@pellux/goodvibes-tui 0.18.12 → 0.18.17

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

@@ -1,181 +0,0 @@
-/**
- * Conversation domain state — tracks the active turn lifecycle,
- * message buffer, streaming deltas, and tool dispatch state.
- */
-
-import type { TurnStopReason } from '@pellux/goodvibes-sdk/platform/runtime/events/turn';
-
-/** States for the turn lifecycle machine. */
-export type TurnState =
-  | 'idle'
-  | 'preflight'
-  | 'streaming'
-  | 'tool_dispatch'
-  | 'post_hooks'
-  | 'completed'
-  | 'failed'
-  | 'cancelled';
-
-/** States for the tool execution machine. */
-export type ToolExecutionState =
-  | 'received'
-  | 'validated'
-  | 'prehooked'
-  | 'permissioned'
-  | 'executing'
-  | 'mapped'
-  | 'posthooked'
-  | 'succeeded'
-  | 'failed'
-  | 'cancelled';
-
-/** A lightweight record of an in-progress or recently completed tool call. */
-export interface ActiveToolCall {
-  /** Tool call ID from the provider. */
-  callId: string;
-  /** Tool name. */
-  toolName: string;
-  /** Serialized arguments (JSON string). */
-  args: string;
-  /** Current execution state. */
-  state: ToolExecutionState;
-  /** Epoch ms when this call entered the current state. */
-  stateEnteredAt: number;
-  /** Phase timestamps keyed by ToolExecutionState. */
-  phaseTimestamps: Partial<Record<ToolExecutionState, number>>;
-  /** Error message if state === 'failed'. */
-  error?: string;
-}
-
-/** Token usage accumulated for the current or most recent turn. */
-export interface TurnUsage {
-  inputTokens: number;
-  outputTokens: number;
-  cacheReadTokens: number;
-  cacheWriteTokens: number;
-  reasoningTokens: number;
-}
-
-/** Streaming progress for the current turn. */
-export interface StreamProgress {
-  /** Accumulated text content so far. */
-  accumulated: string;
-  /** Latest reasoning delta (if any). */
-  reasoningAccumulated: string;
-  /** Compact preview of the most recent partial tool call streamed so far. */
-  partialToolPreview?: string;
-  /** Number of delta events received. */
-  deltaCount: number;
-  /** Epoch ms of the first delta. */
-  firstDeltaAt?: number;
-  /** Epoch ms of the most recent delta. */
-  lastDeltaAt?: number;
-}
-
-export interface TurnReconciliationRecord {
-  count: number;
-  callIds: string[];
-  toolNames: string[];
-  reason: string;
-  timestamp: number;
-  isMalformed: boolean;
-}
-
-/**
- * ConversationDomainState — turn lifecycle and streaming state.
- */
-export interface ConversationDomainState {
-  // ── Domain metadata ────────────────────────────────────────────────────────
-  /** Monotonic revision counter; increments on every mutation. */
-  revision: number;
-  /** Timestamp of last mutation (Date.now()). */
-  lastUpdatedAt: number;
-  /** Subsystem that triggered the last mutation. */
-  source: string;
-
-  // ── Turn lifecycle ─────────────────────────────────────────────────────────
-  /** Current state of the turn lifecycle machine. */
-  turnState: TurnState;
-  /** Unique ID of the current turn (undefined when idle). */
-  currentTurnId?: string;
-  /** Epoch ms when the current turn started (undefined when idle). */
-  turnStartedAt?: number;
-  /** Epoch ms when the current turn completed/failed (undefined while active). */
-  turnEndedAt?: number;
-  /** Error from the most recent failed turn. */
-  lastTurnError?: string;
-  /** Explicit terminal reason for the most recently finished turn. */
-  lastTurnStopReason?: TurnStopReason;
-  /** Final assistant response for the most recently completed turn. */
-  lastTurnResponse?: string;
-  /** Most recent preflight failure message, if any. */
-  lastPreflightFailure?: string;
-  /** Total number of turns completed in this session. */
-  totalTurns: number;
-
-  // ── Streaming ──────────────────────────────────────────────────────────────
-  /** Live streaming progress (populated during 'streaming' state). */
-  stream: StreamProgress;
-
-  // ── Tool dispatch ──────────────────────────────────────────────────────────
-  /** Map of callId → ActiveToolCall for all in-flight tool calls. */
-  activeToolCalls: Map<string, ActiveToolCall>;
-  /** Count of tool calls dispatched in the current turn. */
-  toolCallsThisTurn: number;
-  /** Most recent reconciliation record for unresolved or malformed tool calls. */
-  lastToolReconciliation?: TurnReconciliationRecord;
-
-  // ── Token accounting ───────────────────────────────────────────────────────
-  /** Usage for the current or most recent turn. */
-  currentTurnUsage: TurnUsage;
-  /** Cumulative usage across all turns in this session. */
-  sessionUsage: TurnUsage;
-
-  // ── Context window ─────────────────────────────────────────────────────────
-  /** Estimated token count of the current context window. */
-  estimatedContextTokens: number;
-  /** Whether a context warning threshold has been crossed. */
-  contextWarningActive: boolean;
-  /** Message count in the current session conversation. */
-  messageCount: number;
-}
-
-function makeEmptyUsage(): TurnUsage {
-  return { inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0, reasoningTokens: 0 };
-}
-
-/**
- * Returns the default initial state for the conversation domain.
- */
-export function createInitialConversationState(): ConversationDomainState {
-  return {
-    revision: 0,
-    lastUpdatedAt: 0,
-    source: 'init',
-    turnState: 'idle',
-    currentTurnId: undefined,
-    turnStartedAt: undefined,
-    turnEndedAt: undefined,
-    lastTurnError: undefined,
-    lastTurnStopReason: undefined,
-    lastTurnResponse: undefined,
-    lastPreflightFailure: undefined,
-    totalTurns: 0,
-    stream: {
-      accumulated: '',
-      reasoningAccumulated: '',
-      partialToolPreview: undefined,
-      deltaCount: 0,
-      firstDeltaAt: undefined,
-      lastDeltaAt: undefined,
-    },
-    activeToolCalls: new Map(),
-    toolCallsThisTurn: 0,
-    lastToolReconciliation: undefined,
-    currentTurnUsage: makeEmptyUsage(),
-    sessionUsage: makeEmptyUsage(),
-    estimatedContextTokens: 0,
-    contextWarningActive: false,
-    messageCount: 0,
-  };
-}

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

