@komaa/standin-sdk 0.1.0

package/dist/attachments.d.ts

@@ -0,0 +1,149 @@
+import { type InboundMessage } from "./chat.js";
+/**
+ * What one image may weigh. Matches the per-attachment ceiling the relay itself
+ * applies, so a larger local number could never be reached anyway.
+ */
+export declare const MAX_IMAGE_BYTES: number;
+/** Images kept from one message. Each becomes a base64 blob in front of a model. */
+export declare const MAX_IMAGES = 4;
+/** How long one image has to arrive. */
+export declare const IMAGE_FETCH_TIMEOUT_MS = 10000;
+/**
+ * How many images may be REQUESTED, whatever the outcome. The accept cap counts
+ * only successes, so a message naming fifty attachments that all time out still
+ * costs fifty timeouts and blows the turn budget. This makes the worst case
+ * arithmetic: eight tries at ten seconds.
+ */
+export declare const IMAGE_FETCH_ATTEMPTS = 8;
+/** A voice note is minutes of audio, so it gets a bigger budget than a picture. */
+export declare const MAX_CLIP_BYTES: number;
+export declare const MAX_CLIPS = 2;
+export declare const CLIP_FETCH_TIMEOUT_MS = 20000;
+export declare const CLIP_FETCH_ATTEMPTS = 4;
+/** A card's submit payload is model input, bounded because it reaches a model. */
+export declare const CARD_PAYLOAD_MAX_CHARS = 4096;
+/** Lines in the "what was attached" note. */
+export declare const ATTACHMENT_NOTE_MAX_LINES = 10;
+/** One picture from a message, ready for a vision model. */
+export interface ChatImage {
+    readonly dataBase64: string;
+    readonly mime: string;
+    readonly name?: string;
+    readonly sizeBytes: number;
+}
+/** One voice note, as bytes, before anything has transcribed it. */
+export interface ChatAudio {
+    readonly data: Buffer;
+    readonly mime: string;
+    readonly name: string;
+}
+/** One inbound message, assembled into what an agent is actually asked. */
+export interface ChatTurn {
+    /** The text to put in front of the model, including every note below. */
+    readonly query: string;
+    readonly images: ChatImage[];
+    readonly voiceNote: string;
+    readonly attachmentNote: string;
+}
+/** The bytes of an image, since an interface carries no accessors. */
+export declare function chatImageData(image: ChatImage): Buffer;
+/** The `data:` form most vision APIs take directly. */
+export declare function chatImageDataUrl(image: ChatImage): string;
+/**
+ * Turn a voice note into words. Supplied by the handler or a speech plugin: the
+ * core ships none and reads no provider key.
+ */
+export type Transcriber = (data: Buffer, mime: string) => Promise<string>;
+/** Options shared by the fetchers. */
+export interface FetchOptions {
+    origin: string | undefined;
+    maxBytes?: number;
+    timeoutMs?: number;
+    fetchFn?: typeof fetch;
+}
+/**
+ * The one origin attachments may be fetched from, or undefined.
+ *
+ * Derived from the chat channel's own URL rather than configured separately, so
+ * it is right by construction for a self-hosted or local gateway and there is no
+ * second setting to get wrong.
+ *
+ * undefined means fetch nothing. That is the safe direction: an unset origin
+ * read as "anywhere" turns a configuration typo into a fetcher that a message
+ * can point at any address it likes.
+ */
+export declare function chatAttachmentOrigin(url?: string): string | undefined;
+/**
+ * Pictures from a message, ready to put in front of a vision model.
+ *
+ * Best-effort per attachment: one that will not load costs that attachment,
+ * never the answer.
+ */
+export declare function fetchChatImages(attachments: readonly Record<string, unknown>[], options: FetchOptions & {
+    maxImages?: number;
+}): Promise<ChatImage[]>;
+/**
+ * Voice notes from a message, as bytes.
+ *
+ * `video/` is accepted as well as `audio/`: some clients label a voice or video
+ * note with a container type that speech-to-text reads perfectly well.
+ */
+export declare function fetchChatAudio(attachments: readonly Record<string, unknown>[], options: FetchOptions & {
+    maxClips?: number;
+}): Promise<ChatAudio[]>;
+/**
+ * What the voice notes said, as one block of text.
+ *
+ * Empty when there are none, when no transcriber was supplied, or when every one
+ * failed. A transcriber that throws costs that clip and nothing else.
+ */
+export declare function transcribeVoiceMessages(attachments: readonly Record<string, unknown>[], options: FetchOptions & {
+    transcribe?: Transcriber;
+    maxClips?: number;
+}): Promise<string>;
+/**
+ * A plain sentence naming what came with the message.
+ *
+ * Worth saying even when nothing could be read: a model that is told a picture
+ * was attached and could not be opened says something useful, and a model told
+ * nothing answers as if the message were empty.
+ */
+export declare function attachmentsNote(attachments: readonly Record<string, unknown>[], status?: Map<number, string>): string;
+/**
+ * What a button press on one of this agent's own cards submitted.
+ *
+ * A card message arrives with EMPTY text, so without this the agent is asked
+ * nothing at all and answers as though the person said nothing.
+ */
+export declare function cardActionNote(cardAction: Record<string, unknown> | undefined): string;
+/** Options for {@link buildChatTurn}. */
+export interface ChatTurnOptions {
+    origin?: string;
+    images?: boolean;
+    transcribe?: Transcriber;
+    fetchFn?: typeof fetch;
+}
+/**
+ * One inbound message, assembled into what to ask an agent.
+ *
+ * The order is fixed, and it is the order a person would say it in: what they
+ * typed, what they pressed, what they said out loud, then what they attached.
+ *
+ * ```ts
+ * const turn = await buildChatTurn(message, { transcribe: myStt });
+ * const answer = await agent.ask(turn.query, turn.images.map(chatImageDataUrl));
+ * ```
+ *
+ * Never throws. Anything that will not load is named in the note rather than
+ * failing the turn.
+ */
+export declare function buildChatTurn(message: InboundMessage, options?: ChatTurnOptions): Promise<ChatTurn>;
+/**
+ * Put a voice note on disk for an engine that only takes a path.
+ *
+ * Removed on the way out, on every path. A transcription engine is handed
+ * somebody's voice, and leaving it in a temporary directory is a copy nobody
+ * decided to keep.
+ */
+export declare function spoolClip<T>(clip: ChatAudio, use: (path: string) => Promise<T>): Promise<T>;
+//# sourceMappingURL=attachments.d.ts.map

