@soederpop/luca 0.1.1 → 0.1.3

package/dist/command.d.ts

@@ -0,0 +1,163 @@
+import { Helper } from './helper.js';
+import type { Container, ContainerContext } from './container.js';
+import { Registry } from './registry.js';
+import { CommandStateSchema, CommandOptionsSchema, type DispatchSource, type CommandRunResult } from './schemas/base.js';
+import { z } from 'zod';
+export type { DispatchSource, CommandRunResult };
+export type CommandState = z.infer<typeof CommandStateSchema>;
+export type CommandOptions = z.infer<typeof CommandOptionsSchema>;
+export interface AvailableCommands {
+}
+export type CommandFactory = <T extends keyof AvailableCommands>(key: T, options?: ConstructorParameters<AvailableCommands[T]>[0]) => NonNullable<InstanceType<AvailableCommands[T]>>;
+export interface CommandsInterface {
+    commands: CommandsRegistry;
+    command: CommandFactory;
+}
+export type CommandHandler<T = any> = (options: T, context: ContainerContext) => Promise<void>;
+/**
+ * Type helper for module-augmentation of AvailableCommands when using the
+ * SimpleCommand (module-based) pattern instead of a full class.
+ *
+ * @example
+ * ```typescript
+ * declare module '@soederpop/luca' {
+ *   interface AvailableCommands {
+ *     serve: SimpleCommand<typeof argsSchema>
+ *   }
+ * }
+ * ```
+ */
+export type SimpleCommand<Schema extends z.ZodType = z.ZodType> = typeof Command & {
+    argsSchema: Schema;
+    positionals: string[];
+};
+export declare class Command<T extends CommandState = CommandState, K extends CommandOptions = CommandOptions> extends Helper<T, K> {
+    static shortcut: string;
+    static description: string;
+    static stateSchema: z.ZodObject<{
+        running: z.ZodDefault<z.ZodBoolean>;
+        exitCode: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>;
+    static optionsSchema: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        _cacheKey: z.ZodOptional<z.ZodString>;
+        _: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        dispatchSource: z.ZodDefault<z.ZodEnum<{
+            cli: "cli";
+            headless: "headless";
+            mcp: "mcp";
+            rpc: "rpc";
+        }>>;
+    }, z.core.$strip>;
+    static eventsSchema: z.ZodObject<{
+        stateChange: z.ZodTuple<[z.ZodAny], null>;
+        started: z.ZodTuple<[], null>;
+        completed: z.ZodTuple<[z.ZodNumber], null>;
+        failed: z.ZodTuple<[z.ZodAny], null>;
+    }, z.core.$strip>;
+    static commandDescription: string;
+    static argsSchema: z.ZodType;
+    static positionals: string[];
+    /** Self-register a Command subclass from a static initialization block. */
+    static register: (SubClass: typeof Command, id?: string) => typeof Command;
+    get initialState(): T;
+    /**
+     * Parse raw CLI argv against this command's argsSchema.
+     * Kept for backward compatibility with built-in commands.
+     */
+    parseArgs(): any;
+    /**
+     * The user-defined command payload. Override this in class-based commands,
+     * or export a `run` function in module-based commands.
+     *
+     * Receives clean, named args (positionals already mapped) and the container context.
+     */
+    run(_args: any, _context: ContainerContext): Promise<void>;
+    /**
+     * Internal dispatch normalizer. Maps positionals for CLI, passes through named
+     * args for headless, validates via argsSchema, captures output when headless.
+     *
+     * @param rawInput - Named args object. When omitted, reads from container.argv.
+     * @param source - Override the dispatch source. Defaults to constructor option.
+     */
+    execute(rawInput?: Record<string, any>, source?: DispatchSource): Promise<CommandRunResult | void>;
+    /**
+     * The public entry point for dispatching a command.
+     * Called by the CLI and other dispatch surfaces.
+     */
+    dispatch(rawInput?: Record<string, any>, source?: DispatchSource): Promise<CommandRunResult | void>;
+    /**
+     * Map CLI positional args to named fields based on the command's positionals declaration.
+     * For non-CLI dispatch, args are already named — pass through.
+     */
+    private _normalizeInput;
+    /**
+     * Check whether a Zod schema expects an array type for a given field.
+     * Unwraps ZodObject → ZodOptional/ZodDefault/ZodNullable → ZodArray.
+     */
+    private _schemaExpectsArray;
+    /**
+     * Run the command with stdout/stderr capture for headless dispatch.
+     * Returns a CommandRunResult with captured output.
+     *
+     * NOTE: Uses global console mutation — not safe for concurrent headless dispatches.
+     * A future iteration should pass a logger through context instead.
+     */
+    private _runCaptured;
+    static attach(container: Container<any> & CommandsInterface): Container<any, any> & CommandsInterface;
+}
+export declare class CommandsRegistry extends Registry<Command<any>> {
+    scope: string;
+    baseClass: any;
+    /**
+     * Convert all registered commands into a `{ schemas, handlers }` object
+     * compatible with `assistant.use()`.
+     *
+     * Each command becomes a tool whose parameters come from the command's
+     * `argsSchema` (with internal CLI fields stripped) and whose handler
+     * dispatches the command headlessly, returning `{ exitCode, stdout, stderr }`.
+     *
+     * @param container - The container used to instantiate and dispatch commands
+     * @param options - Optional filter/transform options
+     * @param options.include - Only include these command names (default: all)
+     * @param options.exclude - Exclude these command names (default: none)
+     * @param options.prefix - Prefix tool names (e.g. 'luca_' → 'luca_eval')
+     */
+    toTools(container: Container<any> & CommandsInterface, options?: {
+        include?: string[];
+        exclude?: string[];
+        prefix?: string;
+    }): {
+        schemas: Record<string, z.ZodType>;
+        handlers: Record<string, Function>;
+    };
+    /**
+     * Internal: register a command from a handler function.
+     * Used by built-in commands. External commands should use the module export pattern.
+     */
+    registerHandler<T = any>(name: string, opts: {
+        description?: string;
+        argsSchema?: z.ZodType;
+        handler: CommandHandler<T>;
+    }): new (options: any, context: ContainerContext) => Command<any, {
+        _: string[];
+        dispatchSource: "cli" | "headless" | "mcp" | "rpc";
+        name?: string | undefined;
+        _cacheKey?: string | undefined;
+    }>;
+    /**
+     * Discover and register commands from a directory.
+     * Detection order:
+     *   1. Default export is a class extending Command → register directly
+     *   2. Module exports a `run` function → graft as SimpleCommand
+     *   3. Module exports a `handler` function → legacy graft
+     */
+    discover(options: {
+        directory: string;
+    }): Promise<void>;
+}
+export declare const commands: CommandsRegistry;
+export declare const helperCache: Map<any, any>;
+export { graftModule, isNativeHelperClass } from './graft.js';
+export default Command;
+//# sourceMappingURL=command.d.ts.map

