@x-code-cli/core 0.1.0

package/dist/knowledge/init.d.ts

@@ -0,0 +1,8 @@
+interface InitResult {
+    detectedFacts: string[];
+    createdFiles: string[];
+}
+/** Initialize .x-code/ project structure and generate knowledge from project analysis */
+export declare function initProject(cwd?: string): Promise<InitResult>;
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/knowledge/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/knowledge/init.ts"],"names":[],"mappings":"AAQA,UAAU,UAAU;IAClB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,yFAAyF;AACzF,wBAAsB,WAAW,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CAoFlF"}

package/dist/knowledge/init.js

@@ -0,0 +1,98 @@
+// @x-code/core — Project initialization (xc init / /init)
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { XCODE_DIR, fileExists } from '../utils.js';
+import { getAutoMemory } from './auto-memory.js';
+import { scanProject } from './hooks.js';
+/** Initialize .x-code/ project structure and generate knowledge from project analysis */
+export async function initProject(cwd = process.cwd()) {
+    const xDir = path.join(cwd, XCODE_DIR);
+    const detectedFacts = [];
+    const createdFiles = [];
+    // Create directories
+    const dirs = [
+        xDir,
+        path.join(xDir, 'memory'),
+        path.join(xDir, 'rules'),
+        path.join(xDir, 'sessions'),
+        path.join(xDir, 'plans'),
+        path.join(xDir, 'local'),
+    ];
+    for (const dir of dirs) {
+        await fs.mkdir(dir, { recursive: true });
+    }
+    // Scan project and populate auto memory
+    await scanProject(cwd);
+    const memory = getAutoMemory('project');
+    const facts = memory.getAll();
+    for (const fact of facts) {
+        detectedFacts.push(`${fact.key}: ${fact.fact}`);
+    }
+    // Generate knowledge.md
+    const knowledgePath = path.join(xDir, 'knowledge.md');
+    const knowledgeExists = await fileExists(knowledgePath);
+    if (!knowledgeExists) {
+        const knowledgeContent = generateKnowledgeMd(facts.map((f) => ({ key: f.key, fact: f.fact, category: f.category })));
+        await fs.writeFile(knowledgePath, knowledgeContent, 'utf-8');
+        createdFiles.push('.x-code/knowledge.md');
+    }
+    // Create .x-code/local/.gitignore if not exists
+    const localGitignore = path.join(xDir, 'local', '.gitignore');
+    if (!(await fileExists(localGitignore))) {
+        await fs.writeFile(localGitignore, '*\n', 'utf-8');
+        createdFiles.push('.x-code/local/.gitignore');
+    }
+    // Create .x-code/local/preferences.md template if not exists
+    const prefsPath = path.join(xDir, 'local', 'preferences.md');
+    if (!(await fileExists(prefsPath))) {
+        await fs.writeFile(prefsPath, '# Personal Preferences\n\n<!-- Add your personal coding preferences here. This file is gitignored. -->\n', 'utf-8');
+        createdFiles.push('.x-code/local/preferences.md');
+    }
+    // Ensure rules dir has a README
+    const rulesReadme = path.join(xDir, 'rules', 'README.md');
+    if (!(await fileExists(rulesReadme))) {
+        await fs.writeFile(rulesReadme, `# Rules
+
+Place \`.md\` rule files here. Each rule supports optional frontmatter:
+
+\`\`\`yaml
+---
+alwaysApply: true          # Always load into context
+paths: ["src/**/*.ts"]     # Load when matching files are active
+description: "..."         # Listed for agent to request on demand
+---
+\`\`\`
+
+Rules without frontmatter can be loaded manually via \`@rule-name\` in chat.
+`, 'utf-8');
+        createdFiles.push('.x-code/rules/README.md');
+    }
+    if (createdFiles.includes('.x-code/knowledge.md')) {
+        createdFiles.push('.x-code/memory/auto.md');
+    }
+    return { detectedFacts, createdFiles };
+}
+function generateKnowledgeMd(facts) {
+    const lines = [
+        '# Project Knowledge',
+        '',
+        '<!-- Auto-generated by xc init. Feel free to edit and add business context. -->',
+        '',
+    ];
+    const byCategory = new Map();
+    for (const f of facts) {
+        const list = byCategory.get(f.category) ?? [];
+        list.push({ key: f.key, fact: f.fact });
+        byCategory.set(f.category, list);
+    }
+    for (const [category, items] of byCategory) {
+        lines.push(`## ${category}`);
+        for (const item of items) {
+            lines.push(`- **${item.key}**: ${item.fact}`);
+        }
+        lines.push('');
+    }
+    lines.push('## Business Context', '', '<!-- Describe your project purpose, domain, and any important conventions here. -->', '');
+    return lines.join('\n');
+}
+//# sourceMappingURL=init.js.map

