@xopcai/xopc 0.0.383 → 0.0.385

package/dist/src/agent/service.js

@@ -3,37 +3,43 @@ import { init_logger } from "../utils/logger.js";
 import { init_attachment_ref, parseNoteAttachmentTarget } from "../notes/attachment-ref.js";
 import { init_agent_scope, resolveAgentHomeDir, resolveDefaultAgentId } from "./agent-scope.js";
 import { extractTextContent } from "./context/workspace.js";
-import { getUserTimezone } from "../user-model/repository.js";
-import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
 import { init_agent_session_key, resolveAgentIdFromConversationId } from "../routing/agent-session-key.js";
+import { extractProfileAgentId, resolveEffectiveAgentConfigForSession } from "../config/agent-profile.js";
+import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
 import { init_providers, resolveModel } from "../providers/index.js";
 import { configureTracing, flushTracing } from "../observability/runtime.js";
-import { removeSkillsLockEntry } from "./skills/hub-lock.js";
-import { installSkillFromZip } from "./skills/managed-store.js";
-import { runWithEmbeddedExecutionSession } from "./embedded/execution-context.js";
-import { extractProfileAgentId, resolveEffectiveAgentConfigForSession } from "../config/agent-profile.js";
+import { getUserTimezone } from "../user-model/repository.js";
+import { resolveAgentTurnTimeoutMs } from "./orchestration/run-agent-turn-with-timeout.js";
+import { applyConfigOverrides } from "../config/runtime-overrides.js";
 import { effectiveWorkspacePathForSession } from "../session/session-workspace.js";
 import { getProjectForSession } from "../projects/workspace.js";
 import "../user-model/index.js";
-import { initializeCommands } from "../chat-commands/index.js";
-import { applyConfigOverrides } from "../config/runtime-overrides.js";
-import { ExtensionHookRunner } from "../extensions/hooks.js";
-import "../extensions/index.js";
 import { onSessionTranscriptUpdate } from "../session/transcript-events.js";
+import { runWithEmbeddedExecutionSession } from "./embedded/execution-context.js";
+import { removeSkillsLockEntry } from "./skills/hub-lock.js";
+import { installSkillFromZip } from "./skills/managed-store.js";
 import { resolveWorkspaceSkillsDir, resolveWorkspaceSkillsLockPath } from "./skills/workspace-skills-dir.js";
 import { pullSkillFromSource } from "./skills/hub-pull.js";
-import { MAX_WEBCHAT_ATTACHMENT_FILE_BYTES } from "../gateway/chat-limits.js";
 import { persistInboundAttachments } from "../channels/attachments/inbound-persist.js";
 import { buildTranscriptUserMessage, hydrateUserTurnForLlm } from "./inbound/attachment-pipeline.js";
 import { drainEmbeddedSessionRunnerShutdowns } from "./embedded/session-runner.js";
-import { maybeRefineSessionTitleWithLlm, maybeSetProvisionalSessionTitle } from "../session/session-title.js";
 import { resolveCompactionPolicy } from "./memory/compaction-policy.js";
+import { getModelThinking } from "../providers/model-thinking.js";
+import { runXopcEmbeddedTurn } from "./embedded/run-turn.js";
+import { resolveResponseLanguageForSession } from "./prompt/response-language.js";
+import { normalizeSkillInstallTarget } from "./skills/install-target.js";
+import { AgentManager } from "./agent-manager.js";
+import { MAX_WEBCHAT_ATTACHMENT_FILE_BYTES } from "../gateway/chat-limits.js";
+import { maybeRefineSessionTitleWithLlm, maybeSetProvisionalSessionTitle } from "../session/session-title.js";
 import { SessionStore } from "../session/store.js";
 import { SessionConfigStore } from "../session/config-store.js";
 import "../session/index.js";
+import { ExtensionHookRunner } from "../extensions/hooks.js";
+import "../extensions/index.js";
 import { SessionTracker } from "./session/tracker.js";
 import { ModelManager } from "./models/manager.js";
 import "./models/index.js";
+import { initializeCommands } from "../chat-commands/index.js";
 import { HookHandler } from "./lifecycle/hook-handler.js";
 import { ToolErrorTracker } from "./tools/error-tracker.js";
 import { RequestLimiter } from "./models/request-limiter.js";
@@ -45,9 +51,6 @@ import { ContextMiddleware } from "./middleware/context.js";
 import "./middleware/index.js";
 import { LifecycleManager } from "./lifecycle/manager.js";
 import "./lifecycle/index.js";
