@compilr-dev/sdk 0.10.29 → 0.10.31

package/dist/delegation.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shared delegation defaults for tool result auto-summarization.
+ *
+ * `DelegationConfig` controls when large tool results get summarized
+ * by a delegate agent (instead of being inlined into the conversation
+ * context) — a per-turn token economy win that the agents library wires
+ * via the AfterToolHook.
+ *
+ * Each host (CLI, Desktop) used to keep its own copy of this config.
+ * The two had drifted: identical baselines (8000 default threshold etc.)
+ * but diverged tool overrides — Desktop had 6 extra tools tuned
+ * (run_tests, run_lint, run_build, web_fetch, artifact_get,
+ * find_references, propose_alternatives) plus a tighter `git_diff`
+ * threshold (4000 vs CLI's 6000). The baseline below converges to
+ * Desktop's set since it's the more recently tuned version, and hosts
+ * spread + override per-tool as needed.
+ *
+ * Audit ref: TODO-13.
+ */
+import type { DelegationConfig } from '@compilr-dev/agents';
+export declare const DEFAULT_DELEGATION_CONFIG: DelegationConfig;

package/dist/delegation.js

@@ -0,0 +1,49 @@
+/**
+ * Shared delegation defaults for tool result auto-summarization.
+ *
+ * `DelegationConfig` controls when large tool results get summarized
+ * by a delegate agent (instead of being inlined into the conversation
+ * context) — a per-turn token economy win that the agents library wires
+ * via the AfterToolHook.
+ *
+ * Each host (CLI, Desktop) used to keep its own copy of this config.
+ * The two had drifted: identical baselines (8000 default threshold etc.)
+ * but diverged tool overrides — Desktop had 6 extra tools tuned
+ * (run_tests, run_lint, run_build, web_fetch, artifact_get,
+ * find_references, propose_alternatives) plus a tighter `git_diff`
+ * threshold (4000 vs CLI's 6000). The baseline below converges to
+ * Desktop's set since it's the more recently tuned version, and hosts
+ * spread + override per-tool as needed.
+ *
+ * Audit ref: TODO-13.
+ */
+export const DEFAULT_DELEGATION_CONFIG = {
+    enabled: true,
+    delegationThreshold: 8000,
+    summaryMaxTokens: 800,
+    resultTTL: 600_000,
+    maxStoredResults: 50,
+    strategy: 'auto',
+    toolOverrides: {
+        // Bash often produces large output; allow a higher inline budget
+        // before summarising.
+        bash: { threshold: 12000 },
+        grep: { threshold: 4000 },
+        // Large-output tools — tighter thresholds for earlier summarisation
+        git_diff: { threshold: 4000 },
+        run_tests: { threshold: 6000 },
+        run_lint: { threshold: 4000 },
+        run_build: { threshold: 6000 },
+        web_fetch: { threshold: 6000 },
+        artifact_get: { threshold: 6000 },
+        find_references: { threshold: 4000 },
+        // Disable delegation on small / interactive / read-only tools where
+        // the round-trip cost would exceed the saving.
+        get_tool_info: { enabled: false },
+        list_tools: { enabled: false },
+        ask_user: { enabled: false },
+        ask_user_simple: { enabled: false },
+        propose_alternatives: { enabled: false },
+        todo_read: { enabled: false },
+    },
+};

package/dist/index.d.ts

@@ -81,6 +81,7 @@ export { defineTool, createSuccessResult, createErrorResult, mergeHooks, createL
 export type { Tool, HooksConfig, AgentEvent, Message, LLMProvider, AnchorInput, ToolExecutionResult, AgentRunResult, PermissionHandler, PermissionHandlerResponse, ToolPermission, AgentTypeConfig, GuardrailTriggeredHandler, BeforeLLMHookResult, BeforeToolHook, BeforeToolHookResult, AfterToolHook, AgentState, AgentConfig, SessionInfo, Anchor, AnchorScope, AnchorClearOptions, AnchorPriority, AnchorQueryOptions, FileAccessType, FileAccess, GuardrailResult, GuardrailContext, MCPClient, MCPToolDefinition, } from '@compilr-dev/agents';
 export { DEFAULT_PERMISSION_RULES, findMatchingRule, permissionModeLabel, permissionLevelLabel, } from './permissions.js';
 export type { PermissionRule, PermissionMode, PermissionLevel } from './permissions.js';
+export { DEFAULT_DELEGATION_CONFIG } from './delegation.js';
 export { readMCPConfigFile, writeMCPConfigFile, resolveServerEntry, loadMCPServers, saveMCPServerEntry, deleteMCPServerEntry, getServerNames, } from './mcp-config.js';
 export type { MCPServerEntry, MCPConfigFile, ResolvedMCPServer } from './mcp-config.js';
 export { generateProject, isGitConfigured, generateCompilrMd, generateConfigJson, generateReadmeMd, generateCodingStandardsMd, generatePackageJson, generateTsconfig, generateGitignore, generateCompilrMdForImport, detectProjectInfo, detectGitInfo, prettifyName, getLanguageLabel, getFrameworkLabel, validateImportPath, isValidProjectName, projectExists, TECH_STACK_LABELS, CODING_STANDARDS_LABELS, REPO_PATTERN_LABELS, WORKFLOW_VERSION, } from './project-generator/index.js';

package/dist/index.js

@@ -198,6 +198,10 @@ AgentError, ProviderError, ToolError, ToolTimeoutError, MaxIterationsError, Abor
 // =============================================================================
 export { DEFAULT_PERMISSION_RULES, findMatchingRule, permissionModeLabel, permissionLevelLabel, } from './permissions.js';
 // =============================================================================
+// Shared Delegation Config Defaults
+// =============================================================================
+export { DEFAULT_DELEGATION_CONFIG } from './delegation.js';
+// =============================================================================
 // Shared MCP Configuration
 // =============================================================================
 export { readMCPConfigFile, writeMCPConfigFile, resolveServerEntry, loadMCPServers, saveMCPServerEntry, deleteMCPServerEntry, getServerNames, } from './mcp-config.js';

package/dist/presets/coding.js

@@ -1,7 +1,12 @@
 /**
  * Coding preset — batteries-included for software development
  */
-import { readFileTool, writeFileTool, editTool, bashTool, bashOutputTool, killShellTool, grepTool, globTool, createTodoTools, getDefaultTodoStore, webFetchTool, suggestTool, } from '@compilr-dev/agents';
+import { readFileTool, writeFileTool, editTool, createBashTool, bashOutputTool, killShellTool, grepTool, globTool, createTodoTools, getDefaultTodoStore, webFetchTool, suggestTool, } from '@compilr-dev/agents';
+// 120s default — long-running coding commands (npm run build, pytest -k …,
+// large test suites, factory scaffolds) frequently exceed the agents-library
+// default of 60s. Audit TODO-2 fix: applied at the preset layer so both CLI
+// and Desktop inherit the same value without each host having to override.
+const bashTool = createBashTool({ timeout: 120000 });
 import { allCodingTools, unifiedTools, ts, python, go } from '@compilr-dev/agents-coding';
 import { createLenientTodoWriteTool, createLenientTodoClaimTool, createLenientTodoHandoffTool, } from './lenient-todo.js';
 const CODING_SYSTEM_PROMPT = `You are a skilled software engineer. You help users with coding tasks including:

package/dist/presets/general.js

@@ -5,7 +5,9 @@
  * The project-type-specific identity comes from the systemPromptSection
  * in the ProjectTypeConfig, not from the preset.
  */
-import { readFileTool, writeFileTool, editTool, bashTool, bashOutputTool, killShellTool, grepTool, globTool, createTodoTools, getDefaultTodoStore, webFetchTool, suggestTool, } from '@compilr-dev/agents';
+import { readFileTool, writeFileTool, editTool, createBashTool, bashOutputTool, killShellTool, grepTool, globTool, createTodoTools, getDefaultTodoStore, webFetchTool, suggestTool, } from '@compilr-dev/agents';
+// 120s default — see coding preset for full rationale (audit TODO-2).
+const bashTool = createBashTool({ timeout: 120000 });
 import { createLenientTodoWriteTool, createLenientTodoClaimTool, createLenientTodoHandoffTool, } from './lenient-todo.js';
 const GENERAL_SYSTEM_PROMPT = `You are a versatile AI assistant. You adapt your approach to the user's needs and project context.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.10.29",
+  "version": "0.10.31",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",