ompchamber 0.3.0

package/src/shared/types/omp/session.ts

@@ -0,0 +1,153 @@
+/**
+ * @license
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * Domain types for the oh-my-pi discovery layer (`@/lib/omp`).
+ *
+ * These mirror the shapes omp-web uses for its sidebar (ManagedProject /
+ * SessionInfo) so a future UI fork can consume them directly. They are
+ * intentionally independent from the existing SQLite-backed types
+ * (`WorkspaceFolderData` / `SessionItemData`).
+ */
+
+/** A workspace (project root) shown in the sidebar list. */
+export interface OmpProject {
+  /** Canonical absolute path of the project root. */
+  path: string;
+  /** ISO timestamp of the most recent explicit add (registered only). */
+  addedAt?: string;
+  /** Optional display-only workspace name (registered only). */
+  alias?: string;
+  /** Explicit sidebar position; lower values appear first (registered only). */
+  sortOrder?: number;
+  /** True when this project was discovered from session files on disk rather
+   *  than registered in ~/.omp/agent/projects.json. */
+  discovered: boolean;
+}
+
+/**
+ * Per-message token/cost usage as omp records it in a session JSONL
+ * (`message.usage`). The canonical shape shared by the telemetry, stats, and
+ * usage-aggregation readers — every field is optional because legacy entries
+ * omit subsets of them.
+ */
+export interface OmpUsage {
+  input?: number;
+  output?: number;
+  cacheRead?: number;
+  cacheWrite?: number;
+  totalTokens?: number;
+  reasoningTokens?: number;
+  /** Anchored prompt occupancy reported by the provider (never a per-turn total). */
+  contextTokens?: number;
+  cost?: { input?: number; output?: number; cacheRead?: number; cacheWrite?: number; total?: number };
+}
+
+/** Anchored context snapshot omp attaches to a message (telemetry only). */
+export interface OmpContextSnapshot {
+  promptTokens?: number;
+  /** Estimated prompt tokens removed by local history rewrites after the snapshot. */
+  historyRewriteTokensRemoved?: number;
+  nonMessageTokens?: number;
+  compactionEpoch?: number;
+}
+
+/**
+ * The `message` payload of a `type:"message"` JSONL entry. Superset of every
+ * reader's view (chat reload, telemetry, stats, usage aggregation): the chat
+ * path reads tool/error fields, telemetry reads usage/contextSnapshot, and the
+ * open index signature tolerates fields a future omp version adds.
+ */
+export interface OmpMessage {
+  role?: string;
+  content?: unknown;
+  model?: string;
+  provider?: string;
+  usage?: OmpUsage;
+  contextSnapshot?: OmpContextSnapshot;
+  stopReason?: string;
+  isError?: boolean;
+  /** Chat-reload: pairs a toolResult with its toolCall. */
+  toolCallId?: string;
+  toolName?: string;
+  details?: unknown;
+  attribution?: unknown;
+  /** Wall-clock start (epoch ms) or ISO string, per omp version. */
+  timestamp?: string | number;
+  completedAt?: string | number;
+  duration?: number;
+  /** Provider error fields recorded flat on an abnormal turn. */
+  errorStatus?: number;
+  errorId?: number;
+  errorMessage?: string;
+  [key: string]: unknown;
+}
+
+/**
+ * One raw omp session JSONL record. This is the single canonical entry type
+ * shared by the chat reload path, telemetry, stats, and usage aggregation —
+ * each reader reads the optional fields it needs (title/compaction markers,
+ * model/thinking changes, message payloads).
+ */
+export interface OmpMessageEntry {
+  type?: string;
+  customType?: string;
+  id?: string;
+  parentId?: string | null;
+  timestamp?: string;
+  cwd?: string;
+  title?: string;
+  shortSummary?: string;
+  /** Session-level model recorded by a `model_change` entry. */
+  model?: string;
+  /** Session-level thinking level recorded by a `thinking_level_change` entry. */
+  thinkingLevel?: string;
+  content?: unknown;
+  details?: unknown;
+  /** Turn-level metadata omp may place beside the message rather than inside it. */
+  attribution?: unknown;
+  durationMs?: unknown;
+  message?: OmpMessage;
+}
+
+/** Fields every session summary shares, whether it comes from a 4 KiB scan or
+ *  the sidebar wire payload. */
+export interface OmpSessionBase {
+  /** Absolute path of the session .jsonl file. */
+  path: string;
+  id: string;
+  /** Working directory the session ran in. */
+  cwd: string;
+  /** Prefix-derived lower bound of the message count. */
+  messageCount: number;
+  /** First user message text (truncated by the prefix window). */
+  firstMessage: string;
+}
+
+/** A session summary — one sidebar row under a project. */
+export interface OmpSession extends OmpSessionBase {
+  /** Display title (title-slot wins; falls back to header title). */
+  name?: string;
+  /** ISO timestamp of session creation (header timestamp). */
+  created: string;
+  /** ISO timestamp of last modification (file mtime). */
+  modified: string;
+  /** Parent session id when this session was forked/branched. */
+  parentSessionId?: string;
+  /** Resolved root of the repository the session's cwd belongs to. */
+  projectRoot?: string;
+}
+
+/** Full sidebar payload — equivalent to omp-web's /api/projects + /api/sessions. */
+export interface OmpSidebarData {
+  projects: OmpProject[];
+  sessions: OmpSession[];
+  /** Path of the agent dir the data was read from (~/.omp/agent). */
+  agentDir: string;
+  /** True when the sessions root exists and was readable. */
+  available: boolean;
+  /** ISO timestamp of the read (client can use it as a refresh cursor). */
+  generatedAt: string;
+}

