wicked-crew 0.7.40 → 0.7.46

package/dist/mcp/usage.js

@@ -0,0 +1,159 @@
+/**
+ * The MCP usage fold (DES-MCP-TOOLS-001 §7 Usage, §8 `GET /mcp/usage`; slice S7).
+ *
+ * A pure function over call records (`calls.ndjson`, written by the broker, S3): counts, the
+ * decision split (allow / ask / deny / guard_error), the error rate and nearest-rank p50/p95/p99
+ * over the calls that ran, a per-tool table, per-server totals, the tool × seat × run drill-down,
+ * the common tool chains and one row per UTC day. Nothing is cached and no poller runs: every
+ * `GET /mcp/usage` folds the records as they are on disk.
+ */
+import { parseMcpSubject } from './classify.js';
+export const MCP_USAGE_MAX_DAYS = 30;
+export const MCP_USAGE_DEFAULT_DAYS = 7;
+export const MCP_USAGE_DECISIONS = ['allow', 'ask', 'deny', 'guard_error'];
+export const MCP_USAGE_MAX_RUNS = 200;
+export const MCP_USAGE_MAX_CHAINS = 20;
+const DAY_MS = 86_400_000;
+/** Nearest-rank percentile of ascending `sorted`: the value at position `ceil(q * n)`. */
+export function nearestRank(sorted, q) {
+    if (sorted.length === 0)
+        return null;
+    const rank = Math.max(1, Math.ceil(q * sorted.length));
+    return sorted[Math.min(rank, sorted.length) - 1] ?? null;
+}
+function zero() {
+    return { allow: 0, ask: 0, deny: 0, guard_error: 0 };
+}
+function stats(records) {
+    const decisions = zero();
+    const ms = [];
+    let errors = 0;
+    for (const r of records) {
+        decisions[r.decision.decision] += 1;
+        if (r.decision.decision !== 'allow')
+            continue;
+        ms.push(r.ms);
+        if (r.status.code === 'error')
+            errors += 1;
+    }
+    ms.sort((a, b) => a - b);
+    return {
+        calls: records.length,
+        decisions,
+        ran: ms.length,
+        errors,
+        errorRate: ms.length === 0 ? null : errors / ms.length,
+        p50Ms: nearestRank(ms, 0.5),
+        p95Ms: nearestRank(ms, 0.95),
+        p99Ms: nearestRank(ms, 0.99),
+    };
+}
+function groupBy(records, key) {
+    const out = new Map();
+    for (const r of records) {
+        const k = key(r);
+        const list = out.get(k);
+        if (list === undefined)
+            out.set(k, [r]);
+        else
+            list.push(r);
+    }
+    return out;
+}
+const byStart = (a, b) => Date.parse(a.start) - Date.parse(b.start) || a.spanId.localeCompare(b.spanId);
+const newest = (records) => records.reduce((n, r) => (byStart(r, n) > 0 ? r : n));
+const seatOf = (r) => r.attrs['wicked.seat'];
+const subjectOf = (r) => r.attrs['mcp.subject'];
+/** The tool chains of `records`: consecutive calls of one unit attempt, with different subjects. */
+export function foldChains(records, subject) {
+    const units = groupBy(records.filter((r) => r.traceId !== null && r.parentSpanId !== null), (r) => `${r.traceId ?? ''}\u0000${r.parentSpanId ?? ''}`);
+    const chains = new Map();
+    for (const calls of units.values()) {
+        const ordered = [...calls].sort(byStart);
+        for (let i = 1; i < ordered.length; i++) {
+            const from = subjectOf(ordered[i - 1]);
+            const to = subjectOf(ordered[i]);
+            if (from === to)
+                continue;
+            if (subject !== undefined && from !== subject && to !== subject)
+                continue;
+            const key = `${from}\u0000${to}`;
+            const c = chains.get(key) ?? { from, to, count: 0, runs: new Set() };
+            c.count += 1;
+            c.runs.add(ordered[i].traceId ?? '');
+            chains.set(key, c);
+        }
+    }
+    return [...chains.values()]
+        .map((c) => ({ from: c.from, to: c.to, count: c.count, runs: c.runs.size }))
+        .sort((a, b) => b.count - a.count || a.from.localeCompare(b.from) || a.to.localeCompare(b.to))
+        .slice(0, MCP_USAGE_MAX_CHAINS);
+}
+/**
+ * Fold `records` into the usage view for the last `days` × 24 h before `now`. `skipped` passes
+ * through the count of lines the reader could not parse.
+ */
+export function foldMcpUsage(records, query, now, skipped = 0) {
+    const days = query.days ?? MCP_USAGE_DEFAULT_DAYS;
+    const since = now - days * DAY_MS;
+    // Every start is re-spelled as UTC ISO (the broker writes that already; a line written with an
+    // offset must still land on its UTC day and order by its instant).
+    const inWindow = [];
+    for (const r of records) {
+        const t = Date.parse(r.start);
+        if (Number.isFinite(t) && t >= since && t <= now)
+            inWindow.push({ ...r, start: new Date(t).toISOString() });
+    }
+    const seats = [...new Set(inWindow.map(seatOf).filter((s) => s !== null))].sort();
+    const unitFiltered = inWindow.filter((r) => (query.seat === undefined || seatOf(r) === query.seat) && (query.decision === undefined || r.decision.decision === query.decision));
+    const filtered = query.subject === undefined ? unitFiltered : unitFiltered.filter((r) => subjectOf(r) === query.subject);
+    const tools = [...groupBy(filtered, subjectOf)].map(([subject, calls]) => {
+        const parts = parseMcpSubject(subject);
+        const last = newest(calls);
+        const cls = last.attrs['mcp.class'];
+        return {
+            subject,
+            server: parts?.server ?? '',
+            tool: parts?.tool ?? '',
+            class: cls,
+            seats: [...new Set(calls.map(seatOf).filter((s) => s !== null))].sort(),
+            lastCall: last.start,
+            ...stats(calls),
+        };
+    });
+    tools.sort((a, b) => b.calls - a.calls || a.subject.localeCompare(b.subject));
+    const servers = [...groupBy(filtered, (r) => parseMcpSubject(subjectOf(r))?.server ?? '')].map(([server, calls]) => {
+        const s = stats(calls);
+        return { server, calls: s.calls, decisions: s.decisions, lastCall: newest(calls).start };
+    });
+    servers.sort((a, b) => b.calls - a.calls || a.server.localeCompare(b.server));
+    const runs = [...groupBy(filtered, (r) => `${subjectOf(r)}\u0000${seatOf(r) ?? ''}\u0000${r.traceId ?? ''}`).values()].map((calls) => {
+        const first = calls[0];
+        const s = stats(calls);
+        return { subject: subjectOf(first), seat: seatOf(first), runId: first.traceId, calls: s.calls, decisions: s.decisions, errors: s.errors, lastCall: newest(calls).start };
+    });
+    runs.sort((a, b) => b.lastCall.localeCompare(a.lastCall) || a.subject.localeCompare(b.subject));
+    const daily = [];
+    const perDay = groupBy(filtered, (r) => r.start.slice(0, 10));
+    const firstDay = Date.UTC(new Date(since).getUTCFullYear(), new Date(since).getUTCMonth(), new Date(since).getUTCDate());
+    for (let t = firstDay; t <= now; t += DAY_MS) {
+        const day = new Date(t).toISOString().slice(0, 10);
+        const s = stats(perDay.get(day) ?? []);
+        daily.push({ day, calls: s.calls, decisions: s.decisions });
+    }
+    return {
+        days,
+        since: new Date(since).toISOString(),
+        until: new Date(now).toISOString(),
+        filters: { subject: query.subject ?? null, seat: query.seat ?? null, decision: query.decision ?? null },
+        totals: stats(filtered),
+        tools,
+        servers,
+        runs: runs.slice(0, MCP_USAGE_MAX_RUNS),
+        chains: foldChains(unitFiltered, query.subject),
+        daily,
+        seats,
+        skipped,
+    };
+}
+//# sourceMappingURL=usage.js.map

