@nexrall/code-core 1.4.46 → 1.4.47

package/dist/plugins/installer.d.ts

@@ -86,6 +86,53 @@ export declare function parsePluginSource(spec: string): PluginSource;
  * containing no MCP servers.
  */
 export declare function inspectPluginDir(dir: string): PluginInspection;
+export interface PluginComponentSummary {
+    name: string;
+    description: string;
+}
+export interface PluginMcpServerSummary {
+    name: string;
+    /** Transport, best-effort from the raw config shape (mirrors McpServerConfig in mcp/client.ts). */
+    type: 'stdio' | 'http' | 'sse';
+    /** Short human-readable summary of how this server connects (command, or URL host). */
+    summary: string;
+}
+export interface PluginComponentDetail {
+    commands: PluginComponentSummary[];
+    skills: PluginComponentSummary[];
+    agents: PluginComponentSummary[];
+    mcpServers: PluginMcpServerSummary[];
+    hasHooks: boolean;
+}
+/**
+ * Full breakdown of what a plugin bundles — one skill/command/connector per
+ * row, each with the human-readable text a user needs to decide whether to
+ * use/connect it. Distinct from inspectPluginDir (which only reports COUNTS
+ * and booleans for the install-time safety warning): this is the read model
+ * for the "click a plugin to see what's inside" detail screen, most directly
+ * needed because a Connectors tab has to show each MCP server by NAME so a
+ * user can connect them one at a time, the same way Claude Cowork's plugin
+ * detail view does.
+ */
+export declare function pluginComponentDetail(dir: string): PluginComponentDetail;
+export interface PluginItemDetail extends PluginComponentSummary {
+    /** Full raw file contents, including frontmatter — what a "Raw" toggle / Copy button should use. */
+    raw: string;
+    /** Frontmatter-stripped body — what a "Preview" toggle should render as markdown. */
+    body: string;
+    /** Absolute path to the source file, for "Edit" (open in the user's default editor/file manager). */
+    filePath: string;
+}
+/**
+ * Full content of ONE skill/command/agent inside a plugin — the read model
+ * for "click a skill row to see its content", mirroring Claude Cowork's own
+ * per-skill screen (rendered preview, raw markdown toggle, copy button).
+ * Deliberately separate from pluginComponentDetail's summaries (name +
+ * description only): loading every item's full body up front for a plugin
+ * with many skills would be wasteful, so this is fetched lazily, one row at
+ * a time, only when the user actually opens it.
+ */
+export declare function pluginItemDetail(dir: string, kind: 'commands' | 'agents' | 'skills', name: string): PluginItemDetail | null;
 export interface InstallOptions {
     /** 'global' (default) → ~/.nexrall/plugins; 'project' → <workDir>/.nexrall/plugins */
     scope?: 'project' | 'global';

package/dist/plugins/installer.d.ts.map

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

package/dist/plugins/installer.js

@@ -38,6 +38,8 @@ exports.getRegistryPlugin = getRegistryPlugin;
 exports.reportInstall = reportInstall;
 exports.parsePluginSource = parsePluginSource;
 exports.inspectPluginDir = inspectPluginDir;
+exports.pluginComponentDetail = pluginComponentDetail;
+exports.pluginItemDetail = pluginItemDetail;
 exports.installPlugin = installPlugin;
 exports.readReceipt = readReceipt;
 exports.removePlugin = removePlugin;
@@ -49,6 +51,7 @@ const child_process_1 = require("child_process");
 const client_1 = require("../api/client");
 const index_1 = require("./index");
 const sources_1 = require("./sources");
+const frontmatter_1 = require("../util/frontmatter");
 const RECEIPT_FILE = '_install.json';
 /** Search the registry (empty query = list all, official first). */
 async function searchRegistry(query, limit = 50) {
@@ -169,6 +172,176 @@ function inspectPluginDir(dir) {
         meta,
     };
 }
+/** Read a flat `commands/*.md` or `agents/*.md` directory, returning name + frontmatter description. */
+function listMdWithDescription(dir) {
+    let files;
+    try {
+        files = fs.readdirSync(dir).filter((f) => f.endsWith('.md'));
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const file of files) {
+        const name = file.replace(/\.md$/, '');
+        try {
+            const raw = fs.readFileSync(path.join(dir, file), 'utf-8');
+            const { meta } = (0, frontmatter_1.parseFrontmatter)(raw);
+            out.push({ name, description: meta.description || '' });
+        }
+        catch {
+            out.push({ name, description: '' }); // malformed file — still list it, just without a description
+        }
+    }
+    return out;
+}
+/** Read `skills/<name>/SKILL.md` subdirectories, returning name + frontmatter description. */
+function listSkillsWithDescription(dir) {
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory() && !entry.isSymbolicLink())
+            continue;
+        const skillFile = path.join(dir, entry.name, 'SKILL.md');
+        try {
+            if (!fs.statSync(skillFile).isFile())
+                continue;
+            const raw = fs.readFileSync(skillFile, 'utf-8');
+            const { meta } = (0, frontmatter_1.parseFrontmatter)(raw);
+            out.push({ name: meta.name || entry.name, description: meta.description || '' });
+        }
+        catch {
+            /* not a valid skill directory — skip */
+        }
+    }
+    return out;
+}
+/** Best-effort transport + one-line summary for an mcp.json server entry, for display only (never executed). */
+function summariseMcpServer(name, cfg) {
+    const c = (cfg && typeof cfg === 'object' ? cfg : {});
+    const url = typeof c.url === 'string' ? c.url : undefined;
+    const command = typeof c.command === 'string' ? c.command : undefined;
+    const declaredType = c.type === 'http' || c.type === 'sse' || c.type === 'stdio' ? c.type : undefined;
+    const type = declaredType ?? (url ? 'http' : 'stdio');
+    let summary = 'Unknown connector configuration';
+    if (url) {
+        try {
+            summary = new URL(url).host;
+        }
+        catch {
+            summary = url;
+        }
+    }
+    else if (command) {
+        const args = Array.isArray(c.args) ? c.args.filter((a) => typeof a === 'string') : [];
+        summary = [command, ...args].join(' ');
+    }
+    return { name, type, summary };
+}
+/**
+ * Full breakdown of what a plugin bundles — one skill/command/connector per
+ * row, each with the human-readable text a user needs to decide whether to
+ * use/connect it. Distinct from inspectPluginDir (which only reports COUNTS
+ * and booleans for the install-time safety warning): this is the read model
+ * for the "click a plugin to see what's inside" detail screen, most directly
+ * needed because a Connectors tab has to show each MCP server by NAME so a
+ * user can connect them one at a time, the same way Claude Cowork's plugin
+ * detail view does.
+ */
+function pluginComponentDetail(dir) {
+    const mcpFile = (0, index_1.resolvePluginFile)(dir, 'mcp');
+    let mcpServers = [];
+    if (mcpFile) {
+        try {
+            const j = JSON.parse(fs.readFileSync(mcpFile, 'utf-8'));
+            const servers = (j.mcpServers ?? j);
+            mcpServers = Object.entries(servers).map(([name, cfg]) => summariseMcpServer(name, cfg));
+        }
+        catch {
+            /* malformed mcp.json — report no servers rather than throwing */
+        }
+    }
+    return {
+        commands: listMdWithDescription(path.join(dir, 'commands')),
+        skills: listSkillsWithDescription(path.join(dir, 'skills')),
+        agents: listMdWithDescription(path.join(dir, 'agents')),
+        mcpServers,
+        hasHooks: (0, index_1.resolvePluginFile)(dir, 'hooks') !== null,
+    };
+}
+/** Match a flat `commands/*.md` or `agents/*.md` file by its display name (never builds a path from `name` — only compares against real directory entries, so a caller cannot path-traverse via the name argument). */
+function readPluginItemFromFlatDir(dir, name) {
+    let files;
+    try {
+        files = fs.readdirSync(dir).filter((f) => f.endsWith('.md'));
+    }
+    catch {
+        return null;
+    }
+    for (const file of files) {
+        if (file.replace(/\.md$/, '') !== name)
+            continue;
+        const filePath = path.join(dir, file);
+        try {
+            const raw = fs.readFileSync(filePath, 'utf-8');
+            const { meta, body } = (0, frontmatter_1.parseFrontmatter)(raw);
+            return { name, description: meta.description || '', raw, body, filePath };
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+/** Match a `skills/<dir>/SKILL.md` by its effective name (meta.name override, or the directory name). */
+function readPluginSkill(skillsDir, name) {
+    let entries;
+    try {
+        entries = fs.readdirSync(skillsDir, { withFileTypes: true });
+    }
+    catch {
+        return null;
+    }
+    for (const entry of entries) {
+        if (!entry.isDirectory() && !entry.isSymbolicLink())
+            continue;
+        const skillFile = path.join(skillsDir, entry.name, 'SKILL.md');
+        try {
+            if (!fs.statSync(skillFile).isFile())
+                continue;
+            const raw = fs.readFileSync(skillFile, 'utf-8');
+            const { meta, body } = (0, frontmatter_1.parseFrontmatter)(raw);
+            const skillName = meta.name || entry.name;
+            if (skillName !== name)
+                continue;
+            return { name: skillName, description: meta.description || '', raw, body, filePath: skillFile };
+        }
+        catch {
+            /* unreadable/malformed — keep looking, don't fail the whole scan */
+        }
+    }
+    return null;
+}
+/**
+ * Full content of ONE skill/command/agent inside a plugin — the read model
+ * for "click a skill row to see its content", mirroring Claude Cowork's own
+ * per-skill screen (rendered preview, raw markdown toggle, copy button).
+ * Deliberately separate from pluginComponentDetail's summaries (name +
+ * description only): loading every item's full body up front for a plugin
+ * with many skills would be wasteful, so this is fetched lazily, one row at
+ * a time, only when the user actually opens it.
+ */
+function pluginItemDetail(dir, kind, name) {
+    if (kind === 'skills')
+        return readPluginSkill(path.join(dir, 'skills'), name);
+    return readPluginItemFromFlatDir(path.join(dir, kind), name);
+}
 /** Is this directory a plausible plugin root? */
 function looksLikePlugin(dir) {
     const i = inspectPluginDir(dir);

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

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/tools/executor.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAyB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAg3EtE,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,WAAW,CAAC,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,EAClC,OAAO,CAAC,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GACjC,OAAO,CAAC,UAAU,CAAC,CA6BrB"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/tools/executor.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAyB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AA8kFtE,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,WAAW,CAAC,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,EAClC,OAAO,CAAC,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GACjC,OAAO,CAAC,UAAU,CAAC,CA6BrB"}

package/dist/tools/executor.js

@@ -442,6 +442,187 @@ async function writeFile(input, workDir) {
         return { error: err.message };
     }
 }
+// ─── Office document tools (write_docx / write_xlsx / write_pptx) ─────────────
+//
+// Mirrors how Claude Cowork actually does this (per Anthropic's own docs):
+// generate the real OOXML binary via code, not a chat "artifact" preview.
+// Word/Excel/PowerPoint files ARE zip archives of XML under the hood — these
+// tools just drive the `docx`/`exceljs`/`pptxgenjs` libraries that build that
+// XML correctly, so a real .docx/.xlsx/.pptx lands on disk that Word/Excel/
+// PowerPoint (or LibreOffice) opens normally. The model is given a simplified
+// JSON content shape (paragraphs / sheets+rows / slides) rather than being
+// asked to write library calls itself — smaller, more reliable tool calls,
+// and it keeps these tools usable by models with no library-specific training.
+//
+// atomicWrite() (temp+rename) is NOT reused here — these libraries write
+// binary buffers via their own `.save()`/`.writeFile()` APIs rather than a
+// string this module already has in memory, so each tool does its own
+// write-to-temp-then-rename to get the same crash-safety property.
+function atomicWriteBuffer(resolved, data) {
+    const dir = path.dirname(resolved);
+    fs.mkdirSync(dir, { recursive: true });
+    const tmp = path.join(dir, `.${path.basename(resolved)}.nexrall-tmp-${process.pid}-${Date.now()}`);
+    fs.writeFileSync(tmp, data);
+    fs.renameSync(tmp, resolved);
+}
+async function writeDocx(input, workDir) {
+    const filePath = typeof input.path === 'string' ? input.path : '';
+    if (!filePath)
+        return { error: 'Missing required parameter: path' };
+    const title = typeof input.title === 'string' ? input.title : undefined;
+    const paragraphsRaw = input.paragraphs;
+    if (!Array.isArray(paragraphsRaw) || paragraphsRaw.length === 0) {
+        return { error: 'Missing or empty required parameter: paragraphs (array of { text, heading?, bold?, italic?, bullet?, align? })' };
+    }
+    try {
+        // Loaded lazily so the (fairly large) docx/exceljs/pptxgenjs bundles only
+        // ever get pulled into memory for a session that actually uses them —
+        // most agent sessions never touch Office files at all.
+        const { Document, Packer, Paragraph, TextRun, HeadingLevel, AlignmentType, } = await Promise.resolve().then(() => __importStar(require('docx')));
+        const headingMap = {
+            1: HeadingLevel.HEADING_1, 2: HeadingLevel.HEADING_2,
+            3: HeadingLevel.HEADING_3, 4: HeadingLevel.HEADING_4,
+        };
+        const alignMap = {
+            left: AlignmentType.LEFT, center: AlignmentType.CENTER,
+            right: AlignmentType.RIGHT, justify: AlignmentType.JUSTIFIED,
+        };
+        const children = [];
+        if (title) {
+            children.push(new Paragraph({ text: title, heading: HeadingLevel.TITLE }));
+        }
+        for (const raw of paragraphsRaw) {
+            if (!raw || typeof raw.text !== 'string')
+                continue;
+            children.push(new Paragraph({
+                heading: raw.heading ? headingMap[raw.heading] : undefined,
+                bullet: raw.bullet ? { level: 0 } : undefined,
+                alignment: raw.align ? alignMap[raw.align] : undefined,
+                children: [new TextRun({ text: raw.text, bold: raw.bold, italics: raw.italic })],
+            }));
+        }
+        const doc = new Document({ sections: [{ children }] });
+        const buffer = await Packer.toBuffer(doc);
+        const resolved = resolvePath(filePath, workDir);
+        const isNew = !fs.existsSync(resolved);
+        atomicWriteBuffer(resolved, buffer);
+        return { output: `${isNew ? 'Created' : 'Overwrote'} ${resolved} (${paragraphsRaw.length} paragraph(s), ${buffer.length} bytes)` };
+    }
+    catch (err) {
+        return { error: `Failed to write .docx: ${err.message}` };
+    }
+}
+async function writeXlsx(input, workDir) {
+    const filePath = typeof input.path === 'string' ? input.path : '';
+    if (!filePath)
+        return { error: 'Missing required parameter: path' };
+    const sheetsRaw = input.sheets;
+    if (!Array.isArray(sheetsRaw) || sheetsRaw.length === 0) {
+        return { error: 'Missing or empty required parameter: sheets (array of { name?, columns?, rows })' };
+    }
+    // mode: 'edit' loads the EXISTING workbook first (so other sheets, styles,
+    // and formulas already in the file survive) instead of always starting
+    // from a blank workbook — this is what makes "sửa file Excel có sẵn" work
+    // rather than only ever creating brand-new files.
+    const mode = input.mode === 'edit' ? 'edit' : 'create';
+    try {
+        const ExcelJS = await Promise.resolve().then(() => __importStar(require('exceljs')));
+        const resolved = resolvePath(filePath, workDir);
+        const isNew = !fs.existsSync(resolved);
+        const workbook = new ExcelJS.Workbook();
+        if (mode === 'edit' && !isNew) {
+            try {
+                await workbook.xlsx.readFile(resolved);
+            }
+            catch (err) {
+                return { error: `mode: 'edit' but could not read existing workbook at ${resolved}: ${err.message}` };
+            }
+        }
+        else if (mode === 'edit' && isNew) {
+            return { error: `mode: 'edit' but ${resolved} does not exist yet — use mode: 'create' (or omit mode) for a new file.` };
+        }
+        let sheetsTouched = 0;
+        for (const raw of sheetsRaw) {
+            const name = raw?.name || `Sheet${sheetsTouched + 1}`;
+            let sheet = workbook.getWorksheet(name);
+            if (sheet && mode === 'edit') {
+                // Editing an existing sheet in place: remove and recreate it so
+                // re-running the same tool call REPLACES its data instead of
+                // appending duplicate rows below whatever was already there —
+                // matches write_file's "full replace" semantics for a sheet's data,
+                // while sibling sheets and workbook-level state readFile() already
+                // loaded are untouched. (sheet.spliceRows(1, rowCount) looks like the
+                // obvious way to clear a sheet in place, but empirically does NOT
+                // remove existing rows in exceljs 4.4.0 — verified with a minimal
+                // repro before choosing this remove+recreate approach instead.)
+                //
+                // Trade-off: the recreated sheet is appended at the end of the
+                // workbook's tab order rather than kept in its original position —
+                // acceptable since sheet DATA correctness matters far more than tab
+                // order for an agent-generated edit, and exceljs has no public API
+                // to reinsert a worksheet at an arbitrary index.
+                workbook.removeWorksheet(sheet.id);
+                sheet = workbook.addWorksheet(name);
+            }
+            else if (!sheet) {
+                sheet = workbook.addWorksheet(name);
+            }
+            if (Array.isArray(raw?.columns) && raw.columns.length) {
+                sheet.columns = raw.columns.map((c) => ({ header: c.header, key: c.key, width: c.width }));
+            }
+            if (Array.isArray(raw?.rows)) {
+                for (const row of raw.rows)
+                    sheet.addRow(row);
+            }
+            sheetsTouched++;
+        }
+        const buffer = await workbook.xlsx.writeBuffer();
+        atomicWriteBuffer(resolved, Buffer.from(buffer));
+        return {
+            output: `${isNew ? 'Created' : mode === 'edit' ? 'Updated' : 'Overwrote'} ${resolved} (${sheetsTouched} sheet(s), ${buffer.byteLength} bytes)`,
+        };
+    }
+    catch (err) {
+        return { error: `Failed to write .xlsx: ${err.message}` };
+    }
+}
+async function writePptx(input, workDir) {
+    const filePath = typeof input.path === 'string' ? input.path : '';
+    if (!filePath)
+        return { error: 'Missing required parameter: path' };
+    const slidesRaw = input.slides;
+    if (!Array.isArray(slidesRaw) || slidesRaw.length === 0) {
+        return { error: 'Missing or empty required parameter: slides (array of { title?, bullets?, notes? })' };
+    }
+    try {
+        const PptxGenJSModule = await Promise.resolve().then(() => __importStar(require('pptxgenjs')));
+        const PptxGenJS = PptxGenJSModule.default;
+        const pres = new PptxGenJS();
+        for (const raw of slidesRaw) {
+            const slide = pres.addSlide();
+            if (raw?.title) {
+                slide.addText(raw.title, { x: 0.5, y: 0.3, w: '90%', h: 1, fontSize: 28, bold: true });
+            }
+            if (Array.isArray(raw?.bullets) && raw.bullets.length) {
+                slide.addText(raw.bullets.map((b) => ({ text: b, options: { bullet: true, breakLine: true } })), { x: 0.5, y: 1.5, w: '90%', h: '70%', fontSize: 18 });
+            }
+            if (raw?.notes)
+                slide.addNotes(raw.notes);
+        }
+        const resolved = resolvePath(filePath, workDir);
+        const isNew = !fs.existsSync(resolved);
+        fs.mkdirSync(path.dirname(resolved), { recursive: true });
+        // pptxgenjs writes to disk itself (no in-memory buffer API for Node the
+        // way docx/exceljs offer) — 'nodebuffer' gets us the buffer instead so we
+        // can still go through the same atomic temp+rename write as the other two.
+        const buffer = (await pres.write({ outputType: 'nodebuffer' }));
+        atomicWriteBuffer(resolved, buffer);
+        return { output: `${isNew ? 'Created' : 'Overwrote'} ${resolved} (${slidesRaw.length} slide(s), ${buffer.length} bytes)` };
+    }
+    catch (err) {
+        return { error: `Failed to write .pptx: ${err.message}` };
+    }
+}
 async function listDirectory(input, workDir) {
     const dirPath = typeof input.path === 'string' ? input.path : '.';
     try {
@@ -2360,20 +2541,26 @@ async function memoryWrite(input, workDir) {
     if (!content)
         return { error: 'content is required' };
     const scope = memoryScopeOf(input);
-    const r = await (0, memory_1.writeMemory)(content, scope, workDir);
+    const supersedes = typeof input.supersedes === 'string' ? input.supersedes.trim() : undefined;
+    const source = typeof input.source === 'string' ? input.source.trim() : undefined;
+    const r = await (0, memory_1.writeMemory)(content, scope, workDir, { supersedes, source });
     if (!r.ok)
         return { error: 'failed to save memory' };
-    return { output: r.already ? `Memory already recorded (skipped duplicate): ${content}` : `Memory saved (${scope}): ${content}` };
+    if (r.already)
+        return { output: `Memory already recorded (skipped duplicate): ${content}` };
+    const supersedeNote = r.superseded ? ' (older fact moved to Superseded)' : '';
+    return { output: `Memory saved (${scope}): ${content}${supersedeNote}` };
 }
 async function memoryRead(input, workDir) {
     try {
+        const includeArchived = input?.include_archived === true;
         // No explicit scope requested → merge both (what the model actually needs
         // when re-orienting mid-conversation); an explicit scope narrows to just that file.
         if (input && (input.scope === 'project' || input.scope === 'global')) {
-            const mem = (0, memory_1.readMemory)(input.scope, workDir);
+            const mem = (0, memory_1.readMemory)(input.scope, workDir, { includeArchived });
             return { output: mem || 'No memories saved yet.' };
         }
-        const mem = (0, memory_1.readAllMemory)(workDir);
+        const mem = (0, memory_1.readAllMemory)(workDir, { includeArchived });
         return { output: mem || 'No memories saved yet.' };
     }
     catch (err) {
@@ -2445,6 +2632,9 @@ async function getHover(input, workDir) {
 const TOOL_MAP = {
     read_file: readFile,
     write_file: writeFile,
+    write_docx: writeDocx,
+    write_xlsx: writeXlsx,
+    write_pptx: writePptx,
     list_directory: listDirectory,
     bash: bash,
     search_files: searchFiles,
@@ -2484,7 +2674,8 @@ const TOOL_MAP = {
 // their own dedicated branch above (which passes abortSignal too) — kept out
 // of this set so there's exactly one dispatch path per tool, not two.
 const WORKDIR_TOOLS = new Set([
-    'read_file', 'write_file', 'list_directory', 'search_files', 'glob',
+    'read_file', 'write_file', 'write_docx', 'write_xlsx', 'write_pptx',
+    'list_directory', 'search_files', 'glob',
     'create_directory', 'edit_file', 'multi_edit', 'copy_file', 'move_file',
     'delete_file', 'notebook_read', 'notebook_edit',
     'get_symbols', 'get_workspace_symbols',

package/dist/util/frontmatter.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shared YAML-ish frontmatter parser for the markdown-based config formats
+ * this project uses (slash commands, skills, agent definitions). All three
+ * previously carried their own byte-for-byte identical copy of this function
+ * — extracted here so a future fix (e.g. multi-line values, list syntax)
+ * only has to happen once and cannot silently drift between them.
+ *
+ *   ---
+ *   key: value
+ *   another-key: "quoted value"
+ *   ---
+ *   body text...
+ *
+ * Deliberately minimal: single-line `key: value` pairs only, no nested
+ * structures or YAML lists — matches what commands/loader.ts, agent/skills.ts
+ * and agent/agentTypes.ts have always accepted.
+ */
+export declare function parseFrontmatter(raw: string): {
+    meta: Record<string, string>;
+    body: string;
+};
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/util/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/util/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAS5F"}

package/dist/util/frontmatter.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseFrontmatter = parseFrontmatter;
+/**
+ * Shared YAML-ish frontmatter parser for the markdown-based config formats
+ * this project uses (slash commands, skills, agent definitions). All three
+ * previously carried their own byte-for-byte identical copy of this function
+ * — extracted here so a future fix (e.g. multi-line values, list syntax)
+ * only has to happen once and cannot silently drift between them.
+ *
+ *   ---
+ *   key: value
+ *   another-key: "quoted value"
+ *   ---
+ *   body text...
+ *
+ * Deliberately minimal: single-line `key: value` pairs only, no nested
+ * structures or YAML lists — matches what commands/loader.ts, agent/skills.ts
+ * and agent/agentTypes.ts have always accepted.
+ */
+function parseFrontmatter(raw) {
+    const m = /^\s*---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/.exec(raw);
+    if (!m)
+        return { meta: {}, body: raw.trim() };
+    const meta = {};
+    for (const line of m[1].split(/\r?\n/)) {
+        const kv = /^([A-Za-z0-9_-]+)\s*:\s*(.*)$/.exec(line.trim());
+        if (kv)
+            meta[kv[1].toLowerCase()] = kv[2].trim().replace(/^["']|["']$/g, '');
+    }
+    return { meta, body: (m[2] ?? '').trim() };
+}
+//# sourceMappingURL=frontmatter.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexrall/code-core",
-  "version": "1.4.46",
+  "version": "1.4.47",
   "description": "Core agent loop, tools, and extension primitives for Nexrall Code — embed an AI coding agent in any Node.js application.",
   "license": "MIT",
   "author": "Nexrall <support@nexrall.com> (https://nexrall.com)",
@@ -95,7 +95,10 @@
   },
   "dependencies": {
     "eventsource-parser": "^1.1.2",
-    "node-fetch": "^3.3.2"
+    "node-fetch": "^3.3.2",
+    "docx": "^9.7.1",
+    "exceljs": "^4.4.0",
+    "pptxgenjs": "^4.0.1"
   },
   "devDependencies": {
     "@types/node": "^26.0.1",