ccgateway 0.1.0

package/dist/router.js

@@ -0,0 +1,103 @@
+// ── MessageRouter ─────────────────────────────────────────────────────────
+export class MessageRouter {
+    agents;
+    sessions;
+    context;
+    spawner;
+    bindings;
+    constructor(agents, sessions, context, spawner, bindings) {
+        this.agents = agents;
+        this.sessions = sessions;
+        this.context = context;
+        this.spawner = spawner;
+        this.bindings = bindings;
+    }
+    /**
+     * Resolve which agent handles a message based on bindings.
+     * Given (gateway, channelId), find the matching binding and return binding.agent.
+     */
+    resolveAgent(gateway, channelId) {
+        const binding = this.bindings.find((b) => b.gateway === gateway && b.channel === channelId);
+        return binding?.agent;
+    }
+    /**
+     * Full message dispatch pipeline.
+     *
+     * 1. Look up agent config from registry
+     * 2. Derive session key: {agentId}:{gateway}:{channel}
+     * 3. Get or create session
+     * 4. Append user message to session
+     * 5. Build context
+     * 6. Spawn claude --print
+     * 7. Append assistant response to session (or error on failure)
+     * 8. Return response text
+     */
+    async route(message) {
+        const agentId = message.to.agent;
+        // 1. Get agent config
+        const agent = this.agents.getAgent(agentId);
+        if (!agent) {
+            throw new Error(`Agent "${agentId}" not found in registry`);
+        }
+        // 2. Derive session key
+        const sessionKey = this.sessions.getOrCreateSession(agentId, message.from.gateway, message.from.channel);
+        // 3. Append user message to session
+        await this.sessions.appendMessage(agentId, sessionKey, {
+            role: "user",
+            content: message.content,
+            ts: Date.now(),
+            source: message.from.gateway,
+            sourceUser: message.from.user,
+            sourceMessageId: message.from.messageId,
+        });
+        // 4. Build context
+        const systemPrompt = await this.context.build(agentId, sessionKey);
+        // 5. Spawn claude --print
+        const result = await this.spawner.spawn({
+            workspace: agent.workspace,
+            message: message.content,
+            systemPrompt,
+            model: agent.model,
+            allowedTools: agent.allowedTools,
+        });
+        // 6. Handle failure: append error to session and throw
+        if (result.exitCode !== 0) {
+            const errorContent = result.response || `Spawner failed with exit code ${result.exitCode}`;
+            await this.sessions.appendMessage(agentId, sessionKey, {
+                role: "assistant",
+                content: `[error] ${errorContent}`,
+                ts: Date.now(),
+                tokens: result.tokensEstimate,
+            });
+            throw new Error(`Spawner exited with code ${result.exitCode}: ${errorContent}`);
+        }
+        // 7. Append assistant response to session
+        await this.sessions.appendMessage(agentId, sessionKey, {
+            role: "assistant",
+            content: result.response,
+            ts: Date.now(),
+            tokens: result.tokensEstimate,
+        });
+        // 8. Return response text
+        return result.response;
+    }
+    /**
+     * Add a binding at runtime.
+     */
+    addBinding(binding) {
+        this.bindings.push(binding);
+    }
+    /**
+     * Get all bindings for a given agent.
+     */
+    getBindingsForAgent(agentId) {
+        return this.bindings.filter((b) => b.agent === agentId);
+    }
+    /**
+     * Get the primary (first) binding for an agent.
+     */
+    getPrimaryBinding(agentId) {
+        return this.bindings.find((b) => b.agent === agentId);
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

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

package/dist/sessions.d.ts

@@ -0,0 +1,55 @@
+export interface SessionMessage {
+    role: "user" | "assistant" | "system";
+    content: string;
+    ts: number;
+    source?: string;
+    sourceUser?: string;
+    sourceMessageId?: string;
+    tokens?: {
+        in: number;
+        out: number;
+    };
+}
+export interface SessionInfo {
+    agentId: string;
+    sessionKey: string;
+    messageCount: number;
+    lastActivity: number;
+    filePath: string;
+}
+export declare class SessionManager {
+    private ccgHome;
+    constructor(ccgHome: string);
+    /**
+     * Get or create a session. Returns the session key.
+     */
+    getOrCreateSession(agentId: string, source: string, sourceId: string): string;
+    /**
+     * Get the JSONL file path for a session.
+     */
+    getSessionPath(agentId: string, sessionKey: string): string;
+    /**
+     * Append a message to the session JSONL.
+     */
+    appendMessage(agentId: string, sessionKey: string, message: SessionMessage): Promise<void>;
+    /**
+     * Read all messages from a session.
+     * Returns an empty array for non-existent sessions.
+     */
+    readHistory(agentId: string, sessionKey: string): Promise<SessionMessage[]>;
+    /**
+     * Build windowed history that fits within token budget.
+     * Estimates tokens as chars/4. Returns newest messages that fit.
+     * tokenBudget defaults to 200000.
+     */
+    getWindowedHistory(agentId: string, sessionKey: string, tokenBudget?: number): Promise<SessionMessage[]>;
+    /**
+     * Reset session: archive current JSONL (rename with timestamp suffix).
+     */
+    resetSession(agentId: string, sessionKey: string): Promise<void>;
+    /**
+     * List all sessions, optionally filtered by agent.
+     */
+    listSessions(agentId?: string): Promise<SessionInfo[]>;
+}
+//# sourceMappingURL=sessions.d.ts.map

package/dist/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../src/sessions.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACtC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAqCD,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,MAAM;IAI3B;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI7E;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAU3D;;OAEG;IACG,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC;IAYhB;;;OAGG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,EAAE,CAAC;IAY5B;;;;OAIG;IACG,kBAAkB,CACtB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,GAAE,MAAe,GAC3B,OAAO,CAAC,cAAc,EAAE,CAAC;IAiC5B;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtE;;OAEG;IACG,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CA8C7D"}

package/dist/sessions.js

@@ -0,0 +1,160 @@
+import { appendFile, readFile, rename, readdir, mkdir, stat } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+// ── Helpers ────────────────────────────────────────────────────────────────
+/**
+ * Convert a session key (with colons) to a filesystem-safe filename stem.
+ * e.g. "salt:discord:1465736400014938230" → "salt-discord-1465736400014938230"
+ */
+function keyToFilename(sessionKey) {
+    return sessionKey.replace(/:/g, "-") + ".jsonl";
+}
+/**
+ * Convert a filesystem filename back to a session key.
+ * e.g. "salt-discord-1465736400014938230.jsonl" → "salt:discord:1465736400014938230"
+ * The key format is {agentId}:{source}:{sourceId}. We know the agentId from context,
+ * so we can reconstruct by replacing the first two dashes with colons.
+ */
+function filenameToKey(filename) {
+    const stem = filename.replace(/\.jsonl$/, "");
+    // Replace first dash with colon, then second dash with colon.
+    // The sourceId portion may itself contain dashes, so only replace first two.
+    const first = stem.indexOf("-");
+    if (first === -1)
+        return stem;
+    const second = stem.indexOf("-", first + 1);
+    if (second === -1)
+        return stem;
+    return (stem.slice(0, first) +
+        ":" +
+        stem.slice(first + 1, second) +
+        ":" +
+        stem.slice(second + 1));
+}
+// ── SessionManager ─────────────────────────────────────────────────────────
+export class SessionManager {
+    ccgHome;
+    constructor(ccgHome) {
+        this.ccgHome = ccgHome;
+    }
+    /**
+     * Get or create a session. Returns the session key.
+     */
+    getOrCreateSession(agentId, source, sourceId) {
+        return `${agentId}:${source}:${sourceId}`;
+    }
+    /**
+     * Get the JSONL file path for a session.
+     */
+    getSessionPath(agentId, sessionKey) {
+        return join(this.ccgHome, "agents", agentId, "sessions", keyToFilename(sessionKey));
+    }
+    /**
+     * Append a message to the session JSONL.
+     */
+    async appendMessage(agentId, sessionKey, message) {
+        const filePath = this.getSessionPath(agentId, sessionKey);
+        const dir = join(this.ccgHome, "agents", agentId, "sessions");
+        if (!existsSync(dir)) {
+            await mkdir(dir, { recursive: true });
+        }
+        const line = JSON.stringify(message) + "\n";
+        await appendFile(filePath, line, "utf-8");
+    }
+    /**
+     * Read all messages from a session.
+     * Returns an empty array for non-existent sessions.
+     */
+    async readHistory(agentId, sessionKey) {
+        const filePath = this.getSessionPath(agentId, sessionKey);
+        if (!existsSync(filePath)) {
+            return [];
+        }
+        const raw = await readFile(filePath, "utf-8");
+        const lines = raw.split("\n").filter((l) => l.trim().length > 0);
+        return lines.map((line) => JSON.parse(line));
+    }
+    /**
+     * Build windowed history that fits within token budget.
+     * Estimates tokens as chars/4. Returns newest messages that fit.
+     * tokenBudget defaults to 200000.
+     */
+    async getWindowedHistory(agentId, sessionKey, tokenBudget = 200000) {
+        const messages = await this.readHistory(agentId, sessionKey);
+        if (messages.length === 0) {
+            return [];
+        }
+        // Always keep at least the most recent message
+        const result = [];
+        let totalTokens = 0;
+        // Walk backwards from newest to oldest
+        for (let i = messages.length - 1; i >= 0; i--) {
+            const msgTokens = Math.ceil(messages[i].content.length / 4);
+            if (result.length === 0) {
+                // Always include the most recent message
+                result.unshift(messages[i]);
+                totalTokens += msgTokens;
+                continue;
+            }
+            if (totalTokens + msgTokens <= tokenBudget) {
+                result.unshift(messages[i]);
+                totalTokens += msgTokens;
+            }
+            else {
+                break;
+            }
+        }
+        return result;
+    }
+    /**
+     * Reset session: archive current JSONL (rename with timestamp suffix).
+     */
+    async resetSession(agentId, sessionKey) {
+        const filePath = this.getSessionPath(agentId, sessionKey);
+        if (!existsSync(filePath)) {
+            return;
+        }
+        const timestamp = Date.now();
+        const archivePath = filePath.replace(/\.jsonl$/, `.${timestamp}.jsonl`);
+        await rename(filePath, archivePath);
+    }
+    /**
+     * List all sessions, optionally filtered by agent.
+     */
+    async listSessions(agentId) {
+        const agentsDir = join(this.ccgHome, "agents");
+        const results = [];
+        if (!existsSync(agentsDir)) {
+            return results;
+        }
+        const agentDirs = agentId ? [agentId] : await readdir(agentsDir);
+        for (const agent of agentDirs) {
+            const sessionsDir = join(agentsDir, agent, "sessions");
+            if (!existsSync(sessionsDir)) {
+                continue;
+            }
+            const files = await readdir(sessionsDir);
+            for (const file of files) {
+                // Only match active session files (not archived ones with timestamp suffix)
+                if (!file.endsWith(".jsonl") || /\.\d+\.jsonl$/.test(file)) {
+                    continue;
+                }
+                const filePath = join(sessionsDir, file);
+                const sessionKey = filenameToKey(file);
+                const messages = await this.readHistory(agent, sessionKey);
+                const lastActivity = messages.length > 0
+                    ? messages[messages.length - 1].ts
+                    : (await stat(filePath)).mtimeMs;
+                results.push({
+                    agentId: agent,
+                    sessionKey,
+                    messageCount: messages.length,
+                    lastActivity,
+                    filePath,
+                });
+            }
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=sessions.js.map

package/dist/sessions.js.map

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

package/dist/skills.d.ts

@@ -0,0 +1,58 @@
+export interface SkillDefinition {
+    name: string;
+    description: string;
+    type: "markdown" | "native";
+    filePath?: string;
+    agentId?: string;
+}
+/**
+ * Parse YAML frontmatter from a markdown skill file.
+ * Expects `---` delimiters at the top with `name:` and `description:` fields.
+ * Simple parser — no yaml dependency.
+ */
+export declare function parseFrontmatter(content: string): {
+    name: string;
+    description: string;
+} | null;
+export declare class SkillManager {
+    private ccgHome;
+    constructor(ccgHome: string);
+    private sharedSkillsDir;
+    private agentSkillsDir;
+    /**
+     * Discover all skills: shared + agent-specific.
+     * Agent-specific skills override shared skills with the same name.
+     */
+    discoverSkills(agentId?: string): Promise<SkillDefinition[]>;
+    /**
+     * Read a markdown skill's full content.
+     * Checks agent-specific dir first (if agentId provided), then shared.
+     */
+    readSkill(name: string, agentId?: string): Promise<string | null>;
+    /**
+     * Build skill index for context injection (name + description per skill).
+     */
+    buildSkillIndex(agentId?: string): Promise<string>;
+    /**
+     * Add a skill (copy .md file to shared or agent-specific directory).
+     */
+    addSkill(filePath: string, agentId?: string): Promise<void>;
+    /**
+     * Remove a skill.
+     */
+    removeSkill(name: string, agentId?: string): Promise<boolean>;
+    /**
+     * List skills.
+     */
+    listSkills(agentId?: string): Promise<SkillDefinition[]>;
+    /**
+     * Load all markdown skills from a directory.
+     */
+    private loadSkillsFromDir;
+    /**
+     * Find a skill file in a directory by skill name.
+     * Reads frontmatter of each .md file to match by name.
+     */
+    private findSkillFile;
+}
+//# sourceMappingURL=skills.d.ts.map

package/dist/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,GACd;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAoC9C;AAID,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,MAAM;IAM3B,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,cAAc;IAMtB;;;OAGG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAuBlE;;;OAGG;IACG,SAAS,CACb,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAqBzB;;OAEG;IACG,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAexD;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcjE;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYnE;;OAEG;IACG,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAM9D;;OAEG;YACW,iBAAiB;IAiC/B;;;OAGG;YACW,aAAa;CAsB5B"}

package/dist/skills.js

@@ -0,0 +1,194 @@
+import { readFile, readdir, mkdir, copyFile, unlink } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join, basename } from "node:path";
+// ── Frontmatter parser ──────────────────────────────────────────────────────
+/**
+ * Parse YAML frontmatter from a markdown skill file.
+ * Expects `---` delimiters at the top with `name:` and `description:` fields.
+ * Simple parser — no yaml dependency.
+ */
+export function parseFrontmatter(content) {
+    const lines = content.split("\n");
+    // Must start with ---
+    if (lines[0]?.trim() !== "---")
+        return null;
+    let endIndex = -1;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i].trim() === "---") {
+            endIndex = i;
+            break;
+        }
+    }
+    if (endIndex === -1)
+        return null;
+    let name = "";
+    let description = "";
+    for (let i = 1; i < endIndex; i++) {
+        const line = lines[i];
+        const nameMatch = line.match(/^name:\s*(.+)/);
+        if (nameMatch) {
+            name = nameMatch[1].trim();
+            continue;
+        }
+        const descMatch = line.match(/^description:\s*(.+)/);
+        if (descMatch) {
+            description = descMatch[1].trim();
+            continue;
+        }
+    }
+    if (!name)
+        return null;
+    return { name, description };
+}
+// ── SkillManager ────────────────────────────────────────────────────────────
+export class SkillManager {
+    ccgHome;
+    constructor(ccgHome) {
+        this.ccgHome = ccgHome;
+    }
+    // ── Directory helpers ───────────────────────────────────────────────────
+    sharedSkillsDir() {
+        return join(this.ccgHome, "skills");
+    }
+    agentSkillsDir(agentId) {
+        return join(this.ccgHome, "agents", agentId, "skills");
+    }
+    // ── Core methods ────────────────────────────────────────────────────────
+    /**
+     * Discover all skills: shared + agent-specific.
+     * Agent-specific skills override shared skills with the same name.
+     */
+    async discoverSkills(agentId) {
+        const skillMap = new Map();
+        // Load shared skills first
+        const sharedSkills = await this.loadSkillsFromDir(this.sharedSkillsDir());
+        for (const skill of sharedSkills) {
+            skillMap.set(skill.name, skill);
+        }
+        // Load agent-specific skills (override shared)
+        if (agentId) {
+            const agentSkills = await this.loadSkillsFromDir(this.agentSkillsDir(agentId), agentId);
+            for (const skill of agentSkills) {
+                skillMap.set(skill.name, skill);
+            }
+        }
+        return Array.from(skillMap.values());
+    }
+    /**
+     * Read a markdown skill's full content.
+     * Checks agent-specific dir first (if agentId provided), then shared.
+     */
+    async readSkill(name, agentId) {
+        // Check agent-specific first
+        if (agentId) {
+            const agentPath = await this.findSkillFile(this.agentSkillsDir(agentId), name);
+            if (agentPath) {
+                return readFile(agentPath, "utf-8");
+            }
+        }
+        // Fall back to shared
+        const sharedPath = await this.findSkillFile(this.sharedSkillsDir(), name);
+        if (sharedPath) {
+            return readFile(sharedPath, "utf-8");
+        }
+        return null;
+    }
+    /**
+     * Build skill index for context injection (name + description per skill).
+     */
+    async buildSkillIndex(agentId) {
+        const skills = await this.discoverSkills(agentId);
+        if (skills.length === 0) {
+            return "--- Available Skills ---\n(none)";
+        }
+        const lines = skills.map((s) => {
+            const tag = s.type === "native" ? " [native]" : "";
+            return `- ${s.name}: ${s.description}${tag}`;
+        });
+        return `--- Available Skills ---\n${lines.join("\n")}`;
+    }
+    /**
+     * Add a skill (copy .md file to shared or agent-specific directory).
+     */
+    async addSkill(filePath, agentId) {
+        const targetDir = agentId
+            ? this.agentSkillsDir(agentId)
+            : this.sharedSkillsDir();
+        if (!existsSync(targetDir)) {
+            await mkdir(targetDir, { recursive: true });
+        }
+        const fileName = basename(filePath);
+        const targetPath = join(targetDir, fileName);
+        await copyFile(filePath, targetPath);
+    }
+    /**
+     * Remove a skill.
+     */
+    async removeSkill(name, agentId) {
+        const targetDir = agentId
+            ? this.agentSkillsDir(agentId)
+            : this.sharedSkillsDir();
+        const filePath = await this.findSkillFile(targetDir, name);
+        if (!filePath)
+            return false;
+        await unlink(filePath);
+        return true;
+    }
+    /**
+     * List skills.
+     */
+    async listSkills(agentId) {
+        return this.discoverSkills(agentId);
+    }
+    // ── Private helpers ─────────────────────────────────────────────────────
+    /**
+     * Load all markdown skills from a directory.
+     */
+    async loadSkillsFromDir(dir, agentId) {
+        if (!existsSync(dir))
+            return [];
+        const entries = await readdir(dir);
+        const skills = [];
+        for (const entry of entries) {
+            if (!entry.endsWith(".md"))
+                continue;
+            const filePath = join(dir, entry);
+            const content = await readFile(filePath, "utf-8");
+            const meta = parseFrontmatter(content);
+            if (meta) {
+                const skill = {
+                    name: meta.name,
+                    description: meta.description,
+                    type: "markdown",
+                    filePath,
+                };
+                if (agentId) {
+                    skill.agentId = agentId;
+                }
+                skills.push(skill);
+            }
+        }
+        return skills;
+    }
+    /**
+     * Find a skill file in a directory by skill name.
+     * Reads frontmatter of each .md file to match by name.
+     */
+    async findSkillFile(dir, name) {
+        if (!existsSync(dir))
+            return null;
+        const entries = await readdir(dir);
+        for (const entry of entries) {
+            if (!entry.endsWith(".md"))
+                continue;
+            const filePath = join(dir, entry);
+            const content = await readFile(filePath, "utf-8");
+            const meta = parseFrontmatter(content);
+            if (meta && meta.name === name) {
+                return filePath;
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=skills.js.map

package/dist/skills.js.map

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

package/dist/spawner.d.ts

@@ -0,0 +1,29 @@
+export interface SpawnResult {
+    response: string;
+    exitCode: number;
+    tokensEstimate: {
+        in: number;
+        out: number;
+    };
+}
+export interface SpawnOptions {
+    workspace: string;
+    message: string;
+    systemPrompt: string;
+    model: string;
+    allowedTools: string[];
+    timeoutMs?: number;
+}
+export declare class CCSpawner {
+    /**
+     * Spawn a `claude --print` invocation.
+     *
+     * Executes:
+     *   claude --print -p "<message>" --append-system-prompt "<context>"
+     *          --model <model> --allowedTools Tool1,Tool2,...
+     *
+     * Captures stdout as the response. Estimates tokens as chars / 4.
+     */
+    spawn(options: SpawnOptions): Promise<SpawnResult>;
+}
+//# sourceMappingURL=spawner.d.ts.map

package/dist/spawner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawner.d.ts","sourceRoot":"","sources":["../src/spawner.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,qBAAa,SAAS;IACpB;;;;;;;;OAQG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;CAwDzD"}