@cjhyy/code-shell 0.3.0 → 0.5.0-rc.2

package/dist/plugins/installedPlugins.d.ts

@@ -1,15 +0,0 @@
-/**
- * Read/write ~/.code-shell/plugins/installed_plugins.json (V2 format).
- * Byte-compatible with Claude Code's analogous file.
- */
-import type { InstalledPluginsV2, PluginInstallEntry } from "./types.js";
-export declare function installedPluginsPath(): string;
-export declare function readInstalledPlugins(): InstalledPluginsV2;
-export declare function writeInstalledPlugins(data: InstalledPluginsV2): void;
-/**
- * Append an install entry for `<plugin>@<marketplace>`. Multiple entries
- * for the same key are allowed (different scopes); MVP only writes scope:"user".
- */
-export declare function appendInstallEntry(key: string, entry: PluginInstallEntry): void;
-export declare function removeInstallEntries(key: string): boolean;
-export declare function pluginInstallKey(plugin: string, marketplace: string): string;

package/dist/plugins/knownMarketplaces.d.ts

@@ -1,10 +0,0 @@
-/**
- * Read/write ~/.code-shell/plugins/known_marketplaces.json.
- * File format is byte-compatible with Claude Code's analogous file.
- */
-import type { KnownMarketplaces, KnownMarketplace } from "./types.js";
-export declare function knownMarketplacesPath(): string;
-export declare function readKnownMarketplaces(): KnownMarketplaces;
-export declare function writeKnownMarketplaces(data: KnownMarketplaces): void;
-export declare function upsertKnownMarketplace(name: string, entry: KnownMarketplace): void;
-export declare function removeKnownMarketplace(name: string): boolean;

package/dist/plugins/loadPluginHooks.d.ts

@@ -1,52 +0,0 @@
-/**
- * loadPluginHooks — scan every installed plugin's hooks/hooks.json and
- * register the command-type hooks with the engine's HookRegistry.
- *
- * Plugin hooks.json schema (Claude Code-compatible):
- *
- *   {
- *     "hooks": {
- *       "<EventName>": [
- *         {
- *           "matcher": "<regex>",      // optional; semantics depend on event
- *           "hooks": [
- *             {
- *               "type": "command",
- *               "command": "...",      // ${CODESHELL_PLUGIN_ROOT} placeholder
- *               "async": false,        // currently ignored (always sync await)
- *               "timeout_ms": 60000    // optional override
- *             }
- *           ]
- *         }
- *       ]
- *     }
- *   }
- *
- * Event-name mapping (CC PascalCase → codeshell snake_case):
- *   SessionStart       → on_session_start
- *   UserPromptSubmit   → user_prompt_submit
- *   PreToolUse         → pre_tool_use
- *   PostToolUse        → post_tool_use
- *   PreCompact         → pre_compact
- *   Notification       → notification
- *   Stop               → on_session_end
- *   SubagentStop       → (skipped — codeshell sub-agents don't surface this event)
- *
- * matcher semantics:
- *   SessionStart    — matches against ctx.data.source ("startup"|"resume"|"clear"|"compact")
- *   PreToolUse /
- *   PostToolUse     — matches against ctx.data.toolName
- *   other events    — matcher is currently ignored (the CC spec doesn't
- *                     define matcher semantics for them either)
- *
- * Errors are swallowed per-plugin: a malformed hooks.json from one plugin
- * must not block other plugins from loading.
- */
-import type { HookRegistry } from "../hooks/registry.js";
-/**
- * Walk installed plugins and register their command hooks. Safe to call
- * multiple times — the caller is responsible for not double-registering
- * (HookRegistry has no de-dup; the engine constructor calls this exactly
- * once after creating the registry).
- */
-export declare function loadPluginHooks(registry: HookRegistry): void;

package/dist/plugins/marketplaceManager.d.ts