package/dist/command.d.ts.map

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

package/dist/commands/bootstrap.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+declare module '../command.js' {
+    interface AvailableCommands {
+        bootstrap: ReturnType<typeof commands.registerHandler>;
+    }
+}
+export declare const argsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    _: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    dispatchSource: z.ZodDefault<z.ZodEnum<{
+        cli: "cli";
+        headless: "headless";
+        mcp: "mcp";
+        rpc: "rpc";
+    }>>;
+    output: z.ZodDefault<z.ZodString>;
+    'update-skill': z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/commands/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/commands/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAOvB,OAAO,QAAQ,eAAe,CAAC;IAC9B,UAAU,iBAAiB;QAC1B,SAAS,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,eAAe,CAAC,CAAA;KACtD;CACD;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;;iBAGrB,CAAA"}

package/dist/commands/chat.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import type { ContainerContext } from '../container';
+declare module '../command.js' {
+    interface AvailableCommands {
+        chat: ReturnType<typeof commands.registerHandler>;
+    }
+}
+export declare const argsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    _: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    dispatchSource: z.ZodDefault<z.ZodEnum<{
+        cli: "cli";
+        headless: "headless";
+        mcp: "mcp";
+        rpc: "rpc";
+    }>>;
+    model: z.ZodOptional<z.ZodString>;
+    local: z.ZodDefault<z.ZodBoolean>;
+    resume: z.ZodOptional<z.ZodString>;
+    list: z.ZodOptional<z.ZodBoolean>;
+    historyMode: z.ZodOptional<z.ZodEnum<{
+        session: "session";
+        lifecycle: "lifecycle";
+        daily: "daily";
+        persistent: "persistent";
+    }>>;
+    offRecord: z.ZodOptional<z.ZodBoolean>;
+    clear: z.ZodOptional<z.ZodBoolean>;
+    prependPrompt: z.ZodOptional<z.ZodString>;
+    appendPrompt: z.ZodOptional<z.ZodString>;
+    use: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    forbidTool: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    allowTool: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+}, z.core.$strip>;
+export default function chat(options: z.infer<typeof argsSchema>, context: ContainerContext): Promise<void>;
+//# sourceMappingURL=chat.d.ts.map

