@xopcai/xopc 0.0.381 → 0.0.383

package/dist/src/agent/embedded/run-turn.js

@@ -6,32 +6,32 @@ import { getConnectionResumeInput, init_connection_wait_repository, isConnection
 import { getSessionMetadata } from "../../storage/sqlite/session-read-repository.js";
 import { init_session_repository } from "../../storage/sqlite/session-repository.js";
 import { init_sqlite } from "../../storage/sqlite/index.js";
-import { resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
 import { setTraceIdentity, traceOperation, traceRun, traceTools } from "../../observability/runtime.js";
 import { continuesAfterTool, trackAiUsageStream } from "../../usage/recorder.js";
 import { cloudCreditBudgetStopMessage, isCloudCreditBudgetExhausted, reportCloudCreditError, withCloudCreditBudget } from "../../providers/xopc-cloud-credit-budget.js";
-import { isAgentTurnUnsettledError, resolveAgentTurnTimeoutMs, runAgentTurnWithTimeout } from "../orchestration/run-agent-turn-with-timeout.js";
-import { isContextOverflowError } from "../orchestration/context-overflow.js";
-import { getAssistantTurnErrorMessage, isAssistantTurnAborted, isAssistantTurnFailed, maybeRetryTurnAfterTransientLlmFailure, stripTrailingErrorAssistantMessages } from "../orchestration/llm-turn-retry.js";
-import { allowsExecutionTool, filterExecutionTools, resolveExecutionToolPolicy } from "./execution-tool-policy.js";
 import { runWithEmbeddedExecutionSession } from "./execution-context.js";
-import { externalPolicyContext } from "./tool-metadata.js";
+import { resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
 import { isComputerControlActive, isComputerLeaseTool, stopComputerControl } from "../../computer/control-guard.js";
+import { externalPolicyContext } from "./tool-metadata.js";
+import { resolvePromptCachePolicy } from "../../providers/prompt-cache-plan.js";
+import { wrapStreamFnForXopcExtensions } from "./xopc-stream-bridge.js";
 import { EmbeddedRunConflictError, abortEmbeddedRun, acquireEmbeddedRunLease, queueEmbeddedSteer } from "./runs.js";
+import { allowsExecutionTool, filterExecutionTools, resolveExecutionToolPolicy } from "./execution-tool-policy.js";
+import { acquireEmbeddedSessionRunner, evictEmbeddedSessionRunner } from "./session-runner.js";
+import { projectContextForModel } from "../memory/context-budget.js";
+import { resolveCompactionPolicy } from "../memory/compaction-policy.js";
+import { markTurnToolResult } from "../memory/turn-provenance.js";
 import { lastAssistantPlainText, subscribeEmbeddedSessionEvents } from "./subscribe-session.js";
+import { isContextOverflowError } from "../orchestration/context-overflow.js";
+import { getAssistantTurnErrorMessage, isAssistantTurnAborted, isAssistantTurnFailed, maybeRetryTurnAfterTransientLlmFailure, stripTrailingErrorAssistantMessages } from "../orchestration/llm-turn-retry.js";
+import { isAgentTurnUnsettledError, resolveAgentTurnTimeoutMs, runAgentTurnWithTimeout } from "../orchestration/run-agent-turn-with-timeout.js";
 import { detectToolLoops } from "../orchestration/loop-guard.js";
 import { tryApplySessionTranscriptHygiene } from "../transcript/transcript-hygiene.js";
 import { restoreCurrentTurnImages } from "./current-turn-images.js";
-import { resolvePromptCachePolicy } from "../../providers/prompt-cache-plan.js";
-import { wrapStreamFnForXopcExtensions } from "./xopc-stream-bridge.js";
-import { acquireEmbeddedSessionRunner, evictEmbeddedSessionRunner } from "./session-runner.js";
-import { projectContextForModel } from "../memory/context-budget.js";
 import { createSqliteTranscriptRuntime } from "./transcript-runtime.js";
 import { assessContext, recoverContext as recoverContext$1 } from "../memory/context-recovery.js";
-import { resolveCompactionPolicy } from "../memory/compaction-policy.js";
 import { buildPromptCacheSnapshot, observePromptCacheSnapshot } from "../../providers/prompt-cache-observability.js";
 import { isPromptCacheExpired, recordPromptCacheTouch } from "../../providers/prompt-cache-lifecycle.js";
-import { markTurnToolResult } from "../memory/turn-provenance.js";
 import { RepositoryInstructions } from "../coding/repository-instructions.js";
 import { RunVerification } from "../coding/run-verification.js";
 import { withDelegationScope } from "../orchestration/delegation-scope.js";
@@ -507,6 +507,8 @@ async function runXopcEmbeddedTurnInner(params) {
 			};
 			effectiveSystemPrompt = getCurrentSystemPrompt(effectiveContext.messages);
 			effectiveTools = getCurrentTools(effectiveContext.messages);
+			const modelRequestStop = params.turnPolicy?.beforeModelRequest?.(options?.signal ?? runAbortSignal);
+			if (modelRequestStop) return createContextErrorStream(streamModel, modelRequestStop);
 			const promptCacheSnapshot = buildPromptCacheSnapshot({
 				model: streamModel,
 				systemPrompt: effectiveSystemPrompt,
@@ -663,6 +665,15 @@ async function runXopcEmbeddedTurnInner(params) {
 			}
 			policyStopped ||= params.turnPolicy?.shouldStopAfterTurn(context) ?? false;
 			if (policyStopped || connectionStopped || clarificationStopped) return { action: "end" };
+			const continuation = params.turnPolicy?.takeContinuationMessage?.();
+			if (continuation) {
+				session.agent.steer({
+					role: "user",
+					content: continuation,
+					timestamp: Date.now()
+				});
+				return { action: "continue" };
+			}
 			if (baseDecision && baseDecision.action === "continue") return { action: "continue" };
 		};
 		unsubscribe = subscribeEmbeddedSessionEvents(session, (event) => {

package/dist/src/agent/embedded/session-runner.js

@@ -1,17 +1,17 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { isCodemodeCoreRead } from "../tools/codemode-permissions.js";
-import { filterExecutionTools, resolveExecutionToolPolicy } from "./execution-tool-policy.js";
 import { deferredToolContract, getXopcToolMetadata } from "./tool-metadata.js";
-import { abortEmbeddedRun } from "./runs.js";
 import { guardSessionManager } from "./session-tool-result-guard.js";
 import { transformUserMessageForPersistence } from "../inbound/attachment-pipeline.js";
 import { createEmbeddedModelRuntime, resolveEmbeddedProviderApiKeySync } from "./model-runtime.js";
 import { wrapStreamFnForXopcExtensions } from "./xopc-stream-bridge.js";
 import { xopcToolsToDefinitions } from "./xopc-tools-bridge.js";
+import { isCodemodeCoreRead } from "../tools/codemode-permissions.js";
 import { createXopcCodemodeExtension } from "./codemode-extension.js";
 import { TOOL_DISCOVERY_STATE, createXopcToolSearchExtension } from "./tool-search-extension.js";
 import { getNativePiAgentDir } from "../mcp/native-mcp.js";
+import { abortEmbeddedRun } from "./runs.js";
+import { filterExecutionTools, resolveExecutionToolPolicy } from "./execution-tool-policy.js";
 import { join } from "node:path";
 import { createHash } from "node:crypto";
 import { DefaultResourceLoader, SettingsManager, createAgentSession, createMcpExtension } from "@earendil-works/pi-coding-agent";

package/dist/src/agent/embedded/session-tool-result-guard.js

@@ -1,10 +1,10 @@
 import { init_string_coerce, normalizeOptionalString } from "../../utils/string-coerce.js";
-import { extractToolCallsFromAssistant, extractToolResultId } from "../transcript/tool-call-id.js";
-import { makeMissingToolResult, sanitizeToolCallInputs } from "../transcript/session-transcript-repair.js";
-import { boundedJsonUtf8Bytes, firstEnumerableOwnKeys, jsonUtf8BytesOrInfinity } from "../../infra/json-utf8-bytes.js";
 import { emitSessionTranscriptUpdate } from "../../session/transcript-events.js";
+import { boundedJsonUtf8Bytes, firstEnumerableOwnKeys, jsonUtf8BytesOrInfinity } from "../../infra/json-utf8-bytes.js";
 import { formatContextLimitTruncationNotice } from "./tool-result-context-guard.js";
 import { resolveLiveToolResultMaxChars, truncateToolResultMessage } from "./tool-result-truncation.js";
+import { extractToolCallsFromAssistant, extractToolResultId } from "../transcript/tool-call-id.js";
+import { makeMissingToolResult, sanitizeToolCallInputs } from "../transcript/session-transcript-repair.js";
 //#region src/agent/embedded/session-tool-result-guard.ts
 init_string_coerce();
 /**

package/dist/src/agent/embedded/tool-result-truncation.js

@@ -1,6 +1,6 @@
 import { init_string_coerce, normalizeLowercaseStringOrEmpty } from "../../utils/string-coerce.js";
-import { isDataBatchResult, renderDataBatch } from "../data-acquisition/render.js";
 import { formatContextLimitTruncationNotice } from "./tool-result-context-guard.js";
+import { isDataBatchResult, renderDataBatch } from "../data-acquisition/render.js";
 //#region src/agent/embedded/tool-result-truncation.ts
 init_string_coerce();
 const MAX_TOOL_RESULT_CONTEXT_SHARE = .3;

package/dist/src/agent/external-tools/cliProvider.js

@@ -8,14 +8,14 @@ import { init_sqlite } from "../../storage/sqlite/index.js";
 import { CapabilityError } from "../../capabilities/runtime/errors.js";
 import { ExternalEffectNotAppliedError, executeExternalOperation } from "../../capabilities/runtime/external-operations.js";
 import "../../capabilities/runtime/dispatcher.js";
-import { connectorArgumentsHash, connectorArgumentsPreview } from "../../connectors/approval.js";
-import { selectConnectorAccount } from "../../connectors/account-selection.js";
-import { cliContextPath } from "../../connectors/cli/process.js";
 import { validateActionInput } from "../../connectors/cli/protocol.js";
 import { getCliAdapter } from "../../connectors/cli/adapterRegistry.js";
 import { evaluateConnectorExecutionPolicy } from "../../connectors/policy.js";
 import { listConnectorInstances } from "../../connectors/instances.js";
+import { cliContextPath } from "../../connectors/cli/process.js";
 import { cliOwnerId, recoverCliExecutions } from "../../connectors/cli/store.js";
+import { selectConnectorAccount } from "../../connectors/account-selection.js";
+import { connectorArgumentsHash, connectorArgumentsPreview } from "../../connectors/approval.js";
 import { describeCliAction, executeCliAction } from "../../connectors/cli/runtime.js";
 import { connectorPrincipalForSession } from "../../connectors/principal.js";
 import { externalToolRef, parseExternalToolRef } from "./refs.js";

package/dist/src/agent/external-tools/composio-provider.js

@@ -7,17 +7,17 @@ import { bindObjectiveAccount, connectionBinding, connectionBindings, connectorO
 import { init_sqlite } from "../../storage/sqlite/index.js";
 import { CapabilityError } from "../../capabilities/runtime/errors.js";
 import { ExternalEffectNotAppliedError, executeExternalOperation } from "../../capabilities/runtime/external-operations.js";
-import { connectorArgumentsHash, connectorArgumentsPreview } from "../../connectors/approval.js";
-import { canAccessConnectorAccount, currentAccountConnections } from "../../connectors/account-access.js";
 import { connectorIdentitySummary } from "../../connectors/connector-identity.js";
 import { evaluateConnectorExecutionPolicy } from "../../connectors/policy.js";
+import { canAccessConnectorAccount, currentAccountConnections } from "../../connectors/account-access.js";
 import { ComposioSessionsAdapter } from "../../connectors/composio-sessions.js";
 import { getComposioToolkitScope, getConfiguredComposioAuthConfigs, isComposioActionAllowedByCatalog, scopeForComposioAction } from "../../connectors/composio.js";
 import { getConnectorDefinition } from "../../connectors/catalog.js";
 import { listConnectorInstances } from "../../connectors/instances.js";
+import { connectorArgumentsHash, connectorArgumentsPreview } from "../../connectors/approval.js";
+import { isToolInputSchema } from "../../connectors/connection-capabilities.js";
 import { connectorPrincipalForSession } from "../../connectors/principal.js";
 import { externalToolRef, parseExternalToolRef } from "./refs.js";
-import { isToolInputSchema } from "../../connectors/connection-capabilities.js";
 import { ExternalToolSearchError } from "./search-error.js";
 //#region src/agent/external-tools/composio-provider.ts
 init_session_input_repository();

package/dist/src/agent/external-tools/endpoint-provider.js

@@ -1,15 +1,15 @@
-import { init_src } from "../../../packages/computer-control-contract/src/index.js";
-import "../../../packages/browser-control-contract/src/index.js";
 import { ExternalEffectNotAppliedError, executeExternalOperation } from "../../capabilities/runtime/external-operations.js";
 import { canonicalCapabilityJson } from "../../capabilities/runtime/dispatcher.js";
-import { externalToolRef, parseExternalToolRef } from "./refs.js";
+import { init_src } from "../../../packages/computer-control-contract/src/index.js";
+import "../../../packages/browser-control-contract/src/index.js";
 import { extractDocumentText } from "../../document-understanding/extract.js";
-import { prepareImageForModel } from "../image/prepare-image-for-model.js";
+import { EndpointToolExecutionError } from "../../endpoint-tools/invocation-service.js";
 import { processLocationTask } from "../../endpoint-tools/location-task.js";
 import { projectDeviceReading } from "../../endpoint-tools/result-projector.js";
-import { getEndpointDeviceSettings } from "../../storage/sqlite/endpoint-device-settings-repository.js";
 import { DeviceTargetResolver } from "../../endpoint-tools/target-resolver.js";
-import { EndpointToolExecutionError } from "../../endpoint-tools/invocation-service.js";
+import { getEndpointDeviceSettings } from "../../storage/sqlite/endpoint-device-settings-repository.js";
+import { externalToolRef, parseExternalToolRef } from "./refs.js";
+import { prepareImageForModel } from "../image/prepare-image-for-model.js";
 import { createHash } from "node:crypto";
 //#region src/agent/external-tools/endpoint-provider.ts
 init_src();

package/dist/src/agent/external-tools/gateway-tools.js

@@ -6,11 +6,11 @@ import { connectionBindings, getActiveConnectionWait, init_connection_wait_repos
 import { getSessionMetadata } from "../../storage/sqlite/session-read-repository.js";
 import { init_session_repository } from "../../storage/sqlite/session-repository.js";
 import { listConnectorInstances } from "../../connectors/instances.js";
+import { getStoreConnectorInstallPlan, parseStoreConnectorCandidateRef, searchStoreConnectorInstallCandidates } from "../../capabilities/store-connector.js";
+import { connectionCandidates, resolveConnectionCandidate } from "../../connectors/connection-candidates.js";
 import { connectorPrincipalForSession } from "../../connectors/principal.js";
 import { parseExternalToolRef } from "./refs.js";
 import { setXopcToolMetadata } from "../embedded/tool-metadata.js";
-import { getStoreConnectorInstallPlan, parseStoreConnectorCandidateRef, searchStoreConnectorInstallCandidates } from "../../capabilities/store-connector.js";
-import { connectionCandidates, resolveConnectionCandidate } from "../../connectors/connection-candidates.js";
 import { ExternalToolService } from "./service.js";
 import { EXTERNAL_TOOL_SOURCES } from "./types.js";
 import { bindExternalToolRegistry } from "./tool-registry.js";

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

@@ -1,5 +1,5 @@
-import { resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
 import { getEmbeddedExecutionSession } from "../embedded/execution-context.js";
+import { resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
 import { parseExternalToolRef } from "./refs.js";
 import { CliToolProvider } from "./cliProvider.js";
 import { ComposioToolProvider } from "./composio-provider.js";

package/dist/src/agent/image/generation/openai-images-provider.js

@@ -1,6 +1,5 @@
 import { createLogger } from "../../../utils/logger/index.js";
 import { init_logger } from "../../../utils/logger.js";
-import { imageFileExtensionForMimeType } from "./image-assets.js";
 import { pickTimeoutMsOrFallback } from "../../../media-shared/http/deadline.js";
 import { privateNetworkPolicyToSsrfGuardOptions } from "../../../media-shared/http/private-network.js";
 import { resolveProviderHttpRequestConfig } from "../../../media-shared/http/resolve-provider-http-request-config.js";
@@ -9,6 +8,7 @@ import "../../../media-shared/http/index.js";
 import { ImageProviderError, validateImageRequest } from "../../../../packages/image-providers/src/validation.js";
 import { decodeBase64, imageFromBytes } from "../../../../packages/image-providers/src/http.js";
 import "../../../../packages/image-providers/src/index.js";
+import { imageFileExtensionForMimeType } from "./image-assets.js";
 //#region src/agent/image/generation/openai-images-provider.ts
 /** Strict implementation of the OpenAI Images REST protocol. */
 init_logger();

package/dist/src/agent/image/generation/runtime.js

@@ -3,12 +3,12 @@ import { init_logger } from "../../../utils/logger.js";
 import { PROVIDER_ENV_MAP, init_env_keys } from "../../../providers/env-keys.js";
 import { ImageProviderError } from "../../../../packages/image-providers/src/validation.js";
 import "../../../../packages/image-providers/src/index.js";
+import { getImageGenerationProvider, listImageGenerationProviders, listImageGenerationProvidersSummary as listImageGenerationProvidersSummary$1 } from "./provider-registry.js";
 import { describeFailoverError, isFailoverError } from "../../failover-error.js";
 import { buildNoCapabilityModelConfiguredMessage, recordCapabilityCandidateFailure, resolveCapabilityModelCandidates, throwCapabilityGenerationFailure } from "../../media-generation/runtime-shared.js";
 import "../../media-generation/index.js";
 import { parseImageGenerationModelRef } from "./model-ref.js";
 import { validateImageGenerationRequest } from "./validation.js";
-import { getImageGenerationProvider, listImageGenerationProviders, listImageGenerationProvidersSummary as listImageGenerationProvidersSummary$1 } from "./provider-registry.js";
 //#region src/agent/image/generation/runtime.ts
 init_env_keys();
 init_logger();

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

@@ -1,9 +1,9 @@
+import { getImageGenerationProvider, listImageGenerationProviders } from "./generation/provider-registry.js";
 import { getImageUnderstandingProvider, listImageUnderstandingProviders, registerImageUnderstandingProvider } from "./understanding/provider-registry.js";
 import { resolveImageModelConfigForTool } from "./tool-model-config.js";
 import { describeImages, describeImagesWithFallback } from "./understanding/runtime.js";
 import { modelSupportsVision, resolveImageHandlingStrategy } from "./vision-detection.js";
 import { runWithImageModelFallback } from "./image-model-fallback.js";
 import { loadImageForToolInput } from "./load-image-media.js";
-import { getImageGenerationProvider, listImageGenerationProviders } from "./generation/provider-registry.js";
 import { generateImage, listImageGenerationProvidersSummary } from "./generation/runtime.js";
 export { describeImages, describeImagesWithFallback, generateImage, getImageGenerationProvider, getImageUnderstandingProvider, listImageGenerationProviders, listImageGenerationProvidersSummary, listImageUnderstandingProviders, loadImageForToolInput, modelSupportsVision, registerImageUnderstandingProvider, resolveImageHandlingStrategy, resolveImageModelConfigForTool, runWithImageModelFallback };

package/dist/src/agent/image/load-image-media.js

@@ -1,5 +1,5 @@
-import { checkFileSafety } from "../prompt/safety.js";
 import { decodeDataUrl } from "./image-helpers.js";
+import { checkFileSafety } from "../prompt/safety.js";
 import { homedir } from "node:os";
 import path from "node:path";
 import { promises } from "node:fs";

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

@@ -1,7 +1,7 @@
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
-import { resolveEffectiveAgentConfigForAgent } from "../../config/agent-profile.js";
 import { getAgentDefaultImageModelConfig, getAgentDefaultModelRef, init_schema, parseModelRef } from "../../config/schema.js";
 import { getDefaultModelSync, getModelsByProvider, init_providers, isProviderConfiguredSync, resolveModel } from "../../providers/index.js";
+import { resolveEffectiveAgentConfigForAgent } from "../../config/agent-profile.js";
 import { resolveAgentModelFallbackValues, resolveAgentModelPrimaryValue } from "../../config/model-input.js";
 import { buildCapabilityPlansForConfig } from "../../capabilities/readiness/from-config.js";
 import "../../capabilities/readiness/index.js";

package/dist/src/agent/inbound/attachment-pipeline.js

@@ -1,14 +1,14 @@
 import { stripRuntimeUserMessageEnvelope } from "../../../packages/gateway-contract/src/user-message-display.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
-import { extractProfileAgentId } from "../../config/agent-profile.js";
-import { readAgentMessageContent } from "../memory/agent-message-access.js";
 import { isPersonalConversation } from "../../personal-agent/repository.js";
+import { extractProfileAgentId } from "../../config/agent-profile.js";
 import { MODEL_IMAGE_MAX_BYTES, MODEL_IMAGE_SOURCE_MAX_BYTES, prepareImageForModel } from "../image/prepare-image-for-model.js";
 import { mimeTypeFromMediaPath } from "../../media/store.js";
 import { readMediaReference } from "../../media/media-reference.js";
 import { isImageInboundAttachment } from "../../channels/attachments/attachment-classifiers.js";
 import "../../channels/attachments/inbound-persist.js";
 import { expandAtFileMentionsInPlainText } from "../context/expand-at-file-mentions.js";
+import { readAgentMessageContent } from "../memory/agent-message-access.js";
 import { resolveImageHandlingStrategy } from "../image/vision-detection.js";
 import { resolveInboundImageContentParts } from "../image/inbound-image-handling.js";
 //#region src/agent/inbound/attachment-pipeline.ts

package/dist/src/agent/inbound/inbound-loop.js

@@ -1,9 +1,9 @@
 import { runWithLogContext, updateAsyncLogContext } from "../../utils/logger/context.js";
 import { init_logger } from "../../utils/logger.js";
-import { shouldSkipResetOverlapCommand } from "../../session/reset-triggers.js";
-import { initSessionTurn } from "../../session/init-session-turn.js";
 import { MessageBusShutdownError } from "../../infra/bus/queue.js";
 import "../../infra/bus/index.js";
+import { shouldSkipResetOverlapCommand } from "../../session/reset-triggers.js";
+import { initSessionTurn } from "../../session/init-session-turn.js";
 import { runEmbeddedTurnForSession } from "../embedded/run-for-session.js";
 import { inboundMessageLogRequestId } from "../service-inbound-utils.js";
 //#region src/agent/inbound/inbound-loop.ts

package/dist/src/agent/index.js

@@ -1,14 +1,14 @@
-import { resolveTranscriptPolicy } from "./transcript/transcript-policy.js";
-import { dropThinkingBlocks } from "./transcript/thinking.js";
 import { extractToolCallsFromAssistant, extractToolResultId, sanitizeToolCallId, sanitizeToolCallIdsForCloudCodeAssist } from "./transcript/tool-call-id.js";
 import { makeMissingToolResult, repairToolUseResultPairing, sanitizeToolCallInputs, sanitizeToolUseResultPairing, stripToolResultDetails } from "./transcript/session-transcript-repair.js";
+import { resolveTranscriptPolicy } from "./transcript/transcript-policy.js";
+import { dropThinkingBlocks } from "./transcript/thinking.js";
 import { applySessionTranscriptHygiene, applySessionTranscriptHygieneForPersistence, applySessionTranscriptHygieneWithPolicy, resolvePolicyForModel, tryApplySessionTranscriptHygiene, tryApplySessionTranscriptHygieneForPersistence } from "./transcript/transcript-hygiene.js";
+import { AgentService } from "./service.js";
 import { createResponseMessage, createSignalMessage, createTaskMessage, isValidIPCMessage } from "./ipc/types.js";
 import { AgentInbox } from "./ipc/inbox.js";
 import { AgentBus } from "./ipc/bus.js";
 import { AgentSocketClient, AgentSocketServer, isSocketAvailable } from "./ipc/socket.js";
 import "./ipc/index.js";
-import { AgentService } from "./service.js";
 import { stripToolMessages } from "./transcript/strip-tool-messages.js";
 import "./transcript/index.js";
 export { AgentBus, AgentInbox, AgentService, AgentSocketClient, AgentSocketServer, applySessionTranscriptHygiene, applySessionTranscriptHygieneForPersistence, applySessionTranscriptHygieneWithPolicy, createResponseMessage, createSignalMessage, createTaskMessage, dropThinkingBlocks, extractToolCallsFromAssistant, extractToolResultId, isSocketAvailable, isValidIPCMessage, makeMissingToolResult, repairToolUseResultPairing, resolvePolicyForModel, resolveTranscriptPolicy, sanitizeToolCallId, sanitizeToolCallIdsForCloudCodeAssist, sanitizeToolCallInputs, sanitizeToolUseResultPairing, stripToolMessages, stripToolResultDetails, tryApplySessionTranscriptHygiene, tryApplySessionTranscriptHygieneForPersistence };

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

@@ -1,6 +1,6 @@
-import { AgentPluginStore } from "../../extensions/agent-plugins/store.js";
 import { normalizeConfiguredMcpServers } from "../../config/mcp-config-normalize.js";
 import { inspectExtensionConnectorDependencies } from "../../extensions/connector-dependencies.js";
+import { AgentPluginStore } from "../../extensions/agent-plugins/store.js";
 import { materializePluginServers } from "../../extensions/agent-plugins/mcp-adapter.js";
 //#region src/agent/mcp/config.ts
 function loadMergedMcpConfig(params) {

package/dist/src/agent/memory/context-budget.js

@@ -1,5 +1,5 @@
-import { readAgentMessageContent } from "./agent-message-access.js";
 import { getToolResultTextLength, truncateToolResultMessage } from "../embedded/tool-result-truncation.js";
+import { readAgentMessageContent } from "./agent-message-access.js";
 //#region src/agent/memory/context-budget.ts
 const MESSAGE_OVERHEAD_TOKENS = 12;
 const REQUEST_OVERHEAD_TOKENS = 256;

package/dist/src/agent/memory/context-recovery.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { stripTrailingErrorAssistantMessages } from "../orchestration/llm-turn-retry.js";
 import { evaluateContextBudget, projectContextForModel, stringifyMessagesForBudget } from "./context-budget.js";
+import { stripTrailingErrorAssistantMessages } from "../orchestration/llm-turn-retry.js";
 //#region src/agent/memory/context-recovery.ts
 init_logger();
 const log = createLogger("ContextRecovery");

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

@@ -1,6 +1,6 @@
+import { buildUserContextBlock, sanitizeUserContextFenceEscapes } from "./context-fence.js";
 import { isMemorySubsystemEnabled } from "./memory-config.js";
 import { extractAgentUserPlainText } from "./user-message-text.js";
-import { buildUserContextBlock, sanitizeUserContextFenceEscapes } from "./context-fence.js";
 import { MemoryManager } from "./manager.js";
 import { discoverMemoryPlugins } from "./plugin-discovery.js";
 import { createMemoryManagerFromConfig } from "./create-memory-manager.js";

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

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { abortEmbeddedRun } from "../embedded/runs.js";
 import { persistInboundAttachments } from "../../channels/attachments/inbound-persist.js";
 import { buildTranscriptUserMessage, clearPendingTranscriptUserMessage, hydrateUserTurnForLlm, setPendingTranscriptUserMessage } from "../inbound/attachment-pipeline.js";
+import { abortEmbeddedRun } from "../embedded/runs.js";
 import { resolveEffectiveThinkingLevel } from "../../session/thinking-resolve.js";
 import { runEmbeddedTurnForSession } from "../embedded/run-for-session.js";
 import { randomUUID } from "node:crypto";

package/dist/src/agent/orchestration/agent-turn-policy.d.ts

@@ -4,6 +4,10 @@ export interface AgentTurnPolicy {
     beforeToolCall(context: BeforeToolCallContext, signal?: AbortSignal): Promise<BeforeToolCallResult | undefined>;
     afterToolCall(context: AfterToolCallContext): Promise<undefined>;
     shouldStopAfterTurn(context: AgentTurnContext): boolean;
+    /** One bounded continuation requested by a policy, e.g. a budget handoff. */
+    takeContinuationMessage?(): string | undefined;
+    /** Recheck limits at dispatch, including requests made by recovery paths. */
+    beforeModelRequest?(signal?: AbortSignal): string | undefined;
 }
 export interface AgentTurnPolicyOptions {
     maxTurns?: number;

package/dist/src/agent/orchestration/delegation-budget.d.ts

@@ -0,0 +1,60 @@
+import type { AgentTurnPolicy, AgentTurnPolicyOptions } from './agent-turn-policy.js';
+export declare const DELEGATION_BUDGETS: {
+    readonly light: {
+        readonly maxToolCalls: 15;
+        readonly maxTotalTokens: 50000;
+        readonly timeoutMs: 120000;
+    };
+    readonly standard: {
+        readonly maxToolCalls: 30;
+        readonly maxTotalTokens: 100000;
+        readonly timeoutMs: 300000;
+    };
+    readonly deep: {
+        readonly maxToolCalls: 60;
+        readonly maxTotalTokens: 200000;
+        readonly timeoutMs: 600000;
+    };
+};
+export type DelegationBudgetTier = keyof typeof DELEGATION_BUDGETS;
+export type DelegationStopReason = 'completed' | 'tool_calls' | 'total_tokens' | 'model_turns' | 'tool_failures' | 'timeout' | 'cancelled' | 'parent_policy' | 'credit_budget' | 'runtime_error' | 'verification';
+export declare function resolveDelegationBudget(tier?: DelegationBudgetTier, maxIterations?: number, timeoutMs?: number): {
+    tier: "light" | "standard" | "deep";
+    limits: {
+        maxToolCalls: number;
+        maxTotalTokens: 50000 | 100000 | 200000;
+        maxModelTurns: number;
+        maxToolFailures: number;
+        timeoutMs: number;
+    };
+};
+/** Reserve the last 20% for one tool-free handoff, without bypassing hard limits. */
+export declare function createDelegationBudgetPolicy(budget: ReturnType<typeof resolveDelegationBudget>, options: {
+    isComplete?: () => boolean;
+    authorizeToolCall?: AgentTurnPolicyOptions['authorizeToolCall'];
+}, now?: () => number): {
+    policy: AgentTurnPolicy;
+    addTokens(tokens: number): void;
+    stop(reason: DelegationStopReason, message?: string): void;
+    snapshot(): {
+        usage: {
+            elapsedMs: number;
+            toolCalls: number;
+            totalTokens: number;
+            modelTurns: number;
+            toolFailures: number;
+        };
+        stopReason: DelegationStopReason;
+        stopMessage: string;
+        handoffRequested: boolean;
+        handoffReason: DelegationStopReason;
+        tier: "light" | "standard" | "deep";
+        limits: {
+            maxToolCalls: number;
+            maxTotalTokens: 50000 | 100000 | 200000;
+            maxModelTurns: number;
+            maxToolFailures: number;
+            timeoutMs: number;
+        };
+    };
+};

package/dist/src/agent/orchestration/delegation-budget.js

@@ -0,0 +1,154 @@
+//#region src/agent/orchestration/delegation-budget.ts
+const DELEGATION_BUDGETS = {
+	light: {
+		maxToolCalls: 15,
+		maxTotalTokens: 5e4,
+		timeoutMs: 12e4
+	},
+	standard: {
+		maxToolCalls: 30,
+		maxTotalTokens: 1e5,
+		timeoutMs: 3e5
+	},
+	deep: {
+		maxToolCalls: 60,
+		maxTotalTokens: 2e5,
+		timeoutMs: 6e5
+	}
+};
+function resolveDelegationBudget(tier = "standard", maxIterations, timeoutMs) {
+	const preset = DELEGATION_BUDGETS[tier];
+	return {
+		tier,
+		limits: {
+			maxToolCalls: Math.min(60, Math.max(1, Math.floor(maxIterations ?? preset.maxToolCalls))),
+			maxTotalTokens: preset.maxTotalTokens,
+			maxModelTurns: Math.min(60, Math.max(1, Math.floor(maxIterations ?? preset.maxToolCalls))) + 1,
+			maxToolFailures: 5,
+			timeoutMs: Math.min(timeoutMs ?? preset.timeoutMs, preset.timeoutMs)
+		}
+	};
+}
+/** Reserve the last 20% for one tool-free handoff, without bypassing hard limits. */
+function createDelegationBudgetPolicy(budget, options, now = Date.now) {
+	const startedAt = now();
+	const usage = {
+		toolCalls: 0,
+		totalTokens: 0,
+		modelTurns: 0,
+		toolFailures: 0,
+		elapsedMs: 0
+	};
+	const limits = budget.limits;
+	let stopReason;
+	let stopMessage;
+	let handoffReason;
+	let handoffRequested = false;
+	let continuation;
+	let handoffRequestStarted = false;
+	const reasonAt = (ratio) => {
+		if (usage.totalTokens >= limits.maxTotalTokens * ratio) return "total_tokens";
+		if (now() - startedAt >= limits.timeoutMs * ratio) return "timeout";
+		if (usage.toolCalls >= limits.maxToolCalls * ratio) return "tool_calls";
+		if (usage.modelTurns >= limits.maxModelTurns * ratio) return "model_turns";
+		if (usage.toolFailures >= limits.maxToolFailures * ratio) return "tool_failures";
+	};
+	const handoff = () => `Delegation budget is approaching its ${handoffReason} limit. Do not call more tools. Return a concise handoff now: findings with file/line or source evidence, incomplete work, and precise next steps (including unread ranges). Do not claim the task is complete.`;
+	return {
+		policy: {
+			reset() {},
+			beforeModelRequest(signal) {
+				signal?.throwIfAborted();
+				const hard = reasonAt(1);
+				if (hard || stopReason) {
+					stopReason ??= hard;
+					return stopMessage ?? `Delegation stopped: ${stopReason}.`;
+				}
+				if (handoffRequested) {
+					if (handoffRequestStarted) {
+						stopReason = handoffReason;
+						return "Delegation handoff already attempted; no additional model request is permitted.";
+					}
+					handoffRequestStarted = true;
+				}
+			},
+			async beforeToolCall(context, signal) {
+				signal?.throwIfAborted();
+				if (options.isComplete?.()) return {
+					block: true,
+					reason: "The delegated result is already complete."
+				};
+				const hard = reasonAt(1);
+				if (hard) {
+					stopReason = hard;
+					return {
+						block: true,
+						terminate: true,
+						reason: `Sub-agent budget exhausted: ${hard}.`
+					};
+				}
+				if (handoffRequested) return {
+					block: true,
+					reason: handoff()
+				};
+				if (context.toolCall.name !== "data_batch") usage.toolCalls++;
+				const decision = await options.authorizeToolCall?.(context, signal);
+				if (decision?.block && decision.terminate) {
+					stopReason = "parent_policy";
+					stopMessage = decision.reason;
+				}
+				return decision;
+			},
+			async afterToolCall(context) {
+				if (context.isError) usage.toolFailures++;
+			},
+			shouldStopAfterTurn(context) {
+				usage.modelTurns++;
+				if (options.isComplete?.()) return true;
+				const hard = reasonAt(1);
+				if (hard || stopReason) {
+					stopReason ??= hard;
+					return true;
+				}
+				if (handoffRequested) {
+					stopReason = handoffReason;
+					return true;
+				}
+				const near = reasonAt(.8);
+				if (near && context.toolResults.length) {
+					handoffReason = near;
+					handoffRequested = true;
+					continuation = handoff();
+				}
+				return false;
+			},
+			takeContinuationMessage() {
+				const message = continuation;
+				continuation = void 0;
+				return message;
+			}
+		},
+		addTokens(tokens) {
+			usage.totalTokens += Math.max(0, tokens);
+		},
+		stop(reason, message) {
+			stopReason = reason;
+			stopMessage = message;
+		},
+		snapshot() {
+			return {
+				...budget,
+				usage: {
+					...usage,
+					elapsedMs: now() - startedAt
+				},
+				stopReason,
+				stopMessage,
+				handoffRequested,
+				handoffReason
+			};
+		}
+	};
+}
+//#endregion
+export { DELEGATION_BUDGETS, createDelegationBudgetPolicy, resolveDelegationBudget };

package/dist/src/agent/prompt/response-language.js

@@ -2,9 +2,9 @@ import { isXopcDatabaseOpen } from "../../storage/sqlite/connection.js";
 import { TaskRepository, init_task_repository } from "../../tasks/task-repository.js";
 import { getSessionConfig } from "../../storage/sqlite/config-repository.js";
 import { init_sqlite } from "../../storage/sqlite/index.js";
-import { init_response_language, resolveResponseLanguage } from "../../i18n/response-language.js";
-import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
 import { resolveTaskLocale } from "../../tasks/task-language.js";
+import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
+import { init_response_language, resolveResponseLanguage } from "../../i18n/response-language.js";
 //#region src/agent/prompt/response-language.ts
 init_response_language();
 init_sqlite();

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

@@ -130,7 +130,7 @@ function buildToolingSection(params) {
 	const hasPublishArtifacts = availableTools.has("publish_artifacts");
 	const hasXopcUse = availableTools.has("xopc_use");
 	const orchestrationLines = [];
-	if (hasDelegate) orchestrationLines.push("- Sub-agent delegation → use `delegate_task(goal, context?, mode?, capabilities?, toolset?)`. Default research inherits available read capabilities; pass necessary context explicitly. Use implement for isolated worktree changes. Check rejectedTools and partial results before relying on the answer.");
+	if (hasDelegate) orchestrationLines.push("- Sub-agent delegation → use `delegate_task(goal, context?, mode?, capabilities?, toolset?, budgetTier?, maxIterations?)`. Choose light for narrow lookups, standard for bounded research, and deep for broader investigations. Supply relevant facts and a clear stopping condition; search before reading targeted chunks. Default research inherits available read capabilities. Use implement for isolated worktree changes. Inspect stopReason, budget usage, handoff and rejectedTools; resume incomplete work from the handoff rather than repeating the investigation.");
 	if (hasWorkflow) orchestrationLines.push("- Multi-phase workflows → use `workflow` to start persisted runs with subagents when a script defines phases.");
 	return [
 		"## Tooling",