@gnldev/agui 0.1.0

package/dist/route.d.ts

@@ -0,0 +1,53 @@
+import type { Context } from 'hono';
+import { type FetchHandler } from './handler.js';
+import type { CreateGnlConfig, GnlIdentity } from '@gnldev/durable';
+export interface PipeAguiStreamOptions {
+    /** AG-UI threadId. If not given, runId is used (single-thread default). */
+    threadId?: string;
+}
+/** Stream fullStream as AG-UI SSE events (starts with RUN_STARTED, ends with RUN_FINISHED/RUN_ERROR). */
+export declare function pipeAguiStream(c: Context, runId: string, result: any, opts?: PipeAguiStreamOptions): Response;
+export interface CreateAguiRouteOptions {
+    /** AG-UI threadId resolver (from request + body). If not given, uses body.threadId, else runId. */
+    resolveThreadId?: (c: Context, body: any) => string | undefined;
+    /**
+     * WHO this request acts for — resolved from something the SERVER trusts, never from the body.
+     *
+     * This route declares auth out of scope (see createAguiRoute's own note) and that boundary is
+     * right. What was NOT right is what the boundary implied: `body.context` went to the engine
+     * untouched, and the engine reads the reserved context keys as "the server established this". So
+     * a request could name its own subject. Measured on the sibling route (chat-adapter, identical
+     * shape): a POST carrying `{"context":{"__gnl_resourceId":"KURBAN"}}` produced a run owned by
+     * that name — and once ownership stamping landed, the forged name became the LOCK's value too,
+     * i.e. the caller handed itself the key.
+     *
+     * The route now always seals. With no resolver the seal carries no identity, which strips the
+     * reserved keys: no forged subject gets in, and none is asserted either.
+     *
+     * HONEST BOUND: a resolver reading an unauthenticated request asserts a subject nobody verified.
+     * Put auth in front of this route, or the subject is only as good as the caller's honesty.
+     */
+    resolveResourceId?: (c: Context, body: any) => string | undefined;
+    /**
+     * WHO and WHICH CONVERSATION, in one hook — the SAME signature @gnldev/chat-adapter's route takes, so a
+     * host that has written this function once can mount either adapter with it.
+     *
+     * One signature for both routes is the point. Until now the two adapters asked the same question
+     * with two hooks each, in two shapes, and this one had the sharper lesson: `resolveThreadId` was
+     * called, its answer went into the SSE envelope, and the run still read and wrote the thread the
+     * client named (see the Turkish note in the stream call below). A host could wire identity, watch
+     * the right value appear in the response, and have changed nothing about where memory went.
+     *
+     * Takes the web `Request` rather than the Hono `Context`, matching @gnldev/server's `OrgOptions.resolve`:
+     * a host mounting this from Express or Fastify has a Request and no Context.
+     *
+     * PRECEDENCE: `resolveResourceId` / `resolveThreadId` still win, field by field — an existing
+     * deployment's answer is not taken away by a newer convenience. Called once per request.
+     *
+     * HONEST BOUND: this route declares auth out of scope. A resolver reading an unauthenticated
+     * request asserts a subject nobody verified.
+     */
+    identity?: GnlIdentity;
+}
+/** The AG-UI route as a fetch handler — mount with `app.mount(path, ...)` on a Hono host. */
+export declare function createAguiRoute(config: CreateGnlConfig, opts?: CreateAguiRouteOptions): FetchHandler;

package/dist/route.js

