@m4ike1/ion-cue 0.1.0

package/dist/harness-router.js

@@ -0,0 +1,189 @@
+export class HarnessRouter {
+    handlers = new Map();
+    register(name, handler) {
+        this.handlers.set(name, handler);
+    }
+    async route(directive, element, session) {
+        const handlerName = element.handler;
+        if (!handlerName) {
+            return { action: "error", error: `Element ${element.name} has no handler` };
+        }
+        const handler = this.handlers.get(handlerName);
+        if (!handler) {
+            return { action: "error", error: `Unknown handler: ${handlerName}` };
+        }
+        const args = this.extractArgs(directive);
+        const ctx = {
+            element,
+            directive,
+            session,
+            args,
+        };
+        try {
+            return await handler(ctx);
+        }
+        catch (e) {
+            return { action: "error", error: String(e) };
+        }
+    }
+    async routeColonTier(message, session) {
+        const results = [];
+        const commands = this.parseColonCommands(message);
+        for (const cmd of commands) {
+            // For now, we need to resolve the element from the command name.
+            // This will be integrated with the registry later.
+            // For simplicity, we assume the command name maps to a handler name "harness::<cmd>".
+            const handlerName = `harness::${cmd.command}`;
+            const handler = this.handlers.get(handlerName);
+            if (!handler) {
+                results.push({ action: "error", error: `Unknown handler: ${handlerName}` });
+                continue;
+            }
+            // We need a dummy element and directive for context.
+            // This will be properly implemented when integrated with dispatcher.
+            const dummyElement = {
+                name: cmd.command,
+                description: "",
+                version: "",
+                class: "harness",
+                handler: handlerName,
+                tags: {},
+                uses: [],
+                bodyPath: "",
+                tomlPath: "",
+            };
+            const dummyDirective = {
+                raw: cmd.raw,
+                element: cmd.command,
+                tags: [],
+                scope: null,
+                line: 0,
+                col: 0,
+            };
+            const ctx = {
+                element: dummyElement,
+                directive: dummyDirective,
+                session,
+                args: cmd.arg ? { arg: cmd.arg } : {},
+            };
+            try {
+                const result = await handler(ctx);
+                results.push(result);
+            }
+            catch (e) {
+                results.push({ action: "error", error: String(e) });
+            }
+        }
+        return results;
+    }
+    generateToolSchema(element) {
+        if (element.class !== "harness" || !element.handler) {
+            return null;
+        }
+        const inputSchema = {
+            type: "object",
+            properties: {},
+            required: [],
+        };
+        if (element.inputs) {
+            const properties = inputSchema.properties;
+            const required = inputSchema.required;
+            for (const input of element.inputs) {
+                properties[input] = { type: "string" };
+                required.push(input);
+            }
+        }
+        return {
+            name: element.name,
+            description: element.description,
+            inputSchema,
+            execute: async (args) => {
+                const directive = {
+                    raw: `:${element.name} ${Object.values(args).join(" ")}`,
+                    element: element.name,
+                    tags: [],
+                    scope: null,
+                    line: 0,
+                    col: 0,
+                };
+                return await this.route(directive, element, {
+                    mode: "default",
+                    activeElements: new Map(),
+                    overrides: new Map(),
+                    dispatchHistory: [],
+                });
+            },
+        };
+    }
+    getToolSchemas() {
+        return Array.from(this.handlers.entries()).map(([handlerName]) => {
+            // Derive element-like metadata from handler name
+            const name = handlerName.split("::").pop() ?? handlerName;
+            return {
+                name,
+                description: `Harness handler: ${handlerName}`,
+                inputSchema: { type: "object", properties: {}, required: [] },
+                execute: async (args) => {
+                    const directive = {
+                        raw: `:${name} ${Object.values(args).join(" ")}`,
+                        element: name,
+                        tags: [],
+                        scope: null,
+                        line: 0,
+                        col: 0,
+                    };
+                    const element = {
+                        name,
+                        description: "",
+                        version: "",
+                        class: "harness",
+                        handler: handlerName,
+                        tags: {},
+                        uses: [],
+                        bodyPath: "",
+                        tomlPath: "",
+                    };
+                    return await this.route(directive, element, {
+                        mode: "default",
+                        activeElements: new Map(),
+                        overrides: new Map(),
+                        dispatchHistory: [],
+                    });
+                },
+            };
+        });
+    }
+    extractArgs(directive) {
+        const args = {};
+        if (directive.tags.length > 0) {
+            args.tags = directive.tags;
+            args.color = directive.tags[0];
+            args.arg = directive.tags.join(" ");
+        }
+        return args;
+    }
+    parseColonCommands(message) {
+        const commands = [];
+        // Simple parsing: split by semicolon, trim, find colon at start.
+        const parts = message.split(";");
+        for (const part of parts) {
+            const trimmed = part.trim();
+            if (trimmed.startsWith(":")) {
+                const spaceIdx = trimmed.indexOf(" ");
+                if (spaceIdx === -1) {
+                    commands.push({
+                        command: trimmed.slice(1),
+                        raw: trimmed,
+                    });
+                }
+                else {
+                    const command = trimmed.slice(1, spaceIdx);
+                    const arg = trimmed.slice(spaceIdx + 1).trim();
+                    commands.push({ command, arg, raw: trimmed });
+                }
+            }
+        }
+        return commands;
+    }
+}
+//# sourceMappingURL=harness-router.js.map

