@agimon-ai/po-runner 0.0.0-alpha.3 → 0.0.0-alpha.31

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).
 
@@ -29,11 +29,11 @@ Panes come from the first backend that answers: bundled RMUX, then `rmux` on PAT
 PATH. Only when none is available does a non-interactive command fall back to a supervised
 subprocess, and interactive commands need one of them. A tmux-backed run is supervised by the same
 host process as an RMUX one, so exit metadata and logs behave the same; its session names carry a
-`doom-tmux-` prefix rather than `doom-runner-`.
+`po-tmux-` prefix rather than `po-runner-`.
 
 ## Install
 
-`po init` and `dpi init` include Runner in `default.packages` in `.po/modes.yaml`. Move
+`po init` include Runner in `default.packages` in `.po/modes.yaml`. Move
 it to a named layer to enable it only in selected major modes.
 
 ## Use the `bash` tool
@@ -49,8 +49,24 @@ 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.
+Pass an array to run dependent commands in separate fresh shells, sequentially and fail-fast:
+
+```json
+{
+  "command": ["pnpm build", "pnpm typecheck", "pnpm lint", "pnpm test"],
+  "name": "verification",
+  "timeout": 120
+}
+```
+
+Arrays are noninteractive. 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,15 +79,30 @@ also returns bounded raw output with a warning and does not change the command e
 
 ## Inspect and control runs
 
-The `doom-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
-doom-runner list
-doom-runner status <runner-id>
-doom-runner logs <runner-id>
-doom-runner input <runner-id> --text "y" --enter
-doom-runner stop <runner-id>
-doom-runner stop-all
+po-runner list
+po-runner status <runner-id>
+po-runner logs <runner-id>
+po-runner input <runner-id> --text "y" --enter
+po-runner stop <runner-id>
+po-runner stop-all
 ```
 
 The `input` command requires a running interactive process backed by RMUX or tmux.
@@ -80,15 +111,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/doom-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.
+Runner automatically saves complete command output, so do not add redirects just to preserve it.
+Inspect saved logs when an excerpt is truncated instead of rerunning the command. Result limits and
+the promotion threshold remain environment-configurable.
 
 ### Result excerpts
 
@@ -109,7 +142,7 @@ Compiling 1200 modules...
   compiled src/module-599.ts
 Build succeeded in 12.4s
 exit status 0
-Full log: /path/to/run.log (17.0 KB, 604 lines); inspect with doom-runner logs run-a
+Full log: /path/to/run.log (17.0 KB, 604 lines); inspect with po-runner logs run-a
 ```
 
 Three ceilings apply and whichever binds first wins: bytes, lines, and tokens. Tokens are there
@@ -123,8 +156,8 @@ estimator models how BPE behaves, with punctuation forcing boundaries, natural w
 letter-digit runs expensive. Its worst error against `gpt-tokenizer` is a factor of about 1.46
 either way, which is why the byte ceiling stays behind it as the hard bound.
 
-`DOOM_RUNNER_RESULT_MAX_BYTES`, `DOOM_RUNNER_RESULT_MAX_TOKENS`, and their
-`DOOM_RUNNER_SUCCESS_*` counterparts move these for one invocation. A pragma overrides all of
+`PO_RUNNER_RESULT_MAX_BYTES`, `PO_RUNNER_RESULT_MAX_TOKENS`, and their
+`PO_RUNNER_SUCCESS_*` counterparts move these for one invocation. A pragma overrides all of
 them, which is how one noisy successful command can still ask for the wider result. Raising only
 `maxResultBytes` will not help when the token ceiling is the one binding.
 
@@ -151,7 +184,7 @@ One command that needs a wider result can say so on its first line. The pragma i
 so it stays harmless to the command itself:
 
 ```bash
