@openagt/dashboard 0.0.0-stage → 0.8.0

package/dist/agent-names.js

@@ -0,0 +1,33 @@
+/**
+ * The agent vocabulary (#542), node-free so every surface shares one copy: the CLI's
+ * `--agent` flag, the registry's preference sanitizer, and the dashboard bundle — which must
+ * not import the driver layer (it spawns processes), and whose "kept local" copies existed
+ * only because this list used to live beside those imports. Adding an agent is one entry
+ * here plus its driver; the dashboard's per-agent UI table is keyed by {@link AgentName}, so
+ * a missing entry there is a compile error, not a silent gap.
+ */
+/** The agents the framework can drive, in the order surfaces list them. */
+export const AGENTS = ['claude', 'codex'];
+/** Whether `value` names an agent we can drive. */
+export function isAgentName(value) {
+    return value !== undefined && AGENTS.includes(value);
+}
+/** How each agent reads in a sentence or on a button. */
+export const AGENT_LABELS = {
+    claude: 'Claude Code',
+    codex: 'Codex',
+};
+/**
+ * The agent behind a driver name (#831): a run records the driver that ran it
+ * (`claude-code`), while `--agent` takes the agent name (`claude`). `undefined` for a driver
+ * no agent claims (the fake driver, or a record from a newer version). An agent whose driver
+ * name differs from its own needs a case here, like claude's does.
+ */
+export function agentForDriver(driver) {
+    // Every surface Claude runs on is still Claude (#1263): the local CLI, the cloud session, and
+    // the Actions runner. Where it runs is the run's `target`, not its agent.
+    if (driver === 'claude-code' || driver === 'claude-web' || driver === 'github-actions')
+        return 'claude';
+    return isAgentName(driver) ? driver : undefined;
+}
+//# sourceMappingURL=agent-names.js.map

package/dist/agent-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-names.js","sourceRoot":"","sources":["../src/agent-names.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,2EAA2E;AAC3E,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAU,CAAA;AAKlD,mDAAmD;AACnD,MAAM,UAAU,WAAW,CAAC,KAAyB;IACnD,OAAO,KAAK,KAAK,SAAS,IAAK,MAA4B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AAC7E,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,MAAM,YAAY,GAA8B;IACrD,MAAM,EAAE,aAAa;IACrB,KAAK,EAAE,OAAO;CACf,CAAA;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAA0B;IACvD,8FAA8F;IAC9F,0EAA0E;IAC1E,IAAI,MAAM,KAAK,aAAa,IAAI,MAAM,KAAK,YAAY,IAAI,MAAM,KAAK,gBAAgB;QAAE,OAAO,QAAQ,CAAA;IACvG,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;AACjD,CAAC"}

package/dist/agent-options.d.ts

@@ -0,0 +1,45 @@
+import { type HandoffLevel } from './handoff-level.js';
+import type { Preferences } from './registry.js';
+import type { StartAgentOptions } from './dashboard/types.js';
+import type { FrameworkFileConfig } from './config.js';
+/**
+ * Turning the user's preferences into the options an agent starts with (#858).
+ *
+ * This lived in the dashboard client, which was fine while the browser was the only thing that
+ * started runs. The daemon starts them too (#685), and passed nothing at all — so an unattended agent
+ * ignored the driver, the model and every other per-project setting (#840) that an agent started from
+ * the launcher would have honoured.
+ *
+ * It lives here, in pure code with no Node imports, so both callers share one mapping rather than
+ * keeping two copies of rules that are not a plain field copy: autopilot defaults on, browser is
+ * Claude-only, the eco drops are suppressed under vanilla/transparent, and the four eco
+ * preferences collapse into one object. Re-exported from the browser-safe `./client` entry (#431)
+ * so the dashboard can go on importing it at runtime.
+ */
+/**
+ * A repo's committed `the-framework.yml` as the preference keys it speaks for (#842), so the
+ * launcher and the daemon can layer it under the user's own options the same way. Only the keys
+ * the file set come back, since an unset key must leave the tier below it alone.
+ *
+ * `preset` and `event` have no preference counterpart (there is no preset picker) and stay on the
+ * raw file config for display.
+ */
+export declare function preferencesFromFileConfig(file: FrameworkFileConfig): Preferences;
+/**
+ * How far a set of preferences publishes a finished session (#1102/B5). Defaults to `pr`, which is
+ * what makes it zero-config: a session left alone pushes its branch and opens a draft PR.
+ *
+ * A ladder, not three switches (#1379): the rungs are nested, so "PR without push" was never a
+ * state a session could honour — `gh` will not open a PR for a branch the remote has never seen.
+ * As an ordinal that combination is not representable at all, rather than repaired by turning the
+ * push back on, which is what made a launcher offering "publish nothing" unable to deliver it.
+ */
+export declare function handoffFromPreferences(preferences: Preferences): HandoffLevel;
+/**
+ * The agent options a set of already-resolved preferences implies.
+ *
+ * Takes the merged view, not the two tiers: who wins between the global and the project setting is
+ * `resolvePreferences`' job, and this stays a pure mapping of one settled answer.
+ */
+export declare function agentOptionsFromPreferences(preferences: Preferences, context?: string[]): StartAgentOptions;
+//# sourceMappingURL=agent-options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-options.d.ts","sourceRoot":"","sources":["../src/agent-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEtD;;;;;;;;;;;;;GAaG;AAEH;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,mBAAmB,GAAG,WAAW,CAShF;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,WAAW,GAAG,YAAY,CAE7E;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,GAAE,MAAM,EAAO,GAAG,iBAAiB,CA8B/G"}

