@agentex/agent 0.0.10 → 0.0.11

package/dist/index.d.ts

@@ -17,8 +17,12 @@ export type { TempConfigResult, TempConfigOptions } from "./utils/runtime-config
 export { executeAll } from "./utils/execute-all.js";
 export type { ExecuteAllOptions, ExecuteAllTask } from "./utils/execute-all.js";
 export { getClaudeUnknownDetails, classifyClaudeAuthFromResult, CLAUDE_LOGIN_COMMAND, } from "./providers/claude/parse.js";
+export { getClaudeTranscriptPath, findClaudeTranscriptBySessionId, readClaudeTranscript, peekClaudeTranscript, claudeTranscriptOps, sanitizeProjectPath, resolveClaudeHome, canonicalizeCwd, MAX_SANITIZED_LENGTH, } from "./providers/claude/transcript.js";
+export type { GetClaudeTranscriptPathOptions, ClaudeTranscriptLocation, FindClaudeTranscriptOptions, FoundClaudeTranscript, ReadClaudeTranscriptOptions, ClaudeTranscriptYield, ClaudePeekResult, } from "./providers/claude/transcript.js";
+export { getCodexTranscriptPath, readCodexTranscript, peekCodexTranscript, readCodexCwd, codexTranscriptOps, parseCodexLine, resolveCodexHome, } from "./providers/codex/transcript.js";
+export type { GetCodexTranscriptPathOptions, CodexTranscriptLocation, ReadCodexTranscriptOptions, CodexTranscriptYield, CodexTranscriptLine, CodexPeekResult, } from "./providers/codex/transcript.js";
 export { installSkills, removeSkills, listInstalledSkills, resolveSkillsHome, resolveSkillsWorkspace, resolveNativeSkillsHome, resolveNativeSkillsWorkspace, ensureSkillSymlink, } from "./utils/skills.js";
-export type { ProviderModule, ProviderCapabilities, ExecutionContext, ExecutionResult, ExecutionStatus, ProviderConfig, McpServerConfig, StreamEvent, SessionCodec, SessionState, TokenUsage, ModelUsage, RateLimitInfo, BaseStreamEventFields, LifecycleEvent, QuotaStatus, QuotaContext, AuthMethod, AuthSource, AuthOption, AuthReport, AuthResolveContext, AuthIdentity, AuthRequiredReason, BinaryStatus, ProviderModel, SessionContext, AgentSession, TurnResult, UserInputRequest, UserInputResponse, ElicitationRequest, ElicitationResponse, HookCallbackRequest, HookCallbackResponse, } from "./types.js";
+export type { ProviderModule, ProviderCapabilities, ExecutionContext, ExecutionResult, ExecutionStatus, ProviderConfig, McpServerConfig, StreamEvent, SessionCodec, SessionState, TokenUsage, ModelUsage, RateLimitInfo, BaseStreamEventFields, LifecycleEvent, QuotaStatus, QuotaContext, AuthMethod, AuthSource, AuthOption, AuthReport, AuthResolveContext, AuthIdentity, AuthRequiredReason, BinaryStatus, ProviderModel, SessionContext, AgentSession, TurnResult, UserInputRequest, UserInputResponse, ElicitationRequest, ElicitationResponse, HookCallbackRequest, HookCallbackResponse, TranscriptOps, TranscriptYield, TranscriptPeek, FoundTranscript, } from "./types.js";
 export type { AskUserQuestion, QuestionOption, } from "./utils/ask-user-question.js";
 export type { ExitPlanModeRequest } from "./utils/exit-plan-mode.js";
 export type { SkillRuntime, SkillLocation, SkillChannel, InstallSkillsOptions, SkillInstallEntry, SkillInstallResult, RemoveSkillsOptions, SkillRemoveEntry, SkillRemoveResult, InstalledSkill, } from "./utils/skills.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAE,UAAU,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1F,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EACL,UAAU,EACV,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,SAAS,EACT,UAAU,EACV,UAAU,EACV,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EACL,uBAAuB,EACvB,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,cAAc,EACd,eAAe,EACf,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,UAAU,EACV,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,WAAW,EACX,YAAY,EACZ,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,eAAe,EACf,cAAc,GACf,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,YAAY,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,GACf,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -13,6 +13,8 @@ export { prepareWorkspace } from "./utils/workspace.js";
 export { withTempConfig } from "./utils/runtime-config.js";
 export { executeAll } from "./utils/execute-all.js";
 export { getClaudeUnknownDetails, classifyClaudeAuthFromResult, CLAUDE_LOGIN_COMMAND, } from "./providers/claude/parse.js";
