@sentry/warden 0.22.0 → 0.23.0

package/dist/skill-builder/outline-contract.d.ts

@@ -0,0 +1,113 @@
+import { z } from 'zod';
+import type { UsageStats } from '../types/index.js';
+export declare const SKILL_BUILD_VERSION = "1";
+export declare const SKILL_BUILD_OUTLINE_SCHEMA_VERSION = 1;
+export declare const SkillBuildExternalSourceSchema: z.ZodObject<{
+    title: z.ZodString;
+    url: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strict>;
+export declare const SkillBuildPhaseSchema: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodEnum<{
+        cached: "cached";
+        generated: "generated";
+        validated: "validated";
+    }>;
+}, z.core.$strict>;
+export declare const SkillBuildScopeProfileSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        repository: "repository";
+        ecosystem: "ecosystem";
+        domain: "domain";
+        product: "product";
+    }>;
+    subject: z.ZodString;
+    localContextUsed: z.ZodBoolean;
+    observedContext: z.ZodArray<z.ZodString>;
+    unresolvedContext: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export declare const SkillBuildTrackSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    goal: z.ZodString;
+    rationale: z.ZodString;
+    sourceSignals: z.ZodArray<z.ZodString>;
+    owns: z.ZodArray<z.ZodString>;
+    excludes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    relevanceSignals: z.ZodArray<z.ZodString>;
+    evidenceFocus: z.ZodArray<z.ZodString>;
+    checks: z.ZodArray<z.ZodString>;
+    safeCounterpatterns: z.ZodArray<z.ZodString>;
+    falsePositiveTraps: z.ZodArray<z.ZodString>;
+    researchHints: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export declare const SkillBuildOutlineSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    skill: z.ZodString;
+    sourceHash: z.ZodString;
+    buildVersion: z.ZodString;
+    scopeProfile: z.ZodObject<{
+        kind: z.ZodEnum<{
+            repository: "repository";
+            ecosystem: "ecosystem";
+            domain: "domain";
+            product: "product";
+        }>;
+        subject: z.ZodString;
+        localContextUsed: z.ZodBoolean;
+        observedContext: z.ZodArray<z.ZodString>;
+        unresolvedContext: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>;
+    build: z.ZodObject<{
+        phases: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            status: z.ZodEnum<{
+                cached: "cached";
+                generated: "generated";
+                validated: "validated";
+            }>;
+        }, z.core.$strict>>;
+        externalSources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            url: z.ZodString;
+            reason: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+    tracks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        goal: z.ZodString;
+        rationale: z.ZodString;
+        sourceSignals: z.ZodArray<z.ZodString>;
+        owns: z.ZodArray<z.ZodString>;
+        excludes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        relevanceSignals: z.ZodArray<z.ZodString>;
+        evidenceFocus: z.ZodArray<z.ZodString>;
+        checks: z.ZodArray<z.ZodString>;
+        safeCounterpatterns: z.ZodArray<z.ZodString>;
+        falsePositiveTraps: z.ZodArray<z.ZodString>;
+        researchHints: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type SkillBuildOutline = z.infer<typeof SkillBuildOutlineSchema>;
+export interface SkillBuildSourceFile {
+    path: string;
+    content: string;
+}
+export interface SkillBuildSource {
+    hash: string;
+    files: SkillBuildSourceFile[];
+}
+export type SkillBuildOutlineSource = 'cache' | 'generated';
+export interface SkillBuildOutlineResult {
+    outline: SkillBuildOutline;
+    source: SkillBuildOutlineSource;
+    statePath: string;
+    usage?: UsageStats;
+    durationMs?: number;
+    responseModel?: string;
+    numTurns?: number;
+}
+export declare function outlineHash(outline: SkillBuildOutline): string;
+//# sourceMappingURL=outline-contract.d.ts.map

package/dist/skill-builder/outline-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outline-contract.d.ts","sourceRoot":"","sources":["../../src/skill-builder/outline-contract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,kCAAkC,IAAI,CAAC;AAIpD,eAAO,MAAM,8BAA8B;;;;kBAIhC,CAAC;AAEZ,eAAO,MAAM,qBAAqB;;;;;;;kBAGvB,CAAC;AAEZ,eAAO,MAAM,4BAA4B;;;;;;;;;;;kBAqBvC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;kBAcvB,CAAC;AAEZ,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAWzB,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,oBAAoB,EAAE,CAAC;CAC/B;AAED,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,WAAW,CAAC;AAE5D,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,uBAAuB,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAQ9D"}

package/dist/skill-builder/outline-contract.js

@@ -0,0 +1,73 @@
+import { createHash } from 'node:crypto';
+import { z } from 'zod';
+export const SKILL_BUILD_VERSION = '1';
+export const SKILL_BUILD_OUTLINE_SCHEMA_VERSION = 1;
+const OutlinePhaseStatusSchema = z.enum(['cached', 'generated', 'validated']);
+export const SkillBuildExternalSourceSchema = z.object({
+    title: z.string().min(1),
+    url: z.string().min(1),
+    reason: z.string().min(1),
+}).strict();
+export const SkillBuildPhaseSchema = z.object({
+    id: z.string().min(1),
+    status: OutlinePhaseStatusSchema,
+}).strict();
+export const SkillBuildScopeProfileSchema = z.object({
+    kind: z.enum(['domain', 'ecosystem', 'repository', 'product']),
+    subject: z.string().min(1),
+    localContextUsed: z.boolean(),
+    observedContext: z.array(z.string().min(1)).min(1),
+    unresolvedContext: z.array(z.string().min(1)).default([]),
+}).strict().superRefine((value, ctx) => {
+    if (value.kind === 'repository' && !value.localContextUsed) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'repository scope requires localContextUsed to be true',
+            path: ['localContextUsed'],
+        });
+    }
+    if (value.localContextUsed && value.observedContext.length === 0) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'observedContext is required when localContextUsed is true',
+            path: ['observedContext'],
+        });
+    }
+});
+export const SkillBuildTrackSchema = z.object({
+    id: z.string().min(1).regex(/^[a-z0-9][a-z0-9-]*$/),
+    title: z.string().min(1),
+    goal: z.string().min(1),
+    rationale: z.string().min(1),
+    sourceSignals: z.array(z.string().min(1)).min(1),
+    owns: z.array(z.string().min(1)).min(1),
+    excludes: z.array(z.string().min(1)).default([]),
+    relevanceSignals: z.array(z.string().min(1)).min(1),
+    evidenceFocus: z.array(z.string().min(1)).min(1),
+    checks: z.array(z.string().min(1)).min(1),
+    safeCounterpatterns: z.array(z.string().min(1)).min(1),
+    falsePositiveTraps: z.array(z.string().min(1)).min(1),
+    researchHints: z.array(z.string().min(1)).default([]),
+}).strict();
+export const SkillBuildOutlineSchema = z.object({
+    version: z.literal(SKILL_BUILD_OUTLINE_SCHEMA_VERSION),
+    skill: z.string().min(1),
+    sourceHash: z.string().min(1),
+    buildVersion: z.string().min(1),
+    scopeProfile: SkillBuildScopeProfileSchema,
+    build: z.object({
+        phases: z.array(SkillBuildPhaseSchema).min(1),
+        externalSources: z.array(SkillBuildExternalSourceSchema).optional(),
+    }).strict(),
+    tracks: z.array(SkillBuildTrackSchema).min(1),
+}).strict();
+export function outlineHash(outline) {
+    return createHash('sha256').update(JSON.stringify({
+        skill: outline.skill,
+        sourceHash: outline.sourceHash,
+        buildVersion: outline.buildVersion,
+        tracks: outline.tracks,
+        scopeProfile: outline.scopeProfile,
+    })).digest('hex');
+}
+//# sourceMappingURL=outline-contract.js.map