-# @doom: {"maxResultBytes": 32768, "maxResultTokens": 8192, "maxResultLines": 300}
+# @po: {"maxResultBytes": 32768, "maxResultTokens": 8192, "maxResultLines": 300}
 pnpm build
 ```
 
@@ -186,7 +219,7 @@ retention accordingly.
 
 The headless Po server shares one heavy-job queue across its sessions. Known
 noninteractive build, test, lint, and typecheck commands acquire a slot before
-launching. The default is two concurrent jobs; set `DOOM_RUNNER_MAX_HEAVY_JOBS`
+launching. The default is two concurrent jobs; set `PO_RUNNER_MAX_HEAVY_JOBS`
 to a positive integer in the server's environment to change it. The waiting queue
 is bounded to 128 jobs. Cancellation removes queued work without launching it.
 
@@ -246,7 +279,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 +287,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,

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 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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"}

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":";;qBA2Da"}

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,

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 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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"}

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

@@ -1,9 +1,9 @@
 const require_ansiScrub = require("./ansiScrub-D5gpHDch.cjs");
-const require_runnerConfig = require("./runnerConfig-D2tGq5ZM.cjs");
+const require_runnerConfig = require("./runnerConfig-BoLMinlx.cjs");
 //#region src/constants/bashResult.ts
 const BYTES_PER_KB = 1024;
 const BYTES_PER_MB = 1048576;
-const PRAGMA_PATTERN = /^\s*(?:#|\/\/)\s*@doom:\s*(\{.*\})\s*$/u;
+const PRAGMA_PATTERN = /^\s*(?:#|\/\/)\s*@po:\s*(\{.*\})\s*$/u;
 const PRAGMA_BYTES_CEILING = 262144;
 const PRAGMA_LINES_CEILING = 5e3;
 const PRAGMA_TOKENS_CEILING = 1e5;
@@ -134,7 +134,7 @@ function positiveInteger(value) {
 	return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : void 0;
 }
 /**
-* Reads `# @doom: {"maxResultBytes": 32768}` from the command's first line.
+* Reads `# @po: {"maxResultBytes": 32768}` from the command's first line.
 *
 * The pragma is a shell comment, so it stays harmless if this parse is ever
 * skipped, and it survives verbatim into the log where a wider result can be
@@ -405,7 +405,7 @@ function composeExcerpt(headSource, tailSource, totalLines, maxLines = require_r
 	const salvaged = errorBytes > 0 ? renderSalvaged(errors, errorBytes, settings) : [];
 	return assembleSides(head, tail, Math.max(0, totalLines - head.count - tail.count), trailingNewline, limitBytes, salvaged);
 }
-/** Applies Doom's line and byte ceilings to text already held in memory. */
+/** Applies Po's line and byte ceilings to text already held in memory. */
 function summarizeText(text, maxLines = require_runnerConfig.getResultMaxLines(), maxBytes = require_runnerConfig.getResultMaxBytes()) {
 	const excerpt = boundExcerpt(text, maxLines, maxBytes);
 	return {
@@ -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: doom-runner logs ${result.id}`
+		`Status: po-runner logs ${result.id}`
 	].join("\n"), {
 		id: result.id,
 		runner: result.name,
@@ -516,7 +517,7 @@ function formatRunResult(result, budget = {}, summarizeLog = emptyLogSummary, se
 	if (result.rtkWarning) textLines.push(result.rtkWarning);
 	if (truncated) {
 		const label = result.rtkOutput ? "Complete raw log" : "Full log";
-		textLines.push(`${label}: ${result.logPath} (${formatSize(log.bytes)}, ${log.lines.toLocaleString("en-US")} lines); inspect with doom-runner logs ${result.id}`);
+		textLines.push(`${label}: ${result.logPath} (${formatSize(log.bytes)}, ${log.lines.toLocaleString("en-US")} lines); inspect with po-runner logs ${result.id}`);
 	} else if (failed && plainTail.length === 0) textLines.push(`Log: ${result.logPath}`, "Next: run one read-only diagnostic; retry only after correcting the cause.");
 	const text = boundResultText(textLines.join("\n"), maxBytes, settings, settings === void 0 ? void 0 : maxTokens);
 	const details = {
@@ -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-DNgtahGR.cjs.map
+//# sourceMappingURL=bashResult-CxttmwR5.cjs.map