@x-code-cli/core 0.1.10 → 0.2.0

package/dist/agent/session-store.js

@@ -0,0 +1,415 @@
+// @x-code-cli/core — Per-session JSONL transcript store.
+//
+// One file per session: `.x-code/sessions/<slug>-<sessionId>.jsonl` (slug is
+// the same human-readable token used by plan files; falls back to
+// timestamp-only naming when the user's first message has no ASCII content).
+// The file is append-only; everything we record about a session — header,
+// each ModelMessage, periodic token-usage snapshots, compaction boundaries,
+// abort markers — lives as one JSON object per line.
+//
+// Why JSONL and not a single rewritten JSON document:
+//   - Crash-safe. A killed process or full-disk error at most loses the line
+//     currently being written; everything before it is intact.
+//   - Cheap appends. Each turn appends a few hundred bytes; never rewrites.
+//   - Mirrors Claude Code's `~/.claude/<project>/<uuid>.jsonl` exactly,
+//     including the `compact_boundary` semantics (see `loadSession` below).
+//
+// This module replaces the old per-session `<id>.usage.json` and
+// `<id>.json` (LLM summary) files — both are now meta entries inside the
+// jsonl. /usage history and /resume both source from the same file.
+import { createHash } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { XCODE_DIR } from '../utils.js';
+import { createLoopState } from './loop-state.js';
+const SESSIONS_SUBDIR = 'sessions';
+function sessionsDir(cwd = process.cwd()) {
+    return path.join(cwd, XCODE_DIR, SESSIONS_SUBDIR);
+}
+/** Build the on-disk filename for a session. Same shape as plan files
+ *  (`<slug>-<id>.<ext>`) so `ls .x-code/sessions/` and `ls .x-code/plans/`
+ *  scan the same way. Empty slug (CJK-only first message) collapses to
+ *  pure-timestamp naming, matching the plan-file fallback. */
+export function getSessionFilePath(state, cwd = process.cwd()) {
+    const base = state.taskSlug ? `${state.taskSlug}-${state.sessionId}` : state.sessionId;
+    return path.join(sessionsDir(cwd), `${base}.jsonl`);
+}
+// ── Append helpers (fire-and-forget; never throw) ───────────────────────
+async function appendLine(filePath, entry) {
+    try {
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        await fs.appendFile(filePath, JSON.stringify(entry) + '\n', 'utf-8');
+    }
+    catch {
+        // Persistence is best-effort — never block the agent loop on FS errors.
+    }
+}
+/** Try to read the current git branch from `.git/HEAD`. Cheap, fully sync
+ *  on the calling promise; absent / detached-HEAD / non-git all map to
+ *  undefined silently. */
+async function readGitBranch(cwd) {
+    try {
+        const head = await readFile(path.join(cwd, '.git', 'HEAD'), 'utf-8');
+        const m = head.match(/^ref: refs\/heads\/(.+)$/m);
+        return m ? m[1].trim() : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Write the session header. Idempotent: if the file already exists (resume
+ *  path), we skip — the original header is preserved so picker metadata
+ *  stays stable across resumes. */
+export async function appendHeader(state, modelId, firstPrompt, cwd = process.cwd()) {
+    const filePath = getSessionFilePath(state, cwd);
+    try {
+        await fs.access(filePath);
+        return; // file already exists — header preserved from original session
+    }
+    catch {
+        // File doesn't exist — fall through and write the header.
+    }
+    const gitBranch = await readGitBranch(cwd);
+    const entry = {
+        t: 'meta',
+        kind: 'header',
+        cwd,
+        gitBranch,
+        modelId,
+        startedAt: state.startedAt,
+        firstPrompt: firstPrompt.slice(0, 500),
+        taskSlug: state.taskSlug,
+        sessionId: state.sessionId,
+    };
+    await appendLine(filePath, entry);
+}
+/** Flush every message in `state.messages` past `state.persistedMessageCount`
+ *  to the jsonl file. The diff-based design keeps the writer decoupled from
+ *  the many places in the agent loop that mutate state.messages directly
+ *  (collectTurnResponse, processToolCalls, length-finish nudge, etc.) — we
+ *  catch them all by sweeping at turn boundaries.
+ *
+ *  After deep / light compaction the in-memory array shrinks. Callers must
+ *  call `markBoundaryAndReflush` (below) instead of this — that path writes
+ *  a compact-boundary marker so the loader can correctly truncate-on-load
+ *  and then re-appends the trimmed messages so post-boundary jsonl content
+ *  matches the new in-memory state. */
+export async function flushPendingMessages(state) {
+    if (state.persistedMessageCount >= state.messages.length)
+        return;
+    const filePath = getSessionFilePath(state);
+    const ts = new Date().toISOString();
+    const lines = [];
+    for (let i = state.persistedMessageCount; i < state.messages.length; i++) {
+        const message = state.messages[i];
+        if (!message)
+            continue;
+        const entry = { t: 'msg', message, ts };
+        lines.push(JSON.stringify(entry));
+    }
+    if (lines.length === 0)
+        return;
+    try {
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        await fs.appendFile(filePath, lines.join('\n') + '\n', 'utf-8');
+        state.persistedMessageCount = state.messages.length;
+    }
+    catch {
+        // best-effort
+    }
+}
+/** Append a usage snapshot for the current turn. Called from the agent loop
+ *  after `collectTurnResponse` accepts the provider's `usage` object. The
+ *  picker reads only the LAST usage line (tail scan) to display per-session
+ *  totals — no need to keep older snapshots around any more efficiently. */
+export async function appendUsage(state, modelId) {
+    const filePath = getSessionFilePath(state);
+    const entry = {
+        t: 'meta',
+        kind: 'usage',
+        usage: { ...state.tokenUsage },
+        modelId,
+        turn: state.turnCount,
+        ts: new Date().toISOString(),
+    };
+    await appendLine(filePath, entry);
+}
+/** Mark a compaction event and re-flush the (just-shrunk) message array.
+ *  After this returns, the jsonl post-last-boundary content equals
+ *  `state.messages` exactly — `loadSession` reconstructs the same in-memory
+ *  state on resume.
+ *
+ *  Why we re-append instead of relying on the pre-boundary messages: our
+ *  `compressMessages` keeps a `recent N` slice verbatim, but those slices
+ *  were already persisted before the boundary; the loader's
+ *  "everything-after-last-boundary wins" rule would otherwise drop them.
+ *  Duplicating ~6 messages on disk is cheap and keeps the load logic
+ *  trivial.
+ *
+ *  Light compaction (loop-guard pruning) calls this with `summary=undefined`
+ *  — the trimmed messages still need a boundary so the loader doesn't
+ *  resurrect the dropped loop-guard pairs. */
+export async function markBoundaryAndReflush(state, summary) {
+    const filePath = getSessionFilePath(state);
+    const ts = new Date().toISOString();
+    const boundary = { t: 'meta', kind: 'compact-boundary', ts };
+    if (summary !== undefined)
+        boundary.summary = summary;
+    const lines = [JSON.stringify(boundary)];
+    for (const message of state.messages) {
+        const entry = { t: 'msg', message, ts };
+        lines.push(JSON.stringify(entry));
+    }
+    try {
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        await fs.appendFile(filePath, lines.join('\n') + '\n', 'utf-8');
+        state.persistedMessageCount = state.messages.length;
+    }
+    catch {
+        // best-effort
+    }
+}
+/** Append an `interrupted` marker. Purely informational — the loader
+ *  ignores it for state reconstruction; the picker can show "interrupted"
+ *  next to sessions that ended mid-turn so users know what they're
+ *  resuming into. */
+export async function appendInterrupted(state) {
+    if (!state.sessionId)
+        return;
+    const filePath = getSessionFilePath(state);
+    const entry = { t: 'meta', kind: 'interrupted', ts: new Date().toISOString() };
+    await appendLine(filePath, entry);
+}
+const EMPTY_USAGE = {
+    inputTokens: 0,
+    outputTokens: 0,
+    totalTokens: 0,
+    cacheReadTokens: 0,
+    cacheCreationTokens: 0,
+    currentContextTokens: 0,
+};
+/** Walk a session jsonl and reconstruct a LoadedSession.
+ *
+ *  Compact-boundary semantics (matches Claude Code): every time we see a
+ *  `compact-boundary` line, the message accumulator is cleared. So the
+ *  returned `messages` reflects only what's after the LAST boundary —
+ *  which by construction equals the in-memory state at the point of
+ *  compaction (see `markBoundaryAndReflush`).
+ *
+ *  Trailing tool_call / tool_result orphans are trimmed (the next API
+ *  request would otherwise reject the message array) — see
+ *  `sanitizeMessageTail` for the exact rule. */
+export async function loadSession(filePath) {
+    let raw;
+    try {
+        raw = await readFile(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+    let header = null;
+    let lastUsage = null;
+    let messages = [];
+    for (const line of raw.split('\n')) {
+        if (!line.trim())
+            continue;
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            continue; // skip malformed lines silently
+        }
+        if (entry.t === 'meta') {
+            if (entry.kind === 'header') {
+                header = entry;
+            }
+            else if (entry.kind === 'usage') {
+                lastUsage = entry;
+            }
+            else if (entry.kind === 'compact-boundary') {
+                messages = [];
+            }
+            // 'interrupted' is informational only — doesn't affect state
+        }
+        else if (entry.t === 'msg') {
+            messages.push(entry.message);
+        }
+    }
+    if (!header)
+        return null;
+    return {
+        sessionId: header.sessionId,
+        taskSlug: header.taskSlug,
+        startedAt: header.startedAt,
+        modelId: header.modelId,
+        cwd: header.cwd,
+        gitBranch: header.gitBranch,
+        firstPrompt: header.firstPrompt,
+        messages: sanitizeMessageTail(messages),
+        tokenUsage: lastUsage?.usage ?? EMPTY_USAGE,
+        turnCount: lastUsage?.turn ?? 0,
+        filePath,
+    };
+}
+/** Drop trailing assistant tool_calls that have no matching tool_result
+ *  later in the array. Providers reject any orphan with "tool_use without
+ *  tool_result", so resuming a session that ended mid-tool-execution must
+ *  trim back to the last fully-resolved boundary.
+ *
+ *  Algorithm: collect every toolCallId that has a tool_result somewhere,
+ *  then walk back from the end and drop any assistant message whose
+ *  tool_call parts include an unresolved id. Stops at the first clean
+ *  message (text-only assistant, or assistant whose every tool_call IS
+ *  resolved). */
+function sanitizeMessageTail(messages) {
+    const resolvedIds = new Set();
+    for (const msg of messages) {
+        if (msg.role !== 'tool' || !Array.isArray(msg.content))
+            continue;
+        for (const part of msg.content) {
+            if (part?.type === 'tool-result' && typeof part.toolCallId === 'string') {
+                resolvedIds.add(part.toolCallId);
+            }
+        }
+    }
+    let cutAt = messages.length;
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const msg = messages[i];
+        if (!msg) {
+            cutAt = i;
+            continue;
+        }
+        if (msg.role !== 'assistant') {
+            // Bare 'tool' or 'user' at the tail without an upstream tool_call is
+            // legal — keep walking; the cut is driven only by orphan tool_calls.
+            break;
+        }
+        const content = msg.content;
+        if (typeof content === 'string')
+            break; // text-only assistant — clean tail
+        if (!Array.isArray(content))
+            break;
+        const hasOrphan = content.some((p) => p?.type === 'tool-call' && typeof p.toolCallId === 'string' && !resolvedIds.has(p.toolCallId));
+        if (hasOrphan) {
+            cutAt = i;
+            continue;
+        }
+        break;
+    }
+    return cutAt < messages.length ? messages.slice(0, cutAt) : messages;
+}
+/** Enumerate every session jsonl in the current project, newest first.
+ *  Reads only the head (~8KB, for the header line) and tail (~4KB, for
+ *  the last usage line) of each file — no full-file load — so the picker
+ *  is responsive even with hundreds of historical sessions. Files
+ *  without a parseable header are dropped silently. */
+export async function listSessions(cwd = process.cwd()) {
+    const dir = sessionsDir(cwd);
+    let entries;
+    try {
+        entries = await fs.readdir(dir);
+    }
+    catch {
+        return [];
+    }
+    const jsonlFiles = entries.filter((f) => f.endsWith('.jsonl'));
+    const results = await Promise.all(jsonlFiles.map(async (f) => {
+        const filePath = path.join(dir, f);
+        try {
+            const stat = await fs.stat(filePath);
+            const head = await readRange(filePath, 0, Math.min(8 * 1024, stat.size));
+            const headerLine = head.split('\n').find((l) => l.includes('"kind":"header"'));
+            if (!headerLine)
+                return null;
+            let header;
+            try {
+                header = JSON.parse(headerLine);
+            }
+            catch {
+                return null;
+            }
+            const tailStart = Math.max(0, stat.size - 4 * 1024);
+            const tail = await readRange(filePath, tailStart, stat.size - tailStart);
+            let tokenUsage = null;
+            const tailLines = tail.split('\n').reverse();
+            for (const l of tailLines) {
+                if (!l.trim())
+                    continue;
+                if (l.includes('"kind":"usage"')) {
+                    try {
+                        const e = JSON.parse(l);
+                        tokenUsage = e.usage;
+                        break;
+                    }
+                    catch {
+                        // Malformed line — keep scanning earlier lines.
+                    }
+                }
+            }
+            return {
+                filePath,
+                sessionId: header.sessionId,
+                taskSlug: header.taskSlug,
+                firstPrompt: header.firstPrompt,
+                startedAt: header.startedAt,
+                modelId: header.modelId,
+                mtime: stat.mtimeMs,
+                tokenUsage,
+            };
+        }
+        catch {
+            return null;
+        }
+    }));
+    return results.filter((r) => r !== null).sort((a, b) => b.mtime - a.mtime);
+}
+/** Read [offset, offset+length) bytes of a file as utf-8. Used by
+ *  `listSessions` to grab head/tail without slurping the full file. */
+async function readRange(filePath, offset, length) {
+    if (length <= 0)
+        return '';
+    const fh = await fs.open(filePath, 'r');
+    try {
+        const buf = Buffer.alloc(length);
+        const { bytesRead } = await fh.read(buf, 0, length, offset);
+        return buf.subarray(0, bytesRead).toString('utf-8');
+    }
+    finally {
+        await fh.close();
+    }
+}
+/** Pick the most recently modified session file in the current project, or
+ *  null if none exist. Used by `xc --continue` / `-c` to skip the picker
+ *  and resume the latest session unconditionally. */
+export async function pickLatestSession(cwd = process.cwd()) {
+    const all = await listSessions(cwd);
+    return all[0] ?? null;
+}
+/** Stable identifier for a session in picker UI. We can't use the filename
+ *  directly (it can collide visually when multiple sessions share a slug)
+ *  and the sessionId alone isn't unique across renames — but the file path
+ *  is, by definition. Hashed to keep the choice label compact. */
+export function shortIdFor(filePath) {
+    return createHash('sha1').update(filePath).digest('hex').slice(0, 8);
+}
+/** Build a LoopState seeded from a previously-saved session. The agent
+ *  loop accepts `existingState` and will continue appending to the same
+ *  jsonl file (filename derives from `sessionId` + `taskSlug`, both
+ *  preserved here). `persistedMessageCount` is set to the loaded length
+ *  so the very first flush after the next user submit only appends NEW
+ *  messages — the loaded tail is already on disk. */
+export function hydrateLoopState(loaded, initialMode = 'default') {
+    const state = createLoopState(initialMode);
+    state.sessionId = loaded.sessionId;
+    state.taskSlug = loaded.taskSlug;
+    state.startedAt = loaded.startedAt;
+    state.messages = loaded.messages.slice();
+    state.tokenUsage = { ...loaded.tokenUsage };
+    state.lastInputTokens = loaded.tokenUsage.inputTokens;
+    state.turnCount = loaded.turnCount;
+    state.persistedMessageCount = loaded.messages.length;
+    return state;
+}
+//# sourceMappingURL=session-store.js.map

package/dist/agent/session-store.js.map

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

package/dist/agent/sub-agents/built-in.d.ts

@@ -0,0 +1,3 @@
+import type { SubAgentDefinition } from './types.js';
+export declare const builtInAgents: SubAgentDefinition[];
+//# sourceMappingURL=built-in.d.ts.map

package/dist/agent/sub-agents/built-in.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in.d.ts","sourceRoot":"","sources":["../../../src/agent/sub-agents/built-in.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAapD,eAAO,MAAM,aAAa,EAAE,kBAAkB,EA0F7C,CAAA"}

package/dist/agent/sub-agents/built-in.js

@@ -0,0 +1,98 @@
+const SHELL_DENY_KEYWORDS = [
+    'rm ', 'rm\t', 'rmdir', 'del ', 'rd ',
+    'mv ', 'move ', 'ren ',
+    'git commit', 'git push', 'git merge', 'git rebase', 'git reset',
+    'git checkout -b', 'git branch -d', 'git branch -D',
+    '>', '>>', 'tee ', 'tee\t',
+    'chmod', 'chown',
+    'npm publish', 'pnpm publish', 'yarn publish',
+    'docker rm', 'docker rmi',
+];
+export const builtInAgents = [
+    {
+        name: 'explore',
+        description: 'Read-only codebase exploration. Use for "where is X defined", "find all callers of Y", or any pure-read research question.',
+        prompt: `You are a read-only codebase explorer. Your job is to find information, trace code paths, and report findings clearly.
+
+Guidelines:
+- Search broadly first (glob, grep), then read specific files
+- Report file paths and line numbers so the parent agent can reference them
+- If the codebase is large, prioritize the most relevant files
+- Do NOT suggest code changes — just report what you find
+
+CRITICAL — your final message is ALL the parent agent sees. It will NOT re-read files you've already read. Your output must be comprehensive enough that the parent can act on it directly:
+- Include key code snippets (function signatures, type definitions, important logic) — not just file paths
+- For architecture questions, describe the data flow and module relationships
+- For "find all X" questions, list every match with file:line and a brief context line
+- When exploring project structure, include dependency lists, entry points, and config details
+- Never say "see file X for details" — the parent CANNOT see file X. Inline the relevant details.`,
+        tools: ['readFile', 'glob', 'grep', 'listDir', 'shell'],
+        shellRestrictions: SHELL_DENY_KEYWORDS,
+        maxTurns: 25,
+        source: 'built-in',
+    },
+    {
+        name: 'general-purpose',
+        description: 'Multi-step research and investigation. Use for open-ended questions that may need 3+ tool calls and you don\'t want noise in the main context.',
+        prompt: `You are a general-purpose research assistant. You can read files, search code, and run shell commands to investigate questions.
+
+Guidelines:
+- Be thorough but efficient — minimize unnecessary tool calls
+- Synthesize findings into a clear, actionable summary
+- Include file paths and line numbers for key references
+- If you find issues or patterns, describe them concisely
+
+CRITICAL — your final message is ALL the parent agent sees. It will NOT re-read files you've already read. Your output must be self-contained:
+- Include key code snippets, not just references — the parent cannot read the files
+- For multi-file investigations, summarize each file's role and relevant content
+- When the parent needs to modify code, include the exact current code that needs changing`,
+        tools: ['readFile', 'glob', 'grep', 'listDir', 'shell'],
+        maxTurns: 40,
+        source: 'built-in',
+    },
+    {
+        name: 'plan',
+        description: 'Design an implementation plan. Returns step-by-step plans, identifies critical files, considers tradeoffs.',
+        prompt: `You are a planning assistant. Given a task description, explore the codebase and produce a detailed implementation plan.
+
+Your plan should include:
+1. **Context** — what problem is being solved and why
+2. **Critical files** — which files need to change, with paths
+3. **Step-by-step approach** — ordered implementation steps
+4. **Existing code to reuse** — functions, patterns, utilities already in the repo
+5. **Risks and tradeoffs** — edge cases, breaking changes, alternatives considered
+6. **Verification** — how to test the changes
+
+Guidelines:
+- Read the relevant code before planning — don't guess at file structure
+- Reference existing patterns in the codebase (don't reinvent)
+- Keep the plan concise enough to execute, detailed enough to be unambiguous`,
+        tools: ['readFile', 'glob', 'grep', 'listDir'],
+        maxTurns: 30,
+        source: 'built-in',
+    },
+    {
+        name: 'code-reviewer',
+        description: 'Review pending changes (or specific files) for bugs, security issues, and style violations. Returns a punch list.',
+        prompt: `You are a code reviewer. Examine the specified files or pending changes and produce a structured review.
+
+Your review should cover:
+- **Bugs** — logic errors, off-by-one, null/undefined hazards, race conditions
+- **Security** — injection, XSS, secrets in code, unsafe deserialization
+- **Style** — naming, consistency with surrounding code, dead code
+- **Performance** — unnecessary allocations, O(n^2) where O(n) suffices
+- **Missing edge cases** — error handling, empty inputs, concurrent access
+
+Output format: a numbered punch list, each item with severity (critical/warning/nit), file:line, and a one-line description. Group by file.
+
+Guidelines:
+- Use git diff (shell) to see pending changes when reviewing uncommitted work
+- Read surrounding code for context — don't flag patterns that are idiomatic in this codebase
+- Be specific: "line 42: array index not bounds-checked" not "consider adding validation"`,
+        tools: ['readFile', 'glob', 'grep', 'listDir', 'shell'],
+        shellRestrictions: SHELL_DENY_KEYWORDS,
+        maxTurns: 25,
+        source: 'built-in',
+    },
+];
+//# sourceMappingURL=built-in.js.map

package/dist/agent/sub-agents/built-in.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in.js","sourceRoot":"","sources":["../../../src/agent/sub-agents/built-in.ts"],"names":[],"mappings":"AAGA,MAAM,mBAAmB,GAAG;IAC1B,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK;IACrC,KAAK,EAAE,OAAO,EAAE,MAAM;IACtB,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW;IAChE,iBAAiB,EAAE,eAAe,EAAE,eAAe;IACnD,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO;IAC1B,OAAO,EAAE,OAAO;IAChB,aAAa,EAAE,cAAc,EAAE,cAAc;IAC7C,WAAW,EAAE,YAAY;CAC1B,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAyB;IACjD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EACT,4HAA4H;QAC9H,MAAM,EAAE;;;;;;;;;;;;;kGAasF;QAC9F,KAAK,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC;QACvD,iBAAiB,EAAE,mBAAmB;QACtC,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,UAAU;KACnB;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,gJAAgJ;QAClJ,MAAM,EAAE;;;;;;;;;;;2FAW+E;QACvF,KAAK,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC;QACvD,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,UAAU;KACnB;IACD;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EACT,4GAA4G;QAC9G,MAAM,EAAE;;;;;;;;;;;;;6EAaiE;QACzE,KAAK,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC;QAC9C,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,UAAU;KACnB;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,mHAAmH;QACrH,MAAM,EAAE;;;;;;;;;;;;;;0FAc8E;QACtF,KAAK,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC;QACvD,iBAAiB,EAAE,mBAAmB;QACtC,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,UAAU;KACnB;CACF,CAAA"}

package/dist/agent/sub-agents/index.d.ts

@@ -0,0 +1,7 @@
+export type { SubAgentDefinition, SubAgentTrace, SubAgentEvent } from './types.js';
+export { builtInAgents } from './built-in.js';
+export { loadCustomAgents } from './loader.js';
+export { SubAgentRegistry, createSubAgentRegistry, createBuiltInRegistry } from './registry.js';
+export { runSubAgent } from './runner.js';
+export type { RunSubAgentArgs, RunSubAgentResult } from './runner.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/sub-agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/sub-agents/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAC/F,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA"}

package/dist/agent/sub-agents/index.js

@@ -0,0 +1,5 @@
+export { builtInAgents } from './built-in.js';
+export { loadCustomAgents } from './loader.js';
+export { SubAgentRegistry, createSubAgentRegistry, createBuiltInRegistry } from './registry.js';
+export { runSubAgent } from './runner.js';
+//# sourceMappingURL=index.js.map

package/dist/agent/sub-agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/sub-agents/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAC/F,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA"}

package/dist/agent/sub-agents/loader.d.ts

@@ -0,0 +1,5 @@
+import type { SubAgentDefinition } from './types.js';
+/** Load custom sub-agents from global + project directories.
+ *  Environment variable `XC_AGENTS_DIR` overrides paths (testing only). */
+export declare function loadCustomAgents(): Promise<SubAgentDefinition[]>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/agent/sub-agents/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/agent/sub-agents/loader.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAiHpD;2EAC2E;AAC3E,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAatE"}