@farmslot/protocol 0.5.0 → 0.6.0

package/dist/index.d.ts

@@ -1,14 +1,14 @@
-export * from './agent-roles.js';
-export * from './events.js';
-export * from './frames.js';
-export * from './github-ref.js';
-export * from './methods.js';
-export * from './recipe-compat.js';
-export * from './run-family-readiness.js';
-export * from './signal.js';
-export * from './step-io.js';
-export * from './surfaces.js';
-export * from './tmux-worker-watchlist.js';
-export * from './types.js';
+export * from './agents/roles.js';
+export * from './contracts/index.js';
+export * from './integrations/github-ref.js';
+export * from './recipe/index.js';
+export * from './recipes/step-io.js';
+export * from './rpc/index.js';
+export * from './runs/family-readiness.js';
+export * from './surfaces/command-center.js';
+export * from './transport/events.js';
+export * from './transport/frames.js';
+export * from './transport/signal.js';
 export { PROTOCOL_VERSION } from './version.js';
+export * from './workers/tmux-worker-watchlist.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,cAAc,oCAAoC,CAAC"}

package/dist/index.js

@@ -1,14 +1,14 @@
-export * from './agent-roles.js';
-export * from './events.js';
-export * from './frames.js';
-export * from './github-ref.js';
-export * from './methods.js';
-export * from './recipe-compat.js';
-export * from './run-family-readiness.js';
-export * from './signal.js';
-export * from './step-io.js';
-export * from './surfaces.js';
-export * from './tmux-worker-watchlist.js';
-export * from './types.js';
+export * from './agents/roles.js';
+export * from './contracts/index.js';
+export * from './integrations/github-ref.js';
+export * from './recipe/index.js';
+export * from './recipes/step-io.js';
+export * from './rpc/index.js';
+export * from './runs/family-readiness.js';
+export * from './surfaces/command-center.js';
+export * from './transport/events.js';
+export * from './transport/frames.js';
+export * from './transport/signal.js';
 export { PROTOCOL_VERSION } from './version.js';
+export * from './workers/tmux-worker-watchlist.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,cAAc,oCAAoC,CAAC"}

package/dist/{github-ref.d.ts → integrations/github-ref.d.ts}