package/dist/harness-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-router.js","sourceRoot":"","sources":["../src/harness-router.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n\tCueDirective,\n\tCueRegisteredTool,\n\tElementDef,\n\tHarnessContext,\n\tHarnessHandler,\n\tHarnessResult,\n\tSessionState,\n} from \"./types.ts\";\n\nexport class HarnessRouter {\n\tprivate handlers = new Map<string, HarnessHandler>();\n\n\tregister(name: string, handler: HarnessHandler): void {\n\t\tthis.handlers.set(name, handler);\n\t}\n\n\tasync route(directive: CueDirective, element: ElementDef, session: SessionState): Promise<HarnessResult> {\n\t\tconst handlerName = element.handler;\n\t\tif (!handlerName) {\n\t\t\treturn { action: \"error\", error: `Element ${element.name} has no handler` };\n\t\t}\n\t\tconst handler = this.handlers.get(handlerName);\n\t\tif (!handler) {\n\t\t\treturn { action: \"error\", error: `Unknown handler: ${handlerName}` };\n\t\t}\n\n\t\tconst args = this.extractArgs(directive);\n\t\tconst ctx: HarnessContext = {\n\t\t\telement,\n\t\t\tdirective,\n\t\t\tsession,\n\t\t\targs,\n\t\t};\n\n\t\ttry {\n\t\t\treturn await handler(ctx);\n\t\t} catch (e) {\n\t\t\treturn { action: \"error\", error: String(e) };\n\t\t}\n\t}\n\n\tasync routeColonTier(message: string, session: SessionState): Promise<HarnessResult[]> {\n\t\tconst results: HarnessResult[] = [];\n\t\tconst commands = this.parseColonCommands(message);\n\t\tfor (const cmd of commands) {\n\t\t\t// For now, we need to resolve the element from the command name.\n\t\t\t// This will be integrated with the registry later.\n\t\t\t// For simplicity, we assume the command name maps to a handler name \"harness::<cmd>\".\n\t\t\tconst handlerName = `harness::${cmd.command}`;\n\t\t\tconst handler = this.handlers.get(handlerName);\n\t\t\tif (!handler) {\n\t\t\t\tresults.push({ action: \"error\", error: `Unknown handler: ${handlerName}` });\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\t// We need a dummy element and directive for context.\n\t\t\t// This will be properly implemented when integrated with dispatcher.\n\t\t\tconst dummyElement: ElementDef = {\n\t\t\t\tname: cmd.command,\n\t\t\t\tdescription: \"\",\n\t\t\t\tversion: \"\",\n\t\t\t\tclass: \"harness\",\n\t\t\t\thandler: handlerName,\n\t\t\t\ttags: {},\n\t\t\t\tuses: [],\n\t\t\t\tbodyPath: \"\",\n\t\t\t\ttomlPath: \"\",\n\t\t\t};\n\t\t\tconst dummyDirective: CueDirective = {\n\t\t\t\traw: cmd.raw,\n\t\t\t\telement: cmd.command,\n\t\t\t\ttags: [],\n\t\t\t\tscope: null,\n\t\t\t\tline: 0,\n\t\t\t\tcol: 0,\n\t\t\t};\n\t\t\tconst ctx: HarnessContext = {\n\t\t\t\telement: dummyElement,\n\t\t\t\tdirective: dummyDirective,\n\t\t\t\tsession,\n\t\t\t\targs: cmd.arg ? { arg: cmd.arg } : {},\n\t\t\t};\n\t\t\ttry {\n\t\t\t\tconst result = await handler(ctx);\n\t\t\t\tresults.push(result);\n\t\t\t} catch (e) {\n\t\t\t\tresults.push({ action: \"error\", error: String(e) });\n\t\t\t}\n\t\t}\n\t\treturn results;\n\t}\n\n\tgenerateToolSchema(element: ElementDef): CueRegisteredTool | null {\n\t\tif (element.class !== \"harness\" || !element.handler) {\n\t\t\treturn null;\n\t\t}\n\t\tconst inputSchema: Record<string, unknown> = {\n\t\t\ttype: \"object\",\n\t\t\tproperties: {},\n\t\t\trequired: [],\n\t\t};\n\t\tif (element.inputs) {\n\t\t\tconst properties = inputSchema.properties as Record<string, unknown>;\n\t\t\tconst required = inputSchema.required as string[];\n\t\t\tfor (const input of element.inputs) {\n\t\t\t\tproperties[input] = { type: \"string\" };\n\t\t\t\trequired.push(input);\n\t\t\t}\n\t\t}\n\t\treturn {\n\t\t\tname: element.name,\n\t\t\tdescription: element.description,\n\t\t\tinputSchema,\n\t\t\texecute: async (args: Record<string, unknown>) => {\n\t\t\t\tconst directive: CueDirective = {\n\t\t\t\t\traw: `:${element.name} ${Object.values(args).join(\" \")}`,\n\t\t\t\t\telement: element.name,\n\t\t\t\t\ttags: [],\n\t\t\t\t\tscope: null,\n\t\t\t\t\tline: 0,\n\t\t\t\t\tcol: 0,\n\t\t\t\t};\n\t\t\t\treturn await this.route(directive, element, {\n\t\t\t\t\tmode: \"default\",\n\t\t\t\t\tactiveElements: new Map(),\n\t\t\t\t\toverrides: new Map(),\n\t\t\t\t\tdispatchHistory: [],\n\t\t\t\t});\n\t\t\t},\n\t\t};\n\t}\n\n\tgetToolSchemas(): CueRegisteredTool[] {\n\t\treturn Array.from(this.handlers.entries()).map(([handlerName]) => {\n\t\t\t// Derive element-like metadata from handler name\n\t\t\tconst name = handlerName.split(\"::\").pop() ?? handlerName;\n\t\t\treturn {\n\t\t\t\tname,\n\t\t\t\tdescription: `Harness handler: ${handlerName}`,\n\t\t\t\tinputSchema: { type: \"object\", properties: {}, required: [] },\n\t\t\t\texecute: async (args: Record<string, unknown>) => {\n\t\t\t\t\tconst directive: CueDirective = {\n\t\t\t\t\t\traw: `:${name} ${Object.values(args).join(\" \")}`,\n\t\t\t\t\t\telement: name,\n\t\t\t\t\t\ttags: [],\n\t\t\t\t\t\tscope: null,\n\t\t\t\t\t\tline: 0,\n\t\t\t\t\t\tcol: 0,\n\t\t\t\t\t};\n\t\t\t\t\tconst element: ElementDef = {\n\t\t\t\t\t\tname,\n\t\t\t\t\t\tdescription: \"\",\n\t\t\t\t\t\tversion: \"\",\n\t\t\t\t\t\tclass: \"harness\",\n\t\t\t\t\t\thandler: handlerName,\n\t\t\t\t\t\ttags: {},\n\t\t\t\t\t\tuses: [],\n\t\t\t\t\t\tbodyPath: \"\",\n\t\t\t\t\t\ttomlPath: \"\",\n\t\t\t\t\t};\n\t\t\t\t\treturn await this.route(directive, element, {\n\t\t\t\t\t\tmode: \"default\",\n\t\t\t\t\t\tactiveElements: new Map(),\n\t\t\t\t\t\toverrides: new Map(),\n\t\t\t\t\t\tdispatchHistory: [],\n\t\t\t\t\t});\n\t\t\t\t},\n\t\t\t};\n\t\t});\n\t}\n\n\tprivate extractArgs(directive: CueDirective): Record<string, unknown> {\n\t\tconst args: Record<string, unknown> = {};\n\t\tif (directive.tags.length > 0) {\n\t\t\targs.tags = directive.tags;\n\t\t\targs.color = directive.tags[0];\n\t\t\targs.arg = directive.tags.join(\" \");\n\t\t}\n\t\treturn args;\n\t}\n\n\tprivate parseColonCommands(message: string): Array<{ command: string; arg?: string; raw: string }> {\n\t\tconst commands: Array<{ command: string; arg?: string; raw: string }> = [];\n\t\t// Simple parsing: split by semicolon, trim, find colon at start.\n\t\tconst parts = message.split(\";\");\n\t\tfor (const part of parts) {\n\t\t\tconst trimmed = part.trim();\n\t\t\tif (trimmed.startsWith(\":\")) {\n\t\t\t\tconst spaceIdx = trimmed.indexOf(\" \");\n\t\t\t\tif (spaceIdx === -1) {\n\t\t\t\t\tcommands.push({\n\t\t\t\t\t\tcommand: trimmed.slice(1),\n\t\t\t\t\t\traw: trimmed,\n\t\t\t\t\t});\n\t\t\t\t} else {\n\t\t\t\t\tconst command = trimmed.slice(1, spaceIdx);\n\t\t\t\t\tconst arg = trimmed.slice(spaceIdx + 1).trim();\n\t\t\t\t\tcommands.push({ command, arg, raw: trimmed });\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn commands;\n\t}\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export type { DispatcherOptions } from "./dispatcher.ts";
+export { additionalContextFromDispatchResult, beforeTurn, cueDispatcher } from "./dispatcher.ts";
+export { generateToolDefinition, registerHarnessTools, type ToolDefinition, } from "./harness-bridge.ts";
+export { HarnessRouter } from "./harness-router.ts";
+export { buildAdditionalContext, buildScopeInjection } from "./injector.ts";
+export { collectMarks, type Mark } from "./marks.ts";
+export type { CueMessage, CueMessageContent, CueTextContent, CueToolResultContent, CueToolUseContent, } from "./messages.ts";
+export { CueRegistry, type CueRoot, cueDiscoveryRoots } from "./registry.ts";
+export { type ResolvedDirective, resolveDirective, resolveSections, } from "./resolver.ts";
+export { findFencedBlocks, scan, scanDirectives, stripSpans } from "./scanner.ts";
+export { SecretStore, type SecretStoreOptions } from "./secret-store.ts";
+export type { CueDoneEvent, CueErrorEvent, CueStreamEvent, CueTextDeltaEvent, CueToolUseDeltaEvent, CueToolUseEndEvent, } from "./stream-events.ts";
+export { parseElementToml } from "./toml.ts";
+export type { ActiveElement, AliasCommand, BehavioralDimension, CueAfterToolCallContext, CueAgentConfig, CueBeforeToolCallContext, CueBeforeToolCallResult, CueDirective, CueRegisteredTool, CueScope, CueToolSchema, Directive, DispatchEntry, DispatchResult, ElementDef, HarnessAction, HarnessContext, HarnessHandler, HarnessResult, Injection, SectionRange, SessionState, SystemNavCommand, TagDef, } from "./types.ts";
+export { detectCircularUses, detectConflictingReplace, validateVersionPin } from "./validation.ts";
+//# 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,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,mCAAmC,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACjG,OAAO,EACN,sBAAsB,EACtB,oBAAoB,EACpB,KAAK,cAAc,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AACrD,YAAY,EACX,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,iBAAiB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,KAAK,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EACN,KAAK,iBAAiB,EACtB,gBAAgB,EAChB,eAAe,GACf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACzE,YAAY,EACX,YAAY,EACZ,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,YAAY,EACX,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,wBAAwB,EACxB,uBAAuB,EACvB,YAAY,EACZ,iBAAiB,EACjB,QAAQ,EACR,aAAa,EACb,SAAS,EACT,aAAa,EACb,cAAc,EACd,UAAU,EACV,aAAa,EACb,cAAc,EACd,cAAc,EACd,aAAa,EACb,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,MAAM,GACN,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC","sourcesContent":["export type { DispatcherOptions } from \"./dispatcher.ts\";\nexport { additionalContextFromDispatchResult, beforeTurn, cueDispatcher } from \"./dispatcher.ts\";\nexport {\n\tgenerateToolDefinition,\n\tregisterHarnessTools,\n\ttype ToolDefinition,\n} from \"./harness-bridge.ts\";\nexport { HarnessRouter } from \"./harness-router.ts\";\nexport { buildAdditionalContext, buildScopeInjection } from \"./injector.ts\";\nexport { collectMarks, type Mark } from \"./marks.ts\";\nexport type {\n\tCueMessage,\n\tCueMessageContent,\n\tCueTextContent,\n\tCueToolResultContent,\n\tCueToolUseContent,\n} from \"./messages.ts\";\nexport { CueRegistry, type CueRoot, cueDiscoveryRoots } from \"./registry.ts\";\nexport {\n\ttype ResolvedDirective,\n\tresolveDirective,\n\tresolveSections,\n} from \"./resolver.ts\";\nexport { findFencedBlocks, scan, scanDirectives, stripSpans } from \"./scanner.ts\";\nexport { SecretStore, type SecretStoreOptions } from \"./secret-store.ts\";\nexport type {\n\tCueDoneEvent,\n\tCueErrorEvent,\n\tCueStreamEvent,\n\tCueTextDeltaEvent,\n\tCueToolUseDeltaEvent,\n\tCueToolUseEndEvent,\n} from \"./stream-events.ts\";\nexport { parseElementToml } from \"./toml.ts\";\nexport type {\n\tActiveElement,\n\tAliasCommand,\n\tBehavioralDimension,\n\tCueAfterToolCallContext,\n\tCueAgentConfig,\n\tCueBeforeToolCallContext,\n\tCueBeforeToolCallResult,\n\tCueDirective,\n\tCueRegisteredTool,\n\tCueScope,\n\tCueToolSchema,\n\tDirective,\n\tDispatchEntry,\n\tDispatchResult,\n\tElementDef,\n\tHarnessAction,\n\tHarnessContext,\n\tHarnessHandler,\n\tHarnessResult,\n\tInjection,\n\tSectionRange,\n\tSessionState,\n\tSystemNavCommand,\n\tTagDef,\n} from \"./types.ts\";\nexport { detectCircularUses, detectConflictingReplace, validateVersionPin } from \"./validation.ts\";\n"]}

