@wrongstack/core 0.284.1 → 0.285.0

package/dist/types/hooks.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Lifecycle hook types — the pure, serializable contract shared by the config
+ * layer, the in-process plugin API, and the shell-hook executor.
+ *
+ * These types intentionally avoid referencing the live `Context` (which lives
+ * in `core/`, a higher layer) so `types/config.ts` can import them without
+ * creating a layering cycle. The runtime pieces (`hooks/registry`,
+ * `hooks/runner`, `hooks/shell-executor`) translate live run state into the
+ * serializable `HookInput` below.
+ */
+/** Lifecycle phases a hook can subscribe to. */
+export type HookEvent = 'PreToolUse' | 'PostToolUse' | 'UserPromptSubmit' | 'SessionStart' | 'Stop';
+/**
+ * Tool-name matcher for `PreToolUse`/`PostToolUse` hooks. A pipe-delimited
+ * list of exact tool names, or `*` for all tools. Examples: `"Bash"`,
+ * `"edit|write"`, `"*"`. Ignored (treated as `*`) for non-tool events.
+ */
+export type HookMatcher = string;
+/** What to do when a hook crashes, times out, or returns malformed output. */
+export type HookFailurePolicy = 'open' | 'closed';
+/**
+ * PreToolUse hooks run in two phases. Mutators compose first; validators then
+ * inspect the final arguments and may no longer rewrite them.
+ */
+export type PreToolUseStage = 'mutate' | 'validate';
+/** Per-registration runtime controls shared by every hook transport. */
+export interface HookRegistrationOptions {
+    /** Stable name used in logs and model-visible fail-closed errors. */
+    name?: string | undefined;
+    /** Per-invocation deadline in milliseconds (default 5000). */
+    timeoutMs?: number | undefined;
+    /** `open` skips a failed hook; `closed` converts failure to a denial. */
+    failurePolicy?: HookFailurePolicy | undefined;
+    /** PreToolUse phase. Legacy registrations default to `mutate`. */
+    stage?: PreToolUseStage | undefined;
+    /**
+     * Trusted enforcement hook. Policy hooks remain active under `--no-hooks`;
+     * ordinary automation hooks do not.
+     */
+    policy?: boolean | undefined;
+}
+/** Deadline/cancellation context passed to in-process hooks. */
+export interface HookInvocationContext {
+    signal: AbortSignal;
+    /** Absolute Unix epoch deadline in milliseconds. */
+    deadlineAt: number;
+}
+/**
+ * The JSON payload handed to a hook. For shell hooks this is serialized to
+ * stdin; for in-process hooks it is passed as the sole argument. Kept flat and
+ * serializable so both transports see the same shape.
+ */
+export interface HookInput {
+    event: HookEvent;
+    /** Present for PreToolUse / PostToolUse. */
+    toolName?: string | undefined;
+    /** Tool arguments (PreToolUse / PostToolUse). */
+    toolInput?: unknown | undefined;
+    /** Tool result preview (PostToolUse only). */
+    toolResult?: {
+        content: string;
+        isError: boolean;
+    };
+    /** The submitted user text (UserPromptSubmit only). */
+    prompt?: string | undefined;
+    /** Absolute working directory of the session. */
+    cwd: string;
+    /** Active session id, when known. */
+    sessionId?: string | undefined;
+}
+/**
+ * What a hook returns. Every field is optional — an empty object (or a hook
+ * that returns nothing) is a no-op "allow".
+ */
+export interface HookOutcome {
+    /**
+     * `block` stops the action (PreToolUse → tool not run; UserPromptSubmit →
+     * turn short-circuited). `allow` is the explicit no-op. Omitted = allow.
+     */
+    decision?: 'block' | 'allow' | undefined;
+    /** Human-readable reason, surfaced to the model when blocking. */
+    reason?: string | undefined;
+    /**
+     * PreToolUse only: replacement tool arguments. The executor swaps these in
+     * and RE-VALIDATES them against the tool's input schema before running.
+     */
+    modifiedInput?: Record<string, unknown>;
+    /**
+     * Extra context to fold back to the model — appended to the tool_result
+     * (PostToolUse), the user message (UserPromptSubmit), or the system preamble
+     * (SessionStart).
+     */
+    additionalContext?: string | undefined;
+    /**
+     * Where the additionalContext should appear. `inline` (default) appends it
+     * to the tool_result / user message content so it renders as part of that
+     * block. `separate` appends it as a new user message, keeping plugin notices
+     * visually separated from the actual tool output.
+     */
+    contextAs?: 'inline' | 'separate' | undefined;
+}
+/**
+ * Preferred, mutually-exclusive PreToolUse result. `allow` means only that
+ * this hook has no objection; it never bypasses the core permission policy.
+ */
+export type PreToolUseOutcome = {
+    additionalContext?: string | undefined;
+    contextAs?: 'inline' | 'separate' | undefined;
+} & ({
+    action: 'allow';
+} | {
+    action: 'deny';
+    reason: string;
+} | {
+    action: 'mutate';
+    input: Record<string, unknown>;
+    reason?: string | undefined;
+});
+/** New and legacy hook outputs accepted at the transport boundary. */
+export type AnyHookOutcome = HookOutcome | PreToolUseOutcome;
+/** An in-process hook function (registered via the plugin API). */
+export type InProcessHook = (input: HookInput, runtime: HookInvocationContext) => AnyHookOutcome | void | Promise<AnyHookOutcome | void>;
+interface ConfiguredHookBase extends HookRegistrationOptions {
+    /** Tool-name matcher (defaults to `*`). */
+    matcher?: HookMatcher | undefined;
+}
+/**
+ * A shell-command hook (declared in `config.hooks`). Claude-compatible: the
+ * `HookInput` JSON is written to the command's stdin; a JSON `HookOutcome` may
+ * be printed to stdout, and exit code 2 forces `decision: 'block'`.
+ */
+export interface ShellHook extends ConfiguredHookBase {
+    type?: 'command' | undefined;
+    /** Command line run via the platform shell. */
+    command: string;
+}
+/** Native HTTP hook. The HookInput JSON is POSTed and JSON output is parsed. */
+export interface HttpHook extends ConfiguredHookBase {
+    type: 'http';
+    url: string;
+    headers?: Record<string, string> | undefined;
+}
+export type ConfiguredHook = ShellHook | HttpHook;
+interface HookEntryBase {
+    event: HookEvent;
+    matcher: HookMatcher;
+    name: string;
+    timeoutMs?: number | undefined;
+    failurePolicy: HookFailurePolicy;
+    stage: PreToolUseStage;
+    policy: boolean;
+}
+/** A registered hook entry, discriminated by transport. */
+export type HookEntry = (HookEntryBase & {
+    kind: 'inprocess';
+    hook: InProcessHook;
+    owner?: string | undefined;
+}) | (HookEntryBase & {
+    kind: 'shell';
+    command: string;
+}) | (HookEntryBase & {
+    kind: 'http';
+    url: string;
+    headers?: Record<string, string> | undefined;
+});
+export {};
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/types/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,gDAAgD;AAChD,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,aAAa,GAAG,kBAAkB,GAAG,cAAc,GAAG,MAAM,CAAC;AAEpG;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC,8EAA8E;AAC9E,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEpD,wEAAwE;AACxE,MAAM,WAAW,uBAAuB;IACtC,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,yEAAyE;IACzE,aAAa,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC9C,kEAAkE;IAClE,KAAK,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC9B;AAED,gEAAgE;AAChE,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,WAAW,CAAC;IACpB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,SAAS,CAAC;IACjB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC,8CAA8C;IAC9C,UAAU,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IACnD,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IACzC,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;CAC/C;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,SAAS,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;CAC/C,GAAG,CACA;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GACnB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CACpF,CAAC;AAEF,sEAAsE;AACtE,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,iBAAiB,CAAC;AAE7D,mEAAmE;AACnE,MAAM,MAAM,aAAa,GAAG,CAC1B,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,qBAAqB,KAC3B,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;AAE5D,UAAU,kBAAmB,SAAQ,uBAAuB;IAC1D,2CAA2C;IAC3C,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAU,SAAQ,kBAAkB;IACnD,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,gFAAgF;AAChF,MAAM,WAAW,QAAS,SAAQ,kBAAkB;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC9C;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElD,UAAU,aAAa;IACrB,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,aAAa,EAAE,iBAAiB,CAAC;IACjC,KAAK,EAAE,eAAe,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,2DAA2D;AAC3D,MAAM,MAAM,SAAS,GACjB,CAAC,aAAa,GAAG;IACf,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B,CAAC,GACF,CAAC,aAAa,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GACpD,CAAC,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;CAAE,CAAC,CAAC"}

