@code-yeongyu/senpi-agent-core 2026.8.12 → 2026.8.13

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n\tApi,\n\tAssistantMessage,\n\tAssistantMessageEvent,\n\tAssistantMessageEventStream,\n\tContext,\n\tImageContent,\n\tMessage,\n\tModel,\n\tSimpleStreamOptions,\n\tTextContent,\n\tTool,\n\tToolResultMessage,\n\tUsage,\n} from \"@earendil-works/pi-ai\";\nimport type { Static, TSchema } from \"typebox\";\n\n/**\n * Stream function used by the agent loop. `Models.streamSimple` satisfies\n * this shape.\n *\n * Contract:\n * - Must not throw or return a rejected promise for request/model/runtime failures.\n * - Must return an AssistantMessageEventStream.\n * - Failures must be encoded in the returned stream via protocol events and a\n *   final AssistantMessage with stopReason \"error\" or \"aborted\" and errorMessage.\n */\nexport type StreamFn = (\n\tmodel: Model<Api>,\n\tcontext: Context,\n\toptions?: SimpleStreamOptions,\n) => AssistantMessageEventStream | Promise<AssistantMessageEventStream>;\n\n/**\n * Configuration for how tool calls from a single assistant message are executed.\n *\n * - \"sequential\": each tool call is prepared, executed, and finalized before the next one starts.\n * - \"parallel\": tool calls are prepared sequentially, then scheduled in concurrent waves.\n *   Tools with `executionMode: \"sequential\"` run as exclusive barriers; parallel tools before\n *   or after the barrier can still execute concurrently with each other.\n *   `tool_execution_end` is emitted in tool completion order after each tool is finalized,\n *   while tool-result message artifacts are emitted later in assistant source order.\n */\nexport type ToolExecutionMode = \"sequential\" | \"parallel\";\n\n/**\n * Controls how many queued user messages are injected when the agent loop reaches a queue drain point.\n *\n * - \"all\": drain and inject every queued message at that point.\n * - \"one-at-a-time\": drain and inject only the oldest queued message, leaving the rest queued for later drain points.\n */\nexport type QueueMode = \"all\" | \"one-at-a-time\";\n\n/** A single tool call content block emitted by an assistant message. */\nexport type AgentToolCall = Extract<AssistantMessage[\"content\"][number], { type: \"toolCall\" }>;\n\n/**\n * Result returned from `beforeToolCall`.\n *\n * Returning `{ block: true }` prevents the tool from executing. The loop emits an error tool result instead.\n * `reason` becomes the text shown in that error result. If omitted, a default blocked message is used.\n */\nexport interface BeforeToolCallResult {\n\tblock?: boolean;\n\treason?: string;\n}\n\n/**\n * Partial override returned from `afterToolCall`.\n *\n * Merge semantics are field-by-field:\n * - `content`: if provided, replaces the tool result content array in full\n * - `details`: if provided, replaces the tool result details value in full\n * - `isError`: if provided, replaces the tool result error flag\n * - `usage`: if provided, replaces the tool result usage\n * - `terminate`: if provided, replaces the early-termination hint\n *\n * Omitted fields keep the original executed tool result values.\n * There is no deep merge for `content`, `details`, or `usage`.\n */\nexport interface AfterToolCallResult {\n\tcontent?: (TextContent | ImageContent)[];\n\tdetails?: unknown;\n\tisError?: boolean;\n\t/** Usage from the final tool execution itself, if available. Not used for main LLM context accounting. */\n\tusage?: Usage;\n\t/**\n\t * Hint that the agent should stop after the current tool batch.\n\t * Early termination only happens when every finalized tool result in the batch sets this to true.\n\t */\n\tterminate?: boolean;\n}\n\n/** Context passed to `beforeToolCall`. */\nexport interface BeforeToolCallContext {\n\t/** The assistant message that requested the tool call. */\n\tassistantMessage: AssistantMessage;\n\t/** The raw tool call block from `assistantMessage.content`. */\n\ttoolCall: AgentToolCall;\n\t/** Validated tool arguments for the target tool schema. */\n\targs: unknown;\n\t/** Current agent context at the time the tool call is prepared. */\n\tcontext: AgentContext;\n}\n\n/** Context passed to `afterToolCall`. */\nexport interface AfterToolCallContext {\n\t/** The assistant message that requested the tool call. */\n\tassistantMessage: AssistantMessage;\n\t/** The raw tool call block from `assistantMessage.content`. */\n\ttoolCall: AgentToolCall;\n\t/** Validated tool arguments for the target tool schema. */\n\targs: unknown;\n\t/** The executed tool result before any `afterToolCall` overrides are applied. */\n\tresult: AgentToolResult<any>;\n\t/** Whether the executed tool result is currently treated as an error. */\n\tisError: boolean;\n\t/** Current agent context at the time the tool call is finalized. */\n\tcontext: AgentContext;\n}\n\n/** Context passed to `shouldStopAfterTurn`. */\nexport interface ShouldStopAfterTurnContext {\n\t/** The assistant message that completed the turn. */\n\tmessage: AssistantMessage;\n\t/** Tool result messages passed to the preceding `turn_end` event. */\n\ttoolResults: ToolResultMessage[];\n\t/** Current agent context after the turn's assistant message and tool results have been appended. */\n\tcontext: AgentContext;\n\t/** Messages that this loop invocation will return if it exits at this point. Prompt runs include the initial prompt messages; continuation runs do not include pre-existing context messages. */\n\tnewMessages: AgentMessage[];\n}\n\n/** Replacement runtime state used by the agent loop before starting another provider request. */\nexport interface AgentLoopTurnUpdate {\n\t/** Context for the next provider request. */\n\tcontext?: AgentContext;\n\t/** Model for the next provider request. */\n\tmodel?: Model<any>;\n\t/** Thinking level for the next provider request. */\n\tthinkingLevel?: ThinkingLevel;\n\t/** Whether the next provider request should abort a server-selected fallback. */\n\tabortServerSideFallback?: boolean;\n}\n\nexport interface PrepareNextTurnContext extends ShouldStopAfterTurnContext {}\n\nexport interface AgentLoopConfig extends SimpleStreamOptions {\n\tmodel: Model<any>;\n\n\t/**\n\t * Maximum time in milliseconds to wait for the FIRST provider stream event.\n\t * Providers emit their first event only once the HTTP response begins, so a\n\t * dead upstream that accepts the request but never answers is otherwise only\n\t * bounded by `timeoutMs` (the idle timeout, default 5 minutes). After the\n\t * first event arrives, `timeoutMs` governs inter-event idleness as before.\n\t * Unset or non-positive values disable the start bound.\n\t */\n\tstreamStartTimeoutMs?: number;\n\n\t/** Provider/SDK timeout override for only the first request in this loop invocation. */\n\tinitialRequestTimeoutMs?: number;\n\n\t/** Stream-start timeout override for only the first request in this loop invocation. */\n\tinitialRequestStreamStartTimeoutMs?: number;\n\n\t/**\n\t * Converts AgentMessage[] to LLM-compatible Message[] before each LLM call.\n\t *\n\t * Each AgentMessage must be converted to a UserMessage, AssistantMessage, or ToolResultMessage\n\t * that the LLM can understand. AgentMessages that cannot be converted (e.g., UI-only notifications,\n\t * status messages) should be filtered out.\n\t *\n\t * Contract: must not throw or reject. Return a safe fallback value instead.\n\t * Throwing interrupts the low-level agent loop without producing a normal event sequence.\n\t *\n\t * @example\n\t * ```typescript\n\t * convertToLlm: (messages) => messages.flatMap(m => {\n\t *   if (m.role === \"custom\") {\n\t *     // Convert custom message to user message\n\t *     return [{ role: \"user\", content: m.content, timestamp: m.timestamp }];\n\t *   }\n\t *   if (m.role === \"notification\") {\n\t *     // Filter out UI-only messages\n\t *     return [];\n\t *   }\n\t *   // Pass through standard LLM messages\n\t *   return [m];\n\t * })\n\t * ```\n\t */\n\tconvertToLlm: (messages: AgentMessage[]) => Message[] | Promise<Message[]>;\n\n\t/**\n\t * Optional transform applied to the context before `convertToLlm`.\n\t *\n\t * Use this for operations that work at the AgentMessage level:\n\t * - Context window management (pruning old messages)\n\t * - Injecting context from external sources\n\t *\n\t * Contract: must not throw or reject. Return the original messages or another\n\t * safe fallback value instead.\n\t *\n\t * @example\n\t * ```typescript\n\t * transformContext: async (messages) => {\n\t *   if (estimateTokens(messages) > MAX_TOKENS) {\n\t *     return pruneOldMessages(messages);\n\t *   }\n\t *   return messages;\n\t * }\n\t * ```\n\t */\n\ttransformContext?: (messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>;\n\n\t/**\n\t * Resolves an API key dynamically for each LLM call.\n\t *\n\t * Useful for short-lived OAuth tokens (e.g., GitHub Copilot) that may expire\n\t * during long-running tool execution phases.\n\t *\n\t * Contract: must not throw or reject. Return undefined when no key is available.\n\t */\n\tgetApiKey?: (provider: string) => Promise<string | undefined> | string | undefined;\n\n\t/**\n\t * Called after each turn fully completes and `turn_end` has been emitted.\n\t *\n\t * If it returns true, the loop emits `agent_end` and exits before polling steering or follow-up queues,\n\t * without starting another LLM call. The current assistant response and any tool executions finish normally.\n\t *\n\t * Use this to request a graceful stop after the current turn, e.g. before context gets too full.\n\t *\n\t * Contract: must not throw or reject. Throwing interrupts the low-level agent loop without producing a normal event sequence.\n\t */\n\tshouldStopAfterTurn?: (context: ShouldStopAfterTurnContext) => boolean | Promise<boolean>;\n\n\t/**\n\t * Called after `turn_end` and before the loop decides whether another provider request should start.\n\t * Return replacement context/model/thinking state to affect the next turn in this run.\n\t * Return undefined to keep using the current context/config.\n\t */\n\tprepareNextTurn?: (\n\t\tcontext: PrepareNextTurnContext,\n\t) => AgentLoopTurnUpdate | undefined | Promise<AgentLoopTurnUpdate | undefined>;\n\n\t/**\n\t * Returns steering messages to inject into the conversation mid-run.\n\t *\n\t * Called after the current assistant turn finishes executing its tool calls, unless `shouldStopAfterTurn` exits first.\n\t * If messages are returned, they are added to the context before the next LLM call.\n\t * Tool calls from the current assistant message are not skipped.\n\t *\n\t * Use this for \"steering\" the agent while it's working.\n\t *\n\t * Contract: must not throw or reject. Return [] when no steering messages are available.\n\t */\n\tgetSteeringMessages?: () => Promise<AgentMessage[]>;\n\n\t/**\n\t * Returns follow-up messages to process after the agent would otherwise stop.\n\t *\n\t * Called when the agent has no more tool calls and no steering messages.\n\t * If messages are returned, they're added to the context and the agent\n\t * continues with another turn.\n\t *\n\t * Use this for follow-up messages that should wait until the agent finishes.\n\t *\n\t * Contract: must not throw or reject. Return [] when no follow-up messages are available.\n\t */\n\tgetFollowUpMessages?: () => Promise<AgentMessage[]>;\n\n\t/**\n\t * Restores messages previously returned by a queue callback when next-turn preparation cannot continue.\n\t * Restored messages must be placed before messages queued after the drain.\n\t */\n\trestorePendingMessages?: (queue: \"steering\" | \"followUp\", messages: AgentMessage[]) => Promise<void> | void;\n\n\t/**\n\t * Tool execution mode.\n\t * - \"sequential\": execute tool calls one by one\n\t * - \"parallel\": preflight tool calls sequentially, then execute allowed tools in concurrent waves;\n\t *   per-tool `executionMode: \"sequential\"` calls act as exclusive barriers,\n\t *   emit `tool_execution_end` in tool completion order after each tool is finalized,\n\t *   then emit tool-result message artifacts later in assistant source order\n\t *\n\t * Default: \"parallel\"\n\t */\n\ttoolExecution?: ToolExecutionMode;\n\n\t/**\n\t * Optional migration guidance for tool names intentionally removed by an extension.\n\t * The matching hint is appended to the normal unknown-tool error before hooks run.\n\t */\n\tremovedToolHints?: Record<string, string>;\n\n\t/**\n\t * Called when a model names a tool absent from the current context snapshot.\n\t * Return a newly available tool to continue normal validation and execution, or\n\t * undefined to emit the existing unknown-tool result. Hosts may use this to\n\t * activate a registered lazy tool at call time.\n\t */\n\tresolveUnknownToolCall?: (\n\t\ttoolName: string,\n\t\tcontext: AgentContext,\n\t) => AgentTool | undefined | Promise<AgentTool | undefined>;\n\n\t/**\n\t * Called before a tool is executed, after arguments have been validated.\n\t *\n\t * Return `{ block: true }` to prevent execution. The loop emits an error tool result instead.\n\t * The hook receives the agent abort signal and is responsible for honoring it.\n\t */\n\tbeforeToolCall?: (context: BeforeToolCallContext, signal?: AbortSignal) => Promise<BeforeToolCallResult | undefined>;\n\n\t/**\n\t * Called after a tool finishes executing, before `tool_execution_end` and tool-result message events are emitted.\n\t *\n\t * Return an `AfterToolCallResult` to override parts of the executed tool result:\n\t * - `content` replaces the full content array\n\t * - `details` replaces the full details payload\n\t * - `isError` replaces the error flag\n\t * - `usage` replaces the tool result usage\n\t * - `terminate` replaces the early-termination hint\n\t *\n\t * Any omitted fields keep their original values. No deep merge is performed.\n\t * The hook receives the agent abort signal and is responsible for honoring it.\n\t */\n\tafterToolCall?: (context: AfterToolCallContext, signal?: AbortSignal) => Promise<AfterToolCallResult | undefined>;\n}\n\n/**\n * Thinking/reasoning level for models that support it.\n * Note: \"xhigh\" and \"max\" are only supported by selected model families. Use model\n * thinking-level metadata from @earendil-works/pi-ai to detect support for a concrete model.\n */\nexport type ThinkingLevel = \"off\" | \"minimal\" | \"low\" | \"medium\" | \"high\" | \"xhigh\" | \"max\";\n\n/**\n * Extensible interface for custom app messages.\n * Apps can extend via declaration merging:\n *\n * @example\n * ```typescript\n * declare module \"@earendil-works/pi-agent-core\" {\n *   interface CustomAgentMessages {\n *     artifact: ArtifactMessage;\n *     notification: NotificationMessage;\n *   }\n * }\n * ```\n */\nexport interface CustomAgentMessages {\n\t// Empty by default - apps extend via declaration merging\n}\n\n/**\n * AgentMessage: Union of LLM messages + custom messages.\n * This abstraction allows apps to add custom message types while maintaining\n * type safety and compatibility with the base LLM messages.\n */\nexport type AgentMessage = Message | CustomAgentMessages[keyof CustomAgentMessages];\n\n/**\n * Public agent state.\n *\n * `tools` and `messages` use accessor properties so implementations can copy\n * assigned arrays before storing them.\n */\nexport interface AgentState {\n\t/** System prompt sent with each model request. */\n\tsystemPrompt: string;\n\t/** Active model used for future turns. */\n\tmodel: Model<any>;\n\t/** Requested reasoning level for future turns. */\n\tthinkingLevel: ThinkingLevel;\n\t/** Available tools. Assigning a new array copies the top-level array. */\n\tset tools(tools: AgentTool<any>[]);\n\tget tools(): AgentTool<any>[];\n\t/** Conversation transcript. Assigning a new array copies the top-level array. */\n\tset messages(messages: AgentMessage[]);\n\tget messages(): AgentMessage[];\n\t/**\n\t * True while the agent is processing a prompt or continuation.\n\t *\n\t * This remains true until awaited `agent_end` listeners settle.\n\t */\n\treadonly isStreaming: boolean;\n\t/** Partial assistant message for the current streamed response, if any. */\n\treadonly streamingMessage?: AgentMessage;\n\t/** Tool call ids currently executing. */\n\treadonly pendingToolCalls: ReadonlySet<string>;\n\t/** Error message from the most recent failed or aborted assistant turn, if any. */\n\treadonly errorMessage?: string;\n}\n\n/** Final or partial result produced by a tool. */\nexport interface AgentToolResult<T> {\n\t/** Text or image content returned to the model. */\n\tcontent: (TextContent | ImageContent)[];\n\t/** Arbitrary structured details for logs or UI rendering. */\n\tdetails: T;\n\t/** Usage from the final tool execution itself, if available. Not used for main LLM context accounting. */\n\tusage?: Usage;\n\t/** Names of tools introduced by this result and available from this transcript point onward. */\n\taddedToolNames?: string[];\n\t/**\n\t * Hint that the agent should stop after the current tool batch.\n\t * Early termination only happens when every finalized tool result in the batch sets this to true.\n\t */\n\tterminate?: boolean;\n}\n\n/**\n * Callback used by tools to stream partial execution updates.\n *\n * The callback is scoped to the current `execute()` invocation. Calls made after\n * the tool promise settles are ignored.\n */\nexport type AgentToolUpdateCallback<T = any> = (partialResult: AgentToolResult<T>) => void;\n\n/** Tool definition used by the agent runtime. */\nexport interface AgentTool<TParameters extends TSchema = TSchema, TDetails = any> extends Tool<TParameters> {\n\t/** Human-readable label for UI display. */\n\tlabel: string;\n\t/**\n\t * Optional compatibility shim for raw tool-call arguments before schema validation.\n\t * Must return an object that matches `TParameters`.\n\t */\n\tprepareArguments?: (args: unknown) => Static<TParameters>;\n\t/** Execute the tool call. Throw on failure instead of encoding errors in `content`. */\n\texecute: (\n\t\ttoolCallId: string,\n\t\tparams: Static<TParameters>,\n\t\tsignal?: AbortSignal,\n\t\tonUpdate?: AgentToolUpdateCallback<TDetails>,\n\t) => Promise<AgentToolResult<TDetails>>;\n\t/**\n\t * Per-tool execution mode override.\n\t * - \"sequential\": this tool acts as an exclusive barrier in parallel batches.\n\t * - \"parallel\": this tool can execute concurrently with other tool calls.\n\t *\n\t * If omitted, the default execution mode applies.\n\t */\n\texecutionMode?: ToolExecutionMode;\n}\n\n/** Context snapshot passed into the low-level agent loop. */\nexport interface AgentContext {\n\t/** System prompt included with the request. */\n\tsystemPrompt: string;\n\t/** Transcript visible to the model. */\n\tmessages: AgentMessage[];\n\t/** Tools available for this run. */\n\ttools?: AgentTool<any>[];\n}\n\n/**\n * Events emitted by the Agent for UI updates.\n *\n * `agent_end` is the last event emitted for a run, but awaited `Agent.subscribe()`\n * listeners for that event are still part of run settlement. The agent becomes\n * idle only after those listeners finish.\n */\nexport type AgentEvent =\n\t// Agent lifecycle\n\t| { type: \"agent_start\" }\n\t| { type: \"agent_end\"; messages: AgentMessage[] }\n\t// Turn lifecycle - a turn is one assistant response + any tool calls/results\n\t| { type: \"turn_start\" }\n\t| { type: \"turn_end\"; message: AgentMessage; toolResults: ToolResultMessage[] }\n\t// Message lifecycle - emitted for user, assistant, and toolResult messages\n\t| { type: \"message_start\"; message: AgentMessage }\n\t// Only emitted for assistant messages during streaming\n\t| { type: \"message_update\"; message: AgentMessage; assistantMessageEvent: AssistantMessageEvent }\n\t| { type: \"message_end\"; message: AgentMessage }\n\t// Tool execution lifecycle\n\t| { type: \"tool_execution_start\"; toolCallId: string; toolName: string; args: any }\n\t| { type: \"tool_execution_update\"; toolCallId: string; toolName: string; args: any; partialResult: any }\n\t| { type: \"tool_execution_end\"; toolCallId: string; toolName: string; result: any; isError: boolean };\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n\tApi,\n\tAssistantMessage,\n\tAssistantMessageEvent,\n\tAssistantMessageEventStream,\n\tContext,\n\tImageContent,\n\tMessage,\n\tModel,\n\tSimpleStreamOptions,\n\tTextContent,\n\tTool,\n\tToolResultMessage,\n\tUsage,\n} from \"@earendil-works/pi-ai\";\nimport type { Static, TSchema } from \"typebox\";\n\n/**\n * Stream function used by the agent loop. `Models.streamSimple` satisfies\n * this shape.\n *\n * Contract:\n * - Must not throw or return a rejected promise for request/model/runtime failures.\n * - Must return an AssistantMessageEventStream.\n * - Failures must be encoded in the returned stream via protocol events and a\n *   final AssistantMessage with stopReason \"error\" or \"aborted\" and errorMessage.\n */\nexport type StreamFn = (\n\tmodel: Model<Api>,\n\tcontext: Context,\n\toptions?: SimpleStreamOptions,\n) => AssistantMessageEventStream | Promise<AssistantMessageEventStream>;\n\n/**\n * Configuration for how tool calls from a single assistant message are executed.\n *\n * - \"sequential\": each tool call is prepared, executed, and finalized before the next one starts.\n * - \"parallel\": tool calls are prepared sequentially, then scheduled in concurrent waves.\n *   Tools with `executionMode: \"sequential\"` run as exclusive barriers; parallel tools before\n *   or after the barrier can still execute concurrently with each other.\n *   `tool_execution_end` is emitted in tool completion order after each tool is finalized,\n *   while tool-result message artifacts are emitted later in assistant source order.\n */\nexport type ToolExecutionMode = \"sequential\" | \"parallel\";\n\n/**\n * Controls how many queued user messages are injected when the agent loop reaches a queue drain point.\n *\n * - \"all\": drain and inject every queued message at that point.\n * - \"one-at-a-time\": drain and inject only the oldest queued message, leaving the rest queued for later drain points.\n */\nexport type QueueMode = \"all\" | \"one-at-a-time\";\n\n/** A single tool call content block emitted by an assistant message. */\nexport type AgentToolCall = Extract<AssistantMessage[\"content\"][number], { type: \"toolCall\" }>;\n\n/**\n * Result returned from `beforeToolCall`.\n *\n * Returning `{ block: true }` prevents the tool from executing. The loop emits an error tool result instead.\n * `reason` becomes the text shown in that error result. If omitted, a default blocked message is used.\n */\nexport interface BeforeToolCallResult {\n\tblock?: boolean;\n\treason?: string;\n\t/**\n\t * Hint that the agent should stop after the current tool batch when this call is blocked.\n\t * Early termination only happens when every finalized tool result in the batch sets this to true.\n\t */\n\tterminate?: boolean;\n}\n\n/**\n * Partial override returned from `afterToolCall`.\n *\n * Merge semantics are field-by-field:\n * - `content`: if provided, replaces the tool result content array in full\n * - `details`: if provided, replaces the tool result details value in full\n * - `isError`: if provided, replaces the tool result error flag\n * - `usage`: if provided, replaces the tool result usage\n * - `terminate`: if provided, replaces the early-termination hint\n *\n * Omitted fields keep the original executed tool result values.\n * There is no deep merge for `content`, `details`, or `usage`.\n */\nexport interface AfterToolCallResult {\n\tcontent?: (TextContent | ImageContent)[];\n\tdetails?: unknown;\n\tisError?: boolean;\n\t/** Usage from the final tool execution itself, if available. Not used for main LLM context accounting. */\n\tusage?: Usage;\n\t/**\n\t * Hint that the agent should stop after the current tool batch.\n\t * Early termination only happens when every finalized tool result in the batch sets this to true.\n\t */\n\tterminate?: boolean;\n}\n\n/** Context passed to `beforeToolCall`. */\nexport interface BeforeToolCallContext {\n\t/** The assistant message that requested the tool call. */\n\tassistantMessage: AssistantMessage;\n\t/** The raw tool call block from `assistantMessage.content`. */\n\ttoolCall: AgentToolCall;\n\t/** Validated tool arguments for the target tool schema. */\n\targs: unknown;\n\t/** Current agent context at the time the tool call is prepared. */\n\tcontext: AgentContext;\n}\n\n/** Context passed to `afterToolCall`. */\nexport interface AfterToolCallContext {\n\t/** The assistant message that requested the tool call. */\n\tassistantMessage: AssistantMessage;\n\t/** The raw tool call block from `assistantMessage.content`. */\n\ttoolCall: AgentToolCall;\n\t/** Validated tool arguments for the target tool schema. */\n\targs: unknown;\n\t/** The executed tool result before any `afterToolCall` overrides are applied. */\n\tresult: AgentToolResult<any>;\n\t/** Whether the executed tool result is currently treated as an error. */\n\tisError: boolean;\n\t/** Current agent context at the time the tool call is finalized. */\n\tcontext: AgentContext;\n}\n\n/** Context passed to `shouldStopAfterTurn`. */\nexport interface ShouldStopAfterTurnContext {\n\t/** The assistant message that completed the turn. */\n\tmessage: AssistantMessage;\n\t/** Tool result messages passed to the preceding `turn_end` event. */\n\ttoolResults: ToolResultMessage[];\n\t/** Current agent context after the turn's assistant message and tool results have been appended. */\n\tcontext: AgentContext;\n\t/** Messages that this loop invocation will return if it exits at this point. Prompt runs include the initial prompt messages; continuation runs do not include pre-existing context messages. */\n\tnewMessages: AgentMessage[];\n}\n\n/** Replacement runtime state used by the agent loop before starting another provider request. */\nexport interface AgentLoopTurnUpdate {\n\t/** Context for the next provider request. */\n\tcontext?: AgentContext;\n\t/** Model for the next provider request. */\n\tmodel?: Model<any>;\n\t/** Thinking level for the next provider request. */\n\tthinkingLevel?: ThinkingLevel;\n\t/** Whether the next provider request should abort a server-selected fallback. */\n\tabortServerSideFallback?: boolean;\n}\n\nexport interface PrepareNextTurnContext extends ShouldStopAfterTurnContext {}\n\nexport interface AgentLoopConfig extends SimpleStreamOptions {\n\tmodel: Model<any>;\n\n\t/**\n\t * Maximum time in milliseconds to wait for the FIRST provider stream event.\n\t * Providers emit their first event only once the HTTP response begins, so a\n\t * dead upstream that accepts the request but never answers is otherwise only\n\t * bounded by `timeoutMs` (the idle timeout, default 5 minutes). After the\n\t * first event arrives, `timeoutMs` governs inter-event idleness as before.\n\t * Unset or non-positive values disable the start bound.\n\t */\n\tstreamStartTimeoutMs?: number;\n\n\t/** Provider/SDK timeout override for only the first request in this loop invocation. */\n\tinitialRequestTimeoutMs?: number;\n\n\t/** Stream-start timeout override for only the first request in this loop invocation. */\n\tinitialRequestStreamStartTimeoutMs?: number;\n\n\t/**\n\t * Converts AgentMessage[] to LLM-compatible Message[] before each LLM call.\n\t *\n\t * Each AgentMessage must be converted to a UserMessage, AssistantMessage, or ToolResultMessage\n\t * that the LLM can understand. AgentMessages that cannot be converted (e.g., UI-only notifications,\n\t * status messages) should be filtered out.\n\t *\n\t * Contract: must not throw or reject. Return a safe fallback value instead.\n\t * Throwing interrupts the low-level agent loop without producing a normal event sequence.\n\t *\n\t * @example\n\t * ```typescript\n\t * convertToLlm: (messages) => messages.flatMap(m => {\n\t *   if (m.role === \"custom\") {\n\t *     // Convert custom message to user message\n\t *     return [{ role: \"user\", content: m.content, timestamp: m.timestamp }];\n\t *   }\n\t *   if (m.role === \"notification\") {\n\t *     // Filter out UI-only messages\n\t *     return [];\n\t *   }\n\t *   // Pass through standard LLM messages\n\t *   return [m];\n\t * })\n\t * ```\n\t */\n\tconvertToLlm: (messages: AgentMessage[]) => Message[] | Promise<Message[]>;\n\n\t/**\n\t * Optional transform applied to the context before `convertToLlm`.\n\t *\n\t * Use this for operations that work at the AgentMessage level:\n\t * - Context window management (pruning old messages)\n\t * - Injecting context from external sources\n\t *\n\t * Contract: must not throw or reject. Return the original messages or another\n\t * safe fallback value instead.\n\t *\n\t * @example\n\t * ```typescript\n\t * transformContext: async (messages) => {\n\t *   if (estimateTokens(messages) > MAX_TOKENS) {\n\t *     return pruneOldMessages(messages);\n\t *   }\n\t *   return messages;\n\t * }\n\t * ```\n\t */\n\ttransformContext?: (messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>;\n\n\t/**\n\t * Resolves an API key dynamically for each LLM call.\n\t *\n\t * Useful for short-lived OAuth tokens (e.g., GitHub Copilot) that may expire\n\t * during long-running tool execution phases.\n\t *\n\t * Contract: must not throw or reject. Return undefined when no key is available.\n\t */\n\tgetApiKey?: (provider: string) => Promise<string | undefined> | string | undefined;\n\n\t/**\n\t * Called after each turn fully completes and `turn_end` has been emitted.\n\t *\n\t * If it returns true, the loop emits `agent_end` and exits before polling steering or follow-up queues,\n\t * without starting another LLM call. The current assistant response and any tool executions finish normally.\n\t *\n\t * Use this to request a graceful stop after the current turn, e.g. before context gets too full.\n\t *\n\t * Contract: must not throw or reject. Throwing interrupts the low-level agent loop without producing a normal event sequence.\n\t */\n\tshouldStopAfterTurn?: (context: ShouldStopAfterTurnContext) => boolean | Promise<boolean>;\n\n\t/**\n\t * Called after `turn_end` and before the loop decides whether another provider request should start.\n\t * Return replacement context/model/thinking state to affect the next turn in this run.\n\t * Return undefined to keep using the current context/config.\n\t */\n\tprepareNextTurn?: (\n\t\tcontext: PrepareNextTurnContext,\n\t) => AgentLoopTurnUpdate | undefined | Promise<AgentLoopTurnUpdate | undefined>;\n\n\t/**\n\t * Returns steering messages to inject into the conversation mid-run.\n\t *\n\t * Called after the current assistant turn finishes executing its tool calls, unless `shouldStopAfterTurn` exits first.\n\t * If messages are returned, they are added to the context before the next LLM call.\n\t * Tool calls from the current assistant message are not skipped.\n\t *\n\t * Use this for \"steering\" the agent while it's working.\n\t *\n\t * Contract: must not throw or reject. Return [] when no steering messages are available.\n\t */\n\tgetSteeringMessages?: () => Promise<AgentMessage[]>;\n\n\t/**\n\t * Returns follow-up messages to process after the agent would otherwise stop.\n\t *\n\t * Called when the agent has no more tool calls and no steering messages.\n\t * If messages are returned, they're added to the context and the agent\n\t * continues with another turn.\n\t *\n\t * Use this for follow-up messages that should wait until the agent finishes.\n\t *\n\t * Contract: must not throw or reject. Return [] when no follow-up messages are available.\n\t */\n\tgetFollowUpMessages?: () => Promise<AgentMessage[]>;\n\n\t/**\n\t * Restores messages previously returned by a queue callback when next-turn preparation cannot continue.\n\t * Restored messages must be placed before messages queued after the drain.\n\t */\n\trestorePendingMessages?: (queue: \"steering\" | \"followUp\", messages: AgentMessage[]) => Promise<void> | void;\n\n\t/**\n\t * Tool execution mode.\n\t * - \"sequential\": execute tool calls one by one\n\t * - \"parallel\": preflight tool calls sequentially, then execute allowed tools in concurrent waves;\n\t *   per-tool `executionMode: \"sequential\"` calls act as exclusive barriers,\n\t *   emit `tool_execution_end` in tool completion order after each tool is finalized,\n\t *   then emit tool-result message artifacts later in assistant source order\n\t *\n\t * Default: \"parallel\"\n\t */\n\ttoolExecution?: ToolExecutionMode;\n\n\t/**\n\t * Optional migration guidance for tool names intentionally removed by an extension.\n\t * The matching hint is appended to the normal unknown-tool error before hooks run.\n\t */\n\tremovedToolHints?: Record<string, string>;\n\n\t/**\n\t * Called when a model names a tool absent from the current context snapshot.\n\t * Return a newly available tool to continue normal validation and execution, or\n\t * undefined to emit the existing unknown-tool result. Hosts may use this to\n\t * activate a registered lazy tool at call time.\n\t */\n\tresolveUnknownToolCall?: (\n\t\ttoolName: string,\n\t\tcontext: AgentContext,\n\t) => AgentTool | undefined | Promise<AgentTool | undefined>;\n\n\t/**\n\t * Called before a tool is executed, after arguments have been validated.\n\t *\n\t * Return `{ block: true }` to prevent execution. The loop emits an error tool result instead.\n\t * A blocked result can also set `terminate: true` to participate in the batch early-termination rule.\n\t * The hook receives the agent abort signal and is responsible for honoring it.\n\t */\n\tbeforeToolCall?: (context: BeforeToolCallContext, signal?: AbortSignal) => Promise<BeforeToolCallResult | undefined>;\n\n\t/**\n\t * Called after a tool finishes executing, before `tool_execution_end` and tool-result message events are emitted.\n\t *\n\t * Return an `AfterToolCallResult` to override parts of the executed tool result:\n\t * - `content` replaces the full content array\n\t * - `details` replaces the full details payload\n\t * - `isError` replaces the error flag\n\t * - `usage` replaces the tool result usage\n\t * - `terminate` replaces the early-termination hint\n\t *\n\t * Any omitted fields keep their original values. No deep merge is performed.\n\t * The hook receives the agent abort signal and is responsible for honoring it.\n\t */\n\tafterToolCall?: (context: AfterToolCallContext, signal?: AbortSignal) => Promise<AfterToolCallResult | undefined>;\n}\n\n/**\n * Thinking/reasoning level for models that support it.\n * Note: \"xhigh\" and \"max\" are only supported by selected model families. Use model\n * thinking-level metadata from @earendil-works/pi-ai to detect support for a concrete model.\n */\nexport type ThinkingLevel = \"off\" | \"minimal\" | \"low\" | \"medium\" | \"high\" | \"xhigh\" | \"max\";\n\n/**\n * Extensible interface for custom app messages.\n * Apps can extend via declaration merging:\n *\n * @example\n * ```typescript\n * declare module \"@earendil-works/pi-agent-core\" {\n *   interface CustomAgentMessages {\n *     artifact: ArtifactMessage;\n *     notification: NotificationMessage;\n *   }\n * }\n * ```\n */\nexport interface CustomAgentMessages {\n\t// Empty by default - apps extend via declaration merging\n}\n\n/**\n * AgentMessage: Union of LLM messages + custom messages.\n * This abstraction allows apps to add custom message types while maintaining\n * type safety and compatibility with the base LLM messages.\n */\nexport type AgentMessage = Message | CustomAgentMessages[keyof CustomAgentMessages];\n\n/**\n * Public agent state.\n *\n * `tools` and `messages` use accessor properties so implementations can copy\n * assigned arrays before storing them.\n */\nexport interface AgentState {\n\t/** System prompt sent with each model request. */\n\tsystemPrompt: string;\n\t/** Active model used for future turns. */\n\tmodel: Model<any>;\n\t/** Requested reasoning level for future turns. */\n\tthinkingLevel: ThinkingLevel;\n\t/** Available tools. Assigning a new array copies the top-level array. */\n\tset tools(tools: AgentTool<any>[]);\n\tget tools(): AgentTool<any>[];\n\t/** Conversation transcript. Assigning a new array copies the top-level array. */\n\tset messages(messages: AgentMessage[]);\n\tget messages(): AgentMessage[];\n\t/**\n\t * True while the agent is processing a prompt or continuation.\n\t *\n\t * This remains true until awaited `agent_end` listeners settle.\n\t */\n\treadonly isStreaming: boolean;\n\t/** Partial assistant message for the current streamed response, if any. */\n\treadonly streamingMessage?: AgentMessage;\n\t/** Tool call ids currently executing. */\n\treadonly pendingToolCalls: ReadonlySet<string>;\n\t/** Error message from the most recent failed or aborted assistant turn, if any. */\n\treadonly errorMessage?: string;\n}\n\n/** Final or partial result produced by a tool. */\nexport interface AgentToolResult<T> {\n\t/** Text or image content returned to the model. */\n\tcontent: (TextContent | ImageContent)[];\n\t/** Arbitrary structured details for logs or UI rendering. */\n\tdetails: T;\n\t/** Usage from the final tool execution itself, if available. Not used for main LLM context accounting. */\n\tusage?: Usage;\n\t/** Names of tools introduced by this result and available from this transcript point onward. */\n\taddedToolNames?: string[];\n\t/**\n\t * Hint that the agent should stop after the current tool batch.\n\t * Early termination only happens when every finalized tool result in the batch sets this to true.\n\t */\n\tterminate?: boolean;\n}\n\n/**\n * Callback used by tools to stream partial execution updates.\n *\n * The callback is scoped to the current `execute()` invocation. Calls made after\n * the tool promise settles are ignored.\n */\nexport type AgentToolUpdateCallback<T = any> = (partialResult: AgentToolResult<T>) => void;\n\n/** Tool definition used by the agent runtime. */\nexport interface AgentTool<TParameters extends TSchema = TSchema, TDetails = any> extends Tool<TParameters> {\n\t/** Human-readable label for UI display. */\n\tlabel: string;\n\t/**\n\t * Optional compatibility shim for raw tool-call arguments before schema validation.\n\t * Must return an object that matches `TParameters`.\n\t */\n\tprepareArguments?: (args: unknown) => Static<TParameters>;\n\t/** Execute the tool call. Throw on failure instead of encoding errors in `content`. */\n\texecute: (\n\t\ttoolCallId: string,\n\t\tparams: Static<TParameters>,\n\t\tsignal?: AbortSignal,\n\t\tonUpdate?: AgentToolUpdateCallback<TDetails>,\n\t) => Promise<AgentToolResult<TDetails>>;\n\t/**\n\t * Per-tool execution mode override.\n\t * - \"sequential\": this tool acts as an exclusive barrier in parallel batches.\n\t * - \"parallel\": this tool can execute concurrently with other tool calls.\n\t *\n\t * If omitted, the default execution mode applies.\n\t */\n\texecutionMode?: ToolExecutionMode;\n}\n\n/** Context snapshot passed into the low-level agent loop. */\nexport interface AgentContext {\n\t/** System prompt included with the request. */\n\tsystemPrompt: string;\n\t/** Transcript visible to the model. */\n\tmessages: AgentMessage[];\n\t/** Tools available for this run. */\n\ttools?: AgentTool<any>[];\n}\n\n/**\n * Events emitted by the Agent for UI updates.\n *\n * `agent_end` is the last event emitted for a run, but awaited `Agent.subscribe()`\n * listeners for that event are still part of run settlement. The agent becomes\n * idle only after those listeners finish.\n */\nexport type AgentEvent =\n\t// Agent lifecycle\n\t| { type: \"agent_start\" }\n\t| { type: \"agent_end\"; messages: AgentMessage[] }\n\t// Turn lifecycle - a turn is one assistant response + any tool calls/results\n\t| { type: \"turn_start\" }\n\t| { type: \"turn_end\"; message: AgentMessage; toolResults: ToolResultMessage[] }\n\t// Message lifecycle - emitted for user, assistant, and toolResult messages\n\t| { type: \"message_start\"; message: AgentMessage }\n\t// Only emitted for assistant messages during streaming\n\t| { type: \"message_update\"; message: AgentMessage; assistantMessageEvent: AssistantMessageEvent }\n\t| { type: \"message_end\"; message: AgentMessage }\n\t// Tool execution lifecycle\n\t| { type: \"tool_execution_start\"; toolCallId: string; toolName: string; args: any }\n\t| { type: \"tool_execution_update\"; toolCallId: string; toolName: string; args: any; partialResult: any }\n\t| { type: \"tool_execution_end\"; toolCallId: string; toolName: string; result: any; isError: boolean };\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/senpi-agent-core",
-	"version": "2026.8.12",
+	"version": "2026.8.13",
 	"description": "General-purpose agent with transport abstraction, state management, and attachment support",
 	"type": "module",
 	"main": "./dist/index.js",