package/dist/index.js

@@ -0,0 +1,12 @@
+export { additionalContextFromDispatchResult, beforeTurn, cueDispatcher } from "./dispatcher.js";
+export { generateToolDefinition, registerHarnessTools, } from "./harness-bridge.js";
+export { HarnessRouter } from "./harness-router.js";
+export { buildAdditionalContext, buildScopeInjection } from "./injector.js";
+export { collectMarks } from "./marks.js";
+export { CueRegistry, cueDiscoveryRoots } from "./registry.js";
+export { resolveDirective, resolveSections, } from "./resolver.js";
+export { findFencedBlocks, scan, scanDirectives, stripSpans } from "./scanner.js";
+export { SecretStore } from "./secret-store.js";
+export { parseElementToml } from "./toml.js";
+export { detectCircularUses, detectConflictingReplace, validateVersionPin } from "./validation.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":"AACA,OAAO,EAAE,mCAAmC,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACjG,OAAO,EACN,sBAAsB,EACtB,oBAAoB,GAEpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAa,MAAM,YAAY,CAAC;AAQrD,OAAO,EAAE,WAAW,EAAgB,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAEN,gBAAgB,EAChB,eAAe,GACf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,EAAE,WAAW,EAA2B,MAAM,mBAAmB,CAAC;AASzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AA2B7C,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC","sourcesContent":["export type { DispatcherOptions } from \"./dispatcher.ts\";\nexport { additionalContextFromDispatchResult, beforeTurn, cueDispatcher } from \"./dispatcher.ts\";\nexport {\n\tgenerateToolDefinition,\n\tregisterHarnessTools,\n\ttype ToolDefinition,\n} from \"./harness-bridge.ts\";\nexport { HarnessRouter } from \"./harness-router.ts\";\nexport { buildAdditionalContext, buildScopeInjection } from \"./injector.ts\";\nexport { collectMarks, type Mark } from \"./marks.ts\";\nexport type {\n\tCueMessage,\n\tCueMessageContent,\n\tCueTextContent,\n\tCueToolResultContent,\n\tCueToolUseContent,\n} from \"./messages.ts\";\nexport { CueRegistry, type CueRoot, cueDiscoveryRoots } from \"./registry.ts\";\nexport {\n\ttype ResolvedDirective,\n\tresolveDirective,\n\tresolveSections,\n} from \"./resolver.ts\";\nexport { findFencedBlocks, scan, scanDirectives, stripSpans } from \"./scanner.ts\";\nexport { SecretStore, type SecretStoreOptions } from \"./secret-store.ts\";\nexport type {\n\tCueDoneEvent,\n\tCueErrorEvent,\n\tCueStreamEvent,\n\tCueTextDeltaEvent,\n\tCueToolUseDeltaEvent,\n\tCueToolUseEndEvent,\n} from \"./stream-events.ts\";\nexport { parseElementToml } from \"./toml.ts\";\nexport type {\n\tActiveElement,\n\tAliasCommand,\n\tBehavioralDimension,\n\tCueAfterToolCallContext,\n\tCueAgentConfig,\n\tCueBeforeToolCallContext,\n\tCueBeforeToolCallResult,\n\tCueDirective,\n\tCueRegisteredTool,\n\tCueScope,\n\tCueToolSchema,\n\tDirective,\n\tDispatchEntry,\n\tDispatchResult,\n\tElementDef,\n\tHarnessAction,\n\tHarnessContext,\n\tHarnessHandler,\n\tHarnessResult,\n\tInjection,\n\tSectionRange,\n\tSessionState,\n\tSystemNavCommand,\n\tTagDef,\n} from \"./types.ts\";\nexport { detectCircularUses, detectConflictingReplace, validateVersionPin } from \"./validation.ts\";\n"]}

