@xopcai/xopc 0.0.382 → 0.0.383

package/dist/src/agent/prompt/service-prompt-builder.js

@@ -6,14 +6,14 @@ import { getInteractionState } from "../../storage/sqlite/interaction-state-repo
 import { DEFAULT_USER_TRUST_LEVEL, init_trust_policy } from "../../user-context/trust-policy.js";
 import { getUserTrustPolicy } from "../../storage/sqlite/user-trust-repository.js";
 import { init_sqlite } from "../../storage/sqlite/index.js";
-import { appendStablePromptSection } from "./cache-boundary.js";
 import { getUserTimezone } from "../../user-model/repository.js";
+import { appendStablePromptSection } from "./cache-boundary.js";
+import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
+import { buildTtsSystemPromptHint } from "../../voice/tts/directives.js";
 import "../../user-model/index.js";
 import { resolveSystemPromptBuildParams } from "./system-prompt-params.js";
 import { buildSystemPrompt } from "./system-prompt.js";
 import { resolveResponseLanguageForSession } from "./response-language.js";
-import { buildTtsSystemPromptHint } from "../../voice/tts/directives.js";
-import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 //#region src/agent/prompt/service-prompt-builder.ts
 init_sqlite();
 init_interaction_state();

package/dist/src/agent/sandbox/exec-policy.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { validatePath, validateWritePath } from "./path-policy.js";
 import { prepareSafeToolEnv } from "./sanitize-env-vars.js";
+import { validatePath, validateWritePath } from "./path-policy.js";
 import { auditCommand, validateCommand } from "./command-validator.js";
 import { DEFAULT_SANDBOX_CONFIG } from "./types.js";
 import { resolve } from "node:path";

package/dist/src/agent/service/direct-turn-helpers.js

@@ -1,16 +1,16 @@
 import { getClarificationResumeInput, init_clarification_wait_repository } from "../../storage/sqlite/clarification-wait-repository.js";
 import { getConnectionResumeInput, init_connection_wait_repository } from "../../storage/sqlite/connection-wait-repository.js";
-import { isPersonalConversation } from "../../personal-agent/repository.js";
-import { resolveImageHandlingStrategy } from "../image/vision-detection.js";
-import { hydrateUserTurnForLlm } from "../inbound/attachment-pipeline.js";
-import { buildDelegatedTaskDirective, buildTaskExecutionDirective } from "../../tasks/task-context-assembler.js";
-import { shouldSkipResetOverlapCommand } from "../../session/reset-triggers.js";
 import { parseSlashCommand } from "../../chat-commands/command-parse.js";
+import { isPersonalConversation } from "../../personal-agent/repository.js";
 import { personalCommandRejection } from "../../chat-commands/personal-command-policy.js";
 import { commandRegistry } from "../../chat-commands/registry.js";
 import "../../chat-commands/index.js";
+import { resolveImageHandlingStrategy } from "../image/vision-detection.js";
+import { hydrateUserTurnForLlm } from "../inbound/attachment-pipeline.js";
+import { shouldSkipResetOverlapCommand } from "../../session/reset-triggers.js";
 import { runEmbeddedTurnForSession } from "../embedded/run-for-session.js";
 import { injectSourceContextsIntoUserMessage } from "../source-context/injector.js";
+import { buildDelegatedTaskDirective, buildTaskExecutionDirective } from "../../tasks/task-context-assembler.js";
 import { prependAgentContext } from "../context/prepend.js";
 import crypto from "node:crypto";
 //#region src/agent/service/direct-turn-helpers.ts

package/dist/src/agent/service/process-direct-streaming.js

@@ -5,18 +5,18 @@ import { getClarificationResumeInput, init_clarification_wait_repository } from
 import { getConnectionResumeInput, init_connection_wait_repository } from "../../storage/sqlite/connection-wait-repository.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
 import { init_agent_session_key, resolveAgentMainConversationId } from "../../routing/agent-session-key.js";
