@agimon-ai/po-workflow 0.0.0-alpha.2 → 0.0.0-alpha.21

package/LICENSE

@@ -1,29 +1,149 @@
-Portions of this software are licensed as follows:
-
-* The browser half of this package, meaning every ".web" routed file under
-  "src/extensions" and the "_components" and "_lib" modules colocated with
-  one, is licensed under the Po Web License defined in "LICENSE.web":
-  free to use, not to redistribute.
-* All other content is licensed under the MIT license below.
-
-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

@@ -69,7 +69,7 @@ recovery evidence. The default concurrency ceiling is five runs.
 
 Runs launched through a terminal
 host such as tmux or cmux can have a different lifetime and remain manageable from the CLI. When
-Team is loaded, Workflow contributes active session runs through Team's `doom/background-work`
+Team is loaded, Workflow contributes active session runs through Team's `po/background-work`
 service. That contribution reconnects after Team is replaced and is removed when Workflow unloads.
 Reconciliation distinguishes stale registry records from live processes; do not assume every run
 outlives its parent session.
@@ -133,9 +133,7 @@ The hub-side data source ships behind the `./web-hub` subpath and reads the work
 
 ## License
 
-MIT, except this package's browser half (the `.web` routed files under `src/extensions` and the
-`_components` and `_lib` modules colocated with one), which is source available under the Po
-Web License (see `LICENSE.web`): free to use, including commercially, but not to redistribute.
+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.
 
 ## Native execution contract
 

package/dist/apiContracts.cjs

