@farmslot/protocol 0.5.0

package/dist/methods/slot.js

@@ -0,0 +1,21 @@
+import { Methods } from './registry.js';
+export const SlotMethods = {
+    check: Methods.SLOT_CHECK,
+    prepare: Methods.SLOT_PREPARE,
+    release: Methods.SLOT_RELEASE,
+    recycle: Methods.SLOT_RECYCLE,
+    refresh: Methods.SLOT_REFRESH,
+    cleanup: Methods.SLOT_CLEANUP,
+    fixtureRefresh: Methods.SLOT_FIXTURE_REFRESH,
+    runHistory: Methods.RUN_SLOT_HISTORY,
+    forSlot: Methods.RUN_FOR_SLOT,
+    recipeRunsForSlot: Methods.RUN_RECIPE_RUNS_FOR_SLOT,
+    recipeRerun: Methods.RECIPE_RERUN,
+    recipeCancel: Methods.RECIPE_CANCEL,
+    recipeCommand: Methods.RECIPE_COMMAND,
+    recipeProjectHookCommand: Methods.RECIPE_PROJECT_HOOK_COMMAND,
+    recipeProjectHookRun: Methods.RECIPE_PROJECT_HOOK_RUN,
+    actionList: Methods.SLOT_ACTION_LIST,
+    actionRun: Methods.SLOT_ACTION_RUN,
+};
+//# sourceMappingURL=slot.js.map

package/dist/methods/slot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot.js","sourceRoot":"","sources":["../../src/methods/slot.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,KAAK,EAAE,OAAO,CAAC,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC,YAAY;IAC7B,OAAO,EAAE,OAAO,CAAC,YAAY;IAC7B,OAAO,EAAE,OAAO,CAAC,YAAY;IAC7B,OAAO,EAAE,OAAO,CAAC,YAAY;IAC7B,OAAO,EAAE,OAAO,CAAC,YAAY;IAC7B,cAAc,EAAE,OAAO,CAAC,oBAAoB;IAC5C,UAAU,EAAE,OAAO,CAAC,gBAAgB;IACpC,OAAO,EAAE,OAAO,CAAC,YAAY;IAC7B,iBAAiB,EAAE,OAAO,CAAC,wBAAwB;IACnD,WAAW,EAAE,OAAO,CAAC,YAAY;IACjC,YAAY,EAAE,OAAO,CAAC,aAAa;IACnC,aAAa,EAAE,OAAO,CAAC,cAAc;IACrC,wBAAwB,EAAE,OAAO,CAAC,2BAA2B;IAC7D,oBAAoB,EAAE,OAAO,CAAC,uBAAuB;IACrD,UAAU,EAAE,OAAO,CAAC,gBAAgB;IACpC,SAAS,EAAE,OAAO,CAAC,eAAe;CAC1B,CAAC"}

package/dist/methods/task.d.ts

@@ -0,0 +1,18 @@
+import type { AgentRole } from '../types.js';
+import type { SlotAgentTargetParams } from './terminal.js';
+export interface TaskProgressParams extends SlotAgentTargetParams {
+    /**
+     * Parse a specific task markdown file instead of the active run/context file.
+     * Relative paths are resolved under the slot repo root; absolute paths must
+     * still live under that repo root.
+     */
+    taskFile?: string;
+}
+export interface TaskProgressResult {
+    slotId: string;
+    role?: AgentRole;
+    contextId?: string;
+    markdown: string;
+    structured?: import('../types.js').TaskProgressStructured;
+}
+//# sourceMappingURL=task.d.ts.map

package/dist/methods/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/methods/task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,MAAM,WAAW,kBAAmB,SAAQ,qBAAqB;IAC/D;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,aAAa,EAAE,sBAAsB,CAAC;CAC3D"}

package/dist/methods/task.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=task.js.map

package/dist/methods/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../src/methods/task.ts"],"names":[],"mappings":""}

package/dist/methods/terminal.d.ts

