@farmslot/adapter-sdk 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+All notable changes to `@farmslot/adapter-sdk` are tracked here.
+
+## Unreleased
+
+- Active-development baseline; add user-facing changes here before release or package publication.
+
+## 0.1.0 - 2026-10-04
+
+- Add the platform adapter contract: `PlatformAdapter` and its member types, `defineAdapter`, and `createAdapterRegistry`. A registry refuses a duplicate id and any adapter written for another `sdkVersion`. Extracted from the metamask-harness adapter surface; a host extends `PlatformAdapter` with its own members.
+- Publish with protocol 0.34.0 and recipe-runner 0.23.0.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Arthur Breton
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,39 @@
+# @farmslot/adapter-sdk
+
+The platform adapter contract for recipe harnesses. A platform adapter owns everything one
+target kind needs (ports, readiness, logs, the action set, install/verify/cleanup, recording and
+diagnostics), so the commands that drive it never compare adapter ids.
+
+```ts
+import { createAdapterRegistry, defineAdapter } from '@farmslot/adapter-sdk';
+
+const web = defineAdapter({ id: 'web', sdkVersion: 1, headless: false /* … */ });
+const registry = createAdapterRegistry();
+registry.register(web);
+registry.get('web');
+```
+
+A host extends `PlatformAdapter` with its own members and types its registry with that:
+`createAdapterRegistry<HostAdapter>()`. A registry refuses a duplicate id and any adapter whose
+`sdkVersion` differs from `ADAPTER_SDK_VERSION`.
+
+Docs: https://farmslot.io/docs/reference/adapter-sdk
+
+## Source layout
+
+| path              | owns                                                          |
+| ----------------- | ------------------------------------------------------------- |
+| `src/types.ts`    | `PlatformAdapter`, its member types and `ADAPTER_SDK_VERSION` |
+| `src/registry.ts` | `defineAdapter` and `createAdapterRegistry`                   |
+
+## Maintenance rules
+
+- Types first. The only runtime code is the registry and its shape check.
+- No platform or product names. A behavior one platform needs becomes an optional member.
+- Removing or renaming a member is a breaking change: bump `ADAPTER_SDK_VERSION`.
+
+## Local quality
+
+```sh
+yarn workspace @farmslot/adapter-sdk quality
+```

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { type AdapterRegistry, createAdapterRegistry, defineAdapter } from './registry.js';
+export { ADAPTER_SDK_VERSION, type AdapterActions, type AdapterCdpTarget, type AdapterConsoleFiles, type AdapterDevServer, type AdapterDevServerStop, type AdapterDiagnostics, type AdapterHarness, type AdapterHarnessLeaf, type AdapterHarnessVerify, type AdapterHints, type AdapterLogSource, type AdapterRecording, type AdapterRuntimeContextSpec, type AdapterRuntimeStatus, type AdapterSdkVersion, type AdapterUiHarness, type AdapterUiTransport, type NativeUiTransport, type NativeUiTransportOptions, type PlatformAdapter, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC3F,OAAO,EACL,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createAdapterRegistry, defineAdapter } from './registry.js';
+export { ADAPTER_SDK_VERSION, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,qBAAqB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC3F,OAAO,EACL,mBAAmB,GAqBpB,MAAM,YAAY,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,12 @@
+import { type PlatformAdapter } from './types.js';
+export interface AdapterRegistry<A extends PlatformAdapter = PlatformAdapter> {
+    register(adapter: A): void;
+    get(id: string): A;
+    has(id: string): boolean;
+    list(): string[];
+}
+/** Type and shape-check a platform adapter where it is written. */
+export declare function defineAdapter<A extends PlatformAdapter>(adapter: A): A;
+/** A registry keyed by adapter id. Registering an id twice throws. */
+export declare function createAdapterRegistry<A extends PlatformAdapter = PlatformAdapter>(): AdapterRegistry<A>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAEvE,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe;IAC1E,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;IAC3B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,CAAC;IACnB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAEzB,IAAI,IAAI,MAAM,EAAE,CAAC;CAClB;AAeD,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,CAAC,SAAS,eAAe,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAGtE;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,CACnC,CAAC,SAAS,eAAe,GAAG,eAAe,KACxC,eAAe,CAAC,CAAC,CAAC,CAmBtB"}

package/dist/registry.js

@@ -0,0 +1,38 @@
+import { ADAPTER_SDK_VERSION } from './types.js';
+// Throws when the adapter cannot be registered by any host: a missing id, or an
+// SDK version this package does not implement.
+function assertAdapterShape(adapter) {
+    if (typeof adapter.id !== 'string' || adapter.id.trim() === '') {
+        throw new Error('adapter id must be a non-empty string');
+    }
+    if (adapter.sdkVersion !== ADAPTER_SDK_VERSION) {
+        throw new Error(`adapter '${adapter.id}' targets adapter SDK ${String(adapter.sdkVersion)}; this host implements ${ADAPTER_SDK_VERSION}`);
+    }
+}
+/** Type and shape-check a platform adapter where it is written. */
+export function defineAdapter(adapter) {
+    assertAdapterShape(adapter);
+    return adapter;
+}
+/** A registry keyed by adapter id. Registering an id twice throws. */
+export function createAdapterRegistry() {
+    const adapters = new Map();
+    const registry = {
+        register(adapter) {
+            assertAdapterShape(adapter);
+            if (adapters.has(adapter.id))
+                throw new Error(`adapter '${adapter.id}' is already registered`);
+            adapters.set(adapter.id, adapter);
+        },
+        get(id) {
+            const adapter = adapters.get(id);
+            if (!adapter)
+                throw new Error(`unknown adapter '${id}' (registered: ${registry.list().join(', ')})`);
+            return adapter;
+        },
+        has: (id) => adapters.has(id),
+        list: () => [...adapters.keys()],
+    };
+    return registry;
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAwB,MAAM,YAAY,CAAC;AAUvE,gFAAgF;AAChF,+CAA+C;AAC/C,SAAS,kBAAkB,CAAC,OAAwB;IAClD,IAAI,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,KAAK,mBAAmB,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CACb,YAAY,OAAO,CAAC,EAAE,yBAAyB,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,0BAA0B,mBAAmB,EAAE,CACzH,CAAC;IACJ,CAAC;AACH,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,aAAa,CAA4B,OAAU;IACjE,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,qBAAqB;IAGnC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAa,CAAC;IACtC,MAAM,QAAQ,GAAuB;QACnC,QAAQ,CAAC,OAAO;YACd,kBAAkB,CAAC,OAAO,CAAC,CAAC;YAC5B,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,YAAY,OAAO,CAAC,EAAE,yBAAyB,CAAC,CAAC;YACnE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACpC,CAAC;QACD,GAAG,CAAC,EAAE;YACJ,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACjC,IAAI,CAAC,OAAO;gBACV,MAAM,IAAI,KAAK,CAAC,oBAAoB,EAAE,kBAAkB,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzF,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;KACjC,CAAC;IACF,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,175 @@
+import type { RecipeValidationFinding } from '@farmslot/protocol';
+import type { ActionAdapter, ActionExecutionContext, RecordingTarget, RecordingTargetContext, StandardUiAction, UiActionTransport, VideoRecorder } from '@farmslot/recipe-runner';
+import type { CreateCdpWebUiTransportOptions } from '@farmslot/recipe-runner/runtime/cdp';
+import type { CreateReactNativeBridgeUiTransportOptions } from '@farmslot/recipe-runner/runtime/react-native-bridge';
+/** The adapter SDK major version a host implements. */
+export declare const ADAPTER_SDK_VERSION = 1;
+export type AdapterSdkVersion = typeof ADAPTER_SDK_VERSION;
+export interface PlatformAdapter {
+    /** Registry key and the value of `--adapter`. */
+    readonly id: string;
+    /** The SDK version this adapter was written against. A host refuses any other. */
+    readonly sdkVersion: AdapterSdkVersion;
+    readonly headless: boolean;
+    resolveSlotPorts(target: string): void;
+    runtimeStatus(target: string): Promise<AdapterRuntimeStatus>;
+    devServer: AdapterDevServer;
+    logSources(target: string): AdapterLogSource[];
+    appLogSource(target: string): AdapterLogSource | null;
+    hints: AdapterHints;
+    actions: AdapterActions;
+    harness: AdapterHarness;
+    runtimeContext: AdapterRuntimeContextSpec;
+    reload?(target: string, json: boolean): Promise<number>;
+    recording?: AdapterRecording;
+    diagnostics?: AdapterDiagnostics;
+    sourceFingerprint?(root: string): string;
+}
+export interface AdapterRuntimeStatus {
+    decision: string;
+    reasonCode?: string;
+    reasons: string[];
+    nextAction?: string;
+    deps?: string;
+    devServer?: {
+        label: string;
+        status: string;
+    };
+}
+export interface AdapterLogSource {
+    label: string;
+    path: string;
+}
+export type AdapterDevServerStop = {
+    kind: 'headless';
+    message: string;
+    userAction: string;
+} | {
+    kind: 'stopped';
+    status: number;
+    summary: string;
+    signalled?: number;
+    output?: string;
+};
+export interface AdapterDevServer {
+    label: string;
+    describe(): string;
+    stop(target: string): AdapterDevServerStop;
+    afterStop?(target: string): string;
+}
+export interface AdapterHints {
+    launch: string;
+    relaunch: string;
+    runtimeProbeRecovery(target: string): string;
+}
+export interface AdapterActions {
+    manifestPath(): string;
+    semantic: readonly string[];
+    liveOnly?: readonly string[];
+    liveNeedsCdpPort?: boolean;
+    tsxLiveScripts?: {
+        env(projectRoot: string, tempDir: string): Promise<NodeJS.ProcessEnv>;
+    };
+    cdpTarget: AdapterCdpTarget;
+    ui?(harness: AdapterUiHarness, options: {
+        hudPolicy: 'auto' | 'show';
+    }): AdapterUiTransport;
+    wrap?(adapters: ActionAdapter[]): Promise<ActionAdapter[]>;
+    lifecycle?(adapters: ActionAdapter[]): Promise<ActionAdapter[]>;
+    inputFindings?(nodeId: string, node: Record<string, unknown>): RecipeValidationFinding[];
+}
+export interface AdapterCdpTarget {
+    transport: string;
+    probePath: string;
+    watcherPortFirst?: boolean;
+    requiredProbe?(node: Record<string, unknown>, context: ActionExecutionContext): Promise<Record<string, unknown>>;
+}
+export interface NativeUiTransport extends UiActionTransport {
+    close?(): Promise<void>;
+}
+export interface NativeUiTransportOptions {
+    platform: 'ios' | 'android';
+    device: string;
+    app: string;
+    session: string;
+    stateDir: string;
+}
+export interface AdapterUiHarness {
+    createReactNativeBridgeUiTransport: (options: CreateReactNativeBridgeUiTransportOptions) => UiActionTransport;
+    createCdpWebUiTransport: (options: CreateCdpWebUiTransportOptions) => UiActionTransport;
+    createNativeUiTransport?: (options: NativeUiTransportOptions) => Promise<NativeUiTransport>;
+}
+export interface AdapterUiTransport {
+    base: UiActionTransport;
+    execute?(action: StandardUiAction, node: Record<string, unknown>, context: ActionExecutionContext, standard: () => Promise<unknown>): Promise<unknown>;
+}
+export interface AdapterHarnessLeaf {
+    entry: string;
+    fallback: string;
+    node?: boolean;
+}
+export type AdapterHarnessVerify = {
+    command: string;
+    prefixArgs: string[];
+} | {
+    inProcess(): Promise<(args: string[], io: {
+        out(line: string): void;
+        err(line: string): void;
+    }) => Promise<number>>;
+} | {
+    error: string;
+};
+export interface AdapterHarness {
+    install: AdapterHarnessLeaf;
+    cleanup: AdapterHarnessLeaf & {
+        fromInstalledRunner?: boolean;
+    };
+    verify(target: string): AdapterHarnessVerify;
+    verifyArgs?(target: string, args: string[]): string[];
+    restart?: string;
+}
+export interface AdapterRuntimeContextSpec {
+    forbiddenFields: readonly string[];
+    localPorts?: {
+        cdp?: number;
+        watcher?: number;
+    };
+    resources?(ports: {
+        watcherPort: unknown;
+        existing: Record<string, unknown>;
+        defaults: Record<string, string | number>;
+        envPort(...names: string[]): number | undefined;
+    }): Record<string, unknown>;
+}
+export interface AdapterRecording {
+    target(context: RecordingTargetContext): Promise<RecordingTarget>;
+    framed?: {
+        browserPid(projectRoot: string, artifactsDir: string, cdpPort?: string): number | undefined;
+    };
+    videoRecorder?(): Promise<VideoRecorder | undefined>;
+}
+export interface AdapterConsoleFiles {
+    extensionLog: string;
+    pageLog: string;
+    pidFile: string;
+}
+export interface AdapterDiagnostics {
+    console?: {
+        start(projectRoot: string): Promise<void>;
+        files(projectRoot: string): AdapterConsoleFiles;
+        cdpPort(): string | undefined;
+        verifyControl(capture: {
+            projectRoot: string;
+            cdpPort: string;
+        } & AdapterConsoleFiles): Promise<{
+            ok: boolean;
+            detail: string;
+        }>;
+    };
+    walletLog?(projectRoot: string): string;
+    issueBuffer?: {
+        arm(projectRoot: string): boolean;
+        collect(projectRoot: string): unknown[] | null;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+// The platform adapter contract: one interface every command resolves platform
+// behavior through, so no command compares adapter ids. A new platform behavior
+// adds a member here, implemented by the platforms that own it.
+/** The adapter SDK major version a host implements. */
+export const ADAPTER_SDK_VERSION = 1;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,gFAAgF;AAChF,gEAAgE;AAehE,uDAAuD;AACvD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@farmslot/adapter-sdk",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit --project tsconfig.json",
+    "test": "node ../../scripts/quality/run-tsx-tests.mjs --cwd . --tsconfig tsconfig.json test",
+    "format": "prettier --write --ignore-path ../../.prettierignore .",
+    "format:check": "prettier --check --ignore-path ../../.prettierignore .",
+    "lint": "eslint \"src/**/*.ts\" \"test/**/*.ts\"",
+    "lint:fix": "eslint \"src/**/*.ts\" \"test/**/*.ts\" --fix",
+    "quality": "prettier --check --ignore-path ../../.prettierignore . && eslint \"src/**/*.ts\" \"test/**/*.ts\" && tsc --noEmit --project tsconfig.json && yarn build && yarn test",
+    "build": "yarn workspace @farmslot/recipe-runner build && rm -rf dist && tsc --project tsconfig.build.json",
+    "prepack": "cd ../.. && node scripts/quality/check-farmslot-package-readiness.mjs --require-changelog --packages @farmslot/adapter-sdk && yarn workspace @farmslot/adapter-sdk build",
+    "prepublishOnly": "node ../../scripts/quality/check-farmslot-package-readiness.mjs --publish --packages @farmslot/adapter-sdk"
+  },
+  "dependencies": {
+    "@farmslot/protocol": "0.34.0",
+    "@farmslot/recipe-runner": "0.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "eslint": "^10.3.0",
+    "prettier": "^3.8.3",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deeeed/farmslot.git",
+    "directory": "packages/adapter-sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/deeeed/farmslot/issues"
+  },
+  "license": "MIT",
+  "homepage": "https://farmslot.io/docs/reference/adapter-sdk",
+  "keywords": [
+    "farmslot",
+    "recipe",
+    "adapter-sdk",
+    "platform-adapter",
+    "agentic-engineering"
+  ],
+  "files": [
+    "README.md",
+    "LICENSE",
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "dist/**/*.d.ts.map",
+    "dist/**/*.js.map"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}