@turingfocus/chat-gateway-tfrobot 0.6.0 → 0.8.0

package/dist/outbound-message.d.ts

@@ -0,0 +1,7 @@
+import type { SendMessageInput } from "@turingfocus/chat-protocol";
+import type { TFRobotMessageCreator } from "./types.js";
+type TFRobotMessage = Readonly<Record<string, unknown>>;
+/** Maps one normalized user turn to the currently verified TFRobot DTO. */
+export declare const buildTFRobotOutboundMessage: (input: SendMessageInput, creator: TFRobotMessageCreator, conversationId: number | string) => TFRobotMessage;
+export {};
+//# sourceMappingURL=outbound-message.d.ts.map

package/dist/outbound-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-message.d.ts","sourceRoot":"","sources":["../src/outbound-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAEjB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,KAAK,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAyCxD,2EAA2E;AAC3E,eAAO,MAAM,2BAA2B,GACtC,OAAO,gBAAgB,EACvB,SAAS,qBAAqB,EAC9B,gBAAgB,MAAM,GAAG,MAAM,KAC9B,cAuDF,CAAC"}

package/dist/outbound-message.js

@@ -0,0 +1,91 @@
+const mediaKind = (attachment) => {
+    const mime = attachment.mimeType.toLowerCase();
+    if (mime.startsWith("image/"))
+        return "image";
+    if (mime.startsWith("video/"))
+        return "video";
+    if (mime.startsWith("audio/"))
+        return "audio";
+    return mime === "application/pdf" ? "pdf" : undefined;
+};
+const baseMessage = (creator, conversationId) => ({
+    additionalKwargs: {},
+    attachments: null,
+    createTimestamp: 0,
+    creator,
+    conversationId,
+    role: "user",
+});
+const mediaPart = (attachment, kind) => {
+    const media = {
+        url: attachment.uri,
+        mimeType: attachment.mimeType,
+        ...(attachment.name === undefined ? {} : { name: attachment.name }),
+    };
+    switch (kind) {
+        case "image":
+            return { partType: "image_url", imageUrl: media };
+        case "video":
+            return { partType: "video_url", videoUrl: media };
+        case "audio":
+            return { partType: "audio_url", audioUrl: media };
+        case "pdf":
+            return { partType: "pdf_url", pdfUrl: media };
+    }
+};
+/** Maps one normalized user turn to the currently verified TFRobot DTO. */
+export const buildTFRobotOutboundMessage = (input, creator, conversationId) => {
+    const base = baseMessage(creator, conversationId);
+    const text = input.text ?? "";
+    const attachments = input.attachments ?? [];
+    const media = attachments.flatMap((attachment) => {
+        const kind = mediaKind(attachment);
+        return kind === undefined ? [] : [{ attachment, kind }];
+    });
+    const generic = attachments.filter((attachment) => mediaKind(attachment) === undefined);
+    const messages = [];
+    if (media.length > 0 && (text.length > 0 || media.length > 1)) {
+        messages.push({
+            ...base,
+            msgType: "multipart",
+            content: [
+                ...(text.length === 0 ? [] : [{ partType: "text", text }]),
+                ...media.map(({ attachment, kind }) => mediaPart(attachment, kind)),
+            ],
+        });
+    }
+    else {
+        for (const { attachment, kind } of media) {
+            messages.push({
+                ...base,
+                msgType: kind === "pdf" ? "file" : kind,
+                content: attachment.uri,
+                ...(kind === "image"
+                    ? {
+                        additionalKwargs: {
+                            mimeType: attachment.mimeType,
+                            ...(attachment.name === undefined
+                                ? {}
+                                : { altText: attachment.name }),
+                        },
+                    }
+                    : {}),
+            });
+        }
+        if (text.length > 0) {
+            messages.push({ ...base, msgType: "text", content: text });
+        }
+    }
+    for (const attachment of generic) {
+        messages.push({ ...base, msgType: "file", content: attachment.uri });
+    }
+    if (messages.length === 1)
+        return messages[0];
+    return {
+        ...base,
+        msgType: "history",
+        historyPrefix: "",
+        content: messages,
+    };
+};
+//# sourceMappingURL=outbound-message.js.map

package/dist/outbound-message.js.map

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

package/dist/presentation.d.ts

@@ -0,0 +1,5 @@
+import { type ToolAttachment, type ToolPresentation } from "@turingfocus/chat-protocol";
+/** Transformed display data never changes the existing origin/result field. */
+export declare function mapToolPresentation(toolReturn: Record<string, unknown>): ToolPresentation | undefined;
+export declare function mapToolAttachments(value: unknown): readonly ToolAttachment[];
+//# sourceMappingURL=presentation.d.ts.map

