linkshell-cli 0.5.42 → 0.6.1

package/dist/host/src/drivers/codex/settings.d.ts

@@ -0,0 +1,51 @@
+import type { SessionConfigOption } from "@linkshell/wire";
+export interface CodexModel {
+    id: string;
+    model: string;
+    displayName: string;
+    description?: string;
+    hidden?: boolean;
+    isDefault?: boolean;
+    defaultReasoningEffort?: string;
+    supportedReasoningEfforts?: {
+        reasoningEffort: string;
+        description?: string;
+    }[];
+}
+type SandboxPolicy = {
+    type: string;
+    [key: string]: unknown;
+};
+export interface CodexSettings {
+    model?: string;
+    effort?: string | null;
+    approvalPolicy?: unknown;
+    sandbox?: SandboxPolicy;
+}
+/** What the thread should switch to on its next turn. */
+export interface CodexOverrides {
+    model?: string;
+    effort?: string;
+    permissions?: string;
+}
+/** The Codex TUI's `/approvals` presets. */
+export declare const PERMISSION_PRESETS: {
+    id: string;
+    name: string;
+    description: string;
+    approvalPolicy: string;
+    sandboxPolicy: SandboxPolicy;
+}[];
+export declare function presetOf(settings: CodexSettings): string | undefined;
+export declare function settingsFrom(response: Record<string, unknown>): CodexSettings;
+/** The settings the thread will run with, overrides applied. */
+export declare function effective(settings: CodexSettings, overrides: CodexOverrides, models: CodexModel[]): {
+    model: string | undefined;
+    info: CodexModel | undefined;
+    effort: string | undefined;
+    permissions: string | undefined;
+};
+export declare function configOptions(settings: CodexSettings, overrides: CodexOverrides, models: CodexModel[]): SessionConfigOption[];
+/** `turn/start` parameters for the pending overrides. */
+export declare function turnOverrides(overrides: CodexOverrides): Record<string, unknown>;
+export {};

package/dist/host/src/drivers/codex/settings.js

@@ -0,0 +1,107 @@
+/** The Codex TUI's `/approvals` presets. */
+export const PERMISSION_PRESETS = [
+    {
+        id: "read-only",
+        name: "Read only",
+        description: "Can read files; asks before editing or running commands",
+        approvalPolicy: "on-request",
+        sandboxPolicy: { type: "readOnly", networkAccess: false },
+    },
+    {
+        id: "auto",
+        name: "Auto",
+        description: "Edits and runs commands in the workspace; asks before anything else",
+        approvalPolicy: "on-request",
+        sandboxPolicy: { type: "workspaceWrite", writableRoots: [], networkAccess: false, excludeTmpdirEnvVar: false, excludeSlashTmp: false },
+    },
+    {
+        id: "full-access",
+        name: "Full access",
+        description: "Edits and runs anything without asking",
+        approvalPolicy: "never",
+        sandboxPolicy: { type: "dangerFullAccess" },
+    },
+];
+export function presetOf(settings) {
+    switch (settings.sandbox?.type) {
+        case "readOnly":
+            return "read-only";
+        case "workspaceWrite":
+            return "auto";
+        case "dangerFullAccess":
+            return settings.approvalPolicy === "never" ? "full-access" : undefined;
+        default:
+            return undefined;
+    }
+}
+export function settingsFrom(response) {
+    return {
+        model: typeof response.model === "string" ? response.model : undefined,
+        effort: typeof response.reasoningEffort === "string" ? response.reasoningEffort : null,
+        approvalPolicy: response.approvalPolicy,
+        sandbox: response.sandbox && typeof response.sandbox === "object" ? response.sandbox : undefined,
+    };
+}
+function findModel(models, id) {
+    if (!id)
+        return undefined;
+    return models.find((m) => m.model === id || m.id === id);
+}
+/** The settings the thread will run with, overrides applied. */
+export function effective(settings, overrides, models) {
+    const model = overrides.model ?? settings.model ?? models.find((m) => m.isDefault)?.model;
+    const info = findModel(models, model);
+    const supported = info?.supportedReasoningEfforts?.map((e) => e.reasoningEffort) ?? [];
+    let effort = overrides.effort ?? settings.effort ?? info?.defaultReasoningEffort;
+    if (effort && supported.length > 0 && !supported.includes(effort))
+        effort = info?.defaultReasoningEffort;
+    const permissions = overrides.permissions ?? presetOf(settings);
+    return { model, info, effort, permissions };
+}
+export function configOptions(settings, overrides, models) {
+    const { model, info, effort, permissions } = effective(settings, overrides, models);
+    const options = [];
+    const visible = models.filter((m) => !m.hidden || m.model === model);
+    if (model && visible.length > 0) {
+        const values = visible.map((m) => ({ value: m.model, name: m.displayName || m.model, description: m.description || undefined }));
+        if (!values.some((v) => v.value === model))
+            values.unshift({ value: model, name: model, description: undefined });
+        options.push({ id: "model", name: "Model", category: "model", current: model, values });
+    }
+    const efforts = info?.supportedReasoningEfforts ?? [];
+    if (effort && efforts.length > 1) {
+        options.push({
+            id: "effort",
+            name: "Reasoning effort",
+            category: "effort",
+            current: effort,
+            values: efforts.map((e) => ({ value: e.reasoningEffort, name: e.reasoningEffort, description: e.description || undefined })),
+        });
+    }
+    options.push({
+        id: "permissions",
+        name: "Permissions",
+        category: "mode",
+        current: permissions ?? "custom",
+        values: [
+            ...(permissions ? [] : [{ value: "custom", name: "Custom", description: "Set in Codex's own config" }]),
+            ...PERMISSION_PRESETS.map((p) => ({ value: p.id, name: p.name, description: p.description })),
+        ],
+    });
+    return options;
+}
+/** `turn/start` parameters for the pending overrides. */
+export function turnOverrides(overrides) {
+    const params = {};
+    if (overrides.model)
+        params.model = overrides.model;
+    if (overrides.effort)
+        params.effort = overrides.effort;
+    const preset = PERMISSION_PRESETS.find((p) => p.id === overrides.permissions);
+    if (preset) {
+        params.approvalPolicy = preset.approvalPolicy;
+        params.sandboxPolicy = preset.sandboxPolicy;
+    }
+    return params;
+}
+//# sourceMappingURL=settings.js.map

