luca 2.0.0 → 3.0.0

package/dist/commands/scaffold.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import type { ContainerContext } from '../container.js';
+declare module '../command.js' {
+    interface AvailableCommands {
+        scaffold: 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";
+    }>>;
+    description: z.ZodOptional<z.ZodString>;
+    output: z.ZodOptional<z.ZodString>;
+    print: z.ZodDefault<z.ZodBoolean>;
+    tutorial: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export default function scaffoldCommand(options: z.infer<typeof argsSchema>, context: ContainerContext): Promise<void>;
+//# sourceMappingURL=scaffold.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/commands/scaffold.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAIvD,OAAO,QAAQ,eAAe,CAAC;IAC9B,UAAU,iBAAiB;QAC1B,QAAQ,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,eAAe,CAAC,CAAA;KACrD;CACD;AAID,eAAO,MAAM,UAAU;;;;;;;;;;;;;;iBAKrB,CAAA;AAwCF,wBAA8B,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,gBAAgB,iBA8J3G"}

package/dist/commands/select.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import type { ContainerContext } from '../container.js';
+declare module '../command.js' {
+    interface AvailableCommands {
+        select: 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>;
+    noCache: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export default function selectCommand(options: z.infer<typeof argsSchema>, context: ContainerContext): Promise<void>;
+//# sourceMappingURL=select.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../src/commands/select.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;;;;;;;;;;;;iBAGrB,CAAA;AAEF,wBAA8B,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,gBAAgB,iBAsEzG"}

package/dist/commands/serve.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import type { ContainerContext } from '../container.js';
+declare module '../command.js' {
+    interface AvailableCommands {
+        serve: 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";
+    }>>;
+    port: z.ZodDefault<z.ZodNumber>;
+    endpointsDir: z.ZodOptional<z.ZodString>;
+    staticDir: z.ZodOptional<z.ZodString>;
+    setup: z.ZodOptional<z.ZodString>;
+    cors: z.ZodDefault<z.ZodBoolean>;
+    force: z.ZodDefault<z.ZodBoolean>;
+    anyPort: z.ZodDefault<z.ZodBoolean>;
+    open: z.ZodDefault<z.ZodBoolean>;
+    watch: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export default function serve(options: z.infer<typeof argsSchema>, context: ContainerContext): Promise<void>;
+//# sourceMappingURL=serve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.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,KAAK,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,eAAe,CAAC,CAAA;KAClD;CACD;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;iBAUrB,CAAA;AAEF,wBAA8B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,gBAAgB,iBAmKjG"}

package/dist/container-describer.d.ts

@@ -0,0 +1,144 @@
+import type { IntrospectionSection, HelperIntrospection } from './introspection/index.js';
+type Platform = 'browser' | 'server' | 'node' | 'all';
+type ResolvedTarget = {
+    kind: 'container';
+} | {
+    kind: 'registry';
+    name: string;
+} | {
+    kind: 'helper';
+    registry: string;
+    id: string;
+} | {
+    kind: 'member';
+    registry: string;
+    id: string;
+    member: string;
+    memberType: 'method' | 'getter';
+} | {
+    kind: 'browser-helper';
+    id: string;
+} | {
+    kind: 'browser-member';
+    id: string;
+    member: string;
+    memberType: 'method' | 'getter';
+};
+type DescribeOptions = {
+    sections?: (IntrospectionSection | 'description')[];
+    noTitle?: boolean;
+    headingDepth?: number;
+    platform?: Platform;
+};
+type DescribeResult = {
+    json: any;
+    text: string;
+};
+type BrowserFeatureData = {
+    introspection: Map<string, HelperIntrospection>;
+    constructors: Map<string, any>;
+    available: string[];
+    collidingIds: Set<string>;
+};
+declare class DescribeError extends Error {
+    constructor(message: string);
+}
+/** Maps flag names to the section they represent. */
+declare const SECTION_FLAGS: Record<string, IntrospectionSection | 'description'>;
+/**
+ * Encapsulates container introspection and description logic.
+ * Discovers registries dynamically from the container's own state —
+ * it knows nothing about which helpers exist until it asks the container.
+ * Browser feature data can be injected externally via setBrowserData().
+ */
+export declare class ContainerDescriber {
+    container: any;
+    private _browserData;
+    private _initialized;
+    constructor(container: any);
+    /** The registry names this container actually has, discovered at runtime. */
+    private get registryNames();
+    /**
+     * Discover all helpers. Must be called before resolve/getData.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Inject browser feature data from an external source.
+     * The describer doesn't own browser loading — that's the caller's job.
+     */
+    setBrowserData(data: BrowserFeatureData): void;
+    /**
+     * High-level: describe one or more targets, returning combined json and text.
+     */
+    describe(targets: string[], options?: DescribeOptions): Promise<DescribeResult>;
+    /**
+     * Describe the container itself.
+     */
+    describeContainer(options?: DescribeOptions): Promise<DescribeResult>;
+    /**
+     * Describe a registry by name.
+     */
+    describeRegistry(registryName: string, options?: DescribeOptions): Promise<DescribeResult>;
+    /**
+     * Describe a specific helper by name (qualified or unqualified).
+     */
+    describeHelper(target: string, options?: DescribeOptions): Promise<DescribeResult>;
+    /**
+     * Describe a specific member (method or getter) on a helper.
+     */
+    describeMember(helperAndMember: string, options?: DescribeOptions): Promise<DescribeResult>;
+    /**
+     * Collect sections from a flags object (as produced by the CLI args schema).
+     */
+    static getSectionsFromFlags(flags: Record<string, any>): (IntrospectionSection | 'description')[];
+    /**
+     * Generate tool definitions suitable for use with AI assistant tool-calling interfaces.
+     * Registry names in the enum are populated dynamically from the container.
+     */
+    toTools(): Array<{
+        name: string;
+        description: string;
+        parameters: Record<string, any>;
+        execute: (args: any) => Promise<string>;
+    }>;
+    /**
+     * Parse a target string into one or more resolved targets.
+     */
+    resolve(target: string, platform?: Platform): ResolvedTarget[];
+    /**
+     * Get data for a resolved target.
+     */
+    getData(item: ResolvedTarget, options?: DescribeOptions): DescribeResult;
+    private normalizePlatform;
+    private shouldIncludeNode;
+    private shouldIncludeBrowser;
+    private normalize;
+    private fuzzyFind;
+    private fuzzyFindBrowser;
+    /**
+     * Match a user-provided name to an actual registry name on the container.
+     * Handles pluralization and case variations dynamically.
+     */
+    private matchRegistryName;
+    private resolveHelperMember;
+    private resolveBrowserHelperMember;
+    private getContainerData;
+    private getHelperData;
+    private getMemberData;
+    private getBrowserHelperData;
+    private getBrowserMemberData;
+    private getRegistryData;
+    private renderTitle;
+    private renderHelperText;
+    private renderHelperJson;
+    private renderBrowserHelperText;
+    private renderBrowserHelperJson;
+    private extractSummary;
+    private buildHelperSummary;
+    private buildBrowserHelperSummary;
+    private collectSharedMembers;
+    private findIntermediateParent;
+}
+export { DescribeError, SECTION_FLAGS };
+export type { ResolvedTarget, Platform, DescribeOptions, DescribeResult, BrowserFeatureData };
+//# sourceMappingURL=container-describer.d.ts.map

package/dist/container-describer.d.ts.map

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