@zaly/agent 0.1.1 → 0.2.0

package/dist/{masker-DEgR_ntk.mjs.map → masker-B97uwYXG.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"masker-DEgR_ntk.mjs","names":["defaults"],"sources":["../src/context/scoring.ts","../src/masker.ts"],"sourcesContent":["// ── Frecency tuning ───────────────────────────────────────────────────\n// Half-life measured in assistant turns, not wall time — what matters for\n// compaction context is what's been hot in the agent's *recent\n// experience*, regardless of how long the user spent between turns.\n// 60 turns is a middle ground: actively-iterated work stays at the top\n// while recurring workflow patterns (git stash, test-runner flags) still\n// clear the minScore filter instead of getting buried under one-shot\n\nimport type {\n  AnyPart,\n  Message,\n  MetaPart,\n  ParamsOf,\n  Role,\n  SafeParamsOf,\n  Tool,\n  ToolCallPart,\n  ToolResultPart,\n} from \"@zaly/ai\"\nimport type { BashTool } from \"../tools/bash.ts\"\nimport type { EditTool, EditToolMeta } from \"../tools/edit.ts\"\nimport type { ReadTool, ReadToolMeta } from \"../tools/read.ts\"\nimport type { AnyTool } from \"../tools/registry.ts\"\nimport type { WriteTool, WriteToolMeta } from \"../tools/write.ts\"\n\nimport { isAttachment, safeParseToolParams } from \"@zaly/ai\"\nimport { safeStringify } from \"@zaly/shared\"\n\nconst DEFAULT_HALF_LIFE = 40\nconst DEFAULT_WEIGHT = 1\nconst DEFAULT_GAMMA = 0.5\n\nconst maskedMeta = (result = \"result\", action = \"call\"): MetaPart => ({\n  content: `Masked ${result}. Re-${action} to refresh`,\n  tag: \"masked\",\n  type: \"meta\",\n})\n\nexport type MsgPart<R extends Role = Role, P extends AnyPart = AnyPart> = {\n  message: Message<R>\n  part: P\n  score: number\n  turn: number\n  $m: number\n  $p: number\n}\n\nexport type MaskGroup<P extends MsgPart = MsgPart> = {\n  id: string\n  key: string\n  policy: MaskPolicy<P, MaskGroup<P>>\n  parts: P[]\n}\n\nexport type MaskRule<P extends MsgPart = MsgPart, G extends MaskGroup<P> = MaskGroup<P>> = {\n  filter?: (part: MsgPart) => boolean\n  id?: (part: P) => string | undefined\n  update?: (group: G, part: P) => void\n  gamma?: number | ((group: G) => number | undefined)\n  halfLife?: number | ((group: G) => number | undefined)\n  key?: \"id\" | ((group: G) => string | undefined)\n  weight?: number | ((group: G) => number | undefined)\n  mask: (part: P, group: G) => AnyPart\n}\n\nexport type ToolPart<T extends Tool = Tool, M extends object = object> = MsgPart<\n  \"assistant\" | \"tool\" | \"system\",\n  ToolCallPart<T[\"name\"], ParamsOf<T>> | ToolResultPart<T[\"name\"], M>\n>\n\nexport type ToolGroup<T extends Tool = Tool, M extends object = object> = MaskGroup<\n  ToolPart<T, M>\n> & {\n  name: T[\"name\"]\n  params: SafeParamsOf<T>\n  call?: ToolCallPart<T[\"name\"], ParamsOf<T>>\n  result?: ToolResultPart<T[\"name\"], M>\n}\n\nexport type ToolRule<T extends Tool = Tool, M extends object = object> =\n  | MaskRule<ToolPart<T, M>, ToolGroup<T, M>>\n  | {\n      key?: \"name\" | \"params\" | \"id\" | ((tool: ToolGroup<T, M>) => string | undefined)\n    }\n\nclass MaskPolicy<\n  P extends MsgPart = MsgPart,\n  G extends MaskGroup<P> = MaskGroup<P>,\n> implements Required<MaskRule<P, G>> {\n  #rule: MaskRule<P, G>\n\n  constructor(rule: MaskRule<P, G>) {\n    this.#rule = rule\n  }\n\n  update(group: G, part: P): void {\n    group.parts.push(part)\n    this.#rule.update?.(group, part)\n  }\n\n  mask(part: P, group: G): AnyPart {\n    return this.#rule.mask(part, group)\n  }\n\n  filter(part: MsgPart): boolean {\n    return this.#rule.filter?.(part) ?? true\n  }\n\n  id(part: P): string {\n    return this.#rule.id?.(part) ?? `${part.$m}:${part.$p}`\n  }\n\n  halfLife(group: G): number {\n    const halfLife = this.#rule.halfLife ?? DEFAULT_HALF_LIFE\n    return typeof halfLife === \"number\" ? halfLife : (halfLife(group) ?? DEFAULT_HALF_LIFE)\n  }\n\n  lambda(group: G): number {\n    return Math.LN2 / this.halfLife(group)\n  }\n\n  weight(group: G): number {\n    const weight = this.#rule.weight ?? DEFAULT_WEIGHT\n    return typeof weight === \"number\" ? weight : (weight(group) ?? DEFAULT_WEIGHT)\n  }\n\n  gamma(group: G): number {\n    const gamma = this.#rule.gamma ?? DEFAULT_GAMMA\n    return typeof gamma === \"number\" ? gamma : (gamma(group) ?? DEFAULT_GAMMA)\n  }\n\n  key(group: G): string {\n    const key = this.#rule.key ?? \"id\"\n    if (key === \"id\") return group.id\n    else if (typeof key === \"function\") return key(group) ?? group.id\n    return group.id\n  }\n}\n\nclass ToolPolicy<T extends Tool = Tool, M extends object = object> extends MaskPolicy<\n  ToolPart<T, M>,\n  ToolGroup<T, M>\n> {\n  constructor(name: string, rule: ToolRule<T, M>) {\n    super({\n      filter: (part) =>\n        (part.part.type === \"tool-call\" || part.part.type === \"tool-result\") &&\n        (part.part.name === name || name === \"*\"),\n      id: (part) => part.part.id,\n      mask: (part, group) => {\n        if (part.part.type === \"tool-call\")\n          return {\n            ...part.part,\n            params: { masked: truncate(safeStringify(group.params), 100) },\n          }\n        return { ...part.part, content: [maskedMeta()] }\n      },\n      update: (group, part) => {\n        group.name = name\n        if (part.part.type === \"tool-call\") {\n          group.call = part.part\n          group.params = safeParseToolParams(part.part.params)\n        }\n        if (part.part.type === \"tool-result\") group.result = part.part\n      },\n      ...rule,\n      key: (group) => {\n        const key = rule.key ?? \"params\"\n        if (key === \"name\") return group.name\n        if (key === \"params\" && group.params !== undefined) return safeStringify(group.params)\n        if (key === \"id\") return group.id\n        if (typeof key === \"function\") return key(group)\n        return group.id\n      },\n    })\n  }\n}\n\nfunction truncate(text: string, len: number): string {\n  return text.length <= len ? text : `${text.slice(0, len)}…`\n}\n\nconst fileScore: ToolRule<\n  ReadTool | WriteTool | EditTool,\n  ReadToolMeta | WriteToolMeta | EditToolMeta\n> = {\n  gamma: (t) => {\n    if (t.name === \"write\") return 0.45\n    if (t.name === \"edit\") return 0.65\n    if (t.result?.meta?.full) return 0.75\n    return 0.95\n  },\n  halfLife: (t) => {\n    if (t.name === \"write\") return 90\n    if (t.name === \"edit\") return 75\n    if (t.result?.meta?.full) return 60\n    return 50 // partial read\n  },\n  key: (t) => `file:${t.result?.meta?.path ?? t.id}`,\n  mask: (part) => {\n    if (part.part.type === \"tool-call\")\n      return {\n        ...part.part,\n        params: { masked: true, path: part.part.params.path },\n      }\n    return part.part.isError ? part.part : { ...part.part, content: [maskedMeta()] }\n  },\n  weight: (t) => {\n    if (t.name === \"write\") return 1.25\n    if (t.name === \"edit\") return 1.2\n    if (t.result?.meta?.full) return 1.1\n    return 1\n  },\n}\n\nexport type ContextScoringOptions = {\n  tools?: Record<AnyTool | \"*\", ToolRule>\n  parts?: MaskRule[]\n}\n\nconst defaults: ContextScoringOptions = {\n  parts: [\n    {\n      filter: (part) => isAttachment(part.part),\n      mask: (part) => maskedMeta(part.part.type, \"attach\"),\n    },\n    {\n      filter: (part) => part.message.role === \"system\" && part.message.meta?.kind === \"task\",\n      halfLife: 25,\n      mask: (part) => {\n        if (part.part.type === \"meta\") return part.part\n        return maskedMeta(\"task\")\n      },\n    },\n  ],\n  // oxlint-disable-next-line sort-keys\n  tools: {\n    bash: {\n      gamma: 0.35,\n      halfLife: 25,\n      key: (t: ToolGroup<BashTool>) => `bash:${t.params?.command?.replace(/\\s+/g, \" \") ?? t.id}`,\n    },\n    find: { gamma: 0.7, halfLife: 35 },\n    grep: { gamma: 0.7, halfLife: 35 },\n    search: { gamma: 0.5, halfLife: 40 },\n\n    read: fileScore,\n    edit: fileScore,\n    write: fileScore,\n\n    \"*\": { gamma: 0.5, halfLife: 40 },\n  } as Record<AnyTool | \"*\", ToolRule>,\n}\n\nexport class ContextScoring {\n  #groups = new Map<string, MaskGroup>()\n  #messages: readonly Message[] = []\n  #policies: MaskPolicy[] = []\n\n  constructor(opts: ContextScoringOptions = {}) {\n    const tools = { ...defaults.tools, ...opts.tools }\n    for (const [name, tool] of Object.entries(tools)) {\n      this.#policies.push(new ToolPolicy(name, tool) as MaskPolicy)\n    }\n    for (const rule of [...(defaults.parts ?? []), ...(opts.parts ?? [])]) {\n      this.#policies.push(new MaskPolicy(rule))\n    }\n  }\n\n  #reset() {\n    this.#groups.clear()\n  }\n\n  #index() {\n    let turn = 0\n    for (let $m = this.#messages.length - 1; $m >= 0; $m--) {\n      const m = this.#messages[$m]\n      if (m.role === \"assistant\") turn++\n\n      if (!Array.isArray(m.content)) continue\n\n      for (let $p = m.content.length - 1; $p >= 0; $p--) {\n        const part: MsgPart = { $m, $p, message: m, part: m.content[$p], score: 0, turn }\n        const policy = this.#policy(part)\n        if (!policy) continue\n        const id = policy.id(part)\n        const group = this.#groups.get(id) ?? { id, key: \"\", parts: [], policy }\n        policy.update(group, part)\n        this.#groups.set(id, group)\n      }\n    }\n  }\n\n  #policy(part: MsgPart): MaskPolicy | undefined {\n    return this.#policies.find((policy) => policy.filter(part))\n  }\n\n  score(messages: readonly Message[]): MaskGroup[] {\n    this.#reset()\n    this.#messages = messages\n    this.#index()\n    // tools sorted by recency\n    const groups = [...this.#groups.values()]\n    const gammas = new Map<string, number>()\n    for (const group of groups) {\n      const key = group.policy.key(group)\n      group.key = key\n      const weight = group.policy.weight(group)\n      const shadow = gammas.get(key) ?? 1\n      const lambda = group.policy.lambda(group)\n      for (const part of group.parts) {\n        const decay = Math.exp(-lambda * part.turn)\n        part.score = decay * weight * shadow\n      }\n      gammas.set(key, shadow * group.policy.gamma(group))\n    }\n    return groups\n  }\n}\n","import type { AnyPart, Message, Role, Tool } from \"@zaly/ai\"\nimport type { MaybeGetter } from \"@zaly/shared\"\nimport type { Agent } from \"./agent.ts\"\nimport type { MsgPart } from \"./context/scoring.ts\"\nimport type { Session } from \"./session/session.ts\"\n\nimport { toValue } from \"@zaly/shared\"\nimport { ContextScoring } from \"./context/scoring.ts\"\nimport { estimatePart, tokenStats } from \"./context/tokens.ts\"\n\n/** Top-level masking config. */\nexport type MaskerOptions = {\n  enabled?: boolean\n  /** Don't mask tool-result parts whose original content is shorter\n   *  than this (estimated tokens). Skips tiny \"ok\"-style success\n   *  messages where the stub would be larger than the original.\n   *  Doesn't apply to attachments (always worth masking). */\n  minTokens?: number\n  /** How many turns to keep in the tail of the conversation, regardless\n   *  of score. Defaults to 20. */\n  keepTurns?: number\n  /** How far above the target ratio to trigger a new masking pass.\n   *  Defaults to 0.25 (25%). */\n  delta?: number\n  /** Target ratio of used/limit tokens to reach by masking. Defaults to 0.5 (50%). */\n  target?: number\n}\n\nexport type MaskOpts = {\n  force?: boolean\n  limit?: number\n  ratio?: number\n  tools?: Tool[]\n  prompt?: string[]\n}\n\nconst defaults = {\n  delta: 0.25,\n  enabled: true,\n  keepTurns: 40,\n  minTokens: 50,\n  target: 0.5,\n} as const satisfies Required<MaskerOptions>\n\n/** In-place mask projection for the request stream.\n *\n *  The masker replaces low-value parts with stable stubs to keep the\n *  projected request within budget. A scoring pass ranks maskable parts\n *  by recency, repeated-use shadowing, and per-policy weights; the budget\n *  pass masks from lowest score upward until the target is reached or no\n *  useful candidates remain.\n *\n *  Masking intentionally happens rarely because it changes historical\n *  bytes and busts prefix cache. The first pass after startup/session\n *  reset always rebuilds the projection. Later passes use a hysteresis\n *  threshold: mask toward `target`, then trigger again at roughly\n *  `actual + delta`. If the target cannot be reached, the next threshold\n *  rises automatically to avoid repeated no-op cache busts.\n */\nexport class Masker {\n  #o: MaybeGetter<MaskerOptions>\n  #stats = new Map<Role, Record<string, number>>()\n  #masked = new Map<string, Map<number, AnyPart>>()\n  #threshold?: number\n  #agent: Agent\n\n  constructor(agent: Agent, opts: MaybeGetter<MaskerOptions> = {}) {\n    this.#o = opts\n    this.#agent = agent\n    agent.on(\"context\", async (ctx) => (ctx.messages = await this.mask(ctx.messages)))\n    agent.ctx.on(\"session\", () => this.reset())\n  }\n\n  get #opts(): Required<MaskerOptions> {\n    return { ...defaults, ...toValue(this.#o) }\n  }\n\n  get enabled(): boolean {\n    return this.#opts.enabled\n  }\n\n  get #session(): Session {\n    return this.#agent.session\n  }\n\n  #maskOpts(opts?: MaskOpts): Required<MaskOpts> {\n    const pressure = this.#agent.pressure\n    return {\n      force: false,\n      limit: pressure.limit,\n      prompt: this.#agent.prompt,\n      ratio: pressure.ratio,\n      tools: this.#agent.tools,\n      ...opts,\n    }\n  }\n\n  reset(): void {\n    this.#masked.clear()\n    this.#stats.clear()\n    this.#threshold = undefined\n  }\n\n  get stats(): Map<Role, Record<string, number>> {\n    return this.#stats\n  }\n\n  /** Number of messages with at least one masked part. */\n  get masked(): number {\n    return this.#masked.size\n  }\n\n  isMasked(msgId: string, partIdx?: number): boolean {\n    if (!this.enabled) return false\n    const parts = this.#masked.get(msgId)\n    if (parts === undefined) return false\n    return partIdx === undefined ? parts.size > 0 : parts.has(partIdx)\n  }\n\n  /** Apply masks and return the projected message array.\n   *\n   *  Always rebuild once after startup/session reset: `pressure.ratio`\n   *  may describe a previously masked projection, while this instance has\n   *  no mask decisions yet. After that, rebuild only when projected\n   *  pressure crosses the hysteresis threshold. */\n  async mask(messages: readonly Message[], opts?: MaskOpts): Promise<Message[]> {\n    if (!this.enabled || messages.length === 0) return [...messages]\n\n    const resolved = this.#maskOpts(opts)\n\n    // Masker has not yet been initialized for this session.\n    // Use the session's mask checkpoint to restore the last threshold\n    // and rebuild the mask decisions up to that point.\n    if (this.#threshold === undefined) {\n      const cp = this.#session.maskCheckpoint\n      if (!cp) {\n        // No checkpoint means the session has never been masked before, so\n        // just set to the default threshold for the first pass, so that the next pass will\n        // trigger only if the pressure exceeds the target + delta.\n        this.#threshold = this.#opts.target + this.#opts.delta\n      } else {\n        this.#threshold = cp.threshold\n        const idx = messages.findIndex((m) => m.id === cp.messageId)\n        // NOTE: the checkpoint message should exists. If not mask all, just in case\n        // Rebuild the mask decisions\n        this.#update(idx === -1 ? messages : messages.slice(0, idx + 1), resolved)\n      }\n    }\n\n    // If the current pressure ratio exceeds the threshold, rebuild the mask decisions.\n    if (resolved.ratio >= this.#threshold || resolved.force) {\n      const messageId = messages.at(-1)?.id\n      if (!messageId) throw new Error(\"Message in masker without ID. Should never happen.\")\n      // Create a checkpoint first, with the CURRENT threshold, not the new one.\n      await this.#session.addMaskCheckpoint({\n        messageId,\n        threshold: this.#threshold,\n      })\n      this.#update(messages, resolved)\n    }\n    return this.#mask(messages)\n  }\n\n  #stat(role: Role, key: string, n = 1): void {\n    const r = this.#stats.get(role) ?? {}\n    r[key] = (r[key] ?? 0) + n\n    this.#stats.set(role, r)\n  }\n\n  /** Recompute mask decisions for the current message history. */\n  #update(messages: readonly Message[], opts: Required<MaskOpts>): void {\n    this.#masked.clear()\n    this.#stats.clear()\n    this.#threshold = this.#opts.target + this.#opts.delta\n    const usage = tokenStats(messages, { prompt: opts.prompt, tools: opts.tools })\n    // `pressure.ratio` is based on the current projected/masked request,\n    // not the raw session. Raw history may exceed model context; masking\n    // only needs to keep the projected request in a safe band.\n    const targetRatio = Math.max(this.#opts.target, this.#threshold - this.#opts.delta)\n    const target = opts.limit * targetRatio\n\n    // Return when already under target.\n    if (usage.tokens <= target) return\n\n    let mask = usage.tokens - target\n\n    if (mask === 0) return\n\n    const scorer = new ContextScoring()\n    const scores = scorer.score(messages)\n    const parts: (MsgPart & { mask: () => AnyPart })[] = []\n    for (const s of scores) {\n      for (const p of s.parts) {\n        parts.push({\n          ...p,\n          mask: () => s.policy.mask(p, s),\n        })\n      }\n    }\n    parts.sort((a, b) => a.score - b.score)\n\n    let masked = 0\n    for (const p of parts) {\n      if (mask <= 0) break\n      const id = p.message.id\n      if (!id) continue\n\n      if (p.turn <= this.#opts.keepTurns) continue\n\n      const tokens = estimatePart(p.part).tokens\n      if (tokens < this.#opts.minTokens) continue\n\n      const part = p.mask()\n      if (part === p.part) continue\n\n      const msgParts = this.#masked.get(id) ?? new Map()\n      msgParts.set(p.$p, part)\n      this.#stat(\n        p.message.role,\n        `${p.part.type}${p.part.type === \"tool-result\" || p.part.type === \"tool-call\" ? `:${p.part.name}` : \"\"}`\n      )\n      this.#masked.set(id, msgParts)\n      const delta = tokens - estimatePart(part).tokens\n      masked += delta\n      mask -= delta\n    }\n\n    this.#threshold = Math.max(\n      (usage.tokens - masked) / opts.limit + this.#opts.delta,\n      this.#opts.target + this.#opts.delta\n    )\n  }\n\n  /** Render the current projection using the last computed mask decisions. */\n  #mask(messages: readonly Message[]): Message[] {\n    return messages.map((m) => {\n      if (m.id === undefined || typeof m.content === \"string\") return m\n      const masked = m.id ? this.#masked.get(m.id) : undefined\n      return masked && masked.size > 0\n        ? ({\n            ...m,\n            content: m.content.map((p, i) => masked.get(i) ?? p),\n          } as Message)\n        : m\n    })\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"masker-B97uwYXG.mjs","names":["defaults"],"sources":["../src/context/scoring.ts","../src/masker.ts"],"sourcesContent":["// ── Frecency tuning ───────────────────────────────────────────────────\n// Half-life measured in assistant turns, not wall time — what matters for\n// compaction context is what's been hot in the agent's *recent\n// experience*, regardless of how long the user spent between turns.\n// 60 turns is a middle ground: actively-iterated work stays at the top\n// while recurring workflow patterns (git stash, test-runner flags) still\n// clear the minScore filter instead of getting buried under one-shot\n\nimport type {\n  AnyPart,\n  Message,\n  MetaPart,\n  ParamsOf,\n  Role,\n  SafeParamsOf,\n  Tool,\n  ToolCallPart,\n  ToolResultPart,\n} from \"@zaly/ai\"\nimport type { BashTool } from \"../tools/bash.ts\"\nimport type { EditTool, EditToolMeta } from \"../tools/edit.ts\"\nimport type { ReadTool, ReadToolMeta } from \"../tools/read.ts\"\nimport type { AnyTool } from \"../tools/registry.ts\"\nimport type { WriteTool, WriteToolMeta } from \"../tools/write.ts\"\n\nimport { isAttachment, safeParseToolParams } from \"@zaly/ai\"\nimport { safeStringify } from \"@zaly/shared\"\n\nconst DEFAULT_HALF_LIFE = 40\nconst DEFAULT_WEIGHT = 1\nconst DEFAULT_GAMMA = 0.5\n\nconst maskedMeta = (result = \"result\", action = \"call\"): MetaPart => ({\n  content: `Masked ${result}. Re-${action} to refresh`,\n  tag: \"masked\",\n  type: \"meta\",\n})\n\nexport type MsgPart<R extends Role = Role, P extends AnyPart = AnyPart> = {\n  message: Message<R>\n  part: P\n  score: number\n  turn: number\n  $m: number\n  $p: number\n}\n\nexport type MaskGroup<P extends MsgPart = MsgPart> = {\n  id: string\n  key: string\n  policy: MaskPolicy<P, MaskGroup<P>>\n  parts: P[]\n}\n\nexport type MaskRule<P extends MsgPart = MsgPart, G extends MaskGroup<P> = MaskGroup<P>> = {\n  filter?: (part: MsgPart) => boolean\n  id?: (part: P) => string | undefined\n  update?: (group: G, part: P) => void\n  gamma?: number | ((group: G) => number | undefined)\n  halfLife?: number | ((group: G) => number | undefined)\n  key?: \"id\" | ((group: G) => string | undefined)\n  weight?: number | ((group: G) => number | undefined)\n  mask: (part: P, group: G) => AnyPart\n}\n\nexport type ToolPart<T extends Tool = Tool, M extends object = object> = MsgPart<\n  \"assistant\" | \"tool\" | \"system\",\n  ToolCallPart<T[\"name\"], ParamsOf<T>> | ToolResultPart<T[\"name\"], M>\n>\n\nexport type ToolGroup<T extends Tool = Tool, M extends object = object> = MaskGroup<\n  ToolPart<T, M>\n> & {\n  name: T[\"name\"]\n  params: SafeParamsOf<T>\n  call?: ToolCallPart<T[\"name\"], ParamsOf<T>>\n  result?: ToolResultPart<T[\"name\"], M>\n}\n\nexport type ToolRule<T extends Tool = Tool, M extends object = object> =\n  | MaskRule<ToolPart<T, M>, ToolGroup<T, M>>\n  | {\n      key?: \"name\" | \"params\" | \"id\" | ((tool: ToolGroup<T, M>) => string | undefined)\n    }\n\nclass MaskPolicy<\n  P extends MsgPart = MsgPart,\n  G extends MaskGroup<P> = MaskGroup<P>,\n> implements Required<MaskRule<P, G>> {\n  #rule: MaskRule<P, G>\n\n  constructor(rule: MaskRule<P, G>) {\n    this.#rule = rule\n  }\n\n  update(group: G, part: P): void {\n    group.parts.push(part)\n    this.#rule.update?.(group, part)\n  }\n\n  mask(part: P, group: G): AnyPart {\n    return this.#rule.mask(part, group)\n  }\n\n  filter(part: MsgPart): boolean {\n    return this.#rule.filter?.(part) ?? true\n  }\n\n  id(part: P): string {\n    return this.#rule.id?.(part) ?? `${part.$m}:${part.$p}`\n  }\n\n  halfLife(group: G): number {\n    const halfLife = this.#rule.halfLife ?? DEFAULT_HALF_LIFE\n    return typeof halfLife === \"number\" ? halfLife : (halfLife(group) ?? DEFAULT_HALF_LIFE)\n  }\n\n  lambda(group: G): number {\n    return Math.LN2 / this.halfLife(group)\n  }\n\n  weight(group: G): number {\n    const weight = this.#rule.weight ?? DEFAULT_WEIGHT\n    return typeof weight === \"number\" ? weight : (weight(group) ?? DEFAULT_WEIGHT)\n  }\n\n  gamma(group: G): number {\n    const gamma = this.#rule.gamma ?? DEFAULT_GAMMA\n    return typeof gamma === \"number\" ? gamma : (gamma(group) ?? DEFAULT_GAMMA)\n  }\n\n  key(group: G): string {\n    const key = this.#rule.key ?? \"id\"\n    if (key === \"id\") return group.id\n    else if (typeof key === \"function\") return key(group) ?? group.id\n    return group.id\n  }\n}\n\nclass ToolPolicy<T extends Tool = Tool, M extends object = object> extends MaskPolicy<\n  ToolPart<T, M>,\n  ToolGroup<T, M>\n> {\n  constructor(name: string, rule: ToolRule<T, M>) {\n    super({\n      filter: (part) =>\n        (part.part.type === \"tool-call\" || part.part.type === \"tool-result\") &&\n        (part.part.name === name || name === \"*\"),\n      id: (part) => part.part.id,\n      mask: (part, group) => {\n        if (part.part.type === \"tool-call\")\n          return {\n            ...part.part,\n            params: { masked: truncate(safeStringify(group.params), 100) },\n          }\n        return { ...part.part, content: [maskedMeta()] }\n      },\n      update: (group, part) => {\n        group.name = name\n        if (part.part.type === \"tool-call\") {\n          group.call = part.part\n          group.params = safeParseToolParams(part.part.params)\n        }\n        if (part.part.type === \"tool-result\") group.result = part.part\n      },\n      ...rule,\n      key: (group) => {\n        const key = rule.key ?? \"params\"\n        if (key === \"name\") return group.name\n        if (key === \"params\" && group.params !== undefined) return safeStringify(group.params)\n        if (key === \"id\") return group.id\n        if (typeof key === \"function\") return key(group)\n        return group.id\n      },\n    })\n  }\n}\n\nfunction truncate(text: string, len: number): string {\n  return text.length <= len ? text : `${text.slice(0, len)}…`\n}\n\nconst fileScore: ToolRule<\n  ReadTool | WriteTool | EditTool,\n  ReadToolMeta | WriteToolMeta | EditToolMeta\n> = {\n  gamma: (t) => {\n    if (t.name === \"write\") return 0.45\n    if (t.name === \"edit\") return 0.65\n    if (t.result?.meta?.full) return 0.75\n    return 0.95\n  },\n  halfLife: (t) => {\n    if (t.name === \"write\") return 90\n    if (t.name === \"edit\") return 75\n    if (t.result?.meta?.full) return 60\n    return 50 // partial read\n  },\n  key: (t) => `file:${t.result?.meta?.path ?? t.id}`,\n  mask: (part) => {\n    if (part.part.type === \"tool-call\")\n      return {\n        ...part.part,\n        params: { masked: true, path: part.part.params.path },\n      }\n    return part.part.isError ? part.part : { ...part.part, content: [maskedMeta()] }\n  },\n  weight: (t) => {\n    if (t.name === \"write\") return 1.25\n    if (t.name === \"edit\") return 1.2\n    if (t.result?.meta?.full) return 1.1\n    return 1\n  },\n}\n\nexport type ContextScoringOptions = {\n  tools?: Record<AnyTool | \"*\", ToolRule>\n  parts?: MaskRule[]\n}\n\nconst defaults: ContextScoringOptions = {\n  parts: [\n    {\n      filter: (part) => isAttachment(part.part),\n      mask: (part) => maskedMeta(part.part.type, \"attach\"),\n    },\n    {\n      filter: (part) => part.message.role === \"system\" && part.message.meta?.kind === \"task\",\n      halfLife: 25,\n      mask: (part) => {\n        if (part.part.type === \"meta\") return part.part\n        return maskedMeta(\"task\")\n      },\n    },\n  ],\n  // oxlint-disable-next-line sort-keys\n  tools: {\n    bash: {\n      gamma: 0.35,\n      halfLife: 25,\n      key: (t: ToolGroup<BashTool>) => `bash:${t.params?.command?.replace(/\\s+/g, \" \") ?? t.id}`,\n    },\n    find: { gamma: 0.7, halfLife: 35 },\n    grep: { gamma: 0.7, halfLife: 35 },\n    search: { gamma: 0.5, halfLife: 40 },\n\n    read: fileScore,\n    edit: fileScore,\n    write: fileScore,\n\n    \"*\": { gamma: 0.5, halfLife: 40 },\n  } as Record<AnyTool | \"*\", ToolRule>,\n}\n\nexport class ContextScoring {\n  #groups = new Map<string, MaskGroup>()\n  #messages: readonly Message[] = []\n  #policies: MaskPolicy[] = []\n\n  constructor(opts: ContextScoringOptions = {}) {\n    const tools = { ...defaults.tools, ...opts.tools }\n    for (const [name, tool] of Object.entries(tools)) {\n      this.#policies.push(new ToolPolicy(name, tool) as MaskPolicy)\n    }\n    for (const rule of [...(defaults.parts ?? []), ...(opts.parts ?? [])]) {\n      this.#policies.push(new MaskPolicy(rule))\n    }\n  }\n\n  #reset() {\n    this.#groups.clear()\n  }\n\n  #index() {\n    let turn = 0\n    for (let $m = this.#messages.length - 1; $m >= 0; $m--) {\n      const m = this.#messages[$m]\n      if (m.role === \"assistant\") turn++\n\n      if (!Array.isArray(m.content)) continue\n\n      for (let $p = m.content.length - 1; $p >= 0; $p--) {\n        const part: MsgPart = { $m, $p, message: m, part: m.content[$p], score: 0, turn }\n        const policy = this.#policy(part)\n        if (!policy) continue\n        const id = policy.id(part)\n        const group = this.#groups.get(id) ?? { id, key: \"\", parts: [], policy }\n        policy.update(group, part)\n        this.#groups.set(id, group)\n      }\n    }\n  }\n\n  #policy(part: MsgPart): MaskPolicy | undefined {\n    return this.#policies.find((policy) => policy.filter(part))\n  }\n\n  score(messages: readonly Message[]): MaskGroup[] {\n    this.#reset()\n    this.#messages = messages\n    this.#index()\n    // tools sorted by recency\n    const groups = [...this.#groups.values()]\n    const gammas = new Map<string, number>()\n    for (const group of groups) {\n      const key = group.policy.key(group)\n      group.key = key\n      const weight = group.policy.weight(group)\n      const shadow = gammas.get(key) ?? 1\n      const lambda = group.policy.lambda(group)\n      for (const part of group.parts) {\n        const decay = Math.exp(-lambda * part.turn)\n        part.score = decay * weight * shadow\n      }\n      gammas.set(key, shadow * group.policy.gamma(group))\n    }\n    return groups\n  }\n}\n","import type { AnyPart, Message, Role, Tool } from \"@zaly/ai\"\nimport type { MaybeGetter } from \"@zaly/shared\"\nimport type { Agent } from \"./agent.ts\"\nimport type { MsgPart } from \"./context/scoring.ts\"\nimport type { Session } from \"./session/session.ts\"\n\nimport { toValue } from \"@zaly/shared\"\nimport { ContextScoring } from \"./context/scoring.ts\"\nimport { estimatePart, tokenStats } from \"./context/tokens.ts\"\n\n/** Top-level masking config. */\nexport type MaskerOptions = {\n  enabled?: boolean\n  /** Don't mask tool-result parts whose original content is shorter\n   *  than this (estimated tokens). Skips tiny \"ok\"-style success\n   *  messages where the stub would be larger than the original.\n   *  Doesn't apply to attachments (always worth masking). */\n  minTokens?: number\n  /** How many turns to keep in the tail of the conversation, regardless\n   *  of score. Defaults to 20. */\n  keepTurns?: number\n  /** How far above the target ratio to trigger a new masking pass.\n   *  Defaults to 0.25 (25%). */\n  delta?: number\n  /** Target ratio of used/limit tokens to reach by masking. Defaults to 0.5 (50%). */\n  target?: number\n}\n\nexport type MaskOpts = {\n  force?: boolean\n  limit?: number\n  ratio?: number\n  tools?: Tool[]\n  prompt?: string[]\n}\n\nconst defaults = {\n  delta: 0.25,\n  enabled: true,\n  keepTurns: 40,\n  minTokens: 50,\n  target: 0.5,\n} as const satisfies Required<MaskerOptions>\n\n/** In-place mask projection for the request stream.\n *\n *  The masker replaces low-value parts with stable stubs to keep the\n *  projected request within budget. A scoring pass ranks maskable parts\n *  by recency, repeated-use shadowing, and per-policy weights; the budget\n *  pass masks from lowest score upward until the target is reached or no\n *  useful candidates remain.\n *\n *  Masking intentionally happens rarely because it changes historical\n *  bytes and busts prefix cache. The first pass after startup/session\n *  reset always rebuilds the projection. Later passes use a hysteresis\n *  threshold: mask toward `target`, then trigger again at roughly\n *  `actual + delta`. If the target cannot be reached, the next threshold\n *  rises automatically to avoid repeated no-op cache busts.\n */\nexport class Masker {\n  #o: MaybeGetter<MaskerOptions>\n  #stats = new Map<Role, Record<string, number>>()\n  #masked = new Map<string, Map<number, AnyPart>>()\n  #threshold?: number\n  #agent: Agent\n\n  constructor(agent: Agent, opts: MaybeGetter<MaskerOptions> = {}) {\n    this.#o = opts\n    this.#agent = agent\n    agent.on(\"context\", async (ctx) => (ctx.messages = await this.mask(ctx.messages)))\n    agent.ctx.on(\"session\", () => this.reset())\n  }\n\n  get #opts(): Required<MaskerOptions> {\n    return { ...defaults, ...toValue(this.#o) }\n  }\n\n  get enabled(): boolean {\n    return this.#opts.enabled\n  }\n\n  get #session(): Session {\n    return this.#agent.session\n  }\n\n  #maskOpts(opts?: MaskOpts): Required<MaskOpts> {\n    const pressure = this.#agent.pressure\n    return {\n      force: false,\n      limit: pressure.limit,\n      prompt: this.#agent.prompt,\n      ratio: pressure.ratio,\n      tools: this.#agent.tools,\n      ...opts,\n    }\n  }\n\n  reset(): void {\n    this.#masked.clear()\n    this.#stats.clear()\n    this.#threshold = undefined\n  }\n\n  get stats(): Map<Role, Record<string, number>> {\n    return this.#stats\n  }\n\n  /** Number of messages with at least one masked part. */\n  get masked(): number {\n    return this.#masked.size\n  }\n\n  isMasked(msgId: string, partIdx?: number): boolean {\n    if (!this.enabled) return false\n    const parts = this.#masked.get(msgId)\n    if (parts === undefined) return false\n    return partIdx === undefined ? parts.size > 0 : parts.has(partIdx)\n  }\n\n  /** Apply masks and return the projected message array.\n   *\n   *  Always rebuild once after startup/session reset: `pressure.ratio`\n   *  may describe a previously masked projection, while this instance has\n   *  no mask decisions yet. After that, rebuild only when projected\n   *  pressure crosses the hysteresis threshold. */\n  async mask(messages: readonly Message[], opts?: MaskOpts): Promise<Message[]> {\n    if (!this.enabled || messages.length === 0) return [...messages]\n\n    const resolved = this.#maskOpts(opts)\n\n    // Masker has not yet been initialized for this session.\n    // Use the session's mask checkpoint to restore the last threshold\n    // and rebuild the mask decisions up to that point.\n    if (this.#threshold === undefined) {\n      const cp = this.#session.maskCheckpoint\n      if (!cp) {\n        // No checkpoint means the session has never been masked before, so\n        // just set to the default threshold for the first pass, so that the next pass will\n        // trigger only if the pressure exceeds the target + delta.\n        this.#threshold = this.#opts.target + this.#opts.delta\n      } else {\n        this.#threshold = cp.threshold\n        const idx = messages.findIndex((m) => m.id === cp.messageId)\n        // NOTE: the checkpoint message should exists. If not mask all, just in case\n        // Rebuild the mask decisions\n        this.#update(idx === -1 ? messages : messages.slice(0, idx + 1), resolved)\n      }\n    }\n\n    // If the current pressure ratio exceeds the threshold, rebuild the mask decisions.\n    if (resolved.ratio >= this.#threshold || resolved.force) {\n      const messageId = messages.at(-1)?.id\n      if (!messageId) throw new Error(\"Message in masker without ID. Should never happen.\")\n      // Create a checkpoint first, with the CURRENT threshold, not the new one.\n      await this.#session.addMaskCheckpoint({\n        messageId,\n        threshold: this.#threshold,\n      })\n      this.#update(messages, resolved)\n    }\n    return this.#mask(messages)\n  }\n\n  #stat(role: Role, key: string, n = 1): void {\n    const r = this.#stats.get(role) ?? {}\n    r[key] = (r[key] ?? 0) + n\n    this.#stats.set(role, r)\n  }\n\n  /** Recompute mask decisions for the current message history. */\n  #update(messages: readonly Message[], opts: Required<MaskOpts>): void {\n    this.#masked.clear()\n    this.#stats.clear()\n    this.#threshold = this.#opts.target + this.#opts.delta\n    const usage = tokenStats(messages, { prompt: opts.prompt, tools: opts.tools })\n    // `pressure.ratio` is based on the current projected/masked request,\n    // not the raw session. Raw history may exceed model context; masking\n    // only needs to keep the projected request in a safe band.\n    const targetRatio = Math.max(this.#opts.target, this.#threshold - this.#opts.delta)\n    const target = opts.limit * targetRatio\n\n    // Return when already under target.\n    if (usage.tokens <= target) return\n\n    let mask = usage.tokens - target\n\n    if (mask === 0) return\n\n    const scorer = new ContextScoring()\n    const scores = scorer.score(messages)\n    const parts: (MsgPart & { mask: () => AnyPart })[] = []\n    for (const s of scores) {\n      for (const p of s.parts) {\n        parts.push({\n          ...p,\n          mask: () => s.policy.mask(p, s),\n        })\n      }\n    }\n    parts.sort((a, b) => a.score - b.score)\n\n    let masked = 0\n    for (const p of parts) {\n      if (mask <= 0) break\n      const id = p.message.id\n      if (!id) continue\n\n      if (p.turn <= this.#opts.keepTurns) continue\n\n      const tokens = estimatePart(p.part).tokens\n      if (tokens < this.#opts.minTokens) continue\n\n      const part = p.mask()\n      if (part === p.part) continue\n\n      const msgParts = this.#masked.get(id) ?? new Map()\n      msgParts.set(p.$p, part)\n      this.#stat(\n        p.message.role,\n        `${p.part.type}${p.part.type === \"tool-result\" || p.part.type === \"tool-call\" ? `:${p.part.name}` : \"\"}`\n      )\n      this.#masked.set(id, msgParts)\n      const delta = tokens - estimatePart(part).tokens\n      masked += delta\n      mask -= delta\n    }\n\n    this.#threshold = Math.max(\n      (usage.tokens - masked) / opts.limit + this.#opts.delta,\n      this.#opts.target + this.#opts.delta\n    )\n  }\n\n  /** Render the current projection using the last computed mask decisions. */\n  #mask(messages: readonly Message[]): Message[] {\n    return messages.map((m) => {\n      if (m.id === undefined || typeof m.content === \"string\") return m\n      const masked = m.id ? this.#masked.get(m.id) : undefined\n      return masked && masked.size > 0\n        ? ({\n            ...m,\n            content: m.content.map((p, i) => masked.get(i) ?? p),\n          } as Message)\n        : m\n    })\n  }\n}\n"],"mappings":";;;;AA4BA,MAAM,oBAAoB;AAC1B,MAAM,iBAAiB;AACvB,MAAM,gBAAgB;AAEtB,MAAM,cAAc,SAAS,UAAU,SAAS,YAAsB;CACpE,SAAS,UAAU,OAAO,OAAO,OAAO;CACxC,KAAK;CACL,MAAM;AACR;AAiDA,IAAM,aAAN,MAGsC;CACpC;CAEA,YAAY,MAAsB;EAChC,KAAK,QAAQ;CACf;CAEA,OAAO,OAAU,MAAe;EAC9B,MAAM,MAAM,KAAK,IAAI;EACrB,KAAK,MAAM,SAAS,OAAO,IAAI;CACjC;CAEA,KAAK,MAAS,OAAmB;EAC/B,OAAO,KAAK,MAAM,KAAK,MAAM,KAAK;CACpC;CAEA,OAAO,MAAwB;EAC7B,OAAO,KAAK,MAAM,SAAS,IAAI,KAAK;CACtC;CAEA,GAAG,MAAiB;EAClB,OAAO,KAAK,MAAM,KAAK,IAAI,KAAK,GAAG,KAAK,GAAG,GAAG,KAAK;CACrD;CAEA,SAAS,OAAkB;EACzB,MAAM,WAAW,KAAK,MAAM,YAAY;EACxC,OAAO,OAAO,aAAa,WAAW,WAAY,SAAS,KAAK,KAAK;CACvE;CAEA,OAAO,OAAkB;EACvB,OAAO,KAAK,MAAM,KAAK,SAAS,KAAK;CACvC;CAEA,OAAO,OAAkB;EACvB,MAAM,SAAS,KAAK,MAAM,UAAU;EACpC,OAAO,OAAO,WAAW,WAAW,SAAU,OAAO,KAAK,KAAK;CACjE;CAEA,MAAM,OAAkB;EACtB,MAAM,QAAQ,KAAK,MAAM,SAAS;EAClC,OAAO,OAAO,UAAU,WAAW,QAAS,MAAM,KAAK,KAAK;CAC9D;CAEA,IAAI,OAAkB;EACpB,MAAM,MAAM,KAAK,MAAM,OAAO;EAC9B,IAAI,QAAQ,MAAM,OAAO,MAAM;OAC1B,IAAI,OAAO,QAAQ,YAAY,OAAO,IAAI,KAAK,KAAK,MAAM;EAC/D,OAAO,MAAM;CACf;AACF;AAEA,IAAM,aAAN,cAA2E,WAGzE;CACA,YAAY,MAAc,MAAsB;EAC9C,MAAM;GACJ,SAAS,UACN,KAAK,KAAK,SAAS,eAAe,KAAK,KAAK,SAAS,mBACrD,KAAK,KAAK,SAAS,QAAQ,SAAS;GACvC,KAAK,SAAS,KAAK,KAAK;GACxB,OAAO,MAAM,UAAU;IACrB,IAAI,KAAK,KAAK,SAAS,aACrB,OAAO;KACL,GAAG,KAAK;KACR,QAAQ,EAAE,QAAQ,SAAS,cAAc,MAAM,MAAM,GAAG,GAAG,EAAE;IAC/D;IACF,OAAO;KAAE,GAAG,KAAK;KAAM,SAAS,CAAC,WAAW,CAAC;IAAE;GACjD;GACA,SAAS,OAAO,SAAS;IACvB,MAAM,OAAO;IACb,IAAI,KAAK,KAAK,SAAS,aAAa;KAClC,MAAM,OAAO,KAAK;KAClB,MAAM,SAAS,oBAAoB,KAAK,KAAK,MAAM;IACrD;IACA,IAAI,KAAK,KAAK,SAAS,eAAe,MAAM,SAAS,KAAK;GAC5D;GACA,GAAG;GACH,MAAM,UAAU;IACd,MAAM,MAAM,KAAK,OAAO;IACxB,IAAI,QAAQ,QAAQ,OAAO,MAAM;IACjC,IAAI,QAAQ,YAAY,MAAM,WAAW,KAAA,GAAW,OAAO,cAAc,MAAM,MAAM;IACrF,IAAI,QAAQ,MAAM,OAAO,MAAM;IAC/B,IAAI,OAAO,QAAQ,YAAY,OAAO,IAAI,KAAK;IAC/C,OAAO,MAAM;GACf;EACF,CAAC;CACH;AACF;AAEA,SAAS,SAAS,MAAc,KAAqB;CACnD,OAAO,KAAK,UAAU,MAAM,OAAO,GAAG,KAAK,MAAM,GAAG,GAAG,EAAE;AAC3D;AAEA,MAAM,YAGF;CACF,QAAQ,MAAM;EACZ,IAAI,EAAE,SAAS,SAAS,OAAO;EAC/B,IAAI,EAAE,SAAS,QAAQ,OAAO;EAC9B,IAAI,EAAE,QAAQ,MAAM,MAAM,OAAO;EACjC,OAAO;CACT;CACA,WAAW,MAAM;EACf,IAAI,EAAE,SAAS,SAAS,OAAO;EAC/B,IAAI,EAAE,SAAS,QAAQ,OAAO;EAC9B,IAAI,EAAE,QAAQ,MAAM,MAAM,OAAO;EACjC,OAAO;CACT;CACA,MAAM,MAAM,QAAQ,EAAE,QAAQ,MAAM,QAAQ,EAAE;CAC9C,OAAO,SAAS;EACd,IAAI,KAAK,KAAK,SAAS,aACrB,OAAO;GACL,GAAG,KAAK;GACR,QAAQ;IAAE,QAAQ;IAAM,MAAM,KAAK,KAAK,OAAO;GAAK;EACtD;EACF,OAAO,KAAK,KAAK,UAAU,KAAK,OAAO;GAAE,GAAG,KAAK;GAAM,SAAS,CAAC,WAAW,CAAC;EAAE;CACjF;CACA,SAAS,MAAM;EACb,IAAI,EAAE,SAAS,SAAS,OAAO;EAC/B,IAAI,EAAE,SAAS,QAAQ,OAAO;EAC9B,IAAI,EAAE,QAAQ,MAAM,MAAM,OAAO;EACjC,OAAO;CACT;AACF;AAOA,MAAMA,aAAkC;CACtC,OAAO,CACL;EACE,SAAS,SAAS,aAAa,KAAK,IAAI;EACxC,OAAO,SAAS,WAAW,KAAK,KAAK,MAAM,QAAQ;CACrD,GACA;EACE,SAAS,SAAS,KAAK,QAAQ,SAAS,YAAY,KAAK,QAAQ,MAAM,SAAS;EAChF,UAAU;EACV,OAAO,SAAS;GACd,IAAI,KAAK,KAAK,SAAS,QAAQ,OAAO,KAAK;GAC3C,OAAO,WAAW,MAAM;EAC1B;CACF,CACF;CAEA,OAAO;EACL,MAAM;GACJ,OAAO;GACP,UAAU;GACV,MAAM,MAA2B,QAAQ,EAAE,QAAQ,SAAS,QAAQ,QAAQ,GAAG,KAAK,EAAE;EACxF;EACA,MAAM;GAAE,OAAO;GAAK,UAAU;EAAG;EACjC,MAAM;GAAE,OAAO;GAAK,UAAU;EAAG;EACjC,QAAQ;GAAE,OAAO;GAAK,UAAU;EAAG;EAEnC,MAAM;EACN,MAAM;EACN,OAAO;EAEP,KAAK;GAAE,OAAO;GAAK,UAAU;EAAG;CAClC;AACF;AAEA,IAAa,iBAAb,MAA4B;CAC1B,0BAAU,IAAI,IAAuB;CACrC,YAAgC,CAAC;CACjC,YAA0B,CAAC;CAE3B,YAAY,OAA8B,CAAC,GAAG;EAC5C,MAAM,QAAQ;GAAE,GAAGA,WAAS;GAAO,GAAG,KAAK;EAAM;EACjD,KAAK,MAAM,CAAC,MAAM,SAAS,OAAO,QAAQ,KAAK,GAC7C,KAAK,UAAU,KAAK,IAAI,WAAW,MAAM,IAAI,CAAe;EAE9D,KAAK,MAAM,QAAQ,CAAC,GAAIA,WAAS,SAAS,CAAC,GAAI,GAAI,KAAK,SAAS,CAAC,CAAE,GAClE,KAAK,UAAU,KAAK,IAAI,WAAW,IAAI,CAAC;CAE5C;CAEA,SAAS;EACP,KAAK,QAAQ,MAAM;CACrB;CAEA,SAAS;EACP,IAAI,OAAO;EACX,KAAK,IAAI,KAAK,KAAK,UAAU,SAAS,GAAG,MAAM,GAAG,MAAM;GACtD,MAAM,IAAI,KAAK,UAAU;GACzB,IAAI,EAAE,SAAS,aAAa;GAE5B,IAAI,CAAC,MAAM,QAAQ,EAAE,OAAO,GAAG;GAE/B,KAAK,IAAI,KAAK,EAAE,QAAQ,SAAS,GAAG,MAAM,GAAG,MAAM;IACjD,MAAM,OAAgB;KAAE;KAAI;KAAI,SAAS;KAAG,MAAM,EAAE,QAAQ;KAAK,OAAO;KAAG;IAAK;IAChF,MAAM,SAAS,KAAK,QAAQ,IAAI;IAChC,IAAI,CAAC,QAAQ;IACb,MAAM,KAAK,OAAO,GAAG,IAAI;IACzB,MAAM,QAAQ,KAAK,QAAQ,IAAI,EAAE,KAAK;KAAE;KAAI,KAAK;KAAI,OAAO,CAAC;KAAG;IAAO;IACvE,OAAO,OAAO,OAAO,IAAI;IACzB,KAAK,QAAQ,IAAI,IAAI,KAAK;GAC5B;EACF;CACF;CAEA,QAAQ,MAAuC;EAC7C,OAAO,KAAK,UAAU,MAAM,WAAW,OAAO,OAAO,IAAI,CAAC;CAC5D;CAEA,MAAM,UAA2C;EAC/C,KAAK,OAAO;EACZ,KAAK,YAAY;EACjB,KAAK,OAAO;EAEZ,MAAM,SAAS,CAAC,GAAG,KAAK,QAAQ,OAAO,CAAC;EACxC,MAAM,yBAAS,IAAI,IAAoB;EACvC,KAAK,MAAM,SAAS,QAAQ;GAC1B,MAAM,MAAM,MAAM,OAAO,IAAI,KAAK;GAClC,MAAM,MAAM;GACZ,MAAM,SAAS,MAAM,OAAO,OAAO,KAAK;GACxC,MAAM,SAAS,OAAO,IAAI,GAAG,KAAK;GAClC,MAAM,SAAS,MAAM,OAAO,OAAO,KAAK;GACxC,KAAK,MAAM,QAAQ,MAAM,OAEvB,KAAK,QADS,KAAK,IAAI,CAAC,SAAS,KAAK,IACrB,IAAI,SAAS;GAEhC,OAAO,IAAI,KAAK,SAAS,MAAM,OAAO,MAAM,KAAK,CAAC;EACpD;EACA,OAAO;CACT;AACF;;AC1RA,MAAM,WAAW;CACf,OAAO;CACP,SAAS;CACT,WAAW;CACX,WAAW;CACX,QAAQ;AACV;;;;;;;;;;;;;;;;AAiBA,IAAa,SAAb,MAAoB;CAClB;CACA,yBAAS,IAAI,IAAkC;CAC/C,0BAAU,IAAI,IAAkC;CAChD;CACA;CAEA,YAAY,OAAc,OAAmC,CAAC,GAAG;EAC/D,KAAK,KAAK;EACV,KAAK,SAAS;EACd,MAAM,GAAG,WAAW,OAAO,QAAS,IAAI,WAAW,MAAM,KAAK,KAAK,IAAI,QAAQ,CAAE;EACjF,MAAM,IAAI,GAAG,iBAAiB,KAAK,MAAM,CAAC;CAC5C;CAEA,IAAI,QAAiC;EACnC,OAAO;GAAE,GAAG;GAAU,GAAG,QAAQ,KAAK,EAAE;EAAE;CAC5C;CAEA,IAAI,UAAmB;EACrB,OAAO,KAAK,MAAM;CACpB;CAEA,IAAI,WAAoB;EACtB,OAAO,KAAK,OAAO;CACrB;CAEA,UAAU,MAAqC;EAC7C,MAAM,WAAW,KAAK,OAAO;EAC7B,OAAO;GACL,OAAO;GACP,OAAO,SAAS;GAChB,QAAQ,KAAK,OAAO;GACpB,OAAO,SAAS;GAChB,OAAO,KAAK,OAAO;GACnB,GAAG;EACL;CACF;CAEA,QAAc;EACZ,KAAK,QAAQ,MAAM;EACnB,KAAK,OAAO,MAAM;EAClB,KAAK,aAAa,KAAA;CACpB;CAEA,IAAI,QAA2C;EAC7C,OAAO,KAAK;CACd;;CAGA,IAAI,SAAiB;EACnB,OAAO,KAAK,QAAQ;CACtB;CAEA,SAAS,OAAe,SAA2B;EACjD,IAAI,CAAC,KAAK,SAAS,OAAO;EAC1B,MAAM,QAAQ,KAAK,QAAQ,IAAI,KAAK;EACpC,IAAI,UAAU,KAAA,GAAW,OAAO;EAChC,OAAO,YAAY,KAAA,IAAY,MAAM,OAAO,IAAI,MAAM,IAAI,OAAO;CACnE;;;;;;;CAQA,MAAM,KAAK,UAA8B,MAAqC;EAC5E,IAAI,CAAC,KAAK,WAAW,SAAS,WAAW,GAAG,OAAO,CAAC,GAAG,QAAQ;EAE/D,MAAM,WAAW,KAAK,UAAU,IAAI;EAKpC,IAAI,KAAK,eAAe,KAAA,GAAW;GACjC,MAAM,KAAK,KAAK,SAAS;GACzB,IAAI,CAAC,IAIH,KAAK,aAAa,KAAK,MAAM,SAAS,KAAK,MAAM;QAC5C;IACL,KAAK,aAAa,GAAG;IACrB,MAAM,MAAM,SAAS,WAAW,MAAM,EAAE,OAAO,GAAG,SAAS;IAG3D,KAAK,QAAQ,QAAQ,KAAK,WAAW,SAAS,MAAM,GAAG,MAAM,CAAC,GAAG,QAAQ;GAC3E;EACF;EAGA,IAAI,SAAS,SAAS,KAAK,cAAc,SAAS,OAAO;GACvD,MAAM,YAAY,SAAS,GAAG,EAAE,CAAC,EAAE;GACnC,IAAI,CAAC,WAAW,MAAM,IAAI,MAAM,oDAAoD;GAEpF,MAAM,KAAK,SAAS,kBAAkB;IACpC;IACA,WAAW,KAAK;GAClB,CAAC;GACD,KAAK,QAAQ,UAAU,QAAQ;EACjC;EACA,OAAO,KAAK,MAAM,QAAQ;CAC5B;CAEA,MAAM,MAAY,KAAa,IAAI,GAAS;EAC1C,MAAM,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,CAAC;EACpC,EAAE,QAAQ,EAAE,QAAQ,KAAK;EACzB,KAAK,OAAO,IAAI,MAAM,CAAC;CACzB;;CAGA,QAAQ,UAA8B,MAAgC;EACpE,KAAK,QAAQ,MAAM;EACnB,KAAK,OAAO,MAAM;EAClB,KAAK,aAAa,KAAK,MAAM,SAAS,KAAK,MAAM;EACjD,MAAM,QAAQ,WAAW,UAAU;GAAE,QAAQ,KAAK;GAAQ,OAAO,KAAK;EAAM,CAAC;EAI7E,MAAM,cAAc,KAAK,IAAI,KAAK,MAAM,QAAQ,KAAK,aAAa,KAAK,MAAM,KAAK;EAClF,MAAM,SAAS,KAAK,QAAQ;EAG5B,IAAI,MAAM,UAAU,QAAQ;EAE5B,IAAI,OAAO,MAAM,SAAS;EAE1B,IAAI,SAAS,GAAG;EAGhB,MAAM,SAAS,IADI,eACC,CAAC,CAAC,MAAM,QAAQ;EACpC,MAAM,QAA+C,CAAC;EACtD,KAAK,MAAM,KAAK,QACd,KAAK,MAAM,KAAK,EAAE,OAChB,MAAM,KAAK;GACT,GAAG;GACH,YAAY,EAAE,OAAO,KAAK,GAAG,CAAC;EAChC,CAAC;EAGL,MAAM,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK;EAEtC,IAAI,SAAS;EACb,KAAK,MAAM,KAAK,OAAO;GACrB,IAAI,QAAQ,GAAG;GACf,MAAM,KAAK,EAAE,QAAQ;GACrB,IAAI,CAAC,IAAI;GAET,IAAI,EAAE,QAAQ,KAAK,MAAM,WAAW;GAEpC,MAAM,SAAS,aAAa,EAAE,IAAI,CAAC,CAAC;GACpC,IAAI,SAAS,KAAK,MAAM,WAAW;GAEnC,MAAM,OAAO,EAAE,KAAK;GACpB,IAAI,SAAS,EAAE,MAAM;GAErB,MAAM,WAAW,KAAK,QAAQ,IAAI,EAAE,qBAAK,IAAI,IAAI;GACjD,SAAS,IAAI,EAAE,IAAI,IAAI;GACvB,KAAK,MACH,EAAE,QAAQ,MACV,GAAG,EAAE,KAAK,OAAO,EAAE,KAAK,SAAS,iBAAiB,EAAE,KAAK,SAAS,cAAc,IAAI,EAAE,KAAK,SAAS,IACtG;GACA,KAAK,QAAQ,IAAI,IAAI,QAAQ;GAC7B,MAAM,QAAQ,SAAS,aAAa,IAAI,CAAC,CAAC;GAC1C,UAAU;GACV,QAAQ;EACV;EAEA,KAAK,aAAa,KAAK,KACpB,MAAM,SAAS,UAAU,KAAK,QAAQ,KAAK,MAAM,OAClD,KAAK,MAAM,SAAS,KAAK,MAAM,KACjC;CACF;;CAGA,MAAM,UAAyC;EAC7C,OAAO,SAAS,KAAK,MAAM;GACzB,IAAI,EAAE,OAAO,KAAA,KAAa,OAAO,EAAE,YAAY,UAAU,OAAO;GAChE,MAAM,SAAS,EAAE,KAAK,KAAK,QAAQ,IAAI,EAAE,EAAE,IAAI,KAAA;GAC/C,OAAO,UAAU,OAAO,OAAO,IAC1B;IACC,GAAG;IACH,SAAS,EAAE,QAAQ,KAAK,GAAG,MAAM,OAAO,IAAI,CAAC,KAAK,CAAC;GACrD,IACA;EACN,CAAC;CACH;AACF"}

package/dist/{session-C8zqqbPE.mjs → session-CUE48QWX.mjs}

@@ -81,6 +81,7 @@ var Session = class Session extends Emitter {
 	#started = false;
 	#path;
 	#head;
+	#mutations;
 	constructor(opts) {
 		super();
 		this.#opts = opts;
@@ -154,28 +155,37 @@ var Session = class Session extends Emitter {
 		};
 	}
 	async update(settings, opts) {
-		return this.#commit({
+		return this.#mutate(() => this.#commit({
 			settings,
 			type: "session-settings"
-		}, opts);
+		}, opts));
 	}
 	/** Lazily emits `session-start` on a fresh session or `session-resume`
 	*  on a hydrated one. Called from `#commit` before the first non-marker
 	*  node lands so the start/resume marker always heads the chain. */
 	async #autostart() {
