@zzusp/ccsm 1.0.0

package/shared/types.ts

@@ -0,0 +1,359 @@
+export interface ProjectSummary {
+  id: string;
+  encodedCwd: string;
+  decodedCwd: string;
+  cwdResolved: boolean;
+  sessionCount: number;
+  totalBytes: number;
+  lastActiveAt: string | null;
+}
+
+export interface RelatedBytes {
+  jsonl: number;
+  subdir: number;
+  fileHistory: number;
+  sessionEnv: number;
+}
+
+export interface SessionSummary {
+  id: string;
+  projectId: string;
+  /** Auto-derived: latest `ai-title` record, falling back to first user message. */
+  title: string;
+  /** User-set name (Claude Code's `custom-title` record); null if never renamed. */
+  customTitle: string | null;
+  firstAt: string | null;
+  /** Last activity: max(latest record timestamp, file mtime) — matches `claude code resume`. */
+  lastAt: string | null;
+  messageCount: number;
+  bytes: number;
+  relatedBytes: RelatedBytes;
+  isLivePid: boolean;
+  isRecentlyActive: boolean;
+  livePid: number | null;
+}
+
+export type Block =
+  | { type: 'text'; text: string }
+  | { type: 'tool_use'; id: string; name: string; input: unknown }
+  | { type: 'tool_result'; toolUseId: string; content: string; isError: boolean }
+  | { type: 'thinking'; text: string }
+  | { type: 'image'; mediaType: string | null }
+  | { type: 'unknown'; raw: unknown };
+
+export interface Message {
+  uuid: string;
+  parentUuid: string | null;
+  type: 'user' | 'assistant';
+  ts: string | null;
+  model: string | null;
+  blocks: Block[];
+  isMeta: boolean;
+}
+
+export interface SessionMeta {
+  sessionId: string;
+  projectId: string;
+  cwd: string | null;
+  gitBranch: string | null;
+  version: string | null;
+  firstAt: string | null;
+  /** Last activity: max(latest record timestamp, file mtime) — matches `claude code resume`. */
+  lastAt: string | null;
+  messageCount: number;
+  bytes: number;
+  /** Auto-derived: latest `ai-title` record, falling back to first user message. */
+  title: string;
+  /** User-set name; null if never renamed. */
+  customTitle: string | null;
+}
+
+export interface SessionDetail {
+  meta: SessionMeta;
+  messages: Message[];
+  truncated: boolean;
+}
+
+export interface DeleteRequestItem {
+  projectId: string;
+  sessionId: string;
+}
+
+export interface DeletedItem extends DeleteRequestItem {
+  freedBytes: number;
+  cleaned: string[];
+  relatedBytes: RelatedBytes;
+}
+
+export interface SkippedItem extends DeleteRequestItem {
+  reason: string;
+}
+
+export interface DeleteResult {
+  deleted: DeletedItem[];
+  skipped: SkippedItem[];
+  historyLinesRemoved: number;
+}
+
+export interface DeleteProjectResult extends DeleteResult {
+  /** True only when the project directory itself was removed (all sessions cleared). */
+  projectDirRemoved: boolean;
+}
+
+export interface RevealProjectResult {
+  ok: true;
+  path: string;
+}
+
+export interface DiskUsageProjectRow {
+  projectId: string;
+  decodedCwd: string;
+  totalBytes: number;
+  sessionCount: number;
+}
+
+export interface DiskUsageMonthRow {
+  month: string;
+  totalBytes: number;
+  sessionCount: number;
+}
+
+export interface DiskUsageTopSession {
+  projectId: string;
+  sessionId: string;
+  title: string;
+  customTitle: string | null;
+  totalBytes: number;
+  lastAt: string | null;
+}
+
+export interface DiskUsage {
+  byProject: DiskUsageProjectRow[];
+  byMonth: DiskUsageMonthRow[];
+  topSessions: DiskUsageTopSession[];
+  totalBytes: number;
+  totalSessions: number;
+}
+
+export type MemoryType = 'user' | 'feedback' | 'project' | 'reference';
+
+export interface MemoryEntry {
+  filename: string;
+  name: string | null;
+  description: string | null;
+  type: MemoryType | null;
+  body: string;
+  bytes: number;
+  mtime: string | null;
+}
+
+export interface MemoryResponse {
+  index: string | null;
+  entries: MemoryEntry[];
+}
+
+export interface HealthResponse {
+  ok: boolean;
+  claudeRoot: string;
+  claudeRootExists: boolean;
+  platform: string;
+  node: string;
+  pid: number;
+}
+
+// ── Cross-device share: export/import bundles ───────────────────────────────
+//
+// A bundle is a path-INDEPENDENT folder a user copies / commits-to-git / cloud-
+// syncs between devices. The structural absolute path is replaced with a sentinel
+// (`placeholder`) on export and substituted with the local path on import:
+//   - session `.jsonl` lines carry the project root in their `cwd` field
+//   - `history.jsonl` lines carry it in their `project` field (different name!)
+
+export const BUNDLE_KIND = 'claude-session-bundle' as const;
+export const BUNDLE_SCHEMA_VERSION = 1 as const;
+
+export interface BundleFileMeta {
+  /** sha256 of the bytes as written into the bundle (sentinel form). */
+  sha256: string;
+  /** Line count for .jsonl / .ndjson members. */
+  lines: number;
+  bytes: number;
+}
+
+export interface BundleMemoryFileMeta {
+  filename: string;
+  /** True only for the MEMORY.md index. */
+  isIndex: boolean;
+  sha256: string;
+  bytes: number;
+}
+
+export interface BundleMemoryInventory {
+  hasIndex: boolean;
+  entries: BundleMemoryFileMeta[];
+}
+
+export interface BundleSessionMeta {
+  sessionId: string;
+  title: string;
+  customTitle: string | null;
+  firstAt: string | null;
+  lastAt: string | null;
+  messageCount: number;
+  /** True if at least one conversation line had its `cwd` replaced by the sentinel. */
+  cwdRewritten: boolean;
+  conversation: BundleFileMeta;
+  /** Null when no history.jsonl lines matched this session. */
+  history: BundleFileMeta | null;
+}
+
+export interface BundleSource {
+  platform: string;
+  pathSep: string;
+  projectId: string;
+  cwd: string;
+  cwdResolvedAtExport: boolean;
+}
+
+export interface BundleManifest {
+  schemaVersion: number;
+  kind: typeof BUNDLE_KIND;
+  exportedAt: string;
+  /** The literal sentinel string standing in for the project root. */
+  placeholder: string;
+  source: BundleSource;
+  memory: BundleMemoryInventory;
+  sessions: BundleSessionMeta[];
+}
+
+export interface ExportRequest {
+  projectId: string;
+  /** Session ids to include; null/'all' exports every session in the project. */
+  sessionIds: string[] | 'all';
+  destDir: string;
+}
+
+export interface ExportResult {
+  destDir: string;
+  sessionsExported: number;
+  memoryFilesExported: number;
+  historyLinesExported: number;
+  totalBytes: number;
+}
+
+export type ImportCollisionPolicy = 'skip' | 'overwrite-if-newer' | 'keep-both';
+
+export interface ImportTargetSuggestion {
+  cwd: string;
+  projectId: string;
+  reason: 'existing-project' | 'original-path' | 'same-basename';
+  /** True if the directory currently resolves on disk. */
+  resolved: boolean;
+}
+
+export interface ImportRemapPlan {
+  sourceCwd: string;
+  targetCwd: string;
+  targetProjectId: string;
+  /** True if a project dir already exists locally for the target id. */
+  targetProjectExists: boolean;
+}
+
+export type ImportSessionAction = 'create' | 'skip' | 'overwrite' | 'keep-both';
+
+export interface ImportSessionPlan {
+  sessionId: string;
+  title: string;
+  action: ImportSessionAction;
+  /** Present for skip; explains why. */
+  reason?: string;
+  /** For keep-both: the freshly minted session id the copy lands under. */
+  newSessionId?: string;
+  isLivePid: boolean;
+  isRecentlyActive: boolean;
+  /** Local lastAt when a same-id session already exists (drives overwrite-if-newer). */
+  localLastAt: string | null;
+  bundleLastAt: string | null;
+}
+
+export type ImportMemoryAction = 'create' | 'skip' | 'conflict';
+
+export interface ImportMemoryPlan {
+  filename: string;
+  isIndex: boolean;
+  action: ImportMemoryAction;
+  /** For conflict: the alternate filename the incoming copy will be written as. */
+  writtenAs?: string;
+}
+
+export interface ImportPreviewRequest {
+  bundleDir: string;
+  /** Omit to let the server pick the best-suggested target. */
+  targetCwd?: string;
+  collisionPolicy: ImportCollisionPolicy;
+}
+
+export interface ImportPreviewResult {
+  source: BundleSource;
+  remap: ImportRemapPlan;
+  suggestions: ImportTargetSuggestion[];
+  sessions: ImportSessionPlan[];
+  memory: ImportMemoryPlan[];
+  historyLinesToAdd: number;
+}
+
+export interface ImportCommitRequest {
+  bundleDir: string;
+  targetCwd: string;
+  collisionPolicy: ImportCollisionPolicy;
+}
+
+export interface ImportedSession {
+  sessionId: string;
+  action: ImportSessionAction;
+  newSessionId?: string;
+}
+
+export interface ImportResult {
+  targetProjectId: string;
+  targetCwd: string;
+  imported: ImportedSession[];
+  skipped: SkippedItem[];
+  historyLinesAdded: number;
+  memoryWritten: string[];
+}
+
+export type SearchBlockKind = 'text' | 'tool_use' | 'tool_result' | 'thinking';
+
+export interface SearchSnippet {
+  uuid: string;
+  ts: string | null;
+  role: 'user' | 'assistant';
+  blockKind: SearchBlockKind;
+  before: string;
+  match: string;
+  after: string;
+}
+
+export interface SearchSessionHit {
+  type: 'session';
+  projectId: string;
+  sessionId: string;
+  projectDecodedCwd: string;
+  title: string;
+  customTitle: string | null;
+  lastAt: string | null;
+  /** True if the per-session snippet cap was hit; UI shows "+more". */
+  hasMore: boolean;
+  snippets: SearchSnippet[];
+}
+
+export interface SearchDone {
+  type: 'done';
+  scanned: number;
+  matched: number;
+  durationMs: number;
+  truncated: boolean;
+}
+
+export type SearchEvent = SearchSessionHit | SearchDone;