@xopcai/xopc 0.0.233 → 0.0.235

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

@@ -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 — Keep what matters moving.</title>
-    <script type="module" crossorigin src="/assets/index-BGf-TiZj.js"></script>
+    <script type="module" crossorigin src="/assets/index-DFfvY8IN.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">
@@ -25,13 +25,13 @@
     <link rel="modulepreload" crossorigin href="/assets/download-Dk-ZjtO6.js">
     <link rel="modulepreload" crossorigin href="/assets/plus-Q2yW6OE7.js">
     <link rel="modulepreload" crossorigin href="/assets/x-B_N4OPjy.js">
-    <link rel="modulepreload" crossorigin href="/assets/messages-D4qOHT4D.js">
-    <link rel="modulepreload" crossorigin href="/assets/locale-store-D_dq_0LV.js">
+    <link rel="modulepreload" crossorigin href="/assets/messages-CoovNoMn.js">
+    <link rel="modulepreload" crossorigin href="/assets/locale-store-8k4mvYGL.js">
     <link rel="modulepreload" crossorigin href="/assets/cn-JdwAhgNB.js">
     <link rel="modulepreload" crossorigin href="/assets/schemas-zIBW3wiV.js">
     <link rel="modulepreload" crossorigin href="/assets/product-delivery-tRr-7IxY.js">
     <link rel="modulepreload" crossorigin href="/assets/copy-to-clipboard-HOJ79TWv.js">
-    <link rel="modulepreload" crossorigin href="/assets/markdown-view-CPkBOY3h.js">
+    <link rel="modulepreload" crossorigin href="/assets/markdown-view-D02mJdoU.js">
     <link rel="modulepreload" crossorigin href="/assets/dist-DqPZM2MH2.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-swr-BIWyz7Rc.js">
     <link rel="modulepreload" crossorigin href="/assets/check-DUBLcKHA.js">
@@ -46,26 +46,26 @@
     <link rel="modulepreload" crossorigin href="/assets/eye-off-DEAzt3g1.js">
     <link rel="modulepreload" crossorigin href="/assets/eye-CABVeTq0.js">
     <link rel="modulepreload" crossorigin href="/assets/globe-DSSGFWFn.js">
-    <link rel="modulepreload" crossorigin href="/assets/notes-api-BWSfTP1w.js">
+    <link rel="modulepreload" crossorigin href="/assets/notes-api-p2Pncp2B.js">
     <link rel="modulepreload" crossorigin href="/assets/loader-circle-CifKLtgG.js">
     <link rel="modulepreload" crossorigin href="/assets/rotate-cw-LIg3Am9S.js">
     <link rel="modulepreload" crossorigin href="/assets/search-DA7gz22f.js">
     <link rel="modulepreload" crossorigin href="/assets/middleware-Pd0e8Igk.js">
-    <link rel="modulepreload" crossorigin href="/assets/files-Dp8_uGTO.js">
+    <link rel="modulepreload" crossorigin href="/assets/files-DQjhZjr2.js">
     <link rel="modulepreload" crossorigin href="/assets/tool-activity-R8V9l6nk.js">
     <link rel="modulepreload" crossorigin href="/assets/button-CSEbl4zT.js">
-    <link rel="modulepreload" crossorigin href="/assets/gateway-startup-retry-Dnrl91pU.js">
-    <link rel="modulepreload" crossorigin href="/assets/registry-api-BeVzfRvs.js">
+    <link rel="modulepreload" crossorigin href="/assets/gateway-startup-retry-2rVSUvyw.js">
+    <link rel="modulepreload" crossorigin href="/assets/registry-api-B7b0LJgI.js">
     <link rel="modulepreload" crossorigin href="/assets/config-reload-event-Bjh2zoKp.js">
-    <link rel="modulepreload" crossorigin href="/assets/gateway-config-swr-YyZJKvFf.js">
-    <link rel="modulepreload" crossorigin href="/assets/models-hub-cache-C5y2gzMU.js">
+    <link rel="modulepreload" crossorigin href="/assets/gateway-config-swr-R702lNJR.js">
+    <link rel="modulepreload" crossorigin href="/assets/models-hub-cache-CYr6LzvY.js">
     <link rel="modulepreload" crossorigin href="/assets/electron-env-DH5wF8X8.js">
