@robota-sdk/agent-cli 3.0.0-beta.87 → 3.0.0-beta.88

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @robota-sdk/agent-cli
 
+## 3.0.0-beta.88
+
+### Minor Changes
+
+- b96b81a: `--serve --http-port <port>` also serves the agent HTTP API on `127.0.0.1:<port>`, so other
+  applications and services can submit a prompt and stream its result over SSE, run a slash command,
+  abort and read the conversation without a Robota client library. Requests are admitted by the
+  bearer in `PRODUCT_HTTP_TOKEN` (at least 32 characters), which the runtime removes from its
+  environment before any command runs; the API binds loopback only and is reached from elsewhere
+  through the operator's own proxy. `--http-port` keeps its `mcp serve` meaning.
+
+### Patch Changes
+
+- 853e585: Print mode (`-p`, `--goal`) waits for stdout and stderr to flush before exiting, so a result larger than the pipe buffer is no longer cut off when stdout is a pipe on macOS (for example `-p /help --output-format json`).
+
 ## 3.0.0-beta.87
 
 ### Minor Changes

package/README.md

@@ -301,6 +301,30 @@ on `127.0.0.1` and opens it in your browser. The Electron desktop app in this re
 ([`apps/agent-app`](../../apps/agent-app/docs/README.md)) shows the same GUI over the workspace
 daemon; it is not published to npm. See [The GUI and the Desktop App](../../content/guide/gui.md).
 
