@antaif3ng/til-work 0.1.0

package/dist/extensions/loader.js

@@ -0,0 +1,118 @@
+/**
+ * Extension discovery and loading.
+ * Scans .til/extensions/, ~/.til/extensions/, and config-specified paths.
+ */
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+function createExtensionAPI(extension, cwd, config, onToolRegistered) {
+    return {
+        cwd,
+        config,
+        registerTool(tool) {
+            extension.tools.set(tool.name, tool);
+            onToolRegistered?.();
+        },
+        registerCommand(cmd) {
+            extension.commands.set(cmd.name, cmd);
+        },
+        on(event, handler) {
+            if (!extension.handlers.has(event)) {
+                extension.handlers.set(event, []);
+            }
+            extension.handlers.get(event).push(handler);
+        },
+    };
+}
+function createEmptyExtension(path, name) {
+    return {
+        path,
+        name,
+        tools: new Map(),
+        commands: new Map(),
+        handlers: new Map(),
+    };
+}
+/**
+ * Load a single extension from an absolute path to a .ts or .js file.
+ */
+export async function loadExtension(extensionPath, cwd, config, onToolRegistered) {
+    if (!existsSync(extensionPath))
+        return null;
+    const name = extensionPath.split("/").pop()?.replace(/\.(ts|js)$/, "") ?? "unknown";
+    const extension = createEmptyExtension(extensionPath, name);
+    const api = createExtensionAPI(extension, cwd, config, onToolRegistered);
+    try {
+        const mod = await import(extensionPath);
+        const factory = mod.default ?? mod.activate ?? mod;
+        if (typeof factory === "function") {
+            await factory(api);
+        }
+        return extension;
+    }
+    catch (err) {
+        console.error(`Failed to load extension ${extensionPath}: ${err.message}`);
+        return null;
+    }
+}
+/**
+ * Discover extension paths from standard locations.
+ */
+export function discoverExtensionPaths(cwd, configPaths) {
+    const paths = [];
+    // 1. Project-local: .til/extensions/
+    const localDir = join(cwd, ".til", "extensions");
+    if (existsSync(localDir)) {
+        paths.push(...scanExtensionDir(localDir));
+    }
+    // 2. User global: ~/.til/extensions/
+    const globalDir = join(homedir(), ".til", "extensions");
+    if (existsSync(globalDir)) {
+        paths.push(...scanExtensionDir(globalDir));
+    }
+    // 3. Config-specified paths
+    if (configPaths) {
+        for (const p of configPaths) {
+            if (existsSync(p)) {
+                paths.push(p);
+            }
+        }
+    }
+    return [...new Set(paths)];
+}
+function scanExtensionDir(dir) {
+    const results = [];
+    try {
+        for (const entry of readdirSync(dir)) {
+            const full = join(dir, entry);
+            const stat = statSync(full);
+            if (stat.isFile() && (entry.endsWith(".js") || entry.endsWith(".mjs"))) {
+                results.push(full);
+            }
+            else if (stat.isDirectory()) {
+                const index = join(full, "index.js");
+                if (existsSync(index))
+                    results.push(index);
+                const indexMjs = join(full, "index.mjs");
+                if (existsSync(indexMjs))
+                    results.push(indexMjs);
+            }
+        }
+    }
+    catch { /* directory not readable */ }
+    return results;
+}
+/**
+ * Load all discovered extensions plus any built-in extensions.
+ */
+export async function loadAllExtensions(cwd, config, onToolRegistered) {
+    const extensions = [];
+    const paths = discoverExtensionPaths(cwd, config.extensions);
+    for (const path of paths) {
+        const ext = await loadExtension(path, cwd, config, onToolRegistered);
+        if (ext)
+            extensions.push(ext);
+    }
+    return extensions;
+}
+//# sourceMappingURL=loader.js.map

package/dist/extensions/loader.js.map

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