package/dist/skill-builder/outline-contract.js.map

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

package/dist/skill-builder/outline-state.d.ts

@@ -0,0 +1,158 @@
+import { z } from 'zod';
+export declare const SKILL_BUILD_STATE_SCHEMA_VERSION = 1;
+export declare const SKILL_BUILD_STATE_KIND = "skill-build-state";
+export declare const GeneratedSkillArtifactStateSchema: z.ZodObject<{
+    version: z.ZodLiteral<5>;
+    sourceHash: z.ZodString;
+    outlineHash: z.ZodString;
+    buildVersion: z.ZodString;
+    authoringProvider: z.ZodObject<{
+        name: z.ZodString;
+        rootDir: z.ZodString;
+        contentHash: z.ZodString;
+    }, z.core.$strict>;
+    name: z.ZodString;
+    fileManifest: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        bytes: z.ZodNumber;
+    }, z.core.$strict>>;
+    deterministicWarnings: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    bytes: z.ZodNumber;
+    durationMs: z.ZodNumber;
+    usage: z.ZodObject<{
+        inputTokens: z.ZodNumber;
+        outputTokens: z.ZodNumber;
+        cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheCreation5mInputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheCreation1hInputTokens: z.ZodOptional<z.ZodNumber>;
+        webSearchRequests: z.ZodOptional<z.ZodNumber>;
+        costUSD: z.ZodNumber;
+    }, z.core.$strip>;
+    externalSources: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        url: z.ZodString;
+        reason: z.ZodString;
+    }, z.core.$strict>>;
+    missingInputs: z.ZodArray<z.ZodString>;
+    authoringWarnings: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    responseModel: z.ZodOptional<z.ZodString>;
+    numTurns: z.ZodOptional<z.ZodNumber>;
+    generatedAt: z.ZodString;
+}, z.core.$strict>;
+export type GeneratedSkillArtifactState = z.infer<typeof GeneratedSkillArtifactStateSchema>;
+export declare const SkillBuildStateSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    kind: z.ZodLiteral<"skill-build-state">;
+    identity: z.ZodOptional<z.ZodObject<{
+        requestedModel: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    outline: z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        skill: z.ZodString;
+        sourceHash: z.ZodString;
+        buildVersion: z.ZodString;
+        scopeProfile: z.ZodObject<{
+            kind: z.ZodEnum<{
+                repository: "repository";
+                ecosystem: "ecosystem";
+                domain: "domain";
+                product: "product";
+            }>;
+            subject: z.ZodString;
+            localContextUsed: z.ZodBoolean;
+            observedContext: z.ZodArray<z.ZodString>;
+            unresolvedContext: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>;
+        build: z.ZodObject<{
+            phases: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                status: z.ZodEnum<{
+                    cached: "cached";
+                    generated: "generated";
+                    validated: "validated";
+                }>;
+            }, z.core.$strict>>;
+            externalSources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                url: z.ZodString;
+                reason: z.ZodString;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>;
+        tracks: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            goal: z.ZodString;
+            rationale: z.ZodString;
+            sourceSignals: z.ZodArray<z.ZodString>;
+            owns: z.ZodArray<z.ZodString>;
+            excludes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            relevanceSignals: z.ZodArray<z.ZodString>;
+            evidenceFocus: z.ZodArray<z.ZodString>;
+            checks: z.ZodArray<z.ZodString>;
+            safeCounterpatterns: z.ZodArray<z.ZodString>;
+            falsePositiveTraps: z.ZodArray<z.ZodString>;
+            researchHints: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    outlineRun: z.ZodOptional<z.ZodObject<{
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        usage: z.ZodOptional<z.ZodObject<{
+            inputTokens: z.ZodNumber;
+            outputTokens: z.ZodNumber;
+            cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+            cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
+            cacheCreation5mInputTokens: z.ZodOptional<z.ZodNumber>;
+            cacheCreation1hInputTokens: z.ZodOptional<z.ZodNumber>;
+            webSearchRequests: z.ZodOptional<z.ZodNumber>;
+            costUSD: z.ZodNumber;
+        }, z.core.$strip>>;
+        responseModel: z.ZodOptional<z.ZodString>;
+        numTurns: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    artifact: z.ZodOptional<z.ZodObject<{
+        version: z.ZodLiteral<5>;
+        sourceHash: z.ZodString;
+        outlineHash: z.ZodString;
+        buildVersion: z.ZodString;
+        authoringProvider: z.ZodObject<{
+            name: z.ZodString;
+            rootDir: z.ZodString;
+            contentHash: z.ZodString;
+        }, z.core.$strict>;
+        name: z.ZodString;
+        fileManifest: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            bytes: z.ZodNumber;
+        }, z.core.$strict>>;
+        deterministicWarnings: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        bytes: z.ZodNumber;
+        durationMs: z.ZodNumber;
+        usage: z.ZodObject<{
+            inputTokens: z.ZodNumber;
+            outputTokens: z.ZodNumber;
+            cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+            cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
+            cacheCreation5mInputTokens: z.ZodOptional<z.ZodNumber>;
+            cacheCreation1hInputTokens: z.ZodOptional<z.ZodNumber>;
+            webSearchRequests: z.ZodOptional<z.ZodNumber>;
+            costUSD: z.ZodNumber;
+        }, z.core.$strip>;
+        externalSources: z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            url: z.ZodString;
+            reason: z.ZodString;
+        }, z.core.$strict>>;
+        missingInputs: z.ZodArray<z.ZodString>;
+        authoringWarnings: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        responseModel: z.ZodOptional<z.ZodString>;
+        numTurns: z.ZodOptional<z.ZodNumber>;
+        generatedAt: z.ZodString;
+    }, z.core.$strict>>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type SkillBuildState = z.infer<typeof SkillBuildStateSchema>;
+export declare function getBuildStatePath(rootDir: string): string;
+export declare function readSkillBuildState(path: string): SkillBuildState | undefined;
+export declare function writeSkillBuildState(path: string, state: SkillBuildState): void;
+//# sourceMappingURL=outline-state.d.ts.map

package/dist/skill-builder/outline-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outline-state.d.ts","sourceRoot":"","sources":["../../src/skill-builder/outline-state.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAClD,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAE1D,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA6BnC,CAAC;AAEZ,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAevB,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAyB7E;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAG/E"}

package/dist/skill-builder/outline-state.js

@@ -0,0 +1,87 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { z } from 'zod';
+import { UsageStatsSchema } from '../types/index.js';
+import { BUILD_STATE_FILE } from './definition.js';
+import { SkillBuildOutlineSchema, } from './outline-contract.js';
+export const SKILL_BUILD_STATE_SCHEMA_VERSION = 1;
+export const SKILL_BUILD_STATE_KIND = 'skill-build-state';
+export const GeneratedSkillArtifactStateSchema = z.object({
+    version: z.literal(5),
+    sourceHash: z.string().min(1),
+    outlineHash: z.string().min(1),
+    buildVersion: z.string().min(1),
+    authoringProvider: z.object({
+        name: z.string().min(1),
+        rootDir: z.string().min(1),
+        contentHash: z.string().min(1),
+    }).strict(),
+    name: z.string().min(1),
+    fileManifest: z.array(z.object({
+        path: z.string().min(1),
+        bytes: z.number().int().nonnegative(),
+    }).strict()).min(1),
+    deterministicWarnings: z.array(z.string().min(1)).default([]),
+    bytes: z.number().int().nonnegative(),
+    durationMs: z.number().nonnegative(),
+    usage: UsageStatsSchema,
+    externalSources: z.array(z.object({
+        title: z.string().min(1),
+        url: z.string().min(1),
+        reason: z.string().min(1),
+    }).strict()),
+    missingInputs: z.array(z.string().min(1)),
+    authoringWarnings: z.array(z.string().min(1)).default([]),
+    responseModel: z.string().optional(),
+    numTurns: z.number().int().nonnegative().optional(),
+    generatedAt: z.string().min(1),
+}).strict();
+export const SkillBuildStateSchema = z.object({
+    version: z.literal(SKILL_BUILD_STATE_SCHEMA_VERSION),
+    kind: z.literal(SKILL_BUILD_STATE_KIND),
+    identity: z.object({
+        requestedModel: z.string().min(1).optional(),
+    }).strict().optional(),
+    outline: SkillBuildOutlineSchema,
+    outlineRun: z.object({
+        durationMs: z.number().nonnegative().optional(),
+        usage: UsageStatsSchema.optional(),
+        responseModel: z.string().optional(),
+        numTurns: z.number().int().nonnegative().optional(),
+    }).strict().optional(),
+    artifact: GeneratedSkillArtifactStateSchema.optional(),
+    updatedAt: z.string().optional(),
+}).strict();
+export function getBuildStatePath(rootDir) {
+    return join(rootDir, BUILD_STATE_FILE);
+}
+export function readSkillBuildState(path) {
+    if (!existsSync(path)) {
+        return undefined;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return undefined;
+    }
+    const validation = SkillBuildStateSchema.safeParse(parsed);
+    if (!validation.success) {
+        if (parsed && typeof parsed === 'object' && 'artifact' in parsed) {
+            const withoutArtifact = { ...parsed };
+            delete withoutArtifact.artifact;
+            const outlineOnlyValidation = SkillBuildStateSchema.safeParse(withoutArtifact);
+            if (outlineOnlyValidation.success) {
+                return outlineOnlyValidation.data;
+            }
+        }
+        return undefined;
+    }
+    return validation.data;
+}
+export function writeSkillBuildState(path, state) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(state, null, 2)}\n`, 'utf-8');
+}
+//# sourceMappingURL=outline-state.js.map

package/dist/skill-builder/outline-state.js.map

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

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

@@ -0,0 +1,36 @@
+import type { SkillDefinition } from '../config/schema.js';
+import type { Runtime, RuntimeName } from '../sdk/runtimes/index.js';
+import { type SkillBuildOutline, type SkillBuildOutlineResult, type SkillBuildSource } from './outline-contract.js';
+export { outlineHash, SKILL_BUILD_OUTLINE_SCHEMA_VERSION, SKILL_BUILD_VERSION, SkillBuildOutlineSchema } from './outline-contract.js';
+export type { SkillBuildOutline, SkillBuildOutlineResult, SkillBuildSource, SkillBuildSourceFile } from './outline-contract.js';
+export declare const SKILL_BUILD_MAX_TOKENS = 64000;
+export declare const SKILL_BUILD_TIMEOUT_MS = 180000;
+export declare const SKILL_BUILD_MAX_TURNS = 80;
+export interface BuildSkillOutlineOptions {
+    skill: SkillDefinition;
+    runtime?: Runtime;
+    runtimeName?: RuntimeName;
+    apiKey?: string;
+    model?: string;
+    previousOutline?: SkillBuildOutline;
+    maxRetries?: number;
+    regenerate?: boolean;
+    abortController?: AbortController;
+    repoPath?: string;
+    maxTurns?: number;
+    repairModel?: string;
+    repairMaxRetries?: number;
+    onStatus?: (message: string) => void;
+    source?: SkillBuildSource;
+}
+export declare class SkillBuildOutlineError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare function collectSkillBuildSource(skill: SkillDefinition): SkillBuildSource;
+/** Collect the improvement brief and current artifacts as source material. */
+export declare function collectSkillImproveSource(skill: SkillDefinition, improvementPrompt: string): SkillBuildSource;
+export declare function buildSkillOutline(options: BuildSkillOutlineOptions): Promise<SkillBuildOutlineResult>;
+export declare function defaultOutlineExportPath(skillName: string): string;
+//# sourceMappingURL=outline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"outline.d.ts","sourceRoot":"","sources":["../../src/skill-builder/outline.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAQrE,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAE5B,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAU/B,OAAO,EAAE,WAAW,EAAE,kCAAkC,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACtI,YAAY,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAEhI,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAC7C,eAAO,MAAM,sBAAsB,SAAU,CAAC;AAC9C,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,iBAAiB,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI3D;AAiCD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,CAMhF;AAED,8EAA8E;AAC9E,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,GAAG,gBAAgB,CAmB7G;AAuMD,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CA8GlC;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAElE"}