@birdybeep/agent-core 0.0.1

package/dist/index.cjs

@@ -0,0 +1,1098 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AGENT_CORE_VERSION: () => AGENT_CORE_VERSION,
+  AGENT_SESSION_STATUSES: () => AGENT_SESSION_STATUSES,
+  APPROVAL_COLLAPSE_WINDOW_MS: () => APPROVAL_COLLAPSE_WINDOW_MS,
+  BIRDYBEEP_EVENT_TYPES: () => BIRDYBEEP_EVENT_TYPES,
+  BODY_MAX_CHARS: () => BODY_MAX_CHARS,
+  CLAIM_RECLAIM_MS: () => CLAIM_RECLAIM_MS,
+  DEFAULT_DEDUP_WINDOW_MS: () => DEFAULT_DEDUP_WINDOW_MS,
+  DEFAULT_DRAIN_MAX: () => DEFAULT_DRAIN_MAX,
+  DEFAULT_SEND_TIMEOUT_MS: () => DEFAULT_SEND_TIMEOUT_MS,
+  DEFAULT_TOTAL_BUDGET_MS: () => DEFAULT_TOTAL_BUDGET_MS,
+  ERROR_CODES: () => ERROR_CODES,
+  ERROR_STATUS: () => ERROR_STATUS,
+  FileTokenStore: () => FileTokenStore,
+  HARNESS_IDS: () => HARNESS_IDS,
+  INTEGRATION_STATUSES: () => INTEGRATION_STATUSES,
+  KeychainTokenStore: () => KeychainTokenStore,
+  LABEL_MAX_CHARS: () => LABEL_MAX_CHARS,
+  LocalEventQueue: () => LocalEventQueue,
+  MAX_AGENT_EVENT_BYTES: () => MAX_AGENT_EVENT_BYTES,
+  METADATA_MAX_DEPTH: () => METADATA_MAX_DEPTH,
+  METADATA_MAX_KEYS: () => METADATA_MAX_KEYS,
+  METADATA_VALUE_MAX_CHARS: () => METADATA_VALUE_MAX_CHARS,
+  NormalizeError: () => NormalizeError,
+  QUEUE_RETENTION_MS: () => QUEUE_RETENTION_MS,
+  RecentEventLedger: () => RecentEventLedger,
+  STATUS_REPORT_MAX_ITEMS: () => STATUS_REPORT_MAX_ITEMS,
+  STATUS_REPORT_MAX_PAYLOAD_BYTES: () => STATUS_REPORT_MAX_PAYLOAD_BYTES,
+  TITLE_MAX_CHARS: () => TITLE_MAX_CHARS,
+  agentEventsRequestSchema: () => agentEventsRequestSchema,
+  approvalCollapseIdentity: () => approvalCollapseIdentity,
+  birdyBeepAgentEventSchema: () => birdyBeepAgentEventSchema,
+  birdyBeepConfigDir: () => birdyBeepConfigDir,
+  birdyBeepDataDir: () => birdyBeepDataDir,
+  clearToken: () => clearToken,
+  collectMachineSignals: () => collectMachineSignals,
+  createSender: () => createSender,
+  defaultKeychainBackend: () => defaultKeychainBackend,
+  errorCodeSchema: () => errorCodeSchema,
+  errorEnvelopeSchema: () => errorEnvelopeSchema,
+  eventIdentity: () => eventIdentity,
+  eventMetadataSchema: () => eventMetadataSchema,
+  eventTypeSchema: () => eventTypeSchema,
+  fingerprintFromSignals: () => fingerprintFromSignals,
+  getMachineFingerprintHash: () => getMachineFingerprintHash,
+  getMachineIdentity: () => getMachineIdentity,
+  getMachineLabel: () => getMachineLabel,
+  getOS: () => getOS,
+  getToken: () => getToken,
+  harnessSchema: () => harnessSchema,
+  hashPath: () => hashPath,
+  integrationStatusItemSchema: () => integrationStatusItemSchema,
+  integrationStatusReportSchema: () => integrationStatusReportSchema,
+  integrationStatusResponseSchema: () => integrationStatusResponseSchema,
+  integrationStatusSchema: () => integrationStatusSchema,
+  isWithinMaxAgentEventSize: () => isWithinMaxAgentEventSize,
+  isoDateTimeSchema: () => isoDateTimeSchema,
+  machineSchema: () => machineSchema,
+  macosKeychainBackend: () => macosKeychainBackend,
+  normalizeEvent: () => normalizeEvent,
+  pairStartRequestSchema: () => pairStartRequestSchema,
+  pairStartResponseSchema: () => pairStartResponseSchema,
+  pairTokenRequestSchema: () => pairTokenRequestSchema,
+  pairTokenResponseSchema: () => pairTokenResponseSchema,
+  redactSecrets: () => redactSecrets,
+  resolveTokenStore: () => resolveTokenStore,
+  runAgentHook: () => runAgentHook,
+  scrubAbsolutePaths: () => scrubAbsolutePaths,
+  sessionStatusSchema: () => sessionStatusSchema,
+  setToken: () => setToken,
+  successEnvelopeSchema: () => successEnvelopeSchema,
+  truncate: () => truncate,
+  unavailableKeychainBackend: () => unavailableKeychainBackend,
+  workspaceSchema: () => workspaceSchema
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/adapter.ts
+var INTEGRATION_STATUSES = [
+  "installed",
+  "not_detected",
+  "needs_restart",
+  "needs_trust",
+  "error",
+  "revoked",
+  "unknown"
+];
+
+// src/api.ts
+var import_zod = require("zod");
+var ERROR_CODES = [
+  "validation_failed",
+  "unauthorized",
+  "forbidden",
+  "token_revoked",
+  "not_found",
+  "payload_too_large",
+  "rate_limited",
+  "quota_exceeded",
+  "internal_error"
+];
+var errorCodeSchema = import_zod.z.enum(ERROR_CODES);
+var errorEnvelopeSchema = import_zod.z.object({
+  error: import_zod.z.object({
+    code: errorCodeSchema,
+    message: import_zod.z.string(),
+    details: import_zod.z.unknown().optional()
+  }),
+  requestId: import_zod.z.string().optional()
+});
+var successEnvelopeSchema = (data) => import_zod.z.object({ data });
+var ERROR_STATUS = {
+  validation_failed: 400,
+  unauthorized: 401,
+  forbidden: 403,
+  token_revoked: 403,
+  not_found: 404,
+  payload_too_large: 413,
+  rate_limited: 429,
+  quota_exceeded: 429,
+  internal_error: 500
+};
+
+// src/dedup.ts
+var import_node_crypto = require("crypto");
+var import_node_fs = require("fs");
+var import_node_path2 = require("path");
+
+// src/paths.ts
+var import_node_os = require("os");
+var import_node_path = require("path");
+function baseDir(kind) {
+  const home = (0, import_node_os.homedir)();
+  if (process.platform === "win32") {
+    const local = process.env["LOCALAPPDATA"];
+    return local && local.length > 0 ? local : (0, import_node_path.join)(home, "AppData", "Local");
+  }
+  if (process.platform === "darwin") {
+    return (0, import_node_path.join)(home, "Library", "Application Support");
+  }
+  const xdg = kind === "data" ? process.env["XDG_DATA_HOME"] : process.env["XDG_CONFIG_HOME"];
+  if (xdg && xdg.length > 0) return xdg;
+  return (0, import_node_path.join)(home, kind === "data" ? (0, import_node_path.join)(".local", "share") : ".config");
+}
+function birdyBeepDataDir() {
+  return (0, import_node_path.join)(baseDir("data"), "birdybeep");
+}
+function birdyBeepConfigDir() {
+  return (0, import_node_path.join)(baseDir("config"), "birdybeep");
+}
+
+// src/dedup.ts
+var DEFAULT_DEDUP_WINDOW_MS = 1e4;
+var APPROVAL_COLLAPSE_WINDOW_MS = 1e3;
+function isLedgerEntry(v) {
+  return typeof v === "object" && v !== null && typeof v["id"] === "string" && typeof v["ts"] === "number";
+}
+function contentHash(title, body) {
+  return (0, import_node_crypto.createHash)("sha256").update(`${title}
+${body}`).digest("hex").slice(0, 16);
+}
+function eventIdentity(event) {
+  return `${event.harness}:${event.source_session_id}:${event.event_type}:${contentHash(
+    event.title,
+    event.body
+  )}`;
+}
+function approvalCollapseIdentity(event) {
+  return `${event.harness}:${event.source_session_id}:approval_required:any`;
+}
+var RecentEventLedger = class {
+  path;
+  #windowMs;
+  #now;
+  constructor(options = {}) {
+    this.path = options.path ?? (0, import_node_path2.join)(birdyBeepDataDir(), "recent-events.json");
+    this.#windowMs = options.windowMs ?? DEFAULT_DEDUP_WINDOW_MS;
+    this.#now = options.now ?? (() => Date.now());
+  }
+  #read() {
+    if (!(0, import_node_fs.existsSync)(this.path)) return [];
+    try {
+      const parsed = JSON.parse((0, import_node_fs.readFileSync)(this.path, "utf8"));
+      return Array.isArray(parsed) ? parsed.filter(isLedgerEntry) : [];
+    } catch {
+      return [];
+    }
+  }
+  #write(entries) {
+    const dir = (0, import_node_path2.dirname)(this.path);
+    (0, import_node_fs.mkdirSync)(dir, { recursive: true, mode: 448 });
+    if (process.platform !== "win32") (0, import_node_fs.chmodSync)(dir, 448);
+    const tmp = `${this.path}.tmp`;
+    (0, import_node_fs.writeFileSync)(tmp, JSON.stringify(entries), { mode: 384 });
+    (0, import_node_fs.renameSync)(tmp, this.path);
+    if (process.platform !== "win32") (0, import_node_fs.chmodSync)(this.path, 384);
+  }
+  /**
+   * If `identity` was recorded within the window, return true (it's a duplicate —
+   * caller should skip). Otherwise record it (pruning expired entries) and return
+   * false. `windowMs` narrows the duplicate check for THIS identity (e.g. the short
+   * approval-collapse window) — pruning always uses the ledger's own (max) window so
+   * a narrower check never evicts entries other checks still need. Fail-open: any
+   * I/O error returns false (allow the send).
+   */
+  markAndCheck(identity, windowMs = this.#windowMs) {
+    try {
+      const now = this.#now();
+      const pruneCutoff = now - this.#windowMs;
+      const dupCutoff = now - Math.min(windowMs, this.#windowMs);
+      const fresh = this.#read().filter((e) => e.ts >= pruneCutoff);
+      if (fresh.some((e) => e.id === identity && e.ts >= dupCutoff)) return true;
+      fresh.push({ id: identity, ts: now });
+      this.#write(fresh);
+      return false;
+    } catch {
+      return false;
+    }
+  }
+  clear() {
+    try {
+      if ((0, import_node_fs.existsSync)(this.path)) (0, import_node_fs.rmSync)(this.path, { force: true });
+    } catch {
+    }
+  }
+  /** Whether the ledger file has secure (0600) perms. True on Windows (ACL-based). */
+  isSecure() {
+    if (process.platform === "win32") return true;
+    try {
+      return ((0, import_node_fs.statSync)(this.path).mode & 63) === 0;
+    } catch {
+      return true;
+    }
+  }
+};
+
+// src/event.ts
+var import_zod3 = require("zod");
+
+// src/primitives.ts
+var import_zod2 = require("zod");
+var BIRDYBEEP_EVENT_TYPES = [
+  "session_started",
+  "session_resumed",
+  "session_active",
+  "needs_input",
+  "approval_required",
+  "agent_idle",
+  "agent_completed",
+  "agent_failed",
+  "test_failed",
+  "tool_started",
+  "tool_finished",
+  "subagent_started",
+  "subagent_completed",
+  "custom",
+  // "test" (9fh): the `birdybeep test` diagnostic. Notifies by default server-side
+  // (unlike "custom", which the §10.5 matrix suppresses unconditionally) and is
+  // quota-exempt — the product's DEFAULT_NOTIFY/gauntlet carry the other half.
+  "test"
+];
+var AGENT_SESSION_STATUSES = [
+  "starting",
+  "running",
+  "waiting_for_input",
+  "waiting_for_approval",
+  "idle",
+  "completed",
+  "failed",
+  "unknown"
+];
+var HARNESS_IDS = ["claude_code", "codex", "opencode"];
+var eventTypeSchema = import_zod2.z.enum(BIRDYBEEP_EVENT_TYPES);
+var sessionStatusSchema = import_zod2.z.enum(AGENT_SESSION_STATUSES);
+var harnessSchema = import_zod2.z.enum(HARNESS_IDS);
+var isoDateTimeSchema = import_zod2.z.iso.datetime({ offset: true });
+var MAX_AGENT_EVENT_BYTES = 16 * 1024;
+function isWithinMaxAgentEventSize(body) {
+  const bytes = typeof body === "number" ? body : body.byteLength;
+  return bytes <= MAX_AGENT_EVENT_BYTES;
+}
+
+// src/event.ts
+var machineSchema = import_zod3.z.object({
+  label: import_zod3.z.string().min(1),
+  os: import_zod3.z.string().min(1)
+});
+var workspaceSchema = import_zod3.z.object({
+  cwd: import_zod3.z.string().min(1),
+  repo_name: import_zod3.z.string().optional(),
+  branch: import_zod3.z.string().optional()
+});
+var eventMetadataSchema = import_zod3.z.object({
+  tool: import_zod3.z.string().optional(),
+  command_summary: import_zod3.z.string().optional()
+}).catchall(import_zod3.z.unknown());
+var birdyBeepAgentEventSchema = import_zod3.z.object({
+  event_id: import_zod3.z.string().min(1),
+  event_type: eventTypeSchema,
+  occurred_at: isoDateTimeSchema,
+  harness: harnessSchema,
+  harness_version: import_zod3.z.string().optional(),
+  source_session_id: import_zod3.z.string().min(1),
+  machine: machineSchema,
+  workspace: workspaceSchema,
+  status: sessionStatusSchema,
+  title: import_zod3.z.string(),
+  body: import_zod3.z.string(),
+  metadata: eventMetadataSchema.optional()
+});
+var agentEventsRequestSchema = birdyBeepAgentEventSchema;
+
+// src/fingerprint.ts
+var import_node_crypto2 = require("crypto");
+var import_node_os2 = require("os");
+function primaryMac() {
+  const ifaces = (0, import_node_os2.networkInterfaces)();
+  for (const list of Object.values(ifaces)) {
+    for (const entry of list ?? []) {
+      if (!entry.internal && entry.mac && entry.mac !== "00:00:00:00:00:00") return entry.mac;
+    }
+  }
+  return null;
+}
+function collectMachineSignals() {
+  return {
+    hostname: (0, import_node_os2.hostname)(),
+    platform: process.platform,
+    arch: process.arch,
+    cpuModel: (0, import_node_os2.cpus)()[0]?.model ?? "unknown",
+    totalmem: (0, import_node_os2.totalmem)(),
+    mac: primaryMac()
+  };
+}
+function fingerprintFromSignals(signals) {
+  const material = [
+    signals.platform,
+    signals.arch,
+    signals.hostname,
+    signals.cpuModel,
+    String(signals.totalmem),
+    signals.mac ?? ""
+  ].join("\0");
+  return (0, import_node_crypto2.createHash)("sha256").update(material).digest("hex");
+}
+function getMachineFingerprintHash(signals = collectMachineSignals()) {
+  return fingerprintFromSignals(signals);
+}
+function getOS(platform = process.platform) {
+  switch (platform) {
+    case "darwin":
+      return "macos";
+    case "win32":
+      return "windows";
+    case "linux":
+      return "linux";
+    default:
+      return platform;
+  }
+}
+function getMachineLabel(rawHostname = (0, import_node_os2.hostname)()) {
+  const label = rawHostname.replace(/\.local$/i, "").trim();
+  return label.length > 0 ? label : `${getOS()}-machine`;
+}
+function getMachineIdentity() {
+  return {
+    label: getMachineLabel(),
+    os: getOS(),
+    fingerprintHash: getMachineFingerprintHash()
+  };
+}
+
+// src/hook.ts
+async function runAgentHook(adapter, rawInput, options) {
+  let event;
+  try {
+    event = await adapter.normalizeEvent(rawInput);
+  } catch {
+    return { outcome: "skipped" };
+  }
+  const ledger = options.ledger ?? new RecentEventLedger();
+  const contentDup = ledger.markAndCheck(eventIdentity(event));
+  const approvalDup = event.event_type === "approval_required" && ledger.markAndCheck(approvalCollapseIdentity(event), APPROVAL_COLLAPSE_WINDOW_MS);
+  if (contentDup || approvalDup) {
+    return { outcome: "deduped", eventType: event.event_type };
+  }
+  const send = await options.sender.send(event);
+  return { outcome: send.outcome, eventType: event.event_type, send };
+}
+
+// src/integrations.ts
+var import_zod4 = require("zod");
+var integrationStatusSchema = import_zod4.z.enum(INTEGRATION_STATUSES);
+var STATUS_REPORT_MAX_ITEMS = 16;
+var STATUS_REPORT_MAX_PAYLOAD_BYTES = 2048;
+var integrationStatusItemSchema = import_zod4.z.object({
+  harness: harnessSchema,
+  status: integrationStatusSchema,
+  harness_version: import_zod4.z.string().max(64).optional(),
+  adapter_version: import_zod4.z.string().max(64).optional(),
+  last_status_payload: import_zod4.z.unknown().optional().refine((v) => v === void 0 || JSON.stringify(v).length <= STATUS_REPORT_MAX_PAYLOAD_BYTES, {
+    message: "last_status_payload too large"
+  })
+});
+var integrationStatusReportSchema = import_zod4.z.object({
+  integrations: import_zod4.z.array(integrationStatusItemSchema).min(1).max(STATUS_REPORT_MAX_ITEMS)
+});
+var integrationStatusResponseSchema = import_zod4.z.object({
+  integrations: import_zod4.z.array(
+    import_zod4.z.object({ harness: harnessSchema, status: integrationStatusSchema }).catchall(import_zod4.z.unknown())
+  )
+});
+
+// src/normalize.ts
+var import_node_crypto3 = require("crypto");
+var TITLE_MAX_CHARS = 200;
+var BODY_MAX_CHARS = 2e3;
+var METADATA_VALUE_MAX_CHARS = 500;
+var METADATA_MAX_KEYS = 64;
+var METADATA_MAX_DEPTH = 4;
+var LABEL_MAX_CHARS = 120;
+var NormalizeError = class extends Error {
+  constructor(message, issues) {
+    super(message);
+    this.issues = issues;
+    this.name = "NormalizeError";
+  }
+  issues;
+};
+function isString(v) {
+  return typeof v === "string";
+}
+function asRecord(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v) ? v : {};
+}
+function hashToken(value) {
+  return `h_${(0, import_node_crypto3.createHash)("sha256").update(value).digest("hex").slice(0, 16)}`;
+}
+var ABSOLUTE_PATH_RE = /(?:\/[A-Za-z0-9_.-]+){2,}|[A-Za-z]:(?:[\\/][A-Za-z0-9_. -]+)+/g;
+var SECRET_RES = [
+  /\bAKIA[0-9A-Z]{16}\b/g,
+  // AWS access key id
+  /\bgh[pousr]_[A-Za-z0-9]{20,}\b/g,
+  // GitHub tokens
+  /\bsk-[A-Za-z0-9_-]{16,}\b/g,
+  // OpenAI-style keys
+  /\bxox[baprs]-[A-Za-z0-9-]{10,}\b/g,
+  // Slack tokens
+  /\beyJ[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\b/g,
+  // JWT
+  /\b(?:bearer|token|secret|password|passwd|api[_-]?key)\b\s*[:=]\s*\S+/gi
+  // key=value secrets
+];
+function scrubAbsolutePaths(text) {
+  return text.replace(ABSOLUTE_PATH_RE, (match) => hashToken(match));
+}
+function redactSecrets(text) {
+  let out = text;
+  for (const re of SECRET_RES) out = out.replace(re, "[redacted]");
+  return out;
+}
+function truncate(text, max) {
+  return text.length <= max ? text : `${text.slice(0, Math.max(0, max - 1))}\u2026`;
+}
+function hashPath(path) {
+  return hashToken(path);
+}
+function cleanString(text, max) {
+  return truncate(redactSecrets(scrubAbsolutePaths(text)), max);
+}
+function sanitizeValue(value, depth) {
+  if (isString(value)) return cleanString(value, METADATA_VALUE_MAX_CHARS);
+  if (typeof value === "number" || typeof value === "boolean" || value === null) return value;
+  if (depth >= METADATA_MAX_DEPTH) return void 0;
+  if (Array.isArray(value)) {
+    return value.slice(0, METADATA_MAX_KEYS).map((v) => sanitizeValue(v, depth + 1));
+  }
+  if (typeof value === "object") {
+    const out = {};
+    let n = 0;
+    for (const [k, v] of Object.entries(value)) {
+      if (n >= METADATA_MAX_KEYS) break;
+      const cleaned = sanitizeValue(v, depth + 1);
+      if (cleaned !== void 0) {
+        out[cleanString(k, LABEL_MAX_CHARS)] = cleaned;
+        n++;
+      }
+    }
+    return out;
+  }
+  return void 0;
+}
+function serializedBytes(event) {
+  return Buffer.byteLength(JSON.stringify(event), "utf8");
+}
+function enforceSize(event) {
+  if (serializedBytes(event) <= MAX_AGENT_EVENT_BYTES) return event;
+  const steps = [
+    { ...event, metadata: void 0 },
+    { ...event, metadata: void 0, body: truncate(event.body, 256) },
+    {
+      ...event,
+      metadata: void 0,
+      body: truncate(event.body, 256),
+      title: truncate(event.title, 120)
+    }
+  ];
+  for (const candidate of steps) {
+    if (serializedBytes(candidate) <= MAX_AGENT_EVENT_BYTES) return candidate;
+  }
+  throw new NormalizeError("event exceeds max payload size even after shrinking");
+}
+function normalizeEvent(input, opts = {}) {
+  const rec = asRecord(input);
+  const ws = asRecord(rec["workspace"]);
+  const machine = asRecord(rec["machine"]);
+  const candidate = {
+    event_id: isString(rec["event_id"]) && rec["event_id"].length > 0 ? rec["event_id"] : opts.generateId?.() ?? `evt_local_${(0, import_node_crypto3.randomUUID)()}`,
+    event_type: rec["event_type"],
+    occurred_at: isString(rec["occurred_at"]) && rec["occurred_at"].length > 0 ? rec["occurred_at"] : opts.now?.() ?? (/* @__PURE__ */ new Date()).toISOString(),
+    harness: rec["harness"],
+    // source_session_id is a key (§10.3) — keep it stable, but never let a raw path through.
+    source_session_id: isString(rec["source_session_id"]) ? scrubAbsolutePaths(rec["source_session_id"]) : rec["source_session_id"],
+    machine: {
+      label: isString(machine["label"]) ? cleanString(machine["label"], LABEL_MAX_CHARS) : machine["label"],
+      os: isString(machine["os"]) ? cleanString(machine["os"], LABEL_MAX_CHARS) : machine["os"]
+    },
+    workspace: {
+      // cwd is an absolute path → always hashed (§15: no absolute path leaves the machine).
+      cwd: isString(ws["cwd"]) ? hashPath(ws["cwd"]) : ws["cwd"]
+    },
+    status: rec["status"],
+    title: isString(rec["title"]) ? cleanString(rec["title"], TITLE_MAX_CHARS) : rec["title"],
+    body: isString(rec["body"]) ? cleanString(rec["body"], BODY_MAX_CHARS) : rec["body"]
+  };
+  if (isString(rec["harness_version"])) {
+    candidate["harness_version"] = cleanString(rec["harness_version"], LABEL_MAX_CHARS);
+  }
+  const wsOut = candidate["workspace"];
+  if (isString(ws["repo_name"])) wsOut["repo_name"] = cleanString(ws["repo_name"], LABEL_MAX_CHARS);
+  if (isString(ws["branch"])) wsOut["branch"] = cleanString(ws["branch"], LABEL_MAX_CHARS);
+  if (rec["metadata"] !== void 0) {
+    candidate["metadata"] = sanitizeValue(rec["metadata"], 0);
+  }
+  const parsed = birdyBeepAgentEventSchema.safeParse(candidate);
+  if (!parsed.success) {
+    throw new NormalizeError("normalized event failed schema validation", parsed.error.issues);
+  }
+  return enforceSize(parsed.data);
+}
+
+// src/pairing.ts
+var import_zod5 = require("zod");
+var pairStartRequestSchema = import_zod5.z.object({
+  machine_label: import_zod5.z.string().min(1),
+  os: import_zod5.z.string().optional().catch(void 0),
+  cli_version: import_zod5.z.string().optional().catch(void 0),
+  requested_scopes: import_zod5.z.array(import_zod5.z.string()).optional().catch(void 0)
+});
+var pairTokenRequestSchema = import_zod5.z.object({
+  device_code: import_zod5.z.string().min(1),
+  machine_fingerprint: import_zod5.z.string().optional().catch(void 0)
+});
+var pairStartResponseSchema = import_zod5.z.object({
+  device_code: import_zod5.z.string(),
+  user_code: import_zod5.z.string(),
+  qr_payload: import_zod5.z.string(),
+  expires_at: isoDateTimeSchema
+});
+var pairTokenResponseSchema = import_zod5.z.object({
+  machine_token: import_zod5.z.string(),
+  machine_id: import_zod5.z.string()
+});
+
+// src/queue.ts
+var import_node_crypto4 = require("crypto");
+var import_node_fs2 = require("fs");
+var import_node_path3 = require("path");
+var QUEUE_RETENTION_MS = 24 * 60 * 60 * 1e3;
+var DEFAULT_DRAIN_MAX = 50;
+var CLAIM_RECLAIM_MS = 6e4;
+function isRecord(v) {
+  return typeof v === "object" && v !== null;
+}
+var LocalEventQueue = class {
+  dir;
+  #retentionMs;
+  #now;
+  constructor(options = {}) {
+    this.dir = options.dir ?? (0, import_node_path3.join)(birdyBeepDataDir(), "queue");
+    this.#retentionMs = options.retentionMs ?? QUEUE_RETENTION_MS;
+    this.#now = options.now ?? (() => Date.now());
+  }
+  /** Ensure the dir exists with 0700 perms; repair a too-permissive existing dir. */
+  #ensureDir() {
+    (0, import_node_fs2.mkdirSync)(this.dir, { recursive: true, mode: 448 });
+    if (process.platform !== "win32") (0, import_node_fs2.chmodSync)(this.dir, 448);
+  }
+  /** Park a normalized event on disk (atomic write, 0600). Never throws. */
+  enqueue(event) {
+    try {
+      this.#ensureDir();
+      const enqueuedAt = this.#now();
+      const name = `${enqueuedAt}-${(0, import_node_crypto4.randomUUID)()}.json`;
+      const finalPath = (0, import_node_path3.join)(this.dir, name);
+      const tmpPath = `${finalPath}.tmp`;
+      (0, import_node_fs2.writeFileSync)(tmpPath, JSON.stringify({ enqueuedAt, event }), { mode: 384 });
+      (0, import_node_fs2.renameSync)(tmpPath, finalPath);
+      if (process.platform !== "win32") (0, import_node_fs2.chmodSync)(finalPath, 384);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * Return orphaned `.claim` files (claims older than {@link CLAIM_RECLAIM_MS}) to the
+   * queue by renaming them back to their original `.json` name. The claim timestamp is
+   * embedded in the claim FILENAME (rename preserves mtime, so fs times would report
+   * the enqueue age, not the claim age — an active drain of an old entry must not be
+   * "reclaimed" out from under it). Racing reclaims are safe: rename losers ENOENT.
+   * Known window: a drainer SUSPENDED (not dead) >60s can resume after its claim was
+   * reclaimed and double-send — accepted, since 60s ≫ the 5s send budget (a claim that
+   * old almost always is a dead process) and the backend dedupe absorbs the repeat.
+   */
+  #reclaimOrphanedClaims(names) {
+    const cutoff = this.#now() - CLAIM_RECLAIM_MS;
+    for (const name of names) {
+      const m = /^(.+\.json)\.(\d+)-[0-9a-f-]+\.claim$/.exec(name);
+      if (!m || Number(m[2]) > cutoff) continue;
+      try {
+        (0, import_node_fs2.renameSync)((0, import_node_path3.join)(this.dir, name), (0, import_node_path3.join)(this.dir, m[1]));
+      } catch {
+      }
+    }
+  }
+  /** Read all non-expired entries (FIFO by enqueue time); prune expired/corrupt ones. */
+  #readFresh() {
+    if (!(0, import_node_fs2.existsSync)(this.dir)) return { fresh: [], pruned: 0 };
+    if (process.platform !== "win32") {
+      try {
+        (0, import_node_fs2.chmodSync)(this.dir, 448);
+      } catch {
+      }
+    }
+    let pruned = 0;
+    const fresh = [];
+    const cutoff = this.#now() - this.#retentionMs;
+    let names;
+    try {
+      names = (0, import_node_fs2.readdirSync)(this.dir);
+      this.#reclaimOrphanedClaims(names);
+      names = (0, import_node_fs2.readdirSync)(this.dir);
+    } catch {
+      return { fresh: [], pruned: 0 };
+    }
+    for (const name of names) {
+      if (!name.endsWith(".json")) continue;
+      const path = (0, import_node_path3.join)(this.dir, name);
+      try {
+        const parsed = JSON.parse((0, import_node_fs2.readFileSync)(path, "utf8"));
+        const enqueuedAt = isRecord(parsed) ? parsed["enqueuedAt"] : void 0;
+        const event = isRecord(parsed) ? parsed["event"] : void 0;
+        if (typeof enqueuedAt !== "number" || !isRecord(event)) {
+          (0, import_node_fs2.rmSync)(path, { force: true });
+          pruned++;
+          continue;
+        }
+        if (enqueuedAt < cutoff) {
+          (0, import_node_fs2.rmSync)(path, { force: true });
+          pruned++;
+          continue;
+        }
+        fresh.push({ path, enqueuedAt, event });
+      } catch {
+        try {
+          (0, import_node_fs2.rmSync)(path, { force: true });
+        } catch {
+        }
+        pruned++;
+      }
+    }
+    fresh.sort((a, b) => a.enqueuedAt - b.enqueuedAt);
+    return { fresh, pruned };
+  }
+  /** Count of fresh (non-expired) queued events. Prunes expired entries as a side effect. */
+  size() {
+    return this.#readFresh().fresh.length;
+  }
+  /**
+   * Drain up to `max` fresh entries through `send`. Each entry is CLAIMED via an
+   * atomic rename before sending, so two concurrent drains never double-send the
+   * same event. delivered/drop remove the entry; retry keeps it for next time.
+   * Bounded + best-effort: never throws into the caller.
+   */
+  async drain(send, options = {}) {
+    const max = options.max ?? DEFAULT_DRAIN_MAX;
+    const result = { delivered: 0, dropped: 0, kept: 0, pruned: 0 };
+    let fresh;
+    try {
+      this.#ensureDir();
+      const read = this.#readFresh();
+      fresh = read.fresh;
+      result.pruned = read.pruned;
+    } catch {
+      return result;
+    }
+    for (const entry of fresh.slice(0, max)) {
+      if (options.stopWhen?.() === true) {
+        result.kept += 1;
+        continue;
+      }
+      const claim = `${entry.path}.${this.#now()}-${(0, import_node_crypto4.randomUUID)()}.claim`;
+      try {
+        (0, import_node_fs2.renameSync)(entry.path, claim);
+      } catch {
+        continue;
+      }
+      let outcome;
+      try {
+        outcome = await send(entry.event);
+      } catch {
+        outcome = "retry";
+      }
+      if (outcome === "retry") {
+        try {
+          (0, import_node_fs2.renameSync)(claim, entry.path);
+        } catch {
+        }
+        result.kept++;
+      } else {
+        try {
+          (0, import_node_fs2.rmSync)(claim, { force: true });
+        } catch {
+        }
+        if (outcome === "delivered") result.delivered++;
+        else result.dropped++;
+      }
+    }
+    return result;
+  }
+  /** Remove every queued entry (used by `doctor` / debug tooling). Never throws. */
+  clear() {
+    if (!(0, import_node_fs2.existsSync)(this.dir)) return 0;
+    let removed = 0;
+    try {
+      for (const name of (0, import_node_fs2.readdirSync)(this.dir)) {
+        try {
+          (0, import_node_fs2.rmSync)((0, import_node_path3.join)(this.dir, name), { force: true });
+          removed++;
+        } catch {
+        }
+      }
+    } catch {
+    }
+    return removed;
+  }
+  /** Whether the queue dir has secure (0700) perms. Returns true on Windows (ACL-based). */
+  isSecure() {
+    if (process.platform === "win32") return true;
+    try {
+      return ((0, import_node_fs2.statSync)(this.dir).mode & 63) === 0;
+    } catch {
+      return false;
+    }
+  }
+};
+
+// src/token-store.ts
+var import_node_child_process = require("child_process");
+var import_node_fs3 = require("fs");
+var import_node_path4 = require("path");
+var import_node_util = require("util");
+var execFileAsync = (0, import_node_util.promisify)(import_node_child_process.execFile);
+var SERVICE = "birdybeep";
+var ACCOUNT = "machine-token";
+var FileTokenStore = class {
+  kind = "file";
+  path;
+  constructor(options = {}) {
+    this.path = options.path ?? (0, import_node_path4.join)(birdyBeepDataDir(), "token");
+  }
+  // Sync internals, Promise-returning to satisfy the TokenStore interface.
+  get() {
+    if (!(0, import_node_fs3.existsSync)(this.path)) return Promise.resolve(null);
+    this.#repairPerms();
+    const raw = (0, import_node_fs3.readFileSync)(this.path, "utf8").trim();
+    return Promise.resolve(raw.length > 0 ? raw : null);
+  }
+  set(token) {
+    const dir = (0, import_node_path4.dirname)(this.path);
+    (0, import_node_fs3.mkdirSync)(dir, { recursive: true, mode: 448 });
+    if (process.platform !== "win32") (0, import_node_fs3.chmodSync)(dir, 448);
+    const tmp = `${this.path}.tmp`;
+    (0, import_node_fs3.writeFileSync)(tmp, token, { mode: 384 });
+    (0, import_node_fs3.renameSync)(tmp, this.path);
+    if (process.platform !== "win32") (0, import_node_fs3.chmodSync)(this.path, 384);
+    return Promise.resolve();
+  }
+  clear() {
+    (0, import_node_fs3.rmSync)(this.path, { force: true });
+    return Promise.resolve();
+  }
+  /** Repair a too-permissive token file (§15.1: strict perms). POSIX only. */
+  #repairPerms() {
+    if (process.platform === "win32") return;
+    try {
+      if (((0, import_node_fs3.statSync)(this.path).mode & 63) !== 0) (0, import_node_fs3.chmodSync)(this.path, 384);
+    } catch {
+    }
+  }
+};
+var KeychainTokenStore = class {
+  kind = "keychain";
+  #backend;
+  constructor(backend) {
+    this.#backend = backend;
+  }
+  get() {
+    return this.#backend.get(SERVICE, ACCOUNT);
+  }
+  set(token) {
+    return this.#backend.set(SERVICE, ACCOUNT, token);
+  }
+  clear() {
+    return this.#backend.delete(SERVICE, ACCOUNT);
+  }
+};
+var unavailableKeychainBackend = {
+  available: false,
+  get: () => Promise.resolve(null),
+  set: () => Promise.reject(new Error("keychain unavailable")),
+  delete: () => Promise.resolve()
+};
+function macosKeychainBackend() {
+  return {
+    available: process.platform === "darwin",
+    async get(service, account) {
+      try {
+        const { stdout } = await execFileAsync("security", [
+          "find-generic-password",
+          "-s",
+          service,
+          "-a",
+          account,
+          "-w"
+        ]);
+        const value = stdout.replace(/\n$/, "");
+        return value.length > 0 ? value : null;
+      } catch {
+        return null;
+      }
+    },
+    async set(service, account, secret) {
+      await execFileAsync("security", [
+        "add-generic-password",
+        "-U",
+        "-s",
+        service,
+        "-a",
+        account,
+        "-w",
+        secret
+      ]);
+    },
+    async delete(service, account) {
+      try {
+        await execFileAsync("security", ["delete-generic-password", "-s", service, "-a", account]);
+      } catch {
+      }
+    }
+  };
+}
+function defaultKeychainBackend() {
+  if (process.platform === "darwin") return macosKeychainBackend();
+  return unavailableKeychainBackend;
+}
+function resolveTokenStore(options = {}) {
+  const backend = options.backend ?? defaultKeychainBackend();
+  if (backend.available) return new KeychainTokenStore(backend);
+  return new FileTokenStore(options.filePath !== void 0 ? { path: options.filePath } : {});
+}
+async function setToken(token, options = {}) {
+  const store = resolveTokenStore(options);
+  await store.set(token);
+  return store.kind;
+}
+async function getToken(options = {}) {
+  const backend = options.backend ?? defaultKeychainBackend();
+  if (backend.available) {
+    const fromKeychain = await new KeychainTokenStore(backend).get();
+    if (fromKeychain !== null) return fromKeychain;
+  }
+  const file = new FileTokenStore(options.filePath !== void 0 ? { path: options.filePath } : {});
+  return file.get();
+}
+async function clearToken(options = {}) {
+  const backend = options.backend ?? defaultKeychainBackend();
+  if (backend.available) await new KeychainTokenStore(backend).clear();
+  await new FileTokenStore(
+    options.filePath !== void 0 ? { path: options.filePath } : {}
+  ).clear();
+}
+
+// src/sender.ts
+var DEFAULT_SEND_TIMEOUT_MS = 3e3;
+var DEFAULT_TOTAL_BUDGET_MS = 5e3;
+var MIN_DRAIN_ATTEMPT_MS = 250;
+var AGENT_EVENTS_PATH = "/v1/agent-events";
+var EMPTY_DRAIN = { delivered: 0, dropped: 0, kept: 0, pruned: 0 };
+function classify(status, code) {
+  if (code === "rate_limited" || code === "internal_error") return "retry";
+  if (code !== void 0) return "drop";
+  if (status >= 500 || status === 429) return "retry";
+  return "drop";
+}
+function parseDecision(body) {
+  if (typeof body !== "object" || body === null) return void 0;
+  const decision = body["decision"];
+  return typeof decision === "string" ? decision : void 0;
+}
+function createSender(config) {
+  const baseUrl = config.baseUrl.replace(/\/$/, "");
+  const timeoutMs = config.timeoutMs ?? DEFAULT_SEND_TIMEOUT_MS;
+  const totalBudgetMs = config.totalBudgetMs ?? DEFAULT_TOTAL_BUDGET_MS;
+  const queue = config.queue ?? new LocalEventQueue();
+  const fetchImpl = config.fetchImpl ?? fetch;
+  const drainMax = config.drainMax ?? DEFAULT_DRAIN_MAX;
+  const clock = config.now ?? (() => Date.now());
+  async function attempt(event, token, attemptTimeoutMs = timeoutMs) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), attemptTimeoutMs);
+    try {
+      const res = await fetchImpl(`${baseUrl}${AGENT_EVENTS_PATH}`, {
+        method: "POST",
+        headers: { authorization: `Bearer ${token}`, "content-type": "application/json" },
+        body: JSON.stringify(event),
+        signal: controller.signal
+      });
+      if (res.status >= 200 && res.status < 300) {
+        const decision = parseDecision(await res.json().catch(() => void 0));
+        return { result: "delivered", status: res.status, decision };
+      }
+      let code;
+      try {
+        const body = await res.json();
+        const parsed = errorEnvelopeSchema.safeParse(body);
+        if (parsed.success) code = parsed.data.error.code;
+      } catch {
+      }
+      return { result: classify(res.status, code), status: res.status, code };
+    } catch {
+      return { result: "retry" };
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  function drainQueue(token, deadline) {
+    return queue.drain(
+      (e) => {
+        const remaining = deadline - clock();
+        return attempt(e, token, Math.max(1, Math.min(timeoutMs, remaining))).then((a) => a.result);
+      },
+      { max: drainMax, stopWhen: () => deadline - clock() < MIN_DRAIN_ATTEMPT_MS }
+    );
+  }
+  return {
+    async send(event) {
+      const deadline = clock() + totalBudgetMs;
+      const token = await getToken(config.tokenOptions);
+      if (token === null) {
+        queue.enqueue(event);
+        return { outcome: "queued" };
+      }
+      const a = await attempt(event, token, Math.min(timeoutMs, totalBudgetMs));
+      let outcome;
+      if (a.result === "delivered") {
+        outcome = "delivered";
+      } else if (a.result === "retry") {
+        queue.enqueue(event);
+        outcome = "queued";
+      } else {
+        outcome = "dropped";
+      }
+      const drained = await drainQueue(token, deadline);
+      const result = { outcome, drained };
+      if (a.status !== void 0) result.status = a.status;
+      if (a.code !== void 0) result.code = a.code;
+      if (a.decision !== void 0) result.decision = a.decision;
+      return result;
+    },
+    async drainNow() {
+      const token = await getToken(config.tokenOptions);
+      if (token === null) return EMPTY_DRAIN;
+      return drainQueue(token, clock() + totalBudgetMs);
+    }
+  };
+}
+
+// src/index.ts
+var AGENT_CORE_VERSION = "0.0.0";
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AGENT_CORE_VERSION,
+  AGENT_SESSION_STATUSES,
+  APPROVAL_COLLAPSE_WINDOW_MS,
+  BIRDYBEEP_EVENT_TYPES,
+  BODY_MAX_CHARS,
+  CLAIM_RECLAIM_MS,
+  DEFAULT_DEDUP_WINDOW_MS,
+  DEFAULT_DRAIN_MAX,
+  DEFAULT_SEND_TIMEOUT_MS,
+  DEFAULT_TOTAL_BUDGET_MS,
+  ERROR_CODES,
+  ERROR_STATUS,
+  FileTokenStore,
+  HARNESS_IDS,
+  INTEGRATION_STATUSES,
+  KeychainTokenStore,
+  LABEL_MAX_CHARS,
+  LocalEventQueue,
+  MAX_AGENT_EVENT_BYTES,
+  METADATA_MAX_DEPTH,
+  METADATA_MAX_KEYS,
+  METADATA_VALUE_MAX_CHARS,
+  NormalizeError,
+  QUEUE_RETENTION_MS,
+  RecentEventLedger,
+  STATUS_REPORT_MAX_ITEMS,
+  STATUS_REPORT_MAX_PAYLOAD_BYTES,
+  TITLE_MAX_CHARS,
+  agentEventsRequestSchema,
+  approvalCollapseIdentity,
+  birdyBeepAgentEventSchema,
+  birdyBeepConfigDir,
+  birdyBeepDataDir,
+  clearToken,
+  collectMachineSignals,
+  createSender,
+  defaultKeychainBackend,
+  errorCodeSchema,
+  errorEnvelopeSchema,
+  eventIdentity,
+  eventMetadataSchema,
+  eventTypeSchema,
+  fingerprintFromSignals,
+  getMachineFingerprintHash,
+  getMachineIdentity,
+  getMachineLabel,
+  getOS,
+  getToken,
+  harnessSchema,
+  hashPath,
+  integrationStatusItemSchema,
+  integrationStatusReportSchema,
+  integrationStatusResponseSchema,
+  integrationStatusSchema,
+  isWithinMaxAgentEventSize,
+  isoDateTimeSchema,
+  machineSchema,
+  macosKeychainBackend,
+  normalizeEvent,
+  pairStartRequestSchema,
+  pairStartResponseSchema,
+  pairTokenRequestSchema,
+  pairTokenResponseSchema,
+  redactSecrets,
+  resolveTokenStore,
+  runAgentHook,
+  scrubAbsolutePaths,
+  sessionStatusSchema,
+  setToken,
+  successEnvelopeSchema,
+  truncate,
+  unavailableKeychainBackend,
+  workspaceSchema
+});
+//# sourceMappingURL=index.cjs.map