@pellux/goodvibes-tui 0.18.13 → 0.18.18

package/src/runtime/diagnostics/panels/tool-calls.ts

@@ -1,267 +0,0 @@
-/**
- * Tool Calls diagnostic panel data provider.
- *
- * Subscribes to tool lifecycle events via the RuntimeEventBus and maintains
- * a bounded buffer of ToolCallEntry records. Provides filtered snapshots
- * for the tool-calls diagnostics panel.
- *
- * Phase timeline tracking allows the panel to render latency breakdowns
- * and highlight failures at any lifecycle phase.
- */
-import type { RuntimeEventBus, EnvelopeListener } from '@pellux/goodvibes-sdk/platform/runtime/events/index';
-import type { AnyRuntimeEvent } from '@pellux/goodvibes-sdk/platform/runtime/events/domain-map';
-import type { RuntimeEventEnvelope } from '@pellux/goodvibes-sdk/platform/runtime/events/envelope';
-import {
-  type ToolCallEntry,
-  type ToolCallPhase,
-  type DiagnosticFilter,
-  type PanelConfig,
-  DEFAULT_PANEL_CONFIG,
-  applyFilter,
-  appendBounded,
-} from '@pellux/goodvibes-sdk/platform/runtime/diagnostics/types';
-
-/** Internal mutable tool call record used while the call is in progress. */
-interface MutableToolCallRecord {
-  callId: string;
-  turnId: string;
-  tool: string;
-  args: Record<string, unknown>;
-  phase: ToolCallPhase;
-  receivedAt: number;
-  completedAt?: number;
-  durationMs?: number;
-  error?: string;
-  cancelReason?: string;
-  permissionApproved?: boolean;
-  traceId: string;
-  sessionId: string;
-}
-
-/**
- * ToolCallsPanel — diagnostic data provider for tool call telemetry.
- *
- * Listens to all tool domain events and builds a per-call timeline.
- * Completed calls are transferred to a bounded history buffer.
- */
-export class ToolCallsPanel {
-  private readonly _config: PanelConfig;
-  private readonly _eventBus: RuntimeEventBus;
-  /** Active calls keyed by callId. */
-  private readonly _active = new Map<string, MutableToolCallRecord>();
-  /** Completed call history (oldest first). */
-  private readonly _history: ToolCallEntry[] = [];
-  /** Registered change notification callbacks. */
-  private readonly _subscribers = new Set<() => void>();
-  /** Unsubscribe function returned by the event bus. */
-  private _unsub: (() => void) | null = null;
-
-  constructor(eventBus: RuntimeEventBus, config: PanelConfig = DEFAULT_PANEL_CONFIG) {
-    this._eventBus = eventBus;
-    this._config = config;
-    this._start();
-  }
-
-  /**
-   * Subscribe to the tool domain and wire up event handlers.
-   * @internal
-   */
-  private _start(): void {
-    const handler: EnvelopeListener<AnyRuntimeEvent> = (
-      envelope: RuntimeEventEnvelope<AnyRuntimeEvent['type'], AnyRuntimeEvent>
-    ) => {
-      this._handleEnvelope(envelope);
-    };
-    this._unsub = this._eventBus.onDomain('tools', handler as EnvelopeListener);
-  }
-
-  /**
-   * Handle a tool domain envelope, routing to the appropriate update method.
-   */
-  private _handleEnvelope(
-    envelope: RuntimeEventEnvelope<AnyRuntimeEvent['type'], AnyRuntimeEvent>
-  ): void {
-    const p = envelope.payload;
-    // Type narrowing is done by checking the discriminant field on payload.
-    if (!('type' in p)) return;
-    const type = (p as { type: string }).type;
-    const traceId = envelope.traceId;
-    const sessionId = envelope.sessionId;
-
-    switch (type) {
-      case 'TOOL_RECEIVED': {
-        const evt = p as { type: 'TOOL_RECEIVED'; callId: string; turnId: string; tool: string; args: Record<string, unknown> };
-        this._active.set(evt.callId, {
-          callId: evt.callId,
-          turnId: evt.turnId,
-          tool: evt.tool,
-          args: evt.args,
-          phase: 'received',
-          receivedAt: envelope.ts,
-          traceId,
-          sessionId,
-        });
-        this._notify();
-        break;
-      }
-      case 'TOOL_VALIDATED':
-      case 'TOOL_PREHOOKED':
-      case 'TOOL_EXECUTING':
-      case 'TOOL_MAPPED':
-      case 'TOOL_POSTHOOKED': {
-        const evt = p as { type: string; callId: string };
-        const phaseMap: Record<string, ToolCallPhase> = {
-          TOOL_VALIDATED: 'validated',
-          TOOL_PREHOOKED: 'prehooked',
-          TOOL_EXECUTING: 'executing',
-          TOOL_MAPPED: 'mapped',
-          TOOL_POSTHOOKED: 'posthooked',
-        };
-        const record = this._active.get(evt.callId);
-        if (record) {
-          record.phase = phaseMap[type]!;
-          this._notify();
-        }
-        break;
-      }
-      case 'TOOL_PERMISSIONED': {
-        const evt = p as { type: 'TOOL_PERMISSIONED'; callId: string; approved: boolean };
-        const record = this._active.get(evt.callId);
-        if (record) {
-          record.phase = 'permissioned';
-          record.permissionApproved = evt.approved;
-          this._notify();
-        }
-        break;
-      }
-      case 'TOOL_SUCCEEDED': {
-        const evt = p as { type: 'TOOL_SUCCEEDED'; callId: string; durationMs: number };
-        const record = this._active.get(evt.callId);
-        if (record) {
-          record.phase = 'succeeded';
-          record.completedAt = envelope.ts;
-          record.durationMs = evt.durationMs;
-          this._finalize(record);
-        }
-        break;
-      }
-      case 'TOOL_FAILED': {
-        const evt = p as { type: 'TOOL_FAILED'; callId: string; error: string; durationMs: number };
-        const record = this._active.get(evt.callId);
-        if (record) {
-          record.phase = 'failed';
-          record.completedAt = envelope.ts;
-          record.durationMs = evt.durationMs;
-          record.error = evt.error;
-          this._finalize(record);
-        }
-        break;
-      }
-      case 'TOOL_CANCELLED': {
-        const evt = p as { type: 'TOOL_CANCELLED'; callId: string; reason?: string };
-        const record = this._active.get(evt.callId);
-        if (record) {
-          record.phase = 'cancelled';
-          record.completedAt = envelope.ts;
-          record.cancelReason = evt.reason;
-          this._finalize(record);
-        }
-        break;
-      }
-      default:
-        break;
-    }
-  }
-
-  /**
-   * Move a completed record from active to history.
-   */
-  private _finalize(record: MutableToolCallRecord): void {
-    this._active.delete(record.callId);
-    const entry: ToolCallEntry = {
-      callId: record.callId,
-      turnId: record.turnId,
-      tool: record.tool,
-      args: record.args,
-      phase: record.phase,
-      receivedAt: record.receivedAt,
-      completedAt: record.completedAt,
-      durationMs: record.durationMs,
-      error: record.error,
-      cancelReason: record.cancelReason,
-      permission: record.permissionApproved !== undefined
-        ? { approved: record.permissionApproved }
-        : undefined,
-      traceId: record.traceId,
-      sessionId: record.sessionId,
-    };
-    appendBounded(this._history, entry, this._config.bufferLimit);
-    this._notify();
-  }
-
-  /**
-   * Return a filtered snapshot of tool call entries.
-   * Active calls are included as their current in-progress state.
-   * History is ordered most-recent first.
-   *
-   * @param filter - Optional filter to restrict entries.
-   */
-  public getSnapshot(filter?: DiagnosticFilter): ToolCallEntry[] {
-    // Convert active records to ToolCallEntry for inclusion
-    const activeEntries: ToolCallEntry[] = [];
-    for (const record of this._active.values()) {
-      activeEntries.push({
-        callId: record.callId,
-        turnId: record.turnId,
-        tool: record.tool,
-        args: record.args,
-        phase: record.phase,
-        receivedAt: record.receivedAt,
-        completedAt: record.completedAt,
-        durationMs: record.durationMs,
-        error: record.error,
-        cancelReason: record.cancelReason,
-        permission: record.permissionApproved !== undefined
-          ? { approved: record.permissionApproved }
-          : undefined,
-        traceId: record.traceId,
-        sessionId: record.sessionId,
-      });
-    }
-
-    // Combine: history (oldest-first) + active, then apply filter
-    const combined: ToolCallEntry[] = [...this._history, ...activeEntries];
-    return applyFilter(combined, filter, (e) => e.receivedAt);
-  }
-
-  /**
-   * Register a callback invoked whenever the data changes.
-   * @returns An unsubscribe function.
-   */
-  public subscribe(callback: () => void): () => void {
-    this._subscribers.add(callback);
-    return () => this._subscribers.delete(callback);
-  }
-
-  /**
-   * Release all event bus subscriptions and clear internal state.
-   * After disposal the panel will no longer receive new events.
-   */
-  public dispose(): void {
-    if (this._unsub) {
-      this._unsub();
-      this._unsub = null;
-    }
-    this._subscribers.clear();
-  }
-
-  private _notify(): void {
-    for (const cb of this._subscribers) {
-      try {
-        cb();
-      } catch {
-        // Non-fatal: subscriber errors must not crash the provider
-      }
-    }
-  }
-}