package/dist/types/index.d.ts

@@ -1,244 +1,40 @@
-export { E as AgentError, q as CacheTtl, r as Capabilities, G as CompletedWorkEvidence, H as CompletedWorkSource, I as ConfigError, i as ContentBlock, K as ContextEvidenceState, L as ContextFileEvidence, O as ContextIntentEvidence, Q as ContextRepeatedReadEvidence, V as ERROR_CODES, X as ErrorCode, Y as ErrorSeverity, Z as ErrorSubsystem, _ as FetchError, $ as FileSnapshot, F as ForkedSession, a0 as FsError, a1 as ImageBlock, J as JSONSchema, a2 as JsonSchemaSpec, M as Message, a3 as MessageRole, a4 as ParseError, f as Permission, a5 as PluginError, P as Provider, h as ProviderError, a6 as ProviderErrorBody, a7 as ProviderErrorKind, a as ReasoningConfig, p as ReasoningEffort, R as ReasoningRequest, c as Request, a9 as RequestCacheControl, e as Response, aa as ResponseFormat, ab as ResumeFileStatus, ac as ResumeFileValidationEntry, ad as ResumeValidation, x as ResumedSession, n as RiskTier, af as SafetySetting, ag as SddError, y as SessionData, ah as SessionError, S as SessionEvent, v as SessionForkOptions, j as SessionMetadata, k as SessionStore, z as SessionSummary, b as SessionWriter, ai as SideEffect, aj as SideEffectRisk, am as StopReason, an as StreamEvent, ao as StreamHangError, s as TextBlock, ap as ThinkingBlock, g as Tool, aq as ToolCallContext, ar as ToolError, l as ToolErrorCategory, as as ToolErrorInfo, at as ToolEvidenceStatus, au as ToolFinalEvent, av as ToolIconId, o as ToolOutputMetadata, m as ToolProgressEvent, D as ToolResultBlock, aw as ToolStreamEvent, B as ToolUseBlock, ax as ToolValidationError, U as Usage, W as WorkspaceCheckpointRef, w as WorkspaceMaterializationResult, ay as WrongStackError, az as classifyProviderError, aA as effectiveInputTokens, aC as isAgentError, aD as isConfigError, aE as isFetchError, aF as isFsError, aG as isImageBlock, aH as isParseError, aI as isPluginError, aJ as isRetryableKind, aK as isSddError, aL as isSessionError, aM as isTextBlock, aN as isToolError, aO as isToolResultBlock, aP as isToolUseBlock, aQ as isToolValidationError, aR as isWrongStackError, aS as toWrongStackError } from '../tool-BNlnIJvo.js';
-export { P as ProviderRunner, R as RunProviderOptions } from '../provider-runner-ChL-kVg6.js';
-export { A as AdaptiveConcurrencyConfig, t as AnyHookOutcome, u as AutonomyConfig, v as CONTEXT_WINDOW_MODES, w as CircuitBreakerRuntimeConfig, j as Config, l as ConfigLoader, n as ConfigStore, C as ConfiguredHook, x as ContextConfig, o as ContextWindowAggressiveOn, y as ContextWindowConfigLike, z as ContextWindowMode, B as ContextWindowModeId, p as ContextWindowPolicy, D as ContextWindowThresholds, E as CustomModelDefinition, G as DEFAULT_CONTEXT_WINDOW_MODE_ID, J as DEFAULT_TUI_THINKING_WORD, K as ExecDangerConfig, L as ExecToolConfig, N as FeaturesConfig, F as FleetConfig, O as FleetSupervisorConfig, i as HookEntry, H as HookEvent, Q as HookFailurePolicy, r as HookInput, U as HookInvocationContext, f as HookMatcher, s as HookOutcome, g as HookRegistrationOptions, V as HqClientConfig, h as HttpHook, I as InProcessHook, X as IndexingConfig, Y as InputHistoryConfig, Z as LaunchConfig, _ as LogConfig, $ as LoopDetectionConfig, a0 as MAX_TUI_THINKING_WORD_LENGTH, b as MCPServerConfig, a as ModelMatrixEntry, a1 as ModelRuntimeCacheConfig, k as ModelRuntimeConfig, a2 as ModelRuntimeParametersConfig, a3 as ModelRuntimeReasoningConfig, e as ModelsDevModel, c as ModelsDevPayload, a4 as ModelsDevProvider, M as ModelsRegistry, a5 as PluginConfig, a6 as PreToolUseOutcome, a7 as PreToolUseStage, a8 as ProviderApiKey, P as ProviderConfig, R as ResolvedModel, d as ResolvedProvider, a9 as SessionLoggingConfig, S as ShellHook, aa as SkillsConfig, ab as SyncCategory, m as SyncConfig, q as TokenSavingTier, ac as ToolDescriptionMode, ad as ToolDescriptionModeConfig, T as ToolResultRenderMode, ae as ToolResultRenderModeConfig, af as ToolsConfig, W as WireFamily, ag as formatContextWindowModeList, ah as getContextWindowMode, ai as isContextWindowModeId, aj as listContextWindowModes, ak as normalizeTokenSavingTier, al as normalizeTuiThinkingWord, am as resolveContextWindowPolicy } from '../config-MRqn1V-u.js';
-export { a as CompactReport, C as Compactor } from '../compactor-DQLL4HTo.js';
-export { a as PermissionDecision, P as PermissionPolicy, T as TrustPolicy } from '../permission-ByDKXEcG.js';
-export { C as CheckpointInfo, R as RewindResult, a as RewindResultExtended, S as SessionRewinder } from '../session-rewinder-C9HnMkhP.js';
-export { a as AddAttachmentInput, c as Attachment, d as AttachmentKind, e as AttachmentMeta, b as AttachmentRef, A as AttachmentStore, D as DefaultSessionReader } from '../session-reader-7Esxrkpw.js';
-export { D as DEFAULT_AUTONOMY_CONFIG, a as DEFAULT_CIRCUIT_BREAKER_CONFIG, b as DEFAULT_CONTEXT_CONFIG, c as DEFAULT_SESSION_LOGGING_CONFIG, d as DEFAULT_SESSION_PRUNE_DAYS, e as DEFAULT_TOOLS_CONFIG } from '../default-config-B79_gJYv.js';
-export { o as MEMORY_TYPE_LABELS, p as MemoryClearedPayload, q as MemoryConsolidatedPayload, b as MemoryEntry, r as MemoryForgottenPayload, s as MemoryPriority, d as MemoryRelevanceContext, t as MemoryRememberedPayload, M as MemoryScope, c as MemoryStore, u as MemoryType, S as ScoredEntry } from '../events-Bgnh43r9.js';
-export { b as SkillEntry, S as SkillLoader, a as SkillManifest } from '../skill-DHniprNl.js';
-import { f as PromptCategory } from '../prompt-DLd35n4Q.js';
-export { B as BUILTIN_PROMPT_CATEGORIES, d as BuiltinPromptCategory, e as PROMPT_CATEGORY_LABELS, c as PromptCategoryCount, a as PromptEntry, P as PromptLoader, g as PromptManifest, h as PromptManifestRef, b as PromptSearchOptions, i as PromptSource, j as PromptVariable, k as isBuiltinCategory } from '../prompt-DLd35n4Q.js';
-import { I as IterationStage, l as ParallelIterationStage } from '../parallel-eternal-engine-HUrtePLd.js';
-export { f as DESIGN_STACKS, d as DesignKitEntry, b as DesignKitLoader, c as DesignKitManifest, e as DesignKitTokens, D as DesignStack, a as DesignStudioState, g as DesignTokenSet, m as isDesignStack } from '../parallel-eternal-engine-HUrtePLd.js';
-export { B as BuildContext, c as ModelCapabilities, a as Renderer, S as SystemPromptBuilder, d as SystemPromptRegions, g as flattenSystemPromptRegions } from '../pipeline-DGDyIohT.js';
-export { I as InputReader, P as PromptOption } from '../input-reader-E-ffP2ee.js';
-export { m as AwaitAnyResult, V as CoordinatorEvents, C as CoordinatorStatus, c as DoneCondition, r as MCPRegistryView, u as MetricsSinkView, M as MultiAgentConfig, a5 as MultiAgentCoordinator, y as Plugin, P as PluginAPI, w as PluginCapabilities, x as PluginDependency, v as PluginLLM, a7 as PluginLLMOptions, a8 as PluginLLMResult, o as PluginPipelines, ar as ProviderFactory, q as ProviderRegistryView, t as SessionWriterView, n as SlashCommand, s as SlashCommandRegistryView, a9 as SpawnResult, i as SubagentConfig, ab as SubagentContext, ac as SubagentError, ad as SubagentErrorKind, ae as SubagentPartialResult, af as SubagentRunContext, ag as SubagentRunOutcome, S as SubagentRunner, ah as SubagentSpawnLineage, ai as SubagentStructuredReport, al as TaskDelegation, l as TaskResult, T as TaskSpec, p as ToolRegistryView } from '../multi-agent-coordinator-4RCRZKjN.js';
-export { D as DEFAULT_MODES, b as Mode, a as ModeConfig, c as ModeManifest, M as ModeStore } from '../mode-CZlO9iU1.js';
-export { C as CriticalPathResult, S as SerializableTaskGraph, f as SerializableTaskGraphNodes, g as SerializedTaskGraph, h as TaskAssignment, i as TaskDependency, j as TaskEdge, k as TaskFilter, d as TaskGraph, e as TaskNode, a as TaskPriority, c as TaskProgress, l as TaskSort, b as TaskStatus, T as TaskType, m as computeTaskProgress, n as deserializeTaskGraph, o as findCriticalPath, s as serializeTaskGraph, t as topologicalSort } from '../task-graph-CH3acNQ7.js';
-export { A as AggregateHealth, a as HealthCheck, b as HealthCheckResult, H as HealthRegistry, c as HealthStatus, d as MetricLabels, e as MetricSeries, M as MetricsSink, f as MetricsSnapshot, S as Span, T as Tracer } from '../observability-D-HZN_mF.js';
-export { S as SystemPromptContributor } from '../index--Gm41aBJ.js';
-import '../logger-B63L5bTg.js';
-import '../retry-policy-CQ7KwXJa.js';
-import '../goal-store-Datpp-ar.js';
-import '../mailbox-types-BGZWrYTJ.js';
-import 'node:events';
-import '../secret-scrubber-3MHDDAtm.js';
-
-/**
- * Prompt registry / sync types — the contract for a remote prompt hub
- * (e.g. prompts.wrongstack.com) and the local installed-prompts manifest.
- *
- * The manifest shape intentionally mirrors the bundled dataset's
- * `data/prompts/index.json` (see `PromptManifest` in `types/prompt.ts`): the
- * builtin dataset IS a local registry, so builtin and synced prompts can flow
- * through one validation + diff path. This file defines the format and the
- * structural validator; the actual fetch/download is a deliberately small stub
- * (see `prompts/prompt-installer.ts`) — "groundwork now, sync later".
- */
-
-interface PromptRegistryRef {
-    id: string;
-    slug: string;
-    title: string;
-    description: string;
-    category: PromptCategory;
-    tags: string[];
-    /** sha256 of the prompt content — drives the update diff. */
-    checksum: string;
-    version?: string | undefined;
-    license?: string | undefined;
-    /** Optional direct URL to the full prompt JSON. */
-    url?: string | undefined;
-}
-interface PromptRegistryManifest {
-    registryVersion: 1;
-    /** Where this manifest came from (hub URL or `owner/repo`). */
-    source: string;
-    generatedAt: string;
-    prompts: PromptRegistryRef[];
-}
-/** One entry recorded in `~/.wrongstack/installed-prompts.json`. */
-interface InstalledPromptEntry {
-    slug: string;
-    /** The registry/source this prompt was pulled from. */
-    source: string;
-    /** The ref pinned at install (tag/branch/commit or manifest version). */
-    ref: string;
-    checksum: string;
-    /** True once the prompt body has actually been written locally. */
-    synced: boolean;
-    installedAt: string;
-}
-interface PromptManifestData {
-    version: 1;
-    entries: InstalledPromptEntry[];
-}
-/** Result of validating an untrusted manifest. */
-type ManifestValidation = {
-    ok: true;
-    manifest: PromptRegistryManifest;
-} | {
-    ok: false;
-    errors: string[];
-};
-/**
- * Structurally validate an untrusted registry manifest. Treats the manifest as
- * DATA, not instructions: enforces slug charset, checksum format, and field
- * lengths so a malicious hub can't smuggle oversized or malformed entries into
- * the local store. Does NOT fetch prompt bodies.
- */
-declare function validateRegistryManifest(raw: unknown): ManifestValidation;
-interface RegistryDiff {
-    /** Slugs present in the manifest but not locally. */
-    added: PromptRegistryRef[];
-    /** Slugs present locally but whose checksum differs in the manifest. */
-    updated: PromptRegistryRef[];
-    /** Slugs present locally and identical in the manifest. */
-    unchanged: PromptRegistryRef[];
-}
-/**
- * Compute what a pull WOULD change, by slug+checksum, against the prompts the
- * caller already has. Pure — no I/O, no writes.
- */
-declare function diffRegistry(local: {
-    slug: string;
-    checksum?: string | undefined;
-}[], manifest: PromptRegistryManifest): RegistryDiff;
-
-/**
- * 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)
- */
-declare const MALFORMED_ARG_MARKERS: readonly ["__raw", "__raw_arguments", "_raw"];
-
-type SpecStatus = 'draft' | 'review' | 'approved' | 'implemented' | 'deprecated';
-type SpecSectionType = 'overview' | 'requirements' | 'architecture' | 'api' | 'data' | 'security' | 'acceptance';
-interface SpecSection {
-    type: SpecSectionType;
-    title: string;
-    content: string;
-    level: number;
-    children?: SpecSection[] | undefined;
-}
-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;
-}
-interface SpecApiEndpoint {
-    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
-    path: string;
-    description: string;
-    request?: Record<string, unknown>;
-    response?: Record<string, unknown>;
-    auth?: boolean | undefined;
-}
-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>;
-}
-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[];
-}
-interface SpecValidationResult {
-    valid: boolean;
-    errors: {
-        path: string;
-        message: string;
-    }[];
-    warnings: {
-        path: string;
-        message: string;
-    }[];
-}
-interface SpecTemplate {
-    id: string;
-    name: string;
-    description: string;
-    sections: Omit<SpecSection, 'content'>[];
-    defaultRequirements: Omit<SpecRequirement, 'id' | 'description'>[];
-}
-declare const DEFAULT_SPEC_TEMPLATE: SpecTemplate;
-
-/** Union of serial and parallel autonomy engine stage types (from EternalAutonomyEngine / ParallelEternalEngine). */
-type AutonomyStage = IterationStage | ParallelIterationStage;
-
-/**
- * Shared type-level utilities used across WrongStack packages.
- *
- * These are pure type helpers with no runtime footprint. They solve
- * recurring TypeScript pattern problems that the standard library
- * types (Pick, Omit, Partial, etc.) don't handle well — particularly
- * around discriminated unions and distribution.
- */
-/**
- * Distributive version of the built-in {@link Omit}.
- *
- * **Why this exists:** The standard `Omit<T, K>` is defined as
- * `Pick<T, Exclude<keyof T, K>>`. When `T` is a discriminated union,
- * `keyof T` returns the *intersection* of all members' keys — not
- * what you want. `Omit<{ a: 1 } | { b: 2 }, 'id'>` collapses to `{}`.
- *
- * `DistributiveOmit` forces distribution over each union member via
- * a conditional type (`T extends unknown`), yielding the expected
- * result: `Omit<{ a: 1 }, 'id'> | Omit<{ b: 2 }, 'id'>`.
- *
- * @example
- * ```ts
- * type Entry = { id: number; kind: 'user'; text: string }
- *            | { id: number; kind: 'tool'; name: string };
- *
- * type Broken  = Omit<Entry, 'id'>;            // {}
- * type Working = DistributiveOmit<Entry, 'id'>; // { kind: 'user'; text } | { kind: 'tool'; name }
- * ```
- */
-type DistributiveOmit<T, K extends string | number | symbol> = T extends unknown ? Omit<T, K> : never;
-
-export { type AutonomyStage, DEFAULT_SPEC_TEMPLATE, type DistributiveOmit, type InstalledPromptEntry, MALFORMED_ARG_MARKERS, type ManifestValidation, PromptCategory, type PromptManifestData, type PromptRegistryManifest, type PromptRegistryRef, type RegistryDiff, type SpecAnalysis, type SpecApiEndpoint, type SpecRequirement, type SpecSection, type SpecSectionType, type SpecStatus, type SpecTemplate, type SpecValidationResult, type Specification, diffRegistry, validateRegistryManifest };
+export * from './blocks.js';
+export * from './messages.js';
+export * from './tool.js';
+export * from './tool-markers.js';
+export * from './side-effect.js';
+export * from './provider.js';
+export { StreamHangError } from './provider.js';
+export * from './provider-runner.js';
+export * from './config.js';
+export * from './hooks.js';
+export type { Compactor, CompactReport } from './compactor.js';
+export * from './permission.js';
+export * from './session.js';
+export * from './session-rewinder.js';
+export * from './attachment.js';
+export * from './default-config.js';
+export * from './memory.js';
+export * from './skill.js';
+export * from './prompt.js';
+export * from './prompt-registry.js';
+export * from './design-kit.js';
+export * from './system-prompt.js';
+export * from './renderer.js';
+export * from './input-reader.js';
+export * from './plugin.js';
+export * from './errors.js';
+export * from './models-registry.js';
+export * from './mode.js';
+export * from './context-window.js';
+export * from './context-evidence.js';
+export * from './multi-agent.js';
+export * from './spec.js';
+export * from './task-graph.js';
+export * from './slash-command.js';
+export * from './observability.js';
+export * from './system-prompt-contributor.js';
+export * from '../storage/session-reader.js';
+export * from './autonomy.js';
+export * from './utility-types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/D,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC"}

