@linkshell/wire 0.2.7 → 0.2.9

package/README.md

@@ -5,7 +5,13 @@ The LinkShell v2 wire protocol, shared by the host, the relay and the apps:
 - the session model and ACP-shaped session updates, including Claude Workflow phases and Agent progress,
 - JSON-RPC methods and notifications between devices and a computer,
 - end-to-end encryption (Ed25519 identities, X25519 channel keys, XChaCha20-Poly1305),
-- the relay frames and a relay client for Node and React Native.
+- the relay frames and a relay client for Node and React Native,
+- the direct bulk-stream framing used by `proxy.*` when a WebRTC DataChannel is available.
+
+The bulk channel is separate from the Mac screen's native WebRTC video connection. Screen
+SDP/ICE is forwarded by the host viewer service; media and its four input/cursor channels use
+libwebrtc between LinkShell.app and the receiver. See the
+[screen architecture](../../docs/v2/screen-realtime.md) for both paths and RPC fallback.
 
 Most people want the CLI instead: `npm install -g linkshell-cli`.
 

package/dist/acp.d.ts

@@ -0,0 +1,510 @@
+import { z } from "zod";
+export declare const mcpServerSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"stdio">;
+    name: z.ZodString;
+    command: z.ZodString;
+    args: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    type: "stdio";
+    name: string;
+    command: string;
+    args: string[];
+    env: Record<string, string>;
+}, {
+    type: "stdio";
+    name: string;
+    command: string;
+    args?: string[] | undefined;
+    env?: Record<string, string> | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"http">;
+    name: z.ZodString;
+    url: z.ZodString;
+    headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    type: "http";
+    name: string;
+    url: string;
+    headers: Record<string, string>;
+}, {
+    type: "http";
+    name: string;
+    url: string;
+    headers?: Record<string, string> | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"sse">;
+    name: z.ZodString;
+    url: z.ZodString;
+    headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    type: "sse";
+    name: string;
+    url: string;
+    headers: Record<string, string>;
+}, {
+    type: "sse";
+    name: string;
+    url: string;
+    headers?: Record<string, string> | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"acp">;
+    name: z.ZodString;
+    command: z.ZodString;
+    args: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    type: "acp";
+    name: string;
+    command: string;
+    args: string[];
+    env: Record<string, string>;
+}, {
+    type: "acp";
+    name: string;
+    command: string;
+    args?: string[] | undefined;
+    env?: Record<string, string> | undefined;
+}>]>;
+export type AcpMcpServer = z.infer<typeof mcpServerSchema>;
+/** Session tool configuration is persisted on the host, outside the transcript. */
+export declare const acpAgentSettingsSchema: z.ZodObject<{
+    protocolVersion: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+    experimental: z.ZodDefault<z.ZodBoolean>;
+    mcpServers: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"stdio">;
+        name: z.ZodString;
+        command: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "stdio";
+        name: string;
+        command: string;
+        args: string[];
+        env: Record<string, string>;
+    }, {
+        type: "stdio";
+        name: string;
+        command: string;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"http">;
+        name: z.ZodString;
+        url: z.ZodString;
+        headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "http";
+        name: string;
+        url: string;
+        headers: Record<string, string>;
+    }, {
+        type: "http";
+        name: string;
+        url: string;
+        headers?: Record<string, string> | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"sse">;
+        name: z.ZodString;
+        url: z.ZodString;
+        headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "sse";
+        name: string;
+        url: string;
+        headers: Record<string, string>;
+    }, {
+        type: "sse";
+        name: string;
+        url: string;
+        headers?: Record<string, string> | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"acp">;
+        name: z.ZodString;
+        command: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "acp";
+        name: string;
+        command: string;
+        args: string[];
+        env: Record<string, string>;
+    }, {
+        type: "acp";
+        name: string;
+        command: string;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    }>]>, "many">>;
+    additionalDirectories: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    protocolVersion: 1 | 2;
+    experimental: boolean;
+    mcpServers: ({
+        type: "stdio";
+        name: string;
+        command: string;
+        args: string[];
+        env: Record<string, string>;
+    } | {
+        type: "http";
+        name: string;
+        url: string;
+        headers: Record<string, string>;
+    } | {
+        type: "sse";
+        name: string;
+        url: string;
+        headers: Record<string, string>;
+    } | {
+        type: "acp";
+        name: string;
+        command: string;
+        args: string[];
+        env: Record<string, string>;
+    })[];
+    additionalDirectories: string[];
+}, {
+    protocolVersion?: 1 | 2 | undefined;
+    experimental?: boolean | undefined;
+    mcpServers?: ({
+        type: "stdio";
+        name: string;
+        command: string;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    } | {
+        type: "http";
+        name: string;
+        url: string;
+        headers?: Record<string, string> | undefined;
+    } | {
+        type: "sse";
+        name: string;
+        url: string;
+        headers?: Record<string, string> | undefined;
+    } | {
+        type: "acp";
+        name: string;
+        command: string;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    })[] | undefined;
+    additionalDirectories?: string[] | undefined;
+}>;
+export type AcpAgentSettings = z.infer<typeof acpAgentSettingsSchema>;
+export declare const acpRemoteAgentSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    transport: z.ZodEnum<["stdio", "http", "websocket"]>;
+    command: z.ZodOptional<z.ZodString>;
+    args: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    url: z.ZodOptional<z.ZodString>;
+    /** Header name to environment-variable name. The UI does not store secrets. */
+    headerEnv: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    settings: z.ZodDefault<z.ZodObject<{
+        protocolVersion: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+        experimental: z.ZodDefault<z.ZodBoolean>;
+        mcpServers: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"stdio">;
+            name: z.ZodString;
+            command: z.ZodString;
+            args: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "stdio";
+            name: string;
+            command: string;
+            args: string[];
+            env: Record<string, string>;
+        }, {
+            type: "stdio";
+            name: string;
+            command: string;
+            args?: string[] | undefined;
+            env?: Record<string, string> | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"http">;
+            name: z.ZodString;
+            url: z.ZodString;
+            headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "http";
+            name: string;
+            url: string;
+            headers: Record<string, string>;
+        }, {
+            type: "http";
+            name: string;
+            url: string;
+            headers?: Record<string, string> | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"sse">;
+            name: z.ZodString;
+            url: z.ZodString;
+            headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "sse";
+            name: string;
+            url: string;
+            headers: Record<string, string>;
+        }, {
+            type: "sse";
+            name: string;
+            url: string;
+            headers?: Record<string, string> | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"acp">;
+            name: z.ZodString;
+            command: z.ZodString;
+            args: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "acp";
+            name: string;
+            command: string;
+            args: string[];
+            env: Record<string, string>;
+        }, {
+            type: "acp";
+            name: string;
+            command: string;
+            args?: string[] | undefined;
+            env?: Record<string, string> | undefined;
+        }>]>, "many">>;
+        additionalDirectories: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        protocolVersion: 1 | 2;
+        experimental: boolean;
+        mcpServers: ({
+            type: "stdio";
+            name: string;
+            command: string;
+            args: string[];
+            env: Record<string, string>;
+        } | {
+            type: "http";
+            name: string;
+            url: string;
+            headers: Record<string, string>;
+        } | {
+            type: "sse";
+            name: string;
+            url: string;
+            headers: Record<string, string>;
+        } | {
+            type: "acp";
+            name: string;
+            command: string;
+            args: string[];
+            env: Record<string, string>;
+        })[];
+        additionalDirectories: string[];
+    }, {
+        protocolVersion?: 1 | 2 | undefined;
+        experimental?: boolean | undefined;
+        mcpServers?: ({
+            type: "stdio";
+            name: string;
+            command: string;
+            args?: string[] | undefined;
+            env?: Record<string, string> | undefined;
+        } | {
+            type: "http";
+            name: string;
+            url: string;
+            headers?: Record<string, string> | undefined;
+        } | {
+            type: "sse";
+            name: string;
+            url: string;
+            headers?: Record<string, string> | undefined;
+        } | {
+            type: "acp";
+            name: string;
+            command: string;
+            args?: string[] | undefined;
+            env?: Record<string, string> | undefined;
+        })[] | undefined;
+        additionalDirectories?: string[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    args: string[];
+    id: string;
+    label: string;
+    transport: "stdio" | "http" | "websocket";
+    headerEnv: Record<string, string>;
+    settings: {
+        protocolVersion: 1 | 2;
+        experimental: boolean;
+        mcpServers: ({
+            type: "stdio";
+            name: string;
+            command: string;
+            args: string[];
+            env: Record<string, string>;
+        } | {
+            type: "http";
+            name: string;
+            url: string;
+            headers: Record<string, string>;
+        } | {
+            type: "sse";
+            name: string;
+            url: string;
+            headers: Record<string, string>;
+        } | {
+            type: "acp";
+            name: string;
+            command: string;
+            args: string[];
+            env: Record<string, string>;
+        })[];
+        additionalDirectories: string[];
+    };
+    command?: string | undefined;
+    url?: string | undefined;
+}, {
+    id: string;
+    label: string;
+    transport: "stdio" | "http" | "websocket";
+    command?: string | undefined;
+    args?: string[] | undefined;
+    url?: string | undefined;
+    headerEnv?: Record<string, string> | undefined;
+    settings?: {
+        protocolVersion?: 1 | 2 | undefined;
+        experimental?: boolean | undefined;
+        mcpServers?: ({
+            type: "stdio";
+            name: string;
+            command: string;
+            args?: string[] | undefined;
+            env?: Record<string, string> | undefined;
+        } | {
+            type: "http";
+            name: string;
+            url: string;
+            headers?: Record<string, string> | undefined;
+        } | {
+            type: "sse";
+            name: string;
+            url: string;
+            headers?: Record<string, string> | undefined;
+        } | {
+            type: "acp";
+            name: string;
+            command: string;
+            args?: string[] | undefined;
+            env?: Record<string, string> | undefined;
+        })[] | undefined;
+        additionalDirectories?: string[] | undefined;
+    } | undefined;
+}>;
+export type AcpRemoteAgent = z.infer<typeof acpRemoteAgentSchema>;
+export declare const acpAuthMethodSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    type: z.ZodEnum<["agent", "terminal"]>;
+}, "strip", z.ZodTypeAny, {
+    type: "agent" | "terminal";
+    name: string;
+    id: string;
+    description?: string | undefined;
+}, {
+    type: "agent" | "terminal";
+    name: string;
+    id: string;
+    description?: string | undefined;
+}>;
+export declare const acpFeaturesSchema: z.ZodObject<{
+    protocolVersion: z.ZodNumber;
+    authMethods: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        type: z.ZodEnum<["agent", "terminal"]>;
+    }, "strip", z.ZodTypeAny, {
+        type: "agent" | "terminal";
+        name: string;
+        id: string;
+        description?: string | undefined;
+    }, {
+        type: "agent" | "terminal";
+        name: string;
+        id: string;
+        description?: string | undefined;
+    }>, "many">;
+    logout: z.ZodBoolean;
+    providers: z.ZodBoolean;
+    nes: z.ZodBoolean;
+    additionalDirectories: z.ZodBoolean;
+    mcpHttp: z.ZodBoolean;
+    mcpSse: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    protocolVersion: number;
+    additionalDirectories: boolean;
+    authMethods: {
+        type: "agent" | "terminal";
+        name: string;
+        id: string;
+        description?: string | undefined;
+    }[];
+    logout: boolean;
+    providers: boolean;
+    nes: boolean;
+    mcpHttp: boolean;
+    mcpSse: boolean;
+}, {
+    protocolVersion: number;
+    additionalDirectories: boolean;
+    authMethods: {
+        type: "agent" | "terminal";
+        name: string;
+        id: string;
+        description?: string | undefined;
+    }[];
+    logout: boolean;
+    providers: boolean;
+    nes: boolean;
+    mcpHttp: boolean;
+    mcpSse: boolean;
+}>;
+export type AcpFeatures = z.infer<typeof acpFeaturesSchema>;
+export declare const acpProviderSchema: z.ZodObject<{
+    providerId: z.ZodString;
+    supported: z.ZodArray<z.ZodString, "many">;
+    required: z.ZodBoolean;
+    current: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        apiType: z.ZodString;
+        baseUrl: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        apiType: string;
+        baseUrl: string;
+    }, {
+        apiType: string;
+        baseUrl: string;
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    providerId: string;
+    supported: string[];
+    required: boolean;
+    current?: {
+        apiType: string;
+        baseUrl: string;
+    } | null | undefined;
+}, {
+    providerId: string;
+    supported: string[];
+    required: boolean;
+    current?: {
+        apiType: string;
+        baseUrl: string;
+    } | null | undefined;
+}>;
+export type AcpProvider = z.infer<typeof acpProviderSchema>;
+/** Editor payloads follow ACP's versioned schema; the host validates before forwarding. */
+export declare const acpEditorOperationSchema: z.ZodEnum<["nes/start", "nes/suggest", "nes/close", "nes/accept", "nes/reject", "document/didOpen", "document/didChange", "document/didClose", "document/didSave", "document/didFocus"]>;

