@elie-laloum/outpost 4.2.0 → 6.0.1

package/dist/infrastructure/host-credentials.js

@@ -0,0 +1,89 @@
+import { constants } from "node:fs";
+import { lstat, open } from "node:fs/promises";
+import { join } from "node:path";
+import { OutpostError } from "../domain/errors.js";
+import { expandPath } from "./files.js";
+import { HOST_CREDENTIAL_LIMIT } from "./host-credentials.constants.js";
+export function resolveHostPath(source, environment = process.env) {
+    const home = source.home && environment[source.home.variable];
+    return home && source.home
+        ? join(expandPath(home), source.home.path)
+        : expandPath(source.path);
+}
+function missing(path, credential) {
+    const alternative = credential.alternative
+        ? `, or pass ${credential.alternative}`
+        : "";
+    return new OutpostError("configuration", `Account credentials were not found at ${path}. Run ${credential.login} on the host${alternative}. Outpost reads only this file and never reads the system keychain.`, { path });
+}
+export async function readHostCredential(credential, environment = process.env) {
+    const path = resolveHostPath(credential.source, environment);
+    const link = await lstat(path).catch((error) => {
+        if (error.code === "ENOENT" || error.code === "ENOTDIR")
+            throw missing(path, credential);
+        throw error;
+    });
+    if (!link.isFile())
+        throw new OutpostError("configuration", `Account credentials must be a regular file, not a link or directory: ${path}`, { path });
+    const handle = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW);
+    try {
+        const info = await handle.stat();
+        if (!info.isFile() || info.size > HOST_CREDENTIAL_LIMIT)
+            throw new OutpostError("configuration", `Account credentials must be a regular file of at most ${HOST_CREDENTIAL_LIMIT} bytes: ${path}`, { path });
+        const content = await handle.readFile("utf8");
+        return credential.select ? credential.select(content) : content;
+    }
+    finally {
+        await handle.close();
+    }
+}
+function stringEnd(text, start) {
+    for (let index = start + 1; index < text.length; index += 1) {
+        if (text[index] === '"')
+            return index + 1;
+        if (text[index] === "\\")
+            index += 1;
+    }
+    return text.length;
+}
+function withoutComments(text) {
+    let output = "";
+    for (let index = 0; index < text.length; index += 1) {
+        const pair = text.slice(index, index + 2);
+        if (text[index] === '"') {
+            const end = stringEnd(text, index);
+            output += text.slice(index, end);
+            index = end - 1;
+            continue;
+        }
+        if (pair === "//" || pair === "/*") {
+            const end = text.indexOf(pair === "//" ? "\n" : "*/", index + 2);
+            index = end === -1 ? text.length : end + (pair === "//" ? -1 : 1);
+            output += " ";
+            continue;
+        }
+        output += text[index];
+    }
+    return output;
+}
+function withoutTrailingCommas(text) {
+    const closing = /\s*[}\]]/y;
+    let output = "";
+    for (let index = 0; index < text.length; index += 1) {
+        if (text[index] === '"') {
+            const end = stringEnd(text, index);
+            output += text.slice(index, end);
+            index = end - 1;
+            continue;
+        }
+        closing.lastIndex = index + 1;
+        if (text[index] === "," && closing.test(text))
+            continue;
+        output += text[index];
+    }
+    return output;
+}
+export function parseJsonc(text) {
+    return JSON.parse(withoutTrailingCommas(withoutComments(text)));
+}
+//# sourceMappingURL=host-credentials.js.map

package/dist/infrastructure/host-credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-credentials.js","sourceRoot":"","sources":["../../src/infrastructure/host-credentials.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAKjC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAExE,MAAM,UAAU,eAAe,CAC7B,MAA0B,EAC1B,cAAiC,OAAO,CAAC,GAAG;IAE5C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9D,OAAO,IAAI,IAAI,MAAM,CAAC,IAAI;QACxB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QAC1C,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,OAAO,CAAC,IAAY,EAAE,UAA0B;IACvD,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW;QACxC,CAAC,CAAC,aAAa,UAAU,CAAC,WAAW,EAAE;QACvC,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,IAAI,YAAY,CACrB,eAAe,EACf,yCAAyC,IAAI,SAAS,UAAU,CAAC,KAAK,eAAe,WAAW,qEAAqE,EACrK,EAAE,IAAI,EAAE,CACT,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAA0B,EAC1B,cAAiC,OAAO,CAAC,GAAG;IAE5C,MAAM,IAAI,GAAG,eAAe,CAAC,UAAU,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAA4B,EAAE,EAAE;QACpE,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;YACrD,MAAM,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAClC,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;QAChB,MAAM,IAAI,YAAY,CACpB,eAAe,EACf,wEAAwE,IAAI,EAAE,EAC9E,EAAE,IAAI,EAAE,CACT,CAAC;IACJ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IAC3E,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,GAAG,qBAAqB;YACrD,MAAM,IAAI,YAAY,CACpB,eAAe,EACf,yDAAyD,qBAAqB,WAAW,IAAI,EAAE,EAC/F,EAAE,IAAI,EAAE,CACT,CAAC;QACJ,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC9C,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAClE,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,KAAa;IAC5C,KAAK,IAAI,KAAK,GAAG,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC5D,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG;YAAE,OAAO,KAAK,GAAG,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI;YAAE,KAAK,IAAI,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC;AACrB,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACnC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACjC,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC;YAChB,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YACnC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YACjE,KAAK,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAClE,MAAM,IAAI,GAAG,CAAC;YACd,SAAS;QACX,CAAC;QACD,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAY;IACzC,MAAM,OAAO,GAAG,WAAW,CAAC;IAC5B,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACnC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACjC,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC;YAChB,SAAS;QACX,CAAC;QACD,OAAO,CAAC,SAAS,GAAG,KAAK,GAAG,CAAC,CAAC;QAC9B,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QACxD,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC","sourcesContent":["import { constants } from \"node:fs\";\nimport { lstat, open } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport type {\n  HostCredential,\n  HostCredentialPath,\n} from \"../domain/agent.types.ts\";\nimport { OutpostError } from \"../domain/errors.ts\";\nimport { expandPath } from \"./files.ts\";\nimport { HOST_CREDENTIAL_LIMIT } from \"./host-credentials.constants.ts\";\n\nexport function resolveHostPath(\n  source: HostCredentialPath,\n  environment: NodeJS.ProcessEnv = process.env,\n): string {\n  const home = source.home && environment[source.home.variable];\n  return home && source.home\n    ? join(expandPath(home), source.home.path)\n    : expandPath(source.path);\n}\n\nfunction missing(path: string, credential: HostCredential): OutpostError {\n  const alternative = credential.alternative\n    ? `, or pass ${credential.alternative}`\n    : \"\";\n  return new OutpostError(\n    \"configuration\",\n    `Account credentials were not found at ${path}. Run ${credential.login} on the host${alternative}. Outpost reads only this file and never reads the system keychain.`,\n    { path },\n  );\n}\n\nexport async function readHostCredential(\n  credential: HostCredential,\n  environment: NodeJS.ProcessEnv = process.env,\n): Promise<string> {\n  const path = resolveHostPath(credential.source, environment);\n  const link = await lstat(path).catch((error: NodeJS.ErrnoException) => {\n    if (error.code === \"ENOENT\" || error.code === \"ENOTDIR\")\n      throw missing(path, credential);\n    throw error;\n  });\n  if (!link.isFile())\n    throw new OutpostError(\n      \"configuration\",\n      `Account credentials must be a regular file, not a link or directory: ${path}`,\n      { path },\n    );\n  const handle = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW);\n  try {\n    const info = await handle.stat();\n    if (!info.isFile() || info.size > HOST_CREDENTIAL_LIMIT)\n      throw new OutpostError(\n        \"configuration\",\n        `Account credentials must be a regular file of at most ${HOST_CREDENTIAL_LIMIT} bytes: ${path}`,\n        { path },\n      );\n    const content = await handle.readFile(\"utf8\");\n    return credential.select ? credential.select(content) : content;\n  } finally {\n    await handle.close();\n  }\n}\n\nfunction stringEnd(text: string, start: number): number {\n  for (let index = start + 1; index < text.length; index += 1) {\n    if (text[index] === '\"') return index + 1;\n    if (text[index] === \"\\\\\") index += 1;\n  }\n  return text.length;\n}\n\nfunction withoutComments(text: string): string {\n  let output = \"\";\n  for (let index = 0; index < text.length; index += 1) {\n    const pair = text.slice(index, index + 2);\n    if (text[index] === '\"') {\n      const end = stringEnd(text, index);\n      output += text.slice(index, end);\n      index = end - 1;\n      continue;\n    }\n    if (pair === \"//\" || pair === \"/*\") {\n      const end = text.indexOf(pair === \"//\" ? \"\\n\" : \"*/\", index + 2);\n      index = end === -1 ? text.length : end + (pair === \"//\" ? -1 : 1);\n      output += \" \";\n      continue;\n    }\n    output += text[index];\n  }\n  return output;\n}\n\nfunction withoutTrailingCommas(text: string): string {\n  const closing = /\\s*[}\\]]/y;\n  let output = \"\";\n  for (let index = 0; index < text.length; index += 1) {\n    if (text[index] === '\"') {\n      const end = stringEnd(text, index);\n      output += text.slice(index, end);\n      index = end - 1;\n      continue;\n    }\n    closing.lastIndex = index + 1;\n    if (text[index] === \",\" && closing.test(text)) continue;\n    output += text[index];\n  }\n  return output;\n}\n\nexport function parseJsonc(text: string): unknown {\n  return JSON.parse(withoutTrailingCommas(withoutComments(text)));\n}\n"]}

