vskill 1.0.12 → 1.0.14

package/README.md

@@ -9,8 +9,8 @@
   <a href="https://www.npmjs.com/package/vskill"><img src="https://img.shields.io/npm/v/vskill?color=cb3837&logo=npm" alt="npm" /></a>
   <a href="https://www.npmjs.com/package/vskill"><img src="https://img.shields.io/npm/dw/vskill?color=cb3837&logo=npm&label=downloads" alt="downloads" /></a>
   <img src="https://img.shields.io/badge/agents-53_platforms-0969DA" alt="53 agents" />
-  <img src="https://img.shields.io/badge/plugins-8-8B5CF6" alt="8 plugins" />
-  <img src="https://img.shields.io/badge/skills-14-10B981" alt="14 skills" />
+  <img src="https://img.shields.io/badge/plugins-9-8B5CF6" alt="9 plugins" />
+  <img src="https://img.shields.io/badge/skills-16-10B981" alt="16 skills" />
   <a href="https://verified-skill.com"><img src="https://img.shields.io/badge/registry-verified--skill.com-F59E0B" alt="registry" /></a>
   <img src="https://img.shields.io/badge/license-MIT-green" alt="MIT" />
 </p>

package/agents.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "generatedAt": "2026-04-29T08:41:25.210Z",
+  "generatedAt": "2026-05-01T15:37:33.318Z",
   "agentPrefixes": [
     ".adal",
     ".agent",

package/dist/commands/check.d.ts

@@ -0,0 +1,55 @@
+export interface CheckOptions {
+    json?: boolean;
+    /** Override skill search root (default: cwd). */
+    root?: string;
+}
+interface CheckRow {
+    status: "ok" | "missing" | "warning";
+    message: string;
+}
+interface CheckReport {
+    skill: string;
+    dir: string;
+    mcps: Array<{
+        name: string;
+    } & CheckRow>;
+    secrets: Array<{
+        name: string;
+    } & CheckRow>;
+    runtime: Array<{
+        key: string;
+    } & CheckRow>;
+    tests: CheckRow | null;
+    exitCode: 0 | 1 | 2;
+}
+/**
+ * Locate a skill directory by name, searching common layouts inside `root`:
+ *   - {root}/plugins/<plugin>/skills/<name>/
+ *   - {root}/skills/<name>/
+ *   - {root}/<name>/                       (flat layout)
+ * Returns the first matching absolute path with a SKILL.md, or null.
+ */
+export declare function findSkillDir(name: string, root: string): string | null;
+/**
+ * Check whether a named MCP server is configured in any known Claude config
+ * file. Returns "configured" if found, "missing" otherwise. Tolerant of
+ * malformed JSON — a parse error is treated as "not configured here".
+ */
+export declare function checkMcpConfigured(serverName: string, projectRoot: string): "configured" | "missing";
+/**
+ * Compare a `python3 --version` output line ("Python 3.11.4") against a
+ * declared minimum in the form ">=3.10" or "3.10" (treated as exact-major+).
+ * Returns true if the runtime satisfies the declaration, false otherwise.
+ */
+export declare function pythonVersionSatisfies(installed: string, declared: string): boolean;
+/**
+ * Build the structured CheckReport for a skill. Pure, testable — no console
+ * I/O. The CLI wrapper (`checkCommand`) renders this report to stdout.
+ */
+export declare function buildCheckReport(skillName: string, projectRoot: string): CheckReport;
+/**
+ * CLI entry point — prints the report and exits with the appropriate code.
+ * Never echoes secret values; only names + statuses.
+ */
+export declare function checkCommand(skillName: string, opts?: CheckOptions): Promise<void>;
+export {};

package/dist/commands/check.js

@@ -0,0 +1,279 @@
+// ---------------------------------------------------------------------------
+// commands/check.ts — preflight verification for multi-file skills (0815).
+//
+// Reads a skill's SKILL.md frontmatter and verifies that every declared
+// dependency is satisfied before the skill runs:
+//   - mcpDeps[]      → present in ~/.claude/mcp.json or project .claude/mcp.json
+//   - secrets[]      → resolvable via env or .env.local (resolveCredential)
+//   - runtime.python → `python3 --version` ≥ declared minimum
+//   - runtime.pip    → declared (informational; we don't auto-install)
+//   - integrationTests.runner === "pytest" → `pytest --collect-only` succeeds
+//
+// Exit codes:
+//   0 → all green
+//   1 → at least one required dep missing / unsatisfiable
+//   2 → only soft warnings (e.g. unknown MCP, no integration test runner)
+//
+// Reuses the existing infra: parseSkillFrontmatter + buildSkillMetadata from
+// api-routes.ts (so the same wire format the studio writes is the same one we
+// validate), plus resolveAllCredentials from credential-resolver.ts.
+// ---------------------------------------------------------------------------
+import { readFileSync, existsSync, readdirSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { spawnSync } from "node:child_process";
+import { buildSkillMetadata } from "../eval-server/api-routes.js";
+import { resolveAllCredentials } from "../eval/credential-resolver.js";
+/**
+ * Locate a skill directory by name, searching common layouts inside `root`:
+ *   - {root}/plugins/<plugin>/skills/<name>/
+ *   - {root}/skills/<name>/
+ *   - {root}/<name>/                       (flat layout)
+ * Returns the first matching absolute path with a SKILL.md, or null.
+ */
+export function findSkillDir(name, root) {
+    const candidates = [];
+    const pluginsDir = join(root, "plugins");
+    if (existsSync(pluginsDir)) {
+        try {
+            for (const plugin of readdirSync(pluginsDir, { withFileTypes: true })) {
+                if (!plugin.isDirectory())
+                    continue;
+                const skillsDir = join(pluginsDir, plugin.name, "skills");
+                if (!existsSync(skillsDir))
+                    continue;
+                candidates.push(join(skillsDir, name));
+            }
+        }
+        catch { /* ignore */ }
+    }
+    candidates.push(join(root, "skills", name));
+    candidates.push(join(root, name));
+    for (const c of candidates) {
+        try {
+            if (existsSync(join(c, "SKILL.md")) && statSync(c).isDirectory())
+                return c;
+        }
+        catch { /* ignore */ }
+    }
+    return null;
+}
+/**
+ * Check whether a named MCP server is configured in any known Claude config
+ * file. Returns "configured" if found, "missing" otherwise. Tolerant of
+ * malformed JSON — a parse error is treated as "not configured here".
+ */
+export function checkMcpConfigured(serverName, projectRoot) {
+    const candidates = [
+        join(projectRoot, ".claude", "mcp.json"),
+        join(homedir(), ".claude", "mcp.json"),
+        join(homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json"),
+    ];
+    for (const p of candidates) {
+        if (!existsSync(p))
+            continue;
+        try {
+            const cfg = JSON.parse(readFileSync(p, "utf-8"));
+            const servers = cfg.mcpServers;
+            if (servers && typeof servers === "object" && serverName in servers) {
+                return "configured";
+            }
+        }
+        catch { /* ignore parse error */ }
+    }
+    return "missing";
+}
+/**
+ * Compare a `python3 --version` output line ("Python 3.11.4") against a
+ * declared minimum in the form ">=3.10" or "3.10" (treated as exact-major+).
+ * Returns true if the runtime satisfies the declaration, false otherwise.
+ */
+export function pythonVersionSatisfies(installed, declared) {
+    const m = installed.match(/Python\s+(\d+)\.(\d+)/);
+    if (!m)
+        return false;
+    const haveMaj = parseInt(m[1], 10);
+    const haveMin = parseInt(m[2], 10);
+    const decl = declared.replace(/^[><=~^]+/, "").trim();
+    const dm = decl.match(/^(\d+)\.(\d+)/);
+    if (!dm)
+        return false;
+    const wantMaj = parseInt(dm[1], 10);
+    const wantMin = parseInt(dm[2], 10);
+    if (haveMaj !== wantMaj)
+        return haveMaj > wantMaj;
+    return haveMin >= wantMin;
+}
+/**
+ * Build the structured CheckReport for a skill. Pure, testable — no console
+ * I/O. The CLI wrapper (`checkCommand`) renders this report to stdout.
+ */
+export function buildCheckReport(skillName, projectRoot) {
+    const dir = findSkillDir(skillName, projectRoot);
+    if (!dir) {
+        return {
+            skill: skillName,
+            dir: "",
+            mcps: [],
+            secrets: [],
+            runtime: [],
+            tests: null,
+            exitCode: 1,
+        };
+    }
+    const meta = buildSkillMetadata(dir, "source", projectRoot);
+    const mcps = (meta.mcpDeps ?? []).map((name) => {
+        const status = checkMcpConfigured(name, projectRoot);
+        return {
+            name,
+            status: status === "configured" ? "ok" : "missing",
+            message: status === "configured" ? "configured" : "not configured in any known Claude config",
+        };
+    });
+    const secretStatuses = resolveAllCredentials(meta.secrets ?? [], dir);
+    const secrets = secretStatuses.map((s) => ({
+        name: s.name,
+        status: s.status === "ready" ? "ok" : "missing",
+        message: s.status === "ready" ? `ready (${s.source})` : "missing — set in env or .env.local",
+    }));
+    const runtime = [];
+    if (meta.runtime?.python) {
+        const result = spawnSync("python3", ["--version"], { encoding: "utf-8" });
+        if (result.status === 0) {
+            const out = (result.stdout || result.stderr || "").trim();
+            const ok = pythonVersionSatisfies(out, meta.runtime.python);
+            runtime.push({
+                key: "python",
+                status: ok ? "ok" : "missing",
+                message: ok ? `${out} satisfies ${meta.runtime.python}` : `${out} does not satisfy ${meta.runtime.python}`,
+            });
+        }
+        else {
+            runtime.push({
+                key: "python",
+                status: "missing",
+                message: `python3 not on PATH (declared ${meta.runtime.python})`,
+            });
+        }
+    }
+    if (meta.runtime?.pip && meta.runtime.pip.length > 0) {
+        runtime.push({
+            key: "pip",
+            status: "warning",
+            message: `declares ${meta.runtime.pip.length} pip package(s) — install manually before running`,
+        });
+    }
+    let tests = null;
+    if (meta.integrationTests?.runner === "pytest") {
+        const file = meta.integrationTests.file
+            ? resolve(dir, meta.integrationTests.file)
+            : resolve(dir, "tests");
+        if (!existsSync(file)) {
+            tests = { status: "missing", message: `pytest target ${meta.integrationTests.file ?? "tests/"} not found` };
+        }
+        else {
+            const result = spawnSync("python3", ["-m", "pytest", "--collect-only", file], {
+                encoding: "utf-8",
+                cwd: dir,
+            });
+            if (result.status === 0) {
+                tests = { status: "ok", message: "pytest --collect-only succeeded" };
+            }
+            else {
+                tests = {
+                    status: "missing",
+                    message: `pytest --collect-only failed (exit ${result.status ?? "?"}): ${(result.stderr || "").split("\n")[0] || "no stderr"}`,
+                };
+            }
+        }
+    }
+    else if (meta.integrationTests?.runner === "vitest") {
+        tests = { status: "warning", message: "vitest collection check not yet implemented" };
+    }
+    else if (meta.integrationTests?.runner === "none") {
+        tests = { status: "ok", message: "no integration tests declared" };
+    }
+    // Compute exit code: 0 all green, 1 any missing, 2 only warnings.
+    let anyMissing = false;
+    let anyWarning = false;
+    for (const row of [...mcps, ...secrets, ...runtime, ...(tests ? [tests] : [])]) {
+        if (row.status === "missing")
+            anyMissing = true;
+        if (row.status === "warning")
+            anyWarning = true;
+    }
+    const exitCode = anyMissing ? 1 : anyWarning ? 2 : 0;
+    return { skill: skillName, dir, mcps, secrets, runtime, tests, exitCode };
+}
+/**
+ * CLI entry point — prints the report and exits with the appropriate code.
+ * Never echoes secret values; only names + statuses.
+ */
+export async function checkCommand(skillName, opts = {}) {
+    const root = opts.root ? resolve(opts.root) : process.cwd();
+    const report = buildCheckReport(skillName, root);
+    if (!report.dir) {
+        if (opts.json) {
+            process.stdout.write(JSON.stringify({ ...report, error: "skill-not-found" }, null, 2) + "\n");
+        }
+        else {
+            process.stderr.write(`vskill check: skill '${skillName}' not found under ${root}\n`);
+        }
+        process.exit(1);
+    }
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(report, null, 2) + "\n");
+        process.exit(report.exitCode);
+    }
+    // Human-readable rendering — never includes secret values.
+    const lines = [];
+    lines.push(`vskill check: ${report.skill}`);
+    lines.push(`  ${report.dir}`);
+    lines.push("");
+    if (report.mcps.length === 0) {
+        lines.push("MCPs:    (none declared)");
+    }
+    else {
+        lines.push("MCPs:");
+        for (const r of report.mcps)
+            lines.push(`  ${glyph(r.status)} ${r.name}: ${r.message}`);
+    }
+    if (report.secrets.length === 0) {
+        lines.push("Secrets: (none declared)");
+    }
+    else {
+        lines.push("Secrets:");
+        for (const r of report.secrets)
+            lines.push(`  ${glyph(r.status)} ${r.name}: ${r.message}`);
+    }
+    if (report.runtime.length === 0) {
+        lines.push("Runtime: (none declared)");
+    }
+    else {
+        lines.push("Runtime:");
+        for (const r of report.runtime)
+            lines.push(`  ${glyph(r.status)} ${r.key}: ${r.message}`);
+    }
+    if (report.tests) {
+        lines.push(`Tests:   ${glyph(report.tests.status)} ${report.tests.message}`);
+    }
+    else {
+        lines.push("Tests:   (no integration runner declared)");
+    }
+    lines.push("");
+    lines.push(report.exitCode === 0
+        ? "All checks passed."
+        : report.exitCode === 2
+            ? "Soft warnings only — review above."
+            : "One or more required dependencies missing — see above.");
+    process.stdout.write(lines.join("\n") + "\n");
+    process.exit(report.exitCode);
+}
+function glyph(status) {
+    switch (status) {
+        case "ok": return "[OK]    ";
+        case "missing": return "[MISS]  ";
+        case "warning": return "[WARN]  ";
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

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

package/dist/core/agent-prompts.d.ts

@@ -0,0 +1,35 @@
+export interface AgentFile {
+    path: string;
+    content: string;
+}
+export interface ScriptAgentResponse {
+    files: AgentFile[];
+    runtime?: {
+        python?: string;
+        pip?: string[];
+        node?: string;
+    };
+}
+export interface GraderAgentResponse {
+    files: AgentFile[];
+}
+export interface TestAgentResponse {
+    files: AgentFile[];
+    secrets?: string[];
+    integrationTests?: {
+        runner: "vitest" | "pytest" | "none";
+        file?: string;
+        requires?: string[];
+    };
+}
+export interface ReferenceAgentResponse {
+    files: AgentFile[];
+}
+export declare const SCRIPT_SYSTEM_PROMPT = "You generate the deterministic helper script(s) for a skill in Skill Studio.\n\nGiven the user's skill description, produce one or more language-appropriate helper scripts the skill will shell out to (e.g. `scripts/audit.py`, `scripts/format.js`). Scripts must:\n- Be self-contained and runnable from the skill directory.\n- Use only the standard library plus the dependencies you declare in `runtime`.\n- Read secrets from environment variables; never contain hardcoded API keys.\n- Degrade gracefully when env vars or external services are unavailable (print a clear message and exit non-zero, never crash on import).\n\n## Output Format\nReturn ONLY a JSON object:\n{\n  \"files\": [\n    { \"path\": \"scripts/<name>.<ext>\", \"content\": \"<full source>\" }\n  ],\n  \"runtime\": { \"python\": \">=3.10\", \"pip\": [\"pkg>=1\"] }\n}\n\n`runtime` is optional \u2014 omit if the script needs no runtime declaration.\n`path` is always relative to the skill root, must start with `scripts/`, and must not contain `..` or absolute paths.\nNo code fences, no preamble.";
+export declare const GRADER_SYSTEM_PROMPT = "You generate a deterministic grader script for a skill in Skill Studio.\n\nGiven the user's skill description, produce a single grader script (e.g. `scripts/grader.py`) that takes the skill's output as input and returns a numeric score in [0, 1]. The grader must:\n- Be a pure function of its input \u2014 no network calls, no env reads.\n- Return a deterministic float between 0 and 1.\n- Match the language of the main script when possible.\n\n## Output Format\nReturn ONLY a JSON object:\n{\n  \"files\": [\n    { \"path\": \"scripts/grader.<ext>\", \"content\": \"<full source>\" }\n  ]\n}\n\n`path` must start with `scripts/` and must not contain `..` or absolute paths.\nNo code fences, no preamble.";
+export declare const TEST_SYSTEM_PROMPT = "You generate a runnable integration test for a skill in Skill Studio.\n\nGiven the user's skill description, produce ONE integration test file (e.g. `tests/integration_test.py` or `tests/integration.test.ts`) plus a top-level secrets declaration. The test must:\n- Be runnable via the declared runner (`pytest` or `vitest`).\n- Skip cleanly when required env vars are missing (e.g. `pytest.skip`).\n- Never include real secret values \u2014 only test-mode placeholders or mocks.\n\n## Output Format\nReturn ONLY a JSON object:\n{\n  \"files\": [\n    { \"path\": \"tests/<name>\", \"content\": \"<full source>\" }\n  ],\n  \"secrets\": [\"UPPER_SNAKE_NAME\"],\n  \"integrationTests\": {\n    \"runner\": \"pytest\",\n    \"file\": \"tests/integration_test.py\",\n    \"requires\": [\"UPPER_SNAKE_NAME\"]\n  }\n}\n\n`secrets` is the list of env-var names the skill needs; purposes/hints will be emitted into `.env.example` by the caller.\n`runner` must be one of: \"pytest\", \"vitest\", \"none\".\n`path` must start with `tests/` and must not contain `..` or absolute paths.\nNo code fences, no preamble.";
+export declare const REFERENCE_SYSTEM_PROMPT = "You generate reference documentation files for a skill in Skill Studio.\n\nGiven the user's skill description, produce 1-3 markdown reference files under `references/` that document external schemas, APIs, or domain concepts the skill needs. Files must:\n- Be useful to a future maintainer reading the skill cold.\n- Cite specific field names, types, and behaviors when describing external schemas.\n- Stay under 300 lines each.\n\n## Output Format\nReturn ONLY a JSON object:\n{\n  \"files\": [\n    { \"path\": \"references/<name>.md\", \"content\": \"<full markdown>\" }\n  ]\n}\n\n`path` must start with `references/` and must not contain `..` or absolute paths.\nNo code fences, no preamble.";
+export declare function parseScriptResponse(text: string): ScriptAgentResponse;
+export declare function parseGraderResponse(text: string): GraderAgentResponse;
+export declare function parseTestResponse(text: string): TestAgentResponse;
+export declare function parseReferenceResponse(text: string): ReferenceAgentResponse;

package/dist/core/agent-prompts.js

@@ -0,0 +1,201 @@
+// ---------------------------------------------------------------------------
+// agent-prompts.ts — per-role system prompts + JSON parsers for the 0815
+// multi-file generation pipeline.
+//
+// Each agent owns one slice of a multi-file skill. They run in parallel under
+// generateSkill({ multiFile: true }) via Promise.allSettled; the body-agent
+// runs sequentially after, with the merged filename list as input, so SKILL.md
+// can link to produced files.
+//
+// Output shape is unified — every agent returns `{ files: [{path, content}] }`
+// so the route layer can write them in a single batch. Test-agent additionally
+// emits `secrets[]` and `integrationTests` (top-level manifest fields).
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// System prompts. Each is a constant string consumed by createLlmClient().
+// Kept terse on purpose — the user's skill description is the discriminator.
+// ---------------------------------------------------------------------------
+export const SCRIPT_SYSTEM_PROMPT = `You generate the deterministic helper script(s) for a skill in Skill Studio.
+
+Given the user's skill description, produce one or more language-appropriate helper scripts the skill will shell out to (e.g. \`scripts/audit.py\`, \`scripts/format.js\`). Scripts must:
+- Be self-contained and runnable from the skill directory.
+- Use only the standard library plus the dependencies you declare in \`runtime\`.
+- Read secrets from environment variables; never contain hardcoded API keys.
+- Degrade gracefully when env vars or external services are unavailable (print a clear message and exit non-zero, never crash on import).
+
+## Output Format
+Return ONLY a JSON object:
+{
+  "files": [
+    { "path": "scripts/<name>.<ext>", "content": "<full source>" }
+  ],
+  "runtime": { "python": ">=3.10", "pip": ["pkg>=1"] }
+}
+
+\`runtime\` is optional — omit if the script needs no runtime declaration.
+\`path\` is always relative to the skill root, must start with \`scripts/\`, and must not contain \`..\` or absolute paths.
+No code fences, no preamble.`;
+export const GRADER_SYSTEM_PROMPT = `You generate a deterministic grader script for a skill in Skill Studio.
+
+Given the user's skill description, produce a single grader script (e.g. \`scripts/grader.py\`) that takes the skill's output as input and returns a numeric score in [0, 1]. The grader must:
+- Be a pure function of its input — no network calls, no env reads.
+- Return a deterministic float between 0 and 1.
+- Match the language of the main script when possible.
+
+## Output Format
+Return ONLY a JSON object:
+{
+  "files": [
+    { "path": "scripts/grader.<ext>", "content": "<full source>" }
+  ]
+}
+
+\`path\` must start with \`scripts/\` and must not contain \`..\` or absolute paths.
+No code fences, no preamble.`;
+export const TEST_SYSTEM_PROMPT = `You generate a runnable integration test for a skill in Skill Studio.
+
+Given the user's skill description, produce ONE integration test file (e.g. \`tests/integration_test.py\` or \`tests/integration.test.ts\`) plus a top-level secrets declaration. The test must:
+- Be runnable via the declared runner (\`pytest\` or \`vitest\`).
+- Skip cleanly when required env vars are missing (e.g. \`pytest.skip\`).
+- Never include real secret values — only test-mode placeholders or mocks.
+
+## Output Format
+Return ONLY a JSON object:
+{
+  "files": [
+    { "path": "tests/<name>", "content": "<full source>" }
+  ],
+  "secrets": ["UPPER_SNAKE_NAME"],
+  "integrationTests": {
+    "runner": "pytest",
+    "file": "tests/integration_test.py",
+    "requires": ["UPPER_SNAKE_NAME"]
+  }
+}
+
+\`secrets\` is the list of env-var names the skill needs; purposes/hints will be emitted into \`.env.example\` by the caller.
+\`runner\` must be one of: "pytest", "vitest", "none".
+\`path\` must start with \`tests/\` and must not contain \`..\` or absolute paths.
+No code fences, no preamble.`;
+export const REFERENCE_SYSTEM_PROMPT = `You generate reference documentation files for a skill in Skill Studio.
+
+Given the user's skill description, produce 1-3 markdown reference files under \`references/\` that document external schemas, APIs, or domain concepts the skill needs. Files must:
+- Be useful to a future maintainer reading the skill cold.
+- Cite specific field names, types, and behaviors when describing external schemas.
+- Stay under 300 lines each.
+
+## Output Format
+Return ONLY a JSON object:
+{
+  "files": [
+    { "path": "references/<name>.md", "content": "<full markdown>" }
+  ]
+}
+
+\`path\` must start with \`references/\` and must not contain \`..\` or absolute paths.
+No code fences, no preamble.`;
+// ---------------------------------------------------------------------------
+// JSON parsers. Modeled on parseBodyResponse / parseEvalsResponse from
+// skill-create-routes.ts — strip optional code-fence wrappers, JSON.parse,
+// then validate the shape. Throw a descriptive Error on any malformed input
+// so Promise.allSettled in the generator captures it as a rejection.
+// ---------------------------------------------------------------------------
+function stripCodeFences(text) {
+    // Be tolerant: some models still wrap in ```json\n...\n``` despite "no fences".
+    const trimmed = text.trim();
+    const fenceMatch = trimmed.match(/^```(?:json)?\s*\n([\s\S]*?)\n```\s*$/);
+    return fenceMatch ? fenceMatch[1].trim() : trimmed;
+}
+function parseAgentJson(text, agent) {
+    const stripped = stripCodeFences(text);
+    // Some models emit a trailing ---REASONING--- block (matches body-agent
+    // pattern). Keep only the JSON portion.
+    const reasoningCut = stripped.split(/\n---REASONING---/i)[0].trim();
+    try {
+        return JSON.parse(reasoningCut);
+    }
+    catch (err) {
+        throw new Error(`${agent}-agent returned invalid JSON: ${err.message}. First 200 chars: ${reasoningCut.slice(0, 200)}`);
+    }
+}
+function validateFiles(raw, agent, pathPrefix) {
+    if (!raw || typeof raw !== "object") {
+        throw new Error(`${agent}-agent: response is not an object`);
+    }
+    const files = raw.files;
+    if (!Array.isArray(files) || files.length === 0) {
+        throw new Error(`${agent}-agent: missing or empty 'files' array`);
+    }
+    const out = [];
+    for (const f of files) {
+        if (!f || typeof f !== "object") {
+            throw new Error(`${agent}-agent: file entry is not an object`);
+        }
+        const path = f.path;
+        const content = f.content;
+        if (typeof path !== "string" || path.length === 0) {
+            throw new Error(`${agent}-agent: file.path must be a non-empty string`);
+        }
+        if (typeof content !== "string") {
+            throw new Error(`${agent}-agent: file.content must be a string`);
+        }
+        if (path.includes("..") || path.startsWith("/") || /^[a-zA-Z]:[\\/]/.test(path)) {
+            throw new Error(`${agent}-agent: refused unsafe path '${path}'`);
+        }
+        if (!path.startsWith(pathPrefix)) {
+            throw new Error(`${agent}-agent: path '${path}' must start with '${pathPrefix}'`);
+        }
+        out.push({ path, content });
+    }
+    return out;
+}
+export function parseScriptResponse(text) {
+    const raw = parseAgentJson(text, "script");
+    const files = validateFiles(raw, "script", "scripts/");
+    const r = raw.runtime;
+    let runtime;
+    if (r && typeof r === "object") {
+        const ro = r;
+        runtime = {
+            python: typeof ro.python === "string" ? ro.python : undefined,
+            pip: Array.isArray(ro.pip) ? ro.pip.filter((p) => typeof p === "string") : undefined,
+            node: typeof ro.node === "string" ? ro.node : undefined,
+        };
+    }
+    return { files, runtime };
+}
+export function parseGraderResponse(text) {
+    const raw = parseAgentJson(text, "grader");
+    const files = validateFiles(raw, "grader", "scripts/");
+    return { files };
+}
+export function parseTestResponse(text) {
+    const raw = parseAgentJson(text, "test");
+    const files = validateFiles(raw, "test", "tests/");
+    const r = raw;
+    const secrets = Array.isArray(r.secrets)
+        ? r.secrets.filter((s) => typeof s === "string")
+        : undefined;
+    let integrationTests;
+    const it = r.integrationTests;
+    if (it && typeof it === "object") {
+        const ito = it;
+        const runner = ito.runner;
+        if (runner === "pytest" || runner === "vitest" || runner === "none") {
+            integrationTests = {
+                runner,
+                file: typeof ito.file === "string" ? ito.file : undefined,
+                requires: Array.isArray(ito.requires)
+                    ? ito.requires.filter((r2) => typeof r2 === "string")
+                    : undefined,
+            };
+        }
+    }
+    return { files, secrets, integrationTests };
+}
+export function parseReferenceResponse(text) {
+    const raw = parseAgentJson(text, "reference");
+    const files = validateFiles(raw, "reference", "references/");
+    return { files };
+}
+//# sourceMappingURL=agent-prompts.js.map

package/dist/core/agent-prompts.js.map

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