@adia-ai/agent 0.8.28 → 0.8.30

package/agent.js

@@ -19,7 +19,11 @@ import { composeSystem } from './prompt.js';
 import { attachLayers, resourceTools } from './resource.js';
 import { createSession } from './session.js';
 import { frameClientMessage, shouldRunTurn } from './frame.js';
+import { defineGuardrail } from './guardrail.js';
 import { runLoop } from './loop.js';
+import { assertUniqueToolNames, connectMcpSource, } from './mcp.js';
+import { McpConnectionError } from './mcp-transport.js';
+import { createTracer } from './trace.js';
 import { runWorkflow } from './workflow.js';
 const DEFAULT_MAX_TOOL_ROUNDS = 8;
 export function createAgent(config) {
@@ -43,12 +47,107 @@ export function createAgent(config) {
         return _resolved;
     }
     const layers = config.prompt ?? [];
-    const resources = config.resources ?? [];
-    const tools = [...(config.tools ?? []), ...resourceTools(resources)];
+    const declaredResources = config.resources ?? [];
+    const declaredTools = [...(config.tools ?? []), ...resourceTools(declaredResources)];
     const workflows = new Map((config.workflows ?? []).map(w => [w.name, w]));
     const maxToolRounds = config.maxToolRounds ?? DEFAULT_MAX_TOOL_ROUNDS;
-    async function chatOverrides(provider) {
-        const allLayers = [...layers, ...(await attachLayers(resources))];
+    // MCP sources: one memoized connect for the agent's lifetime. A rejection
+    // is NOT cached as a permanent verdict — the next turn retries, because a
+    // server that was down at 10:00 may be up at 10:01 and an agent that
+    // poisoned itself over one failed fetch is worse than one that retries.
+    const sources = config.integrations ?? [];
+    let connected = [];
+    let connecting = null;
+    // Bumped by close(). A connect that finishes after its generation went
+    // stale must not install itself: otherwise close() returns, the sessions
+    // look shut, and a moment later a late resolve quietly reopens the agent
+    // with connections nobody is going to close.
+    let generation = 0;
+    async function closeAll(servers) {
+        await Promise.all(servers.map(server => server.connection.close().catch(() => { })));
+    }
+    // Trace records produced while connecting, waiting for a turn to carry
+    // them onto the event stream. The SINK already saw them at record time;
+    // this is only about the second consumer, the stream.
+    const pendingTrace = [];
+    async function ensureConnected(sessionId, signal) {
+        if (!sources.length)
+            return [];
+        if (connected.length === sources.length)
+            return connected;
+        if (!connecting) {
+            const tracer = createTracer(config.trace, sessionId);
+            const note = (name, data) => {
+                const record = tracer.record('mcp', name, data);
+                if (record)
+                    pendingTrace.push(record);
+            };
+            const startedGeneration = generation;
+            connecting = (async () => {
+                const results = [];
+                try {
+                    for (const source of sources) {
+                        const startedAt = Date.now();
+                        try {
+                            const server = await connectMcpSource(source, signal ? { signal } : {});
+                            results.push(server);
+                            note('connect', {
+                                url: server.url,
+                                server: server.serverInfo.name,
+                                protocol: server.protocolVersion,
+                                tools: server.tools.length,
+                                resources: server.resources.length,
+                                ms: Date.now() - startedAt,
+                            });
+                        }
+                        catch (err) {
+                            note('connect:failed', {
+                                url: source.url,
+                                error: err.message,
+                                ms: Date.now() - startedAt,
+                            });
+                            throw err;
+                        }
+                    }
+                    assertUniqueToolNames([...declaredTools, ...results.flatMap(s => s.toolDefs)]);
+                    if (startedGeneration !== generation) {
+                        // close() ran while we were connecting. Nobody wants these.
+                        throw new McpConnectionError('the agent was closed while connecting');
+                    }
+                }
+                catch (err) {
+                    // Source B failed after source A shook hands: A's session is open,
+                    // referenced by nothing, and about to be forgotten. Shut it.
+                    await closeAll(results);
+                    throw err;
+                }
+                connected = results;
+                return results;
+            })().finally(() => { connecting = null; });
+        }
+        return connecting;
+    }
+    function assembledTools(servers) {
+        if (!servers.length)
+            return declaredTools;
+        const mcpResources = servers.flatMap(s => s.resourceDefs);
+        return [...declaredTools, ...servers.flatMap(s => s.toolDefs), ...resourceTools(mcpResources)];
+    }
+    // `onToolCall` IS a guardrail — one of the `toolCall` kind, first in the
+    // chain so its verdict keeps precedence over anything declared later.
+    const guardrails = [
+        ...(config.onToolCall
+            ? [defineGuardrail({
+                    name: 'onToolCall',
+                    toolCall: async (call, toolCtx) => (await config.onToolCall(call, toolCtx)) === false
+                        ? { action: 'deny', reason: 'denied by onToolCall' }
+                        : { action: 'allow' },
+                })]
+            : []),
+        ...(config.guardrails ?? []),
+    ];
+    async function chatOverrides(provider, resources, signal) {
+        const allLayers = [...layers, ...(await attachLayers(resources, signal ? { signal } : undefined))];
         if (!allLayers.length)
             return {};
         const composed = composeSystem(allLayers);
@@ -59,21 +158,71 @@ export function createAgent(config) {
         return { system: composed.text };
     }
     return {
-        tools,
+        get tools() {
+            return assembledTools(connected);
+        },
         createSession(id) {
             return createSession(id);
         },
+        async connect() {
+            const servers = await ensureConnected();
+            return servers.map(({ url, serverInfo, protocolVersion, tools: names, resources: reported }) => ({
+                url, serverInfo, protocolVersion, tools: names, resources: reported,
+            }));
+        },
+        async close() {
+            generation++;
+            const open = connected;
+            const inFlight = connecting;
+            connected = [];
+            // Wait out a connect already in the air: it sees the stale generation,
+            // closes whatever it opened, and rejects. Its rejection belongs to
+            // whoever asked for it, not to close().
+            if (inFlight)
+                await inFlight.catch(() => { });
+            await closeAll(open);
+        },
         async *send(session, text, opts = {}) {
             yield { type: 'message', role: 'user', text };
             const { client, provider } = await resolveClient();
+            // Connect-time failure throws out of the generator: an unreachable
+            // server is a configuration/infrastructure fault, the same class as a
+            // missing @adia-ai/llm — not something the model can be told about and
+            // work around. A tool call that fails once the session is up IS
+            // model-visible, and comes back as an isError tool_result.
+            const servers = await ensureConnected(session.id, opts.signal);
+            while (pendingTrace.length)
+                yield { type: 'trace', record: pendingTrace.shift() };
+            const tools = assembledTools(servers);
+            const resources = [...declaredResources, ...servers.flatMap(s => s.resourceDefs)];
             const messages = [...session.messages, { role: 'user', content: text }];
             const ctx = { sessionId: session.id, ...(opts.signal ? { signal: opts.signal } : {}) };
+            const tracer = createTracer(config.trace, session.id);
+            // An attach-mode resource is READ here, during assembly. A read that
+            // fails throws out of send() (McpCallError for an MCP one) — there is
+            // no turn to degrade into: the prompt the model was going to see is
+            // the thing that could not be built.
+            const chat = await chatOverrides(provider, resources, opts.signal);
+            if (tracer.enabled) {
+                const record = tracer.record('prompt', 'assembled', {
+                    layers: layers.length,
+                    attachResources: resources.filter(r => r.mode === 'attach').length,
+                    cached: Array.isArray(chat.system) ? chat.system.filter(b => 'cache_control' in b).length : 0,
+                    chars: Array.isArray(chat.system)
+                        ? chat.system.reduce((n, b) => n + b.text.length, 0)
+                        : (chat.system?.length ?? 0),
+                    tools: tools.length,
+                });
+                if (record)
+                    yield { type: 'trace', record };
+            }
             yield* runLoop(messages, {
                 client,
-                chat: await chatOverrides(provider),
+                chat,
                 tools,
                 maxToolRounds,
-                ...(config.onToolCall ? { onToolCall: config.onToolCall } : {}),
+                ...(guardrails.length ? { guardrails } : {}),
+                ...(tracer.enabled ? { tracer } : {}),
                 ctx,
             });
         },
@@ -83,15 +232,30 @@ export function createAgent(config) {
             const text = frameClientMessage(msg);
             yield* this.send(session, text, opts);
         },
-        async run(session, workflowName, input, onEvent) {
+        async run(session, workflowName, input, opts) {
             const workflow = workflows.get(workflowName);
             if (!workflow) {
                 throw new Error(`Unknown workflow "${workflowName}". Declared: ${[...workflows.keys()].join(', ') || '(none)'}`);
             }
+            const runOpts = typeof opts === 'function' ? { onEvent: opts } : (opts ?? {});
+            const onEvent = runOpts.onEvent;
+            const tracer = createTracer(config.trace, session.id);
+            const services = { ...(config.services ?? {}), ...(runOpts.services ?? {}) };
             return runWorkflow(workflow, {
                 input,
+                services,
                 sessionId: session.id,
+                ...(runOpts.signal ? { signal: runOpts.signal } : {}),
                 ...(onEvent ? { emit: (e) => onEvent(e) } : {}),
+                ...(tracer.enabled
+                    ? {
+                        trace: (phase, name, data) => {
+                            const record = tracer.record(phase, name, data);
+                            if (record && onEvent)
+                                onEvent({ type: 'trace', record });
+                        },
+                    }
+                    : {}),
             });
         },
     };

package/agent.js.map

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

package/events.d.ts

@@ -9,7 +9,8 @@
  * but never touches the caller's Session — reduce is the single writer.
  */
 import type { AdapterUsage } from '@adia-ai/llm';
-import type { Msg, Session } from './session.js';
+import { type JsonValue, type Msg, type Session } from './session.js';
+import type { TraceRecord } from './trace.js';
 /** CHAT-HARNESS law 3 — the closed, code-owned progress vocabulary. Every
  *  reader that renders labels does so from its OWN table keyed on these
  *  strings — never from model text — and drops anything not in this array
@@ -37,6 +38,18 @@ export type AgentEvent = {
     id: string;
     name: string;
     input: Record<string, unknown>;
+}
+/** A fragment of a tool call's arguments as the provider streams them
+ *  (Anthropic `input_json_delta`, OpenAI partial argument strings).
+ *  `snapshot` is the raw JSON text so far — it is NOT parseable until the
+ *  matching `tool_use` arrives, and NOTHING may execute off it. Render
+ *  progress from it; act only on `tool_use`. Render-only in reduce(). */
+ | {
+    type: 'tool_input_delta';
+    id: string;
+    name: string;
+    partial: string;
+    snapshot: string;
 } | {
     type: 'tool_result';
     id: string;
@@ -71,6 +84,31 @@ export type AgentEvent = {
     type: 'surface';
     surfaceId: string;
     line: string;
+}
+/** A guardrail vetoed or rewrote something. Render-only: the effect is
+ *  already in the tool_result / done event that follows. */
+ | {
+    type: 'guardrail';
+    name: string;
+    target: 'tool_call' | 'output';
+    action: 'deny' | 'rewrite';
+    reason?: string;
+    /** Tool-call interventions name the call they acted on. */
+    toolName?: string;
+    toolUseId?: string;
+}
+/** One structured trace record (see trace.ts). Present only when tracing
+ *  is enabled; render-only. */
+ | {
+    type: 'trace';
+    record: TraceRecord;
+}
+/** The ONLY way session memory changes. A null value deletes the key.
+ *  Emitted by a tool through `ctx.remember`, or constructed directly with
+ *  `remember()` and folded by the caller. */
+ | {
+    type: 'memory';
+    patch: Record<string, JsonValue | null>;
 };
 /** Fold one event into a Session. Message-building rules:
  *  - `message`      → append the user message.
@@ -81,11 +119,17 @@ export type AgentEvent = {
  *                     (consecutive results merge into ONE tool msg — the
  *                     Anthropic wire requires alternating roles).
  *  - `done`         → close any remaining draft as the final assistant msg.
- *  - `thinking`/`step`/`error`/`progress`/`surface` → no session effect
+ *  - `memory`       → merge the patch into `session.memory` (null deletes);
+ *                     the patch must be JSON-safe or the write throws.
+ *  - `thinking`/`step`/`error`/`progress`/`surface`/`tool_input_delta`/
+ *    `guardrail`/`trace` → no session effect
  *    (render-only events — `progress`/`surface` included by the same rule:
  *    they narrate the turn in flight, they don't alter the transcript).
  */
 export declare function reduce(session: Session, event: AgentEvent): Session;
+/** Build a memory write. Validated here so a bad patch fails where it was
+ *  authored, not later inside a reduce() the author never sees. */
+export declare function remember(patch: Record<string, JsonValue | null>): AgentEvent;
 /** Convenience for the loop and tests: fold a whole event array. */
 export declare function reduceAll(session: Session, events: AgentEvent[]): Session;
 export type { Msg, Session };

package/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["src/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAQ,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEjD;;;;8CAI8C;AAC9C,eAAO,MAAM,eAAe,6FAElB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D;;oDAEoD;AACpD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC9E;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACpF;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE;AACjC;6BAC6B;GAC3B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE;AAC5C;;;+BAG+B;GAC7B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAsEnE;AAED,oEAAoE;AACpE,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAIzE;AAED,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["src/events.ts"],"names":[],"mappings":"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"}

package/events.js

@@ -8,6 +8,7 @@
  * reduce() is pure: (session, event) → new session. The loop emits events
  * but never touches the caller's Session — reduce is the single writer.
  */
+import { assertJsonSafe } from './session.js';
 /** CHAT-HARNESS law 3 — the closed, code-owned progress vocabulary. Every
  *  reader that renders labels does so from its OWN table keyed on these
  *  strings — never from model text — and drops anything not in this array
@@ -31,7 +32,10 @@ export function isProgressStage(value) {
  *                     (consecutive results merge into ONE tool msg — the
  *                     Anthropic wire requires alternating roles).
  *  - `done`         → close any remaining draft as the final assistant msg.
- *  - `thinking`/`step`/`error`/`progress`/`surface` → no session effect
+ *  - `memory`       → merge the patch into `session.memory` (null deletes);
+ *                     the patch must be JSON-safe or the write throws.
+ *  - `thinking`/`step`/`error`/`progress`/`surface`/`tool_input_delta`/
+ *    `guardrail`/`trace` → no session effect
  *    (render-only events — `progress`/`surface` included by the same rule:
  *    they narrate the turn in flight, they don't alter the transcript).
  */
@@ -92,16 +96,41 @@ export function reduce(session, event) {
             delete next.draft;
             return next;
         }
+        case 'memory': {
+            assertJsonSafe(event.patch);
+            const memory = { ...(session.memory ?? {}) };
+            for (const [key, value] of Object.entries(event.patch)) {
+                if (value === null)
+                    delete memory[key];
+                else
+                    memory[key] = value;
+            }
+            if (!Object.keys(memory).length) {
+                const next = { ...session };
+                delete next.memory;
+                return next;
+            }
+            return { ...session, memory };
+        }
         case 'thinking':
         case 'step':
         case 'error':
         case 'progress':
         case 'surface':
+        case 'tool_input_delta':
+        case 'guardrail':
+        case 'trace':
             return session;
         default:
             return session;
     }
 }
+/** Build a memory write. Validated here so a bad patch fails where it was
+ *  authored, not later inside a reduce() the author never sees. */
+export function remember(patch) {
+    assertJsonSafe(patch);
+    return { type: 'memory', patch };
+}
 /** Convenience for the loop and tests: fold a whole event array. */
 export function reduceAll(session, events) {
     let next = session;

package/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["src/events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["src/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,cAAc,EAA0C,MAAM,cAAc,CAAC;AAGtF;;;;8CAI8C;AAC9C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM;CACxE,CAAC;AAIX;;oDAEoD;AACpD,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,eAAqC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC7F,CAAC;AA6CD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,MAAM,CAAC,OAAgB,EAAE,KAAiB;IACxD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,SAAS;YACZ,OAAO;gBACL,GAAG,OAAO;gBACV,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;aACvE,CAAC;QAEJ,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YACvD,OAAO,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;QACnE,CAAC;QAED,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YACvD,MAAM,KAAK,GAAW,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;YACvC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,CAAC;gBACtD,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACpD,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YACrF,OAAO,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC5D,CAAC;QAED,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,UAAU,GAAS;gBACvB,IAAI,EAAE,aAAa;gBACnB,SAAS,EAAE,KAAK,CAAC,EAAE;gBACnB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,MAAM;gBACrB,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5C,CAAC;YACF,MAAM,QAAQ,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;YACvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;YAC5B,IAAI,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;gBACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YAC7D,CAAC;YACD,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC3C,IAAI,KAAK,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI,EAAE,IAAI,KAAK,MAAM,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACrF,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YACzD,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;YAC3F,CAAC;YACD,MAAM,IAAI,GAAY,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC;YAC/C,OAAO,IAAI,CAAC,KAAK,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,QAAQ,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;YACvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;YAC5B,IAAI,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;gBACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YAC7D,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,EAAE,IAAI,EAAE,CAAC;gBACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;YACjF,CAAC;YACD,MAAM,IAAI,GAAY,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC;YAC/C,OAAO,IAAI,CAAC,KAAK,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC5B,MAAM,MAAM,GAA8B,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;YACxE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvD,IAAI,KAAK,KAAK,IAAI;oBAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;;oBAClC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAC3B,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;gBAChC,MAAM,IAAI,GAAY,EAAE,GAAG,OAAO,EAAE,CAAC;gBACrC,OAAO,IAAI,CAAC,MAAM,CAAC;gBACnB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC;QAChC,CAAC;QAED,KAAK,UAAU,CAAC;QAChB,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO,CAAC;QACb,KAAK,UAAU,CAAC;QAChB,KAAK,SAAS,CAAC;QACf,KAAK,kBAAkB,CAAC;QACxB,KAAK,WAAW,CAAC;QACjB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QAEjB;YACE,OAAO,OAAO,CAAC;IACnB,CAAC;AACH,CAAC;AAED;mEACmE;AACnE,MAAM,UAAU,QAAQ,CAAC,KAAuC;IAC9D,cAAc,CAAC,KAAK,CAAC,CAAC;IACtB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,SAAS,CAAC,OAAgB,EAAE,MAAoB;IAC9D,IAAI,IAAI,GAAG,OAAO,CAAC;IACnB,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/guardrail.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Guardrails — the deterministic layer between the model and the world.
+ *
+ * A guardrail is code that runs OUTSIDE the model's context and cannot be
+ * talked past: prompted guidance is missed on a real fraction of turns, a
+ * check in the loop is not. Two attach points, both declared once at
+ * `createAgent`:
+ *
+ *  - `toolCall` — sees every tool call BEFORE it executes; may allow, deny
+ *    (the model gets an isError tool_result naming the guardrail, the loop
+ *    continues), or rewrite the call's input (clamp a limit, strip a field,
+ *    force a scope).
+ *  - `output` — sees the model's completed text for a round; may allow,
+ *    rewrite (redaction), or deny (the turn ends with the synthetic
+ *    stopReason `guardrail_denied` and no model text).
+ *
+ * Order is declaration order, and it is a CHAIN: a rewrite feeds the next
+ * guardrail, the first deny wins and short-circuits. `AgentConfig.onToolCall`
+ * is now exactly one guardrail of the `toolCall` kind (adapted in agent.ts),
+ * kept for source compatibility.
+ *
+ * A guardrail decides from the CALL and the harness's own context — never
+ * from text the model produced asking to be trusted. Tool output, resource
+ * text, and model text are data.
+ */
+import type { ToolUse } from '@adia-ai/llm';
+import type { ToolContext } from './tools.js';
+export type GuardrailDecision = {
+    action: 'allow';
+} | {
+    action: 'deny';
+    reason: string;
+}
+/** Tool-call rewrite carries `input`; output rewrite carries `text`. */
+ | {
+    action: 'rewrite';
+    input?: Record<string, unknown>;
+    text?: string;
+    reason?: string;
+};
+/** A guardrail may also return nothing — the common "I have no opinion on
+ *  this one" case — which reads as `allow`. */
+export type GuardrailReturn = GuardrailDecision | void | undefined;
+export interface Guardrail {
+    name: string;
+    toolCall?: (call: ToolUse, ctx: ToolContext) => GuardrailReturn | Promise<GuardrailReturn>;
+    output?: (text: string, ctx: ToolContext) => GuardrailReturn | Promise<GuardrailReturn>;
+}
+export declare function defineGuardrail(guardrail: Guardrail): Guardrail;
+/** What the loop needs to know after running a chain. */
+export interface GuardrailOutcome<T> {
+    value: T;
+    denied?: {
+        name: string;
+        reason: string;
+    };
+    /** Names of guardrails that rewrote, in application order. */
+    rewrittenBy: string[];
+}
+/** Run the toolCall chain: each guardrail sees the call as the previous one
+ *  left it; the first deny stops the chain. */
+export declare function guardToolCall(guardrails: Guardrail[], call: ToolUse, ctx: ToolContext): Promise<GuardrailOutcome<ToolUse>>;
+/** Run the output chain over one round's completed text. */
+export declare function guardOutput(guardrails: Guardrail[], text: string, ctx: ToolContext): Promise<GuardrailOutcome<string>>;
+/** True when any declared guardrail has an output opinion — lets the loop
+ *  skip the whole output path (and its events) when nobody is listening. */
+export declare function hasOutputGuardrail(guardrails: Guardrail[]): boolean;
+//# sourceMappingURL=guardrail.d.ts.map

package/guardrail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrail.d.ts","sourceRoot":"","sources":["src/guardrail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GACnB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACpC,wEAAwE;GACtE;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3F;+CAC+C;AAC/C,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG,IAAI,GAAG,SAAS,CAAC;AAEnE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,KAAK,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC3F,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,KAAK,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACzF;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAM/D;AAED,yDAAyD;AACzD,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,KAAK,EAAE,CAAC,CAAC;IACT,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,8DAA8D;IAC9D,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAMD;+CAC+C;AAC/C,wBAAsB,aAAa,CACjC,UAAU,EAAE,SAAS,EAAE,EACvB,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAepC;AAED,4DAA4D;AAC5D,wBAAsB,WAAW,CAC/B,UAAU,EAAE,SAAS,EAAE,EACvB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAenC;AAED;4EAC4E;AAC5E,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAEnE"}

package/guardrail.js

@@ -0,0 +1,79 @@
+/**
+ * Guardrails — the deterministic layer between the model and the world.
+ *
+ * A guardrail is code that runs OUTSIDE the model's context and cannot be
+ * talked past: prompted guidance is missed on a real fraction of turns, a
+ * check in the loop is not. Two attach points, both declared once at
+ * `createAgent`:
+ *
+ *  - `toolCall` — sees every tool call BEFORE it executes; may allow, deny
+ *    (the model gets an isError tool_result naming the guardrail, the loop
+ *    continues), or rewrite the call's input (clamp a limit, strip a field,
+ *    force a scope).
+ *  - `output` — sees the model's completed text for a round; may allow,
+ *    rewrite (redaction), or deny (the turn ends with the synthetic
+ *    stopReason `guardrail_denied` and no model text).
+ *
+ * Order is declaration order, and it is a CHAIN: a rewrite feeds the next
+ * guardrail, the first deny wins and short-circuits. `AgentConfig.onToolCall`
+ * is now exactly one guardrail of the `toolCall` kind (adapted in agent.ts),
+ * kept for source compatibility.
+ *
+ * A guardrail decides from the CALL and the harness's own context — never
+ * from text the model produced asking to be trusted. Tool output, resource
+ * text, and model text are data.
+ */
+export function defineGuardrail(guardrail) {
+    if (!guardrail.name)
+        throw new Error('defineGuardrail: name is required');
+    if (!guardrail.toolCall && !guardrail.output) {
+        throw new Error(`defineGuardrail "${guardrail.name}": declare toolCall, output, or both`);
+    }
+    return guardrail;
+}
+function normalize(decision) {
+    return decision ?? { action: 'allow' };
+}
+/** Run the toolCall chain: each guardrail sees the call as the previous one
+ *  left it; the first deny stops the chain. */
+export async function guardToolCall(guardrails, call, ctx) {
+    let current = call;
+    const rewrittenBy = [];
+    for (const guardrail of guardrails) {
+        if (!guardrail.toolCall)
+            continue;
+        const decision = normalize(await guardrail.toolCall(current, ctx));
+        if (decision.action === 'deny') {
+            return { value: current, denied: { name: guardrail.name, reason: decision.reason }, rewrittenBy };
+        }
+        if (decision.action === 'rewrite' && decision.input) {
+            current = { ...current, input: decision.input };
+            rewrittenBy.push(guardrail.name);
+        }
+    }
+    return { value: current, rewrittenBy };
+}
+/** Run the output chain over one round's completed text. */
+export async function guardOutput(guardrails, text, ctx) {
+    let current = text;
+    const rewrittenBy = [];
+    for (const guardrail of guardrails) {
+        if (!guardrail.output)
+            continue;
+        const decision = normalize(await guardrail.output(current, ctx));
+        if (decision.action === 'deny') {
+            return { value: current, denied: { name: guardrail.name, reason: decision.reason }, rewrittenBy };
+        }
+        if (decision.action === 'rewrite' && typeof decision.text === 'string') {
+            current = decision.text;
+            rewrittenBy.push(guardrail.name);
+        }
+    }
+    return { value: current, rewrittenBy };
+}
+/** True when any declared guardrail has an output opinion — lets the loop
+ *  skip the whole output path (and its events) when nobody is listening. */
+export function hasOutputGuardrail(guardrails) {
+    return guardrails.some(g => !!g.output);
+}
+//# sourceMappingURL=guardrail.js.map

package/guardrail.js.map

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

package/index.d.ts

@@ -6,20 +6,28 @@
  * the serializable Session, and the one shared event reducer.
  */
 export { createAgent } from './agent.js';
-export type { Agent, AgentConfig, SendOpts } from './agent.js';
+export type { Agent, AgentConfig, SendOpts, RunOpts } from './agent.js';
 export { promptLayer, composeSystem } from './prompt.js';
 export type { PromptLayer, ComposedSystem } from './prompt.js';
 export { defineTool, executeTool, checkInput, toSpecs } from './tools.js';
 export type { ToolDef, ToolContext, ToolOutcome } from './tools.js';
-export { defineWorkflow, runWorkflow } from './workflow.js';
-export type { Workflow, WorkflowStep, WorkflowContext, WorkflowResult } from './workflow.js';
+export { defineWorkflow, runWorkflow, toVerdict } from './workflow.js';
+export type { Workflow, WorkflowStep, WorkflowContext, WorkflowResult, WorkflowAttempt, WorkflowOptions, WorkflowInvocation, Verdict, StepDecision, } from './workflow.js';
+export { defineGuardrail } from './guardrail.js';
+export type { Guardrail, GuardrailDecision, GuardrailReturn } from './guardrail.js';
+export { createTracer, consoleSink, TRACE_PHASES, isTracePhase } from './trace.js';
+export type { TraceRecord, TraceSink, TracePhase, TraceConfig, Tracer } from './trace.js';
 export { defineResource } from './resource.js';
-export type { ResourceDef } from './resource.js';
+export type { ResourceDef, ResourceContext } from './resource.js';
+export { mcpServer, connectMcpSource } from './mcp.js';
+export type { McpSource, McpServerOptions, McpServerReport, ConnectedMcpServer } from './mcp.js';
+export { connectStreamableHttp, McpError, McpConnectionError, McpCallError, DEFAULT_MCP_TIMEOUT_MS, } from './mcp-transport.js';
+export type { McpConnection, McpTransportOptions, McpRequestOptions } from './mcp-transport.js';
 export { createIntegrationRegistry, resolveIntegrations, buildToolDispatch, MAX_INTEGRATIONS } from './integrations.js';
 export type { IntegrationManifest, IntegrationRegistry, IntegrationContext, ResolvedIntegrations } from './integrations.js';
-export { createSession, toJSON, fromJSON } from './session.js';
-export type { Session, Msg, Draft } from './session.js';
-export { reduce, reduceAll, PROGRESS_STAGES, isProgressStage } from './events.js';
+export { createSession, toJSON, fromJSON, assertJsonSafe } from './session.js';
+export type { Session, Msg, Draft, JsonValue } from './session.js';
+export { reduce, reduceAll, remember, PROGRESS_STAGES, isProgressStage } from './events.js';
 export type { AgentEvent, ProgressStage } from './events.js';
 export { frameClientMessage, shouldRunTurn } from './frame.js';
 export type { ClientMessage } from './frame.js';

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1E,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5D,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACxH,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC5H,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC/D,YAAY,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAClF,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1E,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACvE,YAAY,EACV,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EACxE,eAAe,EAAE,kBAAkB,EAAE,OAAO,EAAE,YAAY,GAC3D,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACnF,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACvD,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACjG,OAAO,EACL,qBAAqB,EAAE,QAAQ,EAAE,kBAAkB,EAAE,YAAY,EAAE,sBAAsB,GAC1F,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAChG,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACxH,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC5H,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/E,YAAY,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC5F,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}