@adonis-agora/agent 0.76.3 → 0.77.1

package/dist/src/poppy/handler.js

@@ -0,0 +1,362 @@
+import { globalPoppyAuthenticate, globalPoppyIssuer, } from './auth.js';
+import { isPoppyId, PoppyError, parseEmptyBody, parseSendBody } from './protocol.js';
+/** Match the path after the endpoint: `null` → 404, a method mismatch → 405. */
+function matchRoute(method, rest) {
+    const allow = (expected, route) => (method === expected ? route : 405);
+    if (rest.length === 0)
+        return allow('POST', { kind: 'start' });
+    if (rest.length !== 2)
+        return 404;
+    const [id = '', action] = rest;
+    switch (action) {
+        case 'messages':
+            return allow('POST', { kind: 'messages', id });
+        case 'events':
+            return allow('GET', { kind: 'events', id });
+        case 'handoff':
+            return allow('POST', { kind: 'handoff', id });
+        case 'close':
+            return allow('POST', { kind: 'close', id });
+        default:
+            return 404;
+    }
+}
+/** The scheme the request authenticated with — what a challenge of ours is written in. */
+function schemeOf(exchange) {
+    const header = exchange.headers.authorization ?? '';
+    return /^bearer\s/i.test(header) ? 'Bearer' : 'DPoP';
+}
+/** `wait` in ms, capped; absent → 0. */
+function waitMs(exchange, maxSeconds) {
+    const raw = exchange.query.wait;
+    if (raw === undefined || raw === '')
+        return 0;
+    const seconds = Number(raw);
+    if (!Number.isFinite(seconds) || seconds < 0) {
+        throw new PoppyError('invalid_request', 'wait must be a non-negative number of seconds');
+    }
+    return Math.min(seconds, maxSeconds) * 1000;
+}
+function cursorOf(exchange, header = false) {
+    const raw = (header ? exchange.headers['last-event-id'] : undefined) ?? exchange.query.cursor;
+    return raw === undefined || raw === '' ? undefined : raw.trim();
+}
+/**
+ * The Poppy conversation endpoint (§7) — `POST {endpoint}`, `POST {endpoint}/{id}/messages`,
+ * `GET {endpoint}/{id}/events` (JSON, long-poll with `wait`, or SSE), `POST …/handoff` and
+ * `POST …/close`. Returns a handler that answers everything under `/{path}` and reports `false`
+ * for anything else, so it can sit in front of the router.
+ *
+ * Every request is authenticated BEFORE its body is read, by the resolver of
+ * `Symbol.for('@adonis-agora/poppy:authenticate')` (`@adonis-agora/authkit-server`) or the one
+ * given. Without either the endpoint answers `501`.
+ *
+ * @experimental Tracks Personal Agent Protocol Draft 0.1 (https://personalagentprotocol.org/docs/spec),
+ * a spec still in development: this API WILL change as the spec evolves — possibly in breaking
+ * ways, outside semver majors while it is a draft.
+ */
+export function createPoppyHandler(options) {
+    const base = `/${options.path}`;
+    const maxBody = options.maxBodyBytes ?? 1024 * 1024;
+    const maxWait = options.maxWaitSeconds ?? 30;
+    const conversations = options.conversations;
+    async function authenticate(exchange) {
+        const resolver = options.authenticate ?? globalPoppyAuthenticate();
+        if (!resolver) {
+            throw new PoppyError('not_implemented', 'Poppy conversations are not enabled: no Session Token resolver is installed');
+        }
+        // No options: a turn's scopes are decided per tool, and the `resource` a token must carry is
+        // the resolver's to derive from the URL (the `resource` of the `poppy` protocol entry, if any).
+        const result = await resolver({
+            method: exchange.method,
+            url: exchange.url,
+            headers: exchange.rawHeaders,
+        });
+        if (result.ok)
+            return result.principal;
+        exchange.json(result.status, {
+            error: result.error,
+            ...(result.description !== undefined ? { error_description: result.description } : {}),
+            ...(result.scope !== undefined ? { scope: result.scope } : {}),
+        }, {
+            ...(result.headers ?? {}),
+            'WWW-Authenticate': result.wwwAuthenticate,
+            'Cache-Control': 'no-store',
+        });
+        return null;
+    }
+    async function stream(exchange, principal, id) {
+        const conversation = await conversations.owned(principal, id);
+        const controller = new AbortController();
+        const stop = () => controller.abort();
+        const iterator = conversations.stream(conversation, cursorOf(exchange, true), controller.signal);
+        let first;
+        try {
+            // The cursor is checked before the stream opens, so a bad one is still a JSON error.
+            first = await iterator.next();
+        }
+        catch (error) {
+            await iterator.return(undefined);
+            throw error;
+        }
+        const writer = exchange.openStream({
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache, no-transform',
+            Connection: 'keep-alive',
+            'X-Accel-Buffering': 'no',
+        });
+        writer.signal.addEventListener('abort', stop, { once: true });
+        if (writer.signal.aborted)
+            stop();
+        const maxTimer = setTimeout(stop, options.streamMaxMs ?? 300_000);
+        const keepAlive = setInterval(() => writer.write(': keep-alive\n\n'), options.keepAliveMs ?? 15_000);
+        maxTimer.unref?.();
+        keepAlive.unref?.();
+        try {
+            let next = first;
+            while (!next.done) {
+                const item = next.value;
+                if (item.kind === 'event') {
+                    writer.write(`id: ${item.event.id}\ndata: ${JSON.stringify(item.event)}\n\n`);
+                }
+                else if (item.kind === 'delta') {
+                    writer.write(`event: text-delta\ndata: ${JSON.stringify({ message_id: item.messageId, text: item.text })}\n\n`);
+                }
+                next = await iterator.next();
+            }
+        }
+        finally {
+            clearTimeout(maxTimer);
+            clearInterval(keepAlive);
+            await iterator.return(undefined);
+            writer.end();
+        }
+    }
+    async function route(exchange, route) {
+        const principal = await authenticate(exchange);
+        if (principal === null)
+            return;
+        switch (route.kind) {
+            case 'start': {
+                const body = parseSendBody(await exchange.readBody(maxBody), { allowParent: true });
+                const started = await conversations.start(principal, body);
+                return answerPost(exchange, principal, started.conversationId, started);
+            }
+            case 'messages': {
+                if (!isPoppyId(route.id))
+                    throw new PoppyError('conversation_not_found');
+                // The conversation is checked before the body is parsed: an unknown one is a 404.
+                await conversations.owned(principal, route.id);
+                const body = parseSendBody(await exchange.readBody(maxBody), { allowParent: false });
+                const sent = await conversations.send(principal, route.id, body);
+                return answerPost(exchange, principal, route.id, sent);
+            }
+            case 'events': {
+                if (!isPoppyId(route.id))
+                    throw new PoppyError('conversation_not_found');
+                if ((exchange.headers.accept ?? '').includes('text/event-stream')) {
+                    return stream(exchange, principal, route.id);
+                }
+                const wait = waitMs(exchange, maxWait);
+                const cursor = cursorOf(exchange);
+                const result = await conversations.read(principal, route.id, {
+                    ...(cursor !== undefined ? { cursor } : {}),
+                    waitMs: wait,
+                });
+                return exchange.json(200, result);
+            }
+            case 'handoff': {
+                if (!isPoppyId(route.id))
+                    throw new PoppyError('conversation_not_found');
+                await conversations.owned(principal, route.id);
+                parseEmptyBody(await exchange.readBody(maxBody));
+                const state = await conversations.requestHandoff(principal, route.id);
+                return exchange.json(202, { conversation_id: route.id, ...state });
+            }
+            case 'close': {
+                if (!isPoppyId(route.id))
+                    throw new PoppyError('conversation_not_found');
+                await conversations.owned(principal, route.id);
+                parseEmptyBody(await exchange.readBody(maxBody));
+                const state = await conversations.closeByAgent(principal, route.id);
+                return exchange.json(200, { conversation_id: route.id, ...state });
+            }
+        }
+    }
+    /**
+     * A message POST's answer: its status and body — or, with `wait`, a read of the events from
+     * `cursor` (the start without one), still under the POST's status (§7.3).
+     */
+    async function answerPost(exchange, principal, conversationId, answer) {
+        if (exchange.query.wait === undefined)
+            return exchange.json(answer.status, answer.body);
+        const wait = waitMs(exchange, maxWait);
+        const conversation = await conversations.owned(principal, conversationId);
+        const cursor = cursorOf(exchange);
+        const read = await conversations.readOwned(conversation, {
+            ...(cursor !== undefined ? { cursor } : {}),
+            waitMs: wait,
+        });
+        return exchange.json(answer.status, read);
+    }
+    return async function handle(exchange) {
+        const path = exchange.path.replace(/\/+$/, '');
+        if (path !== base && !path.startsWith(`${base}/`))
+            return false;
+        const rest = path
+            .slice(base.length)
+            .split('/')
+            .filter((segment) => segment !== '');
+        let decoded;
+        try {
+            decoded = rest.map((segment) => decodeURIComponent(segment));
+        }
+        catch {
+            decoded = ['', ''];
+        }
+        const matched = matchRoute(exchange.method.toUpperCase(), decoded);
+        try {
+            if (matched === 404)
+                throw new PoppyError('not_found');
+            if (matched === 405)
+                throw new PoppyError('method_not_allowed');
+            await route(exchange, matched);
+        }
+        catch (error) {
+            const poppy = error instanceof PoppyError
+                ? error
+                : error?.name === 'PoppyError'
+                    ? error
+                    : null;
+            if (poppy === null)
+                options.onError?.(error);
+            const answer = poppy ?? new PoppyError('server_error', 'Internal error');
+            exchange.json(answer.status, answer.toJSON(), answer.code === 'sign_in_required'
+                ? { 'WWW-Authenticate': `${schemeOf(exchange)} error="sign_in_required"` }
+                : answer.code === 'method_not_allowed'
+                    ? { Allow: matched === 405 ? allowFor(decoded) : '' }
+                    : {});
+        }
+        return true;
+    };
+}
+function allowFor(rest) {
+    return rest.length === 2 && rest[1] === 'events' ? 'GET' : 'POST';
+}
+// ── exchanges ─────────────────────────────────────────────────────────────────
+function rawLowerHeaders(headers) {
+    const out = {};
+    for (const [name, value] of Object.entries(headers))
+        out[name.toLowerCase()] = value;
+    return out;
+}
+function lowerHeaders(headers) {
+    const out = {};
+    for (const [name, value] of Object.entries(headers)) {
+        out[name.toLowerCase()] = Array.isArray(value) ? value.join(', ') : value;
+    }
+    return out;
+}
+async function readStream(source, limit) {
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of source) {
+        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        size += buffer.length;
+        if (size > limit)
+            throw new PoppyError('request_too_large', 'Request body is too large');
+        chunks.push(buffer);
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+function writer(res, req) {
+    const controller = new AbortController();
+    const abort = () => controller.abort();
+    req.on('close', abort);
+    res.on('close', abort);
+    return {
+        write: (chunk) => {
+            if (!res.writableEnded)
+                res.write(chunk);
+        },
+        end: () => {
+            if (!res.writableEnded)
+                res.end();
+        },
+        signal: controller.signal,
+    };
+}
+/** A {@link PoppyExchange} over a plain Node request — any framework, or a bare `http` server. */
+export function nodeExchange(req, res, options) {
+    const target = new URL(req.url ?? '/', options.origin);
+    return {
+        method: req.method ?? 'GET',
+        path: target.pathname,
+        query: Object.fromEntries(target.searchParams),
+        url: target.toString(),
+        headers: lowerHeaders(req.headers),
+        rawHeaders: rawLowerHeaders(req.headers),
+        readBody: (limit) => readStream(req, limit),
+        json(status, body, headers = {}) {
+            res.writeHead(status, { 'Content-Type': 'application/json', ...headers });
+            res.end(JSON.stringify(body));
+        },
+        openStream(headers) {
+            res.writeHead(200, headers);
+            res.flushHeaders?.();
+            return writer(res, req);
+        },
+    };
+}
+/**
+ * The public origin of a request: `baseUrl` when configured; else the request's protocol and host
+ * (Adonis honours `X-Forwarded-*` from trusted proxies) — upgraded to `https` when the Poppy issuer
+ * is, as a TLS-terminating proxy would otherwise make every DPoP `htu` mismatch.
+ */
+export function publicOrigin(request, baseUrl, issuer = globalPoppyIssuer()) {
+    if (baseUrl !== undefined)
+        return baseUrl.replace(/\/+$/, '');
+    const protocol = request.protocol === 'http' && issuer?.startsWith('https:') ? 'https' : request.protocol;
+    return `${protocol}://${request.host}`;
+}
+/** A {@link PoppyExchange} over an Adonis request — what the Poppy server middleware builds. */
+export function adonisExchange(ctx, options) {
+    const origin = publicOrigin({ protocol: ctx.request.protocol(), host: ctx.request.host() ?? 'localhost' }, options.baseUrl);
+    const original = ctx.request.url(true) ?? ctx.request.url() ?? '/';
+    const target = new URL(original, `${origin}/`);
+    return {
+        method: ctx.request.method(),
+        path: target.pathname,
+        query: Object.fromEntries(target.searchParams),
+        url: `${origin}${target.pathname}${target.search}`,
+        headers: lowerHeaders(ctx.request.headers()),
+        rawHeaders: rawLowerHeaders(ctx.request.headers()),
+        async readBody(limit) {
+            // Mounted ahead of the bodyparser: the body is still on the socket.
+            const parsed = ctx.request.raw?.();
+            if (typeof parsed === 'string')
+                return parsed;
+            return readStream(ctx.request.request, limit);
+        },
+        json(status, body, headers = {}) {
+            ctx.response.status(status);
+            for (const [name, value] of Object.entries(headers))
+                ctx.response.header(name, value);
+            ctx.response.header('Content-Type', 'application/json');
+            ctx.response.send(JSON.stringify(body));
+        },
+        openStream(headers) {
+            const raw = ctx.response.response;
+            // Headers the request already set (a cookie) — `writeHead` on the raw response skips them.
+            for (const [name, value] of Object.entries(ctx.response.getHeaders())) {
+                if (value !== undefined && !(name in headers)) {
+                    raw.setHeader(name, value);
+                }
+            }
+            raw.writeHead(200, headers);
+            raw.flushHeaders?.();
+            return writer(raw, ctx.request.request);
+        },
+    };
+}
+//# sourceMappingURL=handler.js.map

package/dist/src/poppy/handler.js.map

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

package/dist/src/poppy/index.d.ts

@@ -0,0 +1,17 @@
+export type { PoppyAuthenticate, PoppyAuthFailure, PoppyAuthOptions, PoppyAuthRequest, PoppyAuthResult, PoppyPrincipal, } from './auth.js';
+export { globalPoppyAuthenticate, globalPoppyIssuer, POPPY_AUTHENTICATE_SLOT } from './auth.js';
+export type { PoppyActionFormatter, PoppyActionOutcome, PoppyConversationsOptions, PoppyDirectHooks, PoppyHandoffDecision, PoppyHandoffHooks, PoppyHookContext, PoppyReadResult, PoppyStreamItem, PoppyTexts, } from './conversations.js';
+export { DEFAULT_POPPY_TEXTS, formatPoppyAction, PoppyConversations, poppyActorId, } from './conversations.js';
+export type { PoppyConfig } from './define_config.js';
+export { definePoppyConfig } from './define_config.js';
+export type { PoppyEndpoints } from './endpoints.js';
+export { announcedPoppyEndpoints, announcePoppyEndpoints, POPPY_ENDPOINTS_SLOT, poppyConversationsUrl, } from './endpoints.js';
+export type { PoppyExchange, PoppyHandlerOptions, PoppyStreamWriter } from './handler.js';
+export { adonisExchange, createPoppyHandler, nodeExchange, publicOrigin } from './handler.js';
+export type { PoppyContext, PoppyErrorCode, PoppyEvent, PoppyEventBody, PoppyEventMessage, PoppyEventType, PoppyInboundMessage, PoppyResponder, PoppySender, PoppyStatus, } from './protocol.js';
+export { POPPY_PROTOCOL_TYPE, POPPY_PROTOCOL_VERSION, POPPY_READ_SCOPE, POPPY_WRITE_SCOPE, PoppyError, } from './protocol.js';
+export type { PoppyRedisClient, RedisPoppyStoreOptions } from './redis-store.js';
+export { redisPoppyStore } from './redis-store.js';
+export type { LucidPoppyStoreOptions, PoppyConversationPatch, PoppyConversationRecord, PoppyGrant, PoppyMessageClaim, PoppyMessageReceipt, PoppyStore, StoredPoppyEvent, } from './store.js';
+export { ensurePoppyTables, InMemoryPoppyStore, LucidPoppyStore, POPPY_TABLES, poppyTableStatements, } from './store.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/poppy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/poppy/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAChG,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,UAAU,GACX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC9F,YAAY,EACV,YAAY,EACZ,cAAc,EACd,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EACV,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,UAAU,EACV,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/src/poppy/index.js

@@ -0,0 +1,9 @@
+export { globalPoppyAuthenticate, globalPoppyIssuer, POPPY_AUTHENTICATE_SLOT } from './auth.js';
+export { DEFAULT_POPPY_TEXTS, formatPoppyAction, PoppyConversations, poppyActorId, } from './conversations.js';
+export { definePoppyConfig } from './define_config.js';
+export { announcedPoppyEndpoints, announcePoppyEndpoints, POPPY_ENDPOINTS_SLOT, poppyConversationsUrl, } from './endpoints.js';
+export { adonisExchange, createPoppyHandler, nodeExchange, publicOrigin } from './handler.js';
+export { POPPY_PROTOCOL_TYPE, POPPY_PROTOCOL_VERSION, POPPY_READ_SCOPE, POPPY_WRITE_SCOPE, PoppyError, } from './protocol.js';
+export { redisPoppyStore } from './redis-store.js';
+export { ensurePoppyTables, InMemoryPoppyStore, LucidPoppyStore, POPPY_TABLES, poppyTableStatements, } from './store.js';
+//# sourceMappingURL=index.js.map

package/dist/src/poppy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/poppy/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAahG,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAa9F,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,GACX,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAWnD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/src/poppy/protocol.d.ts

@@ -0,0 +1,132 @@
+/**
+ * The wire format of Personal Agent Protocol ("Poppy", Draft 0.1, §7) conversations: messages,
+ * events, statuses and the error codes of §7.13. Hand-rolled like the A2A surface — the rules are
+ * few and exact, and unknown fields are ignored everywhere (§3.1, §3.3).
+ *
+ * @experimental Tracks Personal Agent Protocol Draft 0.1 (https://personalagentprotocol.org/docs/spec),
+ * a spec still in development: this API WILL change as the spec evolves — possibly in breaking
+ * ways, outside semver majors while it is a draft.
+ */
+/** The `protocol_version` this surface implements. */
+export declare const POPPY_PROTOCOL_VERSION = "0.1";
+/** The `type` of this surface's entry in `poppy.json` `agent.protocols` (§7.1). */
+export declare const POPPY_PROTOCOL_TYPE = "poppy";
+/** The account scopes the protocol defines (§4.4). Companies may add their own. */
+export declare const POPPY_READ_SCOPE = "poppy:read";
+export declare const POPPY_WRITE_SCOPE = "poppy:write";
+export type PoppyStatus = 'working' | 'idle' | 'queued' | 'closed';
+export type PoppyResponder = 'agent' | 'human';
+export type PoppySender = 'agent' | 'human';
+/** Facts about the User's situation (§7.4). Other fields are kept as sent. */
+export interface PoppyContext {
+    locale?: string;
+    time_zone?: string;
+    user_available?: boolean;
+    [field: string]: unknown;
+}
+/** A message as the Personal Agent sends it (§7.4). */
+export interface PoppyInboundMessage {
+    id: string;
+    sender: PoppySender;
+    text?: string;
+    data?: Record<string, unknown>;
+    context?: PoppyContext;
+}
+/** A message as it appears in a `message` event (§7.5): `role` says which side it came from. */
+export interface PoppyEventMessage {
+    id: string;
+    role: 'user' | 'company';
+    sender: PoppySender;
+    text?: string;
+    data?: Record<string, unknown>;
+    context?: PoppyContext;
+}
+export type PoppyEventType = 'message' | 'state' | 'authorization' | 'user_requested' | 'direct_opened' | 'direct_closed';
+/** One event of a conversation (§7.5): `id`, `type`, `created_at`, and the type's own fields. */
+export interface PoppyEvent {
+    id: string;
+    type: PoppyEventType | (string & {});
+    created_at: string;
+    [field: string]: unknown;
+}
+/** The type-specific fields of a new event — what the store appends. */
+export type PoppyEventBody = {
+    type: 'message';
+    message: PoppyEventMessage;
+} | {
+    type: 'state';
+    status: PoppyStatus;
+    responder: PoppyResponder;
+} | {
+    type: 'authorization';
+    error: 'sign_in_required' | 'insufficient_scope';
+    scope?: string;
+} | {
+    type: 'user_requested';
+    reason: string;
+} | {
+    type: 'direct_opened' | 'direct_closed';
+    conversation_id: string;
+};
+/** The conversation errors of §7.13, plus the request errors this surface answers. */
+declare const ERRORS: {
+    readonly conversation_not_found: 404;
+    readonly conversation_closed: 409;
+    readonly direct_conversation_open: 409;
+    readonly message_id_conflict: 409;
+    readonly invalid_cursor: 400;
+    readonly cursor_expired: 410;
+    readonly invalid_request: 400;
+    /** §3.3 — a request handled only with an extension the Personal Agent does not list. */
+    readonly extension_required: 403;
+    readonly sign_in_required: 403;
+    readonly not_found: 404;
+    readonly method_not_allowed: 405;
+    readonly request_too_large: 413;
+    readonly not_implemented: 501;
+    readonly server_error: 500;
+};
+export type PoppyErrorCode = keyof typeof ERRORS;
+/**
+ * A Poppy error, answered as `{ "error": code, … }` like an OAuth error response (§7.13). `extra`
+ * carries what a code adds — `conversation_id` for `direct_conversation_open`, `extension` for
+ * `extension_required`. An app hook may throw one to refuse a request.
+ */
+export declare class PoppyError extends Error {
+    readonly code: PoppyErrorCode;
+    readonly extra: Record<string, unknown>;
+    constructor(code: PoppyErrorCode, description?: string, extra?: Record<string, unknown>);
+    get status(): number;
+    toJSON(): Record<string, unknown>;
+}
+export declare function isPoppyId(value: unknown): value is string;
+/** A new id of `kind` — `cnv_…`, `msg_…`, `evt_…`. */
+export declare function newPoppyId(prefix: 'cnv' | 'msg'): string;
+/** A stable id derived from `seed` — what lets a re-read turn produce the same company message. */
+export declare function derivedPoppyId(prefix: 'msg', seed: string): string;
+/** A validated `POST {endpoint}` / `POST {endpoint}/{id}/messages` body. */
+export interface PoppySendBody {
+    message: PoppyInboundMessage;
+    /** Only on `POST {endpoint}`: start a Direct Conversation under this one (§7.10). */
+    parentConversationId?: string;
+}
+/**
+ * Parse a message request (§7.3, §7.4). Unknown fields — on the body, the message or its context —
+ * are ignored, never refused (§3.3). Only the fields the protocol defines are kept.
+ */
+export declare function parseSendBody(raw: string, opts: {
+    allowParent: boolean;
+}): PoppySendBody;
+/**
+ * The fingerprint a retry is compared by (§7.3): the message's content and, for a first message,
+ * the conversation it was addressed to. Unknown fields were dropped by the parser, so a retry that
+ * adds one is still the same message.
+ */
+export declare function messageFingerprint(target: string, body: PoppySendBody): string;
+/**
+ * A request body that must be an empty JSON object (handoff, close) — anything else is tolerated:
+ * extensions may add fields (§3.3). Only malformed JSON is refused.
+ */
+export declare function parseEmptyBody(raw: string): void;
+export {};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/src/poppy/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/poppy/protocol.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,sDAAsD;AACtD,eAAO,MAAM,sBAAsB,QAAQ,CAAC;AAE5C,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAE3C,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,eAAe,CAAC;AAC7C,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAE/C,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACnE,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,CAAC;AAC/C,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5C,8EAA8E;AAC9E,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,uDAAuD;AACvD,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAED,gGAAgG;AAChG,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,OAAO,GACP,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,eAAe,CAAC;AAEpB,iGAAiG;AACjG,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,cAAc,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,wEAAwE;AACxE,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,cAAc,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,kBAAkB,GAAG,oBAAoB,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3F;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,eAAe,GAAG,eAAe,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzE,sFAAsF;AACtF,QAAA,MAAM,MAAM;aACV,sBAAsB,EAAE,GAAG;aAC3B,mBAAmB,EAAE,GAAG;aACxB,wBAAwB,EAAE,GAAG;aAC7B,mBAAmB,EAAE,GAAG;aACxB,cAAc,EAAE,GAAG;aACnB,cAAc,EAAE,GAAG;aACnB,eAAe,EAAE,GAAG;IACpB,wFAAwF;aACxF,kBAAkB,EAAE,GAAG;aACvB,gBAAgB,EAAE,GAAG;aACrB,SAAS,EAAE,GAAG;aACd,kBAAkB,EAAE,GAAG;aACvB,iBAAiB,EAAE,GAAG;aACtB,eAAe,EAAE,GAAG;aACpB,YAAY,EAAE,GAAG;CACT,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,MAAM,CAAC;AAEjD;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,KAAK;IAEjC,QAAQ,CAAC,IAAI,EAAE,cAAc;IAE7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAHzC,YACW,IAAI,EAAE,cAAc,EAC7B,WAAW,CAAC,EAAE,MAAM,EACX,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAI7C;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMhC;CACF;AAKD,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEzD;AAED,sDAAsD;AACtD,wBAAgB,UAAU,CAAC,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAExD;AAED,mGAAmG;AACnG,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAElE;AAMD,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,qFAAqF;IACrF,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,WAAW,EAAE,OAAO,CAAA;CAAE,GAAG,aAAa,CA4DxF;AAeD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,CAI9E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAOhD"}