@intentface/latch-channels 0.9.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Intentface
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,27 @@
+# @intentface/latch-channels
+
+Bring a Latch agent to the places people talk — Slack, Telegram, WhatsApp. Reuses the core runtime, storage and durability (no separate state store); identity (platform user → Principal) and channel → agent binding stay in user-land, per Latch's isolation model.
+
+## What it does
+
+- **Generic core (`.`)** — the platform-agnostic half:
+  - `consumeRun(response)` → `AsyncIterable<RenderEvent>` folded from the runtime's SSE `Response`; `pendingApprovals` / `pendingQuestion` read what a paused turn is waiting on from persisted history. Adding a platform is "translate `RenderEvent`s", never "re-parse the AI stream."
+  - `createTurnKernel(config, surface)` — everything a direct-message surface does between "a webhook arrived" and "the platform API was called", written once: dedupe, the identity gate (with stash + post-link replay), thread epochs (`/new`), commands, questionnaires, media folding (files inline, voice transcribed), the answer posted **once at finish** (split past the cap; a typing hint meanwhile), approvals and button taps back into the run. A `Surface` is pure protocol: send text / link / approval / question, edit or retire a card, download a file.
+  - `AuthResult`, the `lta:` / `ltq:` button-payload codecs, `splitText`.
+- **Telegram (`./telegram`)** and **WhatsApp (`./whatsapp`)** — a webhook parser plus a `Surface` each, over the kernel. `telegramChannel(config)` / `whatsappChannel(config)` verify the webhook, ACK fast, and run the turn in the background (`waitUntil`).
+- **Slack (`./slack`)** — `slackChannel(config)`: one agent's dedicated app; native message streaming with tool calls as task cards, initiator-owned threads, signed actor-bound approval buttons, atomic admission (`claimOnce`). One live run per chat comes from core's storage invariant on the shipped adapters; on a custom adapter without it, wire the optional `claimTurn` / `releaseTurn` lease — every adapter (kernel and Slack) honours it. Plus the per-agent app manifest generator, a minimal Web API client and hand-rolled Block Kit (no Chat SDK runtime dependency). Slack keeps its own engine because its surface is threads, not DMs.
+
+## Usage
+
+```ts
+import { telegramChannel } from "@intentface/latch-channels/telegram";
+
+const channel = telegramChannel<Principal>({
+  agent, botRef, botToken, webhookSecret,
+  runtime: { handleChat, applyApproval, applyToolResult, compactChat, loadHistory },
+  authorizeUser, seen, stashPending, askState, thread, waitUntil,
+});
+return channel.handleRequest(request); // one webhook route per bot
+```
+
+A new DM platform: implement `Surface<User, Ref>` and a parser from your webhook body to `Inbound<User, Ref>`, then `createTurnKernel(config, surface).handleInbound(event)`.

package/dist/ask.d.ts