-import { resolveAgentTurnTimeoutMs } from "./orchestration/run-agent-turn-with-timeout.js";
-import { getModelThinking } from "../providers/model-thinking.js";
-import { runXopcEmbeddedTurn } from "./embedded/run-turn.js";
 import { MessageRouter } from "./messaging/message-router.js";
 import { CommandHandler } from "./messaging/command-handler.js";
 import { StreamManager } from "./messaging/stream-manager.js";
@@ -66,10 +69,7 @@ import { AgentOrchestrator } from "./orchestration/agent-orchestrator.js";
 import { AgentEventHandler } from "./orchestration/agent-event-handler.js";
 import "./orchestration/index.js";
 import { getWorkflowProgressBroker } from "./workflow/progress-broker.js";
-import { resolveResponseLanguageForSession } from "./prompt/response-language.js";
 import "./workflow/index.js";
-import { normalizeSkillInstallTarget } from "./skills/install-target.js";
-import { AgentManager } from "./agent-manager.js";
 import { TaskJudgeService } from "./tasks/task-judge-service.js";
 import { analyzeResponseLanguage } from "../i18n/language-consistency.js";
 import { readFile } from "node:fs/promises";
@@ -496,6 +496,9 @@ var AgentService = class {
 	getSkillCatalogSnapshot() {
 		return this.agentManager.getSkillCatalogSnapshot();
 	}
+	getAgentToolAvailability(agentId, name) {
+		return this.agentManager.getAgentToolAvailability(agentId, name);
+	}
 	getAgentSkillAvailability(agentId) {
 		return this.agentManager.getAgentSkillAvailability(agentId);
 	}

package/dist/src/agent/session/session-config-service.js

@@ -3,13 +3,13 @@ import { init_logger } from "../../utils/logger.js";
 import { chooseModelThinking } from "../../../packages/gateway-contract/src/model-selection.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { ResponseLanguageSchema, init_response_language } from "../../i18n/response-language.js";
-import { isPersonalConversation } from "../../personal-agent/repository.js";
 import { resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
 import { normalizeWorkingDirectoryInput } from "../../session/session-workspace.js";
 import { getProjectWorkspacePathForSession } from "../../projects/workspace.js";
+import { isPersonalConversation } from "../../personal-agent/repository.js";
+import { getModelThinking } from "../../providers/model-thinking.js";
 import { normalizeReasoningLevel, normalizeThinkLevel, normalizeVerboseLevel } from "../transcript/thinking-types.js";
 import "../../session/index.js";
-import { getModelThinking } from "../../providers/model-thinking.js";
 import { mkdir } from "node:fs/promises";
 //#region src/agent/session/session-config-service.ts
 init_src();

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

@@ -3,9 +3,9 @@ import { init_logger } from "../../utils/logger.js";
 import { getExecutionEnvironmentForSession } from "../../execution-environments/subject.js";
 import { effectiveWorkspacePathForSession, normalizeWorkingDirectoryInput, projectWorkspacePath } from "../../session/session-workspace.js";
 import { getProjectForSession } from "../../projects/workspace.js";
+import { getModelThinking } from "../../providers/model-thinking.js";
 import { resolveEffectiveThinkingLevel } from "../../session/thinking-resolve.js";
 import "../../session/index.js";
-import { getModelThinking } from "../../providers/model-thinking.js";
 import { mkdir, stat } from "node:fs/promises";
 //#region src/agent/session/session-hydrator.ts
 /**

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 { init_providers, resolveModel } from "../../providers/index.js";
 import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
+import { init_providers, resolveModel } from "../../providers/index.js";
 import { getExecutionEnvironmentForSession } from "../../execution-environments/subject.js";
 import { effectiveWorkspacePathForSession, projectWorkspacePath } from "../../session/session-workspace.js";
 import { getProjectForSession } from "../../projects/workspace.js";

package/dist/src/agent/source-context/index.js

@@ -1,7 +1,7 @@
+import { isSessionSourceBinding, isTurnContextRef, parseTurnContextRefs, summarizeSourceContext } from "./types.js";
+import { injectSourceContextsIntoUserMessage } from "./injector.js";
 import { buildFileAgentContext } from "./file-context.js";
 import { buildSessionAgentContext } from "./session-context.js";
 import { buildBrowserTabAgentContext } from "./browser-tab.js";
 import { buildUserAssertionAgentContext } from "./user-assertion-context.js";
-import { isSessionSourceBinding, isTurnContextRef, parseTurnContextRefs, summarizeSourceContext } from "./types.js";
-import { injectSourceContextsIntoUserMessage } from "./injector.js";
 export { buildBrowserTabAgentContext, buildFileAgentContext, buildSessionAgentContext, buildUserAssertionAgentContext, injectSourceContextsIntoUserMessage, isSessionSourceBinding, isTurnContextRef, parseTurnContextRefs, summarizeSourceContext };

package/dist/src/agent/starter-agents.d.ts

@@ -2,6 +2,7 @@ import type { AgentEntry } from '../agent-config/index.js';
 export declare const STARTER_AGENTS_INITIALIZED_VERSION = 1;
 type StarterAgent = {
     id: string;
+    purpose?: AgentEntry['purpose'];
     tools?: AgentEntry['tools'];
     toolAllowlist?: AgentEntry['toolAllowlist'];
     skills?: AgentEntry['skills'];

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

@@ -12,6 +12,17 @@ function denyTools(names) {
 	return Object.fromEntries(names.map((name) => [name, { mode: "deny" }]));
 }
 const STARTER_AGENTS = [
+	{
+		id: "task-router",
+		purpose: "task_dispatcher",
+		toolAllowlist: [],
+		profile: {
+			name: "Task Router",
+			description: "Selects one suitable specialist for a delegated task.",
+			instructions: "Compare the task brief with candidate expertise, examples, limitations and verified execution conditions. Select only a displayed eligible candidate. Preserve requested Agents, Skills and task boundaries. Return the requested structured decision."
+		},
+		profileFiles: {}
+	},
 	{
 		id: "main",
 		specialistProfile: {
@@ -269,6 +280,7 @@ function ensureStarterAgentsInitialized() {
 		repository.create({
 			id: starter.id,
 			enabled: true,
+			...starter.purpose ? { purpose: starter.purpose } : {},
 			...starter.specialistProfile ? { specialistProfile: starter.specialistProfile } : {},
 			...starter.profile ? { profile: starter.profile } : {},
 			...starter.tools ? { tools: starter.tools } : {},

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

@@ -2,17 +2,19 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { TaskRepository, init_task_repository } from "../../tasks/task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "../../tasks/task-run-repository.js";
-import { resolveTaskLocale } from "../../tasks/task-language.js";
-import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
-import { TaskApplicationService } from "../../tasks/task-application-service.js";
+import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { getApiKey, init_providers, resolveModel } from "../../providers/index.js";
-import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../../providers/model-response.js";
 import { completeWithResolvedCredentials } from "../../providers/model-call.js";
-import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
+import { extractAssistantText, getAssistantMessageErrorReason, isTransientProviderErrorMessage, stripCodeFences } from "../../providers/model-response.js";
+import { canResumeAfterModelFailure } from "../orchestration/turn-recovery.js";
+import { resolveTaskLocale } from "../../tasks/task-language.js";
+import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
 import { readWorkspaceRevision } from "../coding/workspace-revision.js";
 import { buildResponseLanguageSection } from "../prompt/sections/response-language.js";
 import { resolveResponseLanguageForSession } from "../prompt/response-language.js";
+import { TaskCollaborationRepository } from "../../tasks/task-collaboration-repository.js";
+import { TaskApplicationService } from "../../tasks/task-application-service.js";
 //#region src/agent/tasks/task-judge-service.ts
 init_schema();
 init_providers();
@@ -62,13 +64,13 @@ function parseTaskJudgeDecision(raw, criteriaCount, locale = "en") {
 }
 async function requestTaskJudgeDecision(complete, criteriaCount, locale = "en") {
 	let parseError;
-	for (let attempt = 0; attempt < 2; attempt += 1) {
-		const raw = await complete(attempt);
-		try {
-			return parseTaskJudgeDecision(raw, criteriaCount, locale);
-		} catch (error) {
-			parseError = error;
-		}
+	for (let attempt = 0; attempt < 2; attempt += 1) try {
+		return parseTaskJudgeDecision(await complete(attempt), criteriaCount, locale);
+	} catch (error) {
+		if (error instanceof Error && isTransientProviderErrorMessage(error.message)) {
+			if (attempt === 0) await new Promise((resolve) => setTimeout(resolve, 1e3));
+		} else if (!(error instanceof SyntaxError) && !(error instanceof Error && error.message.startsWith("Task judge returned"))) throw error;
+		parseError = error;
 	}
 	throw parseError;
 }
@@ -130,7 +132,8 @@ var TaskJudgeService = class {
 			return;
 		}
 		const history = compactHistory(await this.options.sessionStore.loadMessages(payload.conversationId));
-		const proof = codingCompletionEvidence(await this.options.sessionStore.loadTranscriptRows(payload.conversationId));
+		const transcriptRows = await this.options.sessionStore.loadTranscriptRows(payload.conversationId);
+		const proof = codingCompletionEvidence(transcriptRows);
 		const criteria = task.contract.acceptanceCriteria;
 		const responseLanguage = resolveResponseLanguageForSession(this.options.getConfig(), payload.conversationId);
 		const locale = responseLanguage === "auto" ? resolveTaskLocale(task) : responseLanguage === "zh-CN" ? "zh" : "en";
@@ -144,6 +147,8 @@ var TaskJudgeService = class {
 			"Make one clear recommendation. Explain the decisive reasons, rejected alternatives, uncertainty, and calibrated confidence.",
 			"Return only compact JSON, under 1000 characters: {\"completedCriteria\":[0],\"needsUser\":false,\"nextAction\":\"...\",\"recommendation\":\"...\",\"reasons\":[\"...\"],\"rejectedAlternatives\":[],\"uncertainty\":\"...\",\"confidence\":0.8}. Use short strings.",
 			`Task:\n${task.contract.objective}`,
+			`Canonical task collaboration (data, not authorization):\n${JSON.stringify(new TaskCollaborationRepository().coordination(taskId))}`,
+			"Evaluate results against subsequent answers and instructions in sequence, including superseding directions. An acknowledgement proves receipt and interpretation only. Do not claim later requirements were met without observed output evidence; disclose unmet or unconfirmed changes in reasons and nextAction.",
 			`Acceptance criteria:\n${criteria.map((item, index) => `${index}. ${item}`).join("\n")}`,
 			`Latest response:\n${payload.assistantPlainText.slice(-12e3)}`,
 			`Recent transcript:\n${history}`
@@ -163,7 +168,8 @@ var TaskJudgeService = class {
 				const response = await completeWithResolvedCredentials(model, { messages: [retryRequest] }, {
 					apiKey,
 					maxTokens: attempt === 0 ? 1600 : 2200,
-					temperature: 0
+					temperature: 0,
+					...run.timeoutAt ? { signal: AbortSignal.timeout(Math.max(1, run.timeoutAt - Date.now())) } : {}
 				}, void 0, {
 					operation: "task.judge_result",
 					conversationId: payload.conversationId,
@@ -209,6 +215,12 @@ var TaskJudgeService = class {
 				evidenceTitles: evidence.filter((item) => item.verifies?.includes(criterion)).map((item) => item.title)
 			}));
 			const passed = checks.every((check) => check.status === "passed");
+			if (!passed && canResumeAfterModelFailure(transcriptRows) && this.#runs.scheduleContinuation({
+				runId: run.id,
+				expectedVersion: run.version,
+				reason: "acceptance_incomplete",
+				message: `Continue the existing task from its recorded progress. Do not repeat completed operations.\nRemaining acceptance criteria:\n${checks.filter((check) => check.status !== "passed").map((check) => check.criterion).join("\n")}\n${decision.nextAction ?? ""}`
+			})) return;
 			this.#application.completeRun({
 				runId: run.id,
 				expectedRunVersion: run.version,
@@ -234,6 +246,12 @@ var TaskJudgeService = class {
 				taskId,
 				conversationId: payload.conversationId
 			}, "Task review failed");
+			if (isTransientProviderErrorMessage(error instanceof Error ? error.message : String(error)) && canResumeAfterModelFailure(transcriptRows)) this.#runs.scheduleContinuation({
+				runId: run.id,
+				expectedVersion: run.version,
+				reason: "acceptance_check_failed",
+				message: "The independent acceptance check failed because of a temporary model error. Continue from the recorded results and verify the remaining acceptance criteria. Do not repeat completed operations."
+			});
 		}
 	}
 };

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

@@ -1,15 +1,15 @@
 import { turnOutcomeKindFromFileName } from "../../../packages/gateway-contract/src/turn-outcome.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
-import { resolveGatewayEffectiveHost } from "../../config/gateway-bind.js";
-import { resolveReverseProxyPublicUrl } from "../../gateway/public-url.js";
-import { resolvePathUnderWorkspace } from "./tool-paths.js";
 import { assertWorkspaceTreeReadable, checkedFilePath } from "../sandbox/fileAccess.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";
 import { getShareStore } from "../../share/share-store.js";
 import { getSiteShareStore } from "../../share/site-share-store.js";
 import { resolveShareUrl, resolveSiteShareUrl } from "../../share/share-url.js";
 import { publishHostedStaticSite } from "../../share/hosted-static-site-publish.js";
+import { resolveReverseProxyPublicUrl } from "../../gateway/public-url.js";
 import { audienceDefaults, decideShareKind, makeDescription, makeTitle, probeShareTarget, rememberStagedSite, stageSingleHtmlAsSite } from "../../share/share-auto.js";
 import { scheduleThumbnail } from "../../share/share-thumbnail.js";
 import { resolveToolLocale, shareToolErrorLine, shareToolSuccessLines } from "../../i18n/share-tool-bundle.js";

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

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { renderDataBatch } from "../data-acquisition/render.js";
 import { DataBatchSchema } from "../data-acquisition/schema.js";
 import { acquireData } from "../data-acquisition/service.js";
+import { renderDataBatch } from "../data-acquisition/render.js";
 import { AsyncLocalStorage } from "node:async_hooks";
 //#region src/agent/tools/dataBatch.ts
 init_logger();

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

@@ -1,12 +1,12 @@
-import { runGit } from "../../execution-environments/git.js";
-import { LocalWorktreeManager } from "../../execution-environments/local-worktree-manager.js";
-import { SessionEnvironmentService } from "../../execution-environments/session-environment-service.js";
 import { readWorkspaceRevision } from "../coding/workspace-revision.js";
 import { EXTERNAL_TOOL_NAMES } from "../external-tools/gateway-tools.js";
 import "../external-tools/index.js";
 import { getDelegationScope } from "../orchestration/delegation-scope.js";
 import { DELEGATION_BUDGETS } from "../orchestration/delegation-budget.js";
 import { createDelegateChildHandle } from "../child-agent-factory.js";
+import { runGit } from "../../execution-environments/git.js";
+import { LocalWorktreeManager } from "../../execution-environments/local-worktree-manager.js";
+import { SessionEnvironmentService } from "../../execution-environments/session-environment-service.js";
 import { DELEGATION_CAPABILITIES, DELEGATION_TOOL_CAPABILITIES, protectDelegatedTool, resolveDelegationTools } from "./delegation-policy.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/delegate-tool.ts

package/dist/src/agent/tools/error-pattern-matcher.js

@@ -45,7 +45,7 @@ const DEFAULT_CONFIG = {
 		{
 			name: "timeout",
 			description: "Command execution timed out",
-			regex: /timeout|timed out|execution time exceeded/i,
+			regex: /\btimeout(?:error|exception)?\b|timed out|execution time exceeded|\betimedout\b/i,
 			suggestion: "Command took too long. Consider optimizing the command, breaking into smaller tasks, or increasing timeout.",
 			autoRetry: true,
 			maxRetries: 1,

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

@@ -7,7 +7,7 @@ import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/exec-command.ts
 const DEFAULT_MAX_OUTPUT_CHARS = 5e4;
 const ExecCommandSchema = Type.Object({
-	cmd: Type.String({ description: "Shell command to execute." }),
+	cmd: Type.String({ description: "Command for the default platform shell: /bin/sh on Unix and in Docker; cmd.exe on Windows hosts. Use portable syntax, or invoke an installed shell explicitly for shell-specific features." }),
 	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." })),
@@ -28,6 +28,7 @@ function commandFailureHint(details) {
 	if (details.status === "success" || details.status === "running") return void 0;
 	if (details.status === "cancelled") return "The command was cancelled. Inspect its partial output before deciding whether to restart.";
 	if (details.status === "timed_out") return "The command timed out. Re-run a narrower command, increase timeoutMs if the long run is expected, or inspect partial output before retrying.";
+	if (details.exitCode !== 0 && /(?:\/bin\/sh|\bsh:).*syntax error|bad substitution/i.test(details.stderr)) return "The default shell rejected the syntax. Use portable POSIX sh commands or invoke an installed bash explicitly for Bash-only features such as process substitution. Inspect stderr, fix the command, then rerun it.";
 	if (details.exitCode !== 0 && details.stderr.trim()) return "The command failed. Inspect stderr first, fix the underlying issue, then re-run the narrowest relevant verification command.";
 	if (details.exitCode !== 0 && details.stdout.trim()) return "The command failed. Inspect stdout for the failure location, then re-run the narrowest relevant verification command.";
 	return "The command failed without output. Verify the command, cwd, and required dependencies before retrying.";
@@ -54,6 +55,7 @@ function createExecCommandTool(workspaceCwd, options) {
 		name: "exec_command",
 		description: [
 			"Run shell commands for code inspection, builds, tests, type checks, and verification.",
+			"Unix and Docker use /bin/sh, not your interactive shell. Do not use Bash process substitution <(...) or other Bash-only syntax unless invoking an installed bash explicitly. Prefer separate portable commands or a script file. Windows hosts use cmd.exe.",
 			"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, declare all final paths in outputs so they are persisted with this command."

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

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { withRetry } from "../../infra/retry.js";
 import { commandTimeout } from "../commands/command-registry.js";
 import { DEFAULT_TOOL_EXECUTION_TIMEOUT_MS, TimeoutError, executeWithTimeout } from "../lifecycle/timeout-wrapper.js";
+import { withRetry } from "../../infra/retry.js";
 import { ToolConcurrencyController, resolveToolLockMode } from "./concurrency.js";
 //#region src/agent/tools/executor.ts
 init_logger();

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

@@ -112,6 +112,12 @@ export interface CreateCoreToolsOptions {
 }
 export declare class AgentToolsFactory {
     private deps;
+    getAgentToolAvailability(candidateId: string, name: string): {
+        condition: string;
+        state: "blocked" | "verified";
+        reasonCode: string;
+        detail: string;
+    };
     private browserRuntime;
     /** Cached readiness probe keyed by the active driver configuration. */
     private browserReadinessCache;

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

@@ -9,32 +9,22 @@ import { patchSessionMetadata } from "../../storage/sqlite/session-repository.js
 import { getSessionTaskPlan, setSessionTaskPlan } from "../../storage/sqlite/session-task-plan-repository.js";
 import { init_sqlite } from "../../storage/sqlite/index.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
-import { createWorkflowCatalog } from "../workflow/catalog.js";
-import { BrowserRuntime } from "../../browser/runtime/browser-runtime.js";
+import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
+import { resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
+import { LOCAL_READ_MAX_CHARS } from "./local-read-budget.js";
+import { createPersonalAttentionTool } from "./personal-attention-tool.js";
+import { markCodemodeCoreRead } from "./codemode-permissions.js";
+import { PERSONAL_TOOL_DESCRIPTIONS } from "../../personal-agent/policy.js";
+import { PERSONAL_REQUEST_TOOL_IDS, filterExecutionTools, resolveExecutionToolPolicy } from "../embedded/execution-tool-policy.js";
 import "../../../packages/browser-control-contract/src/index.js";
-import { createBrowserDriver } from "../../browser/drivers/create-driver.js";
-import { checkBrowserReadiness } from "../../browser/readiness.js";
-import "../../browser/index.js";
 import { getEmbeddedExecutionRunId, getEmbeddedExecutionSession } from "../embedded/execution-context.js";
-import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
-import { resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
-import { ComputerRuntime } from "../../computer/runtime.js";
-import { buildRuntimeEnvironment } from "../../runtime-tools/environment.js";
-import { skillEnvironmentId } from "../skills/installer.js";
 import { wrapToolsWithProtection } from "./executor.js";
 import { EXTERNAL_TOOL_NAMES } from "../external-tools/gateway-tools.js";
 import { createDefaultExternalToolGatewayTools } from "../external-tools/index.js";
-import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
-import { getPendingTranscriptUserText } from "../inbound/attachment-pipeline.js";
-import { createDataBatchTool } from "./dataBatch.js";
-import { markCodemodeCoreRead } from "./codemode-permissions.js";
-import { PERSONAL_TOOL_DESCRIPTIONS } from "../../personal-agent/policy.js";
-import { PERSONAL_REQUEST_TOOL_IDS, filterExecutionTools, resolveExecutionToolPolicy } from "../embedded/execution-tool-policy.js";
-import { createDelegateTool } from "./delegate-tool.js";
-import { createDelegationParentPolicy } from "./delegation-parent-policy.js";
-import { createPersonalAttentionTool } from "./personal-attention-tool.js";
-import { LOCAL_READ_MAX_CHARS } from "./local-read-budget.js";
 import { createReadFileTool } from "./read.js";
+import { createDataBatchTool } from "./dataBatch.js";
+import { buildRuntimeEnvironment } from "../../runtime-tools/environment.js";
+import { skillEnvironmentId } from "../skills/installer.js";
 import { createWriteFileTool } from "./write.js";
 import { createListDirTool } from "./list-dir.js";
 import { createPublishArtifactsTool } from "./publish-artifacts.js";
@@ -57,7 +47,14 @@ import { createUpdatePlanTool } from "./update-plan-tool.js";
 import { createSessionStatusTool } from "./session-status-tool.js";
 import { createMemoryMaintenanceTool } from "./memory-maintenance-tool.js";
 import { createClarifyTool } from "./clarify-tool.js";
+import { BrowserRuntime } from "../../browser/runtime/browser-runtime.js";
+import { createBrowserDriver } from "../../browser/drivers/create-driver.js";
+import { checkBrowserReadiness } from "../../browser/readiness.js";
+import "../../browser/index.js";
+import { getPendingTranscriptUserText } from "../inbound/attachment-pipeline.js";
+import { createDelegateTool } from "./delegate-tool.js";
 import { createWorkflowTool } from "./workflow-tool.js";
+import { createWorkflowCatalog } from "../workflow/catalog.js";
 import { createWorkflowManageTool } from "./workflow-manage-tool.js";
 import { createAutomationTool } from "./automation-tool.js";
 import { createBrowserAutomationTool } from "./browser-automation-tool.js";
@@ -72,15 +69,19 @@ import { createManagedJobTool } from "./managed-job-tool.js";
 import { createImageTool } from "./image-tool.js";
 import { createImageGenerateTool } from "./image-generate-tool.js";
 import { createPersonalReadTool } from "./personal-read-tool.js";
+import { createTaskCollaborationTool } from "./task-collaboration-tool.js";
 import "./index.js";
 import { createPersonalTaskTool } from "./personal-task-tool.js";
 import { createPersonalRequestTools } from "./personal-request-tool.js";
 import { createPersonalRequestConnectionTool, createPersonalRequestResultTool } from "./personal-request-result-tool.js";
 import { createPersonalPreferenceTool } from "./personal-preference-tool.js";
 import { createBrowserUseTool } from "./browser/tool/browser-use-tool.js";
+import { ComputerRuntime } from "../../computer/runtime.js";
 import { createComputerUseTool } from "./computer-use-tool.js";
 import { createReviewWorkspaceTool } from "./review-workspace.js";
 import { createLanguageDiagnosticsTool } from "./language-diagnostics.js";
+import { createDelegationParentPolicy } from "./delegation-parent-policy.js";
+import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 import { createTextToSpeechTool } from "./tts-tool.js";
 import { getAgentCapabilityToolNames } from "../capabilities/registry.js";
 import "../capabilities/index.js";
@@ -100,6 +101,24 @@ const CLARIFY_SUPPORTED_CHANNELS = new Set([
 	"cli"
 ]);
 var AgentToolsFactory = class AgentToolsFactory {
+	getAgentToolAvailability(candidateId, name) {
+		const candidate = resolveEffectiveAgentConfigForAgent(candidateId).config;
+		const denied = new Set(Object.entries(candidate.tools).filter(([, policy]) => policy.mode === "deny").map(([tool]) => tool));
+		const registered = this.createAllTools({
+			agentId: candidateId,
+			workspace: candidate.workspace,
+			conversationId: "",
+			disabledTools: denied,
+			toolAllowlist: candidate.toolAllowlist
+		}).some((tool) => tool.name === name);
+		const activatable = this.getLazyCapabilityToolNames().includes(name);
+		return {
+			condition: `tool:${name}`,
+			state: registered || activatable ? "verified" : "blocked",
+			reasonCode: registered ? "tool_registered" : activatable ? "tool_activatable" : "tool_not_registered",
+			detail: candidate.tools[name]?.mode === "ask" ? "Runtime approval is still required" : "Registration checked; execution environment is checked by the tool"
+		};
+	}
 	browserRuntime = null;
 	/** Cached readiness probe keyed by the active driver configuration. */
 	browserReadinessCache = null;
@@ -254,6 +273,7 @@ var AgentToolsFactory = class AgentToolsFactory {
 			allowed = new Set(PERSONAL_REQUEST_TOOL_IDS.slice(0, 3).filter((name) => !allowed || allowed.has(name)));
 			allowed.add("personal_request_result");
 			allowed.add("personal_request_connection");
+			allowed.add("task_collaboration");
 		}
 		const deliveryContext = () => {
 			if (currentConversationId() && getSessionMetadata(currentConversationId())?.sessionType === "heartbeat") throw new Error("Heartbeat notifications must be returned in the final response for policy-controlled delivery.");
@@ -296,24 +316,7 @@ var AgentToolsFactory = class AgentToolsFactory {
 		const grep = createGrepTool(workspace);
 		const find = createFindTool(workspace);
 		const productToolDeps = {
-			getAgentToolAvailability: this.deps.getAgentToolAvailability ?? ((candidateId, name) => {
-				const candidate = resolveEffectiveAgentConfigForAgent(candidateId).config;
-				const denied = new Set(Object.entries(candidate.tools).filter(([, policy]) => policy.mode === "deny").map(([tool]) => tool));
-				const registered = this.createAllTools({
-					agentId: candidateId,
-					workspace: candidate.workspace,
-					conversationId: "",
-					disabledTools: denied,
-					toolAllowlist: candidate.toolAllowlist
-				}).some((tool) => tool.name === name);
-				const activatable = this.getLazyCapabilityToolNames().includes(name);
-				return {
-					condition: `tool:${name}`,
-					state: registered || activatable ? "verified" : "blocked",
-					reasonCode: registered ? "tool_registered" : activatable ? "tool_activatable" : "tool_not_registered",
-					detail: candidate.tools[name]?.mode === "ask" ? "Runtime approval is still required" : "Registration checked; execution environment is checked by the tool"
-				};
-			}),
+			getAgentToolAvailability: this.deps.getAgentToolAvailability ?? ((candidateId, name) => this.getAgentToolAvailability(candidateId, name)),
 			getAgentSkillAvailability: this.deps.getAgentSkillAvailability,
 			getWorkspace: () => this.deps.workspace,
 			getConfig: () => this.deps.getConfig?.(),
@@ -611,7 +614,14 @@ var AgentToolsFactory = class AgentToolsFactory {
 				}
 			})] : [],
 			...optionalTools,
-			...personalExecution ? [createPersonalRequestResultTool(currentConversationId), createPersonalRequestConnectionTool(currentConversationId)] : []
+			...personalExecution ? [
+				createPersonalRequestResultTool(currentConversationId),
+				createPersonalRequestConnectionTool(currentConversationId),
+				createTaskCollaborationTool({
+					...productToolDeps,
+					getCurrentConversationId: currentConversationId
+				})
+			] : []
 		];
 		if ([
 			"read_file",
@@ -634,7 +644,7 @@ var AgentToolsFactory = class AgentToolsFactory {
 				allowHostGit: () => getCommandIsolation()?.mode !== "docker"
 			}));
 		}
-		const selected = filterToolsByDisabledSet(core.map(markCodemodeCoreRead), disabled).filter((tool) => (!allowed || allowed.has(tool.name)) && !(personalToolsConfigured && tool.name === "clarify")).map((tool) => personalToolsConfigured && PERSONAL_TOOL_DESCRIPTIONS[tool.name] ? {
+		const selected = filterToolsByDisabledSet(core.map(markCodemodeCoreRead), disabled).filter((tool) => (!allowed || allowed.has(tool.name)) && !(personalToolsConfigured && tool.name === "clarify")).map((tool) => personalToolsConfigured && !tool.name.startsWith("personal_") && PERSONAL_TOOL_DESCRIPTIONS[tool.name] ? {
 			...tool,
 			description: PERSONAL_TOOL_DESCRIPTIONS[tool.name]
 		} : tool);

package/dist/src/agent/tools/fetch-text.js

@@ -1,6 +1,6 @@
 import { checkUrlSafety, checkWebsiteBlocklist } from "./url-safety.js";
-import { lookup } from "node:dns";
 import { Agent, fetch } from "undici";
+import { lookup } from "node:dns";
 //#region src/agent/tools/fetch-text.ts
 /** Validate each redirect and the address actually used for the connection. */
 async function fetchPublicText(input, blocklist, signal) {

package/dist/src/agent/tools/image-generate-tool.js

@@ -1,12 +1,12 @@
 import { getAgentDefaultImageGenerationModelConfig, init_schema } from "../../config/schema.js";
+import { readWorkspaceFile, writeWorkspaceFile } from "../sandbox/fileAccess.js";
 import { imageAssetFromDataUrl, imageFileExtensionForMimeType, mimeTypeFromFileName, parseImageDataUrl, sniffImageMimeType } from "../image/generation/image-assets.js";
-import { getImageGenerationProvider } from "../image/generation/provider-registry.js";
+import { persistToolMedia } from "./tool-media.js";
 import { buildCapabilityPlansForConfig } from "../../capabilities/readiness/from-config.js";
 import "../../capabilities/readiness/index.js";
 import { applyImageGenerationModelConfigDefaults } from "../image/image-helpers.js";
-import { readWorkspaceFile, writeWorkspaceFile } from "../sandbox/fileAccess.js";
-import { persistToolMedia } from "./tool-media.js";
 import { isFailoverError } from "../failover-error.js";
+import { getImageGenerationProvider } from "../image/generation/provider-registry.js";
 import { generateImage, listImageGenerationProvidersSummary } from "../image/generation/runtime.js";
 import path from "node:path";
 import { randomBytes } from "node:crypto";

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

@@ -43,3 +43,4 @@ export { createImageGenerateTool, resolveImageGenerationModelConfigForTool } fro
 export { truncateHead, truncateTail, truncateLine, formatSize, type TruncationResult, type TruncationOptions, DEFAULT_MAX_LINES, DEFAULT_MAX_BYTES, GREP_MAX_LINE_LENGTH, } from './truncate.js';
 export { normalizeToLF, restoreLineEndings, normalizeForFuzzyMatch, fuzzyFindText, stripBom, generateDiffString, type FuzzyMatchResult, } from './edit-diff.js';
 export { createPersonalReadTool } from './personal-read-tool.js';
+export { createTaskCollaborationTool } from './task-collaboration-tool.js';