@pinecall/agents 0.9.20

package/dist/runtime/dispatch.js

@@ -0,0 +1,46 @@
+/** Dispatches `event.received` entries to the instance serving the call, or drops them. */
+import { emitEvent } from "../agent/agent.js";
+import { withAuthorAsync } from "../agent/authors.js";
+import { accepts } from "../agent/accepts.js";
+/**
+ * Dispatch after all earlier events finish. The cause lives on the call while a hook runs, so
+ * concurrent hooks would attribute writes to each other's event.
+ */
+export function inOrder(serving, received) {
+    const next = serving.queue.then(() => dispatch(serving, received));
+    // A throwing hook must not block later events; the rejection goes to the caller.
+    serving.queue = next.catch(() => undefined);
+    return next;
+}
+/**
+ * Pass the event to `onEvent` if its name and source are declared, else drop it. Writes inside the
+ * hook are authored `event:<name>`, and the call carries the cause so the log can name it.
+ */
+export async function dispatch(serving, received) {
+    const { name, data, source, seq } = received;
+    if (!accepts(serving.ctor, name, source)) {
+        warn(serving, name, source);
+        return false;
+    }
+    const meta = { source, seq, ...(received.identity === undefined ? {} : { identity: received.identity }) };
+    const hook = serving.agent.onEvent;
+    serving.call.cause = { name, seq };
+    try {
+        await withAuthorAsync(`event:${name}`, () => hook.call(serving.agent, name, data, meta));
+    }
+    finally {
+        serving.call.cause = null;
+    }
+    const heard = { name, data, meta };
+    emitEvent(serving.agent, heard);
+    return true;
+}
+// Once per (call, name): a backend sending an undeclared event usually sends it repeatedly.
+function warn(serving, name, source) {
+    const key = `${serving.call.id}:${name}`;
+    if (serving.warned.has(key))
+        return;
+    serving.warned.add(key);
+    console.warn(`pinecall: event ${name} from ${source} is not declared by this agent; dropped`);
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/runtime/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../src/runtime/dispatch.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAE3F,OAAO,EAAE,SAAS,EAAmB,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAoC,MAAM,qBAAqB,CAAC;AAuBhF;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,OAAgB,EAAE,QAAkB;IAC1D,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IACnE,iFAAiF;IACjF,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAgB,EAAE,QAAkB;IACjE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC;IAC7C,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,GAAc,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC;IACrH,MAAM,IAAI,GAAI,OAAO,CAAC,KAAuF,CAAC,OAAO,CAAC;IACtH,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,eAAe,CAAC,SAAS,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAC3F,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IAC5B,CAAC;IACD,MAAM,KAAK,GAAe,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC/C,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAChC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,4FAA4F;AAC5F,SAAS,IAAI,CAAC,OAAgB,EAAE,IAAY,EAAE,MAAmB;IAC/D,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;IACzC,IAAI,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO;IACpC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,CAAC,IAAI,CAAC,mBAAmB,IAAI,SAAS,MAAM,yCAAyC,CAAC,CAAC;AAChG,CAAC"}

package/dist/runtime/environment.d.ts

@@ -0,0 +1,7 @@
+/** Environment fields a class may not declare, each with the CLI verb that sets it instead. */
+export declare const THE_WORLDS: Readonly<Record<string, string>>;
+/** The error message for a class that declares an environment field. */
+export declare function movedToTheWorld(field: string): string;
+/** Throw on the first environment field the instance declares. */
+export declare function refuseTheEnvironment(probe: object): void;
+//# sourceMappingURL=environment.d.ts.map

package/dist/runtime/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/runtime/environment.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAM/F,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAavD,CAAC;AAEF,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,kEAAkE;AAClE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAIxD"}

package/dist/runtime/environment.js

@@ -0,0 +1,30 @@
+/** Environment fields a class may not declare, each with the CLI verb that sets it instead. */
+import { DeclarationRefused } from "../agent/tools.js";
+// These are per-world settings changed without a deploy. The class is refused at load, and the
+// error names the verb that replaces the field.
+export const THE_WORLDS = {
+    voice: "pinecall agent set --voice <name>",
+    llm: "pinecall agent set --llm <vendor/model>",
+    stt: "pinecall agent set --stt <vendor>",
+    language: "pinecall agent set --language <tag>",
+    greeting: "pinecall agent set --greeting '…' (or --reply '…')",
+    hangup: "pinecall agent set --hangup '…'",
+    says: "pinecall lexicon add <word> --say '…'",
+    hears: "pinecall lexicon hear <word> …",
+    memory: "pinecall memory policy --remember '…' --forget '…'",
+    record: "pinecall agent set --record on|off",
+    knowledge: "pinecall agent knowledge edit — what the agent knows by heart is a setting, not a file",
+    docs: "pinecall docs push, then pinecall docs attach <base>",
+};
+/** The error message for a class that declares an environment field. */
+export function movedToTheWorld(field) {
+    return `\`${field}\` is the world's now, not the class's: ${THE_WORLDS[field]} — remove it from the class`;
+}
+/** Throw on the first environment field the instance declares. */
+export function refuseTheEnvironment(probe) {
+    for (const field of Object.keys(THE_WORLDS)) {
+        if (Object.hasOwn(probe, field))
+            throw new DeclarationRefused(movedToTheWorld(field));
+    }
+}
+//# sourceMappingURL=environment.js.map

package/dist/runtime/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/runtime/environment.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAE/F,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,+FAA+F;AAC/F,gDAAgD;AAChD,MAAM,CAAC,MAAM,UAAU,GAAqC;IAC1D,KAAK,EAAE,mCAAmC;IAC1C,GAAG,EAAE,yCAAyC;IAC9C,GAAG,EAAE,mCAAmC;IACxC,QAAQ,EAAE,qCAAqC;IAC/C,QAAQ,EAAE,oDAAoD;IAC9D,MAAM,EAAE,iCAAiC;IACzC,IAAI,EAAE,uCAAuC;IAC7C,KAAK,EAAE,gCAAgC;IACvC,MAAM,EAAE,oDAAoD;IAC5D,MAAM,EAAE,oCAAoC;IAC5C,SAAS,EAAE,wFAAwF;IACnG,IAAI,EAAE,sDAAsD;CAC7D,CAAC;AAEF,wEAAwE;AACxE,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,KAAK,KAAK,2CAA2C,UAAU,CAAC,KAAK,CAAC,6BAA6B,CAAC;AAC7G,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5C,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC;YAAE,MAAM,IAAI,kBAAkB,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IACxF,CAAC;AACH,CAAC"}

package/dist/runtime/recall.d.ts

@@ -0,0 +1,9 @@
+/** Extracts the recalled memory words that `remembers()` checks against. */
+import { type Camel } from "../wire/codec.js";
+import { type MemoryOps } from "../wire/events.js";
+/**
+ * Each recalled fact's text and category from one `memory.ops` entry. Only `recall` ops count:
+ * a `remember` stores facts from this call rather than surfacing them to it.
+ */
+export declare function wordsRecalled(entry: Camel<MemoryOps>): string[];
+//# sourceMappingURL=recall.d.ts.map

package/dist/runtime/recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../src/runtime/recall.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,MAAM,EAAE,CAI/D"}

package/dist/runtime/recall.js

@@ -0,0 +1,13 @@
+/** Extracts the recalled memory words that `remembers()` checks against. */
+import {} from "../wire/codec.js";
+import {} from "../wire/events.js";
+/**
+ * Each recalled fact's text and category from one `memory.ops` entry. Only `recall` ops count:
+ * a `remember` stores facts from this call rather than surfacing them to it.
+ */
+export function wordsRecalled(entry) {
+    return entry.ops
+        .filter((op) => op.op === "recall")
+        .flatMap((op) => op.facts.flatMap((fact) => [fact.text, fact.category ?? ""]));
+}
+//# sourceMappingURL=recall.js.map

package/dist/runtime/recall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall.js","sourceRoot":"","sources":["../../src/runtime/recall.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,EAAc,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAkB,MAAM,mBAAmB,CAAC;AAEnD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAuB;IACnD,OAAO,KAAK,CAAC,GAAG;SACb,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,QAAQ,CAAC;SAClC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACnF,CAAC"}

package/dist/runtime/run-tool.d.ts

@@ -0,0 +1,18 @@
+/** Runs one tool call: validates args, calls the method, trims the result to its preview. */
+import type { ToolDeclaration } from "../agent/tools.js";
+/** A tool failure with a message for the model. The SDK sends it as `tool.result.error`. */
+export declare class ToolFailed extends Error {
+    constructor(message: string);
+}
+/** Validate args against the tool's schema. Returns complaints; empty means valid. */
+export declare function validate(declaration: ToolDeclaration, args: Record<string, unknown>): string[];
+/** Convert the model's args object into the method's positional arguments. */
+export declare function argumentsFor(declaration: ToolDeclaration, args: Record<string, unknown>): unknown[];
+/** Trim an array result to the tool's `preview` row count; state still keeps the full result. */
+export declare function preview(declaration: ToolDeclaration, result: unknown): unknown;
+/**
+ * Run one tool call against a live agent. The method is called through the instance, not
+ * `declaration.method`, because the decorator's wrapper authors writes with the tool's name.
+ */
+export declare function runTool(agent: object, declaration: ToolDeclaration, args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=run-tool.d.ts.map

package/dist/runtime/run-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tool.d.ts","sourceRoot":"","sources":["../../src/runtime/run-tool.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAE7F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,4FAA4F;AAC5F,qBAAa,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAoCD,sFAAsF;AACtF,wBAAgB,QAAQ,CAAC,WAAW,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAE9F;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAC1B,WAAW,EAAE,eAAe,EAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,EAAE,CAEX;AAED,iGAAiG;AACjG,wBAAgB,OAAO,CAAC,WAAW,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAI9E;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,eAAe,EAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAclB"}

package/dist/runtime/run-tool.js

@@ -0,0 +1,70 @@
+/** Runs one tool call: validates args, calls the method, trims the result to its preview. */
+/** A tool failure with a message for the model. The SDK sends it as `tool.result.error`. */
+export class ToolFailed extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ToolFailed";
+    }
+}
+// Schema property order is the signature's order (parametersOf writes it that way).
+function orderOf(parameters) {
+    return Object.keys(parameters.properties ?? {});
+}
+function typeOf(value) {
+    if (Array.isArray(value))
+        return "array";
+    if (value === null)
+        return "null";
+    return typeof value;
+}
+// Checks only required names and top-level JSON types; nested shapes are the app's to validate.
+function complaintsAbout(parameters, args) {
+    const properties = parameters.properties ?? {};
+    const complaints = [];
+    for (const name of parameters.required ?? []) {
+        if (args[name] === undefined)
+            complaints.push(`${name} is required`);
+    }
+    for (const [name, schema] of Object.entries(properties)) {
+        const value = args[name];
+        const wanted = schema.type;
+        if (value === undefined || wanted === undefined)
+            continue;
+        if (typeOf(value) !== wanted) {
+            complaints.push(`${name} must be a ${wanted}, not a ${typeOf(value)}`);
+        }
+    }
+    return complaints;
+}
+/** Validate args against the tool's schema. Returns complaints; empty means valid. */
+export function validate(declaration, args) {
+    return complaintsAbout(declaration.spec.parameters, args ?? {});
+}
+/** Convert the model's args object into the method's positional arguments. */
+export function argumentsFor(declaration, args) {
+    return orderOf(declaration.spec.parameters).map((name) => args?.[name]);
+}
+/** Trim an array result to the tool's `preview` row count; state still keeps the full result. */
+export function preview(declaration, result) {
+    const rows = declaration.options.preview;
+    if (rows === undefined || !Array.isArray(result) || result.length <= rows)
+        return result;
+    return result.slice(0, rows);
+}
+/**
+ * Run one tool call against a live agent. The method is called through the instance, not
+ * `declaration.method`, because the decorator's wrapper authors writes with the tool's name.
+ */
+export async function runTool(agent, declaration, args) {
+    const complaints = validate(declaration, args);
+    if (complaints.length > 0) {
+        throw new ToolFailed(`${declaration.name}: ${complaints.join("; ")}`);
+    }
+    const method = agent[declaration.name];
+    if (typeof method !== "function") {
+        throw new ToolFailed(`${declaration.name}: this agent has no such method any more`);
+    }
+    const result = await method.apply(agent, argumentsFor(declaration, args));
+    return preview(declaration, result);
+}
+//# sourceMappingURL=run-tool.js.map