+export { getClaudeTranscriptPath, findClaudeTranscriptBySessionId, readClaudeTranscript, peekClaudeTranscript, claudeTranscriptOps, sanitizeProjectPath, resolveClaudeHome, canonicalizeCwd, MAX_SANITIZED_LENGTH, } from "./providers/claude/transcript.js";
+export { getCodexTranscriptPath, readCodexTranscript, peekCodexTranscript, readCodexCwd, codexTranscriptOps, parseCodexLine, resolveCodexHome, } from "./providers/codex/transcript.js";
 // Skills
 export { installSkills, removeSkills, listInstalledSkills, resolveSkillsHome, resolveSkillsWorkspace, resolveNativeSkillsHome, resolveNativeSkillsWorkspace, ensureSkillSymlink, } from "./utils/skills.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY;AACZ,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAE,UAAU,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1F,OAAO,EACL,UAAU,EACV,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,SAAS,EACT,UAAU,EACV,UAAU,EACV,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,EACL,uBAAuB,EACvB,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AAErC,SAAS;AACT,OAAO,EACL,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY;AACZ,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAE,UAAU,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1F,OAAO,EACL,UAAU,EACV,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,SAAS,EACT,UAAU,EACV,UAAU,EACV,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,EACL,uBAAuB,EACvB,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,uBAAuB,EACvB,+BAA+B,EAC/B,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,GACrB,MAAM,kCAAkC,CAAC;AAU1C,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,gBAAgB,GACjB,MAAM,iCAAiC,CAAC;AAUzC,SAAS;AACT,OAAO,EACL,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,mBAAmB,CAAC"}

package/dist/providers/claude/index.d.ts

@@ -1,3 +1,5 @@
 import type { ProviderModule } from "../../types.js";
 export declare const claudeProvider: ProviderModule;
+export { getClaudeTranscriptPath, findClaudeTranscriptBySessionId, readClaudeTranscript, peekClaudeTranscript, claudeTranscriptOps, sanitizeProjectPath, resolveClaudeHome, canonicalizeCwd, MAX_SANITIZED_LENGTH, } from "./transcript.js";
+export type { GetClaudeTranscriptPathOptions, ClaudeTranscriptLocation, FindClaudeTranscriptOptions, FoundClaudeTranscript, ReadClaudeTranscriptOptions, ClaudeTranscriptYield, ClaudePeekResult, } from "./transcript.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/providers/claude/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/claude/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAA2D,MAAM,gBAAgB,CAAC;AAkB9G,eAAO,MAAM,cAAc,EAAE,cAiB5B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/claude/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAA2D,MAAM,gBAAgB,CAAC;AAmB9G,eAAO,MAAM,cAAc,EAAE,cAkB5B,CAAC;AAEF,OAAO,EACL,uBAAuB,EACvB,+BAA+B,EAC/B,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,8BAA8B,EAC9B,wBAAwB,EACxB,2BAA2B,EAC3B,qBAAqB,EACrB,2BAA2B,EAC3B,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC"}

package/dist/providers/claude/index.js

@@ -3,6 +3,7 @@ import { executeClaudeProvider } from "./execute.js";
 import { createClaudeSession } from "./session.js";
 import { claudeSessionCodec } from "./codec.js";
 import { buildEnv, ensurePathInEnv } from "../../utils/env.js";