package/dist/knowledge/init.js.map

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

package/dist/knowledge/loader.d.ts

@@ -0,0 +1,14 @@
+import type { RuleFile } from '../types/index.js';
+/** Load all rule files from .x-code/rules/ */
+declare function loadRuleFiles(): Promise<RuleFile[]>;
+/** Check if a file path matches any of the glob patterns (simple matching) */
+declare function matchesPath(filePath: string, patterns: string[]): boolean;
+/** Build the full knowledge context for system prompt injection */
+export declare function buildKnowledgeContext(options?: {
+    activeFilePaths?: string[];
+    sessionContext?: string;
+    /** Pre-loaded rules to avoid redundant disk reads */
+    rules?: RuleFile[];
+}): Promise<string>;
+export { loadRuleFiles, matchesPath };
+//# sourceMappingURL=loader.d.ts.map

package/dist/knowledge/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/knowledge/loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,mBAAmB,CAAA;AA+BlE,8CAA8C;AAC9C,iBAAe,aAAa,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAelD;AAED,8EAA8E;AAC9E,iBAAS,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAUlE;AAED,mEAAmE;AACnE,wBAAsB,qBAAqB,CAAC,OAAO,CAAC,EAAE;IACpD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,qDAAqD;IACrD,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAA;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuElB;AAED,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,CAAA"}

package/dist/knowledge/loader.js