@@ -1,143 +0,0 @@
-/**
- * Permissions domain state — tracks the permission mode, session approvals,
- * and the most recent permission decision with full audit trail.
- */
-
-import type { PermissionCategory } from '@pellux/goodvibes-sdk/platform/permissions/manager';
-import type { PermissionRiskLevel } from '@pellux/goodvibes-sdk/platform/permissions/types';
-
-/** Permission evaluation modes (maps to PermissionsToolConfig). */
-export type PermissionMode =
-  | 'default'
-  | 'plan'
-  | 'allow-all'
-  | 'custom'
-  | 'background-restricted';
-
-/** States for the permission decision machine. */
-export type PermissionDecisionMachineState =
-  | 'collect_rules'
-  | 'normalize_input'
-  | 'evaluate_policy'
-  | 'evaluate_runtime_mode'
-  | 'evaluate_session_override'
-  | 'final_safety_checks'
-  | 'decision_emitted';
-
-/** The outcome of a permission decision. */
-export type PermissionDecisionOutcome = 'approved' | 'denied' | 'deferred';
-
-/** Source layer that determined the permission outcome. */
-export type PermissionSourceLayer =
-  | 'config_policy'
-  | 'managed_policy'
-  | 'runtime_mode'
-  | 'session_override'
-  | 'safety_check'
-  | 'user_prompt';
-
-/** Reason codes for a permission decision. */
-export type PermissionDecisionReason =
-  | 'config_allow'
-  | 'config_deny'
-  | 'managed_policy_allow'
-  | 'managed_policy_deny'
-  | 'mode_allow_all'
-  | 'mode_denied'
-  | 'mode_plan_deny'
-  | 'mode_background_restricted'
-  | 'session_cached_approval'
-  | 'session_cached_denial'
-  | 'safety_guardrail'
-  | 'user_approved'
-  | 'user_denied';
-
-/** Full record of the most recent permission decision. */
-export interface PermissionDecision {
-  /** Tool call ID this decision is for. */
-  callId: string;
-  /** Tool name. */
-  toolName: string;
-  /** Permission category. */
-  category: PermissionCategory;
-  /** State machine state when the decision was emitted. */
-  machineState: PermissionDecisionMachineState;
-  /** Final outcome. */
-  outcome: PermissionDecisionOutcome;
-  /** Primary reason code. */
-  reason: PermissionDecisionReason;
-  /** Source layer that yielded the decision. */
-  sourceLayer: PermissionSourceLayer;
-  /** Whether the decision was persisted to session approvals. */
-  persisted: boolean;
-  /** Semantic classification surfaced with the decision. */
-  classification?: string;
-  /** Risk level surfaced with the decision. */
-  riskLevel?: PermissionRiskLevel;
-  /** Human-readable summary for operators and the prompt UI. */
-  summary?: string;
-  /** Epoch ms when the decision was emitted. */
-  decidedAt: number;
-}
-
-/**
- * PermissionDomainState — permission configuration and decision state.
- */
-export interface PermissionDomainState {
-  // ── Domain metadata ────────────────────────────────────────────────────────
-  /** Monotonic revision counter; increments on every mutation. */
-  revision: number;
-  /** Timestamp of last mutation (Date.now()). */
-  lastUpdatedAt: number;
-  /** Subsystem that triggered the last mutation. */
-  source: string;
-
-  // ── Mode ───────────────────────────────────────────────────────────────────
-  /** Current global permission mode. */
-  mode: PermissionMode;
-  /** Whether the user is currently being prompted for a permission decision. */
-  awaitingDecision: boolean;
-  /** Current state of the decision state machine (while a decision is in flight). */
-  decisionMachineState?: PermissionDecisionMachineState;
-
-  // ── Session approvals ──────────────────────────────────────────────────────
-  /**
-   * Per-session tool approval cache.
-   * Key format: "<toolName>:<argsHash>" → boolean (approved/denied).
-   */
-  sessionApprovals: Map<string, boolean>;
-  /** Number of approvals granted this session. */
-  approvalCount: number;
-  /** Number of denials issued this session. */
-  denialCount: number;
-
-  // ── Last decision ──────────────────────────────────────────────────────────
-  /** The most recent permission decision record. */
-  lastDecision?: PermissionDecision;
-
-  // ── Statistics ─────────────────────────────────────────────────────────────
-  /** Total permission checks performed this session. */
-  totalChecks: number;
-  /** Total checks that were served from session cache. */
-  cachedChecks: number;
-}
-
-/**
- * Returns the default initial state for the permissions domain.
- */
-export function createInitialPermissionsState(): PermissionDomainState {
-  return {
-    revision: 0,
-    lastUpdatedAt: 0,
-    source: 'init',
-    mode: 'default',
-    awaitingDecision: false,
-    decisionMachineState: undefined,
-    sessionApprovals: new Map(),
-    approvalCount: 0,
-    denialCount: 0,
-    lastDecision: undefined,
-    totalChecks: 0,
-    cachedChecks: 0,
-  };
-}

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