package/dist/commands/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/commands/chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAEpD,OAAO,QAAQ,eAAe,CAAC;IAC9B,UAAU,iBAAiB;QAC1B,IAAI,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,eAAe,CAAC,CAAA;KACjD;CACD;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAarB,CAAA;AAEF,wBAA8B,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,gBAAgB,iBAiRhG"}

package/dist/commands/code.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import type { ContainerContext } from '../container.js';
+import type { AGIFeatures } from '../agi/container.server.js';
+declare module '../command.js' {
+    interface AvailableCommands {
+        code: ReturnType<typeof commands.registerHandler>;
+    }
+}
+export declare const argsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    _: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    dispatchSource: z.ZodDefault<z.ZodEnum<{
+        cli: "cli";
+        headless: "headless";
+        mcp: "mcp";
+        rpc: "rpc";
+    }>>;
+    model: z.ZodOptional<z.ZodString>;
+    local: z.ZodDefault<z.ZodBoolean>;
+    prompt: z.ZodOptional<z.ZodString>;
+    allowAll: z.ZodDefault<z.ZodBoolean>;
+    denyWrites: z.ZodDefault<z.ZodBoolean>;
+    skills: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const positionals: string[];
+export default function code(options: z.infer<typeof argsSchema>, context: ContainerContext<AGIFeatures>): Promise<void>;
+//# sourceMappingURL=code.d.ts.map

package/dist/commands/code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../src/commands/code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAE3E,OAAO,QAAQ,eAAe,CAAC;IAC9B,UAAU,iBAAiB;QAC1B,IAAI,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,eAAe,CAAC,CAAA;KACjD;CACD;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;iBAOrB,CAAA;AAEF,eAAO,MAAM,WAAW,UAAa,CAAA;AAErC,wBAA8B,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,gBAAgB,CAAC,WAAW,CAAC,iBAkV7G"}

package/dist/commands/console.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import type { ContainerContext } from '../container.js';
+declare module '../command.js' {
+    interface AvailableCommands {
+        console: ReturnType<typeof commands.registerHandler>;
+    }
+}
+export declare const argsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    _: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    dispatchSource: z.ZodDefault<z.ZodEnum<{
+        cli: "cli";
+        headless: "headless";
+        mcp: "mcp";
+        rpc: "rpc";
+    }>>;
+    enable: z.ZodOptional<z.ZodString>;
+    eval: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export default function lucaConsole(options: z.infer<typeof argsSchema>, context: ContainerContext): Promise<void>;
+//# sourceMappingURL=console.d.ts.map

