@farmslot/protocol 0.80.0 → 0.82.0

package/dist/transport/node-link.d.ts

@@ -0,0 +1,106 @@
+export declare const NODE_LINK_RECEIPT_RETENTION_MS: number;
+/** ADR-008 Amendment 3. Infrastructure identity is independent of runner transport. */
+export declare const NODE_LINK_LIMITS: {
+    readonly frameBytes: number;
+    readonly chunkBytes: number;
+    readonly queuedBytes: number;
+    readonly inFlight: 32;
+    readonly reservedControl: 8;
+    readonly streamBytes: number;
+};
+export interface NodeLinkCapabilities {
+    commands?: 1;
+    operations?: import('./node-link-operations.js').NodeLinkOperation[];
+    streams?: 1;
+}
+export interface NodeLinkPrincipal {
+    principalId: string;
+    generation: number;
+}
+export interface NodeLinkLease {
+    runId: string;
+    contextId: string;
+    leaseId: string;
+    generation: string;
+}
+export interface NodeLinkAuthority {
+    requester: NodeLinkPrincipal | {
+        kind: 'system';
+    };
+    executor: NodeLinkPrincipal;
+    grantId: string;
+    approvalId: string;
+    approval: 'ask' | 'bypass' | 'framework';
+    lease?: NodeLinkLease;
+}
+/** A resource reference is resolved by its adapter, never by a runner-name branch. */
+export interface NodeLinkTarget {
+    nodeId: string;
+    resourceId: string;
+}
+export interface NodeLinkCommand<Input = unknown> {
+    commandId: string;
+    operation: string;
+    target: NodeLinkTarget;
+    authority: NodeLinkAuthority;
+    expiresAt: number;
+    input: Input;
+}
+export type NodeLinkCommandState = 'admitted' | 'running' | 'cancel-requested' | 'completed' | 'failed' | 'cancelled' | 'unknown';
+export interface NodeLinkError {
+    code: string;
+    message: string;
+}
+/** Audit metadata contains identifiers/digests only. Protected result payloads stay separate. */
+export interface NodeLinkReceipt<Result = unknown> {
+    commandId: string;
+    digest: string;
+    target: NodeLinkTarget;
+    authority: NodeLinkAuthority;
+    operation: string;
+    expiresAt: number;
+    admittedAt: number;
+    state: NodeLinkCommandState;
+    closeoutConfirmed: boolean;
+    settledAt?: number;
+    result?: Result;
+    error?: NodeLinkError;
+}
+export interface NodeLinkCursor {
+    streamId: string;
+    incarnation: string;
+    offset: number;
+}
+export interface NodeLinkStreamFrame<Payload = unknown> extends NodeLinkCursor {
+    authority: NodeLinkAuthority;
+    target: NodeLinkTarget;
+    payload: Payload;
+}
+export type NodeLinkResumeResult<Payload = unknown> = {
+    kind: 'replay';
+    frames: NodeLinkStreamFrame<Payload>[];
+    cursor: NodeLinkCursor;
+} | {
+    kind: 'reset';
+    reason: 'expired' | 'gap' | 'source-replaced';
+    snapshot: Payload;
+    cursor: NodeLinkCursor;
+};
+export declare class NodeLinkFailure extends Error {
+    readonly code: string;
+    readonly details?: {
+        admitted: false;
+    } | undefined;
+    constructor(code: string, message: string, details?: {
+        admitted: false;
+    } | undefined);
+}
+export declare function isNodeLinkTerminal(state: NodeLinkCommandState): boolean;
+export declare function isNodeLinkPrincipal(value: unknown): value is NodeLinkPrincipal;
+export declare function isNodeLinkAuthority(value: unknown): value is NodeLinkAuthority;
+export declare function isNodeLinkTarget(value: unknown): value is NodeLinkTarget;
+/** Deadline-bearing keys remain expired after their settled receipt has been pruned. */
+export declare function nodeLinkCommandDeadline(commandId: string): number | undefined;
+export declare function isNodeLinkCommand(value: unknown): value is NodeLinkCommand;
+export declare function isNodeLinkReceipt(value: unknown): value is NodeLinkReceipt;
+//# sourceMappingURL=node-link.d.ts.map

package/dist/transport/node-link.d.ts.map

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

package/dist/transport/node-link.js