-    <link rel="modulepreload" crossorigin href="/assets/oauth-api-DnanEBsf.js">
+    <link rel="modulepreload" crossorigin href="/assets/oauth-api-DpLONwfK.js">
     <link rel="modulepreload" crossorigin href="/assets/form-field-width-DJw_jULe.js">
     <link rel="modulepreload" crossorigin href="/assets/interaction-BmQogeqz.js">
     <link rel="modulepreload" crossorigin href="/assets/is-masked-secret-DOkL5b_X.js">
-    <link rel="modulepreload" crossorigin href="/assets/activity-store-DQ5L3PTi.js">
-    <link rel="modulepreload" crossorigin href="/assets/theme-store-Bud54q9e.js">
+    <link rel="modulepreload" crossorigin href="/assets/activity-store-BzswYHcj.js">
+    <link rel="modulepreload" crossorigin href="/assets/theme-store-CpcBI73Q.js">
     <link rel="stylesheet" crossorigin href="/assets/markdown-view-B1bGSQqt.css">
     <link rel="stylesheet" crossorigin href="/assets/index-BTUuTnc9.css">
   </head>

package/dist/package.js

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

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

@@ -5,16 +5,16 @@ import { getSessionMetadata } from "../storage/sqlite/session-repository.js";
 import { getSessionConfig } from "../storage/sqlite/config-repository.js";
 import "../storage/sqlite/index.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
-import { applyConfigOverrides } from "../config/runtime-overrides.js";
 import { expandWorkspacePathString, init_workspace_path } from "../config/workspace-path.js";
 import { init_agent_scope, resolveAgentProfileDir } from "./agent-scope.js";