@@ -0,0 +1,69 @@
+import type { AskSession, Question } from "./types.js";
+/**
+ * The questionnaire state machine — pure, platform-free, and the single place
+ * the answer semantics live, so Telegram and WhatsApp can't drift from each
+ * other or from the web composer.
+ *
+ * A chat surface asks one question at a time, but `applyToolResult` closes the
+ * whole `askUser` call in one shot: answers accumulate in an `AskSession` and
+ * only the last question emits `completed`.
+ *
+ * The output is a flat `Record<questionText, answer>` — the exact shape the web
+ * composer submits (`apps/latch-platform/src/components/chat.tsx`), including
+ * joining multi-select picks with `", "`.
+ */
+export type AskEvent = 
+/** An option button: commits a single-select question, toggles a multi-select one. */
+{
+    kind: "pick";
+    option: number;
+}
+/** The "Done" button on a multi-select question. */
+ | {
+    kind: "done";
+}
+/** A typed message, taken as the answer to the question on screen. */
+ | {
+    kind: "typed";
+    text: string;
+};
+export type AskStep = 
+/** A multi-select tick changed; same question stays on screen. */
+{
+    kind: "toggled";
+    selected: number[];
+}
+/** Question committed, more remain. */
+ | {
+    kind: "advanced";
+    cursor: number;
+    answers: Record<string, string>;
+    answered: {
+        question: string;
+        answer: string;
+    };
+}
+/** Last question committed — submit `output` via `applyToolResult`. */
+ | {
+    kind: "completed";
+    output: Record<string, string>;
+    answered: {
+        question: string;
+        answer: string;
+    };
+}
+/** Nothing to do (e.g. Done with nothing ticked); `reason` is user-facing. */
+ | {
+    kind: "rejected";
+    reason: string;
+};
+/**
+ * Interpret typed text as an answer to `q`. Tries, in order: an option label
+ * (case-insensitive), a 1-based option number (or list of them, which is how
+ * WhatsApp's numbered fallback answers), then the raw text — free-form answers
+ * are legitimate, the web composer allows them too.
+ */
+export declare function resolveTypedAnswer(q: Question, text: string): string;
+/** Apply one interaction to a session. Never mutates; returns what to do next. */
+export declare function nextAskStep(session: AskSession, event: AskEvent): AskStep;
+//# sourceMappingURL=ask.d.ts.map

package/dist/ask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask.d.ts","sourceRoot":"","sources":["../src/ask.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,QAAQ;AAClB,sFAAsF;AACpF;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAClC,oDAAoD;GAClD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;AAClB,sEAAsE;GACpE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC,MAAM,MAAM,OAAO;AACjB,kEAAkE;AAChE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE;AACzC,uCAAuC;GACrC;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AACH,uEAAuE;GACrE;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AACH,8EAA8E;GAC5E;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAyBzC;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAWpE;AAWD,kFAAkF;AAClF,wBAAgB,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CA+BzE"}

package/dist/ask.js

@@ -0,0 +1,94 @@
+const MULTI_JOIN = ", ";
+/** Labels of the ticked options, always in OPTION order (not tap order). */
+function selectedLabels(q, selected) {
+    return q.options
+        .map((o, i) => (selected.includes(i) ? o.label : undefined))
+        .filter((l) => l !== undefined);
+}
+/** Parse "1,3" / "1 3" into option indices; null unless ALL tokens are valid. */
+function parseIndexList(q, text) {
+    const tokens = text.split(/[,\s]+/).filter(Boolean);
+    if (!tokens.length)
+        return null;
+    const out = [];
+    for (const t of tokens) {
+        if (!/^\d+$/.test(t))
+            return null;
+        const i = Number(t) - 1; // 1-based for humans
+        if (i < 0 || i >= q.options.length)
+            return null;
+        if (!out.includes(i))
+            out.push(i);
+    }
+    return out.sort((a, b) => a - b);
+}
+/**
+ * Interpret typed text as an answer to `q`. Tries, in order: an option label
+ * (case-insensitive), a 1-based option number (or list of them, which is how
+ * WhatsApp's numbered fallback answers), then the raw text — free-form answers
+ * are legitimate, the web composer allows them too.
+ */
+export function resolveTypedAnswer(q, text) {
+    const trimmed = text.trim();
+    const byLabel = q.options.find((o) => o.label.toLowerCase() === trimmed.toLowerCase());
+    if (byLabel)
+        return byLabel.label;
+    const indices = parseIndexList(q, trimmed);
+    if (indices) {
+        const labels = indices.map((i) => q.options[i].label);
+        // A single index answers either kind; a list only makes sense for multi-select.
+        if (labels.length === 1 || q.multiSelect)
+            return labels.join(MULTI_JOIN);
+    }
+    return trimmed;
+}
+/** Commit `answer` for the current question and move on (or finish). */
+function commit(session, q, answer) {
+    const answers = { ...session.answers, [q.question]: answer };
+    const answered = { question: q.question, answer };
+    const next = session.cursor + 1;
+    if (next >= session.questions.length)
+        return { kind: "completed", output: answers, answered };
+    return { kind: "advanced", cursor: next, answers, answered };
+}
+/** Apply one interaction to a session. Never mutates; returns what to do next. */
+export function nextAskStep(session, event) {
+    const q = session.questions[session.cursor];
+    if (!q)
+        return { kind: "rejected", reason: "This questionnaire is already complete." };
+    switch (event.kind) {
+        case "pick": {
+            const option = q.options[event.option];
+            if (!option)
+                return { kind: "rejected", reason: "That option is no longer available." };
+            if (!q.multiSelect)
+                return commit(session, q, option.label);
+            const selected = session.selected.includes(event.option)
+                ? session.selected.filter((i) => i !== event.option)
+                : [...session.selected, event.option];
+            return { kind: "toggled", selected };
+        }
+        case "done": {
+            if (!q.multiSelect)
+                return { kind: "rejected", reason: "Pick one of the options." };
+            const labels = selectedLabels(q, session.selected);
+            if (!labels.length)
+                return { kind: "rejected", reason: "Pick at least one option first." };
+            return commit(session, q, labels.join(MULTI_JOIN));
+        }
+        case "typed": {
+            const typed = event.text.trim();
+            if (!typed)
+                return { kind: "rejected", reason: "That doesn't look like an answer." };
+            if (!q.multiSelect)
+                return commit(session, q, resolveTypedAnswer(q, typed));
+            // Multi-select: a pure index list replaces the ticks; anything else is
+            // appended to them, matching the web composer's options-plus-free-text join.
+            const indices = parseIndexList(q, typed);
+            if (indices)
+                return commit(session, q, selectedLabels(q, indices).join(MULTI_JOIN));
+            return commit(session, q, [...selectedLabels(q, session.selected), typed].join(MULTI_JOIN));
+        }
+    }
+}
+//# sourceMappingURL=ask.js.map

