Playground examples

# 1. A session with a browser and a shell (scripts run next to the browser).curl -X POST https://api.boxline.dev/v1/sessions \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d '{"shell": true}'# 2. Run script.js in it (use the session's id; jq puts the file into JSON). The output streams back, one JSON line at a time.jq -n --rawfile code script.js '{code: $code}' |  curl -N -X POST https://api.boxline.dev/v1/sessions/$SESSION_ID/browser/script \    -H "x-api-key: $BOXLINE_API_KEY" \    -H "content-type: application/json" \    -d @-# 3. Stop it.curl -X POST https://api.boxline.dev/v1/sessions/$SESSION_ID/stop \  -H "x-api-key: $BOXLINE_API_KEY"

import { readFile } from "node:fs/promises";import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URLconst session = await bx.sessions.create({ shell: true });try {  const result = await session.runScript(await readFile("script.js", "utf8"), {    onData: (_stream, text) => process.stdout.write(text),  });  console.log("exit code", result.exitCode);} finally {  await session.stop();}

from boxline import Boxlinebx = Boxline()  # reads BOXLINE_API_KEY and BOXLINE_API_URLwith bx.sessions.create(shell=True) as session:  # leaving the block stops it    code = open("script.js").read()    with session.run_script(code) as script:        for stream, text in script:            print(text, end="")    print("exit code", script.result["exitCode"])

# 1. Start the run (the task is the JSON's "task").curl -X POST https://api.boxline.dev/v1/agent/runs \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d @- <<'JSON'{  "task": "On https://books.toscrape.com, open the Travel category and find the books that cost less than £30. If more than one fits, don't finish yet: ask me for help to choose, and wait until I hand the browser back with my choice. Then tell me the title and price of the one I chose."}JSON# 2. Follow it: status, steps and result (use its id).curl https://api.boxline.dev/v1/agent/runs/$RUN_ID \  -H "x-api-key: $BOXLINE_API_KEY"# When status is "paused", the agent is asking you. Answer in the live view, or in the note, and resume the run:curl -X POST https://api.boxline.dev/v1/agent/runs/$RUN_ID/resume \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -d '{"note": "Done, carry on."}'

import { createInterface } from "node:readline/promises";import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URLconst run = await bx.agent.run({  task: "On https://books.toscrape.com, open the Travel category and find the books that cost less than £30. If more than one fits, don't finish yet: ask me for help to choose, and wait until I hand the browser back with my choice. Then tell me the title and price of the one I chose.",});// Watch the run. When it pauses, the agent is asking you: answer, then resume it.const rl = createInterface({ input: process.stdin, output: process.stdout });for await (const event of bx.agent.stream(run.id)) {  if (event.type === "thought") console.log("…", event.text);  if (event.type === "tool") console.log(event.name);  if (event.type === "status" && event.status === "paused" && event.by !== "captcha") {    const { liveUrl } = await bx.sessions.get(run.sessionId); // a fresh signed link: keep it private    console.log("The agent needs you:", event.reason ?? "", "\nLive view:", liveUrl);    await bx.agent.resume(run.id, { note: await rl.question("Your answer (Enter when done): ") });  }  if (event.type === "done") console.log(event.status, event.result);}rl.close();

from boxline import Boxlinebx = Boxline()  # reads BOXLINE_API_KEY and BOXLINE_API_URLrun = bx.agent.run(    "On https://books.toscrape.com, open the Travel category and find the books that cost less than £30. If more than one fits, don't finish yet: ask me for help to choose, and wait until I hand the browser back with my choice. Then tell me the title and price of the one I chose.",)# Watch the run. When it pauses, the agent is asking you: answer, then resume it.for event in bx.agent.stream(run["id"]):    if event["type"] == "thought":        print("…", event["text"])    elif event["type"] == "tool":        print(event["name"])    elif event["type"] == "status" and event["status"] == "paused" and event.get("by") != "captcha":        live_url = bx.sessions.get(run["sessionId"]).live_url  # a fresh signed link: keep it private        print("The agent needs you:", event.get("reason") or "", "\nLive view:", live_url)        bx.agent.resume(run["id"], note=input("Your answer (Enter when done): "))    elif event["type"] == "done":        print(event["status"], event.get("result"))

boxline run 'On https://books.toscrape.com, open the Travel category and find the books that cost less than £30. If more than one fits, don'\''t finish yet: ask me for help to choose, and wait until I hand the browser back with my choice. Then tell me the title and price of the one I chose.'# When the agent asks you, open the live view it shows, then press Enter here to resume the run.

# 1. A session with a browser and a shell (scripts run next to the browser).curl -X POST https://api.boxline.dev/v1/sessions \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d '{"shell": true}'# 2. Run script.js in it (use the session's id; jq puts the file into JSON). The output streams back, one JSON line at a time.jq -n --rawfile code script.js '{code: $code, env: { SITE: "https://books.toscrape.com" }}' |  curl -N -X POST https://api.boxline.dev/v1/sessions/$SESSION_ID/browser/script \    -H "x-api-key: $BOXLINE_API_KEY" \    -H "content-type: application/json" \    -d @-# 3. Stop it.curl -X POST https://api.boxline.dev/v1/sessions/$SESSION_ID/stop \  -H "x-api-key: $BOXLINE_API_KEY"

import { readFile } from "node:fs/promises";import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URLconst session = await bx.sessions.create({ shell: true });try {  const result = await session.runScript(await readFile("script.js", "utf8"), {    env: { SITE: "https://books.toscrape.com" },    onData: (_stream, text) => process.stdout.write(text),  });  console.log("exit code", result.exitCode);} finally {  await session.stop();}

from boxline import Boxlinebx = Boxline()  # reads BOXLINE_API_KEY and BOXLINE_API_URLwith bx.sessions.create(shell=True) as session:  # leaving the block stops it    code = open("script.js").read()    with session.run_script(code, env={"SITE": "https://books.toscrape.com"}) as script:        for stream, text in script:            print(text, end="")    print("exit code", script.result["exitCode"])

# 1. Start the run (the task is the JSON's "task").curl -X POST https://api.boxline.dev/v1/agent/runs \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d @- <<'JSON'{  "task": "Open https://www.saucedemo.com, a demo shop made for testing, and sign in with the demo username and password shown on its page. Add one product to the cart and go through the checkout up to the last step before the order is placed, using the name Test User and the postcode 10115. Don't place the order. For each step, tell me if anything is confusing or deceptive: hidden costs, pre-ticked options, fake urgency, or a hard way back."}JSON# 2. Follow it: status, steps and result (use its id).curl https://api.boxline.dev/v1/agent/runs/$RUN_ID \  -H "x-api-key: $BOXLINE_API_KEY"

