lorenz 0.1.0

package/packages/tracker-sdk/dist/provider.d.ts

@@ -0,0 +1,104 @@
+import type { Issue, RuntimeTrackerClient, Settings } from "@lorenz/domain";
+/** Ambient dependencies handed to provider hooks that must not touch process globals directly. */
+export interface TrackerContext {
+    env: NodeJS.ProcessEnv;
+    /**
+     * Config-layer secret resolution (`$VAR` and `op://` references, with an optional env-var
+     * fallback) for provider option values. Present when invoked by the config parser.
+     */
+    resolveSecret?: (value: string | undefined, fallbackEnvVar?: string) => string | undefined;
+}
+/** Dependencies for building the normalized tool operations of one tracker. */
+export interface TrackerOpsContext {
+    fetchImpl: typeof fetch;
+}
+/** Input accepted by {@link TrackerToolOps.createIssue}. */
+export interface TrackerCreateIssueInput {
+    title: string;
+    body?: string | undefined;
+    status?: string | undefined;
+    /** Tracker user identity to assign the created issue to when the backend supports assignment. */
+    assignee?: string | undefined;
+}
+/** Natively projected query payload returned by {@link TrackerToolOps.queryRows}. */
+export interface TrackerQueryResult {
+    rows: Array<Record<string, unknown>>;
+    total: number;
+    skipped?: unknown[] | undefined;
+}
+/**
+ * Normalized issue operations backing the provider-neutral `tracker_*` tool pack. Every
+ * member is optional: a missing member makes the corresponding tool report itself as
+ * unsupported for this tracker instead of failing mid-call.
+ *
+ * Backends that filter and project natively (e.g. the local board's query DSL) implement
+ * {@link queryRows}; backends that return whole issues implement {@link queryIssues} and let
+ * the pack project rows with the shared select/filter helpers.
+ */
+export interface TrackerToolOps {
+    readIssue?(issueId: string): Promise<Issue>;
+    /** Issues matching generic query args (`issueIds`, `states`, provider-native queries such as `jql`). */
+    queryIssues?(args: Record<string, unknown>): Promise<Issue[]>;
+    /** Pre-projected rows for backends with a native query surface; takes precedence over {@link queryIssues}. */
+    queryRows?(args: Record<string, unknown>): Promise<TrackerQueryResult>;
+    updateStatus?(issueId: string, status: string): Promise<Issue>;
+    addComment?(issueId: string, body: string): Promise<void>;
+    createIssue?(input: TrackerCreateIssueInput): Promise<Issue>;
+}
+/**
+ * Everything Symphony needs to know about one issue-tracker backend, bundled as a single
+ * extension point. A provider owns its slice of the selected tracker bundle, the runtime
+ * client that feeds issues into dispatch, and the normalized operations behind the
+ * provider-neutral `tracker_*` tools. Agent-facing tool packs are a separate extension
+ * point (`ToolProvider` in `@lorenz/tool-sdk`): a tracker package may ship one, declare
+ * it as a default pack for this tracker, and a workflow may still mount other registered
+ * packs explicitly through its `tools:` map.
+ *
+ * The core (config parsing, runtime, MCP server, CLI) is provider-agnostic and talks to
+ * providers exclusively through this contract via a {@link TrackerRegistry}. Adding a new
+ * tracker backend means implementing this interface in a new package and registering it at
+ * the composition root - no core package changes.
+ */
+export interface TrackerProvider {
+    /** Config selector matched against the tracker provider name (e.g. `"linear"`, `"jira"`). */
+    readonly kind: string;
+    /**
+     * snake_case → camelCase alias map for this provider's keys in the selected tracker
+     * bundle (e.g. `{ project_slug: "projectSlug" }`). Applied before {@link parseOptions}.
+     */
+    readonly configAliases?: Readonly<Record<string, string>> | undefined;
+    /**
+     * Environment variables consulted as fallbacks for shared `tracker:` fields the workflow
+     * config leaves unset, keyed by field name (e.g. `{ apiKey: "JIRA_API_KEY" }`).
+     */
+    readonly envFallbacks?: Readonly<Record<string, string>> | undefined;
+    /** Endpoint used when `tracker.endpoint` is not configured. */
+    readonly defaultEndpoint?: string | undefined;
+    /**
+     * Validate and normalize the provider-specific keys of the selected tracker bundle
+     * (aliases already applied). Called at config-parse time; throw with a `tracker.<key> ...`
+     * message on invalid input. The returned record becomes {@link Settings.tracker.options}.
+     */
+    parseOptions?(options: Record<string, unknown>, context: TrackerContext): Record<string, unknown>;
+    /**
+     * Throw when the parsed settings cannot drive dispatch (missing credentials or required
+     * options). Called once at startup by `validateDispatchConfig`.
+     */
+    validateDispatch?(settings: Settings): void;
+    /** Build the runtime client that feeds candidate issues into the dispatch loop. */
+    createClient(settings: Settings, context: TrackerContext): RuntimeTrackerClient;
+    /**
+     * Normalized operations backing the neutral `tracker_*` pack for this backend; return
+     * `undefined` (or omit the member) when the backend exposes no agent-facing operations.
+     */
+    createToolOps?(settings: Settings, context: TrackerOpsContext): TrackerToolOps | undefined;
+    /**
+     * Provider-specific tool packs mounted by default when this tracker drives dispatch.
+     * The core always mounts the neutral `tracker` pack separately; this hook declares any
+     * additional minimum packs owned by the tracker extension.
+     */
+    defaultToolPacks?(settings: Settings): readonly string[];
+    /** Operator-facing URL of the tracked project, shown in dashboards. */
+    projectUrl?(settings: Settings): string | undefined;
+}
+//# sourceMappingURL=provider.d.ts.map