-import { init_session_key, parseSessionKey } from "../routing/session-key.js";
-import { resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { init_paths, resolveBundledSkillsDir } from "../config/paths.js";
-import { init_sync_provider_auth, resolveProviderApiKeySync } from "../auth/sync-provider-auth.js";
 import { CredentialResolver, init_credentials } from "../auth/credentials.js";
+import { init_session_key, parseSessionKey } from "../routing/session-key.js";
+import { init_sync_provider_auth, resolveProviderApiKeySync } from "../auth/sync-provider-auth.js";
 import { getApiKeySync, getDefaultModelSync, init_providers, resolveModel } from "../providers/index.js";
 import { createExtensionAwareStreamFn } from "../providers/extension-stream-bridge.js";
+import { applyConfigOverrides } from "../config/runtime-overrides.js";
+import { resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { extractTextContent } from "./context/workspace.js";
 import { buildExecutionScopeContextForPrompt } from "./context/execution-scope.js";
 import { clearBootstrapSnapshot } from "./bootstrap/bootstrap-cache.js";

package/dist/src/agent/background-review/run-background-review.js

@@ -4,10 +4,10 @@ import { finishContextExtractionRun } from "../../storage/sqlite/context-extract
 import { getTurnPersonalization } from "../../storage/sqlite/user-context-repository.js";
 import { loadCompactionSourceSnapshot } from "../../storage/sqlite/transcript-repository.js";
 import "../../storage/sqlite/index.js";
-import { extractProfileAgentId } from "../../config/agent-profile.js";
 import { init_sync_provider_auth, resolveProviderApiKeySync } from "../../auth/sync-provider-auth.js";
 import { getApiKeySync, init_providers, resolveModel } from "../../providers/index.js";
 import { createExtensionAwareStreamFn } from "../../providers/extension-stream-bridge.js";
+import { extractProfileAgentId } from "../../config/agent-profile.js";
 import { extractTextContent } from "../context/workspace.js";
 import { readAgentMessageContent } from "../memory/agent-message-access.js";
 import { resolveAgentTurnTimeoutMs, runAgentTurnWithTimeout } from "../orchestration/run-agent-turn-with-timeout.js";

package/dist/src/agent/embedded/model-runtime.js

@@ -1,6 +1,6 @@
 import { init_paths, resolveModelsJsonPath } from "../../config/paths.js";
-import { init_sync_provider_auth, resolveProviderApiKeySync } from "../../auth/sync-provider-auth.js";
 import { CredentialResolver, init_credentials } from "../../auth/credentials.js";
+import { init_sync_provider_auth, resolveProviderApiKeySync } from "../../auth/sync-provider-auth.js";
 import { XopcModelCredentialStore, init_model_credential_store } from "../../auth/model-credential-store.js";
 import { init_register_bundled_oauth_flows, registerBundledOAuthFlows } from "../../providers/register-bundled-oauth-flows.js";
 import { init_register_runtime_providers, registerRuntimeProviders } from "../../providers/register-runtime-providers.js";

package/dist/src/agent/embedded/run-for-session.js

@@ -1,11 +1,13 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
+import { parseTurnOutcome } from "../../../packages/gateway-contract/src/turn-outcome.js";
+import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { resolveAgentTurnTimeoutMs } from "../orchestration/run-agent-turn-with-timeout.js";
 import { resolvePromptCachePolicy } from "../../providers/prompt-cache-plan.js";
 import { evaluateContextBudget } from "../memory/context-budget.js";
 import { resolveCompactionPolicy } from "../memory/compaction-policy.js";
+import { projectTurnOutcome } from "../../session/turn-outcome-projector.js";
 import { runXopcEmbeddedTurn } from "./run-turn.js";
 import { applyStartupContextToUserMessage } from "../reply/apply-turn-user-enrichment.js";
 import { AgentRunSupervisor } from "../orchestration/agent-run-supervisor.js";
@@ -23,6 +25,41 @@ async function runEmbeddedTurnForSession(params) {
 		deadlineAtMs: params.deadlineAtMs,
 		parentSignal: params.abortSignal
 	});
+	const finish = async (result) => {
+		try {
+			const rows = await sessionStore.loadTranscriptRows(sessionKey);
+			const hasTurn = rows.some((source) => {
+				return source.turnId === runId;
+			});
+			const alreadyPersisted = rows.some((source) => {
+				const row = source;
+				return row.type === "custom" && row.customType === "turn_outcome" && parseTurnOutcome(row.data)?.turnId === runId;
+			});
+			if (!hasTurn || alreadyPersisted) return result;
+			const outcome = projectTurnOutcome({
+				rows,
+				turnId: runId,
+				runStatus: result.ok ? "success" : result.errorMessage === "aborted" ? "cancelled" : "error",
+				summary: result.errorMessage
+			});
+			await sessionStore.appendTranscriptCustomEntry(sessionKey, {
+				customType: "turn_outcome",
+				data: outcome
+			});
+			params.onEvent?.({
+				type: "turn_outcome",
+				runId,
+				outcome
+			});
+		} catch (err) {
+			log.warn({
+				err,
+				sessionKey,
+				runId
+			}, "Turn outcome persistence failed");
+		}
+		return result;
+	};
 	try {
 		await params.beforeTurn?.();
 		if (supervisor.signal.aborted) return {
@@ -169,7 +206,7 @@ async function runEmbeddedTurnForSession(params) {
 						attempt: i + 1,
 						total: resolvedCandidates.length
 					}, "Agent model fallback succeeded");
-					return turnResult;
+					return finish(turnResult);
 				}
 				lastResult = turnResult;
 				if (supervisor.signal.aborted || turnResult.retryable === false) break;
@@ -184,7 +221,13 @@ async function runEmbeddedTurnForSession(params) {
 				}, hasNextCandidate ? "Agent model turn failed, trying fallback" : "Agent model turn failed, no fallback remains");
 			} catch (err) {
 				lastError = err;
-				if (err instanceof DOMException && err.name === "AbortError") throw err;
+				if (err instanceof DOMException && err.name === "AbortError") {
+					await finish({
+						ok: false,
+						errorMessage: "aborted"
+					});
+					throw err;
+				}
 				log.warn({
 					err,
 					sessionKey,
@@ -209,13 +252,19 @@ async function runEmbeddedTurnForSession(params) {
 				resumeLastUserMessage = preparation === "resume";
 			}
 		}
-		if (lastResult) return lastResult;
-		if (lastError instanceof Error) throw lastError;
-		if (lastError != null) throw new Error(String(lastError));
-		return {
+		if (lastResult) return finish(lastResult);
+		if (lastError != null) {
+			const result = await finish({
+				ok: false,
+				errorMessage: lastError instanceof Error ? lastError.message : String(lastError)
+			});
+			if (lastError instanceof Error) throw lastError;
+			throw new Error(result.errorMessage);
+		}
+		return finish({
 			ok: false,
 			errorMessage: "No model candidates available"
-		};
+		});
 	} finally {
 		supervisor.dispose();
 	}

package/dist/src/agent/embedded/types.d.ts

@@ -1,5 +1,6 @@
 import type { AgentMessage, AgentToolResult, ThinkingLevel } from '@earendil-works/pi-agent-core';
 import type { AssistantMessageEvent, Model, Api, ImageContent } from '@earendil-works/pi-ai';
+import type { TurnOutcome } from '@xopcai/gateway-contract';
 import type { SessionStore } from '../../session/store.js';
 import type { EmbeddedTranscriptRuntime } from './transcript-runtime.js';
 import type { AgentTurnPolicy } from '../orchestration/agent-turn-policy.js';
@@ -76,6 +77,10 @@ export type EmbeddedStreamEvent = {
     type: 'error';
     runId?: string;
     content: string;
+} | {
+    type: 'turn_outcome';
+    runId?: string;
+    outcome: TurnOutcome;
 } | {
     type: 'compaction';
     runId?: string;

package/dist/src/agent/image/tool-model-config.js

@@ -1,7 +1,7 @@
 import { getAgentDefaultImageModelConfig, getAgentDefaultModelRef, init_schema, parseModelRef } from "../../config/schema.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
-import { resolveEffectiveAgentConfigForAgent } from "../../config/agent-profile.js";
 import { getDefaultModelSync, getModelsByProvider, init_providers, isProviderConfiguredSync, resolveModel } from "../../providers/index.js";
+import { resolveEffectiveAgentConfigForAgent } from "../../config/agent-profile.js";
 import { resolveAgentModelFallbackValues, resolveAgentModelPrimaryValue } from "../../config/model-input.js";
 import { buildCapabilityPlansForConfig } from "../../capabilities/readiness/from-config.js";
 import "../../capabilities/readiness/index.js";

package/dist/src/agent/ipc/inbox.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_paths, resolveAgentDir } from "../../config/paths.js";
 import { init_write_file_atomic, writeTextAtomic } from "../../infra/write-file-atomic.js";
+import { init_paths, resolveAgentDir } from "../../config/paths.js";
 import { join } from "path";
 import { existsSync, watch } from "fs";
 import { mkdir, readFile, readdir, rename } from "fs/promises";

package/dist/src/agent/mcp/oauth/mcp-oauth-store.js

@@ -1,5 +1,5 @@
-import { init_paths, resolveMcpOAuthPath } from "../../../config/paths.js";
 import { init_write_file_atomic, writeTextAtomic } from "../../../infra/write-file-atomic.js";
+import { init_paths, resolveMcpOAuthPath } from "../../../config/paths.js";
 import { createHash } from "node:crypto";
 import { readFile, rm } from "node:fs/promises";
 //#region src/agent/mcp/oauth/mcp-oauth-store.ts

package/dist/src/agent/prompt/sections/tooling.js

@@ -135,7 +135,7 @@ function buildToolingSection(params) {
 		hasGrep || hasFind ? `Use ${[hasGrep ? `\`${grepToolName}\`` : "", hasFind ? `\`${findToolName}\`` : ""].filter(Boolean).join(" and ")} for text/file discovery; use code graph or symbol tools when available for definitions and call relationships.` : "",
 		hasExec ? `Use \`${execToolName}\` for verification and safe inspection, not routine file editing.` : "",
 		hasWrite || hasExec ? "When delivering a user-facing workspace file, include a clickable Markdown link in the final response using `xopc://workspace/file?path=<workspace-relative-path>`; URL-encode spaces and special characters, and do not invent an HTTP or `file://` URL." : "",