package/dist/presentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation.d.ts","sourceRoot":"","sources":["../src/presentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACtB,MAAM,4BAA4B,CAAC;AAiFpC,+EAA+E;AAC/E,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,gBAAgB,GAAG,SAAS,CAM9B;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,cAAc,EAAE,CAoB5E"}

package/dist/presentation.js

@@ -0,0 +1,102 @@
+import { toolAttachmentSchema, toolPresentationSchema, } from "@turingfocus/chat-protocol";
+const record = (value) => value !== null && typeof value === "object" && !Array.isArray(value)
+    ? value
+    : undefined;
+const string = (value) => typeof value === "string" ? value : undefined;
+const decode = (value) => {
+    if (typeof value !== "string")
+        return value;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return undefined;
+    }
+};
+function presentation(value) {
+    const data = record(decode(value));
+    if (data === undefined)
+        return undefined;
+    const content = string(data["content"]);
+    const url = string(data["url"]);
+    const language = string(data["language"]);
+    let candidate;
+    if (typeof data["original"] === "string" &&
+        typeof data["modified"] === "string") {
+        candidate = {
+            kind: "editor",
+            original: data["original"],
+            modified: data["modified"],
+            language,
+        };
+    }
+    else if (["command", "username", "hostname"].some((key) => key in data) &&
+        (content !== undefined ||
+            ["command", "username", "hostname"].some((key) => typeof data[key] === "string"))) {
+        candidate = {
+            kind: "shell",
+            output: content ?? "",
+            command: string(data["command"]),
+            username: string(data["username"]),
+            hostname: string(data["hostname"]),
+            path: string(data["path"]),
+        };
+    }
+    else if (content !== undefined && "language" in data) {
+        candidate = { kind: "preview", code: content, language };
+    }
+    else if (url !== undefined ||
+        typeof data["image"] === "string" ||
+        content !== undefined) {
+        const downloadable = url !== undefined &&
+            /\.(?:pdf|zip|xlsx?|docx?|csv|txt|mp[34]|wav|webm)(?:[?#]|$)/i.test(url);
+        candidate = downloadable
+            ? {
+                kind: "download",
+                resource: {
+                    uri: url,
+                    name: string(data["filename"]) ?? string(data["name"]),
+                },
+            }
+            : {
+                kind: "browser",
+                url,
+                markdown: content,
+                image: typeof data["image"] === "string"
+                    ? { uri: data["image"] }
+                    : undefined,
+            };
+    }
+    const result = toolPresentationSchema.safeParse(candidate);
+    return result.success ? result.data : undefined;
+}
+/** Transformed display data never changes the existing origin/result field. */
+export function mapToolPresentation(toolReturn) {
+    const mcp = record(record(toolReturn["meta"])?.["__MCP__"]);
+    return (presentation(mcp?.["a2c_vrl_transformed"]) ??
+        presentation(toolReturn["origin"]));
+}
+export function mapToolAttachments(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.slice(0, 100).flatMap((item) => {
+        const data = record(item);
+        if (data === undefined)
+            return [];
+        const mimeType = string(data["mimeType"]);
+        const category = string(data["category"]) ?? mimeType?.split("/")[0];
+        const result = toolAttachmentSchema.safeParse({
+            kind: ["image", "audio", "video", "file"].includes(category ?? "")
+                ? category
+                : "unknown",
+            resource: {
+                uri: data["attachment"],
+                mimeType,
+                name: string(data["name"]),
+                size: data["size"],
+            },
+        });
+        return result.success ? [result.data] : [];
+    });
+}
+//# sourceMappingURL=presentation.js.map

package/dist/presentation.js.map

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

package/dist/redaction.d.ts

@@ -1,5 +1,9 @@
 import { type ChatError, type ReadonlyJsonValue } from "@turingfocus/chat-protocol";
+export declare class TransportPayloadError extends TypeError {
+}
 export declare const sanitizeCredentialText: (input: string, credentialValues: Iterable<string>) => string;
 export declare const sanitizeCredentialRaw: (value: unknown, credentialValues: Iterable<string>) => ReadonlyJsonValue;
+/** Redacts transport JSON before mapping, without diagnostic string/total limits. */
+export declare const sanitizeCredentialPayload: (input: unknown, credentialValues: Iterable<string>) => ReadonlyJsonValue;
 export declare const sanitizeCredentialError: (error: ChatError, credentialValues: Iterable<string>) => ChatError;
 //# sourceMappingURL=redaction.d.ts.map

package/dist/redaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redaction.d.ts","sourceRoot":"","sources":["../src/redaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AAIpC,eAAO,MAAM,sBAAsB,GACjC,OAAO,MAAM,EACb,kBAAkB,QAAQ,CAAC,MAAM,CAAC,KACjC,MASF,CAAC;AA6BF,eAAO,MAAM,qBAAqB,GAChC,OAAO,OAAO,EACd,kBAAkB,QAAQ,CAAC,MAAM,CAAC,KACjC,iBAA0E,CAAC;AAE9E,eAAO,MAAM,uBAAuB,GAClC,OAAO,SAAS,EAChB,kBAAkB,QAAQ,CAAC,MAAM,CAAC,KACjC,SAcD,CAAC"}
+{"version":3,"file":"redaction.d.ts","sourceRoot":"","sources":["../src/redaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AASpC,qBAAa,qBAAsB,SAAQ,SAAS;CAAG;AAEvD,eAAO,MAAM,sBAAsB,GACjC,OAAO,MAAM,EACb,kBAAkB,QAAQ,CAAC,MAAM,CAAC,KACjC,MASF,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,OAAO,OAAO,EACd,kBAAkB,QAAQ,CAAC,MAAM,CAAC,KACjC,iBAC8D,CAAC;AAElE,qFAAqF;AACrF,eAAO,MAAM,yBAAyB,GACpC,OAAO,OAAO,EACd,kBAAkB,QAAQ,CAAC,MAAM,CAAC,KACjC,iBAmFF,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,OAAO,SAAS,EAChB,kBAAkB,QAAQ,CAAC,MAAM,CAAC,KACjC,SAcD,CAAC"}

package/dist/redaction.js

@@ -1,5 +1,11 @@
-import { sanitizeDiagnosticText, sanitizeRaw, } from "@turingfocus/chat-protocol";
+import { isSensitiveRawKey, sanitizeDiagnosticText, sanitizeRaw, } from "@turingfocus/chat-protocol";
 const REDACTED_VALUE = "[REDACTED]";
+// Transport pages contain many independent model items. Their traversal guard
+// must not impose the diagnostic raw budget on the whole business response.
+const MAX_TRANSPORT_DEPTH = 64;
+const MAX_TRANSPORT_NODES = 100_000;
+export class TransportPayloadError extends TypeError {
+}
 export const sanitizeCredentialText = (input, credentialValues) => {
     let output = sanitizeDiagnosticText(input);
     const uniqueValues = [...new Set(credentialValues)]
@@ -10,30 +16,75 @@ export const sanitizeCredentialText = (input, credentialValues) => {
     }
     return output;
 };
-const redactJsonValue = (value, credentialValues) => {
-    if (typeof value === "string") {
-        return sanitizeCredentialText(value, credentialValues);
-    }
-    if (value === null || typeof value !== "object")
-        return value;
-    if (Array.isArray(value)) {
-        return Object.freeze(value.map((entry) => redactJsonValue(entry, credentialValues)));
-    }
-    const output = {};
-    for (const [key, entry] of Object.entries(value)) {
-        const safeKey = sanitizeCredentialText(key, credentialValues);
-        if (Object.hasOwn(output, safeKey))
-            continue;
-        Object.defineProperty(output, safeKey, {
-            configurable: false,
-            enumerable: true,
-            value: redactJsonValue(entry, credentialValues),
-            writable: false,
-        });
-    }
-    return Object.freeze(output);
+export const sanitizeCredentialRaw = (value, credentialValues) => sanitizeCredentialPayload(sanitizeRaw(value), credentialValues);
+/** Redacts transport JSON before mapping, without diagnostic string/total limits. */
+export const sanitizeCredentialPayload = (input, credentialValues) => {
+    const credentials = [...credentialValues];
+    const ancestors = new WeakSet();
+    let nodes = 0;
+    const visit = (value, depth) => {
+        nodes += 1;
+        if (nodes > MAX_TRANSPORT_NODES || depth > MAX_TRANSPORT_DEPTH) {
+            throw new TransportPayloadError("TFRobot payload exceeds transport structure limits (100000 nodes or depth 64)");
+        }
+        if (typeof value === "string") {
+            return sanitizeCredentialText(value, credentials);
+        }
+        if (value === null || typeof value === "boolean")
+            return value;
+        if (typeof value === "number" && Number.isFinite(value))
+            return value;
+        if (typeof value !== "object") {
+            throw new TransportPayloadError("TFRobot payload must contain valid JSON values");
+        }
+        if (ancestors.has(value)) {
+            throw new TransportPayloadError("TFRobot payload must not contain circular references");
+        }
+        ancestors.add(value);
+        try {
+            if (Array.isArray(value)) {
+                if (value.length > MAX_TRANSPORT_NODES - nodes) {
+                    throw new TransportPayloadError("TFRobot payload exceeds transport node limit (100000)");
+                }
+                const headerTuple = value.length === 2 &&
+                    typeof value[0] === "string" &&
+                    isSensitiveRawKey(value[0]);
+                const output = [];
+                for (let index = 0; index < value.length; index += 1) {
+                    if (!Object.hasOwn(value, index)) {
+                        throw new TransportPayloadError("TFRobot payload arrays must not be sparse");
+                    }
+                    output.push(visit(headerTuple && index === 1 ? REDACTED_VALUE : value[index], depth + 1));
+                }
+                return Object.freeze(output);
+            }
+            const prototype = Object.getPrototypeOf(value);
+            if (prototype !== Object.prototype && prototype !== null) {
+                throw new TransportPayloadError("TFRobot payload must contain plain JSON objects");
+            }
+            const output = {};
+            for (const key of Object.keys(value)) {
+                const safeKey = sanitizeCredentialText(key, credentials);
+                const entry = visit(isSensitiveRawKey(key)
+                    ? REDACTED_VALUE
+                    : value[key], depth + 1);
+                if (Object.hasOwn(output, safeKey))
+                    continue;
+                Object.defineProperty(output, safeKey, {
+                    value: entry,
+                    enumerable: true,
+                    configurable: false,
+                    writable: false,
+                });
+            }
+            return Object.freeze(output);
+        }
+        finally {
+            ancestors.delete(value);
+        }
+    };
+    return visit(input, 0);
 };
-export const sanitizeCredentialRaw = (value, credentialValues) => redactJsonValue(sanitizeRaw(value), credentialValues);
 export const sanitizeCredentialError = (error, credentialValues) => ({
     ...error,
     message: sanitizeCredentialText(error.message, credentialValues),

package/dist/redaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../src/redaction.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,WAAW,GAGZ,MAAM,4BAA4B,CAAC;AAEpC,MAAM,cAAc,GAAG,YAAY,CAAC;AAEpC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,KAAa,EACb,gBAAkC,EAC1B,EAAE;IACV,IAAI,MAAM,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC;SAChD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;SACnC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IACrD,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;QACjC,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CACtB,KAAwB,EACxB,gBAAkC,EACf,EAAE;IACrB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC,MAAM,CAClB,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAC/D,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAsC,EAAE,CAAC;IACrD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,OAAO,GAAG,sBAAsB,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;QAC9D,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;YAAE,SAAS;QAC7C,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE;YACrC,YAAY,EAAE,KAAK;YACnB,UAAU,EAAE,IAAI;YAChB,KAAK,EAAE,eAAe,CAAC,KAAK,EAAE,gBAAgB,CAAC;YAC/C,QAAQ,EAAE,KAAK;SAChB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,KAAc,EACd,gBAAkC,EACf,EAAE,CAAC,eAAe,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC,CAAC;AAE9E,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,KAAgB,EAChB,gBAAkC,EACvB,EAAE,CAAC,CAAC;IACf,GAAG,KAAK;IACR,OAAO,EAAE,sBAAsB,CAAC,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC;IAChE,GAAG,CAAC,KAAK,CAAC,cAAc,KAAK,SAAS;QACpC,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC;YACE,cAAc,EAAE,sBAAsB,CACpC,KAAK,CAAC,cAAc,EACpB,gBAAgB,CACjB;SACF,CAAC;IACN,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS;QAC7B,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,EAAE,OAAO,EAAE,qBAAqB,CAAC,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,EAAE,CAAC;CACzE,CAAC,CAAC"}
+{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../src/redaction.ts"],"names":[],"mappings":"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"}

package/dist/socket.d.ts

@@ -1,16 +1,34 @@
 import { io } from "socket.io-client";
-import { type GatewayObserver, type GatewayRequestOptions, type GatewayResult, type GatewaySubscription, type Run } from "@turingfocus/chat-protocol";
+import { type ChatSnapshot, type ChatUpdate, type GatewayObserver, type GatewayRequestOptions, type GatewayResult, type GatewaySubscription, type Run } from "@turingfocus/chat-protocol";
 import type { StatusDto } from "./dto.js";
-import type { TFRobotGatewayOptions, TFRobotSocketFactory } from "./types.js";
+import type { ResolvedTFRobotCurrentServerRebaseOptions, TFRobotGatewayOptions, TFRobotSession, TFRobotSocketFactory } from "./types.js";
 export declare const createSocketIoFactoryWith: (connect: typeof io) => TFRobotSocketFactory;
 export declare const createSocketIoFactory: TFRobotSocketFactory;
 type ReconnectStatusLoader = (conversationId: string) => Promise<GatewayResult<StatusDto>>;
+export interface CurrentServerRestInput extends GatewayRequestOptions {
+    readonly checkpoint: ReadonlySet<string>;
+    readonly conversationId: string;
+    readonly limits: ResolvedTFRobotCurrentServerRebaseOptions;
+    readonly session: TFRobotSession;
+    readonly signal: AbortSignal;
+}
+export interface CurrentServerRestSnapshot {
+    readonly boundedBy?: "cursor-cycle" | "max-items" | "max-pages" | undefined;
+    readonly checkpointReached: boolean;
+    readonly exhausted: boolean;
+    readonly run: Run | null;
+    readonly updates: readonly ChatUpdate[];
+}
+export type CurrentServerRestLoader = (input: CurrentServerRestInput) => Promise<GatewayResult<CurrentServerRestSnapshot>>;
+export declare const recoveryIdentityOfUpdate: (update: ChatUpdate) => string | undefined;
 export declare class TFRobotSocketClient {
     #private;
-    constructor(options: TFRobotGatewayOptions, reconnectStatusLoader: ReconnectStatusLoader);
+    constructor(options: TFRobotGatewayOptions, reconnectStatusLoader: ReconnectStatusLoader, currentServerRestLoader: CurrentServerRestLoader);
     subscribe(conversationId: string, options: GatewayRequestOptions, observer: GatewayObserver): Promise<GatewayResult<GatewaySubscription>>;
     dispose(): void;
+    rememberSnapshot(snapshot: ChatSnapshot): void;
     rememberRun(conversationId: string, run: Run | null): void;
+    forgetConversation(conversationId: string): void;
 }
 export {};
 //# sourceMappingURL=socket.d.ts.map

package/dist/socket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../src/socket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAEtC,OAAO,EASL,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,GAAG,EAET,MAAM,4BAA4B,CAAC;AAuBpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EACV,qBAAqB,EAKrB,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAmQpB,eAAO,MAAM,yBAAyB,GACnC,SAAS,OAAO,EAAE,KAAG,oBAYU,CAAC;AAEnC,eAAO,MAAM,qBAAqB,sBAAgC,CAAC;AAqBnE,KAAK,qBAAqB,GAAG,CAC3B,cAAc,EAAE,MAAM,KACnB,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;AAIvC,qBAAa,mBAAmB;;gBAe5B,OAAO,EAAE,qBAAqB,EAC9B,qBAAqB,EAAE,qBAAqB;IAWxC,SAAS,CACb,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,qBAAqB,EAC9B,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAAC;IA8jC9C,OAAO,IAAI,IAAI;IAYf,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI;CA2K3D"}
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../src/socket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAEtC,OAAO,EASL,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,GAAG,EAET,MAAM,4BAA4B,CAAC;AAyBpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EACV,yCAAyC,EAEzC,qBAAqB,EACrB,cAAc,EAId,oBAAoB,EAErB,MAAM,YAAY,CAAC;AA4QpB,eAAO,MAAM,yBAAyB,GACnC,SAAS,OAAO,EAAE,KAAG,oBAYU,CAAC;AAEnC,eAAO,MAAM,qBAAqB,sBAAgC,CAAC;AAuBnE,KAAK,qBAAqB,GAAG,CAC3B,cAAc,EAAE,MAAM,KACnB,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;AAkCvC,MAAM,WAAW,sBAAuB,SAAQ,qBAAqB;IACnE,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,yCAAyC,CAAC;IAC3D,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;IAC5E,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;CACzC;AAED,MAAM,MAAM,uBAAuB,GAAG,CACpC,KAAK,EAAE,sBAAsB,KAC1B,OAAO,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC,CAAC;AAEvD,eAAO,MAAM,wBAAwB,GACnC,QAAQ,UAAU,KACjB,MAAM,GAAG,SAQX,CAAC;AAaF,qBAAa,mBAAmB;;gBAwB5B,OAAO,EAAE,qBAAqB,EAC9B,qBAAqB,EAAE,qBAAqB,EAC5C,uBAAuB,EAAE,uBAAuB;IAa5C,SAAS,CACb,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,qBAAqB,EAC9B,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAAC;IA00C9C,OAAO,IAAI,IAAI;IAaf,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAY9C,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI;IAK1D,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;CAyLjD"}