package/dist/acp.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+const env = z.record(z.string());
+export const mcpServerSchema = z.discriminatedUnion("type", [
+    z.object({ type: z.literal("stdio"), name: z.string().min(1), command: z.string().min(1), args: z.array(z.string()).default([]), env: env.default({}) }),
+    z.object({ type: z.literal("http"), name: z.string().min(1), url: z.string().url(), headers: env.default({}) }),
+    z.object({ type: z.literal("sse"), name: z.string().min(1), url: z.string().url(), headers: env.default({}) }),
+    z.object({ type: z.literal("acp"), name: z.string().min(1), command: z.string().min(1), args: z.array(z.string()).default([]), env: env.default({}) }),
+]);
+/** Session tool configuration is persisted on the host, outside the transcript. */
+export const acpAgentSettingsSchema = z.object({
+    protocolVersion: z.union([z.literal(1), z.literal(2)]).default(1),
+    experimental: z.boolean().default(true),
+    mcpServers: z.array(mcpServerSchema).max(32).default([]),
+    additionalDirectories: z.array(z.string().min(1)).max(32).default([]),
+});
+export const acpRemoteAgentSchema = z.object({
+    id: z.string().regex(/^[a-z][a-z0-9_-]{0,63}$/),
+    label: z.string().min(1).max(80),
+    transport: z.enum(["stdio", "http", "websocket"]),
+    command: z.string().optional(), args: z.array(z.string()).default([]),
+    url: z.string().url().optional(),
+    /** Header name to environment-variable name. The UI does not store secrets. */
+    headerEnv: env.default({}),
+    settings: acpAgentSettingsSchema.default({}),
+});
+export const acpAuthMethodSchema = z.object({ id: z.string(), name: z.string(), description: z.string().optional(), type: z.enum(["agent", "terminal"]) });
+export const acpFeaturesSchema = z.object({
+    protocolVersion: z.number(),
+    authMethods: z.array(acpAuthMethodSchema),
+    logout: z.boolean(), providers: z.boolean(), nes: z.boolean(),
+    additionalDirectories: z.boolean(), mcpHttp: z.boolean(), mcpSse: z.boolean(),
+});
+export const acpProviderSchema = z.object({
+    providerId: z.string(), supported: z.array(z.string()), required: z.boolean(),
+    current: z.object({ apiType: z.string(), baseUrl: z.string() }).nullish(),
+});
+/** Editor payloads follow ACP's versioned schema; the host validates before forwarding. */
+export const acpEditorOperationSchema = z.enum(["nes/start", "nes/suggest", "nes/close", "nes/accept", "nes/reject", "document/didOpen", "document/didChange", "document/didClose", "document/didSave", "document/didFocus"]);
+//# sourceMappingURL=acp.js.map