package/dist/types/index.js

@@ -1,8 +1,3 @@
-import * as path2 from 'path';
-import { readFileSync, statSync } from 'fs';
-import { fileURLToPath } from 'url';
-import * as fs from 'fs/promises';
-
 // src/types/blocks.ts
 function isTextBlock(b) {
   return b.type === "text";
@@ -38,7 +33,7 @@ function toErrorMessage(err) {
 // src/utils/expect-defined.ts
 function expectDefined(value, label) {
   if (value === null || value === void 0) {
-    const err = new Error("Expected value to be defined");
+    const err = new Error(label ? `Expected ${label} to be defined` : "Expected value to be defined");
     err.name = "ExpectDefinedError";
     throw err;
   }
@@ -80,13 +75,16 @@ function compileUserRegex(pattern, flags) {
     };
   }
 }
+
+// src/utils/session-scoped-path.ts
+import * as path from "node:path";
 function sessionScopedPath(dir, sessionId, suffix) {
   if (!sessionId || sessionId.includes("\\") || sessionId.includes("..")) {
     throw invalid(sessionId);
   }
-  const resolved = path2.resolve(dir, `${sessionId}${suffix}`);
-  const rel = path2.relative(path2.resolve(dir), resolved);
-  if (rel.startsWith("..") || path2.isAbsolute(rel)) {
+  const resolved = path.resolve(dir, `${sessionId}${suffix}`);
+  const rel = path.relative(path.resolve(dir), resolved);
+  if (rel.startsWith("..") || path.isAbsolute(rel)) {
     throw invalid(sessionId);
   }
   return resolved;
@@ -738,6 +736,11 @@ function isDesignStack(v) {
 function flattenSystemPromptRegions(regions) {
   return [...regions.core, ...regions.session, ...regions.volatile];
 }
+
+// src/types/mode-prompts.ts
+import { readFileSync, statSync } from "node:fs";
+import * as path2 from "node:path";
+import { fileURLToPath } from "node:url";
 function modePrompt(id) {
   for (const dir of modePromptDirCandidates()) {
     try {
@@ -1139,6 +1142,9 @@ function deserializeTaskGraph(input) {
   }
   return { ...input, nodes };
 }
+
+// src/storage/session-reader.ts
+import * as fs from "node:fs/promises";
 var DefaultSessionReader = class _DefaultSessionReader {
   store;
   eventCache = /* @__PURE__ */ new Map();
@@ -1476,6 +1482,8 @@ function renderMarkdown(meta, events) {
         lines.push("");
         break;
       }
+      default:
+        break;
     }
   }
   return lines.join("\n");
@@ -1509,11 +1517,81 @@ function renderPlainText(meta, events) {
       case "error":
         lines.push(`[${e.ts}] ERROR (${e.phase}): ${e.message}`);
         break;
+      default:
+        break;
     }
   }
   return lines.join("\n");
 }
-
-export { AgentError, BUILTIN_PROMPT_CATEGORIES, CONTEXT_WINDOW_MODES, ConfigError, DEFAULT_AUTONOMY_CONFIG, DEFAULT_CIRCUIT_BREAKER_CONFIG, DEFAULT_CONTEXT_CONFIG, DEFAULT_CONTEXT_WINDOW_MODE_ID, DEFAULT_MODES, DEFAULT_SESSION_LOGGING_CONFIG, DEFAULT_SESSION_PRUNE_DAYS, DEFAULT_SPEC_TEMPLATE, DEFAULT_TOOLS_CONFIG, DEFAULT_TUI_THINKING_WORD, DESIGN_STACKS, DefaultSessionReader, ERROR_CODES, FetchError, FsError, MALFORMED_ARG_MARKERS, MAX_TUI_THINKING_WORD_LENGTH, MEMORY_TYPE_LABELS, PROMPT_CATEGORY_LABELS, ParseError, PluginError, ProviderError, SddError, SessionError, StreamHangError, ToolError, ToolErrorCategory, ToolValidationError, WrongStackError, classifyProviderError, computeTaskProgress, deserializeTaskGraph, diffRegistry, effectiveInputTokens, findCriticalPath, flattenSystemPromptRegions, formatContextWindowModeList, getContextWindowMode, isAgentError, isBuiltinCategory, isConfigError, isContextWindowModeId, isDesignStack, isFetchError, isFsError, isImageBlock, isParseError, isPluginError, isRetryableKind, isSddError, isSessionError, isTextBlock, isToolError, isToolResultBlock, isToolUseBlock, isToolValidationError, isWrongStackError, listContextWindowModes, normalizeTokenSavingTier, normalizeTuiThinkingWord, resolveContextWindowPolicy, serializeTaskGraph, toWrongStackError, topologicalSort, validateRegistryManifest };
+export {
+  AgentError,
+  BUILTIN_PROMPT_CATEGORIES,
+  CONTEXT_WINDOW_MODES,
+  ConfigError,
+  DEFAULT_AUTONOMY_CONFIG,
+  DEFAULT_CIRCUIT_BREAKER_CONFIG,
+  DEFAULT_CONTEXT_CONFIG,
+  DEFAULT_CONTEXT_WINDOW_MODE_ID,
+  DEFAULT_MODES,
+  DEFAULT_SESSION_LOGGING_CONFIG,
+  DEFAULT_SESSION_PRUNE_DAYS,
+  DEFAULT_SPEC_TEMPLATE,
+  DEFAULT_TOOLS_CONFIG,
+  DEFAULT_TUI_THINKING_WORD,
+  DESIGN_STACKS,
+  DefaultSessionReader,
+  ERROR_CODES,
+  FetchError,
+  FsError,
+  MALFORMED_ARG_MARKERS,
+  MAX_TUI_THINKING_WORD_LENGTH,
+  MEMORY_TYPE_LABELS,
+  PROMPT_CATEGORY_LABELS,
+  ParseError,
+  PluginError,
+  ProviderError,
+  SddError,
+  SessionError,
+  StreamHangError,
+  ToolError,
+  ToolErrorCategory,
+  ToolValidationError,
+  WrongStackError,
+  classifyProviderError,
+  computeTaskProgress,
+  deserializeTaskGraph,
+  diffRegistry,
+  effectiveInputTokens,
+  findCriticalPath,
+  flattenSystemPromptRegions,
+  formatContextWindowModeList,
+  getContextWindowMode,
+  isAgentError,
+  isBuiltinCategory,
+  isConfigError,
+  isContextWindowModeId,
+  isDesignStack,
+  isFetchError,
+  isFsError,
+  isImageBlock,
+  isParseError,
+  isPluginError,
+  isRetryableKind,
+  isSddError,
+  isSessionError,
+  isTextBlock,
+  isToolError,
+  isToolResultBlock,
+  isToolUseBlock,
+  isToolValidationError,
+  isWrongStackError,
+  listContextWindowModes,
+  normalizeTokenSavingTier,
+  normalizeTuiThinkingWord,
+  resolveContextWindowPolicy,
+  serializeTaskGraph,
+  toWrongStackError,
+  topologicalSort,
+  validateRegistryManifest
+};
 //# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map