package/dist/runtime/run-tool.js.map

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

package/dist/serve/index.d.ts

@@ -0,0 +1,5 @@
+/** `@pinecall/agents/serve`: the entry the CLI starts an agent with — `start` holds it, `prompt` prints it. */
+import { type Io } from "./io.js";
+/** Run one verb; 2 when it cannot run at all, with the sentence on `err`. */
+export declare function main(argv: string[], io?: Io): Promise<number>;
+//# sourceMappingURL=index.d.ts.map

package/dist/serve/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/serve/index.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAO/G,OAAO,EAAa,KAAK,EAAE,EAAE,MAAM,SAAS,CAAC;AAW7C,6EAA6E;AAC7E,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAE,EAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAYhF"}

package/dist/serve/index.js

@@ -0,0 +1,50 @@
+/** `@pinecall/agents/serve`: the entry the CLI starts an agent with — `start` holds it, `prompt` prints it. */
+import { realpathSync } from "node:fs";
+import { pathToFileURL } from "node:url";
+import { DeclarationRefused } from "../agent/tools.js";
+import { processIo } from "./io.js";
+import { CannotServe } from "./load.js";
+import { prompt } from "./prompt.js";
+import { start } from "./start.js";
+const USAGE = `usage: serve start --file <agent.tsx> --slug <slug> [--file … --slug …] [--console] [--events]
+       serve prompt --file <agent.tsx> --slug <slug> [--state field=json]… [--channel name] [--medium how] [--show-machine]
+
+  Reads PINECALL_URL, PINECALL_KEY and PINECALL_ENV from its environment and nothing else.
+  start leaves on SIGINT, SIGTERM or the end of its stdin, draining first; a second signal leaves now.`;
+/** Run one verb; 2 when it cannot run at all, with the sentence on `err`. */
+export async function main(argv, io = processIo()) {
+    const [verb, ...rest] = argv;
+    try {
+        if (verb === "start")
+            return await start(rest, io);
+        if (verb === "prompt")
+            return await prompt(rest, io);
+    }
+    catch (failed) {
+        if (!(failed instanceof CannotServe) && !(failed instanceof DeclarationRefused) && !isAFlag(failed))
+            throw failed;
+        io.err.write(`${failed.message}\n`);
+        return 2;
+    }
+    io.err.write(`${USAGE}\n`);
+    return 2;
+}
+function isAFlag(failed) {
+    const code = failed.code;
+    return failed instanceof Error && typeof code === "string" && code.startsWith("ERR_PARSE_ARGS_");
+}
+// argv[1] may be a symlink (a package's bin), so it is resolved before comparing.
+function isEntry() {
+    const entry = process.argv[1];
+    if (entry === undefined)
+        return false;
+    try {
+        return import.meta.url === pathToFileURL(realpathSync(entry)).href;
+    }
+    catch {
+        return false;
+    }
+}
+if (isEntry())
+    process.exitCode = await main(process.argv.slice(2));
+//# sourceMappingURL=index.js.map