package/src/runtime/diagnostics/provider.ts

@@ -1,262 +0,0 @@
-/**
- * DiagnosticsProvider — aggregates all diagnostic panel data providers
- * into a single unified interface.
- *
- * Implements the provider contract for diagnostics and the state inspector.
- * Wire this up once during runtime initialization and pass it to all
- * panels that need diagnostic data.
- *
- * Usage:
- * ```ts
- * import { createDiagnosticsProvider } from './diagnostics/index.ts';
- *
- * const provider = createDiagnosticsProvider({
- *   eventBus,
- *   healthAggregator,
- *   domains: [...],
- * });
- *
- * const toolCalls = provider.getToolCalls({ limit: 50 });
- * const unsubscribe = provider.subscribe('tool-calls', () => render());
- * ```
- */
-import type { RuntimeEventBus } from '@pellux/goodvibes-sdk/platform/runtime/events/index';
-import type { RuntimeHealthAggregator } from '@pellux/goodvibes-sdk/platform/runtime/health/aggregator';
-import type {
-  ToolCallEntry,
-  AgentEntry,
-  TaskEntry,
-  EventEntry,
-  RuntimeStateSnapshot,
-  HealthDashboardData,
-  DiagnosticFilter,
-  PanelConfig,
-  ToolContractEntry,
-} from '@pellux/goodvibes-sdk/platform/runtime/diagnostics/types';
-import { ToolCallsPanel } from './panels/tool-calls.ts';
-import { AgentsPanel } from './panels/agents.ts';
-import { TasksPanel } from './panels/tasks.ts';
-import { EventsPanel } from './panels/events.ts';
-import { StateInspectorPanel, type InspectableDomain } from '@pellux/goodvibes-sdk/platform/runtime/diagnostics/panels/state-inspector';
-import { HealthPanel } from './panels/health.ts';
-import { ToolContractsPanel } from '@pellux/goodvibes-sdk/platform/runtime/diagnostics/panels/tool-contracts';
-import type { ContractVerificationResult } from '@pellux/goodvibes-sdk/platform/runtime/tools/contract-verifier';
-
-/** Configuration for creating a DiagnosticsProvider. */
-export interface DiagnosticsProviderConfig {
-  /** The runtime event bus to subscribe to. */
-  readonly eventBus: RuntimeEventBus;
-  /** The runtime health aggregator to monitor. */
-  readonly healthAggregator: RuntimeHealthAggregator;
-  /**
-   * Domain adapters to expose in the state inspector.
-   * Pass one adapter per runtime store domain.
-   */
-  readonly domains?: readonly InspectableDomain[];
-  /** Optional per-panel buffer configuration. */
-  readonly panelConfig?: PanelConfig;
-}
-
-/** Panel name literals for use with subscribe(). */
-export type DiagnosticPanelName =
-  | 'tool-calls'
-  | 'agents'
-  | 'tasks'
-  | 'events'
-  | 'state-inspector'
-  | 'health'
-  | 'tool-contracts';
-
-/**
- * DiagnosticsProvider — unified data access layer for all diagnostic panels.
- *
- * Each panel is self-contained and subscribes to its own event sources.
- * The provider exposes a stable interface for retrieving snapshots and
- * registering change listeners.
- */
-export class DiagnosticsProvider {
-  private readonly _toolCalls: ToolCallsPanel;
-  private readonly _agents: AgentsPanel;
-  private readonly _tasks: TasksPanel;
-  private readonly _events: EventsPanel;
-  private readonly _stateInspector: StateInspectorPanel;
-  private readonly _health: HealthPanel;
-  private readonly _toolContracts: ToolContractsPanel;
-
-  constructor(config: DiagnosticsProviderConfig) {
-    const pc = config.panelConfig;
-    this._toolCalls = new ToolCallsPanel(config.eventBus, pc);
-    this._agents = new AgentsPanel(config.eventBus, pc);
-    this._tasks = new TasksPanel(config.eventBus, pc);
-    this._events = new EventsPanel(config.eventBus, pc);
-    this._stateInspector = new StateInspectorPanel(
-      config.domains ? [...config.domains] : []
-    );
-    this._health = new HealthPanel(config.healthAggregator);
-    this._toolContracts = new ToolContractsPanel(pc);
-  }
-
-  // ── Data access ──────────────────────────────────────────────────────────────
-
-  /**
-   * Retrieve tool call diagnostic entries.
-   *
-   * @param filter - Optional filter for domain, time range, trace/session/turn/task IDs, and limit.
-   * @returns Filtered tool call entries, most recent first.
-   */
-  public getToolCalls(filter?: DiagnosticFilter): ToolCallEntry[] {
-    return this._toolCalls.getSnapshot(filter);
-  }
-
-  /**
-   * Retrieve agent diagnostic entries.
-   *
-   * @param filter - Optional filter.
-   * @returns Filtered agent entries, most recent first.
-   */
-  public getAgents(filter?: DiagnosticFilter): AgentEntry[] {
-    return this._agents.getSnapshot(filter);
-  }
-
-  /**
-   * Retrieve task diagnostic entries.
-   *
-   * @param filter - Optional filter.
-   * @returns Filtered task entries, most recent first.
-   */
-  public getTasks(filter?: DiagnosticFilter): TaskEntry[] {
-    return this._tasks.getSnapshot(filter);
-  }
-
-  /**
-   * Retrieve event timeline entries.
-   *
-   * @param filter - Optional filter. The `domains` field filters by domain name.
-   * @returns Filtered event entries, most recent first.
-   */
-  public getEvents(filter?: DiagnosticFilter): EventEntry[] {
-    return this._events.getSnapshot(filter);
-  }
-
-  /**
-   * Capture a point-in-time snapshot of all registered runtime domain states.
-   *
-   * @returns A RuntimeStateSnapshot with all domain states serialized.
-   */
-  public getStateSnapshot(): RuntimeStateSnapshot {
-    return this._stateInspector.getSnapshot();
-  }
-
-  /**
-   * Retrieve the current health dashboard data.
-   *
-   * @returns Aggregated health data sorted by severity.
-   */
-  public getHealthDashboard(): HealthDashboardData {
-    return this._health.getSnapshot();
-  }
-
-  /**
-   * Register a domain adapter for inclusion in state inspector snapshots.
-   *
-   * @param domain - Domain adapter implementing InspectableDomain.
-   */
-  public registerDomain(domain: InspectableDomain): void {
-    this._stateInspector.registerDomain(domain);
-  }
-
-  // ── Tool contracts ────────────────────────────────────────────────────────────
-
-  /**
-   * Load (or reload) all tool contract verification results.
-   * Replaces any previously loaded results.
-   *
-   * @param results - Map of tool name → ContractVerificationResult from ToolContractVerifier.
-   */
-  public loadToolContracts(results: Map<string, ContractVerificationResult>): void {
-    this._toolContracts.load(results);
-  }
-
-  /**
-   * Upsert a single tool contract verification result.
-   * Use this for live updates when a single tool is re-verified.
-   *
-   * @param result - The ContractVerificationResult to upsert.
-   */
-  public upsertToolContract(result: ContractVerificationResult): void {
-    this._toolContracts.upsert(result);
-  }
-
-  /**
-   * Get the contract entry for a specific tool by name.
-   *
-   * @param toolName - Tool name to look up.
-   * @returns The entry or undefined if not verified.
-   */
-  public getToolContract(toolName: string): ToolContractEntry | undefined {
-    return this._toolContracts.get(toolName);
-  }
-
-  /**
-   * Get all tool contract entries, sorted by tool name.
-   */
-  public getToolContracts(): ToolContractEntry[] {
-    return this._toolContracts.getAll();
-  }
-
-  /**
-   * Get only tools that failed their contract checks.
-   */
-  public getToolContractFailures(): ToolContractEntry[] {
-    return this._toolContracts.getFailures();
-  }
-
-  /**
-   * Get summary counts across all tool contract results.
-   */
-  public getToolContractSummary(): ReturnType<ToolContractsPanel['getSummary']> {
-    return this._toolContracts.getSummary();
-  }
-
-  // ── Change subscriptions ──────────────────────────────────────────────────────
-
-  /**
-   * Subscribe to change notifications for a specific panel.
-   *
-   * The callback is invoked whenever the panel's data changes. Call the
-   * corresponding `get*` method inside the callback to retrieve the latest data.
-   *
-   * @param panel - The panel to subscribe to.
-   * @param callback - Called whenever the panel's data updates.
-   * @returns An unsubscribe function; call it to stop receiving notifications.
-   */
-  public subscribe(panel: DiagnosticPanelName, callback: () => void): () => void {
-    switch (panel) {
-      case 'tool-calls': return this._toolCalls.subscribe(callback);
-      case 'agents': return this._agents.subscribe(callback);
-      case 'tasks': return this._tasks.subscribe(callback);
-      case 'events': return this._events.subscribe(callback);
-      case 'state-inspector': return this._stateInspector.subscribe(callback);
-      case 'health': return this._health.subscribe(callback);
-      case 'tool-contracts': return this._toolContracts.subscribe(callback);
-    }
-  }
-
-  // ── Lifecycle ─────────────────────────────────────────────────────────────────
-
-  /**
-   * Dispose all panel data providers, releasing event bus subscriptions
-   * and clearing all internal buffers.
-   *
-   * Call this when the diagnostics system is shut down.
-   */
-  public dispose(): void {
-    this._toolCalls.dispose();
-    this._agents.dispose();
-    this._tasks.dispose();
-    this._events.dispose();
-    this._health.dispose();
-    this._toolContracts.dispose();
-    // StateInspectorPanel has no disposable resources (no event bus subscriptions)
-  }
-}