package/packages/tracker-sdk/dist/provider.d.ts.map

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

package/packages/tracker-sdk/dist/provider.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider.js.map

package/packages/tracker-sdk/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":""}

package/packages/tracker-sdk/dist/registry.d.ts

@@ -0,0 +1,26 @@
+import type { Settings } from "@lorenz/domain";
+import type { TrackerProvider } from "./provider.js";
+/**
+ * Lookup table of {@link TrackerProvider}s keyed by provider name. The core resolves the
+ * configured tracker through a registry instead of hardcoding backends, so the set of
+ * supported trackers is decided by whoever composes the application.
+ */
+export declare class TrackerRegistry {
+    private readonly providers;
+    /** Register a provider. Throws when a different provider already claims the kind. */
+    register(provider: TrackerProvider): void;
+    get(kind: string | undefined): TrackerProvider | undefined;
+    /** Resolve the provider for parsed settings. */
+    providerFor(settings: Settings): TrackerProvider | undefined;
+    /** Like {@link get} but throws a config-style error listing the known kinds. */
+    require(kind: string | undefined): TrackerProvider;
+    kinds(): string[];
+}
+/**
+ * Process-wide registry used as the default by config parsing, the MCP server, and the CLI.
+ * The composition root (the CLI entrypoint, or a test) registers providers here; library
+ * code only reads from it. Call sites that need isolation can construct their own
+ * {@link TrackerRegistry} and pass it explicitly.
+ */
+export declare const defaultTrackerRegistry: TrackerRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/packages/tracker-sdk/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAEhE,qFAAqF;IACrF,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAUzC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS;IAI1D,gDAAgD;IAChD,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,eAAe,GAAG,SAAS;IAI5D,gFAAgF;IAChF,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,eAAe;IAgBlD,KAAK,IAAI,MAAM,EAAE;CAGlB;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,iBAAwB,CAAC"}

package/packages/tracker-sdk/dist/registry.js