package/dist/serve/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/serve/index.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAE/G,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,SAAS,EAAW,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,KAAK,GAAG;;;;uGAIyF,CAAC;AAExG,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAc,EAAE,EAAE,GAAO,SAAS,EAAE;IAC7D,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7B,IAAI,CAAC;QACH,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACnD,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,MAAM,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,IAAI,CAAC,CAAC,MAAM,YAAY,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,YAAY,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,MAAM,MAAM,CAAC;QAClH,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC;QACpC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC;IAC3B,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,OAAO,CAAC,MAAe;IAC9B,MAAM,IAAI,GAAI,MAAgC,CAAC,IAAI,CAAC;IACpD,OAAO,MAAM,YAAY,KAAK,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;AACnG,CAAC;AAED,kFAAkF;AAClF,SAAS,OAAO;IACd,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,CAAC;QACH,OAAO,OAAO,IAAI,CAAC,GAAG,KAAK,aAAa,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,IAAI,OAAO,EAAE;IAAE,OAAO,CAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/serve/io.d.ts

@@ -0,0 +1,14 @@
+/** What the serve entry reads and writes: two streams out, its environment, its stdin, its signals. */
+/** Everything a verb of the entry touches outside itself, so a test hands in its own. */
+export interface Io {
+    out: NodeJS.WritableStream;
+    err: NodeJS.WritableStream;
+    env: Record<string, string | undefined>;
+    /** Its end is a reason to leave: the process that started this one is gone. */
+    input: NodeJS.ReadableStream;
+    /** Where SIGINT and SIGTERM are heard. */
+    signals: NodeJS.EventEmitter;
+}
+/** The process's own. */
+export declare function processIo(): Io;
+//# sourceMappingURL=io.d.ts.map