+import { claudeTranscriptOps } from "./transcript.js";
 async function checkQuota(ctx) {
     const env = buildEnv(ctx.env);
     ensurePathInEnv(env);
@@ -30,5 +31,7 @@ export const claudeProvider = {
     resolveAuth: (ctx) => resolveAuthForProvider("claude", ctx),
     sessionCodec: claudeSessionCodec,
     checkQuota,
+    transcript: claudeTranscriptOps,
 };
+export { getClaudeTranscriptPath, findClaudeTranscriptBySessionId, readClaudeTranscript, peekClaudeTranscript, claudeTranscriptOps, sanitizeProjectPath, resolveClaudeHome, canonicalizeCwd, MAX_SANITIZED_LENGTH, } from "./transcript.js";
 //# sourceMappingURL=index.js.map

package/dist/providers/claude/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/claude/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE/D,KAAK,UAAU,UAAU,CAAC,GAAiB;IACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,eAAe,CAAC,GAAG,CAAC,CAAC;IACrB,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACvC,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,MAAM,KAAK,cAAc,IAAI,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC;QACvE,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE;KACrD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,IAAI,EAAE,QAAQ;IACd,YAAY,EAAE;QACZ,QAAQ,EAAE,IAAI;QACd,cAAc,EAAE,KAAK;QACrB,YAAY,EAAE,IAAI;QAClB,GAAG,EAAE,IAAI;QACT,MAAM,EAAE,IAAI;QACZ,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,IAAI;KACf;IACD,OAAO,EAAE,qBAAqB;IAC9B,aAAa,EAAE,CAAC,GAAmB,EAAyB,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC;IACvF,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,sBAAsB,CAAC,QAAQ,EAAE,GAAG,CAAC;IAC3D,YAAY,EAAE,kBAAkB;IAChC,UAAU;CACX,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/claude/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,KAAK,UAAU,UAAU,CAAC,GAAiB;IACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,eAAe,CAAC,GAAG,CAAC,CAAC;IACrB,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACvC,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,MAAM,KAAK,cAAc,IAAI,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC;QACvE,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE;KACrD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,IAAI,EAAE,QAAQ;IACd,YAAY,EAAE;QACZ,QAAQ,EAAE,IAAI;QACd,cAAc,EAAE,KAAK;QACrB,YAAY,EAAE,IAAI;QAClB,GAAG,EAAE,IAAI;QACT,MAAM,EAAE,IAAI;QACZ,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,IAAI;KACf;IACD,OAAO,EAAE,qBAAqB;IAC9B,aAAa,EAAE,CAAC,GAAmB,EAAyB,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC;IACvF,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,sBAAsB,CAAC,QAAQ,EAAE,GAAG,CAAC;IAC3D,YAAY,EAAE,kBAAkB;IAChC,UAAU;IACV,UAAU,EAAE,mBAAmB;CAChC,CAAC;AAEF,OAAO,EACL,uBAAuB,EACvB,+BAA+B,EAC/B,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,GACrB,MAAM,iBAAiB,CAAC"}

package/dist/providers/claude/transcript.d.ts

@@ -0,0 +1,202 @@
+/**
+ * Claude Code writes a durable JSONL transcript for every session under
+ * `<claudeHome>/projects/<sanitized-cwd>/<sessionId>.jsonl`. The on-disk lines
+ * use the same JSON shape Claude streams over stdout, so {@link parseStreamLine}
+ * handles them unchanged. These helpers cover the two parts the consuming
+ * host can't easily derive itself: where the file lives, and how to stream
+ * it back as `StreamEvent`s.
+ *
+ * Encoding rules are verified against Claude Code's open-source source
+ * (`sessionStoragePortable.ts:sanitizePath`):
+ *   1. Replace EVERY non-alphanumeric character with `-`
+ *      (not just `/` and `.` — also `_`, space, `:`, etc.)
+ *   2. If the sanitized name exceeds {@link MAX_SANITIZED_LENGTH} (200),
+ *      truncate and append a hash suffix
+ *   3. Canonicalize the cwd via `realpath` + NFC first so symlinks
+ *      (e.g. macOS `/tmp` → `/private/tmp`) resolve to the same project dir
+ *
+ * The CLI does not expose a flag for the transcript path; the only source of
+ * truth is the open-source `sessionStoragePortable.ts`.
+ */
+import type { StreamEvent, TranscriptOps } from "../../types.js";
+/**
+ * Maximum length of a sanitized project-directory name before truncation +
+ * hash suffix kicks in. Mirrors Claude Code's `MAX_SANITIZED_LENGTH`. Most
+ * filesystems cap individual filename segments at 255 bytes; the gap leaves
+ * room for the hash suffix.
+ */
+export declare const MAX_SANITIZED_LENGTH = 200;
+/**
+ * Encode an absolute path into Claude's project-directory name. Mirrors
+ * `sanitizePath` in Claude Code's open-source `sessionStoragePortable.ts`.
+ *
+ * @example
+ * sanitizeProjectPath("/Users/foo/bar")     // → "-Users-foo-bar"
+ * sanitizeProjectPath("/Users/foo/.config") // → "-Users-foo--config"
+ * sanitizeProjectPath("/Users/foo/my_app")  // → "-Users-foo-my-app"
+ *                                           //   (underscore is non-alphanumeric)
+ */
+export declare function sanitizeProjectPath(name: string): string;
+/**
+ * Resolve Claude's config home directory. Mirrors `getClaudeConfigHomeDir` in
+ * Claude Code, including the NFC normalization needed to keep paths consistent
+ * with macOS HFS+/APFS Unicode handling.
+ */
+export declare function resolveClaudeHome(override?: string): string;
+/**
+ * Canonicalize a cwd path to match what Claude Code stores. `realpath`
+ * resolves symlinks (`/tmp` → `/private/tmp` on macOS) and NFC unifies the
+ * two Unicode normalizations macOS accepts for filenames with accents.
+ *
+ * Returns the NFC-normalized input on `realpath` failure (e.g., directory
+ * was deleted after the session ran), since the directory name on disk was
+ * computed against whatever the cwd was at session start.
+ */
+export declare function canonicalizeCwd(cwd: string): Promise<string>;
+export interface GetClaudeTranscriptPathOptions {
+    /** Claude's session id (UUID). Same value as the `session_id` field on stream events. */
+    sessionId: string;
+    /**
+     * The working directory Claude was launched in. Canonicalized via `realpath`
+     * + NFC before encoding, matching Claude's own behavior.
+     */
+    cwd: string;
+    /**
+     * Override the Claude config home. Defaults to `$CLAUDE_CONFIG_DIR` or
+     * `~/.claude`. Useful in tests and for hosts pointing Claude at a
+     * non-standard home.
+     */
+    claudeHome?: string;
+}
+export interface ClaudeTranscriptLocation {
+    /** Absolute path to the JSONL file. May not exist on disk yet. */
+    filePath: string;
+    /** The project-directory name (sanitized cwd) under `<claudeHome>/projects/`. */
+    projectDir: string;
+    /** The canonicalized cwd that was used to compute {@link projectDir}. */
+    canonicalCwd: string;
+    /** The Claude config home that was used. */
+    claudeHome: string;
+}
+/**
+ * Compute the on-disk JSONL path for a Claude session. Performs `realpath`
+ * canonicalization on the cwd and applies the same encoding rules Claude
+ * Code uses internally.
+ *
+ * For cwd paths sanitized longer than {@link MAX_SANITIZED_LENGTH}, the
+ * deterministic djb2 hash suffix may not match what Claude wrote (Claude Code
+ * uses `Bun.hash` under Bun). If the exact path doesn't exist and the
+ * sanitized name was truncated, this function falls back to a prefix scan
+ * under `<claudeHome>/projects/` and returns the first matching directory.
+ */
+export declare function getClaudeTranscriptPath(opts: GetClaudeTranscriptPathOptions): Promise<ClaudeTranscriptLocation>;
+export interface FindClaudeTranscriptOptions {
+    /** Claude's session id (UUID). */
+    sessionId: string;
+    /** Override the Claude config home. */
+    claudeHome?: string;
+}
+export interface FoundClaudeTranscript {
+    /** Absolute path to the JSONL file. */
+    filePath: string;
+    /** The project-directory name (sanitized cwd) under `<claudeHome>/projects/`. */
+    projectDir: string;
+    /**
+     * The literal cwd Claude was launched with, recovered from the first
+     * `system.init` event in the transcript. `null` if the file has no init
+     * event (e.g., truncated transcript) or it never recorded a cwd.
+     *
+     * This is the only way to recover the original cwd — `projectDir` is the
+     * sanitized form, which is one-way (multiple cwds can collide on the same
+     * sanitized name, though it's rare).
+     */
+    cwd: string | null;
+}
+/**
+ * Scan `<claudeHome>/projects/*` looking for `<sessionId>.jsonl`. Use this
+ * when you have a session ID but don't know which cwd Claude was launched
+ * in — typical for resume-by-id flows.
+ *
+ * Session IDs are unique across project directories, so the first match is
+ * authoritative. The original cwd is recovered from the transcript's first
+ * `system.init` event (Claude writes one at session start carrying `cwd`).
+ *
+ * Returns `null` if no project directory contains the session file.
+ */
+export declare function findClaudeTranscriptBySessionId(opts: FindClaudeTranscriptOptions): Promise<FoundClaudeTranscript | null>;
+export interface ReadClaudeTranscriptOptions {
+    /** Absolute path to the JSONL file. */
+    filePath: string;
+    /**
+     * Byte offset to resume from. Must be line-aligned (the position immediately
+     * after a `\n`). Use an offset previously yielded by this function.
+     * Defaults to 0 (read from the start).
+     */
+    fromOffset?: number;
+    /**
+     * Defensive dedup: if set, skip events whose {@link StreamEvent.eventId}
+     * matches and any events from the same line. Useful when `fromOffset` is
+     * missing or stale; the consumer's unique-index on `eventId` makes
+     * duplicates safe anyway, but this saves a round trip.
+     *
+     * Behavior: drop events up to and including the first one whose eventId
+     * matches; resume yielding from the next line.
+     */
+    sinceEventId?: string;
+}
+export interface ClaudeTranscriptYield {
+    /** A parsed `StreamEvent` from the transcript. */
+    event: StreamEvent;
+    /**
+     * Byte offset immediately AFTER the trailing `\n` of the line this event
+     * came from. Pass this back as {@link ReadClaudeTranscriptOptions.fromOffset}
+     * to resume on the next line. Events sharing a line share an offset.
+     */
+    offset: number;
+}
+/**
+ * Stream-read a Claude transcript JSONL, yielding parsed `StreamEvent`s.
+ *
+ * Behavior:
+ * - Returns an empty async iterable if the file doesn't exist (no throw).
+ * - Skips wrapper types in {@link SKIP_ON_DISK_TYPES} (currently `queue-operation`).
+ * - Skips lines that fail to parse as JSON (`parseStreamLine` returns []).
+ * - Seeks into the file with `createReadStream` so multi-megabyte transcripts
+ *   don't load fully into memory.
+ *
+ * The yielded `offset` lets the caller checkpoint after each event and
+ * resume from that offset on the next call.
+ */
+export declare function readClaudeTranscript(opts: ReadClaudeTranscriptOptions): AsyncIterable<ClaudeTranscriptYield>;
+export interface ClaudePeekResult {
+    /** Last successfully parsed event, or null if the file is empty/missing/unparseable. */
+    lastEvent: StreamEvent | null;
+    /** Total size of the file in bytes, or null if the file is missing. */
+    size: number | null;
+}
+/**
+ * Drift-check primitive. Reads up to {@link PEEK_TAIL_BYTES} from the end of
+ * the file, parses the last complete line, and returns the last event plus
+ * total file size.
+ *
+ * Does NOT stream the whole file — designed to be called frequently as a
+ * cheap "has this changed since I last checked?" probe. Walks back through
+ * the buffer if the last line is a skipped wrapper type or fails to parse.
+ *
+ * Returns `{ lastEvent: null, size }` if the tail buffer holds no parseable
+ * line — caller should fall back to a full read if it needs guaranteed data.
+ */
+export declare function peekClaudeTranscript(filePath: string): Promise<ClaudePeekResult>;
+/**
+ * Polymorphic transcript ops for Claude. Delegates to the named functions
+ * above; mounted as `claudeProvider.transcript` so apps doing runtime-
+ * dispatched recovery can call `getProvider(name).transcript.find(...)`
+ * without a switch statement.
+ *
+ * Apps that know they're on Claude at compile time should prefer the named
+ * helpers (`getClaudeTranscriptPath`, `findClaudeTranscriptBySessionId`) —
+ * they return richer types (`canonicalCwd`, `projectDir`, `claudeHome`) that
+ * the polymorphic interface flattens away.
+ */
+export declare const claudeTranscriptOps: TranscriptOps<StreamEvent>;
+//# sourceMappingURL=transcript.d.ts.map

package/dist/providers/claude/transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../../src/providers/claude/transcript.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AASH,OAAO,KAAK,EAAmB,WAAW,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGlF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAC;AA4BxC;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAM3D;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMlE;AAMD,MAAM,WAAW,8BAA8B;IAC7C,yFAAyF;IACzF,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,8BAA8B,GACnC,OAAO,CAAC,wBAAwB,CAAC,CAqCnC;AAMD,MAAM,WAAW,2BAA2B;IAC1C,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;OAQG;IACH,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,+BAA+B,CACnD,IAAI,EAAE,2BAA2B,GAChC,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAuBvC;AAkED,MAAM,WAAW,2BAA2B;IAC1C,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,KAAK,EAAE,WAAW,CAAC;IACnB;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAuB,oBAAoB,CACzC,IAAI,EAAE,2BAA2B,GAChC,aAAa,CAAC,qBAAqB,CAAC,CAuDtC;AAmBD,MAAM,WAAW,gBAAgB;IAC/B,wFAAwF;IACxF,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;IAC9B,uEAAuE;IACvE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiDtF;AAMD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,WAAW,CAwB1D,CAAC"}