@xopcai/xopc 0.0.383 → 0.0.384

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

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

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

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

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

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_workspace_defaults, resolveDefaultAgentWorkspaceDir } from "../../config/workspace-defaults.js";
-import { init_providers, resolveModel } from "../../providers/index.js";
 import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
+import { init_providers, resolveModel } from "../../providers/index.js";
 import { getExecutionEnvironmentForSession } from "../../execution-environments/subject.js";
 import { effectiveWorkspacePathForSession, projectWorkspacePath } from "../../session/session-workspace.js";
 import { getProjectForSession } from "../../projects/workspace.js";

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

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

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

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

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

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

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

@@ -2,17 +2,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 { resolveTaskLocale } from "../../tasks/task-language.js";
-import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
-import { TaskApplicationService } from "../../tasks/task-application-service.js";
+import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { getApiKey, init_providers, resolveModel } from "../../providers/index.js";
-import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../../providers/model-response.js";
 import { completeWithResolvedCredentials } from "../../providers/model-call.js";
-import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
+import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../../providers/model-response.js";
+import { resolveTaskLocale } from "../../tasks/task-language.js";
+import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
 import { readWorkspaceRevision } from "../coding/workspace-revision.js";
 import { buildResponseLanguageSection } from "../prompt/sections/response-language.js";
 import { resolveResponseLanguageForSession } from "../prompt/response-language.js";