@@ -1,49 +0,0 @@
-/**
- * Marketplace lifecycle: add (clone + validate + persist), remove
- * (delete from disk + manifest), list, load (read marketplace.json on
- * demand). Mirrors Claude Code's utils/plugins/marketplaceManager.ts
- * at the MVP subset (github + git sources only, no auto-update,
- * no policy blocking, no GCS mirror).
- */
-import type { MarketplaceSource, PluginMarketplace } from "./types.js";
-export declare function marketplacesRoot(): string;
-export declare function marketplaceDir(name: string): string;
-export type AddMarketplaceResult = {
-    ok: true;
-    name: string;
-    marketplace: PluginMarketplace;
-    replaced: boolean;
-} | {
-    ok: false;
-    error: string;
-};
-/**
- * Adds a marketplace by cloning it (or refreshing if already present
- * with the same source), validating its marketplace.json, and writing
- * an entry into known_marketplaces.json.
- */
-export declare function addMarketplace(name: string, source: MarketplaceSource): Promise<AddMarketplaceResult>;
-/**
- * Removes a marketplace: deletes the cached clone and the manifest entry.
- * Returns whether anything was actually removed.
- */
-export declare function removeMarketplace(name: string): boolean;
-/**
- * Loads a previously-added marketplace's manifest from disk. Returns null
- * if the marketplace is unknown or the manifest is gone (caller can
- * report to user).
- */
-export declare function loadMarketplace(name: string): PluginMarketplace | null;
-export interface ListedMarketplace {
-    name: string;
-    source: MarketplaceSource;
-    installLocation: string;
-    lastUpdated: string;
-    pluginCount: number;
-}
-/**
- * Lists all known marketplaces with a quick plugin count read from each
- * cached manifest. Marketplaces whose manifest is missing or invalid
- * show pluginCount: -1 so the caller can flag them.
- */
-export declare function listMarketplaces(): ListedMarketplace[];

package/dist/plugins/parseMarketplaceInput.d.ts

@@ -1,16 +0,0 @@
-/**
- * Parse a user-typed marketplace identifier into a MarketplaceSource.
- * MVP subset of Claude Code's utils/plugins/parseMarketplaceInput.ts —
- * local absolute paths, github shorthand, https git URLs, and ssh git URLs.
- */
-import type { MarketplaceSource } from "./types.js";
-/**
- * Returns the parsed source, or null when the input does not match any
- * supported pattern. Callers should show a usage hint on null.
- */
-export declare function parseMarketplaceInput(input: string): MarketplaceSource | null;
-/**
- * Derive a stable marketplace name from a source. Used as the filesystem
- * directory and the key in known_marketplaces.json.
- */
-export declare function deriveMarketplaceName(source: MarketplaceSource): string;

package/dist/plugins/pluginCommandHook.d.ts

