@xopcai/xopc 0.0.354 → 0.0.356

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

@@ -1,8 +1,8 @@
 import { resolveStateDir } from "../../config/paths-state.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_paths } from "../../config/paths.js";
 import { parseFrontmatter } from "../../markdown/frontmatter.js";
+import { init_paths } from "../../config/paths.js";
 import { findInstallSpec, hasBinary, installSkill } from "./installer.js";
 import { applySkillEnvOverrides, createSkillConfigManager, getSkillEnvironment, isSkillEnabled, resolveSkillConfig, validateSkillConfig } from "./config.js";
 import { parseSkillToolConditions } from "./skill-tool-gating.js";

package/dist/src/agent/skills/managed-store.js

@@ -1,5 +1,5 @@
-import { init_paths, resolveSkillsDir } from "../../config/paths.js";
 import { parseFrontmatter } from "../../markdown/frontmatter.js";
+import { init_paths, resolveSkillsDir } from "../../config/paths.js";
 import { loadSkillsLock } from "./hub-lock.js";
 import { dirname, join, resolve, sep } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync } from "node:fs";

package/dist/src/agent/skills/skill-manage-ops.js

@@ -1,5 +1,5 @@
-import { init_paths, resolveSkillsDir } from "../../config/paths.js";
 import { parseFrontmatter } from "../../markdown/frontmatter.js";
+import { init_paths, resolveSkillsDir } from "../../config/paths.js";
 import { resolveWorkspaceSkillsDir } from "./workspace-skills-dir.js";
 import { formatScanSummary, scanSkillDirectory } from "./scanner.js";
 import { fuzzyFindText, normalizeForFuzzyMatch, normalizeToLF, restoreLineEndings } from "../tools/edit-diff.js";

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

@@ -1,8 +1,8 @@
-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 { buildMcpResourceAgentContext } from "./mcp-resource-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, buildMcpResourceAgentContext, buildSessionAgentContext, buildUserAssertionAgentContext, injectSourceContextsIntoUserMessage, isSessionSourceBinding, isTurnContextRef, parseTurnContextRefs, summarizeSourceContext };

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