package/dist/ask.js.map

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

package/dist/commands.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Chat-surface commands — pure parsing plus the one registry every surface reads,
+ * so `/help`, Telegram's native command menu and the dispatcher can never list
+ * different things.
+ *
+ * Only KNOWN commands parse. Unknown `/`-prefixed text is not a command and must
+ * keep reaching the agent as an ordinary message: people paste `/Users/me/notes`
+ * and `/etc/hosts` into chats, and swallowing those would lose real input.
+ */
+export interface ChannelCommand {
+    /** Canonical name, without the leading slash. */
+    name: string;
+    /** Alternative spellings that resolve to `name`. */
+    aliases?: string[];
+    /** One line, shown in `/help` and in Telegram's command menu. */
+    description: string;
+}
+export declare const CHANNEL_COMMANDS: ChannelCommand[];
+/** Commands that end or replace the current thread, so a live questionnaire dies with them. */
+export declare const THREAD_CHANGING_COMMANDS: Set<string>;
+export interface ParsedCommand {
+    /** Canonical command name (aliases already resolved). */
+    name: string;
+    /** Everything after the command word, trimmed (empty when there was none). */
+    args: string;
+}
+/**
+ * Parse a message as a command, or null if it isn't one.
+ *
+ * Telegram appends `@botusername` when a command is typed in a group and can
+ * carry arguments; both are handled here so channels don't each re-derive it.
+ */
+export declare function parseCommand(text: string): ParsedCommand | null;
+/** The `/help` body: one `/command — description` line per command. */
+export declare function helpText(commands?: ChannelCommand[]): string;
+/** Telegram `setMyCommands` payload — canonical names only (aliases stay hidden). */
+export declare function telegramCommandMenu(commands?: ChannelCommand[]): {
+    command: string;
+    description: string;
+}[];
+//# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAW5C,CAAC;AAEF,+FAA+F;AAC/F,eAAO,MAAM,wBAAwB,aAAwC,CAAC;AAE9E,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;CACd;AAOD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAW/D;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,QAAQ,GAAE,cAAc,EAAqB,GAAG,MAAM,CAE9E;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CACjC,QAAQ,GAAE,cAAc,EAAqB,GAC5C;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,CAE5C"}

