@sentry/warden 0.22.0 → 0.23.0

package/dist/skill-builder/agentic.js

@@ -0,0 +1,240 @@
+import { performance } from 'node:perf_hooks';
+import { z } from 'zod';
+import { parseJsonFromOutput } from '../sdk/json-output.js';
+import { buildJsonOutputSection, buildTaggedSection, joinPromptSections } from '../sdk/prompt-sections.js';
+import { aggregateUsage, emptyUsage } from '../sdk/usage.js';
+const SKILL_BUILDER_READ_TOOLS = ['Read', 'Grep', 'Glob', 'WebFetch', 'WebSearch'];
+const SKILL_BUILDER_WRITE_TOOLS = ['Read', 'Grep', 'Glob', 'Write', 'Edit', 'Bash', 'WebFetch', 'WebSearch'];
+const STRUCTURED_REPAIR_MAX_TURNS = 1;
+const STRUCTURED_REPAIR_MAX_CHARS = 60_000;
+export class StructuredSkillBuilderAgentError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'StructuredSkillBuilderAgentError';
+    }
+}
+function formatRuntimeFailure(result) {
+    if (result.errors.length > 0) {
+        return result.errors.join('; ');
+    }
+    return `Runtime status: ${result.status}`;
+}
+function previewText(value, maxLength = 1200) {
+    const trimmed = value?.trim();
+    if (!trimmed)
+        return '<empty>';
+    if (trimmed.length <= maxLength)
+        return trimmed;
+    return `${trimmed.slice(0, maxLength)}...`;
+}
+function formatAgentFailure(message, details) {
+    const lines = [message];
+    if (details.responseModel) {
+        lines.push(`  Model: ${details.responseModel}`);
+    }
+    if (details.durationMs !== undefined) {
+        lines.push(`  Duration: ${(details.durationMs / 1000).toFixed(1)}s`);
+    }
+    if (details.usage) {
+        lines.push(`  Usage: ${details.usage.inputTokens.toLocaleString()} input / ` +
+            `${details.usage.outputTokens.toLocaleString()} output tokens / ` +
+            `$${details.usage.costUSD.toFixed(4)}`);
+    }
+    if (details.numTurns !== undefined) {
+        lines.push(`  Turns: ${details.numTurns}`);
+    }
+    if (details.stderr?.trim()) {
+        lines.push('  Claude Code stderr:');
+        lines.push(`  ${previewText(details.stderr).replace(/\n/g, '\n  ')}`);
+    }
+    if (details.rawText !== undefined) {
+        lines.push('  Raw output:');
+        lines.push(`  ${previewText(details.rawText).replace(/\n/g, '\n  ')}`);
+    }
+    return lines.join('\n');
+}
+function resultFailureDetails(result, stderr, startedAt) {
+    return {
+        rawText: result?.text,
+        stderr,
+        usage: result?.usage,
+        durationMs: result?.durationMs ?? performance.now() - startedAt,
+        responseModel: result?.responseModel,
+        numTurns: result?.numTurns,
+    };
+}
+function truncateForRepair(output) {
+    if (output.length <= STRUCTURED_REPAIR_MAX_CHARS) {
+        return output;
+    }
+    return `${output.slice(0, STRUCTURED_REPAIR_MAX_CHARS)}\n[... truncated]`;
+}
+function structuredRepairSystemPrompt() {
+    return `You repair model output into strict JSON for Warden.
+
+Return only valid JSON matching the provided JSON Schema. Do not include markdown, prose, code fences, or explanations. Preserve the original structured content whenever possible and do not invent extra fields.`;
+}
+function structuredRepairPrompt(args) {
+    return joinPromptSections([
+        `<task>
+Repair this model output into valid JSON that matches the provided JSON Schema.
+</task>`,
+        buildJsonOutputSection(`Remove surrounding prose or markdown only when needed.
+Preserve the original structured content as much as possible.
+Do not invent extra fields.`),
+        buildTaggedSection('parse_error', args.reason),
+        buildTaggedSection('json_schema', JSON.stringify(z.toJSONSchema(args.schema), null, 2)),
+        buildTaggedSection('model_output', truncateForRepair(args.output)),
+    ]);
+}
+async function repairStructuredSkillBuilderOutput(args) {
+    const response = await args.runtime.runSkill({
+        systemPrompt: structuredRepairSystemPrompt(),
+        userPrompt: structuredRepairPrompt({
+            schema: args.schema,
+            output: args.output,
+            reason: args.reason,
+        }),
+        repoPath: args.repoPath,
+        skillName: `${args.skillName}:structured-output-repair`,
+        tools: { allowed: [] },
+        options: {
+            model: args.model,
+            maxTurns: STRUCTURED_REPAIR_MAX_TURNS,
+            abortController: args.abortController,
+        },
+    });
+    if (response.authError) {
+        return {
+            success: false,
+            error: `repair_failed: ${response.authError}`,
+        };
+    }
+    if (!response.result) {
+        return {
+            success: false,
+            error: 'repair_failed: no_result',
+        };
+    }
+    if (response.result.status !== 'success') {
+        return {
+            success: false,
+            error: `repair_failed: ${formatRuntimeFailure(response.result)}`,
+            usage: response.result.usage,
+        };
+    }
+    const parsed = await parseJsonFromOutput({
+        output: response.result.text,
+        schema: args.schema,
+    });
+    if (!parsed.success) {
+        return {
+            success: false,
+            error: `repair_failed: ${parsed.error}`,
+            json: parsed.json,
+            usage: response.result.usage,
+        };
+    }
+    return {
+        success: true,
+        data: parsed.data,
+        json: parsed.json,
+        repaired: true,
+        usage: response.result.usage,
+    };
+}
+export async function runStructuredSkillBuilderAgent(args) {
+    const startedAt = performance.now();
+    const { runtime } = args;
+    const response = await runtime.runSkill({
+        systemPrompt: args.systemPrompt,
+        userPrompt: args.userPrompt,
+        repoPath: args.repoPath,
+        skillName: args.skillName,
+        tools: { allowed: args.writeAccess ? SKILL_BUILDER_WRITE_TOOLS : SKILL_BUILDER_READ_TOOLS },
+        allowMutatingTools: args.writeAccess,
+        options: {
+            model: args.model,
+            maxTurns: args.maxTurns,
+            abortController: args.abortController,
+        },
+    });
+    if (response.authError) {
+        throw new StructuredSkillBuilderAgentError(response.authError);
+    }
+    if (!response.result) {
+        throw new StructuredSkillBuilderAgentError(formatAgentFailure('Skill builder agent returned no result', resultFailureDetails(undefined, response.stderr, startedAt)));
+    }
+    if (response.result.status !== 'success') {
+        throw new StructuredSkillBuilderAgentError(formatAgentFailure(formatRuntimeFailure(response.result), resultFailureDetails(response.result, response.stderr, startedAt)));
+    }
+    const repairUsages = [];
+    let parsed = await parseJsonFromOutput({
+        output: response.result.text,
+        schema: args.schema,
+    });
+    if (!parsed.success) {
+        const skillRepair = await repairStructuredSkillBuilderOutput({
+            runtime,
+            repoPath: args.repoPath,
+            skillName: args.skillName,
+            schema: args.schema,
+            output: response.result.text,
+            reason: parsed.error,
+            model: args.repair?.model ?? args.model,
+            abortController: args.abortController,
+        });
+        if (skillRepair.usage) {
+            repairUsages.push(skillRepair.usage);
+        }
+        if (skillRepair.success) {
+            parsed = skillRepair;
+        }
+        else if (args.repair?.apiKey) {
+            const auxiliaryRepair = await parseJsonFromOutput({
+                output: response.result.text,
+                schema: args.schema,
+                repair: {
+                    runtime,
+                    apiKey: args.repair.apiKey,
+                    model: args.repair.model,
+                    maxRetries: args.repair.maxRetries,
+                },
+            });
+            if (auxiliaryRepair.usage) {
+                repairUsages.push(auxiliaryRepair.usage);
+            }
+            parsed = auxiliaryRepair.success
+                ? auxiliaryRepair
+                : {
+                    ...auxiliaryRepair,
+                    error: `${skillRepair.error}; ${auxiliaryRepair.error}`,
+                    json: auxiliaryRepair.json ?? skillRepair.json ?? parsed.json,
+                };
+        }
+        else {
+            parsed = skillRepair;
+        }
+    }
+    if (!parsed.success) {
+        const label = parsed.error.startsWith('no_json')
+            ? `Skill builder agent returned no JSON: ${parsed.error}`
+            : parsed.error.startsWith('invalid_json')
+                ? `Skill builder agent returned invalid JSON: ${parsed.error}`
+                : `Skill builder agent output failed validation or repair: ${parsed.error}`;
+        throw new StructuredSkillBuilderAgentError(formatAgentFailure(label, {
+            ...resultFailureDetails(response.result, response.stderr, startedAt),
+            rawText: parsed.json ?? response.result.text,
+            usage: aggregateUsage([response.result.usage ?? emptyUsage(), ...repairUsages]),
+        }));
+    }
+    const usage = aggregateUsage([response.result.usage ?? emptyUsage(), ...repairUsages]);
+    return {
+        data: parsed.data,
+        usage,
+        durationMs: response.result.durationMs ?? performance.now() - startedAt,
+        responseModel: response.result.responseModel,
+        numTurns: response.result.numTurns,
+    };
+}
+//# sourceMappingURL=agentic.js.map

