@mono-agent/tui 0.4.0 → 0.5.0

package/dist/data/instances.d.ts

@@ -0,0 +1,48 @@
+import type { TraceSourceListItem } from "@mono-agent/observability";
+export type { TraceSourceListItem } from "@mono-agent/observability";
+/** The default machine-wide registry dir every agent writes to unless overridden. */
+export declare function defaultTraceRegistryDir(env?: Record<string, string | undefined>): string;
+export interface DiscoverInstancesOptions {
+    readonly registryDir?: string;
+    /**
+     * Consult several registries at once (e.g. an agent's config-local registry
+     * plus the machine-wide global one) and merge by sourceId — the fresher
+     * heartbeat wins a duplicate, earlier dirs win ties. Takes precedence over
+     * the single `registryDir` when non-empty; repeated dirs are deduped.
+     */
+    readonly registryDirs?: readonly string[];
+    readonly staleAfterMs?: number;
+    readonly env?: Record<string, string | undefined>;
+}
+export interface DiscoveredInstance {
+    readonly source: TraceSourceListItem;
+    /** The operator-adapter TUI base URL published by the agent's tui channel, when running. */
+    readonly tuiBaseUrl?: string;
+    /** dirname(configPath): where replay/config data lives relative to. */
+    readonly agentDir?: string;
+}
+export interface DiscoverInstancesResult {
+    readonly instances: readonly DiscoveredInstance[];
+    /** First consulted registry — kept for callers that predate multi-registry discovery. */
+    readonly registryDir: string;
+    /** Every consulted registry, in precedence order (deduped, normalized). */
+    readonly registryDirs: readonly string[];
+    readonly warnings: readonly string[];
+}
+/**
+ * Discover mono-agent instances via one or more trace-source registries
+ * (merged by sourceId — fresher heartbeat wins a duplicate, so each instance
+ * carries its winning manifest's own absolute artifact/config paths). Stopped
+ * sources are filtered out; stale ones stay listed (marked by health) because
+ * a busy agent can miss heartbeats while remaining connectable.
+ */
+export declare function discoverInstances(options?: DiscoverInstancesOptions): Promise<DiscoverInstancesResult>;
+export declare function toInstance(source: TraceSourceListItem): DiscoveredInstance;
+/**
+ * Best-effort apiKey resolution for a discovered agent: the registry never
+ * carries secrets, so read the agent's own config file (`tui.apiKey` /
+ * `MONO_AGENT_TUI_API_KEY` env of THIS process). Failures resolve undefined —
+ * a keyless connect against a keyed agent surfaces as 401 with a hint.
+ */
+export declare function resolveInstanceApiKey(instance: DiscoveredInstance, env?: Record<string, string | undefined>): Promise<string | undefined>;
+//# sourceMappingURL=instances.d.ts.map

package/dist/data/instances.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../src/data/instances.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,qFAAqF;AACrF,wBAAgB,uBAAuB,CAAC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,MAAM,CAMrG;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,4FAA4F;IAC5F,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAClD,yFAAyF;IACzF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,uBAAuB,CAAC,CAmBlC;AAoBD,wBAAgB,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,kBAAkB,CAO1E;AAkBD;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,kBAAkB,EAC5B,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAqB7B"}

package/dist/data/instances.js

