@wrongstack/core 0.284.0 → 0.285.0

package/dist/types/plugin.d.ts

@@ -0,0 +1,385 @@
+import type { Mailbox } from '../coordination/mailbox-types.js';
+import type { ToolCallPipelinePayload } from '../core/agent.js';
+import type { Context } from '../core/context.js';
+import type { ExtensionRegistry } from '../extension/registry.js';
+import type { Container } from '../kernel/container.js';
+import type { EventBus, EventName, Listener } from '../kernel/events.js';
+import type { ReadonlyPipeline } from '../kernel/pipeline.js';
+import type { ToolWrapper } from '../registry/tool-registry.js';
+import type { TextBlock } from './blocks.js';
+import type { Config } from './config.js';
+import type { HookEvent, HookMatcher, HookRegistrationOptions, InProcessHook } from './hooks.js';
+import type { Logger } from './logger.js';
+import type { ModelsRegistry, WireFamily } from './models-registry.js';
+import type { Provider, Request, Response } from './provider.js';
+import type { SlashCommand } from './slash-command.js';
+import type { SystemPromptContributor } from './system-prompt-contributor.js';
+import type { JSONSchema, Tool } from './tool.js';
+export interface ToolRegistryView {
+    register(t: Tool): void;
+    unregister(name: string): void;
+    /** Wrap (decorate) an existing tool. The wrapper gets the current tool and returns the decorated version. */
+    wrap(name: string, wrapper: ToolWrapper): void;
+    get(name: string): Tool | undefined;
+    list(): Tool[];
+}
+export interface ProviderFactory {
+    type: string;
+    family: WireFamily;
+    create(cfg: unknown): Provider;
+}
+export interface ProviderRegistryView {
+    register(f: ProviderFactory): void;
+    unregister(type: string): boolean;
+    create(cfg: {
+        type: string;
+    } & Record<string, unknown>): Provider;
+    list(): string[];
+}
+export interface MCPRegistryView {
+    start(cfg: unknown): Promise<void>;
+    stop(name: string): Promise<void>;
+    restart(name: string): Promise<void>;
+    list(): {
+        name: string;
+        state: string;
+        toolCount: number;
+    }[];
+}
+export interface SlashCommandRegistryView {
+    register(cmd: SlashCommand): void;
+    unregister(name: string): boolean;
+    get(name: string): SlashCommand | undefined;
+    list(): SlashCommand[];
+}
+/**
+ * Read-only view of the session writer. Plugins can append custom events
+ * to the JSONL session log and read the transcript path.
+ *
+ * The `append` method accepts any JSON-serializable payload — custom
+ * event types are persisted verbatim next to the built-in events.
+ */
+export interface SessionWriterView {
+    readonly transcriptPath?: string | undefined;
+    append(event: Record<string, unknown> & {
+        type: string;
+        ts: string;
+    }): Promise<void>;
+}
+/**
+ * Metrics sink scoped to a plugin. The host auto-prefixes metric names
+ * with `plugin.<pluginName>.` so plugins don't need to namespace
+ * manually. Plugins call counter/histogram/gauge directly; the values
+ * flow to the host's MetricsSink (Prometheus, OTLP, or noop).
+ */
+export interface MetricsSinkView {
+    counter(name: string, value?: number | undefined, labels?: Record<string, string>): void;
+    histogram(name: string, value: number, labels?: Record<string, string>): void;
+    gauge(name: string, value: number, labels?: Record<string, string>): void;
+}
+/**
+ * Options for a single `api.llm.complete()` call. Everything is
+ * optional — omitted fields fall back first to the plugin's own
+ * configured defaults (`config.extensions[<name>].llm`), then to the
+ * host session's provider/model.
+ */
+export interface PluginLLMOptions {
+    /** System prompt for this call. */
+    system?: string | undefined;
+    /** Model override (e.g. `claude-haiku-4-5`). */
+    model?: string | undefined;
+    /**
+     * Provider override by configured provider name (a key of
+     * `config.providers`, e.g. `anthropic`, `openai`, `omniroute`).
+     * When omitted the host session's provider is used.
+     */
+    provider?: string | undefined;
+    /** Output-token cap. Default 2048, hard-capped by the host. */
+    maxTokens?: number | undefined;
+    temperature?: number | undefined;
+    /** `'json'` asks the provider for a JSON object response. */
+    responseFormat?: 'text' | 'json' | undefined;
+    /** Abort signal — plugins should pass one for cancellable work. */
+    signal?: AbortSignal | undefined;
+}
+export interface PluginLLMResult {
+    /** Concatenated text blocks of the response. */
+    text: string;
+    /** The model that actually served the call. */
+    model: string;
+    /** The provider name the call was routed through. */
+    provider: string;
+    usage: {
+        input: number;
+        output: number;
+    };
+    stopReason: string;
+}
+/**
+ * LLM access for plugins, routed through the host's provider layer —
+ * plugins never handle API keys themselves. Resolution order for
+ * provider/model on each call:
+ *
+ *   1. `PluginLLMOptions.provider` / `.model` (per call)
+ *   2. `config.extensions[<plugin>].llm.provider` / `.model` (per plugin)
+ *   3. the host session's active provider/model (default)
+ *
+ * Exposed as `api.llm` — `undefined` on minimal hosts (tests, the LSP
+ * server) that have no provider wired. Always guard:
+ * `if (!api.llm) return;`
+ */
+export interface PluginLLM {
+    /** The effective defaults for this plugin (after config resolution). */
+    defaults(): {
+        provider: string;
+        model: string;
+    };
+    /** One-shot completion. Throws on provider errors. */
+    complete(prompt: string, opts?: PluginLLMOptions): Promise<PluginLLMResult>;
+}
+export interface PluginPipelines {
+    request: ReadonlyPipeline<Request>;
+    response: ReadonlyPipeline<Response>;
+    toolCall: ReadonlyPipeline<ToolCallPipelinePayload>;
+    userInput: ReadonlyPipeline<{
+        content: import('./blocks.js').ContentBlock[];
+        text: string;
+        ctx: Context;
+    }>;
+    assistantOutput: ReadonlyPipeline<TextBlock>;
+    contextWindow: ReadonlyPipeline<Context>;
+    [k: string]: ReadonlyPipeline<any>;
+}
+export interface PluginAPI {
+    container: Container;
+    pipelines: PluginPipelines;
+    events: EventBus;
+    tools: ToolRegistryView;
+    providers: ProviderRegistryView;
+    mcp: MCPRegistryView;
+    slashCommands: SlashCommandRegistryView;
+    /** Live session writer — plugins can append custom events here. */
+    session: SessionWriterView;
+    /** Scoped metrics sink — counters/histograms/gauges auto-namespaced under `plugin.<name>.` */
+    metrics: MetricsSinkView;
+    /** Registry for agent lifecycle extensions — hooks like beforeRun, beforeIteration, onError, etc. */
+    extensions: ExtensionRegistry;
+    /**
+     * Register a system prompt contributor. Plugins call this to inject
+     * ephemeral TextBlocks into the system prompt on every build.
+     * Returns an unregister function.
+     */
+    registerSystemPromptContributor(c: SystemPromptContributor): () => void;
+    /**
+     * Register an in-process lifecycle hook. `matcher` is a tool-name filter for
+     * `PreToolUse`/`PostToolUse` (`"Bash"`, `"edit|write"`, `"*"`) and ignored
+     * for other events. The hook can block, rewrite tool input, or inject extra
+     * context — see `HookOutcome`. Automatically removed when the plugin is
+     * uninstalled. Returns an unregister function.
+     */
+    registerHook(event: HookEvent, matcher: HookMatcher | undefined, hook: InProcessHook, options?: HookRegistrationOptions | undefined): () => void;
+    config: Config;
+    log: Logger;
+    /**
+     * Register a one-time event listener. The handler is automatically removed
+     * after the first emission, or when the plugin is uninstalled — whichever
+     * comes first.
+     */
+    onEvent<K extends EventName>(event: K, handler: Listener<K>): () => void;
+    /**
+     * Subscribe to all events matching a glob-style pattern.
+     * `'tool.*'` matches all tool events. `'*'` matches everything.
+     * Returns an unsubscribe function.
+     */
+    onPattern(pattern: string, handler: (event: string, payload: unknown) => void): () => void;
+    /**
+     * Emit a custom event on the agent's EventBus. Use for inter-plugin
+     * communication or to surface plugin-specific state to the host.
+     *
+     * Custom events use a `pluginName:eventName` convention to avoid
+     * collisions with built-in events (e.g. `my-plugin:cache_hit`).
+     * The payload is passed through to all subscribers.
+     */
+    emitCustom(event: string, payload: unknown): void;
+    /**
+     * Register a callback that fires when the configuration changes at
+     * runtime (e.g. via `/config` slash command or programmatic update).
+     * The handler receives the new and previous config snapshots.
+     * Returns an unsubscribe function.
+     */
+    onConfigChange(handler: (next: Readonly<Config>, prev: Readonly<Config>) => void): () => void;
+    /**
+     * The models registry (models.dev-backed catalog of providers, models,
+     * and per-token pricing). Optional — some hosts may not construct one
+     * (e.g. minimal CLI invocations, tests). Plugins that need pricing
+     * data (cost-tracker, billing reports) should treat this as the
+     * preferred source when present and fall back to a bundled table
+     * otherwise.
+     */
+    modelsRegistry?: ModelsRegistry | undefined;
+    /**
+     * The host's project-level mailbox. Optional — minimal hosts (tests,
+     * standalone CLI invocations, the LSP server) may not construct one.
+     * Plugins that publish status to other agents (todo-listener,
+     * session-recap) should treat this as the preferred source when present
+     * and gracefully no-op otherwise.
+     */
+    mailbox?: Mailbox | undefined;
+    /**
+     * LLM access routed through the host's provider layer. Optional —
+     * minimal hosts without a wired provider omit it; plugins must guard
+     * (`if (!api.llm) …`). Per-plugin provider/model defaults come from
+     * `config.extensions[<name>].llm = { provider, model }`.
+     */
+    llm?: PluginLLM | undefined;
+}
+/**
+ * Capability declaration — informs the host which subsystems a plugin
+ * intends to touch. Used for diagnostics and per-plugin enable/disable UX
+ * (e.g. "this plugin registers tools — disable to remove them"). Not
+ * enforced at runtime: a plugin that declares `tools: false` can still
+ * call `api.tools.register()`, but the host can flag the discrepancy.
+ */
+export interface PluginCapabilities {
+    /** Will register tools via `api.tools.register()`. */
+    tools?: boolean | undefined;
+    /** Will register provider factories via `api.providers.register()`. */
+    providers?: boolean | undefined;
+    /**
+     * Pipelines the plugin hooks into. Use the standard names
+     * (`request | response | toolCall | userInput | assistantOutput | contextWindow`)
+     * or custom pipeline names exposed by other plugins.
+     */
+    pipelines?: string[] | undefined;
+    /** Will register slash commands via `api.slashCommands.register()`. */
+    slashCommands?: boolean | undefined;
+    /** Will start MCP servers via `api.mcp.start()`. */
+    mcp?: boolean | undefined;
+    /**
+     * Capabilities required to mutate (wrap, unregister, override) tools
+     * the plugin does not own. If empty or omitted, the plugin may only
+     * mutate its own tools. Official plugins bypass this check.
+     *
+     * Example: `['fs.read', 'net.outbound']` allows the plugin to wrap
+     * read-only tools, but not `fs.write` or `shell.arbitrary` tools.
+     */
+    toolMutateCapabilities?: string[] | undefined;
+    /**
+     * Will register in-process lifecycle hooks via `api.registerHook()`. When
+     * false (or omitted by a non-official plugin), the loader either logs a
+     * warning or throws — see `LoadPluginsOptions.enforceCapabilities`.
+     * Official plugins are not gated.
+     */
+    hooks?: boolean | undefined;
+}
+/**
+ * Structured dependency declaration. The string form (`dependsOn: ['foo']`)
+ * is shorthand for `[{ name: 'foo' }]` — both work. Use the structured form
+ * when you need a version constraint:
+ *
+ *   dependsOn: [{ name: 'wstack-auth', version: '^1.2.0' }]
+ */
+export interface PluginDependency {
+    name: string;
+    /** npm-style semver range. Supports `^`, `~`, exact, and unprefixed. */
+    version?: string | undefined;
+}
+export interface Plugin {
+    name: string;
+    version?: string | undefined;
+    /** One-line summary for `wstack plugins list` and error messages. */
+    description?: string | undefined;
+    /** Semver range against the kernel API version (KERNEL_API_VERSION). */
+    apiVersion: string;
+    /**
+     * Capability hints — what subsystems the plugin will register against.
+     * Optional; provided for diagnostics and UX. The loader does not enforce
+     * these, but mismatch is surfaced via logger at warn level.
+     */
+    capabilities?: PluginCapabilities | undefined;
+    /**
+     * JSON Schema for the options under `Config.plugins[<name>].options`.
+     * When present, the loader validates that section before calling `setup`
+     * and rejects the plugin with a clear error path on failure.
+     */
+    configSchema?: JSONSchema | undefined;
+    /**
+     * Mandatory plugin dependencies — loading fails if any are absent or
+     * version-incompatible. Accepts both the legacy string-array form and
+     * the structured form with version constraints.
+     */
+    dependsOn?: (string | PluginDependency)[] | undefined;
+    /** Optional plugin dependencies — silently skipped if absent. */
+    optionalDeps?: (string | PluginDependency)[] | undefined;
+    conflictsWith?: string[] | undefined;
+    /**
+     * Default configuration values, deep-merged under the plugin's options
+     * key before `configSchema` validation. User-provided values take
+     * precedence over defaults — this is a fallback, not an override.
+     *
+     * @example
+     * defaultConfig: { ttl: 3600, maxSize: 100 }
+     */
+    defaultConfig?: Record<string, unknown>;
+    /**
+     * Called by the host to activate the plugin. Receives the `PluginAPI`
+     * and an optional `AbortSignal` the plugin should respect for
+     * cancellation and timeout. `setup` must complete before the plugin is
+     * considered loaded; if it times out the plugin is rejected.
+     */
+    setup(api: PluginAPI, opts?: {
+        signal?: AbortSignal | undefined;
+    }): void | Promise<void>;
+    /**
+     * Called by the host during unload. Receives the same `PluginAPI` instance
+     * the plugin saw during `setup` and an optional `AbortSignal`. Teardown
+     * is best-effort — a timeout does not prevent other plugins from unloading.
+     */
+    teardown?(api: PluginAPI, opts?: {
+        signal?: AbortSignal | undefined;
+    }): void | Promise<void>;
+    /**
+     * Optional health check. Called by the host (e.g. `/diag plugins` slash
+     * command or health endpoint) to surface plugin status. Return
+     * `{ ok: false, message: '...' }` when the plugin is degraded.
+     */
+    health?(): Promise<{
+        ok: boolean;
+        message?: string | undefined;
+    }>;
+    /**
+     * Optional runtime descriptor. Plugins that spawn a language tool
+     * (`tsc`, `vitest`, `pytest`, `cargo test`, `go test`, …) should
+     * declare the target language, package manager, runner executable,
+     * and default command. The shared runtime helper
+     * (`@wrongstack/plugins/runtime`) consumes this declaration so the
+     * argv-sandboxing and flag-allowlist logic live in one place.
+     *
+     * Declaring a runtime is a UX hint today — the loader surfaces it in
+     * `/diag plugins` and the audit report. It will become a requirement
+     * for plugins that spawn language tools in a future release.
+     */
+    runtime?: PluginRuntime | undefined;
+}
+/**
+ * Plugin runtime declaration. The shared runtime helper
+ * (`@wrongstack/plugins/runtime`) is the source of truth for the
+ * shape and validation; this type lives in core so plugin manifests
+ * can depend on it without crossing the plugin boundary.
+ */
+export interface PluginRuntime {
+    /** Stable identifier for diagnostics and listing (e.g. "typescript"). */
+    language: string;
+    /** Default package manager launcher (e.g. "pnpm"). "none" for bare-binary use. */
+    packageManager: 'none' | 'npm' | 'pnpm' | 'yarn' | 'bun' | 'pip' | 'poetry' | 'go' | 'cargo' | 'gem' | 'maven' | 'gradle' | 'dotnet';
+    /** Runner executable token, e.g. "tsc", "vitest", "pytest", "test" (cargo), "test" (go). */
+    executable: string;
+    /**
+     * Default command spelling used when the plugin has no user-supplied
+     * command. Must be parseable by the shared runtime helper — typically
+     * the launcher followed by `subcommand executable …flags`, or the
+     * bare executable.
+     */
+    defaultCommand: string;
+}
+//# sourceMappingURL=plugin.d.ts.map

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

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

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