package/src/shared/types/omp/subagent.ts

@@ -0,0 +1,176 @@
+/**
+ * @license
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * Subagent wire types — mirrors of oh-my-pi task/types.ts (AgentProgress /
+ * SubagentLifecyclePayload / RpcSubagentSnapshot / SubagentMessagesPage).
+ *
+ * Every field is optional where the wire may omit it: payloads are parsed
+ * leniently (see `@/lib/omp/subagent/parse`) and malformed frames must never
+ * fabricate live roster entries.
+ */
+
+/** Where an agent definition came from. */
+export type SubagentAgentSource = 'bundled' | 'user' | 'project';
+
+export interface SubagentRetryState {
+  attempt: number;
+  maxAttempts: number;
+  delayMs: number;
+  errorMessage: string;
+  startedAtMs: number;
+}
+
+/** Live per-subagent progress snapshot (oh-my-pi AgentProgress). */
+export interface SubagentProgress {
+  index?: number;
+  id?: string;
+  agent?: string;
+  agentSource?: SubagentAgentSource;
+  status?: 'pending' | 'running' | 'completed' | 'failed' | 'aborted';
+  task?: string;
+  assignment?: string;
+  description?: string;
+  lastIntent?: string;
+  currentTool?: string;
+  currentToolArgs?: string;
+  currentToolStartMs?: number;
+  recentTools?: Array<{ tool: string; args: string; endMs: number }>;
+  recentOutput?: string[];
+  toolCount?: number;
+  requests?: number;
+  tokens?: number;
+  contextTokens?: number;
+  contextWindow?: number;
+  cost?: number;
+  durationMs?: number;
+  modelOverride?: string | string[];
+  modelRole?: string;
+  resolvedModel?: string;
+  resolvedModelIsFallback?: boolean;
+  retryState?: SubagentRetryState;
+  retryFailure?: { attempt: number; errorMessage: string };
+  inflightTaskDetails?: unknown;
+  extractedToolData?: Record<string, unknown[]>;
+}
+
+/** Compact live-activity entry derived from subagent_event frames. */
+export interface SubagentActivityEvent {
+  kind: 'tool' | 'text' | 'notice';
+  label: string;
+  ts: number;
+}
+
+/** Settled per-subagent result from a parent task toolResult (SingleResult). */
+export interface SubagentHistoryResult {
+  exitCode?: number;
+  truncated?: boolean;
+  cost?: number;
+  structuredOutput?: { source?: string; mode?: string; status?: string; error?: string };
+  error?: string;
+  aborted?: boolean;
+  abortReason?: string;
+  outputPath?: string;
+  patchPath?: string;
+  branchName?: string;
+}
+
+/** On-disk subagent history recovered from a parent session's task toolResults. */
+export interface SubagentHistoryEntry {
+  id: string;
+  agent: string;
+  agentSource?: SubagentAgentSource;
+  status: 'started' | 'completed' | 'failed' | 'aborted';
+  task?: string;
+  assignment?: string;
+  description?: string;
+  index: number;
+  /** Id of the `task` call that spawned this agent, and that call's position in
+   * the session's sequence of `task` calls. Together with `index` they place the
+   * agent without relying on the order entries happen to arrive in. */
+  parentToolCallId?: string;
+  batchSeq?: number;
+  sessionFile?: string;
+  transcriptAvailable: boolean;
+  /** True when the spawn was detached/async (parent turn kept working). */
+  detached?: boolean;
+  lastIntent?: string;
+  toolCount?: number;
+  requests?: number;
+  tokens?: number;
+  contextTokens?: number;
+  contextWindow?: number;
+  cost?: number;
+  durationMs?: number;
+  modelOverride?: string | string[];
+  modelRole?: string;
+  resolvedModel?: string;
+  resolvedModelIsFallback?: boolean;
+  retryFailure?: { attempt: number; errorMessage: string };
+  result?: SubagentHistoryResult;
+}
+
+/** get_subagents snapshot (RpcSubagentSnapshot) as seen over the wire. */
+export interface SubagentSnapshotLike {
+  id: string;
+  index: number;
+  agent: string;
+  agentSource?: SubagentAgentSource;
+  description?: string;
+  status: 'started' | 'completed' | 'failed' | 'aborted' | 'pending' | 'running';
+  task?: string;
+  assignment?: string;
+  sessionFile?: string;
+  lastUpdate?: number;
+  progress?: unknown;
+  parentToolCallId?: string;
+}
+
+/**
+ * One roster row shared by live frames and on-disk history.
+ * Lives under app/types (not in the hook) so server-side helpers and the UI
+ * import the exact same shape.
+ */
+export interface SubagentInfo {
+  id: string;
+  agent: string;
+  agentSource?: SubagentAgentSource;
+  description?: string;
+  status: 'started' | 'completed' | 'failed' | 'aborted';
+  task?: string;
+  assignment?: string;
+  sessionFile?: string;
+  parentToolCallId?: string;
+  /** Position inside the spawning `task` call's batch. Restarts at 0 for every
+   * call, so it orders siblings but never the roster — pair it with `batchSeq`.
+   * Also the matching key for id-less progress frames. */
+  index: number;
+  detached?: boolean;
+  progress?: SubagentProgress;
+  lastUpdate?: number;
+  /** Settled result for history entries (SingleResult-derived). */
+  result?: SubagentHistoryResult;
+  /** Roster origin: live frames/snapshots (default) vs on-disk history. */
+  source?: 'live' | 'history';
+  /** Ordinal of the `task` call that spawned this agent, as recorded in the
+   * session file. Authoritative launch order, but only available once that
+   * call's result is on disk. */
+  batchSeq?: number;
+}
+
+/** get_subagent_messages response page (rpc-ui wire shape). */
+export interface SubagentMessagesPage {
+  /** Session file the messages were read from. */
+  sessionFile: string;
+  /** Byte offset this page starts at (0 = head of the transcript). */
+  fromByte: number;
+  /** Byte offset to pass as the next fromByte for continuation. */
+  nextByte: number;
+  /** True when the transcript shrank (retruncated) and paging must restart. */
+  reset?: boolean;
+  /** Raw omp messages — convert via `@/lib/omp/session/mapper` toChatMessage. */
+  messages: unknown[];
+  totalBytes?: number;
+}

