@voybio/ace-swarm 0.1.0

package/dist/tui/telemetry.js

@@ -0,0 +1,106 @@
+/**
+ * ACE-TUI Telemetry
+ *
+ * Token counting, throughput measurement, and cost estimation.
+ */
+// ── Telemetry tracker ────────────────────────────────────────────────
+export class TelemetryTracker {
+    tokensIn = 0;
+    tokensOut = 0;
+    requestCount = 0;
+    totalLatencyMs = 0;
+    startTime;
+    model = "";
+    contextMax = 8192;
+    contextUsed = 0;
+    // Rolling window for tokens/sec calculation
+    recentTokens = [];
+    windowMs = 10_000; // 10-second rolling window
+    constructor() {
+        this.startTime = Date.now();
+    }
+    /** Record a completed request */
+    recordRequest(telemetry) {
+        this.tokensIn += telemetry.promptTokens;
+        this.tokensOut += telemetry.completionTokens;
+        this.requestCount++;
+        this.totalLatencyMs += telemetry.endTime - telemetry.startTime;
+        this.model = telemetry.model;
+        // Add to rolling window
+        this.recentTokens.push({
+            time: telemetry.endTime,
+            count: telemetry.completionTokens,
+        });
+        this.pruneWindow();
+    }
+    /** Record incremental tokens (for streaming) */
+    recordTokens(input, output) {
+        this.tokensIn += input;
+        this.tokensOut += output;
+        if (output > 0) {
+            this.recentTokens.push({ time: Date.now(), count: output });
+            this.pruneWindow();
+        }
+    }
+    /** Update context window info */
+    setContext(used, max) {
+        this.contextUsed = used;
+        this.contextMax = max;
+    }
+    setModel(name) {
+        this.model = name;
+    }
+    /** Get current snapshot */
+    getSnapshot() {
+        this.pruneWindow();
+        return {
+            tokensIn: this.tokensIn,
+            tokensOut: this.tokensOut,
+            totalTokens: this.tokensIn + this.tokensOut,
+            tokensPerSec: this.calculateThroughput(),
+            requestCount: this.requestCount,
+            avgLatencyMs: this.requestCount > 0 ? this.totalLatencyMs / this.requestCount : 0,
+            costEstimate: this.estimateCost(),
+            uptime: Date.now() - this.startTime,
+            modelName: this.model,
+            contextUsed: this.contextUsed,
+            contextMax: this.contextMax,
+        };
+    }
+    /** Reset all counters */
+    reset() {
+        this.tokensIn = 0;
+        this.tokensOut = 0;
+        this.requestCount = 0;
+        this.totalLatencyMs = 0;
+        this.recentTokens = [];
+        this.startTime = Date.now();
+    }
+    // ── Internal ─────────────────────────────────────────────────────
+    pruneWindow() {
+        const cutoff = Date.now() - this.windowMs;
+        this.recentTokens = this.recentTokens.filter(t => t.time > cutoff);
+    }
+    calculateThroughput() {
+        if (this.recentTokens.length < 2)
+            return 0;
+        const totalTokens = this.recentTokens.reduce((sum, t) => sum + t.count, 0);
+        const timeSpan = this.recentTokens[this.recentTokens.length - 1].time - this.recentTokens[0].time;
+        if (timeSpan <= 0)
+            return 0;
+        return (totalTokens / timeSpan) * 1000; // tokens per second
+    }
+    /** Estimate cost — Ollama is free, but show equivalent cloud cost for reference */
+    estimateCost() {
+        // Using GPT-4o-mini pricing as reference: $0.15/1M input, $0.60/1M output
+        const inputCost = (this.tokensIn / 1_000_000) * 0.15;
+        const outputCost = (this.tokensOut / 1_000_000) * 0.60;
+        return inputCost + outputCost;
+    }
+}
+/** Rough token count estimation (for when Ollama doesn't return counts) */
+export function estimateTokenCount(text) {
+    // Rough heuristic: ~4 chars per token for English text
+    return Math.ceil(text.length / 4);
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/vericify-bridge.d.ts

@@ -0,0 +1,146 @@
+import { type ValidationResult } from "./schemas.js";
+export declare const VERICIFY_PROCESS_POST_LOG_REL_PATH = "agent-state/vericify/process-posts.json";
+export declare const VERICIFY_PROCESS_POST_LOG_SCHEMA_REL_PATH = "agent-state/MODULES/schemas/VERICIFY_PROCESS_POST_LOG.schema.json";
+export declare const VERICIFY_PROCESS_POST_LOG_SCHEMA_NAME = "vericify-process-post-log@1.0.0";
+export declare const VERICIFY_BRIDGE_SNAPSHOT_REL_PATH = "agent-state/vericify/ace-bridge.json";
+export declare const VERICIFY_BRIDGE_SNAPSHOT_SCHEMA_REL_PATH = "agent-state/MODULES/schemas/VERICIFY_BRIDGE_SNAPSHOT.schema.json";
+export declare const VERICIFY_BRIDGE_SNAPSHOT_SCHEMA_NAME = "vericify-bridge-snapshot@1.0.0";
+type VericifyProcessPostKind = "intent" | "progress" | "blocker" | "handoff_note" | "stale_ack" | "completion";
+export interface VericifyProcessPost {
+    process_post_id: string;
+    run_id: string;
+    branch_id?: string;
+    lane_id?: string;
+    agent_id: string;
+    kind: VericifyProcessPostKind;
+    summary: string;
+    tool_refs: string[];
+    evidence_refs: string[];
+    checkpoint_ref?: string;
+    timestamp: string;
+}
+export interface VericifyProcessPostLog {
+    version: 1;
+    updated_at: string;
+    posts: VericifyProcessPost[];
+}
+export interface VericifyBridgeSourceState {
+    path: string;
+    exists: boolean;
+    updated_at?: string;
+    record_count: number;
+    summary: string;
+}
+export interface VericifyRunRef {
+    run_id: string;
+    branch_id: string;
+    lane_id: string;
+}
+export interface VericifyBridgeActiveRunRef extends VericifyRunRef {
+    session_id: string;
+    status: string;
+    objective_id?: string;
+    tracker_item_id?: string;
+    workspace_path: string;
+    updated_at: string;
+}
+interface ExecutorRegistrySessionLike {
+    session_id: string;
+    status: string;
+    objective_id?: string;
+    tracker_item_id?: string;
+    workspace_path: string;
+    updated_at: string;
+}
+export interface VericifyBridgeSnapshot {
+    version: 1;
+    generated_at: string;
+    bridge_enabled: boolean;
+    workspace_root: string;
+    runtime_profile_path: string;
+    bridge_path: string;
+    process_post_path: string;
+    sources: {
+        handoff_registry: VericifyBridgeSourceState;
+        todo_state: VericifyBridgeSourceState;
+        run_ledger: VericifyBridgeSourceState;
+        status_events: VericifyBridgeSourceState;
+        runtime_workspaces: VericifyBridgeSourceState;
+        runtime_executor_sessions: VericifyBridgeSourceState;
+        tracker_snapshot: VericifyBridgeSourceState;
+        process_posts: VericifyBridgeSourceState;
+    };
+    active_run_refs: VericifyBridgeActiveRunRef[];
+}
+export interface VericifyBridgeSnapshotResult {
+    ok: boolean;
+    schema: typeof VERICIFY_BRIDGE_SNAPSHOT_SCHEMA_NAME;
+    path: string;
+    snapshot?: VericifyBridgeSnapshot;
+    errors?: string[];
+}
+export declare function deriveVericifyRunRef(session: Pick<ExecutorRegistrySessionLike, "session_id" | "objective_id">): VericifyRunRef;
+export declare function deriveWorkspaceVericifyRunRef(input: {
+    session_id: string;
+    role?: string;
+}): VericifyRunRef;
+export declare function isVericifyBridgeEnabled(): boolean;
+export declare function getVericifyProcessPostLogPath(): string;
+export declare function getVericifyBridgeSnapshotPath(): string;
+export declare function validateVericifyProcessPostLogContent(raw: string): ValidationResult;
+export declare function validateVericifyBridgeSnapshotContent(raw: string): ValidationResult;
+export declare function loadVericifyProcessPostLog(): {
+    ok: boolean;
+    schema: typeof VERICIFY_PROCESS_POST_LOG_SCHEMA_NAME;
+    path: string;
+    log?: VericifyProcessPostLog;
+    errors?: string[];
+};
+export declare function loadVericifyBridgeSnapshot(): VericifyBridgeSnapshotResult;
+export declare function appendVericifyProcessPost(input: {
+    run_id: string;
+    branch_id?: string;
+    lane_id?: string;
+    agent_id: string;
+    kind: VericifyProcessPostKind;
+    summary: string;
+    tool_refs?: string[];
+    evidence_refs?: string[];
+    checkpoint_ref?: string;
+    timestamp?: string;
+}): Promise<{
+    path: string;
+    post: VericifyProcessPost;
+}>;
+export declare function appendVericifyProcessPostSafe(input: {
+    run_id: string;
+    branch_id?: string;
+    lane_id?: string;
+    agent_id: string;
+    kind: VericifyProcessPostKind;
+    summary: string;
+    tool_refs?: string[];
+    evidence_refs?: string[];
+    checkpoint_ref?: string;
+    timestamp?: string;
+}): Promise<{
+    ok: boolean;
+    path: string;
+    post?: VericifyProcessPost;
+    error?: string;
+}>;
+export declare function buildVericifyBridgeSnapshot(): VericifyBridgeSnapshot;
+export declare function refreshVericifyBridgeSnapshot(): {
+    ok: boolean;
+    path: string;
+    snapshot?: VericifyBridgeSnapshot;
+    error?: string;
+};
+export declare function refreshVericifyBridgeSnapshotSafe(): {
+    ok: boolean;
+    path: string;
+    snapshot?: VericifyBridgeSnapshot;
+    error?: string;
+};
+export {};
+//# sourceMappingURL=vericify-bridge.d.ts.map