-		if (!this.#started) await this.start();
+		if (!this.#started) await this.#start();
 	}
 	/** Explicitly mark the session as started — writes a `session-start`
 	*  marker on a fresh session, `session-resume` on a hydrated one.
 	*  Idempotent; subsequent calls are no-ops. Optional `meta` is
 	*  applied via `update()` after the marker lands. */
 	async start(settings) {
-		if (this.#started) return settings ? this.update(settings) : this.#store.root?.uuid;
+		return this.#mutate(() => this.#start(settings));
+	}
+	async #start(settings) {
+		if (this.#started) return settings ? this.#commit({
+			settings,
+			type: "session-settings"
+		}) : this.#store.root?.uuid;
 		this.#started = true;
 		const type = this.messages.length > 0 ? "session-resume" : "session-start";
 		await this.#commit({ type });
 		this.emit(type);
-		await this.update(settings ?? {});
+		await this.#commit({
+			settings: settings ?? {},
+			type: "session-settings"
+		});
 		return this.#store.root?.uuid;
 	}
 	/** Look up the decorated view for a node id — raw node plus the
@@ -218,46 +228,61 @@ var Session = class Session extends Emitter {
 			id: uuid,
 			ts
 		};
-		return this.#commit({
+		return this.#mutate(() => this.#commit({
 			message: m,
 			type: "message"
-		});
+		}));
 	}
-	/** Mark a compaction boundary. Subsequent `add()` calls land after
-	*  this node; their messages form the new active conversation. The
-	*  pre-compact chain stays in the store but is no longer part of
-	*  `messages`. Also commits a fresh `session-meta` snapshot right
-	*  after the compact so post-compact lazy walks always have a nearby
-	*  meta anchor. */
+	/** Summarize an active prefix through a message ID, preserving everything
+	*  appended after it. Boundary validation and tail calculation share the
+	*  serialized commit with the new summary. Legacy tail-only calls remain
+	*  supported. Original history stays in the store; a fresh settings anchor
+	*  follows the compact node for reconstruction. */
 	async compact(opts) {
-		const node = {
-			durationMs: opts.durationMs,
-			parentUuid: this.#store.root?.uuid,
-			preTokens: opts.preTokens,
-			summary: opts.summary,
-			tail: opts.tail,
-			trigger: opts.trigger ?? "manual",
-			ts: Date.now(),
-			type: "compact",
-			uuid: uuidv7()
-		};
-		const compactUuid = await this.#commit(node);
-		await this.update({}, { force: true });
-		await this.#rebuild();
-		this.emit("compact", { node });
-		return compactUuid;
+		return this.#mutate(async () => {
+			opts.signal?.throwIfAborted();
+			let tail = opts.tail;
+			if (opts.to !== void 0) {
+				const index = this.messages.findIndex((m) => m.id === opts.to);
+				if (index === -1 || opts.from !== void 0 && this.messages[0]?.id !== opts.from) throw new Error("Compaction snapshot is no longer part of the active history");
+				tail = this.messages.length - index - 1;
+			}
+			if (tail === void 0 || !Number.isInteger(tail) || tail < 0) throw new Error("Compaction requires a message boundary or a non-negative integer tail");
+			const compactUuid = await this.#commit({
+				durationMs: opts.durationMs,
+				from: opts.from,
+				preTokens: opts.preTokens,
+				summary: opts.summary,
+				tail,
+				to: opts.to,
+				trigger: opts.trigger ?? "manual",
+				type: "compact"
+			});
+			await this.#commit({
+				settings: {},
+				type: "session-settings"
+			}, { force: true });
+			await this.#rebuild();
+			const node = this.#view.compact;
+			this.emit("compact", { node });
+			return compactUuid;
+		});
 	}
 	async addMaskCheckpoint(opts) {
-		this.#view.maskCheckpoint = opts;
-		return this.#commit({
-			...opts,
-			type: "mask-checkpoint"
+		return this.#mutate(async () => {
+			this.#view.maskCheckpoint = opts;
+			return this.#commit({
+				...opts,
+				type: "mask-checkpoint"
+			});
 		});
 	}
 	async checkout(uuid) {
-		if (this.#closed) throw new Error("Session is closed");
-		this.#head = uuid;
-		await this.#rebuild();
+		return this.#mutate(async () => {
+			if (this.#closed) throw new Error("Session is closed");
+			this.#head = uuid;
+			await this.#rebuild();
+		});
 	}
 	/** Pre-active history of the current chain — messages from before
 	*  the most recent compact (and earlier compacts), in chronological
@@ -274,9 +299,20 @@ var Session = class Session extends Emitter {
 	}
 	/** Flush + close the underlying store. Subsequent writes throw. */
 	async close() {
-		if (this.#closed) return;
-		this.#closed = true;
-		await this.#store.close?.();
+		return this.#mutate(async () => {
+			if (this.#closed) return;
+			this.#closed = true;
+			await this.#store.close?.();
+		});
+	}
+	#mutate(fn) {
+		const pending = this.#mutations ? this.#mutations.then(fn) : fn();
+		const settled = pending.then(() => {}, () => {});
+		this.#mutations = settled;
+		settled.then(() => {
+			if (this.#mutations === settled) this.#mutations = void 0;
+		});
+		return pending;
 	}
 	/** Atomically commit a node: register it in the store, update active
 	*  messages, persist, and emit. Single chokepoint for all mutations. */