@@ -14,6 +14,10 @@
 			"types": "./dist/node.d.ts",
 			"import": "./dist/node.js"
 		},
+		"./session/testing": {
+			"types": "./dist/harness/session/testing/index.d.ts",
+			"import": "./dist/harness/session/testing/index.js"
+		},
 		"./package.json": "./package.json"
 	},
 	"files": [
@@ -22,6 +26,8 @@
 	],
 	"scripts": {
 		"clean": "shx rm -rf dist",
+		"generate-telemetry-docs": "node scripts/generate-telemetry-docs.ts",
+		"check:telemetry-docs": "node scripts/generate-telemetry-docs.ts --check",
 		"build": "tsc -p tsconfig.build.json",
 		"test": "vitest --run",
 		"test:harness": "vitest --run --config vitest.harness.config.ts",
@@ -29,7 +35,8 @@
 		"prepublishOnly": "npm run build"
 	},
 	"dependencies": {
-		"@earendil-works/pi-ai": "npm:@code-yeongyu/senpi-ai@2026.8.12",
+		"@earendil-works/pi-ai": "npm:@code-yeongyu/senpi-ai@2026.8.13",
+		"@earendil-works/pi-telemetry": "npm:@code-yeongyu/senpi-telemetry@2026.8.13",
 		"diff": "9.0.0",
 		"ignore": "7.0.6",
 		"typebox": "1.3.8",

package/dist/harness/session/array-session-reader.d.ts

@@ -1,3 +0,0 @@
-import type { SessionMetadata, SessionReader, SessionTreeEntry } from "../types.ts";
-export declare function createArraySessionReader<TMetadata extends SessionMetadata>(metadata: TMetadata, readCurrentEntries: () => readonly SessionTreeEntry[]): SessionReader<TMetadata>;
-//# sourceMappingURL=array-session-reader.d.ts.map

package/dist/harness/session/array-session-reader.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"array-session-reader.d.ts","sourceRoot":"","sources":["../../../src/harness/session/array-session-reader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA6B,eAAe,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/G,wBAAgB,wBAAwB,CAAC,SAAS,SAAS,eAAe,EACzE,QAAQ,EAAE,SAAS,EACnB,kBAAkB,EAAE,MAAM,SAAS,gBAAgB,EAAE,GACnD,aAAa,CAAC,SAAS,CAAC,CA+D1B"}

package/dist/harness/session/array-session-reader.js

@@ -1,70 +0,0 @@
-import { SessionError } from "../types.js";
-export function createArraySessionReader(metadata, readCurrentEntries) {
-    let indexedCount = 0;
-    let indexedEntries;
-    let leafId = null;
-    const byId = new Map();
-    const updateIndex = () => {
-        const entries = readCurrentEntries();
-        if (entries !== indexedEntries || entries.length < indexedCount) {
-            indexedCount = 0;
-            leafId = null;
-            byId.clear();
-            indexedEntries = entries;
-        }
-        for (; indexedCount < entries.length; indexedCount++) {
-            const entry = entries[indexedCount];
-            byId.set(entry.id, entry);
-            leafId = entry.type === "leaf" ? entry.targetId : entry.id;
-        }
-        return entries;
-    };
-    return {
-        metadata,
-        async readHead() {
-            updateIndex();
-            if (leafId !== null && !byId.has(leafId)) {
-                throw new SessionError("invalid_session", `Entry ${leafId} not found`);
-            }
-            return { leafId };
-        },
-        async readEntry(id) {
-            updateIndex();
-            return byId.get(id);
-        },
-        async readEntries(options) {
-            const entries = updateIndex();
-            const start = options?.afterEntrySeq ?? 0;
-            const end = options?.limit === undefined ? undefined : start + options.limit;
-            return entries.slice(start, end);
-        },
-        async readPathToRootOrCompaction(requestedLeafId) {
-            updateIndex();
-            if (requestedLeafId === null)
-                return [];
-            const path = [];
-            let stopAtEntryId = null;
-            let current = byId.get(requestedLeafId);
-            if (!current)
-                throw new SessionError("not_found", `Entry ${requestedLeafId} not found`);
-            while (current) {
-                path.push(current);
-                if (stopAtEntryId !== null && current.id === stopAtEntryId)
-                    break;
-                if (current.type === "compaction") {
-                    if (current.retainedTail)
-                        break;
-                    stopAtEntryId = current.firstKeptEntryId ?? null;
-                }
-                if (!current.parentId)
-                    break;
-                const parent = byId.get(current.parentId);
-                if (!parent)
-                    throw new SessionError("invalid_session", `Entry ${current.parentId} not found`);
-                current = parent;
-            }
-            return path.reverse();
-        },
-    };
-}
-//# sourceMappingURL=array-session-reader.js.map

package/dist/harness/session/array-session-reader.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"array-session-reader.js","sourceRoot":"","sources":["../../../src/harness/session/array-session-reader.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,UAAU,wBAAwB,CACvC,QAAmB,EACnB,kBAAqD;IAErD,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,cAAuD,CAAC;IAC5D,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEjD,MAAM,WAAW,GAAG,GAAgC,EAAE;QACrD,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;QACrC,IAAI,OAAO,KAAK,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,YAAY,EAAE,CAAC;YACjE,YAAY,GAAG,CAAC,CAAC;YACjB,MAAM,GAAG,IAAI,CAAC;YACd,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,cAAc,GAAG,OAAO,CAAC;QAC1B,CAAC;QACD,OAAO,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,CAAC;YACtD,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,CAAE,CAAC;YACrC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YAC1B,MAAM,GAAG,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5D,CAAC;QACD,OAAO,OAAO,CAAC;IAChB,CAAC,CAAC;IAEF,OAAO;QACN,QAAQ;QACR,KAAK,CAAC,QAAQ;YACb,WAAW,EAAE,CAAC;YACd,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1C,MAAM,IAAI,YAAY,CAAC,iBAAiB,EAAE,SAAS,MAAM,YAAY,CAAC,CAAC;YACxE,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,CAAC;QACnB,CAAC;QACD,KAAK,CAAC,SAAS,CAAC,EAAE;YACjB,WAAW,EAAE,CAAC;YACd,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrB,CAAC;QACD,KAAK,CAAC,WAAW,CAAC,OAAmC;YACpD,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,OAAO,EAAE,aAAa,IAAI,CAAC,CAAC;YAC1C,MAAM,GAAG,GAAG,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;YAC7E,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC;QACD,KAAK,CAAC,0BAA0B,CAAC,eAAe;YAC/C,WAAW,EAAE,CAAC;YACd,IAAI,eAAe,KAAK,IAAI;gBAAE,OAAO,EAAE,CAAC;YACxC,MAAM,IAAI,GAAuB,EAAE,CAAC;YACpC,IAAI,aAAa,GAAkB,IAAI,CAAC;YACxC,IAAI,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YACxC,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,YAAY,CAAC,WAAW,EAAE,SAAS,eAAe,YAAY,CAAC,CAAC;YACxF,OAAO,OAAO,EAAE,CAAC;gBAChB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACnB,IAAI,aAAa,KAAK,IAAI,IAAI,OAAO,CAAC,EAAE,KAAK,aAAa;oBAAE,MAAM;gBAClE,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;oBACnC,IAAI,OAAO,CAAC,YAAY;wBAAE,MAAM;oBAChC,aAAa,GAAG,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAC;gBAClD,CAAC;gBACD,IAAI,CAAC,OAAO,CAAC,QAAQ;oBAAE,MAAM;gBAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAC1C,IAAI,CAAC,MAAM;oBAAE,MAAM,IAAI,YAAY,CAAC,iBAAiB,EAAE,SAAS,OAAO,CAAC,QAAQ,YAAY,CAAC,CAAC;gBAC9F,OAAO,GAAG,MAAM,CAAC;YAClB,CAAC;YACD,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;KACD,CAAC;AACH,CAAC","sourcesContent":["import type { SessionEntryCursorOptions, SessionMetadata, SessionReader, SessionTreeEntry } from \"../types.ts\";\nimport { SessionError } from \"../types.ts\";\n\nexport function createArraySessionReader<TMetadata extends SessionMetadata>(\n\tmetadata: TMetadata,\n\treadCurrentEntries: () => readonly SessionTreeEntry[],\n): SessionReader<TMetadata> {\n\tlet indexedCount = 0;\n\tlet indexedEntries: readonly SessionTreeEntry[] | undefined;\n\tlet leafId: string | null = null;\n\tconst byId = new Map<string, SessionTreeEntry>();\n\n\tconst updateIndex = (): readonly SessionTreeEntry[] => {\n\t\tconst entries = readCurrentEntries();\n\t\tif (entries !== indexedEntries || entries.length < indexedCount) {\n\t\t\tindexedCount = 0;\n\t\t\tleafId = null;\n\t\t\tbyId.clear();\n\t\t\tindexedEntries = entries;\n\t\t}\n\t\tfor (; indexedCount < entries.length; indexedCount++) {\n\t\t\tconst entry = entries[indexedCount]!;\n\t\t\tbyId.set(entry.id, entry);\n\t\t\tleafId = entry.type === \"leaf\" ? entry.targetId : entry.id;\n\t\t}\n\t\treturn entries;\n\t};\n\n\treturn {\n\t\tmetadata,\n\t\tasync readHead() {\n\t\t\tupdateIndex();\n\t\t\tif (leafId !== null && !byId.has(leafId)) {\n\t\t\t\tthrow new SessionError(\"invalid_session\", `Entry ${leafId} not found`);\n\t\t\t}\n\t\t\treturn { leafId };\n\t\t},\n\t\tasync readEntry(id) {\n\t\t\tupdateIndex();\n\t\t\treturn byId.get(id);\n\t\t},\n\t\tasync readEntries(options?: SessionEntryCursorOptions) {\n\t\t\tconst entries = updateIndex();\n\t\t\tconst start = options?.afterEntrySeq ?? 0;\n\t\t\tconst end = options?.limit === undefined ? undefined : start + options.limit;\n\t\t\treturn entries.slice(start, end);\n\t\t},\n\t\tasync readPathToRootOrCompaction(requestedLeafId) {\n\t\t\tupdateIndex();\n\t\t\tif (requestedLeafId === null) return [];\n\t\t\tconst path: SessionTreeEntry[] = [];\n\t\t\tlet stopAtEntryId: string | null = null;\n\t\t\tlet current = byId.get(requestedLeafId);\n\t\t\tif (!current) throw new SessionError(\"not_found\", `Entry ${requestedLeafId} not found`);\n\t\t\twhile (current) {\n\t\t\t\tpath.push(current);\n\t\t\t\tif (stopAtEntryId !== null && current.id === stopAtEntryId) break;\n\t\t\t\tif (current.type === \"compaction\") {\n\t\t\t\t\tif (current.retainedTail) break;\n\t\t\t\t\tstopAtEntryId = current.firstKeptEntryId ?? null;\n\t\t\t\t}\n\t\t\t\tif (!current.parentId) break;\n\t\t\t\tconst parent = byId.get(current.parentId);\n\t\t\t\tif (!parent) throw new SessionError(\"invalid_session\", `Entry ${current.parentId} not found`);\n\t\t\t\tcurrent = parent;\n\t\t\t}\n\t\t\treturn path.reverse();\n\t\t},\n\t};\n}\n"]}

package/dist/harness/session/fork.d.ts

@@ -1,4 +0,0 @@
-import type { SessionForkOptions, SessionForkSelection, SessionReader, SessionTreeEntry } from "../types.ts";
-export declare function createSessionForkSelection(options: SessionForkOptions): SessionForkSelection;
-export declare function readSessionEntriesForFork(reader: SessionReader, selection: SessionForkSelection): Promise<readonly SessionTreeEntry[]>;
-//# sourceMappingURL=fork.d.ts.map

package/dist/harness/session/fork.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fork.d.ts","sourceRoot":"","sources":["../../../src/harness/session/fork.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG7G,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,kBAAkB,GAAG,oBAAoB,CAK5F;AAED,wBAAsB,yBAAyB,CAC9C,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,oBAAoB,GAC7B,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAStC"}

package/dist/harness/session/fork.js

@@ -1,22 +0,0 @@
-import { SessionError } from "../types.js";
-export function createSessionForkSelection(options) {
-    if (!options.entryId)
-        return { kind: "all" };
-    return (options.position ?? "before") === "at"
-        ? { kind: "through_entry", entryId: options.entryId }
-        : { kind: "before_user_message", entryId: options.entryId };
-}
-export async function readSessionEntriesForFork(reader, selection) {
-    if (selection.kind === "all")
-        return reader.readEntries();
-    const target = await reader.readEntry(selection.entryId);
-    if (!target)
-        throw new SessionError("invalid_fork_target", `Entry ${selection.entryId} not found`);
-    if (selection.kind === "through_entry")
-        return reader.readPathToRootOrCompaction(target.id);
-    if (target.type !== "message" || target.message.role !== "user") {
-        throw new SessionError("invalid_fork_target", `Entry ${selection.entryId} is not a user message`);
-    }
-    return reader.readPathToRootOrCompaction(target.parentId);
-}
-//# sourceMappingURL=fork.js.map

package/dist/harness/session/fork.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fork.js","sourceRoot":"","sources":["../../../src/harness/session/fork.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,UAAU,0BAA0B,CAAC,OAA2B;IACrE,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC7C,OAAO,CAAC,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC,KAAK,IAAI;QAC7C,CAAC,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;QACrD,CAAC,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC9C,MAAqB,EACrB,SAA+B;IAE/B,IAAI,SAAS,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC;IAC1D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACzD,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,YAAY,CAAC,qBAAqB,EAAE,SAAS,SAAS,CAAC,OAAO,YAAY,CAAC,CAAC;IACnG,IAAI,SAAS,CAAC,IAAI,KAAK,eAAe;QAAE,OAAO,MAAM,CAAC,0BAA0B,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC5F,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACjE,MAAM,IAAI,YAAY,CAAC,qBAAqB,EAAE,SAAS,SAAS,CAAC,OAAO,wBAAwB,CAAC,CAAC;IACnG,CAAC;IACD,OAAO,MAAM,CAAC,0BAA0B,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC3D,CAAC","sourcesContent":["import type { SessionForkOptions, SessionForkSelection, SessionReader, SessionTreeEntry } from \"../types.ts\";\nimport { SessionError } from \"../types.ts\";\n\nexport function createSessionForkSelection(options: SessionForkOptions): SessionForkSelection {\n\tif (!options.entryId) return { kind: \"all\" };\n\treturn (options.position ?? \"before\") === \"at\"\n\t\t? { kind: \"through_entry\", entryId: options.entryId }\n\t\t: { kind: \"before_user_message\", entryId: options.entryId };\n}\n\nexport async function readSessionEntriesForFork(\n\treader: SessionReader,\n\tselection: SessionForkSelection,\n): Promise<readonly SessionTreeEntry[]> {\n\tif (selection.kind === \"all\") return reader.readEntries();\n\tconst target = await reader.readEntry(selection.entryId);\n\tif (!target) throw new SessionError(\"invalid_fork_target\", `Entry ${selection.entryId} not found`);\n\tif (selection.kind === \"through_entry\") return reader.readPathToRootOrCompaction(target.id);\n\tif (target.type !== \"message\" || target.message.role !== \"user\") {\n\t\tthrow new SessionError(\"invalid_fork_target\", `Entry ${selection.entryId} is not a user message`);\n\t}\n\treturn reader.readPathToRootOrCompaction(target.parentId);\n}\n"]}

