@botiverse/oar 0.0.1

package/dist/installation.js

@@ -0,0 +1,60 @@
+import path from "node:path";
+import { existsSync } from "node:fs";
+import { resolveExecutable, runExecutable } from "./shared/executable/index.js";
+function candidates(definition) {
+    const explicit = definition.explicit?.trim();
+    if (explicit !== undefined && explicit.length > 0) {
+        const command = path.isAbsolute(explicit) ? explicit : resolveExecutable(explicit);
+        return command !== null && existsSync(command) ? [command] : [];
+    }
+    const found = [];
+    const onPath = resolveExecutable(definition.command);
+    if (onPath !== null) {
+        found.push(onPath);
+    }
+    for (const command of definition.fallbacks ?? []) {
+        if (existsSync(command) && !found.includes(command)) {
+            found.push(command);
+        }
+    }
+    return found;
+}
+function version(stdout) {
+    const value = stdout.trim().split(/\r?\n/u)[0];
+    return value === undefined || value.length === 0 ? undefined : value;
+}
+export function createExecutableInstallation(definition) {
+    return {
+        async probe() {
+            const available = candidates(definition);
+            if (available.length === 0) {
+                return { kind: "not_found" };
+            }
+            for (const command of available) {
+                if (definition.readiness !== undefined) {
+                    const readiness = await runExecutable(command, definition.readiness.args);
+                    if (!readiness.ok && readiness.exitCode === null) {
+                        throw new Error(`Failed to probe the ${definition.label} readiness surface`);
+                    }
+                    if (!readiness.ok) {
+                        continue;
+                    }
+                }
+                const result = await runExecutable(command, ["--version"]);
+                if (!result.ok && result.exitCode === null) {
+                    throw new Error(`Failed to probe the ${definition.label} installation version`);
+                }
+                const value = result.ok ? version(result.stdout) : undefined;
+                return {
+                    kind: "available",
+                    ...(value === undefined ? {} : { version: value }),
+                };
+            }
+            return {
+                kind: "unsupported",
+                reason: definition.readiness?.unsupportedReason ?? "readiness_check_failed",
+            };
+        },
+    };
+}
+//# sourceMappingURL=installation.js.map

package/dist/installation.js.map

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

package/dist/observe/agent-status.d.ts

@@ -0,0 +1,39 @@
+import type { SessionEvent, TurnOutcome } from "../contracts/session.js";
+/**
+ * status = fold(events). The reducer is pure — no clock, no IO — so status is
+ * replayable from any event log and snapshot-testable. Time-qualified
+ * judgments (stalled) are deliberately OUTSIDE the ontology: they are
+ * fold(events) × clock, provided by `stallOf` next to it.
+ *
+ * Transition table (from the minimal v1 event union):
+ *   turn_started      → running/waiting_model
+ *   reasoning         → running/thinking
+ *   text_delta        → running/responding
+ *   tool_call_started → running/{tool, callId}
+ *   tool_call_ended   → running/waiting_model   (the model consumes the result next)
+ *   turn_ended        → idle{lastTurnOutcome}
+ * The fold is total: any mid-turn event while idle adopts that turn (a
+ * consumer may subscribe mid-turn, and claude can start a turn on its own).
+ */
+export type RunningPhase = "waiting_model" | "thinking" | "responding" | {
+    readonly tool: string;
+    readonly callId: string;
+};
+export type AgentStatus = {
+    readonly kind: "idle";
+    readonly lastTurnOutcome?: TurnOutcome;
+} | {
+    readonly kind: "running";
+    readonly turnId: string;
+    readonly phase: RunningPhase;
+    /** Envelope receivedAt (unix epoch ms) of the latest folded event. */
+    readonly lastEventAt: number;
+};
+export declare const initialStatus: AgentStatus;
+export declare function reduceStatus(previous: AgentStatus, event: SessionEvent): AgentStatus;
+/** fold(events) × clock: how long a running status has been silent, if beyond the threshold. */
+export declare function stallOf(status: AgentStatus, nowMs: number, thresholdMs: number): {
+    readonly turnId: string;
+    readonly silentForMs: number;
+} | null;
+//# sourceMappingURL=agent-status.d.ts.map