@@ -0,0 +1,130 @@
+// @x-code/core — Knowledge loader (layered loading + 4 rule loading modes)
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { XCODE_DIR, readFileSafe } from '../utils.js';
+import { getAutoMemory } from './auto-memory.js';
+const GLOBAL_DIR = path.join(os.homedir(), '.xcode');
+/** Parse frontmatter from a markdown rule file */
+function parseFrontmatter(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    if (!match)
+        return { frontmatter: {}, body: content };
+    const frontmatter = {};
+    const yamlLines = match[1].split('\n');
+    for (const line of yamlLines) {
+        const kvMatch = line.match(/^(\w+):\s*(.+)$/);
+        if (!kvMatch)
+            continue;
+        const [, key, value] = kvMatch;
+        if (key === 'alwaysApply')
+            frontmatter.alwaysApply = value.trim() === 'true';
+        else if (key === 'description')
+            frontmatter.description = value.trim().replace(/^"(.*)"$/, '$1');
+        else if (key === 'paths') {
+            // Parse YAML array: ["glob1", "glob2"]
+            const arrayMatch = value.match(/\[(.+)\]/);
+            if (arrayMatch) {
+                frontmatter.paths = arrayMatch[1].split(',').map((p) => p.trim().replace(/^"(.*)"$/, '$1'));
+            }
+        }
+    }
+    return { frontmatter, body: match[2] };
+}
+/** Load all rule files from .x-code/rules/ */
+async function loadRuleFiles() {
+    const rulesDir = path.join(process.cwd(), XCODE_DIR, 'rules');
+    try {
+        const files = await fs.readdir(rulesDir);
+        const rules = [];
+        for (const file of files) {
+            if (!file.endsWith('.md'))
+                continue;
+            const content = await readFileSafe(path.join(rulesDir, file));
+            const { frontmatter, body } = parseFrontmatter(content);
+            rules.push({ filename: file.replace('.md', ''), frontmatter, content: body });
+        }
+        return rules;
+    }
+    catch {
+        return [];
+    }
+}
+/** Check if a file path matches any of the glob patterns (simple matching) */
+function matchesPath(filePath, patterns) {
+    for (const pattern of patterns) {
+        // Simple glob matching: ** matches any path segment, * matches within segment
+        const regex = pattern
+            .replace(/\*\*/g, '___DOUBLESTAR___')
+            .replace(/\*/g, '[^/]*')
+            .replace(/___DOUBLESTAR___/g, '.*');
+        if (new RegExp(regex).test(filePath))
+            return true;
+    }
+    return false;
+}
+/** Build the full knowledge context for system prompt injection */
+export async function buildKnowledgeContext(options) {
+    const sections = [];
+    // 1. Global preferences
+    const globalKnowledge = await readFileSafe(path.join(GLOBAL_DIR, 'knowledge.md'));
+    if (globalKnowledge) {
+        sections.push('### Global Preferences\n' + globalKnowledge);
+    }
+    // 2. Global auto memory
+    const globalMemory = getAutoMemory('global');
+    const globalMemoryContent = globalMemory.getPromptContent();
+    if (globalMemoryContent) {
+        sections.push('### Global Auto Memory\n' + globalMemoryContent);
+    }
+    // 3. Project knowledge
+    const projectKnowledge = await readFileSafe(path.join(process.cwd(), XCODE_DIR, 'knowledge.md'));
+    if (projectKnowledge) {
+        sections.push('### Project Knowledge\n' + projectKnowledge);
+    }
+    // 4. Project auto memory
+    const projectMemory = getAutoMemory('project');
+    const projectMemoryContent = projectMemory.getPromptContent();
+    if (projectMemoryContent) {
+        sections.push('### Project Auto Memory\n' + projectMemoryContent);
+    }
+    // 5. Local preferences
+    const localPrefs = await readFileSafe(path.join(process.cwd(), XCODE_DIR, 'local', 'preferences.md'));
+    if (localPrefs) {
+        sections.push('### Local Preferences\n' + localPrefs);
+    }
+    // 6. Rules (4 loading modes)
+    const rules = options?.rules ?? (await loadRuleFiles());
+    // Always rules
+    for (const rule of rules) {
+        if (rule.frontmatter.alwaysApply) {
+            sections.push(`### Rule: ${rule.filename}\n${rule.content}`);
+        }
+    }
+    // Path-match rules
+    if (options?.activeFilePaths?.length) {
+        for (const rule of rules) {
+            if (rule.frontmatter.paths?.length) {
+                const matched = options.activeFilePaths.some((fp) => matchesPath(fp, rule.frontmatter.paths));
+                if (matched) {
+                    sections.push(`### Rule: ${rule.filename}\n${rule.content}`);
+                }
+            }
+        }
+    }
+    // Agent-requested rules: just list descriptions so model can request
+    const requestableRules = rules.filter((r) => r.frontmatter.description && !r.frontmatter.alwaysApply);
+    if (requestableRules.length > 0) {
+        const list = requestableRules.map((r) => `- @${r.filename}: ${r.frontmatter.description}`).join('\n');
+        sections.push(`### Available Rules (mention @name to load)\n${list}`);
+    }
+    // 7. Session context
+    if (options?.sessionContext) {
+        sections.push(options.sessionContext);
+    }
+    if (sections.length === 0)
+        return '';
+    return '## Project Knowledge\n\n' + sections.join('\n\n');
+}
+export { loadRuleFiles, matchesPath };
+//# sourceMappingURL=loader.js.map

package/dist/knowledge/loader.js.map

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

package/dist/knowledge/session.d.ts

@@ -0,0 +1,11 @@
+import type { LanguageModel, ModelMessage } from 'ai';
+import type { SessionSummary } from '../types/index.js';
+/** Load the most recent session summary */
+export declare function loadLatestSession(): Promise<SessionSummary | null>;
+/** Save a session summary */
+export declare function saveSessionSummary(summary: SessionSummary): Promise<void>;
+/** Generate a session summary from messages using the model */
+export declare function generateSessionSummary(messages: ModelMessage[], model: LanguageModel, sessionId: string, startedAt: string, filesModified: string[]): Promise<SessionSummary>;
+/** Format session summary for system prompt injection */
+export declare function formatSessionForPrompt(session: SessionSummary): string;
+//# sourceMappingURL=session.d.ts.map

package/dist/knowledge/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/knowledge/session.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,IAAI,CAAA;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAevD,2CAA2C;AAC3C,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAOxE;AAED,6BAA6B;AAC7B,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ/E;AAED,+DAA+D;AAC/D,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,YAAY,EAAE,EACxB,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EAAE,GACtB,OAAO,CAAC,cAAc,CAAC,CAgDzB;AAED,yDAAyD;AACzD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAoBtE"}

package/dist/knowledge/session.js