package/dist/harness/session/jsonl-store.d.ts

@@ -1,13 +0,0 @@
-import type { FileSystem, JsonlSessionCreateOptions, JsonlSessionListOptions, JsonlSessionMetadata, SessionStore } from "../types.ts";
-export interface JsonlSessionStoreOptions {
-    fs: JsonlSessionStoreFileSystem;
-    sessionsRoot: string;
-    /** Maximum active operations across session keys. Defaults to 4. */
-    maxConcurrentOperations?: number;
-}
-export type JsonlSessionStoreFileSystem = Pick<FileSystem, "absolutePath" | "joinPath" | "readTextFile" | "readTextLines" | "writeFile" | "appendFile" | "listDir" | "exists" | "createDir" | "remove">;
-type JsonlSessionFileSystem = Pick<FileSystem, "readTextFile" | "readTextLines" | "writeFile" | "appendFile">;
-export declare function loadJsonlSessionMetadata(fs: JsonlSessionFileSystem, path: string): Promise<JsonlSessionMetadata>;
-export declare function createJsonlSessionStore(options: JsonlSessionStoreOptions): SessionStore<JsonlSessionMetadata, JsonlSessionCreateOptions, JsonlSessionListOptions>;
-export {};
-//# sourceMappingURL=jsonl-store.d.ts.map