import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URLconst run = await bx.agent.run({  task: "Open https://www.saucedemo.com, a demo shop made for testing, and sign in with the demo username and password shown on its page. Add one product to the cart and go through the checkout up to the last step before the order is placed, using the name Test User and the postcode 10115. Don't place the order. For each step, tell me if anything is confusing or deceptive: hidden costs, pre-ticked options, fake urgency, or a hard way back.",});const done = await bx.agent.wait(run.id); // polls until it finishesconsole.log(done.status, done.result);// Each step, with the agent's thought behind it.for (const s of done.steps) console.log(s.type, s.name ?? "", s.thought ?? s.text ?? "");

from boxline import Boxlinebx = Boxline()  # reads BOXLINE_API_KEY and BOXLINE_API_URLrun = bx.agent.run(    "Open https://www.saucedemo.com, a demo shop made for testing, and sign in with the demo username and password shown on its page. Add one product to the cart and go through the checkout up to the last step before the order is placed, using the name Test User and the postcode 10115. Don't place the order. For each step, tell me if anything is confusing or deceptive: hidden costs, pre-ticked options, fake urgency, or a hard way back.",)done = bx.agent.wait(run["id"])  # polls until it finishesprint(done["status"], done["result"])for s in done["steps"]:    print(s["type"], s.get("name", ""), s.get("thought") or s.get("text", ""))  # with the agent's thought

boxline run 'Open https://www.saucedemo.com, a demo shop made for testing, and sign in with the demo username and password shown on its page. Add one product to the cart and go through the checkout up to the last step before the order is placed, using the name Test User and the postcode 10115. Don'\''t place the order. For each step, tell me if anything is confusing or deceptive: hidden costs, pre-ticked options, fake urgency, or a hard way back.'

# 1. Start the run (the task is the JSON's "task").curl -X POST https://api.boxline.dev/v1/agent/runs \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d @- <<'JSON'{  "task": "Look up the company ARM LIMITED on the UK Companies House register (https://find-and-update.company-information.service.gov.uk) and give me, as JSON: its company number, status, incorporation date and registered office address."}JSON# 2. Follow it: status, steps and result (use its id).curl https://api.boxline.dev/v1/agent/runs/$RUN_ID \  -H "x-api-key: $BOXLINE_API_KEY"

import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URLconst run = await bx.agent.run({  task: "Look up the company ARM LIMITED on the UK Companies House register (https://find-and-update.company-information.service.gov.uk) and give me, as JSON: its company number, status, incorporation date and registered office address.",});const done = await bx.agent.wait(run.id); // polls until it finishesconsole.log(done.status, done.result);// Each step, with the agent's thought behind it.for (const s of done.steps) console.log(s.type, s.name ?? "", s.thought ?? s.text ?? "");

from boxline import Boxlinebx = Boxline()  # reads BOXLINE_API_KEY and BOXLINE_API_URLrun = bx.agent.run(    "Look up the company ARM LIMITED on the UK Companies House register (https://find-and-update.company-information.service.gov.uk) and give me, as JSON: its company number, status, incorporation date and registered office address.",)done = bx.agent.wait(run["id"])  # polls until it finishesprint(done["status"], done["result"])for s in done["steps"]:    print(s["type"], s.get("name", ""), s.get("thought") or s.get("text", ""))  # with the agent's thought

boxline run 'Look up the company ARM LIMITED on the UK Companies House register (https://find-and-update.company-information.service.gov.uk) and give me, as JSON: its company number, status, incorporation date and registered office address.'

# 1. Start the run (the task is the JSON's "task").curl -X POST https://api.boxline.dev/v1/agent/runs \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d @- <<'JSON'{  "task": "Find the legal name and postal address of the organisation behind https://www.eff.org. Look in its terms, privacy or imprint pages (linked at the bottom of most pages). Give them as JSON, with the page you found them on."}JSON# 2. Follow it: status, steps and result (use its id).curl https://api.boxline.dev/v1/agent/runs/$RUN_ID \  -H "x-api-key: $BOXLINE_API_KEY"

import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URLconst run = await bx.agent.run({  task: "Find the legal name and postal address of the organisation behind https://www.eff.org. Look in its terms, privacy or imprint pages (linked at the bottom of most pages). Give them as JSON, with the page you found them on.",});const done = await bx.agent.wait(run.id); // polls until it finishesconsole.log(done.status, done.result);// Each step, with the agent's thought behind it.for (const s of done.steps) console.log(s.type, s.name ?? "", s.thought ?? s.text ?? "");

from boxline import Boxlinebx = Boxline()  # reads BOXLINE_API_KEY and BOXLINE_API_URLrun = bx.agent.run(    "Find the legal name and postal address of the organisation behind https://www.eff.org. Look in its terms, privacy or imprint pages (linked at the bottom of most pages). Give them as JSON, with the page you found them on.",)done = bx.agent.wait(run["id"])  # polls until it finishesprint(done["status"], done["result"])for s in done["steps"]:    print(s["type"], s.get("name", ""), s.get("thought") or s.get("text", ""))  # with the agent's thought

boxline run 'Find the legal name and postal address of the organisation behind https://www.eff.org. Look in its terms, privacy or imprint pages (linked at the bottom of most pages). Give them as JSON, with the page you found them on.'

# 1. Start the run (the task is the JSON's "task").curl -X POST https://api.boxline.dev/v1/agent/runs \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d @- <<'JSON'{  "task": "Open https://books.toscrape.com and add the cheapest poetry book to the basket.",  "mode": "computer"}JSON# 2. Follow it: status, steps and result (use its id).curl https://api.boxline.dev/v1/agent/runs/$RUN_ID \  -H "x-api-key: $BOXLINE_API_KEY"

import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URLconst run = await bx.agent.run({  task: "Open https://books.toscrape.com and add the cheapest poetry book to the basket.",  mode: "computer",});const done = await bx.agent.wait(run.id); // polls until it finishesconsole.log(done.status, done.result);// Each step, with the agent's thought behind it.for (const s of done.steps) console.log(s.type, s.name ?? "", s.thought ?? s.text ?? "");

from boxline import Boxlinebx = Boxline()  # reads BOXLINE_API_KEY and BOXLINE_API_URLrun = bx.agent.run(    "Open https://books.toscrape.com and add the cheapest poetry book to the basket.",    mode="computer",)done = bx.agent.wait(run["id"])  # polls until it finishesprint(done["status"], done["result"])for s in done["steps"]:    print(s["type"], s.get("name", ""), s.get("thought") or s.get("text", ""))  # with the agent's thought

