wicked-crew 0.4.0 → 0.6.0

package/dist/core/types.d.ts

@@ -2,114 +2,24 @@
  * Boundary types for the wicked-core-ts JSON surface.
  *
  * core-ts returns every complex result as a JSON string, which the adapter
- * `JSON.parse`s. These interfaces mirror the serde representation of
- * wicked-core's domain types (wicked-core/src/domain.rs, repo.rs, scope.rs) so
- * the daemon never falls back to `any` at the core boundary. They are permissive
- * about forward-additive fields — a newer core that adds fields still parses.
+ * `JSON.parse`s. The WIRE-SHAPE types — everything that flows on through the
+ * daemon's `/api/v1` + `/ws` surface (SessionView, CoreEvent, governance and
+ * workflow shapes, …) — live in the shared contract package
+ * `wicked-crew-api-types` and are re-exported here verbatim, so the route
+ * layer and the studio SPA compile against the SAME definitions and the two
+ * can no longer drift (task #84; `tests/wire-contract.test.ts` is the guard).
+ *
+ * What remains in THIS file is engine-internal: inputs the adapter maps onto
+ * the native addon (`LaunchRunInput`), shapes that never leave the daemon
+ * (`RepoOnboardRef`), and runtime constants (`DEFAULT_SETTINGS`) — a types-only
+ * contract package cannot carry values.
  *
  * ONLY `core/adapter.ts` imports from the native addon itself; the rest of the
  * daemon speaks these daemon-owned shapes, which is what quarantines the
  * FINALIZING core-ts `subscribe` seam to a single file (DES-STUDIO-001 §5.2).
  */
-/** Run-level lifecycle status (`SessionStatus`, snake_case serde token). */
-export type SessionStatus = 'planning' | 'distributing' | 'executing' | 'awaiting_human' | 'completed' | 'cancelled' | 'failed';
-/** Per-unit lifecycle status (`UnitStatus`). */
-export type UnitStatus = 'pending' | 'distributed' | 'done' | 'rejected';
-/** The methodology stage badge on a unit (`StageKind`). */
-export type StageKind = 'recon' | 'build' | 'review' | 'test';
-/** Collection-scope mode (`EntityMode`). */
-export type EntityMode = 'shared' | 'isolated';
-/** Human-confirm gate policy. serde: `None`→"none", `All`→"all", `Before(n)`→{ before: n }. */
-export type HumanConfirm = 'none' | 'all' | {
-    before: number;
-};
-/** Why a CLI was assigned to a unit (`RoutingInfo`, internally tagged on `method`). */
-export type RoutingInfo = 
-/**
- * `seated` is the seats CONVENED — the denominator `returned` must be read against.
- * Unknown on a run recorded by an engine older than the quorum fix; unknown means exactly that,
- * never "equal to `returned`" (FINDING-026 D).
- *
- * `number | null` AND optional because unknown arrives in both shapes: the engine serializes the
- * artifact's `Option<u32>` as an explicit `null`, and a payload predating the field has no key.
- * Test it with `== null` so both are covered.
- */
-{
-    method: 'council';
-    winner: string;
-    agreement_pct: number;
-    returned: number;
-    seated?: number | null;
-    dissent: number;
-} | {
-    method: 'degraded';
-    reason: string;
-} | {
-    method: 'evaluator_distinct';
-    winner: string;
-    was: string;
-} | {
-    method: 'tool';
-};
-/** A run (`AgentSession`). */
-export interface AgentSession {
-    id: string;
-    workflow_id: string;
-    problem: string;
-    entity_mode: EntityMode;
-    collection_scope: string | null;
-    clis: string[];
-    status: SessionStatus;
-    human_confirm: HumanConfirm;
-    unit_ix: number;
-    attempt: number;
-    workdir: string | null;
-    repo_ref: string | null;
-}
-/** An ordered unit of work within a run (`WorkUnit`). */
-export interface WorkUnit {
-    id: string;
-    session_id: string;
-    ord: number;
-    description: string;
-    stage: StageKind;
-    assigned_cli: string | null;
-    assigned_invocation: string | null;
-    council_task_ref: string | null;
-    routing: RoutingInfo | null;
-    denial_reason: string | null;
-    phase_ref: string | null;
-    conformance_ref: string | null;
-    phase_status: string | null;
-    collection_scope: string | null;
-    status: UnitStatus;
-    skill_ref?: string | null;
-    /** The command this unit runs directly (Tool-executor phases). `null`/absent for Agent units. */
-    tool_cmd?: string[] | null;
-}
-/** A run plus its ordered units — the read a UI builds its project list from (`SessionView`). */
-export interface SessionView {
-    session: AgentSession;
-    units: WorkUnit[];
-}
-/** A registered git repository (`RepoEntry`). */
-export interface RepoEntry {
-    id: string;
-    name: string;
-    root_path: string;
-    default_branch: string;
-    registered_at: number;
-    /** Remote git URL the repo was cloned from (undefined for locally-registered repos). */
-    git_url?: string;
-    /**
-     * ABSOLUTE path of this repo's code graph, resolved by the engine (wicked-core#170).
-     *
-     * Optional in the TYPE, mandatory in practice: an addon predating the field omits it, and
-     * `codeGraphDb()` in `repoPaths.ts` is where that turns into a loud error. Never join this path
-     * yourself — six independent spellings is what FINDING-069 was.
-     */
-    code_graph_db?: string;
-}
+export type * from 'wicked-crew-api-types';
+import type { SystemSettings } from 'wicked-crew-api-types';
 /** The run id of the onboarding run started when a repo was registered. */
 export interface RepoOnboardRef {
     repoId: string;
@@ -131,259 +41,20 @@ export interface LaunchRunInput {
     repoRef?: string;
     /** Workflow def id to drive (e.g. `domain-extraction`). Omit ⇒ free-text planning. */
     workflow?: string;
-}
-/**
- * A CoreEvent frame as delivered by the live stream — a tagged-JSON object
- * discriminated on `type` (wicked-core-ts `event_to_json`). Known optional
- * fields are declared for the frames the daemon inspects; the index signature
- * keeps the shape additive-safe so new variants pass through untouched.
- */
-export interface CoreEvent {
-    type: string;
-    session?: string;
-    ord?: number;
-    prompt?: string;
-    chunk?: string;
-    allow?: boolean;
-    cli?: string;
-    description?: string;
-    problem?: string;
-    message?: string;
-    /** `elicitationCreated`: the id minted by the actor for this elicitation round. */
-    elicitationId?: string;
-    /** `elicitationCreated`: an ordered set of valid responses; `null` / absent = free-text. */
-    options?: string[] | null;
-    /** PTY terminal frames (`terminalOpened`/`terminalOutput`/`terminalExited`): the terminal id. */
-    id?: string;
     /**
-     * A monotonic counter — but of WHAT depends on where the event came from, and the two never
-     * appear together, so there is exactly one right reading per event:
-     *
-     * - **live `/ws` frame** — `terminalOutput` only, and it counts within that one terminal
-     *   (`actor.rs` `TerminalState::next_seq`). Two terminals both start at 0; comparing their `seq`
-     *   values means nothing.
-     * - **entry from `runEvents`** — the durable log's own envelope counter, process-wide and stamped
-     *   at emit (`event_log.rs` `SEQ`), which is what `read_run` sorts on. It totals-orders a run,
-     *   which `ts` alone cannot: a burst from one actor turn shares a millisecond.
-     *
-     * They cannot collide, because `terminalOutput` is classed high-volume and is **never written to
-     * the log** — so no payload ever carries both meanings. What that does forbid is merging the two
-     * sources and sorting the result on this field: a live per-terminal 3 is not comparable to a
-     * replayed envelope 4700. Sort a replay by `seq`; order live frames by arrival, per terminal id.
+     * Project to file this run into (DES-PROJECT-001 §2.2). The engine attaches the `crew.run`
+     * membership atomically with the launch record; unknown/archived ⇒ the launch fails with no
+     * session persisted. Omit ⇒ unfiled (the synthesized `default` project).
      */
-    seq?: number;
-    /** Capture time, epoch millis. Present ONLY on entries replayed from the durable event log
-     *  (`runEvents`); live `/ws` frames are not stamped, because for those the arrival IS the time. */
-    ts?: number;
-    /** `terminalOutput`: raw PTY bytes, base64-encoded (decode → send to the owning socket). */
-    bytesB64?: string;
-    /** `terminalOpened`: the working directory the PTY was opened in. */
-    cwd?: string;
-    /** `unitDispatched`/`cliUsage`: 0-based dispatch attempt (`>0` = a re-dispatch / rework). */
-    attempt?: number;
-    /** `cliUsage`: prompt/input tokens for the unit run. */
-    inputTokens?: number;
-    /** `cliUsage`: completion/output tokens for the unit run. */
-    outputTokens?: number;
-    /** `cliUsage`: dollar cost when the CLI reports it (claude) or a price table resolves it; else `null`. */
-    costUsd?: number | null;
-    /** `dataUsed`: the data files the unit's CLI touched. */
-    files?: string[];
-    /** `gateEvaluated`: the gated criterion — `null` when the phase was UNGATED. */
-    criterion?: string | null;
-    /** `gateEvaluated`: `true` iff a pinned validator gated this unit. */
-    hasDeterministicFloor?: boolean;
-    /** `gateEvaluated`: whether the deterministic (layer-1) floor passed. */
-    deterministicPass?: boolean;
-    /** `gateEvaluated`: the agent (layer-2) judge's verdict when one ran, else `null`. */
-    agentVerdict?: string | null;
-    /** `gateEvaluated`: the agent judge's reasoning when one ran, else `null`. */
-    agentReasoning?: string | null;
-    /** `gateEvaluated`: the evaluator≠creator second-pass result — `null` when it did not run. */
-    evaluatorPass?: boolean | null;
+    projectId?: string;
     /**
-     * `gateEvaluated`: policy ids the second pass applied. EMPTY alongside `evaluatorPass: true`
-     * means nothing applied, so the pass is a vacuous default-allow rather than an enforced
-     * approval (FINDING-025). The layer-3 analogue of `hasDeterministicFloor`.
+     * ADDITIONAL absolute write roots for the run's deliverables (wicked-core#259 / crew#263) —
+     * e.g. the interactive-draft inbox the workflow contract names as the output destination.
+     * The engine validates each root at launch (absolute, never the engine config/pin tree) and
+     * widens the governed units' filesystem boundary by exactly these roots; an invalid root
+     * fails the launch with no session persisted. Omit for runs that deliver inside their workdir.
      */
-    evaluatorPolicies?: string[];
-    /** `gateEvaluated`: the WINNING denial's reason when `combined === false`, else `null`. */
-    denialReason?: string | null;
-    /** `gateEvaluated`: the final deny-dominant decision over all layers. */
-    combined?: boolean;
-    [k: string]: unknown;
-}
-/**
- * A frame read back from core's DURABLE per-run event log (`Core::runEvents`):
- * the same tagged object the live stream carries, plus the two fields the log
- * adds when it records one.
- *
- * Same shape as the live frame on purpose — one mapping in core
- * (`CoreEvent::to_json`) serializes both, so an event named here is the event
- * named live, and a bundle assembled after a run cannot describe it in different
- * words than the operator watched it happen in. (FINDING-014)
- */
-export interface RecordedEvent extends CoreEvent {
-    /** Capture time, epoch millis — when core emitted the frame, not when it was read. */
-    ts: number;
-    /**
-     * Monotonic ordering across THIS RUN's whole event trail, so frames sharing a `ts` are still
-     * ordered.
-     *
-     * Not the same `seq` as `CoreEvent`'s, which counts chunks within one terminal's output. This one
-     * is required and spans every frame of the run; that one is optional and scoped to a stream. The
-     * name is inherited from the wire and narrowed here rather than renamed, because the wire is what
-     * `runEvents` returns.
-     */
-    seq: number;
-}
-/**
- * A registered governance policy (`wicked-governance::Policy`).
- * Serialized via serde snake_case — `effect` values are `deny` | `allow_with_conditions` | `allow`;
- * `severity` values are `high` | `medium` | `low`.
- */
-export interface GovernancePolicy {
-    id: string;
-    kind: string;
-    applies_to: string[];
-    effect: 'deny' | 'allow_with_conditions' | 'allow';
-    trigger: {
-        contains?: string;
-    };
-    obligations: string[];
-    criteria: string;
-    severity: 'high' | 'medium' | 'low';
-    rule: string;
-    /**
-     * Withdrawn from enforcement (FINDING-038). A retired policy is still listed — its node survives
-     * so past decisions citing it stay explicable — but it can no longer decide a gate. Absent on
-     * policies written before the field existed, which read as active.
-     */
-    retired?: boolean;
-}
-/**
- * A prescriptive conformance rule (`wicked-governance::ConformanceRule`).
- * `rule_type` is `pattern` | `policy`; `severity` is `info` | `warn` | `error` | `critical`.
- */
-export interface ConformanceRule {
-    id: string;
-    rule_type: 'pattern' | 'policy';
-    statement: string;
-    severity: 'info' | 'warn' | 'error' | 'critical';
-    confidence: number;
-    targets: {
-        language?: string;
-        layer?: string;
-        framework?: string;
-    };
-    symbol_ref?: string;
-    compliance?: {
-        framework: string;
-        control_id: string;
-    };
-    provenance: {
-        source: string;
-        ref?: string;
-        source_kinds: string[];
-    };
-    /** Withdrawn from recall. Same contract as {@link GovernancePolicy.retired}. */
-    retired?: boolean;
-}
-/**
- * A recorded conformance claim / evaluation result (`wicked-apps-core::ConformanceClaim`).
- * `decision` values are `allow` | `deny` | `allow_with_conditions` (serde snake_case).
- */
-export interface GovernanceClaim {
-    claim_id: string;
-    scope: string;
-    phase: string;
-    policy_ids: string[];
-    decision: 'allow' | 'deny' | 'allow_with_conditions';
-    obligations: string[];
-    evaluated_context_ref: string;
-    criteria: string;
-    evaluator_identity: string;
-    /** Unix-seconds timestamp. */
-    evaluated_at: number;
-}
-/** Per-app breakdown within a `CoverageReport`. */
-export interface CoveragePerApp {
-    app: string;
-    behavior_bearing: number;
-    resolved: number;
-    risk_flagged: number;
-    unaccounted: number;
-    coverage: number;
-}
-/** A behavior-bearing graph node without a coverage annotation (a coverage hole). */
-export interface UnaccountedNode {
-    symbol_id: string;
-    name?: string;
-    kind?: string;
-    file?: string;
-    app?: string;
-}
-/** Front-half coverage gate report (`wicked-governance::CoverageReport`). Null on empty store. */
-export interface CoverageReport {
-    total: number;
-    behavior_bearing: number;
-    resolved: number;
-    risk_flagged: number;
-    unaccounted: number;
-    coverage: number;
-    resolved_rate: number;
-    mean_confidence: number;
-    resolve_threshold: number;
-    per_app: CoveragePerApp[];
-    unaccounted_nodes: UnaccountedNode[];
-}
-/** Gate position in the value→strategy→execution ladder. */
-export type GateType = 'value' | 'strategy' | 'execution';
-/** Human-confirm spec for a phase gate. */
-export type GateSpec = 'auto' | {
-    human_confirm: {
-        unconditional: boolean;
-    };
-} | {
-    human_confirm_if: 'verdict_not_pass';
-};
-/** Evaluator≠creator role. */
-export type PhaseRole = 'neutral' | 'creator' | 'evaluator';
-/** Methodology stage for a phase. */
-export type StageKindPhase = 'recon' | 'build' | 'review' | 'test';
-/** One ordered phase of a workflow — pure data. */
-export type PhaseExecutor = {
-    type: 'agent';
-} | {
-    type: 'tool';
-    cmd: string[];
-};
-export interface PhaseDef {
-    /** Omitted = agent execution (engine default). Tool phases bypass the council and run cmd directly. */
-    executor?: PhaseExecutor;
-    id: string;
-    kind: StageKindPhase;
-    gate_type: GateType | null;
-    gate: GateSpec;
-    executes_code: boolean;
-    verified_evidence: boolean;
-    required_deliverables: string[];
-    depends_on: string[];
-    role: PhaseRole;
-    skill_ref: string | null;
-    allowed_skills: string[];
-    validator_pin: string | null;
-}
-/** A workflow — id + ordered phases. */
-export interface WorkflowDef {
-    id: string;
-    phases: PhaseDef[];
-    /** True for built-in system workflows that have dedicated entry points — hidden from the work-mode selector. */
-    is_system?: boolean;
-}
-export interface SystemSettings {
-    /** Max nodes returned by wicked-estate graph-view (default 150). */
-    graphNodeLimit: number;
+    extraWriteRoots?: string[];
 }
 export declare const DEFAULT_SETTINGS: SystemSettings;
 //# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,mBAAmB,uBAAuB,CAAC;AAE3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,8FAA8F;AAC9F,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,eAAO,MAAM,gBAAgB,EAAE,cAE9B,CAAC"}

package/dist/core/types.js

@@ -2,10 +2,17 @@
  * Boundary types for the wicked-core-ts JSON surface.
  *
  * core-ts returns every complex result as a JSON string, which the adapter
- * `JSON.parse`s. These interfaces mirror the serde representation of
- * wicked-core's domain types (wicked-core/src/domain.rs, repo.rs, scope.rs) so
- * the daemon never falls back to `any` at the core boundary. They are permissive
- * about forward-additive fields — a newer core that adds fields still parses.
+ * `JSON.parse`s. The WIRE-SHAPE types — everything that flows on through the
+ * daemon's `/api/v1` + `/ws` surface (SessionView, CoreEvent, governance and
+ * workflow shapes, …) — live in the shared contract package
+ * `wicked-crew-api-types` and are re-exported here verbatim, so the route
+ * layer and the studio SPA compile against the SAME definitions and the two
+ * can no longer drift (task #84; `tests/wire-contract.test.ts` is the guard).
+ *
+ * What remains in THIS file is engine-internal: inputs the adapter maps onto
+ * the native addon (`LaunchRunInput`), shapes that never leave the daemon
+ * (`RepoOnboardRef`), and runtime constants (`DEFAULT_SETTINGS`) — a types-only
+ * contract package cannot carry values.
  *
  * ONLY `core/adapter.ts` imports from the native addon itself; the rest of the
  * daemon speaks these daemon-owned shapes, which is what quarantines the

package/dist/core/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAqYH,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,cAAc,EAAE,GAAG;CACpB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AA4CH,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,cAAc,EAAE,GAAG;CACpB,CAAC"}

package/dist/interactive/bridge-pool.d.ts

@@ -0,0 +1,71 @@
+/**
+ * The wicked-interactive bridge pool — discovery, health, reuse-or-start (DES-MERGE-001 §5.3/§5.6).
+ *
+ * A bridge is a local `wicked-interactive serve` process that records itself in
+ * `<root>/.wi-serve.json` = `{ port, host, pid, startedAt, version }` (ADR-0022). Its port is
+ * DYNAMIC — the first free port above its base — which is precisely why crew, a server process
+ * that can read that lockfile, proxies it instead of the browser dialling a port literal.
+ *
+ * LOCAL-ONLY BY DESIGN. Every mechanism here (a pid, a file in a directory, spawning a child)
+ * is single-host. That is the slice-1 posture, not an oversight: when the execution seam goes
+ * remote, this module is the seam that gets a remote implementation, and the proxy above it
+ * does not change.
+ *
+ * Pooling is keyed by the RESOLVED root (see `bridge-root.ts`), so two projects that share the
+ * default root share one bridge and one port; projects bound to different roots get their own.
+ *
+ * Health follows ADR-0025's hardened reuse check, and the ORDER matters: a recorded pid that is
+ * alive but slow (cold first hit, busy materializing) must be REUSED, not duplicated — so a
+ * live pid earns three 1.5 s attempts before the bridge is declared dead. Identity is checked
+ * too: `/api/health` must report THIS root, or a recycled port belonging to some other service
+ * would be proxied as if it were ours.
+ */
+import { type ChildProcess } from 'node:child_process';
+export declare const LOCK_NAME = ".wi-serve.json";
+/** ADR-0025: 1.5 s × 3 while the pid lives. */
+export declare const HEALTH_TIMEOUT_MS = 1500;
+export declare const HEALTH_ATTEMPTS = 3;
+/** A cold `npx wicked-interactive serve` may have to resolve and fetch the package first. */
+export declare const START_TIMEOUT_MS = 60000;
+/** A bridge that answered `/api/health` for its root. */
+export interface LiveBridge {
+    host: string;
+    port: number;
+    pid: number;
+}
+/** The 503 the proxy renders as `{"code":"bridge_unavailable","hint":...}` (§5.6). */
+export declare class BridgeUnavailableError extends Error {
+    /** An ACTIONABLE command an operator can actually run — never a bare "try again". */
+    readonly hint: string;
+    constructor(message: string, hint: string);
+}
+/** Injectable IO — the integration suite substitutes a fake bridge for the real `npx` spawn. */
+export interface BridgePoolIo {
+    spawn?: (root: string) => ChildProcess;
+    startTimeoutMs?: number;
+    healthTimeoutMs?: number;
+    log?: (msg: string) => void;
+}
+/** `<root>/.wi-serve.json`, or null when absent/unparseable/incomplete. */
+export declare function readLock(root: string): LiveBridge | null;
+/** Signal 0 probes existence without delivering: EPERM means alive-but-not-ours. */
+export declare function pidAlive(pid: number): boolean;
+export declare class InteractiveBridgePool {
+    private readonly io;
+    /** Last bridge known good per root — the fast path that keeps the proxy off `fetch` per request. */
+    private readonly live;
+    /** In-flight resolutions per root, so a burst of first requests starts ONE bridge, not N. */
+    private readonly inflight;
+    constructor(io?: BridgePoolIo);
+    /** Reuse-or-start, idempotent per root. Throws `BridgeUnavailableError` when start is impossible. */
+    ensure(root: string): Promise<LiveBridge>;
+    /** Drop the cached bridge for a root — called when a proxied connection is refused. */
+    invalidate(root: string): void;
+    /** Live bridges, for tests and future operator introspection. */
+    keys(): string[];
+    private resolveOrStart;
+    /** The lockfile points at a bridge that is alive, answering, and serving THIS root. */
+    private healthy;
+    private start;
+}
+//# sourceMappingURL=bridge-pool.d.ts.map

package/dist/interactive/bridge-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-pool.d.ts","sourceRoot":"","sources":["../../src/interactive/bridge-pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAI3E,eAAO,MAAM,SAAS,mBAAmB,CAAC;AAC1C,+CAA+C;AAC/C,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,6FAA6F;AAC7F,eAAO,MAAM,gBAAgB,QAAS,CAAC;AAEvC,yDAAyD;AACzD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,sFAAsF;AACtF,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,qFAAqF;IACrF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAK1C;AAOD,gGAAgG;AAChG,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,YAAY,CAAC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,2EAA2E;AAC3E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAQxD;AAED,oFAAoF;AACpF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQ7C;AAkBD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAe;IAClC,oGAAoG;IACpG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiC;IACtD,6FAA6F;IAC7F,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0C;gBAEvD,EAAE,GAAE,YAAiB;IAIjC,qGAAqG;IAC/F,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAc/C,uFAAuF;IACvF,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B,iEAAiE;IACjE,IAAI,IAAI,MAAM,EAAE;YAIF,cAAc;IAW5B,uFAAuF;YACzE,OAAO;YAeP,KAAK;CAsCpB"}