package/dist/harness/session/jsonl-store.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"jsonl-store.d.ts","sourceRoot":"","sources":["../../../src/harness/session/jsonl-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,UAAU,EACV,yBAAyB,EACzB,uBAAuB,EACvB,oBAAoB,EAGpB,YAAY,EAEZ,MAAM,aAAa,CAAC;AAOrB,MAAM,WAAW,wBAAwB;IACxC,EAAE,EAAE,2BAA2B,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,uBAAuB,CAAC,EAAE,MAAM,CAAC;CACjC;AACD,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAC7C,UAAU,EACR,cAAc,GACd,UAAU,GACV,cAAc,GACd,eAAe,GACf,WAAW,GACX,YAAY,GACZ,SAAS,GACT,QAAQ,GACR,WAAW,GACX,QAAQ,CACV,CAAC;AAEF,KAAK,sBAAsB,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,GAAG,eAAe,GAAG,WAAW,GAAG,YAAY,CAAC,CAAC;AA2G9G,wBAAsB,wBAAwB,CAC7C,EAAE,EAAE,sBAAsB,EAC1B,IAAI,EAAE,MAAM,GACV,OAAO,CAAC,oBAAoB,CAAC,CAO/B;AAwRD,wBAAgB,uBAAuB,CACtC,OAAO,EAAE,wBAAwB,GAC/B,YAAY,CAAC,oBAAoB,EAAE,yBAAyB,EAAE,uBAAuB,CAAC,CAExF"}