package/dist/skill-builder/agentic.js.map

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

package/dist/skill-builder/authoring-provider.d.ts

@@ -0,0 +1,5 @@
+import type { SkillBuildAuthoringProvider } from './skill-contract.js';
+export declare function resolveAuthoringProvider(args?: {
+    authoringSkillRoot?: string;
+}): SkillBuildAuthoringProvider;
+//# sourceMappingURL=authoring-provider.d.ts.map

package/dist/skill-builder/authoring-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring-provider.d.ts","sourceRoot":"","sources":["../../src/skill-builder/authoring-provider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAkDvE,wBAAgB,wBAAwB,CAAC,IAAI,GAAE;IAC7C,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,2BAA2B,CA0BnC"}

package/dist/skill-builder/authoring-provider.js

@@ -0,0 +1,70 @@
+import { createHash } from 'node:crypto';
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { basename, dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const DEFAULT_AUTHORING_SKILL_NAME = 'skill-writer';
+const AUTHORING_PROVIDER_ENV = 'WARDEN_SKILL_AUTHORING_ROOT';
+function hashDirectory(rootDir) {
+    const hash = createHash('sha256');
+    function visit(relativeDir) {
+        const absoluteDir = join(rootDir, relativeDir);
+        for (const entry of readdirSync(absoluteDir, { withFileTypes: true })
+            .sort((a, b) => a.name.localeCompare(b.name))) {
+            if (entry.name === '.git' || entry.name === 'node_modules') {
+                continue;
+            }
+            const relativePath = relativeDir ? `${relativeDir}/${entry.name}` : entry.name;
+            const absolutePath = join(rootDir, relativePath);
+            if (entry.isDirectory()) {
+                visit(relativePath);
+                continue;
+            }
+            if (!entry.isFile()) {
+                continue;
+            }
+            hash.update(relativePath);
+            hash.update('\0');
+            hash.update(readFileSync(absolutePath));
+            hash.update('\0');
+        }
+    }
+    visit('');
+    return hash.digest('hex');
+}
+function candidateAuthoringSkillRoots() {
+    const fromEnv = process.env[AUTHORING_PROVIDER_ENV];
+    const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..', '..');
+    return [
+        fromEnv ? resolve(fromEnv) : undefined,
+        join(packageRoot, 'src', 'internal-skills', DEFAULT_AUTHORING_SKILL_NAME),
+    ].filter((path) => Boolean(path));
+}
+function authoringSkillName(rootDir) {
+    const content = readFileSync(join(rootDir, 'SKILL.md'), 'utf-8');
+    const match = /^name:\s*["']?([^"'\n]+)["']?$/m.exec(content);
+    return match?.[1]?.trim() || basename(rootDir);
+}
+export function resolveAuthoringProvider(args = {}) {
+    const roots = args.authoringSkillRoot
+        ? [resolve(args.authoringSkillRoot)]
+        : candidateAuthoringSkillRoots();
+    for (const rootDir of roots) {
+        const skillPath = join(rootDir, 'SKILL.md');
+        if (!existsSync(skillPath)) {
+            continue;
+        }
+        const stat = statSync(skillPath);
+        if (!stat.isFile()) {
+            continue;
+        }
+        return {
+            name: authoringSkillName(rootDir),
+            rootDir,
+            contentHash: hashDirectory(rootDir),
+        };
+    }
+    const searched = roots.map((root) => `- ${root}`).join('\n');
+    throw new Error(`Unable to find generated-skill authoring provider "${DEFAULT_AUTHORING_SKILL_NAME}". ` +
+        `Set ${AUTHORING_PROVIDER_ENV} or ensure the internal provider is packaged in one of:\n${searched}`);
+}
+//# sourceMappingURL=authoring-provider.js.map

package/dist/skill-builder/authoring-provider.js.map

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

package/dist/skill-builder/definition.d.ts

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import type { SkillDefinition } from '../config/schema.js';
+export declare const GENERATED_SKILLS_DIR = ".warden/skills";
+export declare const GENERATED_SKILL_DEFINITION_FILE = "warden.yaml";
+export declare const BUILD_STATE_FILE = "build-state.json";
+export declare const GeneratedSkillDefinitionSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    kind: z.ZodLiteral<"generated-skill">;
+    name: z.ZodString;
+    prompt: z.ZodString;
+    instructions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    coverage: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$loose>;
+export type GeneratedSkillDefinition = z.infer<typeof GeneratedSkillDefinitionSchema>;
+/** A generated skill target resolved from a CLI name or filesystem path. */
+export interface GeneratedSkillTarget {
+    displayName: string;
+    isPath: boolean;
+    rootDir: string;
+}
+export interface GeneratedSkillArtifactFile {
+    path: string;
+    content: string;
+    bytes: number;
+}
+export declare function inferGeneratedSkillDescription(name: string, prompt: string): string;
+export declare function getGeneratedSkillRoot(repoRoot: string, skillName: string): string;
+export declare function generatedSkillDefinitionRootExists(rootDir: string): boolean;
+/** Resolve a generated skill CLI target using the shared name and path semantics. */
+export declare function resolveGeneratedSkillTarget(repoRoot: string, target: string): GeneratedSkillTarget;
+export declare function resolveGeneratedSkillRoot(repoRoot: string, skillName: string): string;
+export declare function loadGeneratedSkillDefinition(rootDir: string): {
+    content: string;
+    data: GeneratedSkillDefinition;
+};
+export declare function buildGeneratedSkillDefinition(rootDir: string): SkillDefinition;
+export declare function createGeneratedSkillDefinition(args: {
+    repoRoot: string;
+    name: string;
+    prompt: string;
+    rootDir?: string;
+}): SkillDefinition;
+export declare function clearGeneratedSkillArtifacts(rootDir: string): void;
+/** Read generated runtime artifacts while excluding Warden-owned metadata files. */
+export declare function readGeneratedSkillArtifactFiles(rootDir: string): GeneratedSkillArtifactFile[];
+//# sourceMappingURL=definition.d.ts.map

package/dist/skill-builder/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/skill-builder/definition.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AACrD,eAAO,MAAM,+BAA+B,gBAAgB,CAAC;AAC7D,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAQnD,eAAO,MAAM,8BAA8B;;;;;;;iBAO3B,CAAC;AAEjB,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,4EAA4E;AAC5E,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAuBD,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAgBnF;AAUD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3E;AAED,qFAAqF;AACrF,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,oBAAoB,CAclG;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CASrF;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,wBAAwB,CAAC;CAChC,CAkBA;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAQ9E;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,eAAe,CAYlB;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAUlE;AAED,oFAAoF;AACpF,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,GAAG,0BAA0B,EAAE,CA+B7F"}

package/dist/skill-builder/definition.js

@@ -0,0 +1,171 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { z } from 'zod';
+import { isPathLike, resolvePathTarget } from '../utils/path.js';
+export const GENERATED_SKILLS_DIR = '.warden/skills';
+export const GENERATED_SKILL_DEFINITION_FILE = 'warden.yaml';
+export const BUILD_STATE_FILE = 'build-state.json';
+const DESCRIPTION_MAX_LENGTH = 88;
+const EXISTING_GENERATED_SKILL_DIRS = [
+    GENERATED_SKILLS_DIR,
+    '.agents/skills',
+    '.claude/skills',
+];
+export const GeneratedSkillDefinitionSchema = z.object({
+    version: z.literal(1),
+    kind: z.literal('generated-skill'),
+    name: z.string().min(1),
+    prompt: z.string().min(1),
+    instructions: z.array(z.string().min(1)).optional(),
+    coverage: z.array(z.string().min(1)).optional(),
+}).passthrough();
+function safePathSegment(value) {
+    return value.replace(/[^a-zA-Z0-9._-]/g, '-');
+}
+function firstSentence(value) {
+    return value.trim().split(/(?<=[.!?])\s+/)[0] ?? value.trim();
+}
+function normalizeOneLine(value) {
+    return value.replace(/\s+/g, ' ').trim();
+}
+function ensureSentenceEnding(value) {
+    const trimmed = value.trim().replace(/[,;:]+$/, '');
+    return /[.!?]$/.test(trimmed) ? trimmed : `${trimmed}.`;
+}
+function firstClause(value) {
+    return value.split(/[,;:]\s+/)[0] ?? value;
+}
+export function inferGeneratedSkillDescription(name, prompt) {
+    const fallback = `${name}.`;
+    const sentence = normalizeOneLine(firstSentence(prompt));
+    if (!sentence) {
+        return fallback;
+    }
+    let description = sentence;
+    if (description.length > DESCRIPTION_MAX_LENGTH && /[,;:]\s+/.test(description)) {
+        description = firstClause(description);
+    }
+    description = ensureSentenceEnding(description);
+    if (description.length > DESCRIPTION_MAX_LENGTH) {
+        description = `${description.slice(0, DESCRIPTION_MAX_LENGTH - 3).trimEnd()}...`;
+    }
+    return description;
+}
+function yamlBlock(value, indent = '  ') {
+    return value.split('\n').map((line) => `${indent}${line}`).join('\n');
+}
+function getGeneratedSkillsRoot(repoRoot) {
+    return join(repoRoot, GENERATED_SKILLS_DIR);
+}
+export function getGeneratedSkillRoot(repoRoot, skillName) {
+    return join(getGeneratedSkillsRoot(repoRoot), safePathSegment(skillName));
+}
+export function generatedSkillDefinitionRootExists(rootDir) {
+    return existsSync(join(rootDir, GENERATED_SKILL_DEFINITION_FILE));
+}
+/** Resolve a generated skill CLI target using the shared name and path semantics. */
+export function resolveGeneratedSkillTarget(repoRoot, target) {
+    if (isPathLike(target)) {
+        return {
+            displayName: target,
+            isPath: true,
+            rootDir: resolvePathTarget(target, repoRoot),
+        };
+    }
+    return {
+        displayName: target,
+        isPath: false,
+        rootDir: resolveGeneratedSkillRoot(repoRoot, target),
+    };
+}
+export function resolveGeneratedSkillRoot(repoRoot, skillName) {
+    const safeName = safePathSegment(skillName);
+    for (const dir of EXISTING_GENERATED_SKILL_DIRS) {
+        const rootDir = join(repoRoot, dir, safeName);
+        if (generatedSkillDefinitionRootExists(rootDir)) {
+            return rootDir;
+        }
+    }
+    return getGeneratedSkillRoot(repoRoot, skillName);
+}
+export function loadGeneratedSkillDefinition(rootDir) {
+    const definitionPath = join(rootDir, GENERATED_SKILL_DEFINITION_FILE);
+    const content = readFileSync(definitionPath, 'utf-8');
+    let parsed;
+    try {
+        parsed = parseYaml(content);
+    }
+    catch (error) {
+        throw new Error(`Generated skill definition is not valid YAML: ${definitionPath}`, { cause: error });
+    }
+    const validation = GeneratedSkillDefinitionSchema.safeParse(parsed);
+    if (!validation.success) {
+        throw new Error(`Generated skill definition is invalid: ${validation.error.message}`, {
+            cause: validation.error,
+        });
+    }
+    return { content, data: validation.data };
+}
+export function buildGeneratedSkillDefinition(rootDir) {
+    const { data } = loadGeneratedSkillDefinition(rootDir);
+    return {
+        name: data.name,
+        description: inferGeneratedSkillDescription(data.name, data.prompt),
+        prompt: data.prompt,
+        rootDir,
+    };
+}
+export function createGeneratedSkillDefinition(args) {
+    const rootDir = args.rootDir ?? getGeneratedSkillRoot(args.repoRoot, args.name);
+    mkdirSync(rootDir, { recursive: true });
+    writeFileSync(join(rootDir, GENERATED_SKILL_DEFINITION_FILE), `version: 1
+kind: generated-skill
+name: ${args.name}
+prompt: |-
+${yamlBlock(args.prompt.trim())}
+`, 'utf-8');
+    return buildGeneratedSkillDefinition(rootDir);
+}
+export function clearGeneratedSkillArtifacts(rootDir) {
+    if (!existsSync(rootDir)) {
+        return;
+    }
+    for (const entry of readdirSync(rootDir, { withFileTypes: true })) {
+        if (entry.name === GENERATED_SKILL_DEFINITION_FILE || entry.name === BUILD_STATE_FILE) {
+            continue;
+        }
+        rmSync(join(rootDir, entry.name), { recursive: true, force: true });
+    }
+}
+/** Read generated runtime artifacts while excluding Warden-owned metadata files. */
+export function readGeneratedSkillArtifactFiles(rootDir) {
+    if (!existsSync(rootDir)) {
+        return [];
+    }
+    const files = [];
+    function visit(relativeDir) {
+        for (const entry of readdirSync(join(rootDir, relativeDir), { withFileTypes: true })) {
+            const relativePath = relativeDir ? `${relativeDir}/${entry.name}` : entry.name;
+            if (!relativeDir && (entry.name === GENERATED_SKILL_DEFINITION_FILE || entry.name === BUILD_STATE_FILE)) {
+                continue;
+            }
+            if (entry.isDirectory()) {
+                visit(relativePath);
+                continue;
+            }
+            if (!entry.isFile()) {
+                continue;
+            }
+            const content = readFileSync(join(rootDir, relativePath), 'utf-8');
+            files.push({
+                path: relativePath,
+                content,
+                bytes: Buffer.byteLength(content, 'utf-8'),
+            });
+        }
+    }
+    visit('');
+    return files.sort((a, b) => a.path.localeCompare(b.path));
+}
+//# sourceMappingURL=definition.js.map

package/dist/skill-builder/definition.js.map

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