@datalayer/agent-runtimes 1.5.87 → 1.5.88

package/lib/apps/apps/checks.d.ts

@@ -49,7 +49,7 @@ export declare const ORGANIZATION_FRAME_PREFIX = "org-";
 /** Whether a reference names an organization's own context rather than the catalogue's (U-32). */
 export declare const isOrganizationFrame: (ref: string) => boolean;
 /**
- * The Guards the runtime executes (agent-runtimes `loop/apps/guards.py`): the
+ * The Guards the runtime executes (agent-runtimes `apps/guards.py`): the
  * three of a session's start, run once before its model is first asked and
  * each written to the record, and the two of every tool call and the answer.
  */

package/lib/apps/apps/checks.js

@@ -634,7 +634,7 @@ function attentionNotes(app) {
     return notes;
 }
 /**
- * The Guards the runtime executes (agent-runtimes `loop/apps/guards.py`): the
+ * The Guards the runtime executes (agent-runtimes `apps/guards.py`): the
  * three of a session's start, run once before its model is first asked and
  * each written to the record, and the two of every tool call and the answer.
  */

package/lib/apps/apps/computer.d.ts

@@ -16,7 +16,7 @@ import type { ConversationEntry } from '../core';
 export declare const COMPUTER_PARTS: readonly ["browse", "files", "shell"];
 export type ComputerPart = (typeof COMPUTER_PARTS)[number];
 export type ComputerParts = Record<ComputerPart, boolean>;
-/** The tools of each part, as the runtime gives them (`loop/apps/computer.py`). */
+/** The tools of each part, as the runtime gives them (`apps/computer.py`). */
 export declare const COMPUTER_PART_TOOLS: Record<ComputerPart, readonly string[]>;
 /** What the computer view says. */
 export declare const COMPUTER_WORDS: {

package/lib/apps/apps/computer.js

@@ -4,7 +4,7 @@
  */
 /** The parts of a computer, in the order a person reads them. */
 export const COMPUTER_PARTS = ['browse', 'files', 'shell'];
-/** The tools of each part, as the runtime gives them (`loop/apps/computer.py`). */
+/** The tools of each part, as the runtime gives them (`apps/computer.py`). */
 export const COMPUTER_PART_TOOLS = {
     browse: [
         'open_page',

package/lib/apps/apps/pluginPair.d.ts

@@ -4,7 +4,7 @@
  * Whichever editor wrote it — a spec, the Canvas, an `app.py` — an
  * application is a pair of plugins of one name, `loop-app-<id>`: the page's
  * (`defineAppPlugin`) and the runtime's (`manifest_of` in
- * `agent_runtimes.loop.apps.plugins`, which says the same name). Each
+ * `agent_runtimes.apps.plugins`, which says the same name). Each
  * declares the other: the page's `requiredBackendPlugins`, the runtime's
  * `frontend_dependencies`; and both are delivered as one extension of that
  * name, which is how Reactor's manager and graph show them as one

package/lib/apps/apps/rules.d.ts

@@ -68,7 +68,7 @@ export declare const strictest: (behaviours: AppBehaviour[]) => AppBehaviour;
  * A tool of a server the application is not connected to is not given.
  *
  * The runtime gives its agent only these (`AppRulesCapability.prepare_tools`,
- * through `agent_runtimes.loop.apps.rules.gives`, its Python twin).
+ * through `agent_runtimes.apps.rules.gives`, its Python twin).
  *
  * @throws When `tool` names no server: a catalogue tool is given by the
  *   spec's `tools`, not by a connection.

package/lib/apps/apps/rules.js

@@ -26,7 +26,7 @@
  *    and the most restricted wins.
  *
  * The same decision is written in Python, in `agentspecs.apps.behaviour_for`
- * and in `agent_runtimes.loop.apps.rules`. `APP_BEHAVIOURS`, generated from
+ * and in `agent_runtimes.apps.rules`. `APP_BEHAVIOURS`, generated from
  * agentspecs, is what all three have to agree on. The server enforces; this
  * one shows the decision before it is made.
  *
