@zaly/agent 0.0.12 → 0.1.1

package/dist/{truncate-BSMXgiXj.mjs.map → truncate-CChlZ113.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"truncate-BSMXgiXj.mjs","names":["sw"],"sources":["../src/utils/truncate.ts"],"sourcesContent":["import { sliceAnsi, splitAnsi, stringWidth as sw } from \"@zaly/shared/ansi\"\n\nconst MAX_CHARS = 50_000\nconst MAX_LINES = 2000\nconst MAX_LINE_CHARS = 1000\n\nexport type TruncateOps = {\n  strategy?: \"head\" | \"tail\" | \"head+tail\"\n  /** Max chars to keep (default: 50k). */\n  maxChars?: number\n  /** Max lines to keep (default: 2000). */\n  maxLines?: number\n  /** Max chars per line (default: 1000). */\n  maxLineChars?: number\n  /** When `strategy` is \"head+tail\", how many lines to keep in the head.\n   * When < 1, treated as a fraction of `maxLines`. Default: maxLines/2. */\n  head?: number\n}\n\nexport type TruncateResult = {\n  text: string\n  truncated: boolean\n  truncatedLines?: boolean\n  truncatedChars?: boolean\n  truncatedLineChars?: boolean\n  opts: Required<TruncateOps>\n  origLines: number\n  origChars: number\n  origLongestLine: number\n  origBytes: number\n}\n\nconst isJsonish = (lines: string[]) => lines.length === 1 && /^[\\s]*[[{]/.test(lines[0])\n\nfunction truncateOpts(opts: TruncateOps = {}): Required<TruncateOps> {\n  const maxLines = Math.max(1, opts.maxLines ?? MAX_LINES)\n  let head = opts.head ?? Math.floor(maxLines / 2)\n  if (head < 1) head = Math.floor(maxLines * head)\n  head = Math.max(0, Math.min(head, maxLines))\n  return {\n    ...opts,\n    head,\n    maxChars: Math.max(1, opts.maxChars ?? MAX_CHARS),\n    maxLineChars: Math.max(1, opts.maxLineChars ?? MAX_LINE_CHARS),\n    maxLines,\n    strategy: opts.strategy ?? \"head+tail\",\n  }\n}\n\nexport function truncate(data: string | Buffer, opts: TruncateOps = {}) {\n  const text = typeof data === \"string\" ? data : data.toString(\"utf8\")\n  const o = truncateOpts(opts)\n\n  let lines = splitAnsi(text)\n  while (lines.at(-1) === \"\") lines.pop()\n  const bytes = typeof data === \"string\" ? Buffer.byteLength(data, \"utf8\") : data.length\n\n  const ret: TruncateResult = {\n    opts: o,\n    origBytes: bytes,\n    origChars: lines.reduce((sum, l) => sum + sw(l) + 1, 0) - 1,\n    origLines: lines.length,\n    origLongestLine: lines.reduce((max, l) => Math.max(max, sw(l)), 0),\n    text,\n    truncated: false,\n  }\n\n  if (lines.length === 0) return ret\n\n  const jsonish = isJsonish(lines)\n  const truncLineChars = !jsonish && ret.origLongestLine > o.maxLineChars\n\n  if (lines.length <= o.maxLines && ret.origChars <= o.maxChars && !truncLineChars) return ret\n\n  ret.truncated = true\n\n  if (jsonish && ret.origChars > o.maxChars) {\n    const marker = ` … [truncated ${ret.origChars - o.maxChars} chars]`\n    const len = Math.max(0, o.maxChars - marker.length)\n    ret.text = sliceAnsi(lines[0], 0, len)\n    ret.text += marker\n    ret.truncatedChars = true\n    return ret\n  }\n\n  if (truncLineChars) {\n    lines = lines.map((l) => {\n      const len = sw(l)\n      if (len <= o.maxLineChars) return l\n      ret.truncatedLineChars = true\n      const trunc = len - o.maxLineChars\n      return `${sliceAnsi(l, 0, o.maxLineChars)} [ … truncated ${trunc} chars]`\n    })\n  }\n\n  const truncateLines = (ll: string[], maxLines: number, maxChars: number, reverse = false) => {\n    ll = reverse ? ll.toReversed() : ll\n    if (ll.length > maxLines) {\n      ret.truncatedLines = true\n      ll = ll.slice(0, maxLines)\n    }\n    let c = 0\n    ll = ll.filter((l) => {\n      c += sw(l) + 1 // +1 for the dropped \\n\n      if (c <= maxChars) return true\n      ret.truncatedChars = true\n      ret.truncatedLines = true\n      return false\n    })\n    return reverse ? ll.toReversed() : ll\n  }\n\n  let strategy: \"head\" | \"tail\" | \"head+tail\" = o.strategy\n  if (strategy === \"head+tail\") {\n    if (o.head === 0) strategy = \"tail\"\n    else if (o.head >= o.maxLines) strategy = \"head\"\n  }\n\n  if (strategy === \"head\") {\n    lines = truncateLines(lines, o.maxLines, o.maxChars)\n    const truncated = ret.origLines - lines.length\n    if (truncated) lines.push(` [ … truncated ${truncated} lines]`)\n  } else if (strategy === \"tail\") {\n    lines = truncateLines(lines, o.maxLines, o.maxChars, true)\n    const truncated = ret.origLines - lines.length\n    if (truncated) lines.unshift(` [ … truncated ${truncated} lines]`)\n  } else {\n    const headMaxChars = Math.floor((o.head / o.maxLines) * o.maxChars)\n    const tailMaxChars = o.maxChars - headMaxChars\n    const headLines = lines.splice(0, o.head)\n    const head = truncateLines(headLines, o.head, headMaxChars)\n    const tail = truncateLines(lines, o.maxLines - o.head, tailMaxChars, true)\n    const truncated = ret.origLines - head.length - tail.length\n    lines = truncated\n      ? [...head, ` [ … truncated ${truncated} lines]`, ...tail]\n      : [...head, ...tail]\n  }\n\n  ret.text = lines.join(\"\\n\")\n  return ret\n}\n"],"mappings":";;AAEA,MAAM,YAAY;AAClB,MAAM,YAAY;AAClB,MAAM,iBAAiB;AA4BvB,MAAM,aAAa,UAAoB,MAAM,WAAW,KAAK,aAAa,KAAK,MAAM,EAAE;AAEvF,SAAS,aAAa,OAAoB,CAAC,GAA0B;CACnE,MAAM,WAAW,KAAK,IAAI,GAAG,KAAK,YAAY,SAAS;CACvD,IAAI,OAAO,KAAK,QAAQ,KAAK,MAAM,WAAW,CAAC;CAC/C,IAAI,OAAO,GAAG,OAAO,KAAK,MAAM,WAAW,IAAI;CAC/C,OAAO,KAAK,IAAI,GAAG,KAAK,IAAI,MAAM,QAAQ,CAAC;CAC3C,OAAO;EACL,GAAG;EACH;EACA,UAAU,KAAK,IAAI,GAAG,KAAK,YAAY,SAAS;EAChD,cAAc,KAAK,IAAI,GAAG,KAAK,gBAAgB,cAAc;EAC7D;EACA,UAAU,KAAK,YAAY;CAC7B;AACF;AAEA,SAAgB,SAAS,MAAuB,OAAoB,CAAC,GAAG;CACtE,MAAM,OAAO,OAAO,SAAS,WAAW,OAAO,KAAK,SAAS,MAAM;CACnE,MAAM,IAAI,aAAa,IAAI;CAE3B,IAAI,QAAQ,UAAU,IAAI;CAC1B,OAAO,MAAM,GAAG,EAAE,MAAM,IAAI,MAAM,IAAI;CAGtC,MAAM,MAAsB;EAC1B,MAAM;EACN,WAJY,OAAO,SAAS,WAAW,OAAO,WAAW,MAAM,MAAM,IAAI,KAAK;EAK9E,WAAW,MAAM,QAAQ,KAAK,MAAM,MAAMA,YAAG,CAAC,IAAI,GAAG,CAAC,IAAI;EAC1D,WAAW,MAAM;EACjB,iBAAiB,MAAM,QAAQ,KAAK,MAAM,KAAK,IAAI,KAAKA,YAAG,CAAC,CAAC,GAAG,CAAC;EACjE;EACA,WAAW;CACb;CAEA,IAAI,MAAM,WAAW,GAAG,OAAO;CAE/B,MAAM,UAAU,UAAU,KAAK;CAC/B,MAAM,iBAAiB,CAAC,WAAW,IAAI,kBAAkB,EAAE;CAE3D,IAAI,MAAM,UAAU,EAAE,YAAY,IAAI,aAAa,EAAE,YAAY,CAAC,gBAAgB,OAAO;CAEzF,IAAI,YAAY;CAEhB,IAAI,WAAW,IAAI,YAAY,EAAE,UAAU;EACzC,MAAM,SAAS,iBAAiB,IAAI,YAAY,EAAE,SAAS;EAC3D,MAAM,MAAM,KAAK,IAAI,GAAG,EAAE,WAAW,OAAO,MAAM;EAClD,IAAI,OAAO,UAAU,MAAM,IAAI,GAAG,GAAG;EACrC,IAAI,QAAQ;EACZ,IAAI,iBAAiB;EACrB,OAAO;CACT;CAEA,IAAI,gBACF,QAAQ,MAAM,KAAK,MAAM;EACvB,MAAM,MAAMA,YAAG,CAAC;EAChB,IAAI,OAAO,EAAE,cAAc,OAAO;EAClC,IAAI,qBAAqB;EACzB,MAAM,QAAQ,MAAM,EAAE;EACtB,OAAO,GAAG,UAAU,GAAG,GAAG,EAAE,YAAY,EAAE,iBAAiB,MAAM;CACnE,CAAC;CAGH,MAAM,iBAAiB,IAAc,UAAkB,UAAkB,UAAU,UAAU;EAC3F,KAAK,UAAU,GAAG,WAAW,IAAI;EACjC,IAAI,GAAG,SAAS,UAAU;GACxB,IAAI,iBAAiB;GACrB,KAAK,GAAG,MAAM,GAAG,QAAQ;EAC3B;EACA,IAAI,IAAI;EACR,KAAK,GAAG,QAAQ,MAAM;GACpB,KAAKA,YAAG,CAAC,IAAI;GACb,IAAI,KAAK,UAAU,OAAO;GAC1B,IAAI,iBAAiB;GACrB,IAAI,iBAAiB;GACrB,OAAO;EACT,CAAC;EACD,OAAO,UAAU,GAAG,WAAW,IAAI;CACrC;CAEA,IAAI,WAA0C,EAAE;CAChD,IAAI,aAAa,aAAa;EAC5B,IAAI,EAAE,SAAS,GAAG,WAAW;OACxB,IAAI,EAAE,QAAQ,EAAE,UAAU,WAAW;CAC5C;CAEA,IAAI,aAAa,QAAQ;EACvB,QAAQ,cAAc,OAAO,EAAE,UAAU,EAAE,QAAQ;EACnD,MAAM,YAAY,IAAI,YAAY,MAAM;EACxC,IAAI,WAAW,MAAM,KAAK,kBAAkB,UAAU,QAAQ;CAChE,OAAO,IAAI,aAAa,QAAQ;EAC9B,QAAQ,cAAc,OAAO,EAAE,UAAU,EAAE,UAAU,IAAI;EACzD,MAAM,YAAY,IAAI,YAAY,MAAM;EACxC,IAAI,WAAW,MAAM,QAAQ,kBAAkB,UAAU,QAAQ;CACnE,OAAO;EACL,MAAM,eAAe,KAAK,MAAO,EAAE,OAAO,EAAE,WAAY,EAAE,QAAQ;EAClE,MAAM,eAAe,EAAE,WAAW;EAElC,MAAM,OAAO,cADK,MAAM,OAAO,GAAG,EAAE,IACD,GAAG,EAAE,MAAM,YAAY;EAC1D,MAAM,OAAO,cAAc,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,IAAI;EACzE,MAAM,YAAY,IAAI,YAAY,KAAK,SAAS,KAAK;EACrD,QAAQ,YACJ;GAAC,GAAG;GAAM,kBAAkB,UAAU;GAAU,GAAG;EAAI,IACvD,CAAC,GAAG,MAAM,GAAG,IAAI;CACvB;CAEA,IAAI,OAAO,MAAM,KAAK,IAAI;CAC1B,OAAO;AACT"}
+{"version":3,"file":"truncate-CChlZ113.mjs","names":["sw"],"sources":["../src/utils/truncate.ts"],"sourcesContent":["import { sliceAnsi, splitAnsi, stringWidth as sw } from \"@zaly/shared/ansi\"\n\nconst MAX_CHARS = 50_000\nconst MAX_LINES = 2000\nconst MAX_LINE_CHARS = 1000\n\nexport type TruncateOps = {\n  strategy?: \"head\" | \"tail\" | \"head+tail\"\n  /** Max chars to keep (default: 50k). */\n  maxChars?: number\n  /** Max lines to keep (default: 2000). */\n  maxLines?: number\n  /** Max chars per line (default: 1000). */\n  maxLineChars?: number\n  /** When `strategy` is \"head+tail\", how many lines to keep in the head.\n   * When < 1, treated as a fraction of `maxLines`. Default: maxLines/2. */\n  head?: number\n}\n\nexport type TruncateResult = {\n  text: string\n  truncated: boolean\n  truncatedLines?: boolean\n  truncatedChars?: boolean\n  truncatedLineChars?: boolean\n  opts: Required<TruncateOps>\n  origLines: number\n  origChars: number\n  origLongestLine: number\n  origBytes: number\n}\n\nconst isJsonish = (lines: string[]) => lines.length === 1 && /^[\\s]*[[{]/.test(lines[0])\n\nfunction truncateOpts(opts: TruncateOps = {}): Required<TruncateOps> {\n  const maxLines = Math.max(1, opts.maxLines ?? MAX_LINES)\n  let head = opts.head ?? Math.floor(maxLines / 2)\n  if (head < 1) head = Math.floor(maxLines * head)\n  head = Math.max(0, Math.min(head, maxLines))\n  return {\n    ...opts,\n    head,\n    maxChars: Math.max(1, opts.maxChars ?? MAX_CHARS),\n    maxLineChars: Math.max(1, opts.maxLineChars ?? MAX_LINE_CHARS),\n    maxLines,\n    strategy: opts.strategy ?? \"head+tail\",\n  }\n}\n\nexport function truncate(data: string | Buffer, opts: TruncateOps = {}) {\n  const text = typeof data === \"string\" ? data : data.toString(\"utf8\")\n  const o = truncateOpts(opts)\n\n  let lines = splitAnsi(text)\n  while (lines.at(-1) === \"\") lines.pop()\n  const bytes = typeof data === \"string\" ? Buffer.byteLength(data, \"utf8\") : data.length\n\n  const ret: TruncateResult = {\n    opts: o,\n    origBytes: bytes,\n    origChars: lines.reduce((sum, l) => sum + sw(l) + 1, 0) - 1,\n    origLines: lines.length,\n    origLongestLine: lines.reduce((max, l) => Math.max(max, sw(l)), 0),\n    text,\n    truncated: false,\n  }\n\n  if (lines.length === 0) return ret\n\n  const jsonish = isJsonish(lines)\n  const truncLineChars = !jsonish && ret.origLongestLine > o.maxLineChars\n\n  if (lines.length <= o.maxLines && ret.origChars <= o.maxChars && !truncLineChars) return ret\n\n  ret.truncated = true\n\n  if (jsonish && ret.origChars > o.maxChars) {\n    const marker = ` … [truncated ${ret.origChars - o.maxChars} chars]`\n    const len = Math.max(0, o.maxChars - marker.length)\n    ret.text = sliceAnsi(lines[0], 0, len)\n    ret.text += marker\n    ret.truncatedChars = true\n    return ret\n  }\n\n  if (truncLineChars) {\n    lines = lines.map((l) => {\n      const len = sw(l)\n      if (len <= o.maxLineChars) return l\n      ret.truncatedLineChars = true\n      const trunc = len - o.maxLineChars\n      return `${sliceAnsi(l, 0, o.maxLineChars)} [ … truncated ${trunc} chars]`\n    })\n  }\n\n  const truncateLines = (ll: string[], maxLines: number, maxChars: number, reverse = false) => {\n    ll = reverse ? ll.toReversed() : ll\n    if (ll.length > maxLines) {\n      ret.truncatedLines = true\n      ll = ll.slice(0, maxLines)\n    }\n    let c = 0\n    ll = ll.filter((l) => {\n      c += sw(l) + 1 // +1 for the dropped \\n\n      if (c <= maxChars) return true\n      ret.truncatedChars = true\n      ret.truncatedLines = true\n      return false\n    })\n    return reverse ? ll.toReversed() : ll\n  }\n\n  let strategy: \"head\" | \"tail\" | \"head+tail\" = o.strategy\n  if (strategy === \"head+tail\") {\n    if (o.head === 0) strategy = \"tail\"\n    else if (o.head >= o.maxLines) strategy = \"head\"\n  }\n\n  if (strategy === \"head\") {\n    lines = truncateLines(lines, o.maxLines, o.maxChars)\n    const truncated = ret.origLines - lines.length\n    if (truncated) lines.push(` [ … truncated ${truncated} lines]`)\n  } else if (strategy === \"tail\") {\n    lines = truncateLines(lines, o.maxLines, o.maxChars, true)\n    const truncated = ret.origLines - lines.length\n    if (truncated) lines.unshift(` [ … truncated ${truncated} lines]`)\n  } else {\n    const headMaxChars = Math.floor((o.head / o.maxLines) * o.maxChars)\n    const tailMaxChars = o.maxChars - headMaxChars\n    const headLines = lines.splice(0, o.head)\n    const head = truncateLines(headLines, o.head, headMaxChars)\n    const tail = truncateLines(lines, o.maxLines - o.head, tailMaxChars, true)\n    const truncated = ret.origLines - head.length - tail.length\n    lines = truncated\n      ? [...head, ` [ … truncated ${truncated} lines]`, ...tail]\n      : [...head, ...tail]\n  }\n\n  ret.text = lines.join(\"\\n\")\n  return ret\n}\n"],"mappings":"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"}