@@ -1,54 +0,0 @@
-/**
- * pluginCommandHook — execute a plugin's command-type hook as a child
- * process and translate its stdout into a HookResult.
- *
- * This is the plugin-side analogue of `src/hooks/shell-runner.ts`. The two
- * runners are intentionally separate because they speak different protocols:
- *
- *   src/hooks/shell-runner.ts     codeshell-native: stdout is a HookResult
- *                                 JSON envelope ({ messages, decision, ... }).
- *                                 Used by user-authored settings.hooks.
- *
- *   this file                     CC plugin protocol: stdout is one of
- *                                 - { hookSpecificOutput: { hookEventName, additionalContext } }
- *                                 - { additional_context: "..." }            (Cursor)
- *                                 - { additionalContext: "..." }             (SDK)
- *                                 We normalize all three into HookResult.messages
- *                                 so downstream hook plumbing (inject.ts) is
- *                                 untouched.
- *
- * env contract:
- *   CODESHELL_PLUGIN_ROOT   — set to installPath. Plugin command strings
- *                             reference this via ${CODESHELL_PLUGIN_ROOT}
- *                             (varRewrite.ts rewrites CC's CLAUDE_PLUGIN_ROOT
- *                             to this name at install time).
- *   CODESHELL_HOOK_EVENT    — the codeshell-side event name (snake_case)
- *
- * We deliberately do NOT set CLAUDE_PLUGIN_ROOT here. Plugin scripts that
- * branch on which host they detect (e.g. superpowers' session-start checks
- * `[ -n "${CLAUDE_PLUGIN_ROOT:-}" ]`) get rewritten by varRewrite.ts at
- * install time, so the branch they take after rewrite is the codeshell
- * branch — not the CC one.
- */
-import type { HookContext, HookResult } from "../hooks/events.js";
-export interface PluginCommandHookSpec {
-    /** Shell command line, with ${CODESHELL_PLUGIN_ROOT} placeholder allowed. */
-    command: string;
-    /** Plugin install path; exported as CODESHELL_PLUGIN_ROOT for the child. */
-    installPath: string;
-    /** Plugin install key (`name@marketplace`), used for log lines. */
-    pluginKey: string;
-    /** Per-hook override; falls back to DEFAULT_TIMEOUT_MS. */
-    timeoutMs?: number;
-}
-/**
- * Run one plugin hook command. Returns an empty HookResult on any failure
- * (spawn error, timeout, non-zero exit, unparseable stdout) so the hook
- * chain keeps moving — a misbehaving plugin must not wedge the engine.
- *
- * Stdin carries the same envelope shape the codeshell-native shell-runner
- * uses (eventName + data) so plugin authors who want richer context can
- * read it; CC plugins typically ignore stdin and emit context derived from
- * their own state (e.g. reading a SKILL.md off disk via PLUGIN_ROOT).
- */
-export declare function runPluginCommandHook(spec: PluginCommandHookSpec, ctx: HookContext): Promise<HookResult>;

package/dist/plugins/pluginCommandsLoader.d.ts

@@ -1,25 +0,0 @@
-/**
- * Discover plugin-provided slash commands. For each installed plugin,
- * walks <installPath>/commands/*.md and returns one PluginCommand per
- * markdown file. Mirrors Claude Code's loadPluginCommands.ts at the
- * MVP subset (single-level commands directory, no nested subcommands,
- * no inline-via-plugin.json commands).
- */
-export interface PluginCommand {
-    /** Namespaced name, e.g. "superpowers:brainstorming" */
-    name: string;
-    /** Plain command (without plugin prefix), e.g. "brainstorming" */
-    commandName: string;
-    /** Plugin id (without @marketplace), e.g. "superpowers" */
-    pluginName: string;
-    /** Frontmatter description, coerced. May be empty. */
-    description: string;
-    /** Frontmatter "argument-hint" if present. */
-    argumentHint?: string;
-    /** Body of the .md (frontmatter stripped). */
-    body: string;
-    /** Absolute path to the .md file. */
-    filePath: string;
-}
-export declare function scanPluginCommands(): PluginCommand[];
-export declare function invalidatePluginCommandsCache(): void;

package/dist/plugins/pluginInstaller.d.ts

@@ -1,36 +0,0 @@
-/**
- * Install / uninstall plugins from a known marketplace. Mirrors Claude
- * Code's installResolvedPlugin pattern at the MVP subset: four entry
- * source types (path / git / github / git-subdir), no dependencies, no
- * sparse-checkout, no npm/pip.
- */
-import type { PluginInstallEntry } from "./types.js";
-export interface VarRewriteReport {
-    filesScanned: number;
-    filesRewritten: number;
-}
-export type InstallResult = {
-    ok: true;
-    entry: PluginInstallEntry;
-    freshlyCloned: boolean;
-    varRewrite: VarRewriteReport;
-} | {
-    ok: false;
-    error: string;
-};
-/**
- * Install a plugin from a previously-added marketplace into the user
- * cache. Idempotent within a process: re-installing replaces the
- * cached files and updates the manifest entry.
- */
-export declare function installPlugin(pluginName: string, marketplaceName: string): Promise<InstallResult>;
-export interface UninstallResult {
-    ok: boolean;
-    removedFromManifest: boolean;
-    removedFromDisk: boolean;
-}
-export declare function uninstallPlugin(pluginName: string, marketplaceName: string): UninstallResult;
-export declare function listInstalled(): {
-    key: string;
-    entry: PluginInstallEntry;
-}[];

