subrouter-cli 0.0.0-stage → 0.1.0

package/src/types.ts

@@ -0,0 +1,73 @@
+// Shared normalized types — everything above the adapters speaks these.
+// Only the adapters in src/adapters/ know wire shapes.
+
+import type { EffortLevel } from './effort.ts';
+import type { ImageAttachment } from './images.ts';
+
+export type Dialect = 'openai' | 'anthropic';
+export type AnthropicThinkingBlock =
+  | { type: 'thinking'; thinking: string; signature: string }
+  | { type: 'redacted_thinking'; data: string };
+export type Role = 'system' | 'user' | 'assistant' | 'tool';
+
+export interface ToolCall {
+  id: string;
+  name: string;
+  /** Parsed arguments; {} plus argumentsInvalid on malformed JSON. */
+  arguments: Record<string, unknown>;
+  /** Raw JSON string as received from the wire, for faithful echo-back. */
+  argumentsJson: string;
+  argumentsInvalid?: boolean;
+}
+
+export interface ChatMessage {
+  role: Role;
+  content: string;
+  images?: ImageAttachment[]; // explicit user attachments; output remains text-only
+  toolCalls?: ToolCall[]; // assistant only
+  thinkingBlocks?: AnthropicThinkingBlock[]; // signed provider blocks, never displayed
+  toolCallId?: string; // tool role only
+  isError?: boolean; // tool role; maps to is_error on the anthropic wire
+}
+
+export interface ToolDefinition {
+  name: string;
+  description: string;
+  parameters: Record<string, unknown>; // JSON Schema object
+  requiresApproval: boolean;
+  approvalScope?: 'always'; // per-call authorization, never covered by file approve-all
+}
+
+export type StopReason = 'stop' | 'tool_calls' | 'length' | 'refusal' | 'unknown';
+
+export interface TokenUsage {
+  inputTokens: number;
+  outputTokens: number;
+}
+
+// One wire chunk, dialect-agnostic and order-preserving.
+// 'reasoning' carries thinking/reasoning deltas (openai reasoning_content, anthropic
+// thinking_delta) — kept separate from answers and hidden by the REPL.
+export type StreamEvent =
+  | { kind: 'text'; text: string }
+  | { kind: 'reasoning'; text: string }
+  | { kind: 'tool_call_start'; index: number; id: string; name: string }
+  | { kind: 'tool_call_args'; index: number; delta: string }
+  | { kind: 'stop'; stopReason: StopReason; usage?: TokenUsage };
+
+export interface AssistantTurn {
+  message: ChatMessage;
+  stopReason: StopReason;
+  usage?: TokenUsage;
+}
+
+export interface ChatRequest {
+  model: string;
+  dialect: Dialect;
+  messages: ChatMessage[]; // full conversation, excluding the system prompt
+  system: string;
+  tools?: ToolDefinition[];
+  stream: boolean;
+  maxTokens?: number;
+  effort?: EffortLevel;
+}