package/dist/infrastructure/inspection-path.js

@@ -4,10 +4,11 @@ export async function isDirectInspectionPath(path) {
     let current = resolve(path);
     if ((await realpath(current)) === current)
         return true;
-    if (process.platform !== "win32")
-        return false;
     while (true) {
-        if ((await lstat(current)).isSymbolicLink())
+        const info = await lstat(current);
+        // Root-owned POSIX links belong to the system layout, such as /var on macOS.
+        if (info.isSymbolicLink() &&
+            (process.platform === "win32" || info.uid !== 0))
             return false;
         const parent = dirname(current);
         if (parent === current)

package/dist/infrastructure/inspection-path.js.map

@@ -1 +1 @@
-{"version":3,"file":"inspection-path.js","sourceRoot":"","sources":["../../src/infrastructure/inspection-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAY;IACvD,IAAI,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAC/C,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,EAAE;YAAE,OAAO,KAAK,CAAC;QAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QACpC,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC","sourcesContent":["import { lstat, realpath } from \"node:fs/promises\";\nimport { dirname, resolve } from \"node:path\";\n\nexport async function isDirectInspectionPath(path: string): Promise<boolean> {\n  let current = resolve(path);\n  if ((await realpath(current)) === current) return true;\n  if (process.platform !== \"win32\") return false;\n  while (true) {\n    if ((await lstat(current)).isSymbolicLink()) return false;\n    const parent = dirname(current);\n    if (parent === current) return true;\n    current = parent;\n  }\n}\n"]}
+{"version":3,"file":"inspection-path.js","sourceRoot":"","sources":["../../src/infrastructure/inspection-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAY;IACvD,IAAI,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACvD,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QAClC,6EAA6E;QAC7E,IACE,IAAI,CAAC,cAAc,EAAE;YACrB,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;YAEhD,OAAO,KAAK,CAAC;QACf,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QACpC,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC","sourcesContent":["import { lstat, realpath } from \"node:fs/promises\";\nimport { dirname, resolve } from \"node:path\";\n\nexport async function isDirectInspectionPath(path: string): Promise<boolean> {\n  let current = resolve(path);\n  if ((await realpath(current)) === current) return true;\n  while (true) {\n    const info = await lstat(current);\n    // Root-owned POSIX links belong to the system layout, such as /var on macOS.\n    if (\n      info.isSymbolicLink() &&\n      (process.platform === \"win32\" || info.uid !== 0)\n    )\n      return false;\n    const parent = dirname(current);\n    if (parent === current) return true;\n    current = parent;\n  }\n}\n"]}

package/dist/infrastructure/journal.constants.d.ts

@@ -0,0 +1 @@
+export declare const verboseOnly: ReadonlySet<string>;

package/dist/infrastructure/journal.constants.js

@@ -0,0 +1,2 @@
+export const verboseOnly = new Set(["raw", "text-delta"]);
+//# sourceMappingURL=journal.constants.js.map

package/dist/infrastructure/journal.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.constants.js","sourceRoot":"","sources":["../../src/infrastructure/journal.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAwB,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC","sourcesContent":["export const verboseOnly: ReadonlySet<string> = new Set([\"raw\", \"text-delta\"]);\n"]}

package/dist/infrastructure/journal.js

@@ -1,82 +1,18 @@
 import { transportJournal } from "./transport-journal.js";
-import { lock } from "./git/lock.js";
-import { markJournalClosed } from "./journal-retention.js";
-import { randomUUID } from "node:crypto";
-import { mkdir, open, rm } from "node:fs/promises";
-import { dirname, join, resolve } from "node:path";
+import { repositoryTransport } from "./repository-transport.js";
 import { reporter } from "./reporter.js";
 export async function journal(repository, logging = {}, label) {
-    if (logging && logging !== "stdout" && logging.transporter) {
-        if (logging.file !== undefined)
-            throw new Error("Provide a journal file or transporter, not both");
-        return transportJournal(logging.transporter, logging.verbose ?? false, label);
-    }
-    const file = logging && logging !== "stdout"
-        ? resolve(repository, logging.file ??
-            join(".outpost", "logs", `${label ? label.replace(/[^A-Za-z0-9_-]/g, "-").slice(0, 64) + "-" : ""}${new Date().toISOString().replaceAll(":", "-")}-${randomUUID()}.jsonl`))
-        : undefined;
-    let handle, pending = Promise.resolve();
-    let failure;
-    let release;
-    let closing;
-    const managed = !!logging && logging !== "stdout" && logging.file === undefined;
+    if (logging && logging !== "stdout")
+        return transportJournal(logging.transporter ?? repositoryTransport(repository), logging.verbose ?? false, label);
     const display = reporter({ ...(label ? { label } : {}) });
-    if (file) {
-        await mkdir(dirname(file), { recursive: true });
-        release = await lock(repository, `journal:${file}`);
-        try {
-            await rm(`${file}.closed.json`, { force: true });
-            handle = await open(file, managed ? "wx" : "a", 0o600);
-            await handle.write(JSON.stringify({
-                kind: "dispatch-start",
-                at: new Date().toISOString(),
-                label,
-            }) + "\n");
-        }
-        catch (error) {
-            await handle?.close();
-            await release();
-            throw error;
-        }
-    }
+    let closed = false;
     return {
-        ...(file ? { file } : {}),
         record(event) {
-            if (!logging || closing)
-                return;
-            if (event.kind === "raw" && logging !== "stdout" && !logging.verbose)
-                return;
-            const line = JSON.stringify({
-                at: new Date().toISOString(),
-                ...(label ? { label } : {}),
-                ...event,
-            }) + "\n";
-            if (logging === "stdout")
+            if (logging === "stdout" && !closed)
                 display(event);
-            else
-                pending = pending
-                    .then(async () => {
-                    await handle?.write(line);
-                })
-                    .catch((error) => {
-                    failure = error;
-                });
         },
-        close() {
-            closing ??= (async () => {
-                try {
-                    await pending;
-                    await handle?.close();
-                    if (failure)
-                        throw failure;
-                    if (file && managed)
-                        await markJournalClosed(file);
-                }
-                finally {
-                    await release?.();
-                }
-            })();
-            return closing;
+        async close() {
+            closed = true;
         },
     };
 }

package/dist/infrastructure/journal.js.map

@@ -1 +1 @@
-{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../src/infrastructure/journal.ts"],"names":[],"mappings":"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","sourcesContent":["import { transportJournal } from \"./transport-journal.ts\";\nimport { lock } from \"./git/lock.ts\";\nimport { markJournalClosed } from \"./journal-retention.ts\";\nimport { randomUUID } from \"node:crypto\";\nimport type { FileHandle } from \"node:fs/promises\";\nimport { mkdir, open, rm } from \"node:fs/promises\";\nimport { dirname, join, resolve } from \"node:path\";\nimport type { Journal, Logging } from \"./journal.types.ts\";\nimport { reporter } from \"./reporter.ts\";\n\nexport type { Logging } from \"./journal.types.ts\";\n\nexport async function journal(\n  repository: string,\n  logging: Logging = {},\n  label?: string,\n): Promise<Journal> {\n  if (logging && logging !== \"stdout\" && logging.transporter) {\n    if (logging.file !== undefined)\n      throw new Error(\"Provide a journal file or transporter, not both\");\n    return transportJournal(\n      logging.transporter,\n      logging.verbose ?? false,\n      label,\n    );\n  }\n  const file =\n    logging && logging !== \"stdout\"\n      ? resolve(\n          repository,\n          logging.file ??\n            join(\n              \".outpost\",\n              \"logs\",\n              `${label ? label.replace(/[^A-Za-z0-9_-]/g, \"-\").slice(0, 64) + \"-\" : \"\"}${new Date().toISOString().replaceAll(\":\", \"-\")}-${randomUUID()}.jsonl`,\n            ),\n        )\n      : undefined;\n  let handle: FileHandle | undefined,\n    pending = Promise.resolve();\n  let failure: unknown;\n  let release: (() => Promise<void>) | undefined;\n  let closing: Promise<void> | undefined;\n  const managed =\n    !!logging && logging !== \"stdout\" && logging.file === undefined;\n  const display = reporter({ ...(label ? { label } : {}) });\n  if (file) {\n    await mkdir(dirname(file), { recursive: true });\n    release = await lock(repository, `journal:${file}`);\n    try {\n      await rm(`${file}.closed.json`, { force: true });\n      handle = await open(file, managed ? \"wx\" : \"a\", 0o600);\n      await handle.write(\n        JSON.stringify({\n          kind: \"dispatch-start\",\n          at: new Date().toISOString(),\n          label,\n        }) + \"\\n\",\n      );\n    } catch (error) {\n      await handle?.close();\n      await release();\n      throw error;\n    }\n  }\n  return {\n    ...(file ? { file } : {}),\n    record(event) {\n      if (!logging || closing) return;\n      if (event.kind === \"raw\" && logging !== \"stdout\" && !logging.verbose)\n        return;\n      const line =\n        JSON.stringify({\n          at: new Date().toISOString(),\n          ...(label ? { label } : {}),\n          ...event,\n        }) + \"\\n\";\n      if (logging === \"stdout\") display(event);\n      else\n        pending = pending\n          .then(async () => {\n            await handle?.write(line);\n          })\n          .catch((error) => {\n            failure = error;\n          });\n    },\n    close() {\n      closing ??= (async () => {\n        try {\n          await pending;\n          await handle?.close();\n          if (failure) throw failure;\n          if (file && managed) await markJournalClosed(file);\n        } finally {\n          await release?.();\n        }\n      })();\n      return closing;\n    },\n  };\n}\n"]}
+{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../src/infrastructure/journal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAIzC,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,UAAkB,EAClB,UAAmB,EAAE,EACrB,KAAc;IAEd,IAAI,OAAO,IAAI,OAAO,KAAK,QAAQ;QACjC,OAAO,gBAAgB,CACrB,OAAO,CAAC,WAAW,IAAI,mBAAmB,CAAC,UAAU,CAAC,EACtD,OAAO,CAAC,OAAO,IAAI,KAAK,EACxB,KAAK,CACN,CAAC;IACJ,MAAM,OAAO,GAAG,QAAQ,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC1D,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,OAAO;QACL,MAAM,CAAC,KAAK;YACV,IAAI,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM;gBAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACtD,CAAC;QACD,KAAK,CAAC,KAAK;YACT,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { transportJournal } from \"./transport-journal.ts\";\nimport { repositoryTransport } from \"./repository-transport.ts\";\nimport type { Journal, Logging } from \"./journal.types.ts\";\nimport { reporter } from \"./reporter.ts\";\n\nexport type { Logging } from \"./journal.types.ts\";\n\nexport async function journal(\n  repository: string,\n  logging: Logging = {},\n  label?: string,\n): Promise<Journal> {\n  if (logging && logging !== \"stdout\")\n    return transportJournal(\n      logging.transporter ?? repositoryTransport(repository),\n      logging.verbose ?? false,\n      label,\n    );\n  const display = reporter({ ...(label ? { label } : {}) });\n  let closed = false;\n  return {\n    record(event) {\n      if (logging === \"stdout\" && !closed) display(event);\n    },\n    async close() {\n      closed = true;\n    },\n  };\n}\n"]}

package/dist/infrastructure/journal.types.d.ts

@@ -1,12 +1,10 @@
 import type { Transport, TransportReference } from "../domain/transport.types.ts";
 import type { AgentEvent } from "../domain/agent.types.ts";
 export type Logging = false | "stdout" | {
-    readonly file?: string;
     readonly transporter?: Transport;
     readonly verbose?: boolean;
 };
 export type Journal = {
-    file?: string;
     reference?: TransportReference;
     record(event: AgentEvent): void;
     close(): Promise<void>;

package/dist/infrastructure/journal.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"journal.types.js","sourceRoot":"","sources":["../../src/infrastructure/journal.types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  Transport,\n  TransportReference,\n} from \"../domain/transport.types.ts\";\nimport type { AgentEvent } from \"../domain/agent.types.ts\";\n\nexport type Logging =\n  | false\n  | \"stdout\"\n  | {\n      readonly file?: string;\n      readonly transporter?: Transport;\n      readonly verbose?: boolean;\n    };\n\nexport type Journal = {\n  file?: string;\n  reference?: TransportReference;\n  record(event: AgentEvent): void;\n  close(): Promise<void>;\n};\n"]}
+{"version":3,"file":"journal.types.js","sourceRoot":"","sources":["../../src/infrastructure/journal.types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  Transport,\n  TransportReference,\n} from \"../domain/transport.types.ts\";\nimport type { AgentEvent } from \"../domain/agent.types.ts\";\n\nexport type Logging =\n  | false\n  | \"stdout\"\n  | {\n      readonly transporter?: Transport;\n      readonly verbose?: boolean;\n    };\n\nexport type Journal = {\n  reference?: TransportReference;\n  record(event: AgentEvent): void;\n  close(): Promise<void>;\n};\n"]}

package/dist/infrastructure/local-transport.js

@@ -8,14 +8,19 @@ import { OutpostError } from "../domain/errors.js";
 import { readInspectionFile } from "./inspection-file.js";
 import { decodeObject, encodeObject, readLimit } from "./transport-envelope.js";
 import { transportDefaults } from "./transport.constants.js";
-async function privateDirectory(path) {
+async function privateDirectory(path, target = true) {
     const parent = dirname(path);
     if (parent !== path) {
-        await privateDirectory(parent);
+        await privateDirectory(parent, false);
         await mkdir(path, { recursive: true, mode: 0o700 });
     }
-    if (!(await lstat(path)).isDirectory())
-        throw new Error("Transport directories must not be symlinks");
+    const info = await lstat(path);
+    if (info.isDirectory())
+        return;
+    // Root-owned ancestor links belong to the system layout, such as /var on macOS.
+    if (!target && info.isSymbolicLink() && info.uid === 0)
+        return;
+    throw new Error("Transport directories must not be symlinks");
 }
 export function localTransport(options) {
     const root = resolve(options.directory), objects = join(root, "objects");

package/dist/infrastructure/local-transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-transport.js","sourceRoot":"","sources":["../../src/infrastructure/local-transport.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdir, lstat, open, rename, rm, readdir } from \"node:fs/promises\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { randomUUID } from \"node:crypto\";\nimport { setTimeout } from \"node:timers/promises\";\nimport {\n  TransportConflict,\n  transportKey,\n  transportCondition,\n} from \"../domain/transport.ts\";\nimport type {\n  Transport,\n  TransportWriteOptions,\n} from \"../domain/transport.types.ts\";\nimport type { LocalTransportOptions } from \"./local-transport.types.ts\";\nimport { lock } from \"./git/lock.ts\";\nimport { OutpostError } from \"../domain/errors.ts\";\nimport { readInspectionFile } from \"./inspection-file.ts\";\nimport { decodeObject, encodeObject, readLimit } from \"./transport-envelope.ts\";\nimport { transportDefaults } from \"./transport.constants.ts\";\n\nasync function privateDirectory(path: string): Promise<void> {\n  const parent = dirname(path);\n  if (parent !== path) {\n    await privateDirectory(parent);\n    await mkdir(path, { recursive: true, mode: 0o700 });\n  }\n  if (!(await lstat(path)).isDirectory())\n    throw new Error(\"Transport directories must not be symlinks\");\n}\n\nexport function localTransport(options: LocalTransportOptions): Transport {\n  const root = resolve(options.directory),\n    objects = join(root, \"objects\");\n  const path = (key: string) => join(objects, `${transportKey(key)}.object`);\n  const read: Transport[\"read\"] = async (key, options = {}) => {\n    options.signal?.throwIfAborted();\n    const limit = readLimit(options.maxBytes);\n    try {\n      const target = path(key);\n      const info = await lstat(target);\n      const data = await readInspectionFile(\n        target,\n        Math.min(info.size, limit + transportDefaults.headerBytes) || 1,\n      );\n      options.signal?.throwIfAborted();\n      return decodeObject(data, key, limit);\n    } catch (error) {\n      if (\n        error &&\n        typeof error === \"object\" &&\n        \"code\" in error &&\n        error.code === \"ENOENT\"\n      )\n        return undefined;\n      throw error;\n    }\n  };\n  async function mutate<T>(\n    key: string,\n    options: TransportWriteOptions,\n    action: () => Promise<T>,\n  ): Promise<T> {\n    transportKey(key);\n    transportCondition(options.ifRevision);\n    await privateDirectory(root);\n    const signal = AbortSignal.any([\n      AbortSignal.timeout(transportDefaults.lockMs),\n      ...(options.signal ? [options.signal] : []),\n    ]);\n    let release: (() => Promise<void>) | undefined;\n    while (!release) {\n      signal.throwIfAborted();\n      try {\n        release = await lock(root, key);\n      } catch (error) {\n        if (!(error instanceof OutpostError) || error.code !== \"conflict\")\n          throw error;\n        await setTimeout(transportDefaults.retryMs, undefined, { signal });\n      }\n    }\n    try {\n      if ((await read(key))?.revision !== (options.ifRevision ?? undefined))\n        throw new TransportConflict(key);\n      options.signal?.throwIfAborted();\n      return await action();\n    } finally {\n      await release();\n    }\n  }\n  return {\n    name: \"local\",\n    read,\n    write(key, input, options) {\n      const bytes = Buffer.from(input);\n      return mutate(key, options, async () => {\n        const target = path(key);\n        await privateDirectory(dirname(target));\n        const { entry, data } = encodeObject(key, bytes);\n        const temporary = `${target}.${randomUUID()}.tmp`;\n        try {\n          const file = await open(temporary, \"wx\", 0o600);\n          try {\n            await file.writeFile(data, { signal: options.signal });\n            await file.sync();\n          } finally {\n            await file.close();\n          }\n          options.signal?.throwIfAborted();\n          await rename(temporary, target);\n          if (process.platform !== \"win32\") {\n            const parent = await open(dirname(target), \"r\");\n            try {\n              await parent.sync();\n            } finally {\n              await parent.close();\n            }\n          }\n          return entry;\n        } finally {\n          await rm(temporary, { force: true });\n        }\n      });\n    },\n    remove(key, options) {\n      if (options.ifRevision === null)\n        return Promise.reject(\n          new Error(\"Transport removal requires an existing revision\"),\n        );\n      return mutate(key, options, () => rm(path(key), { force: true }));\n    },\n    async *list(prefix = \"\", options = {}) {\n      if (prefix) transportKey(prefix.replace(/\\/$/, \"\"));\n      async function* scan(\n        directory: string,\n        base: string,\n      ): AsyncIterable<string> {\n        const entries = await readdir(directory, { withFileTypes: true }).catch(\n          (error) => {\n            if (error.code === \"ENOENT\") return [];\n            throw error;\n          },\n        );\n        for (const entry of entries) {\n          options.signal?.throwIfAborted();\n          const name = `${base}${entry.name}`;\n          if (entry.isDirectory())\n            yield* scan(join(directory, entry.name), `${name}/`);\n          if (entry.isFile() && name.endsWith(\".object\"))\n            yield name.slice(0, -7);\n          if (entry.isSymbolicLink())\n            throw new Error(\"Transport objects must not be symlinks\");\n        }\n      }\n      for await (const key of scan(objects, \"\")) {\n        if (!key.startsWith(prefix)) continue;\n        const object = await read(\n          key,\n          options.signal ? { signal: options.signal } : {},\n        );\n        if (object) {\n          const { bytes: _bytes, ...entry } = object;\n          yield entry;\n        }\n      }\n    },\n  };\n}\n"]}
+{"version":3,"file":"local-transport.js","sourceRoot":"","sources":["../../src/infrastructure/local-transport.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdir, lstat, open, rename, rm, readdir } from \"node:fs/promises\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { randomUUID } from \"node:crypto\";\nimport { setTimeout } from \"node:timers/promises\";\nimport {\n  TransportConflict,\n  transportKey,\n  transportCondition,\n} from \"../domain/transport.ts\";\nimport type {\n  Transport,\n  TransportWriteOptions,\n} from \"../domain/transport.types.ts\";\nimport type { LocalTransportOptions } from \"./local-transport.types.ts\";\nimport { lock } from \"./git/lock.ts\";\nimport { OutpostError } from \"../domain/errors.ts\";\nimport { readInspectionFile } from \"./inspection-file.ts\";\nimport { decodeObject, encodeObject, readLimit } from \"./transport-envelope.ts\";\nimport { transportDefaults } from \"./transport.constants.ts\";\n\nasync function privateDirectory(path: string, target = true): Promise<void> {\n  const parent = dirname(path);\n  if (parent !== path) {\n    await privateDirectory(parent, false);\n    await mkdir(path, { recursive: true, mode: 0o700 });\n  }\n  const info = await lstat(path);\n  if (info.isDirectory()) return;\n  // Root-owned ancestor links belong to the system layout, such as /var on macOS.\n  if (!target && info.isSymbolicLink() && info.uid === 0) return;\n  throw new Error(\"Transport directories must not be symlinks\");\n}\n\nexport function localTransport(options: LocalTransportOptions): Transport {\n  const root = resolve(options.directory),\n    objects = join(root, \"objects\");\n  const path = (key: string) => join(objects, `${transportKey(key)}.object`);\n  const read: Transport[\"read\"] = async (key, options = {}) => {\n    options.signal?.throwIfAborted();\n    const limit = readLimit(options.maxBytes);\n    try {\n      const target = path(key);\n      const info = await lstat(target);\n      const data = await readInspectionFile(\n        target,\n        Math.min(info.size, limit + transportDefaults.headerBytes) || 1,\n      );\n      options.signal?.throwIfAborted();\n      return decodeObject(data, key, limit);\n    } catch (error) {\n      if (\n        error &&\n        typeof error === \"object\" &&\n        \"code\" in error &&\n        error.code === \"ENOENT\"\n      )\n        return undefined;\n      throw error;\n    }\n  };\n  async function mutate<T>(\n    key: string,\n    options: TransportWriteOptions,\n    action: () => Promise<T>,\n  ): Promise<T> {\n    transportKey(key);\n    transportCondition(options.ifRevision);\n    await privateDirectory(root);\n    const signal = AbortSignal.any([\n      AbortSignal.timeout(transportDefaults.lockMs),\n      ...(options.signal ? [options.signal] : []),\n    ]);\n    let release: (() => Promise<void>) | undefined;\n    while (!release) {\n      signal.throwIfAborted();\n      try {\n        release = await lock(root, key);\n      } catch (error) {\n        if (!(error instanceof OutpostError) || error.code !== \"conflict\")\n          throw error;\n        await setTimeout(transportDefaults.retryMs, undefined, { signal });\n      }\n    }\n    try {\n      if ((await read(key))?.revision !== (options.ifRevision ?? undefined))\n        throw new TransportConflict(key);\n      options.signal?.throwIfAborted();\n      return await action();\n    } finally {\n      await release();\n    }\n  }\n  return {\n    name: \"local\",\n    read,\n    write(key, input, options) {\n      const bytes = Buffer.from(input);\n      return mutate(key, options, async () => {\n        const target = path(key);\n        await privateDirectory(dirname(target));\n        const { entry, data } = encodeObject(key, bytes);\n        const temporary = `${target}.${randomUUID()}.tmp`;\n        try {\n          const file = await open(temporary, \"wx\", 0o600);\n          try {\n            await file.writeFile(data, { signal: options.signal });\n            await file.sync();\n          } finally {\n            await file.close();\n          }\n          options.signal?.throwIfAborted();\n          await rename(temporary, target);\n          if (process.platform !== \"win32\") {\n            const parent = await open(dirname(target), \"r\");\n            try {\n              await parent.sync();\n            } finally {\n              await parent.close();\n            }\n          }\n          return entry;\n        } finally {\n          await rm(temporary, { force: true });\n        }\n      });\n    },\n    remove(key, options) {\n      if (options.ifRevision === null)\n        return Promise.reject(\n          new Error(\"Transport removal requires an existing revision\"),\n        );\n      return mutate(key, options, () => rm(path(key), { force: true }));\n    },\n    async *list(prefix = \"\", options = {}) {\n      if (prefix) transportKey(prefix.replace(/\\/$/, \"\"));\n      async function* scan(\n        directory: string,\n        base: string,\n      ): AsyncIterable<string> {\n        const entries = await readdir(directory, { withFileTypes: true }).catch(\n          (error) => {\n            if (error.code === \"ENOENT\") return [];\n            throw error;\n          },\n        );\n        for (const entry of entries) {\n          options.signal?.throwIfAborted();\n          const name = `${base}${entry.name}`;\n          if (entry.isDirectory())\n            yield* scan(join(directory, entry.name), `${name}/`);\n          if (entry.isFile() && name.endsWith(\".object\"))\n            yield name.slice(0, -7);\n          if (entry.isSymbolicLink())\n            throw new Error(\"Transport objects must not be symlinks\");\n        }\n      }\n      for await (const key of scan(objects, \"\")) {\n        if (!key.startsWith(prefix)) continue;\n        const object = await read(\n          key,\n          options.signal ? { signal: options.signal } : {},\n        );\n        if (object) {\n          const { bytes: _bytes, ...entry } = object;\n          yield entry;\n        }\n      }\n    },\n  };\n}\n"]}

package/dist/infrastructure/opentelemetry-dispatch.d.ts

@@ -0,0 +1,6 @@
+import type { DispatchTelemetrySession } from "../domain/dispatch-telemetry.types.ts";
+import type { OpenTelemetryOptions } from "./opentelemetry.types.ts";
+export declare function dispatchTelemetry(options: OpenTelemetryOptions): {
+    startDispatch(): DispatchTelemetrySession;
+    close(): void;
+};

package/dist/infrastructure/opentelemetry-dispatch.js

@@ -0,0 +1,70 @@
+import { context, SpanStatusCode } from "@opentelemetry/api";
+import { telemetryNames } from "./opentelemetry.constants.js";
+import { usageDimensions } from "../domain/workflow/budget.constants.js";
+export function dispatchTelemetry(options) {
+    function safe(action) {
+        try {
+            return action();
+        }
+        catch (error) {
+            try {
+                options.onError?.(error);
+            }
+            catch { }
+        }
+    }
+    const executions = safe(() => options.meter.createCounter(telemetryNames.dispatches));
+    const durations = safe(() => options.meter.createHistogram(telemetryNames.dispatchDuration, {
+        unit: "s",
+    }));
+    const tokens = safe(() => options.meter.createCounter(telemetryNames.dispatchTokens, {
+        unit: "{token}",
+    }));
+    const sessions = new Set();
+    let closed = false;
+    return {
+        startDispatch() {
+            if (closed)
+                return { finish() { } };
+            const started = Date.now();
+            const span = safe(() => options.tracer.startSpan("outpost.dispatch", { startTime: started }, context.active()));
+            const session = {
+                finish(outcome) {
+                    if (!sessions.delete(session))
+                        return;
+                    const at = Date.now();
+                    const attributes = { "outpost.status": outcome.status };
+                    safe(() => span?.setAttributes(attributes));
+                    if (outcome.completed !== undefined)
+                        safe(() => span?.setAttribute("outpost.completed", outcome.completed));
+                    safe(() => span?.setStatus({
+                        code: outcome.status === "done"
+                            ? SpanStatusCode.OK
+                            : SpanStatusCode.ERROR,
+                    }));
+                    safe(() => span?.end(at));
+                    safe(() => executions?.add(1, attributes));
+                    safe(() => durations?.record(Math.max(0, at - started) / 1000, attributes));
+                    for (const dimension of usageDimensions) {
+                        const value = outcome.usage[dimension];
+                        if (value !== undefined && Number.isFinite(value) && value > 0)
+                            safe(() => tokens?.add(value, { "outpost.token.type": dimension }));
+                    }
+                },
+            };
+            sessions.add(session);
+            return session;
+        },
+        close() {
+            if (closed)
+                return;
+            closed = true;
+            for (const session of sessions)
+                session.finish({
+                    status: "cancelled",
+                    usage: { input: 0, cached: 0, output: 0 },
+                });
+        },
+    };
+}
+//# sourceMappingURL=opentelemetry-dispatch.js.map

package/dist/infrastructure/opentelemetry-dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opentelemetry-dispatch.js","sourceRoot":"","sources":["../../src/infrastructure/opentelemetry-dispatch.ts"],"names":[],"mappings":"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","sourcesContent":["import { context, SpanStatusCode } from \"@opentelemetry/api\";\nimport type {\n  DispatchTelemetryOutcome,\n  DispatchTelemetrySession,\n} from \"../domain/dispatch-telemetry.types.ts\";\nimport type { OpenTelemetryOptions } from \"./opentelemetry.types.ts\";\nimport { telemetryNames } from \"./opentelemetry.constants.ts\";\nimport { usageDimensions } from \"../domain/workflow/budget.constants.ts\";\n\nexport function dispatchTelemetry(options: OpenTelemetryOptions) {\n  function safe<T>(action: () => T): T | undefined {\n    try {\n      return action();\n    } catch (error) {\n      try {\n        options.onError?.(error);\n      } catch {}\n    }\n  }\n  const executions = safe(() =>\n    options.meter.createCounter(telemetryNames.dispatches),\n  );\n  const durations = safe(() =>\n    options.meter.createHistogram(telemetryNames.dispatchDuration, {\n      unit: \"s\",\n    }),\n  );\n  const tokens = safe(() =>\n    options.meter.createCounter(telemetryNames.dispatchTokens, {\n      unit: \"{token}\",\n    }),\n  );\n  const sessions = new Set<DispatchTelemetrySession>();\n  let closed = false;\n  return {\n    startDispatch(): DispatchTelemetrySession {\n      if (closed) return { finish() {} };\n      const started = Date.now();\n      const span = safe(() =>\n        options.tracer.startSpan(\n          \"outpost.dispatch\",\n          { startTime: started },\n          context.active(),\n        ),\n      );\n      const session: DispatchTelemetrySession = {\n        finish(outcome: DispatchTelemetryOutcome) {\n          if (!sessions.delete(session)) return;\n          const at = Date.now();\n          const attributes = { \"outpost.status\": outcome.status };\n          safe(() => span?.setAttributes(attributes));\n          if (outcome.completed !== undefined)\n            safe(() =>\n              span?.setAttribute(\"outpost.completed\", outcome.completed!),\n            );\n          safe(() =>\n            span?.setStatus({\n              code:\n                outcome.status === \"done\"\n                  ? SpanStatusCode.OK\n                  : SpanStatusCode.ERROR,\n            }),\n          );\n          safe(() => span?.end(at));\n          safe(() => executions?.add(1, attributes));\n          safe(() =>\n            durations?.record(Math.max(0, at - started) / 1000, attributes),\n          );\n          for (const dimension of usageDimensions) {\n            const value = outcome.usage[dimension];\n            if (value !== undefined && Number.isFinite(value) && value > 0)\n              safe(() =>\n                tokens?.add(value, { \"outpost.token.type\": dimension }),\n              );\n          }\n        },\n      };\n      sessions.add(session);\n      return session;\n    },\n    close() {\n      if (closed) return;\n      closed = true;\n      for (const session of sessions)\n        session.finish({\n          status: \"cancelled\",\n          usage: { input: 0, cached: 0, output: 0 },\n        });\n    },\n  };\n}\n"]}