package/dist/plugins/schemas.d.ts

@@ -1,9 +0,0 @@
-/**
- * Lightweight validators for plugin marketplace JSON shapes. Returns
- * { ok, value } | { ok: false, error } so callers can use the error
- * string in user-facing slash command output.
- */
-import type { PluginMarketplace, PluginMarketplaceEntry, PluginEntrySource, ValidationResult } from "./types.js";
-export declare function validatePluginEntrySource(raw: unknown, path: string): ValidationResult<PluginEntrySource>;
-export declare function validatePluginEntry(raw: unknown, index: number): ValidationResult<PluginMarketplaceEntry>;
-export declare function validateMarketplace(raw: unknown): ValidationResult<PluginMarketplace>;

package/dist/plugins/types.d.ts

@@ -1,75 +0,0 @@
-/**
- * Plugin marketplace type definitions for codeshell. Schemas mirror Claude
- * Code's plugin system (see claude-code-sourcemap/restored-src/src/utils/plugins/schemas.ts)
- * at the MVP subset documented in
- * docs/superpowers/specs/2026-05-19-plugin-marketplace-design.md.
- */
-export type MarketplaceSource = {
-    source: "github";
-    repo: string;
-} | {
-    source: "git";
-    url: string;
-};
-export interface KnownMarketplace {
-    source: MarketplaceSource;
-    installLocation: string;
-    lastUpdated: string;
-}
-export type KnownMarketplaces = Record<string, KnownMarketplace>;
-export type PluginEntrySource = string | {
-    source: "git";
-    url: string;
-    ref?: string;
-    sha?: string;
-} | {
-    source: "github";
-    repo: string;
-    ref?: string;
-    sha?: string;
-} | {
-    source: "git-subdir";
-    url: string;
-    path: string;
-    ref?: string;
-    sha?: string;
-};
-export interface PluginMarketplaceEntry {
-    name: string;
-    description?: string;
-    author?: {
-        name: string;
-        email?: string;
-    };
-    category?: string;
-    source: PluginEntrySource;
-    homepage?: string;
-}
-export interface PluginMarketplace {
-    name: string;
-    description?: string;
-    owner: {
-        name: string;
-        email?: string;
-    };
-    plugins: PluginMarketplaceEntry[];
-}
-export interface PluginInstallEntry {
-    scope: "user";
-    installPath: string;
-    version: string;
-    installedAt: string;
-    lastUpdated: string;
-    gitCommitSha?: string;
-}
-export interface InstalledPluginsV2 {
-    version: 2;
-    plugins: Record<string, PluginInstallEntry[]>;
-}
-export type ValidationResult<T> = {
-    ok: true;
-    value: T;
-} | {
-    ok: false;
-    error: string;
-};

package/dist/plugins/varRewrite.d.ts