@@ -284,8 +320,8 @@ var Session = class Session extends Emitter {
 		let node = {
 			...n,
 			parentUuid: this.head,
-			ts: Date.now(),
-			uuid: uuidv7()
+			ts: n.type === "message" ? n.message.ts ?? Date.now() : Date.now(),
+			uuid: n.type === "message" ? n.message.id ?? uuidv7() : uuidv7()
 		};
 		if (!this.#started && node.type !== "session-start" && node.type !== "session-resume") await this.#autostart();
 		if (this.#closed) throw new Error("Session is closed");
@@ -363,8 +399,7 @@ var Session = class Session extends Emitter {
 			if (node.type === "mask-checkpoint" && !compact && !maskCheckpoint) maskCheckpoint = node;
 			if (node.type === "message") messageNodes.push(node);
 			if (node.type === "compact" && (opts.active ?? true)) {
-				if (compact) break;
-				compact = node;
+				compact ??= node;
 				limit = Math.min(limit, messageNodes.length + node.tail);
 			}
 			if (opts.stop?.(node)) break;
@@ -445,4 +480,4 @@ var Session = class Session extends Emitter {
 };
 export { session_exports as n, MemoryStore as r, Session as t };
 
-//# sourceMappingURL=session-C8zqqbPE.mjs.map
+//# sourceMappingURL=session-CUE48QWX.mjs.map

package/dist/session-CUE48QWX.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-CUE48QWX.mjs","names":[],"sources":["../src/session/memory.ts","../src/session/session.ts"],"sourcesContent":["import type { SessionStore } from \"./store.ts\"\nimport type { SessionNode } from \"./types.ts\"\n\n/**\n * In-memory `SessionStore` — a `Map<uuid, SessionNode>` plus a `root`\n * pointer. No persistence. Construction takes optional initial nodes\n * for tests, replay tools, and the Claude session importer.\n */\nexport class MemoryStore implements SessionStore {\n  readonly #nodes: Map<string, SessionNode>\n  #root?: SessionNode\n\n  constructor(nodes?: Iterable<SessionNode>) {\n    this.#nodes = new Map()\n    if (nodes) {\n      for (const node of nodes) {\n        this.#nodes.set(node.uuid, node)\n        this.#root = node\n      }\n    }\n  }\n\n  get root(): SessionNode | undefined {\n    return this.#root\n  }\n\n  async get(id: string): Promise<SessionNode | undefined> {\n    return this.#nodes.get(id)\n  }\n\n  async write(node: SessionNode): Promise<void> {\n    this.#nodes.set(node.uuid, node)\n    this.#root = node\n  }\n\n  *all(): Iterable<SessionNode> {\n    yield* this.#nodes.values()\n  }\n}\n","import type { Message } from \"@zaly/ai\"\nimport type { SessionStore } from \"./store.ts\"\nimport type {\n  MaskCheckpoint,\n  PartialNode,\n  SessionEvents,\n  SessionInit,\n  SessionMessage,\n  SessionNode,\n  SessionNodeView,\n  SessionOptions,\n  SessionSettings,\n  SessionUpdate,\n  SessionView,\n} from \"./types.ts\"\n\nimport { Emitter, normPath } from \"@zaly/shared\"\nimport { zalyPaths } from \"@zaly/shared/paths\"\nimport { isDeepStrictEqual } from \"node:util\"\nimport { join } from \"pathe\"\nimport { uuidv7 } from \"../utils/uuid.ts\"\nimport { JsonlStore } from \"./jsonl.ts\"\nimport { MemoryStore } from \"./memory.ts\"\n\nconst VERSION = 2\n\n/**\n * Conversation primitive. Owns a DAG of message + compaction + meta\n * nodes via a `SessionStore` backend; the *active* message list is\n * whatever you get by walking `parentUuid` backwards from the store's\n * root until you hit a `compact` node (or the start).\n *\n * **Meta is snapshot-based.** `session-meta` nodes carry the full\n * cumulative meta as of their commit time. Other node types (start,\n * resume, message, compact) don't carry meta — `Session` reconstructs\n * the cumulative meta at any point by finding the most recent\n * `session-meta` ancestor in a forward pass over the chain. Public\n * APIs return `SessionNodeView` (raw node + decorated `meta`).\n *\n * Designed so the loop, the persistor, the TUI, and any replay tool\n * all read from one source of truth and never mutate the DAG behind\n * each other's backs:\n *\n * - **Run loop** (`Agent`) calls `add()` on each new message and\n *   `compact()` on overflow.\n * - **TUI** subscribes to the `node` event for streaming render.\n * - **Persistor** is the `SessionStore` — `MemoryStore` for ephemeral\n *   sessions, `JsonlStore` for file-backed.\n *\n * Construction:\n *   - Use `await Session.load(opts)` for the recommended path — picks\n *     the right store (Memory if no path, JSONL if path).\n *   - For tests / direct embedding, `new Session({ store })` works with\n *     any pre-built store.\n */\nexport class Session<T extends SessionStore = SessionStore> extends Emitter<SessionEvents> {\n  readonly #store: T\n  #opts: SessionInit<T>\n  #id: string\n  #dir: string\n  #settings: SessionSettings = {}\n  #view: SessionView = { messages: [], nodes: new Map() }\n  #closed = false\n  #started = false\n  #path?: string\n  #head?: string\n  #mutations?: Promise<void>\n\n  protected constructor(opts: SessionInit<T>) {\n    super()\n    this.#opts = opts\n    this.#path = opts.path\n    this.#store = opts.store\n    this.#id = opts.defaults?.sessionId ?? uuidv7()\n    this.#dir = normPath(opts.dir ?? join(zalyPaths.env.tmp, \"sessions\", this.#id))\n  }\n\n  /** Recommended one-step path: pick the right store backend, hydrate\n   *  if applicable, return a ready-to-use session.\n   *\n   *  - `path` provided → `JsonlStore` (file-backed, hydrates from disk\n   *    if the file exists, opens for append either way).\n   *  - No `path` → `MemoryStore` (ephemeral, no persistence). */\n  static async load<T extends SessionStore = SessionStore>(\n    opts: SessionOptions<T> & { store: T }\n  ): Promise<Session<T>>\n  static async load(opts: SessionOptions & { path: string }): Promise<Session<JsonlStore>>\n  static async load(opts?: SessionOptions & {}): Promise<Session<MemoryStore>>\n  static async load(opts: SessionOptions = {}): Promise<Session> {\n    const session = await Session.create(opts)\n    await session.#rebuild()\n    return session\n  }\n\n  private static async create(opts: SessionOptions = {}): Promise<Session> {\n    const path = opts.path ? normPath(opts.path) : undefined\n    const store: SessionStore =\n      opts.store ?? (path ? await JsonlStore.load(path) : new MemoryStore())\n    const init: SessionInit = { ...opts, path, store }\n    return new Session(init)\n  }\n\n  /** Efficiently fetch the most recent user message by walking backward until we hit\n   * a user message, without reconstructing the full chain. Useful for a session picker. */\n  static async lastMessage(opts: SessionOptions = {}): Promise<Message<\"user\"> | undefined> {\n    const session = await Session.create(opts)\n    let ret: Message<\"user\"> | undefined\n    await session.#chain({\n      stop: (node) => {\n        if (node.type === \"message\" && node.message.role === \"user\") {\n          ret = node.message\n          return true\n        }\n        return false\n      },\n    })\n    void session.close()\n    return ret\n  }\n\n  async #rebuild(): Promise<void> {\n    const chain = await this.#chain()\n    this.#view = chain\n    this.#settings = chain.settings\n    this.#id = chain.settings.sessionId ?? this.#id\n  }\n\n  // ── Read ──────────────────────────────────────────────────────────────\n\n  /** Active conversation — chain from current head back to the most\n   *  recent compact (exclusive), in chronological order. This is what\n   *  the agent sees on the next request. */\n  get messages(): readonly Message[] {\n    return this.#view.messages\n  }\n\n  get maskCheckpoint(): MaskCheckpoint | undefined {\n    return this.#view.maskCheckpoint\n  }\n\n  get id(): string {\n    return this.#id\n  }\n\n  get dir(): string {\n    return this.#dir\n  }\n\n  get path(): string | undefined {\n    return this.#path\n  }\n\n  get started(): boolean {\n    return this.#started\n  }\n\n  /** Current session settings, merged with defaults. */\n  get settings(): SessionSettings {\n    return { ...this.#opts.defaults, ...this.#settings }\n  }\n\n  async update(settings: SessionUpdate, opts?: { force?: boolean }): Promise<string> {\n    return this.#mutate(() => this.#commit({ settings, type: \"session-settings\" }, opts))\n  }\n\n  /** Lazily emits `session-start` on a fresh session or `session-resume`\n   *  on a hydrated one. Called from `#commit` before the first non-marker\n   *  node lands so the start/resume marker always heads the chain. */\n  async #autostart(): Promise<void> {\n    if (!this.#started) await this.#start()\n  }\n\n  /** Explicitly mark the session as started — writes a `session-start`\n   *  marker on a fresh session, `session-resume` on a hydrated one.\n   *  Idempotent; subsequent calls are no-ops. Optional `meta` is\n   *  applied via `update()` after the marker lands. */\n  async start(settings?: SessionUpdate): Promise<string | undefined> {\n    return this.#mutate(() => this.#start(settings))\n  }\n\n  async #start(settings?: SessionUpdate): Promise<string | undefined> {\n    if (this.#started)\n      return settings\n        ? this.#commit({ settings, type: \"session-settings\" })\n        : this.#store.root?.uuid\n    this.#started = true\n    const type = this.messages.length > 0 ? (\"session-resume\" as const) : (\"session-start\" as const)\n    await this.#commit({ type })\n    void this.emit(type)\n    await this.#commit({ settings: settings ?? {}, type: \"session-settings\" })\n    return this.#store.root?.uuid\n  }\n\n  /** Look up the decorated view for a node id — raw node plus the\n   *  cumulative meta as of that node's position. Returns the\n   *  message-typed view, or `undefined` if the id doesn't refer to a\n   *  message in this session. */\n  async node(id?: string | Message): Promise<(SessionNodeView & { type: \"message\" }) | undefined> {\n    const m = typeof id === \"string\" ? { id } : id\n    if (!m?.id) return undefined\n    const ret = this.#view.nodes.get(m.id)\n    return ret?.type === \"message\" ? ret : undefined\n  }\n\n  /** Current head uuid — the root of the store, which is the most\n   *  recently appended node. */\n  get head(): string | undefined {\n    return this.#head ?? this.#store.root?.uuid\n  }\n\n  /** Full DAG iterator — backed by `store.all()`. Yields raw nodes\n   *  (no meta decoration). */\n  nodes(): Iterable<SessionNode> | AsyncIterable<SessionNode> {\n    return this.#store.all?.() ?? []\n  }\n\n  get root(): SessionNode | undefined {\n    return this.#store.root\n  }\n\n  // ── Mutate ────────────────────────────────────────────────────────────\n\n  /** Append a message. The new node is parented to the current head,\n   *  head advances, and a `node` event fires. Optional `meta` carries\n   *  usage / model / finish info — populate it for assistant turns\n   *  the agent commits after a step. Returns the assigned uuid.\n   *\n   *  If `message.id` / `message.ts` are set (e.g. round-tripped from a\n   *  prior load), they're used as the node's uuid / timestamp; otherwise\n   *  fresh values are generated. The committed message always carries\n   *  both — `m.id === node.uuid` and `m.ts === node.ts`. */\n  async add(message: Message): Promise<string> {\n    const uuid = message.id ?? uuidv7()\n    const ts = message.ts ?? Date.now()\n    const m = { ...message, id: uuid, ts }\n    return this.#mutate(() => this.#commit({ message: m, type: \"message\" }))\n  }\n\n  /** Summarize an active prefix through a message ID, preserving everything\n   *  appended after it. Boundary validation and tail calculation share the\n   *  serialized commit with the new summary. Legacy tail-only calls remain\n   *  supported. Original history stays in the store; a fresh settings anchor\n   *  follows the compact node for reconstruction. */\n  async compact(opts: {\n    trigger?: \"manual\" | \"auto\"\n    preTokens?: number\n    durationMs?: number\n    /** Cancel a queued compaction before its commit begins. */\n    signal?: AbortSignal\n    /** Prefer an explicit boundary; tail-only calls remain supported. */\n    to?: string\n    /** Expected first message of the snapshot, including a prior summary if present. */\n    from?: string\n    tail?: number\n    summary: Message<\"system\">\n  }): Promise<string> {\n    return this.#mutate(async () => {\n      opts.signal?.throwIfAborted()\n      let tail = opts.tail\n      if (opts.to !== undefined) {\n        const index = this.messages.findIndex((m) => m.id === opts.to)\n        if (index === -1 || (opts.from !== undefined && this.messages[0]?.id !== opts.from)) {\n          throw new Error(\"Compaction snapshot is no longer part of the active history\")\n        }\n        tail = this.messages.length - index - 1\n      }\n      if (tail === undefined || !Number.isInteger(tail) || tail < 0) {\n        throw new Error(\"Compaction requires a message boundary or a non-negative integer tail\")\n      }\n      const compactUuid = await this.#commit({\n        durationMs: opts.durationMs,\n        from: opts.from,\n        preTokens: opts.preTokens,\n        summary: opts.summary,\n        tail,\n        to: opts.to,\n        trigger: opts.trigger ?? \"manual\",\n        type: \"compact\",\n      })\n      await this.#commit({ settings: {}, type: \"session-settings\" }, { force: true })\n      await this.#rebuild()\n      const node = this.#view.compact!\n      void this.emit(\"compact\", { node })\n      return compactUuid\n    })\n  }\n\n  async addMaskCheckpoint(opts: MaskCheckpoint): Promise<string> {\n    return this.#mutate(async () => {\n      this.#view.maskCheckpoint = opts\n      return this.#commit({ ...opts, type: \"mask-checkpoint\" })\n    })\n  }\n\n  async checkout(uuid: string): Promise<void> {\n    return this.#mutate(async () => {\n      if (this.#closed) throw new Error(\"Session is closed\")\n      this.#head = uuid\n      await this.#rebuild()\n    })\n  }\n\n  /** Pre-active history of the current chain — messages from before\n   *  the most recent compact (and earlier compacts), in chronological\n   *  order. Useful for TUI scrollback that wants to render context the\n   *  agent itself no longer sees.\n   *\n   *  `limit` truncates from the front (oldest), so the most recent\n   *  history messages always make it through. */\n  async history(limit?: number): Promise<readonly Message[]> {\n    const chain = await this.#chain({ active: false, limit })\n    return chain.messages\n  }\n\n  /** Flush + close the underlying store. Subsequent writes throw. */\n  async close(): Promise<void> {\n    return this.#mutate(async () => {\n      if (this.#closed) return\n      this.#closed = true\n      await this.#store.close?.()\n    })\n  }\n\n  // ── Internals ────────────────────────────────────────────────────────\n\n  // Keep commits and view rebuilds together so appends cannot race a compaction.\n  #mutate<R>(fn: () => Promise<R>): Promise<R> {\n    const pending = this.#mutations ? this.#mutations.then(fn) : fn()\n    const settled = pending.then(\n      () => {},\n      () => {}\n    )\n    this.#mutations = settled\n    void settled.then(() => {\n      if (this.#mutations === settled) this.#mutations = undefined\n    })\n    return pending\n  }\n\n  /** Atomically commit a node: register it in the store, update active\n   *  messages, persist, and emit. Single chokepoint for all mutations. */\n  async #commit(n: PartialNode, opts: { force?: boolean } = {}): Promise<string> {\n    let node: SessionNode = {\n      ...n,\n      parentUuid: this.head,\n      ts: n.type === \"message\" ? (n.message.ts ?? Date.now()) : Date.now(),\n      uuid: n.type === \"message\" ? (n.message.id ?? uuidv7()) : uuidv7(),\n    }\n\n    if (!this.#started && node.type !== \"session-start\" && node.type !== \"session-resume\") {\n      await this.#autostart()\n    }\n    if (this.#closed) throw new Error(\"Session is closed\")\n\n    const next: SessionSettings = {\n      ...this.#opts.defaults,\n      ...this.#settings,\n      ...(node.type === \"session-settings\" ? node.settings : {}),\n      sessionId: this.#id,\n      version: VERSION,\n    }\n    if (next.cwd) next.cwd = normPath(next.cwd)\n    if (next.workspace) next.workspace = normPath(next.workspace)\n\n    if (node.type === \"session-settings\") {\n      if (!opts.force && isDeepStrictEqual(this.#settings, next)) return this.#store.root!.uuid\n      node = { ...node, settings: next }\n    }\n\n    node = { ...node, parentUuid: this.head }\n    await this.#store.write(node)\n    this.#head = undefined // invalidate head cache so it reflects the store's root on next read\n\n    // Decorate the new node with cumulative meta and append to the\n    // active chain view\n    this.#view.nodes.set(node.uuid, { ...node, settings: next })\n    if (node.type === \"message\") this.#view.messages.push(node.message)\n\n    // cwd / meta event signaling\n    if (node.type === \"session-settings\") {\n      const prev = this.#settings\n      this.#settings = next\n      this.#emitChanges(prev)\n    }\n\n    void this.emit(\"node\", { node })\n    return node.uuid\n  }\n\n  #emitChanges(prev: SessionSettings): void {\n    const next = this.#settings\n    if (next.cwd && next.cwd !== prev.cwd) void this.emit(\"cwd\", { cwd: next.cwd, prev: prev.cwd })\n    if (next.modelId && next.modelId !== prev.modelId)\n      void this.emit(\"model\", { model: next.modelId, prev: prev.modelId })\n    if (next.reasoning && next.reasoning !== prev.reasoning)\n      void this.emit(\"reasoning\", { effort: next.reasoning, prev: prev.reasoning })\n  }\n\n  /** Walk `parentUuid` from the given node back toward the root,\n   *  returning the chain as decorated views (each with cumulative meta).\n   *  The `active` flag controls what counts:\n   *    - `true`      — only the active chain (stops at first compact /\n   *                    session-start, with the kept tail spliced in via\n   *                    the compact's `tail` field, summary substituted\n   *                    in place of the compact node).\n   *    - `false`     — includes everything back to the root\n   *  Returns chronological order. */\n  async #chain(\n    opts: {\n      active?: boolean\n      limit?: number\n      uuid?: string\n      stop?: (node: SessionNode) => boolean\n    } = {}\n  ): Promise<SessionView & { settings: SessionSettings }> {\n    // Backward pass: collect raw nodes (new to old)\n    const reverse: SessionNode[] = []\n    let cursor = opts.uuid ?? this.head\n    let limit = opts.limit ?? Infinity\n    let compact: SessionNode<\"compact\"> | undefined\n    const messageNodes: SessionNode<\"message\">[] = []\n    let maskCheckpoint: SessionNode<\"mask-checkpoint\"> | undefined\n\n    // Walk backward from the head until we hit a compact or the start, collecting nodes.\n    while (cursor) {\n      // eslint-disable-next-line no-await-in-loop\n      const node = await this.#store.get(cursor)\n      if (!node || (node.type === \"message\" && messageNodes.length + 1 > limit)) break\n      cursor = node.parentUuid\n      reverse.push(node)\n      // Keep track if the last mask-checkpoint, until we hit a compaction.\n      if (node.type === \"mask-checkpoint\" && !compact && !maskCheckpoint) maskCheckpoint = node\n      if (node.type === \"message\") messageNodes.push(node)\n      if (node.type === \"compact\" && (opts.active ?? true)) {\n        compact ??= node\n        // Earlier compactions may contain part of the kept tail. Walk through\n        // their preserved messages, but never resurrect their summarized history.\n        limit = Math.min(limit, messageNodes.length + node.tail)\n      }\n      if (opts.stop?.(node)) break\n    }\n\n    // Forward pass: decorate with cumulative meta. session-meta nodes\n    // redefine the meta; everything else inherits the running snapshot.\n    const nodes = new Map<string, SessionNodeView>()\n    let settings: SessionSettings = {}\n    for (const n of reverse.toReversed()) {\n      if (n.type === \"session-settings\") settings = n.settings\n      nodes.set(n.uuid, { ...n, settings })\n    }\n\n    this.#migrate(nodes)\n\n    const messages: SessionMessage[] = []\n    for (const n of messageNodes) {\n      // add `id`, `ts` and `modelId` (if assistant turn) to the message\n      const m = { ...n.message, id: n.uuid, ts: n.ts }\n      if (m.role === \"assistant\") {\n        // Add missing modelId to assistant messages if not present\n        const s = nodes.get(n.uuid)?.settings ?? {}\n        m.meta = { ...m.meta, modelId: m.meta?.modelId ?? s.modelId }\n      }\n      n.message = m\n      messages.push(m)\n    }\n\n    // Add compaction summary as the first message\n    if (compact) {\n      messages.push({ ...compact.summary, id: compact.uuid, ts: compact.ts })\n      nodes.set(compact.uuid, {\n        message: compact.summary,\n        parentUuid: compact.parentUuid,\n        settings: nodes.get(compact.uuid)?.settings ?? {},\n        ts: compact.ts,\n        type: \"message\",\n        uuid: compact.uuid,\n      })\n    }\n\n    return {\n      compact,\n      maskCheckpoint,\n      messages: messages.toReversed(),\n      nodes,\n      settings,\n    }\n  }\n\n  #migrate(nodes: Map<string, SessionNodeView>) {\n    for (const n of nodes.values()) {\n      const version = n.settings.version ?? 0\n      if (version === VERSION) continue\n      n.settings = { ...n.settings, version: VERSION }\n\n      if (n.type === \"compact\") {\n        n.summary.meta = { kind: \"compaction-summary\", ...n.summary.meta }\n        continue\n      }\n\n      if (n.type !== \"message\") continue\n      const m = n.message\n\n      if (\n        m.role === \"system\" &&\n        Array.isArray(m.content) &&\n        m.content[0].type === \"meta\" &&\n        m.content[0].tag === \"task\"\n      ) {\n        // Missing task meta data kind\n        m.meta = { kind: \"task\", ...m.meta }\n      }\n\n      n.message = m\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/{session-Cq52cam5.d.mts → session-DY9mF9Vb.d.mts}

@@ -35,7 +35,11 @@ type SessionN = {
   preTokens?: number;
   /** How long the compactor took, ms. */
   durationMs?: number;
-  /** Number of message from before compaction that will be preserved */
+  /** Last active message covered by the summary. Absent on legacy entries. */
+  to?: string;
+  /** First active message in the summarized snapshot, used to reject stale summaries. */
+  from?: string;
+  /** Number of messages after the summary boundary at commit time. */
   tail: number;
   /** Frozen summary message that becomes the head of the active
    *  chain reconstruction. The full Message (not just text) so the
@@ -306,17 +310,22 @@ declare class Session<T extends SessionStore = SessionStore> extends Emitter<Ses
    *  fresh values are generated. The committed message always carries
    *  both — `m.id === node.uuid` and `m.ts === node.ts`. */
   add(message: Message): Promise<string>;
-  /** Mark a compaction boundary. Subsequent `add()` calls land after
-   *  this node; their messages form the new active conversation. The
-   *  pre-compact chain stays in the store but is no longer part of
-   *  `messages`. Also commits a fresh `session-meta` snapshot right
-   *  after the compact so post-compact lazy walks always have a nearby
-   *  meta anchor. */
+  /** Summarize an active prefix through a message ID, preserving everything
+   *  appended after it. Boundary validation and tail calculation share the
+   *  serialized commit with the new summary. Legacy tail-only calls remain
+   *  supported. Original history stays in the store; a fresh settings anchor
+   *  follows the compact node for reconstruction. */
   compact(opts: {
     trigger?: "manual" | "auto";
     preTokens?: number;
     durationMs?: number;
-    tail: number;
+    /** Cancel a queued compaction before its commit begins. */
+    signal?: AbortSignal;
+    /** Prefer an explicit boundary; tail-only calls remain supported. */
+    to?: string;
+    /** Expected first message of the snapshot, including a prior summary if present. */
+    from?: string;
+    tail?: number;
     summary: Message<"system">;
   }): Promise<string>;
   addMaskCheckpoint(opts: MaskCheckpoint): Promise<string>;
@@ -333,4 +342,4 @@ declare class Session<T extends SessionStore = SessionStore> extends Emitter<Ses
   close(): Promise<void>;
 }
 export { SessionStore as a, SessionEvents as c, SessionNode as d, SessionNodeView as f, SessionView as g, SessionUpdate as h, JsonlStore as i, SessionInit as l, SessionSettings as m, MemoryStore as n, MaskCheckpoint as o, SessionOptions as p, JsonlReader as r, PartialNode as s, Session as t, SessionMessage as u };
-//# sourceMappingURL=session-Cq52cam5.d.mts.map
+//# sourceMappingURL=session-DY9mF9Vb.d.mts.map

package/dist/session-DY9mF9Vb.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-DY9mF9Vb.d.mts","names":[],"sources":["../src/session/types.ts","../src/session/store.ts","../src/session/jsonl.ts","../src/session/memory.ts","../src/session/session.ts"],"mappings":";;;;;;;;;KAYK;EACH;;EAEA;;EAEA;;EAEI;;EACA;;EACA;EAA0B,UAAU;;EACpC;EAAiB,SAAS;;EAC1B;EAAyB;EAAmB;;EAE5C;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;;;;EAKA,SAAS;;KAGV,kBAAkB;KAEX;EAAmB;EAAmB;;KAEtC,iBAAiB;EAAY;EAAY;;KAEzC,YAAY,UAAU,kBAAkB,mBAAmB,QACrE;EACE,MAAM;;;;;KAME,kBAAkB;EAAgB,UAAU;;KAE5C;EACV,UAAU;EACV,OAAO,YAAY;EACnB,UAAU;EACV,iBAAiB;;KAGP;EACV;EACA;EACA;EACA;EACA;EACA,YAAY;;KAGF,gBAAgB,KAAK;KAE5B,iBAAiB,GAAG,UAAU,eAAe,oBAAoB,KAAK,GAAG;KAElE,cAAc,iBAAiB;;;KAM/B;EACV;IAAQ,MAAM;;EACd;IAAY;IAA0B,mBAAmB;;EACzD;IAAW,MAAM;;EAEjB;IAAO;IAAa;;EACpB;IAAS;IAAe;;EACxB;IAAa,QAAQ;IAAiB,OAAO;;EAE7C;EACA;;KAKU,eAAe,UAAU,eAAe;EAClD,QAAQ;;;;;EAKR;;;;;EAKA;;;EAGA,WAAW,KAAK;;KAGN,YAAY,UAAU,eAAe,gBAAgB;;;EAG/D,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;UCjGQ;;;WAGN,MAAM;;EAGf,MAAM,eAAe,QAAQ;;;;EAK7B,QAAQ,MAAM,gBAAgB;;EAG9B,cAAc;;;;EAKd,YAAY,SAAS,eAAe,cAAc;;;;;;;;;;;;;;cCvBvC,sBAAsB;;WACxB;EAKT,YAAY;;;;SAQC,KAAK,eAAe,QAAQ;MAmBrC,QAAQ;EAIN,IAAI,aAAa,QAAQ;EAIzB,MAAM,MAAM,cAAc;EAS1B,SAAS;EAIR,OAAO,cAAc;;cAMjB,YAAY;;WAMF;EAArB,YAAqB;UAsBN;EAgCT,QAAQ,QAAQ;EAMhB,SAAK;;;;;;;cC3IA,uBAAuB;;EAIlC,YAAY,QAAQ,SAAS;MAUzB,QAAQ;EAIN,IAAI,aAAa,QAAQ;EAIzB,MAAM,MAAM,cAAc;EAK/B,OAAO,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cCoBN,QAAQ,UAAU,eAAe,sBAAsB,QAAQ;;YAajE,YAAa,MAAM,YAAY;;;;;;;SAe3B,KAAK,UAAU,eAAe,cACzC,MAAM,eAAe;IAAO,OAAO;MAClC,QAAQ,QAAQ;SACN,KAAK,MAAM;IAAmB;MAAiB,QAAQ,QAAQ;SAC/D,KAAK,OAAO,sBAAsB,QAAQ,QAAQ;iBAO1C;;;SAUR,YAAY,OAAM,iBAAsB,QAAQ;;;;MA4BzD,qBAAqB;MAIrB,kBAAkB;MAIlB;MAIA;MAIA;MAIA;;MAKA,YAAY;EAIV,OAAO,UAAU,eAAe;IAAS;MAAoB;;;;;EAe7D,MAAM,WAAW,gBAAgB;;;;;EAqBjC,KAAK,cAAc,UAAU,SAAS;IAAoB;;;;MAS5D;;;EAMJ,SAAS,SAAS,eAAe,cAAc;MAI3C,QAAQ;;;;;;;;;;EAeN,IAAI,SAAS,UAAU;;;;;;EAYvB,QAAQ;IACZ;IACA;IACA;;IAEA,SAAS;;IAET;;IAEA;IACA;IACA,SAAS;MACP;EAgCE,kBAAkB,MAAM,iBAAiB;EAOzC,SAAS,eAAe;;;;;;;;EAexB,QAAQ,iBAAiB,iBAAiB;;EAM1C,SAAS"}

package/dist/session.d.mts

@@ -1,4 +1,4 @@
-import { a as SessionStore, c as SessionEvents, d as SessionNode, f as SessionNodeView, g as SessionView, h as SessionUpdate, i as JsonlStore, l as SessionInit, m as SessionSettings, n as MemoryStore, o as MaskCheckpoint, p as SessionOptions, r as JsonlReader, s as PartialNode, t as Session, u as SessionMessage } from "./session-Cq52cam5.mjs";
+import { a as SessionStore, c as SessionEvents, d as SessionNode, f as SessionNodeView, g as SessionView, h as SessionUpdate, i as JsonlStore, l as SessionInit, m as SessionSettings, n as MemoryStore, o as MaskCheckpoint, p as SessionOptions, r as JsonlReader, s as PartialNode, t as Session, u as SessionMessage } from "./session-DY9mF9Vb.mjs";
 import { Stats } from "node:fs";
 export type SessionInfo = {
   /** uuidv7 session id. Absent for non-managed external paths until the

package/dist/session.mjs

@@ -1,6 +1,6 @@
 import { n as isUuidv7Like, r as uuidv7 } from "./uuid-rfbQ9ad2.mjs";
 import { n as JsonlStore, t as JsonlReader } from "./jsonl-BGt7eqPK.mjs";
-import { r as MemoryStore, t as Session } from "./session-C8zqqbPE.mjs";
+import { r as MemoryStore, t as Session } from "./session-CUE48QWX.mjs";
 import { decodePath, encodePath, normPath, safeStatAsync } from "@zaly/shared";
 import { basename, dirname, join, relative } from "pathe";
 import { glob } from "@zaly/shared/glob";

package/dist/{src-C04Qk9KE.mjs → src-DJoqT9yP.mjs}

@@ -181,7 +181,7 @@ var AgentContext = class extends Emitter {
 	}
 	async masker() {
 		return this.#cache.want("masker", async (opts) => {
-			const { Masker } = await import("./masker-DEgR_ntk.mjs");
+			const { Masker } = await import("./masker-B97uwYXG.mjs");
 			return new Masker(this.agent, opts);
 		}, this.#opts.mask);
 	}
@@ -198,7 +198,7 @@ var AgentContext = class extends Emitter {
 async function loadSession(spec) {
 	if (isInstance(spec)) return spec;
 	else {
-		const { Session } = await import("./session-C8zqqbPE.mjs").then((n) => n.n);
+		const { Session } = await import("./session-CUE48QWX.mjs").then((n) => n.n);
 		return await Session.load({ ...spec });
 	}
 }
@@ -210,7 +210,7 @@ async function createAgentContext(opts) {
 	});
 }
 async function createAgent(opts) {
-	const [{ Agent }, ctx] = await Promise.all([import("./agent-BRENvuvx.mjs"), createAgentContext(opts)]);
+	const [{ Agent }, ctx] = await Promise.all([import("./agent-DlhEEMPU.mjs"), createAgentContext(opts)]);
 	return new Agent(ctx);
 }
 const promptRegistry = createRegistry("prompt").from({
@@ -264,7 +264,7 @@ const toolRegistry = createRegistry("tool").from({
 	grep: () => import("./grep-rvZ5S319.mjs").then((m) => m.grepTool),
 	read: () => import("./read-C5keKntU.mjs").then((m) => m.readTool),
 	search: () => import("./search-B-89W3SM.mjs").then((m) => m.searchTool),
-	subagent: () => import("./subagent-BbcxLzgC.mjs").then((m) => m.subagentTool),
+	subagent: () => import("./subagent-D-TYaX38.mjs").then((m) => m.subagentTool),
 	task_list: () => import("./tasks-Dgsiuh0Q.mjs").then((m) => m.taskListTool),
 	task_poll: () => import("./tasks-Dgsiuh0Q.mjs").then((m) => m.taskPollTool),
 	task_stop: () => import("./tasks-Dgsiuh0Q.mjs").then((m) => m.taskStopTool),
@@ -946,4 +946,4 @@ function fmt(n) {
 }
 export { ctx_exports as _, extractConversation as a, formatFileUsage as c, Commands as d, toolCollection as f, createAgent as g, promptRegistry as h, extractBashUsage as i, messageTail as l, promptCollection as m, formatTokenStats as n, extractFileUsage as o, toolRegistry as p, tokenStats as r, formatBashUsage as s, estimatePart as t, Skills as u };
 
-//# sourceMappingURL=src-C04Qk9KE.mjs.map
+//# sourceMappingURL=src-DJoqT9yP.mjs.map