@soederpop/luca 0.1.2 → 0.1.3

package/dist/agi/features/luca-coder.d.ts

@@ -0,0 +1,323 @@
+import { z } from 'zod';
+import { Feature } from '../feature.js';
+import type { Assistant } from './assistant.js';
+declare module '@soederpop/luca/feature' {
+    interface AvailableFeatures {
+        lucaCoder: typeof LucaCoder;
+    }
+}
+/** Permission level for a tool. 'allow' runs immediately, 'ask' blocks for user approval, 'deny' rejects. */
+export type PermissionLevel = 'allow' | 'ask' | 'deny';
+/** A pending approval awaiting user decision. */
+export interface PendingApproval {
+    id: string;
+    toolName: string;
+    args: Record<string, any>;
+    timestamp: number;
+    resolve: (decision: 'approve' | 'deny') => void;
+}
+/** Tool bundle spec — either a feature name string, or an object with filtering. */
+export type ToolBundleSpec = string | {
+    feature: string;
+    only?: string[];
+    except?: string[];
+};
+export declare const LucaCoderEventsSchema: z.ZodObject<{
+    stateChange: z.ZodTuple<[z.ZodAny], null>;
+    enabled: z.ZodTuple<[], null>;
+    started: z.ZodTuple<[], null>;
+    permissionRequest: z.ZodTuple<[z.ZodObject<{
+        id: z.ZodString;
+        toolName: z.ZodString;
+        args: z.ZodRecord<z.ZodString, z.ZodAny>;
+    }, z.core.$strip>], null>;
+    permissionGranted: z.ZodTuple<[z.ZodString], null>;
+    permissionDenied: z.ZodTuple<[z.ZodString], null>;
+    toolBlocked: z.ZodTuple<[z.ZodString, z.ZodString], null>;
+    chunk: z.ZodTuple<[z.ZodString], null>;
+    response: z.ZodTuple<[z.ZodString], null>;
+    toolCall: z.ZodTuple<[z.ZodString, z.ZodAny], null>;
+    toolResult: z.ZodTuple<[z.ZodString, z.ZodAny], null>;
+    toolError: z.ZodTuple<[z.ZodString, z.ZodAny], null>;
+}, z.core.$strip>;
+export declare const LucaCoderStateSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    started: z.ZodBoolean;
+    permissions: z.ZodRecord<z.ZodString, z.ZodEnum<{
+        allow: "allow";
+        ask: "ask";
+        deny: "deny";
+    }>>;
+    defaultPermission: z.ZodEnum<{
+        allow: "allow";
+        ask: "ask";
+        deny: "deny";
+    }>;
+    pendingApprovals: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        toolName: z.ZodString;
+        args: z.ZodRecord<z.ZodString, z.ZodAny>;
+        timestamp: z.ZodNumber;
+    }, z.core.$strip>>;
+    approvalHistory: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        toolName: z.ZodString;
+        decision: z.ZodEnum<{
+            deny: "deny";
+            approve: "approve";
+        }>;
+        timestamp: z.ZodNumber;
+    }, z.core.$strip>>;
+    loadedSkills: z.ZodArray<z.ZodString>;
+}, z.core.$loose>;
+export declare const LucaCoderOptionsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    cached: z.ZodOptional<z.ZodBoolean>;
+    enable: z.ZodOptional<z.ZodBoolean>;
+    tools: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        feature: z.ZodString;
+        only: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        except: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>]>>>;
+    permissions: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<{
+        allow: "allow";
+        ask: "ask";
+        deny: "deny";
+    }>>>;
+    defaultPermission: z.ZodDefault<z.ZodEnum<{
+        allow: "allow";
+        ask: "ask";
+        deny: "deny";
+    }>>;
+    systemPrompt: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    maxTokens: z.ZodDefault<z.ZodNumber>;
+    local: z.ZodDefault<z.ZodBoolean>;
+    historyMode: z.ZodOptional<z.ZodEnum<{
+        session: "session";
+        lifecycle: "lifecycle";
+        daily: "daily";
+        persistent: "persistent";
+    }>>;
+    folder: z.ZodOptional<z.ZodString>;
+    skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    autoLoadLucaSkill: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type LucaCoderState = z.infer<typeof LucaCoderStateSchema>;
+export type LucaCoderOptions = z.infer<typeof LucaCoderOptionsSchema>;
+/**
+ * A coding assistant that owns a lower-level Assistant instance and
+ * gates all tool calls through a permission system.
+ *
+ * Comes with built-in Bash tool (via proc.execAndCapture) and auto-loads
+ * the luca-framework skill when found in .claude/skills paths.
+ *
+ * Tools are stacked from feature bundles (fileTools, etc.)
+ * and each tool can be set to 'allow' (runs immediately), 'ask' (blocks
+ * until user approves/denies), or 'deny' (always rejected).
+ *
+ * @example
+ * ```typescript
+ * const coder = container.feature('lucaCoder', {
+ *   tools: ['fileTools'],
+ *   permissions: {
+ *     readFile: 'allow',
+ *     searchFiles: 'allow',
+ *     writeFile: 'ask',
+ *     bash: 'ask',
+ *   },
+ *   defaultPermission: 'ask',
+ *   systemPrompt: 'You are a coding assistant.',
+ * })
+ *
+ * coder.on('permissionRequest', ({ id, toolName, args }) => {
+ *   console.log(`Tool "${toolName}" wants to run with`, args)
+ *   coder.approve(id)  // or coder.deny(id)
+ * })
+ *
+ * await coder.ask('Refactor the auth module to use async/await')
+ * ```
+ *
+ * @extends Feature
+ */
+export declare class LucaCoder extends Feature<LucaCoderState, LucaCoderOptions> {
+    static shortcut: "features.lucaCoder";
+    static stateSchema: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        started: z.ZodBoolean;
+        permissions: z.ZodRecord<z.ZodString, z.ZodEnum<{
+            allow: "allow";
+            ask: "ask";
+            deny: "deny";
+        }>>;
+        defaultPermission: z.ZodEnum<{
+            allow: "allow";
+            ask: "ask";
+            deny: "deny";
+        }>;
+        pendingApprovals: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            toolName: z.ZodString;
+            args: z.ZodRecord<z.ZodString, z.ZodAny>;
+            timestamp: z.ZodNumber;
+        }, z.core.$strip>>;
+        approvalHistory: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            toolName: z.ZodString;
+            decision: z.ZodEnum<{
+                deny: "deny";
+                approve: "approve";
+            }>;
+            timestamp: z.ZodNumber;
+        }, z.core.$strip>>;
+        loadedSkills: z.ZodArray<z.ZodString>;
+    }, z.core.$loose>;
+    static optionsSchema: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        _cacheKey: z.ZodOptional<z.ZodString>;
+        cached: z.ZodOptional<z.ZodBoolean>;
+        enable: z.ZodOptional<z.ZodBoolean>;
+        tools: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            feature: z.ZodString;
+            only: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            except: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>]>>>;
+        permissions: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<{
+            allow: "allow";
+            ask: "ask";
+            deny: "deny";
+        }>>>;
+        defaultPermission: z.ZodDefault<z.ZodEnum<{
+            allow: "allow";
+            ask: "ask";
+            deny: "deny";
+        }>>;
+        systemPrompt: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        maxTokens: z.ZodDefault<z.ZodNumber>;
+        local: z.ZodDefault<z.ZodBoolean>;
+        historyMode: z.ZodOptional<z.ZodEnum<{
+            session: "session";
+            lifecycle: "lifecycle";
+            daily: "daily";
+            persistent: "persistent";
+        }>>;
+        folder: z.ZodOptional<z.ZodString>;
+        skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        autoLoadLucaSkill: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>;
+    static eventsSchema: z.ZodObject<{
+        stateChange: z.ZodTuple<[z.ZodAny], null>;
+        enabled: z.ZodTuple<[], null>;
+        started: z.ZodTuple<[], null>;
+        permissionRequest: z.ZodTuple<[z.ZodObject<{
+            id: z.ZodString;
+            toolName: z.ZodString;
+            args: z.ZodRecord<z.ZodString, z.ZodAny>;
+        }, z.core.$strip>], null>;
+        permissionGranted: z.ZodTuple<[z.ZodString], null>;
+        permissionDenied: z.ZodTuple<[z.ZodString], null>;
+        toolBlocked: z.ZodTuple<[z.ZodString, z.ZodString], null>;
+        chunk: z.ZodTuple<[z.ZodString], null>;
+        response: z.ZodTuple<[z.ZodString], null>;
+        toolCall: z.ZodTuple<[z.ZodString, z.ZodAny], null>;
+        toolResult: z.ZodTuple<[z.ZodString, z.ZodAny], null>;
+        toolError: z.ZodTuple<[z.ZodString, z.ZodAny], null>;
+    }, z.core.$strip>;
+    /**
+     * Default system prompt that establishes baseline coding assistant identity
+     * and luca framework knowledge. Project-specific CLAUDE.md and loaded skills
+     * are appended below this — the skill will reinforce and expand on these
+     * fundamentals without conflicting.
+     */
+    static defaultSystemPrompt: string;
+    /** The inner assistant instance. Created during start(). */
+    private _assistant;
+    /** Map of pending approval promises keyed by ID. */
+    private _pendingResolvers;
+    get initialState(): LucaCoderState;
+    /** The inner assistant. Throws if not started. */
+    get assistant(): Assistant;
+    /** Current permission map from state. */
+    get permissions(): Record<string, PermissionLevel>;
+    /** Current pending approvals. */
+    get pendingApprovals(): PendingApproval[];
+    /** Whether the assistant is started and ready. */
+    get isStarted(): boolean;
+    /** The tools registered on the inner assistant. */
+    get tools(): Record<string, any>;
+    /** The conversation on the inner assistant (if started). */
+    get conversation(): import("./conversation.js").Conversation | undefined;
+    /** Messages from the inner assistant's conversation. */
+    get messages(): import("openai/resources/index.mjs").ChatCompletionMessageParam[];
+    /** Get the effective permission level for a tool. */
+    getPermission(toolName: string): PermissionLevel;
+    /** Set permission level for one or more tools. */
+    setPermission(toolName: string | string[], level: PermissionLevel): this;
+    /** Set the default permission level for unconfigured tools. */
+    setDefaultPermission(level: PermissionLevel): this;
+    /** Allow a tool (or tools) to run without approval. */
+    permitTool(...toolNames: string[]): this;
+    /** Require approval before a tool (or tools) can run. */
+    gateTool(...toolNames: string[]): this;
+    /** Block a tool (or tools) from ever running. */
+    blockTool(...toolNames: string[]): this;
+    /** Approve a pending tool call by ID. The tool will execute. */
+    approve(id: string): this;
+    /** Deny a pending tool call by ID. The tool call will be skipped. */
+    deny(id: string): this;
+    /** Approve all pending tool calls. */
+    approveAll(): this;
+    /** Deny all pending tool calls. */
+    denyAll(): this;
+    /**
+     * Execute a shell command string and return its output.
+     * Uses proc.execAndCapture under the hood — runs `sh -c <command>`.
+     */
+    bash({ command, cwd, timeout }: {
+        command: string;
+        cwd?: string;
+        timeout?: number;
+    }): Promise<{
+        exitCode: number;
+        stdout: string;
+        stderr: string;
+        success: boolean;
+    }>;
+    /**
+     * Read project instruction files (CLAUDE.md, AGENTS.md, LUCA.md) from the
+     * project root if they exist, and return their combined content.
+     */
+    private _loadProjectInstructions;
+    /**
+     * Detect and load skills into the system prompt context.
+     * Auto-loads luca-framework if found and autoLoadLucaSkill is true.
+     */
+    private _loadSkillsIntoContext;
+    /**
+     * Initialize the inner assistant, register the bash tool, stack tool bundles,
+     * auto-load skills, and wire up the permission interceptor.
+     */
+    start(): Promise<this>;
+    /**
+     * Ask the coder a question. Auto-starts if needed.
+     * Tool calls will be gated by the permission system.
+     */
+    ask(question: string, options?: Record<string, any>): Promise<string>;
+    /**
+     * Add a tool bundle after initialization. Useful for dynamically
+     * extending the assistant's capabilities.
+     */
+    use(spec: ToolBundleSpec): this;
+    /** Resolve a tool bundle spec and register its tools on the inner assistant. */
+    private _stackToolBundle;
+    /** Create a pending approval, emit the event, and return a promise that resolves with the decision. */
+    private _requestApproval;
+    /** Remove a pending approval from state. */
+    private _removePending;
+    /** Record a decision in the approval history. */
+    private _recordDecision;
+}
+export default LucaCoder;
+//# sourceMappingURL=luca-coder.d.ts.map

package/dist/agi/features/luca-coder.d.ts.map

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