@xopcai/xopc 0.0.232 → 0.0.234

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,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.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)));
@@ -94,7 +99,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, declare all final paths in outputs so they are persisted with this command."
 		].join(" "),
 		parameters: ExecCommandSchema,
 		label: "Run Command",
@@ -102,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: [{
@@ -206,7 +212,7 @@ function createExecCommandTool(workspaceCwd, options) {
 						}
 					});
 				};
-				const finish = (exitCode, errorText) => {
+				const finish = async (exitCode, errorText) => {
 					if (settled) return;
 					settled = true;
 					clearTimeout(timeout);
@@ -243,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
 					});
@@ -263,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";
@@ -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

@@ -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";
@@ -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,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

@@ -0,0 +1,95 @@
+import { resolvePathUnderWorkspace } from "./tool-paths.js";
+import { turnOutcomeKindFromFileName, turnOutcomeMimeTypeFromFileName } from "../../../packages/gateway-contract/src/turn-outcome.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";
+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."
+}) });
+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",
+		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 = await publishArtifactPaths({
+				paths,
+				baseDir: workspace,
+				toolCallId
+			});
+			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, publishArtifactPaths };

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/ai-assist/text-assist.js

@@ -1,9 +1,9 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { getAssistantMessageErrorReason, stripCodeFences } from "../providers/model-response.js";
 import { getDefaultModelSync, init_providers, resolveModel } from "../providers/index.js";
 import { createExtensionAwareStreamFn } from "../providers/extension-stream-bridge.js";
 import { isLocalModelBaseUrl, resolveModelCallApiKey, resolveModelCallOptions } from "../providers/model-call.js";
-import { getAssistantMessageErrorReason, stripCodeFences } from "../providers/model-response.js";
 //#region src/ai-assist/text-assist.ts
 init_providers();
 init_logger();

package/dist/src/auth/credentials.js

@@ -1,10 +1,10 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_paths, resolveAgentAuthProfilesPath, resolveAuthProfilesPath, resolveCredentialsDir, resolveOAuthPath } from "../config/paths.js";
 import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
-import { getOAuthProviderDefinition, init_registry } from "./oauth/registry.js";
+import { init_paths, resolveAgentAuthProfilesPath, resolveAuthProfilesPath, resolveCredentialsDir, resolveOAuthPath } from "../config/paths.js";
 import { getApiKeyFromEnv, init_env_keys } from "../providers/env-keys.js";
+import { getOAuthProviderDefinition, init_registry } from "./oauth/registry.js";
 import { init_oauth_provider_lock, withOAuthProviderLock } from "./oauth-provider-lock.js";
 import { dirname, join } from "path";
 import { mkdir, readFile, readdir, rm } from "fs/promises";

package/dist/src/auth/profiles/store.js

@@ -1,5 +1,5 @@
-import { init_paths, resolveCredentialsDir } from "../../config/paths.js";
 import { init_write_file_atomic, writeTextAtomicSync } from "../../infra/write-file-atomic.js";
+import { init_paths, resolveCredentialsDir } from "../../config/paths.js";
 import path from "node:path";
 import { chmodSync, existsSync, mkdirSync, readFileSync } from "node:fs";
 //#region src/auth/profiles/store.ts

package/dist/src/auth/sync-provider-auth.js

@@ -1,8 +1,8 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { init_paths, resolveAgentAuthProfilesPath, resolveAuthProfilesPath, resolveOAuthPath } from "../config/paths.js";
-import { init_loader, loadConfig } from "../config/loader.js";
 import { init_registry, isOAuthOnlyProvider } from "./oauth/registry.js";