package/dist/injector.d.ts

@@ -0,0 +1,23 @@
+import type { Mark } from "./marks.ts";
+import type { ResolvedDirective } from "./resolver.ts";
+import type { CueScope } from "./types.ts";
+/**
+ * Build the context injections for a resolved cue.
+ *
+ * Cues are purely behavioral — the sections describe how the model should
+ * behave (Default + Tag sections). Scopes no longer attach to cues; they are
+ * standalone statements handled by buildScopeInjection.
+ */
+export declare function buildAdditionalContext(resolved: ResolvedDirective): string[];
+/**
+ * Build the injection for a standalone scope statement.
+ *
+ * - file   → `--- path ---\n<content>` (a directory injects its absolute
+ *            path, e.g. `{@ion/}` → `--- /home/user/projects/ion ---`)
+ * - glob   → one block per file
+ * - id     → `--- #id ---\n<marked content>` (resolved via marks)
+ *
+ * Unresolvable targets emit a warning marker instead of failing the message.
+ */
+export declare function buildScopeInjection(scope: CueScope, projectRoot: string | undefined, marks: Mark[]): string;
+//# sourceMappingURL=injector.d.ts.map

package/dist/injector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injector.d.ts","sourceRoot":"","sources":["../src/injector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAE5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CA2B3G","sourcesContent":["import type { Mark } from \"./marks.ts\";\nimport type { ResolvedDirective } from \"./resolver.ts\";\nimport { resolveDirPath, resolveScope } from \"./scope.ts\";\nimport type { CueScope } from \"./types.ts\";\n\n/**\n * Build the context injections for a resolved cue.\n *\n * Cues are purely behavioral — the sections describe how the model should\n * behave (Default + Tag sections). Scopes no longer attach to cues; they are\n * standalone statements handled by buildScopeInjection.\n */\nexport function buildAdditionalContext(resolved: ResolvedDirective): string[] {\n\treturn resolved.sections.map((s) => s.trim()).filter(Boolean);\n}\n\n/**\n * Build the injection for a standalone scope statement.\n *\n * - file   → `--- path ---\\n<content>` (a directory injects its absolute\n *            path, e.g. `{@ion/}` → `--- /home/user/projects/ion ---`)\n * - glob   → one block per file\n * - id     → `--- #id ---\\n<marked content>` (resolved via marks)\n *\n * Unresolvable targets emit a warning marker instead of failing the message.\n */\nexport function buildScopeInjection(scope: CueScope, projectRoot: string | undefined, marks: Mark[]): string {\n\tif (scope.type === \"id\") {\n\t\tconst mark = marks.find((m) => m.id === scope.value);\n\t\tif (!mark) return `[warning: mark not found: #${scope.value}]`;\n\t\treturn `--- #${mark.id} ---\\n${mark.content}`;\n\t}\n\n\t// Skill references are passed through — skill expansion happens in agent-session.\n\tif (scope.type === \"skill\") {\n\t\treturn `$${scope.value}`;\n\t}\n\n\tif (scope.type === \"file\" && !scope.range) {\n\t\tconst dirPath = resolveDirPath(scope.value, projectRoot);\n\t\tif (dirPath) return `--- ${dirPath} ---`;\n\t}\n\n\tconst resolved = resolveScope(scope, projectRoot);\n\tif (!resolved) {\n\t\tconst label = scopeLabel(scope);\n\t\tif (scope.type === \"glob\") return `[warning: no files match: ${label}]`;\n\t\treturn `[warning: file not found: ${label}]`;\n\t}\n\tif (scope.type === \"file\") {\n\t\treturn `--- ${resolved.label} ---\\n${resolved.content}`;\n\t}\n\treturn resolved.content;\n}\n\nfunction scopeLabel(scope: CueScope): string {\n\tif (!scope.range) return scope.value;\n\tif (scope.range.start !== undefined && scope.range.end !== undefined) {\n\t\treturn scope.range.start === scope.range.end\n\t\t\t? `${scope.value}:${scope.range.start}`\n\t\t\t: `${scope.value}:${scope.range.start}-${scope.range.end}`;\n\t}\n\tif (scope.range.start !== undefined) return `${scope.value}:${scope.range.start}-`;\n\treturn `${scope.value}:-${scope.range.end}`;\n}\n"]}