package/dist/mcp/usage.js.map

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

package/dist/presets/routes.d.ts

@@ -0,0 +1,53 @@
+/**
+ * `/api/v1/presets` — saved phase selections (DES-TEAMING-002 §8.4, seam C2):
+ *
+ *   GET    /presets[?projectId=]         the presets a launch in that project sees, by name
+ *   GET    /presets/:name[?projectId=]   one preset (the project's row, else the global one)
+ *   PUT    /presets/:name                save {steps, projectId?} (global when projectId is absent)
+ *   DELETE /presets/:name[?projectId=]   delete in that scope
+ *
+ * A preset is launched by NAME: `POST /runs {workflow: "<name>"}`. The ENGINE resolves it (the
+ * launch's project row, then the global row, then a registered workflow of that name), so the same
+ * name launches the same selection from a campaign node or a bus `wicked.crew.run.requested` with
+ * no crew involvement. These routes are commands and reads over the engine's store (§4.0); crew
+ * keeps no copy and publishes no event.
+ *
+ * Engine error → status: the engine's message leads with a reason token.
+ * `preset_builtin_readonly` 409 · `preset_unknown_project` 404 · any other `preset_*` 400.
+ * An addon without the bindings answers 501 (PresetsUnsupportedError), never 400.
+ */
+import type { FastifyInstance } from 'fastify';
+import { z } from 'zod';
+import type { CoreAdapter } from '../core/adapter.js';
+import { AuditLog } from '../api/audit.js';
+export declare const PutPresetSchema: z.ZodObject<{
+    steps: z.ZodArray<z.ZodObject<{
+        catalog: z.ZodString;
+        id: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        catalog: z.ZodString;
+        id: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        catalog: z.ZodString;
+        id: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+    projectId: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    steps: z.objectOutputType<{
+        catalog: z.ZodString;
+        id: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">[];
+    projectId?: string | undefined;
+}, {
+    steps: z.objectInputType<{
+        catalog: z.ZodString;
+        id: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">[];
+    projectId?: string | undefined;
+}>;
+/** Engine error → HTTP status (the mapping in the module doc). */
+export declare function presetErrorStatus(err: unknown): number;
+export declare function registerPresetRoutes(app: FastifyInstance, adapter: CoreAdapter, security?: {
+    audit: AuditLog;
+}): void;
+//# sourceMappingURL=routes.d.ts.map

package/dist/presets/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/presets/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAU3C,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;EAKjB,CAAC;AAQZ,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAMtD;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,WAAW,EAEpB,QAAQ,GAAE;IAAE,KAAK,EAAE,QAAQ,CAAA;CAA+B,GACzD,IAAI,CAgEN"}

package/dist/presets/routes.js

@@ -0,0 +1,115 @@
+/**
+ * `/api/v1/presets` — saved phase selections (DES-TEAMING-002 §8.4, seam C2):
+ *
+ *   GET    /presets[?projectId=]         the presets a launch in that project sees, by name
+ *   GET    /presets/:name[?projectId=]   one preset (the project's row, else the global one)
+ *   PUT    /presets/:name                save {steps, projectId?} (global when projectId is absent)
+ *   DELETE /presets/:name[?projectId=]   delete in that scope
+ *
+ * A preset is launched by NAME: `POST /runs {workflow: "<name>"}`. The ENGINE resolves it (the
+ * launch's project row, then the global row, then a registered workflow of that name), so the same
+ * name launches the same selection from a campaign node or a bus `wicked.crew.run.requested` with
+ * no crew involvement. These routes are commands and reads over the engine's store (§4.0); crew
+ * keeps no copy and publishes no event.
+ *
+ * Engine error → status: the engine's message leads with a reason token.
+ * `preset_builtin_readonly` 409 · `preset_unknown_project` 404 · any other `preset_*` 400.
+ * An addon without the bindings answers 501 (PresetsUnsupportedError), never 400.
+ */
+import { z } from 'zod';
+import { PresetsUnsupportedError } from '../core/adapter.js';
+import { API_PREFIX } from '../api/api-prefix.js';
+import { AuditLog } from '../api/audit.js';
+import { LOCAL_ACTOR } from '../api/auth.js';
+const V = API_PREFIX;
+/** One plan step. The engine owns the step rules (`plan::compose`, `deny_unknown_fields`), so
+ *  this layer checks only the two keys every step carries and passes the rest through. */
+const PresetStepSchema = z.object({ catalog: z.string().min(1), id: z.string().min(1) }).passthrough();
+// Exported for tests/wire-contract.test.ts (the request-direction drift guard).
+export const PutPresetSchema = z
+    .object({
+    steps: z.array(PresetStepSchema).min(1),
+    projectId: z.string().min(1).optional(),
+})
+    .strict();
+const ScopeQuerySchema = z.object({ projectId: z.string().min(1).optional() }).strict();
+function message(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/** Engine error → HTTP status (the mapping in the module doc). */
+export function presetErrorStatus(err) {
+    if (err instanceof PresetsUnsupportedError)
+        return 501;
+    const msg = message(err);
+    if (msg.startsWith('preset_builtin_readonly'))
+        return 409;
+    if (msg.startsWith('preset_unknown_project'))
+        return 404;
+    return 400;
+}
+export function registerPresetRoutes(app, adapter, 
+// Defaulted to a NOOP trail so a directly-driven route set never writes the real audit log.
+security = { audit: AuditLog.noop() }) {
+    const { audit } = security;
+    const actorOf = (req) => req.actor ?? LOCAL_ACTOR;
+    app.get(`${V}/presets`, async (req, reply) => {
+        const q = ScopeQuerySchema.safeParse(req.query);
+        if (!q.success)
+            return reply.code(400).send({ error: 'Invalid query', details: q.error.issues });
+        try {
+            const body = { presets: await adapter.listPresets(q.data.projectId) };
+            return body;
+        }
+        catch (err) {
+            return reply.code(presetErrorStatus(err)).send({ error: message(err) });
+        }
+    });
+    app.get(`${V}/presets/:name`, async (req, reply) => {
+        const q = ScopeQuerySchema.safeParse(req.query);
+        if (!q.success)
+            return reply.code(400).send({ error: 'Invalid query', details: q.error.issues });
+        try {
+            const preset = (await adapter.listPresets(q.data.projectId)).find((p) => p.name === req.params.name);
+            if (preset === undefined)
+                return reply.code(404).send({ error: `no preset \`${req.params.name}\`` });
+            const body = { preset };
+            return body;
+        }
+        catch (err) {
+            return reply.code(presetErrorStatus(err)).send({ error: message(err) });
+        }
+    });
+    app.put(`${V}/presets/:name`, async (req, reply) => {
+        const parsed = PutPresetSchema.safeParse(req.body);
+        if (!parsed.success) {
+            return reply.code(400).send({ error: 'Invalid request body', details: parsed.error.issues });
+        }
+        try {
+            const preset = await adapter.putPreset(req.params.name, parsed.data.steps, parsed.data.projectId, 'api');
+            audit.record('preset.saved', actorOf(req), { detail: { name: preset.name, scope: preset.scope } });
+            const body = { preset };
+            return body;
+        }
+        catch (err) {
+            return reply.code(presetErrorStatus(err)).send({ error: message(err) });
+        }
+    });
+    app.delete(`${V}/presets/:name`, async (req, reply) => {
+        const q = ScopeQuerySchema.safeParse(req.query);
+        if (!q.success)
+            return reply.code(400).send({ error: 'Invalid query', details: q.error.issues });
+        try {
+            const deleted = await adapter.deletePreset(req.params.name, q.data.projectId);
+            if (!deleted)
+                return reply.code(404).send({ error: `no preset \`${req.params.name}\` in that scope` });
+            audit.record('preset.deleted', actorOf(req), {
+                detail: { name: req.params.name, projectId: q.data.projectId ?? null },
+            });
+            return reply.code(204).send();
+        }
+        catch (err) {
+            return reply.code(presetErrorStatus(err)).send({ error: message(err) });
+        }
+    });
+}
+//# sourceMappingURL=routes.js.map

package/dist/presets/routes.js.map

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

package/dist/projects/activity.d.ts

@@ -4,24 +4,12 @@
  * Two sources, one normalized shape:
  * - CREW: the durable core-event log of the project's `crew.run`/`crew.chat` members
  *   (`adapter.runEvents` — the same log `/runs/:id/events` serves), entry id `crew:<run>:<seq>`.
- * - INTERACTIVE: `wicked.interactive.*` bus events carrying this `project_id`, read directly
- *   from the bus SQLite READ-ONLY through the SAME SQLite library wicked-bus itself uses
- *   (better-sqlite3, resolved from wicked-bus's own location — wicked-bus exposes
- *   subscribe-cursors, not ad-hoc history queries, and a durable cursor per feed-read would turn
- *   a GET into a write), entry id `bus:<event_id>`.
- *
- * WHY NOT `node:sqlite` (F-E2E-021): this daemon already holds long-lived better-sqlite3
- * connections on the very same bus.db (the interactive seams, the /ws relay, the project bridge).
- * SQLite's file locks are POSIX advisory locks, which the kernel releases for the WHOLE process the
- * moment ANY descriptor for that file is closed. One SQLite library instance protects itself (it
- * defers the close while sibling connections hold locks); a SECOND library instance in the same
- * process — Node's bundled SQLite behind `node:sqlite` — knows nothing about the first, so its
- * `close()` here silently released every lock the seams held on bus.db and bus.db-shm. The next
- * short-lived external emitter (`wicked-bus emit`, what wicked-estate spawns after an index) then
- * won the EXCLUSIVE lock on its own close, checkpointed and UNLINKED bus.db-wal/-shm under the
- * seams, whose reads decayed into "database disk image is malformed" on every poll for the life
- * of the daemon. Rule: ONE SQLite library per database file per process — this read goes through
- * wicked-bus's better-sqlite3, whose deferred-close protection then covers it like any seam.
+ * - INTERACTIVE: `wicked.interactive.*` bus events carrying this `project_id`, read through the
+ *   engine that holds the bus (`Core.busRead`, core/bus.ts — wicked-core#631), entry id
+ *   `bus:<event_id>`. Crew opens no SQLite of its own: a second SQLite library on the engine's bus
+ *   file in the same process drops the engine's POSIX locks on its close (F-E2E-021), which is
+ *   why this read used to need a long-lived handle and now needs none. The newest 1000 live
+ *   interactive rows for the project are read, expired ones included: the feed is history.
  *
  * Newest-first, cursor on `(ts, id)` — an opaque `<ts>:<id>` token, base64url. The merge is
  * recomputed per read; members are few and the log excludes high-volume frames, so the simple

package/dist/projects/activity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../src/projects/activity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AA8DtD,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAW9E;AAsFD,sFAAsF;AACtF,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,OAAO,EAAE,aAAa,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAgBlE"}
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../src/projects/activity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAiCtD,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAW9E;AA4ED,sFAAsF;AACtF,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,OAAO,EAAE,aAAa,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAgBlE"}

package/dist/projects/activity.js

@@ -4,49 +4,18 @@
  * Two sources, one normalized shape:
  * - CREW: the durable core-event log of the project's `crew.run`/`crew.chat` members
  *   (`adapter.runEvents` — the same log `/runs/:id/events` serves), entry id `crew:<run>:<seq>`.
- * - INTERACTIVE: `wicked.interactive.*` bus events carrying this `project_id`, read directly
- *   from the bus SQLite READ-ONLY through the SAME SQLite library wicked-bus itself uses
- *   (better-sqlite3, resolved from wicked-bus's own location — wicked-bus exposes
- *   subscribe-cursors, not ad-hoc history queries, and a durable cursor per feed-read would turn
- *   a GET into a write), entry id `bus:<event_id>`.
- *
- * WHY NOT `node:sqlite` (F-E2E-021): this daemon already holds long-lived better-sqlite3
- * connections on the very same bus.db (the interactive seams, the /ws relay, the project bridge).
- * SQLite's file locks are POSIX advisory locks, which the kernel releases for the WHOLE process the
- * moment ANY descriptor for that file is closed. One SQLite library instance protects itself (it
- * defers the close while sibling connections hold locks); a SECOND library instance in the same
- * process — Node's bundled SQLite behind `node:sqlite` — knows nothing about the first, so its
- * `close()` here silently released every lock the seams held on bus.db and bus.db-shm. The next
- * short-lived external emitter (`wicked-bus emit`, what wicked-estate spawns after an index) then
- * won the EXCLUSIVE lock on its own close, checkpointed and UNLINKED bus.db-wal/-shm under the
- * seams, whose reads decayed into "database disk image is malformed" on every poll for the life
- * of the daemon. Rule: ONE SQLite library per database file per process — this read goes through
- * wicked-bus's better-sqlite3, whose deferred-close protection then covers it like any seam.
+ * - INTERACTIVE: `wicked.interactive.*` bus events carrying this `project_id`, read through the
+ *   engine that holds the bus (`Core.busRead`, core/bus.ts — wicked-core#631), entry id
+ *   `bus:<event_id>`. Crew opens no SQLite of its own: a second SQLite library on the engine's bus
+ *   file in the same process drops the engine's POSIX locks on its close (F-E2E-021), which is
+ *   why this read used to need a long-lived handle and now needs none. The newest 1000 live
+ *   interactive rows for the project are read, expired ones included: the feed is history.
  *
  * Newest-first, cursor on `(ts, id)` — an opaque `<ts>:<id>` token, base64url. The merge is
  * recomputed per read; members are few and the log excludes high-volume frames, so the simple
  * full-merge is the honest v1 (the ADR explicitly rejects a new store here).
  */
-import { createRequire } from 'node:module';
-let sqliteCtor;
-/**
- * The better-sqlite3 module INSTANCE wicked-bus loads: resolved from wicked-bus's own entry (the
- * same walk `lib/db.js`'s `require('better-sqlite3')` takes), so even a duplicated copy elsewhere
- * in node_modules could not become a second SQLite library on the bus db (see the module doc).
- * `null` when unresolvable — the interactive half is then empty, never an error.
- */
-function sqlite() {
-    if (sqliteCtor === undefined) {
-        try {
-            const busEntry = createRequire(import.meta.url).resolve('wicked-bus');
-            sqliteCtor = createRequire(busEntry)('better-sqlite3');
-        }
-        catch {
-            sqliteCtor = null;
-        }
-    }
-    return sqliteCtor;
-}
+import { readBus } from '../core/bus.js';
 /** One-line human summary of a core frame (best-effort; `raw` carries the whole frame). */
 function summarizeCoreEvent(frame, runId) {
     const type = typeof frame['type'] === 'string' ? frame['type'] : 'event';
@@ -129,27 +98,18 @@ async function crewEntries(adapter, refs) {
 async function interactiveEntries(busDbPath, projectId) {
     if (busDbPath === null)
         return [];
-    const Database = sqlite();
-    if (Database === null)
-        return [];
-    let db = null;
     const entries = [];
     try {
-        db = new Database(busDbPath, { readonly: true, fileMustExist: true });
-        const rows = db
-            .prepare(`SELECT event_id, event_type, payload, emitted_at FROM events
-         WHERE event_type LIKE 'wicked.interactive.%'
-           AND json_extract(payload, '$.project_id') = ?
-         ORDER BY emitted_at DESC LIMIT 1000`)
-            .all(projectId);
+        // History: rows past the bus TTL stay in the feed (nothing sweeps the daemon's bus).
+        const rows = (await readBus(busDbPath, 'wicked.interactive.', { history: true }))
+            .filter((r) => r.payload?.project_id === projectId)
+            .sort((x, y) => y.emitted_at - x.emitted_at)
+            .slice(0, 1000);
         for (const row of rows) {
-            let payload = null;
-            try {
-                payload = JSON.parse(row.payload);
-            }
-            catch {
-                /* raw stays the string */
-            }
+            // The engine parses the payload; one that is not a JSON object stays in `raw` as stored.
+            const payload = row.payload !== null && typeof row.payload === 'object' && !Array.isArray(row.payload)
+                ? row.payload
+                : null;
             entries.push({
                 id: `bus:${row.event_id}`,
                 ts: row.emitted_at,
@@ -164,13 +124,10 @@ async function interactiveEntries(busDbPath, projectId) {
         }
     }
     catch {
-        // No bus db / schema mismatch — the interactive half is empty, never an error:
+        // No engine bus / an unreadable one — the interactive half is empty, never an error:
         // a project with no bound docs must not 500 its activity feed.
         return entries;
     }
-    finally {
-        db?.close();
-    }
     return entries;
 }
 /** Build one page of the merged feed. `refs` = the project's run/chat member refs. */

package/dist/projects/activity.js.map

@@ -1 +1 @@
-{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../src/projects/activity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAc5C,IAAI,UAAyC,CAAC;AAC9C;;;;;GAKG;AACH,SAAS,MAAM;IACb,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YACtE,UAAU,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,gBAAgB,CAAe,CAAC;QACvE,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,2FAA2F;AAC3F,SAAS,kBAAkB,CAAC,KAA8B,EAAE,KAAa;IACvE,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,KAAK,CAAC,MAAM,CAAY,CAAC,CAAC,CAAC,OAAO,CAAC;IACrF,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,gBAAgB;YACnB,OAAO,OAAO,KAAK,UAAU,CAAC;QAChC,KAAK,eAAe;YAClB,OAAO,OAAO,KAAK,0BACjB,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAM,KAAK,CAAC,QAAQ,CAAY,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAC3F,EAAE,CAAC;QACL,KAAK,SAAS;YACZ,OAAO,OAAO,KAAK,UAAU,CAAC;QAChC,KAAK,kBAAkB;YACrB,OAAO,OAAO,KAAK,YAAY,CAAC;QAClC,KAAK,eAAe;YAClB,OAAO,OAAO,KAAK,SAAS,CAAC;QAC/B,KAAK,cAAc;YACjB,OAAO,OAAO,KAAK,YAAY,CAAC;QAClC,KAAK,aAAa;YAChB,OAAO,OAAO,KAAK,mBAAmB,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC;QACzE;YACE,OAAO,OAAO,KAAK,KAAK,IAAI,EAAE,CAAC;IACnC,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,SAAiB,EAAE,OAAuC;IACtF,MAAM,GAAG,GAAG,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,CAAC,aAAa,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,OAAO,CAAC,aAAa,CAAY,CAAC,CAAC,CAAC,GAAG,CAAC;IACtH,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC;IAC9D,OAAO,OAAO,GAAG,KAAK,KAAK,EAAE,CAAC;AAChC,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,YAAY,CAAC,EAAU,EAAE,EAAU;IACjD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC9D,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,GAAG,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,OAAO,IAAI,CAAC;QACtC,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,SAAS,UAAU,CAAC,CAAgB,EAAE,CAAgB;IACpD,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,kFAAkF;AAClF,SAAS,SAAS,CAAC,KAAoB,EAAE,GAA+B;IACtE,OAAO,KAAK,CAAC,EAAE,GAAG,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,IAAI,KAAK,CAAC,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC;AACzE,CAAC;AAED,2EAA2E;AAC3E,KAAK,UAAU,WAAW,CAAC,OAAoB,EAAE,IAAc;IAC7D,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,MAAM,KAAK,IAAI;YAAE,MAAM,CAAC,8DAA8D;QAC1F,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,KAA2C,CAAC;YAC1D,MAAM,EAAE,GAAG,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,KAAK,CAAC,IAAI,CAAY,CAAC,CAAC,CAAC,CAAC,CAAC;YACzE,MAAM,GAAG,GAAG,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,KAAK,CAAC,KAAK,CAAY,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5E,OAAO,CAAC,IAAI,CAAC;gBACX,EAAE,EAAE,QAAQ,GAAG,IAAI,GAAG,EAAE;gBACxB,EAAE;gBACF,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,KAAK,CAAC,MAAM,CAAY,CAAC,CAAC,CAAC,OAAO;gBAC7E,GAAG;gBACH,OAAO,EAAE,kBAAkB,CAAC,KAAK,EAAE,GAAG,CAAC;gBACvC,GAAG,EAAE,KAAK;aACX,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8EAA8E;AAC9E,KAAK,UAAU,kBAAkB,CAC/B,SAAwB,EACxB,SAAiB;IAEjB,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC;IAC1B,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,EAAE,GAA0B,IAAI,CAAC;IACrC,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,IAAI,CAAC;QACH,EAAE,GAAG,IAAI,QAAQ,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,MAAM,IAAI,GAAG,EAAE;aACZ,OAAO,CACN;;;6CAGqC,CACtC;aACA,GAAG,CAAC,SAAS,CAAoF,CAAC;QACrG,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,OAAO,GAAmC,IAAI,CAAC;YACnD,IAAI,CAAC;gBACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAA4B,CAAC;YAC/D,CAAC;YAAC,MAAM,CAAC;gBACP,0BAA0B;YAC5B,CAAC;YACD,OAAO,CAAC,IAAI,CAAC;gBACX,EAAE,EAAE,OAAO,GAAG,CAAC,QAAQ,EAAE;gBACzB,EAAE,EAAE,GAAG,CAAC,UAAU;gBAClB,MAAM,EAAE,aAAa;gBACrB,IAAI,EAAE,GAAG,CAAC,UAAU;gBACpB,GAAG,EACD,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,CAAC,aAAa,CAAC,KAAK,QAAQ;oBAC5D,CAAC,CAAE,OAAO,CAAC,aAAa,CAAY;oBACpC,CAAC,CAAC,EAAE;gBACR,OAAO,EAAE,oBAAoB,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC;gBACtD,GAAG,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,IAAI,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE;aACjG,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,+EAA+E;QAC/E,+DAA+D;QAC/D,OAAO,OAAO,CAAC;IACjB,CAAC;YAAS,CAAC;QACT,EAAE,EAAE,KAAK,EAAE,CAAC;IACd,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAoB,EACpB,SAAiB,EACjB,IAAc,EACd,SAAwB,EACxB,MAA0B,EAC1B,KAAa;IAEb,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,kBAAkB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAC5G,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAExB,IAAI,IAAI,GAAG,MAAM,CAAC;IAClB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,OAAO,KAAK,IAAI;YAAE,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzC,MAAM,UAAU,GACd,OAAO,CAAC,MAAM,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK,IAAI,IAAI,KAAK,SAAS;QACnE,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC;QAChC,CAAC,CAAC,IAAI,CAAC;IACX,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AACjC,CAAC"}
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../src/projects/activity.ts"],"names":[],"mappings":"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"}

package/dist/projects/events.d.ts

@@ -29,14 +29,15 @@ export declare const PROJECT_ARCHIVED = "wicked.crew.project.archived";
 export declare const MEMBERSHIP_ATTACHED = "wicked.crew.membership.attached";
 export declare const MEMBERSHIP_DETACHED = "wicked.crew.membership.detached";
 export interface ProjectBus {
-    /** Emit one post-commit project event. Never throws; WB-002 (duplicate key) is success. */
-    emit(type: string, payload: Record<string, unknown>, idempotencyKey: string): boolean;
+    /** Emit one post-commit project event (through the engine, core/bus.ts). Never rejects; a key
+     *  already on the bus is success. */
+    emit(type: string, payload: Record<string, unknown>, idempotencyKey: string): Promise<boolean>;
     /** The resolved bus db path (the activity feed's read side opens the same file). */
     dbPath: string | null;
     stop(): Promise<void>;
 }
 export interface ProjectBusOptions {
-    /** Bus db path; omit for wicked-bus's own resolution (honors WICKED_BUS_DATA_DIR). */
+    /** The bus db the daemon handed its engine (core/bus.ts); without one the seam does not arm. */
     dbPath?: string;
     /** Poll cadence for the /ws bridge subscriber, ms (tests shorten it). */
     pollIntervalMs?: number;
@@ -45,8 +46,8 @@ export interface ProjectBusOptions {
     logError?: (msg: string) => void;
 }
 /**
- * Open the bus and arm both halves. Returns `null` (logged) when wicked-bus is not importable
- * or the db cannot open — the caller degrades to CRUD-without-events.
+ * Arm both halves. Returns `null` (logged) when the bus db cannot open — the caller degrades to
+ * CRUD-without-events.
  */
 export declare function startProjectBus(opts?: ProjectBusOptions): Promise<ProjectBus | null>;
 export declare function projectCreatedKey(projectId: string): string;

package/dist/projects/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/projects/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH;;8FAE8F;AAC9F,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAM7C,eAAO,MAAM,eAAe,gCAAgC,CAAC;AAC7D,eAAO,MAAM,eAAe,gCAAgC,CAAC;AAC7D,eAAO,MAAM,gBAAgB,iCAAiC,CAAC;AAC/D,eAAO,MAAM,mBAAmB,oCAAoC,CAAC;AACrE,eAAO,MAAM,mBAAmB,oCAAoC,CAAC;AAErE,MAAM,WAAW,UAAU;IACzB,2FAA2F;IAC3F,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC;IACtF,oFAAoF;IACpF,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,qHAAqH;IACrH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAkG9F;AAID,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3D;AACD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9E;AACD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/E;AACD,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AACD,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE7F"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/projects/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAOH;;8FAE8F;AAC9F,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAI7C,eAAO,MAAM,eAAe,gCAAgC,CAAC;AAC7D,eAAO,MAAM,eAAe,gCAAgC,CAAC;AAC7D,eAAO,MAAM,gBAAgB,iCAAiC,CAAC;AAC/D,eAAO,MAAM,mBAAmB,oCAAoC,CAAC;AACrE,eAAO,MAAM,mBAAmB,oCAAoC,CAAC;AAErE,MAAM,WAAW,UAAU;IACzB;yCACqC;IACrC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/F,oFAAoF;IACpF,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,gGAAgG;IAChG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,qHAAqH;IACrH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAoE9F;AAID,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3D;AACD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9E;AACD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/E;AACD,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AACD,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE7F"}