@agimon-ai/po-runner 0.0.0-alpha.4 → 0.0.0-alpha.40

package/LICENSE

@@ -1,21 +1,149 @@
-MIT License
-
-Copyright (c) 2026 Vuong Ngo
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+License text copyright © 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+Parameters
+
+Licensor:             Agimon Pty Ltd
+Licensed Work:        Po, the software in the Po source repository and the
+                      packages released from it, in each version released by
+                      the Licensor.
+                      The Licensed Work is (c) 2026 Agimon Pty Ltd.
+                      Material identified as third-party in the "Third-party
+                      components" section at the end of this file or in a
+                      NOTICE file, and any package or directory whose own
+                      license file grants a different license, is not part of
+                      the Licensed Work and remains under its own license.
+Additional Use Grant: You may make production use of the Licensed Work if
+  your use is Eligible Use. "Eligible Use" is production use that falls
+  within at least one of the following:
+
+  (a) Personal Use. Use by an individual for their own personal purposes,
+      and not on behalf of, or for the benefit of, an employer, client, or
+      other Organization. Use by an individual in the course of employment
+      or engagement by an Organization is use by that Organization.
+
+  (b) Small Organization Use. Use by or on behalf of an Organization whose
+      Annual Revenue is less than USD 1,000,000.
+
+  (c) Non-profit, Education and Research Use. Use, regardless of Annual
+      Revenue, by (i) an Organization registered or recognized as a
+      non-profit or charitable organization under the laws of its
+      jurisdiction, for its non-profit purposes; (ii) an accredited school,
+      college, or university, for teaching, learning, or academic research;
+      or (iii) a publicly funded research institution, for its research.
+
+  (d) Service Provider Use. Use by a consultant, contractor, agency, or other
+      service provider, regardless of its own Annual Revenue, solely to
+      build, deploy, host, operate, or support the Licensed Work for a client
+      whose own use would be Eligible Use under (a), (b), or (c). A service
+      provider's use for its own purposes is Eligible Use only if the service
+      provider itself qualifies under (b) or (c).
+
+
+  Hosted services. Offering the Licensed Work to third parties as a hosted
+  or managed service whose primary value is the Licensed Work is Eligible
+  Use only if each such third party's own use would be Eligible Use.
+
+  Definitions. "Organization" means any company, partnership, sole
+  proprietorship, trust, association, government body, or other entity, and
+  includes an individual acting in a business or professional capacity.
+  "Affiliate" means any entity that directly or indirectly controls, is
+  controlled by, or is under common control with an Organization, where
+  "control" means ownership of more than 50% of the voting interests of an
+  entity or the power to direct its management and policies by contract or
+  otherwise. "Annual Revenue" means the total gross revenue of an
+  Organization and all of its Affiliates combined, from all sources and
+  whether or not related to the Licensed Work, for its most recently
+  completed fiscal year, or, if it has not completed a fiscal year, for the
+  twelve months before the use (or since its formation, if shorter),
+  converted into US dollars at the average exchange rate for that period.
+  Proceeds of equity or debt financing are not revenue.
+
+  Threshold. If an Organization stops qualifying under (b), its existing
+  production use remains Eligible Use for 90 days after it stops
+  qualifying, after which it must obtain a commercial license or stop
+  production use. Use that was Eligible Use when it occurred never requires
+  a commercial license after the fact.
+Change Date:          Four years from the date a version of the Licensed Work
+                      is first publicly released by the Licensor.
+Change License:       Apache License, Version 2.0
+
+For information about alternative licensing arrangements for the Licensed
+Work, please visit: https://agimon.ai/licensing
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.
+
+-----------------------------------------------------------------------------
+
+Business Source License 1.1
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN “AS IS” BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License’s text to license
+your works, and to refer to it using the trademark “Business Source License”,
+as long as you comply with the Covenants of Licensor below.
+
+Covenants of Licensor
+
+In consideration of the right to use this License’s text and the “Business
+Source License” name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where “compatible” means that software provided under the Change License can
+   be included in a program with software provided under GPL Version 2.0 or a
+   later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text “None”.
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.

package/README.md

@@ -1,6 +1,6 @@
 # @agimon-ai/po-runner
 