package/src/shared/types/settings/agent.ts

@@ -0,0 +1,16 @@
+export type AgentMode = 'primary' | 'subagent' | 'all';
+export type AgentScope = 'system' | 'user' | 'project';
+
+export interface AgentItem {
+  id: string;
+  name: string;
+  description: string;
+  scope: AgentScope;
+  mode: AgentMode;
+  overrideModel?: string;
+  thinkingVariant?: string;
+  temperature?: number | null;
+  topP?: number | null;
+  systemPrompt: string;
+  isBuiltIn?: boolean;
+}

package/src/shared/types/settings/command.ts

@@ -0,0 +1,12 @@
+export type CommandScope = 'system' | 'user' | 'project';
+
+export interface CommandItem {
+  id: string;
+  name: string;
+  description: string;
+  scope: CommandScope;
+  overrideAgent?: string;
+  overrideModel?: string;
+  template: string;
+  isBuiltIn?: boolean;
+}

package/src/shared/types/settings/mcp.ts

@@ -0,0 +1,22 @@
+export type McpReachType = 'command' | 'link';
+export type McpScope = 'every-project' | 'this-project';
+
+export interface McpEnvVar {
+  id: string;
+  key: string;
+  value: string;
+}
+
+export interface McpServerItem {
+  id: string;
+  name: string;
+  scope: McpScope;
+  /** Absolute omp project root — meaningful only when scope is 'this-project'. */
+  projectPath?: string;
+  enabled: boolean;
+  reachType: McpReachType;
+  commandArgs: string[];
+  linkUrl?: string;
+  envVars: McpEnvVar[];
+  status?: 'active' | 'inactive' | 'error';
+}