@@ -1,228 +0,0 @@
-import type { TurnEvent } from '@pellux/goodvibes-sdk/platform/runtime/events/turn';
-import type { ToolEvent } from '@pellux/goodvibes-sdk/platform/runtime/events/tools';
-import type { ConversationDomainState, ActiveToolCall, ToolExecutionState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/conversation';
-import { canStartNewTurn, formatPartialToolPreview, isCurrentTurnEvent, isTerminalTurnState, now, resetStreamState, updateDomainMetadata } from '@pellux/goodvibes-sdk/platform/runtime/store/helpers/reducers/shared';
-
-function formatToolArgs(event: ToolEvent | TurnEvent): string {
-  if ('args' in event) {
-    return JSON.stringify(event.args);
-  }
-  return '{}';
-}
-
-export function updateConversationState(
-  domain: ConversationDomainState,
-  event: TurnEvent | ToolEvent,
-): ConversationDomainState {
-  const source = event.type;
-  if ('callId' in event) {
-    if (!isCurrentTurnEvent(domain, event.turnId) || isTerminalTurnState(domain.turnState)) {
-      return domain;
-    }
-    const activeToolCalls = new Map(domain.activeToolCalls);
-    const existing = activeToolCalls.get(event.callId);
-    const stateByEvent: Partial<Record<ToolEvent['type'], ToolExecutionState>> = {
-      TOOL_RECEIVED: 'received',
-      TOOL_VALIDATED: 'validated',
-      TOOL_PREHOOKED: 'prehooked',
-      TOOL_PERMISSIONED: 'permissioned',
-      TOOL_EXECUTING: 'executing',
-      TOOL_MAPPED: 'mapped',
-      TOOL_POSTHOOKED: 'posthooked',
-      TOOL_SUCCEEDED: 'succeeded',
-      TOOL_FAILED: 'failed',
-      TOOL_CANCELLED: 'cancelled',
-      BUDGET_EXCEEDED_MS: 'failed',
-      BUDGET_EXCEEDED_TOKENS: 'failed',
-      BUDGET_EXCEEDED_COST: 'failed',
-    };
-    const nextState = stateByEvent[event.type];
-    const timestamp = now();
-    const nextRecord: ActiveToolCall = {
-      callId: event.callId,
-      toolName: event.tool,
-      args: existing?.args ?? formatToolArgs(event),
-      state: nextState ?? existing?.state ?? 'received',
-      stateEnteredAt: 'startedAt' in event ? event.startedAt : timestamp,
-      phaseTimestamps: {
-        ...(existing?.phaseTimestamps ?? {}),
-        ...(nextState ? { [nextState]: timestamp } : {}),
-      },
-      error:
-        'error' in event
-          ? event.error
-          : event.type === 'BUDGET_EXCEEDED_MS'
-            ? `${event.phase} exceeded ${event.limitMs}ms budget`
-            : event.type === 'BUDGET_EXCEEDED_TOKENS'
-              ? `${event.phase} exceeded ${event.limitTokens} token budget`
-              : event.type === 'BUDGET_EXCEEDED_COST'
-                ? `${event.phase} exceeded $${event.limitCostUsd} cost budget`
-                : existing?.error,
-    };
-    activeToolCalls.set(event.callId, nextRecord);
-    return {
-      ...updateDomainMetadata(domain, source),
-      activeToolCalls,
-      currentTurnId: domain.currentTurnId ?? event.turnId,
-      toolCallsThisTurn: event.type === 'TOOL_RECEIVED' ? domain.toolCallsThisTurn + 1 : domain.toolCallsThisTurn,
-    };
-  }
-
-  switch (event.type) {
-    case 'TURN_SUBMITTED':
-      if (!canStartNewTurn(domain)) return domain;
-      return {
-        ...updateDomainMetadata(domain, source),
-        turnState: 'preflight',
-        currentTurnId: event.turnId,
-        turnStartedAt: now(),
-        turnEndedAt: undefined,
-        lastTurnError: undefined,
-        lastTurnStopReason: undefined,
-        lastTurnResponse: undefined,
-        lastPreflightFailure: undefined,
-        stream: resetStreamState(),
-        activeToolCalls: new Map(),
-        toolCallsThisTurn: 0,
-        lastToolReconciliation: undefined,
-      };
-    case 'PREFLIGHT_OK':
-      if (!isCurrentTurnEvent(domain, event.turnId) || domain.turnState !== 'preflight') return domain;
-      return {
-        ...updateDomainMetadata(domain, source),
-        currentTurnId: event.turnId,
-        turnState: 'preflight',
-      };
-    case 'PREFLIGHT_FAIL':
-      if (!isCurrentTurnEvent(domain, event.turnId) || domain.turnState !== 'preflight') return domain;
-      return {
-        ...updateDomainMetadata(domain, source),
-        currentTurnId: event.turnId,
-        turnState: 'failed',
-        turnEndedAt: now(),
-        lastTurnError: event.reason,
-        lastTurnStopReason: event.stopReason,
-        lastPreflightFailure: event.reason,
-        stream: resetStreamState(),
-      };
-    case 'STREAM_START':
-      if (!isCurrentTurnEvent(domain, event.turnId) || domain.turnState !== 'preflight') return domain;
-      return {
-        ...updateDomainMetadata(domain, source),
-        currentTurnId: event.turnId,
-        turnState: 'streaming',
-        stream: resetStreamState(),
-      };
-    case 'STREAM_DELTA':
-      if (!isCurrentTurnEvent(domain, event.turnId) || domain.turnState !== 'streaming') return domain;
-      return {
-        ...updateDomainMetadata(domain, source),
-        currentTurnId: event.turnId,
-        turnState: 'streaming',
-        stream: {
-          accumulated: event.accumulated,
-          reasoningAccumulated: `${domain.stream.reasoningAccumulated}${event.reasoning ?? ''}`,
-          partialToolPreview: formatPartialToolPreview(event.toolCalls),
-          deltaCount: domain.stream.deltaCount + 1,
-          firstDeltaAt: domain.stream.firstDeltaAt ?? now(),
-          lastDeltaAt: now(),
-        },
-      };
-    case 'STREAM_END':
-      if (!isCurrentTurnEvent(domain, event.turnId) || domain.turnState !== 'streaming') return domain;
-      return {
-        ...updateDomainMetadata(domain, source),
-        currentTurnId: event.turnId,
-        stream: {
-          ...domain.stream,
-          partialToolPreview: undefined,
-        },
-      };
-    case 'LLM_RESPONSE_RECEIVED':
-      if (!isCurrentTurnEvent(domain, event.turnId) || isTerminalTurnState(domain.turnState)) return domain;
-      return {
-        ...updateDomainMetadata(domain, source),
-        currentTurnId: event.turnId,
-      };
-    case 'TOOL_BATCH_READY':
-      if (!isCurrentTurnEvent(domain, event.turnId) || domain.turnState !== 'tool_dispatch') return domain;
-      return {
-        ...updateDomainMetadata(domain, source),
-        currentTurnId: event.turnId,
-        turnState: 'post_hooks',
-      };
-    case 'TOOLS_DONE':
-      if (!isCurrentTurnEvent(domain, event.turnId) || domain.turnState !== 'tool_dispatch') return domain;
-      return {
-        ...updateDomainMetadata(domain, source),
-        currentTurnId: event.turnId,
-        turnState: 'post_hooks',
-      };
-    case 'POST_HOOKS_DONE':
-      if (!isCurrentTurnEvent(domain, event.turnId) || domain.turnState !== 'post_hooks') return domain;
-      return {
-        ...updateDomainMetadata(domain, source),
-        currentTurnId: event.turnId,
-        turnState: 'post_hooks',
-      };
-    case 'TOOL_RECONCILED':
-      if (!isCurrentTurnEvent(domain, event.turnId) || isTerminalTurnState(domain.turnState)) return domain;
-      return {
-        ...updateDomainMetadata(domain, source),
-        currentTurnId: event.turnId,
-        lastToolReconciliation: {
-          count: event.count,
-          callIds: [...event.callIds],
-          toolNames: [...event.toolNames],
-          reason: event.reason,
-          timestamp: event.timestamp,
-          isMalformed: event.isMalformed ?? false,
-        },
-      };
-    case 'TURN_COMPLETED':
-      if (!isCurrentTurnEvent(domain, event.turnId) || isTerminalTurnState(domain.turnState)) return domain;
-      return {
-        ...updateDomainMetadata(domain, source),
-        currentTurnId: event.turnId,
-        turnState: 'completed',
-        turnEndedAt: now(),
-        totalTurns: domain.totalTurns + 1,
-        lastTurnResponse: event.response,
-        lastTurnStopReason: event.stopReason,
-        stream: {
-          ...domain.stream,
-          partialToolPreview: undefined,
-        },
-      };
-    case 'TURN_ERROR':
-      if (!isCurrentTurnEvent(domain, event.turnId) || isTerminalTurnState(domain.turnState)) return domain;
-      return {
-        ...updateDomainMetadata(domain, source),
-        currentTurnId: event.turnId,
-        turnState: 'failed',
-        turnEndedAt: now(),
-        lastTurnError: event.error,
-        lastTurnStopReason: event.stopReason,
-        stream: {
-          ...domain.stream,
-          partialToolPreview: undefined,
-        },
-      };
-    case 'TURN_CANCEL':
-      if (!isCurrentTurnEvent(domain, event.turnId) || isTerminalTurnState(domain.turnState)) return domain;
-      return {
-        ...updateDomainMetadata(domain, source),
-        currentTurnId: event.turnId,
-        turnState: 'cancelled',
-        turnEndedAt: now(),
-        lastTurnError: event.reason,
-        lastTurnStopReason: event.stopReason,
-        stream: {
-          ...domain.stream,
-          partialToolPreview: undefined,
-        },
-      };
-    default:
-      return updateDomainMetadata(domain, source);
-  }
-}