package/dist/attachments.d.ts.map

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

package/dist/attachments.js

@@ -0,0 +1,451 @@
+// Copyright (c) 2026 Komaa DigiTech
+// SPDX-License-Identifier: MIT
+/**
+ * What somebody attached to a chat message, turned into something an agent can
+ * use.
+ *
+ * A Microsoft Teams message can carry a pasted screenshot, a dragged-in file, or
+ * a voice note. Without this the handler gets `InboundMessage.attachments` as
+ * raw objects, so the best it can do is read a JSON blob to a model, and the
+ * worst is answer a message about a picture as though nothing had been sent.
+ *
+ * {@link buildChatTurn} is the whole thing in one call: the text, the images
+ * fetched and ready to hand to a vision model, a voice note transcribed, and a
+ * plain sentence naming anything that could not be read.
+ *
+ * This is deliberately NOT in `chat.ts`. That module owns the socket, the
+ * duplicate check and the per-conversation ordering, and none of it changes
+ * here. Fetching is optional work that must never be able to wedge the
+ * transport, so it lives beside it: a handler that fetches nothing pays nothing.
+ *
+ * Every fetch is pinned to the one origin the messages themselves arrived from,
+ * and fails CLOSED. An attachment URL is signed, but not by us and not for us:
+ * it arrives inside a message somebody else wrote, and the pin is the only thing
+ * bounding where this worker can be told to go.
+ *
+ * Identical in shape to the Python SDK's `standin.attachments`.
+ */
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { DEFAULT_CHAT_URL } from "./chat.js";
+import { logger } from "./log.js";
+/**
+ * What one image may weigh. Matches the per-attachment ceiling the relay itself
+ * applies, so a larger local number could never be reached anyway.
+ */
+export const MAX_IMAGE_BYTES = 4 * 1024 * 1024;
+/** Images kept from one message. Each becomes a base64 blob in front of a model. */
+export const MAX_IMAGES = 4;
+/** How long one image has to arrive. */
+export const IMAGE_FETCH_TIMEOUT_MS = 10_000;
+/**
+ * How many images may be REQUESTED, whatever the outcome. The accept cap counts
+ * only successes, so a message naming fifty attachments that all time out still
+ * costs fifty timeouts and blows the turn budget. This makes the worst case
+ * arithmetic: eight tries at ten seconds.
+ */
+export const IMAGE_FETCH_ATTEMPTS = 8;
+/** A voice note is minutes of audio, so it gets a bigger budget than a picture. */
+export const MAX_CLIP_BYTES = 16 * 1024 * 1024;
+export const MAX_CLIPS = 2;
+export const CLIP_FETCH_TIMEOUT_MS = 20_000;
+export const CLIP_FETCH_ATTEMPTS = 4;
+/** A card's submit payload is model input, bounded because it reaches a model. */
+export const CARD_PAYLOAD_MAX_CHARS = 4096;
+/** Lines in the "what was attached" note. */
+export const ATTACHMENT_NOTE_MAX_LINES = 10;
+/**
+ * Extensions that make a relayed FILE worth trying as an image. A pasted
+ * screenshot arrives as an image; the same file dragged in from disk arrives as
+ * a file whose declared type is a bare extension, so gating on the kind alone
+ * makes an attached picture invisible while the note says one was sent.
+ */
+const IMAGE_EXTENSIONS = [
+    "png",
+    "jpg",
+    "jpeg",
+    "gif",
+    "webp",
+    "bmp",
+    "heic",
+    "heif",
+];
+/** The same for a voice note, which also arrives as a file in practice. */
+const AUDIO_EXTENSIONS = [
+    "wav",
+    "mp3",
+    "m4a",
+    "mp4",
+    "ogg",
+    "oga",
+    "opus",
+    "aac",
+    "amr",
+    "webm",
+    "mov",
+    "3gp",
+];
+const SCHEME_FOR_FETCH = {
+    "ws:": "http",
+    "wss:": "https",
+    "http:": "http",
+    "https:": "https",
+};
+const DEFAULT_PORT = { http: 80, https: 443 };
+/** The bytes of an image, since an interface carries no accessors. */
+export function chatImageData(image) {
+    return Buffer.from(image.dataBase64, "base64");
+}
+/** The `data:` form most vision APIs take directly. */
+export function chatImageDataUrl(image) {
+    return `data:${image.mime};base64,${image.dataBase64}`;
+}
+/**
+ * The one origin attachments may be fetched from, or undefined.
+ *
+ * Derived from the chat channel's own URL rather than configured separately, so
+ * it is right by construction for a self-hosted or local gateway and there is no
+ * second setting to get wrong.
+ *
+ * undefined means fetch nothing. That is the safe direction: an unset origin
+ * read as "anywhere" turns a configuration typo into a fetcher that a message
+ * can point at any address it likes.
+ */
+export function chatAttachmentOrigin(url) {
+    const raw = (url ?? process.env.STANDIN_CHAT_URL ?? DEFAULT_CHAT_URL).trim();
+    let parts;
+    try {
+        parts = new URL(raw);
+    }
+    catch {
+        return undefined;
+    }
+    const scheme = SCHEME_FOR_FETCH[parts.protocol];
+    if (scheme === undefined || parts.hostname === "")
+        return undefined;
+    const port = parts.port === "" ? DEFAULT_PORT[scheme] : Number(parts.port);
+    const host = parts.hostname.toLowerCase();
+    return port === DEFAULT_PORT[scheme]
+        ? `${scheme}://${host}`
+        : `${scheme}://${host}:${port}`;
+}
+/** Whether this URL is the origin we were told about. Fails closed. */
+function sameOrigin(url, origin) {
+    if (!origin)
+        return false;
+    let got;
+    let want;
+    try {
+        got = new URL(url);
+        want = new URL(origin);
+    }
+    catch {
+        return false;
+    }
+    if (got.protocol !== "http:" && got.protocol !== "https:")
+        return false;
+    const key = (u) => {
+        const scheme = u.protocol.replace(":", "");
+        const port = u.port === "" ? DEFAULT_PORT[scheme] : Number(u.port);
+        return `${scheme}|${u.hostname.toLowerCase()}|${port}`;
+    };
+    return key(got) === key(want);
+}
+function looksLike(name, contentType, extensions) {
+    if (extensions.includes(contentType.trim().toLowerCase()))
+        return true;
+    const suffix = name.includes(".")
+        ? name.split(".").pop().trim().toLowerCase()
+        : "";
+    return extensions.includes(suffix);
+}
+/** Attachments worth a request, in wire order. */
+function candidates(attachments, kind, extensions) {
+    const out = [];
+    attachments.forEach((item, index) => {
+        if (typeof item !== "object" || item === null)
+            return;
+        if (item.relayable === false)
+            return;
+        if (typeof item.url !== "string" || item.url === "")
+            return;
+        const itemKind = String(item.kind ?? "");
+        if (itemKind === kind ||
+            (itemKind === "file" &&
+                looksLike(String(item.name ?? ""), String(item.contentType ?? ""), extensions))) {
+            out.push({ index, item });
+        }
+    });
+    return out;
+}
+/**
+ * The real media type.
+ *
+ * What the RESPONSE said wins. The declared value arrived inside the message,
+ * which somebody else wrote, so letting it decide would let a message claim
+ * `image/png` for a page of HTML and have it read as a picture.
+ *
+ * The declared value is the fallback, and only when it IS a media type: a
+ * relayed file declares a bare extension, and taking that literally fails every
+ * `audio/` check.
+ */
+function resolveMime(declared, header) {
+    for (const candidate of [header, declared]) {
+        const value = String(candidate ?? "")
+            .split(";")[0]
+            .trim()
+            .toLowerCase();
+        if (value.includes("/"))
+            return value;
+    }
+    return "";
+}
+/**
+ * The body, or undefined when it is too big.
+ *
+ * Checked while reading, not after. A content-length that lies, or is simply
+ * absent, otherwise gets to allocate whatever it likes before a later check
+ * objects.
+ */
+async function readCapped(response, maxBytes) {
+    const declared = response.headers.get("content-length");
+    if (declared !== null &&
+        /^\d+$/.test(declared) &&
+        Number(declared) > maxBytes)
+        return undefined;
+    const body = response.body;
+    if (body === null)
+        return undefined;
+    const reader = body.getReader();
+    const chunks = [];
+    let total = 0;
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            total += value.length;
+            if (total > maxBytes) {
+                await reader.cancel().catch(() => undefined);
+                return undefined;
+            }
+            chunks.push(Buffer.from(value));
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+    return Buffer.concat(chunks);
+}
+/** The shared fetch loop. Never throws, and returns what it got. */
+async function fetchAll(attachments, spec, options) {
+    const call = options.fetchFn ?? fetch;
+    const maxBytes = options.maxBytes ?? spec.defaultMaxBytes;
+    const timeoutMs = options.timeoutMs ?? spec.defaultTimeoutMs;
+    const taken = [];
+    let attempts = 0;
+    for (const { index, item } of candidates(attachments, spec.kind, spec.extensions)) {
+        if (taken.length >= spec.maxItems || attempts >= spec.maxAttempts)
+            break;
+        const url = String(item.url);
+        if (!sameOrigin(url, options.origin)) {
+            logger.warn("standin: refusing an attachment from another origin");
+            continue;
+        }
+        attempts += 1;
+        try {
+            // No redirects. The URL is same-origin and signed, so a redirect off it is
+            // already anomalous, and following one reopens the door the origin pin
+            // just closed: the pin is checked on the URL in the message, not on
+            // wherever a 302 points.
+            const response = await call(url, {
+                redirect: "error",
+                signal: AbortSignal.timeout(timeoutMs),
+            });
+            if (!response.ok)
+                continue;
+            const mime = resolveMime(String(item.contentType ?? ""), response.headers.get("content-type") ?? "");
+            // Judged BEFORE a byte is read: an error page would otherwise be base64'd
+            // in front of a model as though it were a picture.
+            if (!spec.prefixes.some((prefix) => mime.startsWith(prefix)))
+                continue;
+            const body = await readCapped(response, maxBytes);
+            if (body !== undefined && body.length > 0) {
+                taken.push({ index, body, mime, name: String(item.name ?? "") });
+            }
+        }
+        catch (err) {
+            logger.warn(`standin: could not fetch an attachment: ${String(err)}`);
+        }
+    }
+    return taken;
+}
+/**
+ * Pictures from a message, ready to put in front of a vision model.
+ *
+ * Best-effort per attachment: one that will not load costs that attachment,
+ * never the answer.
+ */
+export async function fetchChatImages(attachments, options) {
+    const got = await fetchAll(attachments, {
+        kind: "image",
+        extensions: IMAGE_EXTENSIONS,
+        prefixes: ["image/"],
+        maxItems: options.maxImages ?? MAX_IMAGES,
+        maxAttempts: IMAGE_FETCH_ATTEMPTS,
+        defaultTimeoutMs: IMAGE_FETCH_TIMEOUT_MS,
+        defaultMaxBytes: MAX_IMAGE_BYTES,
+    }, options);
+    return got.map((t) => ({
+        dataBase64: t.body.toString("base64"),
+        mime: t.mime,
+        name: t.name || undefined,
+        sizeBytes: t.body.length,
+    }));
+}
+/**
+ * Voice notes from a message, as bytes.
+ *
+ * `video/` is accepted as well as `audio/`: some clients label a voice or video
+ * note with a container type that speech-to-text reads perfectly well.
+ */
+export async function fetchChatAudio(attachments, options) {
+    const got = await fetchAll(attachments, {
+        kind: "audio",
+        extensions: AUDIO_EXTENSIONS,
+        prefixes: ["audio/", "video/"],
+        maxItems: options.maxClips ?? MAX_CLIPS,
+        maxAttempts: CLIP_FETCH_ATTEMPTS,
+        defaultTimeoutMs: CLIP_FETCH_TIMEOUT_MS,
+        defaultMaxBytes: MAX_CLIP_BYTES,
+    }, options);
+    return got.map((t) => ({ data: t.body, mime: t.mime, name: t.name }));
+}
+/**
+ * What the voice notes said, as one block of text.
+ *
+ * Empty when there are none, when no transcriber was supplied, or when every one
+ * failed. A transcriber that throws costs that clip and nothing else.
+ */
+export async function transcribeVoiceMessages(attachments, options) {
+    if (options.transcribe === undefined)
+        return "";
+    const said = [];
+    for (const clip of await fetchChatAudio(attachments, options)) {
+        try {
+            const text = (await options.transcribe(clip.data, clip.mime)).trim();
+            if (text !== "")
+                said.push(text);
+        }
+        catch (err) {
+            logger.warn(`standin: could not transcribe a voice message: ${String(err)}`);
+        }
+    }
+    return said.join("\n");
+}
+/**
+ * A plain sentence naming what came with the message.
+ *
+ * Worth saying even when nothing could be read: a model that is told a picture
+ * was attached and could not be opened says something useful, and a model told
+ * nothing answers as if the message were empty.
+ */
+export function attachmentsNote(attachments, status = new Map()) {
+    if (attachments.length === 0)
+        return "";
+    const lines = [];
+    for (const [index, item] of attachments.entries()) {
+        if (lines.length >= ATTACHMENT_NOTE_MAX_LINES) {
+            lines.push(`and ${attachments.length - lines.length} more`);
+            break;
+        }
+        if (typeof item !== "object" || item === null)
+            continue;
+        const name = String(item.name ?? "").trim() || "an unnamed file";
+        const kind = String(item.kind ?? "file").trim() || "file";
+        const mark = status.get(index);
+        lines.push(`- ${name} [${kind}]${mark ? ` (${mark})` : ""}`);
+    }
+    if (lines.length === 0)
+        return "";
+    return `[Attached to this message]\n${lines.join("\n")}`;
+}
+/**
+ * What a button press on one of this agent's own cards submitted.
+ *
+ * A card message arrives with EMPTY text, so without this the agent is asked
+ * nothing at all and answers as though the person said nothing.
+ */
+export function cardActionNote(cardAction) {
+    if (cardAction === undefined || cardAction === null)
+        return "";
+    let payload;
+    try {
+        payload = JSON.stringify(cardAction, Object.keys(cardAction).sort());
+    }
+    catch {
+        payload = String(cardAction);
+    }
+    return `[The person used a button on your card]\n${payload.slice(0, CARD_PAYLOAD_MAX_CHARS)}`;
+}
+/**
+ * One inbound message, assembled into what to ask an agent.
+ *
+ * The order is fixed, and it is the order a person would say it in: what they
+ * typed, what they pressed, what they said out loud, then what they attached.
+ *
+ * ```ts
+ * const turn = await buildChatTurn(message, { transcribe: myStt });
+ * const answer = await agent.ask(turn.query, turn.images.map(chatImageDataUrl));
+ * ```
+ *
+ * Never throws. Anything that will not load is named in the note rather than
+ * failing the turn.
+ */
+export async function buildChatTurn(message, options = {}) {
+    const origin = options.origin !== undefined ? options.origin : chatAttachmentOrigin();
+    const attachments = (message.attachments ?? []);
+    const shared = { origin, fetchFn: options.fetchFn };
+    const images = options.images === false ? [] : await fetchChatImages(attachments, shared);
+    const voiceNote = await transcribeVoiceMessages(attachments, {
+        ...shared,
+        transcribe: options.transcribe,
+    });
+    // Which ones actually made it, so the note can say so rather than implying the
+    // model has seen something it has not.
+    const readable = new Set(images.map((i) => i.name).filter(Boolean));
+    const status = new Map();
+    attachments.forEach((item, index) => {
+        if (typeof item !== "object" || item === null)
+            return;
+        status.set(index, readable.has(String(item.name ?? "")) ? "attached" : "unreadable");
+    });
+    const card = cardActionNote(message.cardAction);
+    const attachmentNote = attachmentsNote(attachments, status);
+    const spoken = voiceNote ? `[They sent a voice message]\n${voiceNote}` : "";
+    const query = [message.text.trim(), card, spoken, attachmentNote]
+        .filter(Boolean)
+        .join("\n\n");
+    return { query, images, voiceNote, attachmentNote };
+}
+/**
+ * Put a voice note on disk for an engine that only takes a path.
+ *
+ * Removed on the way out, on every path. A transcription engine is handed
+ * somebody's voice, and leaving it in a temporary directory is a copy nobody
+ * decided to keep.
+ */
+export async function spoolClip(clip, use) {
+    const dir = mkdtempSync(join(tmpdir(), "standin-clip-"));
+    const suffix = clip.mime.split("/").pop() || "bin";
+    const path = join(dir, `clip.${suffix}`);
+    try {
+        writeFileSync(path, clip.data);
+        return await use(path);
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=attachments.js.map

package/dist/attachments.js.map

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