@@ -0,0 +1,52 @@
+/**
+ * Lookup table of {@link TrackerProvider}s keyed by provider name. The core resolves the
+ * configured tracker through a registry instead of hardcoding backends, so the set of
+ * supported trackers is decided by whoever composes the application.
+ */
+export class TrackerRegistry {
+    providers = new Map();
+    /** Register a provider. Throws when a different provider already claims the kind. */
+    register(provider) {
+        const kind = provider.kind.trim();
+        if (!kind)
+            throw new Error("tracker provider kind must not be blank");
+        const existing = this.providers.get(kind);
+        if (existing && existing !== provider) {
+            throw new Error(`tracker provider already registered for kind: ${kind}`);
+        }
+        this.providers.set(kind, provider);
+    }
+    get(kind) {
+        return kind === undefined ? undefined : this.providers.get(kind);
+    }
+    /** Resolve the provider for parsed settings. */
+    providerFor(settings) {
+        return this.get(settings.tracker.kind);
+    }
+    /** Like {@link get} but throws a config-style error listing the known kinds. */
+    require(kind) {
+        if (kind === undefined || kind === null || kind === "") {
+            throw new Error("tracker.kind is required");
+        }
+        const provider = this.providers.get(kind);
+        if (!provider) {
+            const known = this.kinds();
+            const hint = known.length > 0
+                ? ` (known kinds: ${known.join(", ")})`
+                : " (no tracker providers registered - register tracker extensions at the composition root)";
+            throw new Error(`unsupported tracker.kind: ${kind}${hint}`);
+        }
+        return provider;
+    }
+    kinds() {
+        return [...this.providers.keys()].sort();
+    }
+}
+/**
+ * Process-wide registry used as the default by config parsing, the MCP server, and the CLI.
+ * The composition root (the CLI entrypoint, or a test) registers providers here; library
+ * code only reads from it. Call sites that need isolation can construct their own
+ * {@link TrackerRegistry} and pass it explicitly.
+ */
+export const defaultTrackerRegistry = new TrackerRegistry();
+//# sourceMappingURL=registry.js.map

package/packages/tracker-sdk/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,OAAO,eAAe;IACT,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEhE,qFAAqF;IACrF,QAAQ,CAAC,QAAyB;QAChC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,QAAQ,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,iDAAiD,IAAI,EAAE,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,GAAG,CAAC,IAAwB;QAC1B,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnE,CAAC;IAED,gDAAgD;IAChD,WAAW,CAAC,QAAkB;QAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,gFAAgF;IAChF,OAAO,CAAC,IAAwB;QAC9B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3B,MAAM,IAAI,GACR,KAAK,CAAC,MAAM,GAAG,CAAC;gBACd,CAAC,CAAC,kBAAkB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;gBACvC,CAAC,CAAC,0FAA0F,CAAC;YACjG,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK;QACH,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,eAAe,EAAE,CAAC"}

package/packages/tracker-sdk/dist/toolPack.d.ts

@@ -0,0 +1,10 @@
+import { type ToolProvider } from "@lorenz/tool-sdk";
+import type { TrackerRegistry } from "./registry.js";
+/**
+ * The provider-neutral `tracker` tool pack: one set of `tracker_*` tools that works against
+ * whichever tracker drives dispatch, implemented purely over the provider's normalized
+ * {@link TrackerToolOps}. Backends without tool operations (e.g. the in-process memory
+ * fixture) advertise no tools and fail any direct call with a clear message.
+ */
+export declare function createTrackerToolProvider(trackers: TrackerRegistry): ToolProvider;
+//# sourceMappingURL=toolPack.d.ts.map

package/packages/tracker-sdk/dist/toolPack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolPack.d.ts","sourceRoot":"","sources":["../src/toolPack.ts"],"names":[],"mappings":"AACA,OAAO,EAQL,KAAK,YAAY,EAGlB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAarD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,eAAe,GAAG,YAAY,CAQjF"}

package/packages/tracker-sdk/dist/toolPack.js