# 1. Start the run (the task is the JSON's "task").curl -X POST https://api.boxline.dev/v1/agent/runs \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d @- <<'JSON'{  "task": "Download the report from https://httpbin.org/base64/bW9udGgscmV2ZW51ZQpKYW4sMTIwMApGZWIsMTg1MApNYXIsMjQxMAo= (a CSV file). In the shell, add up its revenue column with Python and save the total, and nothing else, to output/total.txt. Then open https://httpbin.org/forms/post, type the total into the form's first text box, submit it, and tell me what the page says.",  "session": {    "shell": true  }}JSON# 2. Follow it: status, steps and result (use its id).curl https://api.boxline.dev/v1/agent/runs/$RUN_ID \  -H "x-api-key: $BOXLINE_API_KEY"

import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URLconst run = await bx.agent.run({  task: "Download the report from https://httpbin.org/base64/bW9udGgscmV2ZW51ZQpKYW4sMTIwMApGZWIsMTg1MApNYXIsMjQxMAo= (a CSV file). In the shell, add up its revenue column with Python and save the total, and nothing else, to output/total.txt. Then open https://httpbin.org/forms/post, type the total into the form's first text box, submit it, and tell me what the page says.",  session: { shell: true },});const done = await bx.agent.wait(run.id); // polls until it finishesconsole.log(done.status, done.result);// Each step, with the agent's thought behind it.for (const s of done.steps) console.log(s.type, s.name ?? "", s.thought ?? s.text ?? "");

from boxline import Boxlinebx = Boxline()  # reads BOXLINE_API_KEY and BOXLINE_API_URLrun = bx.agent.run(    "Download the report from https://httpbin.org/base64/bW9udGgscmV2ZW51ZQpKYW4sMTIwMApGZWIsMTg1MApNYXIsMjQxMAo= (a CSV file). In the shell, add up its revenue column with Python and save the total, and nothing else, to output/total.txt. Then open https://httpbin.org/forms/post, type the total into the form's first text box, submit it, and tell me what the page says.",    session={"shell": True},)done = bx.agent.wait(run["id"])  # polls until it finishesprint(done["status"], done["result"])for s in done["steps"]:    print(s["type"], s.get("name", ""), s.get("thought") or s.get("text", ""))  # with the agent's thought

boxline run 'Download the report from https://httpbin.org/base64/bW9udGgscmV2ZW51ZQpKYW4sMTIwMApGZWIsMTg1MApNYXIsMjQxMAo= (a CSV file). In the shell, add up its revenue column with Python and save the total, and nothing else, to output/total.txt. Then open https://httpbin.org/forms/post, type the total into the form'\''s first text box, submit it, and tell me what the page says.' --shell

# 1. A session with a browser and a shell (scripts run next to the browser).curl -X POST https://api.boxline.dev/v1/sessions \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d '{"shell": true}'# 2. Run script.js in it (use the session's id; jq puts the file into JSON). The output streams back, one JSON line at a time.jq -n --rawfile code script.js '{code: $code, env: { REPORT_URL: "https://example.com", FORM_URL: "https://httpbin.org/forms/post" }}' |  curl -N -X POST https://api.boxline.dev/v1/sessions/$SESSION_ID/browser/script \    -H "x-api-key: $BOXLINE_API_KEY" \    -H "content-type: application/json" \    -d @-# 3. Stop it.curl -X POST https://api.boxline.dev/v1/sessions/$SESSION_ID/stop \  -H "x-api-key: $BOXLINE_API_KEY"

import { readFile } from "node:fs/promises";import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URLconst session = await bx.sessions.create({ shell: true });try {  const result = await session.runScript(await readFile("script.js", "utf8"), {    env: { REPORT_URL: "https://example.com", FORM_URL: "https://httpbin.org/forms/post" },    onData: (_stream, text) => process.stdout.write(text),  });  console.log("exit code", result.exitCode);} finally {  await session.stop();}

from boxline import Boxlinebx = Boxline()  # reads BOXLINE_API_KEY and BOXLINE_API_URLwith bx.sessions.create(shell=True) as session:  # leaving the block stops it    code = open("script.js").read()    with session.run_script(code, env={"REPORT_URL": "https://example.com", "FORM_URL": "https://httpbin.org/forms/post"}) as script:        for stream, text in script:            print(text, end="")    print("exit code", script.result["exitCode"])

# 1. Start the run (the task is the JSON's "task").curl -X POST https://api.boxline.dev/v1/agent/runs \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d @- <<'JSON'{  "task": "Download the PDF at https://arxiv.org/pdf/1706.03762 into the downloads folder, turn it into text with pdftotext in the shell, and summarise it in 5 short bullet points.",  "session": {    "shell": true  }}JSON# 2. Follow it: status, steps and result (use its id).curl https://api.boxline.dev/v1/agent/runs/$RUN_ID \  -H "x-api-key: $BOXLINE_API_KEY"

import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URLconst run = await bx.agent.run({  task: "Download the PDF at https://arxiv.org/pdf/1706.03762 into the downloads folder, turn it into text with pdftotext in the shell, and summarise it in 5 short bullet points.",  session: { shell: true },});const done = await bx.agent.wait(run.id); // polls until it finishesconsole.log(done.status, done.result);// Each step, with the agent's thought behind it.for (const s of done.steps) console.log(s.type, s.name ?? "", s.thought ?? s.text ?? "");

from boxline import Boxlinebx = Boxline()  # reads BOXLINE_API_KEY and BOXLINE_API_URLrun = bx.agent.run(    "Download the PDF at https://arxiv.org/pdf/1706.03762 into the downloads folder, turn it into text with pdftotext in the shell, and summarise it in 5 short bullet points.",    session={"shell": True},)done = bx.agent.wait(run["id"])  # polls until it finishesprint(done["status"], done["result"])for s in done["steps"]:    print(s["type"], s.get("name", ""), s.get("thought") or s.get("text", ""))  # with the agent's thought

boxline run 'Download the PDF at https://arxiv.org/pdf/1706.03762 into the downloads folder, turn it into text with pdftotext in the shell, and summarise it in 5 short bullet points.' --shell

