@xopcai/xopc 0.0.382 → 0.0.384

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

@@ -12,8 +12,32 @@ 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: {
+			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 +52,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 +77,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 +98,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 +130,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 +158,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 +186,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 +218,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 +265,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 +280,8 @@ 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 } : {},
 			...starter.toolAllowlist ? { toolAllowlist: starter.toolAllowlist } : {},

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

@@ -7,8 +7,8 @@ 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 { 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";

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

@@ -2,6 +2,7 @@ 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";
@@ -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/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/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;
@@ -111,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

@@ -11,9 +11,9 @@ import { init_sqlite } from "../../storage/sqlite/index.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.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 { LOCAL_READ_MAX_CHARS } from "./local-read-budget.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";
@@ -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,6 +314,7 @@ var AgentToolsFactory = class AgentToolsFactory {
 		const grep = createGrepTool(workspace);
 		const find = createFindTool(workspace);
 		const productToolDeps = {
+			getAgentToolAvailability: this.deps.getAgentToolAvailability ?? ((candidateId, name) => this.getAgentToolAvailability(candidateId, name)),
 			getAgentSkillAvailability: this.deps.getAgentSkillAvailability,
 			getWorkspace: () => this.deps.workspace,
 			getConfig: () => this.deps.getConfig?.(),
@@ -616,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/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

@@ -2,6 +2,7 @@ import { getSqliteDatabase, init_transaction } from "../../storage/sqlite/transa
 import { init_session_instance_repository, readCurrentTranscriptId } from "../../storage/sqlite/session-instance-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
 				};
 			}