package/dist/harness/session/jsonl-store.js

@@ -1,304 +0,0 @@
-import { SessionError, toError } from "../types.js";
-import { createArraySessionReader } from "./array-session-reader.js";
-import { readSessionEntriesForFork } from "./fork.js";
-import { KeyedOperationQueue } from "./keyed-operation-queue.js";
-import { createSessionId, createTimestamp, getFileSystemResultOrThrow } from "./repository.js";
-const DEFAULT_MAX_CONCURRENT_OPERATIONS = 4;
-function invalidSession(path, message, cause) {
-    return new SessionError("invalid_session", `Invalid JSONL session file ${path}: ${message}`, cause);
-}
-function invalidEntry(path, line, message, cause) {
-    return new SessionError("invalid_entry", `Invalid JSONL session file ${path}: line ${line} ${message}`, cause);
-}
-function parseHeader(line, path) {
-    let value;
-    try {
-        value = JSON.parse(line);
-    }
-    catch (error) {
-        throw invalidSession(path, "first line is not a valid session header", toError(error));
-    }
-    if (typeof value !== "object" || value === null)
-        throw invalidSession(path, "first line is not a valid session header");
-    const header = value;
-    if (header.type !== "session" || header.version !== 3) {
-        throw invalidSession(path, header.type === "session" ? "unsupported session version" : "first line is not a valid session header");
-    }
-    if (typeof header.id !== "string" || !header.id)
-        throw invalidSession(path, "session header is missing id");
-    if (typeof header.timestamp !== "string" || !header.timestamp)
-        throw invalidSession(path, "session header is missing timestamp");
-    if (typeof header.cwd !== "string" || !header.cwd)
-        throw invalidSession(path, "session header is missing cwd");
-    if (header.parentSession !== undefined && typeof header.parentSession !== "string") {
-        throw invalidSession(path, "session header parentSession must be a string");
-    }
-    if (header.metadata !== undefined &&
-        (typeof header.metadata !== "object" || header.metadata === null || Array.isArray(header.metadata))) {
-        throw invalidSession(path, "session header metadata must be an object");
-    }
-    return {
-        type: "session",
-        version: 3,
-        id: header.id,
-        timestamp: header.timestamp,
-        cwd: header.cwd,
-        parentSession: header.parentSession,
-        metadata: header.metadata,
-    };
-}
-function parseEntry(line, path, lineNumber) {
-    let value;
-    try {
-        value = JSON.parse(line);
-    }
-    catch (error) {
-        throw invalidEntry(path, lineNumber, "is not valid JSON", toError(error));
-    }
-    if (typeof value !== "object" || value === null)
-        throw invalidEntry(path, lineNumber, "is not a valid session entry");
-    const entry = value;
-    if (typeof entry.type !== "string")
-        throw invalidEntry(path, lineNumber, "is missing entry type");
-    if (typeof entry.id !== "string" || !entry.id)
-        throw invalidEntry(path, lineNumber, "is missing entry id");
-    if (entry.parentId !== null && typeof entry.parentId !== "string")
-        throw invalidEntry(path, lineNumber, "has invalid parentId");
-    if (typeof entry.timestamp !== "string" || !entry.timestamp)
-        throw invalidEntry(path, lineNumber, "is missing timestamp");
-    if (entry.type === "leaf" && entry.targetId !== null && typeof entry.targetId !== "string") {
-        throw invalidEntry(path, lineNumber, "has invalid targetId");
-    }
-    return entry;
-}
-function metadataFromHeader(header, path) {
-    return {
-        id: header.id,
-        createdAt: header.timestamp,
-        cwd: header.cwd,
-        path,
-        parentSessionPath: header.parentSession,
-        metadata: header.metadata,
-    };
-}
-export async function loadJsonlSessionMetadata(fs, path) {
-    const lines = getFileSystemResultOrThrow(await fs.readTextLines(path, { maxLines: 1 }), `Failed to read session header ${path}`);
-    if (!lines[0]?.trim())
-        throw invalidSession(path, "missing session header");
-    return metadataFromHeader(parseHeader(lines[0], path), path);
-}
-async function loadJsonlSession(fs, path) {
-    const content = getFileSystemResultOrThrow(await fs.readTextFile(path), `Failed to read session ${path}`);
-    const lines = content.split("\n").filter((line) => line.trim());
-    if (lines.length === 0)
-        throw invalidSession(path, "missing session header");
-    const header = parseHeader(lines[0], path);
-    const entries = lines.slice(1).map((line, index) => parseEntry(line, path, index + 2));
-    const entryIds = new Set();
-    for (const entry of entries) {
-        if (entryIds.has(entry.id))
-            throw invalidSession(path, `duplicate entry id ${entry.id}`);
-        entryIds.add(entry.id);
-    }
-    return {
-        metadata: metadataFromHeader(header, path),
-        entries,
-    };
-}
-function encodeCwd(cwd) {
-    return `--${cwd.replace(/^[/\\]/, "").replace(/[/\\:]/g, "-")}--`;
-}
-function createDocumentDescriptor(options) {
-    const id = options.id ?? createSessionId();
-    if (!id)
-        throw new SessionError("invalid_session", "Session id cannot be empty");
-    let encodedId;
-    try {
-        encodedId = encodeURIComponent(id);
-    }
-    catch (error) {
-        throw new SessionError("invalid_session", `Invalid session id ${JSON.stringify(id)}`, toError(error));
-    }
-    const timestamp = createTimestamp();
-    const fileName = `${timestamp.replace(/[:.]/g, "-")}_${encodedId}.jsonl`;
-    return {
-        id,
-        timestamp,
-        fileName,
-        operationKey: `document:${JSON.stringify([encodeCwd(options.cwd), fileName])}`,
-    };
-}
-class JsonlSessionStore {
-    constructor(options) {
-        this.entryIdsByPath = new Map();
-        this.entriesByPath = new Map();
-        this.operationKeysByPath = new Map();
-        this.disposed = false;
-        this.fs = options.fs;
-        this.sessionsRootInput = options.sessionsRoot;
-        this.operations = new KeyedOperationQueue({
-            maxConcurrentOperations: options.maxConcurrentOperations ?? DEFAULT_MAX_CONCURRENT_OPERATIONS,
-        });
-    }
-    create(options) {
-        this.assertOpen();
-        const descriptor = createDocumentDescriptor(options);
-        return this.operations.enqueue(descriptor.operationKey, () => this.createDocument(descriptor, options, options.parentSessionPath, options.metadata, []));
-    }
-    load(metadata) {
-        this.assertOpen();
-        return this.operations.enqueue(this.operationKey(metadata), () => this.loadDocument(metadata));
-    }
-    async loadDocument(metadata) {
-        if (!getFileSystemResultOrThrow(await this.fs.exists(metadata.path), `Failed to check session ${metadata.path}`)) {
-            throw new SessionError("not_found", `Session not found: ${metadata.path}`);
-        }
-        const document = await loadJsonlSession(this.fs, metadata.path);
-        this.entriesByPath.set(metadata.path, document.entries);
-        this.entryIdsByPath.set(metadata.path, new Set(document.entries.map((entry) => entry.id)));
-        return this.reader(document.metadata);
-    }
-    list(options = {}) {
-        this.assertOpen();
-        return this.operations.enqueueBarrier(() => this.listSessions(options));
-    }
-    async listSessions(options) {
-        const dirs = options.cwd ? [await this.getSessionDir(options.cwd)] : await this.listSessionDirs();
-        const sessions = [];
-        for (const dir of dirs) {
-            if (!getFileSystemResultOrThrow(await this.fs.exists(dir), `Failed to check session directory ${dir}`))
-                continue;
-            const files = getFileSystemResultOrThrow(await this.fs.listDir(dir), `Failed to list sessions in ${dir}`).filter((file) => file.kind !== "directory" && file.name.endsWith(".jsonl"));
-            for (const file of files)
-                sessions.push(await loadJsonlSessionMetadata(this.fs, file.path));
-        }
-        return sessions.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
-    }
-    appendEntry(metadata, entry) {
-        this.assertOpen();
-        return this.operations.enqueue(this.operationKey(metadata), async () => {
-            if (!getFileSystemResultOrThrow(await this.fs.exists(metadata.path), `Failed to check session ${metadata.path}`)) {
-                throw new SessionError("not_found", `Session not found: ${metadata.path}`);
-            }
-            let entryIds = this.entryIdsByPath.get(metadata.path);
-            if (!entryIds) {
-                await this.loadDocument(metadata);
-                entryIds = this.entryIdsByPath.get(metadata.path);
-            }
-            if (entryIds.has(entry.id))
-                throw new SessionError("invalid_entry", `Entry ${entry.id} already exists`);
-            getFileSystemResultOrThrow(await this.fs.appendFile(metadata.path, `${JSON.stringify(entry)}\n`), `Failed to append session entry ${entry.id}`);
-            entryIds.add(entry.id);
-            this.entryIdsByPath.set(metadata.path, entryIds);
-            this.entriesByPath.get(metadata.path).push(entry);
-        });
-    }
-    delete(metadata) {
-        this.assertOpen();
-        return this.operations.enqueue(this.operationKey(metadata), async () => {
-            getFileSystemResultOrThrow(await this.fs.remove(metadata.path, { force: true }), `Failed to delete session ${metadata.path}`);
-            this.entryIdsByPath.delete(metadata.path);
-            this.entriesByPath.delete(metadata.path);
-            this.operationKeysByPath.delete(metadata.path);
-        });
-    }
-    fork(source, options, selection) {
-        this.assertOpen();
-        const descriptor = createDocumentDescriptor(options);
-        const sourceEntries = this.operations.enqueue(this.operationKey(source), async () => {
-            if (!getFileSystemResultOrThrow(await this.fs.exists(source.path), `Failed to check session ${source.path}`)) {
-                throw new SessionError("not_found", `Session not found: ${source.path}`);
-            }
-            const document = await loadJsonlSession(this.fs, source.path);
-            this.entriesByPath.set(source.path, document.entries);
-            this.entryIdsByPath.set(source.path, new Set(document.entries.map((entry) => entry.id)));
-            return readSessionEntriesForFork(createArraySessionReader(document.metadata, () => document.entries), selection);
-        });
-        return this.operations.enqueue(descriptor.operationKey, async () => this.createDocument(descriptor, options, options.parentSessionPath ?? source.path, options.metadata ?? source.metadata, await sourceEntries));
-    }
-    async [Symbol.asyncDispose]() {
-        if (!this.disposePromise) {
-            this.disposed = true;
-            this.disposePromise = this.operations.drain();
-        }
-        await this.disposePromise;
-    }
-    assertOpen() {
-        if (this.disposed)
-            throw new SessionError("storage", "JSONL session store is disposed");
-    }
-    operationKey(metadata) {
-        return this.operationKeysByPath.get(metadata.path) ?? metadata.path;
-    }
-    async createDocument(descriptor, options, parentSessionPath, metadata, entries) {
-        const dir = await this.getSessionDir(options.cwd);
-        getFileSystemResultOrThrow(await this.fs.createDir(dir, { recursive: true }), `Failed to create session directory ${dir}`);
-        const path = getFileSystemResultOrThrow(await this.fs.joinPath([dir, descriptor.fileName]), `Failed to resolve session file path for ${descriptor.id}`);
-        if (getFileSystemResultOrThrow(await this.fs.exists(path), `Failed to check session ${path}`)) {
-            throw new SessionError("invalid_session", `Session already exists: ${path}`);
-        }
-        const header = {
-            type: "session",
-            version: 3,
-            id: descriptor.id,
-            timestamp: descriptor.timestamp,
-            cwd: options.cwd,
-            parentSession: parentSessionPath,
-            metadata,
-        };
-        const content = [JSON.stringify(header), ...entries.map((entry) => JSON.stringify(entry)), ""].join("\n");
-        getFileSystemResultOrThrow(await this.fs.writeFile(path, content), `Failed to create session ${path}`);
-        const storedEntries = [...entries];
-        this.entriesByPath.set(path, storedEntries);
-        this.entryIdsByPath.set(path, new Set(storedEntries.map((entry) => entry.id)));
-        this.operationKeysByPath.set(path, descriptor.operationKey);
-        return this.reader(metadataFromHeader(header, path));
-    }
-    reader(metadata) {
-        const reader = createArraySessionReader(metadata, () => {
-            const entries = this.entriesByPath.get(metadata.path);
-            if (!entries)
-                throw new SessionError("not_found", `Session not found: ${metadata.path}`);
-            return entries;
-        });
-        const operationKey = this.operationKey(metadata);
-        return {
-            metadata: reader.metadata,
-            readHead: () => {
-                this.assertOpen();
-                return this.operations.enqueue(operationKey, () => reader.readHead());
-            },
-            readEntry: (id) => {
-                this.assertOpen();
-                return this.operations.enqueue(operationKey, () => reader.readEntry(id));
-            },
-            readEntries: (options) => {
-                this.assertOpen();
-                return this.operations.enqueue(operationKey, () => reader.readEntries(options));
-            },
-            readPathToRootOrCompaction: (leafId) => {
-                this.assertOpen();
-                return this.operations.enqueue(operationKey, () => reader.readPathToRootOrCompaction(leafId));
-            },
-        };
-    }
-    async getSessionsRoot() {
-        this.sessionsRoot ??= getFileSystemResultOrThrow(await this.fs.absolutePath(this.sessionsRootInput), `Failed to resolve sessions root ${this.sessionsRootInput}`);
-        return this.sessionsRoot;
-    }
-    async getSessionDir(cwd) {
-        return getFileSystemResultOrThrow(await this.fs.joinPath([await this.getSessionsRoot(), encodeCwd(cwd)]), `Failed to resolve session directory for ${cwd}`);
-    }
-    async listSessionDirs() {
-        const root = await this.getSessionsRoot();
-        if (!getFileSystemResultOrThrow(await this.fs.exists(root), `Failed to check sessions root ${root}`))
-            return [];
-        return getFileSystemResultOrThrow(await this.fs.listDir(root), `Failed to list sessions root ${root}`)
-            .filter((entry) => entry.kind === "directory")
-            .map((entry) => entry.path);
-    }
-}
-export function createJsonlSessionStore(options) {
-    return new JsonlSessionStore(options);
-}
-//# sourceMappingURL=jsonl-store.js.map