package/dist/injector.js

@@ -0,0 +1,62 @@
+import { resolveDirPath, resolveScope } from "./scope.js";
+/**
+ * Build the context injections for a resolved cue.
+ *
+ * Cues are purely behavioral — the sections describe how the model should
+ * behave (Default + Tag sections). Scopes no longer attach to cues; they are
+ * standalone statements handled by buildScopeInjection.
+ */
+export function buildAdditionalContext(resolved) {
+    return resolved.sections.map((s) => s.trim()).filter(Boolean);
+}
+/**
+ * Build the injection for a standalone scope statement.
+ *
+ * - file   → `--- path ---\n<content>` (a directory injects its absolute
+ *            path, e.g. `{@ion/}` → `--- /home/user/projects/ion ---`)
+ * - glob   → one block per file
+ * - id     → `--- #id ---\n<marked content>` (resolved via marks)
+ *
+ * Unresolvable targets emit a warning marker instead of failing the message.
+ */
+export function buildScopeInjection(scope, projectRoot, marks) {
+    if (scope.type === "id") {
+        const mark = marks.find((m) => m.id === scope.value);
+        if (!mark)
+            return `[warning: mark not found: #${scope.value}]`;
+        return `--- #${mark.id} ---\n${mark.content}`;
+    }
+    // Skill references are passed through — skill expansion happens in agent-session.
+    if (scope.type === "skill") {
+        return `$${scope.value}`;
+    }
+    if (scope.type === "file" && !scope.range) {
+        const dirPath = resolveDirPath(scope.value, projectRoot);
+        if (dirPath)
+            return `--- ${dirPath} ---`;
+    }
+    const resolved = resolveScope(scope, projectRoot);
+    if (!resolved) {
+        const label = scopeLabel(scope);
+        if (scope.type === "glob")
+            return `[warning: no files match: ${label}]`;
+        return `[warning: file not found: ${label}]`;
+    }
+    if (scope.type === "file") {
+        return `--- ${resolved.label} ---\n${resolved.content}`;
+    }
+    return resolved.content;
+}
+function scopeLabel(scope) {
+    if (!scope.range)
+        return scope.value;
+    if (scope.range.start !== undefined && scope.range.end !== undefined) {
+        return scope.range.start === scope.range.end
+            ? `${scope.value}:${scope.range.start}`
+            : `${scope.value}:${scope.range.start}-${scope.range.end}`;
+    }
+    if (scope.range.start !== undefined)
+        return `${scope.value}:${scope.range.start}-`;
+    return `${scope.value}:-${scope.range.end}`;
+}
+//# sourceMappingURL=injector.js.map