@@ -0,0 +1,324 @@
+import { toFetchHandler } from './handler.js';
+import { Hono } from 'hono';
+import { limitBreachFromSteps, blockedFromSteps, BLOCKED_ERROR_CODES, blockedErrorCode, callerConflictCode, sealRequestContext, resolveWorkIdentity } from '@gnldev/durable';
+import { createGnl } from '@gnldev/durable';
+import { streamSSE } from 'hono/streaming';
+// The two limit codes are READ from @gnldev/server rather than spelled again here. The event/data
+// SHAPE is deliberately a copy (see the note above), but a code is not a shape: it is the string a
+// caller matches on, and this route mirroring sse.ts by hand is exactly how the docs check ended up
+// with a list it had to maintain. `interruptsFromSteps` already makes this a build-order dependency.
+import { interruptsFromSteps, EDGE_ERROR_CODES } from '@gnldev/server';
+import { toAguiEvents, initialAguiConvertState } from './convert.js';
+import { EventType } from './types.js';
+/** Stream fullStream as AG-UI SSE events (starts with RUN_STARTED, ends with RUN_FINISHED/RUN_ERROR). */
+export function pipeAguiStream(c, runId, result, opts) {
+    const threadId = opts?.threadId ?? runId;
+    const ctx = { threadId, runId };
+    // The header patch, written out rather than imported from @gnldev/server: importing a runtime
+    // helper across packages resolves through that package's BUILT output, and a stale dist turns the
+    // call into `undefined` — measured, this exact swap emptied the stream and every test here failed
+    // on `JSON.parse('')`. Six lines of duplication beats a build-order dependency.
+    //
+    // Why the headers: Hono sets `Cache-Control: no-cache`, which says nothing about re-encoding, so a
+    // compression middleware in the host's chain buffers the stream into one chunk delivered at the
+    // end (measured on Express: 13 progressive chunks became 1). `no-transform` stops it;
+    // `X-Accel-Buffering: no` is the nginx half — measured behind a real one: load-bearing exactly
+    // when the client speaks HTTP/1.1 to a gzipping proxy (without it the stream collapses into one
+    // chunk at the end), and inert otherwise, HTTP/2 included.
+    // Kept IN SYNC with packages/server/src/sse.ts and packages/studio/src/sse.ts.
+    const res = streamSSE(c, async (stream) => {
+        // In AG-UI every SSE frame is a single JSON event; the type is inside the event JSON (the spec has
+        // no event/data split of its own) → the SSE `event:` field is NOT USED, only `data:` is written.
+        const write = async (event) => {
+            await stream.writeSSE({ data: JSON.stringify(event) });
+        };
+        let state = initialAguiConvertState;
+        const emit = async (gnlEvent) => {
+            const out = toAguiEvents(gnlEvent, ctx, state);
+            state = out.state;
+            for (const e of out.events)
+                await write(e);
+        };
+        const started = { type: EventType.RUN_STARTED, threadId, runId };
+        await write(started);
+        try {
+            for await (const part of result.fullStream) {
+                if (stream.aborted)
+                    break;
+                switch (part.type) {
+                    case 'text-delta': {
+                        const text = part.text ?? part.delta ?? '';
+                        if (text)
+                            await emit({ event: 'text-delta', data: { text } });
+                        break;
+                    }
+                    case 'tool-call':
+                        await emit({ event: 'tool-call', data: { toolCallId: part.toolCallId, toolName: part.toolName, input: part.input } });
+                        break;
+                    case 'tool-result':
+                        if (part.output?.__gnl_suspend)
+                            break; // suspend sentinel is carried by the interrupt event
+                        if (part.output?.__gnl_limit_exceeded)
+                            break; // INTERNAL API sentinel — does not leak, carried by the error event
+                        if (part.output?.__gnl_blocked)
+                            break; // K1: the block sentinel is also an INTERNAL API — carried by the error event
+                        await emit({ event: 'tool-result', data: { toolCallId: part.toolCallId, toolName: part.toolName, output: part.output } });
+                        break;
+                    // P0.1: kept IN SYNC with sse.ts (see the sync note at the top of this file) — reasoning/
+                    // tool-input/source/file/step/tool-error events + the raw marker; nothing silently dropped.
+                    case 'reasoning-start':
+                        await emit({ event: 'reasoning-start', data: { id: part.id } });
+                        break;
+                    case 'reasoning-delta': {
+                        const text = part.text ?? part.delta ?? '';
+                        if (text)
+                            await emit({ event: 'reasoning-delta', data: { id: part.id, text } });
+                        break;
+                    }
+                    case 'reasoning-end':
+                        await emit({ event: 'reasoning-end', data: { id: part.id } });
+                        break;
+                    case 'tool-input-start':
+                        await emit({ event: 'tool-input-start', data: { toolCallId: part.toolCallId ?? part.id, toolName: part.toolName } });
+                        break;
+                    case 'tool-input-delta':
+                        await emit({ event: 'tool-input-delta', data: { toolCallId: part.toolCallId ?? part.id, delta: part.delta } });
+                        break;
+                    case 'tool-input-end':
+                        await emit({ event: 'tool-input-end', data: { toolCallId: part.toolCallId ?? part.id } });
+                        break;
+                    case 'source':
+                        await emit({ event: 'source', data: { sourceType: part.sourceType, id: part.id, url: part.url, title: part.title } });
+                        break;
+                    case 'file':
+                        await emit({ event: 'file', data: { mediaType: part.file?.mediaType, base64: part.file?.base64 } });
+                        break;
+                    case 'start-step':
+                        await emit({ event: 'step-start', data: {} });
+                        break;
+                    case 'finish-step':
+                        await emit({ event: 'step-finish', data: { finishReason: part.finishReason, usage: part.usage } });
+                        break;
+                    case 'tool-error':
+                        await emit({ event: 'tool-error', data: { toolCallId: part.toolCallId, toolName: part.toolName, error: String(part.error?.message ?? part.error) } });
+                        break;
+                    case 'error':
+                        await emit({ event: 'error', data: { error: String(part.error?.message ?? part.error) } });
+                        break;
+                    case 'start':
+                    case 'finish':
+                    case 'text-start':
+                    case 'text-end':
+                    case 'abort':
+                    case 'raw':
+                        break; // deliberately no event — same list and reasons as sse.ts
+                    default:
+                        await emit({ event: 'raw', data: { type: part.type } }); // unknown part → type-only marker, never silent
+                        break;
+                }
+            }
+            const steps = await result.steps;
+            const breach = limitBreachFromSteps(steps);
+            if (breach) {
+                await emit({
+                    event: 'error',
+                    data: {
+                        error: breach.message,
+                        code: breach.kind === 'loop' ? EDGE_ERROR_CODES.toolLoopDetected : EDGE_ERROR_CODES.runLimitExceeded,
+                        detail: breach.detail,
+                    },
+                });
+                return;
+            }
+            // K1: the block sentinel (side-effect/retry/busy) → same contract as a limit breach: terminal error, no done.
+            const blocked = blockedFromSteps(steps);
+            if (blocked) {
+                await emit({ event: 'error', data: { error: blocked.message, code: BLOCKED_ERROR_CODES[blocked.code] ?? 'run_busy', detail: blocked.detail } });
+                return;
+            }
+            const interrupts = interruptsFromSteps(steps);
+            // FAZ-2 (chat-adapter parity): the approval ADDRESS travels with the interrupt — a client that
+            // resumes without this runId starts a fresh run and the suspended one leaks forever. Parity is
+            // measured by SCHEMA POSITION, not field name: chat-adapter stamps runId INSIDE each record
+            // (ui-stream.ts), so a shared client helper (approvalPayload) must find it there on BOTH
+            // adapters — the envelope copy stays for consumers already reading it.
+            if (interrupts.length)
+                await emit({ event: 'interrupt', data: { interrupts: interrupts.map((i) => ({ ...i, runId })), runId } });
+            const finishReason = await Promise.resolve(result.finishReason).catch(() => undefined);
+            const usage = await Promise.resolve(result.usage).catch(() => undefined);
+            await emit({ event: 'done', data: { runId, finishReason, usage } });
+        }
+        catch (e) {
+            await emit({ event: 'error', data: { error: String(e?.message ?? e) } });
+        }
+    });
+    res.headers.set('Cache-Control', 'no-cache, no-transform');
+    res.headers.set('X-Accel-Buffering', 'no');
+    return res;
+}
+/**
+ * The caller's own name for the work, reflected back in a refusal (§8, rules 1-3).
+ *
+ * FROM THE REQUEST, never from storage: a swept run keeps only a hash of its workKey (§10.3), so
+ * reading the name back would undo a deletion. The caller already knows what it sent.
+ *
+ * `detail` and not `error`: the sentence is the most casually logged field in any HTTP client, and a
+ * workKey is a business name. Same three lines as @gnldev/server's and @gnldev/chat-adapter's — the
+ * dependency direction forbids sharing one (agui → durable, never agui → server for a renderer).
+ */
+function withWorkKey(detail, workKey) {
+    if (workKey === undefined)
+        return detail;
+    return detail && typeof detail === 'object' ? { ...detail, workKey } : { workKey };
+}
+/**
+ * Produces a single-endpoint Hono router from a createGnl config that CopilotKit's AG-UI HttpAgent can talk to:
+ * POST /agents/:name/run   {runId, prompt|messages, threadId?, approvals?}  → AG-UI SSE
+ * Deliberately kept small: NO auth/org/budget gates (if needed, use @gnldev/server's createRestApi
+ * and pass its stream result to pipeAguiStream — see README).
+ */
+function aguiRouteApp(config, opts = {}) {
+    const gnl = createGnl(config);
+    // Same warning, same wording and same posture as @gnldev/chat-adapter's route: in production, a route
+    // that can name nobody starts runs that are born ownerless, and an ownership gate with no owner to
+    // compare against passes. Warn once at construction — never throw, because a deployment that puts
+    // its own boundary in front of this route is not broken and must not be stopped at boot.
+    if (process.env.NODE_ENV === 'production' && !opts.identity && !opts.resolveResourceId) {
+        console.warn('[gnl agui-route] no `identity` and no `resolveResourceId` in production — runs will be born ownerless; ' +
+            'ownership gates stay fail-open (a run with no owner is refused to nobody). Pass `identity: (req) => ({ resourceId })` ' +
+            'reading your session/JWT — never the request body.');
+    }
+    const app = new Hono();
+    app.post('/agents/:name/run', async (c) => {
+        const name = c.req.param('name');
+        const body = (await c.req.json().catch(() => ({})));
+        // Resolved once — the same reason chat-adapter states: a resolver that reads the request may
+        // answer differently the second time, and these two fields must agree about who this is.
+        // Resolved FIRST, because the identity decision below cannot be made without knowing the subject.
+        const ident = await opts.identity?.(c.req.raw);
+        const subject = opts.resolveResourceId?.(c, body) ?? ident?.resourceId;
+        // WHICH ORGANIZATION — only `identity` can say, and never the body. Same rule and same reason as
+        // the sibling route: an org is an isolation boundary, so it comes from the hook that already
+        // reads a verified session, and `sealRequestContext` strips any the caller tried to assert.
+        const org = ident?.orgId;
+        // WHICH RUN (package #5, §7). Two names can arrive, and they follow different rules:
+        //
+        //   `body.workKey` — DECLARED. Always a workKey, always fail-closed: without an address the
+        //   engine cannot tell whose job this is (§6), and the field is new, so nobody loses anything.
+        //
+        //   `Idempotency-Key` — IMPLICIT, usually stamped by a gateway. A workKey when there is a
+        //   subject, otherwise the raw runId it has been since FAZ-1. The precedence and the reason are
+        //   @gnldev/chat-adapter's, as they were when this header was first accepted here — and so is the
+        //   fallback: this route ships with no auth, and refusing every identity-less deployment that
+        //   put a proxy in front of it would be a regression dressed as a rule.
+        //
+        // Nothing else moves: with no identity at all this route still answers 400, as it always has.
+        const header = c.req.header('Idempotency-Key');
+        if (!body.runId && !body.workKey && header) {
+            if (subject)
+                body.workKey = header;
+            else
+                body.runId = header;
+        }
+        if (!body.runId && !body.workKey)
+            return c.json({ error: 'runId or workKey is required (one names an id, the other names the work)' }, 400);
+        let identity;
+        try {
+            identity = resolveWorkIdentity(`agent:${name}`, {
+                ...(body.runId !== undefined ? { runId: body.runId } : {}),
+                ...(body.workKey !== undefined ? { workKey: body.workKey } : {}),
+                // The agent's own declaration — which address a name is unique within is a property of the
+                // work, not of the request (see AgentConfig.workScope).
+                scopeKind: gnl.agent(name).workScope ?? 'resource',
+                ...(subject ? { resourceId: subject } : {}),
+                // THE ORG — REST parity (§7). @gnldev/server passes it; without it an `'org'` workScope
+                // lands on the deployment sentinel (§10.2) and the same org's same named work gets a
+                // DIFFERENT id here than it does through REST. Note this is also what makes an org-scoped
+                // run with NO subject work: an org address is an address, so the fail-closed `'resource'`
+                // rule above does not apply to the nightly-reconciliation case.
+                ...(org ? { orgId: org } : {}),
+                anonymous: 'refuse',
+                surface: `POST /agents/${name}/run`,
+            });
+        }
+        catch (e) {
+            return c.json({ error: String(e?.message ?? e) }, 400);
+        }
+        const runId = identity.runId;
+        const declared = identity.work?.workKey;
+        // `identity` sits below the dedicated resolver and above the body: it is server-derived, the body
+        // is not.
+        const threadId = opts.resolveThreadId?.(c, body) ?? ident?.threadId ?? body.threadId ?? runId;
+        let result;
+        try {
+            result = await gnl.stream(name, {
+                // The NAME when one was declared, the raw id otherwise — the door re-resolves the same tuple
+                // and lands on the same id, and only the name gets written into the run's record.
+                ...(declared !== undefined ? { workKey: declared } : { runId }),
+                prompt: body.prompt,
+                messages: body.messages,
+                // `threadId`, hesaplanan değer — `body.threadId` DEĞİL. Bu satır ölü koddu: `resolveThreadId`
+                // çağrılıyor, sonucu yalnız SSE zarfına gidiyordu, koşum yine istemcinin dediği thread'e
+                // yazıp okuyordu. Yani host'un kimliği auth'tan türetmek için verdiği TEK kanca hafızayı hiç
+                // etkilemiyordu; host "düzelttim" sanıyordu.
+                threadId,
+                approvals: body.approvals,
+                // HER ZAMAN mühürlü — kimlik bilinmese bile. Ayrılmış anahtarlar motorun "bunu sunucu
+                // doğruladı" kanalıdır; mühürsüz bir gövde o kanalın sahibi olur.
+                context: sealRequestContext(body.context ?? {}, {
+                    ...(subject ? { resourceId: subject } : {}),
+                    // The org goes into the seal too, so the record and the dynamic `system`/`tools` see the
+                    // same organization the id was derived under — the derivation and the seal must not
+                    // disagree about which boundary this run is inside.
+                    ...(org ? { orgId: org } : {}),
+                }),
+                ...(subject ? { resourceId: subject } : {}),
+            });
+        }
+        catch (e) {
+            // A refusal thrown BEFORE the stream exists is still one of ours, and it used to arrive as a bare
+            // 400 with the reason flattened into prose. `streamDurable` asserts thread ownership and takes the
+            // run lock before it returns anything, so `RunThreadMismatchError`, `RunBusyError`,
+            // `SideEffectRetryBlockedError` and `RetryLimitExceededError` all land here — the same errors
+            // @gnldev/server answers with a status and a `code`. A client talking to this route had to match
+            // on the sentence instead, which is the practice the typed errors exist to end.
+            //
+            // Errors raised MID-stream are a different contract and are untouched: once frames are flowing
+            // they surface as an SSE `error` event (see pipeAguiStream), because a response already committed to
+            // 200 cannot become a 409.
+            const name = e?.name;
+            if (name === 'RunThreadMismatchError') {
+                return c.json({ error: e.message, code: 'run_thread_mismatch', detail: withWorkKey(e.detail, declared) }, 409);
+            }
+            // FAZ-4 caller-conflict family (K9: durable's single map — this route was the consumer the
+            // first cut forgot; a critical-profile input/actor/swept refusal must not collapse to a bare 400).
+            const conflict = callerConflictCode(e);
+            if (conflict) {
+                return c.json({ error: e.message, code: conflict, detail: withWorkKey(e.detail, declared) }, 409);
+            }
+            const blocked = blockedErrorCode(e);
+            if (blocked) {
+                const body = { error: e?.message ?? String(e), code: blocked, detail: e?.detail };
+                const res = blocked === 'retry_limit_exceeded'
+                    ? c.json(body, 422)
+                    : c.json({ ...body, resumable: true }, 409);
+                // Same Retry-After contract as @gnldev/server and chat-adapter: run_busy is "correct, only early".
+                if (blocked === 'run_busy')
+                    res.headers.set('Retry-After', '5');
+                return res;
+            }
+            if (name === 'RunLimitExceededError' || name === 'ToolLoopDetectedError') {
+                const code = name === 'RunLimitExceededError' ? EDGE_ERROR_CODES.runLimitExceeded : EDGE_ERROR_CODES.toolLoopDetected;
+                return c.json({ error: e.message, code, detail: e.detail, resumable: true }, 422);
+            }
+            return c.json({ error: String(e?.message ?? e) }, 400);
+        }
+        return pipeAguiStream(c, runId, result, { threadId });
+    });
+    return app;
+}
+/** The AG-UI route as a fetch handler — mount with `app.mount(path, ...)` on a Hono host. */
+export function createAguiRoute(config, opts = {}) {
+    return toFetchHandler(aguiRouteApp(config, opts));
+}
+//# sourceMappingURL=route.js.map