package/dist/serve/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/serve/io.ts"],"names":[],"mappings":"AAAA,uGAAuG;AAEvG,yFAAyF;AACzF,MAAM,WAAW,EAAE;IACjB,GAAG,EAAE,MAAM,CAAC,cAAc,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC,cAAc,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACxC,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC,cAAc,CAAC;IAC7B,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC,YAAY,CAAC;CAC9B;AAED,yBAAyB;AACzB,wBAAgB,SAAS,IAAI,EAAE,CAE9B"}

package/dist/serve/io.js

@@ -0,0 +1,6 @@
+/** What the serve entry reads and writes: two streams out, its environment, its stdin, its signals. */
+/** The process's own. */
+export function processIo() {
+    return { out: process.stdout, err: process.stderr, env: process.env, input: process.stdin, signals: process };
+}
+//# sourceMappingURL=io.js.map

package/dist/serve/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../../src/serve/io.ts"],"names":[],"mappings":"AAAA,uGAAuG;AAavG,yBAAyB;AACzB,MAAM,UAAU,SAAS;IACvB,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAChH,CAAC"}

package/dist/serve/leaving.d.ts

@@ -0,0 +1,12 @@
+/** How a served process leaves: asked to (a signal, its stdin's end, a stop), then a drain. */
+import type { Drained, Pinecall } from "../client/index.js";
+import type { Io } from "./io.js";
+/** Why the process is leaving. A stop from the org is not drained: the gateway already let go. */
+export type Asked = "signalled" | "ended" | "stopped";
+/** Resolve with the first reason to leave; a stop is said on `err` in the gateway's words. */
+export declare function askedToLeave(pc: Pinecall, io: Io): Promise<Asked>;
+/** Drain every agent, unless a second signal says to leave now: then nothing. */
+export declare function drainedUnlessSignalledAgain(pc: Pinecall, io: Io): Promise<Drained | undefined>;
+/** Summarize a drain: live calls handed over or kept, tools finished or cut. */
+export declare function drainLine(done: Drained): string;
+//# sourceMappingURL=leaving.d.ts.map