package/dist/observe/agent-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-status.d.ts","sourceRoot":"","sources":["../../src/observe/agent-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEzE;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,YAAY,GACpB,eAAe,GACf,UAAU,GACV,YAAY,GACZ;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,WAAW,CAAA;CAAE,GACjE;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEN,eAAO,MAAM,aAAa,EAAE,WAA8B,CAAC;AAM3D,wBAAgB,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,GAAG,WAAW,CAiBpF;AAED,gGAAgG;AAChG,wBAAgB,OAAO,CACrB,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAClB;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAMlE"}

package/dist/observe/agent-status.js

@@ -0,0 +1,31 @@
+export const initialStatus = { kind: "idle" };
+function running(event, phase) {
+    return { kind: "running", turnId: event.turnId, phase, lastEventAt: event.receivedAt };
+}
+export function reduceStatus(previous, event) {
+    switch (event.kind) {
+        case "turn_started":
+            return running(event, "waiting_model");
+        case "reasoning":
+            return running(event, "thinking");
+        case "text_delta":
+            return running(event, "responding");
+        case "tool_call_started":
+            return running(event, { tool: event.tool, callId: event.callId });
+        case "tool_call_ended":
+            return running(event, "waiting_model");
+        case "turn_ended":
+            return { kind: "idle", lastTurnOutcome: event.outcome };
+        default:
+            return previous;
+    }
+}
+/** fold(events) × clock: how long a running status has been silent, if beyond the threshold. */
+export function stallOf(status, nowMs, thresholdMs) {
+    if (status.kind !== "running") {
+        return null;
+    }
+    const silentForMs = nowMs - status.lastEventAt;
+    return silentForMs >= thresholdMs ? { turnId: status.turnId, silentForMs } : null;
+}
+//# sourceMappingURL=agent-status.js.map

package/dist/observe/agent-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-status.js","sourceRoot":"","sources":["../../src/observe/agent-status.ts"],"names":[],"mappings":"AAmCA,MAAM,CAAC,MAAM,aAAa,GAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAE3D,SAAS,OAAO,CAAC,KAAmB,EAAE,KAAmB;IACvD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAqB,EAAE,KAAmB;IACrE,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,cAAc;YACjB,OAAO,OAAO,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;QACzC,KAAK,WAAW;YACd,OAAO,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACpC,KAAK,YAAY;YACf,OAAO,OAAO,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QACtC,KAAK,mBAAmB;YACtB,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACpE,KAAK,iBAAiB;YACpB,OAAO,OAAO,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;QACzC,KAAK,YAAY;YACf,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAC1D;YACE,OAAO,QAAQ,CAAC;IACpB,CAAC;AACH,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,OAAO,CACrB,MAAmB,EACnB,KAAa,EACb,WAAmB;IAEnB,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC;IAC/C,OAAO,WAAW,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACpF,CAAC"}

package/dist/observe/aggregate-events.d.ts

@@ -0,0 +1,15 @@
+import type { SessionObserver } from "../contracts/session.js";
+/**
+ * Optional consumer-side aggregation: wrap an observer so consecutive
+ * text/reasoning chunks arrive as one merged event instead of a token stream.
+ * A merged event flushes when the delta kind changes, a non-delta event
+ * arrives, the turn ends, or — when `maxHoldMs` is set — the stream goes
+ * quiet for that long (a stalled model pause must not hold text hostage;
+ * order is safe because only consecutive same-kind deltas are ever held).
+ * It carries the LAST delta's envelope with the concatenated text. Purely a
+ * decorator over the side-tap — adapters and the kernel are unaware.
+ */
+export declare function aggregateDeltas(observer: SessionObserver, options?: {
+    readonly maxHoldMs?: number;
+}): SessionObserver;
+//# sourceMappingURL=aggregate-events.d.ts.map

package/dist/observe/aggregate-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate-events.d.ts","sourceRoot":"","sources":["../../src/observe/aggregate-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAqB7E;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5C,eAAe,CA4CjB"}

package/dist/observe/aggregate-events.js

