@loom-framework/core 0.1.0-alpha.19 → 0.1.0-alpha.191

package/dist/backend/routes/skill-service.js

@@ -0,0 +1,265 @@
+/** Skill business logic — filesystem operations independent of Fastify */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import AdmZip from 'adm-zip';
+import { parseFrontmatter, scanDirFiles, safeResolve, isValidSkillName } from './skill-parser.js';
+import { parseZipArchive } from './skill-archive.js';
+// ── Service functions ──
+/**
+ * Ensure the skills directory exists.
+ */
+async function ensureSkillsDir(skillsDir) {
+    await fs.mkdir(skillsDir, { recursive: true });
+}
+/**
+ * List all skills with metadata.
+ */
+export async function listSkills(skillsDir) {
+    await ensureSkillsDir(skillsDir);
+    let entries;
+    try {
+        entries = await fs.readdir(skillsDir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const skills = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const skillDir = path.join(skillsDir, entry.name);
+        const skillMdPath = path.join(skillDir, 'SKILL.md');
+        let metadata = {};
+        try {
+            const content = await fs.readFile(skillMdPath, 'utf-8');
+            metadata = parseFrontmatter(content).metadata;
+        }
+        catch {
+            // SKILL.md doesn't exist or is unreadable
+        }
+        // Scan subdirectories dynamically (any folder name, not just 'references')
+        let subDirs = [];
+        try {
+            const dirEntries = await fs.readdir(skillDir, { withFileTypes: true });
+            subDirs = dirEntries.filter((e) => e.isDirectory()).map((e) => e.name);
+        }
+        catch {
+            // ignore
+        }
+        skills.push({ name: entry.name, metadata, subDirs });
+    }
+    return skills;
+}
+/**
+ * Get detailed information about a single skill.
+ */
+export async function getSkillDetail(skillsDir, skillName) {
+    const skillDir = path.join(skillsDir, skillName);
+    const exists = await fs.access(skillDir).then(() => true, () => false);
+    if (!exists)
+        return null;
+    let skillMd = '';
+    let metadata = {};
+    try {
+        skillMd = await fs.readFile(path.join(skillDir, 'SKILL.md'), 'utf-8');
+        metadata = parseFrontmatter(skillMd).metadata;
+    }
+    catch {
+        // SKILL.md doesn't exist
+    }
+    // Dynamically scan all files in subdirectories
+    const allFiles = await scanDirFiles(skillDir, skillDir);
+    const files = allFiles.map((p) => ({
+        name: path.basename(p),
+        path: p,
+    }));
+    return { name: skillName, metadata, skillMd, files };
+}
+/**
+ * Create a new skill directory with SKILL.md and optional files.
+ * Returns the created skill info, or throws on conflict / invalid name.
+ */
+export async function createSkill(skillsDir, body) {
+    const { name, skillMd, references, scripts: scriptFiles, files: archiveFiles } = body;
+    if (!isValidSkillName(name)) {
+        return { created: false, status: 400, error: 'Invalid skill name. Use alphanumeric, hyphens, and underscores only.' };
+    }
+    const skillDir = path.join(skillsDir, name);
+    const exists = await fs.access(skillDir).then(() => true, () => false);
+    if (exists) {
+        return { created: false, status: 409, error: `Skill "${name}" already exists` };
+    }
+    await fs.mkdir(skillDir, { recursive: true });
+    const contentToWrite = skillMd || `---
+name: ${name}
+description: ''
+version: 1.0.0
+---
+
+# ${name}
+
+## Overview
+
+[Describe what this skill does]
+
+## Usage Scenarios
+
+- "User prompt" → [what the skill does]
+`;
+    await fs.writeFile(path.join(skillDir, 'SKILL.md'), contentToWrite, 'utf-8');
+    if (references && references.length > 0) {
+        const refDir = path.join(skillDir, 'references');
+        await fs.mkdir(refDir, { recursive: true });
+        for (const ref of references) {
+            const safePath = safeResolve(refDir, ref.name);
+            if (safePath) {
+                await fs.mkdir(path.dirname(safePath), { recursive: true });
+                await fs.writeFile(safePath, ref.content, 'utf-8');
+            }
+        }
+    }
+    if (scriptFiles && scriptFiles.length > 0) {
+        const scriptsDir = path.join(skillDir, 'scripts');
+        await fs.mkdir(scriptsDir, { recursive: true });
+        for (const script of scriptFiles) {
+            const safePath = safeResolve(scriptsDir, script.name);
+            if (safePath) {
+                await fs.mkdir(path.dirname(safePath), { recursive: true });
+                await fs.writeFile(safePath, script.content, 'utf-8');
+            }
+        }
+    }
+    if (archiveFiles && archiveFiles.length > 0) {
+        for (const file of archiveFiles) {
+            const safePath = safeResolve(skillDir, file.path);
+            if (safePath) {
+                await fs.mkdir(path.dirname(safePath), { recursive: true });
+                await fs.writeFile(safePath, file.content, 'utf-8');
+            }
+        }
+    }
+    const metadata = parseFrontmatter(contentToWrite).metadata;
+    return { created: true, info: { name, metadata, subDirs: [] } };
+}
+/**
+ * Delete a skill directory.
+ */
+export async function deleteSkill(skillsDir, skillName) {
+    const skillDir = path.join(skillsDir, skillName);
+    const exists = await fs.access(skillDir).then(() => true, () => false);
+    if (!exists) {
+        return { ok: false, status: 404, error: `Skill "${skillName}" not found` };
+    }
+    await fs.rm(skillDir, { recursive: true, force: true });
+    return { ok: true };
+}
+/**
+ * Read a file within a skill directory.
+ */
+export async function getSkillFile(skillsDir, skillName, filePath) {
+    const skillDir = path.join(skillsDir, skillName);
+    const exists = await fs.access(skillDir).then(() => true, () => false);
+    if (!exists) {
+        return { ok: false, status: 404, error: `Skill "${skillName}" not found` };
+    }
+    const resolvedPath = safeResolve(skillDir, filePath);
+    if (!resolvedPath) {
+        return { ok: false, status: 400, error: 'Invalid file path' };
+    }
+    const fileExists = await fs.access(resolvedPath).then(() => true, () => false);
+    if (!fileExists) {
+        return { ok: false, status: 404, error: `File "${filePath}" not found` };
+    }
+    try {
+        const content = await fs.readFile(resolvedPath, 'utf-8');
+        return { ok: true, content, path: filePath };
+    }
+    catch (err) {
+        return { ok: false, status: 500, error: `Failed to read file: ${err}` };
+    }
+}
+/**
+ * Upload/replace a file in a skill directory.
+ */
+export async function uploadSkillFile(skillsDir, skillName, filename, content) {
+    const skillDir = path.join(skillsDir, skillName);
+    const exists = await fs.access(skillDir).then(() => true, () => false);
+    if (!exists) {
+        return { ok: false, status: 404, error: `Skill "${skillName}" not found` };
+    }
+    const resolvedPath = safeResolve(skillDir, filename);
+    if (!resolvedPath) {
+        return { ok: false, status: 400, error: 'Invalid file path' };
+    }
+    await fs.mkdir(path.dirname(resolvedPath), { recursive: true });
+    await fs.writeFile(resolvedPath, content, 'utf-8');
+    return { ok: true, path: filename };
+}
+/**
+ * Create a ZIP archive of a skill directory.
+ */
+export async function createSkillArchive(skillsDir, skillName) {
+    const skillDir = path.join(skillsDir, skillName);
+    const exists = await fs.access(skillDir).then(() => true, () => false);
+    if (!exists) {
+        return { ok: false, status: 404, error: `Skill "${skillName}" not found` };
+    }
+    const zip = new AdmZip();
+    // Add SKILL.md
+    const skillMdPath = path.join(skillDir, 'SKILL.md');
+    try {
+        const skillMd = await fs.readFile(skillMdPath, 'utf-8');
+        zip.addFile('SKILL.md', Buffer.from(skillMd, 'utf-8'));
+    }
+    catch {
+        // SKILL.md doesn't exist, skip
+    }
+    // Add all other files, preserving directory structure
+    const allFiles = await scanDirFiles(skillDir, skillDir);
+    for (const filePath of allFiles) {
+        if (filePath === 'SKILL.md')
+            continue;
+        const resolvedPath = safeResolve(skillDir, filePath);
+        if (!resolvedPath)
+            continue;
+        try {
+            const content = await fs.readFile(resolvedPath);
+            // Store under skillName/ prefix for proper extraction
+            zip.addFile(`${skillName}/${filePath}`, content);
+        }
+        catch {
+            // skip unreadable files
+        }
+    }
+    // Also put SKILL.md under the prefix
+    zip.deleteFile('SKILL.md');
+    try {
+        const skillMd = await fs.readFile(skillMdPath, 'utf-8');
+        zip.addFile(`${skillName}/SKILL.md`, Buffer.from(skillMd, 'utf-8'));
+    }
+    catch {
+        // skip
+    }
+    return { ok: true, buffer: zip.toBuffer() };
+}
+/**
+ * Parse a base64-encoded ZIP archive and extract skill structure.
+ */
+export function parseSkillArchive(base64Data) {
+    let buffer;
+    try {
+        buffer = Buffer.from(base64Data, 'base64');
+    }
+    catch {
+        return { ok: false, status: 400, error: '无效的 base64 编码' };
+    }
+    try {
+        const result = parseZipArchive(buffer);
+        return { ok: true, data: result };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : '解析压缩包失败';
+        return { ok: false, status: 400, error: msg };
+    }
+}
+//# sourceMappingURL=skill-service.js.map

package/dist/backend/routes/skill-service.js.map

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

package/dist/backend/routes/skills.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Skill Management Routes - REST API for managing skills in .claude/skills/
+ *
+ * POST /api/v1/skills         — Create a new skill
+ * GET  /api/v1/skills         — List all skills with metadata
+ * GET  /api/v1/skills/:skillName — Get skill details
+ * DELETE /api/v1/skills/:skillName — Delete a skill
+ * GET  /api/v1/skills/:skillName/file/:filePath — Get a file's content
+ * POST /api/v1/skills/:skillName/file — Upload/replace a file in a skill
+ */
+import type { FastifyInstance } from 'fastify';
+import type { EventBus } from '../events/event-bus.js';
+export interface SkillRouteOptions {
+    projectRoot: string;
+    eventBus?: EventBus;
+}
+export declare function registerSkillRoutes(fastify: FastifyInstance, options: SkillRouteOptions): void;
+//# sourceMappingURL=skills.d.ts.map

package/dist/backend/routes/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/backend/routes/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAK/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAyEvD,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,iBAAiB,GACzB,IAAI,CAkGN"}

package/dist/backend/routes/skills.js

@@ -0,0 +1,168 @@
+/**
+ * Skill Management Routes - REST API for managing skills in .claude/skills/
+ *
+ * POST /api/v1/skills         — Create a new skill
+ * GET  /api/v1/skills         — List all skills with metadata
+ * GET  /api/v1/skills/:skillName — Get skill details
+ * DELETE /api/v1/skills/:skillName — Delete a skill
+ * GET  /api/v1/skills/:skillName/file/:filePath — Get a file's content
+ * POST /api/v1/skills/:skillName/file — Upload/replace a file in a skill
+ */
+import path from 'node:path';
+import { listSkills, getSkillDetail, createSkill, deleteSkill, getSkillFile, uploadSkillFile, createSkillArchive, parseSkillArchive } from '../services/skill-service.js';
+// ── Schemas ──
+const skillNameParamSchema = {
+    type: 'object',
+    required: ['skillName'],
+    properties: {
+        skillName: { type: 'string', minLength: 1 },
+    },
+};
+const createSkillBodySchema = {
+    type: 'object',
+    required: ['name'],
+    properties: {
+        name: { type: 'string', minLength: 1, maxLength: 64 },
+        skillMd: { type: 'string' },
+        references: {
+            type: 'array',
+            items: {
+                type: 'object',
+                required: ['name', 'content'],
+                properties: {
+                    name: { type: 'string' },
+                    content: { type: 'string' },
+                },
+            },
+        },
+        scripts: {
+            type: 'array',
+            items: {
+                type: 'object',
+                required: ['name', 'content'],
+                properties: {
+                    name: { type: 'string' },
+                    content: { type: 'string' },
+                },
+            },
+        },
+        files: {
+            type: 'array',
+            items: {
+                type: 'object',
+                required: ['path', 'content'],
+                properties: {
+                    path: { type: 'string' },
+                    content: { type: 'string' },
+                },
+            },
+        },
+    },
+};
+const parseArchiveBodySchema = {
+    type: 'object',
+    required: ['data'],
+    properties: {
+        data: { type: 'string', minLength: 1 },
+    },
+};
+const uploadFileBodySchema = {
+    type: 'object',
+    required: ['filename', 'content'],
+    properties: {
+        filename: { type: 'string', minLength: 1 },
+        content: { type: 'string' },
+    },
+};
+export function registerSkillRoutes(fastify, options) {
+    const skillsDir = path.join(options.projectRoot, '.claude', 'skills');
+    const { eventBus } = options;
+    // ── GET /api/v1/skills ──
+    fastify.get('/api/v1/skills', async (_request, reply) => {
+        const skills = await listSkills(skillsDir);
+        return reply.send({ data: skills });
+    });
+    // ── POST /api/v1/skills/parse-archive ──
+    fastify.post('/api/v1/skills/parse-archive', {
+        schema: { body: parseArchiveBodySchema },
+    }, async (request, reply) => {
+        const { data } = request.body;
+        const result = parseSkillArchive(data);
+        if (!result.ok) {
+            return reply.status(result.status).send({ error: result.error });
+        }
+        return reply.send({ data: result.data });
+    });
+    // ── GET /api/v1/skills/:skillName ──
+    fastify.get('/api/v1/skills/:skillName', {
+        schema: { params: skillNameParamSchema },
+    }, async (request, reply) => {
+        const { skillName } = request.params;
+        const detail = await getSkillDetail(skillsDir, skillName);
+        if (!detail) {
+            return reply.status(404).send({ error: `Skill "${skillName}" not found` });
+        }
+        return reply.send({ data: detail });
+    });
+    // ── GET /api/v1/skills/:skillName/archive ──
+    fastify.get('/api/v1/skills/:skillName/archive', {
+        schema: { params: skillNameParamSchema },
+    }, async (request, reply) => {
+        const { skillName } = request.params;
+        const result = await createSkillArchive(skillsDir, skillName);
+        if (!result.ok) {
+            return reply.status(result.status).send({ error: result.error });
+        }
+        reply.header('Content-Type', 'application/zip');
+        reply.header('Content-Disposition', `attachment; filename="${skillName}.zip"`);
+        return reply.send(result.buffer);
+    });
+    // ── GET /api/v1/skills/:skillName/file/* ──
+    fastify.get('/api/v1/skills/:skillName/file/*', async (request, reply) => {
+        const { skillName } = request.params;
+        const filePath = request.params['*'];
+        const result = await getSkillFile(skillsDir, skillName, filePath);
+        if (!result.ok) {
+            return reply.status(result.status).send({ error: result.error });
+        }
+        return reply.send({ data: { content: result.content, path: result.path } });
+    });
+    // ── POST /api/v1/skills ──
+    fastify.post('/api/v1/skills', {
+        schema: { body: createSkillBodySchema },
+    }, async (request, reply) => {
+        const body = request.body;
+        const result = await createSkill(skillsDir, body);
+        if (!result.created) {
+            return reply.status(result.status).send({ error: result.error });
+        }
+        void eventBus?.emit('skill:created', { skillName: result.info.name }, { source: 'server' });
+        return reply.code(201).send({ data: result.info });
+    });
+    // ── DELETE /api/v1/skills/:skillName ──
+    fastify.delete('/api/v1/skills/:skillName', {
+        schema: { params: skillNameParamSchema },
+    }, async (request, reply) => {
+        const { skillName } = request.params;
+        const result = await deleteSkill(skillsDir, skillName);
+        if (!result.ok) {
+            return reply.status(result.status).send({ error: result.error });
+        }
+        void eventBus?.emit('skill:deleted', { skillName }, { source: 'server' });
+        return reply.send({ success: true });
+    });
+    // ── POST /api/v1/skills/:skillName/file ──
+    fastify.post('/api/v1/skills/:skillName/file', {
+        schema: { params: skillNameParamSchema, body: uploadFileBodySchema },
+    }, async (request, reply) => {
+        const { skillName } = request.params;
+        const { filename, content } = request.body;
+        const result = await uploadSkillFile(skillsDir, skillName, filename, content);
+        if (!result.ok) {
+            return reply.status(result.status).send({ error: result.error });
+        }
+        void eventBus?.emit('skill:file_updated', { skillName, filename, path: result.path }, { source: 'server' });
+        return reply.send({ success: true, path: result.path });
+    });
+}
+//# sourceMappingURL=skills.js.map

package/dist/backend/routes/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../../src/backend/routes/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAI1K,gBAAgB;AAEhB,MAAM,oBAAoB,GAAG;IAC3B,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,WAAW,CAAC;IACvB,UAAU,EAAE;QACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;KAC5C;CACO,CAAC;AAEX,MAAM,qBAAqB,GAAG;IAC5B,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,MAAM,CAAC;IAClB,UAAU,EAAE;QACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE;QACrD,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC3B,UAAU,EAAE;YACV,IAAI,EAAE,OAAO;YACb,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;gBAC7B,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACxB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC5B;aACF;SACF;QACD,OAAO,EAAE;YACP,IAAI,EAAE,OAAO;YACb,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;gBAC7B,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACxB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC5B;aACF;SACF;QACD,KAAK,EAAE;YACL,IAAI,EAAE,OAAO;YACb,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;gBAC7B,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACxB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC5B;aACF;SACF;KACF;CACO,CAAC;AAEX,MAAM,sBAAsB,GAAG;IAC7B,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,MAAM,CAAC;IAClB,UAAU,EAAE;QACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;KACvC;CACO,CAAC;AAEX,MAAM,oBAAoB,GAAG;IAC3B,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;IACjC,UAAU,EAAE;QACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;QAC1C,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC5B;CACO,CAAC;AASX,MAAM,UAAU,mBAAmB,CACjC,OAAwB,EACxB,OAA0B;IAE1B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACtE,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAE7B,2BAA2B;IAC3B,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;QACtD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC;QAC3C,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,0CAA0C;IAC1C,OAAO,CAAC,IAAI,CAAC,8BAA8B,EAAE;QAC3C,MAAM,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE;KACzC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAC1B,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,IAAwB,CAAC;QAClD,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE;QACvC,MAAM,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE;KACzC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAC1B,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,MAA+B,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC1D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,SAAS,aAAa,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,8CAA8C;IAC9C,OAAO,CAAC,GAAG,CAAC,mCAAmC,EAAE;QAC/C,MAAM,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE;KACzC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAC1B,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,MAA+B,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;QAChD,KAAK,CAAC,MAAM,CAAC,qBAAqB,EAAE,yBAAyB,SAAS,OAAO,CAAC,CAAC;QAC/E,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,6CAA6C;IAC7C,OAAO,CAAC,GAAG,CAAC,kCAAkC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACvE,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,MAA+B,CAAC;QAC9D,MAAM,QAAQ,GAAI,OAAO,CAAC,MAAkC,CAAC,GAAG,CAAW,CAAC;QAC5E,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,4BAA4B;IAC5B,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE;QAC7B,MAAM,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE;KACxC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAC1B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAuB,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,KAAK,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5F,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,yCAAyC;IACzC,OAAO,CAAC,MAAM,CAAC,2BAA2B,EAAE;QAC1C,MAAM,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE;KACzC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAC1B,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,MAA+B,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,KAAK,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC1E,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,4CAA4C;IAC5C,OAAO,CAAC,IAAI,CAAC,gCAAgC,EAAE;QAC7C,MAAM,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,IAAI,EAAE,oBAAoB,EAAE;KACrE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAC1B,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,MAA+B,CAAC;QAC9D,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAsB,CAAC;QAC7D,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC9E,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,KAAK,QAAQ,EAAE,IAAI,CAAC,oBAAoB,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5G,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/backend/routes/upload.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Upload Routes - File upload and static serving
+ *
+ * Handles base64 file uploads via SSE chat and provides
+ * static file serving for uploaded files.
+ */
+import type { FastifyInstance } from 'fastify';
+import type { LoomPaths } from '../loom-paths.js';
+export interface UploadRouteOptions {
+    paths: LoomPaths;
+    defaultUserId?: string;
+}
+/**
+ * Register upload and static file serving routes
+ */
+export declare function registerUploadRoutes(fastify: FastifyInstance, options: UploadRouteOptions): void;
+/**
+ * Save an uploaded file from base64 data
+ * Returns the relative URL path for accessing the file
+ */
+export declare function saveUploadedFile(paths: LoomPaths, sessionId: string, filename: string, base64Data: string, userId?: string): Promise<{
+    url: string;
+    path: string;
+}>;
+//# sourceMappingURL=upload.d.ts.map

package/dist/backend/routes/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../src/backend/routes/upload.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,SAAS,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,kBAAkB,GAC1B,IAAI,CA+EN;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,SAAU,GACf,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAYxC"}

package/dist/backend/routes/upload.js

@@ -0,0 +1,100 @@
+/**
+ * Upload Routes - File upload and static serving
+ *
+ * Handles base64 file uploads via SSE chat and provides
+ * static file serving for uploaded files.
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+/**
+ * Register upload and static file serving routes
+ */
+export function registerUploadRoutes(fastify, options) {
+    const { paths, defaultUserId = 'admin' } = options;
+    const uploadsDir = paths.forUser(defaultUserId).uploads();
+    // Ensure uploads directory exists
+    fs.mkdir(uploadsDir, { recursive: true }).catch(() => { });
+    // Serve uploaded files: GET /api/v1/uploads/:sessionId/:filename
+    fastify.get('/api/v1/uploads/:sessionId/:filename', async (request, reply) => {
+        const { sessionId, filename } = request.params;
+        // Sanitize path components to prevent directory traversal
+        // sessionId is machine-generated, keep strict; filename allows Unicode (CJK, etc.)
+        const sanitizedSessionId = sessionId.replace(/[^a-zA-Z0-9_-]/g, '');
+        const sanitizedFilename = filename.replace(/[/\\\u0000-\u001f]/g, '');
+        if (!sanitizedSessionId || !sanitizedFilename || sanitizedFilename === '..') {
+            return reply.status(400).send({ error: 'Invalid path parameters' });
+        }
+        const filePath = path.join(uploadsDir, sanitizedSessionId, sanitizedFilename);
+        // Ensure resolved path is within uploads directory
+        const resolvedPath = path.resolve(filePath);
+        if (!resolvedPath.startsWith(path.resolve(uploadsDir))) {
+            return reply.status(403).send({ error: 'Access denied' });
+        }
+        try {
+            const buffer = await fs.readFile(filePath);
+            const ext = path.extname(sanitizedFilename).toLowerCase();
+            const contentTypes = {
+                // Images
+                '.png': 'image/png',
+                '.jpg': 'image/jpeg',
+                '.jpeg': 'image/jpeg',
+                '.gif': 'image/gif',
+                '.svg': 'image/svg+xml',
+                '.webp': 'image/webp',
+                '.bmp': 'image/bmp',
+                '.ico': 'image/x-icon',
+                // Documents
+                '.pdf': 'application/pdf',
+                '.doc': 'application/msword',
+                '.docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+                '.xls': 'application/vnd.ms-excel',
+                '.xlsx': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+                '.ppt': 'application/vnd.ms-powerpoint',
+                '.pptx': 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+                // Text & Markup
+                '.txt': 'text/plain',
+                '.md': 'text/markdown',
+                '.html': 'text/html',
+                '.htm': 'text/html',
+                '.css': 'text/css',
+                '.js': 'text/javascript',
+                '.ts': 'text/typescript',
+                '.json': 'application/json',
+                '.xml': 'application/xml',
+                '.yaml': 'text/yaml',
+                '.yml': 'text/yaml',
+                '.csv': 'text/csv',
+                // Audio & Video
+                '.mp3': 'audio/mpeg',
+                '.wav': 'audio/wav',
+                '.mp4': 'video/mp4',
+                '.webm': 'video/webm',
+                // Archives
+                '.zip': 'application/zip',
+                '.gz': 'application/gzip',
+                '.tar': 'application/x-tar',
+            };
+            reply.header('Content-Type', contentTypes[ext] || 'application/octet-stream');
+            return reply.send(buffer);
+        }
+        catch {
+            return reply.status(404).send({ error: 'File not found' });
+        }
+    });
+}
+/**
+ * Save an uploaded file from base64 data
+ * Returns the relative URL path for accessing the file
+ */
+export async function saveUploadedFile(paths, sessionId, filename, base64Data, userId = 'admin') {
+    const uploadsDir = paths.forUser(userId).uploads(sessionId);
+    await fs.mkdir(uploadsDir, { recursive: true });
+    const filePath = path.join(uploadsDir, filename);
+    const buffer = Buffer.from(base64Data, 'base64');
+    await fs.writeFile(filePath, buffer);
+    return {
+        url: `/api/v1/uploads/${sessionId}/${filename}`,
+        path: filePath,
+    };
+}
+//# sourceMappingURL=upload.js.map

package/dist/backend/routes/upload.js.map

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

package/dist/backend/services/skill-archive.d.ts

@@ -0,0 +1,13 @@
+/** Skill ZIP archive parsing and creation utilities */
+/**
+ * Parse a zip archive buffer and extract skill structure.
+ */
+export declare function parseZipArchive(buffer: Buffer): {
+    skillName: string;
+    skillMd: string;
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+};
+//# sourceMappingURL=skill-archive.d.ts.map

package/dist/backend/services/skill-archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-archive.d.ts","sourceRoot":"","sources":["../../../src/backend/services/skill-archive.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAMvD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAgFvI"}