@wrongstack/core 0.1.9 → 0.2.0

package/dist/tool-executor-CYdZdtno.d.ts

@@ -0,0 +1,97 @@
+import { a0 as Context, h as ProviderError, u as Tool, D as ToolUseBlock, z as ToolResultBlock } from './context-u0bryklF.js';
+import { C as Compactor, a as CompactReport } from './compactor-DSl2FK7a.js';
+import { R as RecoveryDecision, E as ErrorHandler, c as RetryPolicy } from './skill-Bx8jxznf.js';
+import { M as ModelsRegistry } from './models-registry-Y2xbog0E.js';
+import { h as ToolExecutorOptions, i as ToolExecutorStrategy, j as ToolBatchResult } from './plugin-CoYYZKdn.js';
+
+interface CompactorOptions {
+    preserveK?: number;
+    eliseThreshold?: number;
+    estimator?: (text: string) => number;
+}
+declare class HybridCompactor implements Compactor {
+    private readonly preserveK;
+    private readonly eliseThreshold;
+    private readonly estimator;
+    constructor(opts?: CompactorOptions);
+    compact(ctx: Context, opts?: {
+        aggressive?: boolean;
+    }): Promise<CompactReport>;
+    private eliseOldToolResults;
+    private collapseAncientTurns;
+    private estimateMessages;
+}
+
+/**
+ * Tiered error recovery strategies.
+ * Each strategy is attempted in order until one returns a decision.
+ */
+interface RecoveryStrategy {
+    /** Human-readable label for logs. */
+    label: string;
+    /** Optional compactor for context_overflow recovery. */
+    compactor?: Compactor;
+    /** Returns an explicit recovery decision, or null to fall through. */
+    attempt: (err: unknown, ctx: Context) => Promise<RecoveryDecision | null>;
+}
+/**
+ * Builds the ordered list of recovery strategies used by DefaultErrorHandler.
+ * Exported so callers can customise or extend the strategy chain.
+ */
+declare function buildRecoveryStrategies(opts?: {
+    compactor?: Compactor;
+    modelsRegistry?: ModelsRegistry;
+}): RecoveryStrategy[];
+declare const DEFAULT_RECOVERY_STRATEGIES: RecoveryStrategy[];
+declare class DefaultErrorHandler implements ErrorHandler {
+    private readonly strategies;
+    constructor(strategies?: RecoveryStrategy[]);
+    classify(err: unknown): {
+        kind: 'rate_limit' | 'overloaded' | 'server' | 'client' | 'network' | 'abort' | 'context_overflow' | 'unknown';
+        retryable: boolean;
+    };
+    recover(err: unknown, ctx: Context): Promise<RecoveryDecision | null>;
+}
+
+declare class DefaultRetryPolicy implements RetryPolicy {
+    private static readonly NETWORK_ERR_RE;
+    shouldRetry(err: Error | ProviderError, attempt: number): boolean;
+    maxAttempts(err: Error | ProviderError): number;
+    delayMs(attempt: number): number;
+}
+
+declare class ToolExecutor {
+    private readonly registry;
+    private readonly opts;
+    private readonly serializer;
+    private readonly iterationTimeoutMs;
+    constructor(registry: {
+        get(name: string): Tool | undefined;
+        list(): Tool[];
+    }, opts: ToolExecutorOptions);
+    /**
+     * Execute a batch of tool uses using the configured strategy.
+     * Returns the execution results and the remaining output budget.
+     */
+    executeBatch(toolUses: ToolUseBlock[], ctx: Context, strategy: ToolExecutorStrategy): Promise<ToolBatchResult>;
+    /**
+     * Execute a single tool with timeout, permission check, and output capping.
+     * Emits `tool.started` via the injected EventBus (if any) right before
+     * invoking the tool — closes the observability gap between "model decided
+     * to call a tool" and "tool.executed".
+     */
+    executeTool(tool: Tool, use: ToolUseBlock, ctx: Context, budget: number): Promise<ToolResultBlock>;
+    private runWithTimeout;
+    private runStreamedTool;
+    private unknownToolResult;
+    private deniedResult;
+    private decrementBudget;
+    /**
+     * Compute the suggestedPattern string for a tool+input pair.
+     * Matches the logic in DefaultPermissionPolicy so the TUI shows the
+     * same subject that the trust file would use.
+     */
+    private subjectFor;
+}
+
+export { type CompactorOptions as C, DefaultErrorHandler as D, HybridCompactor as H, type RecoveryStrategy as R, ToolExecutor as T, DefaultRetryPolicy as a, DEFAULT_RECOVERY_STRATEGIES as b, buildRecoveryStrategies as c };