@@ -0,0 +1,70 @@
+function textOf(event) {
+    if (event.kind === "text_delta") {
+        return event.text;
+    }
+    return event.kind === "reasoning" && event.content.kind === "text"
+        ? event.content.text
+        : null;
+}
+function withText(event, text) {
+    if (event.kind === "reasoning") {
+        return { ...event, content: { kind: "text", text } };
+    }
+    if (event.kind === "text_delta") {
+        return { ...event, text };
+    }
+    return event;
+}
+/**
+ * Optional consumer-side aggregation: wrap an observer so consecutive
+ * text/reasoning chunks arrive as one merged event instead of a token stream.
+ * A merged event flushes when the delta kind changes, a non-delta event
+ * arrives, the turn ends, or — when `maxHoldMs` is set — the stream goes
+ * quiet for that long (a stalled model pause must not hold text hostage;
+ * order is safe because only consecutive same-kind deltas are ever held).
+ * It carries the LAST delta's envelope with the concatenated text. Purely a
+ * decorator over the side-tap — adapters and the kernel are unaware.
+ */
+export function aggregateDeltas(observer, options = {}) {
+    let held = null;
+    let holdTimer = null;
+    const flush = () => {
+        if (holdTimer !== null) {
+            clearTimeout(holdTimer);
+            holdTimer = null;
+        }
+        if (held !== null) {
+            const event = held;
+            held = null;
+            observer(event);
+        }
+    };
+    const armHoldTimer = () => {
+        if (options.maxHoldMs === undefined) {
+            return;
+        }
+        if (holdTimer !== null) {
+            clearTimeout(holdTimer);
+        }
+        holdTimer = setTimeout(flush, options.maxHoldMs);
+    };
+    return (event) => {
+        const text = textOf(event);
+        if (text !== null) {
+            const previousText = held === null ? null : textOf(held);
+            if (held !== null && previousText !== null
+                && held.kind === event.kind && held.turnId === event.turnId) {
+                held = withText(event, `${previousText}${text}`);
+                armHoldTimer();
+                return;
+            }
+            flush();
+            held = event;
+            armHoldTimer();
+            return;
+        }
+        flush();
+        observer(event);
+    };
+}
+//# sourceMappingURL=aggregate-events.js.map

package/dist/observe/aggregate-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate-events.js","sourceRoot":"","sources":["../../src/observe/aggregate-events.ts"],"names":[],"mappings":"AAEA,SAAS,MAAM,CAAC,KAAmB;IACjC,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC,IAAI,CAAC;IACpB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM;QAChE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI;QACpB,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,QAAQ,CAAC,KAAmB,EAAE,IAAY;IACjD,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC/B,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;IACvD,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAChC,OAAO,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAyB,EACzB,UAA2C,EAAE;IAE7C,IAAI,IAAI,GAAwB,IAAI,CAAC;IACrC,IAAI,SAAS,GAA0B,IAAI,CAAC;IAE5C,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,IAAI,CAAC;YACnB,IAAI,GAAG,IAAI,CAAC;YACZ,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,GAAS,EAAE;QAC9B,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACpC,OAAO;QACT,CAAC;QACD,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;QACD,SAAS,GAAG,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC,CAAC;IAEF,OAAO,CAAC,KAAK,EAAE,EAAE;QACf,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,MAAM,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACzD,IAAI,IAAI,KAAK,IAAI,IAAI,YAAY,KAAK,IAAI;mBACrC,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC9D,IAAI,GAAG,QAAQ,CAAC,KAAK,EAAE,GAAG,YAAY,GAAG,IAAI,EAAE,CAAC,CAAC;gBACjD,YAAY,EAAE,CAAC;gBACf,OAAO;YACT,CAAC;YACD,KAAK,EAAE,CAAC;YACR,IAAI,GAAG,KAAK,CAAC;YACb,YAAY,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QACD,KAAK,EAAE,CAAC;QACR,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC"}

package/dist/observe/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Browser-safe observe subpath: the pure derivation utilities over
+ * SessionEvents, with ZERO Node and ZERO adapter imports. A renderer can
+ * value-import `@botiverse/oar/observe` directly without dragging the runtime
+ * adapters (node:child_process, the pi SDK, …) into a browser bundle. The
+ * root `@botiverse/oar` re-exports these too, for Node consumers.
+ */
+export { aggregateDeltas } from "./aggregate-events.js";
+export { initialStatus, reduceStatus, stallOf } from "./agent-status.js";
+export type { AgentStatus, RunningPhase } from "./agent-status.js";
+export { observeStalls } from "./stall-observer.js";
+export type { StallInfo } from "./stall-observer.js";
+export { observeAgent, simpleStateOf } from "./observe-agent.js";
+export type { AgentObserver, AgentView, ObserveAgentOptions } from "./observe-agent.js";
+export { classifyTool, toolActionLabel } from "./tool-activity.js";
+export type { ToolAction, ToolActionKind } from "./tool-activity.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observe/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACzE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACnE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/observe/index.js