package/dist/commands/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/commands/console.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEvD,OAAO,QAAQ,eAAe,CAAC;IAC9B,UAAU,iBAAiB;QAC1B,OAAO,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,eAAe,CAAC,CAAA;KACpD;CACD;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;;iBAGrB,CAAA;AAoFF,wBAA8B,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,gBAAgB,iBAoFvG"}

package/dist/commands/describe.d.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import type { ContainerContext } from '../container.js';
+declare module '../command.js' {
+    interface AvailableCommands {
+        describe: ReturnType<typeof commands.registerHandler>;
+    }
+}
+export declare const argsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    _: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    dispatchSource: z.ZodDefault<z.ZodEnum<{
+        cli: "cli";
+        headless: "headless";
+        mcp: "mcp";
+        rpc: "rpc";
+    }>>;
+    json: z.ZodDefault<z.ZodBoolean>;
+    typescript: z.ZodDefault<z.ZodBoolean>;
+    ts: z.ZodDefault<z.ZodBoolean>;
+    pretty: z.ZodDefault<z.ZodBoolean>;
+    title: z.ZodDefault<z.ZodBoolean>;
+    description: z.ZodDefault<z.ZodBoolean>;
+    usage: z.ZodDefault<z.ZodBoolean>;
+    methods: z.ZodDefault<z.ZodBoolean>;
+    getters: z.ZodDefault<z.ZodBoolean>;
+    events: z.ZodDefault<z.ZodBoolean>;
+    state: z.ZodDefault<z.ZodBoolean>;
+    options: z.ZodDefault<z.ZodBoolean>;
+    'env-vars': z.ZodDefault<z.ZodBoolean>;
+    envvars: z.ZodDefault<z.ZodBoolean>;
+    examples: z.ZodDefault<z.ZodBoolean>;
+    'only-methods': z.ZodDefault<z.ZodBoolean>;
+    'only-getters': z.ZodDefault<z.ZodBoolean>;
+    'only-events': z.ZodDefault<z.ZodBoolean>;
+    'only-state': z.ZodDefault<z.ZodBoolean>;
+    'only-options': z.ZodDefault<z.ZodBoolean>;
+    'only-env-vars': z.ZodDefault<z.ZodBoolean>;
+    'only-envvars': z.ZodDefault<z.ZodBoolean>;
+    'only-examples': z.ZodDefault<z.ZodBoolean>;
+    platform: z.ZodDefault<z.ZodEnum<{
+        server: "server";
+        all: "all";
+        browser: "browser";
+        node: "node";
+        web: "web";
+    }>>;
+}, z.core.$strip>;
+export default function describe(options: z.infer<typeof argsSchema>, context: ContainerContext): Promise<void>;
+//# sourceMappingURL=describe.d.ts.map

package/dist/commands/describe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../src/commands/describe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAQvD,OAAO,QAAQ,eAAe,CAAC;IAC9B,UAAU,iBAAiB;QAC1B,QAAQ,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,eAAe,CAAC,CAAA;KACrD;CACD;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2BrB,CAAA;AAuFF,wBAA8B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,gBAAgB,iBAgDpG"}

package/dist/commands/eval.d.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import type { ContainerContext } from '../container.js';
+declare module '../command.js' {
+    interface AvailableCommands {
+        eval: ReturnType<typeof commands.registerHandler>;
+    }
+}
+export declare const argsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    _: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    dispatchSource: z.ZodDefault<z.ZodEnum<{
+        cli: "cli";
+        headless: "headless";
+        mcp: "mcp";
+        rpc: "rpc";
+    }>>;
+    json: z.ZodDefault<z.ZodBoolean>;
+    enable: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export default function evalCommand(options: z.infer<typeof argsSchema>, context: ContainerContext): Promise<void>;
+export declare function displayResult(value: any): void;
+//# sourceMappingURL=eval.d.ts.map