@@ -0,0 +1,66 @@
+import type { AgentRole } from '../types.js';
+import type { TmuxWorkerRef } from './tmux.js';
+export interface SlotAgentTargetParams {
+    slotId: string;
+    runId?: string;
+    role?: AgentRole;
+    contextId?: string;
+    target?: string;
+    bareSession?: boolean;
+}
+export interface TerminalSubscribeParams extends SlotAgentTargetParams {
+    interactive?: boolean;
+    cols?: number;
+    rows?: number;
+}
+export interface TerminalSendParams extends SlotAgentTargetParams {
+    text: string;
+    enter?: boolean;
+}
+export interface TerminalSnapshotParams extends SlotAgentTargetParams {
+    lines?: number;
+}
+export interface TerminalInputParams extends SlotAgentTargetParams {
+    data: string;
+}
+export interface TerminalResizeParams extends SlotAgentTargetParams {
+    cols: number;
+    rows: number;
+}
+export interface TerminalReinitParams extends SlotAgentTargetParams {
+}
+export interface TerminalSnapshotResult {
+    slotId: string;
+    role?: AgentRole;
+    contextId?: string;
+    lines: string[];
+    timestamp: number;
+}
+export interface TerminalWorkerSubscribeParams {
+    worker: TmuxWorkerRef;
+    lines?: number;
+    cols?: number;
+    rows?: number;
+}
+export interface TerminalWorkerUnsubscribeParams {
+    worker: TmuxWorkerRef;
+}
+export interface TerminalWorkerInputParams {
+    worker: TmuxWorkerRef;
+    data: string;
+}
+export interface TerminalWorkerResizeParams {
+    worker: TmuxWorkerRef;
+    cols: number;
+    rows: number;
+}
+export interface TerminalWorkerSnapshotParams {
+    worker: TmuxWorkerRef;
+    lines?: number;
+}
+export interface TerminalWorkerSnapshotResult {
+    worker: TmuxWorkerRef;
+    lines: string[];
+    timestamp: number;
+}
+//# sourceMappingURL=terminal.d.ts.map

package/dist/methods/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/methods/terminal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAKhB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,uBAAwB,SAAQ,qBAAqB;IACpE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAmB,SAAQ,qBAAqB;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,sBAAuB,SAAQ,qBAAqB;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAoB,SAAQ,qBAAqB;IAChE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAqB,SAAQ,qBAAqB;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAqB,SAAQ,qBAAqB;CAAG;AACtE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/methods/terminal.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=terminal.js.map

package/dist/methods/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../../src/methods/terminal.ts"],"names":[],"mappings":""}

package/dist/methods/tmux.d.ts

@@ -0,0 +1,108 @@
+export type TmuxWorkerStatusSource = 'hook' | 'statusline' | 'task-file' | 'tmux' | 'gateway' | 'inferred' | 'unknown';
+export type TmuxWorkerStatusConfidence = 'high' | 'medium' | 'low';
+export type TmuxWorkerActivityState = 'active' | 'waiting' | 'idle' | 'stale' | 'unknown';
+export interface TmuxWorkerRef {
+    nodeId: string;
+    session: string;
+    window?: string;
+    windowName?: string;
+    pane?: string;
+    paneId?: string;
+    target: string;
+}
+export interface TmuxWorkerStatusReading {
+    label: string;
+    source: TmuxWorkerStatusSource;
+    confidence: TmuxWorkerStatusConfidence;
+    observedAt?: number;
+    stale?: boolean;
+    state?: TmuxWorkerActivityState;
+    conflicts?: string[];
+}
+export interface TmuxWorkerSummary {
+    ref: TmuxWorkerRef;
+    title?: string;
+    cwd?: string;
+    command?: string;
+    pid?: number;
+    width?: number;
+    height?: number;
+    active?: boolean;
+    linkedSlotId?: string;
+    linkedRunId?: string;
+    linkedFamilyId?: string;
+    branch?: string;
+    lastChangedAt?: number;
+    status: TmuxWorkerStatusReading;
+}
+export interface TmuxWorkerNodeSummary {
+    panes: number;
+    active: number;
+    waiting: number;
+    idle: number;
+    stale: number;
+    unknown: number;
+}
+export interface TmuxWorkerNodeResult {
+    nodeId: string;
+    connected: boolean;
+    ok: boolean;
+    observedAt: number;
+    workers: TmuxWorkerSummary[];
+    summary?: TmuxWorkerNodeSummary;
+    hiddenWorkers?: number;
+    error?: string;
+}
+export interface TmuxWorkerListParams {
+    /** Include registered pool machines that currently have no connected node. Default true. */
+    includeDisconnected?: boolean;
+}
+export interface TmuxWorkerListResult {
+    observedAt: number;
+    nodes: TmuxWorkerNodeResult[];
+    workers: TmuxWorkerSummary[];
+    hiddenWorkers?: number;
+}
+export interface NodeTmuxPaneSignals {
+    hook?: {
+        label?: string;
+        observedAt?: number;
+        event?: string;
+    };
+    statusline?: {
+        label?: string;
+        observedAt?: number;
+        busy?: boolean;
+        model?: string;
+        ctxPct?: number;
+    };
+    taskFile?: {
+        label?: string;
+        observedAt?: number;
+        status?: string;
+        phase?: string;
+    };
+}
+export interface NodeTmuxPane {
+    session: string;
+    window: string;
+    windowName?: string;
+    pane: string;
+    paneId?: string;
+    target: string;
+    active?: boolean;
+    width?: number;
+    height?: number;
+    title?: string;
+    cwd?: string;
+    command?: string;
+    pid?: number;
+    branch?: string;
+    observedAt?: number;
+    lastChangedAt?: number;
+    signals?: NodeTmuxPaneSignals;
+}
+export interface NodeTmuxPanesResult {
+    panes: NodeTmuxPane[];
+}
+//# sourceMappingURL=tmux.d.ts.map