package/src/runtime/store/domains/conversation.ts

@@ -1 +0,0 @@
-export * from '@pellux/goodvibes-sdk/platform/runtime/store/domains/conversation';

package/src/runtime/store/domains/permissions.ts

@@ -1 +0,0 @@
-export * from '@pellux/goodvibes-sdk/platform/runtime/store/domains/permissions';

package/src/runtime/store/helpers/reducers/conversation.ts

@@ -1 +0,0 @@
-export * from '@pellux/goodvibes-sdk/platform/runtime/store/helpers/reducers/conversation';

package/src/runtime/store/helpers/reducers/lifecycle.ts

@@ -1 +0,0 @@
-export * from '@pellux/goodvibes-sdk/platform/runtime/store/helpers/reducers/lifecycle';

package/src/runtime/store/helpers/reducers/shared.ts

@@ -1,60 +0,0 @@
-import type { PartialToolCall } from '@pellux/goodvibes-sdk/platform/providers/interface';
-import type { ConversationDomainState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/conversation';
-
-export function uniq<T>(items: T[]): T[] {
-  return [...new Set(items)];
-}
-
-export function now(): number {
-  return Date.now();
-}
-
-export function updateDomainMetadata<T extends { revision: number; lastUpdatedAt: number; source: string }>(
-  domain: T,
-  source: string,
-): T {
-  return {
-    ...domain,
-    revision: domain.revision + 1,
-    lastUpdatedAt: now(),
-    source,
-  };
-}
-
-export function isTerminalTurnState(state: ConversationDomainState['turnState']): boolean {
-  return state === 'completed' || state === 'failed' || state === 'cancelled';
-}
-
-export function canStartNewTurn(domain: ConversationDomainState): boolean {
-  return domain.turnState === 'idle' || isTerminalTurnState(domain.turnState);
-}
-
-export function isCurrentTurnEvent(domain: ConversationDomainState, turnId: string): boolean {
-  return domain.currentTurnId !== undefined && domain.currentTurnId === turnId;
-}
-
-export function formatPartialToolPreview(toolCalls?: PartialToolCall[]): string | undefined {
-  if (!toolCalls || toolCalls.length === 0) return undefined;
-  const last = toolCalls[toolCalls.length - 1] as { name?: unknown; arguments?: unknown };
-  const name = typeof last.name === 'string' ? last.name : '';
-  const args =
-    typeof last.arguments === 'string'
-      ? last.arguments
-      : last.arguments !== undefined
-        ? JSON.stringify(last.arguments)
-        : '';
-  if (!name) return undefined;
-  const preview = args.length > 60 ? `${args.slice(0, 57)}...` : args;
-  return `${name}(${preview})`;
-}
-
-export function resetStreamState(): ConversationDomainState['stream'] {
-  return {
-    accumulated: '',
-    reasoningAccumulated: '',
-    partialToolPreview: undefined,
-    deltaCount: 0,
-    firstDeltaAt: undefined,
-    lastDeltaAt: undefined,
-  };
-}