@@ -0,0 +1,98 @@
+export const NODE_LINK_RECEIPT_RETENTION_MS = 5 * 60_000;
+/** ADR-008 Amendment 3. Infrastructure identity is independent of runner transport. */
+export const NODE_LINK_LIMITS = {
+    frameBytes: 1024 * 1024,
+    chunkBytes: 64 * 1024,
+    queuedBytes: 8 * 1024 * 1024,
+    inFlight: 32,
+    reservedControl: 8,
+    streamBytes: 256 * 1024,
+};
+export class NodeLinkFailure extends Error {
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'NodeLinkFailure';
+    }
+}
+export function isNodeLinkTerminal(state) {
+    return state === 'completed' || state === 'failed' || state === 'cancelled';
+}
+function record(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+const identity = (value) => typeof value === 'string' && value.length > 0 && value.length <= 512;
+const finite = (value) => typeof value === 'number' && Number.isFinite(value);
+export function isNodeLinkPrincipal(value) {
+    return (record(value) &&
+        identity(value.principalId) &&
+        Number.isSafeInteger(value.generation) &&
+        typeof value.generation === 'number' &&
+        value.generation >= 0);
+}
+export function isNodeLinkAuthority(value) {
+    if (!record(value) ||
+        !isNodeLinkPrincipal(value.executor) ||
+        !identity(value.grantId) ||
+        !identity(value.approvalId) ||
+        !['ask', 'bypass', 'framework'].includes(String(value.approval)))
+        return false;
+    if (!isNodeLinkPrincipal(value.requester) &&
+        !(record(value.requester) && value.requester.kind === 'system'))
+        return false;
+    const lease = value.lease;
+    return (lease === undefined ||
+        (record(lease) &&
+            ['runId', 'contextId', 'leaseId', 'generation'].every((field) => identity(lease[field]))));
+}
+export function isNodeLinkTarget(value) {
+    return record(value) && identity(value.nodeId) && identity(value.resourceId);
+}
+/** Deadline-bearing keys remain expired after their settled receipt has been pruned. */
+export function nodeLinkCommandDeadline(commandId) {
+    const match = /^nl1:([0-9]{1,16}):[^:]+$/.exec(commandId);
+    if (!match)
+        return undefined;
+    const deadline = Number(match[1]);
+    return Number.isSafeInteger(deadline) && deadline > 0 ? deadline : undefined;
+}
+export function isNodeLinkCommand(value) {
+    return (record(value) &&
+        identity(value.commandId) &&
+        identity(value.operation) &&
+        isNodeLinkTarget(value.target) &&
+        isNodeLinkAuthority(value.authority) &&
+        finite(value.expiresAt) &&
+        (!value.commandId.startsWith('nl1:') ||
+            nodeLinkCommandDeadline(value.commandId) === value.expiresAt) &&
+        Object.hasOwn(value, 'input') &&
+        Object.keys(value).every((key) => ['commandId', 'operation', 'target', 'authority', 'expiresAt', 'input'].includes(key)));
+}
+export function isNodeLinkReceipt(value) {
+    return (record(value) &&
+        identity(value.commandId) &&
+        typeof value.digest === 'string' &&
+        /^[a-f0-9]{64}$/.test(value.digest) &&
+        identity(value.operation) &&
+        isNodeLinkTarget(value.target) &&
+        isNodeLinkAuthority(value.authority) &&
+        finite(value.expiresAt) &&
+        finite(value.admittedAt) &&
+        [
+            'admitted',
+            'running',
+            'cancel-requested',
+            'completed',
+            'failed',
+            'cancelled',
+            'unknown',
+        ].includes(String(value.state)) &&
+        typeof value.closeoutConfirmed === 'boolean' &&
+        (value.settledAt === undefined || finite(value.settledAt)) &&
+        (value.error === undefined ||
+            (record(value.error) &&
+                identity(value.error.code) &&
+                typeof value.error.message === 'string')));
+}
+//# sourceMappingURL=node-link.js.map

package/dist/transport/node-link.js.map

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

package/dist/version.d.ts

@@ -1,4 +1,4 @@
-export declare const PROTOCOL_VERSION = "0.80.0";
+export declare const PROTOCOL_VERSION = "0.82.0";
 /** Node-facing additions since this release remain additive or capability-gated. */
 export declare const MINIMUM_PROTOCOL_VERSION = "0.76.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,7 +1,7 @@
 // Published protocol release plus an explicit oldest-supported peer.
 // Different release numbers are harmless when both declared bounds are met;
 // optional methods/events still require their existing feature capabilities.
-export const PROTOCOL_VERSION = '0.80.0';
+export const PROTOCOL_VERSION = '0.82.0';
 /** Node-facing additions since this release remain additive or capability-gated. */
 export const MINIMUM_PROTOCOL_VERSION = '0.76.0';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farmslot/protocol",
-  "version": "0.80.0",
+  "version": "0.82.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -365,6 +365,11 @@
       "import": "./dist/node/farm-layout.js",
       "default": "./dist/node/farm-layout.js"
     },