package/dist/agent-options.js

@@ -0,0 +1,83 @@
+import { DEFAULT_HANDOFF } from './handoff-level.js';
+/**
+ * Turning the user's preferences into the options an agent starts with (#858).
+ *
+ * This lived in the dashboard client, which was fine while the browser was the only thing that
+ * started runs. The daemon starts them too (#685), and passed nothing at all — so an unattended agent
+ * ignored the driver, the model and every other per-project setting (#840) that an agent started from
+ * the launcher would have honoured.
+ *
+ * It lives here, in pure code with no Node imports, so both callers share one mapping rather than
+ * keeping two copies of rules that are not a plain field copy: autopilot defaults on, browser is
+ * Claude-only, the eco drops are suppressed under vanilla/transparent, and the four eco
+ * preferences collapse into one object. Re-exported from the browser-safe `./client` entry (#431)
+ * so the dashboard can go on importing it at runtime.
+ */
+/**
+ * A repo's committed `the-framework.yml` as the preference keys it speaks for (#842), so the
+ * launcher and the daemon can layer it under the user's own options the same way. Only the keys
+ * the file set come back, since an unset key must leave the tier below it alone.
+ *
+ * `preset` and `event` have no preference counterpart (there is no preset picker) and stay on the
+ * raw file config for display.
+ */
+export function preferencesFromFileConfig(file) {
+    return {
+        ...(file.transparent !== undefined ? { transparent: file.transparent } : {}),
+        ...(file.vanilla !== undefined ? { vanilla: file.vanilla } : {}),
+        // The handoff pair (#1102/#1173): whether a session publishes itself is a fact about the repo,
+        // so the committed file may say it — and it is where push-without-PR stays reachable now the
+        // launcher offers a single `Open PR` row.
+        ...(file.handoff !== undefined ? { handoff: file.handoff } : {}),
+    };
+}
+/**
+ * How far a set of preferences publishes a finished session (#1102/B5). Defaults to `pr`, which is
+ * what makes it zero-config: a session left alone pushes its branch and opens a draft PR.
+ *
+ * A ladder, not three switches (#1379): the rungs are nested, so "PR without push" was never a
+ * state a session could honour — `gh` will not open a PR for a branch the remote has never seen.
+ * As an ordinal that combination is not representable at all, rather than repaired by turning the
+ * push back on, which is what made a launcher offering "publish nothing" unable to deliver it.
+ */
+export function handoffFromPreferences(preferences) {
+    return preferences.handoff ?? DEFAULT_HANDOFF;
+}
+/**
+ * The agent options a set of already-resolved preferences implies.
+ *
+ * Takes the merged view, not the two tiers: who wins between the global and the project setting is
+ * `resolvePreferences`' job, and this stays a pure mapping of one settled answer.
+ */
+export function agentOptionsFromPreferences(preferences, context = []) {
+    const vanilla = preferences.vanilla ?? false;
+    const transparent = preferences.transparent ?? false;
+    const onBeforeMergeableQuality = preferences.onBeforeMergeableQuality ?? false;
+    const browser = preferences.browser ?? false;
+    const handoff = handoffFromPreferences(preferences);
+    const model = preferences.model ?? '';
+    const driver = preferences.driver ?? 'claude';
+    const target = preferences.target ?? 'local';
+    return {
+        // The two toggles `the-framework.yml` also owns go out explicitly, `false` included (#842):
+        // the caller has already resolved every layer it can see, so the agent states the settled answer
+        // and the CLI's own resolve (#841) takes it as the nearest layer. Sending nothing would let the
+        // repo file turn back on what the launcher just showed as off.
+        vanilla,
+        transparent,
+        ...(onBeforeMergeableQuality ? { onBeforeMergeable: true } : {}),
+        // Stated explicitly, every rung included: it defaults to `pr` (#1102), so sending nothing
+        // would let the session's own default publish more than the launcher just showed.
+        handoff,
+        // Claude-only (#801): another driver takes no MCP servers, so sending it would only earn
+        // the CLI's "no effect" notice. Matches the box being disabled off Claude Code.
+        ...(browser && driver === 'claude' ? { browser: true } : {}),
+        ...(model ? { model } : {}),
+        ...(driver !== 'claude' ? { driver } : {}),
+        // Run target (#1050/#610): only a non-local target travels; `local` is the default the CLI
+        // already assumes, so a local agent's options stay byte-identical to before either target existed.
+        ...(target && target !== 'local' ? { target } : {}),
+        ...(context.length ? { context } : {}),
+    };
+}
+//# sourceMappingURL=agent-options.js.map

