@capybara-hq/kernel 0.1.0-rc.12 → 0.1.0-rc.13

package/dist/channels/phrases.d.ts

@@ -11,33 +11,33 @@ export declare const CHANNEL_PHRASES: {
         readonly zh: "已开始新对话";
         readonly en: "Started a new conversation.";
     };
-    /** 私聊 `/env`：列出可用环境（`{list}` 每行一个，当前的带标记）。 */
-    readonly envList: {
-        readonly zh: "你的环境：\n{list}\n发送 /env <名称> 选择下一个新对话使用的环境。";
-        readonly en: "Your environments:\n{list}\nSend /env <name> to choose the one your next new conversation uses.";
-    };
-    /** 私聊 `/env <名称>` 之后（`{name}` 是环境名）。 */
-    readonly envSwitched: {
-        readonly zh: "下一个新对话将使用环境「{name}」，发送 /new 开始。";
-        readonly en: "Your next new conversation will use the environment “{name}”; send /new to start one.";
-    };
-    /** 私聊 `/env <名称>` 没有匹配的可用环境（`{list}` 同 envList）。 */
-    readonly envUnknown: {
-        readonly zh: "没有找到名为「{name}」的环境。你的环境：\n{list}";
-        readonly en: "No environment named “{name}”. Your environments:\n{list}";
-    };
-    /** `/env <name>` names an existing environment that is unavailable now (`{list}` as in envList). */
-    readonly envUnavailable: {
-        readonly zh: "环境「{name}」当前不可用（它的文件由未启用的沙箱提供方保存）。你的环境：\n{list}";
-        readonly en: "The environment “{name}” is unavailable: its files are kept by a sandbox provider that is not active. Your environments:\n{list}";
-    };
-    /** 私聊 `/env` 时此人没有可用环境（部署没有云沙箱）。 */
-    readonly envNone: {
-        readonly zh: "你目前没有可用的环境。";
-        readonly en: "You have no usable environments.";
-    };
-    /** 环境列表里当前 IM 默认环境的标记。 */
-    readonly envCurrent: {
+    /** Direct message `/device`: lists the usable devices (`{list}` one per line, the current one marked). */
+    readonly deviceList: {
+        readonly zh: "你的设备：\n{list}\n发送 /device <名称> 选择下一个新对话使用的设备。";
+        readonly en: "Your devices:\n{list}\nSend /device <name> to choose the one your next new conversation uses.";
+    };
+    /** After a direct message `/device <name>` (`{name}` is the device's name). */
+    readonly deviceSwitched: {
+        readonly zh: "下一个新对话将使用设备「{name}」，发送 /new 开始。";
+        readonly en: "Your next new conversation will use the device “{name}”; send /new to start one.";
+    };
+    /** `/device <name>` matches no usable device (`{list}` as in deviceList). */
+    readonly deviceUnknown: {
+        readonly zh: "没有找到名为「{name}」的设备。你的设备：\n{list}";
+        readonly en: "No device named “{name}”. Your devices:\n{list}";
+    };
+    /** `/device <name>` names an existing device that is unavailable now (`{list}` as in deviceList). */
+    readonly deviceUnavailable: {
+        readonly zh: "设备「{name}」当前不可用（它的文件由未启用的沙箱提供方保存）。你的设备：\n{list}";
+        readonly en: "The device “{name}” is unavailable: its files are kept by a sandbox provider that is not active. Your devices:\n{list}";
+    };
+    /** Direct message `/device` when the person has no usable device (no cloud sandbox in the deployment). */
+    readonly deviceNone: {
+        readonly zh: "你目前没有可用的设备。";
+        readonly en: "You have no usable devices.";
+    };
+    /** The mark of the current IM default device in the device list. */
+    readonly deviceCurrent: {
         readonly zh: "（当前）";
         readonly en: " (current)";
     };

package/dist/channels/phrases.js

@@ -6,33 +6,33 @@
 export const CHANNEL_PHRASES = {
     /** 私聊 `/new` 之后。 */
     newConversation: { zh: "已开始新对话", en: "Started a new conversation." },
-    /** 私聊 `/env`：列出可用环境（`{list}` 每行一个，当前的带标记）。 */
-    envList: {
-        zh: "你的环境：\n{list}\n发送 /env <名称> 选择下一个新对话使用的环境。",
-        en: "Your environments:\n{list}\nSend /env <name> to choose the one your next new conversation uses.",
-    },
-    /** 私聊 `/env <名称>` 之后（`{name}` 是环境名）。 */
-    envSwitched: {
-        zh: "下一个新对话将使用环境「{name}」，发送 /new 开始。",
-        en: "Your next new conversation will use the environment \u201c{name}\u201d; send /new to start one.",
-    },
-    /** 私聊 `/env <名称>` 没有匹配的可用环境（`{list}` 同 envList）。 */
-    envUnknown: {
-        zh: "没有找到名为「{name}」的环境。你的环境：\n{list}",
-        en: "No environment named \u201c{name}\u201d. Your environments:\n{list}",
-    },
-    /** `/env <name>` names an existing environment that is unavailable now (`{list}` as in envList). */
-    envUnavailable: {
-        zh: "环境「{name}」当前不可用（它的文件由未启用的沙箱提供方保存）。你的环境：\n{list}",
-        en: "The environment \u201c{name}\u201d is unavailable: its files are kept by a sandbox provider that is not active. Your environments:\n{list}",
-    },
-    /** 私聊 `/env` 时此人没有可用环境（部署没有云沙箱）。 */
-    envNone: {
-        zh: "你目前没有可用的环境。",
-        en: "You have no usable environments.",
-    },
-    /** 环境列表里当前 IM 默认环境的标记。 */
-    envCurrent: { zh: "（当前）", en: " (current)" },
+    /** Direct message `/device`: lists the usable devices (`{list}` one per line, the current one marked). */
+    deviceList: {
+        zh: "你的设备：\n{list}\n发送 /device <名称> 选择下一个新对话使用的设备。",
+        en: "Your devices:\n{list}\nSend /device <name> to choose the one your next new conversation uses.",
+    },
+    /** After a direct message `/device <name>` (`{name}` is the device's name). */
+    deviceSwitched: {
+        zh: "下一个新对话将使用设备「{name}」，发送 /new 开始。",
+        en: "Your next new conversation will use the device \u201c{name}\u201d; send /new to start one.",
+    },
+    /** `/device <name>` matches no usable device (`{list}` as in deviceList). */
+    deviceUnknown: {
+        zh: "没有找到名为「{name}」的设备。你的设备：\n{list}",
+        en: "No device named \u201c{name}\u201d. Your devices:\n{list}",
+    },
+    /** `/device <name>` names an existing device that is unavailable now (`{list}` as in deviceList). */
+    deviceUnavailable: {
+        zh: "设备「{name}」当前不可用（它的文件由未启用的沙箱提供方保存）。你的设备：\n{list}",
+        en: "The device \u201c{name}\u201d is unavailable: its files are kept by a sandbox provider that is not active. Your devices:\n{list}",
+    },
+    /** Direct message `/device` when the person has no usable device (no cloud sandbox in the deployment). */
+    deviceNone: {
+        zh: "你目前没有可用的设备。",
+        en: "You have no usable devices.",
+    },
+    /** The mark of the current IM default device in the device list. */
+    deviceCurrent: { zh: "（当前）", en: " (current)" },
     /** 未绑定的人在私聊里发消息：附绑定卡片。 */
     bindPrompt: {
         zh: "请先绑定你的 Capybara 账号，再与我对话。",

package/dist/config/docs.js

@@ -82,7 +82,7 @@ export function renderConfigDocs(schema) {
         "| `CAPYBARA_WEB_OBJECT_STORE_URL` | Object storage on the web origin: the object store's address as web reaches it (e.g. `http://seaweedfs-s3:8333`). When set, web proxies `/<bucket>/**` (and `/<bucket>` itself for POST only) there, so browsers upload attachments (presigned POST) and download attachments and artifacts (presigned GET) through web; set the object-store extension's `publicEndpoint` to the web origin with `forcePathStyle: true`. Only GET, HEAD and POST; the path is forwarded unchanged; cookies and authorization are not forwarded; responses carry `X-Content-Type-Options: nosniff` and `Content-Security-Policy: sandbox`; uploads are capped at `CAPYBARA_WEB_MAX_PACKAGE_BYTES`. Unset (default): off |",
         "| `CAPYBARA_WEB_OBJECT_STORE_BUCKET` | With `CAPYBARA_WEB_OBJECT_STORE_URL`: the bucket, equal to the object-store extension's `bucket` (it is the first path segment web proxies) |",
         "| `CAPYBARA_WEB_OBJECT_STORE_PUBLIC_HOST` | With `CAPYBARA_WEB_OBJECT_STORE_URL`: the host of the extension's `publicEndpoint` (a host such as `capybara.example.com`, or that URL). Sent upstream as `Host` instead of the incoming one, because presigned URLs sign the host they were issued for and front proxies rewrite it |",
-        "| `CAPYBARA_WEB_GATEWAY_URL` | Connected machines on the web origin: a `gateway` replica's address as web reaches it (an http(s) URL, e.g. `http://gateway:8080`). WebSocket upgrades on exactly `/device/connect` are forwarded to it (`capybara-device` connects at `<http.publicUrl>/device/connect`). Unset, they go to `CAPYBARA_KERNEL_URL` (the kernel runs every role unless the deployment splits them), so only deployments with separate gateway replicas set it (compose does). A malformed value stops the web tier at startup |",
+        "| `CAPYBARA_WEB_GATEWAY_URL` | Local devices on the web origin: a `gateway` replica's address as web reaches it (an http(s) URL, e.g. `http://gateway:8080`). WebSocket upgrades on exactly `/device/connect` are forwarded to it (`capybara-device` connects at `<http.publicUrl>/device/connect`). Unset, they go to `CAPYBARA_KERNEL_URL` (the kernel runs every role unless the deployment splits them), so only deployments with separate gateway replicas set it (compose does). A malformed value stops the web tier at startup |",
         "| `CAPYBARA_DEV_UI` | When set to `1`, production builds also serve the `/dev/ui` component catalog page (off by default) |",
         "",
     ].join("\n");

package/dist/config/schema.d.ts

@@ -219,9 +219,9 @@ export declare const KernelConfigSchema: z.ZodObject<{
             allowHosts: z.ZodDefault<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
-    environments: z.ZodPrefault<z.ZodObject<{
+    devices: z.ZodPrefault<z.ZodObject<{
         maxPersonal: z.ZodDefault<z.ZodNumber>;
-        device: z.ZodPrefault<z.ZodObject<{
+        local: z.ZodPrefault<z.ZodObject<{
             reconnectGraceSeconds: z.ZodDefault<z.ZodNumber>;
             leaseTtlMs: z.ZodDefault<z.ZodNumber>;
             authCodeTtlSeconds: z.ZodDefault<z.ZodNumber>;

package/dist/config/schema.js

@@ -1037,14 +1037,14 @@ export const KernelConfigSchema = z.object({
             .min(1)
             .optional()
             .meta(meta({
-            description: "Image for environment instances, passed to the sandbox extension; unset (the default), each extension uses the image published with its own version (ghcr.io/capybara-hq/capybara-sandbox). Set it to a locally built or mirrored image for offline deployments; an extension that builds instances from its own template may ignore it",
+            description: "Image for cloud device instances, passed to the sandbox extension; unset (the default), each extension uses the image published with its own version (ghcr.io/capybara-hq/capybara-sandbox). Set it to a locally built or mirrored image for offline deployments; an extension that builds instances from its own template may ignore it",
         })),
         lockWaitSeconds: z
             .number()
             .positive()
             .default(75)
             .meta(meta({
-            description: "Seconds a sandbox call waits for the environment's instance (while it is being created, resumed or suspended, or all its concurrent command slots are taken) before failing with sandbox.busy; keep it above the 60-second sandbox lock TTL so a call after a replica crash waits for the dead replica's lock to expire",
+            description: "Seconds a sandbox call waits for the device's instance (while it is being created, resumed or suspended, or all its concurrent command slots are taken) before failing with sandbox.busy; keep it above the 60-second sandbox lock TTL so a call after a replica crash waits for the dead replica's lock to expire",
         })),
         maxConcurrentCommands: z
             .number()
@@ -1054,7 +1054,7 @@ export const KernelConfigSchema = z.object({
             .default(6)
             .meta(meta({
             hot: true,
-            description: "Sandbox commands and file operations that may run at the same time in one environment, shared by all its conversations and their sub-agents; 1 runs them one at a time",
+            description: "Sandbox commands and file operations that may run at the same time in one device, shared by all its conversations and their sub-agents; 1 runs them one at a time",
         })),
         deliverMaxBytes: z
             .number()
@@ -1073,7 +1073,7 @@ export const KernelConfigSchema = z.object({
                 .max(100)
                 .default(4)
                 .meta(meta({
-                description: "Most background Bash tasks (run_in_background) that may run at once in one conversation, its sub-agents included (counted per root conversation, not per environment); a launch beyond it is refused",
+                description: "Most background Bash tasks (run_in_background) that may run at once in one conversation, its sub-agents included (counted per root conversation, not per device); a launch beyond it is refused",
             })),
             maxSeconds: z
                 .number()
@@ -1089,7 +1089,7 @@ export const KernelConfigSchema = z.object({
                 .min(1)
                 .default(10)
                 .meta(meta({
-                description: "How often the worker checks the running background Bash tasks of every environment for a finish, in seconds; read when the worker starts",
+                description: "How often the worker checks the running background Bash tasks of every device for a finish, in seconds; read when the worker starts",
             })),
         })
             .prefault({}),
@@ -1100,7 +1100,7 @@ export const KernelConfigSchema = z.object({
                 .positive()
                 .default(1)
                 .meta(meta({
-                description: "CPU cores for each environment instance; applies to instances created after the change (an extension that sizes instances by its own template, such as E2B, may not apply it)",
+                description: "CPU cores for each cloud device instance; applies to instances created after the change (an extension that sizes instances by its own template, such as E2B, may not apply it)",
             })),
             memoryMb: z
                 .number()
@@ -1108,7 +1108,7 @@ export const KernelConfigSchema = z.object({
                 .positive()
                 .default(2048)
                 .meta(meta({
-                description: "Memory limit of each environment instance in MiB; applies to instances created after the change (an extension that sizes instances by its own template, such as E2B, may not apply it)",
+                description: "Memory limit of each cloud device instance in MiB; applies to instances created after the change (an extension that sizes instances by its own template, such as E2B, may not apply it)",
             })),
             diskMb: z
                 .number()
@@ -1116,7 +1116,7 @@ export const KernelConfigSchema = z.object({
                 .positive()
                 .default(5120)
                 .meta(meta({
-                description: "Disk limit of each environment's file system in MiB; applies to file systems created after the change (Docker: only with a volume driver that supports size; an extension whose storage cannot be sized may not apply it)",
+                description: "Disk limit of each cloud device's file system in MiB; applies to file systems created after the change (Docker: only with a volume driver that supports size; an extension whose storage cannot be sized may not apply it)",
             })),
             maxCommandSeconds: z
                 .number()
@@ -1132,7 +1132,7 @@ export const KernelConfigSchema = z.object({
                 .positive()
                 .default(10)
                 .meta(meta({
-                description: "Minutes without a command from any conversation of the environment before its running instance is suspended (files are kept, processes end)",
+                description: "Minutes without a command from any conversation of the device before its running instance is suspended (files are kept, processes end)",
             })),
             destroyAfterInactiveDays: z
                 .number()
@@ -1140,7 +1140,7 @@ export const KernelConfigSchema = z.object({
                 .positive()
                 .default(7)
                 .meta(meta({
-                description: "Days without use before an environment's instance is destroyed; its files are kept until the environment is deleted, and the next use starts a new instance on them",
+                description: "Days without use before a device's instance is destroyed; its files are kept until the device is deleted, and the next use starts a new instance on them",
             })),
             maxRunningMinutes: z
                 .number()
@@ -1148,13 +1148,13 @@ export const KernelConfigSchema = z.object({
                 .positive()
                 .default(120)
                 .meta(meta({
-                description: "Minutes an environment's instance may run continuously before it is suspended even while in use (skipped while a command is running)",
+                description: "Minutes a device's instance may run continuously before it is suspended even while in use (skipped while a command is running)",
             })),
             egress: z
                 .enum(["none", "allowlist", "open"])
                 .default("allowlist")
                 .meta(meta({
-                description: "Outbound network from environment instances: none, allowlist (only allowHosts) or open; applies to instances created after the change, existing ones keep theirs until destroyed",
+                description: "Outbound network from cloud device instances: none, allowlist (only allowHosts) or open; applies to instances created after the change, existing ones keep theirs until destroyed",
             })),
             allowHosts: z
                 .array(z.string())
@@ -1167,13 +1167,13 @@ export const KernelConfigSchema = z.object({
                 });
             })
                 .meta(meta({
-                description: "Hosts environment instances may reach when egress is allowlist: lowercase hostnames, optional leading '*.', no IPs, ports or internal-only names; applies to instances created after the change",
+                description: "Hosts cloud device instances may reach when egress is allowlist: lowercase hostnames, optional leading '*.', no IPs, ports or internal-only names; applies to instances created after the change",
             })),
         })
             .prefault({}),
     })
         .prefault({}),
-    environments: z
+    devices: z
         .object({
         maxPersonal: z
             .number()
@@ -1182,9 +1182,9 @@ export const KernelConfigSchema = z.object({
             .default(10)
             .meta(meta({
             hot: true,
-            description: "Most personal environments a member may have in one org, the default one included; creating one more fails with environment.limit_reached",
+            description: "Most personal devices a member may have in one org, the default one and local devices included; creating one more fails with device.limit_reached",
         })),
-        device: z
+        local: z
             .object({
             reconnectGraceSeconds: z
                 .number()
@@ -1193,7 +1193,7 @@ export const KernelConfigSchema = z.object({
                 .default(120)
                 .meta(meta({
                 hot: true,
-                description: "Seconds a connected machine may stay disconnected before its environment is reported offline; also sent to the device program at sign-in",
+                description: "Seconds a local device's machine may stay disconnected before the device is reported offline; also sent to capybara-device at sign-in",
             })),
             leaseTtlMs: z
                 .number()
@@ -1201,7 +1201,7 @@ export const KernelConfigSchema = z.object({
                 .min(6000)
                 .default(30000)
                 .meta(meta({
-                description: "Milliseconds the replica holding a machine's connection keeps its lease without renewing it; at least 6000",
+                description: "Milliseconds the replica holding a local device's connection keeps its lease without renewing it; at least 6000",
             })),
             authCodeTtlSeconds: z
                 .number()
@@ -1209,7 +1209,7 @@ export const KernelConfigSchema = z.object({
                 .positive()
                 .default(600)
                 .meta(meta({
-                description: "Seconds a device sign-in code stays valid before the program must start over (device.expired)",
+                description: "Seconds a device sign-in code stays valid before capybara-device must start over (device_sign_in.expired)",
             })),
             pollIntervalSeconds: z
                 .number()
@@ -1217,7 +1217,7 @@ export const KernelConfigSchema = z.object({
                 .positive()
                 .default(5)
                 .meta(meta({
-                description: "Seconds the device program waits between token polls during sign-in; polling faster gets device.slow_down",
+                description: "Seconds capybara-device waits between token polls during sign-in; polling faster gets device_sign_in.slow_down",
             })),
             maxFrameBytes: z
                 .number()
@@ -1225,7 +1225,7 @@ export const KernelConfigSchema = z.object({
                 .positive()
                 .default(16 * 1024 * 1024)
                 .meta(meta({
-                description: "Largest WebSocket frame in bytes accepted from or sent to a connected machine",
+                description: "Largest WebSocket frame in bytes accepted from or sent to a local device's machine",
             })),
         })
             .prefault({}),

package/dist/conversations/conversations.controller.d.ts

@@ -1,6 +1,6 @@
 import type { FastifyReply } from "fastify";
 import { z } from "zod";
-import type { EnvironmentView } from "../environments/environments.service.js";
+import type { DeviceView } from "../devices/devices.service.js";
 import { type Principal } from "../identity/principal.js";
 import { type OrgContext } from "../orgs/org.guard.js";
 import { ConversationToolInfo, type ToolInfo } from "../tools/info.js";
@@ -8,7 +8,7 @@ import type { AgentTreeNode } from "./agent-tree.js";
 import { type ArtifactPreview, ConversationArtifacts } from "./artifacts.js";
 import { EventsQuery, FilesQuery, IdParams, ListQuery, PatchBody, SubagentsQuery } from "./conversations.schemas.js";
 import { type ConversationGroup, ConversationsService, type ConversationView, type SubagentView, type UsageTotals } from "./conversations.service.js";
-import { ConversationEnvironmentStatus } from "./environment-status.js";
+import { ConversationDeviceStatus } from "./device-status.js";
 import type { ConversationEvent } from "./events.js";
 import { ConversationFiles, type FileOutput } from "./files.js";
 import { ConversationOutputs, type OutputPage } from "./outputs-read.js";
@@ -78,12 +78,12 @@ declare const MessageBody: z.ZodObject<{
  * `POST /conversations`: `message` creates the conversation with its first message (create on
  * first send; `clientMessageId` is required and makes a retry return the same conversation).
  * Without it the conversation is created empty (API clients; the web never does).
- * `environmentId` binds it to one of the caller's environments; without it the caller's default
- * environment (environments spec §4.1 item 1).
+ * `deviceId` binds it to one of the caller's devices; without it the caller's default
+ * device (environments spec §4.1 item 1).
  */
 declare const CreateBody: z.ZodObject<{
     agentId: z.ZodString;
-    environmentId: z.ZodOptional<z.ZodString>;
+    deviceId: z.ZodOptional<z.ZodString>;
     message: z.ZodOptional<z.ZodObject<{
         text: z.ZodString;
         attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -156,11 +156,11 @@ export declare class ConversationsController {
     private readonly conversations;
     private readonly outputs;
     private readonly artifacts;
-    private readonly environmentStatus;
+    private readonly deviceStatus;
     private readonly toolInfo;
     private readonly queue;
     private readonly files;
-    constructor(conversations: ConversationsService, outputs: ConversationOutputs, artifacts: ConversationArtifacts, environmentStatus: ConversationEnvironmentStatus, toolInfo: ConversationToolInfo, queue: ConversationQueue, files: ConversationFiles);
+    constructor(conversations: ConversationsService, outputs: ConversationOutputs, artifacts: ConversationArtifacts, deviceStatus: ConversationDeviceStatus, toolInfo: ConversationToolInfo, queue: ConversationQueue, files: ConversationFiles);
     /**
      * 201 when created; 200 when `message.clientMessageId` repeats an earlier first send. With a
      * message the answer has `event` (the `user_message`) and `events`: every event the first send
@@ -266,12 +266,12 @@ export declare class ConversationsController {
      */
     fileContent(principal: Principal, org: OrgContext, id: string, fileId: string, q: z.infer<typeof FileContentQuery>, reply: FastifyReply): Promise<void>;
     /**
-     * The environment the conversation works in (a sub-agent: its root's), as its owner sees it,
-     * with its instance state; `null` while unbound, or when the environment was deleted. Same
+     * The device the conversation works in (a sub-agent: its root's), as its owner sees it,
+     * with its instance state; `null` while unbound, or when the device was deleted. Same
      * visibility as the event stream.
      */
-    environment(principal: Principal, org: OrgContext, id: string): Promise<{
-        environment: EnvironmentView | null;
+    device(principal: Principal, org: OrgContext, id: string): Promise<{
+        device: DeviceView | null;
     }>;
     /**
      * Display metadata (title, kind, key arguments, source) of the tools a conversation's calls name,

package/dist/conversations/conversations.controller.js

@@ -19,7 +19,7 @@ import { ConversationToolInfo, TOOL_INFO_KEY_MAX, TOOL_INFO_MAX_KEYS, } from "..
 import { ARTIFACT_DOWNLOAD_CACHE_SECONDS, ConversationArtifacts, } from "./artifacts.js";
 import { EventsQuery, FilesQuery, IdParams, ListQuery, PatchBody, SubagentsQuery, searchFields, } from "./conversations.schemas.js";
 import { ConversationsService, } from "./conversations.service.js";
-import { ConversationEnvironmentStatus } from "./environment-status.js";
+import { ConversationDeviceStatus } from "./device-status.js";
 import { ConversationFiles, FILE_CONTENT_MAX_BYTES } from "./files.js";
 import { ConversationOutputs, OUTPUT_PAGE_MAX_CHARS } from "./outputs-read.js";
 import { ConversationQueue } from "./queue.service.js";
@@ -106,13 +106,13 @@ const MessageBody = MessageFields.strict().refine(...textRule);
  * `POST /conversations`: `message` creates the conversation with its first message (create on
  * first send; `clientMessageId` is required and makes a retry return the same conversation).
  * Without it the conversation is created empty (API clients; the web never does).
- * `environmentId` binds it to one of the caller's environments; without it the caller's default
- * environment (environments spec §4.1 item 1).
+ * `deviceId` binds it to one of the caller's devices; without it the caller's default
+ * device (environments spec §4.1 item 1).
  */
 const CreateBody = z
     .object({
     agentId: z.string().min(1).max(100),
-    environmentId: z.string().min(1).max(100).optional(),
+    deviceId: z.string().min(1).max(100).optional(),
     message: MessageFields.omit({ retryOf: true })
         .extend({ clientMessageId: z.string().min(1).max(200) })
         .strict()
@@ -167,15 +167,15 @@ let ConversationsController = class ConversationsController {
     conversations;
     outputs;
     artifacts;
-    environmentStatus;
+    deviceStatus;
     toolInfo;
     queue;
     files;
-    constructor(conversations, outputs, artifacts, environmentStatus, toolInfo, queue, files) {
+    constructor(conversations, outputs, artifacts, deviceStatus, toolInfo, queue, files) {
         this.conversations = conversations;
         this.outputs = outputs;
         this.artifacts = artifacts;
-        this.environmentStatus = environmentStatus;
+        this.deviceStatus = deviceStatus;
         this.toolInfo = toolInfo;
         this.queue = queue;
         this.files = files;
@@ -187,7 +187,7 @@ let ConversationsController = class ConversationsController {
      */
     async create(principal, org, body, reply) {
         const p = requireUser(principal);
-        const pick = body.environmentId === undefined ? {} : { environmentId: body.environmentId };
+        const pick = body.deviceId === undefined ? {} : { deviceId: body.deviceId };
         if (body.message === undefined) {
             return {
                 conversation: await this.conversations.create(org.orgId, p.account.id, body.agentId, pick),
@@ -371,13 +371,13 @@ let ConversationsController = class ConversationsController {
         await reply.send(c.body);
     }
     /**
-     * The environment the conversation works in (a sub-agent: its root's), as its owner sees it,
-     * with its instance state; `null` while unbound, or when the environment was deleted. Same
+     * The device the conversation works in (a sub-agent: its root's), as its owner sees it,
+     * with its instance state; `null` while unbound, or when the device was deleted. Same
      * visibility as the event stream.
      */
-    async environment(principal, org, id) {
+    async device(principal, org, id) {
         const p = requireUser(principal);
-        return { environment: await this.environmentStatus.get(org.orgId, id, p.account.id) };
+        return { device: await this.deviceStatus.get(org.orgId, id, p.account.id) };
     }
     /**
      * Display metadata (title, kind, key arguments, source) of the tools a conversation's calls name,
@@ -590,13 +590,13 @@ __decorate([
     __param(5, Res())
 ], ConversationsController.prototype, "fileContent", null);
 __decorate([
-    Get(":id/environment"),
+    Get(":id/device"),
     Header("cache-control", "private, no-store"),
     OrgAction("agents.use"),
     __param(0, CurrentPrincipal()),
     __param(1, CurrentOrg()),
     __param(2, Param("id"))
-], ConversationsController.prototype, "environment", null);
+], ConversationsController.prototype, "device", null);
 __decorate([
     Get(":id/tools"),
     Header("cache-control", "private, no-store"),
@@ -680,7 +680,7 @@ ConversationsController = __decorate([
     __param(0, Inject(ConversationsService)),
     __param(1, Inject(ConversationOutputs)),
     __param(2, Inject(ConversationArtifacts)),
-    __param(3, Inject(ConversationEnvironmentStatus)),
+    __param(3, Inject(ConversationDeviceStatus)),
     __param(4, Inject(ConversationToolInfo)),
     __param(5, Inject(ConversationQueue)),
     __param(6, Inject(ConversationFiles))

package/dist/conversations/conversations.module.d.ts

@@ -1,7 +1,7 @@
 /**
  * Conversations: the one {@link ConversationsService} (messages, model switches, skill
  * invocations, sub-agent views, abort), the queue, the file / artifact / output reads and the
- * conversation's environment. The event log, the access check and the attachments are their own modules (the
+ * conversation's device. The event log, the access check and the attachments are their own modules (the
  * skills and tools use them too) and are re-exported here.
  */
 export declare class ConversationsModule {

package/dist/conversations/conversations.module.js

@@ -7,7 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 import { Module } from "@nestjs/common";
 import { AgentLookupModule } from "../agents/agent-lookup.js";
 import { BackgroundModule } from "../background/background.module.js";
-import { EnvironmentsModule } from "../environments/environments.module.js";
+import { DevicesModule } from "../devices/devices.module.js";
 import { ProvidersModule } from "../runtime/providers.js";
 import { RuntimeModule } from "../runtime/runtime.module.js";
 import { SkillsModule } from "../skills/skills.module.js";
@@ -17,7 +17,7 @@ import { ConversationAccessModule } from "./access.js";
 import { ConversationArtifacts } from "./artifacts.js";
 import { AttachmentsModule } from "./attachments.module.js";
 import { ConversationsService } from "./conversations.service.js";
-import { ConversationEnvironmentStatus } from "./environment-status.js";
+import { ConversationDeviceStatus } from "./device-status.js";
 import { EventLogModule } from "./event-log.js";
 import { ConversationFiles } from "./files.js";
 import { ConversationOutputs } from "./outputs-read.js";
@@ -25,7 +25,7 @@ import { ConversationQueue } from "./queue.service.js";
 /**
  * Conversations: the one {@link ConversationsService} (messages, model switches, skill
  * invocations, sub-agent views, abort), the queue, the file / artifact / output reads and the
- * conversation's environment. The event log, the access check and the attachments are their own modules (the
+ * conversation's device. The event log, the access check and the attachments are their own modules (the
  * skills and tools use them too) and are re-exported here.
  */
 let ConversationsModule = class ConversationsModule {
@@ -43,8 +43,8 @@ ConversationsModule = __decorate([
             // the run control (start a run after a message, stop runs) and the model provider registry
             RuntimeModule,
             ProvidersModule,
-            // the environment a conversation is bound to, and its view
-            EnvironmentsModule,
+            // the device a conversation is bound to, and its view
+            DevicesModule,
             // the stop of a deleted conversation's background tasks
             BackgroundModule,
         ],
@@ -54,7 +54,7 @@ ConversationsModule = __decorate([
             ConversationOutputs,
             ConversationArtifacts,
             ConversationFiles,
-            ConversationEnvironmentStatus,
+            ConversationDeviceStatus,
         ],
         exports: [
             EventLogModule,
@@ -65,7 +65,7 @@ ConversationsModule = __decorate([
             ConversationOutputs,
             ConversationArtifacts,
             ConversationFiles,
-            ConversationEnvironmentStatus,
+            ConversationDeviceStatus,
         ],
     })
 ], ConversationsModule);

package/dist/conversations/conversations.schemas.js

@@ -74,6 +74,6 @@ export const CONVERSATION_ROUTES = [
     { route: "GET /api/v1/orgs/:orgId/conversations/:id/agent-tree", params: IdParams },
     { route: "GET /api/v1/orgs/:orgId/conversations/:id/usage", params: IdParams },
     { route: "GET /api/v1/orgs/:orgId/conversations/:id/files", params: IdParams, query: FilesQuery },
-    { route: "GET /api/v1/orgs/:orgId/conversations/:id/environment", params: IdParams },
+    { route: "GET /api/v1/orgs/:orgId/conversations/:id/device", params: IdParams },
     { route: "POST /api/v1/orgs/:orgId/conversations/:id/abort", params: IdParams },
 ];