package/dist/commands.js

@@ -0,0 +1,54 @@
+/**
+ * Chat-surface commands — pure parsing plus the one registry every surface reads,
+ * so `/help`, Telegram's native command menu and the dispatcher can never list
+ * different things.
+ *
+ * Only KNOWN commands parse. Unknown `/`-prefixed text is not a command and must
+ * keep reaching the agent as an ordinary message: people paste `/Users/me/notes`
+ * and `/etc/hosts` into chats, and swallowing those would lose real input.
+ */
+export const CHANNEL_COMMANDS = [
+    { name: "new", aliases: ["reset"], description: "Start a fresh conversation" },
+    { name: "compact", description: "Summarize this conversation to free up context" },
+    {
+        name: "cancel",
+        aliases: ["skip"],
+        description: "Cancel whatever the agent is waiting on",
+    },
+    { name: "status", description: "Show what this conversation is doing" },
+    { name: "help", aliases: ["commands"], description: "List the available commands" },
+    { name: "start", description: "What this bot can do" },
+];
+/** Commands that end or replace the current thread, so a live questionnaire dies with them. */
+export const THREAD_CHANGING_COMMANDS = new Set(["new", "compact", "cancel"]);
+/** name/alias (lowercased) → canonical name. */
+const BY_NAME = new Map(CHANNEL_COMMANDS.flatMap((c) => [c.name, ...(c.aliases ?? [])].map((n) => [n, c.name])));
+/**
+ * Parse a message as a command, or null if it isn't one.
+ *
+ * Telegram appends `@botusername` when a command is typed in a group and can
+ * carry arguments; both are handled here so channels don't each re-derive it.
+ */
+export function parseCommand(text) {
+    // The command word matches Telegram's own grammar exactly — `[A-Za-z0-9_]`
+    // plus an optional `@botusername` — and nothing else. Anything with another
+    // character in it (`/new/plan.md`, `/Users/me/notes.txt`, `/help@bot/docs`)
+    // fails to match and stays an ordinary message, so a pasted path is never
+    // mistaken for the command its first segment happens to spell.
+    const m = /^\/([A-Za-z0-9_]+)(?:@([A-Za-z0-9_]+))?(?:\s+([\s\S]*))?$/.exec(text.trim());
+    if (!m)
+        return null;
+    const name = BY_NAME.get(m[1].toLowerCase());
+    if (!name)
+        return null;
+    return { name, args: (m[3] ?? "").trim() };
+}
+/** The `/help` body: one `/command — description` line per command. */
+export function helpText(commands = CHANNEL_COMMANDS) {
+    return commands.map((c) => `/${c.name} — ${c.description}`).join("\n");
+}
+/** Telegram `setMyCommands` payload — canonical names only (aliases stay hidden). */
+export function telegramCommandMenu(commands = CHANNEL_COMMANDS) {
+    return commands.map((c) => ({ command: c.name, description: c.description }));
+}
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,MAAM,CAAC,MAAM,gBAAgB,GAAqB;IAChD,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,4BAA4B,EAAE;IAC9E,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,gDAAgD,EAAE;IAClF;QACE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,CAAC,MAAM,CAAC;QACjB,WAAW,EAAE,yCAAyC;KACvD;IACD,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;IACvE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,WAAW,EAAE,6BAA6B,EAAE;IACnF,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE;CACvD,CAAC;AAEF,+FAA+F;AAC/F,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;AAS9E,gDAAgD;AAChD,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAU,CAAC,CAAC,CACjG,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,2EAA2E;IAC3E,4EAA4E;IAC5E,4EAA4E;IAC5E,0EAA0E;IAC1E,+DAA+D;IAC/D,MAAM,CAAC,GAAG,2DAA2D,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACxF,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IAC9C,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;AAC7C,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,QAAQ,CAAC,WAA6B,gBAAgB;IACpE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzE,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,mBAAmB,CACjC,WAA6B,gBAAgB;IAE7C,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;AAChF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @intentface/latch-channels
+ *
+ * Bring a Latch agent to the places people talk — Slack first. The generic
+ * core here is platform-agnostic and dependency-light: a run→`RenderEvent`
+ * projection (`consumeRun`) and approval detection (`pendingApprovals`) over
+ * the runtime's public SSE contract. Per-platform adapters live in subpath
+ * exports (e.g. `@intentface/latch-channels/slack`) and only ever translate
+ * `RenderEvent`s — they never re-parse the AI stream.
+ *
+ * Identity (which platform user maps to which Principal) and channel→agent
+ * binding stay in user-land, per Latch's isolation model.
+ */
+export * from "./types.js";
+export * from "./render.js";
+export * from "./ask.js";
+export * from "./commands.js";
+export * from "./kernel.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+/**
+ * @intentface/latch-channels
+ *
+ * Bring a Latch agent to the places people talk — Slack first. The generic
+ * core here is platform-agnostic and dependency-light: a run→`RenderEvent`
+ * projection (`consumeRun`) and approval detection (`pendingApprovals`) over
+ * the runtime's public SSE contract. Per-platform adapters live in subpath
+ * exports (e.g. `@intentface/latch-channels/slack`) and only ever translate
+ * `RenderEvent`s — they never re-parse the AI stream.
+ *
+ * Identity (which platform user maps to which Principal) and channel→agent
+ * binding stay in user-land, per Latch's isolation model.
+ */
+export * from "./types.js";
+export * from "./render.js";
+export * from "./ask.js";
+export * from "./commands.js";
+export * from "./kernel.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/kernel.d.ts