package/src/shared/types/settings/project.ts

@@ -0,0 +1,18 @@
+export interface ProjectConfigItem {
+  id: string;
+  folderId?: number;
+  name: string;
+  path: string;
+  model: string;
+  accentColor: string;
+  icon: string;
+  customIconUrl?: string;
+  isPinned?: boolean;
+  isExpanded?: boolean;
+}
+
+export interface AccentColorOption {
+  label: string;
+  value: string;
+  bgHex: string;
+}

package/src/shared/types/settings/provider.ts

@@ -0,0 +1,42 @@
+export interface ProviderModel {
+  id: string;
+  name: string;
+  contextWindow: string; // e.g. "1M ctx · 384K out"
+  hasTools: boolean;
+  hasVision: boolean;
+  hasReasoning?: boolean;
+  isVisible: boolean;
+  /** USD per 1M tokens (unit of measure not obvious from the name alone). */
+  priceInput?: number;
+  priceOutput?: number;
+  temperature?: number;
+  maxTokens?: number;
+  topP?: number;
+  reasoningEffort?: 'low' | 'medium' | 'high';
+}
+
+export interface ProviderItem {
+  id: string;
+  name: string;
+  slug: string;
+  icon: string;
+  status: 'connected' | 'disconnected' | 'connecting';
+  /**
+   * Present in omp's own config.yml `disabledProviders`. A disabled provider is
+   * excluded from the chat model picker entirely — independent of `status`, which
+   * only says whether credentials resolve.
+   */
+  disabled?: boolean;
+  configuredIn: string; // e.g. "auth credentials", "api key", "environment"
+  apiKey?: string;
+  baseUrl?: string;
+  models: ProviderModel[];
+}
+
+export interface PresetProviderOption {
+  id: string;
+  name: string;
+  slug: string;
+  icon: string;
+  defaultUrl: string;
+}

package/src/shared/types/settings/skill.ts

@@ -0,0 +1,35 @@
+export type SkillLocation = 'user' | 'project';
+
+export interface SkillItem {
+  id: string;
+  name: string;
+  description: string;
+  location: SkillLocation;
+  locationLabel?: string;
+  group?: string;
+  instructions: string;
+  project: string;
+  isInstalledFromCatalog?: boolean;
+  catalogSource?: string;
+}
+
+export interface SkillCatalogSource {
+  id: string;
+  name: string;
+  repo: string;
+  stars: string;
+  updatedAt: string;
+  skillCount: number;
+  isCustom?: boolean;
+}
+
+export interface CatalogSkillItem {
+  id: string;
+  sourceId: string;
+  name: string;
+  description: string;
+  repoTag: string;
+  githubUrl?: string;
+  instructions?: string;
+  installed?: boolean;
+}

package/src/shared/types/settings/state.ts

@@ -0,0 +1,59 @@
+/** Wire protocol for the live agent event stream (chat timeline). */
+export type StreamTransport = 'websocket' | 'sse';
+
+export type SettingsCategoryId =
+  // OMPCHAMBER
+  | 'appearance'
+  | 'chats'
+  | 'notifications'
+  | 'usage'
+  | 'token-usage'
+  // WORKSPACE
+  | 'projects'
+  // OMP
+  | 'omp'
+  | 'providers'
+  | 'agents'
+  | 'behavior'
+  | 'commands'
+  | 'mcp'
+  // LIBRARY
+  | 'skills'
+  | 'skills-catalog';
+
+export interface SettingsCategoryItem {
+  id: SettingsCategoryId;
+  label: string;
+  iconName: string;
+  badge?: string;
+  section: 'OMPCHAMBER' | 'WORKSPACE' | 'OMP' | 'LIBRARY';
+  description?: string;
+}
+
+export interface SettingsState {
+  binaryPath: string;
+  showUpdateNotifications: boolean;
+  agentControlTool: boolean;
+  ompChamberWebTool: boolean;
+  theme: 'paper' | 'contrast' | 'noir' | 'one-dark-pro-soft';
+  fontSize: 'compact' | 'standard' | 'comfort';
+  editorFont: string;
+  streamResponses: boolean;
+  streamTransport: StreamTransport;
+  expandedThinking: boolean;
+  detailedToolCalls: boolean;
+  notificationsEnabled: boolean;
+  buildFailureAlert: boolean;
+  soundAlerts: boolean;
+  chatCompletionSound: boolean;
+  defaultWorkspacePath: string;
+  tunnelEnabled: boolean;
+  tunnelSubdomain: string;
+  activeProvider: string;
+  autoApproveSafeCmds: boolean;
+  autoPatchErrors: boolean;
+  followUpBehavior: 'queue' | 'steering';
+  keybindingSend: 'Enter' | 'Shift + Enter' | 'Ctrl / Cmd + Enter';
+  keybindingNewLine: 'Enter' | 'Shift + Enter' | 'Ctrl / Cmd + Enter';
+  keybindingSteering: 'Enter' | 'Shift + Enter' | 'Ctrl / Cmd + Enter';
+}