+import { init_loader, loadConfig } from "../config/loader.js";
+import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { existsSync, readFileSync } from "node:fs";
 //#region src/auth/sync-provider-auth.ts
 /**

package/dist/src/browser/providers/browser-ext-install.js

@@ -2,8 +2,8 @@ import { PACKAGE_VERSION, init_package_version } from "../../package-version.js"
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { assertCacheDir, init_cache_dir_policy } from "../cache-dir-policy.js";
-import { init_paths, resolveBinDir } from "../../config/paths.js";
 import { init_write_file_atomic, writeTextAtomic } from "../../infra/write-file-atomic.js";
+import { init_paths, resolveBinDir } from "../../config/paths.js";
 import { shouldRunExtensionBridgeServer } from "../backend-from-config.js";
 import { resolvePackageRoot } from "../../infra/update-check.js";
 import { dirname, join } from "node:path";

package/dist/src/cli/command-catalog.js

@@ -44,6 +44,10 @@ const cliCommandCatalog = [
 		commandPath: ["doctor"],
 		policy: { loadExtensions: "never" }
 	},
+	{
+		commandPath: ["support"],
+		policy: { loadExtensions: "never" }
+	},
 	{
 		commandPath: ["models"],
 		policy: { loadExtensions: "never" }

package/dist/src/cli/command-loaders.js

@@ -16,6 +16,7 @@ const REGISTRY_COMMAND_MODULES = {
 	project: () => import("./commands/project.js"),
 	config: () => import("./commands/config.js"),
 	doctor: () => import("./commands/doctor/index.js"),
+	support: () => import("./commands/support.js"),
 	runtime: () => import("./commands/runtime.js"),
 	image: () => import("./commands/image.js"),
 	channels: () => import("./commands/channels.js"),

package/dist/src/cli/command-manifest.js

@@ -83,6 +83,10 @@ const ROOT_HELP_COMMANDS = [
 		name: "doctor [options]",
 		description: "Check xopc installation health and diagnose common issues"
 	},
+	{
+		name: "support",
+		description: "Create a redacted diagnostic report for an xopc problem"
+	},
 	{
 		name: "runtime",
 		description: "Manage Node.js and Python tool runtimes used by agents"

package/dist/src/cli/commands/auth.js

@@ -4,9 +4,9 @@ import { CredentialResolver, init_credentials } from "../../auth/credentials.js"
 import { getAllProviders, init_providers } from "../../providers/index.js";
 import { formatExamples, register } from "../registry.js";
 import { disconnectProvider } from "../../providers/provider-disconnect.js";
+import { colorizeStatus, colors } from "../utils/colors.js";
 import { listAllProfiles, listProfilesForProvider, removeAuthProfile, upsertAuthProfile } from "../../auth/profiles/profiles.js";
 import { getOAuthProvider, getSupportedOAuthProviders } from "../utils/oauth-providers.js";
-import { colorizeStatus, colors } from "../utils/colors.js";
 import { runCliOAuthLogin } from "../utils/oauth-login.js";
 import { Command } from "commander";
 //#region src/cli/commands/auth.ts

package/dist/src/cli/commands/doctor/checks/database-schema.js

@@ -52,7 +52,7 @@ async function checkDatabaseSchema(ctx) {
 		id: "database-schema",
 		label: "Database schema",
 		status: "pass",
-		message: `SQLite schema v${status.dbVersion} (current release v138).`,
+		message: `SQLite schema v${status.dbVersion} (current release v140).`,
 		hints: []
 	};
 }

package/dist/src/cli/commands/doctor/checks/provider-auth.js

@@ -1,6 +1,6 @@
 import { getAgentDefaultModelRef, init_schema, parseModelRef } from "../../../../config/schema.js";
-import { init_loader, loadConfig } from "../../../../config/loader.js";
 import { PROVIDER_ENV_MAP, getApiKeyFromEnv, init_env_keys } from "../../../../providers/env-keys.js";
+import { init_loader, loadConfig } from "../../../../config/loader.js";
 import { existsSync } from "node:fs";
 //#region src/cli/commands/doctor/checks/provider-auth.ts
 init_loader();

package/dist/src/cli/commands/models.js

@@ -1,6 +1,6 @@
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
-import { loadConfig, saveConfig } from "../../config/loader.js";
 import { CredentialResolver, init_credentials } from "../../auth/credentials.js";
+import { loadConfig, saveConfig } from "../../config/loader.js";
 import { getAllModels, getAvailableModels, getConfiguredProviders, getProviderAuthState, getProviderDisplayName, init_providers, isProviderConfigured, providerSupportsApiKey, providerSupportsOAuth, resolveModel } from "../../providers/index.js";
 import { formatExamples, register } from "../registry.js";
 import { getContextWithOpts } from "../context.js";

package/dist/src/cli/commands/onboard/model.js

@@ -10,9 +10,9 @@ import { discoverProviderModels, isProviderApiDiscoverable } from "../../../prov
 import { getXopcCloudCatalogCoordinator } from "../../../providers/xopc-cloud-catalog-coordinator.js";
 import { getDomesticProviderBaseUrl, getDomesticProviderPreset, getDomesticProviderPresetIds, providerConfigFromDomesticPreset } from "../../../providers/domestic-presets.js";
 import { getProviderHint, getRecommendedModelsForProvider, sortModelsForPicker, sortProvidersForPicker } from "../../../providers/presentation.js";
+import { colors } from "../../utils/colors.js";
 import { listProfilesForProvider } from "../../../auth/profiles/profiles.js";
 import { getOAuthProvider } from "../../utils/oauth-providers.js";
-import { colors } from "../../utils/colors.js";
 import { runCliOAuthLogin } from "../../utils/oauth-login.js";
 import { confirm, input, select } from "@inquirer/prompts";
 //#region src/cli/commands/onboard/model.ts

package/dist/src/cli/commands/providers.js

@@ -1,8 +1,8 @@
 import { PROVIDER_ENV_MAP, getApiKeyFromEnv } from "../../providers/env-keys.js";
 import { PROVIDER_META, getAllProviders, getSortedProviders, init_providers } from "../../providers/index.js";
 import { formatExamples, register } from "../registry.js";
-import { getProfile, listAllProfiles, listProfilesForProvider, removeAuthProfile, upsertAuthProfile } from "../../auth/profiles/profiles.js";
 import { colors } from "../utils/colors.js";
+import { getProfile, listAllProfiles, listProfilesForProvider, removeAuthProfile, upsertAuthProfile } from "../../auth/profiles/profiles.js";
 import { SETUP_EXIT } from "./setup-shared/types.js";
 import { emitTask } from "./setup-shared/output.js";
 import { isPromptCancelled, promptSecret } from "./setup-shared/prompts.js";

package/dist/src/cli/commands/support.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/cli/commands/support.js

@@ -0,0 +1,51 @@
+import { init_paths_state, resolveStateDir } from "../../config/paths-state.js";
+import { formatExamples, register } from "../registry.js";
+import { collectSupportReport } from "../../support/collect-support-report.js";
+import { SupportReportInputSchema } from "../../support/types.js";
+import { resolve } from "node:path";
+import { writeFile } from "node:fs/promises";
+import { Command } from "commander";
+//#region src/cli/commands/support.ts
+init_paths_state();
+function defaultOutputPath(capturedAt) {
+	return resolve(`xopc-diagnostics-${capturedAt.replace(/[:.]/g, "-")}.json`);
+}
+async function runSupportReport(ctx, options) {
+	const report = await collectSupportReport(SupportReportInputSchema.parse({
+		problem: options.problem ?? "xopc startup or runtime problem",
+		occurredAt: (/* @__PURE__ */ new Date()).toISOString()
+	}), { paths: {
+		configPath: ctx.configPath,
+		stateDir: resolveStateDir(),
+		workspaceDir: ctx.workspacePath
+	} });
+	const outputPath = options.output ? resolve(options.output) : defaultOutputPath(report.capturedAt);
+	await writeFile(outputPath, `${JSON.stringify(report, null, 2)}\n`, {
+		encoding: "utf8",
+		flag: "wx",
+		mode: 384
+	});
+	console.log(report.markdown);
+	console.log(`\nDiagnostic file: ${outputPath}`);
+}
+function createSupportCommand(ctx) {
+	const command = new Command("support").description("Create a redacted diagnostic report for an xopc problem").addHelpText("after", formatExamples([
+		"xopc support report",
+		"xopc support report --problem \"Telegram receives messages but does not reply\"",
+		"xopc support report --output ./xopc-diagnostics.json"
+	]));
+	command.command("report").description("Collect Doctor results and nearby warning/error logs").option("-p, --problem <text>", "Short description of the problem").option("-o, --output <path>", "Diagnostic JSON output path (must not already exist)").action((options) => runSupportReport(ctx, options));
+	return command;
+}
+register({
+	id: "support",
+	name: "support",
+	description: "Create a redacted diagnostic report for an xopc problem",
+	factory: createSupportCommand,
+	metadata: {
+		category: "maintenance",
+		examples: ["xopc support report"]
+	}
+});
+//#endregion
+export {};