@@ -1,42 +0,0 @@
-/**
- * Plugin variable rewriter.
- *
- * After a plugin is materialized into the cache dir, walk its files and
- * rewrite every occurrence of `CLAUDE_PLUGIN_ROOT` to `CODESHELL_PLUGIN_ROOT`.
- *
- * Why: plugins authored against Claude Code's protocol embed
- * `${CLAUDE_PLUGIN_ROOT}` in their hooks.json command strings and inside
- * shell scripts. codeshell uses its own env var name (`CODESHELL_PLUGIN_ROOT`)
- * to keep plugin-side host detection unambiguous — so we rewrite the file
- * tree at install time once, instead of dual-setting env vars at every hook
- * invocation (which would let plugins falsely conclude they're running on
- * Claude Code and emit CC-specific output formats).
- *
- * The rewrite is whole-token (not regex with word boundaries — Node's
- * `String.replaceAll` on a literal substring is sufficient because no
- * substring of the source contains the target as a prefix/suffix of another
- * identifier in any plugin we've seen). If a plugin author chose
- * `CLAUDE_PLUGIN_ROOT_SUFFIX` as an identifier this would also get rewritten,
- * but that case is implausible enough we accept the risk over more complex
- * tokenization.
- *
- * Binary files are skipped via NUL-byte heuristic on first 8 KiB.
- *
- * A breadcrumb file (`.code-shell-installed.json`) records the rewrite so
- * a user debugging "why does this file differ from upstream?" has an
- * explanation in-place.
- */
-export interface RewriteSummary {
-    filesScanned: number;
-    filesRewritten: number;
-    rewrittenPaths: string[];
-}
-/**
- * Rewrite every `CLAUDE_PLUGIN_ROOT` → `CODESHELL_PLUGIN_ROOT` under
- * `installPath`, then drop a breadcrumb file at the root.
- *
- * Idempotent: re-running on an already-rewritten tree is a no-op for the
- * rewrite (no `CLAUDE_PLUGIN_ROOT` left) but refreshes the breadcrumb's
- * timestamp so the user can see when the most recent install/update ran.
- */
-export declare function rewritePluginVars(installPath: string): RewriteSummary;

package/dist/preset/index.d.ts

@@ -1,60 +0,0 @@
-/**
- * Built-in agent presets.
- *
- * Presets keep the core engine domain-agnostic while letting callers choose
- * a default prompt, default tools, and safe permission shortcuts.
- *
- * System prompts are assembled from reusable markdown sections in
- * src/prompt/sections/*.md — each preset declares which sections to include.
- */
-import type { PermissionRule } from "../types.js";
-export declare const AGENT_PRESET_NAMES: readonly ["general", "terminal-coding"];
-/** Built-in preset names. Custom presets use arbitrary strings via registerPreset(). */
-export type BuiltinPresetName = (typeof AGENT_PRESET_NAMES)[number];
-/** Any preset name — built-in or custom-registered. */
-export type AgentPresetName = BuiltinPresetName | (string & {});
-export interface AgentPreset {
-    name: AgentPresetName;
-    label: string;
-    description: string;
-    /** Ordered list of prompt section filenames (without .md). */
-    promptSections: readonly string[];
-    /** Whether to inject git status into system context. */
-    injectGitStatus: boolean;
-    builtinTools: string[];
-    defaultPermissionRules: PermissionRule[];
-}
-export declare const BUILTIN_AGENT_PRESETS: Record<AgentPresetName, AgentPreset>;
-export declare const DEFAULT_AGENT_PRESET: AgentPresetName;
-export declare const DEFAULT_CLI_PRESET: AgentPresetName;
-/**
- * Register a custom agent preset.
- *
- * External repos can call this to add their own presets:
- * ```ts
- * import { registerPreset } from "code-shell";
- *
- * registerPreset({
- *   name: "data-pipeline" as AgentPresetName,
- *   label: "Data Pipeline Orchestrator",
- *   description: "Manages ETL workflows and data quality checks.",
- *   promptSections: ["base", "orchestration"],
- *   injectGitStatus: false,
- *   builtinTools: ["Read", "Write", "Bash", "Glob", "Grep", "Agent"],
- *   defaultPermissionRules: [{ tool: "Read", decision: "allow" }],
- * });
- * ```
- */
-export declare function registerPreset(preset: AgentPreset): void;
-/** List all available preset names (built-in + custom). */
-export declare function listPresetNames(): string[];
-export declare function resolveAgentPreset(name?: string): AgentPreset;
-/**
- * Build the full system prompt for a preset by loading and joining its sections.
- */
-export declare function buildPresetSystemPrompt(preset: AgentPreset): string;
-export declare function resolveBuiltinToolNames(options?: {
-    preset?: string;
-    enabledBuiltinTools?: string[];
-    disabledBuiltinTools?: string[];
-}): string[];