package/dist/route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../src/route.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,cAAc,EAAqB,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE7K,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,kGAAkG;AAClG,mGAAmG;AACnG,oGAAoG;AACpG,qGAAqG;AACrG,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAoB,MAAM,cAAc,CAAC;AACvF,OAAO,EAAE,SAAS,EAAwC,MAAM,YAAY,CAAC;AAO7E,yGAAyG;AACzG,MAAM,UAAU,cAAc,CAAC,CAAU,EAAE,KAAa,EAAE,MAAW,EAAE,IAA4B;IACjG,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,KAAK,CAAC;IACzC,MAAM,GAAG,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAChC,8FAA8F;IAC9F,kGAAkG;IAClG,kGAAkG;IAClG,gFAAgF;IAChF,EAAE;IACF,mGAAmG;IACnG,gGAAgG;IAChG,sFAAsF;IACtF,+FAA+F;IAC/F,gGAAgG;IAChG,2DAA2D;IAC3D,+EAA+E;IAC/E,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACxC,mGAAmG;QACnG,iGAAiG;QACjG,MAAM,KAAK,GAAG,KAAK,EAAE,KAAgB,EAAE,EAAE;YACvC,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzD,CAAC,CAAC;QACF,IAAI,KAAK,GAAG,uBAAuB,CAAC;QACpC,MAAM,IAAI,GAAG,KAAK,EAAE,QAAqB,EAAE,EAAE;YAC3C,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YAC/C,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;YAClB,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM;gBAAE,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7C,CAAC,CAAC;QACF,MAAM,OAAO,GAAoB,EAAE,IAAI,EAAE,SAAS,CAAC,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAClF,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QACrB,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBAC3C,IAAI,MAAM,CAAC,OAAO;oBAAE,MAAM;gBAC1B,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;oBAClB,KAAK,YAAY,CAAC,CAAC,CAAC;wBAClB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;wBAC3C,IAAI,IAAI;4BAAE,MAAM,IAAI,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;wBAC9D,MAAM;oBACR,CAAC;oBACD,KAAK,WAAW;wBACd,MAAM,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;wBACtH,MAAM;oBACR,KAAK,aAAa;wBAChB,IAAI,IAAI,CAAC,MAAM,EAAE,aAAa;4BAAE,MAAM,CAAC,qDAAqD;wBAC5F,IAAI,IAAI,CAAC,MAAM,EAAE,oBAAoB;4BAAE,MAAM,CAAC,oEAAoE;wBAClH,IAAI,IAAI,CAAC,MAAM,EAAE,aAAa;4BAAE,MAAM,CAAC,8EAA8E;wBACrH,MAAM,IAAI,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;wBAC1H,MAAM;oBACR,0FAA0F;oBAC1F,4FAA4F;oBAC5F,KAAK,iBAAiB;wBACpB,MAAM,IAAI,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;wBAChE,MAAM;oBACR,KAAK,iBAAiB,CAAC,CAAC,CAAC;wBACvB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;wBAC3C,IAAI,IAAI;4BAAE,MAAM,IAAI,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;wBAChF,MAAM;oBACR,CAAC;oBACD,KAAK,eAAe;wBAClB,MAAM,IAAI,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;wBAC9D,MAAM;oBACR,KAAK,kBAAkB;wBACrB,MAAM,IAAI,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;wBACrH,MAAM;oBACR,KAAK,kBAAkB;wBACrB,MAAM,IAAI,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;wBAC/G,MAAM;oBACR,KAAK,gBAAgB;wBACnB,MAAM,IAAI,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;wBAC1F,MAAM;oBACR,KAAK,QAAQ;wBACX,MAAM,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;wBACtH,MAAM;oBACR,KAAK,MAAM;wBACT,MAAM,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;wBACpG,MAAM;oBACR,KAAK,YAAY;wBACf,MAAM,IAAI,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;wBAC9C,MAAM;oBACR,KAAK,aAAa;wBAChB,MAAM,IAAI,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;wBACnG,MAAM;oBACR,KAAK,YAAY;wBACf,MAAM,IAAI,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAE,IAAY,CAAC,KAAK,EAAE,OAAO,IAAK,IAAY,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;wBACxK,MAAM;oBACR,KAAK,OAAO;wBACV,MAAM,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,CAAE,IAAY,CAAC,KAAK,EAAE,OAAO,IAAK,IAAY,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;wBAC7G,MAAM;oBACR,KAAK,OAAO,CAAC;oBAAC,KAAK,QAAQ,CAAC;oBAAC,KAAK,YAAY,CAAC;oBAAC,KAAK,UAAU,CAAC;oBAAC,KAAK,OAAO,CAAC;oBAAC,KAAK,KAAK;wBACvF,MAAM,CAAC,0DAA0D;oBACnE;wBACE,MAAM,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,gDAAgD;wBACzG,MAAM;gBACV,CAAC;YACH,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC;YACjC,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;YAC3C,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,IAAI,CAAC;oBACT,KAAK,EAAE,OAAO;oBACd,IAAI,EAAE;wBACJ,KAAK,EAAE,MAAM,CAAC,OAAO;wBACrB,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC,CAAC,gBAAgB,CAAC,gBAAgB;wBACpG,MAAM,EAAE,MAAM,CAAC,MAAM;qBACtB;iBACF,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YACD,8GAA8G;YAC9G,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;YACxC,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBAChJ,OAAO;YACT,CAAC;YACD,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;YAC9C,+FAA+F;YAC/F,+FAA+F;YAC/F,4FAA4F;YAC5F,yFAAyF;YACzF,uEAAuE;YACvE,IAAI,UAAU,CAAC,MAAM;gBAAE,MAAM,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACjI,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACvF,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACzE,MAAM,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,MAAM,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC,CAAC,CAAC;IACH,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,wBAAwB,CAAC,CAAC;IAC3D,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC;IAC3C,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,WAAW,CAAC,MAAe,EAAE,OAAgB;IACpD,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACzC,OAAO,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAI,MAAkC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;AAClH,CAAC;AA6CD;;;;;GAKG;AACH,SAAS,YAAY,CAAC,MAAuB,EAAE,OAA+B,EAAE;IAC9E,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9B,sGAAsG;IACtG,mGAAmG;IACnG,kGAAkG;IAClG,yFAAyF;IACzF,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvF,OAAO,CAAC,IAAI,CACV,yGAAyG;YACzG,wHAAwH;YACxH,oDAAoD,CACrD,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACxC,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAQ,CAAC;QAC3D,6FAA6F;QAC7F,yFAAyF;QACzF,kGAAkG;QAClG,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,KAAK,EAAE,UAAU,CAAC;QACvE,iGAAiG;QACjG,6FAA6F;QAC7F,4FAA4F;QAC5F,MAAM,GAAG,GAAG,KAAK,EAAE,KAAK,CAAC;QACzB,qFAAqF;QACrF,EAAE;QACF,4FAA4F;QAC5F,+FAA+F;QAC/F,EAAE;QACF,0FAA0F;QAC1F,gGAAgG;QAChG,kGAAkG;QAClG,8FAA8F;QAC9F,wEAAwE;QACxE,EAAE;QACF,8FAA8F;QAC9F,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,MAAM,EAAE,CAAC;YAC3C,IAAI,OAAO;gBAAE,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;;gBAC9B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,0EAA0E,EAAE,EAAE,GAAG,CAAC,CAAC;QAC5I,IAAI,QAA8B,CAAC;QACnC,IAAI,CAAC;YACH,QAAQ,GAAG,mBAAmB,CAAC,SAAS,IAAI,EAAE,EAAE;gBAC9C,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1D,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,2FAA2F;gBAC3F,wDAAwD;gBACxD,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,IAAI,UAAU;gBAClD,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3C,wFAAwF;gBACxF,qFAAqF;gBACrF,0FAA0F;gBAC1F,0FAA0F;gBAC1F,gEAAgE;gBAChE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9B,SAAS,EAAE,QAAQ;gBACnB,OAAO,EAAE,gBAAgB,IAAI,MAAM;aACpC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAM,CAAC;QAC9B,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QACxC,kGAAkG;QAClG,UAAU;QACV,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,KAAK,EAAE,QAAQ,IAAI,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC;QAC9F,IAAI,MAAW,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE;gBAC9B,6FAA6F;gBAC7F,kFAAkF;gBAClF,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;gBAC/D,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,8FAA8F;gBAC9F,yFAAyF;gBACzF,6FAA6F;gBAC7F,6CAA6C;gBAC7C,QAAQ;gBACR,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,sFAAsF;gBACtF,kEAAkE;gBAClE,OAAO,EAAE,kBAAkB,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE;oBAC9C,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC3C,yFAAyF;oBACzF,oFAAoF;oBACpF,oDAAoD;oBACpD,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC/B,CAAC;gBACF,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5C,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,kGAAkG;YAClG,mGAAmG;YACnG,oFAAoF;YACpF,8FAA8F;YAC9F,iGAAiG;YACjG,gFAAgF;YAChF,EAAE;YACF,+FAA+F;YAC/F,qGAAqG;YACrG,2BAA2B;YAC3B,MAAM,IAAI,GAAI,CAAuB,EAAE,IAAI,CAAC;YAC5C,IAAI,IAAI,KAAK,wBAAwB,EAAE,CAAC;gBACtC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;YACjH,CAAC;YACD,2FAA2F;YAC3F,mGAAmG;YACnG,MAAM,QAAQ,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;YACvC,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;YACpG,CAAC;YACD,MAAM,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;YACpC,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;gBAClF,MAAM,GAAG,GAAG,OAAO,KAAK,sBAAsB;oBAC5C,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC;oBACnB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;gBAC9C,mGAAmG;gBACnG,IAAI,OAAO,KAAK,UAAU;oBAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;gBAChE,OAAO,GAAG,CAAC;YACb,CAAC;YACD,IAAI,IAAI,KAAK,uBAAuB,IAAI,IAAI,KAAK,uBAAuB,EAAE,CAAC;gBACzE,MAAM,IAAI,GAAG,IAAI,KAAK,uBAAuB,CAAC,CAAC,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC,CAAC,gBAAgB,CAAC,gBAAgB,CAAC;gBACtH,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;YACpF,CAAC;YACD,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,eAAe,CAAC,MAAuB,EAAE,OAA+B,EAAE;IACxF,OAAO,cAAc,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;AACpD,CAAC","sourcesContent":["// pipeAguiStream: the AG-UI-output counterpart of @gnldev/server's pipeAgentStream. Streams fullStream (AI SDK\n// StreamTextResult) as SSE, but instead of writing GNL's own event/data schema, converts it via toAguiEvents\n// and writes AG-UI events. createAguiRoute: a small single-endpoint (POST /agents/:name/run) factory —\n// an endpoint that CopilotKit's AG-UI HttpAgent can POST to.\n//\n// NOTE (deliberate choice — don't break the architecture): the switch that converts fullStream parts to the\n// GNL event/data shape is copied from INSIDE pipeAgentStream in packages/server/src/sse.ts (there is no\n// exported hook). sse.ts is a sensitive file carrying the W3 resumable-id contract and locked in by\n// process-kill/exactly-once tests — rather than adding a \"sink\" parameter there, keeping a small,\n// independent copy here is safer (without touching the existing architecture). The event/data shape of the\n// two copies must be kept in sync with sse.ts; see test/route.test.ts (parallel tests with the same mock patterns).\nimport type { Context } from 'hono';\nimport { toFetchHandler, type FetchHandler } from './handler.js';\nimport { Hono } from 'hono';\nimport { limitBreachFromSteps, blockedFromSteps, BLOCKED_ERROR_CODES, blockedErrorCode, callerConflictCode, sealRequestContext, resolveWorkIdentity } from '@gnldev/durable';\nimport type { CreateGnlConfig, GnlIdentity, ResolvedWorkIdentity } from '@gnldev/durable';\nimport { createGnl } from '@gnldev/durable';\nimport { streamSSE } from 'hono/streaming';\n// The two limit codes are READ from @gnldev/server rather than spelled again here. The event/data\n// SHAPE is deliberately a copy (see the note above), but a code is not a shape: it is the string a\n// caller matches on, and this route mirroring sse.ts by hand is exactly how the docs check ended up\n// with a list it had to maintain. `interruptsFromSteps` already makes this a build-order dependency.\nimport { interruptsFromSteps, EDGE_ERROR_CODES } from '@gnldev/server';\nimport { toAguiEvents, initialAguiConvertState, type GnlSseEvent } from './convert.js';\nimport { EventType, type AguiEvent, type RunStartedEvent } from './types.js';\n\nexport interface PipeAguiStreamOptions {\n  /** AG-UI threadId. If not given, runId is used (single-thread default). */\n  threadId?: string;\n}\n\n/** Stream fullStream as AG-UI SSE events (starts with RUN_STARTED, ends with RUN_FINISHED/RUN_ERROR). */\nexport function pipeAguiStream(c: Context, runId: string, result: any, opts?: PipeAguiStreamOptions) {\n  const threadId = opts?.threadId ?? runId;\n  const ctx = { threadId, runId };\n  // The header patch, written out rather than imported from @gnldev/server: importing a runtime\n  // helper across packages resolves through that package's BUILT output, and a stale dist turns the\n  // call into `undefined` — measured, this exact swap emptied the stream and every test here failed\n  // on `JSON.parse('')`. Six lines of duplication beats a build-order dependency.\n  //\n  // Why the headers: Hono sets `Cache-Control: no-cache`, which says nothing about re-encoding, so a\n  // compression middleware in the host's chain buffers the stream into one chunk delivered at the\n  // end (measured on Express: 13 progressive chunks became 1). `no-transform` stops it;\n  // `X-Accel-Buffering: no` is the nginx half — measured behind a real one: load-bearing exactly\n  // when the client speaks HTTP/1.1 to a gzipping proxy (without it the stream collapses into one\n  // chunk at the end), and inert otherwise, HTTP/2 included.\n  // Kept IN SYNC with packages/server/src/sse.ts and packages/studio/src/sse.ts.\n  const res = streamSSE(c, async (stream) => {\n    // In AG-UI every SSE frame is a single JSON event; the type is inside the event JSON (the spec has\n    // no event/data split of its own) → the SSE `event:` field is NOT USED, only `data:` is written.\n    const write = async (event: AguiEvent) => {\n      await stream.writeSSE({ data: JSON.stringify(event) });\n    };\n    let state = initialAguiConvertState;\n    const emit = async (gnlEvent: GnlSseEvent) => {\n      const out = toAguiEvents(gnlEvent, ctx, state);\n      state = out.state;\n      for (const e of out.events) await write(e);\n    };\n    const started: RunStartedEvent = { type: EventType.RUN_STARTED, threadId, runId };\n    await write(started);\n    try {\n      for await (const part of result.fullStream) {\n        if (stream.aborted) break;\n        switch (part.type) {\n          case 'text-delta': {\n            const text = part.text ?? part.delta ?? '';\n            if (text) await emit({ event: 'text-delta', data: { text } });\n            break;\n          }\n          case 'tool-call':\n            await emit({ event: 'tool-call', data: { toolCallId: part.toolCallId, toolName: part.toolName, input: part.input } });\n            break;\n          case 'tool-result':\n            if (part.output?.__gnl_suspend) break; // suspend sentinel is carried by the interrupt event\n            if (part.output?.__gnl_limit_exceeded) break; // INTERNAL API sentinel — does not leak, carried by the error event\n            if (part.output?.__gnl_blocked) break; // K1: the block sentinel is also an INTERNAL API — carried by the error event\n            await emit({ event: 'tool-result', data: { toolCallId: part.toolCallId, toolName: part.toolName, output: part.output } });\n            break;\n          // P0.1: kept IN SYNC with sse.ts (see the sync note at the top of this file) — reasoning/\n          // tool-input/source/file/step/tool-error events + the raw marker; nothing silently dropped.\n          case 'reasoning-start':\n            await emit({ event: 'reasoning-start', data: { id: part.id } });\n            break;\n          case 'reasoning-delta': {\n            const text = part.text ?? part.delta ?? '';\n            if (text) await emit({ event: 'reasoning-delta', data: { id: part.id, text } });\n            break;\n          }\n          case 'reasoning-end':\n            await emit({ event: 'reasoning-end', data: { id: part.id } });\n            break;\n          case 'tool-input-start':\n            await emit({ event: 'tool-input-start', data: { toolCallId: part.toolCallId ?? part.id, toolName: part.toolName } });\n            break;\n          case 'tool-input-delta':\n            await emit({ event: 'tool-input-delta', data: { toolCallId: part.toolCallId ?? part.id, delta: part.delta } });\n            break;\n          case 'tool-input-end':\n            await emit({ event: 'tool-input-end', data: { toolCallId: part.toolCallId ?? part.id } });\n            break;\n          case 'source':\n            await emit({ event: 'source', data: { sourceType: part.sourceType, id: part.id, url: part.url, title: part.title } });\n            break;\n          case 'file':\n            await emit({ event: 'file', data: { mediaType: part.file?.mediaType, base64: part.file?.base64 } });\n            break;\n          case 'start-step':\n            await emit({ event: 'step-start', data: {} });\n            break;\n          case 'finish-step':\n            await emit({ event: 'step-finish', data: { finishReason: part.finishReason, usage: part.usage } });\n            break;\n          case 'tool-error':\n            await emit({ event: 'tool-error', data: { toolCallId: part.toolCallId, toolName: part.toolName, error: String((part as any).error?.message ?? (part as any).error) } });\n            break;\n          case 'error':\n            await emit({ event: 'error', data: { error: String((part as any).error?.message ?? (part as any).error) } });\n            break;\n          case 'start': case 'finish': case 'text-start': case 'text-end': case 'abort': case 'raw':\n            break; // deliberately no event — same list and reasons as sse.ts\n          default:\n            await emit({ event: 'raw', data: { type: part.type } }); // unknown part → type-only marker, never silent\n            break;\n        }\n      }\n      const steps = await result.steps;\n      const breach = limitBreachFromSteps(steps);\n      if (breach) {\n        await emit({\n          event: 'error',\n          data: {\n            error: breach.message,\n            code: breach.kind === 'loop' ? EDGE_ERROR_CODES.toolLoopDetected : EDGE_ERROR_CODES.runLimitExceeded,\n            detail: breach.detail,\n          },\n        });\n        return;\n      }\n      // K1: the block sentinel (side-effect/retry/busy) → same contract as a limit breach: terminal error, no done.\n      const blocked = blockedFromSteps(steps);\n      if (blocked) {\n        await emit({ event: 'error', data: { error: blocked.message, code: BLOCKED_ERROR_CODES[blocked.code] ?? 'run_busy', detail: blocked.detail } });\n        return;\n      }\n      const interrupts = interruptsFromSteps(steps);\n      // FAZ-2 (chat-adapter parity): the approval ADDRESS travels with the interrupt — a client that\n      // resumes without this runId starts a fresh run and the suspended one leaks forever. Parity is\n      // measured by SCHEMA POSITION, not field name: chat-adapter stamps runId INSIDE each record\n      // (ui-stream.ts), so a shared client helper (approvalPayload) must find it there on BOTH\n      // adapters — the envelope copy stays for consumers already reading it.\n      if (interrupts.length) await emit({ event: 'interrupt', data: { interrupts: interrupts.map((i) => ({ ...i, runId })), runId } });\n      const finishReason = await Promise.resolve(result.finishReason).catch(() => undefined);\n      const usage = await Promise.resolve(result.usage).catch(() => undefined);\n      await emit({ event: 'done', data: { runId, finishReason, usage } });\n    } catch (e: any) {\n      await emit({ event: 'error', data: { error: String(e?.message ?? e) } });\n    }\n  });\n  res.headers.set('Cache-Control', 'no-cache, no-transform');\n  res.headers.set('X-Accel-Buffering', 'no');\n  return res;\n}\n\n/**\n * The caller's own name for the work, reflected back in a refusal (§8, rules 1-3).\n *\n * FROM THE REQUEST, never from storage: a swept run keeps only a hash of its workKey (§10.3), so\n * reading the name back would undo a deletion. The caller already knows what it sent.\n *\n * `detail` and not `error`: the sentence is the most casually logged field in any HTTP client, and a\n * workKey is a business name. Same three lines as @gnldev/server's and @gnldev/chat-adapter's — the\n * dependency direction forbids sharing one (agui → durable, never agui → server for a renderer).\n */\nfunction withWorkKey(detail: unknown, workKey?: string): unknown {\n  if (workKey === undefined) return detail;\n  return detail && typeof detail === 'object' ? { ...(detail as Record<string, unknown>), workKey } : { workKey };\n}\n\nexport interface CreateAguiRouteOptions {\n  /** AG-UI threadId resolver (from request + body). If not given, uses body.threadId, else runId. */\n  resolveThreadId?: (c: Context, body: any) => string | undefined;\n  /**\n   * WHO this request acts for — resolved from something the SERVER trusts, never from the body.\n   *\n   * This route declares auth out of scope (see createAguiRoute's own note) and that boundary is\n   * right. What was NOT right is what the boundary implied: `body.context` went to the engine\n   * untouched, and the engine reads the reserved context keys as \"the server established this\". So\n   * a request could name its own subject. Measured on the sibling route (chat-adapter, identical\n   * shape): a POST carrying `{\"context\":{\"__gnl_resourceId\":\"KURBAN\"}}` produced a run owned by\n   * that name — and once ownership stamping landed, the forged name became the LOCK's value too,\n   * i.e. the caller handed itself the key.\n   *\n   * The route now always seals. With no resolver the seal carries no identity, which strips the\n   * reserved keys: no forged subject gets in, and none is asserted either.\n   *\n   * HONEST BOUND: a resolver reading an unauthenticated request asserts a subject nobody verified.\n   * Put auth in front of this route, or the subject is only as good as the caller's honesty.\n   */\n  resolveResourceId?: (c: Context, body: any) => string | undefined;\n  /**\n   * WHO and WHICH CONVERSATION, in one hook — the SAME signature @gnldev/chat-adapter's route takes, so a\n   * host that has written this function once can mount either adapter with it.\n   *\n   * One signature for both routes is the point. Until now the two adapters asked the same question\n   * with two hooks each, in two shapes, and this one had the sharper lesson: `resolveThreadId` was\n   * called, its answer went into the SSE envelope, and the run still read and wrote the thread the\n   * client named (see the Turkish note in the stream call below). A host could wire identity, watch\n   * the right value appear in the response, and have changed nothing about where memory went.\n   *\n   * Takes the web `Request` rather than the Hono `Context`, matching @gnldev/server's `OrgOptions.resolve`:\n   * a host mounting this from Express or Fastify has a Request and no Context.\n   *\n   * PRECEDENCE: `resolveResourceId` / `resolveThreadId` still win, field by field — an existing\n   * deployment's answer is not taken away by a newer convenience. Called once per request.\n   *\n   * HONEST BOUND: this route declares auth out of scope. A resolver reading an unauthenticated\n   * request asserts a subject nobody verified.\n   */\n  identity?: GnlIdentity;\n}\n\n/**\n * Produces a single-endpoint Hono router from a createGnl config that CopilotKit's AG-UI HttpAgent can talk to:\n * POST /agents/:name/run   {runId, prompt|messages, threadId?, approvals?}  → AG-UI SSE\n * Deliberately kept small: NO auth/org/budget gates (if needed, use @gnldev/server's createRestApi\n * and pass its stream result to pipeAguiStream — see README).\n */\nfunction aguiRouteApp(config: CreateGnlConfig, opts: CreateAguiRouteOptions = {}): Hono {\n  const gnl = createGnl(config);\n  // Same warning, same wording and same posture as @gnldev/chat-adapter's route: in production, a route\n  // that can name nobody starts runs that are born ownerless, and an ownership gate with no owner to\n  // compare against passes. Warn once at construction — never throw, because a deployment that puts\n  // its own boundary in front of this route is not broken and must not be stopped at boot.\n  if (process.env.NODE_ENV === 'production' && !opts.identity && !opts.resolveResourceId) {\n    console.warn(\n      '[gnl agui-route] no `identity` and no `resolveResourceId` in production — runs will be born ownerless; ' +\n      'ownership gates stay fail-open (a run with no owner is refused to nobody). Pass `identity: (req) => ({ resourceId })` ' +\n      'reading your session/JWT — never the request body.',\n    );\n  }\n  const app = new Hono();\n  app.post('/agents/:name/run', async (c) => {\n    const name = c.req.param('name');\n    const body = (await c.req.json().catch(() => ({}))) as any;\n    // Resolved once — the same reason chat-adapter states: a resolver that reads the request may\n    // answer differently the second time, and these two fields must agree about who this is.\n    // Resolved FIRST, because the identity decision below cannot be made without knowing the subject.\n    const ident = await opts.identity?.(c.req.raw);\n    const subject = opts.resolveResourceId?.(c, body) ?? ident?.resourceId;\n    // WHICH ORGANIZATION — only `identity` can say, and never the body. Same rule and same reason as\n    // the sibling route: an org is an isolation boundary, so it comes from the hook that already\n    // reads a verified session, and `sealRequestContext` strips any the caller tried to assert.\n    const org = ident?.orgId;\n    // WHICH RUN (package #5, §7). Two names can arrive, and they follow different rules:\n    //\n    //   `body.workKey` — DECLARED. Always a workKey, always fail-closed: without an address the\n    //   engine cannot tell whose job this is (§6), and the field is new, so nobody loses anything.\n    //\n    //   `Idempotency-Key` — IMPLICIT, usually stamped by a gateway. A workKey when there is a\n    //   subject, otherwise the raw runId it has been since FAZ-1. The precedence and the reason are\n    //   @gnldev/chat-adapter's, as they were when this header was first accepted here — and so is the\n    //   fallback: this route ships with no auth, and refusing every identity-less deployment that\n    //   put a proxy in front of it would be a regression dressed as a rule.\n    //\n    // Nothing else moves: with no identity at all this route still answers 400, as it always has.\n    const header = c.req.header('Idempotency-Key');\n    if (!body.runId && !body.workKey && header) {\n      if (subject) body.workKey = header;\n      else body.runId = header;\n    }\n    if (!body.runId && !body.workKey) return c.json({ error: 'runId or workKey is required (one names an id, the other names the work)' }, 400);\n    let identity: ResolvedWorkIdentity;\n    try {\n      identity = resolveWorkIdentity(`agent:${name}`, {\n        ...(body.runId !== undefined ? { runId: body.runId } : {}),\n        ...(body.workKey !== undefined ? { workKey: body.workKey } : {}),\n        // The agent's own declaration — which address a name is unique within is a property of the\n        // work, not of the request (see AgentConfig.workScope).\n        scopeKind: gnl.agent(name).workScope ?? 'resource',\n        ...(subject ? { resourceId: subject } : {}),\n        // THE ORG — REST parity (§7). @gnldev/server passes it; without it an `'org'` workScope\n        // lands on the deployment sentinel (§10.2) and the same org's same named work gets a\n        // DIFFERENT id here than it does through REST. Note this is also what makes an org-scoped\n        // run with NO subject work: an org address is an address, so the fail-closed `'resource'`\n        // rule above does not apply to the nightly-reconciliation case.\n        ...(org ? { orgId: org } : {}),\n        anonymous: 'refuse',\n        surface: `POST /agents/${name}/run`,\n      });\n    } catch (e: any) {\n      return c.json({ error: String(e?.message ?? e) }, 400);\n    }\n    const runId = identity.runId!;\n    const declared = identity.work?.workKey;\n    // `identity` sits below the dedicated resolver and above the body: it is server-derived, the body\n    // is not.\n    const threadId = opts.resolveThreadId?.(c, body) ?? ident?.threadId ?? body.threadId ?? runId;\n    let result: any;\n    try {\n      result = await gnl.stream(name, {\n        // The NAME when one was declared, the raw id otherwise — the door re-resolves the same tuple\n        // and lands on the same id, and only the name gets written into the run's record.\n        ...(declared !== undefined ? { workKey: declared } : { runId }),\n        prompt: body.prompt,\n        messages: body.messages,\n        // `threadId`, hesaplanan değer — `body.threadId` DEĞİL. Bu satır ölü koddu: `resolveThreadId`\n        // çağrılıyor, sonucu yalnız SSE zarfına gidiyordu, koşum yine istemcinin dediği thread'e\n        // yazıp okuyordu. Yani host'un kimliği auth'tan türetmek için verdiği TEK kanca hafızayı hiç\n        // etkilemiyordu; host \"düzelttim\" sanıyordu.\n        threadId,\n        approvals: body.approvals,\n        // HER ZAMAN mühürlü — kimlik bilinmese bile. Ayrılmış anahtarlar motorun \"bunu sunucu\n        // doğruladı\" kanalıdır; mühürsüz bir gövde o kanalın sahibi olur.\n        context: sealRequestContext(body.context ?? {}, {\n          ...(subject ? { resourceId: subject } : {}),\n          // The org goes into the seal too, so the record and the dynamic `system`/`tools` see the\n          // same organization the id was derived under — the derivation and the seal must not\n          // disagree about which boundary this run is inside.\n          ...(org ? { orgId: org } : {}),\n        }),\n        ...(subject ? { resourceId: subject } : {}),\n      });\n    } catch (e: any) {\n      // A refusal thrown BEFORE the stream exists is still one of ours, and it used to arrive as a bare\n      // 400 with the reason flattened into prose. `streamDurable` asserts thread ownership and takes the\n      // run lock before it returns anything, so `RunThreadMismatchError`, `RunBusyError`,\n      // `SideEffectRetryBlockedError` and `RetryLimitExceededError` all land here — the same errors\n      // @gnldev/server answers with a status and a `code`. A client talking to this route had to match\n      // on the sentence instead, which is the practice the typed errors exist to end.\n      //\n      // Errors raised MID-stream are a different contract and are untouched: once frames are flowing\n      // they surface as an SSE `error` event (see pipeAguiStream), because a response already committed to\n      // 200 cannot become a 409.\n      const name = (e as { name?: string })?.name;\n      if (name === 'RunThreadMismatchError') {\n        return c.json({ error: e.message, code: 'run_thread_mismatch', detail: withWorkKey(e.detail, declared) }, 409);\n      }\n      // FAZ-4 caller-conflict family (K9: durable's single map — this route was the consumer the\n      // first cut forgot; a critical-profile input/actor/swept refusal must not collapse to a bare 400).\n      const conflict = callerConflictCode(e);\n      if (conflict) {\n        return c.json({ error: e.message, code: conflict, detail: withWorkKey(e.detail, declared) }, 409);\n      }\n      const blocked = blockedErrorCode(e);\n      if (blocked) {\n        const body = { error: e?.message ?? String(e), code: blocked, detail: e?.detail };\n        const res = blocked === 'retry_limit_exceeded'\n          ? c.json(body, 422)\n          : c.json({ ...body, resumable: true }, 409);\n        // Same Retry-After contract as @gnldev/server and chat-adapter: run_busy is \"correct, only early\".\n        if (blocked === 'run_busy') res.headers.set('Retry-After', '5');\n        return res;\n      }\n      if (name === 'RunLimitExceededError' || name === 'ToolLoopDetectedError') {\n        const code = name === 'RunLimitExceededError' ? EDGE_ERROR_CODES.runLimitExceeded : EDGE_ERROR_CODES.toolLoopDetected;\n        return c.json({ error: e.message, code, detail: e.detail, resumable: true }, 422);\n      }\n      return c.json({ error: String(e?.message ?? e) }, 400);\n    }\n    return pipeAguiStream(c, runId, result, { threadId });\n  });\n  return app;\n}\n\n/** The AG-UI route as a fetch handler — mount with `app.mount(path, ...)` on a Hono host. */\nexport function createAguiRoute(config: CreateGnlConfig, opts: CreateAguiRouteOptions = {}): FetchHandler {\n  return toFetchHandler(aguiRouteApp(config, opts));\n}\n"]}