package/dist/methods/tmux.d.ts.map

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

package/dist/methods/tmux.js

@@ -0,0 +1,3 @@
+// methods/tmux.ts — node-scoped tmux worker inventory
+export {};
+//# sourceMappingURL=tmux.js.map

package/dist/methods/tmux.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux.js","sourceRoot":"","sources":["../../src/methods/tmux.ts"],"names":[],"mappings":"AAAA,sDAAsD"}

package/dist/methods/workspace.d.ts

@@ -0,0 +1,11 @@
+import type { OkResult } from '../types.js';
+export interface WorkspaceMetroSubscribeParams {
+    slotId: string;
+    lastN?: number;
+}
+export type WorkspaceMetroSubscribeResult = OkResult;
+export interface WorkspaceMetroUnsubscribeParams {
+    slotId: string;
+}
+export type WorkspaceMetroUnsubscribeResult = OkResult;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/methods/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/methods/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,6BAA6B,GAAG,QAAQ,CAAC;AAErD,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,+BAA+B,GAAG,QAAQ,CAAC"}

package/dist/methods/workspace.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=workspace.js.map

package/dist/methods/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../src/methods/workspace.ts"],"names":[],"mappings":""}

package/dist/methods.d.ts

@@ -0,0 +1,2 @@
+export * from './methods/index.js';
+//# sourceMappingURL=methods.d.ts.map

package/dist/methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.d.ts","sourceRoot":"","sources":["../src/methods.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC"}

package/dist/methods.js

@@ -0,0 +1,3 @@
+// Compatibility barrel: keep existing './methods.js' and package-root imports stable.
+export * from './methods/index.js';
+//# sourceMappingURL=methods.js.map

package/dist/methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.js","sourceRoot":"","sources":["../src/methods.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,cAAc,oBAAoB,CAAC"}

package/dist/recipe-compat.d.ts

@@ -0,0 +1,89 @@
+export declare const RECIPE_PROTOCOL_SCHEMA_VERSION = 1;
+export declare const RECIPE_PLAYBACK_SLOW_MS_MIN = 100;
+export declare const RECIPE_PLAYBACK_SLOW_MS_MAX = 60000;
+export declare const OFFICIAL_RECIPE_ACTIONS: readonly ["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 type OfficialActionName = (typeof OFFICIAL_RECIPE_ACTIONS)[number];
+export type RecipeActionName = OfficialActionName | (string & {});
+export interface RecipeActionCatalogExample {
+    description?: string;
+    node: Record<string, unknown>;
+}
+export interface RecipeActionCatalogEntry {
+    description?: string;
+    schema?: Record<string, unknown>;
+    examples?: RecipeActionCatalogExample[];
+    when_to_use?: string;
+    avoid_when?: string;
+    proof_effect?: string;
+    safety_notes?: string;
+}
+export interface RecipeCustomActionDeclaration extends RecipeActionCatalogEntry {
+    name: string;
+    owner?: string;
+}
+export interface RecipeNamedDeclaration {
+    name: string;
+    description?: string;
+    schema?: Record<string, unknown>;
+}
+export interface RecipeStateRefDeclaration {
+    name: string;
+    description?: string;
+    schema?: Record<string, unknown>;
+}
+export interface RecipePreconditionDeclaration {
+    id: string;
+    description: string;
+    failure_kind?: string;
+}
+export interface RecipeNativeBindingDeclaration {
+    action: RecipeActionName;
+    implementation: string;
+}
+export interface RecipeActionManifestDocument {
+    runner_protocol_version: 1;
+    action_registry_version: 1;
+    supported_official_actions: OfficialActionName[];
+    action_metadata?: Partial<Record<OfficialActionName, RecipeActionCatalogEntry>>;
+    custom_actions?: RecipeCustomActionDeclaration[];
+    custom_assertion_operators?: RecipeNamedDeclaration[];
+    state_refs?: RecipeStateRefDeclaration[];
+    pre_conditions?: RecipePreconditionDeclaration[];
+    native_bindings?: RecipeNativeBindingDeclaration[];
+}
+export type RecipeCompatibilitySeverity = 'error' | 'warning';
+export type RecipeCompatibilityStatus = 'v1-compatible' | 'legacy-compatible' | 'invalid';
+export interface RecipeCompatibilityFinding {
+    severity: RecipeCompatibilitySeverity;
+    code: string;
+    path: string;
+    message: string;
+}
+export interface RecipeCompatibilityResult {
+    status: RecipeCompatibilityStatus;
+    findings: RecipeCompatibilityFinding[];
+    summary: {
+        errors: number;
+        warnings: number;
+        legacy: boolean;
+    };
+}
+export interface RecipeArtifactPackageInput {
+    manifest?: unknown;
+    artifactPaths?: readonly string[];
+    recipe?: unknown;
+}
+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

package/dist/recipe-compat.d.ts.map

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