@@ -1,4 +1,4 @@
-import type { FlowType } from './types.js';
+import type { FlowType } from '../contracts/index.js';
 export interface GitHubRef {
     repo: string;
     number: number;

package/dist/integrations/github-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-ref.d.ts","sourceRoot":"","sources":["../../src/integrations/github-ref.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAID,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI,CAW/E;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG,MAAM,CAE7E;AAED,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,QAAQ,CAIpD,CAAC;AAEH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,IAAI,CACT;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EACpE,UAAU,GAAG,YAAY,GAAG,UAAU,CACvC,GACA,MAAM,GAAG,IAAI,CAIf"}

package/dist/integrations/github-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-ref.js","sourceRoot":"","sources":["../../src/integrations/github-ref.ts"],"names":[],"mappings":"AAQA,MAAM,kBAAkB,GAAG,4CAA4C,CAAC;AAExE,MAAM,UAAU,cAAc,CAAC,GAA8B;IAC3D,MAAM,KAAK,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI;QACrF,OAAO,IAAI,CAAC;IACd,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACd,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACxB,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE;KAC/B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAuC;IACnE,OAAO,sBAAsB,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,MAAM,EAAE,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAA0B,IAAI,GAAG,CAAC;IAChE,WAAW;IACX,aAAa;IACb,YAAY;CACb,CAAC,CAAC;AAEH,MAAM,UAAU,oBAAoB,CAClC,KAGC;IAED,IAAI,KAAK,CAAC,QAAQ,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC,QAAQ,CAAC;IAClD,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1D,OAAO,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,IAAI,IAAI,CAAC;AAC1D,CAAC"}

package/dist/recipe/artifact.d.ts

@@ -0,0 +1,8 @@
+import { type RecipeArtifactPackageInput, type RecipeValidationResult } from './common.js';
+export declare function validateArtifactManifestDocument(manifest: unknown, options?: {
+    recipe?: unknown;
+    artifactPaths?: readonly string[];
+}): RecipeValidationResult;
+export declare function validateRecipeArtifactPackage(input: RecipeArtifactPackageInput): RecipeValidationResult;
+export declare function mergeRecipeValidationResults(results: readonly RecipeValidationResult[]): RecipeValidationResult;
+//# sourceMappingURL=artifact.d.ts.map

package/dist/recipe/artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../../src/recipe/artifact.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAE5B,MAAM,aAAa,CAAC;AAGrB,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,OAAO,EACjB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAO,GACpE,sBAAsB,CAuJxB;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,0BAA0B,GAChC,sBAAsB,CAsCxB;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,SAAS,sBAAsB,EAAE,GACzC,sBAAsB,CAMxB"}

package/dist/recipe/artifact.js

@@ -0,0 +1,98 @@
+import { addFinding, ARTIFACT_TYPES, createContext, finishResult, isNonEmptyString, isRecord, isRelativeArtifactPath, TERMINAL_STATUSES, } from './common.js';
+import { getRecipeWorkflowNodeIds } from './workflow.js';
+export function validateArtifactManifestDocument(manifest, options = {}) {
+    const ctx = createContext();
+    if (!isRecord(manifest)) {
+        addFinding(ctx, 'error', 'artifact_manifest.invalid_document', '$', 'artifact-manifest.json must be a JSON object.');
+        return finishResult(ctx);
+    }
+    if (manifest.version !== 1) {
+        addFinding(ctx, 'error', 'artifact_manifest.invalid_version', 'version', 'artifact-manifest.json version must equal 1.');
+    }
+    if (manifest.runStatus != null &&
+        (typeof manifest.runStatus !== 'string' || !TERMINAL_STATUSES.has(manifest.runStatus))) {
+        addFinding(ctx, 'error', 'artifact_manifest.invalid_run_status', 'runStatus', 'runStatus must be pass, fail, or unknown when present.');
+    }
+    const artifacts = manifest.artifacts;
+    if (!Array.isArray(artifacts)) {
+        addFinding(ctx, 'error', 'artifact_manifest.invalid_artifacts', 'artifacts', 'artifact-manifest.json must include an artifacts array.');
+        return finishResult(ctx);
+    }
+    const nodeIds = new Set(getRecipeWorkflowNodeIds(options.recipe));
+    const artifactPathSet = options.artifactPaths ? new Set(options.artifactPaths) : null;
+    artifacts.forEach((artifact, index) => {
+        const path = `artifacts[${index}]`;
+        if (!isRecord(artifact)) {
+            addFinding(ctx, 'error', 'artifact_manifest.invalid_artifact', path, 'Artifact entries must be objects.');
+            return;
+        }
+        if (!isNonEmptyString(artifact.path)) {
+            addFinding(ctx, 'error', 'artifact_manifest.invalid_path', `${path}.path`, 'Artifact path must be a non-empty string.');
+        }
+        else {
+            if (!isRelativeArtifactPath(artifact.path)) {
+                addFinding(ctx, 'error', 'artifact_manifest.unsafe_path', `${path}.path`, 'Artifact path must be relative and must not contain .. segments.');
+            }
+            if (artifactPathSet && !artifactPathSet.has(artifact.path)) {
+                addFinding(ctx, 'error', 'artifact_manifest.missing_file', `${path}.path`, `Artifact file ${artifact.path} was not found in the provided artifact path list.`);
+            }
+        }
+        if (!isNonEmptyString(artifact.type)) {
+            addFinding(ctx, 'error', 'artifact_manifest.invalid_type', `${path}.type`, 'Artifact type must be a non-empty string.');
+        }
+        else if (!ARTIFACT_TYPES.has(artifact.type)) {
+            addFinding(ctx, 'warning', 'artifact_manifest.unknown_type', `${path}.type`, `Artifact type ${artifact.type} is not in the v1 core type vocabulary.`);
+        }
+        for (const optionalField of ['label', 'nodeId', 'mimeType', 'category', 'proofTarget']) {
+            const value = artifact[optionalField];
+            if (value != null && typeof value !== 'string') {
+                addFinding(ctx, 'error', 'artifact_manifest.invalid_optional_field', `${path}.${optionalField}`, `${optionalField} must be a string when present.`);
+            }
+        }
+        if (artifact.covers != null) {
+            if (!Array.isArray(artifact.covers) ||
+                artifact.covers.some((cover) => !isNonEmptyString(cover))) {
+                addFinding(ctx, 'error', 'artifact_manifest.invalid_covers', `${path}.covers`, 'covers must be an array of non-empty strings when present.');
+            }
+        }
+        if (typeof artifact.nodeId === 'string' && nodeIds.size > 0 && !nodeIds.has(artifact.nodeId)) {
+            addFinding(ctx, 'warning', 'artifact_manifest.unknown_node', `${path}.nodeId`, `Artifact references nodeId ${artifact.nodeId}, which is not present in the recipe graph.`);
+        }
+    });
+    return finishResult(ctx);
+}
+export function validateRecipeArtifactPackage(input) {
+    const ctx = createContext();
+    const artifactPaths = new Set(input.artifactPaths ?? []);
+    if (input.artifactPaths != null) {
+        const requiredPaths = ['summary.json', 'trace.json'];
+        if (input.manifest != null)
+            requiredPaths.push('artifact-manifest.json');
+        if (input.recipe != null)
+            requiredPaths.push('recipe.json');
+        for (const requiredPath of requiredPaths) {
+            if (!artifactPaths.has(requiredPath)) {
+                addFinding(ctx, 'error', 'artifact_package.missing_required_file', requiredPath, `Recipe artifact package must include ${requiredPath}.`);
+            }
+        }
+    }
+    if (input.manifest == null) {
+        addFinding(ctx, 'error', 'artifact_package.missing_manifest', 'artifact-manifest.json', 'Recipe artifact package must include artifact-manifest.json.');
+    }
+    else {
+        const manifestResult = validateArtifactManifestDocument(input.manifest, {
+            recipe: input.recipe,
+            artifactPaths: input.artifactPaths,
+        });
+        ctx.findings.push(...manifestResult.findings);
+    }
+    return finishResult(ctx);
+}
+export function mergeRecipeValidationResults(results) {
+    const ctx = createContext();
+    for (const result of results) {
+        ctx.findings.push(...result.findings);
+    }
+    return finishResult(ctx);
+}
+//# sourceMappingURL=artifact.js.map

package/dist/recipe/artifact.js.map

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

package/dist/{recipe-compat.d.ts → recipe/common.d.ts}

@@ -51,21 +51,24 @@ export interface RecipeActionManifestDocument {
     pre_conditions?: RecipePreconditionDeclaration[];
     native_bindings?: RecipeNativeBindingDeclaration[];
 }
-export type RecipeCompatibilitySeverity = 'error' | 'warning';
-export type RecipeCompatibilityStatus = 'v1-compatible' | 'legacy-compatible' | 'invalid';
-export interface RecipeCompatibilityFinding {
-    severity: RecipeCompatibilitySeverity;
+export declare const PLAYBACK_MODES: Set<string>;
+export declare const TERMINAL_STATUSES: Set<string>;
+export declare const ARTIFACT_TYPES: Set<string>;
+export declare const OFFICIAL_ACTION_SET: Set<string>;
+export type RecipeValidationSeverity = 'error' | 'warning';
+export type RecipeValidationStatus = 'valid' | 'invalid';
+export interface RecipeValidationFinding {
+    severity: RecipeValidationSeverity;
     code: string;
     path: string;
     message: string;
 }
-export interface RecipeCompatibilityResult {
-    status: RecipeCompatibilityStatus;
-    findings: RecipeCompatibilityFinding[];
+export interface RecipeValidationResult {
+    status: RecipeValidationStatus;
+    findings: RecipeValidationFinding[];
     summary: {
         errors: number;
         warnings: number;
-        legacy: boolean;
     };
 }
 export interface RecipeArtifactPackageInput {
@@ -73,17 +76,15 @@ export interface RecipeArtifactPackageInput {
     artifactPaths?: readonly string[];
     recipe?: unknown;
 }
+export interface MutableValidationContext {
+    findings: RecipeValidationFinding[];
+}
+export declare function createContext(): MutableValidationContext;
+export declare function addFinding(ctx: MutableValidationContext, severity: RecipeValidationSeverity, code: string, path: string, message: string): void;
 export declare function isRecord(value: unknown): value is Record<string, unknown>;
-export declare function getRecipeWorkflowNodeIds(recipe: unknown): string[];
-export declare function getRecipeWorkflowActions(recipe: unknown): string[];
-export declare function getRecipeActionManifestActionNames(manifest: unknown): string[];
-export declare function validateRecipeActionManifestDocument(manifest: unknown): RecipeCompatibilityResult;
-export declare function validateRecipeWithManifest(recipe: unknown, manifest: unknown): RecipeCompatibilityResult;
-export declare function validateRecipeDocument(recipe: unknown): RecipeCompatibilityResult;
-export declare function validateArtifactManifestDocument(manifest: unknown, options?: {
-    recipe?: unknown;
-    artifactPaths?: readonly string[];
-}): RecipeCompatibilityResult;
-export declare function validateRecipeArtifactPackage(input: RecipeArtifactPackageInput): RecipeCompatibilityResult;
-export declare function mergeRecipeCompatibilityResults(results: readonly RecipeCompatibilityResult[]): RecipeCompatibilityResult;
-//# sourceMappingURL=recipe-compat.d.ts.map
+export declare function hasOwn(value: Record<string, unknown>, key: string): boolean;
+export declare function isNonEmptyString(value: unknown): value is string;
+export declare function isRelativeArtifactPath(value: string): boolean;
+export declare function finishResult(ctx: MutableValidationContext): RecipeValidationResult;
+export declare function requireStringField(ctx: MutableValidationContext, document: Record<string, unknown>, field: string, path: string): void;
+//# sourceMappingURL=common.d.ts.map

package/dist/recipe/common.d.ts.map

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

package/dist/recipe/common.js

@@ -0,0 +1,79 @@
+import { RECIPE_ARTIFACT_TYPES } from '../recipes/step-io.js';
+export const RECIPE_PROTOCOL_SCHEMA_VERSION = 1;
+export const RECIPE_PLAYBACK_SLOW_MS_MIN = 100;
+export const RECIPE_PLAYBACK_SLOW_MS_MAX = 60_000;
+export const OFFICIAL_RECIPE_ACTIONS = [
+    'command',
+    'wait',
+    'assert_file',
+    'assert_json',
+    'assert_exit_code',
+    'assert_output',
+    'state_read',
+    'watch_logs',
+    'index_artifacts',
+    'call',
+    'switch',
+    'manual',
+    'end',
+    'ui.navigate',
+    'ui.press',
+    'ui.key_press',
+    'ui.set_input',
+    'ui.scroll',
+    'ui.gesture',
+    'ui.wait_for',
+    'ui.screenshot',
+    'app.status',
+    'app.lifecycle',
+    'app.hud',
+    'app.trace',
+    'cdp.target',
+    'cdp.storage',
+    'cdp.network',
+    'cdp.emulation',
+    'cdp.metrics',
+    'cdp.trace',
+];
+export const PLAYBACK_MODES = new Set(['off', 'auto', 'step']);
+export const TERMINAL_STATUSES = new Set(['pass', 'fail', 'unknown']);
+export const ARTIFACT_TYPES = new Set(RECIPE_ARTIFACT_TYPES);
+export const OFFICIAL_ACTION_SET = new Set(OFFICIAL_RECIPE_ACTIONS);
+export function createContext() {
+    return { findings: [] };
+}
+export function addFinding(ctx, severity, code, path, message) {
+    ctx.findings.push({ severity, code, path, message });
+}
+export function isRecord(value) {
+    return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+}
+export function hasOwn(value, key) {
+    return Object.prototype.hasOwnProperty.call(value, key);
+}
+export function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+export function isRelativeArtifactPath(value) {
+    if (value.startsWith('/') || value.startsWith('\\'))
+        return false;
+    if (/^[A-Za-z]:/.test(value))
+        return false;
+    return !value.split(/[\\/]+/).some((segment) => segment === '..');
+}
+export function finishResult(ctx) {
+    const errors = ctx.findings.filter((finding) => finding.severity === 'error').length;
+    const warnings = ctx.findings.length - errors;
+    const status = errors ? 'invalid' : 'valid';
+    return { status, findings: ctx.findings, summary: { errors, warnings } };
+}
+export function requireStringField(ctx, document, field, path) {
+    if (isNonEmptyString(document[field]))
+        return;
+    if (!hasOwn(document, field)) {
+        addFinding(ctx, 'error', `recipe.missing_${field}`, path, `Recipe requires ${path}.`);
+        return;
+    }
+    addFinding(ctx, 'error', `recipe.invalid_${field}`, path, `${path} must be a non-empty string.`);
+}
+//# sourceMappingURL=common.js.map

package/dist/recipe/common.js.map

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

package/dist/recipe/document.d.ts

@@ -0,0 +1,4 @@
+import { type RecipeValidationResult } from './common.js';
+export declare function validateRecipeWithManifest(recipe: unknown, manifest: unknown): RecipeValidationResult;
+export declare function validateRecipeDocument(recipe: unknown): RecipeValidationResult;
+//# sourceMappingURL=document.d.ts.map

package/dist/recipe/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/recipe/document.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,sBAAsB,EAE5B,MAAM,aAAa,CAAC;AAgBrB,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,OAAO,GAChB,sBAAsB,CAoCxB;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,sBAAsB,CA+C9E"}

package/dist/recipe/document.js

@@ -0,0 +1,53 @@
+import { addFinding, createContext, finishResult, hasOwn, isRecord, RECIPE_PROTOCOL_SCHEMA_VERSION, requireStringField, } from './common.js';
+import { getRecipeActionManifestActionNames, getRecipeActionManifestPreconditionIds, validateRecipeActionManifestDocument, } from './manifest.js';
+import { extractWorkflow, getRecipeWorkflowActionEntries, getRecipeWorkflowPreconditionEntries, validateFlowCalls, validateInlineFlows, validateWorkflowGraph, validateWorkflowPreconditions, } from './workflow.js';
+export function validateRecipeWithManifest(recipe, manifest) {
+    const ctx = createContext();
+    const recipeResult = validateRecipeDocument(recipe);
+    const manifestResult = validateRecipeActionManifestDocument(manifest);
+    ctx.findings.push(...recipeResult.findings, ...manifestResult.findings);
+    const declaredActions = new Set(getRecipeActionManifestActionNames(manifest));
+    if (declaredActions.size > 0) {
+        const actions = getRecipeWorkflowActionEntries(recipe);
+        actions.forEach(({ action, path }) => {
+            if (!declaredActions.has(action)) {
+                addFinding(ctx, 'error', 'recipe.action_not_declared_by_manifest', path, `Recipe action ${action} is not declared by the runner action manifest.`);
+            }
+        });
+    }
+    const declaredPreconditions = new Set(getRecipeActionManifestPreconditionIds(manifest));
+    for (const gate of getRecipeWorkflowPreconditionEntries(recipe)) {
+        if (!declaredPreconditions.has(gate.id)) {
+            addFinding(ctx, 'error', 'recipe.precondition_not_declared_by_manifest', gate.path, `Recipe precondition ${gate.id} is not declared by the runner action manifest.`);
+        }
+    }
+    return finishResult(ctx);
+}
+export function validateRecipeDocument(recipe) {
+    const ctx = createContext();
+    if (!isRecord(recipe)) {
+        addFinding(ctx, 'error', 'recipe.invalid_document', '$', 'Recipe document must be a JSON object.');
+        return finishResult(ctx);
+    }
+    const schemaVersion = recipe.schema_version;
+    const schemaVersionIsV1 = schemaVersion === RECIPE_PROTOCOL_SCHEMA_VERSION;
+    if (!hasOwn(recipe, 'schema_version')) {
+        addFinding(ctx, 'error', 'recipe.missing_schema_version', 'schema_version', `Recipe must set schema_version: ${RECIPE_PROTOCOL_SCHEMA_VERSION}.`);
+    }
+    else if (!schemaVersionIsV1) {
+        addFinding(ctx, 'error', 'recipe.unsupported_schema_version', 'schema_version', `Unsupported schema_version ${JSON.stringify(schemaVersion)}; supported value is ${RECIPE_PROTOCOL_SCHEMA_VERSION}.`);
+    }
+    requireStringField(ctx, recipe, 'title', 'title');
+    requireStringField(ctx, recipe, 'description', 'description');
+    const validate = recipe.validate;
+    const rawWorkflow = isRecord(validate) && isRecord(validate.workflow) ? validate.workflow : null;
+    const workflow = extractWorkflow(ctx, recipe);
+    if (workflow && rawWorkflow) {
+        validateWorkflowPreconditions(ctx, rawWorkflow);
+        validateWorkflowGraph(ctx, workflow, rawWorkflow);
+        validateFlowCalls(ctx, recipe, workflow);
+    }
+    validateInlineFlows(ctx, recipe);
+    return finishResult(ctx);
+}
+//# sourceMappingURL=document.js.map

package/dist/recipe/document.js.map

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

package/dist/recipe/index.d.ts

@@ -0,0 +1,6 @@
+export { mergeRecipeValidationResults, validateArtifactManifestDocument, validateRecipeArtifactPackage, } from './artifact.js';
+export { isRecord, OFFICIAL_RECIPE_ACTIONS, type OfficialActionName, RECIPE_PLAYBACK_SLOW_MS_MAX, RECIPE_PLAYBACK_SLOW_MS_MIN, RECIPE_PROTOCOL_SCHEMA_VERSION, type RecipeActionCatalogEntry, type RecipeActionCatalogExample, type RecipeActionManifestDocument, type RecipeActionName, type RecipeArtifactPackageInput, type RecipeCustomActionDeclaration, type RecipeNamedDeclaration, type RecipeNativeBindingDeclaration, type RecipePreconditionDeclaration, type RecipeStateRefDeclaration, type RecipeValidationFinding, type RecipeValidationResult, type RecipeValidationSeverity, type RecipeValidationStatus, } from './common.js';
+export { validateRecipeDocument, validateRecipeWithManifest } from './document.js';
+export { getRecipeActionManifestActionNames, validateRecipeActionManifestDocument, } from './manifest.js';
+export { getRecipeWorkflowActions, getRecipeWorkflowNodeIds } from './workflow.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/recipe/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/recipe/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,EAChC,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,QAAQ,EACR,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,2BAA2B,EAC3B,2BAA2B,EAC3B,8BAA8B,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,4BAA4B,EACjC,KAAK,gBAAgB,EACrB,KAAK,0BAA0B,EAC/B,KAAK,6BAA6B,EAClC,KAAK,sBAAsB,EAC3B,KAAK,8BAA8B,EACnC,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,GAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,EACL,kCAAkC,EAClC,oCAAoC,GACrC,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC"}

package/dist/recipe/index.js

@@ -0,0 +1,6 @@
+export { mergeRecipeValidationResults, validateArtifactManifestDocument, validateRecipeArtifactPackage, } from './artifact.js';
+export { isRecord, OFFICIAL_RECIPE_ACTIONS, RECIPE_PLAYBACK_SLOW_MS_MAX, RECIPE_PLAYBACK_SLOW_MS_MIN, RECIPE_PROTOCOL_SCHEMA_VERSION, } from './common.js';
+export { validateRecipeDocument, validateRecipeWithManifest } from './document.js';
+export { getRecipeActionManifestActionNames, validateRecipeActionManifestDocument, } from './manifest.js';
+export { getRecipeWorkflowActions, getRecipeWorkflowNodeIds } from './workflow.js';
+//# sourceMappingURL=index.js.map

package/dist/recipe/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/recipe/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,EAChC,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,QAAQ,EACR,uBAAuB,EAEvB,2BAA2B,EAC3B,2BAA2B,EAC3B,8BAA8B,GAe/B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,EACL,kCAAkC,EAClC,oCAAoC,GACrC,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC"}

package/dist/recipe/manifest.d.ts

@@ -0,0 +1,5 @@
+import { type RecipeValidationResult } from './common.js';
+export declare function getRecipeActionManifestActionNames(manifest: unknown): string[];
+export declare function validateRecipeActionManifestDocument(manifest: unknown): RecipeValidationResult;
+export declare function getRecipeActionManifestPreconditionIds(manifest: unknown): string[];
+//# sourceMappingURL=manifest.d.ts.map

package/dist/recipe/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/recipe/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,sBAAsB,EAC5B,MAAM,aAAa,CAAC;AAErB,wBAAgB,kCAAkC,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,EAAE,CAc9E;AA+GD,wBAAgB,oCAAoC,CAAC,QAAQ,EAAE,OAAO,GAAG,sBAAsB,CAsS9F;AAED,wBAAgB,sCAAsC,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,EAAE,CAKlF"}