@@ -217,7 +217,7 @@ const reaches = (connection, tool) => connection.only.length === 0 ||
  * A tool of a server the application is not connected to is not given.
  *
  * The runtime gives its agent only these (`AppRulesCapability.prepare_tools`,
- * through `agent_runtimes.loop.apps.rules.gives`, its Python twin).
+ * through `agent_runtimes.apps.rules.gives`, its Python twin).
  *
  * @throws When `tool` names no server: a catalogue tool is given by the
  *   spec's `tools`, not by a connection.

package/lib/apps/apps/visitorToken.d.ts

@@ -35,7 +35,7 @@ export declare function useVisitorToken(visitors: DatalayerVisitors | undefined)
 };
 /**
  * The agent of the visitors' runtime a visitor's token reaches, as the
- * runtime names it (`agent_of` in `agent_runtimes.loop.apps.visitors`): an
+ * runtime names it (`agent_of` in `agent_runtimes.apps.visitors`): an
  * example's by its id, an application at its address by `at-<slug>`. The
  * chat speaks to that agent and to no other: the token reaches no other.
  *

package/lib/apps/apps/visitorToken.js

@@ -118,7 +118,7 @@ const AT_PREFIX = 'at:';
 const SLUG = /^[a-z0-9][a-z0-9-]{0,99}$/;
 /**
  * The agent of the visitors' runtime a visitor's token reaches, as the
- * runtime names it (`agent_of` in `agent_runtimes.loop.apps.visitors`): an
+ * runtime names it (`agent_of` in `agent_runtimes.apps.visitors`): an
  * example's by its id, an application at its address by `at-<slug>`. The
  * chat speaks to that agent and to no other: the token reaches no other.
  *

package/lib/apps/core/appFiles.js

@@ -9,7 +9,7 @@
  * A component its developer wrote may be a file of its folder (`source:
  * gauge.js`). `loop apps package` puts the folder's files in the
  * application's wheel, beside a generated page-side plugin
- * (`loop-app-<id>/page`, `agent_runtimes/loop/apps/packaging.py`) whose one
+ * (`loop-app-<id>/page`, `agent_runtimes/apps/packaging.py`) whose one
  * contribution is to this point: the address its own directory is served at
  * by the server the wheel is installed beside. The page installs that plugin
  * through Reactor's `bootstrapExtensions` (`AppRuntimePlugins`), and a file

package/lib/apps/plugins/a2ui-surface/toolResult.d.ts

@@ -53,7 +53,7 @@ export declare function validateA2uiField(rule: A2uiFieldRule, value: unknown):
 export declare function validateA2uiSubmission(rules: A2uiFieldRule[], values: Record<string, unknown>): string[];
 /**
  * The display type of what an application's answer shows (P-04,
- * RU-2): `AnswerShows` in `agent_runtimes.loop.apps.components`.
+ * RU-2): `AnswerShows` in `agent_runtimes.apps.components`.
  */
 export declare const ANSWER_DISPLAY_TYPE = "application/vnd.datalayer.loop.answer+json";
 /** A button pressed on what an answer shows, as the chat sends it on. */

package/lib/apps/plugins/a2ui-surface/toolResult.js

@@ -106,7 +106,7 @@ export function validateA2uiSubmission(rules, values) {
 }
 /**
  * The display type of what an application's answer shows (P-04,
- * RU-2): `AnswerShows` in `agent_runtimes.loop.apps.components`.
+ * RU-2): `AnswerShows` in `agent_runtimes.apps.components`.
  */
 export const ANSWER_DISPLAY_TYPE = 'application/vnd.datalayer.loop.answer+json';
 /** The A2UI surface an answer's display draws, or `null` for a display that has none. */

package/lib/apps/plugins/app-page/appPageModel.d.ts