@@ -0,0 +1,81 @@
+/**
+ * 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".
+ */
+import type { PromptCategory } from './prompt.js';
+export 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;
+}
+export 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`. */
+export 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;
+}
+export interface PromptManifestData {
+    version: 1;
+    entries: InstalledPromptEntry[];
+}
+/** Result of validating an untrusted manifest. */
+export 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.
+ */
+export declare function validateRegistryManifest(raw: unknown): ManifestValidation;
+export 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.
+ */
+export declare function diffRegistry(local: {
+    slug: string;
+    checksum?: string | undefined;
+}[], manifest: PromptRegistryManifest): RegistryDiff;
+//# sourceMappingURL=prompt-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-registry.d.ts","sourceRoot":"","sources":["../../src/types/prompt-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,eAAe,EAAE,CAAC,CAAC;IACnB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,oEAAoE;AACpE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,oBAAoB,EAAE,CAAC;CACjC;AAED,kDAAkD;AAClD,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,sBAAsB,CAAA;CAAE,GAC9C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAMpC;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CAsEzE;AAED,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,wEAAwE;IACxE,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,2DAA2D;IAC3D,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EAAE,EACxD,QAAQ,EAAE,sBAAsB,GAC/B,YAAY,CASd"}

package/dist/{prompt-DLd35n4Q.d.ts → types/prompt.d.ts}

@@ -5,28 +5,28 @@
  * without creating a cycle.
  */
 /** Provenance of a prompt — which layer it came from. */
-type PromptSource = 'builtin' | 'user' | 'project' | 'synced';
+export type PromptSource = 'builtin' | 'user' | 'project' | 'synced';
 /**
  * The fourteen first-party categories shipped with the builtin dataset, plus
  * the `uncategorized` sentinel used when migrating legacy v1 entries. Builtin
  * prompts MUST use one of these (enforced by the dataset schema test); user and
  * project prompts may use any free-form string.
  */
-declare const BUILTIN_PROMPT_CATEGORIES: readonly ["coding", "debugging", "refactoring", "testing", "code-review", "architecture", "devops", "documentation", "data-analysis", "writing", "research", "product", "agentic-workflows", "meta-prompting", "uncategorized"];
-type BuiltinPromptCategory = (typeof BUILTIN_PROMPT_CATEGORIES)[number];
+export declare const BUILTIN_PROMPT_CATEGORIES: readonly ['coding', 'debugging', 'refactoring', 'testing', 'code-review', 'architecture', 'devops', 'documentation', 'data-analysis', 'writing', 'research', 'product', 'agentic-workflows', 'meta-prompting', 'uncategorized'];
+export type BuiltinPromptCategory = (typeof BUILTIN_PROMPT_CATEGORIES)[number];
 /**
  * Human-readable labels for the builtin categories (for UI chips / pickers).
  */
-declare const PROMPT_CATEGORY_LABELS: Record<BuiltinPromptCategory, string>;
+export declare const PROMPT_CATEGORY_LABELS: Record<BuiltinPromptCategory, string>;
 /**
  * A prompt's category. Typed as a free-form string because user/project prompts
  * may invent their own; the builtin dataset is constrained to
  * {@link BUILTIN_PROMPT_CATEGORIES} by its schema.
  */
-type PromptCategory = BuiltinPromptCategory | (string & {});
-declare function isBuiltinCategory(value: string): value is BuiltinPromptCategory;
+export type PromptCategory = BuiltinPromptCategory | (string & {});
+export declare function isBuiltinCategory(value: string): value is BuiltinPromptCategory;
 /** A `{{name}}` placeholder declared by a prompt. */
-interface PromptVariable {
+export interface PromptVariable {
     /** Placeholder name as it appears between `{{ }}` (case-sensitive). */
     name: string;
     description?: string | undefined;
@@ -49,7 +49,7 @@ interface PromptVariable {
  * A reusable prompt. v2 schema. Legacy v1 entries (only `id/title/content/tags/
  * createdAt/updatedAt`) are upgraded lazily on read by `migratePromptEntry`.
  */
-interface PromptEntry {
+export interface PromptEntry {
     /** Stable unique handle (ULID for new entries; legacy short hex tolerated). */
     id: string;
     /** kebab-case stable key — the dedup key across layers and registry key. */
@@ -76,12 +76,12 @@ interface PromptEntry {
     updatedAt: string;
 }
 /** One category with its prompt count, for picker chips. */
-interface PromptCategoryCount {
+export interface PromptCategoryCount {
     id: PromptCategory;
     label: string;
     count: number;
 }
-interface PromptSearchOptions {
+export interface PromptSearchOptions {
     category?: PromptCategory | undefined;
     /** Max results (default: unbounded). */
     limit?: number | undefined;
@@ -90,7 +90,7 @@ interface PromptSearchOptions {
  * Read-side contract over the three prompt layers (project > user > builtin),
  * merged and de-duplicated by slug. Mirrors `SkillLoader` in shape.
  */
-interface PromptLoader {
+export interface PromptLoader {
     /** All prompts across layers, project/user shadowing builtin by slug. */
     list(): Promise<PromptEntry[]>;
     /** Resolve by slug first, then by id. */
@@ -120,14 +120,14 @@ interface PromptLoader {
  * The packed builtin index (also the shape a remote registry manifest mirrors
  * — see `types/prompt-registry.ts`).
  */
-interface PromptManifest {
+export interface PromptManifest {
     datasetVersion: number;
     generatedAt: string;
     count: number;
     categories: PromptCategoryCount[];
     prompts: PromptManifestRef[];
 }
-interface PromptManifestRef {
+export interface PromptManifestRef {
     id: string;
     slug: string;
     title: string;
@@ -138,5 +138,4 @@ interface PromptManifestRef {
     /** Relative path of the per-prompt file within the dataset. */
     file: string;
 }
-
-export { BUILTIN_PROMPT_CATEGORIES as B, type PromptLoader as P, type PromptEntry as a, type PromptSearchOptions as b, type PromptCategoryCount as c, type BuiltinPromptCategory as d, PROMPT_CATEGORY_LABELS as e, type PromptCategory as f, type PromptManifest as g, type PromptManifestRef as h, type PromptSource as i, type PromptVariable as j, isBuiltinCategory as k };
+//# sourceMappingURL=prompt.d.ts.map

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

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

package/dist/{provider-runner-ChL-kVg6.d.ts → types/provider-runner.d.ts}

@@ -1,15 +1,15 @@
-import { E as EventBus } from './events-Bgnh43r9.js';
-import { L as Logger } from './logger-B63L5bTg.js';
-import { T as Tracer } from './observability-D-HZN_mF.js';
-import { P as Provider, c as Request, d as Context, e as Response } from './tool-BNlnIJvo.js';
-import { R as RetryPolicy } from './retry-policy-CQ7KwXJa.js';
-
+import type { EventBus } from '../kernel/events.js';
+import type { Logger } from './logger.js';
+import type { Tracer } from './observability.js';
+import type { Provider, Request, Response } from './provider.js';
+import type { RetryPolicy } from './retry-policy.js';
+import type { Context } from '../core/context.js';
 /**
  * Options passed to a ProviderRunner when calling the provider.
  * Shape intentionally mirrors runProviderWithRetry's parameters
  * so the default implementation is a thin wrapper.
  */
-interface RunProviderOptions {
+export interface RunProviderOptions {
     provider: Provider;
     request: Request;
     signal: AbortSignal;
@@ -29,8 +29,7 @@ interface RunProviderOptions {
  * For lighter-weight wrapping (add middleware without replacing),
  * use `AgentExtension.wrapProviderRunner` via the ExtensionRegistry.
  */
-interface ProviderRunner {
+export interface ProviderRunner {
     run(opts: RunProviderOptions): Promise<Response>;
 }
-
-export type { ProviderRunner as P, RunProviderOptions as R };
+//# sourceMappingURL=provider-runner.d.ts.map

package/dist/types/provider-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-runner.d.ts","sourceRoot":"","sources":["../../src/types/provider-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,QAAQ,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAClD"}