+### Let other apps and services use the agent
+
+`robota --serve --http-port <port>` also serves the agent over HTTP on `127.0.0.1:<port>`, so another
+application or service can use it without a Robota client library. Every request presents the
+bearer you choose in `PRODUCT_HTTP_TOKEN` (at least 32 characters); the runtime removes it from its
+environment, so the commands it runs do not inherit it. A command running as the same OS user can
+still read the server's launch environment unless the OS sandbox confines it (or the server runs
+as a separate user), so enable the sandbox on a server. Reach the API from elsewhere through your own
+reverse proxy or tunnel: it binds loopback only.
+
+```bash
+PRODUCT_HTTP_TOKEN="$(openssl rand -hex 32)" robota --serve --http-port 8787
+```
+
+| Request | Does |
+| --- | --- |
+| `POST /submit` `{"prompt": "..."}` | Runs a turn and streams it as SSE (`text_delta`, `complete`, `error`); `409` while a turn is running |
+| `POST /command` `{"name": "help", "args": ""}` | Runs a slash command |
+| `POST /abort` · `POST /cancel-queue` | Aborts the running turn · drops the queued prompt |
+| `GET /messages` · `/context` · `/executing` · `/pending` | Reads the conversation and its state |
+
+No one can answer a permission prompt over HTTP, so a question no other client answers is denied;
+choose the permission mode and rules the server runs under.
+
 ### Reach other sessions and your other devices
 
 `/peers` lists the other live `robota` sessions on this machine, and `/peers send <session-id>

package/dist/node/bin.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 ;(function(){var v=parseInt(process.versions.node.split('.')[0],10);if(v<22){process.stderr.write('\n✗ Node.js 22+ is required (current: '+process.version+')\n\nUpgrade:\n  nvm:   nvm install 22 && nvm use 22\n  Volta: volta install node@22\n  Download: https://nodejs.org/en/download\n\n');process.exit(1);}})();
-import{Bt as e,J as t,Pt as n,dt as r,f as i,ht as a,n as o,xt as s}from"./node-BUERQysz.js";import{A as c,C as l,D as u,E as d,I as f,L as p,M as m,N as h,O as g,S as _,T as ee,_ as te,b as v,d as ne,f as y,g as re,h as ie,j as ae,k as oe,l as se,m as ce,o as le,p as b,s as ue,t as x,u as de,v as fe,w as S,x as C,y as pe}from"./cli-core-6GIkeGqT.js";import{watch as me}from"node:fs";import{basename as he,dirname as ge,join as _e}from"node:path";import{mkdir as ve,readFile as ye,writeFile as w}from"node:fs/promises";import{Readable as be}from"node:stream";import T,{Chalk as xe,backgroundColorNames as Se,foregroundColorNames as Ce}from"chalk";import{Box as E,Static as D,Text as we,render as O,useApp as Te,useBoxMetrics as Ee,useCursor as k,useInput as De,usePaste as Oe,useStdout as ke,useWindowSize as A}from"ink";import j,{createContext as M,useCallback as N,useContext as P,useEffect as F,useLayoutEffect as Ae,useMemo as I,useRef as L,useState as R}from"react";import{Fragment as z,jsx as B,jsxs as V}from"react/jsx-runtime";import je from"string-width";import{marked as Me}from"marked";import Ne from"marked-terminal";const Pe=e=>typeof e==`string`,Fe=e=>t=>t===void 0||e(t),Ie={user:!0,"agent-wakeup":!0,peer:!0,external:!0},H={driverId:Fe(Pe)};({...H}),{...H},{...H},{...H},{...H},{...H},{...H},{...H},{...H},Object.keys(Ie);const Le=new Set([`get-messages`,`get-history`,`get-context`,`get-status`,`get-commands`,`list-models`,`get-executing`,`get-pending`,`get-execution-workspace`,`read-execution-detail`,`get-agent-definitions`,`get-usage-report`,`list-sessions`,`get-background-tasks`,`get-background-task`,`get-background-job-groups`,`get-background-job-group`,`wait-background-job-group`,`read-background-task-log`,`get-settings`,`project-status`,`project-diff`,`project-memory`]);function U(e){return Le.has(e)}const Re=new Set([`	`,`
+import{Bt as e,J as t,Pt as n,dt as r,f as i,ht as a,n as o,xt as s}from"./node-BUERQysz.js";import{A as c,C as l,D as u,E as d,I as f,L as p,M as m,N as h,O as g,S as _,T as ee,_ as te,b as v,d as ne,f as y,g as re,h as ie,j as ae,k as oe,l as se,m as ce,o as le,p as b,s as ue,t as x,u as de,v as fe,w as S,x as C,y as pe}from"./cli-core-CEWWF4d6.js";import{watch as me}from"node:fs";import{basename as he,dirname as ge,join as _e}from"node:path";import{mkdir as ve,readFile as ye,writeFile as w}from"node:fs/promises";import{Readable as be}from"node:stream";import T,{Chalk as xe,backgroundColorNames as Se,foregroundColorNames as Ce}from"chalk";import{Box as E,Static as D,Text as we,render as O,useApp as Te,useBoxMetrics as Ee,useCursor as k,useInput as De,usePaste as Oe,useStdout as ke,useWindowSize as A}from"ink";import j,{createContext as M,useCallback as N,useContext as P,useEffect as F,useLayoutEffect as Ae,useMemo as I,useRef as L,useState as R}from"react";import{Fragment as z,jsx as B,jsxs as V}from"react/jsx-runtime";import je from"string-width";import{marked as Me}from"marked";import Ne from"marked-terminal";const Pe=e=>typeof e==`string`,Fe=e=>t=>t===void 0||e(t),Ie={user:!0,"agent-wakeup":!0,peer:!0,external:!0},H={driverId:Fe(Pe)};({...H}),{...H},{...H},{...H},{...H},{...H},{...H},{...H},{...H},Object.keys(Ie);const Le=new Set([`get-messages`,`get-history`,`get-context`,`get-status`,`get-commands`,`list-models`,`get-executing`,`get-pending`,`get-execution-workspace`,`read-execution-detail`,`get-agent-definitions`,`get-usage-report`,`list-sessions`,`get-background-tasks`,`get-background-task`,`get-background-job-groups`,`get-background-job-group`,`wait-background-job-group`,`read-background-task-log`,`get-settings`,`project-status`,`project-diff`,`project-memory`]);function U(e){return Le.has(e)}const Re=new Set([`	`,`
 `]),ze=/\r\n/g,Be=/\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)?|\x9d[^\x07\x1b\x9c]*(?:\x07|\x9c|\x1b\\)?|\x1b[P^_X][\s\S]*?(?:\x1b\\|\x07)|\x1b[P^_X][\s\S]*$|[\x90\x98\x9e\x9f][\s\S]*?(?:\x9c|\x1b\\|\x07)|[\x90\x98\x9e\x9f][\s\S]*$|\x1b\[[0-?]*[ -/]*[@-~]|\x9b[0-?]*[ -/]*[@-~]|\x1b[@-Z\\-_]|[\x00-\x1f\x7f]|[\x80-\x9f]/g;function W(e){return e.replace(ze,`
 `).replace(Be,e=>Re.has(e)?e:``)}function Ve(e){return typeof e==`string`?W(e):typeof e==`number`||typeof e==`boolean`||e==null?e:Array.isArray(e)?e.map(e=>Ve(e)):e}function G(e){let{children:t,...n}=e;return B(we,{...n,children:Ve(t)})}function He(e){return B(we,{...e})}const Ue={id:`dark`,name:`Dark`,appearance:`dark`,source:`built-in`,colors:{text:{accent:`cyan`,emphasis:`white`,success:`green`,warning:`yellow`,error:`red`,session:`magenta`,muted:`gray`,onAccent:`black`},border:{attention:`yellow`,focused:`cyan`,active:`green`,muted:`gray`,error:`red`},status:{running:`yellow`,success:`green`,error:`red`,denied:`yellowBright`,waiting:`yellow`,cancelled:`yellow`,idle:`gray`}},markdown:{heading:`green`,firstHeading:`magenta`,code:`yellow`,codespan:`yellow`,link:`blue`,href:`blue`,blockquote:`gray`,del:`gray`,html:`gray`,diffAdded:`ansi256(120)`,diffRemoved:`ansi256(210)`,diffAddedBackground:`ansi256(22)`,diffRemovedBackground:`ansi256(52)`,diffHunk:`cyan`},syntax:{keyword:`blue`,built_in:`cyan`,type:`cyan`,literal:`blue`,number:`green`,regexp:`red`,string:`red`,class:`blue`,function:`yellow`,comment:`green`,doctag:`green`,meta:`gray`,tag:`gray`,name:`blue`,attr:`cyan`,addition:`green`,deletion:`red`},motion:{wave:[`#555555`,`#777777`,`#999999`,`#bbbbbb`]}},We=[Ue,{id:`light`,name:`Light`,appearance:`light`,source:`built-in`,colors:{text:{accent:`ansi256(24)`,emphasis:`black`,success:`ansi256(28)`,warning:`ansi256(130)`,error:`ansi256(124)`,session:`ansi256(90)`,muted:`ansi256(243)`,onAccent:`white`},border:{attention:`ansi256(130)`,focused:`ansi256(24)`,active:`ansi256(28)`,muted:`ansi256(249)`,error:`ansi256(124)`},status:{running:`ansi256(130)`,success:`ansi256(28)`,error:`ansi256(124)`,denied:`ansi256(166)`,waiting:`ansi256(130)`,cancelled:`ansi256(130)`,idle:`ansi256(243)`}},markdown:{heading:`ansi256(28)`,firstHeading:`ansi256(90)`,code:`ansi256(94)`,codespan:`ansi256(94)`,link:`ansi256(26)`,href:`ansi256(26)`,blockquote:`ansi256(243)`,del:`ansi256(243)`,html:`ansi256(243)`,diffAdded:`ansi256(22)`,diffRemoved:`ansi256(52)`,diffAddedBackground:`ansi256(194)`,diffRemovedBackground:`ansi256(224)`,diffHunk:`ansi256(24)`},syntax:{keyword:`ansi256(26)`,built_in:`ansi256(24)`,type:`ansi256(24)`,literal:`ansi256(26)`,number:`ansi256(28)`,regexp:`ansi256(124)`,string:`ansi256(124)`,class:`ansi256(26)`,function:`ansi256(94)`,comment:`ansi256(28)`,doctag:`ansi256(28)`,meta:`ansi256(243)`,tag:`ansi256(243)`,name:`ansi256(26)`,attr:`ansi256(24)`,addition:`ansi256(22)`,deletion:`ansi256(52)`},motion:{wave:[`#bbbbbb`,`#999999`,`#777777`,`#555555`]}},{id:`dark-daltonized`,name:`Dark (daltonized)`,appearance:`dark`,source:`built-in`,colors:{text:{accent:`#56b4e9`,emphasis:`#ffffff`,success:`#56b4e9`,warning:`#e69f00`,error:`#d55e00`,session:`#cc79a7`,muted:`#999999`,onAccent:`#000000`},border:{attention:`#e69f00`,focused:`#56b4e9`,active:`#56b4e9`,muted:`#999999`,error:`#d55e00`},status:{running:`#e69f00`,success:`#56b4e9`,error:`#d55e00`,denied:`#f0e442`,waiting:`#e69f00`,cancelled:`#cc79a7`,idle:`#999999`}},markdown:{heading:`#56b4e9`,firstHeading:`#cc79a7`,code:`#e69f00`,codespan:`#e69f00`,link:`#56b4e9`,href:`#56b4e9`,blockquote:`#999999`,del:`#999999`,html:`#999999`,diffAdded:`#8ecdf5`,diffRemoved:`#ffb066`,diffAddedBackground:`#00335c`,diffRemovedBackground:`#5c3000`,diffHunk:`#56b4e9`},syntax:{keyword:`#56b4e9`,built_in:`#8ecdf5`,type:`#8ecdf5`,literal:`#56b4e9`,number:`#e69f00`,regexp:`#d55e00`,string:`#d55e00`,class:`#56b4e9`,function:`#f0e442`,comment:`#999999`,doctag:`#999999`,meta:`#999999`,tag:`#999999`,name:`#56b4e9`,attr:`#8ecdf5`,addition:`#8ecdf5`,deletion:`#ffb066`},motion:{wave:[`#3d3d3d`,`#5c5c5c`,`#7a7a7a`,`#999999`]}},{id:`light-daltonized`,name:`Light (daltonized)`,appearance:`light`,source:`built-in`,colors:{text:{accent:`#0072b2`,emphasis:`#000000`,success:`#0072b2`,warning:`#b35900`,error:`#8c3d00`,session:`#a8477f`,muted:`#5c5c5c`,onAccent:`#ffffff`},border:{attention:`#b35900`,focused:`#0072b2`,active:`#0072b2`,muted:`#a3a3a3`,error:`#8c3d00`},status:{running:`#b35900`,success:`#0072b2`,error:`#8c3d00`,denied:`#8a7500`,waiting:`#b35900`,cancelled:`#a8477f`,idle:`#5c5c5c`}},markdown:{heading:`#0072b2`,firstHeading:`#a8477f`,code:`#8a5a00`,codespan:`#8a5a00`,link:`#0072b2`,href:`#0072b2`,blockquote:`#5c5c5c`,del:`#5c5c5c`,html:`#5c5c5c`,diffAdded:`#004c77`,diffRemoved:`#7a3300`,diffAddedBackground:`#d6ecf9`,diffRemovedBackground:`#fbe5cd`,diffHunk:`#0072b2`},syntax:{keyword:`#0072b2`,built_in:`#004c77`,type:`#004c77`,literal:`#0072b2`,number:`#b35900`,regexp:`#8c3d00`,string:`#8c3d00`,class:`#0072b2`,function:`#8a7500`,comment:`#5c5c5c`,doctag:`#5c5c5c`,meta:`#5c5c5c`,tag:`#5c5c5c`,name:`#0072b2`,attr:`#004c77`,addition:`#004c77`,deletion:`#7a3300`},motion:{wave:[`#c7c7c7`,`#a3a3a3`,`#7a7a7a`,`#5c5c5c`]}}],Ge=Ue.id;function Ke(){return We}function qe(e){return e??Ue}const Je=M(!1);function Ye({enabled:e,children:t}){return B(Je.Provider,{value:e,children:t})}function K(){return P(Je)}function Xe(){if(`NO_COLOR`in process.env)return!1;let e=process.env.FORCE_COLOR;return e===`0`?!1:e!==void 0&&e!==``||!!process.stdout.isTTY}function Ze(e={}){return e.override===!0?!0:e.override===!1||process.env.TERM_PROGRAM===`Apple_Terminal`?!1:!!process.stdout.isTTY}function Qe(e={}){return e.override===!0?!0:e.override===!1||process.env.TERM_PROGRAM===`WezTerm`?!1:!!process.stdout.isTTY}function $e(e={}){return e.override===!0||e.override!==!1&&!!process.stdin.isTTY&&!!process.stdout.isTTY}const et=M(Ue),tt=M(!1),nt=M(!0);function rt({theme:e,reducedMotion:t=!1,syntaxHighlighting:n=!0,children:r}){return B(et.Provider,{value:qe(e),children:B(tt.Provider,{value:t,children:B(nt.Provider,{value:n,children:r})})})}function it(){return P(et)}function q(){return it().colors}function at(){return it().motion}function ot(){let e=K(),t=P(tt);return Xe()&&!e&&!t}function st(){return P(nt)}const ct=[`keyword`,`built_in`,`type`,`literal`,`number`,`regexp`,`string`,`class`,`function`,`comment`,`doctag`,`meta`,`tag`,`name`,`attr`,`addition`,`deletion`],lt=/^#(?:[0-9a-f]{3}|[0-9a-f]{6})$/iu,ut=/^ansi256\((\d{1,3})\)$/iu,dt=/^rgb\((\d{1,3}),\s*(\d{1,3}),\s*(\d{1,3})\)$/iu,ft=`<chalk name> | #rgb | #rrggbb | ansi256(n) | rgb(r,g,b)`,pt=new Map([...Ce,...Se].map(e=>[e,T[e]])),mt=new Set(Ce);function ht(e){return mt.has(e)}function gt(e){if(lt.test(e))return!0;let t=ut.exec(e);if(t)return Number(t[1])<=255;let n=dt.exec(e);return n?n.slice(1).every(e=>Number(e)<=255):ht(e)}function _t(e){throw Error(`Theme colour ${JSON.stringify(e)} is not in Ink's colour grammar (${ft}).`)}function J(e,t=T){if(lt.test(e))return t.hex(e);let n=ut.exec(e);if(n)return t.ansi256(Number(n[1]));let r=dt.exec(e);if(r)return t.rgb(Number(r[1]),Number(r[2]),Number(r[3]));let i=ht(e)?pt.get(e):void 0;return i===void 0&&_t(e),Reflect.get(t,e)??i}function vt(e,t=T){if(lt.test(e))return t.bgHex(e);let n=ut.exec(e);if(n)return t.bgAnsi256(Number(n[1]));let r=dt.exec(e);if(r)return t.bgRgb(Number(r[1]),Number(r[2]),Number(r[3]));let i=`bg${e.charAt(0).toUpperCase()}${e.slice(1)}`;return Reflect.get(t,i)??_t(e)}const yt=new xe({level:3});function bt(){return T.level===0?yt:T}function xt(e){return{heading:J(e.heading).bold,firstHeading:J(e.firstHeading).underline.bold,code:J(e.code),codespan:J(e.codespan),link:J(e.link),href:J(e.href).underline,blockquote:J(e.blockquote).italic,del:J(e.del,T.dim).strikethrough,html:J(e.html)}}function St(e){let t={};for(let n of ct)t[n]=n===`type`?J(e[n]).dim:J(e[n]);return t}function Ct(e){let{markdown:t}=e,n=bt(),r=vt(t.diffAddedBackground,n),i=J(t.diffAdded,n),a=vt(t.diffRemovedBackground,n),o=J(t.diffRemoved,n);return{added:e=>r(i(e)),removed:e=>a(o(e)),hunk:J(t.diffHunk,n),meta:e=>n.dim(e)}}function wt(e){return e.split(/\s+/u).map(Number)}wt(`0 95 135 175 215 255`),wt(`0.1121 0.8853 -0.0005`),wt(`0.1127 0.8897 -0.0001`),wt(`0.0045 0.0 1.0019`),wt(`0.292 0.7054 -0.0003`),wt(`0.2934 0.7089 0.0`),wt(`-0.0209 0.4614 0.5677`),wt(`0.4124 0.3576 0.1805`),wt(`0.2126 0.7152 0.0722`),wt(`0.0193 0.1192 0.9505`),wt(`0.95047 1 1.08883`);function Tt(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}const Et=new Set([`name`,`base`,`overrides`]),Dt=/[\u0000-\u001F\u007F-\u009F]/u,Ot=new RegExp(Dt.source,`gu`);function kt(e){return JSON.stringify(e).replace(Ot,e=>`\\u${(e.codePointAt(0)??0).toString(16).padStart(4,`0`)}`)}function At(e){return kt(e).slice(1,-1)}function jt(e){return W(e).replaceAll(`
 `,` `).replaceAll(`	`,` `).trim()}function Mt(e){return Dt.test(e)?kt(e):e}function Nt(e){return{ok:!1,error:e}}function Pt(e,t){return typeof e==`string`?gt(e)?{ok:!0,value:e}:{ok:!1,error:`${t}: ${kt(e)} is not a colour in Ink's grammar (${ft})`}:{ok:!1,error:`${t}: expected a colour string`}}function Ft(e,t,n){if(!Array.isArray(t)||t.length!==e.length)return{ok:!1,error:`${n}: expected exactly ${e.length} colours`};let r=[];for(let[i,a]of e.entries()){let e=Lt(a,t[i]??null,`${n}[${i}]`);if(!e.ok)return e;r.push(e.value)}return{ok:!0,value:r}}function It(e,t,n){if(!Tt(t))return{ok:!1,error:`${n}: expected an object of tokens`};let r={...e};for(let i of Object.keys(t)){if(!Object.prototype.hasOwnProperty.call(e,i))return{ok:!1,error:`${n}.${Mt(i)} is not a theme token`};let a=Lt(e[i]??null,t[i]??null,`${n}.${Mt(i)}`);if(!a.ok)return a;r[i]=a.value}return{ok:!0,value:r}}function Lt(e,t,n){return typeof e==`string`?Pt(t,n):Array.isArray(e)?Ft(e,t,n):Tt(e)?It(e,t,n):{ok:!1,error:`${n} is not a theme token`}}function Rt(e){return JSON.parse(JSON.stringify(e))}function zt(e){return JSON.parse(JSON.stringify({colors:e.colors,markdown:e.markdown,syntax:e.syntax,motion:e.motion}))}function Bt(e){let t;try{t=JSON.parse(e)}catch(e){return{ok:!1,error:`$: ${e instanceof Error?jt(e.message):`invalid JSON`}`}}if(!Tt(t))return{ok:!1,error:`$: expected an object`};for(let e of Object.keys(t))if(!Et.has(e))return{ok:!1,error:`$.${Mt(e)} is not a theme token`};return{ok:!0,value:t}}function Vt(e,t){let n=e.name;return n===void 0?Dt.test(t)?{ok:!1,error:`$.name: the minted id must not contain control characters`}:t.length>60?{ok:!1,error:`$.name: the minted id must be at most 60 characters`}:{ok:!0,value:t}:typeof n!=`string`||n.trim().length===0?{ok:!1,error:`$.name: expected a non-empty string`}:Dt.test(n)?{ok:!1,error:`$.name: must not contain control characters`}:n.length>60?{ok:!1,error:`$.name: must be at most 60 characters`}:{ok:!0,value:n}}function Ht(e){let t=e.base===void 0?Ge:e.base;if(typeof t!=`string`)return{ok:!1,error:`$.base: expected a built-in theme id`};let n=We.find(e=>e.id===t);return n?{ok:!0,theme:n}:{ok:!1,error:`$.base: ${kt(t)} is not a built-in theme`}}function Ut(e){let t=Bt(e.text);if(!t.ok)return Nt(t.error);let n=t.value,r=Ht(n);if(!r.ok)return Nt(r.error);let i=Vt(n,e.id);if(!i.ok)return Nt(i.error);let a=n.overrides===void 0?{}:n.overrides,o=Lt(zt(r.theme),a,`$.overrides`);if(!o.ok)return Nt(o.error);let{colors:s,markdown:c,syntax:l,motion:u}=Rt(o.value);return{ok:!0,theme:{id:e.id,name:i.value,appearance:r.theme.appearance,source:e.source,colors:s,markdown:c,syntax:l,motion:u}}}function Wt({version:e}){return V(E,{flexDirection:`column`,paddingX:1,marginBottom:1,children:[B(G,{color:q().text.accent,bold:!0,children:`