@@ -0,0 +1,101 @@
+import { homedir } from "node:os";
+import { dirname, resolve } from "node:path";
+import { listTraceSources, mergeTraceSources } from "@mono-agent/observability";
+/** The default machine-wide registry dir every agent writes to unless overridden. */
+export function defaultTraceRegistryDir(env = process.env) {
+    const override = env.MONO_AGENT_TRACE_REGISTRY_DIR?.trim();
+    if (override !== undefined && override.length > 0) {
+        return resolve(override);
+    }
+    return resolve(homedir(), ".mono-agent", "trace-sources");
+}
+/**
+ * Discover mono-agent instances via one or more trace-source registries
+ * (merged by sourceId — fresher heartbeat wins a duplicate, so each instance
+ * carries its winning manifest's own absolute artifact/config paths). Stopped
+ * sources are filtered out; stale ones stay listed (marked by health) because
+ * a busy agent can miss heartbeats while remaining connectable.
+ */
+export async function discoverInstances(options = {}) {
+    const registryDirs = normalizeRegistryDirs(options);
+    const results = await Promise.all(registryDirs.map((registryDir) => listTraceSources({
+        registryDir,
+        ...(options.staleAfterMs === undefined ? {} : { staleAfterMs: options.staleAfterMs }),
+    })));
+    const instances = mergeTraceSources(...results.map((result) => result.sources))
+        .filter((source) => source.health !== "stopped")
+        .map((source) => toInstance(source));
+    return {
+        instances,
+        registryDir: registryDirs[0] ?? "",
+        registryDirs,
+        warnings: results.flatMap((result) => result.warnings),
+    };
+}
+/** Resolve + dedupe the requested registry list; `registryDirs` (when non-empty) beats the single `registryDir`. */
+function normalizeRegistryDirs(options) {
+    const requested = options.registryDirs !== undefined && options.registryDirs.length > 0
+        ? options.registryDirs
+        : [options.registryDir ?? defaultTraceRegistryDir(options.env)];
+    const seen = new Set();
+    const dirs = [];
+    for (const dir of requested) {
+        const resolved = resolve(dir);
+        if (!seen.has(resolved)) {
+            seen.add(resolved);
+            dirs.push(resolved);
+        }
+    }
+    return dirs;
+}
+export function toInstance(source) {
+    const tuiBaseUrl = tuiBaseUrlFromMetadata(source.metadata);
+    return {
+        source,
+        ...(tuiBaseUrl === undefined ? {} : { tuiBaseUrl }),
+        ...(source.configPath === undefined ? {} : { agentDir: dirname(source.configPath) }),
+    };
+}
+function tuiBaseUrlFromMetadata(metadata) {
+    const channels = metadata?.channels;
+    if (typeof channels !== "object" || channels === null) {
+        return undefined;
+    }
+    const tui = channels.tui;
+    if (typeof tui !== "object" || tui === null) {
+        return undefined;
+    }
+    const record = tui;
+    if (record.kind !== "running") {
+        return undefined;
+    }
+    return typeof record.baseUrl === "string" && record.baseUrl.length > 0 ? record.baseUrl : undefined;
+}
+/**
+ * Best-effort apiKey resolution for a discovered agent: the registry never
+ * carries secrets, so read the agent's own config file (`tui.apiKey` /
+ * `MONO_AGENT_TUI_API_KEY` env of THIS process). Failures resolve undefined —
+ * a keyless connect against a keyed agent surfaces as 401 with a hint.
+ */
+export async function resolveInstanceApiKey(instance, env = process.env) {
+    const fromEnv = env.MONO_AGENT_TUI_API_KEY?.trim();
+    if (fromEnv !== undefined && fromEnv.length > 0) {
+        return fromEnv;
+    }
+    const configPath = instance.source.configPath;
+    if (configPath === undefined) {
+        return undefined;
+    }
+    try {
+        const { readFile } = await import("node:fs/promises");
+        const parsed = JSON.parse(await readFile(configPath, "utf8"));
+        // Trim to match the adapter's own loader (normalizeOptionalString): the
+        // server compares against the trimmed key, so an untrimmed client 401s.
+        const apiKey = typeof parsed.tui?.apiKey === "string" ? parsed.tui.apiKey.trim() : undefined;
+        return apiKey !== undefined && apiKey.length > 0 ? apiKey : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=instances.js.map

package/dist/data/instances.js.map

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

package/dist/data/replay.d.ts

@@ -0,0 +1,68 @@
+import type { RecordedRunDetail, RecordedRunListItem, RecordedRunTimelineItem, RunArtifactScope, TimelineTurn } from "@mono-agent/observability";
+export type { RecordedRunDetail, RecordedRunListItem, RecordedRunTimelineItem, TimelineTurn };
+export interface ReplayRunListItem extends RecordedRunListItem {
+    /** `source` when persisted, else {@link deriveRunSource} on `conversationId`. */
+    readonly resolvedSource: string;
+}
+export interface ListReplayRunsOptions {
+    /** Display cap on the returned run list (default 200). */
+    readonly maxRuns?: number;
+    /** When set, keep only runs whose `resolvedSource` matches exactly. */
+    readonly sourceFilter?: string;
+}
+export interface ListReplayRunsResult {
+    readonly runs: readonly ReplayRunListItem[];
+    readonly warnings: readonly string[];
+    /** Total runs found in the artifact dir, independent of `sourceFilter`/`maxRuns`. */
+    readonly totalRuns: number;
+}
+/**
+ * Newest-first recorded runs read straight from the agent's artifact dir.
+ *
+ * @param options - Either a {@link ListReplayRunsOptions} object, or (legacy
+ * back-compat form, kept for published-API callers predating `sourceFilter`)
+ * a bare `number` treated as `{ maxRuns: number }`.
+ */
+export declare function listReplayRuns(artifactDir: string, options?: number | ListReplayRunsOptions): Promise<ListReplayRunsResult>;
+/** Per-item replay annotations layered onto the coalesced timeline. */
+export interface ReplayTimelineItem extends RecordedRunTimelineItem {
+    /** `item.timestamp` parsed to epoch ms; undefined when absent/unparseable. */
+    readonly timestampMs?: number;
+    /**
+     * `timestampMs` minus the PREVIOUS timeline item's END (its `endTimestampMs`
+     * when parseable, else its own `timestampMs`) — anchoring on the previous
+     * item's end rather than its start matters for a coalesced group (e.g. a
+     * multi-chunk thinking block), whose start can be well before the moment it
+     * actually finished. Undefined for the first item, or when either side
+     * lacks a timestamp. Negative values (clock skew) are clamped to 0.
+     */
+    readonly deltaMs?: number;
+    /** Which {@link TimelineTurn.turnIndex} (from segmentTimelineTurns) this item belongs to. */
+    readonly turnIndex: number;
+}
+/** Fallback run-level model/effort/override metadata parsed from a `run_config` event. */
+export interface ReplayRunConfig {
+    readonly model?: string;
+    readonly effort?: string;
+    readonly overridden?: boolean;
+}
+export interface ReplayRunDetail {
+    readonly detail: RecordedRunDetail;
+    /** Coalesced timeline: streamed assistant/thinking deltas merged into one item each. */
+    readonly timeline: readonly ReplayTimelineItem[];
+    /** Agent-loop turns segmented from `timeline` (see segmentTimelineTurns); durationMs clamped to >= 0. */
+    readonly turns: readonly TimelineTurn[];
+    /**
+     * The run's LAST `run_config` event, when the run emitted one. A run can
+     * double-fire this event on a session-resume-retry; the last one reflects
+     * the actually-used configuration.
+     */
+    readonly runConfig?: ReplayRunConfig;
+    /** Resolved effort: `detail.summary.effort` when present, else `runConfig?.effort`. */
+    readonly effort?: string;
+}
+export interface ReadReplayRunOptions {
+    readonly scope?: RunArtifactScope;
+}
+export declare function readReplayRun(artifactDir: string, runId: string, options?: ReadReplayRunOptions): Promise<ReplayRunDetail | undefined>;
+//# sourceMappingURL=replay.d.ts.map

package/dist/data/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/data/replay.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,iBAAiB,EAEjB,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,YAAY,EACb,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,YAAY,EAAE,CAAC;AAkB9F,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D,iFAAiF;IACjF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,qFAAqF;IACrF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,MAAM,GAAG,qBAA0B,GAC3C,OAAO,CAAC,oBAAoB,CAAC,CA4B/B;AAED,uEAAuE;AACvE,MAAM,WAAW,kBAAmB,SAAQ,uBAAuB;IACjE,8EAA8E;IAC9E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,6FAA6F;IAC7F,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,0FAA0F;AAC1F,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACjD,yGAAyG;IACzG,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,eAAe,CAAC;IACrC,uFAAuF;IACvF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;CACnC;AAED,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAsBtC"}

package/dist/data/replay.js

@@ -0,0 +1,149 @@
+import { combineRecordedRunEvents, deriveRunSource, listRecordedRuns, readRecordedRun, segmentTimelineTurns, } from "@mono-agent/observability";
+const DEFAULT_MAX_RUNS = 200;
+// When `sourceFilter` narrows the result, we widen the underlying read past
+// the display cap so a rare source isn't starved by a naive cap-then-filter
+// ordering (a source with few runs could be entirely outside the top 200
+// newest runs even though it has matches further back). Filtering happens
+// AFTER this wider read and BEFORE the final `maxRuns` slice below.
+const FILTERED_READ_CEILING = 500;
+// observability's own default (~4096 bytes, see DEFAULT_MAX_STRING_BYTES in
+// @mono-agent/observability/src/guards.ts) is tuned for compact summaries and
+// guts tool/message payload expansion in the replay detail view. Replay needs
+// to show the (redacted) payload in full for drill-down, so it asks for a
+// much larger cap.
+const REPLAY_MAX_STRING_BYTES = 32_768;
+/**
+ * Newest-first recorded runs read straight from the agent's artifact dir.
+ *
+ * @param options - Either a {@link ListReplayRunsOptions} object, or (legacy
+ * back-compat form, kept for published-API callers predating `sourceFilter`)
+ * a bare `number` treated as `{ maxRuns: number }`.
+ */
+export async function listReplayRuns(artifactDir, options = {}) {
+    const normalized = typeof options === "number" ? { maxRuns: options } : options;
+    const maxRuns = normalized.maxRuns ?? DEFAULT_MAX_RUNS;
+    // Fast path (no filter): read exactly what we'll show, same as before.
+    // Filtering path: read the wider ceiling so filtering doesn't get starved
+    // by a cap applied before we even know what matches.
+    const readCeiling = normalized.sourceFilter === undefined ? maxRuns : Math.max(maxRuns, FILTERED_READ_CEILING);
+    const scope = replayScopeForSourceFilter(normalized.sourceFilter);
+    const result = await listRecordedRuns({
+        artifactDir,
+        maxRuns: readCeiling,
+        ...(scope === undefined ? {} : { scope }),
+    });
+    const resolved = result.runs.map((run) => ({
+        ...run,
+        resolvedSource: run.source ?? deriveRunSource(run.conversationId),
+    }));
+    const filtered = normalized.sourceFilter === undefined
+        ? resolved
+        : resolved.filter((run) => run.resolvedSource === normalized.sourceFilter);
+    return {
+        runs: filtered.slice(0, maxRuns),
+        warnings: result.warnings,
+        totalRuns: result.totalRuns,
+    };
+}
+export async function readReplayRun(artifactDir, runId, options = {}) {
+    const scope = options.scope ?? "agent";
+    const detail = await readRecordedRun({
+        artifactDir,
+        maxStringBytes: REPLAY_MAX_STRING_BYTES,
+        scope,
+    }, runId);
+    if (detail === undefined) {
+        return undefined;
+    }
+    const coalesced = combineRecordedRunEvents(detail.events);
+    const turns = segmentTimelineTurns(coalesced).map(clampTurnDuration);
+    const timeline = annotateTimeline(coalesced, turns);
+    const runConfig = lastRunConfig(detail.events);
+    const effort = detail.summary.effort ?? runConfig?.effort;
+    return {
+        detail,
+        timeline,
+        turns,
+        ...(runConfig === undefined ? {} : { runConfig }),
+        ...(effort === undefined ? {} : { effort }),
+    };
+}
+function replayScopeForSourceFilter(sourceFilter) {
+    if (sourceFilter === "memory") {
+        return "memory";
+    }
+    return undefined;
+}
+/**
+ * `TimelineTurn.durationMs` is derived from raw event timestamps and can go
+ * negative under clock skew (e.g. a resumed session). We clamp to 0 rather
+ * than dropping to undefined: consumers treat `durationMs` as "elapsed time
+ * for this turn" and a defined-but-zero value is easier to render (e.g. in a
+ * duration column) than an extra undefined-check, at the cost of slightly
+ * under-reporting the (already-untrustworthy) skewed turn.
+ */
+function clampTurnDuration(turn) {
+    if (turn.durationMs === undefined || turn.durationMs >= 0) {
+        return turn;
+    }
+    return { ...turn, durationMs: 0 };
+}
+function annotateTimeline(items, turns) {
+    const turnIndexByItem = buildTurnIndexLookup(turns, items.length);
+    // Anchored on the previous item's END (its own endTimestamp when parseable,
+    // else its timestamp) rather than its START — see the deltaMs doc comment.
+    let previousEndMs;
+    return items.map((item, index) => {
+        const timestampMs = parseTimestampMs(item.timestamp);
+        const endTimestampMs = parseTimestampMs(item.endTimestamp) ?? timestampMs;
+        const deltaMs = previousEndMs === undefined || timestampMs === undefined ? undefined : Math.max(0, timestampMs - previousEndMs);
+        previousEndMs = endTimestampMs;
+        return {
+            ...item,
+            ...(timestampMs === undefined ? {} : { timestampMs }),
+            ...(deltaMs === undefined ? {} : { deltaMs }),
+            turnIndex: turnIndexByItem[index] ?? 0,
+        };
+    });
+}
+function buildTurnIndexLookup(turns, itemCount) {
+    const lookup = new Array(itemCount).fill(0);
+    for (const turn of turns) {
+        for (let index = turn.startItemIndex; index <= turn.endItemIndex; index += 1) {
+            lookup[index] = turn.turnIndex;
+        }
+    }
+    return lookup;
+}
+function parseTimestampMs(timestamp) {
+    if (timestamp === undefined) {
+        return undefined;
+    }
+    const ms = Date.parse(timestamp);
+    return Number.isFinite(ms) ? ms : undefined;
+}
+/**
+ * Scan the run's RAW events (not the coalesced timeline) for `run_config`
+ * events and return the LAST one's fields. The harness can double-fire this
+ * event on a session-resume-retry within a single run; the last occurrence
+ * reflects the configuration actually used.
+ */
+function lastRunConfig(events) {
+    let found;
+    for (const event of events) {
+        if (event.type !== "run_config" || !isRecord(event.payload)) {
+            continue;
+        }
+        const payload = event.payload;
+        found = {
+            ...(typeof payload.model === "string" ? { model: payload.model } : {}),
+            ...(typeof payload.effort === "string" ? { effort: payload.effort } : {}),
+            ...(typeof payload.overridden === "boolean" ? { overridden: payload.overridden } : {}),
+        };
+    }
+    return found;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=replay.js.map

package/dist/data/replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.js","sourceRoot":"","sources":["../../src/data/replay.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AAYnC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B,4EAA4E;AAC5E,4EAA4E;AAC5E,yEAAyE;AACzE,0EAA0E;AAC1E,oEAAoE;AACpE,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAElC,4EAA4E;AAC5E,8EAA8E;AAC9E,8EAA8E;AAC9E,0EAA0E;AAC1E,mBAAmB;AACnB,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAqBvC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,WAAmB,EACnB,UAA0C,EAAE;IAE5C,MAAM,UAAU,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IAChF,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,IAAI,gBAAgB,CAAC;IACvD,uEAAuE;IACvE,0EAA0E;IAC1E,qDAAqD;IACrD,MAAM,WAAW,GAAG,UAAU,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;IAC/G,MAAM,KAAK,GAAG,0BAA0B,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC;QACpC,WAAW;QACX,OAAO,EAAE,WAAW;QACpB,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;KAC1C,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAC9B,CAAC,GAAG,EAAqB,EAAE,CAAC,CAAC;QAC3B,GAAG,GAAG;QACN,cAAc,EAAE,GAAG,CAAC,MAAM,IAAI,eAAe,CAAC,GAAG,CAAC,cAAc,CAAC;KAClE,CAAC,CACH,CAAC;IACF,MAAM,QAAQ,GACZ,UAAU,CAAC,YAAY,KAAK,SAAS;QACnC,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,cAAc,KAAK,UAAU,CAAC,YAAY,CAAC,CAAC;IAC/E,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC;QAChC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC;AACJ,CAAC;AA8CD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,WAAmB,EACnB,KAAa,EACb,UAAgC,EAAE;IAElC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC;IACvC,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC;QACnC,WAAW;QACX,cAAc,EAAE,uBAAuB;QACvC,KAAK;KACN,EAAE,KAAK,CAAC,CAAC;IACV,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,SAAS,GAAG,wBAAwB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,SAAS,EAAE,MAAM,CAAC;IAC1D,OAAO;QACL,MAAM;QACN,QAAQ;QACR,KAAK;QACL,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;QACjD,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B,CAAC,YAAgC;IAClE,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,iBAAiB,CAAC,IAAkB;IAC3C,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,gBAAgB,CACvB,KAAyC,EACzC,KAA8B;IAE9B,MAAM,eAAe,GAAG,oBAAoB,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAClE,4EAA4E;IAC5E,2EAA2E;IAC3E,IAAI,aAAiC,CAAC;IACtC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC/B,MAAM,WAAW,GAAG,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrD,MAAM,cAAc,GAAG,gBAAgB,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,WAAW,CAAC;QAC1E,MAAM,OAAO,GACX,aAAa,KAAK,SAAS,IAAI,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,CAAC;QAClH,aAAa,GAAG,cAAc,CAAC;QAC/B,OAAO;YACL,GAAG,IAAI;YACP,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;YACrD,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;YAC7C,SAAS,EAAE,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC;SACvC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,oBAAoB,CAAC,KAA8B,EAAE,SAAiB;IAC7E,MAAM,MAAM,GAAG,IAAI,KAAK,CAAS,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,IAAI,KAAK,GAAG,IAAI,CAAC,cAAc,EAAE,KAAK,IAAI,IAAI,CAAC,YAAY,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAC7E,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,SAA6B;IACrD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,SAAS,aAAa,CAAC,MAAmC;IACxD,IAAI,KAAkC,CAAC;IACvC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5D,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC9B,KAAK,GAAG;YACN,GAAG,CAAC,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,GAAG,CAAC,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,GAAG,CAAC,OAAO,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvF,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/index.d.ts

@@ -2,18 +2,18 @@ export type { AgentMessageStreamLike, AgentRequestLike, AgentResponderLike, Agen
 export { TuiAgentCancelledError, isTuiAgentCancelledError, } from "./agent/responder.js";
 export type { CreateInMemoryTuiHistoryOptions, TuiHistoryMessage, TuiHistoryRole, TuiHistoryStatus, TuiHistoryStore, } from "./agent/history.js";
 export { createInMemoryTuiHistory } from "./agent/history.js";
-export type { TuiInkMessageStreamOptions, TuiStreamState, } from "./agent/message-stream.js";
-export { TuiInkMessageStream } from "./agent/message-stream.js";
-export type { ChatPaneProps } from "./components/ChatPane.js";
-export { ChatPane } from "./components/ChatPane.js";
-export type { HistoryPaneProps } from "./components/HistoryPane.js";
-export { HistoryPane } from "./components/HistoryPane.js";
-export type { ConfigPaneProps } from "./components/ConfigPane.js";
-export { ConfigPane } from "./components/ConfigPane.js";
 export type { BuildTuiConfigSummaryInput, TuiConfigFieldSource, TuiConfigFieldSummary, TuiConfigSummarySection, } from "./config/pane.js";
 export { buildTuiConfigSummary } from "./config/pane.js";
-export type { TuiAppConfigPaneOptions, TuiAppLogger, TuiAppProps, TuiPaneId, } from "./components/TuiApp.js";
-export { TuiApp } from "./components/TuiApp.js";
+export { RemoteAgentResponder, RemoteAgentResponderError } from "./remote/client.js";
+export type { RemoteAgentResponderOptions } from "./remote/client.js";
+export { defaultTraceRegistryDir, discoverInstances, resolveInstanceApiKey, toInstance, } from "./data/instances.js";
+export type { DiscoverInstancesOptions, DiscoveredInstance, TraceSourceListItem, } from "./data/instances.js";
+export { listReplayRuns, readReplayRun } from "./data/replay.js";
+export type { ListReplayRunsOptions, ListReplayRunsResult, ReplayRunConfig, ReplayRunDetail, ReplayRunListItem, ReplayTimelineItem, TimelineTurn, } from "./data/replay.js";
+export { TurnPresenter } from "./ui/turn-presenter.js";
+export type { TurnPresenterOptions } from "./ui/turn-presenter.js";
+export { MonoAgentTuiApp } from "./ui/app.js";
+export type { MonoAgentTuiAppOptions, TuiAppLogger, TuiViewId } from "./ui/app.js";
 export type { StartMonoAgentTuiHandle, StartMonoAgentTuiOptions, } from "./runtime/start.js";
 export { startMonoAgentTui } from "./runtime/start.js";
 export { TUI_PACKAGE_VERSION } from "./runtime/version.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,+BAA+B,EAC/B,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,YAAY,EACV,0BAA0B,EAC1B,cAAc,GACf,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,YAAY,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD,YAAY,EACV,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,YAAY,EACV,uBAAuB,EACvB,YAAY,EACZ,WAAW,EACX,SAAS,GACV,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAEhD,YAAY,EACV,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,+BAA+B,EAC/B,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,YAAY,EACV,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AACrF,YAAY,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,UAAU,GACX,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjE,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEnE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,sBAAsB,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEnF,YAAY,EACV,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -1,11 +1,11 @@
 export { TuiAgentCancelledError, isTuiAgentCancelledError, } from "./agent/responder.js";
 export { createInMemoryTuiHistory } from "./agent/history.js";
-export { TuiInkMessageStream } from "./agent/message-stream.js";
-export { ChatPane } from "./components/ChatPane.js";
-export { HistoryPane } from "./components/HistoryPane.js";
-export { ConfigPane } from "./components/ConfigPane.js";
 export { buildTuiConfigSummary } from "./config/pane.js";
-export { TuiApp } from "./components/TuiApp.js";
+export { RemoteAgentResponder, RemoteAgentResponderError } from "./remote/client.js";
+export { defaultTraceRegistryDir, discoverInstances, resolveInstanceApiKey, toInstance, } from "./data/instances.js";
+export { listReplayRuns, readReplayRun } from "./data/replay.js";
+export { TurnPresenter } from "./ui/turn-presenter.js";
+export { MonoAgentTuiApp } from "./ui/app.js";
 export { startMonoAgentTui } from "./runtime/start.js";
 export { TUI_PACKAGE_VERSION } from "./runtime/version.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAS9B,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAM9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGhE,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGpD,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG1D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAQxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAQzD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAMhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAS9B,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAQ9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAGrF,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,UAAU,GACX,MAAM,qBAAqB,CAAC;AAO7B,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAWjE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAO9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/remote/client.d.ts

@@ -0,0 +1,44 @@
+import { type AgentMessageStream, type AgentRequestBase, type AgentResponder, type AgentResponse } from "@mono-agent/agent-contracts";
+export interface RemoteAgentResponderOptions {
+    /** The running agent's operator-adapter TUI base URL, e.g. http://127.0.0.1:52341/tui */
+    readonly baseUrl: string;
+    readonly apiKey?: string;
+    readonly fetchImpl?: typeof fetch;
+}
+export declare class RemoteAgentResponderError extends Error {
+    readonly code?: string;
+    constructor(message: string, code?: string);
+}
+/**
+ * AgentResponder over the operator-adapter TUI NDJSON wire: one POST per turn, each
+ * received frame replayed onto the local AgentMessageStream in order. Because
+ * it implements the same contract as an in-process responder, every UI surface
+ * works identically in embedded (`--responder`) and remote (`mono-agent tui`)
+ * modes.
+ */
+export declare class RemoteAgentResponder implements AgentResponder {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly fetchImpl;
+    constructor(options: RemoteAgentResponderOptions);
+    private headers;
+    /** Probe GET /v1/info; throws RemoteAgentResponderError when unreachable/unauthorized. */
+    info(): Promise<{
+        schema: number;
+        pid?: number;
+        label?: string;
+        model?: string;
+        effort?: string;
+        models?: readonly string[];
+        modelOptions?: Record<string, {
+            effortLevels?: readonly string[];
+            reasoning?: boolean;
+            reasoningMode?: string;
+            label?: string;
+        }>;
+    }>;
+    respond(request: AgentRequestBase, stream: AgentMessageStream): Promise<AgentResponse>;
+    cancel(conversationId: string): void;
+    private request;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/remote/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/remote/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,2BAA2B;IAC1C,yFAAyF;IACzF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CACnC;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAO3C;AAED;;;;;;GAMG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAE7B,OAAO,EAAE,2BAA2B;IAMhD,OAAO,CAAC,OAAO;IAOf,0FAA0F;IACpF,IAAI,IAAI,OAAO,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAC3B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;YAAC,SAAS,CAAC,EAAE,OAAO,CAAC;YAAC,aAAa,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAClI,CAAC;IA8BI,OAAO,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;IA6D5F,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;YAQtB,OAAO;CAsBtB"}