# 1. A session with a browser and a shell (scripts run next to the browser).curl -X POST https://api.boxline.dev/v1/sessions \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d '{"shell": true}'# 2. Run script.js in it (use the session's id; jq puts the file into JSON). The output streams back, one JSON line at a time.jq -n --rawfile code script.js '{code: $code}' |  curl -N -X POST https://api.boxline.dev/v1/sessions/$SESSION_ID/browser/script \    -H "x-api-key: $BOXLINE_API_KEY" \    -H "content-type: application/json" \    -d @-# 3. Stop it.curl -X POST https://api.boxline.dev/v1/sessions/$SESSION_ID/stop \  -H "x-api-key: $BOXLINE_API_KEY"

import { readFile } from "node:fs/promises";import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URLconst session = await bx.sessions.create({ shell: true });try {  const result = await session.runScript(await readFile("script.js", "utf8"), {    onData: (_stream, text) => process.stdout.write(text),  });  console.log("exit code", result.exitCode);} finally {  await session.stop();}

from boxline import Boxlinebx = Boxline()  # reads BOXLINE_API_KEY and BOXLINE_API_URLwith bx.sessions.create(shell=True) as session:  # leaving the block stops it    code = open("script.js").read()    with session.run_script(code) as script:        for stream, text in script:            print(text, end="")    print("exit code", script.result["exitCode"])

# 1. Start the run (the task is the JSON's "task").curl -X POST https://api.boxline.dev/v1/agent/runs \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d @- <<'JSON'{  "task": "In the shell, install yt-dlp (pip install yt-dlp), download https://archive.org/download/BigBuckBunny_328/BigBuckBunny_512kb.mp4 with it, and cut the first 30 seconds into output/clip.mp4 with ffmpeg. Tell me the clip's size and length. If the site refuses the download, stop and tell me: don't try to get around it.",  "session": {    "shell": true  }}JSON# 2. Follow it: status, steps and result (use its id).curl https://api.boxline.dev/v1/agent/runs/$RUN_ID \  -H "x-api-key: $BOXLINE_API_KEY"

import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URLconst run = await bx.agent.run({  task: "In the shell, install yt-dlp (pip install yt-dlp), download https://archive.org/download/BigBuckBunny_328/BigBuckBunny_512kb.mp4 with it, and cut the first 30 seconds into output/clip.mp4 with ffmpeg. Tell me the clip's size and length. If the site refuses the download, stop and tell me: don't try to get around it.",  session: { shell: true },});const done = await bx.agent.wait(run.id); // polls until it finishesconsole.log(done.status, done.result);// Each step, with the agent's thought behind it.for (const s of done.steps) console.log(s.type, s.name ?? "", s.thought ?? s.text ?? "");

from boxline import Boxlinebx = Boxline()  # reads BOXLINE_API_KEY and BOXLINE_API_URLrun = bx.agent.run(    "In the shell, install yt-dlp (pip install yt-dlp), download https://archive.org/download/BigBuckBunny_328/BigBuckBunny_512kb.mp4 with it, and cut the first 30 seconds into output/clip.mp4 with ffmpeg. Tell me the clip's size and length. If the site refuses the download, stop and tell me: don't try to get around it.",    session={"shell": True},)done = bx.agent.wait(run["id"])  # polls until it finishesprint(done["status"], done["result"])for s in done["steps"]:    print(s["type"], s.get("name", ""), s.get("thought") or s.get("text", ""))  # with the agent's thought

boxline run 'In the shell, install yt-dlp (pip install yt-dlp), download https://archive.org/download/BigBuckBunny_328/BigBuckBunny_512kb.mp4 with it, and cut the first 30 seconds into output/clip.mp4 with ffmpeg. Tell me the clip'\''s size and length. If the site refuses the download, stop and tell me: don'\''t try to get around it.' --shell

# 1. Start the run (the task is the JSON's "task").curl -X POST https://api.boxline.dev/v1/agent/runs \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d @- <<'JSON'{  "task": "In the shell, download the spreadsheet at https://httpbin.org/base64/bmFtZSxwaG9uZSxlbWFpbApBZGEgTG92ZWxhY2UsKzEgNTU1IDAxMDAsYWRhQGV4YW1wbGUuY29tCkFsYW4gVHVyaW5nLCsxIDU1NSAwMTAxLGFsYW5AZXhhbXBsZS5jb20KR3JhY2UgSG9wcGVyLCsxIDU1NSAwMTAyLGdyYWNlQGV4YW1wbGUuY29tCg== and read its rows with Python. For each of the first 3 rows, open https://httpbin.org/forms/post and fill in the customer name, telephone and email from that row. Before you submit the first one, ask me to check it and wait; after I hand the browser back, submit it and do the other rows the same way without asking again. At the end, tell me what the page said after each submit.",  "session": {    "shell": true  }}JSON# 2. Follow it: status, steps and result (use its id).curl https://api.boxline.dev/v1/agent/runs/$RUN_ID \  -H "x-api-key: $BOXLINE_API_KEY"# When status is "paused", the agent is asking you. Answer in the live view, or in the note, and resume the run:curl -X POST https://api.boxline.dev/v1/agent/runs/$RUN_ID/resume \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -d '{"note": "Done, carry on."}'

import { createInterface } from "node:readline/promises";import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URLconst run = await bx.agent.run({  task: "In the shell, download the spreadsheet at https://httpbin.org/base64/bmFtZSxwaG9uZSxlbWFpbApBZGEgTG92ZWxhY2UsKzEgNTU1IDAxMDAsYWRhQGV4YW1wbGUuY29tCkFsYW4gVHVyaW5nLCsxIDU1NSAwMTAxLGFsYW5AZXhhbXBsZS5jb20KR3JhY2UgSG9wcGVyLCsxIDU1NSAwMTAyLGdyYWNlQGV4YW1wbGUuY29tCg== and read its rows with Python. For each of the first 3 rows, open https://httpbin.org/forms/post and fill in the customer name, telephone and email from that row. Before you submit the first one, ask me to check it and wait; after I hand the browser back, submit it and do the other rows the same way without asking again. At the end, tell me what the page said after each submit.",  session: { shell: true },});// Watch the run. When it pauses, the agent is asking you: answer, then resume it.const rl = createInterface({ input: process.stdin, output: process.stdout });for await (const event of bx.agent.stream(run.id)) {  if (event.type === "thought") console.log("…", event.text);  if (event.type === "tool") console.log(event.name);  if (event.type === "status" && event.status === "paused" && event.by !== "captcha") {    const { liveUrl } = await bx.sessions.get(run.sessionId); // a fresh signed link: keep it private    console.log("The agent needs you:", event.reason ?? "", "\nLive view:", liveUrl);    await bx.agent.resume(run.id, { note: await rl.question("Your answer (Enter when done): ") });  }  if (event.type === "done") console.log(event.status, event.result);}rl.close();

