feat(composer): replicate WorkBuddy branch label and context usage (TODO 21)

src/shared/types.ts

@@ -125,11 +125,39 @@ export type ChatEvent = { sessionId?: string; turnDurationMs?: number } & (
   | { runId: string; type: 'interaction'; interaction: ChatInteraction }
   | { runId: string; type: 'tool_call'; call: ToolCallRecord }
   | { runId: string; type: 'tool_result'; call: ToolCallRecord }
+  | { runId: string; type: 'usage'; usage: TokenUsage }
   | { runId: string; type: 'done'; content: string; tools: ToolCallRecord[] }
   | { runId: string; type: 'cancelled' }
   | { runId: string; type: 'error'; message: string }
 )
 
+/**
+ * 上游返回的真实 token 用量（Responses `response.completed.usage`）。
+ * 只做透传，不做估算：拿不到就不产生该事件。
+ */
+export interface TokenUsage {
+  inputTokens: number
+  outputTokens: number
+  totalTokens: number
+  cachedTokens?: number
+}
+
+/**
+ * 会话工作目录的 Git 信息（用于对话框的分支标签）。
+ * `repo: false` 表示该目录不在 Git 仓库内；`detached: true` 时 `branch` 为空、`head` 为短 SHA。
+ */
+export interface GitBranchInfo {
+  /** 目录是否位于 Git 工作树内 */
+  repo: boolean
+  /** 分支名；detached HEAD 或尚无提交时为 null */
+  branch: string | null
+  detached: boolean
+  /** detached HEAD 的短 SHA；无提交时为 null */
+  head: string | null
+  /** git 可执行文件缺失或命令超时时为 true，UI 不显示分支标签 */
+  unavailable?: boolean
+}
+
 /** 一次会话的元信息 */
 export interface SessionMeta {
   id: string