@datalayer/agent-runtimes 1.5.86 → 1.5.88

package/lib/specs/harnesses.d.ts

@@ -15,6 +15,7 @@ export declare const GEMINI_CLI_HARNESS_0_0_1: HarnessSpec;
 export declare const GOOSE_HARNESS_0_0_1: HarnessSpec;
 export declare const OPENCODE_HARNESS_0_0_1: HarnessSpec;
 export declare const OPENHANDS_HARNESS_0_0_1: HarnessSpec;
+export declare const PI_HARNESS_0_0_1: HarnessSpec;
 export declare const HARNESS_CATALOGUE: Record<string, HarnessSpec>;
 /** A harness by id. */
 export declare function getHarness(harnessId: string): HarnessSpec | undefined;

package/lib/specs/harnesses.js

@@ -8,6 +8,7 @@ export const CLAUDE_CODE_HARNESS_0_0_1 = {
     name: 'Claude Code',
     description: "Anthropic's coding agent, driven over ACP through the Agent Client Protocol project's adapter on the Claude Agent SDK.",
     enabled: true,
+    unavailable_because: '',
     tags: ['harness'],
     docs: 'https://github.com/agentclientprotocol/claude-agent-acp',
     acp: {
@@ -72,6 +73,7 @@ export const CODEX_HARNESS_0_0_1 = {
     name: 'Codex',
     description: "OpenAI's coding agent, driven over ACP through the Agent Client Protocol project's adapter, which ships the Codex binary it drives.",
     enabled: true,
+    unavailable_because: '',
     tags: ['harness'],
     docs: 'https://github.com/agentclientprotocol/codex-acp',
     acp: {
@@ -127,6 +129,7 @@ export const CUSTOM_HARNESS_0_0_1 = {
     name: 'Custom harness',
     description: "An organization's own ACP agent, its command named by the organization's own harness spec and never typed into a form.",
     enabled: false,
+    unavailable_because: '',
     tags: ['harness'],
     docs: '',
     requires: {
@@ -171,7 +174,8 @@ export const FAST_AGENT_HARNESS_0_0_1 = {
     version: '0.0.1',
     name: 'fast-agent',
     description: "llmindset's agent framework served over ACP; each agent it defines is a session mode, with any model provider it is configured with.",
-    enabled: true,
+    enabled: false,
+    unavailable_because: 'the catalogue offers four harnesses today — Claude Code, Codex, OpenCode and pi (28 October 2026); fast-agent is a framework served over ACP, not a coding agent, its adapter is a Python tool the runtime image does not carry, and it has not been drilled on Datalayer.',
     tags: ['harness', 'framework'],
     docs: 'https://github.com/evalstate/fast-agent/blob/main/docs/docs/acp/index.md',
     acp: {
@@ -226,7 +230,8 @@ export const GEMINI_CLI_HARNESS_0_0_1 = {
     version: '0.0.1',
     name: 'Gemini CLI',
     description: "Google's coding agent, which speaks ACP itself when started with --experimental-acp.",
-    enabled: true,
+    enabled: false,
+    unavailable_because: "the catalogue offers four harnesses today — Claude Code, Codex, OpenCode and pi (28 October 2026); Gemini CLI's API host (generativelanguage.googleapis.com) is outside a Datalayer runtime's egress boundary and is not routed through ai-inference, so it stays unfunded and unoffered there (the user's decision, 28 October 2026).",
     tags: ['harness'],
     docs: 'https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/cli-reference.md',
     acp: {
@@ -282,7 +287,8 @@ export const GOOSE_HARNESS_0_0_1 = {
     version: '0.0.1',
     name: 'goose',
     description: "Block's open agent (now the Agentic AI Foundation's), which speaks ACP itself with goose acp; any model provider it is configured with.",
-    enabled: true,
+    enabled: false,
+    unavailable_because: 'the catalogue offers four harnesses today — Claude Code, Codex, OpenCode and pi (28 October 2026); goose is a binary of its own release, not an npm adapter, the runtime image does not carry it, and it has not been drilled on Datalayer.',
     tags: ['harness'],
     docs: 'https://block.github.io/goose/docs/gdk/acp/',
     acp: {
@@ -338,6 +344,7 @@ export const OPENCODE_HARNESS_0_0_1 = {
     name: 'OpenCode',
     description: "Anomaly's open coding agent, which speaks ACP itself with opencode acp; any model provider it is configured with.",
     enabled: true,
+    unavailable_because: '',
     tags: ['harness'],
     docs: 'https://opencode.ai/docs/acp/',
     acp: {
@@ -392,7 +399,8 @@ export const OPENHANDS_HARNESS_0_0_1 = {
     version: '0.0.1',
     name: 'OpenHands',
     description: 'The OpenHands CLI, which speaks ACP itself with openhands acp; any model provider it is configured with.',
-    enabled: true,
+    enabled: false,
+    unavailable_because: "the catalogue offers four harnesses today — Claude Code, Codex, OpenCode and pi (28 October 2026); OpenHands' adapter is a Python tool the runtime image does not carry, and it has not been drilled on Datalayer.",
     tags: ['harness'],
     docs: 'https://docs.openhands.dev/openhands/usage/run-openhands/acp',
     acp: {
@@ -448,6 +456,62 @@ export const OPENHANDS_HARNESS_0_0_1 = {
         note: "Open source under MIT, no vendor terms of its own; the model provider's terms apply to the key. Launched as openhands acp (OpenHands-CLI README; docs.openhands.dev's ACP page); resumes with --resume; reads skills from .agents/skills (.openhands/skills is legacy).",
     },
 };
+export const PI_HARNESS_0_0_1 = {
+    id: 'pi',
+    version: '0.0.1',
+    name: 'pi',
+    description: "Earendil's pi coding agent, driven over ACP through the pi-acp adapter, which spawns the published pi executable; any model provider pi is configured with.",
+    enabled: true,
+    unavailable_because: '',
+    tags: ['harness'],
+    docs: 'https://github.com/svkozak/pi-acp',
+    acp: {
+        command: 'npx',
+        args: ['-y', 'pi-acp@0.0.34'],
+        protocolVersion: 1,
+        loadSession: true,
+        mcp: 'lend',
+        modes: [],
+        env: {},
+        nativeSession: 'none',
+    },
+    requires: {
+        secrets: ['ANTHROPIC_API_KEY'],
+        binaries: ['node', 'git'],
+    },
+    terms: {
+        servedToThirdParties: 'permitted',
+        licence: 'MIT (adapter); MIT (the agent, @earendil-works/pi-coding-agent 1.4.0)',
+    },
+    skills: {
+        format: 'skill-md',
+        dir: '.pi/skills',
+    },
+    honours: {
+        model: true,
+        subagents: false,
+    },
+    capabilities: {
+        resume: 'load',
+        forkHistory: 'replay',
+        interrupt: true,
+        steering: false,
+        images: false,
+        compaction: 'own',
+        modes: [],
+        autoRun: [],
+    },
+    instructionsFile: 'AGENTS.md',
+    registered: {
+        adapter: 'pi-acp',
+        version: '0.0.34',
+        licenceSource: 'https://www.npmjs.com/package/pi-acp',
+        termsSource: 'https://github.com/earendil-works/pi/blob/main/LICENSE',
+        credential: "The provider's key pi is configured with; ANTHROPIC_API_KEY declared, the person's own",
+        binaries: 'Node 22 (pi-coding-agent engines.node >=22.19.0; pi-acp >=20), the pi executable 1.4.0 on the PATH (@earendil-works/pi-coding-agent), git',
+        note: "Read 2026-10-28. pi speaks no ACP itself; pi-acp 0.0.34 (MIT, an individual's, github.com/svkozak/pi-acp) speaks ACP JSON-RPC over stdio and spawns the published `pi` executable with `pi --mode rpc`, so pi 1.4.0 runs as published — chosen over @automatalabs/pi-acp 0.9.4 (Apache-2.0, in-process, which embeds pi 0.87.1 through its SDK on a fork's package). Open source under MIT on both sides, no vendor terms of their own; the model provider's terms apply to the key. Session persistence through pi's own session files (session/load).",
+    },
+};
 export const HARNESS_CATALOGUE = {
     'claude-code': CLAUDE_CODE_HARNESS_0_0_1,
     codex: CODEX_HARNESS_0_0_1,
@@ -457,6 +521,7 @@ export const HARNESS_CATALOGUE = {
     goose: GOOSE_HARNESS_0_0_1,
     opencode: OPENCODE_HARNESS_0_0_1,
     openhands: OPENHANDS_HARNESS_0_0_1,
+    pi: PI_HARNESS_0_0_1,
 };
 /** A harness by id. */
 export function getHarness(harnessId) {
@@ -836,20 +901,6 @@ export const LISTED_HARNESSES = [
         servedToThirdParties: 'permitted',
         note: 'Bridges ACP to an OpenClaw Gateway, whose providers keep their own terms.',
     },
-    {
-        id: 'pi',
-        name: 'pi (through pi-acp)',
-        docs: 'https://github.com/svkozak/pi-acp',
-        adapter: 'pi-acp',
-        version: '0.0.34',
-        command: 'npx -y pi-acp',
-        licence: 'MIT',
-        licenceSource: 'https://github.com/svkozak/pi-acp/blob/main/LICENSE',
-        termsSource: 'https://github.com/svkozak/pi-acp/blob/main/LICENSE',
-        credential: "pi's configured provider's API key (a subscription login carries its provider's terms)",
-        servedToThirdParties: 'permitted',
-        note: 'Spawns pi --mode rpc from @earendil-works/pi-coding-agent (MIT).',
-    },
     {
         id: 'poolside',
         name: 'Poolside (pool)',

package/lib/specs/index.d.ts

@@ -26,7 +26,7 @@ export * from './frames';
 export * from './cogs';
 export * from './harnesses';
 export * from './sessionFiles';
-export * from './standards';
+export * from './policies';
 export * from './guards';
 export * from './gates';
 export * from './tracks';

package/lib/specs/index.js

@@ -30,7 +30,7 @@ export * from './frames.js';
 export * from './cogs.js';
 export * from './harnesses.js';
 export * from './sessionFiles.js';
-export * from './standards.js';
+export * from './policies.js';
 export * from './guards.js';
 export * from './gates.js';
 export * from './tracks.js';

package/lib/types/agentspecs.d.ts

@@ -409,6 +409,8 @@ export interface HarnessSpec {
     description: string;
     /** Whether the shared catalogue offers it: `custom` is not. */
     enabled: boolean;
+    /** Why it is not offered today, in a sentence said wherever it is named; set when `enabled` is false, and only then. */
+    unavailable_because: string;
     tags: string[];
     /** Where its ACP use is documented. */
     docs: string;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datalayer/agent-runtimes",
-    "version": "1.5.86",
+    "version": "1.5.88",
     "type": "module",
     "workspaces": [
         ".",

package/scripts/codegen/generate_apps.py

@@ -94,7 +94,7 @@ def python_of(specs_dir: Path, identity: str) -> str:
     Its own ``app.py`` when it was built in Python; otherwise the file `loop
     apps eject` writes from its spec, so every example can be read in Python.
     """
-    from agent_runtimes.loop.apps.scaffold import eject_text  # noqa: PLC0415
+    from agent_runtimes.apps.scaffold import eject_text  # noqa: PLC0415
 
     code = specs_dir / identity / "app.py"
     if code.is_file():

package/scripts/codegen/generate_harnesses.py

@@ -184,6 +184,7 @@ def generate_python_code(specs: list[dict[str, Any]]) -> str:
             f"    name={_s(spec['name'])},",
             f"    description={_s(spec.get('description'))},",
             f"    enabled={bool(spec.get('enabled', True))},",
+            f"    unavailable_because={_s(spec.get('unavailable_because'))},",
             f"    tags={json.dumps(list(spec.get('tags') or []))},",
             f"    docs={_s(spec.get('docs'))},",
         ]
@@ -316,6 +317,7 @@ def generate_typescript_code(
             f"  name: {_t(spec['name'])},",
             f"  description: {_t(spec.get('description'))},",
             f"  enabled: {json.dumps(bool(spec.get('enabled', True)))},",
+            f"  unavailable_because: {_t(spec.get('unavailable_because'))},",
             f"  tags: {json.dumps(list(spec.get('tags') or []))},",
             f"  docs: {_t(spec.get('docs'))},",
         ]

package/scripts/validate_pap_examples.py

@@ -15,7 +15,7 @@ import json
 import sys
 from pathlib import Path
 
-from agent_runtimes.loop.apps.build import build
+from agent_runtimes.apps.build import build
 
 ROOT = Path(__file__).parents[1]
 EXAMPLES = ROOT / "examples" / "personal-agent-protocol"