package/dist/serve/leaving.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaving.d.ts","sourceRoot":"","sources":["../../src/serve/leaving.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAE/F,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAElC,kGAAkG;AAClG,MAAM,MAAM,KAAK,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;AAItD,8FAA8F;AAC9F,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAmBjE;AAED,iFAAiF;AACjF,wBAAsB,2BAA2B,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAWpG;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAS/C"}

package/dist/serve/leaving.js

@@ -0,0 +1,61 @@
+/** How a served process leaves: asked to (a signal, its stdin's end, a stop), then a drain. */
+const SIGNALS = ["SIGINT", "SIGTERM"];
+/** Resolve with the first reason to leave; a stop is said on `err` in the gateway's words. */
+export function askedToLeave(pc, io) {
+    return new Promise((done) => {
+        const signalled = () => leave("signalled");
+        const ended = () => leave("ended");
+        const unstop = pc.onStopped((why) => {
+            io.err.write(`${why}\n`);
+            leave("stopped");
+        });
+        for (const signal of SIGNALS)
+            io.signals.on(signal, signalled);
+        io.input.on("end", ended);
+        io.input.resume();
+        function leave(why) {
+            for (const signal of SIGNALS)
+                io.signals.off(signal, signalled);
+            io.input.off("end", ended);
+            io.input.pause();
+            unstop();
+            done(why);
+        }
+    });
+}
+/** Drain every agent, unless a second signal says to leave now: then nothing. */
+export async function drainedUnlessSignalledAgain(pc, io) {
+    let heard;
+    const again = new Promise((done) => {
+        heard = () => done(undefined);
+        for (const signal of SIGNALS)
+            io.signals.on(signal, heard);
+    });
+    try {
+        return await Promise.race([pc.drain(), again]);
+    }
+    finally {
+        for (const signal of SIGNALS)
+            io.signals.off(signal, heard);
+    }
+}
+/** Summarize a drain: live calls handed over or kept, tools finished or cut. */
+export function drainLine(done) {
+    const calls = done.handed + done.parked;
+    if (calls === 0 && done.tools === 0)
+        return "draining · no live calls";
+    const parts = ["draining"];
+    if (done.handed > 0)
+        parts.push(`${plural(done.handed, "live call")} handed over`);
+    if (done.parked > 0)
+        parts.push(`${plural(done.parked, "live call")} kept for the next process`);
+    if (done.finished > 0)
+        parts.push(`${plural(done.finished, "tool")} finished`);
+    if (done.tools > done.finished)
+        parts.push(`${plural(done.tools - done.finished, "tool")} cut`);
+    return parts.join(" · ");
+}
+function plural(count, noun) {
+    return `${count} ${noun}${count === 1 ? "" : "s"}`;
+}
+//# sourceMappingURL=leaving.js.map