@@ -0,0 +1,207 @@
+import type { AskSession, AskStateStore, AuthResult, ChannelRunOps, ChannelThreadStore, PendingApproval, TranscribeAudio } from "./types.js";
+/**
+ * The turn kernel — everything a direct-message surface (Telegram, WhatsApp,
+ * the next one) does between "a webhook arrived" and "the platform API was
+ * called", written once:
+ *
+ *   dedupe → identity gate (+ stash & link notice) → thread epoch → commands
+ *   → questionnaire answers → one-turn-per-chat lease → media fold → run
+ *   → post the answer at finish → render what the turn parked on
+ *   (approvals, then questions) → button taps back into the run.
+ *
+ * A {@link Surface} is pure protocol: how to send text, buttons and links, how
+ * to edit or retire a card, how to download an attachment. It never sees the
+ * runtime, the stores or the state machine, so a new platform is a Surface plus
+ * a webhook parser that produces {@link Inbound} events — never a re-derivation
+ * of the admission and questionnaire semantics.
+ *
+ * Answers post ONCE at finish (split past the platform's length cap). No
+ * progressive edits: the only progress signal is the surface's typing hint.
+ */
+/** An attachment reference as the platform delivered it, plus what we know about it. */
+export interface InboundMedia<Ref> {
+    ref: Ref;
+    mediaType: string;
+    name: string;
+}
+export type Inbound<User, Ref> = {
+    kind: "message";
+    user: User;
+    text: string;
+    media: InboundMedia<Ref>[];
+    /** Persistent-dedupe key; platforms redeliver until they see a 2xx. */
+    deliveryKey: string;
+} | {
+    kind: "action";
+    user: User;
+    /** The button payload — one of the strings the kernel handed the surface. */
+    data: string;
+    deliveryKey: string;
+    /** The tapped card's platform ref, when the platform reports it. */
+    card?: string;
+    /** Platform ack handle (Telegram callback_query id) — acked via `Surface.ack`. */
+    ackId?: string;
+};
+/** Button payloads the surface attaches to a question card. */
+export interface QuestionData {
+    pick(optionIndex: number): string;
+    done: string;
+}
+export interface Surface<User, Ref> {
+    /** Platform name — the log prefix; also conventionally the chat-id prefix. */
+    kind: string;
+    /** Longest message the platform accepts; longer answers are split at paragraph breaks. */
+    maxTextChars: number;
+    /** The Latch chat id for this person at a thread epoch (0 = the original, un-suffixed id). */
+    chatId(user: User, epoch: number): string;
+    /**
+     * Send a message. `rich` marks agent output (GitHub-flavoured markdown) the
+     * surface may format natively. Returns the card ref when the platform has one.
+     */
+    sendText(user: User, text: string, opts?: {
+        rich?: boolean;
+    }): Promise<string | undefined>;
+    /** A message whose point is a URL to open (identity link, OAuth connect). */
+    sendLink(user: User, body: string, label: string, url: string): Promise<void>;
+    /** Approve/Deny prompt. A tap comes back as an `action` carrying `data.approve` / `data.deny`. */
+    sendApproval(user: User, approval: PendingApproval, data: {
+        approve: string;
+        deny: string;
+    }): Promise<string | undefined>;
+    /**
+     * Post the question at `session.cursor`. Without `data` (no host ask-state)
+     * post the numbered text form — there is nothing to tap.
+     */
+    sendQuestion(user: User, session: AskSession, data?: QuestionData): Promise<string | undefined>;
+    /** Re-tick a multi-select card in place. Surfaces that cannot edit omit it. */
+    updateQuestion?(user: User, card: string, session: AskSession, data: QuestionData): Promise<void>;
+    /** Show that a question was answered — collapse the card, or post a receipt. */
+    answered(user: User, card: string | undefined, answered: {
+        question: string;
+        answer: string;
+    }): Promise<void>;
+    /** Replace a card's content (approval settled / no longer active). Omit where messages can't be edited. */
+    settleCard?(user: User, card: string, text: string, opts?: {
+        rich?: boolean;
+    }): Promise<void>;
+    /** Remove a card's buttons without changing its text. */
+    retireCard?(user: User, card: string): Promise<void>;
+    /** Progress hint ("typing…"), refreshed every few seconds while a turn runs. */
+    typing?(user: User): Promise<void>;
+    /** Acknowledge a button tap, optionally with a toast. */
+    ack?(ackId: string, text?: string): Promise<void>;
+    /** Download an attachment, or null when it's unavailable or larger than `maxBytes`. */
+    fetchMedia(media: InboundMedia<Ref>, maxBytes: number): Promise<{
+        bytes: Uint8Array;
+        mediaType: string;
+    } | null>;
+}
+export interface KernelConfig<P, User, Ref> {
+    /** The agent this bot serves. */
+    agent: string;
+    /** Stable host-side bot id — the chat-id namespace and the dedupe-key prefix. */
+    botRef: string;
+    runtime: ChannelRunOps<P>;
+    /**
+     * Resolve the inbound platform user to a principal. `{ allowed: false, linkUrl }`
+     * refuses and sends a link; the triggering message is stashed for replay.
+     */
+    authorizeUser: (user: User) => Promise<AuthResult<P>>;
+    /** Persistent dedupe: true if this delivery key was already handled. */
+    seen?: (deliveryKey: string) => Promise<boolean>;
+    /**
+     * Optional host-backed one-turn-per-chat lease: a claimant token, or null
+     * when a turn is already running (→ "still working"). Core's storage adapter
+     * already refuses a second live run per chat (`ChatBusyError`, rendered the
+     * same way), so this is only for hosts on an adapter without that invariant.
+     */
+    claimTurn?: (chatId: string) => Promise<string | null>;
+    releaseTurn?: (chatId: string, token: string) => Promise<void>;
+    /** Stash the message that triggered a link prompt, to replay after linking. */
+    stashPending?: (input: {
+        user: User;
+        text: string;
+        media?: InboundMedia<Ref>[];
+    }) => Promise<void>;
+    /** Build the platform authorize URL for a `connect_<name>` OAuth approval. */
+    authorizeUrl?: (connectionName: string, ctx: {
+        chatId: string;
+        user: User;
+        approvalId: string;
+    }) => string;
+    /**
+     * Host speech-to-text. Voice/audio reaches the agent as `[Voice message]: …`
+     * text — never a file part (chat models generally reject audio). Without it,
+     * voice-only messages get a friendly refusal.
+     */
+    transcribe?: TranscribeAudio;
+    /** Storage for in-flight questionnaires; without it questions post as text and stay answerable in the web app. */
+    askState?: AskStateStore;
+    /** Storage for the thread epoch — what makes `/new` possible on a one-conversation surface. */
+    thread?: ChannelThreadStore;
+    /** Attachments above this are skipped with a note (default 10 MB). */
+    maxInlineFileBytes?: number;
+}
+export declare function encodeApprovalData(approved: boolean, approvalId: string): string;
+export declare function decodeApprovalData(data: string | undefined): {
+    approved: boolean;
+    approvalId: string;
+} | null;
+/** Length of the session nonce carried in button payloads. */
+export declare const ASK_NONCE_LENGTH = 6;
+export type QuestionPayload = {
+    verb: "pick";
+    nonce: string;
+    questionIndex: number;
+    optionIndex: number;
+} | {
+    verb: "done";
+    nonce: string;
+    questionIndex: number;
+};
+export declare function encodeQuestionData(cb: QuestionPayload): string;
+export declare function decodeQuestionData(data: string | undefined): QuestionPayload | null;
+export declare function newMessageId(): string;
+/** Short random token pinning button payloads to one posted questionnaire. */
+export declare function newNonce(): string;
+/** Split text into ≤`max`-char messages, preferring paragraph/line breaks. */
+export declare function splitText(text: string, max: number): string[];
+/**
+ * Run `fn` under the one-turn-per-chat lease. Every path that mutates a chat's
+ * run state — fresh turns, replays, approval resumes, questionnaire submits —
+ * goes through here, so two of them can never interleave on one chat. When the
+ * lease is held, `onBusy` runs instead (the "still working" notice).
+ */
+export declare function withTurnLease(lease: {
+    claimTurn?: (chatId: string) => Promise<string | null>;
+    releaseTurn?: (chatId: string, token: string) => Promise<void>;
+}, chatId: string, onBusy: () => Promise<unknown>, fn: () => Promise<void>): Promise<void>;
+export interface TurnKernel<P, User, Ref> {
+    /** Route one parsed webhook event. Runs post-ACK (the caller defers it). */
+    handleInbound(ev: Inbound<User, Ref>): Promise<void>;
+    /**
+     * Run one user message against the agent and render it — WITHOUT the auth
+     * gate or turn lease (callers hold those). `chatId` skips the thread lookup
+     * when the caller already resolved it.
+     */
+    runMessage(ctx: {
+        user: User;
+        text: string;
+        media?: InboundMedia<Ref>[];
+        principal: P;
+        chatId?: string;
+    }): Promise<void>;
+    /**
+     * Replay one already-gated message under the turn lease — the post-link
+     * resume. The gate passed by linking; the lease still must be honoured or a
+     * racing webhook message starts a second run on the same history.
+     */
+    replayMessage(ctx: {
+        user: User;
+        text: string;
+        media?: InboundMedia<Ref>[];
+        principal: P;
+    }): Promise<void>;
+}
+export declare function createTurnKernel<P, User, Ref>(cfg: KernelConfig<P, User, Ref>, surface: Surface<User, Ref>): TurnKernel<P, User, Ref>;
+//# sourceMappingURL=kernel.d.ts.map

package/dist/kernel.d.ts.map

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