package/dist/src/config/index.js

@@ -2,15 +2,15 @@ import { ENV_VARS, XOPC_DB_FILENAME, resolveHomeDir, resolveStateDir, resolveXop
 import { TelegramAccountConfigSchema, TelegramConfigSchema, TelegramGroupConfigSchema, TelegramTopicConfigSchema } from "../../extensions/telegram/src/config-schema.js";
 import { WeixinAccountConfigSchema, WeixinConfigSchema } from "../../extensions/weixin/src/config-schema.js";
 import { AgentImageGenerationModelSchema, AgentModelRefSchema, AgentModelsSchema, AgentsConfigSchema, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, BrowserConfigSchema, ChannelsConfigSchema, CommandsConfigSchema, ConfigSchema, ConnectorsConfigSchema, ExperimentalConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, GatewayWebchatConfigSchema, HeartbeatConfigSchema, McpConfigSchema, McpOAuthConfigSchema, McpServerSchema, MediaUnderstandingCapabilitiesSchema, MediaUnderstandingModelSchema, MessagesConfigSchema, ModelCatalogConfigSchema, ModelsDevConfigSchema, ProviderAuthConfigSchema, ProviderAzureConfigSchema, ProviderRequestOverridesSchema, ProvidersConfigSchema, RuntimeToolsConfigSchema, STTConfigSchema, STTFallbackConfigSchema, STTProviderConfigSchema, SearchProviderEntrySchema, SessionConfigSchema, SessionDmScopeSchema, SessionResetByTypeSchema, SessionResetConfigSchema, SessionResetModeSchema, SessionScopeSchema, SessionStorageConfigSchema, TTSConfigSchema, TTSEdgeConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSProviderConfigSchema, TTSSummarizationConfigSchema, ToolsConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, TuiConfigSchema, TunnelConfigSchema, TunnelConsentSchema, UpdateAutoConfigSchema, UpdateConfigSchema, VoiceConfigSchema, VoiceRefinementConfigSchema, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, getAgentDefaultImageGenerationModelConfig, getAgentDefaultImageModelConfig, getAgentDefaultModelRef, init_schema, parseModelRef } from "./schema.js";
-import { applyConfigOverrides, getConfigOverrides, resetConfigOverrides, setConfigOverride, unsetConfigOverride } from "./runtime-overrides.js";
+import { clearConfigValueCache, getAllowedCommands, getCacheStats, init_resolve_config_value, resolveConfigValue, resolveHeaders, testApiKeyResolution } from "./resolve-config-value.js";
 import { expandWorkspacePathString, init_workspace_path, normalizeWorkspaceDir, resolveWorkspaceRoot } from "./workspace-path.js";
 import { resolveDefaultAgentWorkspaceDir } from "./workspace-defaults.js";
 import { resolveAgentDir as resolveAgentDir$1, resolveAgentHomeDir as resolveAgentHomeDir$1, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
-import { extractProfileAgentId, resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "./agent-profile.js";
 import { FILENAMES, WORKSPACE_FILES, existsSync, hasBundledExtensionManifest, init_paths, resolveAgentAuthProfilesPath, resolveAgentDir, resolveAgentHomeDir, resolveAgentProfileDir, resolveAgentProfileMarkdownPath, resolveAuthProfilesPath, resolveBinDir, resolveBundledExtensionsDir, resolveBundledSkillsDir, resolveConfigPath, resolveCredentialsDir, resolveExtensionSdkPath, resolveExtensionsDir, resolveExtensionsLockPath, resolveInboxDir, resolveInboxMessagePath, resolveInboxPendingDir, resolveInboxProcessedDir, resolveLogPath, resolveLogsDir, resolveMcpOAuthPath, resolveModelsJsonPath, resolveNodeBinDir, resolveNodeBinPath, resolveNodeToolsDir, resolveNpmBinPath, resolveOAuthPath, resolvePidPath, resolveSkillPath, resolveSkillsCachePath, resolveSkillsDir, resolveSkillsLockPath, resolveSocketPath, resolveStatusPath, resolveToolsDir, resolveWorkspaceExtensionsDir, resolveWorkspaceFile, resolveWorkspaceStateDir, resolveWorkspaceStatePath, resolveXopcBinPath } from "./paths.js";
-import { init_loader, loadConfig, saveConfig } from "./loader.js";
-import { clearConfigValueCache, getAllowedCommands, getCacheStats, init_resolve_config_value, resolveConfigValue, resolveHeaders, testApiKeyResolution } from "./resolve-config-value.js";
 import { CustomModelSchema, ImageGenerationCapabilitiesSchema, ImageGenerationModelSchema, ImageGenerationProviderSchema, ModelOverrideSchema, ModelsJsonSchema, OpenAICompatSchema, OpenAICompletionsCompatSchema, OpenAIResponsesCompatSchema, OpenRouterRoutingSchema, ProviderConfigSchema, VercelGatewayRoutingSchema, getDefaultModelValues, init_models_json, loadModelsJson, modelsJsonExists, saveModelsJson, validateModelsConfig } from "./models-json.js";
+import { init_loader, loadConfig, saveConfig } from "./loader.js";
+import { applyConfigOverrides, getConfigOverrides, resetConfigOverrides, setConfigOverride, unsetConfigOverride } from "./runtime-overrides.js";
+import { extractProfileAgentId, resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "./agent-profile.js";
 import { canonicalizeConfiguredMcpServer, isKnownCliMcpTypeAlias, normalizeConfiguredMcpServers, resolveXopcMcpTransportAlias } from "./mcp-config-normalize.js";
 import { formatThinkingLevels, listThinkingLevels, normalizeElevatedMode, normalizeReasoningLevel, normalizeThinkLevel, normalizeVerboseLevel, thinkLevelToNumber } from "../agent/transcript/thinking-types.js";
 import { getWorkspacePath } from "./workspace-path-helpers.js";

package/dist/src/config/loader.js

@@ -2,8 +2,8 @@ import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { ConfigSchema, init_schema } from "./schema.js";
-import { init_paths, resolveConfigPath } from "./paths.js";
 import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
+import { init_paths, resolveConfigPath } from "./paths.js";
 import { assertChannelPluginConfigs, init_validate_channel_configs } from "./validate-channel-configs.js";
 import { dirname } from "path";
 import { existsSync, mkdirSync, promises, readFileSync } from "fs";

package/dist/src/config/models-json.js

@@ -1,6 +1,6 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { init_paths, resolveModelsJsonPath } from "./paths.js";
 import { init_write_file_atomic, writeTextAtomicSync } from "../infra/write-file-atomic.js";
+import { init_paths, resolveModelsJsonPath } from "./paths.js";
 import { existsSync, readFileSync } from "fs";
 import { z } from "zod";
 //#region src/config/models-json.ts

package/dist/src/endpoint-tools/binding-service.d.ts

@@ -0,0 +1,22 @@
+import type { EndpointConnectionSnapshot } from './registry.js';
+import { EndpointRegistry } from './registry.js';
+export interface EndpointSessionBinding {
+    sessionKey: string;
+    endpointId: string;
+    boundAt: number;
+}
+export interface EndpointSessionBindingStore {
+    get(sessionKey: string): EndpointSessionBinding | undefined;
+    set(binding: EndpointSessionBinding): EndpointSessionBinding;
+    delete(sessionKey: string): boolean;
+}
+export declare class EndpointBindingService {
+    private readonly registry;
+    private readonly store;
+    constructor(registry: EndpointRegistry, store?: EndpointSessionBindingStore);
+    bind(sessionKey: string, endpointId: string, now?: number): EndpointSessionBinding;
+    get(sessionKey: string): EndpointSessionBinding | undefined;
+    resolve(sessionKey: string): EndpointConnectionSnapshot | undefined;
+    unbind(sessionKey: string): boolean;
+    private normalizeSessionKey;
+}