@farmslot/protocol 0.5.0 → 0.7.0

package/dist/recipe/manifest.js

@@ -0,0 +1,248 @@
+import { addFinding, createContext, finishResult, isNonEmptyString, isRecord, OFFICIAL_ACTION_SET, RECIPE_PROTOCOL_SCHEMA_VERSION, } from './common.js';
+export function getRecipeActionManifestActionNames(manifest) {
+    if (!isRecord(manifest))
+        return [];
+    const actionNames = new Set();
+    if (Array.isArray(manifest.supported_official_actions)) {
+        for (const action of manifest.supported_official_actions) {
+            if (isNonEmptyString(action))
+                actionNames.add(action);
+        }
+    }
+    if (Array.isArray(manifest.custom_actions)) {
+        for (const action of manifest.custom_actions) {
+            if (isRecord(action) && isNonEmptyString(action.name))
+                actionNames.add(action.name);
+        }
+    }
+    return [...actionNames].sort();
+}
+function validateActionCatalogEntry(ctx, entry, path, expectedAction) {
+    if (!isRecord(entry)) {
+        addFinding(ctx, 'error', 'action_manifest.invalid_action_metadata', path, `${path} must be an object.`);
+        return;
+    }
+    for (const stringField of [
+        'description',
+        'when_to_use',
+        'avoid_when',
+        'proof_effect',
+        'safety_notes',
+    ]) {
+        const value = entry[stringField];
+        if (value != null && typeof value !== 'string') {
+            addFinding(ctx, 'error', 'action_manifest.invalid_metadata_field', `${path}.${stringField}`, `${path}.${stringField} must be a string when present.`);
+        }
+    }
+    if (entry.schema != null && !isRecord(entry.schema)) {
+        addFinding(ctx, 'error', 'action_manifest.invalid_schema', `${path}.schema`, `${path}.schema must be a JSON Schema object when present.`);
+    }
+    if (entry.examples == null)
+        return;
+    if (!Array.isArray(entry.examples)) {
+        addFinding(ctx, 'error', 'action_manifest.invalid_examples', `${path}.examples`, `${path}.examples must be an array when present.`);
+        return;
+    }
+    entry.examples.forEach((example, index) => {
+        const examplePath = `${path}.examples[${index}]`;
+        if (!isRecord(example)) {
+            addFinding(ctx, 'error', 'action_manifest.invalid_example', examplePath, `${examplePath} must be an object.`);
+            return;
+        }
+        if (example.description != null && typeof example.description !== 'string') {
+            addFinding(ctx, 'error', 'action_manifest.invalid_example_description', `${examplePath}.description`, `${examplePath}.description must be a string when present.`);
+        }
+        if (!isRecord(example.node)) {
+            addFinding(ctx, 'error', 'action_manifest.invalid_example_node', `${examplePath}.node`, `${examplePath}.node must be an object.`);
+            return;
+        }
+        if (!isNonEmptyString(example.node.action)) {
+            addFinding(ctx, 'error', 'action_manifest.invalid_example_action', `${examplePath}.node.action`, `${examplePath}.node.action must be a non-empty string.`);
+        }
+        else if (expectedAction && example.node.action !== expectedAction) {
+            addFinding(ctx, 'error', 'action_manifest.example_action_mismatch', `${examplePath}.node.action`, `Example action ${example.node.action} must match declared action ${expectedAction}.`);
+        }
+    });
+}
+export function validateRecipeActionManifestDocument(manifest) {
+    const ctx = createContext();
+    if (!isRecord(manifest)) {
+        addFinding(ctx, 'error', 'action_manifest.invalid_document', '$', 'Recipe action manifest must be a JSON object.');
+        return finishResult(ctx);
+    }
+    if (manifest.runner_protocol_version !== RECIPE_PROTOCOL_SCHEMA_VERSION) {
+        addFinding(ctx, 'error', 'action_manifest.invalid_runner_protocol_version', 'runner_protocol_version', `runner_protocol_version must equal ${RECIPE_PROTOCOL_SCHEMA_VERSION}.`);
+    }
+    if (manifest.action_registry_version !== RECIPE_PROTOCOL_SCHEMA_VERSION) {
+        addFinding(ctx, 'error', 'action_manifest.invalid_action_registry_version', 'action_registry_version', `action_registry_version must equal ${RECIPE_PROTOCOL_SCHEMA_VERSION}.`);
+    }
+    const declaredActions = new Set();
+    const officialActions = manifest.supported_official_actions;
+    if (!Array.isArray(officialActions) || officialActions.length === 0) {
+        addFinding(ctx, 'error', 'action_manifest.invalid_supported_official_actions', 'supported_official_actions', 'supported_official_actions must be a non-empty array.');
+    }
+    else {
+        officialActions.forEach((action, index) => {
+            const path = `supported_official_actions[${index}]`;
+            if (!isNonEmptyString(action)) {
+                addFinding(ctx, 'error', 'action_manifest.invalid_supported_action', path, `${path} must be a non-empty string.`);
+                return;
+            }
+            if (!OFFICIAL_ACTION_SET.has(action)) {
+                addFinding(ctx, 'error', 'action_manifest.unknown_official_action', path, `${action} is not in the Farmslot v1 official action registry.`);
+            }
+            if (declaredActions.has(action)) {
+                addFinding(ctx, 'error', 'action_manifest.duplicate_action', path, `${action} is declared more than once.`);
+            }
+            declaredActions.add(action);
+        });
+    }
+    const customActions = manifest.custom_actions;
+    if (customActions != null) {
+        if (!Array.isArray(customActions)) {
+            addFinding(ctx, 'error', 'action_manifest.invalid_custom_actions', 'custom_actions', 'custom_actions must be an array when present.');
+        }
+        else {
+            customActions.forEach((action, index) => {
+                const path = `custom_actions[${index}]`;
+                if (!isRecord(action)) {
+                    addFinding(ctx, 'error', 'action_manifest.invalid_custom_action', path, `${path} must be an object.`);
+                    return;
+                }
+                if (!isNonEmptyString(action.name)) {
+                    addFinding(ctx, 'error', 'action_manifest.invalid_custom_action_name', `${path}.name`, `${path}.name must be a non-empty string.`);
+                }
+                else {
+                    if (OFFICIAL_ACTION_SET.has(action.name)) {
+                        addFinding(ctx, 'error', 'action_manifest.custom_action_overlaps_official', `${path}.name`, `${action.name} is official and must be declared in supported_official_actions.`);
+                    }
+                    if (declaredActions.has(action.name)) {
+                        addFinding(ctx, 'error', 'action_manifest.duplicate_action', `${path}.name`, `${action.name} is declared more than once.`);
+                    }
+                    declaredActions.add(action.name);
+                }
+                validateActionCatalogEntry(ctx, action, path, isNonEmptyString(action.name) ? action.name : undefined);
+            });
+        }
+    }
+    if (manifest.action_metadata != null) {
+        if (!isRecord(manifest.action_metadata)) {
+            addFinding(ctx, 'error', 'action_manifest.invalid_action_metadata', 'action_metadata', 'action_metadata must be an object when present.');
+        }
+        else {
+            for (const [action, metadata] of Object.entries(manifest.action_metadata)) {
+                if (!declaredActions.has(action)) {
+                    addFinding(ctx, 'error', 'action_manifest.metadata_for_undeclared_action', `action_metadata.${action}`, `Metadata action ${action} is not declared by the manifest.`);
+                }
+                validateActionCatalogEntry(ctx, metadata, `action_metadata.${action}`, action);
+            }
+        }
+    }
+    for (const { field, nameField } of [
+        { field: 'custom_assertion_operators', nameField: 'name' },
+        { field: 'state_refs', nameField: 'name' },
+    ]) {
+        const declarations = manifest[field];
+        if (declarations == null)
+            continue;
+        if (!Array.isArray(declarations)) {
+            addFinding(ctx, 'error', 'action_manifest.invalid_declaration_array', field, `${field} must be an array when present.`);
+            continue;
+        }
+        declarations.forEach((entry, index) => {
+            const path = `${field}[${index}]`;
+            if (!isRecord(entry) || !isNonEmptyString(entry[nameField])) {
+                addFinding(ctx, 'error', 'action_manifest.invalid_declaration', path, `${path}.${nameField} must be a non-empty string.`);
+            }
+        });
+    }
+    const preConditions = manifest.pre_conditions;
+    if (preConditions != null) {
+        if (!Array.isArray(preConditions)) {
+            addFinding(ctx, 'error', 'action_manifest.invalid_pre_conditions', 'pre_conditions', 'pre_conditions must be an array when present.');
+        }
+        else {
+            preConditions.forEach((entry, index) => {
+                const path = `pre_conditions[${index}]`;
+                if (!isRecord(entry)) {
+                    addFinding(ctx, 'error', 'action_manifest.invalid_pre_condition', path, `${path} must be an object.`);
+                    return;
+                }
+                if (!isNonEmptyString(entry.id)) {
+                    addFinding(ctx, 'error', 'action_manifest.invalid_pre_condition_id', `${path}.id`, `${path}.id must be a non-empty string.`);
+                }
+                if (!isNonEmptyString(entry.description)) {
+                    addFinding(ctx, 'error', 'action_manifest.invalid_pre_condition_description', `${path}.description`, `${path}.description must be a non-empty string.`);
+                }
+            });
+        }
+    }
+    const nativeBindings = manifest.native_bindings;
+    if (nativeBindings != null) {
+        if (!Array.isArray(nativeBindings)) {
+            addFinding(ctx, 'error', 'action_manifest.invalid_native_bindings', 'native_bindings', 'native_bindings must be an array when present.');
+        }
+        else {
+            nativeBindings.forEach((binding, index) => {
+                const path = `native_bindings[${index}]`;
+                if (!isRecord(binding)) {
+                    addFinding(ctx, 'error', 'action_manifest.invalid_native_binding', path, `${path} must be an object.`);
+                    return;
+                }
+                if (!isNonEmptyString(binding.action)) {
+                    addFinding(ctx, 'error', 'action_manifest.invalid_native_binding_action', `${path}.action`, `${path}.action must be a non-empty string.`);
+                }
+                else if (!declaredActions.has(binding.action)) {
+                    addFinding(ctx, 'error', 'action_manifest.native_binding_for_undeclared_action', `${path}.action`, `Native binding action ${binding.action} is not declared by the manifest.`);
+                }
+                if (!isNonEmptyString(binding.implementation)) {
+                    addFinding(ctx, 'error', 'action_manifest.invalid_native_binding_implementation', `${path}.implementation`, `${path}.implementation must be a non-empty string.`);
+                }
+            });
+        }
+    }
+    const capabilities = manifest.capabilities;
+    if (capabilities != null) {
+        if (!Array.isArray(capabilities)) {
+            addFinding(ctx, 'error', 'action_manifest.invalid_capabilities', 'capabilities', 'capabilities must be an array when present.');
+        }
+        else {
+            capabilities.forEach((capability, index) => {
+                const path = `capabilities[${index}]`;
+                if (!isRecord(capability)) {
+                    addFinding(ctx, 'error', 'action_manifest.invalid_capability', path, `${path} must be an object.`);
+                    return;
+                }
+                if (!isNonEmptyString(capability.capability)) {
+                    addFinding(ctx, 'error', 'action_manifest.invalid_capability_name', `${path}.capability`, `${path}.capability must be a non-empty string.`);
+                }
+                if (capability.status !== 'supported' &&
+                    capability.status !== 'unsupported' &&
+                    capability.status !== 'partial' &&
+                    capability.status !== 'planned') {
+                    addFinding(ctx, 'error', 'action_manifest.invalid_capability_status', `${path}.status`, `${path}.status must be supported, unsupported, partial, or planned.`);
+                }
+                for (const stringField of ['provider', 'reason']) {
+                    const value = capability[stringField];
+                    if (value != null && typeof value !== 'string') {
+                        addFinding(ctx, 'error', 'action_manifest.invalid_capability_field', `${path}.${stringField}`, `${path}.${stringField} must be a string when present.`);
+                    }
+                }
+                for (const arrayField of ['platforms', 'modes', 'artifactTypes']) {
+                    const value = capability[arrayField];
+                    if (value != null &&
+                        (!Array.isArray(value) || value.some((entry) => !isNonEmptyString(entry)))) {
+                        addFinding(ctx, 'error', 'action_manifest.invalid_capability_field', `${path}.${arrayField}`, `${path}.${arrayField} must be an array of non-empty strings when present.`);
+                    }
+                }
+            });
+        }
+    }
+    return finishResult(ctx);
+}
+export function getRecipeActionManifestPreconditionIds(manifest) {
+    if (!isRecord(manifest) || !Array.isArray(manifest.pre_conditions))
+        return [];
+    return manifest.pre_conditions.flatMap((entry) => isRecord(entry) && isNonEmptyString(entry.id) ? [entry.id] : []);
+}
+//# sourceMappingURL=manifest.js.map