@@ -0,0 +1,108 @@
+// @x-code/core — Session memory (structured JSON summaries for cross-session continuation)
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { generateText } from 'ai';
+import { XCODE_DIR } from '../utils.js';
+const SESSIONS_DIR = `${XCODE_DIR}/sessions`;
+/** Number of recent messages to include when generating session summaries */
+const SESSION_SUMMARY_MESSAGE_COUNT = 20;
+function getSessionsDir() {
+    return path.join(process.cwd(), SESSIONS_DIR);
+}
+function getLatestPath() {
+    return path.join(getSessionsDir(), 'latest.json');
+}
+/** Load the most recent session summary */
+export async function loadLatestSession() {
+    try {
+        const raw = await fs.readFile(getLatestPath(), 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/** Save a session summary */
+export async function saveSessionSummary(summary) {
+    const dir = getSessionsDir();
+    await fs.mkdir(dir, { recursive: true });
+    await fs.writeFile(getLatestPath(), JSON.stringify(summary, null, 2), 'utf-8');
+    const archivePath = path.join(dir, `${summary.id}.json`);
+    await fs.writeFile(archivePath, JSON.stringify(summary, null, 2), 'utf-8');
+}
+/** Generate a session summary from messages using the model */
+export async function generateSessionSummary(messages, model, sessionId, startedAt, filesModified) {
+    const { text } = await generateText({
+        model,
+        messages: [
+            {
+                role: 'system',
+                content: `Summarize this conversation as a structured JSON object with these fields:
+- title: short descriptive title (string)
+- summary: 2-3 sentence overview (string)
+- keyResults: what was accomplished (string[])
+- pendingWork: what remains to be done (string[])
+- decisions: important decisions made (string[])
+- status: "completed" | "in_progress" | "abandoned"
+
+Return ONLY valid JSON, no markdown fencing.`,
+            },
+            ...messages.slice(-SESSION_SUMMARY_MESSAGE_COUNT),
+        ],
+    });
+    try {
+        const parsed = JSON.parse(text);
+        return {
+            id: sessionId,
+            startedAt,
+            endedAt: new Date().toISOString(),
+            filesModified,
+            title: parsed.title ?? 'Untitled session',
+            summary: parsed.summary ?? '',
+            keyResults: parsed.keyResults ?? [],
+            pendingWork: parsed.pendingWork ?? [],
+            decisions: parsed.decisions ?? [],
+            status: parsed.status ?? 'completed',
+        };
+    }
+    catch {
+        return {
+            id: sessionId,
+            startedAt,
+            endedAt: new Date().toISOString(),
+            title: 'Session',
+            summary: text.slice(0, 200),
+            keyResults: [],
+            pendingWork: [],
+            filesModified,
+            decisions: [],
+            status: 'completed',
+        };
+    }
+}
+/** Format session summary for system prompt injection */
+export function formatSessionForPrompt(session) {
+    const lines = [
+        `### Previous Session`,
+        `Title: ${session.title}`,
+        `Status: ${session.status}`,
+        `Summary: ${session.summary}`,
+    ];
+    if (session.keyResults.length > 0) {
+        lines.push('Key results:');
+        for (const r of session.keyResults)
+            lines.push(`- ${r}`);
+    }
+    if (session.pendingWork.length > 0) {
+        lines.push('Pending work:');
+        for (const w of session.pendingWork)
+            lines.push(`- ${w}`);
+    }
+    if (session.decisions.length > 0) {
+        lines.push('Decisions:');
+        for (const d of session.decisions)
+            lines.push(`- ${d}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=session.js.map

package/dist/knowledge/session.js.map

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

package/dist/permissions/index.d.ts

@@ -0,0 +1,14 @@
+import type { PermissionLevel } from '../types/index.js';
+type PermissionInput = Record<string, unknown>;
+/** Get permission level for a tool call */
+export declare function getPermissionLevel(toolName: string, input: PermissionInput): PermissionLevel;
+/** Check permission with trust mode support */
+export declare function checkPermission(toolCall: {
+    toolName: string;
+    input: PermissionInput;
+}, trustMode: boolean, onAskPermission: (toolCall: {
+    toolName: string;
+    input: PermissionInput;
+}) => Promise<boolean>): Promise<boolean>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/permissions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/permissions/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AA6B9C,2CAA2C;AAC3C,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,eAAe,CAI5F;AAED,+CAA+C;AAC/C,wBAAsB,eAAe,CACnC,QAAQ,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,EACtD,SAAS,EAAE,OAAO,EAClB,eAAe,EAAE,CAAC,QAAQ,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,KAAK,OAAO,CAAC,OAAO,CAAC,GAC5F,OAAO,CAAC,OAAO,CAAC,CAKlB"}

package/dist/permissions/index.js

@@ -0,0 +1,46 @@
+// @x-code/core — Permission system (3-level model)
+import { isDestructive, isReadOnly, splitShellCommands } from '../tools/shell-utils.js';
+/** Permission rules for each tool */
+const rules = {
+    readFile: () => 'always-allow',
+    glob: () => 'always-allow',
+    grep: () => 'always-allow',
+    listDir: () => 'always-allow',
+    webSearch: () => 'always-allow',
+    webFetch: () => 'always-allow',
+    askUser: () => 'always-allow',
+    saveKnowledge: () => 'always-allow',
+    edit: () => 'ask',
+    writeFile: () => 'ask',
+    enterPlanMode: () => 'always-allow',
+    exitPlanMode: () => 'always-allow',
+    shell: (input) => {
+        const cmd = input.command ?? '';
+        const subCommands = splitShellCommands(cmd);
+        // Any sub-command destructive → deny the whole command
+        if (subCommands.some(isDestructive))
+            return 'deny';
+        // All sub-commands read-only → auto-allow
+        if (subCommands.every(isReadOnly))
+            return 'always-allow';
+        // Otherwise → ask
+        return 'ask';
+    },
+};
+/** Get permission level for a tool call */
+export function getPermissionLevel(toolName, input) {
+    const rule = rules[toolName];
+    if (!rule)
+        return 'ask'; // Unknown tool defaults to ask
+    return rule(input);
+}
+/** Check permission with trust mode support */
+export async function checkPermission(toolCall, trustMode, onAskPermission) {
+    const level = getPermissionLevel(toolCall.toolName, toolCall.input);
+    if (level === 'deny')
+        return false;
+    if (level === 'always-allow' || trustMode)
+        return true;
+    return onAskPermission(toolCall);
+}
+//# sourceMappingURL=index.js.map

package/dist/permissions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/permissions/index.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAKvF,qCAAqC;AACrC,MAAM,KAAK,GAAgE;IACzE,QAAQ,EAAE,GAAG,EAAE,CAAC,cAAc;IAC9B,IAAI,EAAE,GAAG,EAAE,CAAC,cAAc;IAC1B,IAAI,EAAE,GAAG,EAAE,CAAC,cAAc;IAC1B,OAAO,EAAE,GAAG,EAAE,CAAC,cAAc;IAC7B,SAAS,EAAE,GAAG,EAAE,CAAC,cAAc;IAC/B,QAAQ,EAAE,GAAG,EAAE,CAAC,cAAc;IAC9B,OAAO,EAAE,GAAG,EAAE,CAAC,cAAc;IAC7B,aAAa,EAAE,GAAG,EAAE,CAAC,cAAc;IACnC,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK;IACjB,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK;IACtB,aAAa,EAAE,GAAG,EAAE,CAAC,cAAc;IACnC,YAAY,EAAE,GAAG,EAAE,CAAC,cAAc;IAClC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE;QACf,MAAM,GAAG,GAAI,KAAK,CAAC,OAAkB,IAAI,EAAE,CAAA;QAC3C,MAAM,WAAW,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAA;QAE3C,uDAAuD;QACvD,IAAI,WAAW,CAAC,IAAI,CAAC,aAAa,CAAC;YAAE,OAAO,MAAM,CAAA;QAClD,0CAA0C;QAC1C,IAAI,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC;YAAE,OAAO,cAAc,CAAA;QACxD,kBAAkB;QAClB,OAAO,KAAK,CAAA;IACd,CAAC;CACF,CAAA;AAED,2CAA2C;AAC3C,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,KAAsB;IACzE,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAA;IAC5B,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAA,CAAC,+BAA+B;IACvD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAA;AACpB,CAAC;AAED,+CAA+C;AAC/C,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAsD,EACtD,SAAkB,EAClB,eAA6F;IAE7F,MAAM,KAAK,GAAG,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAA;IACnE,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,KAAK,CAAA;IAClC,IAAI,KAAK,KAAK,cAAc,IAAI,SAAS;QAAE,OAAO,IAAI,CAAA;IACtD,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAA;AAClC,CAAC"}

package/dist/providers/registry.d.ts

@@ -0,0 +1,2 @@
+export declare function createModelRegistry(): import("ai").ProviderRegistryProvider<Record<string, any>, ":">;
+//# sourceMappingURL=registry.d.ts.map

package/dist/providers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAeA,wBAAgB,mBAAmB,oEA4BlC"}

package/dist/providers/registry.js

@@ -0,0 +1,46 @@
+// @x-code/core — AI SDK Provider Registry (multi-model support)
+import { zhipu } from 'zhipu-ai-provider';
+import { createAlibaba } from '@ai-sdk/alibaba';
+import { anthropic } from '@ai-sdk/anthropic';
+import { deepseek } from '@ai-sdk/deepseek';
+import { google } from '@ai-sdk/google';
+import { moonshotai } from '@ai-sdk/moonshotai';
+import { createOpenAI } from '@ai-sdk/openai';
+import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
+import { xai } from '@ai-sdk/xai';
+import { createProviderRegistry } from 'ai';
+import { getProviderOptions } from '../config/index.js';
+export function createModelRegistry() {
+    const opts = getProviderOptions();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const providers = {};
+    if (opts.anthropic)
+        providers.anthropic = anthropic;
+    if (opts.openai)
+        providers.openai = createOpenAI();
+    if (opts.google)
+        providers.google = google;
+    if (opts.xai)
+        providers.xai = xai;
+    if (opts.deepseek)
+        providers.deepseek = deepseek;
+    if (opts.alibaba) {
+        providers.alibaba = createAlibaba({
+            baseURL: 'https://dashscope.aliyuncs.com/compatible-mode/v1',
+        });
+    }
+    if (opts.zhipu)
+        providers.zhipu = zhipu;
+    if (opts.moonshotai)
+        providers.moonshotai = moonshotai;
+    // Custom OpenAI compatible provider
+    if (opts.custom.apiKey && opts.custom.baseURL) {
+        providers.custom = createOpenAICompatible({
+            name: 'custom',
+            apiKey: opts.custom.apiKey,
+            baseURL: opts.custom.baseURL,
+        });
+    }
+    return createProviderRegistry(providers);
+}
+//# sourceMappingURL=registry.js.map

package/dist/providers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AAClE,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AACjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,IAAI,CAAA;AAE3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAEvD,MAAM,UAAU,mBAAmB;IACjC,MAAM,IAAI,GAAG,kBAAkB,EAAE,CAAA;IACjC,8DAA8D;IAC9D,MAAM,SAAS,GAAwB,EAAE,CAAA;IAEzC,IAAI,IAAI,CAAC,SAAS;QAAE,SAAS,CAAC,SAAS,GAAG,SAAS,CAAA;IACnD,IAAI,IAAI,CAAC,MAAM;QAAE,SAAS,CAAC,MAAM,GAAG,YAAY,EAAE,CAAA;IAClD,IAAI,IAAI,CAAC,MAAM;QAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAA;IAC1C,IAAI,IAAI,CAAC,GAAG;QAAE,SAAS,CAAC,GAAG,GAAG,GAAG,CAAA;IACjC,IAAI,IAAI,CAAC,QAAQ;QAAE,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAChD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,SAAS,CAAC,OAAO,GAAG,aAAa,CAAC;YAChC,OAAO,EAAE,mDAAmD;SAC7D,CAAC,CAAA;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,KAAK;QAAE,SAAS,CAAC,KAAK,GAAG,KAAK,CAAA;IACvC,IAAI,IAAI,CAAC,UAAU;QAAE,SAAS,CAAC,UAAU,GAAG,UAAU,CAAA;IAEtD,oCAAoC;IACpC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC9C,SAAS,CAAC,MAAM,GAAG,sBAAsB,CAAC;YACxC,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC1B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;SAC7B,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,sBAAsB,CAAC,SAAS,CAAC,CAAA;AAC1C,CAAC"}

package/dist/tools/ask-user.d.ts

@@ -0,0 +1,8 @@
+export declare const askUser: import("ai").Tool<{
+    options: {
+        description: string;
+        label: string;
+    }[];
+    question: string;
+}, never>;
+//# sourceMappingURL=ask-user.d.ts.map

package/dist/tools/ask-user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user.d.ts","sourceRoot":"","sources":["../../src/tools/ask-user.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,OAAO;;;;;;SAiBlB,CAAA"}

package/dist/tools/ask-user.js

@@ -0,0 +1,19 @@
+// @x-code/core — askUser tool (interactive question, no execute — handled via callback)
+import { tool } from 'ai';
+import { z } from 'zod';
+export const askUser = tool({
+    description: 'Ask the user a clarifying question with multiple-choice options. Use when you need user input to decide between approaches.',
+    inputSchema: z.object({
+        question: z.string().describe('The question to ask'),
+        options: z
+            .array(z.object({
+            label: z.string().describe('Option label (1-5 words)'),
+            description: z.string().describe('What this option means'),
+        }))
+            .min(2)
+            .max(4)
+            .describe('Choices (an "Other" option is auto-appended)'),
+    }),
+    // No execute — through callback to trigger UI rendering
+});
+//# sourceMappingURL=ask-user.js.map

package/dist/tools/ask-user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user.js","sourceRoot":"","sources":["../../src/tools/ask-user.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAA;AAEzB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC;IAC1B,WAAW,EACT,6HAA6H;IAC/H,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;QACpD,OAAO,EAAE,CAAC;aACP,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;YACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;YACtD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;SAC3D,CAAC,CACH;aACA,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,8CAA8C,CAAC;KAC5D,CAAC;IACF,wDAAwD;CACzD,CAAC,CAAA"}

package/dist/tools/edit.d.ts

@@ -0,0 +1,7 @@
+export declare const edit: import("ai").Tool<{
+    filePath: string;
+    oldString: string;
+    newString: string;
+    replaceAll?: boolean | undefined;
+}, never>;
+//# sourceMappingURL=edit.d.ts.map

package/dist/tools/edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../src/tools/edit.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,IAAI;;;;;SAUf,CAAA"}

package/dist/tools/edit.js

@@ -0,0 +1,14 @@
+// @x-code/core — edit tool (precise string replacement, no execute — needs permission check)
+import { tool } from 'ai';
+import { z } from 'zod';
+export const edit = tool({
+    description: 'Replace a specific string in a file. The old_string must be unique in the file. Preferred over writeFile for modifications — safer and costs fewer tokens.',
+    inputSchema: z.object({
+        filePath: z.string().describe('Absolute path to the file'),
+        oldString: z.string().describe('The exact text to find and replace (must be unique in the file)'),
+        newString: z.string().describe('The replacement text'),
+        replaceAll: z.boolean().optional().describe('Replace all occurrences (default: false)'),
+    }),
+    // No execute — handled manually in agent loop for permission check
+});
+//# sourceMappingURL=edit.js.map

package/dist/tools/edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.js","sourceRoot":"","sources":["../../src/tools/edit.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAA;AAEzB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC;IACvB,WAAW,EACT,4JAA4J;IAC9J,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QAC1D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iEAAiE,CAAC;QACjG,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACtD,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;KACxF,CAAC;IACF,mEAAmE;CACpE,CAAC,CAAA"}

package/dist/tools/enter-plan-mode.d.ts

@@ -0,0 +1,2 @@
+export declare const enterPlanMode: import("ai").Tool<{}, never>;
+//# sourceMappingURL=enter-plan-mode.d.ts.map

package/dist/tools/enter-plan-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enter-plan-mode.d.ts","sourceRoot":"","sources":["../../src/tools/enter-plan-mode.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,aAAa,8BAMxB,CAAA"}

package/dist/tools/enter-plan-mode.js

@@ -0,0 +1,11 @@
+// @x-code/core — enterPlanMode tool (no execute — handled in agent loop)
+import { tool } from 'ai';
+import { z } from 'zod';
+export const enterPlanMode = tool({
+    description: `Enter plan mode for exploring the codebase and designing an implementation plan.
+Use proactively for non-trivial tasks: new features, multi-file changes, architectural decisions, unclear requirements.
+Skip for: single-line fixes, obvious bugs, specific user instructions.`,
+    inputSchema: z.object({}),
+    // No execute — handled in agent loop (inject plan mode prompt + wait for user consent)
+});
+//# sourceMappingURL=enter-plan-mode.js.map