package/dist/serve/leaving.js.map

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

package/dist/serve/lines.d.ts

@@ -0,0 +1,7 @@
+/** What a served process prints: the wire entry line by line for the CLI, or a few lines for a person. */
+import type { Entry } from "../wire/envelope.js";
+/** One `--events` line: the entry as the gateway wrote it, without the log's bookkeeping. */
+export declare function eventLine(entry: Entry): string;
+/** A line for a person reading the process, or null for an entry worth no line. */
+export declare function personLine(entry: Entry): string | null;
+//# sourceMappingURL=lines.d.ts.map

package/dist/serve/lines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lines.d.ts","sourceRoot":"","sources":["../../src/serve/lines.ts"],"names":[],"mappings":"AAAA,0GAA0G;AAE1G,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEjD,6FAA6F;AAC7F,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAE9C;AAED,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAiBtD"}

package/dist/serve/lines.js

@@ -0,0 +1,25 @@
+/** What a served process prints: the wire entry line by line for the CLI, or a few lines for a person. */
+/** One `--events` line: the entry as the gateway wrote it, without the log's bookkeeping. */
+export function eventLine(entry) {
+    return JSON.stringify({ type: entry.type, agent: entry.agent, call: entry.call, data: entry.data });
+}
+/** A line for a person reading the process, or null for an entry worth no line. */
+export function personLine(entry) {
+    const data = entry.data;
+    const said = (mark, text) => `${entry.agent}  ${mark} ${String(text)}`;
+    switch (entry.type) {
+        case "agent.registered":
+            return said("·", `answering as ${String(data["app"])}`);
+        case "turn.user":
+            return said("‹", data["text"]);
+        case "turn.agent":
+            return said("›", data["text"]);
+        case "tool.call":
+            return said("→", data["name"]);
+        case "error":
+            return said("✗", data["message"]);
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=lines.js.map

package/dist/serve/lines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lines.js","sourceRoot":"","sources":["../../src/serve/lines.ts"],"names":[],"mappings":"AAAA,0GAA0G;AAI1G,6FAA6F;AAC7F,MAAM,UAAU,SAAS,CAAC,KAAY;IACpC,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AACtG,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,UAAU,CAAC,KAAY;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,IAA+B,CAAC;IACnD,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,IAAa,EAAU,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IAChG,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,kBAAkB;YACrB,OAAO,IAAI,CAAC,GAAG,EAAE,gBAAgB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1D,KAAK,WAAW;YACd,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QACjC,KAAK,YAAY;YACf,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QACjC,KAAK,WAAW;YACd,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QACjC,KAAK,OAAO;YACV,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QACpC;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/serve/load.d.ts

@@ -0,0 +1,26 @@
+/** Load a tenant's agent file: register the TypeScript loader, import the class, read its source. */
+import { type Medium } from "../wire/defs.js";
+import { Agent } from "../agent/agent.js";
+/** Thrown when what was asked cannot be served at all; the entry exits 2 with its sentence. */
+export declare class CannotServe extends Error {
+    readonly name = "CannotServe";
+}
+/** A loaded agent class with its file path and source text. */
+export interface Loaded {
+    ctor: new () => Agent;
+    file: string;
+    source: string;
+}
+/**
+ * Load an agent file and pass its source to `describe`. The source is required: the class
+ * docstring and tool parameter types are not recoverable from the compiled module.
+ */
+export declare function loadAgent(file: string): Promise<Loaded>;
+/** Load the file served as `slug`; a class whose `static slug` says another is refused. */
+export declare function loadServed(file: string, slug: string): Promise<Loaded>;
+/**
+ * Instantiate the class with a stub call, since `render()` may read `this.call`. Without a
+ * medium, the call's is the one its channel implies.
+ */
+export declare function instanceFor(loaded: Loaded, channel?: string, medium?: Medium): Agent;
+//# sourceMappingURL=load.d.ts.map

package/dist/serve/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/serve/load.ts"],"names":[],"mappings":"AAAA,qGAAqG;AAMrG,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAAE,KAAK,EAAW,MAAM,mBAAmB,CAAC;AAKnD,+FAA+F;AAC/F,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAkB,IAAI,iBAAiB;CACxC;AAED,+DAA+D;AAC/D,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,UAAU,KAAK,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAYD;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAY7D;AAED,2FAA2F;AAC3F,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO5E;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,SAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAKnF"}

package/dist/serve/load.js

@@ -0,0 +1,61 @@
+/** Load a tenant's agent file: register the TypeScript loader, import the class, read its source. */
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import {} from "../wire/defs.js";
+import { Agent, setCall } from "../agent/agent.js";
+import { describe } from "../agent/docstrings.js";
+import { CallWorld } from "../call/call.js";
+import { refuseTheEnvironment } from "../runtime/environment.js";
+/** Thrown when what was asked cannot be served at all; the entry exits 2 with its sentence. */
+export class CannotServe extends Error {
+    name = "CannotServe";
+}
+let registered = false;
+/** Register tsx once per process, lazily, so tenant .ts/.tsx files load without a build step. */
+async function useTypeScript() {
+    if (registered)
+        return;
+    const { register } = await import("tsx/esm/api");
+    register();
+    registered = true;
+}
+/**
+ * Load an agent file and pass its source to `describe`. The source is required: the class
+ * docstring and tool parameter types are not recoverable from the compiled module.
+ */
+export async function loadAgent(file) {
+    const path = resolve(file);
+    if (!existsSync(path))
+        throw new CannotServe(`no agent at ${path}`);
+    await useTypeScript();
+    const module_ = (await import(pathToFileURL(path).href));
+    const ctor = module_.default;
+    if (typeof ctor !== "function")
+        throw new CannotServe(`${path} has no default-exported Agent class`);
+    const source = readFileSync(path, "utf8");
+    describe(ctor, source, path);
+    // Refuse environment-owned fields (voice, model, ...) here, since `prompt` never mounts.
+    refuseTheEnvironment(new ctor());
+    return { ctor: ctor, file: path, source };
+}
+/** Load the file served as `slug`; a class whose `static slug` says another is refused. */
+export async function loadServed(file, slug) {
+    const loaded = await loadAgent(file);
+    const declared = loaded.ctor.slug;
+    if (typeof declared === "string" && declared !== slug) {
+        throw new CannotServe(`${loaded.file} says its slug is ${declared}, and it is served as ${slug}: the slug is its folder's name`);
+    }
+    return loaded;
+}
+/**
+ * Instantiate the class with a stub call, since `render()` may read `this.call`. Without a
+ * medium, the call's is the one its channel implies.
+ */
+export function instanceFor(loaded, channel = "web", medium) {
+    const agent = new loaded.ctor();
+    const line = medium === undefined ? { id: "", contact: "", channel } : { id: "", contact: "", channel, medium };
+    setCall(agent, new CallWorld(line, () => undefined));
+    return agent;
+}
+//# sourceMappingURL=load.js.map

package/dist/serve/load.js.map

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

package/dist/serve/machine.d.ts

@@ -0,0 +1,4 @@
+/** Developer view of an agent's tools: current stage, and which tools are visible and why. */
+/** List every declared tool, marking the visible ones and what gates each. For developers only. */
+export declare function showMachine(agent: object): string;
+//# sourceMappingURL=machine.d.ts.map

package/dist/serve/machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine.d.ts","sourceRoot":"","sources":["../../src/serve/machine.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAM9F,mGAAmG;AACnG,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWjD"}

package/dist/serve/machine.js

@@ -0,0 +1,33 @@
+/** Developer view of an agent's tools: current stage, and which tools are visible and why. */
+import { stageOf, stagesOf } from "../agent/stages.js";
+import { toolsOf, visibleToolsOf } from "../agent/tools.js";
+import { headerFor } from "../views/render.js";
+/** List every declared tool, marking the visible ones and what gates each. For developers only. */
+export function showMachine(agent) {
+    const visible = new Set(visibleToolsOf(agent).map((declared) => declared.name));
+    const declarations = toolsOf(agent);
+    if (declarations.length === 0)
+        return `${header(agent)}\n\n  this agent declares no tools`;
+    const width = Math.max(...declarations.map((declared) => declared.name.length));
+    const lines = declarations.map((declared) => {
+        const shown = visible.has(declared.name);
+        const mark = shown ? "●" : "○";
+        return `  ${mark} ${declared.name.padEnd(width)}  ${gatedBy(agent, declared.options, shown)}`;
+    });
+    return [header(agent), "", ...lines].join("\n");
+}
+function header(agent) {
+    const stage = stageOf(agent);
+    return stage === undefined ? headerFor("tools") : `${headerFor("tools")} stage: ${stage}`;
+}
+// Flags a tool hidden in its own stage, since that is always the `when` predicate's doing.
+function gatedBy(agent, options, shown) {
+    const stages = stagesOf(options);
+    if (stages === undefined)
+        return options.when === undefined ? "always" : "when(state)";
+    const here = stageOf(agent);
+    const named = stages.join(" · ");
+    const hiddenInItsOwnStage = !shown && here !== undefined && stages.includes(here);
+    return hiddenInItsOwnStage ? `${named} · when(state) says no` : named;
+}
+//# sourceMappingURL=machine.js.map

package/dist/serve/machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine.js","sourceRoot":"","sources":["../../src/serve/machine.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAE9F,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,cAAc,EAA0B,MAAM,mBAAmB,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,mGAAmG;AACnG,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAChF,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,oCAAoC,CAAC;IAC3F,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAChF,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAC/B,OAAO,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;IAChG,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,MAAM,CAAC,KAAa;IAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,WAAW,KAAK,EAAE,CAAC;AAC5F,CAAC;AAED,2FAA2F;AAC3F,SAAS,OAAO,CAAC,KAAa,EAAE,OAA0B,EAAE,KAAc;IACxE,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC;IACvF,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,mBAAmB,GAAG,CAAC,KAAK,IAAI,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAClF,OAAO,mBAAmB,CAAC,CAAC,CAAC,GAAG,KAAK,wBAAwB,CAAC,CAAC,CAAC,KAAK,CAAC;AACxE,CAAC"}