@soederpop/luca 0.1.2 → 0.2.1

package/dist/agi/features/assistants-manager.d.ts

@@ -0,0 +1,236 @@
+import { z } from 'zod';
+import { Feature } from '../feature.js';
+import type { Assistant } from './assistant.js';
+import type { InterceptorFn, InterceptorPoint, InterceptorPoints } from '../lib/interceptor-chain.js';
+declare module '@soederpop/luca/feature' {
+    interface AvailableFeatures {
+        assistantsManager: typeof AssistantsManager;
+    }
+}
+/**
+ * Metadata for a discovered assistant subdirectory.
+ */
+export interface AssistantEntry {
+    /** The subdirectory name, used as the assistant identifier. */
+    name: string;
+    /** Absolute path to the assistant folder. */
+    folder: string;
+    /** Whether a CORE.md system prompt file exists. */
+    hasCorePrompt: boolean;
+    /** Whether a tools.ts file exists. */
+    hasTools: boolean;
+    /** Whether a hooks.ts file exists. */
+    hasHooks: boolean;
+    /** Whether a voice.yaml configuration file exists. */
+    hasVoice: boolean;
+}
+export declare const AssistantsManagerEventsSchema: z.ZodObject<{
+    stateChange: z.ZodTuple<[z.ZodAny], null>;
+    enabled: z.ZodTuple<[], null>;
+    discovered: z.ZodTuple<[], null>;
+    assistantCreated: z.ZodTuple<[z.ZodString, z.ZodAny], null>;
+    assistantRegistered: z.ZodTuple<[z.ZodString], null>;
+}, z.core.$strip>;
+export declare const AssistantsManagerStateSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    discovered: z.ZodBoolean;
+    assistantCount: z.ZodNumber;
+    activeCount: z.ZodNumber;
+    entries: z.ZodRecord<z.ZodString, z.ZodAny>;
+    instances: z.ZodRecord<z.ZodString, z.ZodAny>;
+    factories: z.ZodRecord<z.ZodString, z.ZodAny>;
+    extraFolders: z.ZodArray<z.ZodString>;
+}, z.core.$loose>;
+export declare const AssistantsManagerOptionsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    cached: z.ZodOptional<z.ZodBoolean>;
+    enable: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type AssistantsManagerState = z.infer<typeof AssistantsManagerStateSchema>;
+export type AssistantsManagerOptions = z.infer<typeof AssistantsManagerOptionsSchema>;
+/**
+ * Discovers and manages assistant definitions by looking for subdirectories
+ * in two locations: ~/.luca/assistants/ and cwd/assistants/. Each subdirectory
+ * containing a CORE.md is treated as an assistant definition.
+ *
+ * Use `discover()` to scan for available assistants, `list()` to enumerate them,
+ * and `create(name)` to instantiate one as a running Assistant feature.
+ *
+ * @extends Feature
+ *
+ * @example
+ * ```typescript
+ * const manager = container.feature('assistantsManager')
+ * manager.discover()
+ * console.log(manager.list()) // [{ name: 'chief-of-staff', folder: '...', ... }]
+ * const assistant = manager.create('chief-of-staff')
+ * const answer = await assistant.ask('Hello!')
+ * ```
+ */
+export declare class AssistantsManager extends Feature<AssistantsManagerState, AssistantsManagerOptions> {
+    static stateSchema: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        discovered: z.ZodBoolean;
+        assistantCount: z.ZodNumber;
+        activeCount: z.ZodNumber;
+        entries: z.ZodRecord<z.ZodString, z.ZodAny>;
+        instances: z.ZodRecord<z.ZodString, z.ZodAny>;
+        factories: z.ZodRecord<z.ZodString, z.ZodAny>;
+        extraFolders: 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>;
+    }, z.core.$strip>;
+    static eventsSchema: z.ZodObject<{
+        stateChange: z.ZodTuple<[z.ZodAny], null>;
+        enabled: z.ZodTuple<[], null>;
+        discovered: z.ZodTuple<[], null>;
+        assistantCreated: z.ZodTuple<[z.ZodString, z.ZodAny], null>;
+        assistantRegistered: z.ZodTuple<[z.ZodString], null>;
+    }, z.core.$strip>;
+    static shortcut: "features.assistantsManager";
+    /** @returns Default state with discovery not yet run and zero counts. */
+    get initialState(): AssistantsManagerState;
+    /** Discovered assistant entries keyed by name. */
+    get entries(): Record<string, AssistantEntry>;
+    /** Active assistant instances keyed by name. */
+    get instances(): Record<string, Assistant>;
+    /** Registered factory functions keyed by name. */
+    get factories(): Record<string, (options: Record<string, any>) => Assistant>;
+    /** Interceptor registrations to be applied to every assistant this manager creates. */
+    private _interceptors;
+    /**
+     * Registers a pipeline interceptor that is applied to every assistant created by this manager.
+     * Interceptors are applied at the given interception point on each assistant at creation time.
+     * This mirrors the per-assistant `assistant.intercept(point, fn)` API, but scopes it globally
+     * across all assistants managed here — useful for cross-cutting concerns like logging, tracing,
+     * or policy enforcement.
+     *
+     * @param {InterceptorPoint} point - The interception point (beforeAsk, beforeTurn, beforeToolCall, afterToolCall, beforeResponse)
+     * @param {InterceptorFn<InterceptorPoints[K]>} fn - Middleware function receiving (ctx, next)
+     * @returns {this} This instance, for chaining
+     *
+     * @example
+     * ```typescript
+     * manager.intercept('beforeAsk', async (ctx, next) => {
+     *   console.log(`[${ctx.assistant.name}] asking: ${ctx.message}`)
+     *   await next()
+     * })
+     * ```
+     */
+    intercept<K extends InterceptorPoint>(point: K, fn: InterceptorFn<InterceptorPoints[K]>): this;
+    /**
+     * Discovers assistants by listing subdirectories in ~/.luca/assistants/
+     * and cwd/assistants/. Each subdirectory containing a CORE.md is an assistant.
+     *
+     * @returns {Promise<this>} This instance, for chaining
+     */
+    /**
+     * Registers an additional folder to scan during assistant discovery and
+     * immediately triggers a new discovery pass.
+     *
+     * @param {string} folderPath - Absolute path to a folder containing assistant subdirectories
+     * @returns {Promise<this>} This instance, for chaining
+     *
+     * @example
+     * ```typescript
+     * await manager.addDiscoveryFolder('/path/to/more/assistants')
+     * console.log(manager.available) // includes assistants from the new folder
+     * ```
+     */
+    addDiscoveryFolder(folderPath: string): Promise<this>;
+    discover(): Promise<this>;
+    /**
+     * Downloads the core assistants that ship with luca from GitHub
+     * into ~/.luca/assistants.
+     *
+     * @returns {Promise<{ files: string[] }>} The files extracted
+     *
+     * @example
+     * ```typescript
+     * const manager = container.feature('assistantsManager')
+     * await manager.downloadLucaCoreAssistants()
+     * await manager.discover()
+     * console.log(manager.available)
+     * ```
+     */
+    downloadLucaCoreAssistants(): Promise<any>;
+    get available(): string[];
+    /**
+     * Returns all discovered assistant entries as an array.
+     *
+     * @returns {AssistantEntry[]} All discovered entries
+     */
+    list(): AssistantEntry[];
+    /**
+     * Looks up a single assistant entry by name.
+     *
+     * @param {string} name - The assistant name (e.g. 'chief-of-staff')
+     * @returns {AssistantEntry | undefined} The entry, or undefined if not found
+     */
+    get(name: string): AssistantEntry | undefined;
+    /**
+     * Registers a factory function that creates an assistant at runtime.
+     * Registered factories take precedence over discovered entries when
+     * calling `create()`.
+     *
+     * @param {string} id - The assistant identifier
+     * @param {(options: Record<string, any>) => Assistant} factory - Factory function that receives create options and returns an Assistant
+     * @returns {this} This instance, for chaining
+     *
+     * @example
+     * ```typescript
+     * manager.register('custom-bot', (options) => {
+     *   return container.feature('assistant', {
+     *     systemPrompt: 'You are a custom bot.',
+     *     ...options,
+     *   })
+     * })
+     * const bot = manager.create('custom-bot')
+     * ```
+     */
+    register(id: string, factory: (options: Record<string, any>) => Assistant): this;
+    /**
+     * Creates and returns a new Assistant feature instance for the given name.
+     * Checks runtime-registered factories first, then falls back to discovered entries.
+     * The assistant is configured with the discovered folder path. Any additional
+     * options are merged in.
+     *
+     * @param {string} name - The assistant name (must match a registered factory or discovered entry)
+     * @param {Record<string, any>} options - Additional options to pass to the Assistant constructor
+     * @returns {Assistant} The created assistant instance
+     * @throws {Error} If the name is not found among registered factories or discovered assistants
+     *
+     * @example
+     * ```typescript
+     * const assistant = manager.create('chief-of-staff', { model: 'gpt-4.1' })
+     * ```
+     */
+    create(name: string, options?: Record<string, any>): Assistant;
+    /**
+     * Wires an assistant into the manager: bridges all assistant events up to the manager
+     * as `assistantEvent:<eventName>` with (assistant, ...originalArgs), and applies any
+     * globally registered interceptors.
+     */
+    private _bindAssistant;
+    /**
+     * Returns a previously created assistant instance by name.
+     *
+     * @param {string} name - The assistant name
+     * @returns {Assistant | undefined} The instance, or undefined if not yet created
+     */
+    getInstance(name: string): Assistant | undefined;
+    /**
+     * Generates a markdown summary of all discovered assistants,
+     * listing their names and which definition files are present.
+     *
+     * @returns {string} Markdown-formatted summary
+     */
+    toSummary(): string;
+}
+export default AssistantsManager;
+//# sourceMappingURL=assistants-manager.d.ts.map