from boxline import Boxlinebx = Boxline()  # reads BOXLINE_API_KEY and BOXLINE_API_URLrun = bx.agent.run(    "In the shell, download the spreadsheet at https://httpbin.org/base64/bmFtZSxwaG9uZSxlbWFpbApBZGEgTG92ZWxhY2UsKzEgNTU1IDAxMDAsYWRhQGV4YW1wbGUuY29tCkFsYW4gVHVyaW5nLCsxIDU1NSAwMTAxLGFsYW5AZXhhbXBsZS5jb20KR3JhY2UgSG9wcGVyLCsxIDU1NSAwMTAyLGdyYWNlQGV4YW1wbGUuY29tCg== and read its rows with Python. For each of the first 3 rows, open https://httpbin.org/forms/post and fill in the customer name, telephone and email from that row. Before you submit the first one, ask me to check it and wait; after I hand the browser back, submit it and do the other rows the same way without asking again. At the end, tell me what the page said after each submit.",    session={"shell": True},)# Watch the run. When it pauses, the agent is asking you: answer, then resume it.for event in bx.agent.stream(run["id"]):    if event["type"] == "thought":        print("…", event["text"])    elif event["type"] == "tool":        print(event["name"])    elif event["type"] == "status" and event["status"] == "paused" and event.get("by") != "captcha":        live_url = bx.sessions.get(run["sessionId"]).live_url  # a fresh signed link: keep it private        print("The agent needs you:", event.get("reason") or "", "\nLive view:", live_url)        bx.agent.resume(run["id"], note=input("Your answer (Enter when done): "))    elif event["type"] == "done":        print(event["status"], event.get("result"))

boxline run 'In the shell, download the spreadsheet at https://httpbin.org/base64/bmFtZSxwaG9uZSxlbWFpbApBZGEgTG92ZWxhY2UsKzEgNTU1IDAxMDAsYWRhQGV4YW1wbGUuY29tCkFsYW4gVHVyaW5nLCsxIDU1NSAwMTAxLGFsYW5AZXhhbXBsZS5jb20KR3JhY2UgSG9wcGVyLCsxIDU1NSAwMTAyLGdyYWNlQGV4YW1wbGUuY29tCg== and read its rows with Python. For each of the first 3 rows, open https://httpbin.org/forms/post and fill in the customer name, telephone and email from that row. Before you submit the first one, ask me to check it and wait; after I hand the browser back, submit it and do the other rows the same way without asking again. At the end, tell me what the page said after each submit.' --shell# When the agent asks you, open the live view it shows, then press Enter here to resume the run.

# 1. A session with a browser and a shell (scripts run next to the browser).curl -X POST https://api.boxline.dev/v1/sessions \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d '{"shell": true}'# 2. Run script.js in it (use the session's id; jq puts the file into JSON). The output streams back, one JSON line at a time.jq -n --rawfile code script.js '{code: $code, env: { URL: "https://example.com" }}' |  curl -N -X POST https://api.boxline.dev/v1/sessions/$SESSION_ID/browser/script \    -H "x-api-key: $BOXLINE_API_KEY" \    -H "content-type: application/json" \    -d @-# 3. Stop it.curl -X POST https://api.boxline.dev/v1/sessions/$SESSION_ID/stop \  -H "x-api-key: $BOXLINE_API_KEY"

import { readFile } from "node:fs/promises";import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URLconst session = await bx.sessions.create({ shell: true });try {  const result = await session.runScript(await readFile("script.js", "utf8"), {    env: { URL: "https://example.com" },    onData: (_stream, text) => process.stdout.write(text),  });  console.log("exit code", result.exitCode);} finally {  await session.stop();}

from boxline import Boxlinebx = Boxline()  # reads BOXLINE_API_KEY and BOXLINE_API_URLwith bx.sessions.create(shell=True) as session:  # leaving the block stops it    code = open("script.js").read()    with session.run_script(code, env={"URL": "https://example.com"}) as script:        for stream, text in script:            print(text, end="")    print("exit code", script.result["exitCode"])

# 1. Start the run (the task is the JSON's "task").curl -X POST https://api.boxline.dev/v1/agent/runs \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d @- <<'JSON'{  "task": "Read https://quotes.toscrape.com/ and https://quotes.toscrape.com/page/2/ as Markdown. Save them in the shell as output/page-1.md and output/page-2.md, then list the files with their sizes.",  "session": {    "shell": true  }}JSON# 2. Follow it: status, steps and result (use its id).curl https://api.boxline.dev/v1/agent/runs/$RUN_ID \  -H "x-api-key: $BOXLINE_API_KEY"

import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URLconst run = await bx.agent.run({  task: "Read https://quotes.toscrape.com/ and https://quotes.toscrape.com/page/2/ as Markdown. Save them in the shell as output/page-1.md and output/page-2.md, then list the files with their sizes.",  session: { shell: true },});const done = await bx.agent.wait(run.id); // polls until it finishesconsole.log(done.status, done.result);// Each step, with the agent's thought behind it.for (const s of done.steps) console.log(s.type, s.name ?? "", s.thought ?? s.text ?? "");

from boxline import Boxlinebx = Boxline()  # reads BOXLINE_API_KEY and BOXLINE_API_URLrun = bx.agent.run(    "Read https://quotes.toscrape.com/ and https://quotes.toscrape.com/page/2/ as Markdown. Save them in the shell as output/page-1.md and output/page-2.md, then list the files with their sizes.",    session={"shell": True},)done = bx.agent.wait(run["id"])  # polls until it finishesprint(done["status"], done["result"])for s in done["steps"]:    print(s["type"], s.get("name", ""), s.get("thought") or s.get("text", ""))  # with the agent's thought

boxline run 'Read https://quotes.toscrape.com/ and https://quotes.toscrape.com/page/2/ as Markdown. Save them in the shell as output/page-1.md and output/page-2.md, then list the files with their sizes.' --shell

# 1. A session with a browser and a shell (scripts run next to the browser).curl -X POST https://api.boxline.dev/v1/sessions \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d '{"shell": true}'# 2. Run script.js in it (use the session's id; jq puts the file into JSON). The output streams back, one JSON line at a time.jq -n --rawfile code script.js '{code: $code, env: { SITE: "https://books.toscrape.com" }}' |  curl -N -X POST https://api.boxline.dev/v1/sessions/$SESSION_ID/browser/script \    -H "x-api-key: $BOXLINE_API_KEY" \    -H "content-type: application/json" \    -d @-# 3. Stop it.curl -X POST https://api.boxline.dev/v1/sessions/$SESSION_ID/stop \  -H "x-api-key: $BOXLINE_API_KEY"