package/dist/infrastructure/opentelemetry.constants.d.ts

@@ -1,4 +1,7 @@
 export declare const telemetryNames: {
+    readonly dispatches: "outpost.dispatch.executions";
+    readonly dispatchDuration: "outpost.dispatch.duration";
+    readonly dispatchTokens: "outpost.dispatch.tokens";
     readonly workflows: "outpost.workflow.executions";
     readonly tasks: "outpost.task.executions";
     readonly attempts: "outpost.task.attempts";

package/dist/infrastructure/opentelemetry.constants.js

@@ -1,4 +1,7 @@
 export const telemetryNames = {
+    dispatches: "outpost.dispatch.executions",
+    dispatchDuration: "outpost.dispatch.duration",
+    dispatchTokens: "outpost.dispatch.tokens",
     workflows: "outpost.workflow.executions",
     tasks: "outpost.task.executions",
     attempts: "outpost.task.attempts",

package/dist/infrastructure/opentelemetry.constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"opentelemetry.constants.js","sourceRoot":"","sources":["../../src/infrastructure/opentelemetry.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS,EAAE,6BAA6B;IACxC,KAAK,EAAE,yBAAyB;IAChC,QAAQ,EAAE,uBAAuB;IACjC,OAAO,EAAE,sBAAsB;IAC/B,KAAK,EAAE,sBAAsB;IAC7B,gBAAgB,EAAE,2BAA2B;IAC7C,YAAY,EAAE,uBAAuB;IACrC,eAAe,EAAE,+BAA+B;CACxC,CAAC","sourcesContent":["export const telemetryNames = {\n  workflows: \"outpost.workflow.executions\",\n  tasks: \"outpost.task.executions\",\n  attempts: \"outpost.task.attempts\",\n  retries: \"outpost.task.retries\",\n  usage: \"outpost.agent.tokens\",\n  workflowDuration: \"outpost.workflow.duration\",\n  taskDuration: \"outpost.task.duration\",\n  attemptDuration: \"outpost.task.attempt.duration\",\n} as const;\n"]}
+{"version":3,"file":"opentelemetry.constants.js","sourceRoot":"","sources":["../../src/infrastructure/opentelemetry.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,UAAU,EAAE,6BAA6B;IACzC,gBAAgB,EAAE,2BAA2B;IAC7C,cAAc,EAAE,yBAAyB;IACzC,SAAS,EAAE,6BAA6B;IACxC,KAAK,EAAE,yBAAyB;IAChC,QAAQ,EAAE,uBAAuB;IACjC,OAAO,EAAE,sBAAsB;IAC/B,KAAK,EAAE,sBAAsB;IAC7B,gBAAgB,EAAE,2BAA2B;IAC7C,YAAY,EAAE,uBAAuB;IACrC,eAAe,EAAE,+BAA+B;CACxC,CAAC","sourcesContent":["export const telemetryNames = {\n  dispatches: \"outpost.dispatch.executions\",\n  dispatchDuration: \"outpost.dispatch.duration\",\n  dispatchTokens: \"outpost.dispatch.tokens\",\n  workflows: \"outpost.workflow.executions\",\n  tasks: \"outpost.task.executions\",\n  attempts: \"outpost.task.attempts\",\n  retries: \"outpost.task.retries\",\n  usage: \"outpost.agent.tokens\",\n  workflowDuration: \"outpost.workflow.duration\",\n  taskDuration: \"outpost.task.duration\",\n  attemptDuration: \"outpost.task.attempt.duration\",\n} as const;\n"]}

package/dist/infrastructure/opentelemetry.js

@@ -1,7 +1,9 @@
+import { dispatchTelemetry } from "./opentelemetry-dispatch.js";
 import { context, trace, SpanStatusCode } from "@opentelemetry/api";
 import { usageDimensions } from "../domain/workflow/budget.constants.js";
 import { telemetryNames } from "./opentelemetry.constants.js";
 export function openTelemetry(options) {
+    const dispatches = dispatchTelemetry(options);
     function safe(action) {
         try {
             return action();
@@ -60,6 +62,7 @@ export function openTelemetry(options) {
         safe(() => counters.workflows?.add(1, { "outpost.status": status }));
     }
     return {
+        startDispatch: dispatches.startDispatch,
         observe(event) {
             if (closed)
                 return;
@@ -122,6 +125,7 @@ export function openTelemetry(options) {
             if (closed)
                 return;
             closed = true;
+            dispatches.close();
             for (const execution of executions.values())
                 complete(execution, "cancelled", Date.now());
             executions.clear();

package/dist/infrastructure/opentelemetry.js.map

@@ -1 +1 @@
-{"version":3,"file":"opentelemetry.js","sourceRoot":"","sources":["../../src/infrastructure/opentelemetry.ts"],"names":[],"mappings":"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","sourcesContent":["import { context, trace, SpanStatusCode } from \"@opentelemetry/api\";\nimport type { Context, Histogram } from \"@opentelemetry/api\";\nimport type { WorkflowEvent } from \"../domain/workflow.types.ts\";\nimport { usageDimensions } from \"../domain/workflow/budget.constants.ts\";\nimport { telemetryNames } from \"./opentelemetry.constants.ts\";\nimport type {\n  OpenTelemetryObserver,\n  OpenTelemetryOptions,\n  TelemetryExecution,\n  TelemetryOperation,\n} from \"./opentelemetry.types.ts\";\n\nexport type {\n  OpenTelemetryObserver,\n  OpenTelemetryOptions,\n} from \"./opentelemetry.types.ts\";\n\nexport function openTelemetry(\n  options: OpenTelemetryOptions,\n): OpenTelemetryObserver {\n  function safe<T>(action: () => T): T | undefined {\n    try {\n      return action();\n    } catch (error) {\n      try {\n        options.onError?.(error);\n      } catch {}\n    }\n  }\n  const counters = {\n    workflows: safe(() =>\n      options.meter.createCounter(telemetryNames.workflows),\n    ),\n    tasks: safe(() => options.meter.createCounter(telemetryNames.tasks)),\n    attempts: safe(() => options.meter.createCounter(telemetryNames.attempts)),\n    retries: safe(() => options.meter.createCounter(telemetryNames.retries)),\n    usage: safe(() =>\n      options.meter.createCounter(telemetryNames.usage, { unit: \"{token}\" }),\n    ),\n  };\n  const durations = {\n    workflow: safe(() =>\n      options.meter.createHistogram(telemetryNames.workflowDuration, {\n        unit: \"s\",\n      }),\n    ),\n    task: safe(() =>\n      options.meter.createHistogram(telemetryNames.taskDuration, { unit: \"s\" }),\n    ),\n    attempt: safe(() =>\n      options.meter.createHistogram(telemetryNames.attemptDuration, {\n        unit: \"s\",\n      }),\n    ),\n  };\n  const executions = new Map<string, TelemetryExecution>();\n  let closed = false;\n  function start(\n    name: string,\n    parent: Context,\n    at: number,\n  ): TelemetryOperation {\n    const span = safe(() =>\n      options.tracer.startSpan(name, { startTime: at }, parent),\n    );\n    return {\n      span,\n      context: span ? trace.setSpan(parent, span) : parent,\n      started: at,\n    };\n  }\n  function finish(\n    operation: TelemetryOperation | undefined,\n    status: string,\n    at: number,\n    duration: Histogram | undefined,\n  ): void {\n    if (!operation) return;\n    const attributes = { \"outpost.status\": status };\n    safe(() => operation.span?.setAttributes(attributes));\n    if (status !== \"skipped\" && status !== \"paused\")\n      safe(() =>\n        operation.span?.setStatus({\n          code: status === \"done\" ? SpanStatusCode.OK : SpanStatusCode.ERROR,\n        }),\n      );\n    safe(() => operation.span?.end(at));\n    safe(() =>\n      duration?.record(Math.max(0, at - operation.started) / 1000, attributes),\n    );\n  }\n  function complete(\n    execution: TelemetryExecution,\n    status: string,\n    at: number,\n  ): void {\n    for (const attempt of execution.attempts.values())\n      finish(attempt, status, at, durations.attempt);\n    for (const task of execution.tasks.values())\n      finish(task, status, at, durations.task);\n    finish(execution.workflow, status, at, durations.workflow);\n    safe(() => counters.workflows?.add(1, { \"outpost.status\": status }));\n  }\n  return {\n    observe(event: WorkflowEvent) {\n      if (closed) return;\n      const at = Date.parse(event.timestamp);\n      if (!Number.isFinite(at)) return;\n      if (event.type === \"start\") {\n        if (executions.has(event.executionId)) return;\n        executions.set(event.executionId, {\n          workflow: start(\"outpost.workflow\", context.active(), at),\n          tasks: new Map(),\n          attempts: new Map(),\n        });\n        return;\n      }\n      const execution = executions.get(event.executionId);\n      if (!execution) return;\n      if (event.type === \"finish\") {\n        executions.delete(event.executionId);\n        complete(execution, event.status ?? \"done\", at);\n        return;\n      }\n      if (event.type === \"usage\") {\n        for (const dimension of usageDimensions) {\n          const value = event.usage?.[dimension];\n          if (value !== undefined && Number.isFinite(value) && value > 0)\n            safe(() =>\n              counters.usage?.add(value, { \"outpost.token.type\": dimension }),\n            );\n        }\n        return;\n      }\n      if (event.key === undefined) return;\n      if (event.type === \"attempt\") {\n        execution.attempts.set(\n          event.key,\n          start(\n            \"outpost.task.attempt\",\n            execution.tasks.get(event.key)?.context ??\n              execution.workflow.context,\n            at,\n          ),\n        );\n        safe(() => counters.attempts?.add(1));\n        return;\n      }\n      if (event.type === \"retry\") {\n        finish(\n          execution.attempts.get(event.key),\n          \"failed\",\n          at,\n          durations.attempt,\n        );\n        execution.attempts.delete(event.key);\n        safe(() => counters.retries?.add(1));\n        return;\n      }\n      if (event.type === \"task\" && event.status === \"active\") {\n        execution.tasks.set(\n          event.key,\n          start(\"outpost.task\", execution.workflow.context, at),\n        );\n        return;\n      }\n      if (event.type === \"task\" && event.status) {\n        finish(\n          execution.attempts.get(event.key),\n          event.status,\n          at,\n          durations.attempt,\n        );\n        finish(\n          execution.tasks.get(event.key),\n          event.status,\n          at,\n          durations.task,\n        );\n        execution.attempts.delete(event.key);\n        execution.tasks.delete(event.key);\n        safe(() => counters.tasks?.add(1, { \"outpost.status\": event.status }));\n      }\n    },\n    close() {\n      if (closed) return;\n      closed = true;\n      for (const execution of executions.values())\n        complete(execution, \"cancelled\", Date.now());\n      executions.clear();\n    },\n  };\n}\n"]}
+{"version":3,"file":"opentelemetry.js","sourceRoot":"","sources":["../../src/infrastructure/opentelemetry.ts"],"names":[],"mappings":"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","sourcesContent":["import { dispatchTelemetry } from \"./opentelemetry-dispatch.ts\";\nimport { context, trace, SpanStatusCode } from \"@opentelemetry/api\";\nimport type { Context, Histogram } from \"@opentelemetry/api\";\nimport type { WorkflowEvent } from \"../domain/workflow.types.ts\";\nimport { usageDimensions } from \"../domain/workflow/budget.constants.ts\";\nimport { telemetryNames } from \"./opentelemetry.constants.ts\";\nimport type {\n  OpenTelemetryObserver,\n  OpenTelemetryOptions,\n  TelemetryExecution,\n  TelemetryOperation,\n} from \"./opentelemetry.types.ts\";\n\nexport type {\n  OpenTelemetryObserver,\n  OpenTelemetryOptions,\n} from \"./opentelemetry.types.ts\";\n\nexport function openTelemetry(\n  options: OpenTelemetryOptions,\n): OpenTelemetryObserver {\n  const dispatches = dispatchTelemetry(options);\n  function safe<T>(action: () => T): T | undefined {\n    try {\n      return action();\n    } catch (error) {\n      try {\n        options.onError?.(error);\n      } catch {}\n    }\n  }\n  const counters = {\n    workflows: safe(() =>\n      options.meter.createCounter(telemetryNames.workflows),\n    ),\n    tasks: safe(() => options.meter.createCounter(telemetryNames.tasks)),\n    attempts: safe(() => options.meter.createCounter(telemetryNames.attempts)),\n    retries: safe(() => options.meter.createCounter(telemetryNames.retries)),\n    usage: safe(() =>\n      options.meter.createCounter(telemetryNames.usage, { unit: \"{token}\" }),\n    ),\n  };\n  const durations = {\n    workflow: safe(() =>\n      options.meter.createHistogram(telemetryNames.workflowDuration, {\n        unit: \"s\",\n      }),\n    ),\n    task: safe(() =>\n      options.meter.createHistogram(telemetryNames.taskDuration, { unit: \"s\" }),\n    ),\n    attempt: safe(() =>\n      options.meter.createHistogram(telemetryNames.attemptDuration, {\n        unit: \"s\",\n      }),\n    ),\n  };\n  const executions = new Map<string, TelemetryExecution>();\n  let closed = false;\n  function start(\n    name: string,\n    parent: Context,\n    at: number,\n  ): TelemetryOperation {\n    const span = safe(() =>\n      options.tracer.startSpan(name, { startTime: at }, parent),\n    );\n    return {\n      span,\n      context: span ? trace.setSpan(parent, span) : parent,\n      started: at,\n    };\n  }\n  function finish(\n    operation: TelemetryOperation | undefined,\n    status: string,\n    at: number,\n    duration: Histogram | undefined,\n  ): void {\n    if (!operation) return;\n    const attributes = { \"outpost.status\": status };\n    safe(() => operation.span?.setAttributes(attributes));\n    if (status !== \"skipped\" && status !== \"paused\")\n      safe(() =>\n        operation.span?.setStatus({\n          code: status === \"done\" ? SpanStatusCode.OK : SpanStatusCode.ERROR,\n        }),\n      );\n    safe(() => operation.span?.end(at));\n    safe(() =>\n      duration?.record(Math.max(0, at - operation.started) / 1000, attributes),\n    );\n  }\n  function complete(\n    execution: TelemetryExecution,\n    status: string,\n    at: number,\n  ): void {\n    for (const attempt of execution.attempts.values())\n      finish(attempt, status, at, durations.attempt);\n    for (const task of execution.tasks.values())\n      finish(task, status, at, durations.task);\n    finish(execution.workflow, status, at, durations.workflow);\n    safe(() => counters.workflows?.add(1, { \"outpost.status\": status }));\n  }\n  return {\n    startDispatch: dispatches.startDispatch,\n    observe(event: WorkflowEvent) {\n      if (closed) return;\n      const at = Date.parse(event.timestamp);\n      if (!Number.isFinite(at)) return;\n      if (event.type === \"start\") {\n        if (executions.has(event.executionId)) return;\n        executions.set(event.executionId, {\n          workflow: start(\"outpost.workflow\", context.active(), at),\n          tasks: new Map(),\n          attempts: new Map(),\n        });\n        return;\n      }\n      const execution = executions.get(event.executionId);\n      if (!execution) return;\n      if (event.type === \"finish\") {\n        executions.delete(event.executionId);\n        complete(execution, event.status ?? \"done\", at);\n        return;\n      }\n      if (event.type === \"usage\") {\n        for (const dimension of usageDimensions) {\n          const value = event.usage?.[dimension];\n          if (value !== undefined && Number.isFinite(value) && value > 0)\n            safe(() =>\n              counters.usage?.add(value, { \"outpost.token.type\": dimension }),\n            );\n        }\n        return;\n      }\n      if (event.key === undefined) return;\n      if (event.type === \"attempt\") {\n        execution.attempts.set(\n          event.key,\n          start(\n            \"outpost.task.attempt\",\n            execution.tasks.get(event.key)?.context ??\n              execution.workflow.context,\n            at,\n          ),\n        );\n        safe(() => counters.attempts?.add(1));\n        return;\n      }\n      if (event.type === \"retry\") {\n        finish(\n          execution.attempts.get(event.key),\n          \"failed\",\n          at,\n          durations.attempt,\n        );\n        execution.attempts.delete(event.key);\n        safe(() => counters.retries?.add(1));\n        return;\n      }\n      if (event.type === \"task\" && event.status === \"active\") {\n        execution.tasks.set(\n          event.key,\n          start(\"outpost.task\", execution.workflow.context, at),\n        );\n        return;\n      }\n      if (event.type === \"task\" && event.status) {\n        finish(\n          execution.attempts.get(event.key),\n          event.status,\n          at,\n          durations.attempt,\n        );\n        finish(\n          execution.tasks.get(event.key),\n          event.status,\n          at,\n          durations.task,\n        );\n        execution.attempts.delete(event.key);\n        execution.tasks.delete(event.key);\n        safe(() => counters.tasks?.add(1, { \"outpost.status\": event.status }));\n      }\n    },\n    close() {\n      if (closed) return;\n      closed = true;\n      dispatches.close();\n      for (const execution of executions.values())\n        complete(execution, \"cancelled\", Date.now());\n      executions.clear();\n    },\n  };\n}\n"]}

package/dist/infrastructure/opentelemetry.types.d.ts

@@ -1,12 +1,12 @@
 import type { Context, Meter, Span, Tracer } from "@opentelemetry/api";
-import type { WorkflowEvent } from "../domain/workflow.types.ts";
+import type { DispatchTelemetry } from "../domain/dispatch-telemetry.types.ts";
+import type { WorkflowTelemetry } from "../domain/workflow.types.ts";
 export interface OpenTelemetryOptions {
     readonly tracer: Tracer;
     readonly meter: Meter;
     readonly onError?: (error: unknown) => void;
 }
-export interface OpenTelemetryObserver {
-    observe(event: WorkflowEvent): void;
+export interface OpenTelemetryObserver extends DispatchTelemetry, WorkflowTelemetry {
     close(): void;
 }
 export interface TelemetryOperation {

package/dist/infrastructure/opentelemetry.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"opentelemetry.types.js","sourceRoot":"","sources":["../../src/infrastructure/opentelemetry.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Context, Meter, Span, Tracer } from \"@opentelemetry/api\";\nimport type { WorkflowEvent } from \"../domain/workflow.types.ts\";\n\nexport interface OpenTelemetryOptions {\n  readonly tracer: Tracer;\n  readonly meter: Meter;\n  readonly onError?: (error: unknown) => void;\n}\n\nexport interface OpenTelemetryObserver {\n  observe(event: WorkflowEvent): void;\n  close(): void;\n}\n\nexport interface TelemetryOperation {\n  readonly span: Span | undefined;\n  readonly context: Context;\n  readonly started: number;\n}\n\nexport interface TelemetryExecution {\n  readonly workflow: TelemetryOperation;\n  readonly tasks: Map<string, TelemetryOperation>;\n  readonly attempts: Map<string, TelemetryOperation>;\n}\n"]}
+{"version":3,"file":"opentelemetry.types.js","sourceRoot":"","sources":["../../src/infrastructure/opentelemetry.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Context, Meter, Span, Tracer } from \"@opentelemetry/api\";\nimport type { DispatchTelemetry } from \"../domain/dispatch-telemetry.types.ts\";\nimport type { WorkflowTelemetry } from \"../domain/workflow.types.ts\";\n\nexport interface OpenTelemetryOptions {\n  readonly tracer: Tracer;\n  readonly meter: Meter;\n  readonly onError?: (error: unknown) => void;\n}\n\nexport interface OpenTelemetryObserver\n  extends DispatchTelemetry, WorkflowTelemetry {\n  close(): void;\n}\n\nexport interface TelemetryOperation {\n  readonly span: Span | undefined;\n  readonly context: Context;\n  readonly started: number;\n}\n\nexport interface TelemetryExecution {\n  readonly workflow: TelemetryOperation;\n  readonly tasks: Map<string, TelemetryOperation>;\n  readonly attempts: Map<string, TelemetryOperation>;\n}\n"]}