package/dist/commands/eval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval.d.ts","sourceRoot":"","sources":["../../src/commands/eval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEvD,OAAO,QAAQ,eAAe,CAAC;IAC9B,UAAU,iBAAiB;QAC1B,IAAI,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,eAAe,CAAC,CAAA;KACjD;CACD;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;;iBAGrB,CAAA;AAEF,wBAA8B,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,gBAAgB,iBAyCvG;AAID,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,QAoDvC"}

package/dist/commands/help.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import type { ContainerContext } from '../container.js';
+declare module '../command.js' {
+    interface AvailableCommands {
+        help: ReturnType<typeof commands.registerHandler>;
+    }
+}
+export declare const argsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    _: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    dispatchSource: z.ZodDefault<z.ZodEnum<{
+        cli: "cli";
+        headless: "headless";
+        mcp: "mcp";
+        rpc: "rpc";
+    }>>;
+}, z.core.$strip>;
+/**
+ * Format CLI-oriented help text for a single command.
+ * Exported so other commands (like describe) can reuse it.
+ */
+export declare function formatCommandHelp(name: string, Cmd: any, colors: any): string;
+export default function help(_options: z.infer<typeof argsSchema>, context: ContainerContext): Promise<void>;
+//# sourceMappingURL=help.d.ts.map

package/dist/commands/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEvD,OAAO,QAAQ,eAAe,CAAC;IAC9B,UAAU,iBAAiB;QAC1B,IAAI,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,eAAe,CAAC,CAAA;KACjD;CACD;AAED,eAAO,MAAM,UAAU;;;;;;;;;;iBAAkC,CAAA;AA+CzD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,MAAM,CAoD7E;AAiCD,wBAA8B,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,gBAAgB,iBAsFjG"}

package/dist/commands/index.d.ts

@@ -0,0 +1,18 @@
+export { Command, commands, CommandsRegistry, type AvailableCommands, type CommandsInterface, type CommandHandler, type CommandState, type CommandOptions } from '../command.js';
+import './run.js';
+import './console.js';
+import './serve.js';
+import './chat.js';
+import './prompt.js';
+import './mcp.js';
+import './sandbox-mcp.js';
+import './describe.js';
+import './eval.js';
+import './help.js';
+import './scaffold.js';
+import './introspect.js';
+import './save-api-docs.js';
+import './bootstrap.js';
+import './select.js';
+import './code.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAA;AAGhL,OAAO,UAAU,CAAA;AACjB,OAAO,cAAc,CAAA;AACrB,OAAO,YAAY,CAAA;AACnB,OAAO,WAAW,CAAA;AAClB,OAAO,aAAa,CAAA;AACpB,OAAO,UAAU,CAAA;AACjB,OAAO,kBAAkB,CAAA;AACzB,OAAO,eAAe,CAAA;AACtB,OAAO,WAAW,CAAA;AAClB,OAAO,WAAW,CAAA;AAClB,OAAO,eAAe,CAAA;AACtB,OAAO,iBAAiB,CAAA;AACxB,OAAO,oBAAoB,CAAA;AAC3B,OAAO,gBAAgB,CAAA;AACvB,OAAO,aAAa,CAAA;AACpB,OAAO,WAAW,CAAA"}

package/dist/commands/introspect.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import '../introspection/scan.js';
+declare module '../command.js' {
+    interface AvailableCommands {
+        introspect: ReturnType<typeof commands.registerHandler>;
+    }
+}
+export declare const argsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    _: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    dispatchSource: z.ZodDefault<z.ZodEnum<{
+        cli: "cli";
+        headless: "headless";
+        mcp: "mcp";
+        rpc: "rpc";
+    }>>;
+    src: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    output: z.ZodOptional<z.ZodString>;
+    'dry-run': z.ZodDefault<z.ZodBoolean>;
+    'include-private': z.ZodDefault<z.ZodBoolean>;
+    lint: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+//# sourceMappingURL=introspect.d.ts.map