package/dist/agent-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-options.js","sourceRoot":"","sources":["../src/agent-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAqB,MAAM,oBAAoB,CAAA;AAKvE;;;;;;;;;;;;;GAaG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAyB;IACjE,OAAO;QACL,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,+FAA+F;QAC/F,6FAA6F;QAC7F,0CAA0C;QAC1C,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjE,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAAwB;IAC7D,OAAO,WAAW,CAAC,OAAO,IAAI,eAAe,CAAA;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,WAAwB,EAAE,OAAO,GAAa,EAAE;IAC1F,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,IAAI,KAAK,CAAA;IAC5C,MAAM,WAAW,GAAG,WAAW,CAAC,WAAW,IAAI,KAAK,CAAA;IACpD,MAAM,wBAAwB,GAAG,WAAW,CAAC,wBAAwB,IAAI,KAAK,CAAA;IAC9E,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,IAAI,KAAK,CAAA;IAC5C,MAAM,OAAO,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAA;IACnD,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE,CAAA;IACrC,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,IAAI,QAAQ,CAAA;IAC7C,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,IAAI,OAAO,CAAA;IAC5C,OAAO;QACL,4FAA4F;QAC5F,iGAAiG;QACjG,gGAAgG;QAChG,+DAA+D;QAC/D,OAAO;QACP,WAAW;QACX,GAAG,CAAC,wBAAwB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,0FAA0F;QAC1F,kFAAkF;QAClF,OAAO;QACP,yFAAyF;QACzF,gFAAgF;QAChF,GAAG,CAAC,OAAO,IAAI,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3B,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1C,2FAA2F;QAC3F,mGAAmG;QACnG,GAAG,CAAC,MAAM,IAAI,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvC,CAAA;AACH,CAAC"}

package/dist/agent-spec.d.ts