-		hasPublishArtifacts ? "After a command or runtime creates final user-facing files such as spreadsheets, presentations, PDFs, documents, media, or archives, call `publish_artifacts` once with all final paths. Do not publish temporary files, code edits, or build intermediates." : "",
+		hasPublishArtifacts ? "Declare final user-facing files in `exec_command.outputs`. Use `publish_artifacts` only when files were created by another runtime or were not known when the command started. Do not publish temporary files, code edits, or build intermediates." : "",
 		hasPlan ? `Use \`${planToolName}\` for multi-step coding work: keep exactly one active step when work is in progress, and update it after meaningful progress or review.` : "",
 		hasToolManual ? "Some complex tools have built-in manuals. Use `tool_manual(tool)` before non-trivial use." : "",
 		hasDelegate ? "If a task is complex or long-running, delegate it. Completion is push-based: the sub-agent result returns when done." : "",

package/dist/src/agent/service.js

@@ -3,10 +3,10 @@ import { init_logger } from "../utils/logger.js";
 import { getUserProfile } from "../storage/sqlite/user-context-repository.js";
 import { parseNoteAttachmentTarget } from "../notes/attachment-ref.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
-import { applyConfigOverrides } from "../config/runtime-overrides.js";
 import { init_agent_scope, resolveAgentHomeDir, resolveDefaultAgentId } from "./agent-scope.js";