+    "./node/node-pty-helper": {
+      "types": "./dist/node/node-pty-helper.d.ts",
+      "import": "./dist/node/node-pty-helper.js",
+      "default": "./dist/node/node-pty-helper.js"
+    },
     "./node/loopback-host": {
       "types": "./dist/node/loopback-host.d.ts",
       "import": "./dist/node/loopback-host.js",
@@ -397,6 +402,14 @@
       "types": "./dist/performance/index.d.ts",
       "import": "./dist/performance/index.js",
       "default": "./dist/performance/index.js"
+    },
+    "./recipe-shape.mjs": {
+      "types": "./recipe-shape.d.mts",
+      "default": "./recipe-shape.mjs"
+    },
+    "./scripts/recipe-library-identity.mjs": {
+      "types": "./scripts/recipe-library-identity.d.mts",
+      "default": "./scripts/recipe-library-identity.mjs"
     }
   },
   "scripts": {
@@ -405,7 +418,7 @@
     "format:check": "prettier --check --ignore-path ../../.prettierignore .",
     "lint": "eslint \"src/**/*.ts\" \"test/**/*.ts\"",
     "lint:fix": "eslint \"src/**/*.ts\" \"test/**/*.ts\" --fix",
-    "test": "yarn build && node ../../scripts/quality/run-tsx-tests.mjs --cwd . --tsconfig tsconfig.json test",
+    "test": "yarn build && node --test test/recipe-shape.test.cjs && node ../../scripts/quality/run-tsx-tests.mjs --cwd . --tsconfig tsconfig.json test",
     "quality": "prettier --check --ignore-path ../../.prettierignore . && eslint \"src/**/*.ts\" \"test/**/*.ts\" && tsc --noEmit --project tsconfig.json && yarn test",
     "build": "rm -rf dist && tsc --project tsconfig.json",
     "prepack": "cd ../.. && node scripts/quality/check-farmslot-package-readiness.mjs --require-changelog --packages @farmslot/protocol && yarn workspace @farmslot/protocol build",
@@ -448,7 +461,11 @@
     "scripts/acceptance.d.cts",
     "scripts/acceptance.d.mts",
     "scripts/review-approval-policy.cjs",
-    "scripts/review-approval-policy.d.cts"
+    "scripts/review-approval-policy.d.cts",
+    "recipe-shape.mjs",
+    "recipe-shape.d.mts",
+    "scripts/recipe-library-identity.mjs",
+    "scripts/recipe-library-identity.d.mts"
   ],
   "publishConfig": {
     "access": "public"

package/recipe-shape.d.mts

@@ -0,0 +1,91 @@
+export interface RecipeShapeCriterion {
+  id: string;
+  text?: string;
+  proofMode?: string;
+}
+export interface RecipeShapeBlock {
+  id: string;
+  ref?: string;
+  tokens?: string[];
+  sig?: string[];
+}
+export interface RecipeShapeSource {
+  name: string;
+  revision: string | null;
+  fingerprint: string | null;
+}
+export interface RecipeShapeCatalog {
+  adapter?: string | null;
+  available: boolean;
+  blocks: RecipeShapeBlock[];
+  sources: RecipeShapeSource[];
+}
+export interface RecipeShapeInput {
+  recipe: unknown;
+  nonLocalCriteria?: string[];
+  criteria?: RecipeShapeCriterion[] | null;
+  catalog?: RecipeShapeCatalog | null;
+}
+export interface RecipeShapeHint {
+  kind: 'parameterize' | 'compose' | 'shorten' | 'acceptance' | 'catalog';
+  message: string;
+  field?: string;
+  nodes?: string[];
+  flow?: string;
+  ref?: string;
+  criterionId?: string;
+}
+export interface RecipeShapeFeedback {
+  policyVersion: number;
+  inputIdentity: { recipe: string; criteria: string; catalog: string };
+  nodes: number;
+  calls: number;
+  templatedValues: number;
+  literalValues: number;
+  short: number;
+  composed: number | null;
+  parameterized: number;
+  inlineDuplicates: { flow: string; ref?: string; nodes: string[] }[];
+  goodShape: boolean;
+  acCoverage: {
+    nonLocal: string[];
+    available: boolean;
+    expected: string[];
+    covered: string[];
+    missing: string[];
+    reviewOnly: string[];
+    unexpected: string[];
+    complete: boolean;
+  };
+  eligibleForImitation: boolean;
+  catalogTrust: 'worker-supplied-self-consistent';
+  status: 'ok' | 'warn' | 'unavailable';
+  hints: RecipeShapeHint[];
+}
+export const POLICY_VERSION: number;
+export const RECIPE_SHAPE_POLICY: Readonly<{
+  short: Readonly<{ good: number; max: number }>;
+  positive: Readonly<{ short: number; composed: number; parameterized: number }>;
+  skipValueKeys: string;
+  selectorKeys: string;
+}>;
+export function stableDigest(value: unknown): string;
+export function inspectRecipeShape(recipe: {
+  workflow?: { entry?: string; teardown?: string; nodes?: Record<string, unknown> };
+}): { order: string[]; reachable: string[]; tokens: string[]; signature: string[] };
+export function recipeShapeNodeToken(node: Record<string, unknown>): string;
+export function recipeShapeSignature(tokens: string[]): string[];
+export function isRecipeShapeObservation(action?: string): boolean;
+export function scoreRecipeShape(input: RecipeShapeInput): RecipeShapeFeedback;
+export function isRecipeShapeFeedback(value: unknown): value is RecipeShapeFeedback;
+
+export function recipeShapeLibraryRef(
+  name: string | null,
+  relativePath: string,
+  platforms?: string[],
+  adapter?: string,
+): string | null;
+export function recipeShapeBlock(ref: string, recipe: unknown): RecipeShapeBlock | null;
+export function processShapeRequest(request: Record<string, unknown>): unknown;
+
+export function recipeShapeSelector(node: Record<string, unknown>): string | null;