npm - open-multi-agent-kit - Versions diffs - 0.80.7 → 0.90.0 - Mend

open-multi-agent-kit 0.80.7 → 0.90.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1494) hide show

package/dist/core/semantic-cache-policy.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"semantic-cache-policy.d.ts","sourceRoot":"","sources":["../../src/core/semantic-cache-policy.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mCAAmC,8GAMtC,CAAC;AAEX,eAAO,MAAM,yCAAyC,gSA0B5C,CAAC;AAEX,eAAO,MAAM,qCAAqC,gYAuCxC,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,mCAAmC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1F,MAAM,MAAM,yBAAyB,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,GAAG,aAAa,CAAC;AAExF,MAAM,WAAW,8BAA8B;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,yBAAyB,CAAC;IACzC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,4BAA4B,CAAC;IAC5C,eAAe,CAAC,EAAE,8BAA8B,CAAC;IACjD,iBAAiB,CAAC,EAAE,8BAA8B,CAAC;CACnD;AAED,MAAM,MAAM,yBAAyB,GAClC,UAAU,GACV,UAAU,GACV,oBAAoB,GACpB,wBAAwB,GACxB,oBAAoB,GACpB,oBAAoB,GACpB,qBAAqB,GACrB,mBAAmB,GACnB,iBAAiB,GACjB,qBAAqB,GACrB,iBAAiB,GACjB,2BAA2B,GAC3B,oBAAoB,GACpB,2BAA2B,GAC3B,wBAAwB,GACxB,uBAAuB,GACvB,kCAAkC,CAAC;AAEtC,MAAM,MAAM,kCAAkC,GAC3C,eAAe,GACf,2BAA2B,GAC3B,6BAA6B,GAC7B,6BAA6B,GAC7B,mCAAmC,GACnC,qCAAqC,GACrC,qCAAqC,GACrC,4BAA4B,GAC5B,8BAA8B,GAC9B,8BAA8B,CAAC;AAElC,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,yBAAyB,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gCAAgC;IAChD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,kCAAkC,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,8BAA8B,CAAC;CACjD;AAwBD,wBAAgB,gCAAgC,CAAC,SAAS,EAAE,sBAAsB,GAAG,2BAA2B,CAkD/G;AAED,wBAAgB,+BAA+B,CAC9C,eAAe,EAAE,8BAA8B,GAAG,SAAS,EAC3D,iBAAiB,EAAE,8BAA8B,GAAG,SAAS,GAC3D,gCAAgC,CAsBlC","sourcesContent":["export const ALLOWED_SEMANTIC_CACHE_TASK_CLASSES = [\n\t\"faq\",\n\t\"read_only_analysis\",\n\t\"documentation_lookup\",\n\t\"code_explanation\",\n\t\"conceptual_explanation\",\n] as const;\n\nexport const FORBIDDEN_SEMANTIC_CACHE_TASK_CLASS_TERMS = [\n\t\"mutation\",\n\t\"mutating\",\n\t\"write\",\n\t\"edit\",\n\t\"create\",\n\t\"update\",\n\t\"delete\",\n\t\"deploy\",\n\t\"deployment\",\n\t\"release\",\n\t\"publish\",\n\t\"auth\",\n\t\"authentication\",\n\t\"authorization\",\n\t\"security\",\n\t\"secret\",\n\t\"credential\",\n\t\"token\",\n\t\"time\",\n\t\"clock\",\n\t\"date\",\n\t\"external\",\n\t\"network\",\n\t\"database\",\n\t\"stateful\",\n] as const;\n\nexport const FORBIDDEN_SEMANTIC_CACHE_ACTION_TERMS = [\n\t\"mutation\",\n\t\"mutate\",\n\t\"write\",\n\t\"edit\",\n\t\"create\",\n\t\"update\",\n\t\"delete\",\n\t\"patch\",\n\t\"modify\",\n\t\"commit\",\n\t\"merge\",\n\t\"rebase\",\n\t\"push\",\n\t\"deploy\",\n\t\"release\",\n\t\"publish\",\n\t\"login\",\n\t\"logout\",\n\t\"auth\",\n\t\"authorize\",\n\t\"token\",\n\t\"secret\",\n\t\"credential\",\n\t\"security\",\n\t\"scan\",\n\t\"audit\",\n\t\"time\",\n\t\"now\",\n\t\"today\",\n\t\"current\",\n\t\"latest\",\n\t\"fetch\",\n\t\"request\",\n\t\"web\",\n\t\"network\",\n\t\"api\",\n\t\"database\",\n\t\"external\",\n] as const;\n\nexport type SemanticCacheTaskClass = (typeof ALLOWED_SEMANTIC_CACHE_TASK_CLASSES)[number];\n\nexport type SemanticCacheResponseKind = \"final\" \| \"draft\" \| \"tool_call\" \| \"tool_result\";\n\nexport interface SemanticCacheContextAttributes {\n\tbranch?: string;\n\tworktree?: string;\n\trepoSha?: string;\n}\n\nexport interface SemanticCacheDependencyFlags {\n\tmutation?: boolean;\n\tdeploy?: boolean;\n\tauth?: boolean;\n\tsecurity?: boolean;\n\ttime?: boolean;\n\texternalState?: boolean;\n}\n\nexport interface SemanticCacheCandidate {\n\tenabled?: boolean;\n\tresponseKind?: SemanticCacheResponseKind;\n\tresponseReadOnly?: boolean;\n\tpendingToolCallCount?: number;\n\ttaskClass?: string;\n\taction?: string;\n\tactions?: readonly string[];\n\tdependencies?: SemanticCacheDependencyFlags;\n\tcacheAttributes?: SemanticCacheContextAttributes;\n\tcurrentAttributes?: SemanticCacheContextAttributes;\n}\n\nexport type SemanticCachePolicyReason =\n\t\| \"eligible\"\n\t\| \"disabled\"\n\t\| \"response.not_final\"\n\t\| \"response.not_read_only\"\n\t\| \"tool_calls.unknown\"\n\t\| \"tool_calls.pending\"\n\t\| \"dependence.mutation\"\n\t\| \"dependence.deploy\"\n\t\| \"dependence.auth\"\n\t\| \"dependence.security\"\n\t\| \"dependence.time\"\n\t\| \"dependence.external_state\"\n\t\| \"task_class.missing\"\n\t\| \"task_class.forbidden_term\"\n\t\| \"task_class.not_allowed\"\n\t\| \"action.forbidden_term\"\n\t\| SemanticCacheAttributePolicyReason;\n\nexport type SemanticCacheAttributePolicyReason =\n\t\| \"attributes.ok\"\n\t\| \"attributes.missing_branch\"\n\t\| \"attributes.missing_worktree\"\n\t\| \"attributes.missing_repo_sha\"\n\t\| \"attributes.missing_current_branch\"\n\t\| \"attributes.missing_current_worktree\"\n\t\| \"attributes.missing_current_repo_sha\"\n\t\| \"attributes.branch_mismatch\"\n\t\| \"attributes.worktree_mismatch\"\n\t\| \"attributes.repo_sha_mismatch\";\n\nexport interface SemanticCachePolicyDecision {\n\teligible: boolean;\n\treason: SemanticCachePolicyReason;\n\tdetail?: string;\n}\n\nexport interface SemanticCacheAttributeValidation {\n\tvalid: boolean;\n\treason: SemanticCacheAttributePolicyReason;\n\tattribute?: keyof SemanticCacheContextAttributes;\n}\n\ntype RequiredAttribute = keyof SemanticCacheContextAttributes;\n\nconst REQUIRED_ATTRIBUTES: readonly RequiredAttribute[] = [\"branch\", \"worktree\", \"repoSha\"];\n\nconst MISSING_CACHE_ATTRIBUTE_REASONS: Record<RequiredAttribute, SemanticCacheAttributePolicyReason> = {\n\tbranch: \"attributes.missing_branch\",\n\tworktree: \"attributes.missing_worktree\",\n\trepoSha: \"attributes.missing_repo_sha\",\n};\n\nconst MISSING_CURRENT_ATTRIBUTE_REASONS: Record<RequiredAttribute, SemanticCacheAttributePolicyReason> = {\n\tbranch: \"attributes.missing_current_branch\",\n\tworktree: \"attributes.missing_current_worktree\",\n\trepoSha: \"attributes.missing_current_repo_sha\",\n};\n\nconst ATTRIBUTE_MISMATCH_REASONS: Record<RequiredAttribute, SemanticCacheAttributePolicyReason> = {\n\tbranch: \"attributes.branch_mismatch\",\n\tworktree: \"attributes.worktree_mismatch\",\n\trepoSha: \"attributes.repo_sha_mismatch\",\n};\n\nexport function classifySemanticCacheEligibility(candidate: SemanticCacheCandidate): SemanticCachePolicyDecision {\n\tif (candidate.enabled !== true) {\n\t\treturn deny(\"disabled\");\n\t}\n\n\tif (candidate.responseKind !== \"final\") {\n\t\treturn deny(\"response.not_final\");\n\t}\n\n\tif (candidate.responseReadOnly !== true) {\n\t\treturn deny(\"response.not_read_only\");\n\t}\n\n\tif (candidate.pendingToolCallCount === undefined) {\n\t\treturn deny(\"tool_calls.unknown\");\n\t}\n\n\tif (candidate.pendingToolCallCount !== 0) {\n\t\treturn deny(\"tool_calls.pending\");\n\t}\n\n\tconst dependencyReason = classifyForbiddenDependence(candidate.dependencies);\n\tif (dependencyReason !== undefined) {\n\t\treturn deny(dependencyReason);\n\t}\n\n\tif (candidate.taskClass === undefined \|\| candidate.taskClass.trim().length === 0) {\n\t\treturn deny(\"task_class.missing\");\n\t}\n\n\tif (containsForbiddenTerm(candidate.taskClass, FORBIDDEN_SEMANTIC_CACHE_TASK_CLASS_TERMS)) {\n\t\treturn deny(\"task_class.forbidden_term\", candidate.taskClass);\n\t}\n\n\tconst normalizedTaskClass = normalizeTaskClass(candidate.taskClass);\n\tif (!isAllowedTaskClass(normalizedTaskClass)) {\n\t\treturn deny(\"task_class.not_allowed\", candidate.taskClass);\n\t}\n\n\tconst actions = collectActions(candidate);\n\tif (actions.some((action) => containsForbiddenTerm(action, FORBIDDEN_SEMANTIC_CACHE_ACTION_TERMS))) {\n\t\treturn deny(\"action.forbidden_term\", actions.join(\", \"));\n\t}\n\n\tconst attributeValidation = validateSemanticCacheAttributes(candidate.cacheAttributes, candidate.currentAttributes);\n\tif (!attributeValidation.valid) {\n\t\treturn deny(attributeValidation.reason, attributeValidation.attribute);\n\t}\n\n\treturn { eligible: true, reason: \"eligible\" };\n}\n\nexport function validateSemanticCacheAttributes(\n\tcacheAttributes: SemanticCacheContextAttributes \| undefined,\n\tcurrentAttributes: SemanticCacheContextAttributes \| undefined,\n): SemanticCacheAttributeValidation {\n\tfor (const attribute of REQUIRED_ATTRIBUTES) {\n\t\tif (!hasUsableAttribute(cacheAttributes, attribute)) {\n\t\t\treturn { valid: false, reason: MISSING_CACHE_ATTRIBUTE_REASONS[attribute], attribute };\n\t\t}\n\t}\n\n\tfor (const attribute of REQUIRED_ATTRIBUTES) {\n\t\tif (!hasUsableAttribute(currentAttributes, attribute)) {\n\t\t\treturn { valid: false, reason: MISSING_CURRENT_ATTRIBUTE_REASONS[attribute], attribute };\n\t\t}\n\t}\n\n\tfor (const attribute of REQUIRED_ATTRIBUTES) {\n\t\tconst cacheAttribute = cacheAttributes?.[attribute];\n\t\tconst currentAttribute = currentAttributes?.[attribute];\n\t\tif (cacheAttribute !== currentAttribute) {\n\t\t\treturn { valid: false, reason: ATTRIBUTE_MISMATCH_REASONS[attribute], attribute };\n\t\t}\n\t}\n\n\treturn { valid: true, reason: \"attributes.ok\" };\n}\n\nfunction classifyForbiddenDependence(\n\tdependencies: SemanticCacheDependencyFlags \| undefined,\n): SemanticCachePolicyReason \| undefined {\n\tif (dependencies?.mutation === true) {\n\t\treturn \"dependence.mutation\";\n\t}\n\tif (dependencies?.deploy === true) {\n\t\treturn \"dependence.deploy\";\n\t}\n\tif (dependencies?.auth === true) {\n\t\treturn \"dependence.auth\";\n\t}\n\tif (dependencies?.security === true) {\n\t\treturn \"dependence.security\";\n\t}\n\tif (dependencies?.time === true) {\n\t\treturn \"dependence.time\";\n\t}\n\tif (dependencies?.externalState === true) {\n\t\treturn \"dependence.external_state\";\n\t}\n\treturn undefined;\n}\n\nfunction collectActions(candidate: SemanticCacheCandidate): readonly string[] {\n\tconst actions: string[] = [];\n\tif (candidate.action !== undefined) {\n\t\tactions.push(candidate.action);\n\t}\n\tif (candidate.actions !== undefined) {\n\t\tactions.push(...candidate.actions);\n\t}\n\treturn actions;\n}\n\nfunction isAllowedTaskClass(taskClass: string): taskClass is SemanticCacheTaskClass {\n\treturn ALLOWED_SEMANTIC_CACHE_TASK_CLASSES.some((allowedTaskClass) => allowedTaskClass === taskClass);\n}\n\nfunction containsForbiddenTerm(text: string, terms: readonly string[]): boolean {\n\tconst textTerms = splitSearchTerms(text);\n\tconst textTermSet = new Set(textTerms);\n\tconst normalizedText = ` ${textTerms.join(\" \")} `;\n\n\treturn terms.some((term) => {\n\t\tconst normalizedTerm = splitSearchTerms(term).join(\" \");\n\t\tif (normalizedTerm.length === 0) {\n\t\t\treturn false;\n\t\t}\n\t\tif (normalizedTerm.includes(\" \")) {\n\t\t\treturn normalizedText.includes(` ${normalizedTerm} `);\n\t\t}\n\t\treturn textTermSet.has(normalizedTerm);\n\t});\n}\n\nfunction normalizeTaskClass(taskClass: string): string {\n\treturn taskClass\n\t\t.trim()\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9]+/g, \"_\")\n\t\t.replace(/^_+\|_+$/g, \"\");\n}\n\nfunction splitSearchTerms(text: string): string[] {\n\treturn text\n\t\t.trim()\n\t\t.toLowerCase()\n\t\t.split(/[^a-z0-9]+/g)\n\t\t.filter((term) => term.length > 0);\n}\n\nfunction hasUsableAttribute(\n\tattributes: SemanticCacheContextAttributes \| undefined,\n\tattribute: RequiredAttribute,\n): boolean {\n\treturn typeof attributes?.[attribute] === \"string\" && attributes[attribute].trim().length > 0;\n}\n\nfunction deny(\n\treason: SemanticCachePolicyReason,\n\tdetail?: string \| keyof SemanticCacheContextAttributes,\n): SemanticCachePolicyDecision {\n\treturn detail === undefined ? { eligible: false, reason } : { eligible: false, reason, detail };\n}\n"]}
1	+ {"version":3,"file":"semantic-cache-policy.d.ts","sourceRoot":"","sources":["../../src/core/semantic-cache-policy.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mCAAmC,8GAMtC,CAAC;AAEX,eAAO,MAAM,yCAAyC,gSA0B5C,CAAC;AAEX,eAAO,MAAM,qCAAqC,gYAuCxC,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,mCAAmC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1F,MAAM,MAAM,yBAAyB,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,GAAG,aAAa,CAAC;AAExF,MAAM,WAAW,8BAA8B;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,+BAA+B;IAC/C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,yBAAyB,CAAC;IACzC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,4BAA4B,CAAC;IAC5C,aAAa,CAAC,EAAE,+BAA+B,CAAC;IAChD,eAAe,CAAC,EAAE,8BAA8B,CAAC;IACjD,iBAAiB,CAAC,EAAE,8BAA8B,CAAC;CACnD;AAED,MAAM,MAAM,yBAAyB,GAClC,UAAU,GACV,UAAU,GACV,oBAAoB,GACpB,wBAAwB,GACxB,oBAAoB,GACpB,oBAAoB,GACpB,qBAAqB,GACrB,mBAAmB,GACnB,iBAAiB,GACjB,qBAAqB,GACrB,iBAAiB,GACjB,2BAA2B,GAC3B,2BAA2B,GAC3B,oBAAoB,GACpB,2BAA2B,GAC3B,wBAAwB,GACxB,uBAAuB,GACvB,kCAAkC,CAAC;AAEtC,MAAM,MAAM,kCAAkC,GAC3C,eAAe,GACf,2BAA2B,GAC3B,6BAA6B,GAC7B,6BAA6B,GAC7B,mCAAmC,GACnC,qCAAqC,GACrC,qCAAqC,GACrC,4BAA4B,GAC5B,8BAA8B,GAC9B,8BAA8B,CAAC;AAElC,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,yBAAyB,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gCAAgC;IAChD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,kCAAkC,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,8BAA8B,CAAC;CACjD;AAwBD,wBAAgB,gCAAgC,CAAC,SAAS,EAAE,sBAAsB,GAAG,2BAA2B,CAsD/G;AAED,wBAAgB,+BAA+B,CAC9C,eAAe,EAAE,8BAA8B,GAAG,SAAS,EAC3D,iBAAiB,EAAE,8BAA8B,GAAG,SAAS,GAC3D,gCAAgC,CAsBlC","sourcesContent":["export const ALLOWED_SEMANTIC_CACHE_TASK_CLASSES = [\n\t\"faq\",\n\t\"read_only_analysis\",\n\t\"documentation_lookup\",\n\t\"code_explanation\",\n\t\"conceptual_explanation\",\n] as const;\n\nexport const FORBIDDEN_SEMANTIC_CACHE_TASK_CLASS_TERMS = [\n\t\"mutation\",\n\t\"mutating\",\n\t\"write\",\n\t\"edit\",\n\t\"create\",\n\t\"update\",\n\t\"delete\",\n\t\"deploy\",\n\t\"deployment\",\n\t\"release\",\n\t\"publish\",\n\t\"auth\",\n\t\"authentication\",\n\t\"authorization\",\n\t\"security\",\n\t\"secret\",\n\t\"credential\",\n\t\"token\",\n\t\"time\",\n\t\"clock\",\n\t\"date\",\n\t\"external\",\n\t\"network\",\n\t\"database\",\n\t\"stateful\",\n] as const;\n\nexport const FORBIDDEN_SEMANTIC_CACHE_ACTION_TERMS = [\n\t\"mutation\",\n\t\"mutate\",\n\t\"write\",\n\t\"edit\",\n\t\"create\",\n\t\"update\",\n\t\"delete\",\n\t\"patch\",\n\t\"modify\",\n\t\"commit\",\n\t\"merge\",\n\t\"rebase\",\n\t\"push\",\n\t\"deploy\",\n\t\"release\",\n\t\"publish\",\n\t\"login\",\n\t\"logout\",\n\t\"auth\",\n\t\"authorize\",\n\t\"token\",\n\t\"secret\",\n\t\"credential\",\n\t\"security\",\n\t\"scan\",\n\t\"audit\",\n\t\"time\",\n\t\"now\",\n\t\"today\",\n\t\"current\",\n\t\"latest\",\n\t\"fetch\",\n\t\"request\",\n\t\"web\",\n\t\"network\",\n\t\"api\",\n\t\"database\",\n\t\"external\",\n] as const;\n\nexport type SemanticCacheTaskClass = (typeof ALLOWED_SEMANTIC_CACHE_TASK_CLASSES)[number];\n\nexport type SemanticCacheResponseKind = \"final\" \| \"draft\" \| \"tool_call\" \| \"tool_result\";\n\nexport interface SemanticCacheContextAttributes {\n\tbranch?: string;\n\tworktree?: string;\n\trepoSha?: string;\n}\n\nexport interface SemanticCacheDependencyFlags {\n\tmutation?: boolean;\n\tdeploy?: boolean;\n\tauth?: boolean;\n\tsecurity?: boolean;\n\ttime?: boolean;\n\texternalState?: boolean;\n}\n\nexport interface SemanticCacheContextBudgetFlags {\n\temergency?: boolean;\n\tomittedRequired?: boolean;\n\tomittedHighPriority?: boolean;\n}\n\nexport interface SemanticCacheCandidate {\n\tenabled?: boolean;\n\tresponseKind?: SemanticCacheResponseKind;\n\tresponseReadOnly?: boolean;\n\tpendingToolCallCount?: number;\n\ttaskClass?: string;\n\taction?: string;\n\tactions?: readonly string[];\n\tdependencies?: SemanticCacheDependencyFlags;\n\tcontextBudget?: SemanticCacheContextBudgetFlags;\n\tcacheAttributes?: SemanticCacheContextAttributes;\n\tcurrentAttributes?: SemanticCacheContextAttributes;\n}\n\nexport type SemanticCachePolicyReason =\n\t\| \"eligible\"\n\t\| \"disabled\"\n\t\| \"response.not_final\"\n\t\| \"response.not_read_only\"\n\t\| \"tool_calls.unknown\"\n\t\| \"tool_calls.pending\"\n\t\| \"dependence.mutation\"\n\t\| \"dependence.deploy\"\n\t\| \"dependence.auth\"\n\t\| \"dependence.security\"\n\t\| \"dependence.time\"\n\t\| \"dependence.external_state\"\n\t\| \"context_budget.incomplete\"\n\t\| \"task_class.missing\"\n\t\| \"task_class.forbidden_term\"\n\t\| \"task_class.not_allowed\"\n\t\| \"action.forbidden_term\"\n\t\| SemanticCacheAttributePolicyReason;\n\nexport type SemanticCacheAttributePolicyReason =\n\t\| \"attributes.ok\"\n\t\| \"attributes.missing_branch\"\n\t\| \"attributes.missing_worktree\"\n\t\| \"attributes.missing_repo_sha\"\n\t\| \"attributes.missing_current_branch\"\n\t\| \"attributes.missing_current_worktree\"\n\t\| \"attributes.missing_current_repo_sha\"\n\t\| \"attributes.branch_mismatch\"\n\t\| \"attributes.worktree_mismatch\"\n\t\| \"attributes.repo_sha_mismatch\";\n\nexport interface SemanticCachePolicyDecision {\n\teligible: boolean;\n\treason: SemanticCachePolicyReason;\n\tdetail?: string;\n}\n\nexport interface SemanticCacheAttributeValidation {\n\tvalid: boolean;\n\treason: SemanticCacheAttributePolicyReason;\n\tattribute?: keyof SemanticCacheContextAttributes;\n}\n\ntype RequiredAttribute = keyof SemanticCacheContextAttributes;\n\nconst REQUIRED_ATTRIBUTES: readonly RequiredAttribute[] = [\"branch\", \"worktree\", \"repoSha\"];\n\nconst MISSING_CACHE_ATTRIBUTE_REASONS: Record<RequiredAttribute, SemanticCacheAttributePolicyReason> = {\n\tbranch: \"attributes.missing_branch\",\n\tworktree: \"attributes.missing_worktree\",\n\trepoSha: \"attributes.missing_repo_sha\",\n};\n\nconst MISSING_CURRENT_ATTRIBUTE_REASONS: Record<RequiredAttribute, SemanticCacheAttributePolicyReason> = {\n\tbranch: \"attributes.missing_current_branch\",\n\tworktree: \"attributes.missing_current_worktree\",\n\trepoSha: \"attributes.missing_current_repo_sha\",\n};\n\nconst ATTRIBUTE_MISMATCH_REASONS: Record<RequiredAttribute, SemanticCacheAttributePolicyReason> = {\n\tbranch: \"attributes.branch_mismatch\",\n\tworktree: \"attributes.worktree_mismatch\",\n\trepoSha: \"attributes.repo_sha_mismatch\",\n};\n\nexport function classifySemanticCacheEligibility(candidate: SemanticCacheCandidate): SemanticCachePolicyDecision {\n\tif (candidate.enabled !== true) {\n\t\treturn deny(\"disabled\");\n\t}\n\n\tif (candidate.responseKind !== \"final\") {\n\t\treturn deny(\"response.not_final\");\n\t}\n\n\tif (candidate.responseReadOnly !== true) {\n\t\treturn deny(\"response.not_read_only\");\n\t}\n\n\tif (candidate.pendingToolCallCount === undefined) {\n\t\treturn deny(\"tool_calls.unknown\");\n\t}\n\n\tif (candidate.pendingToolCallCount !== 0) {\n\t\treturn deny(\"tool_calls.pending\");\n\t}\n\n\tconst dependencyReason = classifyForbiddenDependence(candidate.dependencies);\n\tif (dependencyReason !== undefined) {\n\t\treturn deny(dependencyReason);\n\t}\n\n\tif (isContextBudgetIncomplete(candidate.contextBudget)) {\n\t\treturn deny(\"context_budget.incomplete\");\n\t}\n\n\tif (candidate.taskClass === undefined \|\| candidate.taskClass.trim().length === 0) {\n\t\treturn deny(\"task_class.missing\");\n\t}\n\n\tif (containsForbiddenTerm(candidate.taskClass, FORBIDDEN_SEMANTIC_CACHE_TASK_CLASS_TERMS)) {\n\t\treturn deny(\"task_class.forbidden_term\", candidate.taskClass);\n\t}\n\n\tconst normalizedTaskClass = normalizeTaskClass(candidate.taskClass);\n\tif (!isAllowedTaskClass(normalizedTaskClass)) {\n\t\treturn deny(\"task_class.not_allowed\", candidate.taskClass);\n\t}\n\n\tconst actions = collectActions(candidate);\n\tif (actions.some((action) => containsForbiddenTerm(action, FORBIDDEN_SEMANTIC_CACHE_ACTION_TERMS))) {\n\t\treturn deny(\"action.forbidden_term\", actions.join(\", \"));\n\t}\n\n\tconst attributeValidation = validateSemanticCacheAttributes(candidate.cacheAttributes, candidate.currentAttributes);\n\tif (!attributeValidation.valid) {\n\t\treturn deny(attributeValidation.reason, attributeValidation.attribute);\n\t}\n\n\treturn { eligible: true, reason: \"eligible\" };\n}\n\nexport function validateSemanticCacheAttributes(\n\tcacheAttributes: SemanticCacheContextAttributes \| undefined,\n\tcurrentAttributes: SemanticCacheContextAttributes \| undefined,\n): SemanticCacheAttributeValidation {\n\tfor (const attribute of REQUIRED_ATTRIBUTES) {\n\t\tif (!hasUsableAttribute(cacheAttributes, attribute)) {\n\t\t\treturn { valid: false, reason: MISSING_CACHE_ATTRIBUTE_REASONS[attribute], attribute };\n\t\t}\n\t}\n\n\tfor (const attribute of REQUIRED_ATTRIBUTES) {\n\t\tif (!hasUsableAttribute(currentAttributes, attribute)) {\n\t\t\treturn { valid: false, reason: MISSING_CURRENT_ATTRIBUTE_REASONS[attribute], attribute };\n\t\t}\n\t}\n\n\tfor (const attribute of REQUIRED_ATTRIBUTES) {\n\t\tconst cacheAttribute = cacheAttributes?.[attribute];\n\t\tconst currentAttribute = currentAttributes?.[attribute];\n\t\tif (cacheAttribute !== currentAttribute) {\n\t\t\treturn { valid: false, reason: ATTRIBUTE_MISMATCH_REASONS[attribute], attribute };\n\t\t}\n\t}\n\n\treturn { valid: true, reason: \"attributes.ok\" };\n}\n\nfunction isContextBudgetIncomplete(contextBudget: SemanticCacheContextBudgetFlags \| undefined): boolean {\n\treturn (\n\t\tcontextBudget?.emergency === true \|\|\n\t\tcontextBudget?.omittedRequired === true \|\|\n\t\tcontextBudget?.omittedHighPriority === true\n\t);\n}\n\nfunction classifyForbiddenDependence(\n\tdependencies: SemanticCacheDependencyFlags \| undefined,\n): SemanticCachePolicyReason \| undefined {\n\tif (dependencies?.mutation === true) {\n\t\treturn \"dependence.mutation\";\n\t}\n\tif (dependencies?.deploy === true) {\n\t\treturn \"dependence.deploy\";\n\t}\n\tif (dependencies?.auth === true) {\n\t\treturn \"dependence.auth\";\n\t}\n\tif (dependencies?.security === true) {\n\t\treturn \"dependence.security\";\n\t}\n\tif (dependencies?.time === true) {\n\t\treturn \"dependence.time\";\n\t}\n\tif (dependencies?.externalState === true) {\n\t\treturn \"dependence.external_state\";\n\t}\n\treturn undefined;\n}\n\nfunction collectActions(candidate: SemanticCacheCandidate): readonly string[] {\n\tconst actions: string[] = [];\n\tif (candidate.action !== undefined) {\n\t\tactions.push(candidate.action);\n\t}\n\tif (candidate.actions !== undefined) {\n\t\tactions.push(...candidate.actions);\n\t}\n\treturn actions;\n}\n\nfunction isAllowedTaskClass(taskClass: string): taskClass is SemanticCacheTaskClass {\n\treturn ALLOWED_SEMANTIC_CACHE_TASK_CLASSES.some((allowedTaskClass) => allowedTaskClass === taskClass);\n}\n\nfunction containsForbiddenTerm(text: string, terms: readonly string[]): boolean {\n\tconst textTerms = splitSearchTerms(text);\n\tconst textTermSet = new Set(textTerms);\n\tconst normalizedText = ` ${textTerms.join(\" \")} `;\n\n\treturn terms.some((term) => {\n\t\tconst normalizedTerm = splitSearchTerms(term).join(\" \");\n\t\tif (normalizedTerm.length === 0) {\n\t\t\treturn false;\n\t\t}\n\t\tif (normalizedTerm.includes(\" \")) {\n\t\t\treturn normalizedText.includes(` ${normalizedTerm} `);\n\t\t}\n\t\treturn textTermSet.has(normalizedTerm);\n\t});\n}\n\nfunction normalizeTaskClass(taskClass: string): string {\n\treturn taskClass\n\t\t.trim()\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9]+/g, \"_\")\n\t\t.replace(/^_+\|_+$/g, \"\");\n}\n\nfunction splitSearchTerms(text: string): string[] {\n\treturn text\n\t\t.trim()\n\t\t.toLowerCase()\n\t\t.split(/[^a-z0-9]+/g)\n\t\t.filter((term) => term.length > 0);\n}\n\nfunction hasUsableAttribute(\n\tattributes: SemanticCacheContextAttributes \| undefined,\n\tattribute: RequiredAttribute,\n): boolean {\n\treturn typeof attributes?.[attribute] === \"string\" && attributes[attribute].trim().length > 0;\n}\n\nfunction deny(\n\treason: SemanticCachePolicyReason,\n\tdetail?: string \| keyof SemanticCacheContextAttributes,\n): SemanticCachePolicyDecision {\n\treturn detail === undefined ? { eligible: false, reason } : { eligible: false, reason, detail };\n}\n"]}

package/dist/core/semantic-cache-policy.js CHANGED Viewed

@@ -108,6 +108,9 @@ export function classifySemanticCacheEligibility(candidate) {
     if (dependencyReason !== undefined) {
         return deny(dependencyReason);
     }
+    if (isContextBudgetIncomplete(candidate.contextBudget)) {
+        return deny("context_budget.incomplete");
+    }
     if (candidate.taskClass === undefined || candidate.taskClass.trim().length === 0) {
         return deny("task_class.missing");
     }
@@ -148,6 +151,11 @@ export function validateSemanticCacheAttributes(cacheAttributes, currentAttribut
     }
     return { valid: true, reason: "attributes.ok" };
 }
+function isContextBudgetIncomplete(contextBudget) {
+    return (contextBudget?.emergency === true ||
+        contextBudget?.omittedRequired === true ||
+        contextBudget?.omittedHighPriority === true);
+}
 function classifyForbiddenDependence(dependencies) {
     if (dependencies?.mutation === true) {
         return "dependence.mutation";

package/dist/core/semantic-cache-policy.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"semantic-cache-policy.js","sourceRoot":"","sources":["../../src/core/semantic-cache-policy.ts"],"names":[],"mappings":"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","sourcesContent":["export const ALLOWED_SEMANTIC_CACHE_TASK_CLASSES = [\n\t\"faq\",\n\t\"read_only_analysis\",\n\t\"documentation_lookup\",\n\t\"code_explanation\",\n\t\"conceptual_explanation\",\n] as const;\n\nexport const FORBIDDEN_SEMANTIC_CACHE_TASK_CLASS_TERMS = [\n\t\"mutation\",\n\t\"mutating\",\n\t\"write\",\n\t\"edit\",\n\t\"create\",\n\t\"update\",\n\t\"delete\",\n\t\"deploy\",\n\t\"deployment\",\n\t\"release\",\n\t\"publish\",\n\t\"auth\",\n\t\"authentication\",\n\t\"authorization\",\n\t\"security\",\n\t\"secret\",\n\t\"credential\",\n\t\"token\",\n\t\"time\",\n\t\"clock\",\n\t\"date\",\n\t\"external\",\n\t\"network\",\n\t\"database\",\n\t\"stateful\",\n] as const;\n\nexport const FORBIDDEN_SEMANTIC_CACHE_ACTION_TERMS = [\n\t\"mutation\",\n\t\"mutate\",\n\t\"write\",\n\t\"edit\",\n\t\"create\",\n\t\"update\",\n\t\"delete\",\n\t\"patch\",\n\t\"modify\",\n\t\"commit\",\n\t\"merge\",\n\t\"rebase\",\n\t\"push\",\n\t\"deploy\",\n\t\"release\",\n\t\"publish\",\n\t\"login\",\n\t\"logout\",\n\t\"auth\",\n\t\"authorize\",\n\t\"token\",\n\t\"secret\",\n\t\"credential\",\n\t\"security\",\n\t\"scan\",\n\t\"audit\",\n\t\"time\",\n\t\"now\",\n\t\"today\",\n\t\"current\",\n\t\"latest\",\n\t\"fetch\",\n\t\"request\",\n\t\"web\",\n\t\"network\",\n\t\"api\",\n\t\"database\",\n\t\"external\",\n] as const;\n\nexport type SemanticCacheTaskClass = (typeof ALLOWED_SEMANTIC_CACHE_TASK_CLASSES)[number];\n\nexport type SemanticCacheResponseKind = \"final\" \| \"draft\" \| \"tool_call\" \| \"tool_result\";\n\nexport interface SemanticCacheContextAttributes {\n\tbranch?: string;\n\tworktree?: string;\n\trepoSha?: string;\n}\n\nexport interface SemanticCacheDependencyFlags {\n\tmutation?: boolean;\n\tdeploy?: boolean;\n\tauth?: boolean;\n\tsecurity?: boolean;\n\ttime?: boolean;\n\texternalState?: boolean;\n}\n\nexport interface SemanticCacheCandidate {\n\tenabled?: boolean;\n\tresponseKind?: SemanticCacheResponseKind;\n\tresponseReadOnly?: boolean;\n\tpendingToolCallCount?: number;\n\ttaskClass?: string;\n\taction?: string;\n\tactions?: readonly string[];\n\tdependencies?: SemanticCacheDependencyFlags;\n\tcacheAttributes?: SemanticCacheContextAttributes;\n\tcurrentAttributes?: SemanticCacheContextAttributes;\n}\n\nexport type SemanticCachePolicyReason =\n\t\| \"eligible\"\n\t\| \"disabled\"\n\t\| \"response.not_final\"\n\t\| \"response.not_read_only\"\n\t\| \"tool_calls.unknown\"\n\t\| \"tool_calls.pending\"\n\t\| \"dependence.mutation\"\n\t\| \"dependence.deploy\"\n\t\| \"dependence.auth\"\n\t\| \"dependence.security\"\n\t\| \"dependence.time\"\n\t\| \"dependence.external_state\"\n\t\| \"task_class.missing\"\n\t\| \"task_class.forbidden_term\"\n\t\| \"task_class.not_allowed\"\n\t\| \"action.forbidden_term\"\n\t\| SemanticCacheAttributePolicyReason;\n\nexport type SemanticCacheAttributePolicyReason =\n\t\| \"attributes.ok\"\n\t\| \"attributes.missing_branch\"\n\t\| \"attributes.missing_worktree\"\n\t\| \"attributes.missing_repo_sha\"\n\t\| \"attributes.missing_current_branch\"\n\t\| \"attributes.missing_current_worktree\"\n\t\| \"attributes.missing_current_repo_sha\"\n\t\| \"attributes.branch_mismatch\"\n\t\| \"attributes.worktree_mismatch\"\n\t\| \"attributes.repo_sha_mismatch\";\n\nexport interface SemanticCachePolicyDecision {\n\teligible: boolean;\n\treason: SemanticCachePolicyReason;\n\tdetail?: string;\n}\n\nexport interface SemanticCacheAttributeValidation {\n\tvalid: boolean;\n\treason: SemanticCacheAttributePolicyReason;\n\tattribute?: keyof SemanticCacheContextAttributes;\n}\n\ntype RequiredAttribute = keyof SemanticCacheContextAttributes;\n\nconst REQUIRED_ATTRIBUTES: readonly RequiredAttribute[] = [\"branch\", \"worktree\", \"repoSha\"];\n\nconst MISSING_CACHE_ATTRIBUTE_REASONS: Record<RequiredAttribute, SemanticCacheAttributePolicyReason> = {\n\tbranch: \"attributes.missing_branch\",\n\tworktree: \"attributes.missing_worktree\",\n\trepoSha: \"attributes.missing_repo_sha\",\n};\n\nconst MISSING_CURRENT_ATTRIBUTE_REASONS: Record<RequiredAttribute, SemanticCacheAttributePolicyReason> = {\n\tbranch: \"attributes.missing_current_branch\",\n\tworktree: \"attributes.missing_current_worktree\",\n\trepoSha: \"attributes.missing_current_repo_sha\",\n};\n\nconst ATTRIBUTE_MISMATCH_REASONS: Record<RequiredAttribute, SemanticCacheAttributePolicyReason> = {\n\tbranch: \"attributes.branch_mismatch\",\n\tworktree: \"attributes.worktree_mismatch\",\n\trepoSha: \"attributes.repo_sha_mismatch\",\n};\n\nexport function classifySemanticCacheEligibility(candidate: SemanticCacheCandidate): SemanticCachePolicyDecision {\n\tif (candidate.enabled !== true) {\n\t\treturn deny(\"disabled\");\n\t}\n\n\tif (candidate.responseKind !== \"final\") {\n\t\treturn deny(\"response.not_final\");\n\t}\n\n\tif (candidate.responseReadOnly !== true) {\n\t\treturn deny(\"response.not_read_only\");\n\t}\n\n\tif (candidate.pendingToolCallCount === undefined) {\n\t\treturn deny(\"tool_calls.unknown\");\n\t}\n\n\tif (candidate.pendingToolCallCount !== 0) {\n\t\treturn deny(\"tool_calls.pending\");\n\t}\n\n\tconst dependencyReason = classifyForbiddenDependence(candidate.dependencies);\n\tif (dependencyReason !== undefined) {\n\t\treturn deny(dependencyReason);\n\t}\n\n\tif (candidate.taskClass === undefined \|\| candidate.taskClass.trim().length === 0) {\n\t\treturn deny(\"task_class.missing\");\n\t}\n\n\tif (containsForbiddenTerm(candidate.taskClass, FORBIDDEN_SEMANTIC_CACHE_TASK_CLASS_TERMS)) {\n\t\treturn deny(\"task_class.forbidden_term\", candidate.taskClass);\n\t}\n\n\tconst normalizedTaskClass = normalizeTaskClass(candidate.taskClass);\n\tif (!isAllowedTaskClass(normalizedTaskClass)) {\n\t\treturn deny(\"task_class.not_allowed\", candidate.taskClass);\n\t}\n\n\tconst actions = collectActions(candidate);\n\tif (actions.some((action) => containsForbiddenTerm(action, FORBIDDEN_SEMANTIC_CACHE_ACTION_TERMS))) {\n\t\treturn deny(\"action.forbidden_term\", actions.join(\", \"));\n\t}\n\n\tconst attributeValidation = validateSemanticCacheAttributes(candidate.cacheAttributes, candidate.currentAttributes);\n\tif (!attributeValidation.valid) {\n\t\treturn deny(attributeValidation.reason, attributeValidation.attribute);\n\t}\n\n\treturn { eligible: true, reason: \"eligible\" };\n}\n\nexport function validateSemanticCacheAttributes(\n\tcacheAttributes: SemanticCacheContextAttributes \| undefined,\n\tcurrentAttributes: SemanticCacheContextAttributes \| undefined,\n): SemanticCacheAttributeValidation {\n\tfor (const attribute of REQUIRED_ATTRIBUTES) {\n\t\tif (!hasUsableAttribute(cacheAttributes, attribute)) {\n\t\t\treturn { valid: false, reason: MISSING_CACHE_ATTRIBUTE_REASONS[attribute], attribute };\n\t\t}\n\t}\n\n\tfor (const attribute of REQUIRED_ATTRIBUTES) {\n\t\tif (!hasUsableAttribute(currentAttributes, attribute)) {\n\t\t\treturn { valid: false, reason: MISSING_CURRENT_ATTRIBUTE_REASONS[attribute], attribute };\n\t\t}\n\t}\n\n\tfor (const attribute of REQUIRED_ATTRIBUTES) {\n\t\tconst cacheAttribute = cacheAttributes?.[attribute];\n\t\tconst currentAttribute = currentAttributes?.[attribute];\n\t\tif (cacheAttribute !== currentAttribute) {\n\t\t\treturn { valid: false, reason: ATTRIBUTE_MISMATCH_REASONS[attribute], attribute };\n\t\t}\n\t}\n\n\treturn { valid: true, reason: \"attributes.ok\" };\n}\n\nfunction classifyForbiddenDependence(\n\tdependencies: SemanticCacheDependencyFlags \| undefined,\n): SemanticCachePolicyReason \| undefined {\n\tif (dependencies?.mutation === true) {\n\t\treturn \"dependence.mutation\";\n\t}\n\tif (dependencies?.deploy === true) {\n\t\treturn \"dependence.deploy\";\n\t}\n\tif (dependencies?.auth === true) {\n\t\treturn \"dependence.auth\";\n\t}\n\tif (dependencies?.security === true) {\n\t\treturn \"dependence.security\";\n\t}\n\tif (dependencies?.time === true) {\n\t\treturn \"dependence.time\";\n\t}\n\tif (dependencies?.externalState === true) {\n\t\treturn \"dependence.external_state\";\n\t}\n\treturn undefined;\n}\n\nfunction collectActions(candidate: SemanticCacheCandidate): readonly string[] {\n\tconst actions: string[] = [];\n\tif (candidate.action !== undefined) {\n\t\tactions.push(candidate.action);\n\t}\n\tif (candidate.actions !== undefined) {\n\t\tactions.push(...candidate.actions);\n\t}\n\treturn actions;\n}\n\nfunction isAllowedTaskClass(taskClass: string): taskClass is SemanticCacheTaskClass {\n\treturn ALLOWED_SEMANTIC_CACHE_TASK_CLASSES.some((allowedTaskClass) => allowedTaskClass === taskClass);\n}\n\nfunction containsForbiddenTerm(text: string, terms: readonly string[]): boolean {\n\tconst textTerms = splitSearchTerms(text);\n\tconst textTermSet = new Set(textTerms);\n\tconst normalizedText = ` ${textTerms.join(\" \")} `;\n\n\treturn terms.some((term) => {\n\t\tconst normalizedTerm = splitSearchTerms(term).join(\" \");\n\t\tif (normalizedTerm.length === 0) {\n\t\t\treturn false;\n\t\t}\n\t\tif (normalizedTerm.includes(\" \")) {\n\t\t\treturn normalizedText.includes(` ${normalizedTerm} `);\n\t\t}\n\t\treturn textTermSet.has(normalizedTerm);\n\t});\n}\n\nfunction normalizeTaskClass(taskClass: string): string {\n\treturn taskClass\n\t\t.trim()\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9]+/g, \"_\")\n\t\t.replace(/^_+\|_+$/g, \"\");\n}\n\nfunction splitSearchTerms(text: string): string[] {\n\treturn text\n\t\t.trim()\n\t\t.toLowerCase()\n\t\t.split(/[^a-z0-9]+/g)\n\t\t.filter((term) => term.length > 0);\n}\n\nfunction hasUsableAttribute(\n\tattributes: SemanticCacheContextAttributes \| undefined,\n\tattribute: RequiredAttribute,\n): boolean {\n\treturn typeof attributes?.[attribute] === \"string\" && attributes[attribute].trim().length > 0;\n}\n\nfunction deny(\n\treason: SemanticCachePolicyReason,\n\tdetail?: string \| keyof SemanticCacheContextAttributes,\n): SemanticCachePolicyDecision {\n\treturn detail === undefined ? { eligible: false, reason } : { eligible: false, reason, detail };\n}\n"]}
1	+ {"version":3,"file":"semantic-cache-policy.js","sourceRoot":"","sources":["../../src/core/semantic-cache-policy.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mCAAmC,GAAG;IAClD,KAAK;IACL,oBAAoB;IACpB,sBAAsB;IACtB,kBAAkB;IAClB,wBAAwB;CACf,CAAC;AAEX,MAAM,CAAC,MAAM,yCAAyC,GAAG;IACxD,UAAU;IACV,UAAU;IACV,OAAO;IACP,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,YAAY;IACZ,SAAS;IACT,SAAS;IACT,MAAM;IACN,gBAAgB;IAChB,eAAe;IACf,UAAU;IACV,QAAQ;IACR,YAAY;IACZ,OAAO;IACP,MAAM;IACN,OAAO;IACP,MAAM;IACN,UAAU;IACV,SAAS;IACT,UAAU;IACV,UAAU;CACD,CAAC;AAEX,MAAM,CAAC,MAAM,qCAAqC,GAAG;IACpD,UAAU;IACV,QAAQ;IACR,OAAO;IACP,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,SAAS;IACT,SAAS;IACT,OAAO;IACP,QAAQ;IACR,MAAM;IACN,WAAW;IACX,OAAO;IACP,QAAQ;IACR,YAAY;IACZ,UAAU;IACV,MAAM;IACN,OAAO;IACP,MAAM;IACN,KAAK;IACL,OAAO;IACP,SAAS;IACT,QAAQ;IACR,OAAO;IACP,SAAS;IACT,KAAK;IACL,SAAS;IACT,KAAK;IACL,UAAU;IACV,UAAU;CACD,CAAC;AAuFX,MAAM,mBAAmB,GAAiC,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;AAE5F,MAAM,+BAA+B,GAAkE;IACtG,MAAM,EAAE,2BAA2B;IACnC,QAAQ,EAAE,6BAA6B;IACvC,OAAO,EAAE,6BAA6B;CACtC,CAAC;AAEF,MAAM,iCAAiC,GAAkE;IACxG,MAAM,EAAE,mCAAmC;IAC3C,QAAQ,EAAE,qCAAqC;IAC/C,OAAO,EAAE,qCAAqC;CAC9C,CAAC;AAEF,MAAM,0BAA0B,GAAkE;IACjG,MAAM,EAAE,4BAA4B;IACpC,QAAQ,EAAE,8BAA8B;IACxC,OAAO,EAAE,8BAA8B;CACvC,CAAC;AAEF,MAAM,UAAU,gCAAgC,CAAC,SAAiC,EAA+B;IAChH,IAAI,SAAS,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,SAAS,CAAC,YAAY,KAAK,OAAO,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,SAAS,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,SAAS,CAAC,oBAAoB,KAAK,SAAS,EAAE,CAAC;QAClD,OAAO,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,SAAS,CAAC,oBAAoB,KAAK,CAAC,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,gBAAgB,GAAG,2BAA2B,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IAC7E,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,yBAAyB,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC;QACxD,OAAO,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,SAAS,CAAC,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClF,OAAO,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,qBAAqB,CAAC,SAAS,CAAC,SAAS,EAAE,yCAAyC,CAAC,EAAE,CAAC;QAC3F,OAAO,IAAI,CAAC,2BAA2B,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,mBAAmB,GAAG,kBAAkB,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACpE,IAAI,CAAC,kBAAkB,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC,wBAAwB,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,qBAAqB,CAAC,MAAM,EAAE,qCAAqC,CAAC,CAAC,EAAE,CAAC;QACpG,OAAO,IAAI,CAAC,uBAAuB,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,mBAAmB,GAAG,+BAA+B,CAAC,SAAS,CAAC,eAAe,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;IACpH,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAAA,CAC9C;AAED,MAAM,UAAU,+BAA+B,CAC9C,eAA2D,EAC3D,iBAA6D,EAC1B;IACnC,KAAK,MAAM,SAAS,IAAI,mBAAmB,EAAE,CAAC;QAC7C,IAAI,CAAC,kBAAkB,CAAC,eAAe,EAAE,SAAS,CAAC,EAAE,CAAC;YACrD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,+BAA+B,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;QACxF,CAAC;IACF,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,mBAAmB,EAAE,CAAC;QAC7C,IAAI,CAAC,kBAAkB,CAAC,iBAAiB,EAAE,SAAS,CAAC,EAAE,CAAC;YACvD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,iCAAiC,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;QAC1F,CAAC;IACF,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,mBAAmB,EAAE,CAAC;QAC7C,MAAM,cAAc,GAAG,eAAe,EAAE,CAAC,SAAS,CAAC,CAAC;QACpD,MAAM,gBAAgB,GAAG,iBAAiB,EAAE,CAAC,SAAS,CAAC,CAAC;QACxD,IAAI,cAAc,KAAK,gBAAgB,EAAE,CAAC;YACzC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,0BAA0B,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;QACnF,CAAC;IACF,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;AAAA,CAChD;AAED,SAAS,yBAAyB,CAAC,aAA0D,EAAW;IACvG,OAAO,CACN,aAAa,EAAE,SAAS,KAAK,IAAI;QACjC,aAAa,EAAE,eAAe,KAAK,IAAI;QACvC,aAAa,EAAE,mBAAmB,KAAK,IAAI,CAC3C,CAAC;AAAA,CACF;AAED,SAAS,2BAA2B,CACnC,YAAsD,EACd;IACxC,IAAI,YAAY,EAAE,QAAQ,KAAK,IAAI,EAAE,CAAC;QACrC,OAAO,qBAAqB,CAAC;IAC9B,CAAC;IACD,IAAI,YAAY,EAAE,MAAM,KAAK,IAAI,EAAE,CAAC;QACnC,OAAO,mBAAmB,CAAC;IAC5B,CAAC;IACD,IAAI,YAAY,EAAE,IAAI,KAAK,IAAI,EAAE,CAAC;QACjC,OAAO,iBAAiB,CAAC;IAC1B,CAAC;IACD,IAAI,YAAY,EAAE,QAAQ,KAAK,IAAI,EAAE,CAAC;QACrC,OAAO,qBAAqB,CAAC;IAC9B,CAAC;IACD,IAAI,YAAY,EAAE,IAAI,KAAK,IAAI,EAAE,CAAC;QACjC,OAAO,iBAAiB,CAAC;IAC1B,CAAC;IACD,IAAI,YAAY,EAAE,aAAa,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,2BAA2B,CAAC;IACpC,CAAC;IACD,OAAO,SAAS,CAAC;AAAA,CACjB;AAED,SAAS,cAAc,CAAC,SAAiC,EAAqB;IAC7E,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,SAAS,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,OAAO,CAAC;AAAA,CACf;AAED,SAAS,kBAAkB,CAAC,SAAiB,EAAuC;IACnF,OAAO,mCAAmC,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,EAAE,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC;AAAA,CACtG;AAED,SAAS,qBAAqB,CAAC,IAAY,EAAE,KAAwB,EAAW;IAC/E,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,cAAc,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAElD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC3B,MAAM,cAAc,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxD,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC;QACd,CAAC;QACD,IAAI,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAClC,OAAO,cAAc,CAAC,QAAQ,CAAC,IAAI,cAAc,GAAG,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAAA,CACvC,CAAC,CAAC;AAAA,CACH;AAED,SAAS,kBAAkB,CAAC,SAAiB,EAAU;IACtD,OAAO,SAAS;SACd,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAAA,CAC1B;AAED,SAAS,gBAAgB,CAAC,IAAY,EAAY;IACjD,OAAO,IAAI;SACT,IAAI,EAAE;SACN,WAAW,EAAE;SACb,KAAK,CAAC,aAAa,CAAC;SACpB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAAA,CACpC;AAED,SAAS,kBAAkB,CAC1B,UAAsD,EACtD,SAA4B,EAClB;IACV,OAAO,OAAO,UAAU,EAAE,CAAC,SAAS,CAAC,KAAK,QAAQ,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AAAA,CAC9F;AAED,SAAS,IAAI,CACZ,MAAiC,EACjC,MAAsD,EACxB;IAC9B,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAAA,CAChG","sourcesContent":["export const ALLOWED_SEMANTIC_CACHE_TASK_CLASSES = [\n\t\"faq\",\n\t\"read_only_analysis\",\n\t\"documentation_lookup\",\n\t\"code_explanation\",\n\t\"conceptual_explanation\",\n] as const;\n\nexport const FORBIDDEN_SEMANTIC_CACHE_TASK_CLASS_TERMS = [\n\t\"mutation\",\n\t\"mutating\",\n\t\"write\",\n\t\"edit\",\n\t\"create\",\n\t\"update\",\n\t\"delete\",\n\t\"deploy\",\n\t\"deployment\",\n\t\"release\",\n\t\"publish\",\n\t\"auth\",\n\t\"authentication\",\n\t\"authorization\",\n\t\"security\",\n\t\"secret\",\n\t\"credential\",\n\t\"token\",\n\t\"time\",\n\t\"clock\",\n\t\"date\",\n\t\"external\",\n\t\"network\",\n\t\"database\",\n\t\"stateful\",\n] as const;\n\nexport const FORBIDDEN_SEMANTIC_CACHE_ACTION_TERMS = [\n\t\"mutation\",\n\t\"mutate\",\n\t\"write\",\n\t\"edit\",\n\t\"create\",\n\t\"update\",\n\t\"delete\",\n\t\"patch\",\n\t\"modify\",\n\t\"commit\",\n\t\"merge\",\n\t\"rebase\",\n\t\"push\",\n\t\"deploy\",\n\t\"release\",\n\t\"publish\",\n\t\"login\",\n\t\"logout\",\n\t\"auth\",\n\t\"authorize\",\n\t\"token\",\n\t\"secret\",\n\t\"credential\",\n\t\"security\",\n\t\"scan\",\n\t\"audit\",\n\t\"time\",\n\t\"now\",\n\t\"today\",\n\t\"current\",\n\t\"latest\",\n\t\"fetch\",\n\t\"request\",\n\t\"web\",\n\t\"network\",\n\t\"api\",\n\t\"database\",\n\t\"external\",\n] as const;\n\nexport type SemanticCacheTaskClass = (typeof ALLOWED_SEMANTIC_CACHE_TASK_CLASSES)[number];\n\nexport type SemanticCacheResponseKind = \"final\" \| \"draft\" \| \"tool_call\" \| \"tool_result\";\n\nexport interface SemanticCacheContextAttributes {\n\tbranch?: string;\n\tworktree?: string;\n\trepoSha?: string;\n}\n\nexport interface SemanticCacheDependencyFlags {\n\tmutation?: boolean;\n\tdeploy?: boolean;\n\tauth?: boolean;\n\tsecurity?: boolean;\n\ttime?: boolean;\n\texternalState?: boolean;\n}\n\nexport interface SemanticCacheContextBudgetFlags {\n\temergency?: boolean;\n\tomittedRequired?: boolean;\n\tomittedHighPriority?: boolean;\n}\n\nexport interface SemanticCacheCandidate {\n\tenabled?: boolean;\n\tresponseKind?: SemanticCacheResponseKind;\n\tresponseReadOnly?: boolean;\n\tpendingToolCallCount?: number;\n\ttaskClass?: string;\n\taction?: string;\n\tactions?: readonly string[];\n\tdependencies?: SemanticCacheDependencyFlags;\n\tcontextBudget?: SemanticCacheContextBudgetFlags;\n\tcacheAttributes?: SemanticCacheContextAttributes;\n\tcurrentAttributes?: SemanticCacheContextAttributes;\n}\n\nexport type SemanticCachePolicyReason =\n\t\| \"eligible\"\n\t\| \"disabled\"\n\t\| \"response.not_final\"\n\t\| \"response.not_read_only\"\n\t\| \"tool_calls.unknown\"\n\t\| \"tool_calls.pending\"\n\t\| \"dependence.mutation\"\n\t\| \"dependence.deploy\"\n\t\| \"dependence.auth\"\n\t\| \"dependence.security\"\n\t\| \"dependence.time\"\n\t\| \"dependence.external_state\"\n\t\| \"context_budget.incomplete\"\n\t\| \"task_class.missing\"\n\t\| \"task_class.forbidden_term\"\n\t\| \"task_class.not_allowed\"\n\t\| \"action.forbidden_term\"\n\t\| SemanticCacheAttributePolicyReason;\n\nexport type SemanticCacheAttributePolicyReason =\n\t\| \"attributes.ok\"\n\t\| \"attributes.missing_branch\"\n\t\| \"attributes.missing_worktree\"\n\t\| \"attributes.missing_repo_sha\"\n\t\| \"attributes.missing_current_branch\"\n\t\| \"attributes.missing_current_worktree\"\n\t\| \"attributes.missing_current_repo_sha\"\n\t\| \"attributes.branch_mismatch\"\n\t\| \"attributes.worktree_mismatch\"\n\t\| \"attributes.repo_sha_mismatch\";\n\nexport interface SemanticCachePolicyDecision {\n\teligible: boolean;\n\treason: SemanticCachePolicyReason;\n\tdetail?: string;\n}\n\nexport interface SemanticCacheAttributeValidation {\n\tvalid: boolean;\n\treason: SemanticCacheAttributePolicyReason;\n\tattribute?: keyof SemanticCacheContextAttributes;\n}\n\ntype RequiredAttribute = keyof SemanticCacheContextAttributes;\n\nconst REQUIRED_ATTRIBUTES: readonly RequiredAttribute[] = [\"branch\", \"worktree\", \"repoSha\"];\n\nconst MISSING_CACHE_ATTRIBUTE_REASONS: Record<RequiredAttribute, SemanticCacheAttributePolicyReason> = {\n\tbranch: \"attributes.missing_branch\",\n\tworktree: \"attributes.missing_worktree\",\n\trepoSha: \"attributes.missing_repo_sha\",\n};\n\nconst MISSING_CURRENT_ATTRIBUTE_REASONS: Record<RequiredAttribute, SemanticCacheAttributePolicyReason> = {\n\tbranch: \"attributes.missing_current_branch\",\n\tworktree: \"attributes.missing_current_worktree\",\n\trepoSha: \"attributes.missing_current_repo_sha\",\n};\n\nconst ATTRIBUTE_MISMATCH_REASONS: Record<RequiredAttribute, SemanticCacheAttributePolicyReason> = {\n\tbranch: \"attributes.branch_mismatch\",\n\tworktree: \"attributes.worktree_mismatch\",\n\trepoSha: \"attributes.repo_sha_mismatch\",\n};\n\nexport function classifySemanticCacheEligibility(candidate: SemanticCacheCandidate): SemanticCachePolicyDecision {\n\tif (candidate.enabled !== true) {\n\t\treturn deny(\"disabled\");\n\t}\n\n\tif (candidate.responseKind !== \"final\") {\n\t\treturn deny(\"response.not_final\");\n\t}\n\n\tif (candidate.responseReadOnly !== true) {\n\t\treturn deny(\"response.not_read_only\");\n\t}\n\n\tif (candidate.pendingToolCallCount === undefined) {\n\t\treturn deny(\"tool_calls.unknown\");\n\t}\n\n\tif (candidate.pendingToolCallCount !== 0) {\n\t\treturn deny(\"tool_calls.pending\");\n\t}\n\n\tconst dependencyReason = classifyForbiddenDependence(candidate.dependencies);\n\tif (dependencyReason !== undefined) {\n\t\treturn deny(dependencyReason);\n\t}\n\n\tif (isContextBudgetIncomplete(candidate.contextBudget)) {\n\t\treturn deny(\"context_budget.incomplete\");\n\t}\n\n\tif (candidate.taskClass === undefined \|\| candidate.taskClass.trim().length === 0) {\n\t\treturn deny(\"task_class.missing\");\n\t}\n\n\tif (containsForbiddenTerm(candidate.taskClass, FORBIDDEN_SEMANTIC_CACHE_TASK_CLASS_TERMS)) {\n\t\treturn deny(\"task_class.forbidden_term\", candidate.taskClass);\n\t}\n\n\tconst normalizedTaskClass = normalizeTaskClass(candidate.taskClass);\n\tif (!isAllowedTaskClass(normalizedTaskClass)) {\n\t\treturn deny(\"task_class.not_allowed\", candidate.taskClass);\n\t}\n\n\tconst actions = collectActions(candidate);\n\tif (actions.some((action) => containsForbiddenTerm(action, FORBIDDEN_SEMANTIC_CACHE_ACTION_TERMS))) {\n\t\treturn deny(\"action.forbidden_term\", actions.join(\", \"));\n\t}\n\n\tconst attributeValidation = validateSemanticCacheAttributes(candidate.cacheAttributes, candidate.currentAttributes);\n\tif (!attributeValidation.valid) {\n\t\treturn deny(attributeValidation.reason, attributeValidation.attribute);\n\t}\n\n\treturn { eligible: true, reason: \"eligible\" };\n}\n\nexport function validateSemanticCacheAttributes(\n\tcacheAttributes: SemanticCacheContextAttributes \| undefined,\n\tcurrentAttributes: SemanticCacheContextAttributes \| undefined,\n): SemanticCacheAttributeValidation {\n\tfor (const attribute of REQUIRED_ATTRIBUTES) {\n\t\tif (!hasUsableAttribute(cacheAttributes, attribute)) {\n\t\t\treturn { valid: false, reason: MISSING_CACHE_ATTRIBUTE_REASONS[attribute], attribute };\n\t\t}\n\t}\n\n\tfor (const attribute of REQUIRED_ATTRIBUTES) {\n\t\tif (!hasUsableAttribute(currentAttributes, attribute)) {\n\t\t\treturn { valid: false, reason: MISSING_CURRENT_ATTRIBUTE_REASONS[attribute], attribute };\n\t\t}\n\t}\n\n\tfor (const attribute of REQUIRED_ATTRIBUTES) {\n\t\tconst cacheAttribute = cacheAttributes?.[attribute];\n\t\tconst currentAttribute = currentAttributes?.[attribute];\n\t\tif (cacheAttribute !== currentAttribute) {\n\t\t\treturn { valid: false, reason: ATTRIBUTE_MISMATCH_REASONS[attribute], attribute };\n\t\t}\n\t}\n\n\treturn { valid: true, reason: \"attributes.ok\" };\n}\n\nfunction isContextBudgetIncomplete(contextBudget: SemanticCacheContextBudgetFlags \| undefined): boolean {\n\treturn (\n\t\tcontextBudget?.emergency === true \|\|\n\t\tcontextBudget?.omittedRequired === true \|\|\n\t\tcontextBudget?.omittedHighPriority === true\n\t);\n}\n\nfunction classifyForbiddenDependence(\n\tdependencies: SemanticCacheDependencyFlags \| undefined,\n): SemanticCachePolicyReason \| undefined {\n\tif (dependencies?.mutation === true) {\n\t\treturn \"dependence.mutation\";\n\t}\n\tif (dependencies?.deploy === true) {\n\t\treturn \"dependence.deploy\";\n\t}\n\tif (dependencies?.auth === true) {\n\t\treturn \"dependence.auth\";\n\t}\n\tif (dependencies?.security === true) {\n\t\treturn \"dependence.security\";\n\t}\n\tif (dependencies?.time === true) {\n\t\treturn \"dependence.time\";\n\t}\n\tif (dependencies?.externalState === true) {\n\t\treturn \"dependence.external_state\";\n\t}\n\treturn undefined;\n}\n\nfunction collectActions(candidate: SemanticCacheCandidate): readonly string[] {\n\tconst actions: string[] = [];\n\tif (candidate.action !== undefined) {\n\t\tactions.push(candidate.action);\n\t}\n\tif (candidate.actions !== undefined) {\n\t\tactions.push(...candidate.actions);\n\t}\n\treturn actions;\n}\n\nfunction isAllowedTaskClass(taskClass: string): taskClass is SemanticCacheTaskClass {\n\treturn ALLOWED_SEMANTIC_CACHE_TASK_CLASSES.some((allowedTaskClass) => allowedTaskClass === taskClass);\n}\n\nfunction containsForbiddenTerm(text: string, terms: readonly string[]): boolean {\n\tconst textTerms = splitSearchTerms(text);\n\tconst textTermSet = new Set(textTerms);\n\tconst normalizedText = ` ${textTerms.join(\" \")} `;\n\n\treturn terms.some((term) => {\n\t\tconst normalizedTerm = splitSearchTerms(term).join(\" \");\n\t\tif (normalizedTerm.length === 0) {\n\t\t\treturn false;\n\t\t}\n\t\tif (normalizedTerm.includes(\" \")) {\n\t\t\treturn normalizedText.includes(` ${normalizedTerm} `);\n\t\t}\n\t\treturn textTermSet.has(normalizedTerm);\n\t});\n}\n\nfunction normalizeTaskClass(taskClass: string): string {\n\treturn taskClass\n\t\t.trim()\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9]+/g, \"_\")\n\t\t.replace(/^_+\|_+$/g, \"\");\n}\n\nfunction splitSearchTerms(text: string): string[] {\n\treturn text\n\t\t.trim()\n\t\t.toLowerCase()\n\t\t.split(/[^a-z0-9]+/g)\n\t\t.filter((term) => term.length > 0);\n}\n\nfunction hasUsableAttribute(\n\tattributes: SemanticCacheContextAttributes \| undefined,\n\tattribute: RequiredAttribute,\n): boolean {\n\treturn typeof attributes?.[attribute] === \"string\" && attributes[attribute].trim().length > 0;\n}\n\nfunction deny(\n\treason: SemanticCachePolicyReason,\n\tdetail?: string \| keyof SemanticCacheContextAttributes,\n): SemanticCachePolicyDecision {\n\treturn detail === undefined ? { eligible: false, reason } : { eligible: false, reason, detail };\n}\n"]}

package/dist/core/session-manager.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
-import { type AgentMessage } from "@earendil-works/omk-agent-core";
-import type { ImageContent, Message, TextContent } from "@earendil-works/omk-ai";
+import { type AgentMessage } from "omk-agent-core";
+import type { ImageContent, Message, TextContent } from "omk-ai";
 import { type BashExecutionMessage, type CustomMessage } from "./messages.ts";
 export declare const CURRENT_SESSION_VERSION = 3;
 export interface SessionHeader {
@@ -40,7 +40,6 @@ export interface CompactionEntry<T = unknown> extends SessionEntryBase {
     tokensBefore: number;
     /** Extension-specific data (e.g., ArtifactIndex, version markers for structured compaction) */
     details?: T;
-    /** True if generated by an extension, undefined/false if omk-generated */
     fromHook?: boolean;
 }
 export interface BranchSummaryEntry<T = unknown> extends SessionEntryBase {
@@ -49,7 +48,6 @@ export interface BranchSummaryEntry<T = unknown> extends SessionEntryBase {
     summary: string;
     /** Extension-specific data (not sent to LLM) */
     details?: T;
-    /** True if generated by an extension, false if omk-generated */
     fromHook?: boolean;
 }
 /**

package/dist/core/session-manager.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/core/session-manager.ts"],"names":[],"mappings":"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","sourcesContent":["import { type AgentMessage, uuidv7 } from \"@earendil-works/omk-agent-core\";\nimport type { ImageContent, Message, TextContent } from \"@earendil-works/omk-ai\";\nimport { randomUUID } from \"crypto\";\nimport {\n\tappendFileSync,\n\tcloseSync,\n\tcreateReadStream,\n\texistsSync,\n\tmkdirSync,\n\topenSync,\n\treaddirSync,\n\treadSync,\n\trenameSync,\n\tstatSync,\n\twriteFileSync,\n} from \"fs\";\nimport { readdir, stat } from \"fs/promises\";\nimport { join, resolve } from \"path\";\nimport { createInterface } from \"readline\";\nimport { StringDecoder } from \"string_decoder\";\nimport { getAgentDir as getDefaultAgentDir, getSessionsDir } from \"../config.ts\";\nimport { normalizePath, resolvePath } from \"../utils/paths.ts\";\nimport {\n\ttype BashExecutionMessage,\n\ttype CustomMessage,\n\tcreateBranchSummaryMessage,\n\tcreateCompactionSummaryMessage,\n\tcreateCustomMessage,\n} from \"./messages.ts\";\nimport {\n\tBoundedDigestAccumulator,\n\tboundSessionFirstMessage,\n\tDEFAULT_SESSION_DIGEST_MAX_CHARS,\n} from \"./session-digest.ts\";\n\nexport const CURRENT_SESSION_VERSION = 3;\n\nexport interface SessionHeader {\n\ttype: \"session\";\n\tversion?: number; // v1 sessions don't have this\n\tid: string;\n\ttimestamp: string;\n\tcwd: string;\n\tparentSession?: string;\n}\n\nexport interface NewSessionOptions {\n\tid?: string;\n\tparentSession?: string;\n}\n\nexport interface SessionEntryBase {\n\ttype: string;\n\tid: string;\n\tparentId: string \| null;\n\ttimestamp: string;\n}\n\nexport interface SessionMessageEntry extends SessionEntryBase {\n\ttype: \"message\";\n\tmessage: AgentMessage;\n}\n\nexport interface ThinkingLevelChangeEntry extends SessionEntryBase {\n\ttype: \"thinking_level_change\";\n\tthinkingLevel: string;\n}\n\nexport interface ModelChangeEntry extends SessionEntryBase {\n\ttype: \"model_change\";\n\tprovider: string;\n\tmodelId: string;\n}\n\nexport interface CompactionEntry<T = unknown> extends SessionEntryBase {\n\ttype: \"compaction\";\n\tsummary: string;\n\tfirstKeptEntryId: string;\n\ttokensBefore: number;\n\t/** Extension-specific data (e.g., ArtifactIndex, version markers for structured compaction) /\n\tdetails?: T;\n\t/* True if generated by an extension, undefined/false if omk-generated /\n\tfromHook?: boolean;\n}\n\nexport interface BranchSummaryEntry<T = unknown> extends SessionEntryBase {\n\ttype: \"branch_summary\";\n\tfromId: string;\n\tsummary: string;\n\t/* Extension-specific data (not sent to LLM) /\n\tdetails?: T;\n\t/* True if generated by an extension, false if omk-generated /\n\tfromHook?: boolean;\n}\n\n/\n Custom entry for extensions to store extension-specific data in the session.\n * Use customType to identify your extension's entries.\n \n Purpose: Persist extension state across session reloads. On reload, extensions can\n * scan entries for their customType and reconstruct internal state.\n \n Does NOT participate in LLM context (ignored by buildSessionContext).\n * For injecting content into context, see CustomMessageEntry.\n /\nexport interface CustomEntry<T = unknown> extends SessionEntryBase {\n\ttype: \"custom\";\n\tcustomType: string;\n\tdata?: T;\n}\n\n/* Label entry for user-defined bookmarks/markers on entries. /\nexport interface LabelEntry extends SessionEntryBase {\n\ttype: \"label\";\n\ttargetId: string;\n\tlabel: string \| undefined;\n}\n\n/* Session metadata entry (e.g., user-defined display name). /\nexport interface SessionInfoEntry extends SessionEntryBase {\n\ttype: \"session_info\";\n\tname?: string;\n}\n\n/\n Custom message entry for extensions to inject messages into LLM context.\n * Use customType to identify your extension's entries.\n \n Unlike CustomEntry, this DOES participate in LLM context.\n * The content is converted to a user message in buildSessionContext().\n * Use details for extension-specific metadata (not sent to LLM).\n \n display controls TUI rendering:\n * - false: hidden entirely\n * - true: rendered with distinct styling (different from user messages)\n /\nexport interface CustomMessageEntry<T = unknown> extends SessionEntryBase {\n\ttype: \"custom_message\";\n\tcustomType: string;\n\tcontent: string \| (TextContent \| ImageContent)[];\n\tdetails?: T;\n\tdisplay: boolean;\n}\n\n/* Session entry - has id/parentId for tree structure (returned by \"read\" methods in SessionManager) /\nexport type SessionEntry =\n\t\| SessionMessageEntry\n\t\| ThinkingLevelChangeEntry\n\t\| ModelChangeEntry\n\t\| CompactionEntry\n\t\| BranchSummaryEntry\n\t\| CustomEntry\n\t\| CustomMessageEntry\n\t\| LabelEntry\n\t\| SessionInfoEntry;\n\n/* Raw file entry (includes header) /\nexport type FileEntry = SessionHeader \| SessionEntry;\n\n/* Tree node for getTree() - defensive copy of session structure /\nexport interface SessionTreeNode {\n\tentry: SessionEntry;\n\tchildren: SessionTreeNode[];\n\t/* Resolved label for this entry, if any /\n\tlabel?: string;\n\t/* Timestamp of the latest label change for this entry, if any /\n\tlabelTimestamp?: string;\n}\n\nexport interface SessionContext {\n\tmessages: AgentMessage[];\n\tthinkingLevel: string;\n\tmodel: { provider: string; modelId: string } \| null;\n}\n\nexport interface SessionInfo {\n\tpath: string;\n\tid: string;\n\t/* Working directory where the session was started. Empty string for old sessions. /\n\tcwd: string;\n\t/* User-defined display name from session_info entries. /\n\tname?: string;\n\t/* Path to the parent session (if this session was forked). /\n\tparentSessionPath?: string;\n\tcreated: Date;\n\tmodified: Date;\n\tmessageCount: number;\n\tfirstMessage: string;\n\tallMessagesText: string;\n}\n\nexport type ReadonlySessionManager = Pick<\n\tSessionManager,\n\t\| \"getCwd\"\n\t\| \"getSessionDir\"\n\t\| \"getSessionId\"\n\t\| \"getSessionFile\"\n\t\| \"getLeafId\"\n\t\| \"getLeafEntry\"\n\t\| \"getEntry\"\n\t\| \"getLabel\"\n\t\| \"getBranch\"\n\t\| \"getHeader\"\n\t\| \"getEntries\"\n\t\| \"getTree\"\n\t\| \"getSessionName\"\n>;\n\nfunction createSessionId(): string {\n\treturn uuidv7();\n}\n\nexport function assertValidSessionId(id: string): void {\n\tif (!/^[A-Za-z0-9](?:[A-Za-z0-9._-][A-Za-z0-9])?$/.test(id)) {\n\t\tthrow new Error(\n\t\t\t\"Session id must be non-empty, contain only alphanumeric characters, '-', '_', and '.', and start and end with an alphanumeric character\",\n\t\t);\n\t}\n}\n\n/** Generate a unique short ID (8 hex chars, collision-checked) /\nfunction generateId(byId: { has(id: string): boolean }): string {\n\tfor (let i = 0; i < 100; i++) {\n\t\tconst id = randomUUID().slice(0, 8);\n\t\tif (!byId.has(id)) return id;\n\t}\n\t// Fallback to full UUID if somehow we have collisions\n\treturn randomUUID();\n}\n\n/* Migrate v1 → v2: add id/parentId tree structure. Mutates in place. /\nfunction migrateV1ToV2(entries: FileEntry[]): void {\n\tconst ids = new Set<string>();\n\tlet prevId: string \| null = null;\n\n\tfor (const entry of entries) {\n\t\tif (entry.type === \"session\") {\n\t\t\tentry.version = 2;\n\t\t\tcontinue;\n\t\t}\n\n\t\tentry.id = generateId(ids);\n\t\tentry.parentId = prevId;\n\t\tprevId = entry.id;\n\n\t\t// Convert firstKeptEntryIndex to firstKeptEntryId for compaction\n\t\tif (entry.type === \"compaction\") {\n\t\t\tconst comp = entry as CompactionEntry & { firstKeptEntryIndex?: number };\n\t\t\tif (typeof comp.firstKeptEntryIndex === \"number\") {\n\t\t\t\tconst targetEntry = entries[comp.firstKeptEntryIndex];\n\t\t\t\tif (targetEntry && targetEntry.type !== \"session\") {\n\t\t\t\t\tcomp.firstKeptEntryId = targetEntry.id;\n\t\t\t\t}\n\t\t\t\tdelete comp.firstKeptEntryIndex;\n\t\t\t}\n\t\t}\n\t}\n}\n\n/* Migrate v2 → v3: rename hookMessage role to custom. Mutates in place. /\nfunction migrateV2ToV3(entries: FileEntry[]): void {\n\tfor (const entry of entries) {\n\t\tif (entry.type === \"session\") {\n\t\t\tentry.version = 3;\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Update message entries with hookMessage role\n\t\tif (entry.type === \"message\") {\n\t\t\tconst msgEntry = entry as SessionMessageEntry;\n\t\t\tif (msgEntry.message && (msgEntry.message as { role: string }).role === \"hookMessage\") {\n\t\t\t\t(msgEntry.message as { role: string }).role = \"custom\";\n\t\t\t}\n\t\t}\n\t}\n}\n\n/\n Run all necessary migrations to bring entries to current version.\n * Mutates entries in place. Returns true if any migration was applied.\n /\nfunction migrateToCurrentVersion(entries: FileEntry[]): boolean {\n\tconst header = entries.find((e) => e.type === \"session\") as SessionHeader \| undefined;\n\tconst version = header?.version ?? 1;\n\n\tif (version >= CURRENT_SESSION_VERSION) return false;\n\n\tif (version < 2) migrateV1ToV2(entries);\n\tif (version < 3) migrateV2ToV3(entries);\n\n\treturn true;\n}\n\n/* Exported for testing /\nexport function migrateSessionEntries(entries: FileEntry[]): void {\n\tmigrateToCurrentVersion(entries);\n}\n\n/* Exported for compaction.test.ts /\nexport function parseSessionEntries(content: string): FileEntry[] {\n\tconst entries: FileEntry[] = [];\n\tconst lines = content.trim().split(\"\\n\");\n\n\tfor (const line of lines) {\n\t\tif (!line.trim()) continue;\n\t\ttry {\n\t\t\tconst entry = JSON.parse(line) as FileEntry;\n\t\t\tentries.push(entry);\n\t\t} catch {\n\t\t\t// Skip malformed lines\n\t\t}\n\t}\n\n\treturn entries;\n}\n\nexport function getLatestCompactionEntry(entries: SessionEntry[]): CompactionEntry \| null {\n\tfor (let i = entries.length - 1; i >= 0; i--) {\n\t\tif (entries[i].type === \"compaction\") {\n\t\t\treturn entries[i] as CompactionEntry;\n\t\t}\n\t}\n\treturn null;\n}\n\n/\n Build the session context from entries using tree traversal.\n * If leafId is provided, walks from that entry to root.\n * Handles compaction and branch summaries along the path.\n /\nexport function buildSessionContext(\n\tentries: SessionEntry[],\n\tleafId?: string \| null,\n\tbyId?: Map<string, SessionEntry>,\n): SessionContext {\n\t// Build uuid index if not available\n\tif (!byId) {\n\t\tbyId = new Map<string, SessionEntry>();\n\t\tfor (const entry of entries) {\n\t\t\tbyId.set(entry.id, entry);\n\t\t}\n\t}\n\n\t// Find leaf\n\tlet leaf: SessionEntry \| undefined;\n\tif (leafId === null) {\n\t\t// Explicitly null - return no messages (navigated to before first entry)\n\t\treturn { messages: [], thinkingLevel: \"off\", model: null };\n\t}\n\tif (leafId) {\n\t\tleaf = byId.get(leafId);\n\t}\n\tif (!leaf) {\n\t\t// Fallback to last entry (when leafId is undefined)\n\t\tleaf = entries[entries.length - 1];\n\t}\n\n\tif (!leaf) {\n\t\treturn { messages: [], thinkingLevel: \"off\", model: null };\n\t}\n\n\t// Walk from leaf to root, collecting path\n\tconst path: SessionEntry[] = [];\n\tlet current: SessionEntry \| undefined = leaf;\n\twhile (current) {\n\t\tpath.unshift(current);\n\t\tcurrent = current.parentId ? byId.get(current.parentId) : undefined;\n\t}\n\n\t// Extract settings and find compaction\n\tlet thinkingLevel = \"off\";\n\tlet model: { provider: string; modelId: string } \| null = null;\n\tlet compaction: CompactionEntry \| null = null;\n\n\tfor (const entry of path) {\n\t\tif (entry.type === \"thinking_level_change\") {\n\t\t\tthinkingLevel = entry.thinkingLevel;\n\t\t} else if (entry.type === \"model_change\") {\n\t\t\tmodel = { provider: entry.provider, modelId: entry.modelId };\n\t\t} else if (entry.type === \"message\" && entry.message.role === \"assistant\") {\n\t\t\tmodel = { provider: entry.message.provider, modelId: entry.message.model };\n\t\t} else if (entry.type === \"compaction\") {\n\t\t\tcompaction = entry;\n\t\t}\n\t}\n\n\t// Build messages and collect corresponding entries\n\t// When there's a compaction, we need to:\n\t// 1. Emit summary first (entry = compaction)\n\t// 2. Emit kept messages (from firstKeptEntryId up to compaction)\n\t// 3. Emit messages after compaction\n\tconst messages: AgentMessage[] = [];\n\n\tconst appendMessage = (entry: SessionEntry) => {\n\t\tif (entry.type === \"message\") {\n\t\t\tmessages.push(entry.message);\n\t\t} else if (entry.type === \"custom_message\") {\n\t\t\tmessages.push(\n\t\t\t\tcreateCustomMessage(entry.customType, entry.content, entry.display, entry.details, entry.timestamp),\n\t\t\t);\n\t\t} else if (entry.type === \"branch_summary\" && entry.summary) {\n\t\t\tmessages.push(createBranchSummaryMessage(entry.summary, entry.fromId, entry.timestamp));\n\t\t}\n\t};\n\n\tif (compaction) {\n\t\t// Emit summary first\n\t\tmessages.push(createCompactionSummaryMessage(compaction.summary, compaction.tokensBefore, compaction.timestamp));\n\n\t\t// Find compaction index in path\n\t\tconst compactionIdx = path.findIndex((e) => e.type === \"compaction\" && e.id === compaction.id);\n\n\t\t// Emit kept messages (before compaction, starting from firstKeptEntryId)\n\t\tlet foundFirstKept = false;\n\t\tfor (let i = 0; i < compactionIdx; i++) {\n\t\t\tconst entry = path[i];\n\t\t\tif (entry.id === compaction.firstKeptEntryId) {\n\t\t\t\tfoundFirstKept = true;\n\t\t\t}\n\t\t\tif (foundFirstKept) {\n\t\t\t\tappendMessage(entry);\n\t\t\t}\n\t\t}\n\n\t\t// Emit messages after compaction\n\t\tfor (let i = compactionIdx + 1; i < path.length; i++) {\n\t\t\tconst entry = path[i];\n\t\t\tappendMessage(entry);\n\t\t}\n\t} else {\n\t\t// No compaction - emit all messages, handle branch summaries and custom messages\n\t\tfor (const entry of path) {\n\t\t\tappendMessage(entry);\n\t\t}\n\t}\n\n\treturn { messages, thinkingLevel, model };\n}\n\n/\n Compute the default session directory for a cwd.\n * Encodes cwd into a safe directory name under ~/.omk/agent/sessions/.\n /\nfunction getDefaultSessionDirPath(cwd: string, agentDir: string = getDefaultAgentDir()): string {\n\tconst resolvedCwd = resolvePath(cwd);\n\tconst resolvedAgentDir = resolvePath(agentDir);\n\tconst safePath = `--${resolvedCwd.replace(/^[/\\\\]/, \"\").replace(/[/\\\\:]/g, \"-\")}--`;\n\treturn join(resolvedAgentDir, \"sessions\", safePath);\n}\n\nexport function getDefaultSessionDir(cwd: string, agentDir: string = getDefaultAgentDir()): string {\n\tconst sessionDir = getDefaultSessionDirPath(cwd, agentDir);\n\tif (!existsSync(sessionDir)) {\n\t\tmkdirSync(sessionDir, { recursive: true });\n\t}\n\treturn sessionDir;\n}\n\nconst SESSION_READ_BUFFER_SIZE = 1024 1024;\n\nfunction parseSessionEntryLine(line: string): FileEntry \| null {\n\tif (!line.trim()) return null;\n\ttry {\n\t\treturn JSON.parse(line) as FileEntry;\n\t} catch {\n\t\t// Skip malformed lines\n\t\treturn null;\n\t}\n}\n\n/** Exported for testing /\nexport function loadEntriesFromFile(filePath: string): FileEntry[] {\n\tconst resolvedFilePath = normalizePath(filePath);\n\tif (!existsSync(resolvedFilePath)) return [];\n\n\tconst entries: FileEntry[] = [];\n\tconst fd = openSync(resolvedFilePath, \"r\");\n\ttry {\n\t\tconst decoder = new StringDecoder(\"utf8\");\n\t\tconst buffer = Buffer.allocUnsafe(SESSION_READ_BUFFER_SIZE);\n\t\tlet pending = \"\";\n\n\t\twhile (true) {\n\t\t\tconst bytesRead = readSync(fd, buffer, 0, buffer.length, null);\n\t\t\tif (bytesRead === 0) break;\n\n\t\t\tpending += decoder.write(buffer.subarray(0, bytesRead));\n\t\t\tlet lineStart = 0;\n\t\t\tlet newlineIndex = pending.indexOf(\"\\n\", lineStart);\n\t\t\twhile (newlineIndex !== -1) {\n\t\t\t\tconst entry = parseSessionEntryLine(pending.slice(lineStart, newlineIndex));\n\t\t\t\tif (entry) entries.push(entry);\n\t\t\t\tlineStart = newlineIndex + 1;\n\t\t\t\tnewlineIndex = pending.indexOf(\"\\n\", lineStart);\n\t\t\t}\n\t\t\tpending = pending.slice(lineStart);\n\t\t}\n\n\t\tpending += decoder.end();\n\t\tconst finalEntry = parseSessionEntryLine(pending);\n\t\tif (finalEntry) entries.push(finalEntry);\n\t} finally {\n\t\tcloseSync(fd);\n\t}\n\n\t// Validate session header\n\tif (entries.length === 0) return entries;\n\tconst header = entries[0];\n\tif (header.type !== \"session\" \|\| typeof (header as { id?: unknown }).id !== \"string\") {\n\t\treturn [];\n\t}\n\n\treturn entries;\n}\n\n/\n Preserve a corrupt (non-empty, headerless) session file by renaming it to\n * `<file>.corrupt-<timestamp>` so recovery never destroys user data.\n * Returns the backup path, or null if the file was empty (nothing to preserve).\n /\nfunction backupCorruptSessionFile(filePath: string): string \| null {\n\ttry {\n\t\tif (statSync(filePath).size === 0) return null;\n\t} catch {\n\t\treturn null;\n\t}\n\tconst timestamp = new Date().toISOString().replace(/[:.]/g, \"-\");\n\tlet backupPath = `${filePath}.corrupt-${timestamp}`;\n\tlet counter = 0;\n\twhile (existsSync(backupPath)) {\n\t\tcounter++;\n\t\tbackupPath = `${filePath}.corrupt-${timestamp}-${counter}`;\n\t}\n\trenameSync(filePath, backupPath);\n\treturn backupPath;\n}\n\nfunction readSessionHeader(filePath: string): SessionHeader \| null {\n\ttry {\n\t\tconst fd = openSync(filePath, \"r\");\n\t\tconst buffer = Buffer.alloc(512);\n\t\tconst bytesRead = readSync(fd, buffer, 0, 512, 0);\n\t\tcloseSync(fd);\n\t\tconst firstLine = buffer.toString(\"utf8\", 0, bytesRead).split(\"\\n\")[0];\n\t\tif (!firstLine) return null;\n\t\tconst header = JSON.parse(firstLine) as Record<string, unknown>;\n\t\tif (header.type !== \"session\" \|\| typeof header.id !== \"string\") {\n\t\t\treturn null;\n\t\t}\n\t\treturn header as unknown as SessionHeader;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nfunction getSessionHeaderCwd(header: SessionHeader): string \| undefined {\n\tconst cwd = (header as { cwd?: unknown }).cwd;\n\treturn typeof cwd === \"string\" ? cwd : undefined;\n}\n\nfunction sessionCwdMatches(cwd: string \| undefined, resolvedCwd: string): boolean {\n\treturn cwd !== undefined && cwd !== \"\" && resolvePath(cwd) === resolvedCwd;\n}\n\n/* Exported for testing /\nexport function findMostRecentSession(sessionDir: string, cwd?: string): string \| null {\n\tconst resolvedSessionDir = normalizePath(sessionDir);\n\tconst resolvedCwd = cwd ? resolvePath(cwd) : undefined;\n\ttry {\n\t\tconst files = readdirSync(resolvedSessionDir)\n\t\t\t.filter((f) => f.endsWith(\".jsonl\"))\n\t\t\t.map((f) => join(resolvedSessionDir, f))\n\t\t\t.map((path) => ({ path, header: readSessionHeader(path) }))\n\t\t\t.filter(\n\t\t\t\t(file): file is { path: string; header: SessionHeader } =>\n\t\t\t\t\tfile.header !== null &&\n\t\t\t\t\t(!resolvedCwd \|\| sessionCwdMatches(getSessionHeaderCwd(file.header), resolvedCwd)),\n\t\t\t)\n\t\t\t.map(({ path }) => ({ path, mtime: statSync(path).mtime }))\n\t\t\t.sort((a, b) => b.mtime.getTime() - a.mtime.getTime());\n\n\t\treturn files[0]?.path \|\| null;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nfunction isMessageWithContent(message: AgentMessage): message is Message {\n\treturn typeof (message as Message).role === \"string\" && \"content\" in message;\n}\n\nfunction extractTextContent(message: Message): string {\n\tconst content = message.content;\n\tif (typeof content === \"string\") {\n\t\treturn content;\n\t}\n\treturn content\n\t\t.filter((block): block is TextContent => block.type === \"text\")\n\t\t.map((block) => block.text)\n\t\t.join(\" \");\n}\n\nfunction getMessageActivityTime(entry: SessionMessageEntry): number \| undefined {\n\tconst message = entry.message;\n\tif (!isMessageWithContent(message)) return undefined;\n\tif (message.role !== \"user\" && message.role !== \"assistant\") return undefined;\n\n\tconst msgTimestamp = (message as { timestamp?: number }).timestamp;\n\tif (typeof msgTimestamp === \"number\") {\n\t\treturn msgTimestamp;\n\t}\n\n\tconst t = new Date(entry.timestamp).getTime();\n\treturn Number.isNaN(t) ? undefined : t;\n}\n\nasync function buildSessionInfo(filePath: string): Promise<SessionInfo \| null> {\n\ttry {\n\t\tconst stats = await stat(filePath);\n\t\tlet header: SessionHeader \| null = null;\n\t\tlet messageCount = 0;\n\t\tlet firstMessage = \"\";\n\t\tconst allMessagesDigest = new BoundedDigestAccumulator({ maxChars: DEFAULT_SESSION_DIGEST_MAX_CHARS });\n\t\tlet name: string \| undefined;\n\t\tlet lastActivityTime: number \| undefined;\n\n\t\tconst rl = createInterface({\n\t\t\tinput: createReadStream(filePath, { encoding: \"utf8\" }),\n\t\t\tcrlfDelay: Infinity,\n\t\t});\n\n\t\tfor await (const line of rl) {\n\t\t\tconst entry = parseSessionEntryLine(line);\n\t\t\tif (!entry) continue;\n\n\t\t\tif (!header) {\n\t\t\t\tif (entry.type !== \"session\") return null;\n\t\t\t\theader = entry;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Extract session name (use latest, including explicit clears)\n\t\t\tif (entry.type === \"session_info\") {\n\t\t\t\tname = entry.name?.trim() \|\| undefined;\n\t\t\t}\n\n\t\t\tif (entry.type !== \"message\") continue;\n\t\t\tmessageCount++;\n\n\t\t\tconst activityTime = getMessageActivityTime(entry);\n\t\t\tif (typeof activityTime === \"number\") {\n\t\t\t\tlastActivityTime = Math.max(lastActivityTime ?? 0, activityTime);\n\t\t\t}\n\n\t\t\tconst message = entry.message;\n\t\t\tif (!isMessageWithContent(message)) continue;\n\t\t\tif (message.role !== \"user\" && message.role !== \"assistant\") continue;\n\n\t\t\tconst textContent = extractTextContent(message);\n\t\t\tif (!textContent) continue;\n\n\t\t\tallMessagesDigest.push(textContent);\n\t\t\tif (!firstMessage && message.role === \"user\") {\n\t\t\t\tfirstMessage = boundSessionFirstMessage(textContent);\n\t\t\t}\n\t\t}\n\n\t\tif (!header) return null;\n\n\t\tconst cwd = typeof header.cwd === \"string\" ? header.cwd : \"\";\n\t\tconst parentSessionPath = header.parentSession;\n\t\tconst headerTime = typeof header.timestamp === \"string\" ? new Date(header.timestamp).getTime() : NaN;\n\t\tconst modified =\n\t\t\ttypeof lastActivityTime === \"number\" && lastActivityTime > 0\n\t\t\t\t? new Date(lastActivityTime)\n\t\t\t\t: !Number.isNaN(headerTime)\n\t\t\t\t\t? new Date(headerTime)\n\t\t\t\t\t: stats.mtime;\n\n\t\treturn {\n\t\t\tpath: filePath,\n\t\t\tid: header.id,\n\t\t\tcwd,\n\t\t\tname,\n\t\t\tparentSessionPath,\n\t\t\tcreated: new Date(header.timestamp),\n\t\t\tmodified,\n\t\t\tmessageCount,\n\t\t\tfirstMessage: firstMessage \|\| \"(no messages)\",\n\t\t\tallMessagesText: allMessagesDigest.result().text,\n\t\t};\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nexport type SessionListProgress = (loaded: number, total: number) => void;\n\nconst MAX_CONCURRENT_SESSION_INFO_LOADS = 10;\n\nasync function buildSessionInfosWithConcurrency(\n\tfiles: string[],\n\tonLoaded: () => void,\n): Promise<(SessionInfo \| null)[]> {\n\tconst results: (SessionInfo \| null)[] = new Array(files.length).fill(null);\n\tconst inFlight = new Set<Promise<void>>();\n\tlet nextIndex = 0;\n\n\tconst startNext = (): void => {\n\t\tconst index = nextIndex++;\n\t\tconst file = files[index];\n\t\tif (!file) return;\n\n\t\tlet task: Promise<void>;\n\t\ttask = buildSessionInfo(file)\n\t\t\t.then((info) => {\n\t\t\t\tresults[index] = info;\n\t\t\t})\n\t\t\t.catch(() => {\n\t\t\t\tresults[index] = null;\n\t\t\t})\n\t\t\t.finally(() => {\n\t\t\t\tinFlight.delete(task);\n\t\t\t\tonLoaded();\n\t\t\t});\n\t\tinFlight.add(task);\n\t};\n\n\twhile (nextIndex < files.length \|\| inFlight.size > 0) {\n\t\twhile (nextIndex < files.length && inFlight.size < MAX_CONCURRENT_SESSION_INFO_LOADS) {\n\t\t\tstartNext();\n\t\t}\n\t\tif (inFlight.size > 0) {\n\t\t\tawait Promise.race(inFlight);\n\t\t}\n\t}\n\n\treturn results;\n}\n\nasync function listSessionsFromDir(\n\tdir: string,\n\tonProgress?: SessionListProgress,\n\tprogressOffset = 0,\n\tprogressTotal?: number,\n): Promise<SessionInfo[]> {\n\tconst sessions: SessionInfo[] = [];\n\tif (!existsSync(dir)) {\n\t\treturn sessions;\n\t}\n\n\ttry {\n\t\tconst dirEntries = await readdir(dir);\n\t\tconst files = dirEntries.filter((f) => f.endsWith(\".jsonl\")).map((f) => join(dir, f));\n\t\tconst total = progressTotal ?? files.length;\n\n\t\tlet loaded = 0;\n\t\tconst results = await buildSessionInfosWithConcurrency(files, () => {\n\t\t\tloaded++;\n\t\t\tonProgress?.(progressOffset + loaded, total);\n\t\t});\n\t\tfor (const info of results) {\n\t\t\tif (info) {\n\t\t\t\tsessions.push(info);\n\t\t\t}\n\t\t}\n\t} catch {\n\t\t// Return empty list on error\n\t}\n\n\treturn sessions;\n}\n\n/\n Manages conversation sessions as append-only trees stored in JSONL files.\n \n Each session entry has an id and parentId forming a tree structure. The \"leaf\"\n * pointer tracks the current position. Appending creates a child of the current leaf.\n * Branching moves the leaf to an earlier entry, allowing new branches without\n * modifying history.\n \n Use buildSessionContext() to get the resolved message list for the LLM, which\n * handles compaction summaries and follows the path from root to current leaf.\n /\nexport class SessionManager {\n\tprivate sessionId: string = \"\";\n\tprivate sessionFile: string \| undefined;\n\tprivate sessionDir: string;\n\tprivate cwd: string;\n\tprivate persist: boolean;\n\tprivate flushed: boolean = false;\n\tprivate fileEntries: FileEntry[] = [];\n\tprivate byId: Map<string, SessionEntry> = new Map();\n\tprivate labelsById: Map<string, string> = new Map();\n\tprivate labelTimestampsById: Map<string, string> = new Map();\n\tprivate leafId: string \| null = null;\n\n\tprivate constructor(\n\t\tcwd: string,\n\t\tsessionDir: string,\n\t\tsessionFile: string \| undefined,\n\t\tpersist: boolean,\n\t\tnewSessionOptions?: NewSessionOptions,\n\t) {\n\t\tthis.cwd = resolvePath(cwd);\n\t\tthis.sessionDir = normalizePath(sessionDir);\n\t\tthis.persist = persist;\n\t\tif (persist && this.sessionDir && !existsSync(this.sessionDir)) {\n\t\t\tmkdirSync(this.sessionDir, { recursive: true });\n\t\t}\n\n\t\tif (sessionFile) {\n\t\t\tthis.setSessionFile(sessionFile);\n\t\t} else {\n\t\t\tthis.newSession(newSessionOptions);\n\t\t}\n\t}\n\n\t/* Switch to a different session file (used for resume and branching) /\n\tsetSessionFile(sessionFile: string): void {\n\t\tthis.sessionFile = resolvePath(sessionFile);\n\t\tif (existsSync(this.sessionFile)) {\n\t\t\tthis.fileEntries = loadEntriesFromFile(this.sessionFile);\n\n\t\t\t// If file was empty or corrupted (no valid header), start fresh to avoid\n\t\t\t// appending messages without a session header (which breaks the session).\n\t\t\t// Never destroy existing data: if the file has content, preserve the\n\t\t\t// original as a .corrupt- backup before rewriting.\n\t\t\tif (this.fileEntries.length === 0) {\n\t\t\t\tconst explicitPath = this.sessionFile;\n\t\t\t\tif (this.persist) {\n\t\t\t\t\tbackupCorruptSessionFile(explicitPath);\n\t\t\t\t}\n\t\t\t\tthis.newSession();\n\t\t\t\tthis.sessionFile = explicitPath;\n\t\t\t\tthis._rewriteFile();\n\t\t\t\tthis.flushed = true;\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst header = this.fileEntries.find((e) => e.type === \"session\") as SessionHeader \| undefined;\n\t\t\tthis.sessionId = header?.id ?? createSessionId();\n\n\t\t\tif (migrateToCurrentVersion(this.fileEntries)) {\n\t\t\t\tthis._rewriteFile();\n\t\t\t}\n\n\t\t\tthis._buildIndex();\n\t\t\tthis.flushed = true;\n\t\t} else {\n\t\t\tconst explicitPath = this.sessionFile;\n\t\t\tthis.newSession();\n\t\t\tthis.sessionFile = explicitPath; // preserve explicit path from --session flag\n\t\t}\n\t}\n\n\tnewSession(options?: NewSessionOptions): string \| undefined {\n\t\tif (options?.id !== undefined) {\n\t\t\tassertValidSessionId(options.id);\n\t\t}\n\t\tthis.sessionId = options?.id ?? createSessionId();\n\t\tconst timestamp = new Date().toISOString();\n\t\tconst header: SessionHeader = {\n\t\t\ttype: \"session\",\n\t\t\tversion: CURRENT_SESSION_VERSION,\n\t\t\tid: this.sessionId,\n\t\t\ttimestamp,\n\t\t\tcwd: this.cwd,\n\t\t\tparentSession: options?.parentSession,\n\t\t};\n\t\tthis.fileEntries = [header];\n\t\tthis.byId.clear();\n\t\tthis.labelsById.clear();\n\t\tthis.leafId = null;\n\t\tthis.flushed = false;\n\n\t\tif (this.persist) {\n\t\t\tconst fileTimestamp = timestamp.replace(/[:.]/g, \"-\");\n\t\t\tthis.sessionFile = join(this.getSessionDir(), `${fileTimestamp}_${this.sessionId}.jsonl`);\n\t\t}\n\t\treturn this.sessionFile;\n\t}\n\n\tprivate _buildIndex(): void {\n\t\tthis.byId.clear();\n\t\tthis.labelsById.clear();\n\t\tthis.labelTimestampsById.clear();\n\t\tthis.leafId = null;\n\t\tfor (const entry of this.fileEntries) {\n\t\t\tif (entry.type === \"session\") continue;\n\t\t\tthis.byId.set(entry.id, entry);\n\t\t\tthis.leafId = entry.id;\n\t\t\tif (entry.type === \"label\") {\n\t\t\t\tif (entry.label) {\n\t\t\t\t\tthis.labelsById.set(entry.targetId, entry.label);\n\t\t\t\t\tthis.labelTimestampsById.set(entry.targetId, entry.timestamp);\n\t\t\t\t} else {\n\t\t\t\t\tthis.labelsById.delete(entry.targetId);\n\t\t\t\t\tthis.labelTimestampsById.delete(entry.targetId);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate _rewriteFile(): void {\n\t\tif (!this.persist \|\| !this.sessionFile) return;\n\t\tconst fd = openSync(this.sessionFile, \"w\");\n\t\ttry {\n\t\t\tfor (const entry of this.fileEntries) {\n\t\t\t\twriteFileSync(fd, `${JSON.stringify(entry)}\\n`);\n\t\t\t}\n\t\t} finally {\n\t\t\tcloseSync(fd);\n\t\t}\n\t}\n\n\tisPersisted(): boolean {\n\t\treturn this.persist;\n\t}\n\n\tgetCwd(): string {\n\t\treturn this.cwd;\n\t}\n\n\tgetSessionDir(): string {\n\t\treturn this.sessionDir;\n\t}\n\n\tusesDefaultSessionDir(): boolean {\n\t\treturn this.sessionDir === getDefaultSessionDirPath(this.cwd);\n\t}\n\n\tgetSessionId(): string {\n\t\treturn this.sessionId;\n\t}\n\n\tgetSessionFile(): string \| undefined {\n\t\treturn this.sessionFile;\n\t}\n\n\t_persist(entry: SessionEntry): void {\n\t\tif (!this.persist \|\| !this.sessionFile) return;\n\n\t\tconst hasAssistant = this.fileEntries.some((e) => e.type === \"message\" && e.message.role === \"assistant\");\n\t\tif (!hasAssistant) {\n\t\t\tif (this.flushed) {\n\t\t\t\tappendFileSync(this.sessionFile, `${JSON.stringify(entry)}\\n`);\n\t\t\t} else {\n\t\t\t\t// Mark as not flushed so when assistant arrives, all entries get written\n\t\t\t\tthis.flushed = false;\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\tif (!this.flushed) {\n\t\t\tconst fd = openSync(this.sessionFile, \"wx\");\n\t\t\ttry {\n\t\t\t\tfor (const e of this.fileEntries) {\n\t\t\t\t\twriteFileSync(fd, `${JSON.stringify(e)}\\n`);\n\t\t\t\t}\n\t\t\t} finally {\n\t\t\t\tcloseSync(fd);\n\t\t\t}\n\t\t\tthis.flushed = true;\n\t\t} else {\n\t\t\tappendFileSync(this.sessionFile, `${JSON.stringify(entry)}\\n`);\n\t\t}\n\t}\n\n\tprivate _appendEntry(entry: SessionEntry): void {\n\t\tthis.fileEntries.push(entry);\n\t\tthis.byId.set(entry.id, entry);\n\t\tthis.leafId = entry.id;\n\t\tthis._persist(entry);\n\t}\n\n\t/** Append a message as child of current leaf, then advance leaf. Returns entry id.\n\t * Does not allow writing CompactionSummaryMessage and BranchSummaryMessage directly.\n\t * Reason: we want these to be top-level entries in the session, not message session entries,\n\t * so it is easier to find them.\n\t * These need to be appended via appendCompaction() and appendBranchSummary() methods.\n\t /\n\tappendMessage(message: Message \| CustomMessage \| BashExecutionMessage): string {\n\t\tconst entry: SessionMessageEntry = {\n\t\t\ttype: \"message\",\n\t\t\tid: generateId(this.byId),\n\t\t\tparentId: this.leafId,\n\t\t\ttimestamp: new Date().toISOString(),\n\t\t\tmessage,\n\t\t};\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\t/* Append a thinking level change as child of current leaf, then advance leaf. Returns entry id. /\n\tappendThinkingLevelChange(thinkingLevel: string): string {\n\t\tconst entry: ThinkingLevelChangeEntry = {\n\t\t\ttype: \"thinking_level_change\",\n\t\t\tid: generateId(this.byId),\n\t\t\tparentId: this.leafId,\n\t\t\ttimestamp: new Date().toISOString(),\n\t\t\tthinkingLevel,\n\t\t};\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\t/* Append a model change as child of current leaf, then advance leaf. Returns entry id. /\n\tappendModelChange(provider: string, modelId: string): string {\n\t\tconst entry: ModelChangeEntry = {\n\t\t\ttype: \"model_change\",\n\t\t\tid: generateId(this.byId),\n\t\t\tparentId: this.leafId,\n\t\t\ttimestamp: new Date().toISOString(),\n\t\t\tprovider,\n\t\t\tmodelId,\n\t\t};\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\t/* Append a compaction summary as child of current leaf, then advance leaf. Returns entry id. /\n\tappendCompaction<T = unknown>(\n\t\tsummary: string,\n\t\tfirstKeptEntryId: string,\n\t\ttokensBefore: number,\n\t\tdetails?: T,\n\t\tfromHook?: boolean,\n\t): string {\n\t\tconst entry: CompactionEntry<T> = {\n\t\t\ttype: \"compaction\",\n\t\t\tid: generateId(this.byId),\n\t\t\tparentId: this.leafId,\n\t\t\ttimestamp: new Date().toISOString(),\n\t\t\tsummary,\n\t\t\tfirstKeptEntryId,\n\t\t\ttokensBefore,\n\t\t\tdetails,\n\t\t\tfromHook,\n\t\t};\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\t/* Append a custom entry (for extensions) as child of current leaf, then advance leaf. Returns entry id. /\n\tappendCustomEntry(customType: string, data?: unknown): string {\n\t\tconst entry: CustomEntry = {\n\t\t\ttype: \"custom\",\n\t\t\tcustomType,\n\t\t\tdata,\n\t\t\tid: generateId(this.byId),\n\t\t\tparentId: this.leafId,\n\t\t\ttimestamp: new Date().toISOString(),\n\t\t};\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\t/* Append a session info entry (e.g., display name). Returns entry id. /\n\tappendSessionInfo(name: string): string {\n\t\tconst entry: SessionInfoEntry = {\n\t\t\ttype: \"session_info\",\n\t\t\tid: generateId(this.byId),\n\t\t\tparentId: this.leafId,\n\t\t\ttimestamp: new Date().toISOString(),\n\t\t\tname: name.trim(),\n\t\t};\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\t/* Get the current session name from the latest session_info entry, if any. /\n\tgetSessionName(): string \| undefined {\n\t\t// Walk entries in reverse to find the latest session_info entry.\n\t\t// Empty names explicitly clear the session title.\n\t\tconst entries = this.getEntries();\n\t\tfor (let i = entries.length - 1; i >= 0; i--) {\n\t\t\tconst entry = entries[i];\n\t\t\tif (entry.type === \"session_info\") {\n\t\t\t\treturn entry.name?.trim() \|\| undefined;\n\t\t\t}\n\t\t}\n\t\treturn undefined;\n\t}\n\n\t/\n\t Append a custom message entry (for extensions) that participates in LLM context.\n\t * @param customType Extension identifier for filtering on reload\n\t * @param content Message content (string or TextContent/ImageContent array)\n\t * @param display Whether to show in TUI (true = styled display, false = hidden)\n\t * @param details Optional extension-specific metadata (not sent to LLM)\n\t * @returns Entry id\n\t /\n\tappendCustomMessageEntry<T = unknown>(\n\t\tcustomType: string,\n\t\tcontent: string \| (TextContent \| ImageContent)[],\n\t\tdisplay: boolean,\n\t\tdetails?: T,\n\t): string {\n\t\tconst entry: CustomMessageEntry<T> = {\n\t\t\ttype: \"custom_message\",\n\t\t\tcustomType,\n\t\t\tcontent,\n\t\t\tdisplay,\n\t\t\tdetails,\n\t\t\tid: generateId(this.byId),\n\t\t\tparentId: this.leafId,\n\t\t\ttimestamp: new Date().toISOString(),\n\t\t};\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\t// =========================================================================\n\t// Tree Traversal\n\t// =========================================================================\n\n\tgetLeafId(): string \| null {\n\t\treturn this.leafId;\n\t}\n\n\tgetLeafEntry(): SessionEntry \| undefined {\n\t\treturn this.leafId ? this.byId.get(this.leafId) : undefined;\n\t}\n\n\tgetEntry(id: string): SessionEntry \| undefined {\n\t\treturn this.byId.get(id);\n\t}\n\n\t/\n\t Get all direct children of an entry.\n\t /\n\tgetChildren(parentId: string): SessionEntry[] {\n\t\tconst children: SessionEntry[] = [];\n\t\tfor (const entry of this.byId.values()) {\n\t\t\tif (entry.parentId === parentId) {\n\t\t\t\tchildren.push(entry);\n\t\t\t}\n\t\t}\n\t\treturn children;\n\t}\n\n\t/\n\t Get the label for an entry, if any.\n\t /\n\tgetLabel(id: string): string \| undefined {\n\t\treturn this.labelsById.get(id);\n\t}\n\n\t/\n\t Set or clear a label on an entry.\n\t * Labels are user-defined markers for bookmarking/navigation.\n\t * Pass undefined or empty string to clear the label.\n\t /\n\tappendLabelChange(targetId: string, label: string \| undefined): string {\n\t\tif (!this.byId.has(targetId)) {\n\t\t\tthrow new Error(`Entry ${targetId} not found`);\n\t\t}\n\t\tconst entry: LabelEntry = {\n\t\t\ttype: \"label\",\n\t\t\tid: generateId(this.byId),\n\t\t\tparentId: this.leafId,\n\t\t\ttimestamp: new Date().toISOString(),\n\t\t\ttargetId,\n\t\t\tlabel,\n\t\t};\n\t\tthis._appendEntry(entry);\n\t\tif (label) {\n\t\t\tthis.labelsById.set(targetId, label);\n\t\t\tthis.labelTimestampsById.set(targetId, entry.timestamp);\n\t\t} else {\n\t\t\tthis.labelsById.delete(targetId);\n\t\t\tthis.labelTimestampsById.delete(targetId);\n\t\t}\n\t\treturn entry.id;\n\t}\n\n\t/\n\t Walk from entry to root, returning all entries in path order.\n\t * Includes all entry types (messages, compaction, model changes, etc.).\n\t * Use buildSessionContext() to get the resolved messages for the LLM.\n\t /\n\tgetBranch(fromId?: string): SessionEntry[] {\n\t\tconst path: SessionEntry[] = [];\n\t\tconst startId = fromId ?? this.leafId;\n\t\tlet current = startId ? this.byId.get(startId) : undefined;\n\t\twhile (current) {\n\t\t\tpath.unshift(current);\n\t\t\tcurrent = current.parentId ? this.byId.get(current.parentId) : undefined;\n\t\t}\n\t\treturn path;\n\t}\n\n\t/\n\t Build the session context (what gets sent to the LLM).\n\t * Uses tree traversal from current leaf.\n\t /\n\tbuildSessionContext(): SessionContext {\n\t\treturn buildSessionContext(this.getEntries(), this.leafId, this.byId);\n\t}\n\n\t/\n\t Get session header.\n\t /\n\tgetHeader(): SessionHeader \| null {\n\t\tconst h = this.fileEntries.find((e) => e.type === \"session\");\n\t\treturn h ? (h as SessionHeader) : null;\n\t}\n\n\t/\n\t Get all session entries (excludes header). Returns a shallow copy.\n\t * The session is append-only: use appendXXX() to add entries, branch() to\n\t * change the leaf pointer. Entries cannot be modified or deleted.\n\t /\n\tgetEntries(): SessionEntry[] {\n\t\treturn this.fileEntries.filter((e): e is SessionEntry => e.type !== \"session\");\n\t}\n\n\t/\n\t Get the session as a tree structure. Returns a shallow defensive copy of all entries.\n\t * A well-formed session has exactly one root (first entry with parentId === null).\n\t * Orphaned entries (broken parent chain) are also returned as roots.\n\t /\n\tgetTree(): SessionTreeNode[] {\n\t\tconst entries = this.getEntries();\n\t\tconst nodeMap = new Map<string, SessionTreeNode>();\n\t\tconst roots: SessionTreeNode[] = [];\n\n\t\t// Create nodes with resolved labels\n\t\tfor (const entry of entries) {\n\t\t\tconst label = this.labelsById.get(entry.id);\n\t\t\tconst labelTimestamp = this.labelTimestampsById.get(entry.id);\n\t\t\tnodeMap.set(entry.id, { entry, children: [], label, labelTimestamp });\n\t\t}\n\n\t\t// Build tree\n\t\tfor (const entry of entries) {\n\t\t\tconst node = nodeMap.get(entry.id)!;\n\t\t\tif (entry.parentId === null \|\| entry.parentId === entry.id) {\n\t\t\t\troots.push(node);\n\t\t\t} else {\n\t\t\t\tconst parent = nodeMap.get(entry.parentId);\n\t\t\t\tif (parent) {\n\t\t\t\t\tparent.children.push(node);\n\t\t\t\t} else {\n\t\t\t\t\t// Orphan - treat as root\n\t\t\t\t\troots.push(node);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Sort children by timestamp (oldest first, newest at bottom)\n\t\t// Use iterative approach to avoid stack overflow on deep trees\n\t\tconst stack: SessionTreeNode[] = [...roots];\n\t\twhile (stack.length > 0) {\n\t\t\tconst node = stack.pop()!;\n\t\t\tnode.children.sort((a, b) => new Date(a.entry.timestamp).getTime() - new Date(b.entry.timestamp).getTime());\n\t\t\tstack.push(...node.children);\n\t\t}\n\n\t\treturn roots;\n\t}\n\n\t// =========================================================================\n\t// Branching\n\t// =========================================================================\n\n\t/\n\t Start a new branch from an earlier entry.\n\t * Moves the leaf pointer to the specified entry. The next appendXXX() call\n\t * will create a child of that entry, forming a new branch. Existing entries\n\t * are not modified or deleted.\n\t /\n\tbranch(branchFromId: string): void {\n\t\tif (!this.byId.has(branchFromId)) {\n\t\t\tthrow new Error(`Entry ${branchFromId} not found`);\n\t\t}\n\t\tthis.leafId = branchFromId;\n\t}\n\n\t/\n\t Reset the leaf pointer to null (before any entries).\n\t * The next appendXXX() call will create a new root entry (parentId = null).\n\t * Use this when navigating to re-edit the first user message.\n\t /\n\tresetLeaf(): void {\n\t\tthis.leafId = null;\n\t}\n\n\t/\n\t Start a new branch with a summary of the abandoned path.\n\t * Same as branch(), but also appends a branch_summary entry that captures\n\t * context from the abandoned conversation path.\n\t /\n\tbranchWithSummary(branchFromId: string \| null, summary: string, details?: unknown, fromHook?: boolean): string {\n\t\tif (branchFromId !== null && !this.byId.has(branchFromId)) {\n\t\t\tthrow new Error(`Entry ${branchFromId} not found`);\n\t\t}\n\t\tthis.leafId = branchFromId;\n\t\tconst entry: BranchSummaryEntry = {\n\t\t\ttype: \"branch_summary\",\n\t\t\tid: generateId(this.byId),\n\t\t\tparentId: branchFromId,\n\t\t\ttimestamp: new Date().toISOString(),\n\t\t\tfromId: branchFromId ?? \"root\",\n\t\t\tsummary,\n\t\t\tdetails,\n\t\t\tfromHook,\n\t\t};\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\t/\n\t Create a new session file containing only the path from root to the specified leaf.\n\t * Useful for extracting a single conversation path from a branched session.\n\t * Returns the new session file path, or undefined if not persisting.\n\t /\n\tcreateBranchedSession(leafId: string): string \| undefined {\n\t\tconst previousSessionFile = this.sessionFile;\n\t\tconst path = this.getBranch(leafId);\n\t\tif (path.length === 0) {\n\t\t\tthrow new Error(`Entry ${leafId} not found`);\n\t\t}\n\n\t\t// Filter out LabelEntry from path - we'll recreate them from the resolved map\n\t\tconst pathWithoutLabels = path.filter((e) => e.type !== \"label\");\n\n\t\tconst newSessionId = createSessionId();\n\t\tconst timestamp = new Date().toISOString();\n\t\tconst fileTimestamp = timestamp.replace(/[:.]/g, \"-\");\n\t\tconst newSessionFile = join(this.getSessionDir(), `${fileTimestamp}_${newSessionId}.jsonl`);\n\n\t\tconst header: SessionHeader = {\n\t\t\ttype: \"session\",\n\t\t\tversion: CURRENT_SESSION_VERSION,\n\t\t\tid: newSessionId,\n\t\t\ttimestamp,\n\t\t\tcwd: this.cwd,\n\t\t\tparentSession: this.persist ? previousSessionFile : undefined,\n\t\t};\n\n\t\t// Collect labels for entries in the path\n\t\tconst pathEntryIds = new Set(pathWithoutLabels.map((e) => e.id));\n\t\tconst labelsToWrite: Array<{ targetId: string; label: string; timestamp: string }> = [];\n\t\tfor (const [targetId, label] of this.labelsById) {\n\t\t\tif (pathEntryIds.has(targetId)) {\n\t\t\t\tlabelsToWrite.push({ targetId, label, timestamp: this.labelTimestampsById.get(targetId)! });\n\t\t\t}\n\t\t}\n\n\t\tif (this.persist) {\n\t\t\t// Build label entries\n\t\t\tconst lastEntryId = pathWithoutLabels[pathWithoutLabels.length - 1]?.id \|\| null;\n\t\t\tlet parentId = lastEntryId;\n\t\t\tconst labelEntries: LabelEntry[] = [];\n\t\t\tfor (const { targetId, label, timestamp: labelTimestamp } of labelsToWrite) {\n\t\t\t\tconst labelEntry: LabelEntry = {\n\t\t\t\t\ttype: \"label\",\n\t\t\t\t\tid: generateId(new Set(pathEntryIds)),\n\t\t\t\t\tparentId,\n\t\t\t\t\ttimestamp: labelTimestamp,\n\t\t\t\t\ttargetId,\n\t\t\t\t\tlabel,\n\t\t\t\t};\n\t\t\t\tpathEntryIds.add(labelEntry.id);\n\t\t\t\tlabelEntries.push(labelEntry);\n\t\t\t\tparentId = labelEntry.id;\n\t\t\t}\n\n\t\t\tthis.fileEntries = [header, ...pathWithoutLabels, ...labelEntries];\n\t\t\tthis.sessionId = newSessionId;\n\t\t\tthis.sessionFile = newSessionFile;\n\t\t\tthis._buildIndex();\n\n\t\t\t// Only write the file now if it contains an assistant message.\n\t\t\t// Otherwise defer to _persist(), which creates the file on the\n\t\t\t// first assistant response, matching the newSession() contract\n\t\t\t// and avoiding the duplicate-header bug when _persist()'s\n\t\t\t// no-assistant guard later resets flushed to false.\n\t\t\tconst hasAssistant = this.fileEntries.some((e) => e.type === \"message\" && e.message.role === \"assistant\");\n\t\t\tif (hasAssistant) {\n\t\t\t\tthis._rewriteFile();\n\t\t\t\tthis.flushed = true;\n\t\t\t} else {\n\t\t\t\tthis.flushed = false;\n\t\t\t}\n\n\t\t\treturn newSessionFile;\n\t\t}\n\n\t\t// In-memory mode: replace current session with the path + labels\n\t\tconst labelEntries: LabelEntry[] = [];\n\t\tlet parentId = pathWithoutLabels[pathWithoutLabels.length - 1]?.id \|\| null;\n\t\tfor (const { targetId, label, timestamp: labelTimestamp } of labelsToWrite) {\n\t\t\tconst labelEntry: LabelEntry = {\n\t\t\t\ttype: \"label\",\n\t\t\t\tid: generateId(new Set([...pathEntryIds, ...labelEntries.map((e) => e.id)])),\n\t\t\t\tparentId,\n\t\t\t\ttimestamp: labelTimestamp,\n\t\t\t\ttargetId,\n\t\t\t\tlabel,\n\t\t\t};\n\t\t\tlabelEntries.push(labelEntry);\n\t\t\tparentId = labelEntry.id;\n\t\t}\n\t\tthis.fileEntries = [header, ...pathWithoutLabels, ...labelEntries];\n\t\tthis.sessionId = newSessionId;\n\t\tthis._buildIndex();\n\t\treturn undefined;\n\t}\n\n\t/\n\t Create a new session.\n\t * @param cwd Working directory (stored in session header)\n\t * @param sessionDir Optional session directory. If omitted, uses default (~/.omk/agent/sessions/<encoded-cwd>/).\n\t /\n\tstatic create(cwd: string, sessionDir?: string, options?: NewSessionOptions): SessionManager {\n\t\tconst dir = sessionDir ? normalizePath(sessionDir) : getDefaultSessionDir(cwd);\n\t\treturn new SessionManager(cwd, dir, undefined, true, options);\n\t}\n\n\t/\n\t Open a specific session file.\n\t * @param path Path to session file\n\t * @param sessionDir Optional session directory for /new or /branch. If omitted, derives from file's parent.\n\t * @param cwdOverride Optional cwd override instead of the session header cwd.\n\t /\n\tstatic open(path: string, sessionDir?: string, cwdOverride?: string): SessionManager {\n\t\tconst resolvedPath = resolvePath(path);\n\t\t// Extract cwd from session header if possible, otherwise use process.cwd()\n\t\tconst entries = loadEntriesFromFile(resolvedPath);\n\t\tconst header = entries.find((e) => e.type === \"session\") as SessionHeader \| undefined;\n\t\tconst cwd = cwdOverride ?? header?.cwd ?? process.cwd();\n\t\t// If no sessionDir provided, derive from file's parent directory\n\t\tconst dir = sessionDir ? normalizePath(sessionDir) : resolve(resolvedPath, \"..\");\n\t\treturn new SessionManager(cwd, dir, resolvedPath, true);\n\t}\n\n\t/\n\t Continue the most recent session, or create new if none.\n\t * @param cwd Working directory\n\t * @param sessionDir Optional session directory. If omitted, uses default (~/.omk/agent/sessions/<encoded-cwd>/).\n\t /\n\tstatic continueRecent(cwd: string, sessionDir?: string): SessionManager {\n\t\tconst dir = sessionDir ? normalizePath(sessionDir) : getDefaultSessionDir(cwd);\n\t\tconst filterCwd = sessionDir !== undefined && dir !== getDefaultSessionDirPath(cwd);\n\t\tconst mostRecent = findMostRecentSession(dir, filterCwd ? cwd : undefined);\n\t\tif (mostRecent) {\n\t\t\treturn new SessionManager(cwd, dir, mostRecent, true);\n\t\t}\n\t\treturn new SessionManager(cwd, dir, undefined, true);\n\t}\n\n\t/* Create an in-memory session (no file persistence) /\n\tstatic inMemory(cwd: string = process.cwd()): SessionManager {\n\t\treturn new SessionManager(cwd, \"\", undefined, false);\n\t}\n\n\t/\n\t Fork a session from another project directory into the current project.\n\t * Creates a new session in the target cwd with the full history from the source session.\n\t * @param sourcePath Path to the source session file\n\t * @param targetCwd Target working directory (where the new session will be stored)\n\t * @param sessionDir Optional session directory. If omitted, uses default for targetCwd.\n\t /\n\tstatic forkFrom(\n\t\tsourcePath: string,\n\t\ttargetCwd: string,\n\t\tsessionDir?: string,\n\t\toptions?: NewSessionOptions,\n\t): SessionManager {\n\t\tconst resolvedSourcePath = resolvePath(sourcePath);\n\t\tconst resolvedTargetCwd = resolvePath(targetCwd);\n\t\tconst sourceEntries = loadEntriesFromFile(resolvedSourcePath);\n\t\tif (sourceEntries.length === 0) {\n\t\t\tthrow new Error(`Cannot fork: source session file is empty or invalid: ${resolvedSourcePath}`);\n\t\t}\n\n\t\tconst sourceHeader = sourceEntries.find((e) => e.type === \"session\") as SessionHeader \| undefined;\n\t\tif (!sourceHeader) {\n\t\t\tthrow new Error(`Cannot fork: source session has no header: ${resolvedSourcePath}`);\n\t\t}\n\n\t\tconst dir = sessionDir ? normalizePath(sessionDir) : getDefaultSessionDir(resolvedTargetCwd);\n\t\tif (!existsSync(dir)) {\n\t\t\tmkdirSync(dir, { recursive: true });\n\t\t}\n\n\t\t// Create new session file with new ID but forked content\n\t\tif (options?.id !== undefined) {\n\t\t\tassertValidSessionId(options.id);\n\t\t}\n\t\tconst newSessionId = options?.id ?? createSessionId();\n\t\tconst timestamp = new Date().toISOString();\n\t\tconst fileTimestamp = timestamp.replace(/[:.]/g, \"-\");\n\t\tconst newSessionFile = join(dir, `${fileTimestamp}_${newSessionId}.jsonl`);\n\n\t\t// Write new header pointing to source as parent, with updated cwd\n\t\tconst newHeader: SessionHeader = {\n\t\t\ttype: \"session\",\n\t\t\tversion: CURRENT_SESSION_VERSION,\n\t\t\tid: newSessionId,\n\t\t\ttimestamp,\n\t\t\tcwd: resolvedTargetCwd,\n\t\t\tparentSession: resolvedSourcePath,\n\t\t};\n\t\twriteFileSync(newSessionFile, `${JSON.stringify(newHeader)}\\n`, { flag: \"wx\" });\n\n\t\t// Copy all non-header entries from source\n\t\tfor (const entry of sourceEntries) {\n\t\t\tif (entry.type !== \"session\") {\n\t\t\t\tappendFileSync(newSessionFile, `${JSON.stringify(entry)}\\n`);\n\t\t\t}\n\t\t}\n\n\t\treturn new SessionManager(resolvedTargetCwd, dir, newSessionFile, true);\n\t}\n\n\t/\n\t List all sessions for a directory.\n\t * @param cwd Working directory (used to compute default session directory)\n\t * @param sessionDir Optional session directory. If omitted, uses default (~/.omk/agent/sessions/<encoded-cwd>/).\n\t * @param onProgress Optional callback for progress updates (loaded, total)\n\t /\n\tstatic async list(cwd: string, sessionDir?: string, onProgress?: SessionListProgress): Promise<SessionInfo[]> {\n\t\tconst dir = sessionDir ? normalizePath(sessionDir) : getDefaultSessionDir(cwd);\n\t\tconst filterCwd = sessionDir !== undefined && dir !== getDefaultSessionDirPath(cwd);\n\t\tconst resolvedCwd = resolvePath(cwd);\n\t\tconst sessions = (await listSessionsFromDir(dir, onProgress)).filter(\n\t\t\t(session) => !filterCwd \|\| sessionCwdMatches(session.cwd, resolvedCwd),\n\t\t);\n\t\tsessions.sort((a, b) => b.modified.getTime() - a.modified.getTime());\n\t\treturn sessions;\n\t}\n\n\t/\n\t List all sessions across all project directories.\n\t * @param onProgress Optional callback for progress updates (loaded, total)\n\t */\n\tstatic async listAll(onProgress?: SessionListProgress): Promise<SessionInfo[]>;\n\tstatic async listAll(sessionDir?: string, onProgress?: SessionListProgress): Promise<SessionInfo[]>;\n\tstatic async listAll(\n\t\tsessionDirOrOnProgress?: string \| SessionListProgress,\n\t\tonProgress?: SessionListProgress,\n\t): Promise<SessionInfo[]> {\n\t\tconst customSessionDir =\n\t\t\ttypeof sessionDirOrOnProgress === \"string\" ? normalizePath(sessionDirOrOnProgress) : undefined;\n\t\tconst progress = typeof sessionDirOrOnProgress === \"function\" ? sessionDirOrOnProgress : onProgress;\n\t\tif (customSessionDir) {\n\t\t\tconst sessions = await listSessionsFromDir(customSessionDir, progress);\n\t\t\tsessions.sort((a, b) => b.modified.getTime() - a.modified.getTime());\n\t\t\treturn sessions;\n\t\t}\n\n\t\tconst sessionsDir = getSessionsDir();\n\n\t\ttry {\n\t\t\tif (!existsSync(sessionsDir)) {\n\t\t\t\treturn [];\n\t\t\t}\n\t\t\tconst entries = await readdir(sessionsDir, { withFileTypes: true });\n\t\t\tconst dirs = entries.filter((e) => e.isDirectory()).map((e) => join(sessionsDir, e.name));\n\n\t\t\t// Count total files first for accurate progress\n\t\t\tlet totalFiles = 0;\n\t\t\tconst dirFiles: string[][] = [];\n\t\t\tfor (const dir of dirs) {\n\t\t\t\ttry {\n\t\t\t\t\tconst files = (await readdir(dir)).filter((f) => f.endsWith(\".jsonl\"));\n\t\t\t\t\tdirFiles.push(files.map((f) => join(dir, f)));\n\t\t\t\t\ttotalFiles += files.length;\n\t\t\t\t} catch {\n\t\t\t\t\tdirFiles.push([]);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Process all files with progress tracking\n\t\t\tlet loaded = 0;\n\t\t\tconst sessions: SessionInfo[] = [];\n\t\t\tconst allFiles = dirFiles.flat();\n\n\t\t\tconst results = await buildSessionInfosWithConcurrency(allFiles, () => {\n\t\t\t\tloaded++;\n\t\t\t\tprogress?.(loaded, totalFiles);\n\t\t\t});\n\n\t\t\tfor (const info of results) {\n\t\t\t\tif (info) {\n\t\t\t\t\tsessions.push(info);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tsessions.sort((a, b) => b.modified.getTime() - a.modified.getTime());\n\t\t\treturn sessions;\n\t\t} catch {\n\t\t\treturn [];\n\t\t}\n\t}\n}\n"]}
1	+ {"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/core/session-manager.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"crypto\";\nimport {\n\tappendFileSync,\n\tcloseSync,\n\tcreateReadStream,\n\texistsSync,\n\tmkdirSync,\n\topenSync,\n\treaddirSync,\n\treadSync,\n\trenameSync,\n\tstatSync,\n\twriteFileSync,\n} from \"fs\";\nimport { readdir, stat } from \"fs/promises\";\nimport { type AgentMessage, uuidv7 } from \"omk-agent-core\";\nimport type { ImageContent, Message, TextContent } from \"omk-ai\";\nimport { join, resolve } from \"path\";\nimport { createInterface } from \"readline\";\nimport { StringDecoder } from \"string_decoder\";\nimport { getAgentDir as getDefaultAgentDir, getSessionsDir } from \"../config.ts\";\nimport { normalizePath, resolvePath } from \"../utils/paths.ts\";\nimport {\n\ttype BashExecutionMessage,\n\ttype CustomMessage,\n\tcreateBranchSummaryMessage,\n\tcreateCompactionSummaryMessage,\n\tcreateCustomMessage,\n} from \"./messages.ts\";\n\nexport const CURRENT_SESSION_VERSION = 3;\n\nexport interface SessionHeader {\n\ttype: \"session\";\n\tversion?: number; // v1 sessions don't have this\n\tid: string;\n\ttimestamp: string;\n\tcwd: string;\n\tparentSession?: string;\n}\n\nexport interface NewSessionOptions {\n\tid?: string;\n\tparentSession?: string;\n}\n\nexport interface SessionEntryBase {\n\ttype: string;\n\tid: string;\n\tparentId: string \| null;\n\ttimestamp: string;\n}\n\nexport interface SessionMessageEntry extends SessionEntryBase {\n\ttype: \"message\";\n\tmessage: AgentMessage;\n}\n\nexport interface ThinkingLevelChangeEntry extends SessionEntryBase {\n\ttype: \"thinking_level_change\";\n\tthinkingLevel: string;\n}\n\nexport interface ModelChangeEntry extends SessionEntryBase {\n\ttype: \"model_change\";\n\tprovider: string;\n\tmodelId: string;\n}\n\nexport interface CompactionEntry<T = unknown> extends SessionEntryBase {\n\ttype: \"compaction\";\n\tsummary: string;\n\tfirstKeptEntryId: string;\n\ttokensBefore: number;\n\t/** Extension-specific data (e.g., ArtifactIndex, version markers for structured compaction) /\n\tdetails?: T;\n\tfromHook?: boolean;\n}\n\nexport interface BranchSummaryEntry<T = unknown> extends SessionEntryBase {\n\ttype: \"branch_summary\";\n\tfromId: string;\n\tsummary: string;\n\t/* Extension-specific data (not sent to LLM) /\n\tdetails?: T;\n\tfromHook?: boolean;\n}\n\n/\n Custom entry for extensions to store extension-specific data in the session.\n * Use customType to identify your extension's entries.\n \n Purpose: Persist extension state across session reloads. On reload, extensions can\n * scan entries for their customType and reconstruct internal state.\n \n Does NOT participate in LLM context (ignored by buildSessionContext).\n * For injecting content into context, see CustomMessageEntry.\n /\nexport interface CustomEntry<T = unknown> extends SessionEntryBase {\n\ttype: \"custom\";\n\tcustomType: string;\n\tdata?: T;\n}\n\n/* Label entry for user-defined bookmarks/markers on entries. /\nexport interface LabelEntry extends SessionEntryBase {\n\ttype: \"label\";\n\ttargetId: string;\n\tlabel: string \| undefined;\n}\n\n/* Session metadata entry (e.g., user-defined display name). /\nexport interface SessionInfoEntry extends SessionEntryBase {\n\ttype: \"session_info\";\n\tname?: string;\n}\n\n/\n Custom message entry for extensions to inject messages into LLM context.\n * Use customType to identify your extension's entries.\n \n Unlike CustomEntry, this DOES participate in LLM context.\n * The content is converted to a user message in buildSessionContext().\n * Use details for extension-specific metadata (not sent to LLM).\n \n display controls TUI rendering:\n * - false: hidden entirely\n * - true: rendered with distinct styling (different from user messages)\n /\nexport interface CustomMessageEntry<T = unknown> extends SessionEntryBase {\n\ttype: \"custom_message\";\n\tcustomType: string;\n\tcontent: string \| (TextContent \| ImageContent)[];\n\tdetails?: T;\n\tdisplay: boolean;\n}\n\n/* Session entry - has id/parentId for tree structure (returned by \"read\" methods in SessionManager) /\nexport type SessionEntry =\n\t\| SessionMessageEntry\n\t\| ThinkingLevelChangeEntry\n\t\| ModelChangeEntry\n\t\| CompactionEntry\n\t\| BranchSummaryEntry\n\t\| CustomEntry\n\t\| CustomMessageEntry\n\t\| LabelEntry\n\t\| SessionInfoEntry;\n\n/* Raw file entry (includes header) /\nexport type FileEntry = SessionHeader \| SessionEntry;\n\n/* Tree node for getTree() - defensive copy of session structure /\nexport interface SessionTreeNode {\n\tentry: SessionEntry;\n\tchildren: SessionTreeNode[];\n\t/* Resolved label for this entry, if any /\n\tlabel?: string;\n\t/* Timestamp of the latest label change for this entry, if any /\n\tlabelTimestamp?: string;\n}\n\nexport interface SessionContext {\n\tmessages: AgentMessage[];\n\tthinkingLevel: string;\n\tmodel: { provider: string; modelId: string } \| null;\n}\n\nexport interface SessionInfo {\n\tpath: string;\n\tid: string;\n\t/* Working directory where the session was started. Empty string for old sessions. /\n\tcwd: string;\n\t/* User-defined display name from session_info entries. /\n\tname?: string;\n\t/* Path to the parent session (if this session was forked). /\n\tparentSessionPath?: string;\n\tcreated: Date;\n\tmodified: Date;\n\tmessageCount: number;\n\tfirstMessage: string;\n\tallMessagesText: string;\n}\n\nexport type ReadonlySessionManager = Pick<\n\tSessionManager,\n\t\| \"getCwd\"\n\t\| \"getSessionDir\"\n\t\| \"getSessionId\"\n\t\| \"getSessionFile\"\n\t\| \"getLeafId\"\n\t\| \"getLeafEntry\"\n\t\| \"getEntry\"\n\t\| \"getLabel\"\n\t\| \"getBranch\"\n\t\| \"getHeader\"\n\t\| \"getEntries\"\n\t\| \"getTree\"\n\t\| \"getSessionName\"\n>;\n\nfunction createSessionId(): string {\n\treturn uuidv7();\n}\n\nexport function assertValidSessionId(id: string): void {\n\tif (!/^[A-Za-z0-9](?:[A-Za-z0-9._-][A-Za-z0-9])?$/.test(id)) {\n\t\tthrow new Error(\n\t\t\t\"Session id must be non-empty, contain only alphanumeric characters, '-', '_', and '.', and start and end with an alphanumeric character\",\n\t\t);\n\t}\n}\n\n/** Generate a unique short ID (8 hex chars, collision-checked) /\nfunction generateId(byId: { has(id: string): boolean }): string {\n\tfor (let i = 0; i < 100; i++) {\n\t\tconst id = randomUUID().slice(0, 8);\n\t\tif (!byId.has(id)) return id;\n\t}\n\t// Fallback to full UUID if somehow we have collisions\n\treturn randomUUID();\n}\n\n/* Migrate v1 → v2: add id/parentId tree structure. Mutates in place. /\nfunction migrateV1ToV2(entries: FileEntry[]): void {\n\tconst ids = new Set<string>();\n\tlet prevId: string \| null = null;\n\n\tfor (const entry of entries) {\n\t\tif (entry.type === \"session\") {\n\t\t\tentry.version = 2;\n\t\t\tcontinue;\n\t\t}\n\n\t\tentry.id = generateId(ids);\n\t\tentry.parentId = prevId;\n\t\tprevId = entry.id;\n\n\t\t// Convert firstKeptEntryIndex to firstKeptEntryId for compaction\n\t\tif (entry.type === \"compaction\") {\n\t\t\tconst comp = entry as CompactionEntry & { firstKeptEntryIndex?: number };\n\t\t\tif (typeof comp.firstKeptEntryIndex === \"number\") {\n\t\t\t\tconst targetEntry = entries[comp.firstKeptEntryIndex];\n\t\t\t\tif (targetEntry && targetEntry.type !== \"session\") {\n\t\t\t\t\tcomp.firstKeptEntryId = targetEntry.id;\n\t\t\t\t}\n\t\t\t\tdelete comp.firstKeptEntryIndex;\n\t\t\t}\n\t\t}\n\t}\n}\n\n/* Migrate v2 → v3: rename hookMessage role to custom. Mutates in place. /\nfunction migrateV2ToV3(entries: FileEntry[]): void {\n\tfor (const entry of entries) {\n\t\tif (entry.type === \"session\") {\n\t\t\tentry.version = 3;\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Update message entries with hookMessage role\n\t\tif (entry.type === \"message\") {\n\t\t\tconst msgEntry = entry as SessionMessageEntry;\n\t\t\tif (msgEntry.message && (msgEntry.message as { role: string }).role === \"hookMessage\") {\n\t\t\t\t(msgEntry.message as { role: string }).role = \"custom\";\n\t\t\t}\n\t\t}\n\t}\n}\n\n/\n Run all necessary migrations to bring entries to current version.\n * Mutates entries in place. Returns true if any migration was applied.\n /\nfunction migrateToCurrentVersion(entries: FileEntry[]): boolean {\n\tconst header = entries.find((e) => e.type === \"session\") as SessionHeader \| undefined;\n\tconst version = header?.version ?? 1;\n\n\tif (version >= CURRENT_SESSION_VERSION) return false;\n\n\tif (version < 2) migrateV1ToV2(entries);\n\tif (version < 3) migrateV2ToV3(entries);\n\n\treturn true;\n}\n\n/* Exported for testing /\nexport function migrateSessionEntries(entries: FileEntry[]): void {\n\tmigrateToCurrentVersion(entries);\n}\n\n/* Exported for compaction.test.ts /\nexport function parseSessionEntries(content: string): FileEntry[] {\n\tconst entries: FileEntry[] = [];\n\tconst lines = content.trim().split(\"\\n\");\n\n\tfor (const line of lines) {\n\t\tif (!line.trim()) continue;\n\t\ttry {\n\t\t\tconst entry = JSON.parse(line) as FileEntry;\n\t\t\tentries.push(entry);\n\t\t} catch {\n\t\t\t// Skip malformed lines\n\t\t}\n\t}\n\n\treturn entries;\n}\n\nexport function getLatestCompactionEntry(entries: SessionEntry[]): CompactionEntry \| null {\n\tfor (let i = entries.length - 1; i >= 0; i--) {\n\t\tif (entries[i].type === \"compaction\") {\n\t\t\treturn entries[i] as CompactionEntry;\n\t\t}\n\t}\n\treturn null;\n}\n\n/\n Build the session context from entries using tree traversal.\n * If leafId is provided, walks from that entry to root.\n * Handles compaction and branch summaries along the path.\n /\nexport function buildSessionContext(\n\tentries: SessionEntry[],\n\tleafId?: string \| null,\n\tbyId?: Map<string, SessionEntry>,\n): SessionContext {\n\t// Build uuid index if not available\n\tif (!byId) {\n\t\tbyId = new Map<string, SessionEntry>();\n\t\tfor (const entry of entries) {\n\t\t\tbyId.set(entry.id, entry);\n\t\t}\n\t}\n\n\t// Find leaf\n\tlet leaf: SessionEntry \| undefined;\n\tif (leafId === null) {\n\t\t// Explicitly null - return no messages (navigated to before first entry)\n\t\treturn { messages: [], thinkingLevel: \"off\", model: null };\n\t}\n\tif (leafId) {\n\t\tleaf = byId.get(leafId);\n\t}\n\tif (!leaf) {\n\t\t// Fallback to last entry (when leafId is undefined)\n\t\tleaf = entries[entries.length - 1];\n\t}\n\n\tif (!leaf) {\n\t\treturn { messages: [], thinkingLevel: \"off\", model: null };\n\t}\n\n\t// Walk from leaf to root, collecting path\n\tconst path: SessionEntry[] = [];\n\tlet current: SessionEntry \| undefined = leaf;\n\twhile (current) {\n\t\tpath.unshift(current);\n\t\tcurrent = current.parentId ? byId.get(current.parentId) : undefined;\n\t}\n\n\t// Extract settings and find compaction\n\tlet thinkingLevel = \"off\";\n\tlet model: { provider: string; modelId: string } \| null = null;\n\tlet compaction: CompactionEntry \| null = null;\n\n\tfor (const entry of path) {\n\t\tif (entry.type === \"thinking_level_change\") {\n\t\t\tthinkingLevel = entry.thinkingLevel;\n\t\t} else if (entry.type === \"model_change\") {\n\t\t\tmodel = { provider: entry.provider, modelId: entry.modelId };\n\t\t} else if (entry.type === \"message\" && entry.message.role === \"assistant\") {\n\t\t\tmodel = { provider: entry.message.provider, modelId: entry.message.model };\n\t\t} else if (entry.type === \"compaction\") {\n\t\t\tcompaction = entry;\n\t\t}\n\t}\n\n\t// Build messages and collect corresponding entries\n\t// When there's a compaction, we need to:\n\t// 1. Emit summary first (entry = compaction)\n\t// 2. Emit kept messages (from firstKeptEntryId up to compaction)\n\t// 3. Emit messages after compaction\n\tconst messages: AgentMessage[] = [];\n\n\tconst appendMessage = (entry: SessionEntry) => {\n\t\tif (entry.type === \"message\") {\n\t\t\tmessages.push(entry.message);\n\t\t} else if (entry.type === \"custom_message\") {\n\t\t\tmessages.push(\n\t\t\t\tcreateCustomMessage(entry.customType, entry.content, entry.display, entry.details, entry.timestamp),\n\t\t\t);\n\t\t} else if (entry.type === \"branch_summary\" && entry.summary) {\n\t\t\tmessages.push(createBranchSummaryMessage(entry.summary, entry.fromId, entry.timestamp));\n\t\t}\n\t};\n\n\tif (compaction) {\n\t\t// Emit summary first\n\t\tmessages.push(createCompactionSummaryMessage(compaction.summary, compaction.tokensBefore, compaction.timestamp));\n\n\t\t// Find compaction index in path\n\t\tconst compactionIdx = path.findIndex((e) => e.type === \"compaction\" && e.id === compaction.id);\n\n\t\t// Emit kept messages (before compaction, starting from firstKeptEntryId)\n\t\tlet foundFirstKept = false;\n\t\tfor (let i = 0; i < compactionIdx; i++) {\n\t\t\tconst entry = path[i];\n\t\t\tif (entry.id === compaction.firstKeptEntryId) {\n\t\t\t\tfoundFirstKept = true;\n\t\t\t}\n\t\t\tif (foundFirstKept) {\n\t\t\t\tappendMessage(entry);\n\t\t\t}\n\t\t}\n\n\t\t// Emit messages after compaction\n\t\tfor (let i = compactionIdx + 1; i < path.length; i++) {\n\t\t\tconst entry = path[i];\n\t\t\tappendMessage(entry);\n\t\t}\n\t} else {\n\t\t// No compaction - emit all messages, handle branch summaries and custom messages\n\t\tfor (const entry of path) {\n\t\t\tappendMessage(entry);\n\t\t}\n\t}\n\n\treturn { messages, thinkingLevel, model };\n}\n\n/\n Compute the default session directory for a cwd.\n * Encodes cwd into a safe directory name under ~/.omk/agent/sessions/.\n /\nfunction getDefaultSessionDirPath(cwd: string, agentDir: string = getDefaultAgentDir()): string {\n\tconst resolvedCwd = resolvePath(cwd);\n\tconst resolvedAgentDir = resolvePath(agentDir);\n\tconst safePath = `--${resolvedCwd.replace(/^[/\\\\]/, \"\").replace(/[/\\\\:]/g, \"-\")}--`;\n\treturn join(resolvedAgentDir, \"sessions\", safePath);\n}\n\nexport function getDefaultSessionDir(cwd: string, agentDir: string = getDefaultAgentDir()): string {\n\tconst sessionDir = getDefaultSessionDirPath(cwd, agentDir);\n\tif (!existsSync(sessionDir)) {\n\t\tmkdirSync(sessionDir, { recursive: true });\n\t}\n\treturn sessionDir;\n}\n\nconst SESSION_READ_BUFFER_SIZE = 1024 1024;\n\nfunction parseSessionEntryLine(line: string): FileEntry \| null {\n\tif (!line.trim()) return null;\n\ttry {\n\t\treturn JSON.parse(line) as FileEntry;\n\t} catch {\n\t\t// Skip malformed lines\n\t\treturn null;\n\t}\n}\n\n/** Exported for testing /\nexport function loadEntriesFromFile(filePath: string): FileEntry[] {\n\tconst resolvedFilePath = normalizePath(filePath);\n\tif (!existsSync(resolvedFilePath)) return [];\n\n\tconst entries: FileEntry[] = [];\n\tconst fd = openSync(resolvedFilePath, \"r\");\n\ttry {\n\t\tconst decoder = new StringDecoder(\"utf8\");\n\t\tconst buffer = Buffer.allocUnsafe(SESSION_READ_BUFFER_SIZE);\n\t\tlet pending = \"\";\n\n\t\twhile (true) {\n\t\t\tconst bytesRead = readSync(fd, buffer, 0, buffer.length, null);\n\t\t\tif (bytesRead === 0) break;\n\n\t\t\tpending += decoder.write(buffer.subarray(0, bytesRead));\n\t\t\tlet lineStart = 0;\n\t\t\tlet newlineIndex = pending.indexOf(\"\\n\", lineStart);\n\t\t\twhile (newlineIndex !== -1) {\n\t\t\t\tconst entry = parseSessionEntryLine(pending.slice(lineStart, newlineIndex));\n\t\t\t\tif (entry) entries.push(entry);\n\t\t\t\tlineStart = newlineIndex + 1;\n\t\t\t\tnewlineIndex = pending.indexOf(\"\\n\", lineStart);\n\t\t\t}\n\t\t\tpending = pending.slice(lineStart);\n\t\t}\n\n\t\tpending += decoder.end();\n\t\tconst finalEntry = parseSessionEntryLine(pending);\n\t\tif (finalEntry) entries.push(finalEntry);\n\t} finally {\n\t\tcloseSync(fd);\n\t}\n\n\t// Validate session header\n\tif (entries.length === 0) return entries;\n\tconst header = entries[0];\n\tif (header.type !== \"session\" \|\| typeof (header as { id?: unknown }).id !== \"string\") {\n\t\treturn [];\n\t}\n\n\treturn entries;\n}\n\n/\n Preserve a corrupt (non-empty, headerless) session file by renaming it to\n * `<file>.corrupt-<timestamp>` so recovery never destroys user data.\n * Returns the backup path, or null if the file was empty (nothing to preserve).\n /\nfunction backupCorruptSessionFile(filePath: string): string \| null {\n\ttry {\n\t\tif (statSync(filePath).size === 0) return null;\n\t} catch {\n\t\treturn null;\n\t}\n\tconst timestamp = new Date().toISOString().replace(/[:.]/g, \"-\");\n\tlet backupPath = `${filePath}.corrupt-${timestamp}`;\n\tlet counter = 0;\n\twhile (existsSync(backupPath)) {\n\t\tcounter++;\n\t\tbackupPath = `${filePath}.corrupt-${timestamp}-${counter}`;\n\t}\n\trenameSync(filePath, backupPath);\n\treturn backupPath;\n}\n\nfunction readSessionHeader(filePath: string): SessionHeader \| null {\n\ttry {\n\t\tconst fd = openSync(filePath, \"r\");\n\t\tconst buffer = Buffer.alloc(512);\n\t\tconst bytesRead = readSync(fd, buffer, 0, 512, 0);\n\t\tcloseSync(fd);\n\t\tconst firstLine = buffer.toString(\"utf8\", 0, bytesRead).split(\"\\n\")[0];\n\t\tif (!firstLine) return null;\n\t\tconst header = JSON.parse(firstLine) as Record<string, unknown>;\n\t\tif (header.type !== \"session\" \|\| typeof header.id !== \"string\") {\n\t\t\treturn null;\n\t\t}\n\t\treturn header as unknown as SessionHeader;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nfunction getSessionHeaderCwd(header: SessionHeader): string \| undefined {\n\tconst cwd = (header as { cwd?: unknown }).cwd;\n\treturn typeof cwd === \"string\" ? cwd : undefined;\n}\n\nfunction sessionCwdMatches(cwd: string \| undefined, resolvedCwd: string): boolean {\n\treturn cwd !== undefined && cwd !== \"\" && resolvePath(cwd) === resolvedCwd;\n}\n\n/* Exported for testing /\nexport function findMostRecentSession(sessionDir: string, cwd?: string): string \| null {\n\tconst resolvedSessionDir = normalizePath(sessionDir);\n\tconst resolvedCwd = cwd ? resolvePath(cwd) : undefined;\n\ttry {\n\t\tconst files = readdirSync(resolvedSessionDir)\n\t\t\t.filter((f) => f.endsWith(\".jsonl\"))\n\t\t\t.map((f) => join(resolvedSessionDir, f))\n\t\t\t.map((path) => ({ path, header: readSessionHeader(path) }))\n\t\t\t.filter(\n\t\t\t\t(file): file is { path: string; header: SessionHeader } =>\n\t\t\t\t\tfile.header !== null &&\n\t\t\t\t\t(!resolvedCwd \|\| sessionCwdMatches(getSessionHeaderCwd(file.header), resolvedCwd)),\n\t\t\t)\n\t\t\t.map(({ path }) => ({ path, mtime: statSync(path).mtime }))\n\t\t\t.sort((a, b) => b.mtime.getTime() - a.mtime.getTime());\n\n\t\treturn files[0]?.path \|\| null;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nfunction isMessageWithContent(message: AgentMessage): message is Message {\n\treturn typeof (message as Message).role === \"string\" && \"content\" in message;\n}\n\nfunction extractTextContent(message: Message): string {\n\tconst content = message.content;\n\tif (typeof content === \"string\") {\n\t\treturn content;\n\t}\n\treturn content\n\t\t.filter((block): block is TextContent => block.type === \"text\")\n\t\t.map((block) => block.text)\n\t\t.join(\" \");\n}\n\nfunction getMessageActivityTime(entry: SessionMessageEntry): number \| undefined {\n\tconst message = entry.message;\n\tif (!isMessageWithContent(message)) return undefined;\n\tif (message.role !== \"user\" && message.role !== \"assistant\") return undefined;\n\n\tconst msgTimestamp = (message as { timestamp?: number }).timestamp;\n\tif (typeof msgTimestamp === \"number\") {\n\t\treturn msgTimestamp;\n\t}\n\n\tconst t = new Date(entry.timestamp).getTime();\n\treturn Number.isNaN(t) ? undefined : t;\n}\n\nasync function buildSessionInfo(filePath: string): Promise<SessionInfo \| null> {\n\ttry {\n\t\tconst stats = await stat(filePath);\n\t\tlet header: SessionHeader \| null = null;\n\t\tlet messageCount = 0;\n\t\tlet firstMessage = \"\";\n\t\tconst allMessages: string[] = [];\n\t\tlet name: string \| undefined;\n\t\tlet lastActivityTime: number \| undefined;\n\n\t\tconst rl = createInterface({\n\t\t\tinput: createReadStream(filePath, { encoding: \"utf8\" }),\n\t\t\tcrlfDelay: Infinity,\n\t\t});\n\n\t\tfor await (const line of rl) {\n\t\t\tconst entry = parseSessionEntryLine(line);\n\t\t\tif (!entry) continue;\n\n\t\t\tif (!header) {\n\t\t\t\tif (entry.type !== \"session\") return null;\n\t\t\t\theader = entry;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Extract session name (use latest, including explicit clears)\n\t\t\tif (entry.type === \"session_info\") {\n\t\t\t\tname = entry.name?.trim() \|\| undefined;\n\t\t\t}\n\n\t\t\tif (entry.type !== \"message\") continue;\n\t\t\tmessageCount++;\n\n\t\t\tconst activityTime = getMessageActivityTime(entry);\n\t\t\tif (typeof activityTime === \"number\") {\n\t\t\t\tlastActivityTime = Math.max(lastActivityTime ?? 0, activityTime);\n\t\t\t}\n\n\t\t\tconst message = entry.message;\n\t\t\tif (!isMessageWithContent(message)) continue;\n\t\t\tif (message.role !== \"user\" && message.role !== \"assistant\") continue;\n\n\t\t\tconst textContent = extractTextContent(message);\n\t\t\tif (!textContent) continue;\n\n\t\t\tallMessages.push(textContent);\n\t\t\tif (!firstMessage && message.role === \"user\") {\n\t\t\t\tfirstMessage = textContent;\n\t\t\t}\n\t\t}\n\n\t\tif (!header) return null;\n\n\t\tconst cwd = typeof header.cwd === \"string\" ? header.cwd : \"\";\n\t\tconst parentSessionPath = header.parentSession;\n\t\tconst headerTime = typeof header.timestamp === \"string\" ? new Date(header.timestamp).getTime() : NaN;\n\t\tconst modified =\n\t\t\ttypeof lastActivityTime === \"number\" && lastActivityTime > 0\n\t\t\t\t? new Date(lastActivityTime)\n\t\t\t\t: !Number.isNaN(headerTime)\n\t\t\t\t\t? new Date(headerTime)\n\t\t\t\t\t: stats.mtime;\n\n\t\treturn {\n\t\t\tpath: filePath,\n\t\t\tid: header.id,\n\t\t\tcwd,\n\t\t\tname,\n\t\t\tparentSessionPath,\n\t\t\tcreated: new Date(header.timestamp),\n\t\t\tmodified,\n\t\t\tmessageCount,\n\t\t\tfirstMessage: firstMessage \|\| \"(no messages)\",\n\t\t\tallMessagesText: allMessages.join(\" \"),\n\t\t};\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nexport type SessionListProgress = (loaded: number, total: number) => void;\n\nconst MAX_CONCURRENT_SESSION_INFO_LOADS = 10;\n\nasync function buildSessionInfosWithConcurrency(\n\tfiles: string[],\n\tonLoaded: () => void,\n): Promise<(SessionInfo \| null)[]> {\n\tconst results: (SessionInfo \| null)[] = new Array(files.length).fill(null);\n\tconst inFlight = new Set<Promise<void>>();\n\tlet nextIndex = 0;\n\n\tconst startNext = (): void => {\n\t\tconst index = nextIndex++;\n\t\tconst file = files[index];\n\t\tif (!file) return;\n\n\t\tlet task: Promise<void>;\n\t\ttask = buildSessionInfo(file)\n\t\t\t.then((info) => {\n\t\t\t\tresults[index] = info;\n\t\t\t})\n\t\t\t.catch(() => {\n\t\t\t\tresults[index] = null;\n\t\t\t})\n\t\t\t.finally(() => {\n\t\t\t\tinFlight.delete(task);\n\t\t\t\tonLoaded();\n\t\t\t});\n\t\tinFlight.add(task);\n\t};\n\n\twhile (nextIndex < files.length \|\| inFlight.size > 0) {\n\t\twhile (nextIndex < files.length && inFlight.size < MAX_CONCURRENT_SESSION_INFO_LOADS) {\n\t\t\tstartNext();\n\t\t}\n\t\tif (inFlight.size > 0) {\n\t\t\tawait Promise.race(inFlight);\n\t\t}\n\t}\n\n\treturn results;\n}\n\nasync function listSessionsFromDir(\n\tdir: string,\n\tonProgress?: SessionListProgress,\n\tprogressOffset = 0,\n\tprogressTotal?: number,\n): Promise<SessionInfo[]> {\n\tconst sessions: SessionInfo[] = [];\n\tif (!existsSync(dir)) {\n\t\treturn sessions;\n\t}\n\n\ttry {\n\t\tconst dirEntries = await readdir(dir);\n\t\tconst files = dirEntries.filter((f) => f.endsWith(\".jsonl\")).map((f) => join(dir, f));\n\t\tconst total = progressTotal ?? files.length;\n\n\t\tlet loaded = 0;\n\t\tconst results = await buildSessionInfosWithConcurrency(files, () => {\n\t\t\tloaded++;\n\t\t\tonProgress?.(progressOffset + loaded, total);\n\t\t});\n\t\tfor (const info of results) {\n\t\t\tif (info) {\n\t\t\t\tsessions.push(info);\n\t\t\t}\n\t\t}\n\t} catch {\n\t\t// Return empty list on error\n\t}\n\n\treturn sessions;\n}\n\n/\n Manages conversation sessions as append-only trees stored in JSONL files.\n \n Each session entry has an id and parentId forming a tree structure. The \"leaf\"\n * pointer tracks the current position. Appending creates a child of the current leaf.\n * Branching moves the leaf to an earlier entry, allowing new branches without\n * modifying history.\n \n Use buildSessionContext() to get the resolved message list for the LLM, which\n * handles compaction summaries and follows the path from root to current leaf.\n /\nexport class SessionManager {\n\tprivate sessionId: string = \"\";\n\tprivate sessionFile: string \| undefined;\n\tprivate sessionDir: string;\n\tprivate cwd: string;\n\tprivate persist: boolean;\n\tprivate flushed: boolean = false;\n\tprivate fileEntries: FileEntry[] = [];\n\tprivate byId: Map<string, SessionEntry> = new Map();\n\tprivate labelsById: Map<string, string> = new Map();\n\tprivate labelTimestampsById: Map<string, string> = new Map();\n\tprivate leafId: string \| null = null;\n\n\tprivate constructor(\n\t\tcwd: string,\n\t\tsessionDir: string,\n\t\tsessionFile: string \| undefined,\n\t\tpersist: boolean,\n\t\tnewSessionOptions?: NewSessionOptions,\n\t) {\n\t\tthis.cwd = resolvePath(cwd);\n\t\tthis.sessionDir = normalizePath(sessionDir);\n\t\tthis.persist = persist;\n\t\tif (persist && this.sessionDir && !existsSync(this.sessionDir)) {\n\t\t\tmkdirSync(this.sessionDir, { recursive: true });\n\t\t}\n\n\t\tif (sessionFile) {\n\t\t\tthis.setSessionFile(sessionFile);\n\t\t} else {\n\t\t\tthis.newSession(newSessionOptions);\n\t\t}\n\t}\n\n\t/* Switch to a different session file (used for resume and branching) /\n\tsetSessionFile(sessionFile: string): void {\n\t\tthis.sessionFile = resolvePath(sessionFile);\n\t\tif (existsSync(this.sessionFile)) {\n\t\t\tthis.fileEntries = loadEntriesFromFile(this.sessionFile);\n\n\t\t\t// If file was empty or corrupted (no valid header), start fresh to avoid\n\t\t\t// appending messages without a session header (which breaks the session).\n\t\t\t// Never destroy existing data: if the file has content, preserve the\n\t\t\t// original as a .corrupt- backup before rewriting.\n\t\t\tif (this.fileEntries.length === 0) {\n\t\t\t\tconst explicitPath = this.sessionFile;\n\t\t\t\tif (this.persist) {\n\t\t\t\t\tbackupCorruptSessionFile(explicitPath);\n\t\t\t\t}\n\t\t\t\tthis.newSession();\n\t\t\t\tthis.sessionFile = explicitPath;\n\t\t\t\tthis._rewriteFile();\n\t\t\t\tthis.flushed = true;\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst header = this.fileEntries.find((e) => e.type === \"session\") as SessionHeader \| undefined;\n\t\t\tthis.sessionId = header?.id ?? createSessionId();\n\n\t\t\tif (migrateToCurrentVersion(this.fileEntries)) {\n\t\t\t\tthis._rewriteFile();\n\t\t\t}\n\n\t\t\tthis._buildIndex();\n\t\t\tthis.flushed = true;\n\t\t} else {\n\t\t\tconst explicitPath = this.sessionFile;\n\t\t\tthis.newSession();\n\t\t\tthis.sessionFile = explicitPath; // preserve explicit path from --session flag\n\t\t}\n\t}\n\n\tnewSession(options?: NewSessionOptions): string \| undefined {\n\t\tif (options?.id !== undefined) {\n\t\t\tassertValidSessionId(options.id);\n\t\t}\n\t\tthis.sessionId = options?.id ?? createSessionId();\n\t\tconst timestamp = new Date().toISOString();\n\t\tconst header: SessionHeader = {\n\t\t\ttype: \"session\",\n\t\t\tversion: CURRENT_SESSION_VERSION,\n\t\t\tid: this.sessionId,\n\t\t\ttimestamp,\n\t\t\tcwd: this.cwd,\n\t\t\tparentSession: options?.parentSession,\n\t\t};\n\t\tthis.fileEntries = [header];\n\t\tthis.byId.clear();\n\t\tthis.labelsById.clear();\n\t\tthis.leafId = null;\n\t\tthis.flushed = false;\n\n\t\tif (this.persist) {\n\t\t\tconst fileTimestamp = timestamp.replace(/[:.]/g, \"-\");\n\t\t\tthis.sessionFile = join(this.getSessionDir(), `${fileTimestamp}_${this.sessionId}.jsonl`);\n\t\t}\n\t\treturn this.sessionFile;\n\t}\n\n\tprivate _buildIndex(): void {\n\t\tthis.byId.clear();\n\t\tthis.labelsById.clear();\n\t\tthis.labelTimestampsById.clear();\n\t\tthis.leafId = null;\n\t\tfor (const entry of this.fileEntries) {\n\t\t\tif (entry.type === \"session\") continue;\n\t\t\tthis.byId.set(entry.id, entry);\n\t\t\tthis.leafId = entry.id;\n\t\t\tif (entry.type === \"label\") {\n\t\t\t\tif (entry.label) {\n\t\t\t\t\tthis.labelsById.set(entry.targetId, entry.label);\n\t\t\t\t\tthis.labelTimestampsById.set(entry.targetId, entry.timestamp);\n\t\t\t\t} else {\n\t\t\t\t\tthis.labelsById.delete(entry.targetId);\n\t\t\t\t\tthis.labelTimestampsById.delete(entry.targetId);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate _rewriteFile(): void {\n\t\tif (!this.persist \|\| !this.sessionFile) return;\n\t\tconst fd = openSync(this.sessionFile, \"w\");\n\t\ttry {\n\t\t\tfor (const entry of this.fileEntries) {\n\t\t\t\twriteFileSync(fd, `${JSON.stringify(entry)}\\n`);\n\t\t\t}\n\t\t} finally {\n\t\t\tcloseSync(fd);\n\t\t}\n\t}\n\n\tisPersisted(): boolean {\n\t\treturn this.persist;\n\t}\n\n\tgetCwd(): string {\n\t\treturn this.cwd;\n\t}\n\n\tgetSessionDir(): string {\n\t\treturn this.sessionDir;\n\t}\n\n\tusesDefaultSessionDir(): boolean {\n\t\treturn this.sessionDir === getDefaultSessionDirPath(this.cwd);\n\t}\n\n\tgetSessionId(): string {\n\t\treturn this.sessionId;\n\t}\n\n\tgetSessionFile(): string \| undefined {\n\t\treturn this.sessionFile;\n\t}\n\n\t_persist(entry: SessionEntry): void {\n\t\tif (!this.persist \|\| !this.sessionFile) return;\n\n\t\tconst hasAssistant = this.fileEntries.some((e) => e.type === \"message\" && e.message.role === \"assistant\");\n\t\tif (!hasAssistant) {\n\t\t\tif (this.flushed) {\n\t\t\t\tappendFileSync(this.sessionFile, `${JSON.stringify(entry)}\\n`);\n\t\t\t} else {\n\t\t\t\t// Mark as not flushed so when assistant arrives, all entries get written\n\t\t\t\tthis.flushed = false;\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\tif (!this.flushed) {\n\t\t\tconst fd = openSync(this.sessionFile, \"wx\");\n\t\t\ttry {\n\t\t\t\tfor (const e of this.fileEntries) {\n\t\t\t\t\twriteFileSync(fd, `${JSON.stringify(e)}\\n`);\n\t\t\t\t}\n\t\t\t} finally {\n\t\t\t\tcloseSync(fd);\n\t\t\t}\n\t\t\tthis.flushed = true;\n\t\t} else {\n\t\t\tappendFileSync(this.sessionFile, `${JSON.stringify(entry)}\\n`);\n\t\t}\n\t}\n\n\tprivate _appendEntry(entry: SessionEntry): void {\n\t\tthis.fileEntries.push(entry);\n\t\tthis.byId.set(entry.id, entry);\n\t\tthis.leafId = entry.id;\n\t\tthis._persist(entry);\n\t}\n\n\t/** Append a message as child of current leaf, then advance leaf. Returns entry id.\n\t * Does not allow writing CompactionSummaryMessage and BranchSummaryMessage directly.\n\t * Reason: we want these to be top-level entries in the session, not message session entries,\n\t * so it is easier to find them.\n\t * These need to be appended via appendCompaction() and appendBranchSummary() methods.\n\t /\n\tappendMessage(message: Message \| CustomMessage \| BashExecutionMessage): string {\n\t\tconst entry: SessionMessageEntry = {\n\t\t\ttype: \"message\",\n\t\t\tid: generateId(this.byId),\n\t\t\tparentId: this.leafId,\n\t\t\ttimestamp: new Date().toISOString(),\n\t\t\tmessage,\n\t\t};\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\t/* Append a thinking level change as child of current leaf, then advance leaf. Returns entry id. /\n\tappendThinkingLevelChange(thinkingLevel: string): string {\n\t\tconst entry: ThinkingLevelChangeEntry = {\n\t\t\ttype: \"thinking_level_change\",\n\t\t\tid: generateId(this.byId),\n\t\t\tparentId: this.leafId,\n\t\t\ttimestamp: new Date().toISOString(),\n\t\t\tthinkingLevel,\n\t\t};\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\t/* Append a model change as child of current leaf, then advance leaf. Returns entry id. /\n\tappendModelChange(provider: string, modelId: string): string {\n\t\tconst entry: ModelChangeEntry = {\n\t\t\ttype: \"model_change\",\n\t\t\tid: generateId(this.byId),\n\t\t\tparentId: this.leafId,\n\t\t\ttimestamp: new Date().toISOString(),\n\t\t\tprovider,\n\t\t\tmodelId,\n\t\t};\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\t/* Append a compaction summary as child of current leaf, then advance leaf. Returns entry id. /\n\tappendCompaction<T = unknown>(\n\t\tsummary: string,\n\t\tfirstKeptEntryId: string,\n\t\ttokensBefore: number,\n\t\tdetails?: T,\n\t\tfromHook?: boolean,\n\t): string {\n\t\tconst entry: CompactionEntry<T> = {\n\t\t\ttype: \"compaction\",\n\t\t\tid: generateId(this.byId),\n\t\t\tparentId: this.leafId,\n\t\t\ttimestamp: new Date().toISOString(),\n\t\t\tsummary,\n\t\t\tfirstKeptEntryId,\n\t\t\ttokensBefore,\n\t\t\tdetails,\n\t\t\tfromHook,\n\t\t};\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\t/* Append a custom entry (for extensions) as child of current leaf, then advance leaf. Returns entry id. /\n\tappendCustomEntry(customType: string, data?: unknown): string {\n\t\tconst entry: CustomEntry = {\n\t\t\ttype: \"custom\",\n\t\t\tcustomType,\n\t\t\tdata,\n\t\t\tid: generateId(this.byId),\n\t\t\tparentId: this.leafId,\n\t\t\ttimestamp: new Date().toISOString(),\n\t\t};\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\t/* Append a session info entry (e.g., display name). Returns entry id. /\n\tappendSessionInfo(name: string): string {\n\t\tconst entry: SessionInfoEntry = {\n\t\t\ttype: \"session_info\",\n\t\t\tid: generateId(this.byId),\n\t\t\tparentId: this.leafId,\n\t\t\ttimestamp: new Date().toISOString(),\n\t\t\tname: name.trim(),\n\t\t};\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\t/* Get the current session name from the latest session_info entry, if any. /\n\tgetSessionName(): string \| undefined {\n\t\t// Walk entries in reverse to find the latest session_info entry.\n\t\t// Empty names explicitly clear the session title.\n\t\tconst entries = this.getEntries();\n\t\tfor (let i = entries.length - 1; i >= 0; i--) {\n\t\t\tconst entry = entries[i];\n\t\t\tif (entry.type === \"session_info\") {\n\t\t\t\treturn entry.name?.trim() \|\| undefined;\n\t\t\t}\n\t\t}\n\t\treturn undefined;\n\t}\n\n\t/\n\t Append a custom message entry (for extensions) that participates in LLM context.\n\t * @param customType Extension identifier for filtering on reload\n\t * @param content Message content (string or TextContent/ImageContent array)\n\t * @param display Whether to show in TUI (true = styled display, false = hidden)\n\t * @param details Optional extension-specific metadata (not sent to LLM)\n\t * @returns Entry id\n\t /\n\tappendCustomMessageEntry<T = unknown>(\n\t\tcustomType: string,\n\t\tcontent: string \| (TextContent \| ImageContent)[],\n\t\tdisplay: boolean,\n\t\tdetails?: T,\n\t): string {\n\t\tconst entry: CustomMessageEntry<T> = {\n\t\t\ttype: \"custom_message\",\n\t\t\tcustomType,\n\t\t\tcontent,\n\t\t\tdisplay,\n\t\t\tdetails,\n\t\t\tid: generateId(this.byId),\n\t\t\tparentId: this.leafId,\n\t\t\ttimestamp: new Date().toISOString(),\n\t\t};\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\t// =========================================================================\n\t// Tree Traversal\n\t// =========================================================================\n\n\tgetLeafId(): string \| null {\n\t\treturn this.leafId;\n\t}\n\n\tgetLeafEntry(): SessionEntry \| undefined {\n\t\treturn this.leafId ? this.byId.get(this.leafId) : undefined;\n\t}\n\n\tgetEntry(id: string): SessionEntry \| undefined {\n\t\treturn this.byId.get(id);\n\t}\n\n\t/\n\t Get all direct children of an entry.\n\t /\n\tgetChildren(parentId: string): SessionEntry[] {\n\t\tconst children: SessionEntry[] = [];\n\t\tfor (const entry of this.byId.values()) {\n\t\t\tif (entry.parentId === parentId) {\n\t\t\t\tchildren.push(entry);\n\t\t\t}\n\t\t}\n\t\treturn children;\n\t}\n\n\t/\n\t Get the label for an entry, if any.\n\t /\n\tgetLabel(id: string): string \| undefined {\n\t\treturn this.labelsById.get(id);\n\t}\n\n\t/\n\t Set or clear a label on an entry.\n\t * Labels are user-defined markers for bookmarking/navigation.\n\t * Pass undefined or empty string to clear the label.\n\t /\n\tappendLabelChange(targetId: string, label: string \| undefined): string {\n\t\tif (!this.byId.has(targetId)) {\n\t\t\tthrow new Error(`Entry ${targetId} not found`);\n\t\t}\n\t\tconst entry: LabelEntry = {\n\t\t\ttype: \"label\",\n\t\t\tid: generateId(this.byId),\n\t\t\tparentId: this.leafId,\n\t\t\ttimestamp: new Date().toISOString(),\n\t\t\ttargetId,\n\t\t\tlabel,\n\t\t};\n\t\tthis._appendEntry(entry);\n\t\tif (label) {\n\t\t\tthis.labelsById.set(targetId, label);\n\t\t\tthis.labelTimestampsById.set(targetId, entry.timestamp);\n\t\t} else {\n\t\t\tthis.labelsById.delete(targetId);\n\t\t\tthis.labelTimestampsById.delete(targetId);\n\t\t}\n\t\treturn entry.id;\n\t}\n\n\t/\n\t Walk from entry to root, returning all entries in path order.\n\t * Includes all entry types (messages, compaction, model changes, etc.).\n\t * Use buildSessionContext() to get the resolved messages for the LLM.\n\t /\n\tgetBranch(fromId?: string): SessionEntry[] {\n\t\tconst path: SessionEntry[] = [];\n\t\tconst startId = fromId ?? this.leafId;\n\t\tlet current = startId ? this.byId.get(startId) : undefined;\n\t\twhile (current) {\n\t\t\tpath.unshift(current);\n\t\t\tcurrent = current.parentId ? this.byId.get(current.parentId) : undefined;\n\t\t}\n\t\treturn path;\n\t}\n\n\t/\n\t Build the session context (what gets sent to the LLM).\n\t * Uses tree traversal from current leaf.\n\t /\n\tbuildSessionContext(): SessionContext {\n\t\treturn buildSessionContext(this.getEntries(), this.leafId, this.byId);\n\t}\n\n\t/\n\t Get session header.\n\t /\n\tgetHeader(): SessionHeader \| null {\n\t\tconst h = this.fileEntries.find((e) => e.type === \"session\");\n\t\treturn h ? (h as SessionHeader) : null;\n\t}\n\n\t/\n\t Get all session entries (excludes header). Returns a shallow copy.\n\t * The session is append-only: use appendXXX() to add entries, branch() to\n\t * change the leaf pointer. Entries cannot be modified or deleted.\n\t /\n\tgetEntries(): SessionEntry[] {\n\t\treturn this.fileEntries.filter((e): e is SessionEntry => e.type !== \"session\");\n\t}\n\n\t/\n\t Get the session as a tree structure. Returns a shallow defensive copy of all entries.\n\t * A well-formed session has exactly one root (first entry with parentId === null).\n\t * Orphaned entries (broken parent chain) are also returned as roots.\n\t /\n\tgetTree(): SessionTreeNode[] {\n\t\tconst entries = this.getEntries();\n\t\tconst nodeMap = new Map<string, SessionTreeNode>();\n\t\tconst roots: SessionTreeNode[] = [];\n\n\t\t// Create nodes with resolved labels\n\t\tfor (const entry of entries) {\n\t\t\tconst label = this.labelsById.get(entry.id);\n\t\t\tconst labelTimestamp = this.labelTimestampsById.get(entry.id);\n\t\t\tnodeMap.set(entry.id, { entry, children: [], label, labelTimestamp });\n\t\t}\n\n\t\t// Build tree\n\t\tfor (const entry of entries) {\n\t\t\tconst node = nodeMap.get(entry.id)!;\n\t\t\tif (entry.parentId === null \|\| entry.parentId === entry.id) {\n\t\t\t\troots.push(node);\n\t\t\t} else {\n\t\t\t\tconst parent = nodeMap.get(entry.parentId);\n\t\t\t\tif (parent) {\n\t\t\t\t\tparent.children.push(node);\n\t\t\t\t} else {\n\t\t\t\t\t// Orphan - treat as root\n\t\t\t\t\troots.push(node);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Sort children by timestamp (oldest first, newest at bottom)\n\t\t// Use iterative approach to avoid stack overflow on deep trees\n\t\tconst stack: SessionTreeNode[] = [...roots];\n\t\twhile (stack.length > 0) {\n\t\t\tconst node = stack.pop()!;\n\t\t\tnode.children.sort((a, b) => new Date(a.entry.timestamp).getTime() - new Date(b.entry.timestamp).getTime());\n\t\t\tstack.push(...node.children);\n\t\t}\n\n\t\treturn roots;\n\t}\n\n\t// =========================================================================\n\t// Branching\n\t// =========================================================================\n\n\t/\n\t Start a new branch from an earlier entry.\n\t * Moves the leaf pointer to the specified entry. The next appendXXX() call\n\t * will create a child of that entry, forming a new branch. Existing entries\n\t * are not modified or deleted.\n\t /\n\tbranch(branchFromId: string): void {\n\t\tif (!this.byId.has(branchFromId)) {\n\t\t\tthrow new Error(`Entry ${branchFromId} not found`);\n\t\t}\n\t\tthis.leafId = branchFromId;\n\t}\n\n\t/\n\t Reset the leaf pointer to null (before any entries).\n\t * The next appendXXX() call will create a new root entry (parentId = null).\n\t * Use this when navigating to re-edit the first user message.\n\t /\n\tresetLeaf(): void {\n\t\tthis.leafId = null;\n\t}\n\n\t/\n\t Start a new branch with a summary of the abandoned path.\n\t * Same as branch(), but also appends a branch_summary entry that captures\n\t * context from the abandoned conversation path.\n\t /\n\tbranchWithSummary(branchFromId: string \| null, summary: string, details?: unknown, fromHook?: boolean): string {\n\t\tif (branchFromId !== null && !this.byId.has(branchFromId)) {\n\t\t\tthrow new Error(`Entry ${branchFromId} not found`);\n\t\t}\n\t\tthis.leafId = branchFromId;\n\t\tconst entry: BranchSummaryEntry = {\n\t\t\ttype: \"branch_summary\",\n\t\t\tid: generateId(this.byId),\n\t\t\tparentId: branchFromId,\n\t\t\ttimestamp: new Date().toISOString(),\n\t\t\tfromId: branchFromId ?? \"root\",\n\t\t\tsummary,\n\t\t\tdetails,\n\t\t\tfromHook,\n\t\t};\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\t/\n\t Create a new session file containing only the path from root to the specified leaf.\n\t * Useful for extracting a single conversation path from a branched session.\n\t * Returns the new session file path, or undefined if not persisting.\n\t /\n\tcreateBranchedSession(leafId: string): string \| undefined {\n\t\tconst previousSessionFile = this.sessionFile;\n\t\tconst path = this.getBranch(leafId);\n\t\tif (path.length === 0) {\n\t\t\tthrow new Error(`Entry ${leafId} not found`);\n\t\t}\n\n\t\t// Filter out LabelEntry from path - we'll recreate them from the resolved map\n\t\tconst pathWithoutLabels = path.filter((e) => e.type !== \"label\");\n\n\t\tconst newSessionId = createSessionId();\n\t\tconst timestamp = new Date().toISOString();\n\t\tconst fileTimestamp = timestamp.replace(/[:.]/g, \"-\");\n\t\tconst newSessionFile = join(this.getSessionDir(), `${fileTimestamp}_${newSessionId}.jsonl`);\n\n\t\tconst header: SessionHeader = {\n\t\t\ttype: \"session\",\n\t\t\tversion: CURRENT_SESSION_VERSION,\n\t\t\tid: newSessionId,\n\t\t\ttimestamp,\n\t\t\tcwd: this.cwd,\n\t\t\tparentSession: this.persist ? previousSessionFile : undefined,\n\t\t};\n\n\t\t// Collect labels for entries in the path\n\t\tconst pathEntryIds = new Set(pathWithoutLabels.map((e) => e.id));\n\t\tconst labelsToWrite: Array<{ targetId: string; label: string; timestamp: string }> = [];\n\t\tfor (const [targetId, label] of this.labelsById) {\n\t\t\tif (pathEntryIds.has(targetId)) {\n\t\t\t\tlabelsToWrite.push({ targetId, label, timestamp: this.labelTimestampsById.get(targetId)! });\n\t\t\t}\n\t\t}\n\n\t\tif (this.persist) {\n\t\t\t// Build label entries\n\t\t\tconst lastEntryId = pathWithoutLabels[pathWithoutLabels.length - 1]?.id \|\| null;\n\t\t\tlet parentId = lastEntryId;\n\t\t\tconst labelEntries: LabelEntry[] = [];\n\t\t\tfor (const { targetId, label, timestamp: labelTimestamp } of labelsToWrite) {\n\t\t\t\tconst labelEntry: LabelEntry = {\n\t\t\t\t\ttype: \"label\",\n\t\t\t\t\tid: generateId(new Set(pathEntryIds)),\n\t\t\t\t\tparentId,\n\t\t\t\t\ttimestamp: labelTimestamp,\n\t\t\t\t\ttargetId,\n\t\t\t\t\tlabel,\n\t\t\t\t};\n\t\t\t\tpathEntryIds.add(labelEntry.id);\n\t\t\t\tlabelEntries.push(labelEntry);\n\t\t\t\tparentId = labelEntry.id;\n\t\t\t}\n\n\t\t\tthis.fileEntries = [header, ...pathWithoutLabels, ...labelEntries];\n\t\t\tthis.sessionId = newSessionId;\n\t\t\tthis.sessionFile = newSessionFile;\n\t\t\tthis._buildIndex();\n\n\t\t\t// Only write the file now if it contains an assistant message.\n\t\t\t// Otherwise defer to _persist(), which creates the file on the\n\t\t\t// first assistant response, matching the newSession() contract\n\t\t\t// and avoiding the duplicate-header bug when _persist()'s\n\t\t\t// no-assistant guard later resets flushed to false.\n\t\t\tconst hasAssistant = this.fileEntries.some((e) => e.type === \"message\" && e.message.role === \"assistant\");\n\t\t\tif (hasAssistant) {\n\t\t\t\tthis._rewriteFile();\n\t\t\t\tthis.flushed = true;\n\t\t\t} else {\n\t\t\t\tthis.flushed = false;\n\t\t\t}\n\n\t\t\treturn newSessionFile;\n\t\t}\n\n\t\t// In-memory mode: replace current session with the path + labels\n\t\tconst labelEntries: LabelEntry[] = [];\n\t\tlet parentId = pathWithoutLabels[pathWithoutLabels.length - 1]?.id \|\| null;\n\t\tfor (const { targetId, label, timestamp: labelTimestamp } of labelsToWrite) {\n\t\t\tconst labelEntry: LabelEntry = {\n\t\t\t\ttype: \"label\",\n\t\t\t\tid: generateId(new Set([...pathEntryIds, ...labelEntries.map((e) => e.id)])),\n\t\t\t\tparentId,\n\t\t\t\ttimestamp: labelTimestamp,\n\t\t\t\ttargetId,\n\t\t\t\tlabel,\n\t\t\t};\n\t\t\tlabelEntries.push(labelEntry);\n\t\t\tparentId = labelEntry.id;\n\t\t}\n\t\tthis.fileEntries = [header, ...pathWithoutLabels, ...labelEntries];\n\t\tthis.sessionId = newSessionId;\n\t\tthis._buildIndex();\n\t\treturn undefined;\n\t}\n\n\t/\n\t Create a new session.\n\t * @param cwd Working directory (stored in session header)\n\t * @param sessionDir Optional session directory. If omitted, uses default (~/.omk/agent/sessions/<encoded-cwd>/).\n\t /\n\tstatic create(cwd: string, sessionDir?: string, options?: NewSessionOptions): SessionManager {\n\t\tconst dir = sessionDir ? normalizePath(sessionDir) : getDefaultSessionDir(cwd);\n\t\treturn new SessionManager(cwd, dir, undefined, true, options);\n\t}\n\n\t/\n\t Open a specific session file.\n\t * @param path Path to session file\n\t * @param sessionDir Optional session directory for /new or /branch. If omitted, derives from file's parent.\n\t * @param cwdOverride Optional cwd override instead of the session header cwd.\n\t /\n\tstatic open(path: string, sessionDir?: string, cwdOverride?: string): SessionManager {\n\t\tconst resolvedPath = resolvePath(path);\n\t\t// Extract cwd from session header if possible, otherwise use process.cwd()\n\t\tconst entries = loadEntriesFromFile(resolvedPath);\n\t\tconst header = entries.find((e) => e.type === \"session\") as SessionHeader \| undefined;\n\t\tconst cwd = cwdOverride ?? header?.cwd ?? process.cwd();\n\t\t// If no sessionDir provided, derive from file's parent directory\n\t\tconst dir = sessionDir ? normalizePath(sessionDir) : resolve(resolvedPath, \"..\");\n\t\treturn new SessionManager(cwd, dir, resolvedPath, true);\n\t}\n\n\t/\n\t Continue the most recent session, or create new if none.\n\t * @param cwd Working directory\n\t * @param sessionDir Optional session directory. If omitted, uses default (~/.omk/agent/sessions/<encoded-cwd>/).\n\t /\n\tstatic continueRecent(cwd: string, sessionDir?: string): SessionManager {\n\t\tconst dir = sessionDir ? normalizePath(sessionDir) : getDefaultSessionDir(cwd);\n\t\tconst filterCwd = sessionDir !== undefined && dir !== getDefaultSessionDirPath(cwd);\n\t\tconst mostRecent = findMostRecentSession(dir, filterCwd ? cwd : undefined);\n\t\tif (mostRecent) {\n\t\t\treturn new SessionManager(cwd, dir, mostRecent, true);\n\t\t}\n\t\treturn new SessionManager(cwd, dir, undefined, true);\n\t}\n\n\t/* Create an in-memory session (no file persistence) /\n\tstatic inMemory(cwd: string = process.cwd()): SessionManager {\n\t\treturn new SessionManager(cwd, \"\", undefined, false);\n\t}\n\n\t/\n\t Fork a session from another project directory into the current project.\n\t * Creates a new session in the target cwd with the full history from the source session.\n\t * @param sourcePath Path to the source session file\n\t * @param targetCwd Target working directory (where the new session will be stored)\n\t * @param sessionDir Optional session directory. If omitted, uses default for targetCwd.\n\t /\n\tstatic forkFrom(\n\t\tsourcePath: string,\n\t\ttargetCwd: string,\n\t\tsessionDir?: string,\n\t\toptions?: NewSessionOptions,\n\t): SessionManager {\n\t\tconst resolvedSourcePath = resolvePath(sourcePath);\n\t\tconst resolvedTargetCwd = resolvePath(targetCwd);\n\t\tconst sourceEntries = loadEntriesFromFile(resolvedSourcePath);\n\t\tif (sourceEntries.length === 0) {\n\t\t\tthrow new Error(`Cannot fork: source session file is empty or invalid: ${resolvedSourcePath}`);\n\t\t}\n\n\t\tconst sourceHeader = sourceEntries.find((e) => e.type === \"session\") as SessionHeader \| undefined;\n\t\tif (!sourceHeader) {\n\t\t\tthrow new Error(`Cannot fork: source session has no header: ${resolvedSourcePath}`);\n\t\t}\n\n\t\tconst dir = sessionDir ? normalizePath(sessionDir) : getDefaultSessionDir(resolvedTargetCwd);\n\t\tif (!existsSync(dir)) {\n\t\t\tmkdirSync(dir, { recursive: true });\n\t\t}\n\n\t\t// Create new session file with new ID but forked content\n\t\tif (options?.id !== undefined) {\n\t\t\tassertValidSessionId(options.id);\n\t\t}\n\t\tconst newSessionId = options?.id ?? createSessionId();\n\t\tconst timestamp = new Date().toISOString();\n\t\tconst fileTimestamp = timestamp.replace(/[:.]/g, \"-\");\n\t\tconst newSessionFile = join(dir, `${fileTimestamp}_${newSessionId}.jsonl`);\n\n\t\t// Write new header pointing to source as parent, with updated cwd\n\t\tconst newHeader: SessionHeader = {\n\t\t\ttype: \"session\",\n\t\t\tversion: CURRENT_SESSION_VERSION,\n\t\t\tid: newSessionId,\n\t\t\ttimestamp,\n\t\t\tcwd: resolvedTargetCwd,\n\t\t\tparentSession: resolvedSourcePath,\n\t\t};\n\t\twriteFileSync(newSessionFile, `${JSON.stringify(newHeader)}\\n`, { flag: \"wx\" });\n\n\t\t// Copy all non-header entries from source\n\t\tfor (const entry of sourceEntries) {\n\t\t\tif (entry.type !== \"session\") {\n\t\t\t\tappendFileSync(newSessionFile, `${JSON.stringify(entry)}\\n`);\n\t\t\t}\n\t\t}\n\n\t\treturn new SessionManager(resolvedTargetCwd, dir, newSessionFile, true);\n\t}\n\n\t/\n\t List all sessions for a directory.\n\t * @param cwd Working directory (used to compute default session directory)\n\t * @param sessionDir Optional session directory. If omitted, uses default (~/.omk/agent/sessions/<encoded-cwd>/).\n\t * @param onProgress Optional callback for progress updates (loaded, total)\n\t /\n\tstatic async list(cwd: string, sessionDir?: string, onProgress?: SessionListProgress): Promise<SessionInfo[]> {\n\t\tconst dir = sessionDir ? normalizePath(sessionDir) : getDefaultSessionDir(cwd);\n\t\tconst filterCwd = sessionDir !== undefined && dir !== getDefaultSessionDirPath(cwd);\n\t\tconst resolvedCwd = resolvePath(cwd);\n\t\tconst sessions = (await listSessionsFromDir(dir, onProgress)).filter(\n\t\t\t(session) => !filterCwd \|\| sessionCwdMatches(session.cwd, resolvedCwd),\n\t\t);\n\t\tsessions.sort((a, b) => b.modified.getTime() - a.modified.getTime());\n\t\treturn sessions;\n\t}\n\n\t/\n\t List all sessions across all project directories.\n\t * @param onProgress Optional callback for progress updates (loaded, total)\n\t */\n\tstatic async listAll(onProgress?: SessionListProgress): Promise<SessionInfo[]>;\n\tstatic async listAll(sessionDir?: string, onProgress?: SessionListProgress): Promise<SessionInfo[]>;\n\tstatic async listAll(\n\t\tsessionDirOrOnProgress?: string \| SessionListProgress,\n\t\tonProgress?: SessionListProgress,\n\t): Promise<SessionInfo[]> {\n\t\tconst customSessionDir =\n\t\t\ttypeof sessionDirOrOnProgress === \"string\" ? normalizePath(sessionDirOrOnProgress) : undefined;\n\t\tconst progress = typeof sessionDirOrOnProgress === \"function\" ? sessionDirOrOnProgress : onProgress;\n\t\tif (customSessionDir) {\n\t\t\tconst sessions = await listSessionsFromDir(customSessionDir, progress);\n\t\t\tsessions.sort((a, b) => b.modified.getTime() - a.modified.getTime());\n\t\t\treturn sessions;\n\t\t}\n\n\t\tconst sessionsDir = getSessionsDir();\n\n\t\ttry {\n\t\t\tif (!existsSync(sessionsDir)) {\n\t\t\t\treturn [];\n\t\t\t}\n\t\t\tconst entries = await readdir(sessionsDir, { withFileTypes: true });\n\t\t\tconst dirs = entries.filter((e) => e.isDirectory()).map((e) => join(sessionsDir, e.name));\n\n\t\t\t// Count total files first for accurate progress\n\t\t\tlet totalFiles = 0;\n\t\t\tconst dirFiles: string[][] = [];\n\t\t\tfor (const dir of dirs) {\n\t\t\t\ttry {\n\t\t\t\t\tconst files = (await readdir(dir)).filter((f) => f.endsWith(\".jsonl\"));\n\t\t\t\t\tdirFiles.push(files.map((f) => join(dir, f)));\n\t\t\t\t\ttotalFiles += files.length;\n\t\t\t\t} catch {\n\t\t\t\t\tdirFiles.push([]);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Process all files with progress tracking\n\t\t\tlet loaded = 0;\n\t\t\tconst sessions: SessionInfo[] = [];\n\t\t\tconst allFiles = dirFiles.flat();\n\n\t\t\tconst results = await buildSessionInfosWithConcurrency(allFiles, () => {\n\t\t\t\tloaded++;\n\t\t\t\tprogress?.(loaded, totalFiles);\n\t\t\t});\n\n\t\t\tfor (const info of results) {\n\t\t\t\tif (info) {\n\t\t\t\t\tsessions.push(info);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tsessions.sort((a, b) => b.modified.getTime() - a.modified.getTime());\n\t\t\treturn sessions;\n\t\t} catch {\n\t\t\treturn [];\n\t\t}\n\t}\n}\n"]}

package/dist/core/session-manager.js CHANGED Viewed

@@ -1,14 +1,13 @@
-import { uuidv7 } from "@earendil-works/omk-agent-core";
 import { randomUUID } from "crypto";
 import { appendFileSync, closeSync, createReadStream, existsSync, mkdirSync, openSync, readdirSync, readSync, renameSync, statSync, writeFileSync, } from "fs";
 import { readdir, stat } from "fs/promises";
+import { uuidv7 } from "omk-agent-core";
 import { join, resolve } from "path";
 import { createInterface } from "readline";
 import { StringDecoder } from "string_decoder";
 import { getAgentDir as getDefaultAgentDir, getSessionsDir } from "../config.js";
 import { normalizePath, resolvePath } from "../utils/paths.js";
 import { createBranchSummaryMessage, createCompactionSummaryMessage, createCustomMessage, } from "./messages.js";
-import { BoundedDigestAccumulator, boundSessionFirstMessage, DEFAULT_SESSION_DIGEST_MAX_CHARS, } from "./session-digest.js";
 export const CURRENT_SESSION_VERSION = 3;
 function createSessionId() {
     return uuidv7();
@@ -387,7 +386,7 @@ async function buildSessionInfo(filePath) {
         let header = null;
         let messageCount = 0;
         let firstMessage = "";
-        const allMessagesDigest = new BoundedDigestAccumulator({ maxChars: DEFAULT_SESSION_DIGEST_MAX_CHARS });
+        const allMessages = [];
         let name;
         let lastActivityTime;
         const rl = createInterface({
@@ -423,9 +422,9 @@ async function buildSessionInfo(filePath) {
             const textContent = extractTextContent(message);
             if (!textContent)
                 continue;
-            allMessagesDigest.push(textContent);
+            allMessages.push(textContent);
             if (!firstMessage && message.role === "user") {
-                firstMessage = boundSessionFirstMessage(textContent);
+                firstMessage = textContent;
             }
         }
         if (!header)
@@ -448,7 +447,7 @@ async function buildSessionInfo(filePath) {
             modified,
             messageCount,
             firstMessage: firstMessage || "(no messages)",
-            allMessagesText: allMessagesDigest.result().text,
+            allMessagesText: allMessages.join(" "),
         };
     }
     catch {