@@ -2,14 +2,14 @@ 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 { 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 { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
-import { readWorkspaceRevision } from "../coding/workspace-revision.js";
 import { completeWithResolvedCredentials } from "../../providers/model-call.js";
-import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../../providers/model-response.js";
+import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
+import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
 import { TaskApplicationService } from "../../tasks/task-application-service.js";
+import { readWorkspaceRevision } from "../coding/workspace-revision.js";
 //#region src/agent/tasks/task-judge-service.ts
 init_schema();
 init_providers();

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 { assertWorkspaceTreeReadable, checkedFilePath } from "../sandbox/fileAccess.js";
-import { resolvePathUnderWorkspace } from "./tool-paths.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 { 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,11 +1,11 @@
+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 { 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/delegation-parent-policy.js

@@ -1,6 +1,6 @@
 import { resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
-import { parseExternalToolRef } from "../external-tools/refs.js";
 import { mcpToolPolicyId } from "../mcp/bundle-mcp-policy.js";
+import { parseExternalToolRef } from "../external-tools/refs.js";
 import { createAgentTurnPolicy } from "../orchestration/agent-turn-policy.js";
 //#region src/agent/tools/delegation-parent-policy.ts
 /** Noninteractive callers cannot silently turn an ask policy into an allow. */

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.js

@@ -7,16 +7,27 @@ import { getSessionMetadata } from "../../storage/sqlite/session-read-repository
 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 { resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
+import { BrowserRuntime } from "../../browser/runtime/browser-runtime.js";
 import "../../../packages/browser-control-contract/src/index.js";
-import { getEmbeddedExecutionRunId, getEmbeddedExecutionSession } from "../embedded/execution-context.js";
+import { createBrowserDriver } from "../../browser/drivers/create-driver.js";
+import { checkBrowserReadiness } from "../../browser/readiness.js";
+import "../../browser/index.js";
+import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
+import { resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
+import { createWorkflowCatalog } from "../workflow/catalog.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 { buildRuntimeEnvironment } from "../../runtime-tools/environment.js";
 import { createDefaultExternalToolGatewayTools } from "../external-tools/index.js";
-import { createReadFileTool } from "./read.js";
+import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
+import { getPendingTranscriptUserText } from "../inbound/attachment-pipeline.js";
 import { createDataBatchTool } from "./dataBatch.js";
-import { skillEnvironmentId } from "../skills/installer.js";
+import { getEmbeddedExecutionRunId, getEmbeddedExecutionSession } from "../embedded/execution-context.js";
+import { createDelegateTool } from "./delegate-tool.js";
+import { createDelegationParentPolicy } from "./delegation-parent-policy.js";
+import { createReadFileTool } from "./read.js";
 import { createWriteFileTool } from "./write.js";
 import { createListDirTool } from "./list-dir.js";
 import { createPublishArtifactsTool } from "./publish-artifacts.js";
@@ -39,14 +50,7 @@ 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";
@@ -63,14 +67,10 @@ import { createImageGenerateTool } from "./image-generate-tool.js";
 import "./index.js";
 import { createPersonalTaskTool } from "./personal-task-tool.js";
 import { createPersonalPreferenceTool } from "./personal-preference-tool.js";
-import { resolveUserContextSessionAccess } from "../../user-context/access-policy.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";

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

@@ -1,6 +1,6 @@
 import { checkUrlSafety, checkWebsiteBlocklist } from "./url-safety.js";
-import { Agent, fetch } from "undici";
 import { lookup } from "node:dns";
+import { Agent, fetch } from "undici";
 //#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 { persistToolMedia } from "./tool-media.js";
+import { getImageGenerationProvider } from "../image/generation/provider-registry.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.js

@@ -1,8 +1,13 @@
+import { assertBrowserUrlAllowed } from "../../browser/url-policy.js";
+import { BrowserRuntime } from "../../browser/runtime/browser-runtime.js";
+import "../../browser/index.js";
 import { DEFAULT_TOOL_METADATA, getToolMetadata } from "./metadata.js";
 import { ToolConcurrencyController, resolveToolLockMode } from "./concurrency.js";
+import { resolveImageModelConfigForTool } from "../image/tool-model-config.js";
+import { createDataBatchTool } from "./dataBatch.js";
+import { DEFAULT_DELEGATE_TOOLS, DELEGATE_BLOCKED_TOOLS, createDelegateTool } from "./delegate-tool.js";
 import { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, GREP_MAX_LINE_LENGTH, formatSize, truncateHead, truncateLine, truncateTail } from "./truncate.js";
 import { createReadFileTool } from "./read.js";
-import { createDataBatchTool } from "./dataBatch.js";
 import { createWriteFileTool, writeFileTool } from "./write.js";
 import { createListDirTool, listDirTool } from "./list-dir.js";
 import { createPublishArtifactsTool } from "./publish-artifacts.js";
@@ -26,11 +31,6 @@ 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 { assertBrowserUrlAllowed } from "../../browser/url-policy.js";
-import { BrowserRuntime } from "../../browser/runtime/browser-runtime.js";
-import "../../browser/index.js";
-import { resolveImageModelConfigForTool } from "../image/tool-model-config.js";
-import { DEFAULT_DELEGATE_TOOLS, DELEGATE_BLOCKED_TOOLS, createDelegateTool } from "./delegate-tool.js";
 import { createWorkflowTool } from "./workflow-tool.js";
 import { createWorkflowManageTool } from "./workflow-manage-tool.js";
 import { createAutomationTool } from "./automation-tool.js";

package/dist/src/agent/tools/list-dir.js

@@ -1,5 +1,5 @@
-import { checkedFilePath } from "../sandbox/fileAccess.js";
 import { resolvePathUnderWorkspace } from "./tool-paths.js";
+import { checkedFilePath } from "../sandbox/fileAccess.js";
 import { readdir } from "fs/promises";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/list-dir.ts

package/dist/src/agent/tools/personal-preference-tool.d.ts

@@ -1,6 +1,6 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
 declare const PreferenceSchema: import("@sinclair/typebox").TObject<{
-    field: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"addressAs">, import("@sinclair/typebox").TLiteral<"warmth">, import("@sinclair/typebox").TLiteral<"humor">, import("@sinclair/typebox").TLiteral<"supportMode">, import("@sinclair/typebox").TLiteral<"detailLevel">, import("@sinclair/typebox").TLiteral<"proactivity">]>;
+    field: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"addressAs">, import("@sinclair/typebox").TLiteral<"warmth">, import("@sinclair/typebox").TLiteral<"humor">, import("@sinclair/typebox").TLiteral<"supportMode">, import("@sinclair/typebox").TLiteral<"detailLevel">, import("@sinclair/typebox").TLiteral<"proactivity">, import("@sinclair/typebox").TLiteral<"guidance">]>;
     value: import("@sinclair/typebox").TString;
 }>;
 export declare function createPersonalPreferenceTool(deps: {

package/dist/src/agent/tools/personal-preference-tool.js

@@ -9,9 +9,10 @@ const PreferenceSchema = Type.Object({
 		Type.Literal("humor"),
 		Type.Literal("supportMode"),
 		Type.Literal("detailLevel"),
-		Type.Literal("proactivity")
+		Type.Literal("proactivity"),
+		Type.Literal("guidance")
 	]),
-	value: Type.String({ description: "Use the exact enum for the field: warmth=reserved|balanced|gentle; humor=none|occasional|playful; supportMode=listen|untangle|solutions; detailLevel=brief|balanced|detailed; proactivity=decisions|important|open. addressAs is free text. Save only explicitly requested lasting preferences." })
+	value: Type.String({ description: "Use the exact enum for warmth, humor, supportMode, detailLevel, or proactivity. addressAs is a name. guidance is free text for the user’s precise, explicitly requested lasting response preference; preserve their meaning. Do not store temporary mood or guesswork." })
 });
 function createPersonalPreferenceTool(deps) {
 	return {

package/dist/src/agent/tools/personal-task-tool.d.ts

@@ -1,13 +1,14 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
 import { type XopcUseToolDeps } from './xopc-use-tool.js';
 declare const PersonalTaskSchema: import("@sinclair/typebox").TObject<{
-    command: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"agents">, import("@sinclair/typebox").TLiteral<"create">, import("@sinclair/typebox").TLiteral<"list">, import("@sinclair/typebox").TLiteral<"get">, import("@sinclair/typebox").TLiteral<"instruct">]>;
+    command: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"agents">, import("@sinclair/typebox").TLiteral<"create">, import("@sinclair/typebox").TLiteral<"list">, import("@sinclair/typebox").TLiteral<"get">, import("@sinclair/typebox").TLiteral<"instruct">, import("@sinclair/typebox").TLiteral<"answer">]>;
     title: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     objective: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     agentId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     taskId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     instruction: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    questionId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     expectedOutputs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
     acceptanceCriteria: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
     constraints: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;

package/dist/src/agent/tools/personal-task-tool.js

@@ -1,22 +1,25 @@
 import { resolveEffectiveAgentConfig } from "../../agent-config/resolver.js";
 import { init_agent_config } from "../../agent-config/index.js";
 import { AgentCatalogRepository, init_repository } from "../../agent-catalog/repository.js";
+import { init_providers, isProviderConfiguredSync, resolveModel } from "../../providers/index.js";
 import { resolveEffectiveAgentConfigForAgent } from "../../config/agent-profile.js";
+import { isPersonalConversation } from "../../personal-agent/repository.js";
 import { TaskOriginRepository } from "../../tasks/task-origin-repository.js";
 import { createXopcUseTool } from "./xopc-use-tool.js";
-import { isPersonalConversation } from "../../personal-agent/repository.js";
 import { randomUUID } from "node:crypto";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/personal-task-tool.ts
 init_repository();
 init_agent_config();
+init_providers();
 const PersonalTaskSchema = Type.Object({
 	command: Type.Union([
 		Type.Literal("agents"),
 		Type.Literal("create"),
 		Type.Literal("list"),
 		Type.Literal("get"),
-		Type.Literal("instruct")
+		Type.Literal("instruct"),
+		Type.Literal("answer")
 	]),
 	title: Type.Optional(Type.String({ description: "Short task title, ideally under 60 characters. Do not put the full instructions here." })),
 	objective: Type.Optional(Type.String({ description: "One-sentence outcome for a new delegated Task." })),
@@ -24,6 +27,7 @@ const PersonalTaskSchema = Type.Object({
 	agentId: Type.Optional(Type.String({ description: "Specialist Agent ID. Never use your own ID." })),
 	taskId: Type.Optional(Type.String()),
 	instruction: Type.Optional(Type.String({ description: "The user’s new direction for this delegated Task." })),
+	questionId: Type.Optional(Type.String({ description: "Collaboration question ID to answer." })),
 	expectedOutputs: Type.Optional(Type.Array(Type.String())),
 	acceptanceCriteria: Type.Optional(Type.Array(Type.String())),
 	constraints: Type.Optional(Type.Array(Type.String())),
@@ -52,6 +56,15 @@ const DISCOVERY_TOOLS = [
 function availableAgentTools(config, deps) {
 	return (config.toolAllowlist ? [...new Set([...DISCOVERY_TOOLS, ...config.toolAllowlist])] : DISCOVERY_TOOLS).filter((name) => (name !== "browser_use" || deps.getConfig?.()?.browser?.enabled !== false) && (!config.toolAllowlist || config.toolAllowlist.includes(name)) && config.tools[name]?.mode !== "deny");
 }
+function agentModelAvailability(config) {
+	for (const ref of [config.models.chat.primary, ...config.models.chat.fallbacks]) try {
+		if (isProviderConfiguredSync(resolveModel(ref).provider)) return { available: true };
+	} catch {}
+	return {
+		available: false,
+		reason: "No configured chat model resolves to an available provider"
+	};
+}
 function buildPersonalTaskBrief(input) {
 	const fullObjective = input.objective.trim();
 	const titleSource = (input.title?.trim() || fullObjective).replace(/\s+/g, " ");
@@ -72,7 +85,7 @@ function createPersonalTaskTool(deps) {
 	return {
 		name: "personal_task",
 		label: "Personal Task",
-		description: "Find specialist Agents by role and availableTools, delegate work they can do, inspect Tasks, or send instructions. Before saying you cannot do a request, use agents to look for another Agent. If a candidate fails, try another suitable Agent or approach before reporting a blocker. agents can filter by requiredTools; if none match, inspect unfiltered Agents for another viable approach. Return to the user quickly after creation.",
+		description: "Find specialist Agents by role, availableTools, and model.available; delegate work, inspect Tasks, send instructions, or answer worker questions. Choose an Agent whose model.available is true. Before saying you cannot do a request, inspect another Agent. If a candidate fails, try another suitable Agent or approach within the user’s authorization. agents can filter by requiredTools; if none match, inspect unfiltered Agents. Return to the user quickly after creation.",
 		parameters: PersonalTaskSchema,
 		mutatesWorkspace: true,
 		mutationScope: "external",
@@ -95,7 +108,8 @@ function createPersonalTaskTool(deps) {
 						id: agent.id,
 						name: agent.profile?.name ?? agent.id,
 						description: agent.profile?.description ?? "",
-						availableTools
+						availableTools,
+						model: agentModelAvailability(config)
 					};
 				}).filter((agent) => requiredTools.every((tool) => agent.availableTools.includes(tool)));
 				return {
@@ -115,7 +129,10 @@ function createPersonalTaskTool(deps) {
 				if (agentId === ownAgentId || agentId.startsWith("personal-")) throw new Error("Delegate to a specialist Agent, not a personal Agent");
 				const specialist = new AgentCatalogRepository().get(agentId);
 				if (!specialist || specialist.enabled === false || specialist.provisioningState !== "ready") throw new Error(`Specialist Agent is unavailable: ${agentId}`);
-				const availableTools = availableAgentTools(resolveEffectiveAgentConfigForAgent(agentId).config, deps);
+				const config = resolveEffectiveAgentConfigForAgent(agentId).config;
+				const model = agentModelAvailability(config);
+				if (!model.available) throw new Error(`Agent ${agentId} cannot start: ${model.reason}. Find another available Agent.`);
+				const availableTools = availableAgentTools(config, deps);
 				const missingTools = (input.requiredTools ?? []).filter((tool) => !availableTools.includes(tool));
 				if (missingTools.length > 0) throw new Error(`Agent ${agentId} lacks required tools: ${missingTools.join(", ")}. Find another Agent or approach.`);
 				args = {
@@ -139,14 +156,16 @@ function createPersonalTaskTool(deps) {
 				const taskId = input.taskId?.trim();
 				if (!taskId) throw new Error("taskId is required");
 				if (!new TaskOriginRepository().owns(taskId, conversationId)) throw new Error("Task does not belong to this personal conversation");
-				if (command === "instruct") {
+				if (command === "instruct" || command === "answer") {
 					const body = input.instruction?.trim();
 					if (!body) throw new Error("instruction is required");
+					if (command === "answer" && !input.questionId?.trim()) throw new Error("questionId is required");
 					command = "collaboration_post";
 					args = {
 						taskId,
-						kind: "instruction",
-						body
+						kind: input.command === "answer" ? "answer" : "instruction",
+						body,
+						...input.command === "answer" ? { causationId: input.questionId.trim() } : {}
 					};
 				} else args = { taskId };
 			}

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

@@ -1,9 +1,9 @@
 import { turnOutcomeKindFromFileName, turnOutcomeMimeTypeFromFileName } from "../../../packages/gateway-contract/src/turn-outcome.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
+import { fileResourceId, fileSpaceId } from "../../files/file-service.js";
+import { resolvePathUnderWorkspace } from "./tool-paths.js";
 import { evaluateFilePolicy } from "../sandbox/exec-policy.js";
 import { readWorkspaceFile } from "../sandbox/fileAccess.js";
-import { resolvePathUnderWorkspace } from "./tool-paths.js";
-import { fileResourceId, fileSpaceId } from "../../files/file-service.js";
 import { persistToolMedia } from "./tool-media.js";
 import { basename, isAbsolute, relative, sep } from "node:path";
 import { realpath } from "node:fs/promises";

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

@@ -1,8 +1,8 @@
+import { isBareProfileMarkdownFileName, resolvePathUnderWorkspace, resolveProfileMarkdownPathIfBareName } from "./tool-paths.js";
 import { checkedFilePath, readWorkspaceFileAsync } from "../sandbox/fileAccess.js";
-import { dataScheduler } from "../data-acquisition/scheduler.js";
 import { checkFileSafety } from "../prompt/safety.js";
+import { dataScheduler } from "../data-acquisition/scheduler.js";
 import { DEFAULT_MAX_BYTES, formatSize, truncateHead } from "./truncate.js";
-import { isBareProfileMarkdownFileName, resolvePathUnderWorkspace, resolveProfileMarkdownPathIfBareName } from "./tool-paths.js";
 import { stat } from "fs/promises";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/read.ts

package/dist/src/agent/tools/review-workspace.js

@@ -1,5 +1,5 @@
-import { readWorkspaceRevision } from "../coding/workspace-revision.js";
 import { prepareSafeToolEnv } from "../sandbox/sanitize-env-vars.js";
+import { readWorkspaceRevision } from "../coding/workspace-revision.js";
 import { evaluateFilePolicy } from "../sandbox/exec-policy.js";
 import { checkedFilePath, readWorkspaceFile } from "../sandbox/fileAccess.js";
 import { resolve } from "node:path";

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

@@ -1,9 +1,9 @@
 import { turnOutcomeKindFromFileName } from "../../../packages/gateway-contract/src/turn-outcome.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
-import { readWorkspaceFile } from "../sandbox/fileAccess.js";
-import { checkFileSafety } from "../prompt/safety.js";
 import { resolvePathUnderWorkspace } from "./tool-paths.js";
 import { MEDIA_MAX_BYTES } from "../../media/store.js";
+import { readWorkspaceFile } from "../sandbox/fileAccess.js";
+import { checkFileSafety } from "../prompt/safety.js";
 import { persistToolMedia } from "./tool-media.js";
 import { basename } from "node:path";
 import { Type } from "@sinclair/typebox";

package/dist/src/agent/tools/skills-tools.js

@@ -1,7 +1,7 @@
 import { resolveStateDir } from "../../config/paths-state.js";
 import { init_paths } from "../../config/paths.js";
-import { DEFAULT_MAX_BYTES, formatSize, truncateHead } from "./truncate.js";
 import { createSkillConfigManager, isSkillEnabled, resolveSkillConfig } from "../skills/config.js";
+import { DEFAULT_MAX_BYTES, formatSize, truncateHead } from "./truncate.js";
 import { resolveSkillReadablePath } from "../skills/skill-view-path.js";
 import { readFileSync, statSync } from "fs";
 import { Type } from "@sinclair/typebox";

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

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { speak } from "../../voice/tts/speak-core.js";
 import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 import { getChannelOutputFormat } from "../../voice/tts/service.js";
+import { speak } from "../../voice/tts/speak-core.js";
 import { compressAudio } from "../../voice/tts/audio.js";
 import { persistOutboundTtsAudio } from "../../channels/attachments/outbound-tts-persist.js";
 import { Type } from "@sinclair/typebox";

package/dist/src/agent/tools/user-context-tool.js

@@ -1,7 +1,7 @@
-import { retrievalLexicalSimilarity } from "../../retrieval/textFeatures.js";
 import { deleteUserAssertion, getAssertionSlot, getUserAssertion, listUserAssertionSources, listUserAssertions, reconcileAssertion, setAssertionStatus } from "../../user-model/repository.js";
 import { canUseAssertion } from "../../user-model/usage-policy.js";
 import "../../user-model/index.js";
+import { retrievalLexicalSimilarity } from "../../retrieval/textFeatures.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/user-context-tool.ts
 const SearchSchema = Type.Object({

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

@@ -1,9 +1,9 @@
 import { appendProductDeliveryText } from "../../../packages/gateway-contract/src/product-delivery.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
+import { fileResourceId, fileSpaceId } from "../../files/file-service.js";
+import { isBareProfileMarkdownFileName, resolvePathUnderWorkspace, resolveProfileMarkdownPathIfBareName } from "./tool-paths.js";
 import { writeWorkspaceFile } from "../sandbox/fileAccess.js";
 import { checkFileSafety } from "../prompt/safety.js";
-import { isBareProfileMarkdownFileName, resolvePathUnderWorkspace, resolveProfileMarkdownPathIfBareName } from "./tool-paths.js";
-import { fileResourceId, fileSpaceId } from "../../files/file-service.js";
 import { basename, relative, sep } from "path";
 import { realpath } from "fs/promises";
 import { Type } from "@sinclair/typebox";

package/dist/src/agent/tools/xopc-use-tool.js

@@ -10,22 +10,22 @@ import { TaskRunRepository } from "../../tasks/task-run-repository.js";
 import { getSessionMetadata } from "../../storage/sqlite/session-read-repository.js";
 import { init_sqlite } from "../../storage/sqlite/index.js";
 import "../../activity/index.js";
-import { getDefaultAgentId, init_resolve_route } from "../../routing/resolve-route.js";
-import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
 import { CapabilityError } from "../../capabilities/runtime/errors.js";
 import "../../capabilities/runtime/dispatcher.js";
+import { getDefaultAgentId, init_resolve_route } from "../../routing/resolve-route.js";
+import { TaskCollaborationRepository } from "../../tasks/task-collaboration-repository.js";
+import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
+import { TaskApplicationService } from "../../tasks/task-application-service.js";
 import { resolveProjectAgentId } from "../../projects/project-agent.js";
 import "../../projects/index.js";
+import { TaskOriginRepository } from "../../tasks/task-origin-repository.js";
 import { TaskDeletionService } from "../../tasks/task-deletion-service.js";
 import { TaskDeleteOutputSchema } from "../../tasks/capabilities/management.js";
-import { TaskCollaborationRepository } from "../../tasks/task-collaboration-repository.js";
-import { TaskApplicationService } from "../../tasks/task-application-service.js";
 import { AutomationCreateCapabilityInputSchema, AutomationUpdatePatchSchema } from "../../automations/capabilities/write.js";
 import { TaskMutationOutputSchema } from "../../tasks/capabilities/write.js";
 import { createProductDispatcher } from "../../capabilities/runtime/product.js";
 import { localAppCapabilities } from "../../local-apps/capabilities/runtime.js";
 import { defineTaskContract } from "../../tasks/task-contract-definition.js";
-import { TaskOriginRepository } from "../../tasks/task-origin-repository.js";
 import "../../tasks/index.js";
 import { randomUUID } from "node:crypto";
 import { Type } from "@sinclair/typebox";

package/dist/src/agent/workflow/subagent-runner.js

@@ -1,11 +1,11 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { createSqliteTranscriptRuntime } from "../embedded/transcript-runtime.js";
+import { STRUCTURED_OUTPUT_TOOL_NAME, createStructuredOutputTool } from "./structured-output-tool.js";
 import { createDelegateChildHandle } from "../child-agent-factory.js";
 import { DELEGATION_TOOL_CAPABILITIES, protectDelegatedTool, resolveDelegationTools } from "../tools/delegation-policy.js";
 import { DELEGATE_BLOCKED_TOOLS } from "../tools/delegate-tool.js";
 import { createDelegationParentPolicy } from "../tools/delegation-parent-policy.js";
-import { STRUCTURED_OUTPUT_TOOL_NAME, createStructuredOutputTool } from "./structured-output-tool.js";
 //#region src/agent/workflow/subagent-runner.ts
 init_logger();
 const log = createLogger("Agent:WorkflowSubagent");

package/dist/src/agent-catalog/capabilities.js

@@ -1,10 +1,10 @@
 import { AgentEntrySchema, EffectiveAgentConfigSchema } from "../agent-config/schema.js";
 import { resolveEffectiveAgentConfig } from "../agent-config/resolver.js";
 import { init_agent_config } from "../agent-config/index.js";
-import { AgentCatalogRepository, init_repository } from "./repository.js";
-import { init_agent_scope, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
 import { CapabilityError } from "../capabilities/runtime/errors.js";
 import { defineAtomicCapability, defineReadCapability } from "../capabilities/runtime/dispatcher.js";
+import { AgentCatalogRepository, init_repository } from "./repository.js";
+import { init_agent_scope, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
 import { AgentCatalogService } from "./service.js";
 import { z } from "zod";
 //#region src/agent-catalog/capabilities.ts