@@ -28,6 +28,10 @@ const Step = {
 };
 const Run = typebox.Type.Object({
 	runKey: S,
+	routeKey: O(S),
+	runId: O(S),
+	ownerSessionId: O(S),
+	launcherSessionId: O(S),
 	workspace: S,
 	displayName: S,
 	workflowName: O(S),
@@ -337,7 +341,7 @@ const apiContracts = (0, _agimon_ai_po_core_apiContracts.defineApiContract)({
 	sockets: ["global", "workspace"].flatMap((scope) => [{
 		id: "workflow.runs",
 		scope,
-		service: "po.hub.v1",
+		service: "po.hub",
 		member: "workflow_runs",
 		kind: "channel",
 		direction: "server-to-client",
@@ -346,7 +350,7 @@ const apiContracts = (0, _agimon_ai_po_core_apiContracts.defineApiContract)({
 	}, {
 		id: "workflow.catalog",
 		scope,
-		service: "po.hub.v1",
+		service: "po.hub",
 		member: "workflow_catalog",
 		kind: "channel",
 		direction: "server-to-client",

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, type DoomHttpContract } 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 values = <T extends string>(items: T[]) => Type.Union(items.map((item) => Type.Literal(item)));\nconst Progress = values(['running', 'completed', 'skipped', 'failed', 'pause_requested', 'paused', 'resumed']);\nconst Step = { name: S, status: Progress, reason: O(S), group: O(S), startedAt: O(S), endedAt: O(S) };\nconst Run = Type.Object({\n  runKey: S,\n  workspace: S,\n  displayName: S,\n  workflowName: O(S),\n  workflowPath: S,\n  stage: values(['running', 'completed', 'error']),\n  outcome: O(values(['success', 'skipped', 'failed', 'interrupted'])),\n  executionState: O(values(['running', 'pause_requested', 'paused', 'resume_requested'])),\n  prompt: O(S),\n  startedAt: S,\n  finishedAt: O(S),\n  errorMessage: O(S),\n  failedJob: O(S),\n  stale: O(B),\n  staleReason: O(S),\n  worktreeBranch: O(S),\n  position: O(Type.Object({ job: S, step: O(S), index: O(N), total: O(N) })),\n  jobs: Type.Array(\n    Type.Object({\n      ...Step,\n      phase: values(['pre', 'job', 'post']),\n      index: O(N),\n      total: O(N),\n      steps: Type.Array(Type.Object(Step)),\n    }),\n  ),\n});\nexport const WorkflowRunsSchema = Type.Object({ runs: Type.Array(Run) });\nconst Artifact = { path: S, kind: values(['file', 'directory']), description: S, producedBy: Type.Array(S) };\nexport const WorkflowCatalogSchema = Type.Object({\n  cwd: S,\n  warning: O(S),\n  workflows: Type.Array(\n    Type.Object({\n      path: S,\n      relativePath: S,\n      name: S,\n      description: S,\n      tags: Type.Array(S),\n      triggers: Type.Array(S),\n      inputs: Type.Array(\n        Type.Object({\n          name: S,\n          description: O(S),\n          required: O(B),\n          default: O(S),\n          type: O(S),\n          options: O(Type.Array(S)),\n        }),\n      ),\n      jobs: Type.Array(Type.Object({ name: S, steps: Type.Array(S) })),\n      artifacts: Type.Array(Type.Object(Artifact)),\n      runners: O(Type.Array(S)),\n      commands: O(Type.Array(S)),\n      choices: O(Type.Array(S)),\n      error: O(S),\n    }),\n  ),\n});\nconst Screen = Type.Object({\n  lines: Type.Array(S),\n  capabilities: Type.Object({ readable: B, writable: B, resizable: B, reason: O(S) }),\n  ended: O(B),\n});\nconst Control = Type.Object({ held: B, token: O(S), reason: O(S) });\nconst root = '/runs/{workspace}/{runKey}';\nexport const apiContracts = defineApiContract({\n  version: 1,\n  dynamic: [],\n  http: (['global', 'workspace', 'session'] as const).flatMap((scope): DoomHttpContract[] => [\n    {\n      id: 'workflow.screen',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/screen/stream`,\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Follow the workflow terminal.',\n      responses: {\n        '200': {\n          description: 'SSE stream with JSON screen events.',\n          contentType: 'text/event-stream',\n          schema: S,\n          events: { screen: Screen },\n        },\n        '404': { description: 'Run unavailable.', schema: Type.Object({ error: S }) },\n      },\n    },\n    {\n      id: 'workflow.control',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/control`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Take or release the keyboard.',\n      body: { required: true, contentType: 'application/json', schema: Type.Object({ release: O(B), token: O(S) }) },\n      responses: { ...jsonApiResponses(Control), '409': { description: 'Keyboard unavailable.', schema: Control } },\n    },\n    {\n      id: 'workflow.keys',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/keys`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Write terminal data with the control token.',\n      body: { required: true, contentType: 'application/json', schema: Type.Object({ token: S, data: S }) },\n      responses: {\n        '204': { description: 'Data written.' },\n        '400': { description: 'Invalid request.', schema: Type.Object({ error: S }) },\n        '409': { description: 'Write refused.', schema: Type.Object({ error: S }) },\n      },\n    },\n    {\n      id: 'workflow.resize',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/resize`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Resize the terminal.',\n      body: { required: true, contentType: 'application/json', schema: Type.Object({ token: S, columns: N, rows: N }) },\n      responses: jsonApiResponses(Type.Object({ resized: B })),\n    },\n    {\n      id: 'workflow.delete',\n      scope,\n      basePath: 'workflow',\n      path: root,\n      method: 'DELETE',\n      authentication: 'owner',\n      description: 'Delete a settled run and its directory.',\n      responses: jsonApiResponses(Type.Object({ deleted: Type.Literal(true) })),\n    },\n    {\n      id: 'workflow.openRunDirectory',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/open-directory`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Open the registered run folder in Finder. Local callers only.',\n      responses: {\n        ...jsonApiResponses(Type.Object({ opened: Type.Literal(true) })),\n        '403': { description: 'Local caller required.', schema: Type.Object({ error: S }) },\n        '409': { description: 'Folder opening unavailable.', schema: Type.Object({ error: S }) },\n      },\n    },\n    {\n      id: 'workflow.artifacts',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/artifacts`,\n      method: 'GET',\n      authentication: 'owner',\n      description: 'List declared and discovered artifacts, or immediate children of a directory.',\n      parameters: [{ name: 'directory', in: 'query', required: false, schema: S }],\n      responses: jsonApiResponses(\n        Type.Object({\n          runDir: S,\n          description: S,\n          artifacts: Type.Array(\n            Type.Object({\n              ...Artifact,\n              declared: B,\n              state: values(['written', 'empty', 'pending', 'unreadable']),\n              size: O(N),\n              modifiedAt: O(S),\n            }),\n          ),\n        }),\n      ),\n    },\n    {\n      id: 'workflow.artifact',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/artifacts/{name}`,\n      method: 'GET',\n      authentication: 'owner',\n      description:\n        'Read artifact metadata and text. name may contain nested path segments. raw=1 streams binary with its media type and supports byte ranges.',\n      parameters: [\n        { name: 'raw', in: 'query', required: false, schema: values(['0', '1']) },\n        { name: 'download', in: 'query', required: false, schema: values(['0', '1']) },\n        { name: 'range', in: 'header', required: false, schema: S },\n      ],\n      responses: {\n        ...jsonApiResponses(\n          Type.Union([Type.Object({ path: S, size: N, modifiedAt: S, mimeType: O(S), text: O(S), truncated: B }), S]),\n        ),\n        '206': { description: 'Partial raw bytes.', contentType: 'application/octet-stream', schema: S },\n        '416': { description: 'Unsatisfiable byte range.' },\n      },\n    },\n  ]),\n  sockets: (['global', 'workspace'] as const).flatMap((scope) => [\n    {\n      id: 'workflow.runs',\n      scope,\n      service: 'po.hub.v1',\n      member: 'workflow_runs',\n      kind: 'channel',\n      direction: 'server-to-client',\n      description: 'Workflow runs channel payload.',\n      input: WorkflowRunsSchema,\n    },\n    {\n      id: 'workflow.catalog',\n      scope,\n      service: 'po.hub.v1',\n      member: 'workflow_catalog',\n      kind: 'channel',\n      direction: 'server-to-client',\n      description: 'Workflow catalog channel payload.',\n      input: WorkflowCatalogSchema,\n    },\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, type PoHttpContract } 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 values = <T extends string>(items: T[]) => Type.Union(items.map((item) => Type.Literal(item)));\nconst Progress = values(['running', 'completed', 'skipped', 'failed', 'pause_requested', 'paused', 'resumed']);\nconst Step = { name: S, status: Progress, reason: O(S), group: O(S), startedAt: O(S), endedAt: O(S) };\nconst Run = Type.Object({\n  runKey: S,\n  routeKey: O(S),\n  runId: O(S),\n  ownerSessionId: O(S),\n  launcherSessionId: O(S),\n  workspace: S,\n  displayName: S,\n  workflowName: O(S),\n  workflowPath: S,\n  stage: values(['running', 'completed', 'error']),\n  outcome: O(values(['success', 'skipped', 'failed', 'interrupted'])),\n  executionState: O(values(['running', 'pause_requested', 'paused', 'resume_requested'])),\n  prompt: O(S),\n  startedAt: S,\n  finishedAt: O(S),\n  errorMessage: O(S),\n  failedJob: O(S),\n  stale: O(B),\n  staleReason: O(S),\n  worktreeBranch: O(S),\n  position: O(Type.Object({ job: S, step: O(S), index: O(N), total: O(N) })),\n  jobs: Type.Array(\n    Type.Object({\n      ...Step,\n      phase: values(['pre', 'job', 'post']),\n      index: O(N),\n      total: O(N),\n      steps: Type.Array(Type.Object(Step)),\n    }),\n  ),\n});\nexport const WorkflowRunsSchema = Type.Object({ runs: Type.Array(Run) });\nconst Artifact = { path: S, kind: values(['file', 'directory']), description: S, producedBy: Type.Array(S) };\nexport const WorkflowCatalogSchema = Type.Object({\n  cwd: S,\n  warning: O(S),\n  workflows: Type.Array(\n    Type.Object({\n      path: S,\n      relativePath: S,\n      name: S,\n      description: S,\n      tags: Type.Array(S),\n      triggers: Type.Array(S),\n      inputs: Type.Array(\n        Type.Object({\n          name: S,\n          description: O(S),\n          required: O(B),\n          default: O(S),\n          type: O(S),\n          options: O(Type.Array(S)),\n        }),\n      ),\n      jobs: Type.Array(Type.Object({ name: S, steps: Type.Array(S) })),\n      artifacts: Type.Array(Type.Object(Artifact)),\n      runners: O(Type.Array(S)),\n      commands: O(Type.Array(S)),\n      choices: O(Type.Array(S)),\n      error: O(S),\n    }),\n  ),\n});\nconst Screen = Type.Object({\n  lines: Type.Array(S),\n  capabilities: Type.Object({ readable: B, writable: B, resizable: B, reason: O(S) }),\n  ended: O(B),\n});\nconst Control = Type.Object({ held: B, token: O(S), reason: O(S) });\nconst root = '/runs/{workspace}/{runKey}';\nexport const apiContracts = defineApiContract({\n  version: 1,\n  dynamic: [],\n  http: (['global', 'workspace', 'session'] as const).flatMap((scope): PoHttpContract[] => [\n    {\n      id: 'workflow.screen',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/screen/stream`,\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Follow the workflow terminal.',\n      responses: {\n        '200': {\n          description: 'SSE stream with JSON screen events.',\n          contentType: 'text/event-stream',\n          schema: S,\n          events: { screen: Screen },\n        },\n        '404': { description: 'Run unavailable.', schema: Type.Object({ error: S }) },\n      },\n    },\n    {\n      id: 'workflow.control',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/control`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Take or release the keyboard.',\n      body: { required: true, contentType: 'application/json', schema: Type.Object({ release: O(B), token: O(S) }) },\n      responses: { ...jsonApiResponses(Control), '409': { description: 'Keyboard unavailable.', schema: Control } },\n    },\n    {\n      id: 'workflow.keys',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/keys`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Write terminal data with the control token.',\n      body: { required: true, contentType: 'application/json', schema: Type.Object({ token: S, data: S }) },\n      responses: {\n        '204': { description: 'Data written.' },\n        '400': { description: 'Invalid request.', schema: Type.Object({ error: S }) },\n        '409': { description: 'Write refused.', schema: Type.Object({ error: S }) },\n      },\n    },\n    {\n      id: 'workflow.resize',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/resize`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Resize the terminal.',\n      body: { required: true, contentType: 'application/json', schema: Type.Object({ token: S, columns: N, rows: N }) },\n      responses: jsonApiResponses(Type.Object({ resized: B })),\n    },\n    {\n      id: 'workflow.delete',\n      scope,\n      basePath: 'workflow',\n      path: root,\n      method: 'DELETE',\n      authentication: 'owner',\n      description: 'Delete a settled run and its directory.',\n      responses: jsonApiResponses(Type.Object({ deleted: Type.Literal(true) })),\n    },\n    {\n      id: 'workflow.openRunDirectory',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/open-directory`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Open the registered run folder in Finder. Local callers only.',\n      responses: {\n        ...jsonApiResponses(Type.Object({ opened: Type.Literal(true) })),\n        '403': { description: 'Local caller required.', schema: Type.Object({ error: S }) },\n        '409': { description: 'Folder opening unavailable.', schema: Type.Object({ error: S }) },\n      },\n    },\n    {\n      id: 'workflow.artifacts',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/artifacts`,\n      method: 'GET',\n      authentication: 'owner',\n      description: 'List declared and discovered artifacts, or immediate children of a directory.',\n      parameters: [{ name: 'directory', in: 'query', required: false, schema: S }],\n      responses: jsonApiResponses(\n        Type.Object({\n          runDir: S,\n          description: S,\n          artifacts: Type.Array(\n            Type.Object({\n              ...Artifact,\n              declared: B,\n              state: values(['written', 'empty', 'pending', 'unreadable']),\n              size: O(N),\n              modifiedAt: O(S),\n            }),\n          ),\n        }),\n      ),\n    },\n    {\n      id: 'workflow.artifact',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/artifacts/{name}`,\n      method: 'GET',\n      authentication: 'owner',\n      description:\n        'Read artifact metadata and text. name may contain nested path segments. raw=1 streams binary with its media type and supports byte ranges.',\n      parameters: [\n        { name: 'raw', in: 'query', required: false, schema: values(['0', '1']) },\n        { name: 'download', in: 'query', required: false, schema: values(['0', '1']) },\n        { name: 'range', in: 'header', required: false, schema: S },\n      ],\n      responses: {\n        ...jsonApiResponses(\n          Type.Union([Type.Object({ path: S, size: N, modifiedAt: S, mimeType: O(S), text: O(S), truncated: B }), S]),\n        ),\n        '206': { description: 'Partial raw bytes.', contentType: 'application/octet-stream', schema: S },\n        '416': { description: 'Unsatisfiable byte range.' },\n      },\n    },\n  ]),\n  sockets: (['global', 'workspace'] as const).flatMap((scope) => [\n    {\n      id: 'workflow.runs',\n      scope,\n      service: 'po.hub',\n      member: 'workflow_runs',\n      kind: 'channel',\n      direction: 'server-to-client',\n      description: 'Workflow runs channel payload.',\n      input: WorkflowRunsSchema,\n    },\n    {\n      id: 'workflow.catalog',\n      scope,\n      service: 'po.hub',\n      member: 'workflow_catalog',\n      kind: 'channel',\n      direction: 'server-to-client',\n      description: 'Workflow catalog channel payload.',\n      input: WorkflowCatalogSchema,\n    },\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":";;qBA6Ea"}
+{"version":3,"file":"apiContracts.d.mts","names":[],"sources":["../src/schemas/apiContracts.ts"],"mappings":";;qBAiFa"}

package/dist/apiContracts.mjs

@@ -24,6 +24,10 @@ const Step = {
 };
 const Run = Type.Object({
 	runKey: S,
+	routeKey: O(S),
+	runId: O(S),
+	ownerSessionId: O(S),
+	launcherSessionId: O(S),
 	workspace: S,
 	displayName: S,
 	workflowName: O(S),
@@ -333,7 +337,7 @@ const apiContracts = defineApiContract({
 	sockets: ["global", "workspace"].flatMap((scope) => [{
 		id: "workflow.runs",
 		scope,
-		service: "po.hub.v1",
+		service: "po.hub",
 		member: "workflow_runs",
 		kind: "channel",
 		direction: "server-to-client",
@@ -342,7 +346,7 @@ const apiContracts = defineApiContract({
 	}, {
 		id: "workflow.catalog",
 		scope,
-		service: "po.hub.v1",
+		service: "po.hub",
 		member: "workflow_catalog",
 		kind: "channel",
 		direction: "server-to-client",

package/dist/apiContracts.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"apiContracts.mjs","names":[],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract, jsonApiResponses, type DoomHttpContract } 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 values = <T extends string>(items: T[]) => Type.Union(items.map((item) => Type.Literal(item)));\nconst Progress = values(['running', 'completed', 'skipped', 'failed', 'pause_requested', 'paused', 'resumed']);\nconst Step = { name: S, status: Progress, reason: O(S), group: O(S), startedAt: O(S), endedAt: O(S) };\nconst Run = Type.Object({\n  runKey: S,\n  workspace: S,\n  displayName: S,\n  workflowName: O(S),\n  workflowPath: S,\n  stage: values(['running', 'completed', 'error']),\n  outcome: O(values(['success', 'skipped', 'failed', 'interrupted'])),\n  executionState: O(values(['running', 'pause_requested', 'paused', 'resume_requested'])),\n  prompt: O(S),\n  startedAt: S,\n  finishedAt: O(S),\n  errorMessage: O(S),\n  failedJob: O(S),\n  stale: O(B),\n  staleReason: O(S),\n  worktreeBranch: O(S),\n  position: O(Type.Object({ job: S, step: O(S), index: O(N), total: O(N) })),\n  jobs: Type.Array(\n    Type.Object({\n      ...Step,\n      phase: values(['pre', 'job', 'post']),\n      index: O(N),\n      total: O(N),\n      steps: Type.Array(Type.Object(Step)),\n    }),\n  ),\n});\nexport const WorkflowRunsSchema = Type.Object({ runs: Type.Array(Run) });\nconst Artifact = { path: S, kind: values(['file', 'directory']), description: S, producedBy: Type.Array(S) };\nexport const WorkflowCatalogSchema = Type.Object({\n  cwd: S,\n  warning: O(S),\n  workflows: Type.Array(\n    Type.Object({\n      path: S,\n      relativePath: S,\n      name: S,\n      description: S,\n      tags: Type.Array(S),\n      triggers: Type.Array(S),\n      inputs: Type.Array(\n        Type.Object({\n          name: S,\n          description: O(S),\n          required: O(B),\n          default: O(S),\n          type: O(S),\n          options: O(Type.Array(S)),\n        }),\n      ),\n      jobs: Type.Array(Type.Object({ name: S, steps: Type.Array(S) })),\n      artifacts: Type.Array(Type.Object(Artifact)),\n      runners: O(Type.Array(S)),\n      commands: O(Type.Array(S)),\n      choices: O(Type.Array(S)),\n      error: O(S),\n    }),\n  ),\n});\nconst Screen = Type.Object({\n  lines: Type.Array(S),\n  capabilities: Type.Object({ readable: B, writable: B, resizable: B, reason: O(S) }),\n  ended: O(B),\n});\nconst Control = Type.Object({ held: B, token: O(S), reason: O(S) });\nconst root = '/runs/{workspace}/{runKey}';\nexport const apiContracts = defineApiContract({\n  version: 1,\n  dynamic: [],\n  http: (['global', 'workspace', 'session'] as const).flatMap((scope): DoomHttpContract[] => [\n    {\n      id: 'workflow.screen',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/screen/stream`,\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Follow the workflow terminal.',\n      responses: {\n        '200': {\n          description: 'SSE stream with JSON screen events.',\n          contentType: 'text/event-stream',\n          schema: S,\n          events: { screen: Screen },\n        },\n        '404': { description: 'Run unavailable.', schema: Type.Object({ error: S }) },\n      },\n    },\n    {\n      id: 'workflow.control',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/control`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Take or release the keyboard.',\n      body: { required: true, contentType: 'application/json', schema: Type.Object({ release: O(B), token: O(S) }) },\n      responses: { ...jsonApiResponses(Control), '409': { description: 'Keyboard unavailable.', schema: Control } },\n    },\n    {\n      id: 'workflow.keys',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/keys`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Write terminal data with the control token.',\n      body: { required: true, contentType: 'application/json', schema: Type.Object({ token: S, data: S }) },\n      responses: {\n        '204': { description: 'Data written.' },\n        '400': { description: 'Invalid request.', schema: Type.Object({ error: S }) },\n        '409': { description: 'Write refused.', schema: Type.Object({ error: S }) },\n      },\n    },\n    {\n      id: 'workflow.resize',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/resize`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Resize the terminal.',\n      body: { required: true, contentType: 'application/json', schema: Type.Object({ token: S, columns: N, rows: N }) },\n      responses: jsonApiResponses(Type.Object({ resized: B })),\n    },\n    {\n      id: 'workflow.delete',\n      scope,\n      basePath: 'workflow',\n      path: root,\n      method: 'DELETE',\n      authentication: 'owner',\n      description: 'Delete a settled run and its directory.',\n      responses: jsonApiResponses(Type.Object({ deleted: Type.Literal(true) })),\n    },\n    {\n      id: 'workflow.openRunDirectory',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/open-directory`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Open the registered run folder in Finder. Local callers only.',\n      responses: {\n        ...jsonApiResponses(Type.Object({ opened: Type.Literal(true) })),\n        '403': { description: 'Local caller required.', schema: Type.Object({ error: S }) },\n        '409': { description: 'Folder opening unavailable.', schema: Type.Object({ error: S }) },\n      },\n    },\n    {\n      id: 'workflow.artifacts',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/artifacts`,\n      method: 'GET',\n      authentication: 'owner',\n      description: 'List declared and discovered artifacts, or immediate children of a directory.',\n      parameters: [{ name: 'directory', in: 'query', required: false, schema: S }],\n      responses: jsonApiResponses(\n        Type.Object({\n          runDir: S,\n          description: S,\n          artifacts: Type.Array(\n            Type.Object({\n              ...Artifact,\n              declared: B,\n              state: values(['written', 'empty', 'pending', 'unreadable']),\n              size: O(N),\n              modifiedAt: O(S),\n            }),\n          ),\n        }),\n      ),\n    },\n    {\n      id: 'workflow.artifact',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/artifacts/{name}`,\n      method: 'GET',\n      authentication: 'owner',\n      description:\n        'Read artifact metadata and text. name may contain nested path segments. raw=1 streams binary with its media type and supports byte ranges.',\n      parameters: [\n        { name: 'raw', in: 'query', required: false, schema: values(['0', '1']) },\n        { name: 'download', in: 'query', required: false, schema: values(['0', '1']) },\n        { name: 'range', in: 'header', required: false, schema: S },\n      ],\n      responses: {\n        ...jsonApiResponses(\n          Type.Union([Type.Object({ path: S, size: N, modifiedAt: S, mimeType: O(S), text: O(S), truncated: B }), S]),\n        ),\n        '206': { description: 'Partial raw bytes.', contentType: 'application/octet-stream', schema: S },\n        '416': { description: 'Unsatisfiable byte range.' },\n      },\n    },\n  ]),\n  sockets: (['global', 'workspace'] as const).flatMap((scope) => [\n    {\n      id: 'workflow.runs',\n      scope,\n      service: 'po.hub.v1',\n      member: 'workflow_runs',\n      kind: 'channel',\n      direction: 'server-to-client',\n      description: 'Workflow runs channel payload.',\n      input: WorkflowRunsSchema,\n    },\n    {\n      id: 'workflow.catalog',\n      scope,\n      service: 'po.hub.v1',\n      member: 'workflow_catalog',\n      kind: 'channel',\n      direction: 'server-to-client',\n      description: 'Workflow catalog channel payload.',\n      input: WorkflowCatalogSchema,\n    },\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, type PoHttpContract } 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 values = <T extends string>(items: T[]) => Type.Union(items.map((item) => Type.Literal(item)));\nconst Progress = values(['running', 'completed', 'skipped', 'failed', 'pause_requested', 'paused', 'resumed']);\nconst Step = { name: S, status: Progress, reason: O(S), group: O(S), startedAt: O(S), endedAt: O(S) };\nconst Run = Type.Object({\n  runKey: S,\n  routeKey: O(S),\n  runId: O(S),\n  ownerSessionId: O(S),\n  launcherSessionId: O(S),\n  workspace: S,\n  displayName: S,\n  workflowName: O(S),\n  workflowPath: S,\n  stage: values(['running', 'completed', 'error']),\n  outcome: O(values(['success', 'skipped', 'failed', 'interrupted'])),\n  executionState: O(values(['running', 'pause_requested', 'paused', 'resume_requested'])),\n  prompt: O(S),\n  startedAt: S,\n  finishedAt: O(S),\n  errorMessage: O(S),\n  failedJob: O(S),\n  stale: O(B),\n  staleReason: O(S),\n  worktreeBranch: O(S),\n  position: O(Type.Object({ job: S, step: O(S), index: O(N), total: O(N) })),\n  jobs: Type.Array(\n    Type.Object({\n      ...Step,\n      phase: values(['pre', 'job', 'post']),\n      index: O(N),\n      total: O(N),\n      steps: Type.Array(Type.Object(Step)),\n    }),\n  ),\n});\nexport const WorkflowRunsSchema = Type.Object({ runs: Type.Array(Run) });\nconst Artifact = { path: S, kind: values(['file', 'directory']), description: S, producedBy: Type.Array(S) };\nexport const WorkflowCatalogSchema = Type.Object({\n  cwd: S,\n  warning: O(S),\n  workflows: Type.Array(\n    Type.Object({\n      path: S,\n      relativePath: S,\n      name: S,\n      description: S,\n      tags: Type.Array(S),\n      triggers: Type.Array(S),\n      inputs: Type.Array(\n        Type.Object({\n          name: S,\n          description: O(S),\n          required: O(B),\n          default: O(S),\n          type: O(S),\n          options: O(Type.Array(S)),\n        }),\n      ),\n      jobs: Type.Array(Type.Object({ name: S, steps: Type.Array(S) })),\n      artifacts: Type.Array(Type.Object(Artifact)),\n      runners: O(Type.Array(S)),\n      commands: O(Type.Array(S)),\n      choices: O(Type.Array(S)),\n      error: O(S),\n    }),\n  ),\n});\nconst Screen = Type.Object({\n  lines: Type.Array(S),\n  capabilities: Type.Object({ readable: B, writable: B, resizable: B, reason: O(S) }),\n  ended: O(B),\n});\nconst Control = Type.Object({ held: B, token: O(S), reason: O(S) });\nconst root = '/runs/{workspace}/{runKey}';\nexport const apiContracts = defineApiContract({\n  version: 1,\n  dynamic: [],\n  http: (['global', 'workspace', 'session'] as const).flatMap((scope): PoHttpContract[] => [\n    {\n      id: 'workflow.screen',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/screen/stream`,\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Follow the workflow terminal.',\n      responses: {\n        '200': {\n          description: 'SSE stream with JSON screen events.',\n          contentType: 'text/event-stream',\n          schema: S,\n          events: { screen: Screen },\n        },\n        '404': { description: 'Run unavailable.', schema: Type.Object({ error: S }) },\n      },\n    },\n    {\n      id: 'workflow.control',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/control`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Take or release the keyboard.',\n      body: { required: true, contentType: 'application/json', schema: Type.Object({ release: O(B), token: O(S) }) },\n      responses: { ...jsonApiResponses(Control), '409': { description: 'Keyboard unavailable.', schema: Control } },\n    },\n    {\n      id: 'workflow.keys',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/keys`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Write terminal data with the control token.',\n      body: { required: true, contentType: 'application/json', schema: Type.Object({ token: S, data: S }) },\n      responses: {\n        '204': { description: 'Data written.' },\n        '400': { description: 'Invalid request.', schema: Type.Object({ error: S }) },\n        '409': { description: 'Write refused.', schema: Type.Object({ error: S }) },\n      },\n    },\n    {\n      id: 'workflow.resize',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/resize`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Resize the terminal.',\n      body: { required: true, contentType: 'application/json', schema: Type.Object({ token: S, columns: N, rows: N }) },\n      responses: jsonApiResponses(Type.Object({ resized: B })),\n    },\n    {\n      id: 'workflow.delete',\n      scope,\n      basePath: 'workflow',\n      path: root,\n      method: 'DELETE',\n      authentication: 'owner',\n      description: 'Delete a settled run and its directory.',\n      responses: jsonApiResponses(Type.Object({ deleted: Type.Literal(true) })),\n    },\n    {\n      id: 'workflow.openRunDirectory',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/open-directory`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Open the registered run folder in Finder. Local callers only.',\n      responses: {\n        ...jsonApiResponses(Type.Object({ opened: Type.Literal(true) })),\n        '403': { description: 'Local caller required.', schema: Type.Object({ error: S }) },\n        '409': { description: 'Folder opening unavailable.', schema: Type.Object({ error: S }) },\n      },\n    },\n    {\n      id: 'workflow.artifacts',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/artifacts`,\n      method: 'GET',\n      authentication: 'owner',\n      description: 'List declared and discovered artifacts, or immediate children of a directory.',\n      parameters: [{ name: 'directory', in: 'query', required: false, schema: S }],\n      responses: jsonApiResponses(\n        Type.Object({\n          runDir: S,\n          description: S,\n          artifacts: Type.Array(\n            Type.Object({\n              ...Artifact,\n              declared: B,\n              state: values(['written', 'empty', 'pending', 'unreadable']),\n              size: O(N),\n              modifiedAt: O(S),\n            }),\n          ),\n        }),\n      ),\n    },\n    {\n      id: 'workflow.artifact',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/artifacts/{name}`,\n      method: 'GET',\n      authentication: 'owner',\n      description:\n        'Read artifact metadata and text. name may contain nested path segments. raw=1 streams binary with its media type and supports byte ranges.',\n      parameters: [\n        { name: 'raw', in: 'query', required: false, schema: values(['0', '1']) },\n        { name: 'download', in: 'query', required: false, schema: values(['0', '1']) },\n        { name: 'range', in: 'header', required: false, schema: S },\n      ],\n      responses: {\n        ...jsonApiResponses(\n          Type.Union([Type.Object({ path: S, size: N, modifiedAt: S, mimeType: O(S), text: O(S), truncated: B }), S]),\n        ),\n        '206': { description: 'Partial raw bytes.', contentType: 'application/octet-stream', schema: S },\n        '416': { description: 'Unsatisfiable byte range.' },\n      },\n    },\n  ]),\n  sockets: (['global', 'workspace'] as const).flatMap((scope) => [\n    {\n      id: 'workflow.runs',\n      scope,\n      service: 'po.hub',\n      member: 'workflow_runs',\n      kind: 'channel',\n      direction: 'server-to-client',\n      description: 'Workflow runs channel payload.',\n      input: WorkflowRunsSchema,\n    },\n    {\n      id: 'workflow.catalog',\n      scope,\n      service: 'po.hub',\n      member: 'workflow_catalog',\n      kind: 'channel',\n      direction: 'server-to-client',\n      description: 'Workflow catalog channel payload.',\n      input: WorkflowCatalogSchema,\n    },\n  ]),\n});\nexport default apiContracts;\n"],"mappings":"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"}

package/dist/extensions/native.mjs

@@ -6,6 +6,14 @@ import { Text } from "react-native-unistyles/components/native/Text";
 import { ScrollView } from "react-native-unistyles/components/native/ScrollView";
 import { StyleSheet } from "react-native-unistyles";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+//#region src/extensions/workspaces/(frontend)/fill/Workflows.home.native.ts
+var Workflows_home_native_default = defineFill({ data: {
+	version: 1,
+	label: "Workflows",
+	source: "workflow_runs",
+	destination: "workflows"
+} });
+//#endregion
 //#region src/types/webWorkflows.ts
 const WORKFLOW_RUNS_TYPE = "workflow_runs";
 const WORKFLOW_CATALOG_TYPE = "workflow_catalog";
@@ -29,7 +37,7 @@ function formatRunDuration(elapsedMs) {
 //#region src/extensions/workspaces/sessions/(frontend)/_lib/workflowActivity.ts
 const PAUSED_STATES = /* @__PURE__ */ new Set(["paused", "pause_requested"]);
 function workflowRunIdentity(run) {
-	return `${run.workspace}/${run.runKey}`;
+	return `${run.workspace}/${run.routeKey ?? run.runKey}`;
 }
 function toneOf(run) {
 	if (run.stage === "running") return run.executionState !== void 0 && PAUSED_STATES.has(run.executionState) ? "paused" : "running";
@@ -763,7 +771,7 @@ function useWorkflows(sessionId) {
 function workflowTab(run) {
 	const identity = workflowRunIdentity(run);
 	return {
-		id: `workflows-run-${run.workspace}-${run.runKey}`.replace(/[^\w-]+/g, "-"),
+		id: `workflows-run-${run.workspace}-${run.routeKey ?? run.runKey}`.replace(/[^\w-]+/g, "-"),
 		label: run.displayName,
 		retainComposer: true,
 		panel: (props) => /* @__PURE__ */ jsx(WorkflowPanel, {
@@ -1017,7 +1025,7 @@ function WorkflowPanel(props) {
 				variant: "danger-outline",
 				disabled: busy || props.sessionId === null,
 				onPress: () => void act(async () => {
-					const result = await stopWorkflowRun(run.workspace, run.runKey, props.sessionId);
+					const result = await stopWorkflowRun(run.workspace, run.routeKey ?? run.runKey, props.sessionId);
 					if ("error" in result) throw new Error(result.error);
 				}),
 				children: "Stop workflow"
@@ -1037,11 +1045,11 @@ function WorkflowPanel(props) {
 					variant: "danger-outline",
 					disabled: busy,
 					onPress: () => void act(async () => {
-						const result = await deleteWorkflowRun(run.workspace, run.runKey, props.sessionId);
+						const result = await deleteWorkflowRun(run.workspace, run.routeKey ?? run.runKey, props.sessionId);
 						if ("error" in result) throw new Error(result.error);
 						if (props.sessionId !== null) removeRun(props.sessionId, props.identity);
 						setConfirmDelete(false);
-						props.closeTransientTab(`workflows-run-${run.workspace}-${run.runKey}`.replace(/[^\w-]+/g, "-"));
+						props.closeTransientTab(`workflows-run-${run.workspace}-${run.routeKey ?? run.runKey}`.replace(/[^\w-]+/g, "-"));
 					}),
 					children: "Delete"
 				})] })] })
@@ -1051,7 +1059,7 @@ function WorkflowPanel(props) {
 }
 function stepTab(run, job, step) {
 	const workspace = run.workspace;
-	const runKey = run.runKey;
+	const runKey = run.routeKey ?? run.runKey;
 	return {
 		id: `workflows-step-${workspace}-${runKey}-${job}${step === void 0 ? "" : `-${step}`}`.replace(/[^\w-]+/g, "-"),
 		label: `${run.displayName} › ${step ?? job}`,
@@ -1065,7 +1073,7 @@ function stepTab(run, job, step) {
 	};
 }
 function WorkflowStep({ sessionId, workspace, runKey, job, step, renderSessionTranscript, renderRunnerTerminal }) {
-	const run = useWorkflows(sessionId).runs.find((item) => item.workspace === workspace && item.runKey === runKey);
+	const run = useWorkflows(sessionId).runs.find((item) => item.workspace === workspace && (item.routeKey ?? item.runKey) === runKey);
 	const steps = run?.jobs.find((item) => item.name === job)?.steps;
 	const target = step === void 0 ? steps?.at(-1) : steps?.find((item) => item.name === step);
 	const [message, setMessage] = useState("");
@@ -1244,7 +1252,7 @@ function WorkflowArtifacts(props) {
 	const [error, setError] = useState();
 	useEffect(() => {
 		let active = true;
-		fetchArtifacts(run.workspace, run.runKey, sessionId, directory).then((result) => {
+		fetchArtifacts(run.workspace, run.routeKey ?? run.runKey, sessionId, directory).then((result) => {
 			if (active) {
 				if ("error" in result) setError(result.error);
 				else {
@@ -1261,6 +1269,7 @@ function WorkflowArtifacts(props) {
 	}, [
 		run.workspace,
 		run.runKey,
+		run.routeKey,
 		sessionId,
 		directory,
 		run.stage
@@ -1283,7 +1292,7 @@ function WorkflowArtifacts(props) {
 					if (item.kind === "directory") setDirectory(item.path);
 					else {
 						const workspace = run.workspace;
-						const runKey = run.runKey;
+						const runKey = run.routeKey ?? run.runKey;
 						const path = item.path;
 						openTransientTab({
 							id: `workflows-artifact-${workspace}-${runKey}-${path}`.replace(/[^\w-]+/g, "-"),
@@ -1567,7 +1576,7 @@ function WorkflowsActivitySection({ sessionId, openSession, openTransientTab })
 						openSession(row.ownerSessionId);
 						return;
 					}
-					const run = state.runs.find((item) => `${item.workspace}/${item.runKey}` === row.identity);
+					const run = state.runs.find((item) => `${item.workspace}/${item.routeKey ?? item.runKey}` === row.identity);
 					if (sessionId !== null) focusRun(sessionId, row.identity);
 					if (run) openTransientTab(workflowTab(run));
 				},
@@ -1596,6 +1605,12 @@ const via = (identity, value) => value === void 0 ? void 0 : {
 };
 const nativePlugin = defineNativePlugin({
 	id: "workflows",
+	workspace: { get fills() {
+		return [via({
+			slot: "home",
+			id: "workflows"
+		}, Workflows_home_native_default)];
+	} },
 	session: {
 		get activityGroups() {
 			return [via({ name: "workflows" }, workflows_native_default)];