package/dist/injector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injector.js","sourceRoot":"","sources":["../src/injector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1D;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAA2B,EAAY;IAC7E,OAAO,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAAA,CAC9D;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAe,EAAE,WAA+B,EAAE,KAAa,EAAU;IAC5G,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI;YAAE,OAAO,8BAA8B,KAAK,CAAC,KAAK,GAAG,CAAC;QAC/D,OAAO,QAAQ,IAAI,CAAC,EAAE,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC;IAC/C,CAAC;IAED,oFAAkF;IAClF,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QACzD,IAAI,OAAO;YAAE,OAAO,OAAO,OAAO,MAAM,CAAC;IAC1C,CAAC;IAED,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,6BAA6B,KAAK,GAAG,CAAC;QACxE,OAAO,6BAA6B,KAAK,GAAG,CAAC;IAC9C,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,OAAO,OAAO,QAAQ,CAAC,KAAK,SAAS,QAAQ,CAAC,OAAO,EAAE,CAAC;IACzD,CAAC;IACD,OAAO,QAAQ,CAAC,OAAO,CAAC;AAAA,CACxB;AAED,SAAS,UAAU,CAAC,KAAe,EAAU;IAC5C,IAAI,CAAC,KAAK,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC;IACrC,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QACtE,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,GAAG;YAC3C,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE;YACvC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IAC7D,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC;IACnF,OAAO,GAAG,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;AAAA,CAC5C","sourcesContent":["import type { Mark } from \"./marks.ts\";\nimport type { ResolvedDirective } from \"./resolver.ts\";\nimport { resolveDirPath, resolveScope } from \"./scope.ts\";\nimport type { CueScope } from \"./types.ts\";\n\n/**\n * Build the context injections for a resolved cue.\n *\n * Cues are purely behavioral — the sections describe how the model should\n * behave (Default + Tag sections). Scopes no longer attach to cues; they are\n * standalone statements handled by buildScopeInjection.\n */\nexport function buildAdditionalContext(resolved: ResolvedDirective): string[] {\n\treturn resolved.sections.map((s) => s.trim()).filter(Boolean);\n}\n\n/**\n * Build the injection for a standalone scope statement.\n *\n * - file   → `--- path ---\\n<content>` (a directory injects its absolute\n *            path, e.g. `{@ion/}` → `--- /home/user/projects/ion ---`)\n * - glob   → one block per file\n * - id     → `--- #id ---\\n<marked content>` (resolved via marks)\n *\n * Unresolvable targets emit a warning marker instead of failing the message.\n */\nexport function buildScopeInjection(scope: CueScope, projectRoot: string | undefined, marks: Mark[]): string {\n\tif (scope.type === \"id\") {\n\t\tconst mark = marks.find((m) => m.id === scope.value);\n\t\tif (!mark) return `[warning: mark not found: #${scope.value}]`;\n\t\treturn `--- #${mark.id} ---\\n${mark.content}`;\n\t}\n\n\t// Skill references are passed through — skill expansion happens in agent-session.\n\tif (scope.type === \"skill\") {\n\t\treturn `$${scope.value}`;\n\t}\n\n\tif (scope.type === \"file\" && !scope.range) {\n\t\tconst dirPath = resolveDirPath(scope.value, projectRoot);\n\t\tif (dirPath) return `--- ${dirPath} ---`;\n\t}\n\n\tconst resolved = resolveScope(scope, projectRoot);\n\tif (!resolved) {\n\t\tconst label = scopeLabel(scope);\n\t\tif (scope.type === \"glob\") return `[warning: no files match: ${label}]`;\n\t\treturn `[warning: file not found: ${label}]`;\n\t}\n\tif (scope.type === \"file\") {\n\t\treturn `--- ${resolved.label} ---\\n${resolved.content}`;\n\t}\n\treturn resolved.content;\n}\n\nfunction scopeLabel(scope: CueScope): string {\n\tif (!scope.range) return scope.value;\n\tif (scope.range.start !== undefined && scope.range.end !== undefined) {\n\t\treturn scope.range.start === scope.range.end\n\t\t\t? `${scope.value}:${scope.range.start}`\n\t\t\t: `${scope.value}:${scope.range.start}-${scope.range.end}`;\n\t}\n\tif (scope.range.start !== undefined) return `${scope.value}:${scope.range.start}-`;\n\treturn `${scope.value}:-${scope.range.end}`;\n}\n"]}

package/dist/marks.d.ts

@@ -0,0 +1,26 @@
+export interface Mark {
+    id: string;
+    content: string;
+    /** Character offset of the `{` of the mark header line. */
+    startIndex: number;
+    /** Character offset just past the `}` of the header. */
+    headerEnd: number;
+    /** Character offset where the content block begins. */
+    contentStart: number;
+    /** Character offset just past the last content character. */
+    contentEnd: number;
+}
+/**
+ * Two-pass mark collection: find own-line `{#id}` headers and capture the
+ * content block that follows them.
+ *
+ * A header line is a line whose trimmed content is exactly `{#id}`. The
+ * content block runs until the next line that starts (trimmed) with `{`, `[`,
+ * `:`, `/`, or EOF. Headers inside fenced blocks (```, ~~~, inline `) are
+ * ignored.
+ *
+ * A header with no following content is not a mark — it is a reference, which
+ * the dispatcher resolves against collected marks.
+ */
+export declare function collectMarks(input: string): Mark[];
+//# sourceMappingURL=marks.d.ts.map

package/dist/marks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marks.d.ts","sourceRoot":"","sources":["../src/marks.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,IAAI;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;CACnB;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,CAgDlD","sourcesContent":["import { findFencedBlocks, isInsideFencedBlock } from \"./scanner.ts\";\n\nexport interface Mark {\n\tid: string;\n\tcontent: string;\n\t/** Character offset of the `{` of the mark header line. */\n\tstartIndex: number;\n\t/** Character offset just past the `}` of the header. */\n\theaderEnd: number;\n\t/** Character offset where the content block begins. */\n\tcontentStart: number;\n\t/** Character offset just past the last content character. */\n\tcontentEnd: number;\n}\n\nconst MARK_LINE_RE = /^\\s*\\{#([A-Za-z0-9_-]+)\\}\\s*$/;\n\n/**\n * Two-pass mark collection: find own-line `{#id}` headers and capture the\n * content block that follows them.\n *\n * A header line is a line whose trimmed content is exactly `{#id}`. The\n * content block runs until the next line that starts (trimmed) with `{`, `[`,\n * `:`, `/`, or EOF. Headers inside fenced blocks (```, ~~~, inline `) are\n * ignored.\n *\n * A header with no following content is not a mark — it is a reference, which\n * the dispatcher resolves against collected marks.\n */\nexport function collectMarks(input: string): Mark[] {\n\tconst fencedRanges = findFencedBlocks(input);\n\tconst marks: Mark[] = [];\n\tconst lines = input.split(\"\\n\");\n\tlet offset = 0;\n\n\tfor (let i = 0; i < lines.length; i++) {\n\t\tconst line = lines[i];\n\t\tconst m = MARK_LINE_RE.exec(line);\n\t\tif (m && !isInsideFencedBlock(offset, fencedRanges)) {\n\t\t\tconst id = m[1] ?? \"\";\n\t\t\tconst headerEnd = offset + line.length;\n\n\t\t\tlet j = i + 1;\n\t\t\tlet contentStart = -1;\n\t\t\tlet contentEnd = headerEnd;\n\t\t\tlet nextOffset = offset + line.length + 1;\n\t\t\tfor (; j < lines.length; j++) {\n\t\t\t\tconst trimmed = lines[j].trim();\n\t\t\t\tif (\n\t\t\t\t\ttrimmed.startsWith(\"{\") ||\n\t\t\t\t\ttrimmed.startsWith(\"[\") ||\n\t\t\t\t\ttrimmed.startsWith(\":\") ||\n\t\t\t\t\ttrimmed.startsWith(\"/\")\n\t\t\t\t) {\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tif (contentStart === -1) contentStart = nextOffset;\n\t\t\t\tcontentEnd = nextOffset + lines[j].length;\n\t\t\t\tnextOffset += lines[j].length + 1;\n\t\t\t}\n\n\t\t\tif (contentStart !== -1) {\n\t\t\t\tconst content = input.slice(contentStart, contentEnd).trimEnd();\n\t\t\t\tmarks.push({\n\t\t\t\t\tid,\n\t\t\t\t\tcontent,\n\t\t\t\t\tstartIndex: offset,\n\t\t\t\t\theaderEnd,\n\t\t\t\t\tcontentStart,\n\t\t\t\t\tcontentEnd: contentStart + content.length,\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t\toffset += line.length + 1;\n\t}\n\n\treturn marks;\n}\n"]}