@@ -0,0 +1,13 @@
+/**
+ * Browser-safe observe subpath: the pure derivation utilities over
+ * SessionEvents, with ZERO Node and ZERO adapter imports. A renderer can
+ * value-import `@botiverse/oar/observe` directly without dragging the runtime
+ * adapters (node:child_process, the pi SDK, …) into a browser bundle. The
+ * root `@botiverse/oar` re-exports these too, for Node consumers.
+ */
+export { aggregateDeltas } from "./aggregate-events.js";
+export { initialStatus, reduceStatus, stallOf } from "./agent-status.js";
+export { observeStalls } from "./stall-observer.js";
+export { observeAgent, simpleStateOf } from "./observe-agent.js";
+export { classifyTool, toolActionLabel } from "./tool-activity.js";
+//# sourceMappingURL=index.js.map

package/dist/observe/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observe/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/observe/observe-agent.d.ts

@@ -0,0 +1,38 @@
+import type { Session } from "../contracts/session.js";
+import { type AgentStatus } from "./agent-status.js";
+/**
+ * The composed observer: one subscription yields a unified derived view of
+ * the agent — fold state plus the clock overlay. This is the wiring every
+ * host was about to hand-roll (subscribe + fold + a ticker): pushed on every
+ * event (the fold advances) and on the silence edge (the clock crosses the
+ * threshold). The primitives (reduceStatus/stallOf) stay exported for
+ * consumers with their own composition needs.
+ */
+export interface AgentView {
+    readonly status: AgentStatus;
+    readonly stall: {
+        readonly turnId: string;
+        readonly silentForMs: number;
+    } | null;
+}
+export interface ObserveAgentOptions {
+    readonly stallAfterMs: number;
+    /** Clock injection for tests; defaults to Date.now. */
+    readonly now?: () => number;
+    /** Stall-edge poll interval; defaults to 1s. */
+    readonly tickMs?: number;
+}
+export interface AgentObserver {
+    /** Push the current view immediately, then on every change; returns unsubscribe. */
+    subscribe(listener: (view: AgentView) => void): () => void;
+    dispose(): void;
+}
+export declare function observeAgent(session: Session, options: ObserveAgentOptions): AgentObserver;
+/**
+ * The four-word collapse for consumers who want exactly idle/busy/stuck/error.
+ * Precedence: stuck beats busy (a silent turn is a problem before it is
+ * progress); error means "idle after a failed last turn" — a report about
+ * history, never a running state (see the status-bar design notes).
+ */
+export declare function simpleStateOf(view: AgentView): "idle" | "busy" | "stuck" | "error";
+//# sourceMappingURL=observe-agent.d.ts.map

package/dist/observe/observe-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-agent.d.ts","sourceRoot":"","sources":["../../src/observe/observe-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAwC,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE3F;;;;;;;GAOG;AAEH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAClF;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,uDAAuD;IACvD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,gDAAgD;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,oFAAoF;IACpF,SAAS,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC3D,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,GAAG,aAAa,CA6C1F;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAQlF"}

package/dist/observe/observe-agent.js

