@cuylabs/agent-core 4.8.1 → 4.10.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/plugin/settings.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAuD/E,uDAAuD;AACvD,qBAAa,YAAa,YAAW,sBAAsB;IACzD,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAInD,KAAK,CAAC,CAAC,EACL,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC/B,CAAC,GAAG,SAAS;IAIhB,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,CAAC;CAGnE;AAED,wFAAwF;AACxF,qBAAa,cAAe,YAAW,sBAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAE1D,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAKlD,KAAK,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS;IAO3E,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,CAAC;CAOlE;AAED,6EAA6E;AAC7E,qBAAa,eAAgB,YAAW,sBAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,sBAAsB,EAAE;IAE7D,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAiBlD,KAAK,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS;IAO3E,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,CAAC;CAOlE;AAED,yEAAyE;AACzE,qBAAa,iBAAkB,YAAW,sBAAsB;IAE5D,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,IAAI,EAAE,sBAAsB,EAC5B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAGrD,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAOlD,KAAK,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS;IAO3E,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,CAAC;CAMlE"}

package/dist/plugin/types.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Plugin types — contracts for the extension system.
+ *
+ * Plugins contribute tools, middleware, commands, prompt sections,
+ * and lifecycle hooks to an agent without coupling to a specific host.
+ */
+import type { AgentMiddleware } from "../middleware/types.js";
+import type { PromptSection } from "../prompt/types.js";
+import type { Tool } from "../tool/tool.js";
+import type { PluginEventBus } from "./event-bus.js";
+import type { ZodType } from "zod";
+/** Static metadata about a plugin (from package.json or inline). */
+export interface PluginCompatibility {
+    /** Expected plugin API version supported by the host (exact match). */
+    apiVersion?: string;
+    /** Supported Node.js version range (supports exact or comparator syntax). */
+    node?: string;
+}
+/** Host-readable capability tags such as "workspace", "session", or "network". */
+export type PluginCapabilityTag = string;
+/**
+ * Static surface contract for a plugin.
+ *
+ * This keeps the server/plugin boundary explicit: plugin behavior is headless
+ * by default, and any future UI surface must remain a separate client concern.
+ */
+export interface PluginSurfaceContract {
+    tools?: boolean;
+    middleware?: boolean;
+    commands?: boolean;
+    promptSections?: boolean;
+    lifecycle?: boolean;
+    ui?: "none" | "separate-client-extension";
+}
+export interface PluginManifest {
+    /** Unique plugin identifier (e.g. "brave-search", "finance") */
+    id: string;
+    /** Human-readable display name */
+    name?: string;
+    /** Short description */
+    description?: string;
+    /** SemVer string */
+    version?: string;
+    /** Compatibility requirements validated by the host at load time. */
+    compatibility?: PluginCompatibility;
+    /** Host-readable business capability tags. */
+    capabilities?: PluginCapabilityTag[];
+    /** Explicit contract for which host-owned surfaces this plugin contributes to. */
+    surfaces?: PluginSurfaceContract;
+}
+/**
+ * Host-readable metadata for a plugin command.
+ *
+ * This is the sanctioned way to enrich command discovery and routing without
+ * coupling plugins to a specific renderer or UI widget system.
+ */
+export interface PluginCommandMetadata {
+    /** Grouping hint for help views, palettes, and command inventories. */
+    category?: string;
+    /** Short argument hint shown in usage/help surfaces. */
+    argsHint?: string;
+    /** Host-readable capability tags such as "workspace", "session", or "network". */
+    capabilities?: PluginCapabilityTag[];
+}
+/**
+ * A user-facing command registered by a plugin.
+ *
+ * Commands are intentionally host-surfaced, not renderer-owned UI. Plugins
+ * should return results and metadata here instead of trying to reach into TUI
+ * or web implementation details.
+ */
+export interface PluginCommand {
+    /** Command name (without leading slash) */
+    name: string;
+    /** Optional aliases */
+    alias?: string[];
+    /** One-line description shown in help */
+    summary: string;
+    /** Execute the command. Return the text to display, or null for silent. */
+    execute: (args: string) => Promise<string | null>;
+    /** Optional host-readable metadata for richer discovery and routing. */
+    metadata?: PluginCommandMetadata;
+}
+export type PluginSettingsSchema<T = unknown> = ZodType<T>;
+export interface PluginSettingsDefinition<T = unknown> {
+    /** Settings namespace. Defaults to the plugin ID. */
+    namespace?: string;
+    /** Whether missing settings are allowed. Defaults to true. */
+    optional?: boolean;
+    /** Zod schema used to validate the resolved settings object. */
+    schema: PluginSettingsSchema<T>;
+}
+/** Namespace-isolated config access. The host injects the implementation. */
+export interface PluginSettingsProvider {
+    /**
+     * Read the config value for a given namespace.
+     *
+     * @param namespace  Plugin's config key (e.g. "brave-search")
+     * @returns The config object, or undefined if not configured.
+     */
+    get<T = unknown>(namespace: string): T | undefined;
+    /**
+     * Read and validate a namespace with a schema.
+     *
+     * Returns undefined when the namespace is not configured.
+     */
+    parse<T>(namespace: string, schema: PluginSettingsSchema<T>): T | undefined;
+    /**
+     * Read and validate a namespace with a schema.
+     *
+     * Throws when the namespace is missing or invalid.
+     */
+    require<T>(namespace: string, schema: PluginSettingsSchema<T>): T;
+}
+/** Session lifecycle hooks a plugin can register. */
+export interface PluginLifecycleHooks {
+    activate?: (ctx: PluginSessionContext) => Promise<void> | void;
+    deactivate?: () => Promise<void> | void;
+}
+/** Context available during plugin activation. */
+export interface PluginSessionContext {
+    /** Agent's working directory */
+    cwd: string;
+    /** Session ID (if session-based) */
+    sessionId?: string;
+}
+/** The API surface passed to a plugin's entry function. */
+export interface PluginContext {
+    /** Working directory of the agent (project root) */
+    cwd: string;
+    /** Plugin's own manifest (id, name, version). Read-only. */
+    manifest: Readonly<PluginManifest>;
+    /** Register a tool the LLM can call */
+    addTool(tool: Tool.AnyInfo): void;
+    /** Register middleware (model hooks, tool guards, prompt sections) */
+    addMiddleware(mw: AgentMiddleware): void;
+    /** Register a user-facing command (host-dependent) */
+    addCommand(cmd: PluginCommand): void;
+    /** Add a dynamic prompt section injected at system-prompt build time. */
+    addPromptSection(section: PromptSection): void;
+    /** Inter-plugin event bus (string-keyed pub/sub). */
+    events: PluginEventBus;
+    /** Plugin-namespaced settings from the host. */
+    settings: PluginSettingsProvider;
+    /** Register an activation hook (fires when the agent session starts). */
+    onActivate(fn: (ctx: PluginSessionContext) => Promise<void> | void): void;
+    /** Register a deactivation hook (fires when the agent session ends). */
+    onDeactivate(fn: () => Promise<void> | void): void;
+}
+/** The function shape a plugin file must default-export. */
+export type PluginInit = (ctx: PluginContext) => void | Promise<void>;
+/** Aggregated contributions from all loaded plugins. */
+export interface PluginContributions {
+    /** Tools to add to the agent's tool set */
+    tools: Tool.AnyInfo[];
+    /** Middleware to pass into the agent's middleware stack in plugin load order. */
+    middleware: AgentMiddleware[];
+    /** User-facing commands (host-dependent surfacing) */
+    commands: PluginCommand[];
+    /** Dynamic prompt sections */
+    promptSections: PromptSection[];
+    /** Loader / plugin errors (non-fatal — the rest of the system keeps working) */
+    errors: Array<{
+        pluginId: string;
+        error: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/profiles/apply.d.ts

@@ -0,0 +1,17 @@
+import type { Tool } from "../tool/tool.js";
+import type { AppliedProfile, Profile } from "./types.js";
+/**
+ * Apply a profile to available tools and a parent system prompt.
+ */
+export declare function applyProfile(profile: Profile, availableTools: Tool.AnyInfo[], baseSystemPrompt?: string): AppliedProfile;
+/**
+ * Merge multiple profiles. Later profiles override earlier scalar values.
+ */
+export declare function mergeProfiles(...profiles: Profile[]): Profile;
+/**
+ * Create a custom profile with sensible defaults.
+ */
+export declare function createProfile(options: Partial<Profile> & {
+    name: string;
+}): Profile;
+//# sourceMappingURL=apply.d.ts.map

package/dist/profiles/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../src/profiles/apply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1D;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,IAAI,CAAC,OAAO,EAAE,EAC9B,gBAAgB,CAAC,EAAE,MAAM,GACxB,cAAc,CAoBhB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAoD7D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAC3C,OAAO,CAKT"}

package/dist/profiles/builtins.d.ts

@@ -0,0 +1,18 @@
+import type { Profile } from "./types.js";
+export declare const explore: Profile;
+export declare const plan: Profile;
+export declare const review: Profile;
+export declare const quick: Profile;
+export declare const careful: Profile;
+export declare const code: Profile;
+export declare const watch: Profile;
+export declare const Profiles: {
+    readonly explore: Profile;
+    readonly plan: Profile;
+    readonly review: Profile;
+    readonly quick: Profile;
+    readonly careful: Profile;
+    readonly code: Profile;
+    readonly watch: Profile;
+};
+//# sourceMappingURL=builtins.d.ts.map

package/dist/profiles/builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../src/profiles/builtins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAO,MAAM,OAAO,EAAE,OA0BrB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,OAoBlB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,OA2BpB,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,OAgBnB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,OAkBrB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,OAwBlB,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,OA8BnB,CAAC;AAEF,eAAO,MAAM,QAAQ;;;;;;;;CAQX,CAAC"}

package/dist/profiles/index.d.ts

@@ -1,57 +1,14 @@
-import { T as Tool, cb as Profile, af as AppliedProfile } from '../instance-Bg61WSyz.js';
-import '../types-C_LCeYNg.js';
-import 'ai';
-import '../types-RSCv7nQ4.js';
-import 'zod';
-import '../types-CQaXbRsS.js';
-import '../types-DMjoFKKv.js';
-import '@modelcontextprotocol/sdk/client/auth.js';
-import '@modelcontextprotocol/sdk/types.js';
-import '@ai-sdk/provider-utils';
-import '../sandbox/index.js';
-import '../llm-error-D93FNNLY.js';
-
 /**
- * Filter tools using profile allow/deny patterns.
+ * Profiles module for reusable agent execution profiles.
  *
- * Explicit allow matches win over deny matches. This lets profiles define a
- * broad deny rule like `"*"` and then carve out a safe allow-list.
- */
-declare function filterTools(tools: Tool.AnyInfo[], options: {
-    allow?: string[];
-    deny?: string[];
-}): Tool.AnyInfo[];
-
-/**
- * Apply a profile to available tools and a parent system prompt.
- */
-declare function applyProfile(profile: Profile, availableTools: Tool.AnyInfo[], baseSystemPrompt?: string): AppliedProfile;
-/**
- * Merge multiple profiles. Later profiles override earlier scalar values.
- */
-declare function mergeProfiles(...profiles: Profile[]): Profile;
-/**
- * Create a custom profile with sensible defaults.
- */
-declare function createProfile(options: Partial<Profile> & {
-    name: string;
-}): Profile;
-
-declare const explore: Profile;
-declare const plan: Profile;
-declare const review: Profile;
-declare const quick: Profile;
-declare const careful: Profile;
-declare const code: Profile;
-declare const watch: Profile;
-declare const Profiles: {
-    readonly explore: Profile;
-    readonly plan: Profile;
-    readonly review: Profile;
-    readonly quick: Profile;
-    readonly careful: Profile;
-    readonly code: Profile;
-    readonly watch: Profile;
-};
-
-export { AppliedProfile, Profile, Profiles, applyProfile, careful, code, createProfile, explore, filterTools, mergeProfiles, plan, quick, review, watch };
+ * Split by responsibility:
+ * - `types` defines profile contracts
+ * - `patterns` owns tool allow/deny matching
+ * - `apply` owns applying and merging profiles
+ * - `builtins` owns the bundled profile catalog
+ */
+export type { AppliedProfile, Profile } from "./types.js";
+export { filterTools } from "./patterns.js";
+export { applyProfile, createProfile, mergeProfiles } from "./apply.js";
+export { Profiles, careful, code, explore, plan, quick, review, watch, } from "./builtins.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/profiles/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EACL,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,OAAO,EACP,IAAI,EACJ,KAAK,EACL,MAAM,EACN,KAAK,GACN,MAAM,eAAe,CAAC"}

package/dist/profiles/patterns.d.ts

@@ -0,0 +1,12 @@
+import type { Tool } from "../tool/tool.js";
+/**
+ * Filter tools using profile allow/deny patterns.
+ *
+ * Explicit allow matches win over deny matches. This lets profiles define a
+ * broad deny rule like `"*"` and then carve out a safe allow-list.
+ */
+export declare function filterTools(tools: Tool.AnyInfo[], options: {
+    allow?: string[];
+    deny?: string[];
+}): Tool.AnyInfo[];
+//# sourceMappingURL=patterns.d.ts.map

package/dist/profiles/patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.d.ts","sourceRoot":"","sources":["../../src/profiles/patterns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAoB5C;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,EACrB,OAAO,EAAE;IACP,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,GACA,IAAI,CAAC,OAAO,EAAE,CAmBhB"}

package/dist/profiles/types.d.ts

@@ -0,0 +1,48 @@
+import type { LanguageModel } from "ai";
+import type { ReasoningLevel } from "../models/reasoning/index.js";
+import type { Tool } from "../tool/tool.js";
+/**
+ * Reusable agent execution profile.
+ */
+export interface Profile {
+    /** Unique identifier for this profile */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /**
+     * Tool allow patterns (glob-like).
+     * If provided, only tools matching these patterns are candidates.
+     */
+    allowTools?: string[];
+    /**
+     * Tool deny patterns (glob-like).
+     * Deny patterns apply only after allow matching, so explicit allows win.
+     */
+    denyTools?: string[];
+    /**
+     * Override system prompt.
+     * Use `{basePrompt}` to include the parent's system prompt.
+     */
+    systemPrompt?: string;
+    /** Override temperature (0-1). */
+    temperature?: number;
+    /** Override max steps. */
+    maxSteps?: number;
+    /** Override reasoning level. */
+    reasoningLevel?: ReasoningLevel;
+    /** Override model. */
+    model?: LanguageModel;
+}
+/**
+ * Result of applying a profile - ready for `fork()`.
+ */
+export interface AppliedProfile {
+    name: string;
+    systemPrompt?: string;
+    tools?: Tool.AnyInfo[];
+    temperature?: number;
+    maxSteps?: number;
+    reasoningLevel?: ReasoningLevel;
+    model?: LanguageModel;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/profiles/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,sBAAsB;IACtB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB"}

package/dist/prompt/builder/builder.d.ts

@@ -0,0 +1,27 @@
+import type { ModelFamily, PromptBuildContext, PromptConfig, PromptSection } from "../types.js";
+import { type SkillRegistry } from "../../skill/registry.js";
+import type { MiddlewareRunner } from "../../middleware/runner.js";
+import { type PromptSectionPreview } from "./sections.js";
+export declare class PromptBuilder {
+    private readonly config;
+    private customSections;
+    private envCache?;
+    private instructionCache?;
+    private skillRegistryCache?;
+    constructor(config?: PromptConfig);
+    build(context: PromptBuildContext, middleware?: MiddlewareRunner): Promise<string>;
+    addSection(section: PromptSection): void;
+    removeSection(id: string): boolean;
+    toggleSection(id: string, enabled: boolean): void;
+    getSections(): PromptSection[];
+    hasSection(id: string): boolean;
+    clearCache(): void;
+    getSkillRegistry(cwd: string): Promise<SkillRegistry>;
+    getModelFamily(model: PromptBuildContext["model"]): ModelFamily;
+    getBaseTemplate(model: PromptBuildContext["model"]): string;
+    preview(context: PromptBuildContext, middleware?: MiddlewareRunner): Promise<PromptSectionPreview[]>;
+    private getEnvironment;
+    private getInstructions;
+}
+export declare function createPromptBuilder(config?: PromptConfig): PromptBuilder;
+//# sourceMappingURL=builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../src/prompt/builder/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACd,MAAM,aAAa,CAAC;AAQrB,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAGL,KAAK,oBAAoB,EAE1B,MAAM,eAAe,CAAC;AAEvB,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IACrD,OAAO,CAAC,cAAc,CAAyC;IAC/D,OAAO,CAAC,QAAQ,CAAC,CAAyC;IAC1D,OAAO,CAAC,gBAAgB,CAAC,CAA4C;IACrE,OAAO,CAAC,kBAAkB,CAAC,CAA2C;gBAE1D,MAAM,CAAC,EAAE,YAAY;IAe3B,KAAK,CACT,OAAO,EAAE,kBAAkB,EAC3B,UAAU,CAAC,EAAE,gBAAgB,GAC5B,OAAO,CAAC,MAAM,CAAC;IAoBlB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAIxC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIlC,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAOjD,WAAW,IAAI,aAAa,EAAE;IAI9B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI/B,UAAU,IAAI,IAAI;IAMZ,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAgB3D,cAAc,CAAC,KAAK,EAAE,kBAAkB,CAAC,OAAO,CAAC,GAAG,WAAW;IAI/D,eAAe,CAAC,KAAK,EAAE,kBAAkB,CAAC,OAAO,CAAC,GAAG,MAAM;IAKrD,OAAO,CACX,OAAO,EAAE,kBAAkB,EAC3B,UAAU,CAAC,EAAE,gBAAgB,GAC5B,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAclC,OAAO,CAAC,cAAc;YAUR,eAAe;CA0B9B;AAED,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,aAAa,CAExE"}

package/dist/prompt/builder/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Prompt-builder module.
+ *
+ * Split by responsibility:
+ * - `priorities` defines section ordering constants
+ * - `sections` owns prompt section composition and preview derivation
+ * - `builder` owns cache/stateful orchestration
+ */
+export { PRIORITY_BASE, PRIORITY_CUSTOM, PRIORITY_ENVIRONMENT, PRIORITY_INSTRUCTIONS, PRIORITY_OVERRIDE, PRIORITY_SKILLS, } from "./priorities.js";
+export { PromptBuilder, createPromptBuilder } from "./builder.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/prompt/builder/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/prompt/builder/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/prompt/builder/priorities.d.ts

@@ -0,0 +1,13 @@
+/** Priority for the base template section. */
+export declare const PRIORITY_BASE = 10;
+/** Priority for the environment block section. */
+export declare const PRIORITY_ENVIRONMENT = 20;
+/** Priority for instruction files. */
+export declare const PRIORITY_INSTRUCTIONS = 30;
+/** Priority for custom user-defined sections. */
+export declare const PRIORITY_CUSTOM = 50;
+/** Priority for skill summary injection. */
+export declare const PRIORITY_SKILLS = 70;
+/** Priority for per-turn override content. */
+export declare const PRIORITY_OVERRIDE = 90;
+//# sourceMappingURL=priorities.d.ts.map

package/dist/prompt/builder/priorities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"priorities.d.ts","sourceRoot":"","sources":["../../../src/prompt/builder/priorities.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,kDAAkD;AAClD,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,sCAAsC;AACtC,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,iDAAiD;AACjD,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,4CAA4C;AAC5C,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,8CAA8C;AAC9C,eAAO,MAAM,iBAAiB,KAAK,CAAC"}

package/dist/prompt/builder/sections.d.ts

@@ -0,0 +1,30 @@
+import type { EnvironmentInfo, InstructionFile, PromptBuildContext, PromptConfig, PromptSection } from "../types.js";
+import type { MiddlewareRunner } from "../../middleware/runner.js";
+import type { SkillRegistry } from "../../skill/registry.js";
+export type ResolvedPromptBuilderConfig = Required<Pick<PromptConfig, "includeEnvironment" | "includeInstructions" | "separator">> & PromptConfig;
+export interface PromptSectionPreview {
+    id: string;
+    label: string;
+    priority: number;
+    size: number;
+}
+export interface PromptSectionSources {
+    getEnvironment(cwd: string): EnvironmentInfo;
+    getInstructions(cwd: string): Promise<InstructionFile[]>;
+    getSkillRegistry(cwd: string): Promise<SkillRegistry>;
+}
+export declare function composePromptSections(options: {
+    config: ResolvedPromptBuilderConfig;
+    context: PromptBuildContext;
+    customSections: Iterable<PromptSection>;
+    middleware?: MiddlewareRunner;
+    sources: PromptSectionSources;
+}): Promise<PromptSection[]>;
+export declare function previewPromptSections(options: {
+    config: ResolvedPromptBuilderConfig;
+    context: PromptBuildContext;
+    customSections: Iterable<PromptSection>;
+    middleware?: MiddlewareRunner;
+    sources: PromptSectionSources;
+}): Promise<PromptSectionPreview[]>;
+//# sourceMappingURL=sections.d.ts.map

package/dist/prompt/builder/sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections.d.ts","sourceRoot":"","sources":["../../../src/prompt/builder/sections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACd,MAAM,aAAa,CAAC;AAIrB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAU7D,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CAChD,IAAI,CAAC,YAAY,EAAE,oBAAoB,GAAG,qBAAqB,GAAG,WAAW,CAAC,CAC/E,GACC,YAAY,CAAC;AAEf,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;IAC7C,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACzD,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACvD;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE;IACnD,MAAM,EAAE,2BAA2B,CAAC;IACpC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,cAAc,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IACxC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,OAAO,EAAE,oBAAoB,CAAC;CAC/B,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAuE3B;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE;IACnD,MAAM,EAAE,2BAA2B,CAAC;IACpC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,cAAc,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IACxC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,OAAO,EAAE,oBAAoB,CAAC;CAC/B,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAWlC"}

package/dist/prompt/environment.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Environment Block — Runtime context for the system prompt
+ *
+ * Gathers information about the working environment (cwd, platform,
+ * git status, date, shell) and formats it as a structured block
+ * that gets injected into the prompt at priority 20.
+ *
+ * This gives the model awareness of:
+ * - Where it's working (directory, project)
+ * - What platform it's on (affects path separators, commands)
+ * - Current time (useful for time-sensitive tasks)
+ * - Git state (branch, clean/dirty)
+ */
+import type { EnvironmentInfo } from "./types.js";
+/**
+ * Gather runtime environment information.
+ *
+ * Collects cwd, platform, git status, date, and shell.
+ * Git commands use a short timeout to avoid hanging on slow repos.
+ *
+ * @param cwd - Working directory to gather info for
+ * @returns Environment info object
+ */
+export declare function gatherEnvironment(cwd: string): EnvironmentInfo;
+/**
+ * Format environment info as a prompt-friendly block.
+ *
+ * Output example:
+ * ```
+ * <workspace>
+ * Directory: /Users/dev/my-project
+ * Project: my-project
+ * Platform: macOS (darwin arm64)
+ * Date: Saturday, February 8, 2026
+ * Shell: /bin/zsh
+ * Git: main (clean)
+ * </workspace>
+ * ```
+ */
+export declare function formatEnvironment(info: EnvironmentInfo): string;
+/**
+ * Create a short one-line summary of the environment.
+ * Useful for compact contexts or logging.
+ */
+export declare function summarizeEnvironment(info: EnvironmentInfo): string;
+//# sourceMappingURL=environment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/prompt/environment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAsDlD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAiB9D;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAqB/D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAKlE"}