@@ -0,0 +1,185 @@
+import { errorMessage, isRecord } from "@lorenz/domain";
+import { applyQuery, parseQuerySpec, parseSelect, pickFields, toolFailure, toolSuccess, unsupportedToolFailure, } from "@lorenz/tool-sdk";
+const TRACKER_TOOL_NAMES = [
+    "tracker_read_issue",
+    "tracker_query",
+    "tracker_update_status",
+    "tracker_comment",
+    "tracker_create_issue",
+];
+const DEFAULT_SELECT = ["id", "identifier", "title", "state", "stateType", "labels", "url"];
+/**
+ * The provider-neutral `tracker` tool pack: one set of `tracker_*` tools that works against
+ * whichever tracker drives dispatch, implemented purely over the provider's normalized
+ * {@link TrackerToolOps}. Backends without tool operations (e.g. the in-process memory
+ * fixture) advertise no tools and fail any direct call with a clear message.
+ */
+export function createTrackerToolProvider(trackers) {
+    return {
+        name: "tracker",
+        toolSpecs: (settings) => opsFor(trackers, settings, fetch) === undefined ? [] : trackerToolSpecs(),
+        executeTool: async (name, input, context) => executeTrackerTool(trackers, name, input, context.settings, context.fetchImpl),
+    };
+}
+function opsFor(trackers, settings, fetchImpl) {
+    return trackers.get(settings.tracker.kind)?.createToolOps?.(settings, { fetchImpl });
+}
+function trackerToolSpecs() {
+    return [
+        {
+            name: "tracker_read_issue",
+            description: "Read one issue from the configured tracker. Args: issueId (tracker id or key when supported).",
+            inputSchema: {
+                type: "object",
+                additionalProperties: false,
+                properties: { issueId: { type: "string" } },
+                required: ["issueId"],
+            },
+        },
+        {
+            name: "tracker_query",
+            description: "Query issues from the configured tracker. Args: states?, issueIds?, query? (native query string, for trackers with a query language), where?, select?, order_by?, limit?, offset?.",
+            inputSchema: {
+                type: "object",
+                additionalProperties: true,
+                properties: {
+                    states: { type: "array", items: { type: "string" } },
+                    issueIds: { type: "array", items: { type: "string" } },
+                    query: { type: "string" },
+                    where: { type: "object" },
+                    select: { type: "array", items: { type: "string" } },
+                    order_by: { type: "array", items: { type: "object" } },
+                    limit: { type: "number" },
+                    offset: { type: "number" },
+                },
+            },
+        },
+        {
+            name: "tracker_update_status",
+            description: "Move an issue in the configured tracker to a new status. Args: issueId, status.",
+            inputSchema: {
+                type: "object",
+                additionalProperties: false,
+                properties: { issueId: { type: "string" }, status: { type: "string" } },
+                required: ["issueId", "status"],
+            },
+        },
+        {
+            name: "tracker_comment",
+            description: "Add a comment to an issue in the configured tracker. Args: issueId, body.",
+            inputSchema: {
+                type: "object",
+                additionalProperties: false,
+                properties: { issueId: { type: "string" }, body: { type: "string" } },
+                required: ["issueId", "body"],
+            },
+        },
+        {
+            name: "tracker_create_issue",
+            description: "Create an issue in the configured tracker. Args: title, body?, status?, assignee?.",
+            inputSchema: {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    title: { type: "string" },
+                    body: { type: "string" },
+                    status: { type: "string" },
+                    assignee: { type: "string" },
+                },
+                required: ["title"],
+            },
+        },
+    ];
+}
+async function executeTrackerTool(trackers, name, input, settings, fetchImpl) {
+    if (!isTrackerToolName(name))
+        return unsupportedToolFailure(name, TRACKER_TOOL_NAMES);
+    const args = isRecord(input) ? input : {};
+    const ops = opsFor(trackers, settings, fetchImpl);
+    try {
+        switch (name) {
+            case "tracker_read_issue": {
+                const issueId = requireStr(args, "issueId");
+                if (!ops?.readIssue)
+                    return unavailableFailure(settings);
+                return toolSuccess({ issue: await ops.readIssue(issueId) });
+            }
+            case "tracker_query":
+                return await queryTrackerRows(ops, settings, args);
+            case "tracker_update_status": {
+                const issueId = requireStr(args, "issueId");
+                const status = requireStr(args, "status");
+                if (!ops?.updateStatus)
+                    return unavailableFailure(settings);
+                return toolSuccess({ issue: await ops.updateStatus(issueId, status) });
+            }
+            case "tracker_comment": {
+                const issueId = requireStr(args, "issueId");
+                const body = requireStr(args, "body");
+                if (!ops?.addComment)
+                    return unavailableFailure(settings);
+                await ops.addComment(issueId, body);
+                return toolSuccess({ ok: true });
+            }
+            case "tracker_create_issue": {
+                const create = {
+                    title: requireStr(args, "title"),
+                    body: optStr(args.body),
+                    status: optStr(args.status),
+                    assignee: optStr(args.assignee),
+                };
+                if (!ops?.createIssue)
+                    return unavailableFailure(settings);
+                return toolSuccess({ issue: await ops.createIssue(create) });
+            }
+        }
+    }
+    catch (error) {
+        return toolFailure(errorMessage(error));
+    }
+}
+async function queryTrackerRows(ops, settings, args) {
+    const select = parseSelect(args.select) ?? DEFAULT_SELECT;
+    if (ops?.queryRows)
+        return toolSuccess(await ops.queryRows(args));
+    if (!ops?.queryIssues)
+        return unavailableFailure(settings);
+    return toolSuccess(projectIssues(await ops.queryIssues(args), select, args));
+}
+function unavailableFailure(settings) {
+    // An unset kind resolves to no provider, so it reports like the in-process memory fixture.
+    return toolFailure(`tracker tools are unavailable for ${settings.tracker.kind ?? "memory"} tracker`);
+}
+function isTrackerToolName(name) {
+    return TRACKER_TOOL_NAMES.includes(name);
+}
+function projectIssues(issues, select, args) {
+    const spec = parseQuerySpec(args);
+    const records = issues.map(issueRecord);
+    const { rows, total } = applyQuery(records, spec);
+    return { rows: rows.map((row) => pickFields(row, select)), total };
+}
+function issueRecord(issue) {
+    return {
+        id: issue.id,
+        identifier: issue.identifier,
+        title: issue.title,
+        description: issue.description ?? null,
+        state: issue.state,
+        stateType: issue.stateType,
+        labels: issue.labels,
+        createdAt: issue.createdAt ?? null,
+        updatedAt: issue.updatedAt ?? null,
+        url: issue.url ?? null,
+    };
+}
+function requireStr(args, key) {
+    const value = args[key];
+    if (typeof value !== "string" || value.trim() === "")
+        throw new Error(`'${key}' is required`);
+    return value;
+}
+function optStr(value) {
+    return typeof value === "string" && value.trim() !== "" ? value : undefined;
+}
+//# sourceMappingURL=toolPack.js.map