+import { 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 { resolveGatewayEffectiveHost } from "../../config/gateway-bind.js";
-import { resolveReverseProxyPublicUrl } from "../../gateway/public-url.js";
-import { resolvePathUnderWorkspace } from "./tool-paths.js";
 import { assertWorkspaceTreeReadable, checkedFilePath } from "../sandbox/fileAccess.js";
+import { resolvePathUnderWorkspace } from "./tool-paths.js";
+import { resolveGatewayEffectiveHost } from "../../config/gateway-bind.js";
 import { resolveShareConfig } from "../../share/share-config.js";
 import { mergeWithDefaults } from "../../share/site-share-config.js";
 import { getShareStore } from "../../share/share-store.js";
 import { getSiteShareStore } from "../../share/site-share-store.js";
 import { resolveShareUrl, resolveSiteShareUrl } from "../../share/share-url.js";
 import { publishHostedStaticSite } from "../../share/hosted-static-site-publish.js";
+import { resolveReverseProxyPublicUrl } from "../../gateway/public-url.js";
 import { audienceDefaults, decideShareKind, makeDescription, makeTitle, probeShareTarget, rememberStagedSite, stageSingleHtmlAsSite } from "../../share/share-auto.js";
 import { scheduleThumbnail } from "../../share/share-thumbnail.js";
 import { resolveToolLocale, shareToolErrorLine, shareToolSuccessLines } from "../../i18n/share-tool-bundle.js";

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

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

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

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

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

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

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

@@ -7,7 +7,7 @@ import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/exec-command.ts
 const DEFAULT_MAX_OUTPUT_CHARS = 5e4;
 const ExecCommandSchema = Type.Object({
-	cmd: Type.String({ description: "Shell command to execute." }),
+	cmd: Type.String({ description: "Command for the default platform shell: /bin/sh on Unix and in Docker; cmd.exe on Windows hosts. Use portable syntax, or invoke an installed shell explicitly for shell-specific features." }),
 	cwd: Type.Optional(Type.String({ description: "Working directory. Relative paths are resolved under the agent workspace." })),
 	timeoutMs: Type.Optional(Type.Number({ description: "Command timeout in milliseconds. Defaults to 1800000 (30m) and is capped at 14400000 (4h)." })),
 	maxOutputChars: Type.Optional(Type.Number({ description: "Maximum characters returned to the model. UI streaming still receives output deltas." })),
@@ -28,6 +28,7 @@ function commandFailureHint(details) {
 	if (details.status === "success" || details.status === "running") return void 0;
 	if (details.status === "cancelled") return "The command was cancelled. Inspect its partial output before deciding whether to restart.";
 	if (details.status === "timed_out") return "The command timed out. Re-run a narrower command, increase timeoutMs if the long run is expected, or inspect partial output before retrying.";
+	if (details.exitCode !== 0 && /(?:\/bin\/sh|\bsh:).*syntax error|bad substitution/i.test(details.stderr)) return "The default shell rejected the syntax. Use portable POSIX sh commands or invoke an installed bash explicitly for Bash-only features such as process substitution. Inspect stderr, fix the command, then rerun it.";
 	if (details.exitCode !== 0 && details.stderr.trim()) return "The command failed. Inspect stderr first, fix the underlying issue, then re-run the narrowest relevant verification command.";
 	if (details.exitCode !== 0 && details.stdout.trim()) return "The command failed. Inspect stdout for the failure location, then re-run the narrowest relevant verification command.";
 	return "The command failed without output. Verify the command, cwd, and required dependencies before retrying.";
@@ -54,6 +55,7 @@ function createExecCommandTool(workspaceCwd, options) {
 		name: "exec_command",
 		description: [
 			"Run shell commands for code inspection, builds, tests, type checks, and verification.",
+			"Unix and Docker use /bin/sh, not your interactive shell. Do not use Bash process substitution <(...) or other Bash-only syntax unless invoking an installed bash explicitly. Prefer separate portable commands or a script file. Windows hosts use cmd.exe.",
 			"Use apply_patch for file edits; do not edit files by shell redirection unless explicitly necessary.",
 			"Relative cwd values resolve under the current agent workspace.",
 			"When the command creates final user-facing files, declare all final paths in outputs so they are persisted with this command."

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

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

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

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

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

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

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

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

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

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

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

@@ -1,13 +1,8 @@
-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";
@@ -31,6 +26,11 @@ 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 { resolvePathUnderWorkspace } from "./tool-paths.js";
 import { checkedFilePath } from "../sandbox/fileAccess.js";
+import { resolvePathUnderWorkspace } from "./tool-paths.js";
 import { readdir } from "fs/promises";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/list-dir.ts

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

@@ -2,6 +2,8 @@ import type { AgentTool } from '@earendil-works/pi-agent-core';
 import type { Config } from '../../config/schema.js';
 declare const schema: import("@sinclair/typebox").TObject<{
     command: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"list">, import("@sinclair/typebox").TLiteral<"follow">, import("@sinclair/typebox").TLiteral<"pause">, import("@sinclair/typebox").TLiteral<"end">, import("@sinclair/typebox").TLiteral<"resume">, import("@sinclair/typebox").TLiteral<"settings">, import("@sinclair/typebox").TLiteral<"interests">, import("@sinclair/typebox").TLiteral<"feedback">, import("@sinclair/typebox").TLiteral<"rollback">]>;
+    offset: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
     id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     subject: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     summary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;

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

@@ -1,7 +1,8 @@
 import { getSqliteDatabase, init_transaction } from "../../storage/sqlite/transaction.js";
 import { init_session_instance_repository, readCurrentTranscriptId } from "../../storage/sqlite/session-instance-repository.js";
-import { getPersonalAgentByConversation } from "../../personal-agent/repository.js";
 import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
+import { getPersonalAgentByConversation } from "../../personal-agent/repository.js";
+import { boundedPersonalResult } from "./personal-result-budget.js";
 import { parseLocalCheckTime } from "../../personal-agent/proactivity/follow-up-request.js";
 import { applyThreadFeedback, getAttention, getProactivitySettings, listAttention, listInterestCandidates, patchAttention, patchProactivitySettings, rollbackStrategy, saveAttention, strategyState, userText } from "../../personal-agent/proactivity/repository.js";
 import { Type } from "@sinclair/typebox";
@@ -20,6 +21,11 @@ const schema = Type.Object({
 		Type.Literal("feedback"),
 		Type.Literal("rollback")
 	]),
+	offset: Type.Optional(Type.Integer({ minimum: 0 })),
+	limit: Type.Optional(Type.Integer({
+		minimum: 1,
+		maximum: 20
+	})),
 	id: Type.Optional(Type.String()),
 	subject: Type.Optional(Type.String({ maxLength: 160 })),
 	summary: Type.Optional(Type.String({ maxLength: 1600 })),
@@ -39,6 +45,35 @@ const schema = Type.Object({
 	])),
 	preparation: Type.Optional(Type.Union([Type.Literal("brief"), Type.Literal("thorough")])),
 	versionId: Type.Optional(Type.String({ description: "Latest strategy version ID returned by list; required for rollback." }))
+}, {
+	additionalProperties: false,
+	anyOf: [
+		{ properties: { command: { enum: [
+			"list",
+			"settings",
+			"interests"
+		] } } },
+		{
+			properties: { command: { const: "follow" } },
+			required: ["subject"]
+		},
+		{
+			properties: { command: { enum: [
+				"pause",
+				"end",
+				"resume"
+			] } },
+			required: ["id"]
+		},
+		{
+			properties: { command: { const: "feedback" } },
+			required: ["id", "feedback"]
+		},
+		{
+			properties: { command: { const: "rollback" } },
+			required: ["id", "versionId"]
+		}
+	]
 });
 function createPersonalAttentionTool(deps) {
 	return {
@@ -59,30 +94,29 @@ function createPersonalAttentionTool(deps) {
 				}],
 				details: {}
 			};
-			if (input.command === "interests") {
-				if (!resolveUserContextSessionAccess(config, conversationId).userModel) throw new Error("Interest access is unavailable");
+			if (input.command === "interests" || input.command === "list") {
+				if (input.command === "interests" && !resolveUserContextSessionAccess(config, conversationId).userModel) throw new Error("Interest access is unavailable");
+				const rows = input.command === "interests" ? listInterestCandidates(conversationId) : listAttention(conversationId).map((thread) => ({
+					id: thread.id,
+					subject: thread.subject,
+					status: thread.status,
+					nextCheckAt: thread.next_check_at,
+					revision: thread.revision,
+					strategy: strategyState(thread.id)
+				}));
+				const offset = input.offset ?? 0;
 				return {
 					content: [{
 						type: "text",
-						text: JSON.stringify(listInterestCandidates(conversationId))
+						text: JSON.stringify(boundedPersonalResult({
+							items: rows.slice(offset, offset + (input.limit ?? 10)),
+							total: rows.length,
+							offset
+						}))
 					}],
 					details: {}
 				};
 			}
-			if (input.command === "list") return {
-				content: [{
-					type: "text",
-					text: JSON.stringify(listAttention(conversationId).map((thread) => ({
-						id: thread.id,
-						subject: thread.subject,
-						status: thread.status,
-						nextCheckAt: thread.next_check_at,
-						revision: thread.revision,
-						strategy: strategyState(thread.id)
-					})))
-				}],
-				details: {}
-			};
 			const db = getSqliteDatabase();
 			const transcriptId = readCurrentTranscriptId(db, conversationId);
 			const source = db.prepare("SELECT entry_id,payload_json FROM transcript_entries WHERE transcript_id = ? AND role = 'user' ORDER BY seq DESC LIMIT 1").get(transcriptId);

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

@@ -20,6 +20,12 @@ const schema = Type.Object({
 		minimum: 1,
 		maximum: 10
 	}))
+}, {
+	additionalProperties: false,
+	anyOf: [{ properties: { command: { const: "list" } } }, {
+		properties: { command: { const: "get" } },
+		required: ["id"]
+	}]
 });
 const fields = [
 	"id",
@@ -52,11 +58,15 @@ function compact(value, textLimit) {
 			result[key] = entry.slice(0, textLimit);
 			if (entry.length > textLimit) truncatedFields.push(key);
 		} else if (typeof entry === "number" || typeof entry === "boolean" || entry === null) result[key] = entry;
-		else if (entry && typeof entry === "object" && !Array.isArray(entry)) result[key] = Object.fromEntries(Object.entries(entry).slice(0, 12).filter(([, item]) => [
-			"string",
-			"number",
-			"boolean"
-		].includes(typeof item) || item === null).map(([field, item]) => [field, typeof item === "string" ? item.slice(0, 200) : item]));
+		else if (entry && typeof entry === "object" && !Array.isArray(entry)) {
+			const nested = Object.entries(entry);
+			if (nested.length > 12 || nested.some(([, item]) => typeof item === "string" && item.length > 200 || item !== null && typeof item === "object")) truncatedFields.push(key);
+			result[key] = Object.fromEntries(nested.slice(0, 12).filter(([, item]) => [
+				"string",
+				"number",
+				"boolean"
+			].includes(typeof item) || item === null).map(([field, item]) => [field, typeof item === "string" ? item.slice(0, 200) : item]));
+		} else if (Array.isArray(entry)) truncatedFields.push(key);
 	}
 	if (truncatedFields.length) result.truncatedFields = truncatedFields;
 	return result;
@@ -119,7 +129,7 @@ function createPersonalReadTool(deps) {
 					items: selected.map((row) => compact(row, 200)),
 					offset,
 					total: result.total ?? rows.length,
-					nextOffset: selected.length === limit ? offset + selected.length : void 0,
+					nextOffset: offset + selected.length < Number(result.total ?? rows.length) ? offset + selected.length : void 0,
 					excerpts: true
 				};
 			}