import { readFile } from "node:fs/promises";import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URLconst session = await bx.sessions.create({ shell: true });try {  const result = await session.runScript(await readFile("script.js", "utf8"), {    env: { SITE: "https://books.toscrape.com" },    onData: (_stream, text) => process.stdout.write(text),  });  console.log("exit code", result.exitCode);} finally {  await session.stop();}

from boxline import Boxlinebx = Boxline()  # reads BOXLINE_API_KEY and BOXLINE_API_URLwith bx.sessions.create(shell=True) as session:  # leaving the block stops it    code = open("script.js").read()    with session.run_script(code, env={"SITE": "https://books.toscrape.com"}) as script:        for stream, text in script:            print(text, end="")    print("exit code", script.result["exitCode"])

# 1. A session with a browser and a shell (scripts run next to the browser).curl -X POST https://api.boxline.dev/v1/sessions \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d '{"shell": true}'# 2. Run script.js in it (use the session's id; jq puts the file into JSON). The output streams back, one JSON line at a time.jq -n --rawfile code script.js '{code: $code, env: { SITE: "https://books.toscrape.com" }}' |  curl -N -X POST https://api.boxline.dev/v1/sessions/$SESSION_ID/browser/script \    -H "x-api-key: $BOXLINE_API_KEY" \    -H "content-type: application/json" \    -d @-# 3. Stop it.curl -X POST https://api.boxline.dev/v1/sessions/$SESSION_ID/stop \  -H "x-api-key: $BOXLINE_API_KEY"

import { readFile } from "node:fs/promises";import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URLconst session = await bx.sessions.create({ shell: true });try {  const result = await session.runScript(await readFile("script.js", "utf8"), {    env: { SITE: "https://books.toscrape.com" },    onData: (_stream, text) => process.stdout.write(text),  });  console.log("exit code", result.exitCode);} finally {  await session.stop();}

from boxline import Boxlinebx = Boxline()  # reads BOXLINE_API_KEY and BOXLINE_API_URLwith bx.sessions.create(shell=True) as session:  # leaving the block stops it    code = open("script.js").read()    with session.run_script(code, env={"SITE": "https://books.toscrape.com"}) as script:        for stream, text in script:            print(text, end="")    print("exit code", script.result["exitCode"])

# 1. A session with a browser and a shell (scripts run next to the browser).curl -X POST https://api.boxline.dev/v1/sessions \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d '{"shell": true}'# 2. Run script.js in it (use the session's id; jq puts the file into JSON). The output streams back, one JSON line at a time.jq -n --rawfile code script.js '{code: $code, env: { URL: "https://books.toscrape.com" }}' |  curl -N -X POST https://api.boxline.dev/v1/sessions/$SESSION_ID/browser/script \    -H "x-api-key: $BOXLINE_API_KEY" \    -H "content-type: application/json" \    -d @-# 3. Stop it.curl -X POST https://api.boxline.dev/v1/sessions/$SESSION_ID/stop \  -H "x-api-key: $BOXLINE_API_KEY"

import { readFile } from "node:fs/promises";import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URLconst session = await bx.sessions.create({ shell: true });try {  const result = await session.runScript(await readFile("script.js", "utf8"), {    env: { URL: "https://books.toscrape.com" },    onData: (_stream, text) => process.stdout.write(text),  });  console.log("exit code", result.exitCode);} finally {  await session.stop();}

from boxline import Boxlinebx = Boxline()  # reads BOXLINE_API_KEY and BOXLINE_API_URLwith bx.sessions.create(shell=True) as session:  # leaving the block stops it    code = open("script.js").read()    with session.run_script(code, env={"URL": "https://books.toscrape.com"}) as script:        for stream, text in script:            print(text, end="")    print("exit code", script.result["exitCode"])

# 1. A session with a browser and a shell (scripts run next to the browser).curl -X POST https://api.boxline.dev/v1/sessions \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d '{"shell": true}'# 2. Run script.js in it (use the session's id; jq puts the file into JSON). The output streams back, one JSON line at a time.jq -n --rawfile code script.js '{code: $code, env: { SITE: "https://books.toscrape.com" }}' |  curl -N -X POST https://api.boxline.dev/v1/sessions/$SESSION_ID/browser/script \    -H "x-api-key: $BOXLINE_API_KEY" \    -H "content-type: application/json" \    -d @-# 3. Stop it.curl -X POST https://api.boxline.dev/v1/sessions/$SESSION_ID/stop \  -H "x-api-key: $BOXLINE_API_KEY"

import { readFile } from "node:fs/promises";import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URLconst session = await bx.sessions.create({ shell: true });try {  const result = await session.runScript(await readFile("script.js", "utf8"), {    env: { SITE: "https://books.toscrape.com" },    onData: (_stream, text) => process.stdout.write(text),  });  console.log("exit code", result.exitCode);} finally {  await session.stop();}

from boxline import Boxlinebx = Boxline()  # reads BOXLINE_API_KEY and BOXLINE_API_URLwith bx.sessions.create(shell=True) as session:  # leaving the block stops it    code = open("script.js").read()    with session.run_script(code, env={"SITE": "https://books.toscrape.com"}) as script:        for stream, text in script:            print(text, end="")    print("exit code", script.result["exitCode"])

# 1. Start the run (the task is the JSON's "task").curl -X POST https://api.boxline.dev/v1/agent/runs \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d @- <<'JSON'{  "task": "Search the web for <a question>, read the three best sources, and answer in 3 sentences with links to them."}JSON# 2. Follow it: status, steps and result (use its id).curl https://api.boxline.dev/v1/agent/runs/$RUN_ID \  -H "x-api-key: $BOXLINE_API_KEY"

import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URLconst run = await bx.agent.run({  task: "Search the web for <a question>, read the three best sources, and answer in 3 sentences with links to them.",});const done = await bx.agent.wait(run.id); // polls until it finishesconsole.log(done.status, done.result);// Each step, with the agent's thought behind it.for (const s of done.steps) console.log(s.type, s.name ?? "", s.thought ?? s.text ?? "");

from boxline import Boxlinebx = Boxline()  # reads BOXLINE_API_KEY and BOXLINE_API_URLrun = bx.agent.run(    "Search the web for <a question>, read the three best sources, and answer in 3 sentences with links to them.",)done = bx.agent.wait(run["id"])  # polls until it finishesprint(done["status"], done["result"])for s in done["steps"]:    print(s["type"], s.get("name", ""), s.get("thought") or s.get("text", ""))  # with the agent's thought