package/packages/tracker-sdk/dist/toolPack.js.map

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

package/packages/tracker-sdk/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@lorenz/tracker-sdk",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "dependencies": {
+    "@lorenz/domain": "file:../domain",
+    "@lorenz/tool-sdk": "file:../tool-sdk"
+  }
+}

package/packages/tui/dist/index.d.ts

@@ -0,0 +1,35 @@
+import type { RuntimeSnapshot } from "@lorenz/runtime-events";
+export interface RuntimeViewSource {
+    snapshot(): RuntimeSnapshot;
+    subscribe(listener: (snapshot: RuntimeSnapshot) => void): () => void;
+}
+export { humanizeAgentMessage, humanizeCodexMessage, humanizeClaudeMessage, } from "@lorenz/humanize";
+export declare function RuntimeApp({ runtime, dashboardUrl, projectUrl, }: {
+    runtime: RuntimeViewSource;
+    dashboardUrl?: string | null | undefined;
+    projectUrl?: string | undefined;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function RuntimeDashboard({ snapshot, throughputTps, dashboardUrl, projectUrl, now, }: {
+    snapshot: RuntimeSnapshot;
+    throughputTps?: number | undefined;
+    dashboardUrl?: string | null | undefined;
+    projectUrl?: string | undefined;
+    now?: Date | string | number | undefined;
+}): import("react/jsx-runtime").JSX.Element;
+export interface TokenSample {
+    timestampMs: number;
+    totalTokens: number;
+}
+export interface DashboardFormatOptions {
+    ansi?: boolean | undefined;
+    dashboardUrl?: string | null | undefined;
+    maxAgents?: number | undefined;
+    now?: Date | string | number | undefined;
+    projectUrl?: string | undefined;
+    runtimeSeconds?: number | undefined;
+    throughputTps?: number | undefined;
+}
+export declare function formatDashboard(snapshot: RuntimeSnapshot, options?: DashboardFormatOptions): string;
+export declare function updateTokenSamples(samples: TokenSample[], nowMs: number, totalTokens: number): TokenSample[];
+export declare function rollingThroughput(samples: TokenSample[], nowMs: number, currentTokens: number): number;
+//# sourceMappingURL=index.d.ts.map

package/packages/tui/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAI9D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,IAAI,eAAe,CAAC;IAC5B,SAAS,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACtE;AAED,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,YAAY,EACZ,UAAU,GACX,EAAE;IACD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,2CAoCA;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,UAAU,EACV,GAAG,GACJ,EAAE;IACD,QAAQ,EAAE,eAAe,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,GAAG,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC1C,2CAcA;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAWD,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,GAAG,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE,sBAA2B,GACnC,MAAM,CAiDR;AAyMD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,EAAE,EACtB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAClB,WAAW,EAAE,CAEf;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,WAAW,EAAE,EACtB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,GACpB,MAAM,CAWR"}