package/dist/extensions/runner.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Extension runtime: manages loaded extensions, event dispatch, and tool collection.
+ */
+import type { AgentTool } from "../core/types.js";
+import type { LoadedExtension, CommandDefinition, ExtensionEventType, ExtensionEventMap } from "./types.js";
+export declare class ExtensionRunner {
+    private extensions;
+    constructor(extensions: LoadedExtension[]);
+    get loadedExtensions(): LoadedExtension[];
+    /**
+     * Collect all tools registered across all extensions.
+     * First-registered tool wins for name conflicts.
+     */
+    getAllTools(): AgentTool[];
+    /**
+     * Collect all commands registered across all extensions.
+     */
+    getAllCommands(): Map<string, CommandDefinition>;
+    /**
+     * Emit an event to all extensions that have registered handlers.
+     */
+    emit<T extends ExtensionEventType>(event: T, data: ExtensionEventMap[T]): Promise<void>;
+    /**
+     * Shut down all extensions (emit session_end).
+     */
+    shutdown(cwd: string): Promise<void>;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/extensions/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/extensions/runner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EACX,eAAe,EAEf,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,MAAM,YAAY,CAAC;AAEpB,qBAAa,eAAe;IAC3B,OAAO,CAAC,UAAU,CAAyB;gBAE/B,UAAU,EAAE,eAAe,EAAE;IAIzC,IAAI,gBAAgB,IAAI,eAAe,EAAE,CAExC;IAED;;;OAGG;IACH,WAAW,IAAI,SAAS,EAAE;IAc1B;;OAEG;IACH,cAAc,IAAI,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAYhD;;OAEG;IACG,IAAI,CAAC,CAAC,SAAS,kBAAkB,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAc7F;;OAEG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1C"}

package/dist/extensions/runner.js

@@ -0,0 +1,77 @@
+/**
+ * Extension runtime: manages loaded extensions, event dispatch, and tool collection.
+ */
+export class ExtensionRunner {
+    extensions = [];
+    constructor(extensions) {
+        this.extensions = extensions;
+    }
+    get loadedExtensions() {
+        return [...this.extensions];
+    }
+    /**
+     * Collect all tools registered across all extensions.
+     * First-registered tool wins for name conflicts.
+     */
+    getAllTools() {
+        const toolMap = new Map();
+        for (const ext of this.extensions) {
+            for (const [name, def] of ext.tools) {
+                if (!toolMap.has(name)) {
+                    toolMap.set(name, { definition: def, extensionName: ext.name });
+                }
+            }
+        }
+        return Array.from(toolMap.values()).map(({ definition }) => wrapToolDefinition(definition));
+    }
+    /**
+     * Collect all commands registered across all extensions.
+     */
+    getAllCommands() {
+        const commands = new Map();
+        for (const ext of this.extensions) {
+            for (const [name, cmd] of ext.commands) {
+                if (!commands.has(name)) {
+                    commands.set(name, cmd);
+                }
+            }
+        }
+        return commands;
+    }
+    /**
+     * Emit an event to all extensions that have registered handlers.
+     */
+    async emit(event, data) {
+        for (const ext of this.extensions) {
+            const handlers = ext.handlers.get(event);
+            if (!handlers)
+                continue;
+            for (const handler of handlers) {
+                try {
+                    await handler(data);
+                }
+                catch (err) {
+                    console.error(`Extension ${ext.name} error on ${event}: ${err.message}`);
+                }
+            }
+        }
+    }
+    /**
+     * Shut down all extensions (emit session_end).
+     */
+    async shutdown(cwd) {
+        await this.emit("session_end", { cwd });
+    }
+}
+function wrapToolDefinition(def) {
+    return {
+        name: def.name,
+        label: def.label,
+        description: def.description,
+        parameters: def.parameters,
+        execute: async (toolCallId, params, signal) => {
+            return def.execute(toolCallId, params, signal);
+        },
+    };
+}
+//# sourceMappingURL=runner.js.map

package/dist/extensions/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/extensions/runner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,MAAM,OAAO,eAAe;IACnB,UAAU,GAAsB,EAAE,CAAC;IAE3C,YAAY,UAA6B;QACxC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC9B,CAAC;IAED,IAAI,gBAAgB;QACnB,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,WAAW;QACV,MAAM,OAAO,GAAG,IAAI,GAAG,EAAiE,CAAC;QAEzF,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACnC,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBACrC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBACxB,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;gBACjE,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC;IAC7F,CAAC;IAED;;OAEG;IACH,cAAc;QACb,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;QACtD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACnC,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;gBACxC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBACzB,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBACzB,CAAC;YACF,CAAC;QACF,CAAC;QACD,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAA+B,KAAQ,EAAE,IAA0B;QAC5E,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACzC,IAAI,CAAC,QAAQ;gBAAE,SAAS;YACxB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAChC,IAAI,CAAC;oBACJ,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;gBACrB,CAAC;gBAAC,OAAO,GAAQ,EAAE,CAAC;oBACnB,OAAO,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,IAAI,aAAa,KAAK,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC1E,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,GAAW;QACzB,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IACzC,CAAC;CACD;AAED,SAAS,kBAAkB,CAAC,GAAmB;IAC9C,OAAO;QACN,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YAC7C,OAAO,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAChD,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/extensions/types.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Extension system type definitions.
+ * Lightweight version inspired by pi-mono's extension architecture.
+ */
+import type { AgentToolResult, ToolSchema } from "../core/types.js";
+import type { TilConfig } from "../core/config.js";
+export interface ToolDefinition {
+    name: string;
+    label: string;
+    description: string;
+    parameters: ToolSchema;
+    execute: (toolCallId: string, params: Record<string, any>, signal?: AbortSignal) => Promise<AgentToolResult>;
+}
+export interface CommandDefinition {
+    name: string;
+    description: string;
+    execute: (args: string[]) => Promise<string | void>;
+}
+export type ExtensionEventType = "session_start" | "session_end" | "agent_start" | "agent_end" | "tool_call" | "tool_result";
+export interface ExtensionEventMap {
+    session_start: {
+        cwd: string;
+    };
+    session_end: {
+        cwd: string;
+    };
+    agent_start: Record<string, never>;
+    agent_end: {
+        messages: any[];
+    };
+    tool_call: {
+        toolName: string;
+        args: Record<string, any>;
+    };
+    tool_result: {
+        toolName: string;
+        result: AgentToolResult;
+        isError: boolean;
+    };
+}
+export type ExtensionEventHandler<T extends ExtensionEventType> = (event: ExtensionEventMap[T]) => void | Promise<void>;
+export interface ExtensionAPI {
+    /** Register a new tool that the agent can use */
+    registerTool(tool: ToolDefinition): void;
+    /** Register a slash command for the interactive REPL */
+    registerCommand(cmd: CommandDefinition): void;
+    /** Subscribe to extension events */
+    on<T extends ExtensionEventType>(event: T, handler: ExtensionEventHandler<T>): void;
+    /** Current working directory */
+    readonly cwd: string;
+    /** Loaded configuration */
+    readonly config: TilConfig;
+}
+export type ExtensionFactory = (api: ExtensionAPI) => void | Promise<void>;
+export interface LoadedExtension {
+    path: string;
+    name: string;
+    tools: Map<string, ToolDefinition>;
+    commands: Map<string, CommandDefinition>;
+    handlers: Map<ExtensionEventType, ExtensionEventHandler<any>[]>;
+}
+export interface McpServerConfig {
+    /**
+     * Transport type. Accepts both `transport` and `type` for compatibility
+     * with different config conventions (Cursor uses `type`, MCP spec uses `transport`).
+     * Auto-detected if omitted: "stdio" when `command` is set, "streamable_http" when `url` is set.
+     */
+    transport?: "stdio" | "sse" | "streamable_http" | "http";
+    /** Alias for `transport`, used by Cursor / 智谱 etc. */
+    type?: "stdio" | "sse" | "streamable_http" | "http";
+    /** Stdio transport: executable command */
+    command?: string;
+    /** Stdio transport: command arguments */
+    args?: string[];
+    /** Stdio transport: environment variables */
+    env?: Record<string, string>;
+    /** HTTP transport: server URL */
+    url?: string;
+    /** HTTP transport: custom request headers (e.g. authorization) */
+    headers?: Record<string, string>;
+    /** Timeout in ms for initial connection (default: 10000) */
+    timeout?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/extensions/types.js

@@ -0,0 +1,6 @@
+/**
+ * Extension system type definitions.
+ * Lightweight version inspired by pi-mono's extension architecture.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/extensions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/extensions/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export { Agent } from "./core/agent.js";
+export { TilSession } from "./core/session.js";
+export { loadConfig, saveConfig, resolveModel, resolveApiKey, resolveBaseUrl } from "./core/config.js";
+export type { TilConfig, ProviderConfig } from "./core/config.js";
+export { buildSystemPrompt } from "./core/system-prompt.js";
+export { streamLLM, completeLLM } from "./core/llm.js";
+export { loadSkills, formatSkillsForPrompt } from "./core/skills.js";
+export type { Skill, LoadSkillsResult, LoadSkillsOptions } from "./core/skills.js";
+export { loadMemory, loadProjectContextFiles, formatMemoryForPrompt, formatContextFilesForPrompt } from "./core/memory.js";
+export type { MemoryContent, ContextFile } from "./core/memory.js";
+export { SessionManager } from "./core/session-manager.js";
+export type { SessionHeader, SessionMessageEntry, SessionInfo } from "./core/session-manager.js";
+export { estimateTokens, estimateAllTokens, calculateContextTokens, shouldCompact, findCutPoint, isContextOverflow, compact, DEFAULT_COMPACTION_SETTINGS, } from "./core/compaction.js";
+export type { CompactionSettings, CompactionResult, CutResult } from "./core/compaction.js";
+export { calculateCost, formatUsage, formatTokenCount, formatCost, formatContextPercent, MODEL_PRICING } from "./core/pricing.js";
+export type { ModelPricing } from "./core/pricing.js";
+export { isDangerousCommand, getDangerReason, createToolCallRequestHandler } from "./core/tool-permissions.js";
+export { MarkdownRenderer, renderMarkdown } from "./core/markdown.js";
+export * from "./core/types.js";
+export * from "./tools/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvG,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACrE,YAAY,EAAE,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC3H,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACjG,OAAO,EACN,cAAc,EAAE,iBAAiB,EAAE,sBAAsB,EACzD,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAE,OAAO,EACvD,2BAA2B,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC5F,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClI,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC/G,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACtE,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+export { Agent } from "./core/agent.js";
+export { TilSession } from "./core/session.js";
+export { loadConfig, saveConfig, resolveModel, resolveApiKey, resolveBaseUrl } from "./core/config.js";
+export { buildSystemPrompt } from "./core/system-prompt.js";
+export { streamLLM, completeLLM } from "./core/llm.js";
+export { loadSkills, formatSkillsForPrompt } from "./core/skills.js";
+export { loadMemory, loadProjectContextFiles, formatMemoryForPrompt, formatContextFilesForPrompt } from "./core/memory.js";
+export { SessionManager } from "./core/session-manager.js";
+export { estimateTokens, estimateAllTokens, calculateContextTokens, shouldCompact, findCutPoint, isContextOverflow, compact, DEFAULT_COMPACTION_SETTINGS, } from "./core/compaction.js";
+export { calculateCost, formatUsage, formatTokenCount, formatCost, formatContextPercent, MODEL_PRICING } from "./core/pricing.js";
+export { isDangerousCommand, getDangerReason, createToolCallRequestHandler } from "./core/tool-permissions.js";
+export { MarkdownRenderer, renderMarkdown } from "./core/markdown.js";
+export * from "./core/types.js";
+export * from "./tools/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvG,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAErE,OAAO,EAAE,UAAU,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAE3H,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,EACN,cAAc,EAAE,iBAAiB,EAAE,sBAAsB,EACzD,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAE,OAAO,EACvD,2BAA2B,GAC3B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElI,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC/G,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACtE,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Main entry point: parses arguments and dispatches to the appropriate mode.
+ */
+export declare function main(argv: string[]): Promise<void>;
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA;;GAEG;AA+SH,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwGxD"}