boxline run 'Search the web for <a question>, read the three best sources, and answer in 3 sentences with links to them.'

# 1. A browser profile, and a session that keeps what happens in it (persist).curl -X POST https://api.boxline.dev/v1/profiles \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -d '{"name": "My site"}'curl -X POST https://api.boxline.dev/v1/sessions \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -d '{"keepAlive": true, "profile": {"id": "'"$PROFILE_ID"'", "persist": true}}'# 2. Start the run (the task is the JSON's "task").curl -X POST https://api.boxline.dev/v1/agent/runs \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d @- <<JSON{  "task": "Open <your sign-in page> and ask me to sign in: I'll do it myself in the live browser. When I hand the browser back, check that I'm signed in and tell me the name shown on the page.",  "sessionId": "$SESSION_ID"}JSON# 3. Follow it: status, steps and result (use its id).curl https://api.boxline.dev/v1/agent/runs/$RUN_ID \  -H "x-api-key: $BOXLINE_API_KEY"# When status is "paused", the agent is asking you. Answer in the live view, or in the note, and resume the run:curl -X POST https://api.boxline.dev/v1/agent/runs/$RUN_ID/resume \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -d '{"note": "Done, carry on."}'# 4. Stop the session when you are done: this saves the profile.curl -X POST https://api.boxline.dev/v1/sessions/$SESSION_ID/stop \  -H "x-api-key: $BOXLINE_API_KEY"

import { createInterface } from "node:readline/promises";import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URLconst profile = await bx.profiles.create({ name: "My site" });const session = await bx.sessions.create({ keepAlive: true, profile: { id: profile.id, persist: true } });const run = await bx.agent.run({  task: "Open <your sign-in page> and ask me to sign in: I'll do it myself in the live browser. When I hand the browser back, check that I'm signed in and tell me the name shown on the page.",  sessionId: session.id,});// Watch the run. When it pauses, the agent is asking you: answer, then resume it.const rl = createInterface({ input: process.stdin, output: process.stdout });for await (const event of bx.agent.stream(run.id)) {  if (event.type === "thought") console.log("…", event.text);  if (event.type === "tool") console.log(event.name);  if (event.type === "status" && event.status === "paused" && event.by !== "captcha") {    const { liveUrl } = await bx.sessions.get(run.sessionId); // a fresh signed link: keep it private    console.log("The agent needs you:", event.reason ?? "", "\nLive view:", liveUrl);    await bx.agent.resume(run.id, { note: await rl.question("Your answer (Enter when done): ") });  }  if (event.type === "done") console.log(event.status, event.result);}rl.close();await bx.sessions.stop(session.id); // this saves the profile

from boxline import Boxlinebx = Boxline()  # reads BOXLINE_API_KEY and BOXLINE_API_URLprofile = bx.profiles.create("My site")# Leaving the block stops the session, which saves the profile.with bx.sessions.create(keep_alive=True, profile=profile["id"], persist_profile=True) as session:    run = bx.agent.run(        "Open <your sign-in page> and ask me to sign in: I'll do it myself in the live browser. When I hand the browser back, check that I'm signed in and tell me the name shown on the page.",        session_id=session.id,    )    # Watch the run. When it pauses, the agent is asking you: answer, then resume it.    for event in bx.agent.stream(run["id"]):        if event["type"] == "thought":            print("…", event["text"])        elif event["type"] == "tool":            print(event["name"])        elif event["type"] == "status" and event["status"] == "paused" and event.get("by") != "captcha":            live_url = bx.sessions.get(run["sessionId"]).live_url  # a fresh signed link: keep it private            print("The agent needs you:", event.get("reason") or "", "\nLive view:", live_url)            bx.agent.resume(run["id"], note=input("Your answer (Enter when done): "))        elif event["type"] == "done":            print(event["status"], event.get("result"))

# In a session that saves the browser profile when it stops (start it as in the curl tab: the CLI has no browser-profile option).boxline run 'Open <your sign-in page> and ask me to sign in: I'\''ll do it myself in the live browser. When I hand the browser back, check that I'\''m signed in and tell me the name shown on the page.' --session $SESSION_IDboxline sessions stop $SESSION_ID   # this saves the profile

# 1. Start the run (the task is the JSON's "task").curl -X POST https://api.boxline.dev/v1/agent/runs \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d @- <<JSON{  "task": "Open <your sign-in page> and sign in with the username %username% and the password %password%. When the site asks for a verification code, ask me for it and wait, then type the code I give you. When I'm signed in, tell me the name shown on the page.",  "variables": {    "username": "$SITE_USERNAME",    "password": {      "value": "$SITE_PASSWORD",      "origins": [        "https://example.com"      ]    }  }}JSON# 2. Follow it: status, steps and result (use its id).curl https://api.boxline.dev/v1/agent/runs/$RUN_ID \  -H "x-api-key: $BOXLINE_API_KEY"# When status is "paused", the agent is asking you. Answer in the live view, or in the note, and resume the run:curl -X POST https://api.boxline.dev/v1/agent/runs/$RUN_ID/resume \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -d '{"note": "Done, carry on."}'