package/dist/commands/introspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.d.ts","sourceRoot":"","sources":["../../src/commands/introspect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,0BAA0B,CAAA;AAEjC,OAAO,QAAQ,eAAe,CAAC;IAC9B,UAAU,iBAAiB;QAC1B,UAAU,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,eAAe,CAAC,CAAA;KACvD;CACD;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;iBAMrB,CAAA"}

package/dist/commands/mcp.d.ts

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import type { ContainerContext } from '../container.js';
+declare module '../command.js' {
+    interface AvailableCommands {
+        mcp: ReturnType<typeof commands.registerHandler>;
+    }
+}
+export declare const argsSchema: z.ZodObject<{
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    _: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    dispatchSource: z.ZodDefault<z.ZodEnum<{
+        cli: "cli";
+        headless: "headless";
+        mcp: "mcp";
+        rpc: "rpc";
+    }>>;
+    transport: z.ZodDefault<z.ZodEnum<{
+        stdio: "stdio";
+        http: "http";
+    }>>;
+    port: z.ZodDefault<z.ZodNumber>;
+    name: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    mcpCompat: z.ZodOptional<z.ZodEnum<{
+        standard: "standard";
+        codex: "codex";
+    }>>;
+    stdioCompat: z.ZodOptional<z.ZodEnum<{
+        standard: "standard";
+        codex: "codex";
+        auto: "auto";
+    }>>;
+}, z.core.$strip>;
+export default function mcp(options: z.infer<typeof argsSchema>, context: ContainerContext): Promise<void>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/commands/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAGvD,OAAO,QAAQ,eAAe,CAAC;IAC9B,UAAU,iBAAiB;QAC1B,GAAG,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,eAAe,CAAC,CAAA;KAChD;CACD;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;iBASrB,CAAA;AAEF,wBAA8B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,gBAAgB,iBAkC/F"}

package/dist/commands/prompt.d.ts

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+import type { ContainerContext } from '../container.js';
+declare module '../command.js' {
+    interface AvailableCommands {
+        prompt: ReturnType<typeof commands.registerHandler>;
+    }
+}
+export declare const argsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    _: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    dispatchSource: z.ZodDefault<z.ZodEnum<{
+        cli: "cli";
+        headless: "headless";
+        mcp: "mcp";
+        rpc: "rpc";
+    }>>;
+    model: z.ZodOptional<z.ZodString>;
+    'include-frontmatter': z.ZodDefault<z.ZodBoolean>;
+    'skip-eval': z.ZodDefault<z.ZodBoolean>;
+    'permission-mode': z.ZodDefault<z.ZodEnum<{
+        default: "default";
+        acceptEdits: "acceptEdits";
+        bypassPermissions: "bypassPermissions";
+        plan: "plan";
+    }>>;
+    'in-folder': z.ZodOptional<z.ZodString>;
+    'out-file': z.ZodOptional<z.ZodString>;
+    'include-output': z.ZodDefault<z.ZodBoolean>;
+    'inputs-file': z.ZodOptional<z.ZodString>;
+    parallel: z.ZodDefault<z.ZodBoolean>;
+    'exclude-sections': z.ZodOptional<z.ZodString>;
+    chrome: z.ZodDefault<z.ZodBoolean>;
+    'dry-run': z.ZodDefault<z.ZodBoolean>;
+    local: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export default function prompt(options: z.infer<typeof argsSchema>, context: ContainerContext): Promise<void>;
+//# sourceMappingURL=prompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/commands/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEvD,OAAO,QAAQ,eAAe,CAAC;IAC9B,UAAU,iBAAiB;QAC1B,MAAM,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,eAAe,CAAC,CAAA;KACnD;CACD;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAcrB,CAAA;AAqzBF,wBAA8B,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,gBAAgB,iBAgIlG"}