package/dist/types.d.ts

@@ -0,0 +1,88 @@
+/** The core type tag carried by all AG-UI events. */
+export declare enum EventType {
+    RUN_STARTED = "RUN_STARTED",
+    RUN_FINISHED = "RUN_FINISHED",
+    RUN_ERROR = "RUN_ERROR",
+    TEXT_MESSAGE_START = "TEXT_MESSAGE_START",
+    TEXT_MESSAGE_CONTENT = "TEXT_MESSAGE_CONTENT",
+    TEXT_MESSAGE_END = "TEXT_MESSAGE_END",
+    TOOL_CALL_START = "TOOL_CALL_START",
+    TOOL_CALL_ARGS = "TOOL_CALL_ARGS",
+    TOOL_CALL_END = "TOOL_CALL_END",
+    TOOL_CALL_RESULT = "TOOL_CALL_RESULT",
+    /** The spec's general-purpose escape hatch — for signals with no counterpart in the core (see interrupt mapping). */
+    CUSTOM = "CUSTOM"
+}
+/** Fields common to every event. `timestamp`/`rawEvent` exist in the official spec but we only fill them in when needed. */
+export interface BaseAguiEvent {
+    type: EventType;
+    timestamp?: number;
+    /** Escape hatch for extra/raw data that doesn't fit the core schema (e.g. GNL error.detail). */
+    rawEvent?: unknown;
+}
+export interface RunStartedEvent extends BaseAguiEvent {
+    type: EventType.RUN_STARTED;
+    threadId: string;
+    runId: string;
+}
+export interface RunFinishedEvent extends BaseAguiEvent {
+    type: EventType.RUN_FINISHED;
+    threadId: string;
+    runId: string;
+    /** UNCERTAIN: we're not sure whether/what the official spec's field carrying the run result is called —
+     *  as a best effort we carry GNL's finishReason/usage here. */
+    result?: unknown;
+}
+export interface RunErrorEvent extends BaseAguiEvent {
+    type: EventType.RUN_ERROR;
+    message: string;
+    code?: string;
+}
+export interface TextMessageStartEvent extends BaseAguiEvent {
+    type: EventType.TEXT_MESSAGE_START;
+    messageId: string;
+    /** UNCERTAIN: it's not clear from the spec whether the role is always 'assistant' or can vary — since
+     *  the text streamed on the GNL side is always agent output, we give a fixed 'assistant'. */
+    role?: 'assistant';
+}
+export interface TextMessageContentEvent extends BaseAguiEvent {
+    type: EventType.TEXT_MESSAGE_CONTENT;
+    messageId: string;
+    delta: string;
+}
+export interface TextMessageEndEvent extends BaseAguiEvent {
+    type: EventType.TEXT_MESSAGE_END;
+    messageId: string;
+}
+export interface ToolCallStartEvent extends BaseAguiEvent {
+    type: EventType.TOOL_CALL_START;
+    toolCallId: string;
+    toolCallName: string;
+    /** UNCERTAIN: we're not sure whether the spec has an optional field linking to the assistant message that started the tool call. */
+    parentMessageId?: string;
+}
+export interface ToolCallArgsEvent extends BaseAguiEvent {
+    type: EventType.TOOL_CALL_ARGS;
+    toolCallId: string;
+    /** In the official spec this is an incremental JSON chunk (streaming args) — since GNL's tool-call
+     *  gives arguments COMPLETE (not streaming), here the entire JSON is sent in a SINGLE delta (see README note). */
+    delta: string;
+}
+export interface ToolCallEndEvent extends BaseAguiEvent {
+    type: EventType.TOOL_CALL_END;
+    toolCallId: string;
+}
+export interface ToolCallResultEvent extends BaseAguiEvent {
+    type: EventType.TOOL_CALL_RESULT;
+    messageId: string;
+    toolCallId: string;
+    content: string;
+    role?: 'tool';
+}
+/** For signals with no counterpart in the core (GNL interrupt/HITL is carried here — see README). */
+export interface CustomEvent extends BaseAguiEvent {
+    type: EventType.CUSTOM;
+    name: string;
+    value: unknown;
+}
+export type AguiEvent = RunStartedEvent | RunFinishedEvent | RunErrorEvent | TextMessageStartEvent | TextMessageContentEvent | TextMessageEndEvent | ToolCallStartEvent | ToolCallArgsEvent | ToolCallEndEvent | ToolCallResultEvent | CustomEvent;