-import { readAgentMessageContent } from "../memory/agent-message-access.js";
-import { abortEmbeddedRun } from "../embedded/runs.js";
-import { clearPendingTranscriptUserMessage, setPendingTranscriptUserMessage } from "../inbound/attachment-pipeline.js";
+import { stripEnvelopeTimestampPrefix } from "../../channels/envelope-timestamp.js";
 import { mergeSttConfigFromAppConfig } from "../../voice/stt/config.js";
 import "../../voice/stt/index.js";
-import { formatAgentRunErrorForClient } from "../client-error-format.js";
+import { readAgentMessageContent } from "../memory/agent-message-access.js";
+import { clearPendingTranscriptUserMessage, setPendingTranscriptUserMessage } from "../inbound/attachment-pipeline.js";
+import { abortEmbeddedRun } from "../embedded/runs.js";
 import { resolveConfiguredActivityDetailDefault, resolveEffectiveReasoningLevel } from "../../session/thinking-resolve.js";
 import { initSessionTurn } from "../../session/init-session-turn.js";
 import "../../session/index.js";
-import { stripEnvelopeTimestampPrefix } from "../../channels/envelope-timestamp.js";
 import { isVoiceLikeAttachment, mergeVoiceTranscriptsIntoUserText, requestsOriginalVoiceInspection } from "../../channels/attachments/voice-stt-webchat.js";
 import { applyReasoningVisibility } from "../streaming/reasoning-visibility.js";
+import { formatAgentRunErrorForClient } from "../client-error-format.js";
 import { isSessionSourceBinding, summarizeSourceContext } from "../source-context/types.js";
 import { injectSourceContextsIntoUserMessage } from "../source-context/injector.js";
 import { AsyncQueue, AsyncQueueOverflowError } from "./async-queue.js";

package/dist/src/agent/service/webchat-tts.js

@@ -1,12 +1,12 @@
 import { appendMediaToAssistantTranscriptEntry, findLatestAssistantTranscriptEntryId } from "../../storage/sqlite/transcript-repository.js";
 import { init_sqlite } from "../../storage/sqlite/index.js";
 import { isTTSAvailable } from "../../voice/tts/factory.js";
-import { speak } from "../../voice/tts/speak-core.js";
 import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 import { getChannelOutputFormat, shouldUseTTS } 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 "../../voice/tts/index.js";
+import { persistOutboundTtsAudio } from "../../channels/attachments/outbound-tts-persist.js";
 import { deleteMediaUris } from "../../media/session-references.js";
 //#region src/agent/service/webchat-tts.ts
 init_sqlite();

package/dist/src/agent/service.js

@@ -3,43 +3,37 @@ 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 { init_agent_session_key, resolveAgentIdFromConversationId } from "../routing/agent-session-key.js";
-import { extractProfileAgentId, resolveEffectiveAgentConfigForSession } from "../config/agent-profile.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 { init_providers, resolveModel } from "../providers/index.js";
 import { configureTracing, flushTracing } from "../observability/runtime.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 { 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 { effectiveWorkspacePathForSession } from "../session/session-workspace.js";
 import { getProjectForSession } from "../projects/workspace.js";
 import "../user-model/index.js";
-import { runWithEmbeddedExecutionSession } from "./embedded/execution-context.js";
-import { removeSkillsLockEntry } from "./skills/hub-lock.js";
-import { installSkillFromZip } from "./skills/managed-store.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 { resolveWorkspaceSkillsDir, resolveWorkspaceSkillsLockPath } from "./skills/workspace-skills-dir.js";
 import { pullSkillFromSource } from "./skills/hub-pull.js";