@@ -0,0 +1,61 @@
+import { initialStatus, reduceStatus, stallOf } from "./agent-status.js";
+export function observeAgent(session, options) {
+    const now = options.now ?? (() => Date.now());
+    const listeners = new Set();
+    let status = initialStatus;
+    let lastStalled = false;
+    const view = () => ({ status, stall: stallOf(status, now(), options.stallAfterMs) });
+    const push = () => {
+        const current = view();
+        lastStalled = current.stall !== null;
+        for (const listener of listeners) {
+            try {
+                listener(current);
+            }
+            catch {
+                // observer isolation: one throwing listener never starves the rest
+            }
+        }
+    };
+    const unsubscribe = session.subscribe((event) => {
+        status = reduceStatus(status, event);
+        push();
+    });
+    const ticker = setInterval(() => {
+        // push only on the silence EDGES, not every tick
+        const stalledNow = stallOf(status, now(), options.stallAfterMs) !== null;
+        if (stalledNow !== lastStalled) {
+            push();
+        }
+    }, options.tickMs ?? 1000);
+    return {
+        subscribe(listener) {
+            listeners.add(listener);
+            listener(view());
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        dispose() {
+            clearInterval(ticker);
+            unsubscribe();
+            listeners.clear();
+        },
+    };
+}
+/**
+ * The four-word collapse for consumers who want exactly idle/busy/stuck/error.
+ * Precedence: stuck beats busy (a silent turn is a problem before it is
+ * progress); error means "idle after a failed last turn" — a report about
+ * history, never a running state (see the status-bar design notes).
+ */
+export function simpleStateOf(view) {
+    if (view.stall !== null) {
+        return "stuck";
+    }
+    if (view.status.kind === "running") {
+        return "busy";
+    }
+    return view.status.lastTurnOutcome?.kind === "failed" ? "error" : "idle";
+}
+//# sourceMappingURL=observe-agent.js.map

package/dist/observe/observe-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-agent.js","sourceRoot":"","sources":["../../src/observe/observe-agent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,OAAO,EAAoB,MAAM,mBAAmB,CAAC;AA8B3F,MAAM,UAAU,YAAY,CAAC,OAAgB,EAAE,OAA4B;IACzE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAW,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,IAAI,GAAG,EAA6B,CAAC;IACvD,IAAI,MAAM,GAAgB,aAAa,CAAC;IACxC,IAAI,WAAW,GAAG,KAAK,CAAC;IAExB,MAAM,IAAI,GAAG,GAAc,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IAChG,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,MAAM,OAAO,GAAG,IAAI,EAAE,CAAC;QACvB,WAAW,GAAG,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC;QACrC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,QAAQ,CAAC,OAAO,CAAC,CAAC;YACpB,CAAC;YAAC,MAAM,CAAC;gBACP,mEAAmE;YACrE,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;QAC9C,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACrC,IAAI,EAAE,CAAC;IACT,CAAC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE;QAC9B,iDAAiD;QACjD,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;QACzE,IAAI,UAAU,KAAK,WAAW,EAAE,CAAC;YAC/B,IAAI,EAAE,CAAC;QACT,CAAC;IACH,CAAC,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC;IAE3B,OAAO;QACL,SAAS,CAAC,QAAQ;YAChB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;YACjB,OAAO,GAAG,EAAE;gBACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC7B,CAAC,CAAC;QACJ,CAAC;QACD,OAAO;YACL,aAAa,CAAC,MAAM,CAAC,CAAC;YACtB,WAAW,EAAE,CAAC;YACd,SAAS,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAe;IAC3C,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AAC3E,CAAC"}

package/dist/observe/stall-observer.d.ts

@@ -0,0 +1,19 @@
+import type { Session, Unsubscribe } from "../contracts/session.js";
+/**
+ * Convenience layer over the public status reducer: fold the session's events
+ * with reduceStatus, ask stallOf with the wall clock, and report when an
+ * active turn has been silent for `stallAfterMs`. There is deliberately no
+ * second state machine here — the reducer is the single source of truth.
+ * Fires once per silence episode; the next event re-arms it. The embedder
+ * decides what a stall means (surface, notify, or abort via its turn handle).
+ */
+export interface StallInfo {
+    readonly turnId: string;
+    readonly silentForMs: number;
+    readonly lastEventKind: string;
+}
+export declare function observeStalls(session: Session, options: {
+    readonly stallAfterMs: number;
+    readonly onStall: (info: StallInfo) => void;
+}): Unsubscribe;
+//# sourceMappingURL=stall-observer.d.ts.map

package/dist/observe/stall-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stall-observer.d.ts","sourceRoot":"","sources":["../../src/observe/stall-observer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGpE;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAA;CAAE,GACtF,WAAW,CAmCb"}

package/dist/observe/stall-observer.js

@@ -0,0 +1,36 @@
+import { initialStatus, reduceStatus, stallOf } from "./agent-status.js";
+export function observeStalls(session, options) {
+    let status = initialStatus;
+    let lastEventKind = "";
+    let timer = null;
+    const disarm = () => {
+        if (timer !== null) {
+            clearTimeout(timer);
+            timer = null;
+        }
+    };
+    const arm = () => {
+        disarm();
+        timer = setTimeout(() => {
+            const stall = stallOf(status, Date.now(), options.stallAfterMs);
+            if (stall !== null) {
+                options.onStall({ ...stall, lastEventKind });
+            }
+        }, options.stallAfterMs);
+    };
+    const unsubscribe = session.subscribe((event) => {
+        status = reduceStatus(status, event);
+        lastEventKind = event.kind;
+        if (status.kind === "running") {
+            arm();
+        }
+        else {
+            disarm();
+        }
+    });
+    return () => {
+        disarm();
+        unsubscribe();
+    };
+}
+//# sourceMappingURL=stall-observer.js.map

package/dist/observe/stall-observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stall-observer.js","sourceRoot":"","sources":["../../src/observe/stall-observer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,OAAO,EAAoB,MAAM,mBAAmB,CAAC;AAgB3F,MAAM,UAAU,aAAa,CAC3B,OAAgB,EAChB,OAAuF;IAEvF,IAAI,MAAM,GAAgB,aAAa,CAAC;IACxC,IAAI,aAAa,GAAG,EAAE,CAAC;IACvB,IAAI,KAAK,GAA0B,IAAI,CAAC;IAExC,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IACF,MAAM,GAAG,GAAG,GAAS,EAAE;QACrB,MAAM,EAAE,CAAC;QACT,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;YAChE,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3B,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;QAC9C,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACrC,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC;QAC3B,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9B,GAAG,EAAE,CAAC;QACR,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,EAAE;QACV,MAAM,EAAE,CAAC;QACT,WAAW,EAAE,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

package/dist/observe/tool-activity.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Cross-runtime tool classification — the friendly-Activity utility. Each
+ * runtime names the same action differently (claude "Bash", codex
+ * "commandExecution", pi "bash"); only OAR knows the mapping, so it lives
+ * here. Pure: raw tool_call events stay the source of truth; a friendly view
+ * derives labels via this (same pattern as reduceStatus / aggregateDeltas).
+ *
+ * The tool set is OPEN (custom + MCP tools have arbitrary names), so unknown
+ * tools fall back to "other" rather than being force-fit.
+ */
+export type ToolActionKind = "run_command" | "read_file" | "edit_file" | "search" | "web" | "mcp" | "other";
+export interface ToolAction {
+    readonly kind: ToolActionKind;
+    /** A short target extracted from the tool input: the command text, a file path, a query. */
+    readonly detail?: string;
+}
+/** Classify one tool call into a cross-runtime semantic action plus an extracted detail. */
+export declare function classifyTool(runtimeId: string, tool: string, inputJson?: string): ToolAction;
+/** The human label for an action in a given lifecycle state — tense centralized here so views stay consistent. */
+export declare function toolActionLabel(kind: ToolActionKind, state: "running" | "done" | "failed"): string;
+//# sourceMappingURL=tool-activity.d.ts.map

package/dist/observe/tool-activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-activity.d.ts","sourceRoot":"","sources":["../../src/observe/tool-activity.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,WAAW,GACX,WAAW,GACX,QAAQ,GACR,KAAK,GACL,KAAK,GACL,OAAO,CAAC;AAEZ,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,4FAA4F;IAC5F,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAwED,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,CAI5F;AAYD,kHAAkH;AAClH,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAElG"}

package/dist/observe/tool-activity.js

@@ -0,0 +1,87 @@
+import { asRecord, parseJson } from "../shared/json.js";
+// Per-runtime tool name → kind. Names are what the tool_call_started event
+// carries (codex uses its item type; claude/pi use the tool name).
+const BY_RUNTIME = {
+    claude: {
+        Bash: "run_command",
+        Read: "read_file",
+        Edit: "edit_file",
+        Write: "edit_file",
+        NotebookEdit: "edit_file",
+        Grep: "search",
+        Glob: "search",
+        WebFetch: "web",
+        WebSearch: "web",
+    },
+    codex: {
+        commandExecution: "run_command",
+        fileChange: "edit_file",
+        webSearch: "web",
+        mcpToolCall: "mcp",
+    },
+    pi: {
+        bash: "run_command",
+        read: "read_file",
+        ls: "read_file",
+        edit: "edit_file",
+        write: "edit_file",
+        grep: "search",
+        find: "search",
+    },
+};
+function kindOf(runtimeId, tool) {
+    const runtime = runtimeId.replace(/-aimock$/u, "");
+    const direct = BY_RUNTIME[runtime]?.[tool];
+    if (direct !== undefined) {
+        return direct;
+    }
+    // MCP tools are conventionally prefixed on claude (mcp__server__tool).
+    if (tool.startsWith("mcp__")) {
+        return "mcp";
+    }
+    return "other";
+}
+const FIRST_STRING_KEYS = ["command", "cmd", "path", "file_path", "filePath", "file", "pattern", "query", "url"];
+function detailOf(inputJson) {
+    if (inputJson === undefined) {
+        return undefined;
+    }
+    const input = asRecord(parseJson(inputJson));
+    if (input === null) {
+        return undefined;
+    }
+    for (const key of FIRST_STRING_KEYS) {
+        const value = input[key];
+        if (typeof value === "string" && value.length > 0) {
+            return value;
+        }
+        // codex nests the shell command as ["bash","-lc", "<cmd>"] sometimes.
+        if (Array.isArray(value)) {
+            const last = value.at(-1);
+            if (typeof last === "string" && last.length > 0) {
+                return last;
+            }
+        }
+    }
+    return undefined;
+}
+/** Classify one tool call into a cross-runtime semantic action plus an extracted detail. */
+export function classifyTool(runtimeId, tool, inputJson) {
+    const kind = kindOf(runtimeId, tool);
+    const detail = detailOf(inputJson) ?? (kind === "other" ? tool : undefined);
+    return detail === undefined ? { kind } : { kind, detail };
+}
+const LABELS = {
+    run_command: { running: "Running command", done: "Ran command", failed: "Command failed" },
+    read_file: { running: "Reading file", done: "Read file", failed: "Read failed" },
+    edit_file: { running: "Editing file", done: "Edited file", failed: "Edit failed" },
+    search: { running: "Searching", done: "Searched", failed: "Search failed" },
+    web: { running: "Searching the web", done: "Searched the web", failed: "Web request failed" },
+    mcp: { running: "Using a tool", done: "Used a tool", failed: "Tool failed" },
+    other: { running: "Working", done: "Done", failed: "Failed" },
+};
+/** The human label for an action in a given lifecycle state — tense centralized here so views stay consistent. */
+export function toolActionLabel(kind, state) {
+    return LABELS[kind][state];
+}
+//# sourceMappingURL=tool-activity.js.map

package/dist/observe/tool-activity.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,10 @@
+import type { Runtime } from "./contracts/runtime.js";
+export declare class RuntimeRegistry {
+    #private;
+    constructor(runtimes: Iterable<Runtime>);
+    get(id: string): Runtime | undefined;
+    require(id: string): Runtime;
+    list(): readonly Runtime[];
+}
+export declare function createRuntimeRegistry(runtimes: Iterable<Runtime>): RuntimeRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,qBAAa,eAAe;;gBAGd,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC;IAWvC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIpC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAQ5B,IAAI,IAAI,SAAS,OAAO,EAAE;CAG3B;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,eAAe,CAElF"}

package/dist/registry.js

@@ -0,0 +1,30 @@
+export class RuntimeRegistry {
+    #runtimes;
+    constructor(runtimes) {
+        const indexed = new Map();
+        for (const runtime of runtimes) {
+            if (indexed.has(runtime.id)) {
+                throw new Error(`duplicate runtime id: ${runtime.id}`);
+            }
+            indexed.set(runtime.id, runtime);
+        }
+        this.#runtimes = indexed;
+    }
+    get(id) {
+        return this.#runtimes.get(id);
+    }
+    require(id) {
+        const runtime = this.get(id);
+        if (runtime === undefined) {
+            throw new Error(`unknown runtime: ${id}`);
+        }
+        return runtime;
+    }
+    list() {
+        return [...this.#runtimes.values()];
+    }
+}
+export function createRuntimeRegistry(runtimes) {
+    return new RuntimeRegistry(runtimes);
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,eAAe;IACjB,SAAS,CAA+B;IAEjD,YAAY,QAA2B;QACrC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;QAC3C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IACtC,CAAC;CACF;AAED,MAAM,UAAU,qBAAqB,CAAC,QAA2B;IAC/D,OAAO,IAAI,eAAe,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC"}