@@ -124,7 +124,7 @@ export declare function appPageInitialData(app: Pick<AppSpec, 'kind' | 'name' |
 export declare function inputsInWords(app: Pick<AppSpec, 'interface'>, inputs: unknown): string;
 /**
  * The largest file a session takes: what the session API refuses above
- * (`agent_runtimes.loop.apps.sessions.MAX_FILE_BYTES`), said here before
+ * (`agent_runtimes.apps.sessions.MAX_FILE_BYTES`), said here before
  * the file is sent.
  */
 export declare const MAX_FILE_BYTES: number;

package/lib/apps/plugins/app-page/appPageModel.js

@@ -357,7 +357,7 @@ export function inputsInWords(app, inputs) {
 }
 /**
  * The largest file a session takes: what the session API refuses above
- * (`agent_runtimes.loop.apps.sessions.MAX_FILE_BYTES`), said here before
+ * (`agent_runtimes.apps.sessions.MAX_FILE_BYTES`), said here before
  * the file is sent.
  */
 export const MAX_FILE_BYTES = 25 * 1024 * 1024;

package/lib/portable/hosts/client.d.ts

@@ -35,16 +35,26 @@ export type BoundHost = Readonly<{
  * with its key in `X-Datalayer-Host-Key`, or as a person, with the host token
  * the exchange answered. Any host speaks them.
  */
+/** Which app a host runs as: Datalayer's own, or one the person brought (`custom`). */
+export type HostProvider = 'datalayer' | 'custom';
 export declare class DatalayerHostClient {
     #private;
     readonly apiUrl: string;
     readonly fetchImplementation: typeof fetch;
     constructor(apiUrl: string, fetchImplementation?: typeof fetch);
-    /** Bind the installation its owner set up, with the code their browser carried. */
+    /**
+     * Bind the installation its owner set up, with the code their browser
+     * carried, asserting the app this host runs as: `datalayer` for
+     * Datalayer's own app, `custom` with the app's id for one the person
+     * brought. Datalayer refuses a provider that is not the one the
+     * installation was registered for (409), and a bind without one (422).
+     */
     bind(input: {
         code: string;
         externalId: string;
         name?: string;
+        provider: HostProvider;
+        customAppId?: string;
     }): Promise<BoundHost>;
     /** The installation was removed from its host: it ends at Datalayer (revocation). */
     uninstalled(hostKey: string): Promise<void>;

package/lib/portable/hosts/client.js

@@ -21,11 +21,6 @@ export class HostRefusedError extends Error {
         this.what = what;
     }
 }
-/**
- * The generic host routes of ai-agents a host calls besides the credential exchange: as the installation,
- * with its key in `X-Datalayer-Host-Key`, or as a person, with the host token
- * the exchange answered. Any host speaks them.
- */
 export class DatalayerHostClient {
     apiUrl;
     fetchImplementation;
@@ -54,13 +49,24 @@ export class DatalayerHostClient {
             throw new HostRefusedError(response.status, typeof body.detail === 'string' ? body.detail : 'refused', what);
         return schema.parse(body);
     }
-    /** Bind the installation its owner set up, with the code their browser carried. */
+    /**
+     * Bind the installation its owner set up, with the code their browser
+     * carried, asserting the app this host runs as: `datalayer` for
+     * Datalayer's own app, `custom` with the app's id for one the person
+     * brought. Datalayer refuses a provider that is not the one the
+     * installation was registered for (409), and a bind without one (422).
+     */
     async bind(input) {
+        if (input.provider === 'custom' && !input.customAppId) {
+            throw new Error("A custom app's bind names its app id (customAppId): Datalayer refuses it otherwise.");
+        }
         const bound = await this.#call('Datalayer did not bind the installation', '/apps/hosts/bind', {
             body: {
                 code: input.code,
                 external_id: input.externalId,
                 name: input.name ?? '',
+                provider: input.provider,
+                custom_app_id: input.provider === 'custom' ? (input.customAppId ?? '') : '',
             },
             method: 'POST',
         }, bindSchema);

package/lib/portable/hosts/contracts.json

@@ -36,7 +36,9 @@
     "request": {
       "code": "dlhc_…",
       "external_id": "A0123:-:T0123",
-      "name": "Acme"
+      "name": "Acme",
+      "provider": "datalayer",
+      "custom_app_id": ""
     },
     "response_keys": [
       "success",
@@ -452,7 +454,9 @@
     "bind_request": {
       "code": "dlhc_…",
       "external_id": "123456789012345678:234567890123456789",
-      "name": "Acme"
+      "name": "Acme",
+      "provider": "datalayer",
+      "custom_app_id": ""
     },
     "external_user_id": "567890123456789012",
     "thread": {
@@ -501,7 +505,9 @@
     "bind_request": {
       "code": "dlhc_…",
       "external_id": "102290129340398:106540352242922",
-      "name": "Acme"
+      "name": "Acme",
+      "provider": "custom",
+      "custom_app_id": "1234567890"
     },
     "external_user_id": "US.13491208655302741918",
     "external_user_name": "Alice",

package/lib/portable/hosts/index.d.ts

@@ -21,7 +21,7 @@ export { AgUiFrames, readRunStream, type AgUiEvent } from '../agui';
 export * from '../semantic';
 export { askQuestionOf, semanticOf, turnOf, type TurnInfo, } from '../semanticOfAgUi';
 export * from './contracts';
-export { DatalayerHostClient, HostRefusedError, type BoundHost, type HostSelf, } from './client';
+export { DatalayerHostClient, HostRefusedError, type BoundHost, type HostProvider, type HostSelf, } from './client';
 export { agUiEventsOf, assertTrustedStreamUrl, DevelopmentCredentials, HostKeyCredentials, hostSessionOf, HostStarters, HttpAgentClient, InstallationCredentials, lastAnswer, type AgentClient, type HostCredentials, type HostKeyLookup, type HostSession, type HostShape, type HostTurnRequest, type Place, type SessionBinder, type Starter, type StarterSource, type TurnProvenance, type TurnStream, } from './agentClient';
 export { hostSessionUid } from './sessionUid';
 export { DATALAYER_ONLY, MAIL_WORDS, RENDERERS, renderApproval, type RenderedAction, type RenderedField, } from './approvalRenderers';

package/lib/portable/records.d.ts

@@ -15,7 +15,7 @@ export declare const RUN_END_WORDS: Record<string, string>;
 /**
  * The mark around what the runtime tells an application of a turn a personal
  * agent asked over PAP or PACT, before the request (`asked_for_said`,
- * `ASKED_FOR_TAG` in agent_runtimes.loop.apps.pap_company).
+ * `ASKED_FOR_TAG` in agent_runtimes.apps.pap_company).
  */
 export declare const ASKED_FOR_TAG = "asked-for";
 /**

package/lib/portable/records.js

@@ -23,7 +23,7 @@ export const RUN_END_WORDS = {
 /**
  * The mark around what the runtime tells an application of a turn a personal
  * agent asked over PAP or PACT, before the request (`asked_for_said`,
- * `ASKED_FOR_TAG` in agent_runtimes.loop.apps.pap_company).
+ * `ASKED_FOR_TAG` in agent_runtimes.apps.pap_company).
  */
 export const ASKED_FOR_TAG = 'asked-for';
 /**

package/lib/portable/semantic-events.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "about": "The semantic agent events a chat host renders (Slack, Discord:  DC-005, S-004, S-205), and the AG-UI events of agent-runtimes' session API (agent_runtimes/routes/apps.py, agent_runtimes/loop/apps/sessions.py, agent_runtimes/loop/apps/external_turns.py) each reduces to. src/portable/semanticOfAgUi.ts reduces every case (src/portable/__tests__/semantic.unit.test.ts); agent_runtimes/tests/test_semantic_events_contract.py holds the cases to what the runtime emits.",
+  "about": "The semantic agent events a chat host renders (Slack, Discord:  DC-005, S-004, S-205), and the AG-UI events of agent-runtimes' session API (agent_runtimes/routes/apps.py, agent_runtimes/apps/sessions.py, agent_runtimes/apps/external_turns.py) each reduces to. src/portable/semanticOfAgUi.ts reduces every case (src/portable/__tests__/semantic.unit.test.ts); agent_runtimes/tests/test_semantic_events_contract.py holds the cases to what the runtime emits.",
   "kinds": [
     "text",
     "progress",
@@ -23,9 +23,9 @@
     "table": "a Markdown table in the answer (src/portable/semantic.ts answerParts); no AG-UI event carries one",
     "file": "none in agent-runtimes 1.5.45: reserved, rendered as a safe HTTPS link when produced",
     "citation": "an HTTPS Markdown link in the answer (answerParts); no AG-UI event carries one",
-    "ask": "AG-UI RUN_FINISHED with result.asking (agent_runtimes/loop/apps/sessions.py question_of); the run stream carries no loop.ask event",
+    "ask": "AG-UI RUN_FINISHED with result.asking (agent_runtimes/apps/sessions.py question_of); the run stream carries no loop.ask event",
     "completion": "AG-UI RUN_FINISHED without asking",
-    "stop": "the host itself, after its own Stop: a stopped session's stream ends without RUN_FINISHED or RUN_ERROR (agent_runtimes/loop/apps/sessions.py stop, _close); no AG-UI event carries it",
+    "stop": "the host itself, after its own Stop: a stopped session's stream ends without RUN_FINISHED or RUN_ERROR (agent_runtimes/apps/sessions.py stop, _close); no AG-UI event carries it",
     "error": "AG-UI RUN_ERROR message",
     "sign-in": "AG-UI TOOL_CALL_RESULT of pap_sign_in (or pact_sign_in, with or without a gateway prefix) whose result is a sign-in waiting for the person with an https page (src/portable/signIn.ts readPapSignIn), after the tool's complete row; a page that is not https gives the row only"
   },

package/lib/portable/semanticOfAgUi.d.ts

@@ -4,7 +4,7 @@
  * `readRunStream` (`agui.ts`); this says what each event means to a host.
  *
  * The runtime's `loop.turn` event says which turn a stream is and where it
- * stands (`running`, `finished`, `failed`: agent_runtimes/loop/apps/
+ * stands (`running`, `finished`, `failed`: agent_runtimes/apps/
  * external_turns.py); a stopped session's stream ends without a run end,
  * so `stop` is never read from an event: the host that pressed Stop says it.
  * A question is read from `RUN_FINISHED.result.asking` only: the run stream

package/lib/runtimes/variants.d.ts

@@ -37,7 +37,7 @@ export declare const CUSTOM_HARNESS = "custom";
  * when one does.
  *
  * A harness the catalogue offers (`agentspecs/harnesses`, SH-01) — Claude
- * Code, Codex, OpenCode, Gemini CLI — is served by the Datalayer runtime
+ * Code, Codex, OpenCode, pi — is served by the Datalayer runtime
  * through its ACP adapter (`ACPAgent`, SH-10): the runtime launches the
  * harness as its subprocess, so the runtime's locations run it and the
  * browser, which has no process to launch, does not. Three are refused:

package/lib/runtimes/variants.js

@@ -73,7 +73,7 @@ export const CUSTOM_HARNESS = 'custom';
  * when one does.
  *
  * A harness the catalogue offers (`agentspecs/harnesses`, SH-01) — Claude
- * Code, Codex, OpenCode, Gemini CLI — is served by the Datalayer runtime
+ * Code, Codex, OpenCode, pi — is served by the Datalayer runtime
  * through its ACP adapter (`ACPAgent`, SH-10): the runtime launches the
  * harness as its subprocess, so the runtime's locations run it and the
  * browser, which has no process to launch, does not. Three are refused:

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

@@ -48,6 +48,7 @@ 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_HARNESS_PI_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

@@ -2918,6 +2918,54 @@ export const EXAMPLE_HARNESS_OPENHANDS_AGENTSPEC_0_0_1 = {
     parameters: undefined,
     subagents: undefined,
 };
+export const EXAMPLE_HARNESS_PI_AGENTSPEC_0_0_1 = {
+    id: 'example-harness-pi',
+    version: '0.0.1',
+    name: 'A pi Agent',
+    description: `pi 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: 'pi',
+    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',
@@ -13858,6 +13906,7 @@ export const AGENTSPECS = {
     '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-harness-pi': EXAMPLE_HARNESS_PI_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,