package/dist/types/index.d.ts

@@ -1,4 +1,26 @@
-export { A as AgentError, C as CacheStats, a as Capabilities, b as ConfigError, c as ContentBlock, E as ErrorCode, d as ErrorSeverity, e as ErrorSubsystem, I as ImageBlock, J as JSONSchema, M as Message, f as MessageRole, P as Permission, g as PluginError, h as Provider, i as ProviderError, j as ProviderErrorBody, R as Request, k as Response, l as ResumedSession, S as SessionData, m as SessionError, n as SessionEvent, o as SessionMetadata, p as SessionStore, q as SessionSummary, r as SessionWriter, s as StopReason, t as StreamEvent, T as TextBlock, u as TokenCounter, v as Tool, w as ToolCallContext, x as ToolError, y as ToolFinalEvent, z as ToolProgressEvent, B as ToolResultBlock, D as ToolStreamEvent, F as ToolUseBlock, U as Usage, W as WrongStackError, G as asBlocks, H as asText, K as isAgentError, L as isConfigError, N as isImageBlock, O as isPluginError, Q as isSessionError, V as isTextBlock, X as isToolError, Y as isToolResultBlock, Z as isToolUseBlock, _ as isWrongStackError, $ as toWrongStackError } from '../provider-txgB0Oq9.js';
-export { C as CompactReport, a as Compactor, b as Config, c as ConfigLoader, d as ConfigStore, e as ContextConfig, D as DEFAULT_MODES, E as ErrorHandler, F as FeaturesConfig, I as InputReader, L as LogConfig, f as LogLevel, g as Logger, M as MCPServerConfig, h as MemoryEntry, i as MemoryScope, j as MemoryStore, k as Mode, l as ModeConfig, m as ModeManifest, n as ModeStore, o as ModelsDevModel, p as ModelsDevPayload, q as ModelsDevProvider, r as ModelsRegistry, P as PathResolver, s as PermissionDecision, t as PermissionPolicy, u as PluginConfig, v as PromptOption, w as ProviderApiKey, x as ProviderConfig, R as RecoveryDecision, y as Renderer, z as ResolvedModel, A as ResolvedProvider, B as RetryPolicy, S as SecretScrubber, G as SkillEntry, H as SkillLoader, J as SkillManifest, T as ToolsConfig, K as TrustPolicy, W as WireFamily } from '../mode-Pjt5vMS6.js';
-export { A as AddAttachmentInput, a as AgentBridge, b as AgentBridgeConfig, c as AggregateHealth, d as Attachment, e as AttachmentKind, f as AttachmentMeta, g as AttachmentRef, h as AttachmentStore, B as BridgeMessage, i as BridgeMessageType, j as BridgeTransport, C as ConfirmAwaiter, k as CoordinatorEvents, l as CoordinatorStatus, m as CriticalPathResult, D as DEFAULT_SPEC_TEMPLATE, n as DefaultSessionReaderOptions, o as DoneCondition, E as ENCRYPTED_PREFIX, H as HealthCheck, p as HealthCheckResult, q as HealthRegistry, r as HealthStatus, M as MCPRegistryView, s as MetricLabels, t as MetricSeries, u as MetricsSink, v as MetricsSnapshot, w as MultiAgentConfig, x as MultiAgentCoordinator, P as Plugin, y as PluginAPI, z as PluginCapabilities, F as PluginDependency, G as PluginPipelines, I as ProviderFactory, J as ProviderRegistryView, S as SecretVault, K as SessionEventType, L as SessionExportOptions, N as SessionQuery, O as SessionReader, Q as SessionSearchHit, R as SessionSearchQuery, T as SessionSummaryLite, U as SlashCommand, V as SlashCommandRegistryView, W as Span, X as SpawnResult, Y as SpecAnalysis, Z as SpecApiEndpoint, _ as SpecRequirement, $ as SpecSection, a0 as SpecSectionType, a1 as SpecStatus, a2 as SpecTemplate, a3 as SpecValidationResult, a4 as Specification, a5 as SubagentConfig, a6 as SubagentContext, a7 as SubagentRunContext, a8 as SubagentRunOutcome, a9 as SubagentRunner, aa as TaskAssignment, ab as TaskDelegation, ac as TaskDependency, ad as TaskEdge, ae as TaskFilter, af as TaskGraph, ag as TaskNode, ah as TaskPriority, ai as TaskProgress, aj as TaskResult, ak as TaskSort, al as TaskSpec, am as TaskStatus, an as TaskType, ao as ToolBatchResult, ap as ToolConfirmPendingResult, aq as ToolExecution, ar as ToolExecutionOutput, as as ToolExecutorInit, at as ToolExecutorOptions, au as ToolExecutorStrategy, av as ToolRegistryView, aw as Tracer, ax as computeTaskProgress, ay as findCriticalPath, az as topologicalSort } from '../session-reader-9sOTgmeC.js';
-export { B as BuildContext, M as ModelCapabilities, S as SystemPromptBuilder } from '../system-prompt-vAB0F54-.js';
+export { A as AgentError, C as Capabilities, a as ConfigError, b as ContentBlock, E as ErrorCode, c as ErrorSeverity, d as ErrorSubsystem, I as ImageBlock, J as JSONSchema, M as Message, e as MessageRole, P as Permission, f as PluginError, g as Provider, h as ProviderError, i as ProviderErrorBody, R as Request, j as Response, k as ResumedSession, S as SessionData, l as SessionError, m as SessionEvent, n as SessionMetadata, o as SessionStore, p as SessionSummary, q as SessionWriter, r as StopReason, s as StreamEvent, T as TextBlock, t as ThinkingBlock, u as Tool, v as ToolCallContext, w as ToolError, x as ToolFinalEvent, y as ToolProgressEvent, z as ToolResultBlock, B as ToolStreamEvent, D as ToolUseBlock, U as Usage, W as WrongStackError, F as asBlocks, G as asText, H as isAgentError, K as isConfigError, L as isImageBlock, N as isPluginError, O as isSessionError, Q as isTextBlock, V as isThinkingBlock, X as isToolError, Y as isToolResultBlock, Z as isToolUseBlock, _ as isWrongStackError, $ as toWrongStackError } from '../context-u0bryklF.js';
+export { C as Config, a as ConfigLoader, b as ConfigStore, c as ContextConfig, F as FeaturesConfig, L as LogConfig, M as MCPServerConfig, P as PluginConfig, d as ProviderApiKey, e as ProviderConfig, T as ToolsConfig } from '../config-DXrqb41m.js';
+export { P as PermissionDecision, a as PermissionPolicy, T as TrustPolicy } from '../secret-scrubber-3TLUkiCV.js';
+export { A as AddAttachmentInput, a as Attachment, b as AttachmentKind, c as AttachmentMeta, d as AttachmentRef, e as AttachmentStore, D as DefaultSessionReader } from '../session-reader-C3x96CDR.js';
+export { D as DefaultSecretScrubber, a as DefaultSecretVault, S as SecretVaultOptions, d as decryptConfigSecrets, e as encryptConfigSecrets, m as migratePlaintextSecrets, r as rewriteConfigEncrypted } from '../secret-scrubber-CwYliRWd.js';
+export { D as DefaultLogger, a as DefaultLoggerOptions } from '../logger-BH6AE0W9.js';
+export { D as DefaultPathResolver, a as DefaultTokenCounter } from '../path-resolver-Crkt8wTQ.js';
+export { M as MemoryEntry, a as MemoryScope, b as MemoryStore } from '../memory-CEXuo7sz.js';
+export { C as CompactorOptions, b as DEFAULT_RECOVERY_STRATEGIES, D as DefaultErrorHandler, a as DefaultRetryPolicy, H as HybridCompactor, R as RecoveryStrategy, T as ToolExecutor, c as buildRecoveryStrategies } from '../tool-executor-CYdZdtno.js';
+export { S as SkillEntry, a as SkillLoader, b as SkillManifest } from '../skill-Bx8jxznf.js';
+export { B as BuildContext, M as ModelCapabilities, S as SystemPromptBuilder } from '../system-prompt-CG9jU5-5.js';
+export { R as Renderer } from '../renderer-0A2ZEtca.js';
+export { I as InputReader, P as PromptOption } from '../input-reader-E-ffP2ee.js';
+export { M as MCPRegistryView, P as Plugin, a as PluginAPI, b as PluginCapabilities, c as PluginDependency, d as PluginPipelines, e as ProviderFactory, f as ProviderRegistryView, S as SlashCommand, g as SlashCommandRegistryView, T as ToolRegistryView } from '../plugin-CoYYZKdn.js';
+export { D as DefaultModelsRegistry, a as DefaultModelsRegistryOptions, c as classifyFamily } from '../models-registry-DqzwpBQy.js';
+export { D as DEFAULT_MODES, M as Mode, a as ModeConfig, b as ModeManifest, c as ModeStore } from '../mode-CV077NjV.js';
+export { I as InMemoryAgentBridge, a as InMemoryBridgeTransport, c as createMessage } from '../agent-bridge-DmBiCipY.js';
+export { C as CoordinatorEvents, d as CoordinatorStatus, D as DoneCondition, M as MultiAgentConfig, e as MultiAgentCoordinator, f as SpawnResult, g as SubagentConfig, h as SubagentContext, i as SubagentError, j as SubagentErrorKind, k as SubagentRunContext, l as SubagentRunOutcome, m as SubagentRunner, T as TaskDelegation, n as TaskResult, o as TaskSpec } from '../multi-agent-BDfkxL5C.js';
+export { C as CriticalPathResult, D as DEFAULT_SPEC_TEMPLATE, S as SpecAnalysis, a as SpecApiEndpoint, b as SpecRequirement, c as SpecSection, d as SpecSectionType, e as SpecStatus, f as SpecTemplate, g as SpecValidationResult, h as Specification, T as TaskAssignment, i as TaskDependency, j as TaskEdge, k as TaskFilter, l as TaskGraph, m as TaskNode, n as TaskPriority, o as TaskProgress, p as TaskSort, q as TaskStatus, r as TaskType, s as computeTaskProgress, t as findCriticalPath, u as topologicalSort } from '../task-graph-BITvWt4t.js';
+export { A as AggregateHealth, H as HealthCheck, a as HealthCheckResult, b as HealthRegistry, c as HealthStatus, M as MetricLabels, d as MetricSeries, e as MetricsSink, f as MetricsSnapshot, S as Span, T as Tracer } from '../observability-BhnVLBLS.js';
+import '../models-registry-Y2xbog0E.js';
+import '../secret-vault-DoISxaKO.js';
+import '../logger-BMQgxvdy.js';
+import '../events-B6Q03pTu.js';
+import '../path-resolver-CPRj4bFY.js';
+import '../compactor-DSl2FK7a.js';