@@ -0,0 +1,56 @@
+import type { StartAgentKind, StartAgentOptions } from './dashboard/index.js';
+/**
+ * The dashboard's process API to a session it spawns (D4).
+ *
+ * This used to be twenty-seven command-line flags. `StartAgentOptions` was serialized onto an argv
+ * — every field carrying a "maps to `--x`" comment — which made the dashboard's IPC format and the
+ * CLI's human surface the same thing. That is what forced the flags to be mutually validated,
+ * documented in a 140-line help text, and tri-stated: `--auto-open-pr` / `--no-auto-open-pr` both
+ * had to exist because argv has no way to say `false`, only "present" and "absent".
+ *
+ * JSON has a real `false`, so none of that is needed. The dashboard writes this blob to a temp
+ * file and spawns `framework --agent <path>`; the child reads it, deletes it, and runs. The
+ * flags are gone, the `--no-*` pairs with them, and the CLI is left with the four options a human
+ * actually types.
+ */
+export interface AgentSpec {
+    /** What the session is asked to do. Empty is allowed for `research`, which has its own default. */
+    prompt: string;
+    /** Build from an intent, run one prompt verbatim, or run the Research preset. */
+    kind: StartAgentKind;
+    /** The checkout the session runs in: a worktree, or the project itself. */
+    cwd: string;
+    /** The id its worktree is named with, so the directory and the agent recorded inside it are one string. */
+    agentId?: string;
+    /** Reopen `agentId`'s log instead of truncating it: the follow-up IS that agent (#762). */
+    continueAgent?: boolean;
+    /** Everything the launcher's options gear and Settings decide about the session. */
+    options: StartAgentOptions;
+}
+/**
+ * Write a spec and return its path, for `framework --agent <path>`.
+ *
+ * A file rather than a pipe or an fd: the child is spawned detached with its stdio closed, so
+ * there is no channel to inherit, and a path survives the spawn without either side blocking on
+ * the other. The child removes it once read, so a spec never outlives the session it started.
+ */
+export declare function writeAgentSpec(spec: AgentSpec, env?: NodeJS.ProcessEnv): Promise<string>;
+/**
+ * Remove a spec — and the directory {@link writeAgentSpec} made for it, or removing one spec per
+ * session would leave one empty directory per session behind forever. Only a directory this
+ * module verifiably made goes whole: it must carry the mkdtemp prefix AND sit directly in the
+ * configured spec home. `--agent <path>` accepts any path, and neither a hand-written spec nor a
+ * user's own directory that happens to be named like ours may be taken with the file.
+ *
+ * Also the cleanup for a spawn whose child never consumed the spec — the spawn failed outright,
+ * or the child died before reading it — which otherwise left the whole prompt sitting on disk.
+ * Idempotent: removing a spec an exiting child already consumed is a no-op.
+ */
+export declare function removeAgentSpec(path: string, env?: NodeJS.ProcessEnv): Promise<void>;
+/**
+ * Read a spec, and remove it. Consumed rather than merely read: it is a one-shot handoff, and a
+ * session's options can name a device token (`options.remote`), which has no business staying on
+ * disk after the session that used it has started.
+ */
+export declare function readAgentSpec(path: string, env?: NodeJS.ProcessEnv): Promise<AgentSpec>;
+//# sourceMappingURL=agent-spec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-spec.d.ts","sourceRoot":"","sources":["../src/agent-spec.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAE7E;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,SAAS;IACxB,mGAAmG;IACnG,MAAM,EAAE,MAAM,CAAA;IACd,iFAAiF;IACjF,IAAI,EAAE,cAAc,CAAA;IACpB,2EAA2E;IAC3E,GAAG,EAAE,MAAM,CAAA;IACX,2GAA2G;IAC3G,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2FAA2F;IAC3F,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,oFAAoF;IACpF,OAAO,EAAE,iBAAiB,CAAA;CAC3B;AAQD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAK3G;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQvG;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,SAAS,CAAC,CAQ1G"}

package/dist/agent-spec.js

