@wrongstack/core 0.284.1 → 0.285.0

package/dist/types/side-effect.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Side-effect risk classification for structured audit recording (P2 #5).
+ *
+ * @see {@link import('../core/context.js').Context.recordSideEffect}
+ */
+/**
+ * The kind of risk a tool side-effect poses. Used by /diag and session
+ * replay to filter and group side effects.
+ */
+export type SideEffectRisk = 'fs.write' | 'shell' | 'package' | 'network' | 'config';
+/**
+ * A structured record of a non-filesystem side effect produced by a tool.
+ * Appended to the session JSONL as a `side_effect` event for audit and
+ * observability.
+ */
+export interface SideEffect {
+    /** Session-unique tool call ID (from the tool_use block). */
+    toolUseId: string;
+    /** Tool name: 'bash' | 'install' | 'fetch' | ... */
+    toolName: string;
+    /** ISO timestamp. */
+    ts: string;
+    /** The input the tool received (command, url, packages). */
+    input: Record<string, unknown>;
+    /**
+     * Optional outcome summary — NOT the full output (that's already in the
+     * tool_result block). A short string like "exit 0", "installed 42 packages",
+     * "HTTP 200 (12KB)", or "timed out".
+     */
+    outcome?: string | undefined;
+    /** Risk classification for filtering in /diag. */
+    risk: SideEffectRisk;
+}
+//# sourceMappingURL=side-effect.d.ts.map

package/dist/types/side-effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"side-effect.d.ts","sourceRoot":"","sources":["../../src/types/side-effect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAErF;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,kDAAkD;IAClD,IAAI,EAAE,cAAc,CAAC;CACtB"}

package/dist/{skill-DHniprNl.d.ts → types/skill.d.ts}

@@ -1,4 +1,4 @@
-interface SkillManifest {
+export interface SkillManifest {
     name: string;
     description: string;
     version?: string | undefined;
@@ -18,7 +18,7 @@ interface SkillManifest {
     originTool?: string | undefined;
 }
 /** Parsed skill entry for structured rendering in system prompt. */
-interface SkillEntry {
+export interface SkillEntry {
     name: string;
     /** "Use when..." trigger condition — one-liner */
     trigger: string;
@@ -29,7 +29,7 @@ interface SkillEntry {
     originTool?: string | undefined;
     path: string;
 }
-interface SkillLoader {
+export interface SkillLoader {
     list(): Promise<SkillManifest[]>;
     /** Structured entries with trigger/scope for system prompt rendering. */
     listEntries(): Promise<SkillEntry[]>;
@@ -45,5 +45,4 @@ interface SkillLoader {
     /** Clear the internal cache so the next list/find re-reads from disk. */
     invalidateCache(): void;
 }
-
-export type { SkillLoader as S, SkillManifest as a, SkillEntry as b };
+//# sourceMappingURL=skill.d.ts.map

package/dist/types/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/types/skill.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC9C,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,gBAAgB,GAAG,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;IAChG,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,oEAAoE;AACpE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACjC,yEAAyE;IACzE,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACrC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;IACvD,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,yEAAyE;IACzE,eAAe,IAAI,IAAI,CAAC;CACzB"}

package/dist/types/slash-command.d.ts

@@ -0,0 +1,59 @@
+import type { Context } from '../core/context.js';
+/**
+ * A slash command registered with the CLI or available to plugins.
+ * Plugins receive a view of the registry via PluginAPI.slashCommands.
+ *
+ * Commands registered by plugins use a namespaced name: `pluginName:commandName`.
+ * This prevents collisions with built-in commands and other plugins.
+ */
+export interface SlashCommand {
+    /** Unique command name. For plugins: `pluginName:commandName`. */
+    name: string;
+    /** Short aliases — also prefixed automatically: `pluginName:alias`. */
+    aliases?: string[] | undefined;
+    description: string;
+    /**
+     * Category used to group commands in the slash picker. Defaults to 'App'
+     * when omitted.
+     */
+    category?: 'Run' | 'Session' | 'Inspect' | 'Agent' | 'Config' | 'App' | undefined;
+    /**
+     * Optional compact argument hint for interactive menus. This is not parsed
+     * by the registry; it only helps TUI/REPL surfaces show the expected shape,
+     * for example `[list|install <alias>|disable <name>]`.
+     */
+    argsHint?: string | undefined;
+    /**
+     * Optional detailed help shown by `/help <name>`. Use this for usage,
+     * arguments, examples, side-effects — anything that doesn't fit in
+     * `description`. Renders verbatim, so format with line breaks.
+     * If absent, `/help <name>` falls back to `description`.
+     */
+    help?: string | undefined;
+    /**
+     * When true, this command does not appear in the slash-picker list
+     * triggered by typing `/` alone. It is still dispatchable and
+     * searchable when the user types a matching prefix (e.g. `/f`).
+     * Defaults to false.
+     */
+    hidden?: boolean | undefined;
+    /**
+     * Execute the command.
+     * @param args Everything after the command name (trimmed by dispatch).
+     * @param ctx The current agent context.
+     * @returns `{ exit: true }` to quit the REPL. `{ message }` to print and
+     * continue. `{ runText }` to send a follow-up user-role message to the
+     * model immediately (e.g. `/steer <text>` builds a STEERING preamble
+     * here and asks the TUI to run it as the next turn). The TUI prints
+     * `message` first (if any) so the user sees the slash result before
+     * the model's response starts streaming. `{ metadata }` carries
+     * structured data for the REPL/TUI to act on (e.g. SDD session state).
+     */
+    run(args: string, ctx?: Context | undefined): Promise<{
+        exit?: boolean | undefined;
+        message?: string | undefined;
+        runText?: string | undefined;
+        metadata?: Record<string, unknown>;
+    } | void>;
+}
+//# sourceMappingURL=slash-command.d.ts.map

package/dist/types/slash-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-command.d.ts","sourceRoot":"","sources":["../../src/types/slash-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;IAClF;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B;;;;;;;;;;;OAWG;IACH,GAAG,CACD,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,GACxB,OAAO,CAAC;QAAE,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;CACnJ"}

package/dist/types/spec.d.ts

@@ -0,0 +1,77 @@
+export type SpecStatus = 'draft' | 'review' | 'approved' | 'implemented' | 'deprecated';
+export type SpecSectionType = 'overview' | 'requirements' | 'architecture' | 'api' | 'data' | 'security' | 'acceptance';
+export interface SpecSection {
+    type: SpecSectionType;
+    title: string;
+    content: string;
+    level: number;
+    children?: SpecSection[] | undefined;
+}
+export interface SpecRequirement {
+    id: string;
+    type: 'functional' | 'non-functional' | 'security' | 'performance' | 'ux';
+    priority: 'critical' | 'high' | 'medium' | 'low';
+    description: string;
+    acceptanceCriteria: string[];
+    blockedBy?: string[] | undefined;
+    implements?: string[] | undefined;
+}
+export interface SpecApiEndpoint {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    path: string;
+    description: string;
+    request?: Record<string, unknown>;
+    response?: Record<string, unknown>;
+    auth?: boolean | undefined;
+}
+export interface Specification {
+    id: string;
+    title: string;
+    version: string;
+    status: SpecStatus;
+    overview: string;
+    sections: SpecSection[];
+    requirements: SpecRequirement[];
+    apiEndpoints?: SpecApiEndpoint[] | undefined;
+    dependencies?: string[] | undefined;
+    createdAt: number;
+    updatedAt: number;
+    metadata?: Record<string, unknown>;
+}
+export interface SpecAnalysis {
+    specId: string;
+    completeness: number;
+    coverage: {
+        requirements: number;
+        apiEndpoints: number;
+        edgeCases: number;
+        errorHandling: number;
+    };
+    gaps: string[];
+    risks: {
+        requirement: string;
+        risk: string;
+        severity: 'high' | 'medium' | 'low';
+    }[];
+    suggestions: string[];
+}
+export interface SpecValidationResult {
+    valid: boolean;
+    errors: {
+        path: string;
+        message: string;
+    }[];
+    warnings: {
+        path: string;
+        message: string;
+    }[];
+}
+export interface SpecTemplate {
+    id: string;
+    name: string;
+    description: string;
+    sections: Omit<SpecSection, 'content'>[];
+    defaultRequirements: Omit<SpecRequirement, 'id' | 'description'>[];
+}
+export declare const DEFAULT_SPEC_TEMPLATE: SpecTemplate;
+//# sourceMappingURL=spec.d.ts.map

package/dist/types/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/types/spec.ts"],"names":[],"mappings":"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"}

package/dist/types/system-prompt-contributor.d.ts

@@ -0,0 +1,20 @@
+import type { TextBlock } from './blocks.js';
+import type { BuildContext } from './system-prompt.js';
+/**
+ * A contributor that injects additional TextBlocks into the system prompt.
+ *
+ * Contributors are called on every `build()` in registration order.
+ * Their output is inserted after the core blocks (identity, tool usage,
+ * environment) but before the mode and plan blocks. This lets plugins
+ * inject ephemeral context — current state, recent events, plugin-specific
+ * instructions — without replacing the entire system prompt builder.
+ *
+ * @example
+ * ```ts
+ * api.extensions.registerSystemPromptContributor(async (ctx) => {
+ *   return [{ type: 'text', text: '## My Plugin Context\n...' }];
+ * });
+ * ```
+ */
+export type SystemPromptContributor = (ctx: BuildContext) => Promise<TextBlock[]>;
+//# sourceMappingURL=system-prompt-contributor.d.ts.map

package/dist/types/system-prompt-contributor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt-contributor.d.ts","sourceRoot":"","sources":["../../src/types/system-prompt-contributor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC"}

package/dist/types/system-prompt.d.ts

@@ -0,0 +1,51 @@
+import type { TextBlock } from './blocks.js';
+import type { Tool } from './tool.js';
+import type { MailboxAgentStatus } from '../coordination/mailbox-types.js';
+/** Model capabilities relevant to prompt composition. */
+export interface ModelCapabilities {
+    maxContextTokens: number;
+    supportsTools: boolean;
+    supportsVision: boolean;
+    supportsReasoning: boolean;
+}
+export interface BuildContext {
+    cwd: string;
+    projectRoot: string;
+    tools: Tool[];
+    /** Provider id (e.g. "anthropic", "minimax-coding-plan"). */
+    provider?: string | undefined;
+    /** Model id (e.g. "configured-model", "MiniMax-M2.7"). */
+    model?: string | undefined;
+    /**
+     * True when the prompt is being built for a SUBAGENT, not the host
+     * agent. Subagents are scoped to a single task — they should NOT see
+     * the host's strategic plan board (which is anchoring the host across
+     * turns, not steering individual subtasks). The plan-injection
+     * layer short-circuits when this flag is set.
+     */
+    subagent?: boolean | undefined;
+    /**
+     * List of currently online agents in the shared mailbox system.
+     * Includes agents from all sessions (TUI, WebUI, CLI) in the same project.
+     */
+    onlineAgents?: MailboxAgentStatus[] | undefined;
+}
+/**
+ * Stability regions for the system prompt.
+ *
+ * `core` and `session` form the provider-cache prefix and must remain byte-for-byte
+ * stable after the first request in a session. `volatile` is appended at request
+ * time and may change between turns without rewriting that prefix.
+ */
+export interface SystemPromptRegions {
+    readonly core: readonly TextBlock[];
+    readonly session: readonly TextBlock[];
+    readonly volatile: readonly TextBlock[];
+}
+export declare function flattenSystemPromptRegions(regions: SystemPromptRegions): TextBlock[];
+export interface SystemPromptBuilder {
+    build(ctx: BuildContext): Promise<TextBlock[]>;
+    /** Region-aware build used by hosts that enforce prompt-prefix stability. */
+    buildRegions?(ctx: BuildContext): Promise<SystemPromptRegions>;
+}
+//# sourceMappingURL=system-prompt.d.ts.map

package/dist/types/system-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/types/system-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAE3E,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B;;;OAGG;IACH,YAAY,CAAC,EAAE,kBAAkB,EAAE,GAAG,SAAS,CAAC;CACjD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC;CACzC;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,EAAE,CAEpF;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAC/C,6EAA6E;IAC7E,YAAY,CAAC,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAChE"}

package/dist/{task-graph-CH3acNQ7.d.ts → types/task-graph.d.ts}

@@ -1,7 +1,7 @@
-type TaskStatus = 'pending' | 'in_progress' | 'blocked' | 'failed' | 'review' | 'completed';
-type TaskPriority = 'critical' | 'high' | 'medium' | 'low';
-type TaskType = 'feature' | 'bugfix' | 'refactor' | 'docs' | 'test' | 'chore';
-interface TaskNode {
+export type TaskStatus = 'pending' | 'in_progress' | 'blocked' | 'failed' | 'review' | 'completed';
+export type TaskPriority = 'critical' | 'high' | 'medium' | 'low';
+export type TaskType = 'feature' | 'bugfix' | 'refactor' | 'docs' | 'test' | 'chore';
+export interface TaskNode {
     id: string;
     title: string;
     description: string;
@@ -21,14 +21,14 @@ interface TaskNode {
     completedAt?: number | undefined;
     metadata?: Record<string, unknown>;
 }
-interface TaskEdge {
+export interface TaskEdge {
     id: string;
     from: string;
     to: string;
     type: 'blocks' | 'depends_on' | 'relates_to' | 'implements';
     weight?: number | undefined;
 }
-interface TaskGraph {
+export interface TaskGraph {
     id: string;
     specId: string;
     title: string;
@@ -38,17 +38,17 @@ interface TaskGraph {
     createdAt: number;
     updatedAt: number;
 }
-interface TaskDependency {
+export interface TaskDependency {
     taskId: string;
     blockedBy: string[];
     blocking: string[];
 }
-interface TaskAssignment {
+export interface TaskAssignment {
     taskId: string;
     assignee: string;
     assignedAt: number;
 }
-interface TaskProgress {
+export interface TaskProgress {
     total: number;
     pending: number;
     inProgress: number;
@@ -60,7 +60,7 @@ interface TaskProgress {
     estimatedHours: number;
     actualHours: number;
 }
-interface TaskFilter {
+export interface TaskFilter {
     status?: TaskStatus[] | undefined;
     priority?: TaskPriority[] | undefined;
     type?: TaskType[] | undefined;
@@ -68,26 +68,25 @@ interface TaskFilter {
     tags?: string[] | undefined;
     specRequirementId?: string | undefined;
 }
-interface TaskSort {
+export interface TaskSort {
     field: 'priority' | 'createdAt' | 'updatedAt' | 'status';
     direction: 'asc' | 'desc';
 }
-interface CriticalPathResult {
+export interface CriticalPathResult {
     taskIds: string[];
     totalEstimateHours: number;
     bottleneckTasks: string[];
 }
-declare function computeTaskProgress(graph: TaskGraph): TaskProgress;
-declare function findCriticalPath(graph: TaskGraph): CriticalPathResult;
-declare function topologicalSort(graph: TaskGraph): string[];
-type SerializableTaskGraphNodes = TaskNode[] | Array<[string, TaskNode]> | Record<string, TaskNode>;
-type SerializableTaskGraph = Omit<TaskGraph, 'nodes'> & {
+export declare function computeTaskProgress(graph: TaskGraph): TaskProgress;
+export declare function findCriticalPath(graph: TaskGraph): CriticalPathResult;
+export declare function topologicalSort(graph: TaskGraph): string[];
+export type SerializableTaskGraphNodes = TaskNode[] | Array<[string, TaskNode]> | Record<string, TaskNode>;
+export type SerializableTaskGraph = Omit<TaskGraph, 'nodes'> & {
     nodes: SerializableTaskGraphNodes;
 };
-type SerializedTaskGraph = Omit<TaskGraph, 'nodes'> & {
+export type SerializedTaskGraph = Omit<TaskGraph, 'nodes'> & {
     nodes: TaskNode[];
 };
-declare function serializeTaskGraph(graph: TaskGraph): SerializedTaskGraph;
-declare function deserializeTaskGraph(input: SerializableTaskGraph): TaskGraph;
-
-export { type CriticalPathResult as C, type SerializableTaskGraph as S, type TaskType as T, type TaskPriority as a, type TaskStatus as b, type TaskProgress as c, type TaskGraph as d, type TaskNode as e, type SerializableTaskGraphNodes as f, type SerializedTaskGraph as g, type TaskAssignment as h, type TaskDependency as i, type TaskEdge as j, type TaskFilter as k, type TaskSort as l, computeTaskProgress as m, deserializeTaskGraph as n, findCriticalPath as o, serializeTaskGraph as s, topologicalSort as t };
+export declare function serializeTaskGraph(graph: TaskGraph): SerializedTaskGraph;
+export declare function deserializeTaskGraph(input: SerializableTaskGraph): TaskGraph;
+//# sourceMappingURL=task-graph.d.ts.map

package/dist/types/task-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-graph.d.ts","sourceRoot":"","sources":["../../src/types/task-graph.ts"],"names":[],"mappings":"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"}

package/dist/types/token-counter.d.ts

@@ -0,0 +1,42 @@
+import type { Usage } from './provider.js';
+export interface CacheStats {
+    /** Tokens served from cache (cheaper). */
+    readTokens: number;
+    /** Tokens written into the cache (more expensive than input on first hit). */
+    writeTokens: number;
+    /** Hit ratio: cacheRead / (cacheRead + input). 0 when nothing cached. */
+    hitRatio: number;
+}
+export interface TokenCounter {
+    account(usage: Usage, model?: string): void | undefined;
+    /** Optional live session binding used by token.accounted events. */
+    setSessionId?(sessionId: string | (() => string | undefined) | undefined): void;
+    /**
+     * Disjoint token counts from the most recently-accounted request. Sum
+     * input + cacheRead + cacheWrite for per-request context pressure tracking
+     * (e.g. status bar ctx bar) — tokenCounter.total() is cumulative across all
+     * requests and cannot be compared meaningfully against a per-request
+     * maxContext ceiling.
+     */
+    currentRequestTokens(): {
+        input: number;
+        cacheRead: number;
+        cacheWrite: number;
+    };
+    /**
+     * Override the last-request token snapshot. Used by slash commands like
+     * /compact that modify ctx.messages without making an API request —
+     * after calling this, the TUI/REPL context bar reflects the new size.
+     */
+    setCurrentRequestTokens(input: number, cacheRead?: number, cacheWrite?: number): void;
+    total(): Usage;
+    estimateCost(): {
+        input: number;
+        output: number;
+        total: number;
+        currency: 'USD';
+    };
+    cacheStats(): CacheStats;
+    reset(): void;
+}
+//# sourceMappingURL=token-counter.d.ts.map

package/dist/types/token-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.d.ts","sourceRoot":"","sources":["../../src/types/token-counter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACxD,oEAAoE;IACpE,YAAY,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC;IAChF;;;;;;OAMG;IACH,oBAAoB,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACjF;;;;OAIG;IACH,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtF,KAAK,IAAI,KAAK,CAAC;IACf,YAAY,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,KAAK,CAAA;KAAE,CAAC;IAClF,UAAU,IAAI,UAAU,CAAC;IACzB,KAAK,IAAI,IAAI,CAAC;CACf"}

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

@@ -0,0 +1,133 @@
+import type { ToolResultBlock, ToolUseBlock } from '../types/blocks.js';
+import type { Tool } from '../types/tool.js';
+/**
+ * Input for a single tool execution, scoped to a single iteration's budget.
+ */
+export interface ToolExecution {
+    toolUse: ToolUseBlock;
+    result: ToolResultBlock;
+    /** True if the tool was not found in the registry. */
+    unknownTool?: boolean | undefined;
+    /** True if the tool execution threw an exception. */
+    threw?: boolean | undefined;
+}
+/**
+ * Output from a single tool execution.
+ */
+export interface ToolExecutionOutput {
+    result: ToolResultBlock | ToolConfirmPendingResult;
+    tool?: Tool | undefined;
+    durationMs: number;
+}
+/**
+ * Result of running a batch of tools for a single agent iteration.
+ */
+export interface ToolBatchResult {
+    outputs: ToolExecutionOutput[];
+    remainingBudget: number;
+}
+export type ConfirmAwaiter = (tool: Tool, input: unknown, toolUseId: string, suggestedPattern: string) => Promise<'yes' | 'no' | 'always' | 'deny'>;
+export interface ToolExecutorOptions {
+    permissionPolicy: import('../types/permission.js').PermissionPolicy;
+    secretScrubber: import('../types/secret-scrubber.js').SecretScrubber;
+    renderer?: import('../types/renderer.js').Renderer | undefined;
+    /**
+     * Optional event bus. When provided, the executor emits `tool.started`
+     * before invoking each tool's `execute()`. Closes the observability gap
+     * between "model decided to call tool" and "tool finished".
+     */
+    events?: import('../kernel/events.js').EventBus | undefined;
+    /**
+     * Optional tracer. When provided, every tool execution opens a
+     * `tool.<name>` span with attributes for tool name, permission decision,
+     * input size, output size, and outcome. Spans are no-op by default.
+     */
+    tracer?: import('../types/observability.js').Tracer | undefined;
+    /**
+     * Optional structured logger for production diagnostics. Tool execution logs
+     * include correlation IDs and metadata only — never raw tool inputs or output.
+     */
+    logger?: import('../types/logger.js').Logger | undefined;
+    /**
+     * Async callback invoked when a tool needs user confirmation.
+     * When omitted and confirmation is required, the executor returns a
+     * failure result immediately (TUI path). When provided (CLI path),
+     * the callback handles the interactive prompt and returns a decision.
+     */
+    confirmAwaiter?: ConfirmAwaiter | undefined;
+    iterationTimeoutMs?: number | undefined;
+    /** Hard upper bound for a single tool call timeout. Defaults to 5 minutes. */
+    maxToolTimeoutMs?: number | undefined;
+    perIterationOutputCapBytes?: number | undefined;
+    /**
+     * Optional lifecycle hook runner. When present, `PreToolUse` hooks run
+     * before the permission check (and can block the call or rewrite its input)
+     * and `PostToolUse` hooks run after the tool returns (and can append context
+     * to the result the model sees).
+     */
+    hookRunner?: import('../hooks/runner.js').HookRunner | undefined;
+    /**
+     * Per-tool on-screen result render mode map (`tools.resultRenderMode[name]`).
+     * When set, the executor reads this map to decide whether the next
+     * `writeToolResult` call should render in `simple` (meta only) or `extend`
+     * (full preview) mode. Independent of the LLM-side `descriptionMode`.
+     */
+    resultRenderModes?: import('./config.js').ToolResultRenderModeConfig | undefined;
+}
+export interface ToolExecutorInit {
+    registry: import('../registry/tool-registry.js').ToolRegistry;
+    options: ToolExecutorOptions;
+}
+/**
+ * Result returned by executeBatch when a tool needs confirmation and
+ * no confirmAwaiter is available. The TUI catches this and surfaces a
+ * confirmation dialog; once resolved the tool is re-executed.
+ * The string tag identifies it as a "pending confirm" result so callers
+ * can distinguish it from an error without inspecting content strings.
+ */
+export interface ToolConfirmPendingResult {
+    type: 'tool_confirm_pending';
+    toolUseId: string;
+    toolName: string;
+    input: unknown;
+    suggestedPattern: string;
+    decisionSource?: import('./permission.js').PermissionDecision['source'] | undefined;
+    riskTier?: import('./tool.js').RiskTier | undefined;
+}
+export type ToolExecutorStrategy = 'parallel' | 'sequential' | 'smart';
+/**
+ * Minimal contract for tool execution.
+ *
+ * Defined here (in `types/`) so `core/` does not need to import the
+ * concrete `ToolExecutor` class from `execution/`. Callers that create
+ * the executor (e.g. CLI wiring) implement this interface.
+ *
+ * Only the methods actually called by `Agent` are included — keeping the
+ * interface narrow prevents unnecessary coupling.
+ */
+export interface ToolExecutorLike {
+    /**
+     * Execute a batch of tool uses. The strategy controls whether tools run
+     * sequentially, in parallel, or smart (parallel non-mutating + sequential mutating).
+     */
+    executeBatch(toolUses: import('./blocks.js').ToolUseBlock[], ctx: import('../core/context.js').Context, strategy: ToolExecutorStrategy): Promise<ToolBatchResult>;
+    /**
+     * Clear the interactive confirm awaiter so the executor returns
+     * `ToolConfirmPendingResult` instead of blocking.
+     */
+    clearConfirmAwaiter(): void;
+    /**
+     * Execute a single tool with timeout and output capping.
+     * Used by the agent when it needs to run one tool at a time.
+     *
+     * Returns the rendered `ToolResultBlock` plus the exact byte count it
+     * consumed against the iteration output cap. The caller subtracts
+     * `bytes` from the running budget — no second `Buffer.byteLength`
+     * walk, and no `JSON.stringify` fallback for structured results.
+     */
+    executeTool(tool: Tool, use: ToolUseBlock, ctx: import('../core/context.js').Context, budget: number): Promise<{
+        block: ToolResultBlock;
+        bytes: number;
+    }>;
+}
+//# sourceMappingURL=tool-executor.d.ts.map

package/dist/types/tool-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executor.d.ts","sourceRoot":"","sources":["../../src/types/tool-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,eAAe,CAAC;IACxB,sDAAsD;IACtD,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,qDAAqD;IACrD,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,eAAe,GAAG,wBAAwB,CAAC;IACnD,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,cAAc,GAAG,CAC3B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,KACrB,OAAO,CAAC,KAAK,GAAG,IAAI,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC;AAE/C,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,OAAO,wBAAwB,EAAE,gBAAgB,CAAC;IACpE,cAAc,EAAE,OAAO,6BAA6B,EAAE,cAAc,CAAC;IACrE,QAAQ,CAAC,EAAE,OAAO,sBAAsB,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC/D;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,qBAAqB,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5D;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,2BAA2B,EAAE,MAAM,GAAG,SAAS,CAAC;IAChE;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;IACzD;;;;;OAKG;IACH,cAAc,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IAC5C,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,0BAA0B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,oBAAoB,EAAE,UAAU,GAAG,SAAS,CAAC;IACjE;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,OAAO,aAAa,EAAE,0BAA0B,GAAG,SAAS,CAAC;CAClF;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,8BAA8B,EAAE,YAAY,CAAC;IAC9D,OAAO,EAAE,mBAAmB,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,iBAAiB,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;IACpF,QAAQ,CAAC,EAAE,OAAO,WAAW,EAAE,QAAQ,GAAG,SAAS,CAAC;CACrD;AAED,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC;AAEvE;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,YAAY,CACV,QAAQ,EAAE,OAAO,aAAa,EAAE,YAAY,EAAE,EAC9C,GAAG,EAAE,OAAO,oBAAoB,EAAE,OAAO,EACzC,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAAC;IAE5B;;;OAGG;IACH,mBAAmB,IAAI,IAAI,CAAC;IAE5B;;;;;;;;OAQG;IACH,WAAW,CACT,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,OAAO,oBAAoB,EAAE,OAAO,EACzC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;QAAE,KAAK,EAAE,eAAe,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD"}

package/dist/types/tool-markers.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Sentinel keys provider adapters use to wrap tool-call arguments that could
+ * not be parsed into a proper JSON object. Single source of truth — the core
+ * tool executor (which DETECTS these markers to surface a friendly error)
+ * defines them here, and the providers package (which PRODUCES them when
+ * wrapping) imports from `@wrongstack/core`.
+ *
+ * P3 #14 (before-release.md): the list was duplicated in tool-executor.ts with
+ * a "Keep this list in sync" comment — a manual rule that will eventually be
+ * forgotten. Centralizing it removes the sync burden.
+ *
+ * Layering note: this lives in core (not providers) because the dependency
+ * direction is providers → core, not the reverse. Putting it in providers
+ * would force core into a forbidden upward dependency.
+ *
+ * Current markers:
+ * - `__raw`            — produced by `parseToolInput` (Anthropic / shared)
+ * - `__raw_arguments`  — produced by `contentFromOpenAI` (OpenAI / compatible)
+ * - `_raw`             — produced by the streaming response builder's
+ *                        `safeJsonOrRaw` (legacy fallback)
+ */
+export declare const MALFORMED_ARG_MARKERS: readonly ['__raw', '__raw_arguments', '_raw'];
+//# sourceMappingURL=tool-markers.d.ts.map

package/dist/types/tool-markers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-markers.d.ts","sourceRoot":"","sources":["../../src/types/tool-markers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,qBAAqB,YAAI,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAU,CAAC"}