package/dist/host/src/drivers/codex/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../../../../../host/src/drivers/codex/settings.ts"],"names":[],"mappings":"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"}

package/dist/host/src/drivers/images.d.ts

@@ -0,0 +1,11 @@
+import type { ContentBlock } from "@linkshell/wire";
+/** Largest image forwarded inline (base64 bytes). */
+export declare const MAX_INLINE_IMAGE: number;
+/** An inline image block, or undefined when the data is missing, too big or not base64. */
+export declare function inlineImage(data: string | undefined, mimeType: string | undefined): Extract<ContentBlock, {
+    type: "image";
+}> | undefined;
+/** A local image file, inlined so a client on another device can show it. */
+export declare function imageFromPath(path: string | undefined): Extract<ContentBlock, {
+    type: "image";
+}> | undefined;

package/dist/host/src/drivers/images.js

@@ -0,0 +1,34 @@
+import { readFileSync, statSync } from "node:fs";
+// Images every driver forwards the same way: inline base64, bounded in size so
+// one screenshot can't bloat the event log.
+/** Largest image forwarded inline (base64 bytes). */
+export const MAX_INLINE_IMAGE = 4 * 1024 * 1024;
+const IMAGE_TYPES = {
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    gif: "image/gif",
+    webp: "image/webp",
+    heic: "image/heic",
+};
+/** An inline image block, or undefined when the data is missing, too big or not base64. */
+export function inlineImage(data, mimeType) {
+    if (!data || data.length > MAX_INLINE_IMAGE || !/^[A-Za-z0-9+/=\s]+$/.test(data.slice(0, 256)))
+        return undefined;
+    return { type: "image", mimeType: mimeType && mimeType.startsWith("image/") ? mimeType : "image/png", data };
+}
+/** A local image file, inlined so a client on another device can show it. */
+export function imageFromPath(path) {
+    const mimeType = path ? IMAGE_TYPES[path.split(".").pop()?.toLowerCase() ?? ""] : undefined;
+    if (!path || !mimeType)
+        return undefined;
+    try {
+        if (statSync(path).size * 1.37 > MAX_INLINE_IMAGE)
+            return undefined;
+        return inlineImage(readFileSync(path).toString("base64"), mimeType);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=images.js.map

package/dist/host/src/drivers/images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.js","sourceRoot":"","sources":["../../../../../host/src/drivers/images.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGjD,+EAA+E;AAC/E,4CAA4C;AAE5C,qDAAqD;AACrD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAEhD,MAAM,WAAW,GAA2B;IAC1C,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,YAAY;IACjB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,YAAY;CACnB,CAAC;AAEF,2FAA2F;AAC3F,MAAM,UAAU,WAAW,CAAC,IAAwB,EAAE,QAA4B;IAChF,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,gBAAgB,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACjH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;AAC/G,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,aAAa,CAAC,IAAwB;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5F,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,CAAC;QACH,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,IAAI,GAAG,gBAAgB;YAAE,OAAO,SAAS,CAAC;QACpE,OAAO,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/host/src/drivers/nesting.d.ts

@@ -0,0 +1,6 @@
+import type { SessionUpdate } from "@linkshell/wire";
+import type { HistoryItem } from "./types.js";
+/** Marks a sub-agent's update as belonging to `parent`; drops what a sub-agent can't own (its prompt, usage, config…). */
+export declare function nestUnder(update: SessionUpdate, parent: string): SessionUpdate | undefined;
+/** A sub-agent's history items, nested under `parent`, with ids that can't collide with the parent's. */
+export declare function nestHistory(items: HistoryItem[], parent: string): HistoryItem[];

package/dist/host/src/drivers/nesting.js

@@ -0,0 +1,25 @@
+// Sub-agents, for every driver: a sub-agent's own messages, tool calls and turn
+// state are carried on the parent session, marked with the tool call that
+// spawned it. Clients nest them under that call.
+/** Marks a sub-agent's update as belonging to `parent`; drops what a sub-agent can't own (its prompt, usage, config…). */
+export function nestUnder(update, parent) {
+    switch (update.sessionUpdate) {
+        case "agent_message_chunk":
+        case "agent_thought_chunk":
+        case "tool_call":
+        case "tool_call_update":
+        case "ls_message_done":
+        case "ls_turn":
+            return { ...update, parentToolCallId: parent };
+        default:
+            return undefined;
+    }
+}
+/** A sub-agent's history items, nested under `parent`, with ids that can't collide with the parent's. */
+export function nestHistory(items, parent) {
+    return items.flatMap((item) => {
+        const updates = item.updates.flatMap((update) => nestUnder(update, parent) ?? []);
+        return updates.length > 0 ? [{ ...item, itemId: `sub:${parent}:${item.itemId}`, updates }] : [];
+    });
+}
+//# sourceMappingURL=nesting.js.map

package/dist/host/src/drivers/nesting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nesting.js","sourceRoot":"","sources":["../../../../../host/src/drivers/nesting.ts"],"names":[],"mappings":"AAGA,gFAAgF;AAChF,0EAA0E;AAC1E,iDAAiD;AAEjD,0HAA0H;AAC1H,MAAM,UAAU,SAAS,CAAC,MAAqB,EAAE,MAAc;IAC7D,QAAQ,MAAM,CAAC,aAAa,EAAE,CAAC;QAC7B,KAAK,qBAAqB,CAAC;QAC3B,KAAK,qBAAqB,CAAC;QAC3B,KAAK,WAAW,CAAC;QACjB,KAAK,kBAAkB,CAAC;QACxB,KAAK,iBAAiB,CAAC;QACvB,KAAK,SAAS;YACZ,OAAO,EAAE,GAAG,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC;QACjD;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,WAAW,CAAC,KAAoB,EAAE,MAAc;IAC9D,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAClF,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,OAAO,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClG,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/host/src/drivers/registry.d.ts

@@ -0,0 +1,21 @@
+import type { AgentDriver } from "./types.js";
+import { type AcpAgentSpec } from "./acp/driver.js";
+/**
+ * ACP agents LinkShell drives generically. Launch commands are the ones each
+ * CLI documents for its ACP server mode; agents that aren't installed are
+ * listed as such. Tier "remote": the phone gets full control, the desktop uses
+ * LinkShell's own UI rather than the agent's TUI.
+ */
+export declare const ACP_AGENTS: AcpAgentSpec[];
+export interface DefaultDriverOptions {
+    env?: NodeJS.ProcessEnv;
+    hostVersion: string;
+    codexSocket: string;
+    codexCommand?: string;
+    claudeCommand?: string;
+    claudeAdapter?: {
+        command: string;
+        args: string[];
+    };
+}
+export declare function defaultDrivers(options: DefaultDriverOptions): AgentDriver[];

package/dist/host/src/drivers/registry.js

@@ -0,0 +1,30 @@
+import { AcpDriver } from "./acp/driver.js";
+import { ClaudeDriver } from "./claude/driver.js";
+import { CodexDriver } from "./codex/driver.js";
+/**
+ * ACP agents LinkShell drives generically. Launch commands are the ones each
+ * CLI documents for its ACP server mode; agents that aren't installed are
+ * listed as such. Tier "remote": the phone gets full control, the desktop uses
+ * LinkShell's own UI rather than the agent's TUI.
+ */
+export const ACP_AGENTS = [
+    { id: "gemini", label: "Gemini", tier: "remote", command: "gemini", args: ["--acp"] },
+    // Lists sessions over ACP (including ones made in its own CLI).
+    { id: "copilot", label: "Copilot", tier: "remote", command: "copilot", args: ["--acp"], discover: true },
+    { id: "grok", label: "Grok", tier: "remote", command: "grok", args: ["agent", "stdio"], discover: true },
+    { id: "opencode", label: "OpenCode", tier: "remote", command: "opencode", args: ["acp"] },
+    { id: "cursor", label: "Cursor", tier: "remote", command: "cursor-agent", args: ["acp"] },
+];
+export function defaultDrivers(options) {
+    return [
+        new CodexDriver({ socketPath: options.codexSocket, command: options.codexCommand, env: options.env, hostVersion: options.hostVersion }),
+        new ClaudeDriver({
+            env: options.env,
+            hostVersion: options.hostVersion,
+            claudeCommand: options.claudeCommand,
+            adapter: options.claudeAdapter,
+        }),
+        ...ACP_AGENTS.map((spec) => new AcpDriver(spec, { env: options.env, hostVersion: options.hostVersion })),
+    ];
+}
+//# sourceMappingURL=registry.js.map

package/dist/host/src/drivers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../../host/src/drivers/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAqB,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAmB;IACxC,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE;IACrF,gEAAgE;IAChE,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE;IACxG,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE;IACxG,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE;IACzF,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE;CAC1F,CAAC;AAWF,MAAM,UAAU,cAAc,CAAC,OAA6B;IAC1D,OAAO;QACL,IAAI,WAAW,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,YAAY,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;QACvI,IAAI,YAAY,CAAC;YACf,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,OAAO,EAAE,OAAO,CAAC,aAAa;SAC/B,CAAC;QACF,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;KACzG,CAAC;AACJ,CAAC"}

package/dist/host/src/drivers/types.d.ts

@@ -0,0 +1,105 @@
+import type { AgentAuth, AgentCapabilities, AgentTier, ContentBlock, SessionState, SessionUpdate } from "@linkshell/wire";
+/** A session the agent knows about, however it was created. */
+export interface DiscoveredSession {
+    nativeId: string;
+    cwd: string;
+    title?: string;
+    preview?: string;
+    model?: string;
+    createdAt: number;
+    updatedAt: number;
+    state?: SessionState;
+}
+/**
+ * One completed item of native history (a message, a tool call, …) expressed as
+ * the updates that reproduce it. `itemId` lets the host skip items it already
+ * logged, so re-attaching after a restart only appends what is new.
+ */
+export interface HistoryItem {
+    itemId: string;
+    updates: SessionUpdate[];
+    /** When it happened (ms), if the agent's history records it. */
+    ts?: number;
+}
+/** Callbacks a driver uses to report to the host. */
+export interface DriverHost {
+    /** A session was created or changed outside of any client request (e.g. in the desktop TUI). */
+    sessionSeen(agent: string, session: DiscoveredSession): void;
+    /** A live update for an attached session. `itemId` marks the native item it completes, if any. */
+    update(agent: string, nativeId: string, update: SessionUpdate, itemId?: string): void;
+    /** Asks the host to attach (import history, then follow live) — e.g. a thread the TUI just opened. */
+    follow(agent: string, nativeId: string): Promise<void>;
+    /** The driver lost its live connection to a session; the host re-attaches on next use. */
+    detached(agent: string, nativeId: string): void;
+    /** The terminal currently driving a handoff session, if any. */
+    desktop(agent: string, nativeId: string): DesktopController | undefined;
+    /** Durable per-session values for the driver (survive host restarts). */
+    state(agent: string, nativeId: string): {
+        get(key: string): string | undefined;
+        set(key: string, value: string): void;
+    };
+    log(message: string): void;
+}
+export interface AttachContext {
+    cwd: string;
+}
+/** A terminal running an agent's native UI via `linkshell <agent>`. */
+export interface DesktopController {
+    /** Asks the terminal to exit its native UI; resolves once it has (or went away). */
+    yield(): Promise<void>;
+    /** Shows a line of remote progress in the terminal. */
+    activity(line: string): void;
+}
+export interface DesktopLaunchContext {
+    cwd?: string;
+    env?: Record<string, string>;
+}
+export interface DesktopLaunch extends LaunchSpec {
+    /** Handoff agents: the session the terminal now drives. */
+    nativeId?: string;
+    cwd?: string;
+}
+export interface DriverStatus {
+    installed: boolean;
+    version?: string;
+    problem?: string;
+}
+export interface LaunchSpec {
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+}
+export interface AgentDriver {
+    readonly id: string;
+    readonly label: string;
+    readonly tier: AgentTier;
+    readonly capabilities: AgentCapabilities;
+    start(host: DriverHost): Promise<DriverStatus>;
+    stop(): Promise<void>;
+    status(): DriverStatus;
+    /** The agent's own report of how it is logged in. Must not read or return secrets. */
+    authStatus?(): Promise<AgentAuth>;
+    listSessions(limit: number): Promise<DiscoveredSession[]>;
+    createSession(options: {
+        cwd: string;
+        model?: string;
+    }): Promise<DiscoveredSession>;
+    /**
+     * Starts live updates for a session and returns its full native history.
+     * Idempotent: attaching an attached session just returns the history again.
+     */
+    attach(nativeId: string, context: AttachContext): Promise<HistoryItem[]>;
+    detach(nativeId: string): Promise<void>;
+    prompt(nativeId: string, content: ContentBlock[], clientMessageId: string): Promise<"started" | "steered" | "queued">;
+    cancel(nativeId: string): Promise<void>;
+    respondPermission(nativeId: string, requestId: string, optionId: string): Promise<void>;
+    setConfig?(nativeId: string, optionId: string, value: string): Promise<void>;
+    /** How a desktop terminal launches this agent's native UI attached to the host. */
+    desktopLaunch?(args: string[], nativeId: string | undefined, context: DesktopLaunchContext): DesktopLaunch | Promise<DesktopLaunch>;
+    /** Handoff agents: a device takes the session over from the desktop. */
+    takeover?(nativeId: string): Promise<void>;
+    /** Handoff agents: the terminal driving the session disconnected (its native UI exited). */
+    desktopDetached?(nativeId: string): void;
+    /** Handoff agents: the desktop takes the session back; returns how to relaunch the native UI. */
+    reclaim?(nativeId: string, context: DesktopLaunchContext): Promise<LaunchSpec>;
+}

package/dist/host/src/drivers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/host/src/drivers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../host/src/drivers/types.ts"],"names":[],"mappings":""}

package/dist/host/src/fs.d.ts

@@ -0,0 +1,69 @@
+export declare function listDirectory(input: {
+    path?: string;
+    hidden: boolean;
+}): Promise<{
+    path: string;
+    parent: string | undefined;
+    home: string;
+    entries: {
+        path: string;
+        name: string;
+        project?: boolean | undefined;
+    }[];
+}>;
+/**
+ * Breadth-first under the home directory, a few levels deep, within a time
+ * budget: good enough to find "claude-remote" or "rtranslate" by typing.
+ */
+export declare function searchDirectories(input: {
+    query: string;
+    limit: number;
+}, budgetMs?: number): Promise<{
+    entries: {
+        path: string;
+        name: string;
+        project?: boolean | undefined;
+    }[];
+    truncated: boolean;
+}>;
+/** Reads a file for the phone's viewer. Text is detected by content, not extension. */
+export declare function readFile(input: {
+    path: string;
+    maxBytes: number;
+}): Promise<{
+    kind: "image";
+    data: string;
+    mimeType: string;
+    path: string;
+    size: number;
+    modifiedAt: number;
+    truncated: boolean;
+} | {
+    kind: "binary";
+    path: string;
+    size: number;
+    modifiedAt: number;
+    truncated: boolean;
+} | {
+    kind: "text";
+    text: string;
+    path: string;
+    size: number;
+    modifiedAt: number;
+    truncated: boolean;
+}>;
+/** Writes an uploaded file into `dir`, never over an existing one. */
+export declare function uploadFile(input: {
+    dir: string;
+    name: string;
+    data: string;
+}): Promise<{
+    path: string;
+    size: number;
+}>;
+export declare function makeDirectory(input: {
+    parent: string;
+    name: string;
+}): Promise<{
+    path: string;
+}>;