@datalayer/agent-runtimes 1.5.53 → 1.5.55

package/lib/apps/core/index.d.ts

@@ -144,6 +144,17 @@ export type LoopWorkspaceContext = {
     setAgentId: (agentId: string) => void;
     /** Conversation being continued, when there is one. */
     conversationId?: string;
+    /**
+     * The thread the chat last sent on, once it has sent: an application's
+     * thread is its session on the runtime, so what reads a running session —
+     * the Rules card's *This session* (SH-54) — reads it here. Without it a
+     * workspace whose host named no conversation never knew its session, and
+     * the card said *Start a conversation* after one had started (16 October
+     * 2026).
+     */
+    thread?: string;
+    /** For the chat to say which thread it sends on. */
+    setThread?: (thread: string) => void;
     /**
      * The id the notebook and the document on screen are addressed by.
      *

package/lib/apps/plugins/app-rules/AppRulesCard.d.ts

@@ -61,6 +61,12 @@ export declare function SessionRules({ agentServerUrl, sessionUid, token, }: {
     sessionUid: string;
     token: string;
 }): JSX.Element;
+/**
+ * The running session the card tightens: the conversation the host
+ * continued, else the thread the chat sent on — an application's thread is
+ * its session on the runtime. None before a message is sent.
+ */
+export declare function sessionUidOf(workspace?: Pick<LoopWorkspaceContext, 'conversationId' | 'thread'>): string | undefined;
 export declare function AppRulesCard({ app, workspace, }: {
     app: AppSpec;
     /** The workspace the card sits in, when the slot gives it: names the session running. */

package/lib/apps/plugins/app-rules/AppRulesCard.js

@@ -107,13 +107,21 @@ export function SessionRules({ agentServerUrl, sessionUid, token, }) {
     };
     return (_jsxs(Box, { "data-testid": "session-rules", mt: 3, children: [_jsx(Heading, { as: "h4", sx: { fontSize: 1, mb: 1 }, children: SESSION_RULES_WORDS.title }), inForce?.unavailable ? (_jsx(Text, { as: "p", role: "alert", sx: { fontSize: 0, m: 0, mb: 1 }, children: SESSION_RULES_WORDS.unavailable(inForce.unavailable) })) : null, inForce && inForce.session_rules.length === 0 ? (_jsx(Text, { as: "p", sx: { fontSize: 1, color: 'fg.muted', m: 0 }, children: SESSION_RULES_WORDS.none })) : (_jsx(Box, { as: "ul", listStyle: "none", p: 0, m: 0, children: (inForce?.session_rules ?? []).map(rule => (_jsxs(Box, { as: "li", py: 1, fontSize: 1, display: "flex", gap: 2, alignItems: "center", children: [_jsx(Text, { sx: { fontWeight: 'semibold' }, children: rule.name }), _jsx(Text, { sx: { color: 'fg.muted', fontSize: 0 }, children: sessionRuleInWords(rule) }), _jsx(Button, { size: "small", variant: "invisible", disabled: busy, onClick: () => void act(() => removeSessionRule(agentServerUrl, token, sessionUid, rule.name)), children: SESSION_RULES_WORDS.remove })] }, rule.name))) })), _jsxs(Box, { display: "flex", gap: 1, mt: 1, flexWrap: "wrap", alignItems: "center", children: [_jsx(TextInput, { size: "small", value: name, placeholder: SESSION_RULES_WORDS.namePlaceholder, "aria-label": "The rule's name", onChange: event => setName(event.target.value) }), _jsx(Select, { size: "small", value: kind, "aria-label": "What it covers", onChange: event => setKind(event.target.value), children: SESSION_RULE_CLASSES.map(item => (_jsx(Select.Option, { value: item, children: SESSION_RULES_WORDS.classes[item] }, item))) }), _jsx(Select, { size: "small", value: decision, "aria-label": "What it says", onChange: event => setDecision(event.target.value), children: SESSION_RULE_DECISIONS.map(item => (_jsx(Select.Option, { value: item, children: SESSION_RULES_WORDS.decisions[item] }, item))) }), _jsx(Button, { size: "small", disabled: busy, onClick: add, children: SESSION_RULES_WORDS.add })] }), _jsx(Box, { display: "flex", gap: 1, mt: 1, flexWrap: "wrap", "data-testid": "session-rules-file-and-shell", children: FILE_AND_SHELL_RULES.map(rule => (_jsx(Button, { size: "small", variant: "invisible", disabled: busy, title: sessionRuleInWords(rule), onClick: () => void act(() => addSessionRule(agentServerUrl, token, sessionUid, rule)), children: rule.name }, rule.name))) }), problem ? (_jsx(Text, { as: "p", role: "alert", sx: { fontSize: 0, m: 0, mt: 1 }, children: problem })) : null, _jsx(Text, { as: "p", sx: { fontSize: 0, color: 'fg.muted', mt: 1, mb: 0 }, children: SESSION_RULES_WORDS.goneWithSession })] }));
 }
+/**
+ * The running session the card tightens: the conversation the host
+ * continued, else the thread the chat sent on — an application's thread is
+ * its session on the runtime. None before a message is sent.
+ */
+export function sessionUidOf(workspace) {
+    return workspace?.conversationId || workspace?.thread || undefined;
+}
 export function AppRulesCard({ app, workspace, }) {
     const token = useIAMStore(state => state.token) ?? '';
     const signedIn = Boolean(token);
     const agentServerUrl = workspace
         ? agentServerOf(workspace.sandbox, workspace.serverUrl)
         : undefined;
-    const sessionUid = workspace?.conversationId;
+    const sessionUid = sessionUidOf(workspace);
     return (_jsxs(Box, { "data-testid": "app-rules", mb: 4, children: [_jsx(Heading, { as: "h3", sx: { fontSize: 2, mb: 2 }, children: APP_RULES_WORDS.title }), app.rules.length === 0 ? (_jsx(Text, { as: "p", sx: { fontSize: 1, color: 'fg.muted', m: 0 }, children: APP_RULES_WORDS.none })) : (_jsx(Box, { as: "ul", listStyle: "none", p: 0, m: 0, children: app.rules.map(ruleInWords).map((rule, index) => (_jsxs(Box, { as: "li", py: 1, fontSize: 1, children: [_jsx(Text, { children: rule.action }), ' ', _jsx(Label, { title: rule.means, children: rule.says }), _jsx(Text, { as: "p", sx: { m: 0, color: 'fg.muted', fontSize: 0 }, children: rule.covers })] }, index))) })), _jsx(Text, { as: "p", sx: { fontSize: 0, color: 'fg.muted', mt: 1, mb: 0 }, children: APP_RULES_WORDS.byDefault }), signedIn ? (_jsx(Approvals, { app: app })) : (_jsx(Text, { as: "p", sx: { fontSize: 1, color: 'fg.muted', mt: 3, mb: 0 }, children: APP_RULES_WORDS.signedOut })), signedIn && agentServerUrl ? (sessionUid ? (_jsx(SessionRules, { agentServerUrl: agentServerUrl, sessionUid: sessionUid, token: token })) : (_jsx(Text, { as: "p", sx: { fontSize: 0, color: 'fg.muted', mt: 3, mb: 0 }, children: SESSION_RULES_WORDS.noSession }))) : null] }));
 }
 export default AppRulesCard;

package/lib/apps/plugins/chat/ChatView.js

@@ -80,6 +80,20 @@ export default function ChatView({ workspace }) {
     const palette = useColorPalette();
     const controlsRef = useRef(null);
     const { setViewControls } = workspace;
+    /*
+     * Say the thread a message goes on to the workspace: an application's
+     * thread is its session on the runtime, which the Rules card's *This
+     * session* reads (SH-54). Through a ref, as the senders below are built once.
+     */
+    const setThreadRef = useRef(workspace.setThread);
+    setThreadRef.current = workspace.setThread;
+    const sayThread = useCallback(() => {
+        const thread = controlsRef.current?.thread();
+        if (thread) {
+            setThreadRef.current?.(thread);
+        }
+        return thread;
+    }, []);
     const [transient, setTransient] = useState(null);
     // Read from the reactor rather than taken as a prop: the placeholder and the
     // default editor are the chat plugin's own configuration, so a host sets them
@@ -440,14 +454,14 @@ export default function ChatView({ workspace }) {
             return;
         }
         // A new turn: whatever the panel showed is gone, this message is it.
-        turnFeedRef.current?.begin(message, controlsRef.current?.thread());
+        turnFeedRef.current?.begin(message, sayThread());
         const send = controlsRef.current?.send;
         if (!send) {
             heldForAdapter.current.push([message, forwardedProps]);
             return;
         }
         send(message, forwardedProps);
-    }, []);
+    }, [sayThread]);
     // One writer, so neither fact can erase the other.
     useEffect(() => {
         setViewControls(sendReady
@@ -481,9 +495,10 @@ export default function ChatView({ workspace }) {
         }
         const held = heldForAdapter.current.splice(0, heldForAdapter.current.length);
         for (const [message, forwardedProps] of held) {
+            sayThread();
             controlsRef.current?.send(message, forwardedProps);
         }
-    }, [sendReady]);
+    }, [sendReady, sayThread]);
     /*
      * Fired once, on the first real send, for the life of this mounted chat —
      * a ref rather than a signal, because nothing here needs to re-render when

package/lib/apps/shell/LoopWorkspace.js

@@ -45,6 +45,11 @@ function WorkspaceBody({ serverUrl, agentId: initialAgentId, conversationId, mod
     useEffect(() => {
         setAgentId(initialAgentId);
     }, [initialAgentId]);
+    // The thread the chat sends on, said by the chat (its session, SH-54).
+    const [thread, setThreadState] = useState(undefined);
+    const setThread = useCallback((next) => {
+        setThreadState(current => (current === next ? current : next));
+    }, []);
     const [activeViewType, setActiveViewType] = useState(initialViewType ?? '');
     // Seeded by the host (a handoff carries what the terminal knew), then kept
     // current by whichever plugin owns the sandbox.
@@ -109,6 +114,8 @@ function WorkspaceBody({ serverUrl, agentId: initialAgentId, conversationId, mod
         surfaceId: surfaceIdRef.current,
         setAgentId,
         conversationId,
+        thread,
+        setThread,
         model,
         sandbox,
         setSandbox,
@@ -124,6 +131,7 @@ function WorkspaceBody({ serverUrl, agentId: initialAgentId, conversationId, mod
         serverUrl,
         agentId,
         conversationId,
+        thread,
         model,
         sandbox,
         activeViewType,

package/lib/portable/hosts/contracts.json

@@ -125,6 +125,35 @@
       "expires_in"
     ]
   },
+  "bind_session": {
+    "about": "The host maps a session it opened to a place of its own, with the host token it opened it with and its host key: binding it again replaces the target. The target is opaque to ai-agents (a JSON object of at most target_limit characters) and is handed back with every delivery of that session.",
+    "request": {
+      "target": {
+        "appId": "A0",
+        "channelId": "C0",
+        "teamId": "T0",
+        "threadTs": "1700000000.000001",
+        "userId": "U0ALICE"
+      }
+    },
+    "session_uid_pattern": "^[A-Za-z0-9_-]{8,128}$",
+    "target_limit": 2048,
+    "response_keys": [
+      "success",
+      "binding"
+    ],
+    "binding_keys": [
+      "uid",
+      "host_uid",
+      "session_uid",
+      "deployment_uid",
+      "agent_id",
+      "link_uid",
+      "principal_uid",
+      "target",
+      "state"
+    ]
+  },
   "external_turn": {
     "start_request": {
       "agent": "agent-desk",
@@ -142,6 +171,7 @@
       "type": "CUSTOM",
       "name": "loop.turn",
       "value_keys": [
+        "session",
         "turn",
         "external_event_id",
         "replayed",

package/lib/specs/agents/agents.d.ts

@@ -42,6 +42,12 @@ export declare const EXAMPLE_GPT_AND_CLAUDE_COLLABORATE_AGENTSPEC_0_0_1: Agentsp
 export declare const EXAMPLE_GUARDRAILS_AGENTSPEC_0_0_1: Agentspec;
 export declare const EXAMPLE_HAIKU_GENERATIVE_UI_AGENTSPEC_0_0_1: Agentspec;
 export declare const EXAMPLE_HARNESS_CLAUDE_CODE_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_HARNESS_CODEX_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_HARNESS_FAST_AGENT_SPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_HARNESS_GEMINI_CLI_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_HARNESS_GOOSE_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_HARNESS_OPENCODE_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_HARNESS_OPENHANDS_AGENTSPEC_0_0_1: Agentspec;
 export declare const EXAMPLE_HOOKS_AGENTSPEC_0_0_1: Agentspec;
 export declare const EXAMPLE_HUMAN_APPROVED_AUTOMATION_AGENTSPEC_0_0_1: Agentspec;
 export declare const EXAMPLE_HUMAN_IN_THE_LOOP_AGENTSPEC_0_0_1: Agentspec;

package/lib/specs/agents/agents.js

@@ -2630,6 +2630,294 @@ export const EXAMPLE_HARNESS_CLAUDE_CODE_AGENTSPEC_0_0_1 = {
     parameters: undefined,
     subagents: undefined,
 };
+export const EXAMPLE_HARNESS_CODEX_AGENTSPEC_0_0_1 = {
+    id: 'example-harness-codex',
+    version: '0.0.1',
+    name: 'A Codex Agent',
+    description: `OpenAI's Codex as a Datalayer agent: launched in the runtime over the Agent Client Protocol, its files, terminals and permissions decided by the Shield under the application's Rules, every action in the record. Needs the account's OPENAI_API_KEY.`,
+    tags: ['coding', 'harness', 'acp'],
+    domain: undefined,
+    enabled: false,
+    model: undefined,
+    mcpServers: [],
+    skills: [].filter(Boolean),
+    backendTools: [],
+    frontendTools: [],
+    environmentName: 'ai-agents-env',
+    icon: undefined,
+    emoji: undefined,
+    color: undefined,
+    suggestions: [],
+    welcomeMessage: undefined,
+    welcomeNotebook: undefined,
+    welcomeDocument: undefined,
+    sandboxVariant: 'jupyter-server',
+    harness: 'codex',
+    systemPrompt: undefined,
+    systemPromptCodemodeAddons: undefined,
+    goal: undefined,
+    delegable: [],
+    protocol: undefined,
+    ui: [],
+    protocols: [],
+    trigger: undefined,
+    modelConfig: undefined,
+    mcpServerTools: undefined,
+    guardrails: undefined,
+    evals: undefined,
+    codemode: undefined,
+    output: undefined,
+    advanced: undefined,
+    checkpoints: undefined,
+    authorizationPolicy: undefined,
+    notifications: undefined,
+    memory: 'ephemeral',
+    preHooks: undefined,
+    postHooks: undefined,
+    toolHooks: undefined,
+    parameters: undefined,
+    subagents: undefined,
+};
+export const EXAMPLE_HARNESS_FAST_AGENT_SPEC_0_0_1 = {
+    id: 'example-harness-fast-agent',
+    version: '0.0.1',
+    name: 'A fast-agent Agent',
+    description: `fast-agent as a Datalayer agent: launched in the runtime over the Agent Client Protocol, its files, terminals and permissions decided by the Shield under the application's Rules, every action in the record. Needs the account's ANTHROPIC_API_KEY.`,
+    tags: ['coding', 'harness', 'acp'],
+    domain: undefined,
+    enabled: false,
+    model: undefined,
+    mcpServers: [],
+    skills: [].filter(Boolean),
+    backendTools: [],
+    frontendTools: [],
+    environmentName: 'ai-agents-env',
+    icon: undefined,
+    emoji: undefined,
+    color: undefined,
+    suggestions: [],
+    welcomeMessage: undefined,
+    welcomeNotebook: undefined,
+    welcomeDocument: undefined,
+    sandboxVariant: 'jupyter-server',
+    harness: 'fast-agent',
+    systemPrompt: undefined,
+    systemPromptCodemodeAddons: undefined,
+    goal: undefined,
+    delegable: [],
+    protocol: undefined,
+    ui: [],
+    protocols: [],
+    trigger: undefined,
+    modelConfig: undefined,
+    mcpServerTools: undefined,
+    guardrails: undefined,
+    evals: undefined,
+    codemode: undefined,
+    output: undefined,
+    advanced: undefined,
+    checkpoints: undefined,
+    authorizationPolicy: undefined,
+    notifications: undefined,
+    memory: 'ephemeral',
+    preHooks: undefined,
+    postHooks: undefined,
+    toolHooks: undefined,
+    parameters: undefined,
+    subagents: undefined,
+};
+export const EXAMPLE_HARNESS_GEMINI_CLI_AGENTSPEC_0_0_1 = {
+    id: 'example-harness-gemini-cli',
+    version: '0.0.1',
+    name: 'A Gemini CLI Agent',
+    description: `Google's Gemini CLI as a Datalayer agent: launched in the runtime over the Agent Client Protocol, its files, terminals and permissions decided by the Shield under the application's Rules, every action in the record. Needs the account's GEMINI_API_KEY.`,
+    tags: ['coding', 'harness', 'acp'],
+    domain: undefined,
+    enabled: false,
+    model: undefined,
+    mcpServers: [],
+    skills: [].filter(Boolean),
+    backendTools: [],
+    frontendTools: [],
+    environmentName: 'ai-agents-env',
+    icon: undefined,
+    emoji: undefined,
+    color: undefined,
+    suggestions: [],
+    welcomeMessage: undefined,
+    welcomeNotebook: undefined,
+    welcomeDocument: undefined,
+    sandboxVariant: 'jupyter-server',
+    harness: 'gemini-cli',
+    systemPrompt: undefined,
+    systemPromptCodemodeAddons: undefined,
+    goal: undefined,
+    delegable: [],
+    protocol: undefined,
+    ui: [],
+    protocols: [],
+    trigger: undefined,
+    modelConfig: undefined,
+    mcpServerTools: undefined,
+    guardrails: undefined,
+    evals: undefined,
+    codemode: undefined,
+    output: undefined,
+    advanced: undefined,
+    checkpoints: undefined,
+    authorizationPolicy: undefined,
+    notifications: undefined,
+    memory: 'ephemeral',
+    preHooks: undefined,
+    postHooks: undefined,
+    toolHooks: undefined,
+    parameters: undefined,
+    subagents: undefined,
+};
+export const EXAMPLE_HARNESS_GOOSE_AGENTSPEC_0_0_1 = {
+    id: 'example-harness-goose',
+    version: '0.0.1',
+    name: 'A goose Agent',
+    description: `goose as a Datalayer agent: launched in the runtime over the Agent Client Protocol, its files, terminals and permissions decided by the Shield under the application's Rules, every action in the record. Needs the account's ANTHROPIC_API_KEY.`,
+    tags: ['coding', 'harness', 'acp'],
+    domain: undefined,
+    enabled: false,
+    model: undefined,
+    mcpServers: [],
+    skills: [].filter(Boolean),
+    backendTools: [],
+    frontendTools: [],
+    environmentName: 'ai-agents-env',
+    icon: undefined,
+    emoji: undefined,
+    color: undefined,
+    suggestions: [],
+    welcomeMessage: undefined,
+    welcomeNotebook: undefined,
+    welcomeDocument: undefined,
+    sandboxVariant: 'jupyter-server',
+    harness: 'goose',
+    systemPrompt: undefined,
+    systemPromptCodemodeAddons: undefined,
+    goal: undefined,
+    delegable: [],
+    protocol: undefined,
+    ui: [],
+    protocols: [],
+    trigger: undefined,
+    modelConfig: undefined,
+    mcpServerTools: undefined,
+    guardrails: undefined,
+    evals: undefined,
+    codemode: undefined,
+    output: undefined,
+    advanced: undefined,
+    checkpoints: undefined,
+    authorizationPolicy: undefined,
+    notifications: undefined,
+    memory: 'ephemeral',
+    preHooks: undefined,
+    postHooks: undefined,
+    toolHooks: undefined,
+    parameters: undefined,
+    subagents: undefined,
+};
+export const EXAMPLE_HARNESS_OPENCODE_AGENTSPEC_0_0_1 = {
+    id: 'example-harness-opencode',
+    version: '0.0.1',
+    name: 'An OpenCode Agent',
+    description: `OpenCode as a Datalayer agent: launched in the runtime over the Agent Client Protocol, its files, terminals and permissions decided by the Shield under the application's Rules, every action in the record. Needs the account's ANTHROPIC_API_KEY.`,
+    tags: ['coding', 'harness', 'acp'],
+    domain: undefined,
+    enabled: false,
+    model: undefined,
+    mcpServers: [],
+    skills: [].filter(Boolean),
+    backendTools: [],
+    frontendTools: [],
+    environmentName: 'ai-agents-env',
+    icon: undefined,
+    emoji: undefined,
+    color: undefined,
+    suggestions: [],
+    welcomeMessage: undefined,
+    welcomeNotebook: undefined,
+    welcomeDocument: undefined,
+    sandboxVariant: 'jupyter-server',
+    harness: 'opencode',
+    systemPrompt: undefined,
+    systemPromptCodemodeAddons: undefined,
+    goal: undefined,
+    delegable: [],
+    protocol: undefined,
+    ui: [],
+    protocols: [],
+    trigger: undefined,
+    modelConfig: undefined,
+    mcpServerTools: undefined,
+    guardrails: undefined,
+    evals: undefined,
+    codemode: undefined,
+    output: undefined,
+    advanced: undefined,
+    checkpoints: undefined,
+    authorizationPolicy: undefined,
+    notifications: undefined,
+    memory: 'ephemeral',
+    preHooks: undefined,
+    postHooks: undefined,
+    toolHooks: undefined,
+    parameters: undefined,
+    subagents: undefined,
+};
+export const EXAMPLE_HARNESS_OPENHANDS_AGENTSPEC_0_0_1 = {
+    id: 'example-harness-openhands',
+    version: '0.0.1',
+    name: 'An OpenHands Agent',
+    description: `The OpenHands CLI as a Datalayer agent: launched in the runtime over the Agent Client Protocol, its files, terminals and permissions decided by the Shield under the application's Rules, every action in the record. Needs the account's LLM_API_KEY.`,
+    tags: ['coding', 'harness', 'acp'],
+    domain: undefined,
+    enabled: false,
+    model: undefined,
+    mcpServers: [],
+    skills: [].filter(Boolean),
+    backendTools: [],
+    frontendTools: [],
+    environmentName: 'ai-agents-env',
+    icon: undefined,
+    emoji: undefined,
+    color: undefined,
+    suggestions: [],
+    welcomeMessage: undefined,
+    welcomeNotebook: undefined,
+    welcomeDocument: undefined,
+    sandboxVariant: 'jupyter-server',
+    harness: 'openhands',
+    systemPrompt: undefined,
+    systemPromptCodemodeAddons: undefined,
+    goal: undefined,
+    delegable: [],
+    protocol: undefined,
+    ui: [],
+    protocols: [],
+    trigger: undefined,
+    modelConfig: undefined,
+    mcpServerTools: undefined,
+    guardrails: undefined,
+    evals: undefined,
+    codemode: undefined,
+    output: undefined,
+    advanced: undefined,
+    checkpoints: undefined,
+    authorizationPolicy: undefined,
+    notifications: undefined,
+    memory: 'ephemeral',
+    preHooks: undefined,
+    postHooks: undefined,
+    toolHooks: undefined,
+    parameters: undefined,
+    subagents: undefined,
+};
 export const EXAMPLE_HOOKS_AGENTSPEC_0_0_1 = {
     id: 'example-hooks',
     version: '0.0.1',
@@ -13563,6 +13851,12 @@ export const AGENTSPECS = {
     'example-guardrails': EXAMPLE_GUARDRAILS_AGENTSPEC_0_0_1,
     'example-haiku-generative-ui': EXAMPLE_HAIKU_GENERATIVE_UI_AGENTSPEC_0_0_1,
     'example-harness-claude-code': EXAMPLE_HARNESS_CLAUDE_CODE_AGENTSPEC_0_0_1,
+    'example-harness-codex': EXAMPLE_HARNESS_CODEX_AGENTSPEC_0_0_1,
+    'example-harness-fast-agent': EXAMPLE_HARNESS_FAST_AGENT_SPEC_0_0_1,
+    'example-harness-gemini-cli': EXAMPLE_HARNESS_GEMINI_CLI_AGENTSPEC_0_0_1,
+    'example-harness-goose': EXAMPLE_HARNESS_GOOSE_AGENTSPEC_0_0_1,
+    'example-harness-opencode': EXAMPLE_HARNESS_OPENCODE_AGENTSPEC_0_0_1,
+    'example-harness-openhands': EXAMPLE_HARNESS_OPENHANDS_AGENTSPEC_0_0_1,
     'example-hooks': EXAMPLE_HOOKS_AGENTSPEC_0_0_1,
     'example-human-approved-automation': EXAMPLE_HUMAN_APPROVED_AUTOMATION_AGENTSPEC_0_0_1,
     'example-human-in-the-loop': EXAMPLE_HUMAN_IN_THE_LOOP_AGENTSPEC_0_0_1,

package/lib/voice/HandsFree.js

@@ -198,7 +198,17 @@ export function HandsFree({ hearing, language, consentKey, microphoneId, turnSil
     }, [on, paused]);
     return (_jsxs(Box, { display: "inline-flex", alignItems: "center", sx: { gap: 1, position: 'relative' }, "data-hands-free": state, children: [_jsx(Tooltip, { text: on
                     ? 'Stop talking with it'
-                    : 'Talk with it: speak, it answers, and listens on (hands-free)', direction: "n", children: _jsx(Button, { size: "small", variant: on ? 'primary' : 'invisible', "aria-pressed": on, "aria-label": on ? 'Stop talking with it' : 'Talk with it', disabled: disabled, "data-hands-free-toggle": "", onClick: () => (on ? turnOff() : turnOn()), children: HANDS_FREE_WORDS.off }) }), on ? (_jsxs(_Fragment, { children: [_jsx(Text, { sx: { fontSize: 0, color: 'fg.muted' }, role: "status", "aria-live": "polite", "data-hands-free-state": state, children: HANDS_FREE_WORDS[state] }), paused ? (_jsx(IconButton, { icon: () => _jsx("span", { "aria-hidden": "true", children: "\u25B6" }), size: "small", variant: "invisible", "aria-label": "Resume listening", "data-hands-free-resume": "", onClick: () => setPaused(false) })) : (_jsx(IconButton, { icon: () => _jsx("span", { "aria-hidden": "true", children: "\u275A\u275A" }), size: "small", variant: "invisible", "aria-label": "Pause listening (Esc)", "data-hands-free-pause": "", onClick: () => {
+                    : 'Talk with it: speak, it answers, and listens on (hands-free)', direction: "n", children: _jsx(Button, { size: "small", variant: on ? 'primary' : 'invisible', "aria-pressed": on, "aria-label": on ? 'Stop talking with it' : 'Talk with it', "aria-disabled": disabled || undefined, "data-hands-free-toggle": "", onClick: () => {
+                        if (disabled) {
+                            return;
+                        }
+                        if (on) {
+                            turnOff();
+                        }
+                        else {
+                            turnOn();
+                        }
+                    }, children: HANDS_FREE_WORDS.off }) }), on ? (_jsxs(_Fragment, { children: [_jsx(Text, { sx: { fontSize: 0, color: 'fg.muted' }, role: "status", "aria-live": "polite", "data-hands-free-state": state, children: HANDS_FREE_WORDS[state] }), paused ? (_jsx(IconButton, { icon: () => _jsx("span", { "aria-hidden": "true", children: "\u25B6" }), size: "small", variant: "invisible", "aria-label": "Resume listening", "data-hands-free-resume": "", onClick: () => setPaused(false) })) : (_jsx(IconButton, { icon: () => _jsx("span", { "aria-hidden": "true", children: "\u275A\u275A" }), size: "small", variant: "invisible", "aria-label": "Pause listening (Esc)", "data-hands-free-pause": "", onClick: () => {
                             setPaused(true);
                             capture.current?.cancel();
                             capture.current = undefined;

package/lib/voice/VoiceInput.js

@@ -239,13 +239,15 @@ export function VoiceInput({ hearing, language, onTranscript, onInterim, silence
     // Never left open behind the page.
     useEffect(() => () => capture.current?.cancel(), []);
     const listening = state === 'listening';
+    // Not to be pressed: turned off, or the words still being heard.
+    const inert = disabled || state === 'hearing';
     const label = listening
         ? clicked
             ? 'Listening — click to stop'
             : 'Listening — let go to stop'
         : 'Click to talk, or hold (Ctrl+Space)';
-    return (_jsxs(Box, { "data-voice-input": state, display: "inline-flex", alignItems: "center", gap: 1, position: "relative", children: [speaking && onStopSpeaking && (_jsx(Tooltip, { text: "Stop speaking (Esc)", direction: "n", children: _jsx(IconButton, { icon: MuteIcon, "aria-label": "Stop speaking", size: "small", variant: "invisible", "data-voice-stop": "", onClick: onStopSpeaking }) })), listening && (_jsx(Box, { "aria-hidden": "true", width: 40, height: 4, borderRadius: 2, bg: "neutral.muted", overflow: "hidden", children: _jsx(Box, { ref: meter, width: "100%", height: "100%", bg: "danger.emphasis", transformOrigin: "left", transform: prefersStill() ? 'scaleX(1)' : 'scaleX(0.04)' }) })), (state === 'loading' || state === 'hearing') && (_jsx(Text, { sx: { fontSize: 0, color: 'fg.muted' }, "data-voice-progress": "", children: state === 'loading' && progress !== undefined ? `${progress}%` : '…' })), _jsx(Tooltip, { text: label, direction: "n", children: _jsx(IconButton, { icon: () => _jsx(MicrophoneIcon, { size: 16 }), "aria-label": label, "aria-pressed": listening, size: "small", variant: listening ? 'danger' : 'invisible', disabled: disabled || state === 'hearing', "data-voice-mic": "", onPointerDown: event => {
-                        if (event.button !== 0) {
+    return (_jsxs(Box, { "data-voice-input": state, display: "inline-flex", alignItems: "center", gap: 1, position: "relative", children: [speaking && onStopSpeaking && (_jsx(Tooltip, { text: "Stop speaking (Esc)", direction: "n", children: _jsx(IconButton, { icon: MuteIcon, "aria-label": "Stop speaking", size: "small", variant: "invisible", "data-voice-stop": "", onClick: onStopSpeaking }) })), listening && (_jsx(Box, { "aria-hidden": "true", width: 40, height: 4, borderRadius: 2, bg: "neutral.muted", overflow: "hidden", children: _jsx(Box, { ref: meter, width: "100%", height: "100%", bg: "danger.emphasis", transformOrigin: "left", transform: prefersStill() ? 'scaleX(1)' : 'scaleX(0.04)' }) })), (state === 'loading' || state === 'hearing') && (_jsx(Text, { sx: { fontSize: 0, color: 'fg.muted' }, "data-voice-progress": "", children: state === 'loading' && progress !== undefined ? `${progress}%` : '…' })), _jsx(Tooltip, { text: label, direction: "n", children: _jsx(IconButton, { icon: () => _jsx(MicrophoneIcon, { size: 16 }), "aria-label": label, "aria-pressed": listening, size: "small", variant: listening ? 'danger' : 'invisible', "aria-disabled": inert || undefined, "data-voice-mic": "", onPointerDown: event => {
+                        if (inert || event.button !== 0) {
                             return;
                         }
                         pressedAt.current = Date.now();
@@ -255,6 +257,9 @@ export function VoiceInput({ hearing, language, onTranscript, onInterim, silence
                             void start();
                         }
                     }, onPointerUp: () => {
+                        if (inert) {
+                            return;
+                        }
                         // Held: letting go stops. A click: it goes on until the next
                         // one, or until the person stops speaking.
                         if (stopOnRelease.current ||
@@ -269,6 +274,9 @@ export function VoiceInput({ hearing, language, onTranscript, onInterim, silence
                         // Enter or Space on the focused button toggles, for the keyboard (VO-66).
                         if (event.key === 'Enter' || event.key === ' ') {
                             event.preventDefault();
+                            if (inert) {
+                                return;
+                            }
                             if (stateRef.current === 'listening') {
                                 void stop();
                             }

package/lib/voice/handsFree.d.ts

@@ -53,8 +53,10 @@ export declare function turnEnded(heard: HeardSoFarLike, turnSilenceMs?: number)
  * At most this share of what plays is taken to come back into the
  * microphone once the browser's echo cancellation has done its part (VO-13),
  * on the meters' own scales (the microphone's `Capture.level`, the speaker's
- * `level`). A setting, not a measure yet: VO-52 measures it on a laptop's
- * own speakers.
+ * `level`). Measured on a laptop's own speakers in Chrome (VO-13): the echo
+ * left after cancellation was about 1% of the playback (0.055 at p95), and a
+ * voice over the answer passed this gate several times a second. 0.6 keeps
+ * a margin for worse speakers and rooms.
  */
 export declare const ECHO_SHARE = 0.6;
 /** How far above that echo the person's voice must be, on the meter's scale. */

package/lib/voice/handsFree.js

@@ -41,8 +41,10 @@ export function turnEnded(heard, turnSilenceMs = TURN_SILENCE_MS) {
  * At most this share of what plays is taken to come back into the
  * microphone once the browser's echo cancellation has done its part (VO-13),
  * on the meters' own scales (the microphone's `Capture.level`, the speaker's
- * `level`). A setting, not a measure yet: VO-52 measures it on a laptop's
- * own speakers.
+ * `level`). Measured on a laptop's own speakers in Chrome (VO-13): the echo
+ * left after cancellation was about 1% of the playback (0.055 at p95), and a
+ * voice over the answer passed this gate several times a second. 0.6 keeps
+ * a margin for worse speakers and rooms.
  */
 export const ECHO_SHARE = 0.6;
 /** How far above that echo the person's voice must be, on the meter's scale. */

package/package.json

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