-import { onSessionTranscriptUpdate } from "../session/transcript-events.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 { 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 { resolveCompactionPolicy } from "./memory/compaction-policy.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";
@@ -51,6 +45,9 @@ 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";
@@ -69,7 +66,10 @@ 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";

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 { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
+import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.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

@@ -6,6 +6,7 @@ type StarterAgent = {
     toolAllowlist?: AgentEntry['toolAllowlist'];
     skills?: AgentEntry['skills'];
     profile?: AgentEntry['profile'];
+    specialistProfile?: AgentEntry['specialistProfile'];
     profileFiles: Record<string, string>;
 };
 export declare const STARTER_AGENTS: readonly StarterAgent[];

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

@@ -14,6 +14,19 @@ function denyTools(names) {
 const STARTER_AGENTS = [
 	{
 		id: "main",
+		specialistProfile: {
+			version: 1,
+			domains: ["general"],
+			taskTypes: ["general_assistance"],
+			inputKinds: ["text"],
+			outputKinds: ["answer"],
+			specialties: ["General assistance"],
+			examples: [{
+				"request": "Summarize the supplied notes",
+				"deliverable": "A concise answer grounded in the notes"
+			}],
+			limitations: []
+		},
 		profile: {
 			name: "Smart Assistant",
 			description: "General-purpose personal assistant.",
@@ -28,6 +41,19 @@ const STARTER_AGENTS = [
 	},
 	{
 		id: "conductor",
+		specialistProfile: {
+			version: 1,
+			domains: ["coordination"],
+			taskTypes: ["task_planning"],
+			inputKinds: ["text"],
+			outputKinds: ["plan"],
+			specialties: ["Task planning and coordination"],
+			examples: [{
+				"request": "Plan delivery across several specialists",
+				"deliverable": "A task plan with deliverables and acceptance criteria"
+			}],
+			limitations: []
+		},
 		toolAllowlist: [
 			"xopc_use",
 			"tool_manual",
@@ -40,10 +66,6 @@ const STARTER_AGENTS = [
 			"grep",
 			"read_file"
 		],
-		skills: {
-			mode: "replace",
-			include: []
-		},
 		profile: {
 			name: "Conductor",
 			description: "User-facing coordination Agent for task planning, delegation, progress, verification, and reporting to the user.",
@@ -65,6 +87,23 @@ const STARTER_AGENTS = [
 	},
 	{
 		id: "coder",
+		specialistProfile: {
+			version: 1,
+			domains: ["software"],
+			taskTypes: [
+				"bug_fix",
+				"implementation",
+				"code_review"
+			],
+			inputKinds: ["repository"],
+			outputKinds: ["code_patch"],
+			specialties: ["Software implementation, debugging and code review"],
+			examples: [{
+				"request": "Fix a failing repository test",
+				"deliverable": "A focused code patch with verification results"
+			}],
+			limitations: []
+		},
 		tools: denyTools([]),
 		profile: {
 			name: "Coding Expert",
@@ -80,6 +119,19 @@ const STARTER_AGENTS = [
 	},
 	{
 		id: "writer",
+		specialistProfile: {
+			version: 1,
+			domains: ["writing"],
+			taskTypes: ["writing", "editing"],
+			inputKinds: ["text"],
+			outputKinds: ["document"],
+			specialties: ["Audience-aware writing and editing"],
+			examples: [{
+				"request": "Rewrite an announcement for customers",
+				"deliverable": "An audience-aware document draft"
+			}],
+			limitations: []
+		},
 		tools: denyTools([]),
 		profile: {
 			name: "Writing Assistant",
@@ -95,6 +147,19 @@ const STARTER_AGENTS = [
 	},
 	{
 		id: "researcher",
+		specialistProfile: {
+			version: 1,
+			domains: ["research"],
+			taskTypes: ["research"],
+			inputKinds: ["text", "web_page"],
+			outputKinds: ["report"],
+			specialties: ["Source comparison and fact synthesis"],
+			examples: [{
+				"request": "Compare evidence about a current topic",
+				"deliverable": "A dated report with primary source links"
+			}],
+			limitations: []
+		},
 		tools: denyTools([]),
 		profile: {
 			name: "Research Assistant",
@@ -110,6 +175,23 @@ const STARTER_AGENTS = [
 	},
 	{
 		id: "data-analyst",
+		specialistProfile: {
+			version: 1,
+			domains: ["data"],
+			taskTypes: ["data_analysis", "data_cleaning"],
+			inputKinds: ["csv", "spreadsheet"],
+			outputKinds: [
+				"report",
+				"chart",
+				"script"
+			],
+			specialties: ["Reproducible data analysis"],
+			examples: [{
+				"request": "Analyze monthly sales from a CSV",
+				"deliverable": "A reproducible report and charts"
+			}],
+			limitations: []
+		},
 		tools: denyTools([]),
 		profile: {
 			name: "Data Analyst",
@@ -125,6 +207,19 @@ const STARTER_AGENTS = [
 	},
 	{
 		id: "creative",
+		specialistProfile: {
+			version: 1,
+			domains: ["design"],
+			taskTypes: ["image_generation"],
+			inputKinds: ["text", "image"],
+			outputKinds: ["image", "design_brief"],
+			specialties: ["Visual direction and creative assets"],
+			examples: [{
+				"request": "Create a campaign visual",
+				"deliverable": "An image asset matching the creative brief"
+			}],
+			limitations: []
+		},
 		tools: denyTools([]),
 		profile: {
 			name: "Creative Assistant",
@@ -159,10 +254,11 @@ function ensureStarterAgentsInitialized() {
 		const existing = repository.get(starter.id);
 		if (existing) {
 			const current = existing.provisioningState === "ready" ? existing : repository.markProvisioned(starter.id);
-			if (starter.toolAllowlist && current.toolAllowlist === void 0 || starter.skills && current.skills === void 0) {
+			if (starter.toolAllowlist && current.toolAllowlist === void 0 || starter.skills && current.skills === void 0 || starter.specialistProfile && current.specialistProfile === void 0) {
 				const { revision, provisioningState: _state, provisioningError: _error, createdAt: _created, updatedAt: _updated, deletedAt: _deleted, ...entry } = current;
 				repository.update(starter.id, revision, {
 					...entry,
+					...starter.specialistProfile && entry.specialistProfile === void 0 ? { specialistProfile: starter.specialistProfile } : {},
 					...starter.toolAllowlist && entry.toolAllowlist === void 0 ? { toolAllowlist: starter.toolAllowlist } : {},
 					...starter.skills && entry.skills === void 0 ? { skills: starter.skills } : {}
 				});
@@ -173,6 +269,7 @@ function ensureStarterAgentsInitialized() {
 		repository.create({
 			id: starter.id,
 			enabled: true,
+			...starter.specialistProfile ? { specialistProfile: starter.specialistProfile } : {},
 			...starter.profile ? { profile: starter.profile } : {},
 			...starter.tools ? { tools: starter.tools } : {},
 			...starter.toolAllowlist ? { toolAllowlist: starter.toolAllowlist } : {},

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

@@ -2,17 +2,17 @@ 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 { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.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 { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { getApiKey, init_providers, resolveModel } from "../../providers/index.js";
-import { completeWithResolvedCredentials } from "../../providers/model-call.js";
 import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../../providers/model-response.js";
-import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
-import { resolveTaskLocale } from "../../tasks/task-language.js";
+import { completeWithResolvedCredentials } from "../../providers/model-call.js";
+import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { readWorkspaceRevision } from "../coding/workspace-revision.js";
 import { buildResponseLanguageSection } from "../prompt/sections/response-language.js";
 import { resolveResponseLanguageForSession } from "../prompt/response-language.js";
-import { TaskApplicationService } from "../../tasks/task-application-service.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,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
@@ -42,7 +43,8 @@ const DelegateTaskSchema = Type.Object({
 	maxIterations: Type.Optional(Type.Integer({
 		minimum: 1,
 		maximum: 60
-	}))
+	})),
+	budgetTier: Type.Optional(Type.Union(Object.keys(DELEGATION_BUDGETS).map((tier) => Type.Literal(tier)), { description: "light: 15 calls/50k cumulative tokens/2 min; standard (default): 30/100k/5 min; deep: 60/200k/10 min. maxIterations overrides the call limit only. Approaching limits reserves one tool-free handoff. Cloud Credit limits still apply." }))
 });
 function delegateToolNames(mode, requested) {
 	return resolveDelegationTools(Object.keys(DELEGATION_TOOL_CAPABILITIES), mode, requested).granted;
@@ -52,7 +54,7 @@ function createDelegateTool(deps) {
 		name: "delegate_task",
 		label: "Delegate task",
 		parameters: DelegateTaskSchema,
-		description: "Delegate a bounded task with a fresh context; supply relevant facts and constraints in context. Default research inherits the parent's local, web, knowledge, skill and approved external read tools. read/inspect/review are local read-only. toolset and capabilities only narrow parent access; custom requires explicit capabilities. Browser interaction is opt-in. implement requires a project and clean Git workspace and returns changes in a separate worktree for review. No nested delegation, external writes, installation or background jobs. Up to 60 tool calls, 100k tokens and five minutes. Reports rejected tools and their reasons.",
+		description: "Delegate a bounded task with a fresh context; supply relevant facts and constraints in context. Default research inherits the parent's local, web, knowledge, skill and approved external read tools. read/inspect/review are local read-only. toolset and capabilities only narrow parent access; custom requires explicit capabilities. Browser interaction is opt-in. implement requires a project and clean Git workspace and returns changes in a separate worktree for review. No nested delegation, external writes, installation or background jobs. budgetTier selects light, standard (default), or deep; token budgets sum all model requests, not context size. Reports stop reason, budget usage, partial handoff and rejected tools.",
 		supportsParallel: false,
 		idempotent: false,
 		async execute(_id, input, signal) {
@@ -72,6 +74,7 @@ function createDelegateTool(deps) {
 				}],
 				details: {
 					status: "failed",
+					stopReason: "parent_policy",
 					mode,
 					grantedTools: tools,
 					rejectedTools: access.rejected
@@ -99,7 +102,8 @@ function createDelegateTool(deps) {
 				context: input.context,
 				requesterConversationId: parentConversationId,
 				allowedToolNames: tools,
-				maxIterations: input.maxIterations ?? 30,
+				budgetTier: input.budgetTier,
+				maxIterations: input.maxIterations ?? DELEGATION_BUDGETS[input.budgetTier ?? "standard"].maxToolCalls,
 				model,
 				bus: deps.bus,
 				getConfig: deps.getConfig,
@@ -144,6 +148,12 @@ function createDelegateTool(deps) {
 						type: "text",
 						text: [
 							result.summary,
+							`Budget (${result.budget.tier}): ${JSON.stringify({
+								stopReason: result.stopReason,
+								usage: result.budget.usage,
+								limits: result.budget.limits,
+								handoffRequested: result.handoff.requested
+							})}`,
 							stale ? "Workspace changed or could not be fingerprinted; review findings require revalidation." : "",
 							access.rejected.length ? `Rejected tools: ${JSON.stringify(access.rejected)}` : "",
 							environmentId ? `Changes retained in ${workspace} (environment ${environmentId}). Review and integrate from this workspace, then verify the parent workspace again.` : "",
@@ -159,6 +169,9 @@ function createDelegateTool(deps) {
 						iterations: result.toolIterations,
 						revision: currentRevision,
 						reviewedRevision: revision,
+						stopReason: result.stopReason,
+						budget: result.budget,
+						handoff: result.handoff,
 						...result.verification ? { childVerification: result.verification } : {},
 						...environmentId ? {
 							environmentId,
@@ -175,6 +188,7 @@ function createDelegateTool(deps) {
 					}],
 					details: {
 						status: signal?.aborted ? "cancelled" : "failed",
+						stopReason: signal?.aborted ? "cancelled" : "runtime_error",
 						mode,
 						grantedTools: tools,
 						rejectedTools: access.rejected,

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

@@ -48,6 +48,7 @@ export interface ToolFactoryDeps {
     getMemoryManager?: () => MemoryManager;
     /** Skill runtime for the current workspace/session. */
     getSkillManager?: () => SkillManager;
+    getAgentToolAvailability?: PersonalTaskToolDeps['getAgentToolAvailability'];
     getAgentSkillAvailability?: PersonalTaskToolDeps['getAgentSkillAvailability'];
     /** Session store for `session_search`. */
     getSessionStore?: () => SessionStore;