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

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 },
 ];

package/dist/conversations/conversations.service.d.ts

@@ -1,8 +1,9 @@
 import { AgentLookup } from "../agents/agent-lookup.js";
 import type { ModelRef } from "../agents/definition.js";
+import type { AgentAvatar } from "../agents/profile.js";
 import { BackgroundTaskStopper } from "../background/stop.js";
 import type { TitleSource } from "../db/kernel-schema.js";
-import { ConversationEnvironments, type NewConversationEnvironment } from "../environments/conversation-environments.js";
+import { ConversationDevices, type NewConversationDevice } from "../devices/conversation-devices.js";
 import { KernelDb } from "../infra/database/kernel-db.js";
 import { TransactionHost } from "../infra/database/transaction-host.js";
 import type { KernelLogger } from "../log.js";
@@ -38,11 +39,11 @@ export interface ConversationView {
     /** When the owner archived it; null = not archived (hidden from the default lists). */
     archivedAt: Date | null;
     /**
-     * The environment it works in (environments spec §4.1 item 1); null while unbound (no sandbox
-     * provider when it was created, an anonymous IM sender's, or created before environments). A
+     * The device it works in (environments spec §4.1 item 1); null while unbound (no sandbox
+     * provider when it was created, an anonymous IM sender's, or created before devices). A
      * sub-agent's is null: it works in its root conversation's.
      */
-    environmentId: string | null;
+    deviceId: string | null;
     /**
      * What the latest run is doing: `running` (queued or running), `waiting` (an approval or a
      * question), else null. Only the list queries compute it; other responses carry null.
@@ -53,9 +54,17 @@ export interface ConversationView {
 export declare function escapeLike(s: string): string;
 /** One agent's group in the sidebar list: the caller's newest conversations with that agent. */
 export interface ConversationGroup {
+    /**
+     * The agent's name and the avatar half of its profile, in the agents API's shape (the sidebar
+     * draws the group title from it without reading the agents list).
+     */
     agent: {
         id: string;
         name: string;
+        profile: {
+            avatar: AgentAvatar;
+            updatedAt: string;
+        };
     };
     /** max(updated_at) of the group's conversations. */
     latestAt: Date;
@@ -196,8 +205,8 @@ export declare class ConversationsService {
     private readonly invoker;
     /** Stops a deleted conversation's background tasks. */
     private readonly background;
-    /** The environment a new conversation is bound to (environments spec §4.1 item 1). */
-    private readonly environments;
+    /** The device a new conversation is bound to (environments spec §4.1 item 1). */
+    private readonly devices;
     readonly txHost: TransactionHost;
     constructor(db: KernelDb, eventLog: EventLog, agents: Pick<AgentLookup, "get">, access: Pick<ConversationAccess, "isAccessible">, 
     /** Starts and stops the conversation's runs. */
@@ -212,20 +221,20 @@ export declare class ConversationsService {
     invoker: Pick<SkillInvoker, "prepare">, 
     /** Stops a deleted conversation's background tasks. */
     background: Pick<BackgroundTaskStopper, "stopForDeletedConversation">, 
-    /** The environment a new conversation is bound to (environments spec §4.1 item 1). */
-    environments: Pick<ConversationEnvironments, "forNew">, txHost: TransactionHost);
+    /** The device a new conversation is bound to (environments spec §4.1 item 1). */
+    devices: Pick<ConversationDevices, "forNew">, txHost: TransactionHost);
     /**
      * 不阻塞地调用一次 `ensureRun`（打开 SSE、读事件时）：它幂等，并顺带清理孤儿运行，
      * 会话不会因为某次运行结束后的投递失败而永远停在「运行中」。失败只记日志。
      */
     kickRun(conversationId: string): void;
     /**
-     * Creates an empty conversation bound to its environment (`pick`, see
-     * {@link ConversationEnvironments.forNew}); an agent the account cannot use →
-     * `agent.not_found`, an environment it may not use → `environment.not_found` /
-     * `environment.unavailable`, and nothing is created.
+     * Creates an empty conversation bound to its device (`pick`, see
+     * {@link ConversationDevices.forNew}); an agent the account cannot use →
+     * `agent.not_found`, a device it may not use → `device.not_found` /
+     * `device.unavailable`, and nothing is created.
      */
-    create(orgId: string, accountId: string, agentId: string, pick?: NewConversationEnvironment): Promise<ConversationView>;
+    create(orgId: string, accountId: string, agentId: string, pick?: NewConversationDevice): Promise<ConversationView>;
     /**
      * Creates a conversation together with its first message (UI refresh B, create on first send):
      * the conversation row and the `user_message` are written in one transaction, keyed by the
@@ -237,7 +246,7 @@ export declare class ConversationsService {
      */
     createWithMessage(orgId: string, accountId: string, agentId: string, input: UserMessageInput & {
         clientMessageId: string;
-    }, pick?: NewConversationEnvironment): Promise<{
+    }, pick?: NewConversationDevice): Promise<{
         conversation: ConversationView;
         event: ConversationEvent;
         events: ConversationEvent[];