package/dist/acp.js.map

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

package/dist/async-questions.d.ts

@@ -0,0 +1,40 @@
+import { z } from "zod";
+import type { SessionUpdate } from "./updates.js";
+/** A question an agent's message asks without stopping its turn; `id` is what the answer quotes. */
+export declare const asyncQuestionSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    options: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    options: string[];
+    id: string;
+    title: string;
+}, {
+    options: string[];
+    id: string;
+    title: string;
+}>;
+export type AsyncQuestion = z.infer<typeof asyncQuestionSchema>;
+/**
+ * The message that answers async questions, as Codex Desktop writes it: the
+ * agent reads it as the answer, and Desktop (and this app) shows it as one.
+ */
+export declare function asyncQuestionReply(answers: {
+    question: AsyncQuestion;
+    answer: string;
+}[]): string;
+export interface QuestionReply {
+    /** The question's id, where the reply names it. */
+    id?: string;
+    question: string;
+    answer: string;
+}
+/**
+ * The answers in a reply to async questions, as Codex Desktop writes one (and shows it: each question with
+ * its answer). Anything that isn't exactly the envelope is not a reply.
+ */
+export declare function questionReplies(text: string): QuestionReply[] | undefined;
+/** What a message answers, by question id, if it is such a reply. */
+export declare function answeredQuestions(text: string): [id: string, answer: string][];
+/** Keeps attention separate from running: async questions do not stop the agent. */
+export declare function updateAsyncQuestions(pending: AsyncQuestion[], update: SessionUpdate): AsyncQuestion[];