package/dist/recipe/manifest.js.map

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

package/dist/recipe/workflow.d.ts

@@ -0,0 +1,29 @@
+import { type MutableValidationContext } from './common.js';
+interface WorkflowGraph {
+    entry: string;
+    nodes: Record<string, Record<string, unknown>>;
+    lifecycleNodes: Record<string, LifecycleWorkflowNode>;
+}
+interface LifecycleWorkflowNode {
+    node: Record<string, unknown>;
+    path: string;
+}
+interface RecipePreconditionGate {
+    id: string;
+    path: string;
+}
+export declare function extractWorkflow(ctx: MutableValidationContext, recipe: Record<string, unknown>): WorkflowGraph | null;
+export declare function validateWorkflowGraph(ctx: MutableValidationContext, workflow: WorkflowGraph, rawWorkflow: Record<string, unknown>): void;
+export declare function getRecipeWorkflowNodeIds(recipe: unknown): string[];
+export declare function getRecipeWorkflowActions(recipe: unknown): string[];
+export declare function getRecipeWorkflowActionEntries(recipe: unknown): Array<{
+    nodeId: string;
+    action: string;
+    path: string;
+}>;
+export declare function validateInlineFlows(ctx: MutableValidationContext, recipe: Record<string, unknown>): void;
+export declare function validateWorkflowPreconditions(ctx: MutableValidationContext, workflow: Record<string, unknown>): void;
+export declare function getRecipeWorkflowPreconditionEntries(recipe: unknown): RecipePreconditionGate[];
+export declare function validateFlowCalls(ctx: MutableValidationContext, recipe: Record<string, unknown>, workflow: WorkflowGraph): void;
+export {};
+//# sourceMappingURL=workflow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/recipe/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,wBAAwB,EAM9B,MAAM,aAAa,CAAC;AAErB,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CACvD;AAED,UAAU,qBAAqB;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,sBAAsB;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AA4FD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,wBAAwB,EAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,aAAa,GAAG,IAAI,CAkEtB;AAyOD,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,wBAAwB,EAC7B,QAAQ,EAAE,aAAa,EACvB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,IAAI,CAwIN;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,CAelE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,CAElE;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,OAAO,GACd,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAoDzD;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,wBAAwB,EAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI,CAyKN;AAmCD,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,wBAAwB,EAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CA0EN;AAED,wBAAgB,oCAAoC,CAAC,MAAM,EAAE,OAAO,GAAG,sBAAsB,EAAE,CAc9F;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,wBAAwB,EAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,aAAa,GACtB,IAAI,CA2CN"}