package/dist/marks.js

@@ -0,0 +1,59 @@
+import { findFencedBlocks, isInsideFencedBlock } from "./scanner.js";
+const MARK_LINE_RE = /^\s*\{#([A-Za-z0-9_-]+)\}\s*$/;
+/**
+ * Two-pass mark collection: find own-line `{#id}` headers and capture the
+ * content block that follows them.
+ *
+ * A header line is a line whose trimmed content is exactly `{#id}`. The
+ * content block runs until the next line that starts (trimmed) with `{`, `[`,
+ * `:`, `/`, or EOF. Headers inside fenced blocks (```, ~~~, inline `) are
+ * ignored.
+ *
+ * A header with no following content is not a mark — it is a reference, which
+ * the dispatcher resolves against collected marks.
+ */
+export function collectMarks(input) {
+    const fencedRanges = findFencedBlocks(input);
+    const marks = [];
+    const lines = input.split("\n");
+    let offset = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const m = MARK_LINE_RE.exec(line);
+        if (m && !isInsideFencedBlock(offset, fencedRanges)) {
+            const id = m[1] ?? "";
+            const headerEnd = offset + line.length;
+            let j = i + 1;
+            let contentStart = -1;
+            let contentEnd = headerEnd;
+            let nextOffset = offset + line.length + 1;
+            for (; j < lines.length; j++) {
+                const trimmed = lines[j].trim();
+                if (trimmed.startsWith("{") ||
+                    trimmed.startsWith("[") ||
+                    trimmed.startsWith(":") ||
+                    trimmed.startsWith("/")) {
+                    break;
+                }
+                if (contentStart === -1)
+                    contentStart = nextOffset;
+                contentEnd = nextOffset + lines[j].length;
+                nextOffset += lines[j].length + 1;
+            }
+            if (contentStart !== -1) {
+                const content = input.slice(contentStart, contentEnd).trimEnd();
+                marks.push({
+                    id,
+                    content,
+                    startIndex: offset,
+                    headerEnd,
+                    contentStart,
+                    contentEnd: contentStart + content.length,
+                });
+            }
+        }
+        offset += line.length + 1;
+    }
+    return marks;
+}
+//# sourceMappingURL=marks.js.map

package/dist/marks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marks.js","sourceRoot":"","sources":["../src/marks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAerE,MAAM,YAAY,GAAG,+BAA+B,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAU;IACnD,MAAM,YAAY,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAW,EAAE,CAAC;IACzB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC;YACrD,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACtB,MAAM,SAAS,GAAG,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YAEvC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,IAAI,YAAY,GAAG,CAAC,CAAC,CAAC;YACtB,IAAI,UAAU,GAAG,SAAS,CAAC;YAC3B,IAAI,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;YAC1C,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBAChC,IACC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;oBACvB,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;oBACvB,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;oBACvB,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EACtB,CAAC;oBACF,MAAM;gBACP,CAAC;gBACD,IAAI,YAAY,KAAK,CAAC,CAAC;oBAAE,YAAY,GAAG,UAAU,CAAC;gBACnD,UAAU,GAAG,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;gBAC1C,UAAU,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;YACnC,CAAC;YAED,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;gBACzB,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;gBAChE,KAAK,CAAC,IAAI,CAAC;oBACV,EAAE;oBACF,OAAO;oBACP,UAAU,EAAE,MAAM;oBAClB,SAAS;oBACT,YAAY;oBACZ,UAAU,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM;iBACzC,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;QACD,MAAM,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,KAAK,CAAC;AAAA,CACb","sourcesContent":["import { findFencedBlocks, isInsideFencedBlock } from \"./scanner.ts\";\n\nexport interface Mark {\n\tid: string;\n\tcontent: string;\n\t/** Character offset of the `{` of the mark header line. */\n\tstartIndex: number;\n\t/** Character offset just past the `}` of the header. */\n\theaderEnd: number;\n\t/** Character offset where the content block begins. */\n\tcontentStart: number;\n\t/** Character offset just past the last content character. */\n\tcontentEnd: number;\n}\n\nconst MARK_LINE_RE = /^\\s*\\{#([A-Za-z0-9_-]+)\\}\\s*$/;\n\n/**\n * Two-pass mark collection: find own-line `{#id}` headers and capture the\n * content block that follows them.\n *\n * A header line is a line whose trimmed content is exactly `{#id}`. The\n * content block runs until the next line that starts (trimmed) with `{`, `[`,\n * `:`, `/`, or EOF. Headers inside fenced blocks (```, ~~~, inline `) are\n * ignored.\n *\n * A header with no following content is not a mark — it is a reference, which\n * the dispatcher resolves against collected marks.\n */\nexport function collectMarks(input: string): Mark[] {\n\tconst fencedRanges = findFencedBlocks(input);\n\tconst marks: Mark[] = [];\n\tconst lines = input.split(\"\\n\");\n\tlet offset = 0;\n\n\tfor (let i = 0; i < lines.length; i++) {\n\t\tconst line = lines[i];\n\t\tconst m = MARK_LINE_RE.exec(line);\n\t\tif (m && !isInsideFencedBlock(offset, fencedRanges)) {\n\t\t\tconst id = m[1] ?? \"\";\n\t\t\tconst headerEnd = offset + line.length;\n\n\t\t\tlet j = i + 1;\n\t\t\tlet contentStart = -1;\n\t\t\tlet contentEnd = headerEnd;\n\t\t\tlet nextOffset = offset + line.length + 1;\n\t\t\tfor (; j < lines.length; j++) {\n\t\t\t\tconst trimmed = lines[j].trim();\n\t\t\t\tif (\n\t\t\t\t\ttrimmed.startsWith(\"{\") ||\n\t\t\t\t\ttrimmed.startsWith(\"[\") ||\n\t\t\t\t\ttrimmed.startsWith(\":\") ||\n\t\t\t\t\ttrimmed.startsWith(\"/\")\n\t\t\t\t) {\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tif (contentStart === -1) contentStart = nextOffset;\n\t\t\t\tcontentEnd = nextOffset + lines[j].length;\n\t\t\t\tnextOffset += lines[j].length + 1;\n\t\t\t}\n\n\t\t\tif (contentStart !== -1) {\n\t\t\t\tconst content = input.slice(contentStart, contentEnd).trimEnd();\n\t\t\t\tmarks.push({\n\t\t\t\t\tid,\n\t\t\t\t\tcontent,\n\t\t\t\t\tstartIndex: offset,\n\t\t\t\t\theaderEnd,\n\t\t\t\t\tcontentStart,\n\t\t\t\t\tcontentEnd: contentStart + content.length,\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t\toffset += line.length + 1;\n\t}\n\n\treturn marks;\n}\n"]}