package/dist/commands/run.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import type { ContainerContext } from '../container.js';
+declare module '../command.js' {
+    interface AvailableCommands {
+        run: ReturnType<typeof commands.registerHandler>;
+    }
+}
+export declare const argsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    _: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    dispatchSource: z.ZodDefault<z.ZodEnum<{
+        cli: "cli";
+        headless: "headless";
+        mcp: "mcp";
+        rpc: "rpc";
+    }>>;
+    safe: z.ZodDefault<z.ZodBoolean>;
+    console: z.ZodDefault<z.ZodBoolean>;
+    onlySections: z.ZodOptional<z.ZodString>;
+    dontInjectContext: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export default function run(options: z.infer<typeof argsSchema>, context: ContainerContext): Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/dist/commands/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEvD,OAAO,QAAQ,eAAe,CAAC;IAC9B,UAAU,iBAAiB;QAC1B,GAAG,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,eAAe,CAAC,CAAA;KAChD;CACD;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;;;;iBAKrB,CAAA;AA+MF,wBAA8B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,gBAAgB,iBAgD/F"}

package/dist/commands/sandbox-mcp.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import type { ContainerContext } from '../container.js';
+declare module '../command.js' {
+    interface AvailableCommands {
+        'sandbox-mcp': ReturnType<typeof commands.registerHandler>;
+    }
+}
+export declare const argsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    _: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    dispatchSource: z.ZodDefault<z.ZodEnum<{
+        cli: "cli";
+        headless: "headless";
+        mcp: "mcp";
+        rpc: "rpc";
+    }>>;
+    transport: z.ZodDefault<z.ZodEnum<{
+        stdio: "stdio";
+        http: "http";
+    }>>;
+    port: z.ZodDefault<z.ZodNumber>;
+    mcpCompat: z.ZodOptional<z.ZodEnum<{
+        standard: "standard";
+        codex: "codex";
+    }>>;
+    stdioCompat: z.ZodOptional<z.ZodEnum<{
+        standard: "standard";
+        codex: "codex";
+        auto: "auto";
+    }>>;
+}, z.core.$strip>;
+export default function mcpSandbox(options: z.infer<typeof argsSchema>, context: ContainerContext): Promise<void>;
+//# sourceMappingURL=sandbox-mcp.d.ts.map

package/dist/commands/sandbox-mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-mcp.d.ts","sourceRoot":"","sources":["../../src/commands/sandbox-mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAKvD,OAAO,QAAQ,eAAe,CAAC;IAC9B,UAAU,iBAAiB;QAC1B,aAAa,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,eAAe,CAAC,CAAA;KAC1D;CACD;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;iBAOrB,CAAA;AAEF,wBAA8B,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,gBAAgB,iBAuZtG"}

package/dist/commands/save-api-docs.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import type { ContainerContext } from '../container.js';
+declare module '../command.js' {
+    interface AvailableCommands {
+        introspect: ReturnType<typeof commands.registerHandler>;
+    }
+}
+export declare const argsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    _: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    dispatchSource: z.ZodDefault<z.ZodEnum<{
+        cli: "cli";
+        headless: "headless";
+        mcp: "mcp";
+        rpc: "rpc";
+    }>>;
+    outputPath: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export declare function apiDocs(options: z.infer<typeof argsSchema>, context: ContainerContext): Promise<void>;
+//# sourceMappingURL=save-api-docs.d.ts.map

package/dist/commands/save-api-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-api-docs.d.ts","sourceRoot":"","sources":["../../src/commands/save-api-docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEvD,OAAO,QAAQ,eAAe,CAAC;IAC9B,UAAU,iBAAiB;QAC1B,UAAU,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,eAAe,CAAC,CAAA;KACvD;CACD;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;iBAErB,CAAA;AAEF,wBAAsB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,gBAAgB,iBA2B3F"}