@adonis-agora/agent 0.76.2 → 0.77.0

package/dist/src/poppy/protocol.js

@@ -0,0 +1,178 @@
+import { createHash, randomBytes } from 'node:crypto';
+/**
+ * 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 const POPPY_PROTOCOL_VERSION = '0.1';
+/** The `type` of this surface's entry in `poppy.json` `agent.protocols` (§7.1). */
+export const POPPY_PROTOCOL_TYPE = 'poppy';
+/** The account scopes the protocol defines (§4.4). Companies may add their own. */
+export const POPPY_READ_SCOPE = 'poppy:read';
+export const POPPY_WRITE_SCOPE = 'poppy:write';
+/** The conversation errors of §7.13, plus the request errors this surface answers. */
+const ERRORS = {
+    conversation_not_found: 404,
+    conversation_closed: 409,
+    direct_conversation_open: 409,
+    message_id_conflict: 409,
+    invalid_cursor: 400,
+    cursor_expired: 410,
+    invalid_request: 400,
+    /** §3.3 — a request handled only with an extension the Personal Agent does not list. */
+    extension_required: 403,
+    sign_in_required: 403,
+    not_found: 404,
+    method_not_allowed: 405,
+    request_too_large: 413,
+    not_implemented: 501,
+    server_error: 500,
+};
+/**
+ * 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 class PoppyError extends Error {
+    code;
+    extra;
+    constructor(code, description, extra = {}) {
+        super(description ?? code);
+        this.code = code;
+        this.extra = extra;
+        this.name = 'PoppyError';
+    }
+    get status() {
+        return ERRORS[this.code];
+    }
+    toJSON() {
+        return {
+            error: this.code,
+            ...(this.message !== this.code ? { error_description: this.message } : {}),
+            ...this.extra,
+        };
+    }
+}
+/** IDs are 1–256 characters of the URL-safe base64 alphabet (§7.2). */
+const ID_PATTERN = /^[A-Za-z0-9_-]{1,256}$/;
+export function isPoppyId(value) {
+    return typeof value === 'string' && ID_PATTERN.test(value);
+}
+/** A new id of `kind` — `cnv_…`, `msg_…`, `evt_…`. */
+export function newPoppyId(prefix) {
+    return `${prefix}_${randomBytes(12).toString('base64url')}`;
+}
+/** A stable id derived from `seed` — what lets a re-read turn produce the same company message. */
+export function derivedPoppyId(prefix, seed) {
+    return `${prefix}_${createHash('sha256').update(seed).digest('base64url').slice(0, 22)}`;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * 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 function parseSendBody(raw, opts) {
+    let body;
+    try {
+        body = raw.trim() === '' ? undefined : JSON.parse(raw);
+    }
+    catch {
+        throw new PoppyError('invalid_request', 'The request body is not valid JSON');
+    }
+    if (!isRecord(body) || !isRecord(body.message)) {
+        throw new PoppyError('invalid_request', 'message is required');
+    }
+    const message = body.message;
+    if (!isPoppyId(message.id)) {
+        throw new PoppyError('invalid_request', 'message.id must be 1-256 URL-safe base64 characters');
+    }
+    if (message.sender !== 'agent' && message.sender !== 'human') {
+        throw new PoppyError('invalid_request', 'message.sender must be "agent" or "human"');
+    }
+    if (message.text !== undefined && typeof message.text !== 'string') {
+        throw new PoppyError('invalid_request', 'message.text must be a string');
+    }
+    if (message.data !== undefined && !isRecord(message.data)) {
+        throw new PoppyError('invalid_request', 'message.data must be a JSON object');
+    }
+    if (message.context !== undefined && !isRecord(message.context)) {
+        throw new PoppyError('invalid_request', 'message.context must be a JSON object');
+    }
+    if (message.text === undefined && message.data === undefined && message.context === undefined) {
+        throw new PoppyError('invalid_request', 'A message needs text, data or context');
+    }
+    const context = message.context;
+    if (context !== undefined) {
+        if (context.locale !== undefined && typeof context.locale !== 'string') {
+            throw new PoppyError('invalid_request', 'context.locale must be a string');
+        }
+        if (context.time_zone !== undefined && typeof context.time_zone !== 'string') {
+            throw new PoppyError('invalid_request', 'context.time_zone must be a string');
+        }
+        if (context.user_available !== undefined && typeof context.user_available !== 'boolean') {
+            throw new PoppyError('invalid_request', 'context.user_available must be a boolean');
+        }
+    }
+    let parentConversationId;
+    if (opts.allowParent && body.parent_conversation_id !== undefined) {
+        if (!isPoppyId(body.parent_conversation_id)) {
+            throw new PoppyError('conversation_not_found', 'Unknown parent_conversation_id');
+        }
+        parentConversationId = body.parent_conversation_id;
+    }
+    return {
+        message: {
+            id: message.id,
+            sender: message.sender,
+            ...(message.text !== undefined ? { text: message.text } : {}),
+            ...(message.data !== undefined ? { data: message.data } : {}),
+            ...(context !== undefined ? { context: { ...context } } : {}),
+        },
+        ...(parentConversationId !== undefined ? { parentConversationId } : {}),
+    };
+}
+/** Stable JSON: object keys sorted, so equal content hashes equally whatever its key order. */
+function canonical(value) {
+    if (Array.isArray(value))
+        return `[${value.map(canonical).join(',')}]`;
+    if (isRecord(value)) {
+        return `{${Object.keys(value)
+            .sort()
+            .filter((key) => value[key] !== undefined)
+            .map((key) => `${JSON.stringify(key)}:${canonical(value[key])}`)
+            .join(',')}}`;
+    }
+    return JSON.stringify(value) ?? 'null';
+}
+/**
+ * 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 function messageFingerprint(target, body) {
+    return createHash('sha256')
+        .update(canonical({ target, parent: body.parentConversationId ?? null, ...body.message }))
+        .digest('base64url');
+}
+/**
+ * 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 function parseEmptyBody(raw) {
+    if (raw.trim() === '')
+        return;
+    try {
+        JSON.parse(raw);
+    }
+    catch {
+        throw new PoppyError('invalid_request', 'The request body is not valid JSON');
+    }
+}
+//# sourceMappingURL=protocol.js.map

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

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

package/dist/src/poppy/redis-store.d.ts

@@ -0,0 +1,27 @@
+import { type PoppyStore } from './store.js';
+/**
+ * The slice of a Redis client {@link redisPoppyStore} uses — an `@adonisjs/redis` connection
+ * (ioredis) has it: `redisPoppyStore(redis.connection('main'))`.
+ */
+export interface PoppyRedisClient {
+    get(key: string): Promise<string | null>;
+    mget(...keys: string[]): Promise<(string | null)[]>;
+    set(key: string, value: string, ...args: (string | number)[]): Promise<unknown>;
+    del(...keys: string[]): Promise<unknown>;
+    incr(key: string): Promise<number>;
+}
+export interface RedisPoppyStoreOptions {
+    /** Key prefix. Default `'agent:poppy:'`. */
+    prefix?: string;
+}
+/**
+ * A {@link PoppyStore} shared by every replica, over Redis. Positions come from `INCR`, so two
+ * appends never share one; a message claim, an event key and the reader lease are `SET … NX`.
+ * Conversations are JSON values; events one key each (`…:evt:<conversation>:<seq>`).
+ *
+ * @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 declare function redisPoppyStore(redis: PoppyRedisClient, options?: RedisPoppyStoreOptions): PoppyStore;
+//# sourceMappingURL=redis-store.d.ts.map

package/dist/src/poppy/redis-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-store.d.ts","sourceRoot":"","sources":["../../../src/poppy/redis-store.ts"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,UAAU,EAEhB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChF,GAAG,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,gBAAgB,EACvB,OAAO,GAAE,sBAA2B,GACnC,UAAU,CA8IZ"}

package/dist/src/poppy/redis-store.js

@@ -0,0 +1,148 @@
+import { newEventId, } from './store.js';
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+ * A {@link PoppyStore} shared by every replica, over Redis. Positions come from `INCR`, so two
+ * appends never share one; a message claim, an event key and the reader lease are `SET … NX`.
+ * Conversations are JSON values; events one key each (`…:evt:<conversation>:<seq>`).
+ *
+ * @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 redisPoppyStore(redis, options = {}) {
+    const p = options.prefix ?? 'agent:poppy:';
+    const k = {
+        conversation: (id) => `${p}cnv:${id}`,
+        seq: (id) => `${p}seq:${id}`,
+        event: (id, seq) => `${p}evt:${id}:${seq}`,
+        eventId: (id, eventId) => `${p}evtid:${id}:${eventId}`,
+        eventKey: (id, key) => `${p}evtkey:${id}:${key}`,
+        message: (owner, messageId) => `${p}msg:${owner}:${messageId}`,
+        lease: (id) => `${p}lease:${id}`,
+    };
+    const getConversation = async (id) => {
+        const raw = await redis.get(k.conversation(id));
+        return raw === null ? null : JSON.parse(raw);
+    };
+    const lastSeq = async (id) => Number.parseInt((await redis.get(k.seq(id))) ?? '0', 10) || 0;
+    return {
+        async createConversation(record) {
+            await redis.set(k.conversation(record.id), JSON.stringify(record));
+        },
+        getConversation,
+        async updateConversation(id, patch) {
+            const current = await getConversation(id);
+            if (!current)
+                return;
+            await redis.set(k.conversation(id), JSON.stringify({ ...current, ...patch, updatedAt: Date.now() }));
+        },
+        async appendEvent(conversationId, body, opts = {}) {
+            if (opts.key !== undefined) {
+                const keyKey = k.eventKey(conversationId, opts.key);
+                if ((await redis.set(keyKey, 'pending', 'NX')) === null) {
+                    // Taken: answer the event it points at (once its writer has numbered it).
+                    for (let i = 0; i < 100; i++) {
+                        const seq = Number.parseInt((await redis.get(keyKey)) ?? '', 10);
+                        if (Number.isSafeInteger(seq)) {
+                            const raw = await redis.get(k.event(conversationId, seq));
+                            if (raw !== null) {
+                                return { event: { seq, event: JSON.parse(raw) }, created: false };
+                            }
+                        }
+                        await sleep(10);
+                    }
+                    throw new Error(`poppy: event key ${opts.key} never resolved`);
+                }
+            }
+            const seq = await redis.incr(k.seq(conversationId));
+            const now = Date.now();
+            const stored = {
+                seq,
+                event: { id: newEventId(seq), created_at: new Date(now).toISOString(), ...body },
+            };
+            await redis.set(k.event(conversationId, seq), JSON.stringify(stored.event));
+            await redis.set(k.eventId(conversationId, stored.event.id), String(seq));
+            if (opts.key !== undefined) {
+                await redis.set(k.eventKey(conversationId, opts.key), String(seq));
+            }
+            return { event: stored, created: true };
+        },
+        async listEvents(conversationId, afterSeq, limit) {
+            const last = await lastSeq(conversationId);
+            const pruned = (await getConversation(conversationId))?.prunedSeq ?? 0;
+            const seqs = [];
+            for (let seq = Math.max(afterSeq, pruned) + 1; seq <= last && seqs.length < limit; seq++)
+                seqs.push(seq);
+            if (seqs.length === 0)
+                return [];
+            const raws = await redis.mget(...seqs.map((seq) => k.event(conversationId, seq)));
+            const out = [];
+            raws.forEach((raw, index) => {
+                // A position whose write is still in flight ends the page: nothing is skipped over.
+                if (raw === null)
+                    return;
+                out.push({ seq: seqs[index], event: JSON.parse(raw) });
+            });
+            const firstGap = raws.indexOf(null);
+            return firstGap === -1 ? out : out.filter((entry) => entry.seq < (seqs[firstGap] ?? 0));
+        },
+        async findEventSeq(conversationId, eventId) {
+            const raw = await redis.get(k.eventId(conversationId, eventId));
+            if (raw === null)
+                return null;
+            const seq = Number.parseInt(raw, 10);
+            return (await redis.get(k.event(conversationId, seq))) === null ? null : seq;
+        },
+        async pruneEvents(conversationId, before) {
+            const conversation = await getConversation(conversationId);
+            const last = await lastSeq(conversationId);
+            const from = conversation?.prunedSeq ?? 0;
+            let upTo = from;
+            const doomed = [];
+            for (let seq = from + 1; seq < last; seq++) {
+                const raw = await redis.get(k.event(conversationId, seq));
+                if (raw !== null) {
+                    const event = JSON.parse(raw);
+                    if (Date.parse(event.created_at) >= before)
+                        break;
+                    doomed.push(k.event(conversationId, seq), k.eventId(conversationId, event.id));
+                }
+                upTo = seq;
+            }
+            if (!conversation || upTo === from)
+                return;
+            // Readers learn the new floor before the events go, so none mistakes the gap for a write.
+            await redis.set(k.conversation(conversationId), JSON.stringify({ ...conversation, prunedSeq: upTo }));
+            if (doomed.length > 0)
+                await redis.del(...doomed);
+        },
+        async claimMessage(owner, messageId, receipt) {
+            const key = k.message(owner, messageId);
+            if ((await redis.set(key, JSON.stringify(receipt), 'NX')) !== null) {
+                return { status: 'claimed' };
+            }
+            const raw = await redis.get(key);
+            if (raw === null)
+                return this.claimMessage(owner, messageId, receipt);
+            return { status: 'existing', ...JSON.parse(raw) };
+        },
+        async releaseMessage(owner, messageId) {
+            await redis.del(k.message(owner, messageId));
+        },
+        async leaseReader(conversationId, holder, ttlMs) {
+            const key = k.lease(conversationId);
+            if ((await redis.set(key, holder, 'PX', ttlMs, 'NX')) !== null)
+                return true;
+            if ((await redis.get(key)) !== holder)
+                return false;
+            await redis.set(key, holder, 'PX', ttlMs);
+            return true;
+        },
+        async releaseReader(conversationId, holder) {
+            const key = k.lease(conversationId);
+            if ((await redis.get(key)) === holder)
+                await redis.del(key);
+        },
+    };
+}
+//# sourceMappingURL=redis-store.js.map

package/dist/src/poppy/redis-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-store.js","sourceRoot":"","sources":["../../../src/poppy/redis-store.ts"],"names":[],"mappings":"AACA,OAAO,EACL,UAAU,GAOX,MAAM,YAAY,CAAC;AAmBpB,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAEhF;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAuB,EACvB,OAAO,GAA2B,EAAE;IAEpC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC;IAC3C,MAAM,CAAC,GAAG;QACR,YAAY,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE;QAC7C,GAAG,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE;QACpC,KAAK,EAAE,CAAC,EAAU,EAAE,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,GAAG,EAAE;QAC1D,OAAO,EAAE,CAAC,EAAU,EAAE,OAAe,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,OAAO,EAAE;QACtE,QAAQ,EAAE,CAAC,EAAU,EAAE,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,GAAG,EAAE;QAChE,OAAO,EAAE,CAAC,KAAa,EAAE,SAAiB,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,IAAI,SAAS,EAAE;QAC9E,KAAK,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE;KACzC,CAAC;IAEF,MAAM,eAAe,GAAG,KAAK,EAAE,EAAU,EAA2C,EAAE;QACpF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC;QAChD,OAAO,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAA6B,CAAC;IAC5E,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,KAAK,EAAE,EAAU,EAAmB,EAAE,CACpD,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IAEhE,OAAO;QACL,KAAK,CAAC,kBAAkB,CAAC,MAAM;YAC7B,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QACrE,CAAC;QACD,eAAe;QACf,KAAK,CAAC,kBAAkB,CAAC,EAAE,EAAE,KAA6B;YACxD,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,EAAE,CAAC,CAAC;YAC1C,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,MAAM,KAAK,CAAC,GAAG,CACb,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,EAClB,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAChE,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,cAAc,EAAE,IAAoB,EAAE,IAAI,GAAqB,EAAE;YACjF,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;gBAC3B,MAAM,MAAM,GAAG,CAAC,CAAC,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;gBACpD,IAAI,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;oBACxD,0EAA0E;oBAC1E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;wBAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;wBACjE,IAAI,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;4BAC9B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC,CAAC;4BAC1D,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gCACjB,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;4BAClF,CAAC;wBACH,CAAC;wBACD,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC;oBAClB,CAAC;oBACD,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,CAAC,GAAG,iBAAiB,CAAC,CAAC;gBACjE,CAAC;YACH,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;YACpD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,MAAM,GAAqB;gBAC/B,GAAG;gBACH,KAAK,EAAE,EAAE,EAAE,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,GAAG,IAAI,EAAE;aACjF,CAAC;YACF,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC5E,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACzE,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;gBAC3B,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACrE,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC1C,CAAC;QAED,KAAK,CAAC,UAAU,CAAC,cAAc,EAAE,QAAQ,EAAE,KAAK;YAC9C,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;YAC3C,MAAM,MAAM,GAAG,CAAC,MAAM,eAAe,CAAC,cAAc,CAAC,CAAC,EAAE,SAAS,IAAI,CAAC,CAAC;YACvE,MAAM,IAAI,GAAa,EAAE,CAAC;YAC1B,KAAK,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK,EAAE,GAAG,EAAE;gBACtF,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACjB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;YAClF,MAAM,GAAG,GAAuB,EAAE,CAAC;YACnC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;gBAC1B,oFAAoF;gBACpF,IAAI,GAAG,KAAK,IAAI;oBAAE,OAAO;gBACzB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAW,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,EAAE,CAAC,CAAC;YACjF,CAAC,CAAC,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACpC,OAAO,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1F,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,cAAc,EAAE,OAAO;YACxC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;YAChE,IAAI,GAAG,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAC;YAC9B,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACrC,OAAO,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;QAC/E,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,cAAc,EAAE,MAAM;YACtC,MAAM,YAAY,GAAG,MAAM,eAAe,CAAC,cAAc,CAAC,CAAC;YAC3D,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;YAC3C,MAAM,IAAI,GAAG,YAAY,EAAE,SAAS,IAAI,CAAC,CAAC;YAC1C,IAAI,IAAI,GAAG,IAAI,CAAC;YAChB,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,KAAK,IAAI,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;gBAC3C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC,CAAC;gBAC1D,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;oBACjB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;oBAC5C,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,MAAM;wBAAE,MAAM;oBAClD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;gBACjF,CAAC;gBACD,IAAI,GAAG,GAAG,CAAC;YACb,CAAC;YACD,IAAI,CAAC,YAAY,IAAI,IAAI,KAAK,IAAI;gBAAE,OAAO;YAC3C,0FAA0F;YAC1F,MAAM,KAAK,CAAC,GAAG,CACb,CAAC,CAAC,YAAY,CAAC,cAAc,CAAC,EAC9B,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CACrD,CAAC;YACF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;QACpD,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,OAA4B;YAC/D,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;YACxC,IAAI,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;gBACnE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;YAC/B,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,GAAG,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YACtE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,GAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyB,EAAE,CAAC;QAC7E,CAAC;QAED,KAAK,CAAC,cAAc,CAAC,KAAK,EAAE,SAAS;YACnC,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;QAC/C,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK;YAC7C,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YACpC,IAAI,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAC;YAC5E,IAAI,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,MAAM;gBAAE,OAAO,KAAK,CAAC;YACpD,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,CAAC,aAAa,CAAC,cAAc,EAAE,MAAM;YACxC,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YACpC,IAAI,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,MAAM;gBAAE,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9D,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,6 @@
+import type { HttpContext } from '@adonisjs/core/http';
+/** The request handler the Poppy server middleware delegates to; `false` = not a Poppy request. */
+export type PoppyRequestHandler = (ctx: HttpContext) => Promise<boolean>;
+export declare function setPoppyHandler(handler: PoppyRequestHandler | null): void;
+export declare function getPoppyHandler(): PoppyRequestHandler | null;
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/poppy/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,mGAAmG;AACnG,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAQzE,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,GAAG,IAAI,CAEzE;AAED,wBAAgB,eAAe,IAAI,mBAAmB,GAAG,IAAI,CAE5D"}

package/dist/src/poppy/runtime.js

@@ -0,0 +1,12 @@
+/**
+ * Set by the Poppy provider at boot, read by the server middleware per request — a module
+ * singleton for the reason the A2A one is (the framework builds the middleware from a lazy import).
+ */
+let current = null;
+export function setPoppyHandler(handler) {
+    current = handler;
+}
+export function getPoppyHandler() {
+    return current;
+}
+//# sourceMappingURL=runtime.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/poppy/runtime.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,IAAI,OAAO,GAA+B,IAAI,CAAC;AAE/C,MAAM,UAAU,eAAe,CAAC,OAAmC;IACjE,OAAO,GAAG,OAAO,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { HttpContext } from '@adonisjs/core/http';
+import type { NextFn } from '@adonisjs/core/types/http';
+/**
+ * Server middleware that answers Poppy requests before the router runs — before the bodyparser,
+ * the session and CSRF, like the A2A surface: a Poppy request is authenticated by its Session
+ * Token (DPoP), BEFORE its body is read. Everything outside the endpoint passes straight through.
+ */
+export default class PoppyServerMiddleware {
+    handle(ctx: HttpContext, next: NextFn): Promise<any>;
+}
+//# sourceMappingURL=server_middleware.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server_middleware.d.ts","sourceRoot":"","sources":["../../../src/poppy/server_middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAGxD;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,qBAAqB;IAClC,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,gBAM1C;CACF"}

package/dist/src/poppy/server_middleware.js

@@ -0,0 +1,16 @@
+import { getPoppyHandler } from './runtime.js';
+/**
+ * Server middleware that answers Poppy requests before the router runs — before the bodyparser,
+ * the session and CSRF, like the A2A surface: a Poppy request is authenticated by its Session
+ * Token (DPoP), BEFORE its body is read. Everything outside the endpoint passes straight through.
+ */
+export default class PoppyServerMiddleware {
+    async handle(ctx, next) {
+        const handler = getPoppyHandler();
+        if (handler !== null && (await handler(ctx))) {
+            return;
+        }
+        return next();
+    }
+}
+//# sourceMappingURL=server_middleware.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server_middleware.js","sourceRoot":"","sources":["../../../src/poppy/server_middleware.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,qBAAqB;IACxC,KAAK,CAAC,MAAM,CAAC,GAAgB,EAAE,IAAY;QACzC,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;QAClC,IAAI,OAAO,KAAK,IAAI,IAAI,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC7C,OAAO;QACT,CAAC;QACD,OAAO,IAAI,EAAE,CAAC;IAChB,CAAC;CACF"}