@groundtrack/hooks 0.1.9 → 0.1.10

package/src/agents.ts

@@ -6,10 +6,57 @@ export const AGENTS = [
     aliases: ["claude-code"],
     source: "claude_code",
     enrichment: "command",
+    sessionImport: {
+      cli: true,
+      web: {
+        extension: ".jsonl",
+        accept: ".jsonl",
+        fileLabel: "Claude Code session JSONL",
+        location: "~/.claude/projects/<project>/*.jsonl",
+      },
+    },
+  },
+  {
+    id: "codex",
+    name: "Codex",
+    aliases: [],
+    source: "codex",
+    enrichment: "command",
+    sessionImport: {
+      cli: true,
+      web: {
+        extension: ".jsonl",
+        accept: ".jsonl",
+        fileLabel: "Codex rollout JSONL",
+        location: "~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl",
+      },
+    },
+  },
+  {
+    id: "cursor",
+    name: "Cursor",
+    aliases: [],
+    source: "cursor",
+    enrichment: "command",
+    sessionImport: { cli: true, web: null },
+  },
+  {
+    id: "opencode",
+    name: "OpenCode",
+    aliases: [],
+    source: "opencode",
+    enrichment: "plugin",
+    sessionImport: {
+      cli: true,
+      web: {
+        extension: ".json",
+        accept: ".json,application/json",
+        fileLabel: "OpenCode session export JSON",
+        location: "opencode export <session-id> --pure > opencode-session.json",
+        note: "Use direct file redirection as shown. Do not add --sanitize; Groundtrack removes sensitive records during import.",
+      },
+    },
   },
-  { id: "codex", name: "Codex", aliases: [], source: "codex", enrichment: "command" },
-  { id: "cursor", name: "Cursor", aliases: [], source: "cursor", enrichment: "command" },
-  { id: "opencode", name: "OpenCode", aliases: [], source: "opencode", enrichment: "plugin" },
 ] as const;
 
 export type AgentDefinition = (typeof AGENTS)[number];
@@ -17,6 +64,29 @@ export type Agent = AgentDefinition["id"];
 export type CommandHookAgent = Extract<AgentDefinition, { enrichment: "command" }>["id"];
 export const AGENT_IDS = AGENTS.map((agent) => agent.id);
 
+export type SessionImportAgentDefinition = Extract<
+  AgentDefinition,
+  { sessionImport: { cli: true } }
+>;
+export type SessionImportAgent = SessionImportAgentDefinition["id"];
+export type AgentSessionSource = SessionImportAgentDefinition["source"];
+export type WebSessionImportAgentDefinition = Extract<
+  SessionImportAgentDefinition,
+  { sessionImport: { web: object } }
+>;
+export type WebSessionImportSource = WebSessionImportAgentDefinition["source"];
+
+export const SESSION_IMPORT_AGENTS = AGENTS.filter(
+  (agent): agent is SessionImportAgentDefinition => agent.sessionImport.cli,
+);
+export const WEB_SESSION_IMPORT_AGENTS = SESSION_IMPORT_AGENTS.filter(
+  (agent): agent is WebSessionImportAgentDefinition => agent.sessionImport.web !== null,
+);
+export const WEB_SESSION_IMPORT_SOURCES = WEB_SESSION_IMPORT_AGENTS.map((agent) => agent.source);
+
+export const DEFAULT_SESSION_IMPORT_AGENT: SessionImportAgent = "codex";
+export const DEFAULT_WEB_SESSION_IMPORT_SOURCE: WebSessionImportSource = "codex";
+
 export function isAgent(value: unknown): value is Agent {
   return AGENTS.some((agent) => agent.id === value);
 }
@@ -27,6 +97,37 @@ export function resolveAgent(value: string): AgentDefinition | undefined {
   );
 }
 
+export function isSessionImportAgent(value: string): value is SessionImportAgent {
+  return SESSION_IMPORT_AGENTS.some((agent) => agent.id === value);
+}
+
+function isAgentSessionSource(value: string): value is AgentSessionSource {
+  return SESSION_IMPORT_AGENTS.some((agent) => agent.source === value);
+}
+
+export function normalizeAgentSessionSource(value: string): AgentSessionSource | undefined {
+  const source = value === "codex_cli" ? "codex" : value;
+  return isAgentSessionSource(source) ? source : undefined;
+}
+
+export function isWebSessionImportSource(value: string): value is WebSessionImportSource {
+  return WEB_SESSION_IMPORT_AGENTS.some((agent) => agent.source === value);
+}
+
+export function resolveSessionImportAgentFromSource(
+  source: string | undefined,
+): SessionImportAgentDefinition | undefined {
+  return SESSION_IMPORT_AGENTS.find((agent) => agent.source === source);
+}
+
+export function webSessionImportAgentFromSource(
+  source: WebSessionImportSource,
+): WebSessionImportAgentDefinition {
+  const agent = WEB_SESSION_IMPORT_AGENTS.find((candidate) => candidate.source === source);
+  if (!agent) throw new Error(`Unsupported web session import source: ${source}`);
+  return agent;
+}
+
 export function agentFromClientName(value: string | null | undefined): AgentDefinition | undefined {
   const normalized = value?.trim().toLowerCase() ?? "";
   return AGENTS.find((agent) => normalized.includes(agent.id));