-Supervised shell execution, background process control, durable logs.
+Supervised shell execution, sequential checks, background process control, complete session-temp logs.
 
 Part of the [Po distribution](https://www.npmjs.com/package/@agimon-ai/po).
 
@@ -40,7 +40,7 @@ it to a named layer to enable it only in selected major modes.
 
 ```json
 {
-  "command": "pnpm test",
+  "command": ["pnpm test"],
   "timeout": 60
 }
 ```
@@ -49,8 +49,26 @@ Commands crossing the promotion threshold move to a supervised runner. The defau
 seconds. Set `background: true` to detach immediately, or `interactive: true` only when a command
 needs terminal input.
 
-Runner requires `PI_SESSION_ID` for session ownership. Processes, controls, and logs remain
-addressable after transcript compaction because their identity is outside model context.
+Always pass `command` as an array, including for one command. Dependent commands run in separate fresh shells, sequentially and fail-fast:
+
+```json
+{
+  "command": ["pnpm build", "pnpm typecheck", "pnpm lint", "pnpm test"],
+  "name": "verification",
+  "timeout": 120
+}
+```
+
+With `interactive: true`, only the last command gets a pseudo terminal. Runner returns control when
+that stage starts; inspect its stage runner ID and logs, then use that ID for input, not the sequence ID.
+Each command gets its own timeout and complete log. The result lists all attempted log paths and only
+the last executed command's trimmed output. Shell state such as `cd` and `export` does not carry
+between entries. Keep repository mutations separate from verification.
+A promoted array remains one supervised sequence, and its next command waits for the current process
+to actually exit. Native sessions receive one aggregate completion; remote MCP callers poll.
+
+Runner requires a session identity and host-admitted `PO_SESSION_TEMP_DIR`. Processes, controls, and
+logs remain addressable after transcript compaction because identity is outside model context.
 
 ### RTK result processing
 
@@ -63,7 +81,22 @@ also returns bounded raw output with a warning and does not change the command e
 
 ## Inspect and control runs
 
-The `po-runner` CLI supports:
+When code mode is available, use its typed `runner` namespace rather than shelling out to the CLI:
+
+```ts
+// discover({ namespace: 'runner' }) shows current signatures.
+return await runner.list();
+return await runner.status({ id: 'returned-id' });
+return await runner.logs({ id: 'returned-id', lines: 100 });
+return await runner.stop({ id: 'unused-id', reason: 'finished' });
+```
+
+`runner.input` sends interactive input, and `runner.stopAll` stops this session's active work. Reads
+return bounded snapshots, not live streams. Sequence IDs report ordered stages and the guarded final
+result; stage IDs address the actual process logs. Check status before retrying, and distinguish a
+requested cancellation from confirmed termination.
+
+Without code mode, the `po-runner` CLI supports:
 
 ```bash
 po-runner list
@@ -80,15 +113,17 @@ Stop runs that are no longer required.
 
 ## Storage and limits
 
-By default, session-scoped logs and registry data live under:
+All runner files live beneath the session's host-admitted temporary directory: command logs, process
+metadata, sequence manifests, cancellation files, and supervision transport files. Runner does not
+use the artifact folder or a durable agent-directory fallback for session-owned files.
 
-```text
-~/.po/agent/po-runner/<session>/
-```
+Session removal, restart, or termination stops its runner processes and removes its runner subtree
+and registry entries. An external observer handles owner hard-kill cleanup. Compaction and ordinary
+activity changes do not remove evidence. Save important deliverables to the session artifact folder.
 
-Logs remain complete until TTL cleanup and are eligible for cleanup after seven days by default. The
-legacy log-size configuration exports remain available for compatibility but no longer rotate log
-content. Result limits, retention, and the promotion threshold remain environment-configurable.
+Do not pipe or redirect command output to a file, `head`, or `tail`. Runner automatically saves full
+logs and bounds returned output. Inspect saved logs when an excerpt is truncated instead of rerunning
+the command. Result limits and the promotion threshold remain environment-configurable.
 
 ### Result excerpts
 
@@ -246,7 +281,7 @@ Maintained by [Agimon](https://agimon.ai/about).
 
 ## License
 
-MIT
+Business Source License 1.1: free for personal use, organisations under USD 1M revenue, non-profits and education. See [LICENSE](LICENSE) and https://agimon.ai/licensing.
 
 ## Extension lifecycle and source layout
 
@@ -254,4 +289,4 @@ Public capabilities use flat kebab-case subpaths such as `runner-dependencies`,
 
 ### Native session ownership
 
-The Po server facet owns runner startup, history retention, background completion notifications, and successful-compaction recovery. The standalone `po-runner` command remains available. Runner project settings retain the existing headless bridge's trusted-project assumption, validation, and environment-over-project precedence. Optional runner activity toggles do not restart the retained supervisor.
+The Po server plugin owns runner startup, history retention, background completion notifications, and successful-compaction recovery. The standalone `po-runner` command remains available. Runner project settings retain the existing headless bridge's trusted-project assumption, validation, and environment-over-project precedence. Optional runner activity toggles do not restart the retained supervisor.

package/dist/apiContracts.cjs

@@ -50,7 +50,14 @@ const Run = typebox.Type.Object({
 		finishedAt: S
 	}))
 });
-const RunnerPayloadSchema = typebox.Type.Object({ runs: typebox.Type.Array(Run) });
+const RunnerPayloadSchema = typebox.Type.Object({
+	runs: typebox.Type.Array(Run),
+	sessionDirectory: O(S),
+	startFailure: O(typebox.Type.Object({
+		id: S,
+		message: S
+	}))
+});
 const RunnerLogSchema = typebox.Type.Object({
 	runId: S,
 	running: B,
@@ -73,6 +80,18 @@ const RunnerScreenSchema = typebox.Type.Object({
 	offset: O(N),
 	ended: O(B)
 });
+const RunnerOutputSchema = typebox.Type.Object({
+	chunk: typebox.Type.String({ contentEncoding: "base64" }),
+	offset: typebox.Type.Integer({
+		minimum: 0,
+		maximum: Number.MAX_SAFE_INTEGER
+	}),
+	reset: B,
+	generation: O(S),
+	exists: B,
+	hasMore: B,
+	ended: B
+});
 const apiContracts = (0, _agimon_ai_po_core_apiContracts.defineApiContract)({
 	version: 1,
 	dynamic: [],
@@ -98,6 +117,30 @@ const apiContracts = (0, _agimon_ai_po_core_apiContracts.defineApiContract)({
 			})),
 			responses: (0, _agimon_ai_po_core_apiContracts.jsonApiResponses)(RunnerLogSchema)
 		},
+		...["log", "screen"].map((kind) => ({
+			id: `runner.${kind}.read`,
+			scope: "session",
+			basePath: "runner",
+			path: `/runners/{runId}/${kind}/read`,
+			method: "GET",
+			authentication: "owner",
+			description: `Read at most 64 KiB of session-owned runner ${kind} bytes as base64. A completed runner remains readable; screen reads require an owned interactive multiplexer pane.`,
+			parameters: [{
+				name: "from",
+				in: "query",
+				required: false,
+				schema: typebox.Type.Integer({
+					minimum: 0,
+					maximum: Number.MAX_SAFE_INTEGER
+				})
+			}, ...kind === "screen" ? [{
+				name: "generation",
+				in: "query",
+				required: false,
+				schema: S
+			}] : []],
+			responses: (0, _agimon_ai_po_core_apiContracts.jsonApiResponses)(RunnerOutputSchema)
+		})),
 		...["log", "screen"].map((kind) => ({
 			id: `runner.${kind}.stream`,
 			scope: "session",

package/dist/apiContracts.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"apiContracts.cjs","names":["Type","defineApiContract","jsonApiResponses"],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract, jsonApiResponses } from '@agimon-ai/po-core/apiContracts';\nimport { Type } from 'typebox';\n\nconst S = Type.String();\nconst N = Type.Number();\nconst B = Type.Boolean();\nconst O = Type.Optional;\nconst literals = <T extends string>(values: T[]) => Type.Union(values.map((value) => Type.Literal(value)));\nconst Run = Type.Object({\n  id: S,\n  name: S,\n  pid: N,\n  command: S,\n  cwd: S,\n  interactive: B,\n  backend: literals(['rmux', 'tmux', 'native']),\n  state: literals(['running', 'completed']),\n  promoted: B,\n  startedAt: S,\n  logPath: S,\n  exit: O(\n    Type.Object({\n      reason: literals(['completed', 'failed', 'signaled', 'stopped', 'timed_out', 'launcher_error', 'backend_lost']),\n      code: Type.Union([N, Type.Null()]),\n      signal: Type.Union([S, Type.Null()]),\n      terminationReason: O(\n        literals([\n          'timeout',\n          'user_stop',\n          'request_cancelled',\n          'parent_session_cleanup',\n          'owner_lost',\n          'external_signal',\n        ]),\n      ),\n      stopReason: O(S),\n      finishedAt: S,\n    }),\n  ),\n});\nexport const RunnerPayloadSchema = Type.Object({ runs: Type.Array(Run) });\nexport const RunnerLogSchema = Type.Object({\n  runId: S,\n  running: B,\n  text: S,\n  lineCount: N,\n  totalLines: N,\n  fileSize: N,\n  completeBytes: N,\n  path: S,\n  exists: B,\n  lineNumbers: O(Type.Array(N)),\n});\nexport const RunnerAppendSchema = Type.Object({ lines: Type.Array(S), offset: O(N), ended: O(B) });\nexport const RunnerScreenSchema = Type.Object({ chunk: S, offset: O(N), ended: O(B) });\nexport const apiContracts = defineApiContract({\n  version: 1,\n  dynamic: [],\n  http: [\n    {\n      id: 'runner.log',\n      scope: 'session',\n      basePath: 'runner',\n      path: '/runners/{runId}/log',\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Read a runner log tail or literal substring search.',\n      parameters: ['lines', 'grep', 'ignoreCase', 'contextLines'].map((name) => ({\n        name,\n        in: 'query',\n        required: false,\n        schema: S,\n      })),\n      responses: jsonApiResponses(RunnerLogSchema),\n    },\n    ...(['log', 'screen'] as const).map((kind) => ({\n      id: `runner.${kind}.stream`,\n      scope: 'session' as const,\n      basePath: 'runner',\n      path: `/runners/{runId}/${kind}/stream`,\n      method: 'GET' as const,\n      authentication: 'owner' as const,\n      description: `Follow runner ${kind}. SSE data is JSON; ping events carry empty data.`,\n      parameters: [{ name: 'from', in: 'query' as const, required: false, schema: N }],\n      responses: {\n        '200': {\n          description: 'Event stream.',\n          contentType: 'text/event-stream',\n          schema: S,\n          events: {\n            [kind === 'log' ? 'append' : 'screen']: kind === 'log' ? RunnerAppendSchema : RunnerScreenSchema,\n            ping: Type.Literal(''),\n          },\n        },\n        '404': { description: 'Runner unavailable.', schema: Type.Object({ error: S }) },\n      },\n    })),\n    {\n      id: 'runner.input',\n      scope: 'session',\n      basePath: 'runner',\n      path: '/runners/{runId}/screen/input',\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Send text to an interactive runner.',\n      body: {\n        required: true,\n        contentType: 'application/json',\n        schema: Type.Object({ text: Type.String({ minLength: 1 }) }),\n      },\n      responses: jsonApiResponses(Type.Object({ delivered: Type.Literal(true) })),\n    },\n  ],\n  sockets: (['global', 'workspace'] as const).map((scope) => ({\n    id: 'runner.channel',\n    scope,\n    service: 'po.hub',\n    member: 'runner_runs',\n    kind: 'channel',\n    direction: 'server-to-client',\n    description: 'Runner channel payload in the hub frame payload property.',\n    input: RunnerPayloadSchema,\n  })),\n});\nexport default apiContracts;\n"],"mappings":"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"}
+{"version":3,"file":"apiContracts.cjs","names":["Type","defineApiContract","jsonApiResponses"],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract, jsonApiResponses } from '@agimon-ai/po-core/apiContracts';\nimport { Type } from 'typebox';\n\nconst S = Type.String();\nconst N = Type.Number();\nconst B = Type.Boolean();\nconst O = Type.Optional;\nconst literals = <T extends string>(values: T[]) => Type.Union(values.map((value) => Type.Literal(value)));\nconst Run = Type.Object({\n  id: S,\n  name: S,\n  pid: N,\n  command: S,\n  cwd: S,\n  interactive: B,\n  backend: literals(['rmux', 'tmux', 'native']),\n  state: literals(['running', 'completed']),\n  promoted: B,\n  startedAt: S,\n  logPath: S,\n  exit: O(\n    Type.Object({\n      reason: literals(['completed', 'failed', 'signaled', 'stopped', 'timed_out', 'launcher_error', 'backend_lost']),\n      code: Type.Union([N, Type.Null()]),\n      signal: Type.Union([S, Type.Null()]),\n      terminationReason: O(\n        literals([\n          'timeout',\n          'user_stop',\n          'request_cancelled',\n          'parent_session_cleanup',\n          'owner_lost',\n          'external_signal',\n        ]),\n      ),\n      stopReason: O(S),\n      finishedAt: S,\n    }),\n  ),\n});\nexport const RunnerPayloadSchema = Type.Object({\n  runs: Type.Array(Run),\n  sessionDirectory: O(S),\n  startFailure: O(Type.Object({ id: S, message: S })),\n});\nexport const RunnerLogSchema = Type.Object({\n  runId: S,\n  running: B,\n  text: S,\n  lineCount: N,\n  totalLines: N,\n  fileSize: N,\n  completeBytes: N,\n  path: S,\n  exists: B,\n  lineNumbers: O(Type.Array(N)),\n});\nexport const RunnerAppendSchema = Type.Object({ lines: Type.Array(S), offset: O(N), ended: O(B) });\nexport const RunnerScreenSchema = Type.Object({ chunk: S, offset: O(N), ended: O(B) });\nexport const RunnerOutputSchema = Type.Object({\n  chunk: Type.String({ contentEncoding: 'base64' }),\n  offset: Type.Integer({ minimum: 0, maximum: Number.MAX_SAFE_INTEGER }),\n  reset: B,\n  generation: O(S),\n  exists: B,\n  hasMore: B,\n  ended: B,\n});\nexport const apiContracts = defineApiContract({\n  version: 1,\n  dynamic: [],\n  http: [\n    {\n      id: 'runner.log',\n      scope: 'session',\n      basePath: 'runner',\n      path: '/runners/{runId}/log',\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Read a runner log tail or literal substring search.',\n      parameters: ['lines', 'grep', 'ignoreCase', 'contextLines'].map((name) => ({\n        name,\n        in: 'query',\n        required: false,\n        schema: S,\n      })),\n      responses: jsonApiResponses(RunnerLogSchema),\n    },\n    ...(['log', 'screen'] as const).map((kind) => ({\n      id: `runner.${kind}.read`,\n      scope: 'session' as const,\n      basePath: 'runner',\n      path: `/runners/{runId}/${kind}/read`,\n      method: 'GET' as const,\n      authentication: 'owner' as const,\n      description: `Read at most 64 KiB of session-owned runner ${kind} bytes as base64. A completed runner remains readable; screen reads require an owned interactive multiplexer pane.`,\n      parameters: [\n        {\n          name: 'from',\n          in: 'query' as const,\n          required: false,\n          schema: Type.Integer({ minimum: 0, maximum: Number.MAX_SAFE_INTEGER }),\n        },\n        ...(kind === 'screen' ? [{ name: 'generation', in: 'query' as const, required: false, schema: S }] : []),\n      ],\n      responses: jsonApiResponses(RunnerOutputSchema),\n    })),\n    ...(['log', 'screen'] as const).map((kind) => ({\n      id: `runner.${kind}.stream`,\n      scope: 'session' as const,\n      basePath: 'runner',\n      path: `/runners/{runId}/${kind}/stream`,\n      method: 'GET' as const,\n      authentication: 'owner' as const,\n      description: `Follow runner ${kind}. SSE data is JSON; ping events carry empty data.`,\n      parameters: [{ name: 'from', in: 'query' as const, required: false, schema: N }],\n      responses: {\n        '200': {\n          description: 'Event stream.',\n          contentType: 'text/event-stream',\n          schema: S,\n          events: {\n            [kind === 'log' ? 'append' : 'screen']: kind === 'log' ? RunnerAppendSchema : RunnerScreenSchema,\n            ping: Type.Literal(''),\n          },\n        },\n        '404': { description: 'Runner unavailable.', schema: Type.Object({ error: S }) },\n      },\n    })),\n    {\n      id: 'runner.input',\n      scope: 'session',\n      basePath: 'runner',\n      path: '/runners/{runId}/screen/input',\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Send text to an interactive runner.',\n      body: {\n        required: true,\n        contentType: 'application/json',\n        schema: Type.Object({ text: Type.String({ minLength: 1 }) }),\n      },\n      responses: jsonApiResponses(Type.Object({ delivered: Type.Literal(true) })),\n    },\n  ],\n  sockets: (['global', 'workspace'] as const).map((scope) => ({\n    id: 'runner.channel',\n    scope,\n    service: 'po.hub',\n    member: 'runner_runs',\n    kind: 'channel',\n    direction: 'server-to-client',\n    description: 'Runner channel payload in the hub frame payload property.',\n    input: RunnerPayloadSchema,\n  })),\n});\nexport default apiContracts;\n"],"mappings":"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"}

package/dist/apiContracts.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"apiContracts.d.mts","names":[],"sources":["../src/schemas/apiContracts.ts"],"mappings":";;qBAuDa"}
+{"version":3,"file":"apiContracts.d.mts","names":[],"sources":["../src/schemas/apiContracts.ts"],"mappings":";;qBAoEa"}

package/dist/apiContracts.mjs

@@ -46,7 +46,14 @@ const Run = Type.Object({
 		finishedAt: S
 	}))
 });
-const RunnerPayloadSchema = Type.Object({ runs: Type.Array(Run) });
+const RunnerPayloadSchema = Type.Object({
+	runs: Type.Array(Run),
+	sessionDirectory: O(S),
+	startFailure: O(Type.Object({
+		id: S,
+		message: S
+	}))
+});
 const RunnerLogSchema = Type.Object({
 	runId: S,
 	running: B,
@@ -69,6 +76,18 @@ const RunnerScreenSchema = Type.Object({
 	offset: O(N),
 	ended: O(B)
 });
+const RunnerOutputSchema = Type.Object({
+	chunk: Type.String({ contentEncoding: "base64" }),
+	offset: Type.Integer({
+		minimum: 0,
+		maximum: Number.MAX_SAFE_INTEGER
+	}),
+	reset: B,
+	generation: O(S),
+	exists: B,
+	hasMore: B,
+	ended: B
+});
 const apiContracts = defineApiContract({
 	version: 1,
 	dynamic: [],
@@ -94,6 +113,30 @@ const apiContracts = defineApiContract({
 			})),
 			responses: jsonApiResponses(RunnerLogSchema)
 		},
+		...["log", "screen"].map((kind) => ({
+			id: `runner.${kind}.read`,
+			scope: "session",
+			basePath: "runner",
+			path: `/runners/{runId}/${kind}/read`,
+			method: "GET",
+			authentication: "owner",
+			description: `Read at most 64 KiB of session-owned runner ${kind} bytes as base64. A completed runner remains readable; screen reads require an owned interactive multiplexer pane.`,
+			parameters: [{
+				name: "from",
+				in: "query",
+				required: false,
+				schema: Type.Integer({
+					minimum: 0,
+					maximum: Number.MAX_SAFE_INTEGER
+				})
+			}, ...kind === "screen" ? [{
+				name: "generation",
+				in: "query",
+				required: false,
+				schema: S
+			}] : []],
+			responses: jsonApiResponses(RunnerOutputSchema)
+		})),
 		...["log", "screen"].map((kind) => ({
 			id: `runner.${kind}.stream`,
 			scope: "session",

package/dist/apiContracts.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"apiContracts.mjs","names":[],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract, jsonApiResponses } from '@agimon-ai/po-core/apiContracts';\nimport { Type } from 'typebox';\n\nconst S = Type.String();\nconst N = Type.Number();\nconst B = Type.Boolean();\nconst O = Type.Optional;\nconst literals = <T extends string>(values: T[]) => Type.Union(values.map((value) => Type.Literal(value)));\nconst Run = Type.Object({\n  id: S,\n  name: S,\n  pid: N,\n  command: S,\n  cwd: S,\n  interactive: B,\n  backend: literals(['rmux', 'tmux', 'native']),\n  state: literals(['running', 'completed']),\n  promoted: B,\n  startedAt: S,\n  logPath: S,\n  exit: O(\n    Type.Object({\n      reason: literals(['completed', 'failed', 'signaled', 'stopped', 'timed_out', 'launcher_error', 'backend_lost']),\n      code: Type.Union([N, Type.Null()]),\n      signal: Type.Union([S, Type.Null()]),\n      terminationReason: O(\n        literals([\n          'timeout',\n          'user_stop',\n          'request_cancelled',\n          'parent_session_cleanup',\n          'owner_lost',\n          'external_signal',\n        ]),\n      ),\n      stopReason: O(S),\n      finishedAt: S,\n    }),\n  ),\n});\nexport const RunnerPayloadSchema = Type.Object({ runs: Type.Array(Run) });\nexport const RunnerLogSchema = Type.Object({\n  runId: S,\n  running: B,\n  text: S,\n  lineCount: N,\n  totalLines: N,\n  fileSize: N,\n  completeBytes: N,\n  path: S,\n  exists: B,\n  lineNumbers: O(Type.Array(N)),\n});\nexport const RunnerAppendSchema = Type.Object({ lines: Type.Array(S), offset: O(N), ended: O(B) });\nexport const RunnerScreenSchema = Type.Object({ chunk: S, offset: O(N), ended: O(B) });\nexport const apiContracts = defineApiContract({\n  version: 1,\n  dynamic: [],\n  http: [\n    {\n      id: 'runner.log',\n      scope: 'session',\n      basePath: 'runner',\n      path: '/runners/{runId}/log',\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Read a runner log tail or literal substring search.',\n      parameters: ['lines', 'grep', 'ignoreCase', 'contextLines'].map((name) => ({\n        name,\n        in: 'query',\n        required: false,\n        schema: S,\n      })),\n      responses: jsonApiResponses(RunnerLogSchema),\n    },\n    ...(['log', 'screen'] as const).map((kind) => ({\n      id: `runner.${kind}.stream`,\n      scope: 'session' as const,\n      basePath: 'runner',\n      path: `/runners/{runId}/${kind}/stream`,\n      method: 'GET' as const,\n      authentication: 'owner' as const,\n      description: `Follow runner ${kind}. SSE data is JSON; ping events carry empty data.`,\n      parameters: [{ name: 'from', in: 'query' as const, required: false, schema: N }],\n      responses: {\n        '200': {\n          description: 'Event stream.',\n          contentType: 'text/event-stream',\n          schema: S,\n          events: {\n            [kind === 'log' ? 'append' : 'screen']: kind === 'log' ? RunnerAppendSchema : RunnerScreenSchema,\n            ping: Type.Literal(''),\n          },\n        },\n        '404': { description: 'Runner unavailable.', schema: Type.Object({ error: S }) },\n      },\n    })),\n    {\n      id: 'runner.input',\n      scope: 'session',\n      basePath: 'runner',\n      path: '/runners/{runId}/screen/input',\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Send text to an interactive runner.',\n      body: {\n        required: true,\n        contentType: 'application/json',\n        schema: Type.Object({ text: Type.String({ minLength: 1 }) }),\n      },\n      responses: jsonApiResponses(Type.Object({ delivered: Type.Literal(true) })),\n    },\n  ],\n  sockets: (['global', 'workspace'] as const).map((scope) => ({\n    id: 'runner.channel',\n    scope,\n    service: 'po.hub',\n    member: 'runner_runs',\n    kind: 'channel',\n    direction: 'server-to-client',\n    description: 'Runner channel payload in the hub frame payload property.',\n    input: RunnerPayloadSchema,\n  })),\n});\nexport default apiContracts;\n"],"mappings":"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"}
+{"version":3,"file":"apiContracts.mjs","names":[],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract, jsonApiResponses } from '@agimon-ai/po-core/apiContracts';\nimport { Type } from 'typebox';\n\nconst S = Type.String();\nconst N = Type.Number();\nconst B = Type.Boolean();\nconst O = Type.Optional;\nconst literals = <T extends string>(values: T[]) => Type.Union(values.map((value) => Type.Literal(value)));\nconst Run = Type.Object({\n  id: S,\n  name: S,\n  pid: N,\n  command: S,\n  cwd: S,\n  interactive: B,\n  backend: literals(['rmux', 'tmux', 'native']),\n  state: literals(['running', 'completed']),\n  promoted: B,\n  startedAt: S,\n  logPath: S,\n  exit: O(\n    Type.Object({\n      reason: literals(['completed', 'failed', 'signaled', 'stopped', 'timed_out', 'launcher_error', 'backend_lost']),\n      code: Type.Union([N, Type.Null()]),\n      signal: Type.Union([S, Type.Null()]),\n      terminationReason: O(\n        literals([\n          'timeout',\n          'user_stop',\n          'request_cancelled',\n          'parent_session_cleanup',\n          'owner_lost',\n          'external_signal',\n        ]),\n      ),\n      stopReason: O(S),\n      finishedAt: S,\n    }),\n  ),\n});\nexport const RunnerPayloadSchema = Type.Object({\n  runs: Type.Array(Run),\n  sessionDirectory: O(S),\n  startFailure: O(Type.Object({ id: S, message: S })),\n});\nexport const RunnerLogSchema = Type.Object({\n  runId: S,\n  running: B,\n  text: S,\n  lineCount: N,\n  totalLines: N,\n  fileSize: N,\n  completeBytes: N,\n  path: S,\n  exists: B,\n  lineNumbers: O(Type.Array(N)),\n});\nexport const RunnerAppendSchema = Type.Object({ lines: Type.Array(S), offset: O(N), ended: O(B) });\nexport const RunnerScreenSchema = Type.Object({ chunk: S, offset: O(N), ended: O(B) });\nexport const RunnerOutputSchema = Type.Object({\n  chunk: Type.String({ contentEncoding: 'base64' }),\n  offset: Type.Integer({ minimum: 0, maximum: Number.MAX_SAFE_INTEGER }),\n  reset: B,\n  generation: O(S),\n  exists: B,\n  hasMore: B,\n  ended: B,\n});\nexport const apiContracts = defineApiContract({\n  version: 1,\n  dynamic: [],\n  http: [\n    {\n      id: 'runner.log',\n      scope: 'session',\n      basePath: 'runner',\n      path: '/runners/{runId}/log',\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Read a runner log tail or literal substring search.',\n      parameters: ['lines', 'grep', 'ignoreCase', 'contextLines'].map((name) => ({\n        name,\n        in: 'query',\n        required: false,\n        schema: S,\n      })),\n      responses: jsonApiResponses(RunnerLogSchema),\n    },\n    ...(['log', 'screen'] as const).map((kind) => ({\n      id: `runner.${kind}.read`,\n      scope: 'session' as const,\n      basePath: 'runner',\n      path: `/runners/{runId}/${kind}/read`,\n      method: 'GET' as const,\n      authentication: 'owner' as const,\n      description: `Read at most 64 KiB of session-owned runner ${kind} bytes as base64. A completed runner remains readable; screen reads require an owned interactive multiplexer pane.`,\n      parameters: [\n        {\n          name: 'from',\n          in: 'query' as const,\n          required: false,\n          schema: Type.Integer({ minimum: 0, maximum: Number.MAX_SAFE_INTEGER }),\n        },\n        ...(kind === 'screen' ? [{ name: 'generation', in: 'query' as const, required: false, schema: S }] : []),\n      ],\n      responses: jsonApiResponses(RunnerOutputSchema),\n    })),\n    ...(['log', 'screen'] as const).map((kind) => ({\n      id: `runner.${kind}.stream`,\n      scope: 'session' as const,\n      basePath: 'runner',\n      path: `/runners/{runId}/${kind}/stream`,\n      method: 'GET' as const,\n      authentication: 'owner' as const,\n      description: `Follow runner ${kind}. SSE data is JSON; ping events carry empty data.`,\n      parameters: [{ name: 'from', in: 'query' as const, required: false, schema: N }],\n      responses: {\n        '200': {\n          description: 'Event stream.',\n          contentType: 'text/event-stream',\n          schema: S,\n          events: {\n            [kind === 'log' ? 'append' : 'screen']: kind === 'log' ? RunnerAppendSchema : RunnerScreenSchema,\n            ping: Type.Literal(''),\n          },\n        },\n        '404': { description: 'Runner unavailable.', schema: Type.Object({ error: S }) },\n      },\n    })),\n    {\n      id: 'runner.input',\n      scope: 'session',\n      basePath: 'runner',\n      path: '/runners/{runId}/screen/input',\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Send text to an interactive runner.',\n      body: {\n        required: true,\n        contentType: 'application/json',\n        schema: Type.Object({ text: Type.String({ minLength: 1 }) }),\n      },\n      responses: jsonApiResponses(Type.Object({ delivered: Type.Literal(true) })),\n    },\n  ],\n  sockets: (['global', 'workspace'] as const).map((scope) => ({\n    id: 'runner.channel',\n    scope,\n    service: 'po.hub',\n    member: 'runner_runs',\n    kind: 'channel',\n    direction: 'server-to-client',\n    description: 'Runner channel payload in the hub frame payload property.',\n    input: RunnerPayloadSchema,\n  })),\n});\nexport default apiContracts;\n"],"mappings":"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"}

package/dist/{bashResult-BVaoDLYO.cjs → bashResult-CxttmwR5.cjs}

@@ -446,7 +446,7 @@ function formatUptime(startedAt, now) {
 }
 const PROMOTION_REASONS = {
 	requested: "Started in the background",
-	threshold: "Still running after the background threshold",
+	threshold: "Over the background threshold",
 	interactive: "Started interactively"
 };
 function completionFailed(result) {
@@ -464,12 +464,13 @@ const emptyLogSummary = () => ({
 	lines: 0,
 	tailLines: 0
 });
-function formatRunResult(result, budget = {}, summarizeLog = emptyLogSummary, settings, environment = process.env) {
+function formatRunResult(result, budget = {}, summarizeLog = emptyLogSummary, settings, environment = process.env, throwOnFailure = true) {
 	if (result.kind === "failed") throw new Error([`Could not start runner "${result.name}": ${result.error}`, "Next: correct the reported launch or supervision problem. Retry only after changing the command or environment."].join("\n"));
 	if (result.kind === "promoted") return textResult([
-		`${PROMOTION_REASONS[result.reason]}: runner "${result.name}" (${result.id}).`,
+		`${PROMOTION_REASONS[result.reason]}: runner "${result.name}" (${result.id}) is running in the background.`,
+		"Its exit is reported here when it finishes; no need to poll.",
 		`Streaming log: ${result.logPath}`,
-		`Inspect: po-runner logs ${result.id}`
+		`Status: po-runner logs ${result.id}`
 	].join("\n"), {
 		id: result.id,
 		runner: result.name,
@@ -537,7 +538,7 @@ function formatRunResult(result, budget = {}, summarizeLog = emptyLogSummary, se
 		...result.rtkWarning ? { rtkWarning: result.rtkWarning } : {},
 		...result.timedOut ? { timedOut: true } : {}
 	};
-	if (failed) throw new Error(text);
+	if (failed && throwOnFailure) throw new Error(text);
 	return textResult(text, details);
 }
 //#endregion
@@ -626,4 +627,4 @@ Object.defineProperty(exports, "textResult", {
 	}
 });
 
-//# sourceMappingURL=bashResult-BVaoDLYO.cjs.map
+//# sourceMappingURL=bashResult-CxttmwR5.cjs.map