package/src/shared/types/settings/usage.ts

@@ -0,0 +1,99 @@
+/**
+ * Usage / balance contracts for the Settings → Usage panel.
+ *
+ * Served by `GET /api/settings/usage`. Both provider reports are always
+ * present; `configured` is false when the matching provider key is missing
+ * from Settings → Providers, and `error` carries a human-readable failure
+ * when the upstream call could not be completed.
+ */
+
+/** Fields shared by every provider report. */
+export interface UsageProviderStatus {
+  configured: boolean;
+  error?: string;
+}
+
+/** A single rolling quota window from kenari's plan (week / month / 5 hours). */
+export interface KenariQuotaWindow {
+  key: 'five_hour' | 'week' | 'month';
+  label: string;
+  usedRp: number;
+  remainingRp: number;
+  /** RFC 3339 UTC timestamp of the next roll. */
+  resetsAt: string;
+}
+
+/** An active kenari coupon, shown separately from the plan windows. */
+export interface KenariCoupon {
+  name: string;
+  usedRp: number;
+  /** Null when the coupon has no spending limit. */
+  remainingRp: number | null;
+  expiresAt: string;
+  scopeModels: string[];
+}
+
+/** kenari plan + coupon quota (`GET /v1/account/quota`). */
+export interface KenariQuota {
+  planName: string | null;
+  windows: KenariQuotaWindow[];
+  coupon: KenariCoupon | null;
+}
+
+/** One model row from the kenari 30-day usage report. */
+export interface KenariUsageRow {
+  model: string;
+  requests: number;
+  inputTokens: number;
+  outputTokens: number;
+  costRp: number;
+}
+
+/** kenari 30-day usage per model (`kenari_usage` MCP tool). */
+export interface KenariUsage {
+  rows: KenariUsageRow[];
+  totalRequests: number;
+  totalCostRp: number;
+  /** Raw text returned by the MCP tool, kept for display fallbacks. */
+  raw: string;
+}
+
+/** kenari wallet balance (`kenari_balance` MCP tool). */
+export interface KenariBalance {
+  /** Parsed Rupiah amount, or null when the text could not be parsed. */
+  amountRp: number | null;
+  /** Raw text returned by the MCP tool. */
+  raw: string;
+}
+
+export interface KenariUsageReport extends UsageProviderStatus {
+  balance?: KenariBalance;
+  usage?: KenariUsage;
+  quota?: KenariQuota;
+}
+
+/** One currency bucket from DeepSeek's balance response. */
+export interface DeepSeekBalanceEntry {
+  currency: string;
+  totalBalance: string;
+  grantedBalance: string;
+  toppedUpBalance: string;
+}
+
+/** DeepSeek prepaid balance (`GET https://api.deepseek.com/user/balance`). */
+export interface DeepSeekBalance {
+  isAvailable: boolean;
+  entries: DeepSeekBalanceEntry[];
+}
+
+export interface DeepSeekUsageReport extends UsageProviderStatus {
+  balance?: DeepSeekBalance;
+}
+
+/** Response body of `GET /api/settings/usage`. */
+export interface UsageReport {
+  isMock: boolean;
+  generatedAt: string;
+  kenari: KenariUsageReport;
+  deepseek: DeepSeekUsageReport;
+}

package/src/shared/types/terminal.ts

@@ -0,0 +1,19 @@
+export interface TerminalLogItem {
+  id: string;
+  command: string;
+  stdout?: string;
+  stderr?: string;
+  exitCode: number;
+  durationMs?: number;
+  timestamp: string;
+  cwd?: string;
+}
+
+export interface TerminalRunResponse {
+  stdout: string;
+  stderr: string;
+  exitCode: number;
+  durationMs: number;
+  cwd: string;
+  error?: string;
+}