package/dist/agi/features/assistants-manager.d.ts.map

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

package/dist/agi/features/autonomous-assistant.d.ts

@@ -0,0 +1,281 @@
+import { z } from 'zod';
+import { Feature } from '../feature.js';
+import type { Assistant } from './assistant.js';
+declare module '@soederpop/luca/feature' {
+    interface AvailableFeatures {
+        autoAssistant: typeof AutonomousAssistant;
+    }
+}
+/** 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 AutonomousAssistantEventsSchema: 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 AutonomousAssistantStateSchema: 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>>;
+}, z.core.$loose>;
+export declare const AutonomousAssistantOptionsSchema: 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>;
+    historyMode: z.ZodOptional<z.ZodEnum<{
+        session: "session";
+        lifecycle: "lifecycle";
+        daily: "daily";
+        persistent: "persistent";
+    }>>;
+    folder: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AutonomousAssistantState = z.infer<typeof AutonomousAssistantStateSchema>;
+export type AutonomousAssistantOptions = z.infer<typeof AutonomousAssistantOptionsSchema>;
+/**
+ * An autonomous assistant that owns a lower-level Assistant instance and
+ * gates all tool calls through a permission system.
+ *
+ * Tools are stacked from feature bundles (fileTools, processManager, etc.)
+ * and each tool can be set to 'allow' (runs immediately), 'ask' (blocks
+ * until user approves/denies), or 'deny' (always rejected).
+ *
+ * @example
+ * ```typescript
+ * const auto = container.feature('autoAssistant', {
+ *   tools: ['fileTools', { feature: 'processManager', except: ['killAllProcesses'] }],
+ *   permissions: {
+ *     readFile: 'allow',
+ *     searchFiles: 'allow',
+ *     writeFile: 'ask',
+ *     editFile: 'ask',
+ *     deleteFile: 'deny',
+ *   },
+ *   defaultPermission: 'ask',
+ *   systemPrompt: 'You are a coding assistant.',
+ * })
+ *
+ * auto.on('permissionRequest', ({ id, toolName, args }) => {
+ *   console.log(`Tool "${toolName}" wants to run with`, args)
+ *   // Show UI, then:
+ *   auto.approve(id)  // or auto.deny(id)
+ * })
+ *
+ * await auto.ask('Refactor the auth module to use async/await')
+ * ```
+ *
+ * @extends Feature
+ */
+export declare class AutonomousAssistant extends Feature<AutonomousAssistantState, AutonomousAssistantOptions> {
+    static shortcut: "features.autoAssistant";
+    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>>;
+    }, 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>;
+        historyMode: z.ZodOptional<z.ZodEnum<{
+            session: "session";
+            lifecycle: "lifecycle";
+            daily: "daily";
+            persistent: "persistent";
+        }>>;
+        folder: z.ZodOptional<z.ZodString>;
+    }, 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>;
+    /** The inner assistant instance. Created during start(). */
+    private _assistant;
+    /** Map of pending approval promises keyed by ID. */
+    private _pendingResolvers;
+    get initialState(): AutonomousAssistantState;
+    /** 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;
+    /**
+     * Initialize the inner assistant, stack tool bundles, and wire up
+     * the permission interceptor.
+     */
+    start(): Promise<this>;
+    /**
+     * Ask the autonomous assistant 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 AutonomousAssistant;
+//# sourceMappingURL=autonomous-assistant.d.ts.map

package/dist/agi/features/autonomous-assistant.d.ts.map

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