npm - @xopcai/xopc - Versions diffs - 0.0.150 → 0.0.151 - Mend

@xopcai/xopc 0.0.150 → 0.0.151

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (145) hide show

package/dist/gateway/static/root/index.html CHANGED Viewed

@@ -11,7 +11,7 @@
     <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png?v=20260713-1" />
     <link rel="manifest" href="/site.webmanifest?v=20260713-1" />
     <title>xopc</title>
-    <script type="module" crossorigin src="/assets/index-IPmCli0N.js"></script>
+    <script type="module" crossorigin src="/assets/index-apLU0Hun.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/rolldown-runtime-aKtaBQYM.js">
     <link rel="modulepreload" crossorigin href="/assets/preload-helper-zJ_50EbN.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-react-BOUWij0V.js">
@@ -24,14 +24,15 @@
     <link rel="modulepreload" crossorigin href="/assets/check-BODqo66o.js">
     <link rel="modulepreload" crossorigin href="/assets/circle-alert-RzVebuX2.js">
     <link rel="modulepreload" crossorigin href="/assets/middleware-Pd0e8Igk.js">
-    <link rel="modulepreload" crossorigin href="/assets/messages-BH7paqYt.js">
-    <link rel="modulepreload" crossorigin href="/assets/locale-store-BvcHGPHU.js">
+    <link rel="modulepreload" crossorigin href="/assets/messages-B0B40tpO.js">
+    <link rel="modulepreload" crossorigin href="/assets/locale-store-GfSwnwIZ.js">
+    <link rel="modulepreload" crossorigin href="/assets/schemas-DgQq6Z5S.js">
     <link rel="modulepreload" crossorigin href="/assets/config-reload-event-Bjh2zoKp.js">
     <link rel="modulepreload" crossorigin href="/assets/copy-to-clipboard-HOJ79TWv.js">
-    <link rel="modulepreload" crossorigin href="/assets/gateway-startup-retry-D0SU7dte.js">
-    <link rel="modulepreload" crossorigin href="/assets/activity-store-B3YP7y9d.js">
-    <link rel="modulepreload" crossorigin href="/assets/theme-store-EbMQ3TYi.js">
-    <link rel="stylesheet" crossorigin href="/assets/index-C46C7Xee.css">
+    <link rel="modulepreload" crossorigin href="/assets/gateway-startup-retry-BM_xvzl0.js">
+    <link rel="modulepreload" crossorigin href="/assets/activity-store-uu1xu9Pl.js">
+    <link rel="modulepreload" crossorigin href="/assets/theme-store-Bi6hMBDb.js">
+    <link rel="stylesheet" crossorigin href="/assets/index-DIlxvrlG.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/package.js CHANGED Viewed

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "0.0.150";
+var version = "0.0.151";
 //#endregion
 export { version };

package/dist/src/agent/agent-manager.d.ts CHANGED Viewed