import { createInterface } from "node:readline/promises";import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URLconst run = await bx.agent.run({  task: "Open <your sign-in page> and sign in with the username %username% and the password %password%. When the site asks for a verification code, ask me for it and wait, then type the code I give you. When I'm signed in, tell me the name shown on the page.",  variables: {    username: process.env.SITE_USERNAME!,    password: { value: process.env.SITE_PASSWORD!, origins: ["https://example.com"] }, // only fields on your site  },});// Watch the run. When it pauses, the agent is asking you: answer, then resume it.const rl = createInterface({ input: process.stdin, output: process.stdout });for await (const event of bx.agent.stream(run.id)) {  if (event.type === "thought") console.log("…", event.text);  if (event.type === "tool") console.log(event.name);  if (event.type === "status" && event.status === "paused" && event.by !== "captcha") {    const { liveUrl } = await bx.sessions.get(run.sessionId); // a fresh signed link: keep it private    console.log("The agent needs you:", event.reason ?? "", "\nLive view:", liveUrl);    await bx.agent.resume(run.id, { note: await rl.question("Your answer (Enter when done): ") });  }  if (event.type === "done") console.log(event.status, event.result);}rl.close();

import osfrom boxline import Boxlinebx = Boxline()  # reads BOXLINE_API_KEY and BOXLINE_API_URLrun = bx.agent.run(    "Open <your sign-in page> and sign in with the username %username% and the password %password%. When the site asks for a verification code, ask me for it and wait, then type the code I give you. When I'm signed in, tell me the name shown on the page.",    variables={        "username": os.environ["SITE_USERNAME"],        "password": {"value": os.environ["SITE_PASSWORD"], "origins": ["https://example.com"]},  # only fields on your site    },)# Watch the run. When it pauses, the agent is asking you: answer, then resume it.for event in bx.agent.stream(run["id"]):    if event["type"] == "thought":        print("…", event["text"])    elif event["type"] == "tool":        print(event["name"])    elif event["type"] == "status" and event["status"] == "paused" and event.get("by") != "captcha":        live_url = bx.sessions.get(run["sessionId"]).live_url  # a fresh signed link: keep it private        print("The agent needs you:", event.get("reason") or "", "\nLive view:", live_url)        bx.agent.resume(run["id"], note=input("Your answer (Enter when done): "))    elif event["type"] == "done":        print(event["status"], event.get("result"))

# 1. A session signed in with your browser profile.curl -X POST https://api.boxline.dev/v1/sessions \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -d '{"keepAlive": true, "profile": {"id": "'"$PROFILE_ID"'"}}'# 2. Start the run (the task is the JSON's "task").curl -X POST https://api.boxline.dev/v1/agent/runs \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d @- <<JSON{  "task": "Open <your billing page>. I'm signed in already (browser profile). Find the invoices or billing history, download every invoice from the last 3 months, and tell me each file's name, date and amount. If you're asked to sign in, ask me for help and wait.",  "sessionId": "$SESSION_ID"}JSON# 3. Follow it: status, steps and result (use its id).curl https://api.boxline.dev/v1/agent/runs/$RUN_ID \  -H "x-api-key: $BOXLINE_API_KEY"# When status is "paused", the agent is asking you. Answer in the live view, or in the note, and resume the run:curl -X POST https://api.boxline.dev/v1/agent/runs/$RUN_ID/resume \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -d '{"note": "Done, carry on."}'# 4. Stop the session when you are done.curl -X POST https://api.boxline.dev/v1/sessions/$SESSION_ID/stop \  -H "x-api-key: $BOXLINE_API_KEY"

import { createInterface } from "node:readline/promises";import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URL// A session signed in with your browser profile (its id is in the console, or bx.profiles.list()).const session = await bx.sessions.create({ keepAlive: true, profile: { id: "PROFILE_ID" } });const run = await bx.agent.run({  task: "Open <your billing page>. I'm signed in already (browser profile). Find the invoices or billing history, download every invoice from the last 3 months, and tell me each file's name, date and amount. If you're asked to sign in, ask me for help and wait.",  sessionId: session.id,});// Watch the run. When it pauses, the agent is asking you: answer, then resume it.const rl = createInterface({ input: process.stdin, output: process.stdout });for await (const event of bx.agent.stream(run.id)) {  if (event.type === "thought") console.log("…", event.text);  if (event.type === "tool") console.log(event.name);  if (event.type === "status" && event.status === "paused" && event.by !== "captcha") {    const { liveUrl } = await bx.sessions.get(run.sessionId); // a fresh signed link: keep it private    console.log("The agent needs you:", event.reason ?? "", "\nLive view:", liveUrl);    await bx.agent.resume(run.id, { note: await rl.question("Your answer (Enter when done): ") });  }  if (event.type === "done") console.log(event.status, event.result);}rl.close();await bx.sessions.stop(session.id);

from boxline import Boxlinebx = Boxline()  # reads BOXLINE_API_KEY and BOXLINE_API_URL# A session signed in with your browser profile (its id is in the console, or bx.profiles.list()).with bx.sessions.create(keep_alive=True, profile="PROFILE_ID") as session:    run = bx.agent.run(        "Open <your billing page>. I'm signed in already (browser profile). Find the invoices or billing history, download every invoice from the last 3 months, and tell me each file's name, date and amount. If you're asked to sign in, ask me for help and wait.",        session_id=session.id,    )    # Watch the run. When it pauses, the agent is asking you: answer, then resume it.    for event in bx.agent.stream(run["id"]):        if event["type"] == "thought":            print("…", event["text"])        elif event["type"] == "tool":            print(event["name"])        elif event["type"] == "status" and event["status"] == "paused" and event.get("by") != "captcha":            live_url = bx.sessions.get(run["sessionId"]).live_url  # a fresh signed link: keep it private            print("The agent needs you:", event.get("reason") or "", "\nLive view:", live_url)            bx.agent.resume(run["id"], note=input("Your answer (Enter when done): "))        elif event["type"] == "done":            print(event["status"], event.get("result"))

# In a session signed in with your browser profile (start it as in the curl tab: the CLI has no browser-profile option).boxline run 'Open <your billing page>. I'\''m signed in already (browser profile). Find the invoices or billing history, download every invoice from the last 3 months, and tell me each file'\''s name, date and amount. If you'\''re asked to sign in, ask me for help and wait.' --session $SESSION_ID

# 1. Start the run (the task is the JSON's "task").curl -X POST https://api.boxline.dev/v1/agent/runs \  -H "x-api-key: $BOXLINE_API_KEY" \  -H "content-type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d @- <<'JSON'{  "task": "Open <your sign-in page> and sign in with %<credential>.username%, %<credential>.password% and the code %<credential>.otp%."}JSON# 2. Follow it: status, steps and result (use its id).curl https://api.boxline.dev/v1/agent/runs/$RUN_ID \  -H "x-api-key: $BOXLINE_API_KEY"

import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URLconst run = await bx.agent.run({  task: "Open <your sign-in page> and sign in with %<credential>.username%, %<credential>.password% and the code %<credential>.otp%.",});const done = await bx.agent.wait(run.id); // polls until it finishesconsole.log(done.status, done.result);// Each step, with the agent's thought behind it.for (const s of done.steps) console.log(s.type, s.name ?? "", s.thought ?? s.text ?? "");

from boxline import Boxlinebx = Boxline()  # reads BOXLINE_API_KEY and BOXLINE_API_URLrun = bx.agent.run(    "Open <your sign-in page> and sign in with %<credential>.username%, %<credential>.password% and the code %<credential>.otp%.",)done = bx.agent.wait(run["id"])  # polls until it finishesprint(done["status"], done["result"])for s in done["steps"]:    print(s["type"], s.get("name", ""), s.get("thought") or s.get("text", ""))  # with the agent's thought

boxline run 'Open <your sign-in page> and sign in with %<credential>.username%, %<credential>.password% and the code %<credential>.otp%.'