package/dist/async-questions.js

@@ -0,0 +1,66 @@
+import { z } from "zod";
+/** A question an agent's message asks without stopping its turn; `id` is what the answer quotes. */
+export const asyncQuestionSchema = z.object({ id: z.string(), title: z.string(), options: z.array(z.string()) });
+/**
+ * The message that answers async questions, as Codex Desktop writes it: the
+ * agent reads it as the answer, and Desktop (and this app) shows it as one.
+ */
+export function asyncQuestionReply(answers) {
+    const entries = answers.map(({ question, answer }) => ({ questionItemId: question.id, question: question.title, answer }));
+    return `<send_user_message_question_reply>\n${JSON.stringify(entries)}\n</send_user_message_question_reply>\n`;
+}
+/**
+ * The answers in a reply to async questions, as Codex Desktop writes one (and shows it: each question with
+ * its answer). Anything that isn't exactly the envelope is not a reply.
+ */
+export function questionReplies(text) {
+    const match = /^<send_user_message_question_reply>\s*([\s\S]+?)\s*<\/send_user_message_question_reply>$/.exec(text.replace(/\r\n/g, "\n").trim());
+    if (!match)
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(match[1]);
+    }
+    catch {
+        return undefined;
+    }
+    const entries = Array.isArray(parsed) ? parsed : [parsed];
+    if (entries.length === 0)
+        return undefined;
+    const replies = [];
+    for (const entry of entries) {
+        if (!entry || typeof entry !== "object")
+            return undefined;
+        const { questionItemId, question, answer } = entry;
+        if (typeof question !== "string" || typeof answer !== "string")
+            return undefined;
+        replies.push({ ...(typeof questionItemId === "string" ? { id: questionItemId } : {}), question: question.trim(), answer: answer.trim() });
+    }
+    return replies;
+}
+/** What a message answers, by question id, if it is such a reply. */
+export function answeredQuestions(text) {
+    return (questionReplies(text) ?? []).flatMap((reply) => (reply.id ? [[reply.id, reply.answer]] : []));
+}
+/** Keeps attention separate from running: async questions do not stop the agent. */
+export function updateAsyncQuestions(pending, update) {
+    if ("parentToolCallId" in update && update.parentToolCallId)
+        return pending;
+    if (update.sessionUpdate === "ls_async_questions")
+        return update.questions;
+    if (update.sessionUpdate === "ls_turn")
+        return [];
+    if (update.sessionUpdate === "ls_message_done" && update.role === "agent" && update.questions?.length) {
+        const merged = new Map(pending.map((question) => [question.id, question]));
+        for (const question of update.questions)
+            merged.set(question.id, question);
+        return [...merged.values()];
+    }
+    if (update.sessionUpdate === "user_message_chunk" && update.content.type === "text") {
+        const answered = new Set(answeredQuestions(update.content.text).map(([id]) => id));
+        if (answered.size)
+            return pending.filter((question) => !answered.has(question.id));
+    }
+    return pending;
+}
+//# sourceMappingURL=async-questions.js.map

package/dist/async-questions.js.map

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