-import { extractProfileAgentId } from "../config/agent-profile.js";
 import { init_providers, resolveModel } from "../providers/index.js";
+import { applyConfigOverrides } from "../config/runtime-overrides.js";
+import { extractProfileAgentId } from "../config/agent-profile.js";
 import { extractTextContent } from "./context/workspace.js";
 import { effectiveWorkspacePathForSession } from "../session/session-workspace.js";
 import { getProjectForSession } from "../projects/workspace.js";

package/dist/src/agent/session/session-inspector.js

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_workspace_defaults, resolveDefaultAgentWorkspaceDir } from "../../config/workspace-defaults.js";
-import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
+import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { effectiveWorkspacePathForSession, projectWorkspacePath } from "../../session/session-workspace.js";
 import { getProjectForSession } from "../../projects/workspace.js";
 import { resolveCompactionPolicy } from "../memory/compaction-policy.js";

package/dist/src/agent/skills/hub-lock.js

@@ -1,5 +1,5 @@
-import { init_paths, resolveSkillsLockPath } from "../../config/paths.js";
 import { init_write_file_atomic, writeTextAtomicSync } from "../../infra/write-file-atomic.js";
+import { init_paths, resolveSkillsLockPath } from "../../config/paths.js";
 import { existsSync, readFileSync } from "node:fs";
 //#region src/agent/skills/hub-lock.ts
 /**

package/dist/src/agent/tasks/task-judge-service.js

@@ -1,14 +1,14 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../../providers/model-response.js";
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
-import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { getApiKey, init_providers, resolveModel } from "../../providers/index.js";
+import { completeWithResolvedCredentials } from "../../providers/model-call.js";
+import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { TaskRepository } from "../../tasks/task-repository.js";
 import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
 import { TaskRunRepository } from "../../tasks/task-run-repository.js";
-import { completeWithResolvedCredentials } from "../../providers/model-call.js";
 import { TaskApplicationService } from "../../tasks/task-application-service.js";
-import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../../providers/model-response.js";
 //#region src/agent/tasks/task-judge-service.ts
 init_schema();
 init_providers();

package/dist/src/agent/tools/create-share-tool.js

@@ -1,5 +1,5 @@
-import { resolvePathUnderWorkspace } from "./tool-paths.js";
 import { turnOutcomeKindFromFileName } from "../../../packages/gateway-contract/src/turn-outcome.js";
+import { resolvePathUnderWorkspace } from "./tool-paths.js";
 import { resolveGatewayEffectiveHost } from "../../config/gateway-bind.js";
 import { resolveShareConfig } from "../../share/share-config.js";
 import { mergeWithDefaults } from "../../share/site-share-config.js";

package/dist/src/agent/tools/exec-command.d.ts

@@ -1,4 +1,5 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
+import type { TurnOutcomeDeliverable } from '@xopcai/gateway-contract';
 export interface ExecCommandDetails {
     command: string;
     cwd: string;
@@ -15,6 +16,7 @@ export interface ExecCommandDetails {
     stderr: string;
     aggregatedOutput: string;
     failureHint?: string;
+    artifacts?: TurnOutcomeDeliverable[];
 }
 export interface ExecCommandUpdateDetails {
     kind: 'command_output_delta';

package/dist/src/agent/tools/exec-command.js

@@ -1,5 +1,6 @@
 import { formatSize, truncateTail } from "./truncate.js";
 import { evaluateExecPolicy } from "../sandbox/exec-policy.js";
+import { publishArtifactPaths } from "./publish-artifacts.js";
 import { resolve } from "node:path";
 import { spawn } from "node:child_process";
 import { Type } from "@sinclair/typebox";
@@ -12,7 +13,11 @@ const ExecCommandSchema = Type.Object({
 	cmd: Type.String({ description: "Shell command to execute." }),
 	cwd: Type.Optional(Type.String({ description: "Working directory. Relative paths are resolved under the agent workspace." })),
 	timeoutMs: Type.Optional(Type.Number({ description: "Command timeout in milliseconds. Defaults to 1800000 (30m) and is capped at 14400000 (4h)." })),
-	maxOutputChars: Type.Optional(Type.Number({ description: "Maximum characters returned to the model. UI streaming still receives output deltas." }))
+	maxOutputChars: Type.Optional(Type.Number({ description: "Maximum characters returned to the model. UI streaming still receives output deltas." })),
+	outputs: Type.Optional(Type.Array(Type.String({ minLength: 1 }), {
+		maxItems: 50,
+		description: "Final user-facing files created by this command. Relative paths resolve under the effective cwd and are persisted as chat deliverables after a successful command."
+	}))
 });
 function clampTimeoutMs(raw) {
 	return Math.min(MAX_COMMAND_TIMEOUT_MS, Math.max(1e3, Math.floor(typeof raw === "number" && Number.isFinite(raw) ? raw : DEFAULT_TIMEOUT_MS)));
@@ -95,7 +100,7 @@ function createExecCommandTool(workspaceCwd, options) {
 			"Run shell commands for code inspection, builds, tests, type checks, and verification.",
 			"Use apply_patch for file edits; do not edit files by shell redirection unless explicitly necessary.",
 			"Relative cwd values resolve under the current agent workspace.",
-			"When the command creates final user-facing files, call publish_artifacts afterward with all final paths."
+			"When the command creates final user-facing files, declare all final paths in outputs so they are persisted with this command."
 		].join(" "),
 		parameters: ExecCommandSchema,
 		label: "Run Command",
@@ -103,7 +108,7 @@ function createExecCommandTool(workspaceCwd, options) {
 		supportsParallel: false,
 		idempotent: false,
 		finalGuardRelevant: true,
-		async execute(_toolCallId, params, signal, onUpdate) {
+		async execute(toolCallId, params, signal, onUpdate) {
 			const command = (params.cmd ?? params.command ?? "").trim();
 			if (!command) return {
 				content: [{
@@ -207,7 +212,7 @@ function createExecCommandTool(workspaceCwd, options) {
 						}
 					});
 				};
-				const finish = (exitCode, errorText) => {
+				const finish = async (exitCode, errorText) => {
 					if (settled) return;
 					settled = true;
 					clearTimeout(timeout);
@@ -244,10 +249,21 @@ function createExecCommandTool(workspaceCwd, options) {
 						truncatedBy: formatted.truncatedBy,
 						outputBytes: formatted.outputBytes
 					};
+					let resultText = formatted.text;
+					if (details.status === "success" && params.outputs?.length) {
+						details.artifacts = await publishArtifactPaths({
+							paths: params.outputs,
+							baseDir: policy.effectiveCwd,
+							toolCallId
+						});
+						const published = details.artifacts.filter((item) => item.availability === "available").length;
+						const failed = details.artifacts.length - published;
+						resultText += `\n\nArtifacts: ${published} published${failed > 0 ? `, ${failed} failed` : ""}.`;
+					}
 					resolveTool({
 						content: [{
 							type: "text",
-							text: formatted.text
+							text: resultText
 						}],
 						details
 					});
@@ -264,8 +280,8 @@ function createExecCommandTool(workspaceCwd, options) {
 				else signal?.addEventListener("abort", abort, { once: true });
 				proc.stdout?.on("data", (data) => publishDelta("stdout", data));
 				proc.stderr?.on("data", (data) => publishDelta("stderr", data));
-				proc.on("error", (err) => finish(null, `Error: ${err.message}`));
-				proc.on("close", (code) => finish(code));
+				proc.on("error", (err) => void finish(null, `Error: ${err.message}`));
+				proc.on("close", (code) => void finish(code));
 			});
 		}
 	};

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

@@ -11,6 +11,7 @@ import { createDefaultExternalToolGatewayTools } from "../external-tools/index.j
 import { createReadFileTool } from "./read.js";
 import { createWriteFileTool } from "./write.js";
 import { createListDirTool } from "./list-dir.js";
+import { createPublishArtifactsTool } from "./publish-artifacts.js";
 import { createExecCommandTool } from "./exec-command.js";
 import { createApplyPatchTool } from "./apply-patch.js";
 import { createMemoryGetTool, createMemorySearchTool } from "./memory-tool.js";
@@ -22,7 +23,6 @@ import { createWebFetchTool, createWebSearchTool } from "./web.js";
 import { createWebExtractTool } from "./web-extract.js";
 import { createMessageTool } from "./communication.js";
 import { createSendMediaTool } from "./send-media.js";
-import { createPublishArtifactsTool } from "./publish-artifacts.js";
 import { createReadMediaTool } from "./media-read-tool.js";
 import { createCreateShareTool, isShareToolAvailable } from "./create-share-tool.js";
 import { createTodoTool } from "./todo-tool.js";

package/dist/src/agent/tools/index.js

@@ -4,6 +4,7 @@ import { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, GREP_MAX_LINE_LENGTH, formatSize,
 import { createReadFileTool } from "./read.js";
 import { createWriteFileTool, writeFileTool } from "./write.js";
 import { createListDirTool, listDirTool } from "./list-dir.js";
+import { createPublishArtifactsTool } from "./publish-artifacts.js";
 import { createExecCommandTool } from "./exec-command.js";
 import { fuzzyFindText, generateDiffString, normalizeForFuzzyMatch, normalizeToLF, restoreLineEndings, stripBom } from "./edit-diff.js";
 import { createApplyPatchTool } from "./apply-patch.js";
@@ -16,7 +17,6 @@ import { createWebFetchTool, createWebSearchTool } from "./web.js";
 import { DEFAULT_WEB_EXTRACT_MAX_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, createWebExtractTool, stripHtmlBoilerplate } from "./web-extract.js";
 import { createMessageTool } from "./communication.js";
 import { createSendMediaTool } from "./send-media.js";
-import { createPublishArtifactsTool } from "./publish-artifacts.js";
 import { createReadMediaTool } from "./media-read-tool.js";
 import { createCreateShareTool, isShareToolAvailable } from "./create-share-tool.js";
 import { TodoStore, createTodoTool } from "./todo-tool.js";

package/dist/src/agent/tools/publish-artifacts.d.ts

@@ -1,2 +1,8 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
+import { type TurnOutcomeDeliverable } from '@xopcai/gateway-contract';
+export declare function publishArtifactPaths(params: {
+    paths: string[];
+    baseDir: string;
+    toolCallId: string;
+}): Promise<TurnOutcomeDeliverable[]>;
 export declare function createPublishArtifactsTool(workspace: string): AgentTool;

package/dist/src/agent/tools/publish-artifacts.js

@@ -1,6 +1,6 @@
-import { checkFileSafety } from "../prompt/safety.js";
-import { resolvePathUnderWorkspace } from "./tool-paths.js";
 import { turnOutcomeKindFromFileName, turnOutcomeMimeTypeFromFileName } from "../../../packages/gateway-contract/src/turn-outcome.js";
+import { resolvePathUnderWorkspace } from "./tool-paths.js";
+import { evaluateFilePolicy } from "../sandbox/exec-policy.js";
 import { persistToolMedia } from "./tool-media.js";
 import { basename, isAbsolute } from "node:path";
 import { readFile } from "node:fs/promises";
@@ -11,6 +11,53 @@ const PublishArtifactsSchema = Type.Object({ paths: Type.Array(Type.String({ min
 	maxItems: 50,
 	description: "Files to publish. Relative paths resolve under the current agent workspace."
 }) });
+async function publishArtifactPaths(params) {
+	const paths = [...new Set(params.paths.map((value) => value.trim()).filter(Boolean))];
+	const artifacts = [];
+	const publishedPaths = /* @__PURE__ */ new Set();
+	for (const [index, inputPath] of paths.entries()) {
+		const resolved = resolvePathUnderWorkspace(inputPath, params.baseDir);
+		if (publishedPaths.has(resolved)) continue;
+		publishedPaths.add(resolved);
+		try {
+			const policy = evaluateFilePolicy({
+				operation: "read",
+				path: resolved,
+				workspaceRoot: params.baseDir
+			});
+			if (!policy.allowed) throw new Error(policy.reason);
+			const media = await persistToolMedia({
+				buffer: await readFile(policy.canonicalPath ?? resolved),
+				filePath: resolved
+			});
+			const kind = turnOutcomeKindFromFileName(media.name);
+			artifacts.push({
+				artifactId: media.id,
+				title: media.name,
+				kind,
+				mimeType: media.mimeType,
+				sizeBytes: media.size,
+				availability: "available",
+				location: "artifact_store",
+				capabilities: kind === "archive" || kind === "file" ? ["download"] : ["preview", "download"],
+				uri: media.uri
+			});
+		} catch {
+			const title = basename(resolved);
+			const mimeType = turnOutcomeMimeTypeFromFileName(title);
+			artifacts.push({
+				artifactId: `publish-failed:${params.toolCallId}:${index}`,
+				title,
+				kind: turnOutcomeKindFromFileName(title),
+				...mimeType ? { mimeType } : {},
+				availability: "failed",
+				location: isAbsolute(inputPath) ? "external_host" : "workspace",
+				capabilities: ["regenerate"]
+			});
+		}
+	}
+	return artifacts;
+}
 function createPublishArtifactsTool(workspace) {
 	return {
 		name: "publish_artifacts",
@@ -23,45 +70,11 @@ function createPublishArtifactsTool(workspace) {
 		async execute(toolCallId, params) {
 			const paths = [...new Set(params.paths.map((value) => value.trim()).filter(Boolean))];
 			if (paths.length === 0) throw new Error("At least one artifact path is required");
-			const artifacts = [];
-			const publishedPaths = /* @__PURE__ */ new Set();
-			for (const [index, inputPath] of paths.entries()) {
-				const resolved = resolvePathUnderWorkspace(inputPath, workspace);
-				if (publishedPaths.has(resolved)) continue;
-				publishedPaths.add(resolved);
-				try {
-					const safety = checkFileSafety("read", resolved);
-					if (!safety.allowed) throw new Error(safety.message);
-					const media = await persistToolMedia({
-						buffer: await readFile(resolved),
-						filePath: resolved
-					});
-					const kind = turnOutcomeKindFromFileName(media.name);
-					artifacts.push({
-						artifactId: media.id,
-						title: media.name,
-						kind,
-						mimeType: media.mimeType,
-						sizeBytes: media.size,
-						availability: "available",
-						location: "artifact_store",
-						capabilities: kind === "archive" || kind === "file" ? ["download"] : ["preview", "download"],
-						uri: media.uri
-					});
-				} catch {
-					const title = basename(resolved);
-					const mimeType = turnOutcomeMimeTypeFromFileName(title);
-					artifacts.push({
-						artifactId: `publish-failed:${toolCallId}:${index}`,
-						title,
-						kind: turnOutcomeKindFromFileName(title),
-						...mimeType ? { mimeType } : {},
-						availability: "failed",
-						location: isAbsolute(inputPath) ? "external_host" : "workspace",
-						capabilities: ["regenerate"]
-					});
-				}
-			}
+			const artifacts = await publishArtifactPaths({
+				paths,
+				baseDir: workspace,
+				toolCallId
+			});
 			const publishedCount = artifacts.filter((item) => item.availability === "available").length;
 			const failedCount = artifacts.length - publishedCount;
 			return {
@@ -79,4 +92,4 @@ function createPublishArtifactsTool(workspace) {
 	};
 }
 //#endregion
-export { createPublishArtifactsTool };
+export { createPublishArtifactsTool, publishArtifactPaths };

package/dist/src/agent/tools/send-media.js

@@ -1,6 +1,6 @@
+import { turnOutcomeKindFromFileName } from "../../../packages/gateway-contract/src/turn-outcome.js";
 import { checkFileSafety } from "../prompt/safety.js";
 import { resolvePathUnderWorkspace } from "./tool-paths.js";
-import { turnOutcomeKindFromFileName } from "../../../packages/gateway-contract/src/turn-outcome.js";
 import { persistToolMedia } from "./tool-media.js";
 import { basename } from "node:path";
 import { readFile } from "fs/promises";

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

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { extractProfileAgentId, resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { appendProductDeliveryText } from "../../../packages/gateway-contract/src/product-delivery.js";
+import { extractProfileAgentId, resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/workflow-tool.ts
 /**

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

@@ -1,6 +1,6 @@
+import { appendProductDeliveryText } from "../../../packages/gateway-contract/src/product-delivery.js";
 import { checkFileSafety } from "../prompt/safety.js";
 import { isBareProfileMarkdownFileName, resolvePathUnderWorkspace, resolveProfileMarkdownPathIfBareName } from "./tool-paths.js";
-import { appendProductDeliveryText } from "../../../packages/gateway-contract/src/product-delivery.js";
 import { fileResourceId, fileSpaceId } from "../../files/file-service.js";
 import { evaluateFilePolicy } from "../sandbox/exec-policy.js";
 import { basename, dirname, relative, sep } from "path";