package/dist/product/define.d.ts

@@ -1,60 +0,0 @@
-/**
- * defineProduct — assemble a domain-specific agent product from preset + adapter + contract.
- *
- * This is the primary entry point for external repos. One call produces a
- * ready-to-use RunManager that embodies the product's behavior.
- *
- * Example (in an external repo):
- * ```ts
- * import { defineProduct } from "code-shell";
- *
- * const { manager, preset } = defineProduct({
- *   preset: {
- *     name: "security-audit",
- *     label: "Security Audit Agent",
- *     description: "Scans repos for OWASP top 10 vulnerabilities.",
- *     sections: ["base", "orchestration"],
- *     appendPrompt: "You are a security expert. Focus on...",
- *   },
- *   adapter: {
- *     tools: [myCustomScanTool],
- *     enableTools: ["Read", "Glob", "Grep", "Bash"],
- *     permissionRules: [{ tool: "Bash", decision: "ask" }],
- *   },
- *   contract: {
- *     evaluator: new SecurityEvaluator(),
- *     defaultTags: ["security"],
- *     maxTurns: 50,
- *   },
- * }, {
- *   llm: { provider: "openai", model: "...", apiKey: "..." },
- * });
- *
- * await manager.submit({ objective: "Audit auth module for SQL injection" });
- * ```
- */
-import type { LLMConfig, PermissionMode } from "../types.js";
-import type { AgentPreset } from "../preset/index.js";
-import { RunManager } from "../run/RunManager.js";
-import type { ProductDefinition, CustomTool } from "./types.js";
-export interface ProductRuntimeOptions {
-    /** LLM configuration (required). */
-    llm: LLMConfig;
-    /** Permission mode. Default: "acceptEdits" */
-    permissionMode?: PermissionMode;
-    /** Working directory. Default: process.cwd() */
-    cwd?: string;
-    /** Storage directory for runs. Default: ~/.code-shell/runs */
-    runsDir?: string;
-    /** Storage directory for sessions. */
-    sessionStorageDir?: string;
-}
-export interface ProductInstance {
-    /** The configured RunManager, ready for submit/resume/cancel. */
-    manager: RunManager;
-    /** The registered preset (can be used to create Engine directly). */
-    preset: AgentPreset;
-    /** Custom tools registered by the adapter (for reference). */
-    customTools: CustomTool[];
-}
-export declare function defineProduct(definition: ProductDefinition, runtime: ProductRuntimeOptions): ProductInstance;

package/dist/product/index.d.ts

@@ -1,5 +0,0 @@
-/**
- * Product module — build domain-specific agents on CodeShell.
- */
-export type { ProductDefinition, ProductPreset, ProductAdapter, ProductContract, CustomTool, } from "./types.js";
-export { defineProduct, type ProductRuntimeOptions, type ProductInstance, } from "./define.js";

package/dist/product/index.js

@@ -1 +0,0 @@
-export{a as defineProduct}from'../chunk-GGVAOPI7.js';import'../chunk-Z5HKHAO7.js';import'../chunk-SKIX2M5Z.js';import'../chunk-MLCTC53I.js';import'../chunk-WI6FSWGU.js';import'../chunk-P6JSTIFM.js';import'../chunk-SNFAPSLA.js';import'../chunk-D3TVASD2.js';import'../chunk-FZXY554D.js';import'../chunk-M7VU4YVY.js';import'../chunk-T222K6IV.js';import'../chunk-QTWU7UNA.js';import'../chunk-K4HILJ6G.js';import'../chunk-WONQHE4P.js';import'../chunk-GKAQH2DG.js';import'../chunk-FU7AHZNN.js';import'../chunk-DI26OUIU.js';import'../chunk-3QP5BQ3L.js';

