@datalayer/agent-runtimes 1.5.28 → 1.5.31

package/lib/specs/envvars.js

@@ -15,6 +15,16 @@ export const ALPHAVANTAGE_API_KEY_SPEC_0_0_1 = {
     icon: 'key',
     emoji: '🔑',
 };
+export const ANTHROPIC_API_KEY_SPEC_0_0_1 = {
+    id: 'ANTHROPIC_API_KEY',
+    version: '0.0.1',
+    name: 'Anthropic API Key',
+    description: "API key for Anthropic's Claude API. Required by the Claude Code harness, and by any harness configured with Anthropic as its model provider; the person's own, never a Claude.ai subscription login.",
+    registrationUrl: 'https://platform.claude.com/settings/keys',
+    tags: ['authentication', 'api-key', 'anthropic', 'harness'],
+    icon: 'key',
+    emoji: '🔑',
+};
 export const EARTHDATA_PASSWORD_SPEC_0_0_1 = {
     id: 'EARTHDATA_PASSWORD',
     version: '0.0.1',
@@ -35,6 +45,16 @@ export const EARTHDATA_USERNAME_SPEC_0_0_1 = {
     icon: 'key',
     emoji: '🔑',
 };
+export const GEMINI_API_KEY_SPEC_0_0_1 = {
+    id: 'GEMINI_API_KEY',
+    version: '0.0.1',
+    name: 'Gemini API Key',
+    description: "API key for Google's Gemini API. Required by the Gemini CLI harness in place of a Google login; the person's own.",
+    registrationUrl: 'https://aistudio.google.com/apikey',
+    tags: ['authentication', 'api-key', 'google', 'harness'],
+    icon: 'key',
+    emoji: '🔑',
+};
 export const GITHUB_TOKEN_SPEC_0_0_1 = {
     id: 'GITHUB_TOKEN',
     version: '0.0.1',
@@ -92,6 +112,26 @@ export const KAGGLE_API_TOKEN_SPEC_0_0_1 = {
     icon: 'key',
     emoji: '🔑',
 };
+export const LLM_API_KEY_SPEC_0_0_1 = {
+    id: 'LLM_API_KEY',
+    version: '0.0.1',
+    name: 'OpenHands LLM API Key',
+    description: "The model provider's key the OpenHands CLI reads, with LLM_MODEL, when started with --override-with-envs. Required by the OpenHands harness; the person's own key at their provider.",
+    registrationUrl: 'https://docs.openhands.dev/openhands/usage/cli/installation',
+    tags: ['authentication', 'api-key', 'openhands', 'harness'],
+    icon: 'key',
+    emoji: '🔑',
+};
+export const OPENAI_API_KEY_SPEC_0_0_1 = {
+    id: 'OPENAI_API_KEY',
+    version: '0.0.1',
+    name: 'OpenAI API Key',
+    description: "API key for OpenAI's API. Required by the Codex harness, which takes it in place of a ChatGPT login; the person's own.",
+    registrationUrl: 'https://platform.openai.com/api-keys',
+    tags: ['authentication', 'api-key', 'openai', 'harness'],
+    icon: 'key',
+    emoji: '🔑',
+};
 export const SLACK_BOT_TOKEN_SPEC_0_0_1 = {
     id: 'SLACK_BOT_TOKEN',
     version: '0.0.1',
@@ -136,13 +176,17 @@ export const TAVILY_API_KEY_SPEC_0_0_1 = {
 // ============================================================================
 export const ENVVAR_CATALOG = {
     ALPHAVANTAGE_API_KEY: ALPHAVANTAGE_API_KEY_SPEC_0_0_1,
+    ANTHROPIC_API_KEY: ANTHROPIC_API_KEY_SPEC_0_0_1,
     EARTHDATA_PASSWORD: EARTHDATA_PASSWORD_SPEC_0_0_1,
     EARTHDATA_USERNAME: EARTHDATA_USERNAME_SPEC_0_0_1,
+    GEMINI_API_KEY: GEMINI_API_KEY_SPEC_0_0_1,
     GITHUB_TOKEN: GITHUB_TOKEN_SPEC_0_0_1,
     GOOGLE_OAUTH_CLIENT_ID: GOOGLE_OAUTH_CLIENT_ID_SPEC_0_0_1,
     GOOGLE_OAUTH_CLIENT_SECRET: GOOGLE_OAUTH_CLIENT_SECRET_SPEC_0_0_1,
     HF_TOKEN: HF_TOKEN_SPEC_0_0_1,
     KAGGLE_API_TOKEN: KAGGLE_API_TOKEN_SPEC_0_0_1,
+    LLM_API_KEY: LLM_API_KEY_SPEC_0_0_1,
+    OPENAI_API_KEY: OPENAI_API_KEY_SPEC_0_0_1,
     SLACK_BOT_TOKEN: SLACK_BOT_TOKEN_SPEC_0_0_1,
     SLACK_CHANNEL_IDS: SLACK_CHANNEL_IDS_SPEC_0_0_1,
     SLACK_TEAM_ID: SLACK_TEAM_ID_SPEC_0_0_1,

package/lib/specs/harnesses.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Harness Catalog.
+ *
+ * An agent program driven over the Agent Client Protocol (SHIELD.md SH-01).
+ *
+ * This file is AUTO-GENERATED from YAML specifications.
+ * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
+ */
+import type { HarnessSpec } from '../types/agentspecs';
+export declare const CLAUDE_CODE_HARNESS_0_0_1: HarnessSpec;
+export declare const CODEX_HARNESS_0_0_1: HarnessSpec;
+export declare const CUSTOM_HARNESS_0_0_1: HarnessSpec;
+export declare const FAST_AGENT_HARNESS_0_0_1: HarnessSpec;
+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 HARNESS_CATALOGUE: Record<string, HarnessSpec>;
+/** A harness by id. */
+export declare function getHarness(harnessId: string): HarnessSpec | undefined;
+/** Every harness of the catalogue. */
+export declare function listHarnesses(): HarnessSpec[];

package/lib/specs/harnesses.js

@@ -0,0 +1,372 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+export const CLAUDE_CODE_HARNESS_0_0_1 = {
+    id: 'claude-code',
+    version: '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,
+    tags: ['harness'],
+    docs: 'https://github.com/agentclientprotocol/claude-agent-acp',
+    acp: {
+        command: 'npx',
+        args: ['-y', '@agentclientprotocol/claude-agent-acp@0.91.0'],
+        protocolVersion: 1,
+        loadSession: true,
+        mcp: 'lend',
+        modes: ['default', 'plan', 'acceptEdits', 'bypassPermissions'],
+        env: {},
+    },
+    requires: {
+        secrets: ['ANTHROPIC_API_KEY'],
+        binaries: ['node', 'git'],
+    },
+    terms: {
+        servedToThirdParties: 'api_key_only',
+        licence: 'Apache-2.0 (adapter); Anthropic Commercial Terms of Service (the agent)',
+    },
+    skills: {
+        format: 'skill-md',
+        dir: '.claude/skills',
+    },
+    honours: {
+        model: true,
+        subagents: false,
+    },
+    instructionsFile: 'CLAUDE.md',
+    registered: {
+        adapter: '@agentclientprotocol/claude-agent-acp',
+        version: '0.91.0',
+        licenceSource: 'https://www.npmjs.com/package/@agentclientprotocol/claude-agent-acp',
+        termsSource: 'https://code.claude.com/docs/en/legal-and-compliance',
+        credential: "An Anthropic API key (ANTHROPIC_API_KEY), the person's own",
+        binaries: 'Node 22 (engines.node >=22 on npm), git',
+        note: "Anthropic's legal page (read 2026-10-15): running Claude Code in hosted sandboxes or agent infrastructure requires the Commercial Terms; each end user authenticates with their own API key or subscription; developers may not route requests through Free, Pro or Max plan credentials on behalf of their users, nor collect or intermediate Claude.ai credentials. So only API keys are taken; a subscription login is refused. The npm package moved from @zed-industries (0.23.1, March 2026) to @agentclientprotocol.",
+    },
+};
+export const CODEX_HARNESS_0_0_1 = {
+    id: 'codex',
+    version: '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,
+    tags: ['harness'],
+    docs: 'https://github.com/agentclientprotocol/codex-acp',
+    acp: {
+        command: 'npx',
+        args: ['-y', '@agentclientprotocol/codex-acp@2.2.2'],
+        protocolVersion: 1,
+        loadSession: true,
+        mcp: 'lend',
+        modes: ['read-only', 'workspace-write', 'agent', 'agent-full-access'],
+        env: { NO_BROWSER: '1' },
+    },
+    requires: {
+        secrets: ['OPENAI_API_KEY'],
+        binaries: ['node', 'git'],
+    },
+    terms: {
+        servedToThirdParties: 'api_key_only',
+        licence: 'Apache-2.0 (adapter); OpenAI Terms of Use (the agent)',
+    },
+    skills: {
+        format: 'skill-md',
+        dir: '.agents/skills',
+    },
+    honours: {
+        model: true,
+        subagents: false,
+    },
+    instructionsFile: 'AGENTS.md',
+    registered: {
+        adapter: '@agentclientprotocol/codex-acp',
+        version: '2.2.2',
+        licenceSource: 'https://www.npmjs.com/package/@agentclientprotocol/codex-acp',
+        termsSource: 'https://learn.chatgpt.com/docs/auth',
+        credential: "An OpenAI API key (OPENAI_API_KEY or CODEX_API_KEY), the person's own",
+        binaries: "Node 22 (as the Agent Client Protocol project's adapters; unstated on npm), git",
+        note: "Codex's authentication page (read 2026-10-15) recommends API keys for automation and device-code login for headless machines; a ChatGPT login needs a browser and is hidden with NO_BROWSER=1 in the adapter. Only API keys are taken; a ChatGPT login is refused. The Zed-scoped package was archived on 22 July 2026 and names this one.",
+    },
+};
+export const CUSTOM_HARNESS_0_0_1 = {
+    id: 'custom',
+    version: '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,
+    tags: ['harness'],
+    docs: '',
+    requires: {
+        secrets: [],
+        binaries: [],
+    },
+    terms: {
+        servedToThirdParties: 'organizations_own',
+        licence: "The organization's own",
+    },
+    skills: {
+        format: 'none',
+        dir: '',
+    },
+    honours: {
+        model: false,
+        subagents: false,
+    },
+    instructionsFile: '',
+    registered: {
+        adapter: "The organization's own",
+        version: '0',
+        licenceSource: 'https://agentspecs.datalayer.tech/harnesses',
+        termsSource: 'https://agentspecs.datalayer.tech/harnesses',
+        credential: "The organization's own",
+        binaries: '',
+        note: "Not launchable from the shared catalogue; an organization's own harness spec names the command and answers for its terms.",
+    },
+};
+export const FAST_AGENT_HARNESS_0_0_1 = {
+    id: 'fast-agent',
+    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,
+    tags: ['harness', 'framework'],
+    docs: 'https://github.com/evalstate/fast-agent/blob/main/docs/docs/acp/index.md',
+    acp: {
+        command: 'uvx',
+        args: ['fast-agent-acp==0.10.45'],
+        protocolVersion: 1,
+        loadSession: true,
+        mcp: 'lend',
+        modes: [],
+        env: {},
+    },
+    requires: {
+        secrets: ['ANTHROPIC_API_KEY'],
+        binaries: ['uvx'],
+    },
+    terms: {
+        servedToThirdParties: 'permitted',
+        licence: 'Apache-2.0',
+    },
+    skills: {
+        format: 'skill-md',
+        dir: '.agents/skills',
+    },
+    honours: {
+        model: true,
+        subagents: false,
+    },
+    instructionsFile: 'AGENTS.md',
+    registered: {
+        adapter: 'fast-agent-acp',
+        version: '0.10.45',
+        licenceSource: 'https://pypi.org/project/fast-agent-acp/',
+        termsSource: 'https://github.com/evalstate/fast-agent/blob/main/LICENSE',
+        credential: "The provider's key fast-agent is given (ANTHROPIC_API_KEY, OPENAI_API_KEY or HF_TOKEN); ANTHROPIC_API_KEY declared",
+        binaries: 'uv (uvx), Python 3.12 to 3.15 (requires_python on PyPI)',
+        note: "A framework, not a coding agent (SHIELD §2.5): each agent it defines is an ACP mode; the client's MCP servers are attached; sessions are listed. Launched with uvx fast-agent-acp (docs/docs/acp/index.md); reads skills from .fast-agent/skills, .agents/skills and .claude/skills; its default prompt reads AGENTS.md.",
+    },
+};
+export const GEMINI_CLI_HARNESS_0_0_1 = {
+    id: 'gemini-cli',
+    version: '0.0.1',
+    name: 'Gemini CLI',
+    description: "Google's coding agent, which speaks ACP itself when started with --experimental-acp.",
+    enabled: true,
+    tags: ['harness'],
+    docs: 'https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/cli-reference.md',
+    acp: {
+        command: 'npx',
+        args: ['-y', '@google/gemini-cli@0.64.0', '--experimental-acp'],
+        protocolVersion: 1,
+        loadSession: false,
+        mcp: 'lend',
+        modes: ['default', 'auto_edit', 'yolo', 'plan'],
+        env: {},
+    },
+    requires: {
+        secrets: ['GEMINI_API_KEY'],
+        binaries: ['node', 'git'],
+    },
+    terms: {
+        servedToThirdParties: 'api_key_only',
+        licence: 'Apache-2.0 (the agent); Gemini API or Gemini Code Assist terms (the model)',
+        tierRestrictions: 'Gemini Code Assist Standard or Enterprise for a Google login (the individuals tier stopped being served on 18 June 2026); a Gemini API key otherwise',
+    },
+    skills: {
+        format: 'skill-md',
+        dir: '.gemini/skills',
+    },
+    honours: {
+        model: true,
+        subagents: false,
+    },
+    instructionsFile: 'GEMINI.md',
+    registered: {
+        adapter: '@google/gemini-cli',
+        version: '0.64.0',
+        licenceSource: 'https://www.npmjs.com/package/@google/gemini-cli',
+        termsSource: 'https://developers.google.com/gemini-code-assist/resources/privacy-notice-gemini-code-assist-individuals',
+        credential: "A Gemini API key (GEMINI_API_KEY), the person's own; or a Google login on a Code Assist Standard or Enterprise subscription",
+        binaries: 'Node 20 or later (engines.node >=20 on npm), git',
+        note: 'Google\'s notice (read 2026-10-15): "Starting June 18, 2026, Gemini Code Assist IDE extensions stopped serving requests for the Gemini Code Assist for individuals"; Standard and Enterprise follow a separate schedule. The ACP flag is --experimental-acp in the CLI reference (docs/cli/cli-reference.md).',
+    },
+};
+export const GOOSE_HARNESS_0_0_1 = {
+    id: 'goose',
+    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,
+    tags: ['harness'],
+    docs: 'https://block.github.io/goose/docs/gdk/acp/',
+    acp: {
+        command: 'goose',
+        args: ['acp'],
+        protocolVersion: 1,
+        loadSession: false,
+        mcp: 'lend',
+        modes: [],
+        env: { GOOSE_PROVIDER: 'anthropic' },
+    },
+    requires: {
+        secrets: ['ANTHROPIC_API_KEY'],
+        binaries: ['goose@1.54.0', 'git'],
+    },
+    terms: {
+        servedToThirdParties: 'permitted',
+        licence: 'Apache-2.0',
+    },
+    skills: {
+        format: 'skill-md',
+        dir: '.agents/skills',
+    },
+    honours: {
+        model: true,
+        subagents: false,
+    },
+    instructionsFile: '.goosehints',
+    registered: {
+        adapter: 'goose',
+        version: '1.54.0',
+        licenceSource: 'https://github.com/aaif-goose/goose',
+        termsSource: 'https://github.com/aaif-goose/goose/blob/main/LICENSE',
+        credential: "The provider's key goose is configured with (GOOSE_PROVIDER); ANTHROPIC_API_KEY declared",
+        binaries: 'The goose CLI (release v1.54.0 of 8 October 2026), git',
+        note: "Open source under Apache-2.0, no vendor terms of its own; the model provider's terms apply to the key. Launched as goose acp (documentation/docs/gdk/acp/index.md).",
+    },
+};
+export const OPENCODE_HARNESS_0_0_1 = {
+    id: 'opencode',
+    version: '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,
+    tags: ['harness'],
+    docs: 'https://opencode.ai/docs/acp/',
+    acp: {
+        command: 'npx',
+        args: ['-y', 'opencode-ai@1.19.0', 'acp'],
+        protocolVersion: 1,
+        loadSession: false,
+        mcp: 'lend',
+        modes: [],
+        env: {},
+    },
+    requires: {
+        secrets: ['ANTHROPIC_API_KEY'],
+        binaries: ['node', 'git'],
+    },
+    terms: {
+        servedToThirdParties: 'permitted',
+        licence: 'MIT',
+    },
+    skills: {
+        format: 'skill-md',
+        dir: '.opencode/skills',
+    },
+    honours: {
+        model: true,
+        subagents: false,
+    },
+    instructionsFile: 'AGENTS.md',
+    registered: {
+        adapter: 'opencode-ai',
+        version: '1.19.0',
+        licenceSource: 'https://www.npmjs.com/package/opencode-ai',
+        termsSource: 'https://github.com/anomalyco/opencode/blob/dev/LICENSE',
+        credential: "The provider's key OpenCode is configured with; ANTHROPIC_API_KEY declared",
+        binaries: 'Node (the opencode-ai package), git',
+        note: "Open source under MIT, no vendor terms of its own; the model provider's terms apply to the key. Launched as opencode acp (opencode.ai/docs/acp); reads skills from .opencode/skills, .claude/skills and .agents/skills.",
+    },
+};
+export const OPENHANDS_HARNESS_0_0_1 = {
+    id: 'openhands',
+    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,
+    tags: ['harness'],
+    docs: 'https://docs.openhands.dev/openhands/usage/run-openhands/acp',
+    acp: {
+        command: 'uvx',
+        args: [
+            '--from',
+            'openhands==1.16.0',
+            'openhands',
+            'acp',
+            '--override-with-envs',
+        ],
+        protocolVersion: 1,
+        loadSession: true,
+        mcp: 'lend',
+        modes: ['always-ask', 'always-approve', 'llm-approve'],
+        env: {},
+    },
+    requires: {
+        secrets: ['LLM_API_KEY'],
+        binaries: ['uvx', 'git'],
+    },
+    terms: {
+        servedToThirdParties: 'permitted',
+        licence: 'MIT',
+    },
+    skills: {
+        format: 'skill-md',
+        dir: '.agents/skills',
+    },
+    honours: {
+        model: true,
+        subagents: false,
+    },
+    instructionsFile: 'AGENTS.md',
+    registered: {
+        adapter: 'openhands',
+        version: '1.16.0',
+        licenceSource: 'https://pypi.org/project/openhands/',
+        termsSource: 'https://github.com/OpenHands/OpenHands-CLI/blob/main/LICENSE',
+        credential: "The provider's key OpenHands reads as LLM_API_KEY, with LLM_MODEL, under --override-with-envs",
+        binaries: 'uv (uvx), Python 3.12 or later, git',
+        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 HARNESS_CATALOGUE = {
+    'claude-code': CLAUDE_CODE_HARNESS_0_0_1,
+    codex: CODEX_HARNESS_0_0_1,
+    custom: CUSTOM_HARNESS_0_0_1,
+    'fast-agent': FAST_AGENT_HARNESS_0_0_1,
+    'gemini-cli': GEMINI_CLI_HARNESS_0_0_1,
+    goose: GOOSE_HARNESS_0_0_1,
+    opencode: OPENCODE_HARNESS_0_0_1,
+    openhands: OPENHANDS_HARNESS_0_0_1,
+};
+/** A harness by id. */
+export function getHarness(harnessId) {
+    return HARNESS_CATALOGUE[harnessId];
+}
+/** Every harness of the catalogue. */
+export function listHarnesses() {
+    return Object.values(HARNESS_CATALOGUE);
+}

package/lib/specs/index.d.ts

@@ -24,6 +24,7 @@ export * from './uiRenderers';
 export * from './protocols';
 export * from './frames';
 export * from './cogs';
+export * from './harnesses';
 export * from './guards';
 export * from './gates';
 export * from './tracks';

package/lib/specs/index.js

@@ -28,6 +28,7 @@ export * from './uiRenderers';
 export * from './protocols';
 export * from './frames';
 export * from './cogs';
+export * from './harnesses';
 export * from './guards';
 export * from './gates';
 export * from './tracks';

package/lib/specs/voices.js

@@ -375,6 +375,48 @@ export const SPEECH_MODEL_CATALOGUE = {
             },
         ],
     },
+    'whisper-small': {
+        id: 'whisper-small',
+        version: '0.0.1',
+        name: 'Whisper Small',
+        description: "Speech to text on Datalayer's servers for short spoken turns, on CPU: OpenAI's Whisper small (244M parameters, 99 languages), converted to CTranslate2 and run by faster-whisper, its weights quantized to 8 bits when loaded. About four times faster than large-v3-turbo; on the fixtures it hears English as well (3.3% against 2.4%) and French less well (16.1% against 2.6%). Recordings longer than a turn go to large-v3-turbo.",
+        provider: 'openai',
+        task: 'stt',
+        engine: 'faster-whisper',
+        dtype: 'float16',
+        languages: ['en', 'fr', 'es', 'it', 'pt', 'de', 'nl', 'ja', 'zh', 'hi'],
+        where: ['server'],
+        streaming: false,
+        licence: {
+            weights: 'MIT',
+            code: 'MIT',
+        },
+        attribution: '',
+        upstream: 'https://huggingface.co/openai/whisper-small',
+        revision: '536b0662742c02347bc0e980a01041f333bce120',
+        files: [
+            {
+                path: 'config.json',
+                sha256: 'b55496ac7940a7ae47d2c01eab40edfd8701feec1229d9cce3b40014383fb828',
+                size: 2370,
+            },
+            {
+                path: 'tokenizer.json',
+                sha256: 'fb7b63191e9bb045082c79fd742a3106a12c99513ab30df4a0d47fa6cb6fd0ab',
+                size: 2203239,
+            },
+            {
+                path: 'vocabulary.txt',
+                sha256: '34ce3fe1c5041027b3f8d42912270993f986dbc4bb34cf27f951e34a1e453913',
+                size: 459861,
+            },
+            {
+                path: 'model.bin',
+                sha256: '3e305921506d8872816023e4c273e75d2419fb89b24da97b4fe7bce14170d671',
+                size: 483546902,
+            },
+        ],
+    },
 };
 /** Whether a voice speaks a language: `fr` and `fr-FR` are spoken by a `fr-FR` voice. */
 export function voiceSpeaks(voice, language) {

package/lib/types/agentspecs.d.ts

@@ -204,6 +204,75 @@ export interface ProtocolSpec {
     /** The Appspec block it configures, if any: refused unless `protocols` lists it. */
     appspecBlock?: 'pap' | 'pact' | 'a2a' | 'signed_fetch';
 }
+/** How a harness is launched and driven over ACP (SHIELD.md §3.1). */
+export interface HarnessAcpSpec {
+    /** The executable, as the runtime image has it. */
+    command: string;
+    /** Its arguments, the adapter's version pinned among them. */
+    args: string[];
+    protocolVersion: number;
+    /** Whether it answers `session/load`. */
+    loadSession: boolean;
+    /** `lend`: the Shield lends MCP servers through the gateway; `own`; or `none`. */
+    mcp: 'lend' | 'own' | 'none';
+    /** The session modes it advertises, as it names them. */
+    modes: string[];
+    /** Plain variables the launch needs, never a secret. */
+    env: Record<string, string>;
+}
+/**
+ * An agent program driven over the Agent Client Protocol
+ * (`agentspecs/harnesses`, SHIELD.md SH-01). An agent spec's `harness:` names
+ * one beside `pydantic-ai` and `vercel-ai`; the Datalayer runtime serves it
+ * through its ACP adapter, `ACPAgent` (SHIELD SH-10), never the browser.
+ */
+export interface HarnessSpec {
+    /** What `harness:` names (e.g. 'claude-code'). */
+    id: string;
+    version: string;
+    name: string;
+    description: string;
+    /** Whether the shared catalogue offers it: `custom` is not. */
+    enabled: boolean;
+    tags: string[];
+    /** Where its ACP use is documented. */
+    docs: string;
+    /** Absent only on `custom`, whose command an organization's own spec names. */
+    acp?: HarnessAcpSpec;
+    /** What it needs in the pod: secrets as ids of the env-vars catalogue, executables. */
+    requires: {
+        secrets: string[];
+        binaries: string[];
+    };
+    /** The terms it is served under, as the register says them (§3.3). */
+    terms: {
+        servedToThirdParties: 'api_key_only' | 'permitted' | 'refused' | 'organizations_own';
+        licence: string;
+        tierRestrictions?: string;
+    };
+    /** Where the Shield writes an application's skills for it (§4.10). */
+    skills: {
+        format: 'skill-md' | 'none';
+        dir: string;
+    };
+    /** What of an agent spec it can honour; the rest is refused at load. */
+    honours: {
+        model: boolean;
+        subagents: boolean;
+    };
+    /** The workspace file it reads its instructions from. */
+    instructionsFile: string;
+    /** The register's line: what was checked, and where. */
+    registered: {
+        adapter: string;
+        version: string;
+        licenceSource: string;
+        termsSource: string;
+        credential: string;
+        binaries: string;
+        note: string;
+    };
+}
 /** A check a Frame requires of the output of work done under it. */
 export interface FrameGuardSpec {
     id: string;
@@ -958,7 +1027,7 @@ export interface AppPageSpec {
 export interface AppVoiceSpec {
     enabled: boolean;
     /** `hands_free` (VO-12) is refused until it is built. */
-    input: 'off' | 'push_to_talk';
+    input: 'off' | 'push_to_talk' | 'hands_free';
     output: 'off' | 'on_request' | 'always';
     voice: string;
     language: string;

package/lib/voice/ComposerVoice.d.ts

@@ -7,7 +7,9 @@
  * person to edit and send — or sent at once with *Send what I say*. While
  * the words are still being heard the host is told (`onInterimChange`), to
  * grey them until they are final (VO-11). Beside the microphone, the
- * person's voice menu (`VoiceMenu`, VO-30).
+ * person's voice menu (`VoiceMenu`, VO-30). Where the application's voice
+ * says `hands_free`, *Talk with it* too (`HandsFree`, VO-12, VO-13): a turn
+ * is sent by itself and the agent's answer may be spoken over.
  *
  * @module voice/ComposerVoice
  */
@@ -29,6 +31,12 @@ export interface ComposerVoiceProps {
     speaking?: boolean;
     /** Stops the agent's voice, also when the microphone opens (VO-13). */
     onStopSpeaking?: () => void;
+    /** The agent is answering: a run is in progress (hands-free, VO-12). */
+    running?: boolean;
+    /** Stops the run while the answer is still being written (barge-in, VO-13). */
+    onStopRun?: () => void;
+    /** The answer being written was spoken over: marked in the conversation (VO-13). */
+    onInterrupted?: () => void;
     /**
      * The words in the box are still being heard (`true`), or final
      * (`false`): the host greys them until they are (VO-11).
@@ -42,5 +50,5 @@ export interface ComposerVoiceProps {
 }
 /** Whether something rides on a run as a spoken message's metadata (VO-27). */
 export declare function spokenOf(value: unknown): SpokenMetadata | undefined;
-export declare function ComposerVoice({ voice, input, setInput, onSpoken, send, disabled, speaking, onStopSpeaking, onInterimChange, answers, }: ComposerVoiceProps): JSX.Element | null;
+export declare function ComposerVoice({ voice, input, setInput, onSpoken, send, disabled, speaking, onStopSpeaking, running, onStopRun, onInterrupted, onInterimChange, answers, }: ComposerVoiceProps): JSX.Element | null;
 export default ComposerVoice;