@xopcai/xopc 0.0.231 → 0.0.233

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

@@ -1,6 +1,6 @@
 import { getAgentDefaultImageModelConfig, getAgentDefaultModelRef, init_schema, parseModelRef } from "../../config/schema.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
-import { resolveEffectiveAgentManifestForAgent } from "../../config/agent-profile.js";
+import { resolveEffectiveAgentConfigForAgent } from "../../config/agent-profile.js";
 import { getDefaultModelSync, getModelsByProvider, init_providers, isProviderConfiguredSync, resolveModel } from "../../providers/index.js";
 import { resolveAgentModelFallbackValues, resolveAgentModelPrimaryValue } from "../../config/model-input.js";
 import { buildCapabilityPlansForConfig } from "../../capabilities/readiness/from-config.js";
@@ -37,13 +37,13 @@ function resolveEffectiveModelsConfig(params) {
 	if (!params.cfg) return;
 	try {
 		const agentId = params.agentId?.trim() || resolveDefaultAgentId(params.cfg);
-		return resolveEffectiveAgentManifestForAgent(params.cfg, agentId).models;
+		return resolveEffectiveAgentConfigForAgent(params.cfg, agentId).config.models;
 	} catch {
 		return;
 	}
 }
 function resolveConfiguredImageModelConfig(params) {
-	return coerceToolModelConfig(resolveEffectiveModelsConfig(params)?.imageModel ?? (params.cfg ? getAgentDefaultImageModelConfig(params.cfg) : void 0));
+	return coerceToolModelConfig(resolveEffectiveModelsConfig(params)?.imageUnderstanding ?? (params.cfg ? getAgentDefaultImageModelConfig(params.cfg) : void 0));
 }
 function modelRefSupportsImage(modelRef) {
 	try {
@@ -70,27 +70,26 @@ function addCandidate(candidates, seen, entry) {
 }
 function collectRoleImageModelCandidates(params) {
 	const models = resolveEffectiveModelsConfig(params);
-	const roles = models?.roles ?? {};
-	const roleIds = Object.keys(roles);
-	if (roleIds.length === 0) return [];
-	const orderedRoleIds = [...models?.defaultRole && roles[models.defaultRole] ? [models.defaultRole] : [], ...roleIds.filter((roleId) => roleId !== models?.defaultRole)];
+	const routes = models ? {
+		chat: models.chat,
+		...models.intents
+	} : {};
+	const roleIds = Object.keys(routes);
 	const seen = /* @__PURE__ */ new Set();
 	const candidates = [];
-	for (const roleId of orderedRoleIds) {
-		const role = roles[roleId];
+	for (const roleId of roleIds) {
+		const role = routes[roleId];
 		if (!role) continue;
-		const refs = [role.model, ...role.fallbacks ?? []];
+		const refs = [role.primary, ...role.fallbacks];
 		for (const ref of refs) addCandidate(candidates, seen, {
 			ref,
-			roleId,
-			...role.description ? { roleDescription: role.description } : {}
+			roleId
 		});
 	}
 	return candidates;
 }
 function resolveDefaultModelRefForAgent(params) {
-	const models = resolveEffectiveModelsConfig(params);
-	const ref = (models?.defaultRole ? models.roles?.[models.defaultRole] : void 0)?.model?.trim();
+	const ref = resolveEffectiveModelsConfig(params)?.chat.primary.trim();
 	if (ref) {
 		const parsed = parseModelRef(ref);
 		if (parsed) return parsed;

package/dist/src/agent/mcp/bundle-mcp-policy.d.ts

@@ -1,10 +1 @@
-import type { AgentManifest, ToolPolicy } from '../../agent-manifest/schema.js';
 export declare function mcpToolPolicyId(serverId: string, toolName: string): string;
-export declare function resolveMcpToolPolicy(identity: {
-    serverId: string;
-    policyToolId: string;
-}, policy: AgentManifest['tools']['mcp']): ToolPolicy | undefined;
-export declare function isMcpCatalogToolDenied(identity: {
-    serverId: string;
-    policyToolId: string;
-}, policy: AgentManifest['tools']['mcp']): boolean;

package/dist/src/agent/mcp/bundle-mcp-policy.js

@@ -1,18 +1,6 @@
-import { sanitizeServerName } from "./bundle-mcp-names.js";
 //#region src/agent/mcp/bundle-mcp-policy.ts
 function mcpToolPolicyId(serverId, toolName) {
 	return `mcp:${encodeURIComponent(serverId)}:${encodeURIComponent(toolName)}`;
 }
-function resolveMcpToolPolicy(identity, policy) {
-	const toolPolicy = policy?.tools?.[identity.policyToolId];
-	if (toolPolicy) return toolPolicy;
-	const directServerPolicy = policy?.servers?.[identity.serverId];
-	if (directServerPolicy) return directServerPolicy;
-	const usedNames = /* @__PURE__ */ new Set();
-	for (const [serverId, serverPolicy] of Object.entries(policy?.servers ?? {})) if (sanitizeServerName(serverId, usedNames) === identity.serverId) return serverPolicy;
-}
-function isMcpCatalogToolDenied(identity, policy) {
-	return resolveMcpToolPolicy(identity, policy)?.mode === "deny";
-}
 //#endregion
-export { isMcpCatalogToolDenied, mcpToolPolicyId, resolveMcpToolPolicy };
+export { mcpToolPolicyId };

package/dist/src/agent/mcp/bundle-mcp-runtime.js

@@ -2,12 +2,12 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { resolveGlobalSingleton } from "../../utils/global-singleton.js";
 import { init_string_coerce, normalizeOptionalString } from "../../utils/string-coerce.js";
-import { sanitizeServerName } from "./bundle-mcp-names.js";
 import { redactSensitiveUrlLikeString } from "../../utils/redact-sensitive-url.js";
 import { loadEmbeddedMcpConfig } from "./embedded-mcp.js";
 import { resolveConnectorSecretReferences } from "../../connectors/secret-store.js";
 import { isMcpConfigRecord } from "./mcp-config-shared.js";
 import { resolveMcpTransport } from "./mcp-transport.js";
+import { sanitizeServerName } from "./bundle-mcp-names.js";
 import crypto from "node:crypto";
 import Ajv2020 from "ajv/dist/2020.js";
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";

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

@@ -1,4 +1,4 @@
-import { isMcpCatalogToolDenied, mcpToolPolicyId, resolveMcpToolPolicy } from "./bundle-mcp-policy.js";
+import { mcpToolPolicyId } from "./bundle-mcp-policy.js";
 import { loadMergedBundleMcpConfig } from "./bundle-mcp-config.js";
 import { loadEmbeddedMcpConfig } from "./embedded-mcp.js";
 import { McpAuthorizationRequiredError, isMcpAuthorizationError } from "./oauth/mcp-oauth-errors.js";
@@ -9,4 +9,4 @@ import "./bundle-mcp-tools.js";
 import { McpOAuthSession } from "./oauth/mcp-oauth-session.js";
 import { McpOAuthManager, getMcpOAuthManager } from "./oauth/mcp-oauth-manager.js";
 import "./oauth/index.js";
-export { McpAuthorizationRequiredError, McpOAuthManager, McpOAuthSession, McpOAuthStore, XopcMcpOAuthClientProvider, __testing, canonicalMcpServerUrl, createSessionMcpRuntime, disposeAllSessionMcpRuntimes, disposeSessionMcpRuntime, getMcpOAuthManager, getOrCreateSessionMcpRuntime, getSessionMcpRuntimeManager, isMcpAuthorizationError, isMcpCatalogToolDenied, loadEmbeddedMcpConfig, loadMergedBundleMcpConfig, mcpOAuthServerKey, mcpToolPolicyId, resolveMcpToolPolicy, retireSessionMcpRuntime, retireSessionMcpRuntimeForSessionKey };
+export { McpAuthorizationRequiredError, McpOAuthManager, McpOAuthSession, McpOAuthStore, XopcMcpOAuthClientProvider, __testing, canonicalMcpServerUrl, createSessionMcpRuntime, disposeAllSessionMcpRuntimes, disposeSessionMcpRuntime, getMcpOAuthManager, getOrCreateSessionMcpRuntime, getSessionMcpRuntimeManager, isMcpAuthorizationError, loadEmbeddedMcpConfig, loadMergedBundleMcpConfig, mcpOAuthServerKey, mcpToolPolicyId, retireSessionMcpRuntime, retireSessionMcpRuntimeForSessionKey };

package/dist/src/agent/media-generation/runtime-shared.d.ts

@@ -90,7 +90,7 @@ export declare function throwCapabilityGenerationFailure(params: ThrowCapability
 export interface BuildNoCapabilityModelConfiguredMessageParams {
     /** Display label, e.g. "image-generation". */
     capabilityLabel: string;
-    /** Config key path, e.g. "imageGenerationModel". */
+    /** Config key path, e.g. "agents.defaults.models.imageGeneration". */
     modelConfigKey: string;
     providers: ReadonlyArray<CapabilityProviderCandidate>;
     /** Optional env-var lookup, e.g. (id) => PROVIDER_ENV_MAP[id]. */

package/dist/src/agent/media-generation/runtime-shared.js

@@ -190,7 +190,7 @@ function throwCapabilityGenerationFailure(params) {
 	});
 }
 function buildNoCapabilityModelConfiguredMessage(params) {
-	const lines = [`No ${params.capabilityLabel} model configured. Add a manifest/runtime model policy for ${params.modelConfigKey} or pass modelOverride at call site.`];
+	const lines = [`No ${params.capabilityLabel} model configured. Set agents.defaults.models.${params.modelConfigKey} or pass modelOverride at call site.`];
 	if (params.providers.length > 0) {
 		lines.push("Registered providers:");
 		for (const p of params.providers) {

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

@@ -2,7 +2,7 @@ import { isMemorySubsystemEnabled } from "./memory-config.js";
 import { BuiltinMemoryProvider } from "./builtin-provider.js";
 import { MemoryManager } from "./manager.js";
 import { loadMemoryPluginProviders } from "./plugin-discovery.js";
-import { buildMemoryRuntime } from "../../agent-runtime/memory-runtime.js";
+import { buildMemoryRuntime } from "./runtime.js";
 //#region src/agent/memory/create-memory-manager.ts
 function createMemoryManagerFromConfig(config) {
 	const routing = resolveMemoryManagerOptions(config);

package/dist/src/agent/memory/manager.d.ts

@@ -1,5 +1,5 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
-import type { MemoryRuntime } from '../../agent-runtime/memory-runtime.js';
+import type { MemoryRuntime } from './runtime.js';
 import type { MemoryProvider, MemoryProviderInitOptions } from './provider.js';
 import type { UnderstandingCandidate } from './understanding/types.js';
 import type { MemoryDeleteRequest, MemoryListRequest, MemoryReadRequest, MemoryReadResult, MemorySearchRequest, MemorySearchResult, MemoryUpdateRequest, MemoryWriteRequest, MemoryWriteResult, MemoryRecord, MemorySignal, MemoryKind } from './types.js';

package/dist/src/{agent-runtime/memory-runtime.d.ts → agent/memory/runtime.d.ts}

@@ -1,4 +1,4 @@
-import type { UserContextConfig } from '../user-context/config.js';
+import type { UserContextConfig } from '../../user-context/config.js';
 export type MemorySource = 'session' | 'agentProfile' | 'understanding' | 'workspace';
 export type MemoryWriteTarget = 'agentProfile' | 'understanding' | 'workspace';
 export type MemoryWriteDecision = 'allow' | 'confirm' | 'deny';

package/dist/src/{agent-runtime/memory-runtime.js → agent/memory/runtime.js}

@@ -1,5 +1,4 @@
-//#region src/agent-runtime/memory-runtime.ts
-const READ_ONLY_MODES = new Set(["readOnly"]);
+//#region src/agent/memory/runtime.ts
 function normalizeConfidence(value) {
 	if (typeof value !== "number" || !Number.isFinite(value)) return .5;
 	return Math.max(0, Math.min(1, value));
@@ -16,7 +15,7 @@ function buildMemoryRuntime(userContext) {
 				decision: "deny",
 				reason: "memory is disabled"
 			};
-			if (READ_ONLY_MODES.has(memory.mode)) return {
+			if (memory.mode === "readOnly") return {
 				decision: "deny",
 				reason: "memory is read-only"
 			};

package/dist/src/agent/orchestration/agent-orchestrator.d.ts

@@ -21,8 +21,6 @@ export interface AgentOrchestratorConfig {
     /** Per-session hydration (workspace override + model override) before the agent runs. */
     sessionHydrator: SessionHydrator;
     getThinkingDefault: () => ThinkLevel | undefined;
-    /** Per-session default from merged `agents.list` / defaults (optional). */
-    getThinkingDefaultForSession?: (sessionKey: string) => ThinkLevel | undefined;
     /** Default workspace root when no per-session resolver is set. */
     workspaceRoot: string;
     /** Per-agent workspace root for attachments (optional; defaults to `workspaceRoot`). */
@@ -45,7 +43,6 @@ export declare class AgentOrchestrator {
     private sessionConfigStore;
     private sessionHydrator;
     private getThinkingDefault;
-    private getThinkingDefaultForSession?;
     private enqueueAutoTitle?;
     private getConfig?;
     private onEmbeddedStreamEvent?;

package/dist/src/agent/orchestration/agent-orchestrator.js

@@ -24,7 +24,6 @@ var AgentOrchestrator = class {
 	sessionConfigStore;
 	sessionHydrator;
 	getThinkingDefault;
-	getThinkingDefaultForSession;
 	enqueueAutoTitle;
 	getConfig;
 	onEmbeddedStreamEvent;
@@ -36,7 +35,6 @@ var AgentOrchestrator = class {
 		this.sessionConfigStore = config.sessionConfigStore;
 		this.sessionHydrator = config.sessionHydrator;
 		this.getThinkingDefault = config.getThinkingDefault;
-		this.getThinkingDefaultForSession = config.getThinkingDefaultForSession;
 		this.enqueueAutoTitle = config.enqueueAutoTitle;
 		this.getConfig = config.getConfig;
 		this.onEmbeddedStreamEvent = config.onEmbeddedStreamEvent;
@@ -70,7 +68,7 @@ var AgentOrchestrator = class {
 				this.agentManager.getOrCreateAgent(sessionKey);
 				this.agentManager.applyTurnChannelSystemPrompt(sessionKey, channelSystemPrompt);
 			}
-			const thinkingDefault = this.getThinkingDefaultForSession?.(sessionKey) ?? this.getThinkingDefault();
+			const thinkingDefault = this.getThinkingDefault();
 			const thinkingLevel = await resolveEffectiveThinkingLevel(this.sessionConfigStore, sessionKey, null, thinkingDefault);
 			this.agentManager.setThinkingLevel(sessionKey, thinkingLevel);
 			const persistedAttachments = await persistInboundAttachments(msg.attachments);

package/dist/src/agent/orchestration/run-agent-turn-with-timeout.js

@@ -1,4 +1,4 @@
-import { resolveEffectiveAgentManifestForSession } from "../../config/agent-profile.js";
+import { resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
 //#region src/agent/orchestration/run-agent-turn-with-timeout.ts
 /** Minimum per-turn timeout (1 minute). */
 const MIN_AGENT_TURN_TIMEOUT_MS = 6e4;
@@ -20,7 +20,7 @@ function isAgentTurnUnsettledError(err) {
 }
 function resolveAgentTurnTimeoutMs(config, sessionKey) {
 	if (!config) return DEFAULT_AGENT_TURN_TIMEOUT_MS;
-	const configured = resolveEffectiveAgentManifestForSession(config, sessionKey).runtime?.timeoutMs;
+	const configured = resolveEffectiveAgentConfigForSession(config, sessionKey).config.runtime.timeoutMs;
 	if (!configured) return DEFAULT_AGENT_TURN_TIMEOUT_MS;
 	return Math.min(MAX_AGENT_TURN_TIMEOUT_MS, Math.max(MIN_AGENT_TURN_TIMEOUT_MS, configured));
 }

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

@@ -14,6 +14,7 @@ const CORE_TOOL_ORDER = [
 	"browser_use",
 	"send_message",
 	"send_media",
+	"publish_artifacts",
 	"memory_search",
 	"memory_get",
 	"session_recall",
@@ -51,6 +52,7 @@ const CORE_TOOL_SUMMARIES = {
 	browser_use: "Control the configured browser",
 	send_message: "Send messages to the current conversation or an explicit configured channel",
 	send_media: "Send media attachments to the current channel",
+	publish_artifacts: "Publish final generated files as durable chat deliverables",
 	memory_search: "Semantic search over indexed memory sources",
 	memory_get: "Read specific lines from memory sources returned by search",
 	session_recall: "Search exact raw turns in the current session, including compacted history",
@@ -117,6 +119,7 @@ function buildToolingSection(params) {
 	const hasFind = availableTools.has("find");
 	const hasExec = availableTools.has("exec_command");
 	const hasPlan = availableTools.has("update_plan");
+	const hasPublishArtifacts = availableTools.has("publish_artifacts");
 	const orchestrationLines = [];
 	if (hasDelegate) orchestrationLines.push("- Sub-agent delegation → use `delegate_task(goal, context?, toolset?)` for focused parallel work; results return to you automatically.");
 	if (hasWorkflow) orchestrationLines.push("- Multi-phase workflows → use `workflow` to start persisted runs with subagents when a script defines phases.");
@@ -131,6 +134,8 @@ function buildToolingSection(params) {
 		hasWrite ? `Use \`${writeToolName}\` only for new files or intentional complete rewrites.` : "",
 		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." : "",
 		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

@@ -283,7 +283,6 @@ var AgentService = class {
 			sessionHydrator: this.sessionHydrator,
 			getConfig: () => this.effectiveAppConfig(),
 			getThinkingDefault: () => void 0,
-			getThinkingDefaultForSession: (sessionKey) => this.agentManager.getThinkingDefaultForSession(sessionKey),
 			workspaceRoot: this.workspaceDir,
 			getWorkspaceRootForSession: (sessionKey) => this.agentManager.getResolvedWorkspaceForSession(sessionKey),
 			getAgentInternalStorageRootForSession: (sessionKey) => resolveAgentHomeDir(this.config.config, extractProfileAgentId(sessionKey, this.config.config)),

package/dist/src/agent/starter-agents.js

@@ -8,7 +8,7 @@ init_paths();
 init_agent_scope();
 const STARTER_AGENTS_INITIALIZED_VERSION = 1;
 function denyTools(names) {
-	return { builtin: Object.fromEntries(names.map((name) => [name, { mode: "deny" }])) };
+	return Object.fromEntries(names.map((name) => [name, { mode: "deny" }]));
 }
 function identity(params) {
 	return `# IDENTITY.md - Who Am I?\n\n- **Name:** ${params.name}\n- **Description:** ${params.description}\n- **Language:** en\n- **Creature:** ${params.creature}\n- **Emoji:** ${params.emoji}\n- **Avatar:**\n`;
@@ -158,13 +158,6 @@ function ensureStarterAgentsInitialized(cfg) {
 		if (hasAgentEntry(next, starter.id)) continue;
 		next = applyAgentConfig(next, {
 			agentId: starter.id,
-			identity: {
-				name: starter.displayName,
-				description: starter.description,
-				role: starter.role,
-				language: "en",
-				tone: "direct"
-			},
 			...starter.tools ? { tools: starter.tools } : {}
 		});
 	}

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

@@ -1,4 +1,5 @@
 import { resolvePathUnderWorkspace } from "./tool-paths.js";
+import { turnOutcomeKindFromFileName } from "../../../packages/gateway-contract/src/turn-outcome.js";
 import { resolveGatewayEffectiveHost } from "../../config/gateway-bind.js";
 import { resolveShareConfig } from "../../share/share-config.js";
 import { mergeWithDefaults } from "../../share/site-share-config.js";
@@ -231,7 +232,7 @@ function successResult(locale, payload) {
 			artifacts: [{
 				artifactId: `share:${String(payload.shareUrl ?? "")}`,
 				title: String(payload.title ?? "Shared result"),
-				kind: payload.kind === "site" ? "site" : payload.kind === "zip" ? "archive" : "file",
+				kind: payload.kind === "site" ? "site" : payload.kind === "zip" ? "archive" : turnOutcomeKindFromFileName(String(payload.title ?? "Shared result")),
 				availability: "available",
 				location: "artifact_store",
 				capabilities: payload.kind === "site" ? ["preview", "share"] : ["download", "share"],

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

@@ -94,7 +94,8 @@ function createExecCommandTool(workspaceCwd, options) {
 		description: [
 			"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."
+			"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."
 		].join(" "),
 		parameters: ExecCommandSchema,
 		label: "Run Command",

package/dist/src/agent/tools/executor.d.ts

@@ -18,7 +18,7 @@ import type { ToolConcurrencyController as ToolConcurrencyControllerType } from
 export interface ToolExecutorConfig {
     /** Default per-tool timeout when the tool does not declare its own `timeoutMs`. */
     defaultTimeoutMs: number;
-    /** Per-session policy override resolved from the effective agent manifest. */
+    /** Per-session policy resolved from global defaults and agent overrides. */
     resolveTimeoutMs?: (toolName: string) => number | undefined;
     /** Max retry attempts for tools opted into retry via `idempotent: true`. */
     maxRetries: number;

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

@@ -22,6 +22,7 @@ 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";
@@ -280,6 +281,7 @@ var AgentToolsFactory = class {
 				getConfig: () => this.deps.getConfig?.()
 			})] : [],
 			createSendMediaTool(workspace, bus, () => this.deps.getCurrentContext()),
+			createPublishArtifactsTool(workspace),
 			createReadMediaTool(),
 			...isShareToolAvailable(cfg) ? [createCreateShareTool({
 				workspace,

package/dist/src/agent/tools/index.d.ts

@@ -14,6 +14,7 @@ export { createWebSearchTool, createWebFetchTool } from './web.js';
 export { createWebExtractTool, stripHtmlBoilerplate, DEFAULT_WEB_EXTRACT_MAX_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, } from './web-extract.js';
 export { createMessageTool } from './communication.js';
 export { createSendMediaTool } from './send-media.js';
+export { createPublishArtifactsTool } from './publish-artifacts.js';
 export { createReadMediaTool } from './media-read-tool.js';
 export { createCreateShareTool, isShareToolAvailable, type CreateShareToolDeps, } from './create-share-tool.js';
 export { createTodoTool, TodoStore, type TodoItem, type TodoStatus } from './todo-tool.js';

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

@@ -16,6 +16,7 @@ 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";
@@ -42,4 +43,4 @@ import { createManagedJobTool } from "./managed-job-tool.js";
 import { resolveImageModelConfigForTool } from "../image/tool-model-config.js";
 import { createImageTool } from "./image-tool.js";
 import { createImageGenerateTool, resolveImageGenerationModelConfigForTool } from "./image-generate-tool.js";
-export { BrowserManager, DEFAULT_DELEGATE_TOOLS, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_TOOL_METADATA, DEFAULT_WEB_EXTRACT_MAX_LENGTH, DELEGATE_BLOCKED_TOOLS, GREP_MAX_LINE_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, SANDBOX_ALLOWED_TOOLS, TodoStore, ToolConcurrencyController, assertBrowserUrlAllowed, buildSandboxToolMap, createApplyPatchTool, createAutomationTool, createBrowserRecipeTool, createClarifyTool, createCreateShareTool, createDelegateTool, createDesktopPetTool, createDreamingTool, createExecCommandTool, createExecuteCodeTool, createFindTool, createGrepTool, createImageGenerateTool, createImageTool, createListDirTool, createManagedJobTool, createMemoryGetTool, createMemorySearchTool, createMessageTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionRecallTool, createSessionSearchTool, createSessionStatusTool, createSkillInstallTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createSkillsMarketplaceSearchTool, createTodoTool, createToolManualTool, createUpdatePlanTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, createWorkflowTool, createWriteFileTool, createXopcUseTool, findTool, formatSize, fuzzyFindText, generateDiffString, getToolMetadata, grepTool, isShareToolAvailable, listDirTool, normalizeForFuzzyMatch, normalizeToLF, resolveImageGenerationModelConfigForTool, resolveImageModelConfigForTool, resolveToolLockMode, restoreLineEndings, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, writeFileTool };
+export { BrowserManager, DEFAULT_DELEGATE_TOOLS, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_TOOL_METADATA, DEFAULT_WEB_EXTRACT_MAX_LENGTH, DELEGATE_BLOCKED_TOOLS, GREP_MAX_LINE_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, SANDBOX_ALLOWED_TOOLS, TodoStore, ToolConcurrencyController, assertBrowserUrlAllowed, buildSandboxToolMap, createApplyPatchTool, createAutomationTool, createBrowserRecipeTool, createClarifyTool, createCreateShareTool, createDelegateTool, createDesktopPetTool, createDreamingTool, createExecCommandTool, createExecuteCodeTool, createFindTool, createGrepTool, createImageGenerateTool, createImageTool, createListDirTool, createManagedJobTool, createMemoryGetTool, createMemorySearchTool, createMessageTool, createPublishArtifactsTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionRecallTool, createSessionSearchTool, createSessionStatusTool, createSkillInstallTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createSkillsMarketplaceSearchTool, createTodoTool, createToolManualTool, createUpdatePlanTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, createWorkflowTool, createWriteFileTool, createXopcUseTool, findTool, formatSize, fuzzyFindText, generateDiffString, getToolMetadata, grepTool, isShareToolAvailable, listDirTool, normalizeForFuzzyMatch, normalizeToLF, resolveImageGenerationModelConfigForTool, resolveImageModelConfigForTool, resolveToolLockMode, restoreLineEndings, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, writeFileTool };

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

@@ -0,0 +1,2 @@
+import type { AgentTool } from '@earendil-works/pi-agent-core';
+export declare function createPublishArtifactsTool(workspace: string): AgentTool;

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

@@ -0,0 +1,82 @@
+import { checkFileSafety } from "../prompt/safety.js";
+import { resolvePathUnderWorkspace } from "./tool-paths.js";
+import { turnOutcomeKindFromFileName, turnOutcomeMimeTypeFromFileName } from "../../../packages/gateway-contract/src/turn-outcome.js";
+import { persistToolMedia } from "./tool-media.js";
+import { basename, isAbsolute } from "node:path";
+import { readFile } from "node:fs/promises";
+import { Type } from "@sinclair/typebox";
+//#region src/agent/tools/publish-artifacts.ts
+const PublishArtifactsSchema = Type.Object({ paths: Type.Array(Type.String({ minLength: 1 }), {
+	minItems: 1,
+	maxItems: 50,
+	description: "Files to publish. Relative paths resolve under the current agent workspace."
+}) });
+function createPublishArtifactsTool(workspace) {
+	return {
+		name: "publish_artifacts",
+		label: "Publish Artifacts",
+		description: "Publish completed user-facing files into durable chat artifacts. Call this after exec_command or another runtime creates spreadsheets, presentations, PDFs, documents, archives, or other files. Pass every final deliverable together; do not publish temporary or source files.",
+		parameters: PublishArtifactsSchema,
+		mutationScope: "none",
+		supportsParallel: false,
+		idempotent: false,
+		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 publishedCount = artifacts.filter((item) => item.availability === "available").length;
+			const failedCount = artifacts.length - publishedCount;
+			return {
+				content: [{
+					type: "text",
+					text: [
+						`${publishedCount} artifact${publishedCount === 1 ? "" : "s"} published`,
+						failedCount > 0 ? `${failedCount} failed` : "",
+						artifacts.map((item) => item.title).join(", ")
+					].filter(Boolean).join(": ")
+				}],
+				details: { artifacts }
+			};
+		}
+	};
+}
+//#endregion
+export { createPublishArtifactsTool };

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

@@ -1,5 +1,6 @@
 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";
@@ -67,7 +68,7 @@ function createSendMediaTool(workspace, bus, getContext) {
 						artifacts: [{
 							artifactId: media.id,
 							title: media.name,
-							kind: media.type === "photo" ? "image" : media.type === "video" ? "video" : media.type === "audio" ? "audio" : media.mimeType === "application/pdf" ? "pdf" : "file",
+							kind: media.type === "photo" ? "image" : media.type === "video" ? "video" : media.type === "audio" ? "audio" : turnOutcomeKindFromFileName(media.name),
 							mimeType: media.mimeType,
 							sizeBytes: media.size,
 							availability: "available",

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

@@ -143,11 +143,7 @@ function resolveDefinitionId(params, catalog, config, sessionKey) {
 		catalog.load(name);
 		return name;
 	}
-	const configuredDefault = config ? (() => {
-		const policy = resolveEffectiveAgentProfileForSession(config, sessionKey).manifest.workflows;
-		const intent = params.intent?.trim().toLowerCase();
-		return (intent ? policy.suggested?.find((entry) => entry.intent.toLowerCase() === intent)?.workflow : void 0) ?? policy.default;
-	})() : void 0;
+	const configuredDefault = config ? resolveEffectiveAgentProfileForSession(config, sessionKey).config.workflows.default : void 0;
 	if (configuredDefault) {
 		catalog.load(configuredDefault);
 		return configuredDefault;

package/dist/src/agent-config/index.d.ts

@@ -0,0 +1,2 @@
+export * from './schema.js';
+export * from './resolver.js';

package/dist/src/agent-config/index.js

@@ -0,0 +1,11 @@
+import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
+import { AgentDefaultsSchema, AgentEntrySchema, AgentModelsDefaultsSchema, AgentModelsOverrideSchema, AgentProfileSchema, AgentsConfigSchema, DEFAULT_AGENT_MODEL_REF, EffectiveAgentConfigSchema, ImageGenerationRouteSchema, ModelIntentSchema, ModelRefSchema, ModelRouteSchema, RuntimePolicySchema, SkillDefaultsSchema, SkillOverrideSchema, ToolModeSchema, ToolPoliciesSchema, ToolPolicySchema, WorkflowPolicySchema, init_schema } from "./schema.js";
+import { init_resolver, resolveEffectiveAgentConfig } from "./resolver.js";
+//#region src/agent-config/index.ts
+var init_agent_config = __esmMin((() => {
+	init_schema();
+	init_resolver();
+}));
+//#endregion
+init_agent_config();
+export { AgentDefaultsSchema, AgentEntrySchema, AgentModelsDefaultsSchema, AgentModelsOverrideSchema, AgentProfileSchema, AgentsConfigSchema, DEFAULT_AGENT_MODEL_REF, EffectiveAgentConfigSchema, ImageGenerationRouteSchema, ModelIntentSchema, ModelRefSchema, ModelRouteSchema, RuntimePolicySchema, SkillDefaultsSchema, SkillOverrideSchema, ToolModeSchema, ToolPoliciesSchema, ToolPolicySchema, WorkflowPolicySchema, init_agent_config, resolveEffectiveAgentConfig };

package/dist/src/agent-config/resolver.d.ts

@@ -0,0 +1,11 @@
+import { type AgentDefaults, type AgentEntry, type EffectiveAgentConfig } from './schema.js';
+export type AgentConfigSource = 'system' | 'global' | 'agent';
+export interface ResolveEffectiveAgentConfigResult {
+    config: EffectiveAgentConfig;
+    sources: Record<string, AgentConfigSource>;
+}
+export declare function resolveEffectiveAgentConfig(params: {
+    defaults: AgentDefaults;
+    agent: AgentEntry;
+    defaultWorkspace?: (agentId: string) => string;
+}): ResolveEffectiveAgentConfigResult;