package/dist/messages.d.ts

@@ -0,0 +1,23 @@
+export interface CueTextContent {
+    type: "text";
+    text: string;
+}
+export interface CueToolUseContent {
+    type: "tool_use";
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+export interface CueToolResultContent {
+    type: "tool_result";
+    toolUseId: string;
+    content: string;
+    isError?: boolean;
+}
+export type CueMessageContent = CueTextContent | CueToolUseContent | CueToolResultContent;
+export interface CueMessage {
+    role: "user" | "assistant" | "system" | "tool";
+    content: string | CueMessageContent[];
+    toolCallId?: string;
+}
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,iBAAiB,GAAG,oBAAoB,CAAC;AAE1F,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB","sourcesContent":["export interface CueTextContent {\n\ttype: \"text\";\n\ttext: string;\n}\n\nexport interface CueToolUseContent {\n\ttype: \"tool_use\";\n\tid: string;\n\tname: string;\n\tinput: Record<string, unknown>;\n}\n\nexport interface CueToolResultContent {\n\ttype: \"tool_result\";\n\ttoolUseId: string;\n\tcontent: string;\n\tisError?: boolean;\n}\n\nexport type CueMessageContent = CueTextContent | CueToolUseContent | CueToolResultContent;\n\nexport interface CueMessage {\n\trole: \"user\" | \"assistant\" | \"system\" | \"tool\";\n\tcontent: string | CueMessageContent[];\n\ttoolCallId?: string;\n}\n"]}

package/dist/messages.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"","sourcesContent":["export interface CueTextContent {\n\ttype: \"text\";\n\ttext: string;\n}\n\nexport interface CueToolUseContent {\n\ttype: \"tool_use\";\n\tid: string;\n\tname: string;\n\tinput: Record<string, unknown>;\n}\n\nexport interface CueToolResultContent {\n\ttype: \"tool_result\";\n\ttoolUseId: string;\n\tcontent: string;\n\tisError?: boolean;\n}\n\nexport type CueMessageContent = CueTextContent | CueToolUseContent | CueToolResultContent;\n\nexport interface CueMessage {\n\trole: \"user\" | \"assistant\" | \"system\" | \"tool\";\n\tcontent: string | CueMessageContent[];\n\ttoolCallId?: string;\n}\n"]}

package/dist/registry.d.ts

@@ -0,0 +1,94 @@
+import type { BehavioralDimension, ElementDef, SectionRange } from "./types.ts";
+export interface AliasConfig {
+    aliases: Record<string, string>;
+}
+/**
+ * Parse alias configuration from a cue.toml-style config string.
+ * Expects an [aliases] section with key = "value" pairs.
+ */
+export declare function parseAliasConfig(content: string): AliasConfig;
+export interface CueRoot {
+    /** Element root directory. */
+    path: string;
+    /** Config scope the root belongs to (drives override matching). */
+    scope: "user" | "project";
+}
+/**
+ * Single source of truth for cue element discovery roots. Used by
+ * CueRegistry.discover(), watchedPaths(), and the package manager's
+ * resource collection so the config UI lists exactly what will load.
+ */
+export declare function cueDiscoveryRoots(options?: {
+    projectRoot?: string;
+    skipHome?: boolean;
+    additionalRoots?: string[];
+}): CueRoot[];
+export declare class CueRegistry {
+    private elements;
+    private sharedTags;
+    private realpathCache;
+    private baseRoots;
+    private skipHome;
+    private disabledNames;
+    constructor(additionalRoots?: string[], options?: {
+        skipHome?: boolean;
+    });
+    private computeRoots;
+    /**
+     * Idempotent: clears all discovered state and re-scans, so it is safe
+     * to call again when watched files change (see watchedPaths).
+     * `disabled` holds lowercased element names to skip (config UI toggles).
+     */
+    discover(projectRoot?: string, options?: {
+        disabled?: string[];
+    }): void;
+    /**
+     * Existing directories whose changes invalidate discovery: element
+     * roots, shared-tags dirs, and cue.toml parents. Callers watch these
+     * (non-recursively) and call discover() again on change, then re-arm
+     * to pick up newly created subdirectories.
+     */
+    watchedPaths(projectRoot?: string): string[];
+    private discoverSharedTags;
+    getSharedTagSectionIndex(tagName: string): Map<string, SectionRange> | undefined;
+    loadSharedTagBody(tagName: string): string | undefined;
+    getSharedTagOverrides(tagName: string): BehavioralDimension[] | undefined;
+    getSharedTagDefs(): Map<string, {
+        description: string;
+        overrides: BehavioralDimension[];
+    }>;
+    private discoverFromRoot;
+    private registerElement;
+    private resolveRealpath;
+    private isDuplicate;
+    /**
+     * Load aliases from cue.toml config files in project root.
+     * Project-level aliases override home-level aliases.
+     */
+    loadAliases(projectRoot?: string): Record<string, string>;
+    private validateElement;
+    private validateTagHeaderAlignment;
+    get(name: string): ElementDef | undefined;
+    /**
+     * Get an element by name and optional version.
+     * If version is provided, tries to find the exact version first, then falls back to latest compatible.
+     * If version is not provided, returns the latest version.
+     */
+    getByVersion(name: string, version?: string): ElementDef | undefined;
+    /**
+     * Compare two semver versions.
+     * Returns positive if a > b, negative if a < b, 0 if equal.
+     */
+    private compareVersions;
+    has(name: string): boolean;
+    list(): ElementDef[];
+    getSectionIndex(name: string): Map<string, SectionRange> | undefined;
+    loadBody(name: string): string | undefined;
+    /**
+     * Load body for a specific version of an element.
+     */
+    loadBodyByVersion(name: string, version?: string): string | undefined;
+    getMdPath(name: string): string | undefined;
+    private buildSectionIndex;
+}
+//# sourceMappingURL=registry.d.ts.map