@@ -0,0 +1,56 @@
+import { mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { basename, dirname, join, resolve } from 'node:path';
+/** The env var naming the directory session specs are written to. Set by tests; defaults to the OS temp dir. */
+const SPEC_DIR_ENV = 'FRAMEWORK_SESSION_SPEC_DIR';
+/** The per-spec mkdtemp directory's prefix, which marks the directory as this module's to remove. */
+const SPEC_DIR_PREFIX = 'framework-session-';
+/**
+ * Write a spec and return its path, for `framework --agent <path>`.
+ *
+ * A file rather than a pipe or an fd: the child is spawned detached with its stdio closed, so
+ * there is no channel to inherit, and a path survives the spawn without either side blocking on
+ * the other. The child removes it once read, so a spec never outlives the session it started.
+ */
+export async function writeAgentSpec(spec, env = process.env) {
+    const dir = await mkdtemp(join(env[SPEC_DIR_ENV] ?? tmpdir(), SPEC_DIR_PREFIX));
+    const path = join(dir, 'session.json');
+    await writeFile(path, JSON.stringify(spec, null, 2) + '\n');
+    return path;
+}
+/**
+ * Remove a spec — and the directory {@link writeAgentSpec} made for it, or removing one spec per
+ * session would leave one empty directory per session behind forever. Only a directory this
+ * module verifiably made goes whole: it must carry the mkdtemp prefix AND sit directly in the
+ * configured spec home. `--agent <path>` accepts any path, and neither a hand-written spec nor a
+ * user's own directory that happens to be named like ours may be taken with the file.
+ *
+ * Also the cleanup for a spawn whose child never consumed the spec — the spawn failed outright,
+ * or the child died before reading it — which otherwise left the whole prompt sitting on disk.
+ * Idempotent: removing a spec an exiting child already consumed is a no-op.
+ */
+export async function removeAgentSpec(path, env = process.env) {
+    const dir = dirname(path);
+    const home = resolve(env[SPEC_DIR_ENV] ?? tmpdir());
+    if (basename(dir).startsWith(SPEC_DIR_PREFIX) && resolve(dirname(dir)) === home) {
+        await rm(dir, { recursive: true, force: true }).catch(() => { });
+    }
+    else {
+        await rm(path, { force: true }).catch(() => { });
+    }
+}
+/**
+ * Read a spec, and remove it. Consumed rather than merely read: it is a one-shot handoff, and a
+ * session's options can name a device token (`options.remote`), which has no business staying on
+ * disk after the session that used it has started.
+ */
+export async function readAgentSpec(path, env = process.env) {
+    const raw = await readFile(path, 'utf8');
+    await removeAgentSpec(path, env);
+    const spec = JSON.parse(raw);
+    if (typeof spec.prompt !== 'string' || typeof spec.cwd !== 'string' || !spec.kind) {
+        throw new Error(`${path} is not a session spec`);
+    }
+    return { ...spec, options: spec.options ?? {} };
+}
+//# sourceMappingURL=agent-spec.js.map

package/dist/agent-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-spec.js","sourceRoot":"","sources":["../src/agent-spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAgC5D,gHAAgH;AAChH,MAAM,YAAY,GAAG,4BAA4B,CAAA;AAEjD,qGAAqG;AACrG,MAAM,eAAe,GAAG,oBAAoB,CAAA;AAE5C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAe,EAAE,GAAG,GAAsB,OAAO,CAAC,GAAG;IACxF,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,CAAA;IAC/E,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAA;IACtC,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IAC3D,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,GAAG,GAAsB,OAAO,CAAC,GAAG;IACtF,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,MAAM,EAAE,CAAC,CAAA;IACnD,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAChF,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IACjE,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IACjD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,GAAG,GAAsB,OAAO,CAAC,GAAG;IACpF,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACxC,MAAM,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAuB,CAAA;IAClD,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAClF,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,wBAAwB,CAAC,CAAA;IAClD,CAAC;IACD,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE,EAAe,CAAA;AAC9D,CAAC"}

package/dist/agent-telemetry.d.ts

@@ -0,0 +1,88 @@
+import type { Driver, DriverEvent } from 'agent-driver';
+import { type FrameworkEvent } from './events.js';
+/** Inputs to {@link emitSessionStart}. */
+export interface SessionStartOptions {
+    emit: (event: FrameworkEvent) => void;
+    driver: Driver;
+    /** The workspace the agent works in. */
+    cwd: string;
+    /** The session link, literal or templated with `{sessionId}`. */
+    sessionLink?: string | undefined;
+    /** The model id the driver was started with (#1438), recorded on the event per leg. */
+    model?: string | undefined;
+}
+/**
+ * Emit the agent's opening `session` event. A literal link is shown right away; a
+ * templated one (`.../{sessionId}`) can only resolve once the driver reports its
+ * session id, so it waits for the `session-update` from {@link createDriverEventHandler}.
+ */
+export declare function emitSessionStart(opts: SessionStartOptions): void;
+/** Inputs to {@link createDriverEventHandler}. */
+export interface DriverEventHandlerOptions {
+    emit: (event: FrameworkEvent) => void;
+    /** The session link template, when the caller configured one. */
+    sessionLink?: string | undefined;
+}
+/** What {@link createDriverEventHandler} hands back. */
+export interface DriverEventHandler {
+    /** Wire this as the driver session's `onEvent`. */
+    onDriverEvent: (event: DriverEvent) => void;
+}
+/**
+ * Watch the driver's black box (#165) and turn it into the agent's stream: surface the real session
+ * id as `session-update` once known (that is the honest handle a UI links to, and it changes per
+ * prompt, so re-emit), and fold each turn's usage into the agent total.
+ *
+ * It used to trip two self-stops here as well — a per-agent USD cap and a mid-run quota gate — each
+ * firing *after* the turn that crossed it, when its cost was already spent (E1).
+ */
+export declare function createDriverEventHandler(opts: DriverEventHandlerOptions): DriverEventHandler;
+/** Inputs to {@link createAgentControls}. */
+export interface AgentControlsOptions {
+    emit: (event: FrameworkEvent) => void;
+    /** The caller's abort signal (Stop button / Ctrl+C / control channel), if any. */
+    signal?: AbortSignal | undefined;
+    sessionLink?: string | undefined;
+}
+/** The agent's abort plumbing plus its driver-event sink. */
+export interface AgentControls extends DriverEventHandler {
+    /** The composed signal every driver turn runs under: the caller's, or the answer's. */
+    agentSignal: AbortSignal;
+    /** Trips a clean stop when the user answers a gate with a `stop` option (#358). */
+    answerController: AbortController;
+}
+/**
+ * Compose the agent's signal and wire its driver-event handler in one place. The caller's signal is
+ * OR'd (via {@link AbortSignal.any}) with the one self-stop left — an answer that says to stop
+ * (#358) — so anything downstream that watches `agentSignal` stops the same way regardless of which
+ * fired.
+ *
+ * There were three (E1). A per-agent USD cap and a mid-run quota gate also aborted a session that
+ * was already going, which is the worst moment to economise: the tokens are already spent, the
+ * work is half-done, and what is saved is the cheap part while what is lost is the expensive part.
+ * Spending is decided once, before a session starts.
+ *
+ * What survives is the one a *person* asked for. It used to be reached through the gate's kind —
+ * a decline of an `await-confirmation` — and now through the option the agent marked, which is
+ * the same stop with the plan-approval special case taken out of it (D6).
+ */
+export declare function createAgentControls(opts: AgentControlsOptions): AgentControls;
+/** Inputs to {@link endStopDetail}. */
+export interface StopDetailOptions {
+    /** The error the agent's turn loop threw. */
+    err: unknown;
+    /** The caller's own signal, to tell a caller stop from a self-stop. */
+    signal?: AbortSignal | undefined;
+    /** The gate-answer stop (#358), which is a stop rather than a failure however it surfaced. */
+    answerController: AbortController;
+}
+/**
+ * Classify why an agent's turn loop threw and render the `end` event's `detail`. A caller interrupt
+ * or an answer that said to stop (#358) are clean stops; anything else is a real failure. Shared
+ * so the two agent paths can never disagree on what "stopped" means.
+ */
+export declare function endStopDetail(opts: StopDetailOptions): {
+    stopped: boolean;
+    detail: string;
+};
+//# sourceMappingURL=agent-telemetry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-telemetry.d.ts","sourceRoot":"","sources":["../src/agent-telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAEvD,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAUjD,0CAA0C;AAC1C,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAA;IACrC,MAAM,EAAE,MAAM,CAAA;IACd,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAA;IACX,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAUhE;AAED,kDAAkD;AAClD,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAA;IACrC,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACjC;AAED,wDAAwD;AACxD,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,aAAa,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;CAC5C;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,yBAAyB,GAAG,kBAAkB,CAoC5F;AAED,6CAA6C;AAC7C,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAA;IACrC,kFAAkF;IAClF,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;IAChC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACjC;AAED,6DAA6D;AAC7D,MAAM,WAAW,aAAc,SAAQ,kBAAkB;IACvD,uFAAuF;IACvF,WAAW,EAAE,WAAW,CAAA;IACxB,mFAAmF;IACnF,gBAAgB,EAAE,eAAe,CAAA;CAClC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG,aAAa,CAK7E;AAED,uCAAuC;AACvC,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,GAAG,EAAE,OAAO,CAAA;IACZ,uEAAuE;IACvE,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;IAChC,8FAA8F;IAC9F,gBAAgB,EAAE,eAAe,CAAA;CAClC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAK3F"}

package/dist/agent-telemetry.js

@@ -0,0 +1,97 @@
+import { hasSessionIdPlaceholder, resolveSessionLink } from './session-link.js';
+import { UsageMeter } from './usage.js';
+/**
+ * Emit the agent's opening `session` event. A literal link is shown right away; a
+ * templated one (`.../{sessionId}`) can only resolve once the driver reports its
+ * session id, so it waits for the `session-update` from {@link createDriverEventHandler}.
+ */
+export function emitSessionStart(opts) {
+    const literal = opts.sessionLink && !hasSessionIdPlaceholder(opts.sessionLink) ? opts.sessionLink : undefined;
+    opts.emit({
+        kind: 'session',
+        driver: opts.driver.id,
+        workspace: opts.cwd,
+        fake: opts.driver.id === 'fake',
+        ...(literal ? { sessionLink: literal } : {}),
+        ...(opts.model ? { model: opts.model } : {}),
+    });
+}
+/**
+ * Watch the driver's black box (#165) and turn it into the agent's stream: surface the real session
+ * id as `session-update` once known (that is the honest handle a UI links to, and it changes per
+ * prompt, so re-emit), and fold each turn's usage into the agent total.
+ *
+ * It used to trip two self-stops here as well — a per-agent USD cap and a mid-run quota gate — each
+ * firing *after* the turn that crossed it, when its cost was already spent (E1).
+ */
+export function createDriverEventHandler(opts) {
+    const { emit } = opts;
+    let lastSessionId;
+    const usage = new UsageMeter();
+    const onDriverEvent = (event) => {
+        // The turn-start id announcement (#1322) is consumed here, not forwarded: it exists so the
+        // `session-update` below lands before a Stop or a crash can lose the turn, and a transcript
+        // row repeating an id the very next event also carries would only be noise.
+        if (event.type === 'session') {
+            if (event.sessionId !== lastSessionId) {
+                lastSessionId = event.sessionId;
+                const link = opts.sessionLink ? resolveSessionLink(opts.sessionLink, event.sessionId) : undefined;
+                emit({ kind: 'session-update', sessionId: event.sessionId, ...(link ? { sessionLink: link } : {}) });
+            }
+            return;
+        }
+        emit({ kind: 'driver', event });
+        if (event.type !== 'result')
+            return;
+        // The hand-off anchor (#1601) reaches the meta the same way the session id does: it is a
+        // fact about the run the daemon needs after this process is gone, so only an event carries it.
+        if (event.anchorSha)
+            emit({ kind: 'cloud-anchor', sha: event.anchorSha });
+        if (event.sessionId && event.sessionId !== lastSessionId) {
+            lastSessionId = event.sessionId;
+            // A driver that knows its session's real URL (#1317, the cloud hand-off) beats the
+            // session-link template, whose Claude default is the generic entry point.
+            const link = event.sessionLink ?? (opts.sessionLink ? resolveSessionLink(opts.sessionLink, event.sessionId) : undefined);
+            emit({ kind: 'session-update', sessionId: event.sessionId, ...(link ? { sessionLink: link } : {}) });
+        }
+        if (!event.usage)
+            return;
+        usage.add(event.usage);
+        const totals = usage.totals();
+        emit({ kind: 'usage', ...totals });
+    };
+    return { onDriverEvent };
+}
+/**
+ * Compose the agent's signal and wire its driver-event handler in one place. The caller's signal is
+ * OR'd (via {@link AbortSignal.any}) with the one self-stop left — an answer that says to stop
+ * (#358) — so anything downstream that watches `agentSignal` stops the same way regardless of which
+ * fired.
+ *
+ * There were three (E1). A per-agent USD cap and a mid-run quota gate also aborted a session that
+ * was already going, which is the worst moment to economise: the tokens are already spent, the
+ * work is half-done, and what is saved is the cheap part while what is lost is the expensive part.
+ * Spending is decided once, before a session starts.
+ *
+ * What survives is the one a *person* asked for. It used to be reached through the gate's kind —
+ * a decline of an `await-confirmation` — and now through the option the agent marked, which is
+ * the same stop with the plan-approval special case taken out of it (D6).
+ */
+export function createAgentControls(opts) {
+    const answerController = new AbortController();
+    const agentSignal = AbortSignal.any([...(opts.signal ? [opts.signal] : []), answerController.signal]);
+    const handler = createDriverEventHandler({ emit: opts.emit, sessionLink: opts.sessionLink });
+    return { ...handler, agentSignal, answerController };
+}
+/**
+ * Classify why an agent's turn loop threw and render the `end` event's `detail`. A caller interrupt
+ * or an answer that said to stop (#358) are clean stops; anything else is a real failure. Shared
+ * so the two agent paths can never disagree on what "stopped" means.
+ */
+export function endStopDetail(opts) {
+    const callerAborted = opts.signal?.aborted === true;
+    const answered = opts.answerController.signal.aborted;
+    const detail = answered ? 'stopped by your answer' : opts.err instanceof Error ? opts.err.message : String(opts.err);
+    return { stopped: callerAborted || answered, detail };
+}
+//# sourceMappingURL=agent-telemetry.js.map

package/dist/agent-telemetry.js.map

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

package/dist/agent-view.d.ts

@@ -0,0 +1,39 @@
+import type { FrameworkEvent } from './events.js';
+/** One error of a run: one the agent reported through an `error` block (#1500), or one its tool wrote in the diary. */
+export interface AgentError {
+    /** What is wrong, in one line. */
+    headline: string;
+    /** What it ran and what that said, when the agent wrote any. */
+    detail?: string;
+}
+/**
+ * Every error of the run (#1500), oldest first — the count the dashboard shows on the session, and
+ * the latest headline it shows beside it. Two sources: the `error` lines the run's tool writes in
+ * the diary when the coding agent or its transport fails (the message's first line is the
+ * headline, the rest the detail), and the `error` blocks of runs recorded before the daemon
+ * stopped running agents.
+ *
+ * A fold over the log rather than state of its own: an error is an event that happened, so the
+ * list only ever grows, and reopening a finished agent shows exactly what it showed while it ran.
+ */
+export declare function agentErrors(events: readonly FrameworkEvent[]): AgentError[];
+/** The wrapped agent session (#431): its id and a deep link, when one is known. */
+export interface SessionInfo {
+    sessionId?: string;
+    sessionLink?: string;
+    /**
+     * The directory the agent ran in (#1195), from the opening `session` event.
+     *
+     * Taken from the event rather than the filesystem on purpose: an agent that finishes cleanly has
+     * its worktree removed (`tearDownWorktree`), so the event is the only surviving record of where
+     * the session lived — and that path is exactly what `claude --resume` needs to find it again.
+     */
+    workspace?: string;
+}
+/**
+ * The session behind the agent (#431): the workspace from the opening `session`
+ * event, then the id and any deep link from the latest `session-update`. Null before the
+ * session opens. The link is what the old dashboard surfaced as "open session".
+ */
+export declare function sessionInfo(events: readonly FrameworkEvent[]): SessionInfo | null;
+//# sourceMappingURL=agent-view.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-view.d.ts","sourceRoot":"","sources":["../src/agent-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAOjD,uHAAuH;AACvH,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,GAAG,UAAU,EAAE,CAY3E;AAED,mFAAmF;AACnF,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,GAAG,WAAW,GAAG,IAAI,CAajF"}

package/dist/agent-view.js

@@ -0,0 +1,45 @@
+/**
+ * Every error of the run (#1500), oldest first — the count the dashboard shows on the session, and
+ * the latest headline it shows beside it. Two sources: the `error` lines the run's tool writes in
+ * the diary when the coding agent or its transport fails (the message's first line is the
+ * headline, the rest the detail), and the `error` blocks of runs recorded before the daemon
+ * stopped running agents.
+ *
+ * A fold over the log rather than state of its own: an error is an event that happened, so the
+ * list only ever grows, and reopening a finished agent shows exactly what it showed while it ran.
+ */
+export function agentErrors(events) {
+    const errors = [];
+    for (const event of events) {
+        if (event.kind === 'error') {
+            errors.push({ headline: event.headline, ...(event.detail ? { detail: event.detail } : {}) });
+        }
+        else if (event.kind === 'driver' && event.event.type === 'error' && typeof event.event.message === 'string') {
+            const [headline = '', ...rest] = event.event.message.trim().split('\n');
+            const detail = rest.join('\n').trim();
+            errors.push({ headline: headline || 'error', ...(detail ? { detail } : {}) });
+        }
+    }
+    return errors;
+}
+/**
+ * The session behind the agent (#431): the workspace from the opening `session`
+ * event, then the id and any deep link from the latest `session-update`. Null before the
+ * session opens. The link is what the old dashboard surfaced as "open session".
+ */
+export function sessionInfo(events) {
+    let info = null;
+    for (const event of events) {
+        if (event.kind === 'session') {
+            info = {
+                workspace: event.workspace,
+                ...(event.sessionLink ? { sessionLink: event.sessionLink } : {}),
+            };
+        }
+        else if (event.kind === 'session-update') {
+            info = { ...(info ?? {}), sessionId: event.sessionId, ...(event.sessionLink ? { sessionLink: event.sessionLink } : {}) };
+        }
+    }
+    return info;
+}
+//# sourceMappingURL=agent-view.js.map

package/dist/agent-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-view.js","sourceRoot":"","sources":["../src/agent-view.ts"],"names":[],"mappings":"AAeA;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,MAAiC;IAC3D,MAAM,MAAM,GAAiB,EAAE,CAAA;IAC/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;QAC9F,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC9G,MAAM,CAAC,QAAQ,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YACvE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAA;YACrC,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,IAAI,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;QAC/E,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAgBD;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,MAAiC;IAC3D,IAAI,IAAI,GAAuB,IAAI,CAAA;IACnC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,GAAG;gBACL,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjE,CAAA;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YAC3C,IAAI,GAAG,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;QAC1H,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}