@@ -88,6 +88,7 @@ export interface AgentManagerConfig {
     getNotesService?: () => NotesService | undefined;
     getProjectService?: () => ProjectService | undefined;
     getWorkItemService?: () => WorkItemService | undefined;
+    getLocalAppService?: () => import('../local-apps/index.js').LocalAppService | undefined;
     /** Gateway: starts persisted workflow runs (dedicated chat session per run). */
     getWorkflowRunService?: () => import('../workflows/service/workflow-run-service.types.js').WorkflowRunServiceLike | undefined;
     /** Runtime notification for UI/CLI shells that cache skill catalogs. */

package/dist/src/agent/agent-manager.js CHANGED Viewed

@@ -233,6 +233,7 @@ var AgentManager = class {
 			getNotesService: this.config.getNotesService,
 			getProjectService: this.config.getProjectService,
 			getWorkItemService: this.config.getWorkItemService,
+			getLocalAppService: this.config.getLocalAppService,
 			getWorkflowRunService: this.config.getWorkflowRunService,
 			getSkillIndexingContext: () => {
 				const ctx = this.config.getCurrentContext?.();

package/dist/src/agent/service.js CHANGED Viewed

@@ -231,6 +231,7 @@ var AgentService = class {
 			getNotesService: config.getNotesService,
 			getProjectService: config.getProjectService,
 			getWorkItemService: config.getWorkItemService,
+			getLocalAppService: config.getLocalAppService,
 			getWorkflowRunService: config.getWorkflowRunService,
 			onSkillsUpdated: config.onSkillsUpdated,
 			installSkillFromSource: (opts) => this.installSkillFromSource(opts),

package/dist/src/agent/service.types.d.ts CHANGED Viewed

@@ -6,6 +6,7 @@ import type { ExtensionRegistryImpl as ExtensionRegistry } from '../extensions/i
 import type { NotesService } from '../notes/index.js';
 import type { ProjectService } from '../projects/index.js';
 import type { WorkItemService } from '../work-items/index.js';
+import type { LocalAppService } from '../local-apps/index.js';
 import type { GatewayClarifyRequestFn } from './tools/clarify-tool.js';
 import type { ProgressStage } from './lifecycle/progress.js';
 import type { AgentSourceContextResolver } from './source-context/types.js';
@@ -31,6 +32,7 @@ export interface AgentServiceConfig {
     getNotesService?: () => NotesService | undefined;
     getProjectService?: () => ProjectService | undefined;
     getWorkItemService?: () => WorkItemService | undefined;
+    getLocalAppService?: () => LocalAppService | undefined;
     /**
      * Gateway: reuse the gateway `SessionManager` store so web API and agent share one index + files.
      * When omitted, `AgentService` creates its own `SessionStore` (CLI / embedded).

package/dist/src/agent/tool-manuals/xopc-use.d.ts CHANGED Viewed

	@@ -1 +1 @@
1	- export declare const xopcUseManual = "# XOPC Use Tool Manual\n\n## Overview\n\n`xopc_use` is the unified tool for operating XOPC product objects. Use it instead of editing storage files or database rows directly.\n\nBasic shape:\n\n```json\n{\n \"mode\": \"project \| note \| work_item\",\n \"command\": \"list \| get \| create \| update \| append \| preview_edit \| resolve_workspace\",\n \"args\": { \"...\": \"...\" },\n \"dryRun\": false\n}\n```\n\n## General Rules\n\n- Use `list` or `get` first when the target object is ambiguous.\n- Use `dryRun: true` before a broad or risky change.\n- Prefer additive operations over destructive replacement.\n- Do not invent ids. If an id is not known, search/list first.\n- Do not attempt delete/archive workflows through this tool unless the command is explicitly supported.\n- For non-trivial note rewrites, use `note.preview_edit` before `note.update`.\n\n## Projects\n\nProjects group sessions, work items, goals, workflows, files, and project instructions.\n\n### Find projects\n\n```json\n{ \"mode\": \"project\", \"command\": \"list\", \"args\": { \"search\": \"release\", \"limit\": 10 } }\n```\n\n### Read project detail\n\n```json\n{ \"mode\": \"project\", \"command\": \"get\", \"args\": { \"projectId\": \"project_id\" } }\n```\n\n### Create a project\n\nUse when the user asks to keep an outcome moving across conversations, or explicitly accepts an offer to do so. The user does not need to say \u201Cproject\u201D. Do not create one merely because a task is complex: continuity across sessions, files, decisions, or dependencies is the key signal. Include `workspaceRoot` when the work maps to a local repository or directory. Include `brief` for the desired outcome and `instructions` only for durable operating guidance.\n\n```json\n{\n \"mode\": \"project\",\n \"command\": \"create\",\n \"args\": {\n \"name\": \"AI Product Research\",\n \"workspaceRoot\": \"/path/to/repo\",\n \"brief\": \"Explore demand and feasibility for an AI product.\",\n \"instructions\": \"Keep decisions and open questions current.\"\n }\n}\n```\n\n### Update a project\n\nUse for metadata, brief, status, or instructions. Use `dryRun` first when changing `workspaceRoot` or broad instructions.\n\n```json\n{\n \"mode\": \"project\",\n \"command\": \"update\",\n \"args\": {\n \"projectId\": \"project_id\",\n \"status\": \"active\",\n \"instructions\": \"Prioritize safe previews before changing notes.\"\n }\n}\n```\n\n### Resolve workspace\n\nUse when a file path or current working directory should be mapped to a project.\n\n```json\n{\n \"mode\": \"project\",\n \"command\": \"resolve_workspace\",\n \"args\": { \"workspacePath\": \"/path/to/repo\", \"autoCreate\": false }\n}\n```\n\n## Notes\n\nNotes are user-owned markdown objects. Treat them as durable user content.\n\n### Find notes\n\n```json\n{ \"mode\": \"note\", \"command\": \"list\", \"args\": { \"search\": \"pricing\", \"limit\": 10 } }\n```\n\n### Create a note\n\n```json\n{\n \"mode\": \"note\",\n \"command\": \"create\",\n \"args\": {\n \"title\": \"Product direction\",\n \"markdown\": \"Initial notes...\",\n \"tags\": [\"product\"]\n }\n}\n```\n\n### Append to a note\n\nPrefer append when preserving original user notes and adding AI output.\n\n```json\n{\n \"mode\": \"note\",\n \"command\": \"append\",\n \"args\": {\n \"noteId\": \"note_id\",\n \"heading\": \"AI synthesis\",\n \"content\": \"Key points...\"\n }\n}\n```\n\n### Preview an edit\n\nUse before rewriting or restructuring a note.\n\n```json\n{\n \"mode\": \"note\",\n \"command\": \"preview_edit\",\n \"args\": {\n \"noteId\": \"note_id\",\n \"instruction\": \"Summarize this as action items\"\n }\n}\n```\n\n### Update a note\n\nUse only when the user clearly wants the canonical note changed. Prefer `append` or `preview_edit` otherwise.\n\n```json\n{\n \"mode\": \"note\",\n \"command\": \"update\",\n \"args\": {\n \"noteId\": \"note_id\",\n \"status\": \"processed\",\n \"tags\": [\"product\", \"validated\"]\n }\n}\n```\n\n## Work Items\n\nWork items are project-scoped tasks. If `projectId` is omitted, the tool may inherit the current session's project binding.\n\n### Create a work item\n\n```json\n{\n \"mode\": \"work_item\",\n \"command\": \"create\",\n \"args\": {\n \"projectId\": \"project_id\",\n \"title\": \"Validate technical feasibility\",\n \"description\": \"Check API, storage, UI, and safety implications.\",\n \"priority\": \"high\",\n \"status\": \"todo\"\n }\n}\n```\n\n### Update a work item\n\n```json\n{\n \"mode\": \"work_item\",\n \"command\": \"update\",\n \"args\": {\n \"workItemId\": \"work_item_id\",\n \"status\": \"in_progress\",\n \"nextAction\": \"Prototype the xopc_use tool path.\"\n }\n}\n```\n\n## Safety\n\n- `note.update` can replace canonical user content. Use `preview_edit` first for content rewrites.\n- `project.update.workspaceRoot` changes project-file scope. Use `dryRun` and ask the user if intent is unclear.\n- `work_item.update.archivedAt` hides work from normal active views. Confirm before archiving.\n- If the user asks for deletion, explain that deletion is not exposed through `xopc_use` yet.\n";
1	+ export declare const xopcUseManual = "# XOPC Use Tool Manual\n\n## Overview\n\n`xopc_use` is the unified tool for operating XOPC product objects. Use it instead of editing storage files or database rows directly.\n\nBasic shape:\n\n```json\n{\n \"mode\": \"project \| note \| work_item \| local_app \| settings\",\n \"command\": \"list \| get \| create \| update \| append \| preview_edit \| resolve_workspace \| validate \| open\",\n \"args\": { \"...\": \"...\" },\n \"dryRun\": false\n}\n```\n\n## General Rules\n\n- Use `list` or `get` first when the target object is ambiguous.\n- Use `dryRun: true` before a broad or risky change.\n- Prefer additive operations over destructive replacement.\n- Do not invent ids. If an id is not known, search/list first.\n- Do not attempt delete/archive workflows through this tool unless the command is explicitly supported.\n- For non-trivial note rewrites, use `note.preview_edit` before `note.update`.\n- Preserve the returned \u201COpen in xopc\u201D link in channel replies so the user can jump directly into the delivered object.\n\n## Projects\n\nProjects group sessions, work items, goals, workflows, files, and project instructions.\n\n### Find projects\n\n```json\n{ \"mode\": \"project\", \"command\": \"list\", \"args\": { \"search\": \"release\", \"limit\": 10 } }\n```\n\n### Read project detail\n\n```json\n{ \"mode\": \"project\", \"command\": \"get\", \"args\": { \"projectId\": \"project_id\" } }\n```\n\n### Create a project\n\nUse when the user asks to keep an outcome moving across conversations, or explicitly accepts an offer to do so. The user does not need to say \u201Cproject\u201D. Do not create one merely because a task is complex: continuity across sessions, files, decisions, or dependencies is the key signal. Include `workspaceRoot` when the work maps to a local repository or directory. Include `brief` for the desired outcome and `instructions` only for durable operating guidance.\n\n```json\n{\n \"mode\": \"project\",\n \"command\": \"create\",\n \"args\": {\n \"name\": \"AI Product Research\",\n \"workspaceRoot\": \"/path/to/repo\",\n \"brief\": \"Explore demand and feasibility for an AI product.\",\n \"instructions\": \"Keep decisions and open questions current.\"\n }\n}\n```\n\n### Update a project\n\nUse for metadata, brief, status, or instructions. Use `dryRun` first when changing `workspaceRoot` or broad instructions.\n\n```json\n{\n \"mode\": \"project\",\n \"command\": \"update\",\n \"args\": {\n \"projectId\": \"project_id\",\n \"status\": \"active\",\n \"instructions\": \"Prioritize safe previews before changing notes.\"\n }\n}\n```\n\n### Resolve workspace\n\nUse when a file path or current working directory should be mapped to a project.\n\n```json\n{\n \"mode\": \"project\",\n \"command\": \"resolve_workspace\",\n \"args\": { \"workspacePath\": \"/path/to/repo\", \"autoCreate\": false }\n}\n```\n\n## Notes\n\nNotes are user-owned markdown objects. Treat them as durable user content.\n\n### Find notes\n\n```json\n{ \"mode\": \"note\", \"command\": \"list\", \"args\": { \"search\": \"pricing\", \"limit\": 10 } }\n```\n\n### Create a note\n\n```json\n{\n \"mode\": \"note\",\n \"command\": \"create\",\n \"args\": {\n \"title\": \"Product direction\",\n \"markdown\": \"Initial notes...\",\n \"tags\": [\"product\"]\n }\n}\n```\n\n### Append to a note\n\nPrefer append when preserving original user notes and adding AI output.\n\n```json\n{\n \"mode\": \"note\",\n \"command\": \"append\",\n \"args\": {\n \"noteId\": \"note_id\",\n \"heading\": \"AI synthesis\",\n \"content\": \"Key points...\"\n }\n}\n```\n\n### Preview an edit\n\nUse before rewriting or restructuring a note.\n\n```json\n{\n \"mode\": \"note\",\n \"command\": \"preview_edit\",\n \"args\": {\n \"noteId\": \"note_id\",\n \"instruction\": \"Summarize this as action items\"\n }\n}\n```\n\n### Update a note\n\nUse only when the user clearly wants the canonical note changed. Prefer `append` or `preview_edit` otherwise.\n\n```json\n{\n \"mode\": \"note\",\n \"command\": \"update\",\n \"args\": {\n \"noteId\": \"note_id\",\n \"status\": \"processed\",\n \"tags\": [\"product\", \"validated\"]\n }\n}\n```\n\n## Work Items\n\nWork items are project-scoped tasks. If `projectId` is omitted, the tool may inherit the current session's project binding.\n\n### Create a work item\n\n```json\n{\n \"mode\": \"work_item\",\n \"command\": \"create\",\n \"args\": {\n \"projectId\": \"project_id\",\n \"title\": \"Validate technical feasibility\",\n \"description\": \"Check API, storage, UI, and safety implications.\",\n \"priority\": \"high\",\n \"status\": \"todo\"\n }\n}\n```\n\n### Update a work item\n\n```json\n{\n \"mode\": \"work_item\",\n \"command\": \"update\",\n \"args\": {\n \"workItemId\": \"work_item_id\",\n \"status\": \"in_progress\",\n \"nextAction\": \"Prototype the xopc_use tool path.\"\n }\n}\n```\n\n## Local Apps\n\nLocal apps are first-class XOPC extension UIs backed by a project workspace.\n\n```json\n{\n \"mode\": \"local_app\",\n \"command\": \"create\",\n \"args\": {\n \"name\": \"Research Hub\",\n \"idea\": \"Keep product research sources and decisions together.\",\n \"description\": \"A compact local research workspace.\"\n }\n}\n```\n\nUse `list`, `get`, and `validate` to inspect an existing app. Installation,\nactivation, rollback, and uninstall remain explicit product UI operations because\nthey change the extension runtime.\n\n## Settings\n\nUse settings references when the user must review credentials, privacy, gateway,\nappearance, agent browser, or another configuration surface. This does not change\nconfiguration silently; it returns an exact inline jump target.\n\n```json\n{\n \"mode\": \"settings\",\n \"command\": \"open\",\n \"args\": {\n \"section\": \"credentials\",\n \"title\": \"Provider credentials\",\n \"summary\": \"Add the API key required by the selected model.\"\n }\n}\n```\n\n## Safety\n\n- `note.update` can replace canonical user content. Use `preview_edit` first for content rewrites.\n- `project.update.workspaceRoot` changes project-file scope. Use `dryRun` and ask the user if intent is unclear.\n- `work_item.update.archivedAt` hides work from normal active views. Confirm before archiving.\n- If the user asks for deletion, explain that deletion is not exposed through `xopc_use` yet.\n";

package/dist/src/agent/tool-manuals/xopc-use.js CHANGED Viewed

@@ -9,8 +9,8 @@ Basic shape:
 \`\`\`json
 {
-  "mode": "project | note | work_item",
-  "command": "list | get | create | update | append | preview_edit | resolve_workspace",
+  "mode": "project | note | work_item | local_app | settings",
+  "command": "list | get | create | update | append | preview_edit | resolve_workspace | validate | open",
   "args": { "...": "..." },
   "dryRun": false
 }
@@ -24,6 +24,7 @@ Basic shape:
 - Do not invent ids. If an id is not known, search/list first.
 - Do not attempt delete/archive workflows through this tool unless the command is explicitly supported.
 - For non-trivial note rewrites, use \`note.preview_edit\` before \`note.update\`.
+- Preserve the returned “Open in xopc” link in channel replies so the user can jump directly into the delivered object.
 ## Projects
@@ -191,6 +192,44 @@ Work items are project-scoped tasks. If \`projectId\` is omitted, the tool may i
 }
 \`\`\`
+## Local Apps
+Local apps are first-class XOPC extension UIs backed by a project workspace.
+\`\`\`json
+{
+  "mode": "local_app",
+  "command": "create",
+  "args": {
+    "name": "Research Hub",
+    "idea": "Keep product research sources and decisions together.",
+    "description": "A compact local research workspace."
+  }
+}
+\`\`\`
+Use \`list\`, \`get\`, and \`validate\` to inspect an existing app. Installation,
+activation, rollback, and uninstall remain explicit product UI operations because
+they change the extension runtime.
+## Settings
+Use settings references when the user must review credentials, privacy, gateway,
+appearance, agent browser, or another configuration surface. This does not change
+configuration silently; it returns an exact inline jump target.
+\`\`\`json
+{
+  "mode": "settings",
+  "command": "open",
+  "args": {
+    "section": "credentials",
+    "title": "Provider credentials",
+    "summary": "Add the API key required by the selected model."
+  }
+}
+\`\`\`
 ## Safety
 - \`note.update\` can replace canonical user content. Use \`preview_edit\` first for content rewrites.

package/dist/src/agent/tools/automation-tool.js CHANGED Viewed

@@ -1,4 +1,5 @@
 import { Type } from "@sinclair/typebox";
+import { appendProductDeliveryText } from "@xopcai/gateway-contract";
 //#region src/agent/tools/automation-tool.ts
 const AutomationToolSchema = Type.Object({
 	action: Type.Union([
@@ -20,7 +21,7 @@ function textResult(text, details = {}) {
 	return {
 		content: [{
 			type: "text",
-			text
+			text: appendProductDeliveryText(text, details.delivery)
 		}],
 		details
 	};
@@ -31,6 +32,28 @@ function formatAutomation(item) {
 	const next = item.state.nextRunAtMs ? new Date(item.state.nextRunAtMs).toISOString() : "none";
 	return `- ${item.id} · ${item.name} · ${status} · trigger=${trigger} · next=${next}`;
 }
+function automationDelivery(automation, operation) {
+	return {
+		version: 1,
+		operation,
+		primary: {
+			kind: "automation",
+			id: automation.id,
+			title: automation.name,
+			summary: automation.description?.trim() || void 0,
+			status: automation.enabled ? "enabled" : "paused",
+			revision: String(automation.updatedAtMs),
+			projectId: automation.projectId ?? void 0,
+			capabilities: [
+				"open",
+				"edit",
+				"continue_in_chat",
+				"run",
+				automation.enabled ? "pause" : "resume"
+			]
+		}
+	};
+}
 function createAutomationTool(deps) {
 	return {
 		name: "automation",
@@ -48,7 +71,10 @@ function createAutomationTool(deps) {
 				case "create": {
 					if (!params.automation || typeof params.automation !== "object") return textResult("automation payload is required for create.", { ok: false });
 					const automation = await service.create(params.automation);
-					return textResult(`Created automation ${automation.id}: ${automation.name}`, { automation });
+					return textResult(`Created automation ${automation.id}: ${automation.name}`, {
+						automation,
+						delivery: automationDelivery(automation, "created")
+					});
 				}
 				case "update": {
 					const id = params.automationId?.trim();
@@ -56,7 +82,10 @@ function createAutomationTool(deps) {
 					if (!params.patch || typeof params.patch !== "object") return textResult("patch payload is required for update.", { ok: false });
 					const automation = await service.update(id, params.patch);
 					if (!automation) return textResult(`Automation not found: ${id}`, { ok: false });
-					return textResult(`Updated automation ${automation.id}: ${automation.name}`, { automation });
+					return textResult(`Updated automation ${automation.id}: ${automation.name}`, {
+						automation,
+						delivery: automationDelivery(automation, "updated")
+					});
 				}
 				case "delete": {
 					const id = params.automationId?.trim();
@@ -67,22 +96,32 @@ function createAutomationTool(deps) {
 				case "run": {
 					const id = params.automationId?.trim();
 					if (!id) return textResult("automationId is required for run.", { ok: false });
+					const automation = (await service.list()).find((item) => item.id === id);
 					const run = await service.runNow(id);
-					return textResult(`Started automation run ${run.id}.`, { run });
+					return textResult(`Started automation run ${run.id}.`, {
+						run,
+						...automation ? { delivery: automationDelivery(automation, "started") } : {}
+					});
 				}
 				case "pause": {
 					const id = params.automationId?.trim();
 					if (!id) return textResult("automationId is required for pause.", { ok: false });
 					const automation = await service.pause(id);
 					if (!automation) return textResult(`Automation not found: ${id}`, { ok: false });
-					return textResult(`Paused automation ${id}.`, { automation });
+					return textResult(`Paused automation ${id}.`, {
+						automation,
+						delivery: automationDelivery(automation, "updated")
+					});
 				}
 				case "resume": {
 					const id = params.automationId?.trim();
 					if (!id) return textResult("automationId is required for resume.", { ok: false });
 					const automation = await service.resume(id);
 					if (!automation) return textResult(`Automation not found: ${id}`, { ok: false });
-					return textResult(`Resumed automation ${id}.`, { automation });
+					return textResult(`Resumed automation ${id}.`, {
+						automation,
+						delivery: automationDelivery(automation, "updated")
+					});
 				}
 				case "history": {
 					const id = params.automationId?.trim();

package/dist/src/agent/tools/factory.d.ts CHANGED Viewed

@@ -18,6 +18,7 @@ import type { AutomationService } from '../../automations/index.js';
 import type { NotesService } from '../../notes/index.js';
 import type { ProjectService } from '../../projects/index.js';
 import type { WorkItemService } from '../../work-items/index.js';
+import type { LocalAppService } from '../../local-apps/index.js';
 import type { WorkflowRunServiceLike } from '../../workflows/service/workflow-run-service.types.js';
 import type { SkillManager } from '../skills/skill-manager.js';
 import { type ToolExecutorConfig } from './executor.js';
@@ -51,6 +52,7 @@ export interface ToolFactoryDeps {
     getNotesService?: () => NotesService | undefined;
     getProjectService?: () => ProjectService | undefined;
     getWorkItemService?: () => WorkItemService | undefined;
+    getLocalAppService?: () => LocalAppService | undefined;
     /** Gateway: starts persisted workflow runs (dedicated chat session per run). */
     getWorkflowRunService?: () => WorkflowRunServiceLike | undefined;
     /** Current session skill indexing (tool gating + allowlist); used by skills_list / skill_view. */

package/dist/src/agent/tools/factory.js CHANGED Viewed

@@ -283,13 +283,14 @@ var AgentToolsFactory = class {
 				getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey
 			})] : [],
 			...this.deps.getAutomationService ? [createAutomationTool({ getAutomationService: this.deps.getAutomationService })] : [],
-			...this.deps.getProjectService || this.deps.getNotesService || this.deps.getWorkItemService ? [createXopcUseTool({
+			...this.deps.getProjectService || this.deps.getNotesService || this.deps.getWorkItemService || this.deps.getLocalAppService ? [createXopcUseTool({
 				getConfig: () => this.deps.getConfig?.(),
 				getCurrentAgentId: () => options.agentId,
 				getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey,
 				getNotesService: this.deps.getNotesService,
 				getProjectService: this.deps.getProjectService,
-				getWorkItemService: this.deps.getWorkItemService
+				getWorkItemService: this.deps.getWorkItemService,
+				getLocalAppService: this.deps.getLocalAppService
 			})] : [],
 			createGoalTool({ getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey }),
 			...browserEnabled ? [createBrowserUseTool({

package/dist/src/agent/tools/goal-tool.d.ts CHANGED Viewed

@@ -1,4 +1,6 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
+import { type ProductDeliveryEnvelope } from '@xopcai/gateway-contract';
+import { type Goal } from '../../goals/index.js';
 declare const GoalToolSchema: import("@sinclair/typebox").TObject<{
     action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"list">, import("@sinclair/typebox").TLiteral<"create">, import("@sinclair/typebox").TLiteral<"update">]>;
     goalId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
@@ -19,5 +21,9 @@ declare const GoalToolSchema: import("@sinclair/typebox").TObject<{
 export interface GoalToolOptions {
     getCurrentSessionKey?: () => string | undefined;
 }
-export declare function createGoalTool(options?: GoalToolOptions): AgentTool<typeof GoalToolSchema, {}>;
+type GoalToolDetails = {
+    goal?: Goal;
+    delivery?: ProductDeliveryEnvelope;
+};
+export declare function createGoalTool(options?: GoalToolOptions): AgentTool<typeof GoalToolSchema, GoalToolDetails>;
 export {};

package/dist/src/agent/tools/goal-tool.js CHANGED Viewed

@@ -3,6 +3,7 @@ import "../../storage/sqlite/index.js";
 import { GoalService } from "../../goals/goal-service.js";
 import "../../goals/index.js";
 import { Type } from "@sinclair/typebox";
+import { appendProductDeliveryText } from "@xopcai/gateway-contract";
 //#region src/agent/tools/goal-tool.ts
 const GoalToolSchema = Type.Object({
 	action: Type.Union([
@@ -42,13 +43,35 @@ const GoalToolSchema = Type.Object({
 		maximum: 100
 	}))
 });
-function textResult(text) {
+function goalDelivery(goal, operation) {
+	return {
+		version: 1,
+		operation,
+		primary: {
+			kind: "goal",
+			id: goal.id,
+			title: goal.title,
+			summary: goal.description?.trim() || goal.nextAction?.trim() || void 0,
+			status: goal.status,
+			revision: String(goal.updatedAt),
+			projectId: goal.projectId ?? void 0,
+			capabilities: [
+				"open",
+				"edit",
+				"continue_in_chat",
+				"pause",
+				"resume"
+			]
+		}
+	};
+}
+function textResult(text, details = {}) {
 	return {
 		content: [{
 			type: "text",
-			text
+			text: appendProductDeliveryText(text, details.delivery)
 		}],
-		details: {}
+		details
 	};
 }
 function createGoalTool(options = {}) {
@@ -81,7 +104,10 @@ function createGoalTool(options = {}) {
 					maxTurns: params.maxTurns,
 					source: "workflow"
 				});
-				return textResult(`Created goal ${goal.id}\n${goal.title}`);
+				return textResult(`Created goal ${goal.id}\n${goal.title}`, {
+					goal,
+					delivery: goalDelivery(goal, "created")
+				});
 			}
 			const goalId = params.goalId?.trim();
 			if (!goalId) return textResult("Error: goalId is required.");
@@ -97,7 +123,10 @@ function createGoalTool(options = {}) {
 			});
 			if (!goal) return textResult(`Goal not found: ${goalId}`);
 			if (params.status) goal = goals.setStatus(goalId, params.status, { reason: params.blockedReason });
-			return textResult(`Updated goal ${goalId}\n${goal?.title ?? ""}`);
+			return textResult(`Updated goal ${goalId}\n${goal?.title ?? ""}`, goal ? {
+				goal,
+				delivery: goalDelivery(goal, "updated")
+			} : {});
 		}
 	};
 }

package/dist/src/agent/tools/workflow-tool.js CHANGED Viewed

@@ -2,6 +2,7 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { extractProfileAgentId } from "../../config/agent-profile.js";
 import { Type } from "@sinclair/typebox";
+import { appendProductDeliveryText } from "@xopcai/gateway-contract";
 //#region src/agent/tools/workflow-tool.ts
 /**
 * `workflow` — starts a persisted workflow run in a dedicated chat session.
@@ -76,16 +77,45 @@ function createWorkflowTool(deps) {
 					}],
 					details: { error: result.message }
 				};
+				const summary = goal ? `Started workflow \`${definitionId}\` (run ${result.runId}). Open chat session to track progress and continue.` : `Started workflow \`${definitionId}\` (run ${result.runId}). Open the workflow chat session to track progress.`;
+				const delivery = {
+					version: 1,
+					operation: "started",
+					primary: {
+						kind: "workflow_run",
+						id: result.runId,
+						title: goal || definitionId,
+						summary: `Workflow ${definitionId}`,
+						status: "running",
+						capabilities: ["open", "continue_in_chat"]
+					},
+					related: [{
+						kind: "workflow_definition",
+						id: definitionId,
+						title: definitionId,
+						capabilities: [
+							"open",
+							"edit",
+							"run"
+						]
+					}, {
+						kind: "session",
+						id: result.sessionKey,
+						title: goal || definitionId,
+						capabilities: ["open", "continue_in_chat"]
+					}]
+				};
 				return {
 					content: [{
 						type: "text",
-						text: `${goal ? `Started workflow \`${definitionId}\` (run ${result.runId}). Open chat session to track progress and continue.` : `Started workflow \`${definitionId}\` (run ${result.runId}). Open the workflow chat session to track progress.`}\n\nsessionKey: ${result.sessionKey}`
+						text: appendProductDeliveryText(`${summary}\n\nsessionKey: ${result.sessionKey}`, delivery)
 					}],
 					details: {
 						runId: result.runId,
 						sessionKey: result.sessionKey,
 						definitionId,
-						parentSessionKey: parentSessionKey ?? null
+						parentSessionKey: parentSessionKey ?? null,
+						delivery
 					}
 				};
 			} catch (e) {

package/dist/src/agent/tools/write.js CHANGED Viewed

@@ -1,9 +1,10 @@
 import { checkFileSafety } from "../prompt/safety.js";
 import { isBareProfileMarkdownFileName, resolvePathUnderWorkspace, resolveProfileMarkdownPathIfBareName } from "./tool-paths.js";
 import { evaluateFilePolicy } from "../sandbox/exec-policy.js";
-import { dirname } from "path";
+import { basename, dirname } from "path";
 import { mkdir, writeFile } from "fs/promises";
 import { Type } from "@sinclair/typebox";
+import { appendProductDeliveryText } from "@xopcai/gateway-contract";
 //#region src/agent/tools/write.ts
 const MAX_FILE_SIZE = 10 * 1024 * 1024;
 const WriteFileSchema = Type.Object({
@@ -69,12 +70,31 @@ function createWriteFileTool(workspace, options) {
 						operation: "write"
 					}
 				});
+				const delivery = {
+					version: 1,
+					operation: "updated",
+					primary: {
+						kind: "file",
+						id: target,
+						title: basename(target),
+						summary: `${contentBytes} bytes written`,
+						capabilities: [
+							"preview",
+							"reveal",
+							"share"
+						]
+					}
+				};
 				return {
 					content: [{
 						type: "text",
-						text: `File written: ${target}`
+						text: appendProductDeliveryText(`File written: ${target}`, delivery)
 					}],
-					details: { size: contentBytes }
+					details: {
+						size: contentBytes,
+						path: target,
+						delivery
+					}
 				};
 			} catch (error) {
 				return {

package/dist/src/agent/tools/xopc-use-tool.d.ts CHANGED Viewed

@@ -1,15 +1,17 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
+import { type ProductDeliveryEnvelope } from '@xopcai/gateway-contract';
 import type { Config } from '../../config/schema.js';
 import type { NotesService } from '../../notes/index.js';
 import { type ProjectService } from '../../projects/index.js';
 import type { WorkItemService } from '../../work-items/index.js';
+import type { LocalAppService } from '../../local-apps/index.js';
 declare const XopcUseToolSchema: import("@sinclair/typebox").TObject<{
-    mode: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"project">, import("@sinclair/typebox").TLiteral<"note">, import("@sinclair/typebox").TLiteral<"work_item">]>;
+    mode: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"project">, import("@sinclair/typebox").TLiteral<"note">, import("@sinclair/typebox").TLiteral<"work_item">, import("@sinclair/typebox").TLiteral<"local_app">, import("@sinclair/typebox").TLiteral<"settings">]>;
     command: import("@sinclair/typebox").TString;
     args: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TAny>>;
     dryRun: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
 }>;
-export type XopcUseMode = 'project' | 'note' | 'work_item';
+export type XopcUseMode = 'project' | 'note' | 'work_item' | 'local_app' | 'settings';
 export interface XopcUseToolInput {
     mode: XopcUseMode;
     command: string;
@@ -23,12 +25,14 @@ export interface XopcUseToolDeps {
     getNotesService?: () => NotesService | undefined;
     getProjectService?: () => ProjectService | undefined;
     getWorkItemService?: () => WorkItemService | undefined;
+    getLocalAppService?: () => LocalAppService | undefined;
 }
 type XopcUseDetails = {
     mode: XopcUseMode;
     command: string;
     dryRun: boolean;
     result?: unknown;
+    delivery?: ProductDeliveryEnvelope;
 };
 export declare function createXopcUseTool(deps: XopcUseToolDeps): AgentTool<typeof XopcUseToolSchema, XopcUseDetails>;
 export {};