package/dist/types.js

@@ -0,0 +1,22 @@
+// AG-UI (https://github.com/ag-ui-protocol/ag-ui — CopilotKit's open agent↔UI event protocol) core
+// event types. HONESTY NOTE: this is a hand-extracted TS equivalent of the SUBSET of the known spec we
+// need, WITHOUT installing the official `@ag-ui/core` package — not verified against the official
+// conformance test. Fields we're not sure about (rawEvent, RunFinishedEvent.result, TextMessageStart.role
+// being fixed) are marked in comments; no made-up fields were ADDED.
+/** The core type tag carried by all AG-UI events. */
+export var EventType;
+(function (EventType) {
+    EventType["RUN_STARTED"] = "RUN_STARTED";
+    EventType["RUN_FINISHED"] = "RUN_FINISHED";
+    EventType["RUN_ERROR"] = "RUN_ERROR";
+    EventType["TEXT_MESSAGE_START"] = "TEXT_MESSAGE_START";
+    EventType["TEXT_MESSAGE_CONTENT"] = "TEXT_MESSAGE_CONTENT";
+    EventType["TEXT_MESSAGE_END"] = "TEXT_MESSAGE_END";
+    EventType["TOOL_CALL_START"] = "TOOL_CALL_START";
+    EventType["TOOL_CALL_ARGS"] = "TOOL_CALL_ARGS";
+    EventType["TOOL_CALL_END"] = "TOOL_CALL_END";
+    EventType["TOOL_CALL_RESULT"] = "TOOL_CALL_RESULT";
+    /** The spec's general-purpose escape hatch — for signals with no counterpart in the core (see interrupt mapping). */
+    EventType["CUSTOM"] = "CUSTOM";
+})(EventType || (EventType = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,uGAAuG;AACvG,kGAAkG;AAClG,0GAA0G;AAC1G,qEAAqE;AAErE,qDAAqD;AACrD,MAAM,CAAN,IAAY,SAaX;AAbD,WAAY,SAAS;IACnB,wCAA2B,CAAA;IAC3B,0CAA6B,CAAA;IAC7B,oCAAuB,CAAA;IACvB,sDAAyC,CAAA;IACzC,0DAA6C,CAAA;IAC7C,kDAAqC,CAAA;IACrC,gDAAmC,CAAA;IACnC,8CAAiC,CAAA;IACjC,4CAA+B,CAAA;IAC/B,kDAAqC,CAAA;IACrC,qHAAqH;IACrH,8BAAiB,CAAA;AACnB,CAAC,EAbW,SAAS,KAAT,SAAS,QAapB","sourcesContent":["// AG-UI (https://github.com/ag-ui-protocol/ag-ui — CopilotKit's open agent↔UI event protocol) core\n// event types. HONESTY NOTE: this is a hand-extracted TS equivalent of the SUBSET of the known spec we\n// need, WITHOUT installing the official `@ag-ui/core` package — not verified against the official\n// conformance test. Fields we're not sure about (rawEvent, RunFinishedEvent.result, TextMessageStart.role\n// being fixed) are marked in comments; no made-up fields were ADDED.\n\n/** The core type tag carried by all AG-UI events. */\nexport enum EventType {\n  RUN_STARTED = 'RUN_STARTED',\n  RUN_FINISHED = 'RUN_FINISHED',\n  RUN_ERROR = 'RUN_ERROR',\n  TEXT_MESSAGE_START = 'TEXT_MESSAGE_START',\n  TEXT_MESSAGE_CONTENT = 'TEXT_MESSAGE_CONTENT',\n  TEXT_MESSAGE_END = 'TEXT_MESSAGE_END',\n  TOOL_CALL_START = 'TOOL_CALL_START',\n  TOOL_CALL_ARGS = 'TOOL_CALL_ARGS',\n  TOOL_CALL_END = 'TOOL_CALL_END',\n  TOOL_CALL_RESULT = 'TOOL_CALL_RESULT',\n  /** The spec's general-purpose escape hatch — for signals with no counterpart in the core (see interrupt mapping). */\n  CUSTOM = 'CUSTOM',\n}\n\n/** Fields common to every event. `timestamp`/`rawEvent` exist in the official spec but we only fill them in when needed. */\nexport interface BaseAguiEvent {\n  type: EventType;\n  timestamp?: number;\n  /** Escape hatch for extra/raw data that doesn't fit the core schema (e.g. GNL error.detail). */\n  rawEvent?: unknown;\n}\n\nexport interface RunStartedEvent extends BaseAguiEvent {\n  type: EventType.RUN_STARTED;\n  threadId: string;\n  runId: string;\n}\n\nexport interface RunFinishedEvent extends BaseAguiEvent {\n  type: EventType.RUN_FINISHED;\n  threadId: string;\n  runId: string;\n  /** UNCERTAIN: we're not sure whether/what the official spec's field carrying the run result is called —\n   *  as a best effort we carry GNL's finishReason/usage here. */\n  result?: unknown;\n}\n\nexport interface RunErrorEvent extends BaseAguiEvent {\n  type: EventType.RUN_ERROR;\n  message: string;\n  code?: string;\n}\n\nexport interface TextMessageStartEvent extends BaseAguiEvent {\n  type: EventType.TEXT_MESSAGE_START;\n  messageId: string;\n  /** UNCERTAIN: it's not clear from the spec whether the role is always 'assistant' or can vary — since\n   *  the text streamed on the GNL side is always agent output, we give a fixed 'assistant'. */\n  role?: 'assistant';\n}\n\nexport interface TextMessageContentEvent extends BaseAguiEvent {\n  type: EventType.TEXT_MESSAGE_CONTENT;\n  messageId: string;\n  delta: string;\n}\n\nexport interface TextMessageEndEvent extends BaseAguiEvent {\n  type: EventType.TEXT_MESSAGE_END;\n  messageId: string;\n}\n\nexport interface ToolCallStartEvent extends BaseAguiEvent {\n  type: EventType.TOOL_CALL_START;\n  toolCallId: string;\n  toolCallName: string;\n  /** UNCERTAIN: we're not sure whether the spec has an optional field linking to the assistant message that started the tool call. */\n  parentMessageId?: string;\n}\n\nexport interface ToolCallArgsEvent extends BaseAguiEvent {\n  type: EventType.TOOL_CALL_ARGS;\n  toolCallId: string;\n  /** In the official spec this is an incremental JSON chunk (streaming args) — since GNL's tool-call\n   *  gives arguments COMPLETE (not streaming), here the entire JSON is sent in a SINGLE delta (see README note). */\n  delta: string;\n}\n\nexport interface ToolCallEndEvent extends BaseAguiEvent {\n  type: EventType.TOOL_CALL_END;\n  toolCallId: string;\n}\n\nexport interface ToolCallResultEvent extends BaseAguiEvent {\n  type: EventType.TOOL_CALL_RESULT;\n  messageId: string;\n  toolCallId: string;\n  content: string;\n  role?: 'tool';\n}\n\n/** For signals with no counterpart in the core (GNL interrupt/HITL is carried here — see README). */\nexport interface CustomEvent extends BaseAguiEvent {\n  type: EventType.CUSTOM;\n  name: string;\n  value: unknown;\n}\n\nexport type AguiEvent =\n  | RunStartedEvent\n  | RunFinishedEvent\n  | RunErrorEvent\n  | TextMessageStartEvent\n  | TextMessageContentEvent\n  | TextMessageEndEvent\n  | ToolCallStartEvent\n  | ToolCallArgsEvent\n  | ToolCallEndEvent\n  | ToolCallResultEvent\n  | CustomEvent;\n"]}