package/dist/{uuid-CAdJg4l8.mjs → uuid-rfbQ9ad2.mjs}

@@ -1,4 +1,4 @@
-//#region src/utils/uuid.ts
+// src/utils/uuid.ts
 /**
 * RFC 9562 UUIDv7 — timestamp-prefixed (48-bit ms since epoch),
 * monotonic within a millisecond via a 32-bit sequence counter,
@@ -53,7 +53,6 @@ function isUuidv7Like(s) {
 	const ts = parseInt(s, 16);
 	return ts > Date.parse("2026-01-01T00:00:00Z") && ts < Date.now() + 36e5;
 }
-//#endregion
 export { isUuidv7Like as n, uuidv7 as r, isUuidv7 as t };
 
-//# sourceMappingURL=uuid-CAdJg4l8.mjs.map
+//# sourceMappingURL=uuid-rfbQ9ad2.mjs.map

package/dist/{uuid-CAdJg4l8.mjs.map → uuid-rfbQ9ad2.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"uuid-CAdJg4l8.mjs","names":[],"sources":["../src/utils/uuid.ts"],"sourcesContent":["/**\n * RFC 9562 UUIDv7 — timestamp-prefixed (48-bit ms since epoch),\n * monotonic within a millisecond via a 32-bit sequence counter,\n * random tail otherwise. Sortable lexicographically by creation time,\n * which is handy for debugging (\"show me the latest few records by\n * uuid\") and for any future DB index.\n *\n * Hand-rolled to keep `@zaly/agent` dep-free. Same algorithm as the\n * `uuid` package's v7 implementation, just without the buffer/offset\n * ceremony — we only ever want the canonical string form.\n */\n\nlet lastMs = 0\nlet seq = 0\n\nexport function uuidv7(): string {\n  let ms = Date.now()\n  if (ms > lastMs) {\n    // Time moved on — fresh sequence base.\n    lastMs = ms\n    seq = Math.floor(Math.random() * 0x1_00_00_00_00)\n  } else {\n    // Same (or earlier) ms — bump sequence with 32-bit rollover. On\n    // rollover, advance the timestamp by one ms to preserve\n    // monotonicity (allowed by RFC 9562 §6.2; self-corrects as the\n    // wall clock catches up).\n    seq = (seq + 1) >>> 0\n    if (seq === 0) lastMs++\n    ms = lastMs\n  }\n\n  const r = crypto.getRandomValues(new Uint8Array(6))\n  const b = new Uint8Array(16)\n\n  // bytes 0-5: 48-bit big-endian millisecond timestamp\n  b[0] = (ms / 0x1_00_00_00_00_00) & 0xff\n  b[1] = (ms / 0x1_00_00_00_00) & 0xff\n  b[2] = (ms / 0x1_00_00_00) & 0xff\n  b[3] = (ms / 0x1_00_00) & 0xff\n  b[4] = (ms / 0x1_00) & 0xff\n  b[5] = ms & 0xff\n  // byte 6: version (0x70) + top 4 bits of sequence\n  b[6] = 0x70 | ((seq >>> 28) & 0x0f)\n  // byte 7: next 8 bits of sequence\n  b[7] = (seq >>> 20) & 0xff\n  // byte 8: variant (0x80) + next 6 bits of sequence\n  b[8] = 0x80 | ((seq >>> 14) & 0x3f)\n  // byte 9: next 8 bits of sequence\n  b[9] = (seq >>> 6) & 0xff\n  // byte 10: low 6 bits of sequence + 2 random bits\n  b[10] = ((seq << 2) & 0xff) | (r[0] & 0x03)\n  // bytes 11-15: 40 random bits\n  b[11] = r[1]\n  b[12] = r[2]\n  b[13] = r[3]\n  b[14] = r[4]\n  b[15] = r[5]\n\n  const hex = [...b].map((x) => x.toString(16).padStart(2, \"0\")).join(\"\")\n  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20, 32)}`\n}\n\nexport function isUuidv7(s: string): boolean {\n  return /^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(s)\n}\n\nexport function isUuidv7Like(s: string): boolean {\n  if (s.length < 7) return false\n  // First 12 chars of a v7 UUID is a timestamp\n  s = s.replace(/-/g, \"\").slice(0, 12).padEnd(12, \"0\").toLowerCase()\n  if (!/^[0-9a-f]+$/.test(s)) return false\n  const ts = parseInt(s, 16)\n  // Reject timestamps before 2026, and more than an hour in the future to allow for clock drift\n  return ts > Date.parse(\"2026-01-01T00:00:00Z\") && ts < Date.now() + 3600 * 1000\n}\n"],"mappings":";;;;;;;;;;;;AAYA,IAAI,SAAS;AACb,IAAI,MAAM;AAEV,SAAgB,SAAiB;CAC/B,IAAI,KAAK,KAAK,IAAI;CAClB,IAAI,KAAK,QAAQ;EAEf,SAAS;EACT,MAAM,KAAK,MAAM,KAAK,OAAO,IAAI,UAAe;CAClD,OAAO;EAKL,MAAO,MAAM,MAAO;EACpB,IAAI,QAAQ,GAAG;EACf,KAAK;CACP;CAEA,MAAM,IAAI,OAAO,gCAAgB,IAAI,WAAW,CAAC,CAAC;CAClD,MAAM,oBAAI,IAAI,WAAW,EAAE;CAG3B,EAAE,KAAM,KAAK,gBAAsB;CACnC,EAAE,KAAM,KAAK,aAAmB;CAChC,EAAE,KAAM,KAAK,WAAgB;CAC7B,EAAE,KAAM,KAAK,QAAa;CAC1B,EAAE,KAAM,KAAK,MAAU;CACvB,EAAE,KAAK,KAAK;CAEZ,EAAE,KAAK,MAAS,QAAQ,KAAM;CAE9B,EAAE,KAAM,QAAQ,KAAM;CAEtB,EAAE,KAAK,MAAS,QAAQ,KAAM;CAE9B,EAAE,KAAM,QAAQ,IAAK;CAErB,EAAE,MAAQ,OAAO,IAAK,MAAS,EAAE,KAAK;CAEtC,EAAE,MAAM,EAAE;CACV,EAAE,MAAM,EAAE;CACV,EAAE,MAAM,EAAE;CACV,EAAE,MAAM,EAAE;CACV,EAAE,MAAM,EAAE;CAEV,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE;CACtE,OAAO,GAAG,IAAI,MAAM,GAAG,CAAC,EAAE,GAAG,IAAI,MAAM,GAAG,EAAE,EAAE,GAAG,IAAI,MAAM,IAAI,EAAE,EAAE,GAAG,IAAI,MAAM,IAAI,EAAE,EAAE,GAAG,IAAI,MAAM,IAAI,EAAE;AAC7G;AAEA,SAAgB,SAAS,GAAoB;CAC3C,OAAO,yEAAyE,KAAK,CAAC;AACxF;AAEA,SAAgB,aAAa,GAAoB;CAC/C,IAAI,EAAE,SAAS,GAAG,OAAO;CAEzB,IAAI,EAAE,QAAQ,MAAM,EAAE,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC,YAAY;CACjE,IAAI,CAAC,cAAc,KAAK,CAAC,GAAG,OAAO;CACnC,MAAM,KAAK,SAAS,GAAG,EAAE;CAEzB,OAAO,KAAK,KAAK,MAAM,sBAAsB,KAAK,KAAK,KAAK,IAAI,IAAI;AACtE"}
+{"version":3,"file":"uuid-rfbQ9ad2.mjs","names":[],"sources":["../src/utils/uuid.ts"],"sourcesContent":["/**\n * RFC 9562 UUIDv7 — timestamp-prefixed (48-bit ms since epoch),\n * monotonic within a millisecond via a 32-bit sequence counter,\n * random tail otherwise. Sortable lexicographically by creation time,\n * which is handy for debugging (\"show me the latest few records by\n * uuid\") and for any future DB index.\n *\n * Hand-rolled to keep `@zaly/agent` dep-free. Same algorithm as the\n * `uuid` package's v7 implementation, just without the buffer/offset\n * ceremony — we only ever want the canonical string form.\n */\n\nlet lastMs = 0\nlet seq = 0\n\nexport function uuidv7(): string {\n  let ms = Date.now()\n  if (ms > lastMs) {\n    // Time moved on — fresh sequence base.\n    lastMs = ms\n    seq = Math.floor(Math.random() * 0x1_00_00_00_00)\n  } else {\n    // Same (or earlier) ms — bump sequence with 32-bit rollover. On\n    // rollover, advance the timestamp by one ms to preserve\n    // monotonicity (allowed by RFC 9562 §6.2; self-corrects as the\n    // wall clock catches up).\n    seq = (seq + 1) >>> 0\n    if (seq === 0) lastMs++\n    ms = lastMs\n  }\n\n  const r = crypto.getRandomValues(new Uint8Array(6))\n  const b = new Uint8Array(16)\n\n  // bytes 0-5: 48-bit big-endian millisecond timestamp\n  b[0] = (ms / 0x1_00_00_00_00_00) & 0xff\n  b[1] = (ms / 0x1_00_00_00_00) & 0xff\n  b[2] = (ms / 0x1_00_00_00) & 0xff\n  b[3] = (ms / 0x1_00_00) & 0xff\n  b[4] = (ms / 0x1_00) & 0xff\n  b[5] = ms & 0xff\n  // byte 6: version (0x70) + top 4 bits of sequence\n  b[6] = 0x70 | ((seq >>> 28) & 0x0f)\n  // byte 7: next 8 bits of sequence\n  b[7] = (seq >>> 20) & 0xff\n  // byte 8: variant (0x80) + next 6 bits of sequence\n  b[8] = 0x80 | ((seq >>> 14) & 0x3f)\n  // byte 9: next 8 bits of sequence\n  b[9] = (seq >>> 6) & 0xff\n  // byte 10: low 6 bits of sequence + 2 random bits\n  b[10] = ((seq << 2) & 0xff) | (r[0] & 0x03)\n  // bytes 11-15: 40 random bits\n  b[11] = r[1]\n  b[12] = r[2]\n  b[13] = r[3]\n  b[14] = r[4]\n  b[15] = r[5]\n\n  const hex = [...b].map((x) => x.toString(16).padStart(2, \"0\")).join(\"\")\n  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20, 32)}`\n}\n\nexport function isUuidv7(s: string): boolean {\n  return /^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(s)\n}\n\nexport function isUuidv7Like(s: string): boolean {\n  if (s.length < 7) return false\n  // First 12 chars of a v7 UUID is a timestamp\n  s = s.replace(/-/g, \"\").slice(0, 12).padEnd(12, \"0\").toLowerCase()\n  if (!/^[0-9a-f]+$/.test(s)) return false\n  const ts = parseInt(s, 16)\n  // Reject timestamps before 2026, and more than an hour in the future to allow for clock drift\n  return ts > Date.parse(\"2026-01-01T00:00:00Z\") && ts < Date.now() + 3600 * 1000\n}\n"],"mappings":";;;;;;;;;;;;AAYA,IAAI,SAAS;AACb,IAAI,MAAM;AAEV,SAAgB,SAAiB;CAC/B,IAAI,KAAK,KAAK,IAAI;CAClB,IAAI,KAAK,QAAQ;EAEf,SAAS;EACT,MAAM,KAAK,MAAM,KAAK,OAAO,IAAI,UAAe;CAClD,OAAO;EAKL,MAAO,MAAM,MAAO;EACpB,IAAI,QAAQ,GAAG;EACf,KAAK;CACP;CAEA,MAAM,IAAI,OAAO,gCAAgB,IAAI,WAAW,CAAC,CAAC;CAClD,MAAM,oBAAI,IAAI,WAAW,EAAE;CAG3B,EAAE,KAAM,KAAK,gBAAsB;CACnC,EAAE,KAAM,KAAK,aAAmB;CAChC,EAAE,KAAM,KAAK,WAAgB;CAC7B,EAAE,KAAM,KAAK,QAAa;CAC1B,EAAE,KAAM,KAAK,MAAU;CACvB,EAAE,KAAK,KAAK;CAEZ,EAAE,KAAK,MAAS,QAAQ,KAAM;CAE9B,EAAE,KAAM,QAAQ,KAAM;CAEtB,EAAE,KAAK,MAAS,QAAQ,KAAM;CAE9B,EAAE,KAAM,QAAQ,IAAK;CAErB,EAAE,MAAQ,OAAO,IAAK,MAAS,EAAE,KAAK;CAEtC,EAAE,MAAM,EAAE;CACV,EAAE,MAAM,EAAE;CACV,EAAE,MAAM,EAAE;CACV,EAAE,MAAM,EAAE;CACV,EAAE,MAAM,EAAE;CAEV,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE;CACtE,OAAO,GAAG,IAAI,MAAM,GAAG,CAAC,EAAE,GAAG,IAAI,MAAM,GAAG,EAAE,EAAE,GAAG,IAAI,MAAM,IAAI,EAAE,EAAE,GAAG,IAAI,MAAM,IAAI,EAAE,EAAE,GAAG,IAAI,MAAM,IAAI,EAAE;AAC7G;AAEA,SAAgB,SAAS,GAAoB;CAC3C,OAAO,yEAAyE,KAAK,CAAC;AACxF;AAEA,SAAgB,aAAa,GAAoB;CAC/C,IAAI,EAAE,SAAS,GAAG,OAAO;CAEzB,IAAI,EAAE,QAAQ,MAAM,EAAE,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC,YAAY;CACjE,IAAI,CAAC,cAAc,KAAK,CAAC,GAAG,OAAO;CACnC,MAAM,KAAK,SAAS,GAAG,EAAE;CAEzB,OAAO,KAAK,KAAK,MAAM,sBAAsB,KAAK,KAAK,KAAK,IAAI,IAAI;AACtE"}

package/dist/{wakeup-BYqTnfSp.mjs → wakeup-CFr1nu_L.mjs}

@@ -1,6 +1,6 @@
 import { AiError, defineTool } from "@zaly/ai";
 import { Type } from "typebox";
-//#region src/tools/wakeup.ts
+// src/tools/wakeup.ts
 const wakeupTool = defineTool({
 	name: "wakeup",
 	desc: "Schedule a one-shot wake-up of the agent loop. If `delayMs` elapses without anything else waking the loop (task completion, heartbeat, user message), you'll receive a system message with the optional `hint`. If something else wakes the loop first, the wakeup is cancelled — its hint still surfaces (with `status=\"cancelled\"`) so your reminder doesn't evaporate. Useful for polling external state or scheduling a return to a thought.",
@@ -23,7 +23,6 @@ const wakeupTool = defineTool({
 		})} scheduled for ${new Date(Date.now() + args.delayMs).toISOString()}`;
 	}
 });
-//#endregion
 export { wakeupTool };
 
-//# sourceMappingURL=wakeup-BYqTnfSp.mjs.map
+//# sourceMappingURL=wakeup-CFr1nu_L.mjs.map

package/dist/{wakeup-BYqTnfSp.mjs.map → wakeup-CFr1nu_L.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"wakeup-BYqTnfSp.mjs","names":[],"sources":["../src/tools/wakeup.ts"],"sourcesContent":["import type { Agent } from \"../agent.ts\"\n\nimport { defineTool, AiError } from \"@zaly/ai\"\nimport { Type } from \"typebox\"\n\n/**\n * Schedule a future wake-up of the agent loop.\n *\n * Behavior:\n *  - If `delayMs` elapses without anything else waking the loop, the\n *    agent receives a system message containing the wakeup id and the\n *    optional `hint`. The loop ticks; the model decides what to do next.\n *  - If task completion / heartbeat / user message wakes the loop first,\n *    the wakeup is auto-cancelled. Any cancelled wakeups carry their\n *    `hint`s forward as a system message tagged `status=\"cancelled\"` so\n *    the model still sees what it scheduled — the timing context is just\n *    explicit (\"I scheduled this; it didn't fire on its own\").\n *\n * Use cases:\n *  - Watch an external (non-task) process: \"wake me in 60s to re-fetch\n *    the build status URL.\"\n *  - Poll-style fallback for long-running tasks the model cares about\n *    finishing: \"wake me in 30s in case the build hasn't completed yet.\"\n *  - \"Take a moment\" patterns: \"wake me in 5min to reflect on whether\n *    this approach is right.\"\n *\n * No companion `wakeup_cancel` tool exists — by the time the model has\n * a turn to call cancel, the wakeup has either fired or been auto-\n * cancelled for it. The only useful state transition is \"fire,\" and that\n * the harness handles automatically.\n */\nexport interface WakeupContext {\n  /** The agent that scheduled the wakeup — provided via ToolContext\n   *  augmentation so the tool can call `scheduleWakeup` without a\n   *  cross-package dep on `Agent`. */\n  agent?: Agent\n}\n\n// oxlint-disable-next-line sort-keys -- semantic field order: name, desc, params, call\nexport const wakeupTool = defineTool({\n  name: \"wakeup\",\n  desc:\n    \"Schedule a one-shot wake-up of the agent loop. If `delayMs` elapses \" +\n    \"without anything else waking the loop (task completion, heartbeat, \" +\n    \"user message), you'll receive a system message with the optional \" +\n    \"`hint`. If something else wakes the loop first, the wakeup is \" +\n    'cancelled — its hint still surfaces (with `status=\"cancelled\"`) so ' +\n    \"your reminder doesn't evaporate. Useful for polling external state \" +\n    \"or scheduling a return to a thought.\",\n  parallel: true,\n  params: Type.Object({\n    delayMs: Type.Integer({\n      description: \"How long to wait before waking up, in milliseconds. Minimum 1.\",\n      minimum: 1,\n    }),\n    hint: Type.Optional(\n      Type.String({\n        description:\n          \"Short text the wakeup carries — what you wanted to remember \" +\n          \"to do at this point. Surfaces in the system message whether \" +\n          \"the wakeup fires on its own timer or gets cancelled by another \" +\n          \"event. Keep it concise; treat it as a TODO line, not prose.\",\n      })\n    ),\n  }),\n\n  call(args, ctx) {\n    if (!ctx.agent) {\n      throw new AiError({\n        code: \"MISSING_TOOL_CONTEXT\",\n        message: \"wakeup requires an Agent reference on the context (set up by the agent harness).\",\n      })\n    }\n    const id = ctx.agent.scheduleWakeup({ delayMs: args.delayMs, hint: args.hint })\n    const when = new Date(Date.now() + args.delayMs).toISOString()\n    return `wakeup ${id} scheduled for ${when}`\n  },\n})\n"],"mappings":";;;AAuCA,MAAa,aAAa,WAAW;CACnC,MAAM;CACN,MACE;CAOF,UAAU;CACV,QAAQ,KAAK,OAAO;EAClB,SAAS,KAAK,QAAQ;GACpB,aAAa;GACb,SAAS;EACX,CAAC;EACD,MAAM,KAAK,SACT,KAAK,OAAO,EACV,aACE,qPAIJ,CAAC,CACH;CACF,CAAC;CAED,KAAK,MAAM,KAAK;EACd,IAAI,CAAC,IAAI,OACP,MAAM,IAAI,QAAQ;GAChB,MAAM;GACN,SAAS;EACX,CAAC;EAIH,OAAO,UAFI,IAAI,MAAM,eAAe;GAAE,SAAS,KAAK;GAAS,MAAM,KAAK;EAAK,CAE3D,EAAE,iBADP,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,OAAO,CAAC,CAAC,YACT;CAC1C;AACF,CAAC"}
+{"version":3,"file":"wakeup-CFr1nu_L.mjs","names":[],"sources":["../src/tools/wakeup.ts"],"sourcesContent":["import type { Agent } from \"../agent.ts\"\n\nimport { defineTool, AiError } from \"@zaly/ai\"\nimport { Type } from \"typebox\"\n\n/**\n * Schedule a future wake-up of the agent loop.\n *\n * Behavior:\n *  - If `delayMs` elapses without anything else waking the loop, the\n *    agent receives a system message containing the wakeup id and the\n *    optional `hint`. The loop ticks; the model decides what to do next.\n *  - If task completion / heartbeat / user message wakes the loop first,\n *    the wakeup is auto-cancelled. Any cancelled wakeups carry their\n *    `hint`s forward as a system message tagged `status=\"cancelled\"` so\n *    the model still sees what it scheduled — the timing context is just\n *    explicit (\"I scheduled this; it didn't fire on its own\").\n *\n * Use cases:\n *  - Watch an external (non-task) process: \"wake me in 60s to re-fetch\n *    the build status URL.\"\n *  - Poll-style fallback for long-running tasks the model cares about\n *    finishing: \"wake me in 30s in case the build hasn't completed yet.\"\n *  - \"Take a moment\" patterns: \"wake me in 5min to reflect on whether\n *    this approach is right.\"\n *\n * No companion `wakeup_cancel` tool exists — by the time the model has\n * a turn to call cancel, the wakeup has either fired or been auto-\n * cancelled for it. The only useful state transition is \"fire,\" and that\n * the harness handles automatically.\n */\nexport interface WakeupContext {\n  /** The agent that scheduled the wakeup — provided via ToolContext\n   *  augmentation so the tool can call `scheduleWakeup` without a\n   *  cross-package dep on `Agent`. */\n  agent?: Agent\n}\n\n// oxlint-disable-next-line sort-keys -- semantic field order: name, desc, params, call\nexport const wakeupTool = defineTool({\n  name: \"wakeup\",\n  desc:\n    \"Schedule a one-shot wake-up of the agent loop. If `delayMs` elapses \" +\n    \"without anything else waking the loop (task completion, heartbeat, \" +\n    \"user message), you'll receive a system message with the optional \" +\n    \"`hint`. If something else wakes the loop first, the wakeup is \" +\n    'cancelled — its hint still surfaces (with `status=\"cancelled\"`) so ' +\n    \"your reminder doesn't evaporate. Useful for polling external state \" +\n    \"or scheduling a return to a thought.\",\n  parallel: true,\n  params: Type.Object({\n    delayMs: Type.Integer({\n      description: \"How long to wait before waking up, in milliseconds. Minimum 1.\",\n      minimum: 1,\n    }),\n    hint: Type.Optional(\n      Type.String({\n        description:\n          \"Short text the wakeup carries — what you wanted to remember \" +\n          \"to do at this point. Surfaces in the system message whether \" +\n          \"the wakeup fires on its own timer or gets cancelled by another \" +\n          \"event. Keep it concise; treat it as a TODO line, not prose.\",\n      })\n    ),\n  }),\n\n  call(args, ctx) {\n    if (!ctx.agent) {\n      throw new AiError({\n        code: \"MISSING_TOOL_CONTEXT\",\n        message: \"wakeup requires an Agent reference on the context (set up by the agent harness).\",\n      })\n    }\n    const id = ctx.agent.scheduleWakeup({ delayMs: args.delayMs, hint: args.hint })\n    const when = new Date(Date.now() + args.delayMs).toISOString()\n    return `wakeup ${id} scheduled for ${when}`\n  },\n})\n"],"mappings":";;;AAuCA,MAAa,aAAa,WAAW;CACnC,MAAM;CACN,MACE;CAOF,UAAU;CACV,QAAQ,KAAK,OAAO;EAClB,SAAS,KAAK,QAAQ;GACpB,aAAa;GACb,SAAS;EACX,CAAC;EACD,MAAM,KAAK,SACT,KAAK,OAAO,EACV,aACE,qPAIJ,CAAC,CACH;CACF,CAAC;CAED,KAAK,MAAM,KAAK;EACd,IAAI,CAAC,IAAI,OACP,MAAM,IAAI,QAAQ;GAChB,MAAM;GACN,SAAS;EACX,CAAC;EAIH,OAAO,UAFI,IAAI,MAAM,eAAe;GAAE,SAAS,KAAK;GAAS,MAAM,KAAK;EAAK,CAE3D,EAAE,iBADP,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,OAAO,CAAC,CAAC,YACT;CAC1C;AACF,CAAC"}

package/dist/{write-DwGiDNeG.mjs → write-BRQFfWAn.mjs}

@@ -4,7 +4,7 @@ import { AiError, defineTool } from "@zaly/ai";
 import { mkdir, stat, writeFile } from "node:fs/promises";
 import { Type } from "typebox";
 import { detectEol, normalizeEol } from "@zaly/shared/text";
-//#region src/tools/write.ts
+// src/tools/write.ts
 /**
 * Write a file to disk. Overwrites if the file exists; creates parent
 * directories as needed.
@@ -75,7 +75,6 @@ function countLines(content) {
 	if (content.endsWith("\n")) n--;
 	return n;
 }
-//#endregion
 export { writeTool };
 
-//# sourceMappingURL=write-DwGiDNeG.mjs.map
+//# sourceMappingURL=write-BRQFfWAn.mjs.map

package/dist/write-BRQFfWAn.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-BRQFfWAn.mjs","names":[],"sources":["../src/tools/write.ts"],"sourcesContent":["import type { ToolContext } from \"@zaly/ai\"\nimport type { FileMeta } from \"./read.ts\"\n\nimport { AiError, defineTool } from \"@zaly/ai\"\nimport { normPath, safeReadFile } from \"@zaly/shared\"\nimport { detectEol, normalizeEol } from \"@zaly/shared/text\"\nimport { mkdir, stat, writeFile } from \"node:fs/promises\"\nimport { dirname } from \"pathe\"\nimport { Type } from \"typebox\"\n\nexport type WriteTool = typeof writeTool\n\nexport type WriteToolMeta = FileMeta & {\n  /** File content before the write. Undefined for new files. The\n   *  post-write content is recoverable from the original call's\n   *  `params.content`, so we don't redundantly stash it on meta. */\n  original?: string\n}\n\n/**\n * Write a file to disk. Overwrites if the file exists; creates parent\n * directories as needed.\n *\n * Content is written *verbatim* in everything but line endings. The\n * model always emits LF; this tool detects the existing file's\n * line-ending style (or the platform default for new files via\n * `detectEol`) and re-applies it on write so a CRLF file stays CRLF\n * after an LF-from-the-model overwrite. No trailing-newline injection,\n * no whitespace stripping.\n *\n * Returns a small acknowledgement (`{ ok, bytes, lines }`) rather than\n * echoing the content back — the model already has it. `bytes` reflects\n * the on-disk byte count, including any extra bytes from CRLF expansion.\n */\n// oxlint-disable-next-line sort-keys -- semantic field order: name, desc, params, call\nexport const writeTool = defineTool({\n  name: \"write\",\n  desc:\n    \"Write content to a file. Overwrites existing files; \" +\n    \"creates parent directories as needed. Returns the byte count and line \" +\n    \"count of the written file.\",\n  // oxlint-disable-next-line sort-keys -- semantic param order\n  params: Type.Object({\n    path: Type.String({ description: \"Path to the file. Absolute or cwd-relative.\" }),\n    content: Type.String({ description: \"File contents to write, verbatim.\" }),\n  }),\n\n  async preflight(args, ctx: ToolContext<WriteToolMeta>) {\n    const path = normPath(ctx.cwd, args.path)\n    await ctx.need?.(\"write\", path)\n  },\n\n  async call(\n    args,\n    ctx: ToolContext<WriteToolMeta>\n  ): Promise<{ ok: true; path: string; bytes: number; lines: number }> {\n    const path = normPath(ctx.cwd, args.path)\n\n    let text: string\n    let original: string | undefined\n    try {\n      original = await safeReadFile(path)\n      const eol = detectEol({ path, text: original })\n      text = normalizeEol(args.content, { eol })\n      await mkdir(dirname(path), { recursive: true })\n      await writeFile(path, text, \"utf8\")\n    } catch (error) {\n      throw new AiError({\n        cause: error,\n        code: \"WRITE_FAILED\",\n        message: `failed to write ${path}: ${error instanceof Error ? error.message : String(error)}`,\n      })\n    }\n\n    // Record the new mtime for unchanged-read detection and mark the\n    // full-file replacement for context masking.\n    const fstat = await stat(path)\n    ctx.meta = { full: true, kind: \"write\", mtime: fstat.mtimeMs, original, path }\n\n    const bytes = Buffer.byteLength(text, \"utf8\")\n    const lines = countLines(text)\n    return { bytes, lines, ok: true, path }\n  },\n})\n\n/** Count lines the way an editor would — non-empty trailing line counts;\n *  trailing newline doesn't add a phantom blank line. */\nfunction countLines(content: string): number {\n  if (content === \"\") return 0\n  let n = 1\n  for (const c of content) if (c === \"\\n\") n++\n  // A trailing newline means the count is one too high (no real line follows).\n  if (content.endsWith(\"\\n\")) n--\n  return n\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAmCA,MAAa,YAAY,WAAW;CAClC,MAAM;CACN,MACE;CAIF,QAAQ,KAAK,OAAO;EAClB,MAAM,KAAK,OAAO,EAAE,aAAa,8CAA8C,CAAC;EAChF,SAAS,KAAK,OAAO,EAAE,aAAa,oCAAoC,CAAC;CAC3E,CAAC;CAED,MAAM,UAAU,MAAM,KAAiC;EACrD,MAAM,OAAO,SAAS,IAAI,KAAK,KAAK,IAAI;EACxC,MAAM,IAAI,OAAO,SAAS,IAAI;CAChC;CAEA,MAAM,KACJ,MACA,KACmE;EACnE,MAAM,OAAO,SAAS,IAAI,KAAK,KAAK,IAAI;EAExC,IAAI;EACJ,IAAI;EACJ,IAAI;GACF,WAAW,MAAM,aAAa,IAAI;GAClC,MAAM,MAAM,UAAU;IAAE;IAAM,MAAM;GAAS,CAAC;GAC9C,OAAO,aAAa,KAAK,SAAS,EAAE,IAAI,CAAC;GACzC,MAAM,MAAM,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;GAC9C,MAAM,UAAU,MAAM,MAAM,MAAM;EACpC,SAAS,OAAO;GACd,MAAM,IAAI,QAAQ;IAChB,OAAO;IACP,MAAM;IACN,SAAS,mBAAmB,KAAK,IAAI,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GAC5F,CAAC;EACH;EAKA,IAAI,OAAO;GAAE,MAAM;GAAM,MAAM;GAAS,QAAO,MAD3B,KAAK,IAAI,EAAA,CACwB;GAAS;GAAU;EAAK;EAI7E,OAAO;GAAE,OAFK,OAAO,WAAW,MAAM,MAEzB;GAAG,OADF,WAAW,IACL;GAAG,IAAI;GAAM;EAAK;CACxC;AACF,CAAC;;;AAID,SAAS,WAAW,SAAyB;CAC3C,IAAI,YAAY,IAAI,OAAO;CAC3B,IAAI,IAAI;CACR,KAAK,MAAM,KAAK,SAAS,IAAI,MAAM,MAAM;CAEzC,IAAI,QAAQ,SAAS,IAAI,GAAG;CAC5B,OAAO;AACT"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaly/agent",
-  "version": "0.0.12",
+  "version": "0.1.1",
   "description": "Agent runtime, sessions, tools, permissions, compaction, and tasks for zaly.",
   "keywords": [
     "agent",
@@ -33,27 +33,65 @@
     "access": "public"
   },
   "dependencies": {
-    "@zaly/ai": "0.0.12",
-    "@zaly/shared": "0.0.12",
+    "@zaly/ai": "0.1.1",
+    "@zaly/shared": "0.1.1",
     "pathe": "^2.0.3"
   },
   "devDependencies": {
+    "@joplin/turndown-plugin-gfm": "^1.0.68",
+    "@mozilla/readability": "^0.6.0",
     "@types/shell-quote": "^1.7.5",
-    "ignore": "^7.0.12",
+    "@types/turndown": "^5.0.6",
+    "ignore": "^7.0.14",
     "jsonpath-plus": "^11.2.1",
-    "shell-quote": "^1.12.0"
+    "linkedom": "^0.18.14",
+    "shell-quote": "^1.12.0",
+    "turndown": "^7.2.4"
   },
   "peerDependencies": {
-    "typebox": "^1.3.37"
+    "typebox": "^1.4.3"
   },
   "engines": {
     "bun": ">=1.2",
     "node": ">=22.18.0"
   },
   "inlinedDependencies": {
-    "ignore": "7.0.12",
+    "@acemir/cssom": "0.9.32",
+    "@joplin/turndown-plugin-gfm": "1.0.68",
+    "@mixmark-io/domino": "2.2.0",
+    "@mozilla/readability": "0.6.0",
+    "boolbase": "2.0.0",
+    "css-select": "7.0.0",
+    "css-what": "8.0.0",
+    "dom-serializer": [
+      "2.0.0",
+      "3.1.1"
+    ],
+    "domelementtype": [
+      "2.3.0",
+      "3.0.0"
+    ],
+    "domhandler": [
+      "5.0.3",
+      "6.0.1"
+    ],
+    "domutils": [
+      "3.2.2",
+      "4.0.2"
+    ],
+    "entities": [
+      "4.5.0",
+      "7.0.1",
+      "8.1.0"
+    ],
+    "htmlparser2": "10.1.0",
+    "ignore": "7.0.14",
     "jsonpath-plus": "11.2.1",
-    "shell-quote": "1.12.0"
+    "linkedom": "0.18.14",
+    "nth-check": "3.0.1",
+    "shell-quote": "1.12.0",
+    "turndown": "7.2.4",
+    "uhyphen": "0.2.0"
   },
   "scripts": {
     "build": "z build",

package/dist/bash-COgq4W7U.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"bash-COgq4W7U.mjs","names":[],"sources":["../src/tools/bash.ts"],"sourcesContent":["import type { MetaOf, MetaPart, Streamable, TextPart, ToolResult } from \"@zaly/ai\"\n\nimport { defineTool } from \"@zaly/ai\"\nimport { normPath, randomHash } from \"@zaly/shared\"\nimport { bufferedTailStream, Spawn, TextStream } from \"@zaly/shared/process\"\nimport { cleanTextTui } from \"@zaly/shared/text\"\nimport { tmpdir } from \"node:os\"\nimport { join } from \"pathe\"\nimport { Type } from \"typebox\"\nimport { truncate } from \"../utils/truncate.ts\"\n\nexport type BashTool = typeof bashTool\nexport type BashToolMeta = MetaOf<BashTool>\n\n/**\n * Run a bash command and capture its output.\n *\n * Lifecycle is fully owned by the Tasks harness:\n *\n *  - The tool returns a `Streamable` immediately. Tasks races its `done`\n *    against a grace window. Sub-grace commands appear synchronous to the\n *    model; longer ones promote to a background task and the model gets\n *    a partial snapshot now plus a system-message completion later.\n *  - There's no blocking wait: a backgrounded command's result arrives\n *    automatically as a `task-done` system message. `task_poll` peeks at\n *    incremental output, `task_stop` aborts, and `wakeup` covers\n *    poll-cadence re-checks. (No more bash_wait / bash_kill — the generic\n *    surface covers it.)\n *  - `timeout` is now a real kill deadline. The Spawn aborts itself when\n *    it elapses; the streamable's `done` resolves with `killReason: \"timeout\"`\n *    in the snapshot. Defaults to 10 minutes (long enough for builds, tests,\n *    installs); pass shorter for tighter deadlines.\n *\n * Output truncation — large outputs are summarised inline as head + tail\n * (split from `max_lines`). Only when truncation actually fires does\n * the tool flush the captured bytes to a per-spawn log file under\n * `tmpdir()/zaly-bash/` and surface `truncated.fullOutputPath`; small\n * outputs that fit inline never touch disk. The model can `read({ path })`\n * the surfaced log to inspect the full bytes.\n *\n * Cancellation — `ctx.signal` (agent abort) propagates to the spawn.\n * `task_stop(id)` calls the streamable's `abort()`, which aborts the spawn.\n */\nconst DEFAULT_TIMEOUT_MS = 600_000 // 10 min — real kill deadline\nconst DEFAULT_MAX_BUFFER = 5 * 1024 * 1024 // 5 MB\n\n// oxlint-disable-next-line sort-keys -- semantic field order: name, desc, params, call\nexport const bashTool = defineTool({\n  name: \"bash\",\n  desc:\n    \"Run a bash command. Returns its output once the command exits, or a \" +\n    \"partial snapshot if the command is still running after the harness's \" +\n    \"grace window — in that case the eventual result arrives as a system \" +\n    \"message. Its result then arrives automatically when it finishes; use \" +\n    \"`task_poll` to peek at output, `task_stop` to terminate one. `timeout` \" +\n    \"is a real kill deadline.\",\n  params: Type.Object({\n    command: Type.String({ description: \"The shell command to run, evaluated by `bash -c`.\" }),\n    description: Type.Optional(\n      Type.String({\n        description:\n          \"Short, human-readable description of what this command does. \" +\n          \"Shown to the user in the TUI alongside the command. Keep it under \" +\n          \"~10 words. Don't restate the command itself — describe the intent \" +\n          '(e.g. \"check the test suite passes\", not \"run bun test\").',\n      })\n    ),\n    max_lines: Type.Optional(\n      Type.Integer({\n        default: 200,\n        description:\n          \"Cap on lines kept inline in the result. Split as head + tail \" +\n          \"(half each). Lower for commands you only need pass/fail on \" +\n          \"(`max_lines: 20`); raise when middle output matters. Output \" +\n          \"above the cap is elided in the inline result, but the full \" +\n          \"log is always written to disk and surfaced as \" +\n          \"`truncated.fullOutputPath` — `read` it if you need to dig deeper.\",\n        minimum: 10,\n      })\n    ),\n    timeout: Type.Optional(\n      Type.Integer({\n        default: DEFAULT_TIMEOUT_MS,\n        description:\n          \"Kill deadline in ms. The process IS killed when this elapses (SIGTERM → SIGKILL).\",\n        minimum: 1,\n      })\n    ),\n  }),\n\n  async preflight(args, ctx) {\n    // Permission gate. The bash handler validates the parsed command\n    // (segments, redirects, sensitive paths) and composes file-scope\n    // checks for any redirect targets via `ctx.validate`.\n    await ctx.need?.(\"bash\", args.command)\n  },\n\n  async call(args, ctx): Promise<Streamable> {\n    const cwd = normPath(ctx.cwd)\n    const timeout = args.timeout\n    const startedAt = Date.now()\n\n    // Buffer in memory; only flip to disk if a snapshot reports the\n    // output exceeded the inline cap.\n    const { stream, startTailing } = bufferedTailStream(new TextStream())\n    const logState: { path?: string } = {}\n    const logPath = (): string => {\n      if (!logState.path) {\n        logState.path = join(\n          ctx.sessionDir ?? join(tmpdir(), \"zaly-bash\"),\n          `bash-${randomHash()}.log`\n        )\n        startTailing(logState.path)\n      }\n      return logState.path\n    }\n\n    const proc = new Spawn(args.command, [], {\n      bash: true,\n      cwd,\n      maxBuffer: DEFAULT_MAX_BUFFER,\n      signal: ctx.signal,\n      stderr: stream,\n      stdout: stream,\n      timeout,\n    })\n\n    const cursor = { combined: 0 }\n\n    return {\n      abort: () => {\n        if (!proc.done) proc.abort({ delay: 5000 })\n      },\n      done: proc.result.then(\n        () => undefined,\n        () => undefined\n      ),\n      // Non-consuming check used by heartbeats: is there incremental\n      // output the model hasn't seen since the last `poll()`? Lets the\n      // heartbeat flag this task with `*new*` without advancing the\n      // cursor (which would consume the bytes for any later poll).\n      hasNew: () => proc.stdout.length > cursor.combined,\n      poll: () => snapshot({ cursor, logPath, maxLines: args.max_lines ?? 200, proc, startedAt }),\n    }\n  },\n})\n\n// ── Internals ─────────────────────────────────────────────────────────\n\ninterface SnapshotOpts {\n  proc: Spawn<string, string>\n  startedAt: number\n  /** Lazily allocate the log path on first call — flips\n   *  bufferedTailStream into tailing mode so subsequent chunks land on\n   *  disk too. Idempotent. */\n  logPath: () => string\n  cursor: { combined: number }\n  maxLines: number\n}\n\n/** Build the current `ToolResult` snapshot for a running or exited bash\n *  command. Slices incremental output since the last poll, summarises\n *  it head+tail, and stamps a `<bash>` MetaPart with status info. */\nfunction snapshot({\n  proc,\n  startedAt,\n  logPath,\n  cursor,\n  maxLines,\n}: SnapshotOpts): ToolResult & { running: boolean } {\n  // Slice incremental combined output since the cursor and advance.\n  let text = proc.stdout.slice(cursor.combined)\n  cursor.combined += text.length // cursor is over bytes, not cleaned text\n\n  // clean text, but keep styles. Styles are stripped in the provider\n  // content transform pipelines\n  text = cleanTextTui(text)\n\n  const status: \"exited\" | \"running\" = proc.done ? \"exited\" : \"running\"\n  const meta: Record<string, unknown> = {\n    durationMs: Date.now() - startedAt,\n    status,\n  }\n  if (status === \"exited\") {\n    meta.code = proc.exitCode ?? -1\n    if (proc.killReason) meta.killReason = proc.killReason\n  }\n\n  const summary = truncate(text, { maxLines, strategy: \"head+tail\" })\n  if (summary.truncated) {\n    const log = logPath()\n    meta.truncated = {\n      fullOutputPath: log,\n      totalLines: summary.origLines,\n    }\n  }\n\n  const parts: (MetaPart | TextPart)[] = [{ data: meta, tag: \"bash\", type: \"meta\" }]\n  if (summary.text !== \"\") parts.push({ text: summary.text, type: \"text\" })\n\n  return {\n    content: parts,\n    isError: false,\n    running: !proc.done,\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CA,MAAM,qBAAqB;AAC3B,MAAM,qBAAqB;AAG3B,MAAa,WAAW,WAAW;CACjC,MAAM;CACN,MACE;CAMF,QAAQ,KAAK,OAAO;EAClB,SAAS,KAAK,OAAO,EAAE,aAAa,oDAAoD,CAAC;EACzF,aAAa,KAAK,SAChB,KAAK,OAAO,EACV,aACE,iQAIJ,CAAC,CACH;EACA,WAAW,KAAK,SACd,KAAK,QAAQ;GACX,SAAS;GACT,aACE;GAMF,SAAS;EACX,CAAC,CACH;EACA,SAAS,KAAK,SACZ,KAAK,QAAQ;GACX,SAAS;GACT,aACE;GACF,SAAS;EACX,CAAC,CACH;CACF,CAAC;CAED,MAAM,UAAU,MAAM,KAAK;EAIzB,MAAM,IAAI,OAAO,QAAQ,KAAK,OAAO;CACvC;CAEA,MAAM,KAAK,MAAM,KAA0B;EACzC,MAAM,MAAM,SAAS,IAAI,GAAG;EAC5B,MAAM,UAAU,KAAK;EACrB,MAAM,YAAY,KAAK,IAAI;EAI3B,MAAM,EAAE,QAAQ,iBAAiB,mBAAmB,IAAI,WAAW,CAAC;EACpE,MAAM,WAA8B,CAAC;EACrC,MAAM,gBAAwB;GAC5B,IAAI,CAAC,SAAS,MAAM;IAClB,SAAS,OAAO,KACd,IAAI,cAAc,KAAK,OAAO,GAAG,WAAW,GAC5C,QAAQ,WAAW,EAAE,KACvB;IACA,aAAa,SAAS,IAAI;GAC5B;GACA,OAAO,SAAS;EAClB;EAEA,MAAM,OAAO,IAAI,MAAM,KAAK,SAAS,CAAC,GAAG;GACvC,MAAM;GACN;GACA,WAAW;GACX,QAAQ,IAAI;GACZ,QAAQ;GACR,QAAQ;GACR;EACF,CAAC;EAED,MAAM,SAAS,EAAE,UAAU,EAAE;EAE7B,OAAO;GACL,aAAa;IACX,IAAI,CAAC,KAAK,MAAM,KAAK,MAAM,EAAE,OAAO,IAAK,CAAC;GAC5C;GACA,MAAM,KAAK,OAAO,WACV,KAAA,SACA,KAAA,CACR;GAKA,cAAc,KAAK,OAAO,SAAS,OAAO;GAC1C,YAAY,SAAS;IAAE;IAAQ;IAAS,UAAU,KAAK,aAAa;IAAK;IAAM;GAAU,CAAC;EAC5F;CACF;AACF,CAAC;;;;AAkBD,SAAS,SAAS,EAChB,MACA,WACA,SACA,QACA,YACkD;CAElD,IAAI,OAAO,KAAK,OAAO,MAAM,OAAO,QAAQ;CAC5C,OAAO,YAAY,KAAK;CAIxB,OAAO,aAAa,IAAI;CAExB,MAAM,SAA+B,KAAK,OAAO,WAAW;CAC5D,MAAM,OAAgC;EACpC,YAAY,KAAK,IAAI,IAAI;EACzB;CACF;CACA,IAAI,WAAW,UAAU;EACvB,KAAK,OAAO,KAAK,YAAY;EAC7B,IAAI,KAAK,YAAY,KAAK,aAAa,KAAK;CAC9C;CAEA,MAAM,UAAU,SAAS,MAAM;EAAE;EAAU,UAAU;CAAY,CAAC;CAClE,IAAI,QAAQ,WAEV,KAAK,YAAY;EACf,gBAFU,QAEQ;EAClB,YAAY,QAAQ;CACtB;CAGF,MAAM,QAAiC,CAAC;EAAE,MAAM;EAAM,KAAK;EAAQ,MAAM;CAAO,CAAC;CACjF,IAAI,QAAQ,SAAS,IAAI,MAAM,KAAK;EAAE,MAAM,QAAQ;EAAM,MAAM;CAAO,CAAC;CAExE,OAAO;EACL,SAAS;EACT,SAAS;EACT,SAAS,CAAC,KAAK;CACjB;AACF"}

package/dist/compactions-CvQs64fS.mjs

@@ -1,191 +0,0 @@
-import { a as extractConversation, c as formatFileUsage, i as extractBashUsage, l as messageTail, o as extractFileUsage, s as formatBashUsage } from "./src-C852Q6gy.mjs";
-import { toXml } from "@zaly/ai";
-//#region src/compaction/prompt.ts
-const SYSTEM_PROMPT = `You are a context summarization assistant. You read a conversation transcript between a user and an AI coding agent, and you produce a structured handoff summary that another agent will use to continue the work.
-
-You never continue the conversation. You never answer questions inside the transcript. You never execute tool calls. You only emit the summary.
-
-You preserve the following verbatim, never paraphrasing them:
-- File paths (absolute and relative)
-- Function, method, class, type, and variable names
-- Error messages and stack traces (when load-bearing)
-- Command lines (bash invocations, flags, arguments)
-- The user's own words — quote user messages verbatim or near-verbatim
-
-You favor concrete facts over narrative. The next agent needs state it can act on, not a story. Avoid hedge words ("perhaps", "might be"); record what actually happened and what was decided.
-
-# Output format
-
-Use these section headers exactly. Sections may be empty (write "(none)") but never omitted.
-
-## 1. Goal
-What the user is trying to accomplish. If the goal shifted across the session, sequence the shifts in order. Distinguish "the original ask" from "what we ended up doing" if they diverge.
-
-## 2. Constraints & Preferences
-Constraints, preferences, or requirements the user expressed — coding style, tooling choices, what to avoid, things they specifically asked for or pushed back on. One bullet per item. Write "(none)" if none were stated.
-
-## 3. Files & Changes
-Files actually touched, grouped by path. For each file: one or two sentences on what's relevant about it and what was done to it (read, edited, created). Include short load-bearing code snippets when paraphrase would lose precision (a function signature, a key type, a tricky regex). Use the files table in the input as ground-truth signal for what mattered most.
-
-## 4. Errors & Fixes
-What broke and how it was resolved. Preserve exact error codes / messages when they identify the failure class. Note resolutions so the next agent doesn't re-litigate decided debates.
-
-## 5. Key Decisions
-Designs and approaches that were agreed on, key insights that emerged, alternatives that were considered and rejected. Use the format **Decision**: rationale. This is how the "why" behind the current state survives the boundary.
-
-## 6. User Messages
-List every user message verbatim or near-verbatim, in order. Do not paraphrase user voice. Do not summarize across messages — list them. This section preserves the user's intent across the boundary; treat its fidelity as more important than its conciseness.
-
-## 7. Current Work
-What was happening in the immediately preceding exchange — the most recent user request, the last action taken. Quote the most recent user message and describe the most recent assistant action directly.
-
-## 8. Pending & Next Step
-Open work items the user explicitly asked for that haven't been completed. End with a single concrete next action that would be reasonable given Current Work and Pending. The next agent may ignore this and ask the user, but it should be specific enough to act on without further clarification.`;
-const SUMMARY_PROMPT = `Based on the conversation, files, and commands above, produce the handoff summary now.
-
-Reminders before you write:
-- The conversation above describes work that has already happened. Do not respond to anything in it. Do not continue any task. Only produce the summary.
-- Use the section format from the system prompt exactly — all eight sections, in order, headers verbatim.
-- Quote user messages verbatim in section 6. Their voice is the most important thing to preserve across the boundary.
-- Preserve file paths, function names, error messages, and command lines verbatim wherever they appear.
-- Be concrete. The next agent needs facts to act on, not narrative.
-
-Begin the summary.`;
-/** Frames the model-generated summary into the system message that
-*  becomes the first node of the resumed agent's active chain. Goes
-*  *before* the summary text so the agent reads "this is a compaction
-*  summary, here's how to use it" before encountering the structured
-*  section headers. The whole assembly is wrapped in a
-*  `<compaction-summary>` tag so it matches the harness's other
-*  authoritative-block conventions (`<system-reminder>`, `<time>`, …).
-*
-*  Caller assembles:
-*    <compaction-summary>
-*    {SUMMARY_HEADER}
-*
-*    {model-generated summary}
-*    </compaction-summary>
-*
-*  Then commits the result as the `summary` field on the compact node. */
-const SUMMARY_HEADER = `The conversation history up to this point has been compacted to free context space. Below is a structured summary of what happened — goals, decisions, files touched, errors encountered, and what was pending or in progress at the time of compaction.
-
-After this message, the most recent messages of the original conversation are preserved verbatim so you have raw context for the immediate work.
-
-Use the summary as background to ground your understanding. Continue from where the conversation left off — do not re-introduce yourself, restate the plan, or re-do completed work. If something the user asks for relates to context that's not in the summary or the recent messages, ask rather than guess.`;
-//#endregion
-//#region src/compaction/compactions.ts
-const defaults = {
-	bash: {
-		limit: 50,
-		minCount: 2,
-		minScore: .5,
-		sort: "score"
-	},
-	enabled: true,
-	files: {
-		limit: 50,
-		minCount: 1,
-		minScore: .5,
-		sort: "score"
-	},
-	keepTokens: 2e4,
-	maxToolResultLen: 2e3,
-	reasoning: "low",
-	summaryTokens: 1e4,
-	threshold: .95
-};
-var Compaction = class {
-	#opts;
-	#agent;
-	constructor(agent, opts = {}) {
-		this.#agent = agent;
-		this.#opts = {
-			...defaults,
-			...opts
-		};
-	}
-	async compact(pressure) {
-		const { session } = this.#agent;
-		const masker = await this.#agent.ctx.masker();
-		const messages = masker ? await masker.mask(session.messages, pressure) : session.messages;
-		const now = performance.now();
-		const tail = messageTail(messages, { keepTokens: this.#opts.keepTokens });
-		const older = tail.length > 0 ? messages.slice(0, -tail.length) : messages;
-		if (older.length === 0) return;
-		const conversation = extractConversation(older, { maxToolResultLen: this.#opts.maxToolResultLen });
-		const bashUsage = formatBashUsage(extractBashUsage(messages, this.#opts.bash));
-		const fileUsage = formatFileUsage(extractFileUsage(messages, this.#opts.files));
-		const request = {
-			content: [
-				{
-					text: conversation,
-					type: "text"
-				},
-				{
-					text: fileUsage,
-					type: "text"
-				},
-				{
-					text: bashUsage,
-					type: "text"
-				},
-				{
-					text: SUMMARY_PROMPT,
-					type: "text"
-				}
-			],
-			role: "user"
-		};
-		const summary = await this.#summarize(request);
-		const summaryMessage = {
-			content: [
-				{
-					text: SUMMARY_HEADER,
-					type: "text"
-				},
-				{
-					text: toXml(summary, "compaction-summary", { indent: false }),
-					type: "text"
-				},
-				{
-					text: fileUsage,
-					type: "text"
-				},
-				{
-					text: bashUsage,
-					type: "text"
-				}
-			],
-			meta: { kind: "compaction-summary" },
-			role: "system"
-		};
-		await session.compact({
-			durationMs: Math.round(performance.now() - now),
-			preTokens: this.#agent.contextSize,
-			summary: summaryMessage,
-			tail: tail.length,
-			trigger: this.#opts.trigger
-		});
-		masker?.reset();
-	}
-	async #summarize(message) {
-		const model = this.#agent.model;
-		if (!model) throw new Error("model must be loaded to compact");
-		const m = await model.stream({
-			messages: [message],
-			prompt: [SYSTEM_PROMPT],
-			sessionId: this.#agent.session.id
-		}, {
-			caching: false,
-			maxTokens: this.#opts.summaryTokens,
-			reasoning: this.#opts.reasoning ? { effort: this.#opts.reasoning } : void 0,
-			signal: this.#opts.signal
-		});
-		if (typeof m.content === "string") return m.content;
-		return m.content.filter((p) => p.type === "text").map((p) => p.text).join("\n");
-	}
-};
-//#endregion
-export { Compaction };
-
-//# sourceMappingURL=compactions-CvQs64fS.mjs.map

package/dist/compactions-CvQs64fS.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"compactions-CvQs64fS.mjs","names":[],"sources":["../src/compaction/prompt.ts","../src/compaction/compactions.ts"],"sourcesContent":["/* Prompts for the compaction summarizer.\n *\n * The summarizer is a separate model call whose job is to compress an\n * older slice of conversation into a structured handoff document. The\n * resulting summary is committed to the session as a `compact` node and\n * becomes part of the resumed agent's active chain — so it must be\n * self-contained: a fresh agent reading only this summary should be\n * able to continue the work without needing the original transcript.\n *\n * Three pieces, all conditional except the system prompt:\n *\n *  - `SYSTEM_PROMPT` — declarative, identity-framing, format spec. Sets\n *    the role and the rules that don't change per call. Models follow\n *    system-prompt rules harder; this is where \"do not continue the\n *    conversation\" lives.\n *\n *  - `SUMMARY_PROMPT` — imperative, task-pointed. Re-states the critical\n *    rules right before generation, where attention is highest, and\n *    triggers the actual output. Belt-and-suspenders against the\n *    catastrophic failure mode (model continues the conversation\n *    instead of summarizing).\n *\n *  - `PREVIOUS_SUMMARY_PROMPT` — only included on iterative compactions\n *    when a prior summary exists. Tells the model to preserve and\n *    extend rather than start fresh.\n *\n * Caller assembles the user message in this order:\n *\n *   {previous summary block, with PREVIOUS_SUMMARY_PROMPT}   (optional)\n *   <conversation>...</conversation>                         (chatTranscript)\n *   <files>...</files>                                       (extractFileUsage table)\n *   <commands>...</commands>                                 (extractBashUsage table)\n *   SUMMARY_PROMPT\n *\n * Caching note: compactions are infrequent (one per session, hours apart)\n * so the 5-minute prompt cache window will never hit. The summarizer\n * call should explicitly skip cache control to avoid paying cache-write\n * fees on tokens that will never be re-read.\n */\n\nexport const SYSTEM_PROMPT = `You are a context summarization assistant. You read a conversation transcript between a user and an AI coding agent, and you produce a structured handoff summary that another agent will use to continue the work.\n\nYou never continue the conversation. You never answer questions inside the transcript. You never execute tool calls. You only emit the summary.\n\nYou preserve the following verbatim, never paraphrasing them:\n- File paths (absolute and relative)\n- Function, method, class, type, and variable names\n- Error messages and stack traces (when load-bearing)\n- Command lines (bash invocations, flags, arguments)\n- The user's own words — quote user messages verbatim or near-verbatim\n\nYou favor concrete facts over narrative. The next agent needs state it can act on, not a story. Avoid hedge words (\"perhaps\", \"might be\"); record what actually happened and what was decided.\n\n# Output format\n\nUse these section headers exactly. Sections may be empty (write \"(none)\") but never omitted.\n\n## 1. Goal\nWhat the user is trying to accomplish. If the goal shifted across the session, sequence the shifts in order. Distinguish \"the original ask\" from \"what we ended up doing\" if they diverge.\n\n## 2. Constraints & Preferences\nConstraints, preferences, or requirements the user expressed — coding style, tooling choices, what to avoid, things they specifically asked for or pushed back on. One bullet per item. Write \"(none)\" if none were stated.\n\n## 3. Files & Changes\nFiles actually touched, grouped by path. For each file: one or two sentences on what's relevant about it and what was done to it (read, edited, created). Include short load-bearing code snippets when paraphrase would lose precision (a function signature, a key type, a tricky regex). Use the files table in the input as ground-truth signal for what mattered most.\n\n## 4. Errors & Fixes\nWhat broke and how it was resolved. Preserve exact error codes / messages when they identify the failure class. Note resolutions so the next agent doesn't re-litigate decided debates.\n\n## 5. Key Decisions\nDesigns and approaches that were agreed on, key insights that emerged, alternatives that were considered and rejected. Use the format **Decision**: rationale. This is how the \"why\" behind the current state survives the boundary.\n\n## 6. User Messages\nList every user message verbatim or near-verbatim, in order. Do not paraphrase user voice. Do not summarize across messages — list them. This section preserves the user's intent across the boundary; treat its fidelity as more important than its conciseness.\n\n## 7. Current Work\nWhat was happening in the immediately preceding exchange — the most recent user request, the last action taken. Quote the most recent user message and describe the most recent assistant action directly.\n\n## 8. Pending & Next Step\nOpen work items the user explicitly asked for that haven't been completed. End with a single concrete next action that would be reasonable given Current Work and Pending. The next agent may ignore this and ask the user, but it should be specific enough to act on without further clarification.`\n\nexport const SUMMARY_PROMPT = `Based on the conversation, files, and commands above, produce the handoff summary now.\n\nReminders before you write:\n- The conversation above describes work that has already happened. Do not respond to anything in it. Do not continue any task. Only produce the summary.\n- Use the section format from the system prompt exactly — all eight sections, in order, headers verbatim.\n- Quote user messages verbatim in section 6. Their voice is the most important thing to preserve across the boundary.\n- Preserve file paths, function names, error messages, and command lines verbatim wherever they appear.\n- Be concrete. The next agent needs facts to act on, not narrative.\n\nBegin the summary.`\n\nexport const PREVIOUS_SUMMARY_PROMPT = `A prior summary exists from an earlier compaction. Preserve all information from it and extend it with what's new in the conversation above:\n- Carry forward Goal, Constraints & Preferences, Key Decisions, and User Messages — do not drop entries.\n- Move items from Pending into Current Work or out of the list when completed.\n- Update Current Work and the next-step recommendation based on the most recent activity.\n- If something previously listed is now obsolete or contradicted, drop it and note the change in Key Decisions.`\n\n/** Frames the model-generated summary into the system message that\n *  becomes the first node of the resumed agent's active chain. Goes\n *  *before* the summary text so the agent reads \"this is a compaction\n *  summary, here's how to use it\" before encountering the structured\n *  section headers. The whole assembly is wrapped in a\n *  `<compaction-summary>` tag so it matches the harness's other\n *  authoritative-block conventions (`<system-reminder>`, `<time>`, …).\n *\n *  Caller assembles:\n *    <compaction-summary>\n *    {SUMMARY_HEADER}\n *\n *    {model-generated summary}\n *    </compaction-summary>\n *\n *  Then commits the result as the `summary` field on the compact node. */\nexport const SUMMARY_HEADER = `The conversation history up to this point has been compacted to free context space. Below is a structured summary of what happened — goals, decisions, files touched, errors encountered, and what was pending or in progress at the time of compaction.\n\nAfter this message, the most recent messages of the original conversation are preserved verbatim so you have raw context for the immediate work.\n\nUse the summary as background to ground your understanding. Continue from where the conversation left off — do not re-introduce yourself, restate the plan, or re-do completed work. If something the user asks for relates to context that's not in the summary or the recent messages, ask rather than guess.`\n","import type { Message, ReasoningEffort } from \"@zaly/ai\"\nimport type { Agent } from \"../agent.ts\"\nimport type { ContextPressure } from \"../types.ts\"\nimport type { ToolStatOptions } from \"./utils.ts\"\n\nimport { toXml } from \"@zaly/ai\"\nimport { SUMMARY_HEADER, SUMMARY_PROMPT, SYSTEM_PROMPT } from \"./prompt.ts\"\nimport {\n  extractBashUsage,\n  extractConversation,\n  extractFileUsage,\n  formatBashUsage,\n  formatFileUsage,\n  messageTail,\n} from \"./utils.ts\"\n\nexport type CompactionOptions = {\n  enabled: boolean\n  threshold?: number\n  /** Existing messages up to this many tokens will be preserved in the context */\n  keepTokens: number\n  maxToolResultLen: number\n  summaryTokens: number\n  bash: ToolStatOptions\n  files: ToolStatOptions\n  signal?: AbortSignal\n  reasoning?: ReasoningEffort\n  trigger?: \"manual\" | \"auto\"\n}\n\nconst defaults: CompactionOptions = {\n  bash: { limit: 50, minCount: 2, minScore: 0.5, sort: \"score\" },\n  enabled: true,\n  files: { limit: 50, minCount: 1, minScore: 0.5, sort: \"score\" },\n  keepTokens: 20_000,\n  maxToolResultLen: 2000,\n  reasoning: \"low\",\n  summaryTokens: 10_000,\n  threshold: 0.95,\n}\n\nexport class Compaction {\n  #opts: CompactionOptions\n  #agent: Agent\n\n  constructor(agent: Agent, opts: Partial<CompactionOptions> = {}) {\n    this.#agent = agent\n    this.#opts = { ...defaults, ...opts }\n  }\n\n  async compact(pressure: ContextPressure): Promise<void> {\n    const { session } = this.#agent\n\n    const masker = await this.#agent.ctx.masker()\n\n    const messages = masker ? await masker.mask(session.messages, pressure) : session.messages\n\n    const now = performance.now()\n\n    const tail = messageTail(messages, { keepTokens: this.#opts.keepTokens })\n    const older = tail.length > 0 ? messages.slice(0, -tail.length) : messages\n\n    if (older.length === 0) return\n\n    const conversation = extractConversation(\n      // Conversation summary is based on the older messages, not the tail — the tail is what we keep\n      older,\n      { maxToolResultLen: this.#opts.maxToolResultLen }\n    )\n\n    const bashUsage = formatBashUsage(extractBashUsage(messages, this.#opts.bash))\n    const fileUsage = formatFileUsage(extractFileUsage(messages, this.#opts.files))\n\n    const request: Message<\"user\"> = {\n      content: [\n        { text: conversation, type: \"text\" },\n        { text: fileUsage, type: \"text\" },\n        { text: bashUsage, type: \"text\" },\n        { text: SUMMARY_PROMPT, type: \"text\" },\n      ],\n      role: \"user\",\n    }\n\n    const summary = await this.#summarize(request)\n    // The bash + file usage tables are deterministic, ground-truth signals\n    // — pricier to ask the model to reproduce than to copy verbatim. Carry\n    // them through to the resumed agent so it has the same working-set\n    // visibility the summarizer had, without paying for output tokens.\n    const summaryMessage: Message<\"system\"> = {\n      content: [\n        { text: SUMMARY_HEADER, type: \"text\" },\n        { text: toXml(summary, \"compaction-summary\", { indent: false }), type: \"text\" },\n        { text: fileUsage, type: \"text\" },\n        { text: bashUsage, type: \"text\" },\n      ],\n      meta: { kind: \"compaction-summary\" },\n      role: \"system\",\n    }\n    await session.compact({\n      durationMs: Math.round(performance.now() - now),\n      preTokens: this.#agent.contextSize,\n      summary: summaryMessage,\n      tail: tail.length,\n      trigger: this.#opts.trigger,\n    })\n    masker?.reset()\n  }\n\n  async #summarize(message: Message<\"user\">): Promise<string> {\n    const model = this.#agent.model\n    if (!model) throw new Error(\"model must be loaded to compact\")\n    const m = await model.stream(\n      {\n        messages: [message],\n        prompt: [SYSTEM_PROMPT],\n        sessionId: this.#agent.session.id,\n      },\n      {\n        caching: false,\n        maxTokens: this.#opts.summaryTokens,\n        reasoning: this.#opts.reasoning ? { effort: this.#opts.reasoning } : undefined,\n        signal: this.#opts.signal,\n      }\n    )\n    if (typeof m.content === \"string\") return m.content\n    const parts = m.content.filter((p) => p.type === \"text\").map((p) => p.text)\n    return parts.join(\"\\n\")\n  }\n}\n"],"mappings":"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"}

package/dist/edit-D4yaBK1K.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"edit-D4yaBK1K.mjs","names":[],"sources":["../src/tools/edit.ts"],"sourcesContent":["import type { ToolContext } from \"@zaly/ai\"\nimport type { FileMeta } from \"../utils/file.ts\"\n\nimport { AiError, defineTool } from \"@zaly/ai\"\nimport { normPath } from \"@zaly/shared\"\nimport { detectEol, normalizeEol } from \"@zaly/shared/text\"\nimport { readFile, stat, writeFile } from \"node:fs/promises\"\nimport { Type } from \"typebox\"\n\nexport type EditTool = typeof editTool\nexport type EditToolMeta = FileMeta & {\n  /** File content before any edit was applied. */\n  original: string\n  /** File content after all edits were applied — exactly what's now on disk. */\n  content: string\n}\n\n/**\n * Apply one or more exact-text replacements to a file.\n *\n * Semantics:\n *   - All `oldText` matches are resolved against the *original* file\n *     content. Edits are not applied sequentially — so edit #1's\n *     `newText` cannot accidentally produce a match for edit #2's\n *     `oldText`.\n *   - Each `oldText` must occur exactly once in the file (uniqueness\n *     forces the model to disambiguate via context rather than guessing).\n *   - Edits must not overlap. Nearby changes should be combined into a\n *     single edit covering the surrounding block.\n *   - The file is rewritten atomically: either every edit applies\n *     cleanly or none do.\n *\n * Use `read` first to inspect the file. Keep `oldText` minimal but\n * uniquely identifying. For full-file rewrites, use `write` instead.\n */\n// oxlint-disable-next-line sort-keys -- semantic field order: name, desc, params, call\nexport const editTool = defineTool({\n  name: \"edit\",\n  desc:\n    \"Apply one or more exact-text replacements to a file. All matches are resolved \" +\n    \"against the original content (not sequentially), each `oldText` must be unique, \" +\n    \"and edits must not overlap. Atomic: all-or-nothing.\",\n  // oxlint-disable-next-line sort-keys -- semantic param order\n  params: Type.Object({\n    path: Type.String({ description: \"Path to the file. Absolute or cwd-relative.\" }),\n    edits: Type.Array(\n      // oxlint-disable-next-line sort-keys -- semantic order: oldText then newText\n      Type.Object({\n        oldText: Type.String({ description: \"Exact text to find. Must occur once.\" }),\n        newText: Type.String({ description: \"Replacement text.\" }),\n      }),\n      { description: \"Edits to apply atomically.\", minItems: 1 }\n    ),\n  }),\n\n  async preflight(args, ctx: ToolContext<EditToolMeta>) {\n    const path = normPath(ctx.cwd, args.path)\n    // Edits ride the `write` scope — they're mutations.\n    await ctx.need?.(\"write\", path)\n  },\n\n  async call(\n    args,\n    ctx: ToolContext<EditToolMeta>\n  ): Promise<{ ok: true; path: string; bytes: number; lines: number; edits: number }> {\n    const path = normPath(ctx.cwd, args.path)\n\n    const original = await readFile(path, \"utf8\").catch((error: unknown) => {\n      throw new AiError({\n        cause: error,\n        code: \"FILE_NOT_FOUND\",\n        message: `cannot edit ${path}: file not found`,\n      })\n    })\n\n    const updated = applyEdits(original, args.edits, path)\n    await writeFile(path, updated, \"utf8\")\n    const fstat = await stat(path)\n    ctx.meta = { content: updated, kind: \"edit\", mtime: fstat.mtimeMs, original, path }\n\n    const bytes = Buffer.byteLength(updated, \"utf8\")\n    const lines = countLines(updated)\n    return { bytes, edits: args.edits.length, lines, ok: true, path }\n  },\n})\n\ninterface EditSpec {\n  oldText: string\n  newText: string\n}\n\n/** Resolve all edit positions against `original`, validate uniqueness +\n *  non-overlap, then splice the replacements in.\n *\n *  Line-ending fidelity: the model always emits LF, but the file may be\n *  CRLF. We detect the file's eol once, then normalize each `oldText` /\n *  `newText` to that eol before matching/splicing. The result has the\n *  same line-ending style as the original file. */\nfunction applyEdits(original: string, edits: readonly EditSpec[], path: string): string {\n  const eol = detectEol({ path, text: original })\n  // 1. Locate every oldText. Reject not-found and non-unique up-front so\n  //    the model gets a precise error per failing edit rather than a\n  //    \"patch failed at line N\" mystery.\n  const matches: { start: number; end: number; newText: string; spec: EditSpec }[] = []\n  for (const [i, edit] of edits.entries()) {\n    const oldText = normalizeEol(edit.oldText, { eol })\n    const newText = normalizeEol(edit.newText, { eol })\n    if (oldText === \"\") {\n      throw new AiError({\n        code: \"EMPTY_OLD_TEXT\",\n        data: { editIndex: i },\n        message: `edit #${i}: oldText is empty (use \\`write\\` to create or fully replace a file)`,\n      })\n    }\n    const first = original.indexOf(oldText)\n    if (first === -1) {\n      throw new AiError({\n        code: \"NOT_FOUND\",\n        data: { editIndex: i, path, snippet: preview(oldText) },\n        message: `edit #${i}: oldText not found in ${path}`,\n      })\n    }\n    const next = original.indexOf(oldText, first + 1)\n    if (next !== -1) {\n      throw new AiError({\n        code: \"NOT_UNIQUE\",\n        data: { editIndex: i, occurrences: countOccurrences(original, oldText), path },\n        message:\n          `edit #${i}: oldText matches multiple locations in ${path}. ` +\n          `Add surrounding context to make it unique.`,\n      })\n    }\n    matches.push({\n      end: first + oldText.length,\n      newText,\n      spec: edit,\n      start: first,\n    })\n  }\n\n  // 2. Sort by start; verify no overlap. Equal start positions are\n  //    impossible because oldText is unique.\n  matches.sort((a, b) => a.start - b.start)\n  for (let i = 1; i < matches.length; i++) {\n    if (matches[i].start < matches[i - 1].end) {\n      throw new AiError({\n        code: \"OVERLAP\",\n        data: { a: matches[i - 1], b: matches[i] },\n        message:\n          `edits overlap in ${path}. ` +\n          `Combine adjacent changes into a single edit covering both.`,\n      })\n    }\n  }\n\n  // 3. Splice. Walk the original and emit untouched-prefix + replacement\n  //    chunks; cheaper than N independent string replacements.\n  const out: string[] = []\n  let cursor = 0\n  for (const m of matches) {\n    out.push(original.slice(cursor, m.start), m.newText)\n    cursor = m.end\n  }\n  out.push(original.slice(cursor))\n  return out.join(\"\")\n}\n\n/** Count lines the way an editor would — non-empty trailing line counts;\n *  a trailing newline doesn't add a phantom blank line. */\nfunction countLines(content: string): number {\n  if (content === \"\") return 0\n  let n = 1\n  for (const c of content) if (c === \"\\n\") n++\n  if (content.endsWith(\"\\n\")) n--\n  return n\n}\n\nfunction countOccurrences(haystack: string, needle: string): number {\n  let n = 0\n  let from = 0\n  for (;;) {\n    const i = haystack.indexOf(needle, from)\n    if (i === -1) return n\n    n++\n    from = i + needle.length\n  }\n}\n\nfunction preview(text: string): string {\n  const trimmed = text.trim().replaceAll(/\\s+/g, \" \")\n  return trimmed.length > 80 ? `${trimmed.slice(0, 79)}…` : trimmed\n}\n"],"mappings":"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"}

package/dist/fetch-VKhSWdEh.mjs

@@ -1,111 +0,0 @@
-import { defineTool, toAttachment } from "@zaly/ai";
-import { Type } from "typebox";
-//#region src/tools/fetch.ts
-const DEFAULT_MAX_BODY_BYTES = 262144;
-/**
-* Fetch a URL and return the response — JSON when the server speaks JSON,
-* raw text otherwise. Optional `jsonpath` filters the parsed JSON to a
-* subset, which keeps tokens down on chatty APIs.
-*
-* Scope: API endpoints. For HTML pages (browsing, content extraction),
-* the optional `@zaly/browser` package provides browser-backed tools that
-* return a structured a11y tree — much better than raw HTML through this
-* tool. Pointing this at an HTML URL works but the response is a string
-* blob the model has to slog through.
-*
-* Permissions: routes through the `fetch` scope when the agent wires up
-* tool-side permission checks. Until then, callers should restrict via
-* a wrapping permission layer (rule-based or explicit allowlist).
-*/
-const fetchTool = defineTool({
-	desc: "Fetch a URL and return the response. JSON responses are parsed; use `jsonpath` (e.g. `$.items[*].name`) to extract a subset and minimise tokens.Image & PDF are returned as attachments. Best for APIs — for web pages, use the browser tool.",
-	name: "fetch",
-	parallel: true,
-	params: Type.Object({
-		url: Type.String({ description: "Absolute URL." }),
-		method: Type.Optional(Type.Union([
-			Type.Literal("GET"),
-			Type.Literal("POST"),
-			Type.Literal("PUT"),
-			Type.Literal("PATCH"),
-			Type.Literal("DELETE")
-		], {
-			default: "GET",
-			description: "HTTP method."
-		})),
-		headers: Type.Optional(Type.Record(Type.String(), Type.String(), { description: "Request headers." })),
-		query: Type.Optional(Type.Record(Type.String(), Type.String(), { description: "Query string params, appended to the URL." })),
-		body: Type.Optional(Type.String({ description: "Request body as a string. For JSON, stringify it yourself and set `headers: { 'Content-Type': 'application/json' }`." })),
-		jsonpath: Type.Optional(Type.String({ description: "JSONPath expression applied to a JSON response, e.g. `$.items[*].name`. Returns the matched values as an array." }))
-	}),
-	async call(args) {
-		const t0 = Date.now();
-		const url = new URL(args.url);
-		if (args.query) for (const [k, v] of Object.entries(args.query)) url.searchParams.set(k, v);
-		const res = await fetch(url, {
-			body: args.body,
-			headers: args.headers,
-			method: args.method
-		});
-		const contentType = res.headers.get("content-type") ?? "";
-		const bytes = new Uint8Array(await res.arrayBuffer());
-		const meta = {
-			contentType: contentType || void 0,
-			durationMs: Date.now() - t0,
-			ok: res.ok,
-			status: res.status,
-			statusText: res.statusText
-		};
-		const { fileDetect } = await import("@zaly/shared/detect");
-		const file = await fileDetect({
-			data: bytes,
-			mime: contentType || void 0,
-			url: url.toString()
-		});
-		if (file) {
-			const att = await toAttachment(file);
-			if (att) return [{
-				data: meta,
-				tag: "fetch",
-				type: "meta"
-			}, att];
-		}
-		const text = new TextDecoder().decode(bytes);
-		const isJson = file?.type === "text" && file.format === "json";
-		let body = text;
-		if (isJson) try {
-			body = JSON.parse(text);
-		} catch {}
-		if (args.jsonpath !== void 0 && body !== text) {
-			const { JSONPath } = await import("./index-node-esm-CJsN8G51.mjs");
-			body = JSONPath({
-				json: body,
-				path: args.jsonpath
-			});
-		}
-		const bodyText = typeof body === "string" ? body : JSON.stringify(body, void 0, 2);
-		const totalBytes = Buffer.byteLength(bodyText, "utf8");
-		const truncated = totalBytes > DEFAULT_MAX_BODY_BYTES;
-		const displayed = truncated ? bodyText.slice(0, DEFAULT_MAX_BODY_BYTES) : bodyText;
-		if (truncated) meta.truncated = {
-			bytes: totalBytes,
-			hint: args.jsonpath === void 0 ? "body exceeded limit; pass `jsonpath` to filter, or use the browser tool for HTML." : "filtered body still exceeded limit; tighten the JSONPath expression.",
-			limit: DEFAULT_MAX_BODY_BYTES
-		};
-		const parts = [{
-			data: meta,
-			tag: "fetch",
-			type: "meta"
-		}];
-		if (displayed !== "") parts.push({
-			format: isJson ? "json" : void 0,
-			text: displayed,
-			type: "text"
-		});
-		return parts;
-	}
-});
-//#endregion
-export { fetchTool };
-
-//# sourceMappingURL=fetch-VKhSWdEh.mjs.map