package/dist/product/types.d.ts

@@ -1,111 +0,0 @@
-/**
- * Product Adapter — the contract for turning CodeShell into a domain-specific agent.
- *
- * A "product" is a concrete agent application built on top of CodeShell.
- * Examples:
- *   - Code reviewer agent
- *   - Data pipeline orchestrator
- *   - DevOps deployment agent
- *   - Documentation writer
- *   - Security audit agent
- *
- * To build a product, an external repo provides:
- *
- *   1. **Preset** (brain)     — system prompt, tool set, permission rules
- *   2. **Adapter** (hands)    — custom tools, MCP servers, domain-specific IO
- *   3. **Contract** (quality) — evaluator, completion criteria, artifact specs
- *
- * These three layers compose into a ProductDefinition that CodeShell's
- * `defineProduct()` function turns into a fully configured RunManager.
- */
-import type { PermissionRule, MCPServerConfig } from "../types.js";
-import type { Evaluator } from "../run/Evaluator.js";
-import type { RegisteredTool } from "../types.js";
-import type { EngineHookConfig } from "../engine/engine.js";
-export interface ProductPreset {
-    /** Unique name for this product's preset. */
-    name: string;
-    /** Human-readable label. */
-    label: string;
-    /** One-line description. */
-    description: string;
-    /**
-     * System prompt for the agent. Two options:
-     *   - `sections`: reuse CodeShell's built-in markdown sections (e.g. ["base", "orchestration"])
-     *   - `customPrompt`: provide a full custom system prompt string
-     * If both are provided, customPrompt takes precedence.
-     */
-    sections?: string[];
-    customPrompt?: string;
-    /** Additional text appended after the main system prompt. */
-    appendPrompt?: string;
-    /** Whether to inject git status into system context. Default: false */
-    injectGitStatus?: boolean;
-}
-export interface CustomTool {
-    /** Tool definition (name, description, inputSchema). */
-    definition: RegisteredTool;
-    /** Tool executor function. */
-    execute: (args: Record<string, unknown>) => Promise<string>;
-}
-export interface ProductAdapter {
-    /**
-     * Custom tools specific to this product domain.
-     * These are registered in addition to the preset's builtin tools.
-     */
-    tools?: CustomTool[];
-    /**
-     * MCP servers to connect (external tool providers).
-     */
-    mcpServers?: Record<string, MCPServerConfig>;
-    /**
-     * Builtin tools to explicitly enable (add to preset defaults).
-     */
-    enableTools?: string[];
-    /**
-     * Builtin tools to explicitly disable (remove from preset defaults).
-     */
-    disableTools?: string[];
-    /**
-     * Permission rules specific to this product.
-     * Applied on top of the preset's default rules.
-     */
-    permissionRules?: PermissionRule[];
-    /**
-     * Hooks to register for this product.
-     * Key: hook event name, Value: handler function.
-     */
-    hooks?: EngineHookConfig[];
-}
-export interface ProductContract {
-    /**
-     * Evaluator(s) to run on completion.
-     * Can be a single Evaluator or an array (composed automatically).
-     */
-    evaluator?: Evaluator | Evaluator[];
-    /**
-     * Default tags applied to every run submitted through this product.
-     */
-    defaultTags?: string[];
-    /**
-     * Default metadata attached to every run.
-     */
-    defaultMetadata?: Record<string, unknown>;
-    /**
-     * Maximum turns per run. Overrides the default 30.
-     */
-    maxTurns?: number;
-    /**
-     * Maximum context tokens. Overrides the default 200_000.
-     */
-    maxContextTokens?: number;
-    /**
-     * Queue concurrency. Default: 1.
-     */
-    concurrency?: number;
-}
-export interface ProductDefinition {
-    preset: ProductPreset;
-    adapter?: ProductAdapter;
-    contract?: ProductContract;
-}