@botiverse/oar 0.0.1

package/dist/shared/executable/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/shared/executable/resolve.ts"],"names":[],"mappings":"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"}

package/dist/shared/executable/run.d.ts

@@ -0,0 +1,13 @@
+export interface ExecutableResult {
+    readonly ok: boolean;
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly exitCode: number | null;
+}
+export interface ExecutableRunOptions {
+    readonly env?: NodeJS.ProcessEnv;
+    readonly timeoutMs?: number;
+}
+export type ExecutableRunner = (executable: string, args: readonly string[], options?: ExecutableRunOptions) => Promise<ExecutableResult>;
+export declare const runExecutable: ExecutableRunner;
+//# sourceMappingURL=run.d.ts.map

package/dist/shared/executable/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/shared/executable/run.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,gBAAgB,GAAG,CAC7B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,CAAC,EAAE,oBAAoB,KAC3B,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAE/B,eAAO,MAAM,aAAa,EAAE,gBA2B3B,CAAC"}

package/dist/shared/executable/run.js

@@ -0,0 +1,26 @@
+import { execFile } from "node:child_process";
+import { requiresShell } from "./process.js";
+export const runExecutable = async (executable, args, options = {}) => {
+    const result = await new Promise((resolve) => {
+        execFile(executable, [...args], {
+            env: options.env,
+            timeout: options.timeoutMs ?? 5000,
+            maxBuffer: 2 * 1024 * 1024,
+            // Same Windows .cmd-shim rule as spawnLineProcess: modern Node throws
+            // EINVAL (synchronously) on shell-less exec of .cmd/.bat.
+            shell: requiresShell(executable, process.platform),
+        }, (error, stdout, stderr) => {
+            const exitCode = error !== null && "code" in error && typeof error.code === "number"
+                ? error.code
+                : null;
+            resolve({
+                ok: error === null,
+                stdout,
+                stderr,
+                exitCode,
+            });
+        });
+    });
+    return result;
+};
+//# sourceMappingURL=run.js.map

package/dist/shared/executable/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/shared/executable/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAoB7C,MAAM,CAAC,MAAM,aAAa,GAAqB,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE;IACtF,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAAmB,CAAC,OAAO,EAAE,EAAE;QAC7D,QAAQ,CACN,UAAU,EACV,CAAC,GAAG,IAAI,CAAC,EACT;YACE,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,OAAO,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;YAClC,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;YAC1B,sEAAsE;YACtE,0DAA0D;YAC1D,KAAK,EAAE,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC;SACnD,EACD,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACxB,MAAM,QAAQ,GAAG,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;gBAClF,CAAC,CAAC,KAAK,CAAC,IAAI;gBACZ,CAAC,CAAC,IAAI,CAAC;YACT,OAAO,CAAC;gBACN,EAAE,EAAE,KAAK,KAAK,IAAI;gBAClB,MAAM;gBACN,MAAM;gBACN,QAAQ;aACT,CAAC,CAAC;QACL,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/dist/shared/executable/version.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Read one executable's `--version` first line.
+ * Returns undefined when the executable rejects the flag; throws only when it cannot be spawned.
+ */
+export declare function readExecutableVersion(executable: string): Promise<string | undefined>;
+//# sourceMappingURL=version.d.ts.map

package/dist/shared/executable/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/shared/executable/version.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAU3F"}

package/dist/shared/executable/version.js

@@ -0,0 +1,17 @@
+import { runExecutable } from "./run.js";
+/**
+ * Read one executable's `--version` first line.
+ * Returns undefined when the executable rejects the flag; throws only when it cannot be spawned.
+ */
+export async function readExecutableVersion(executable) {
+    const result = await runExecutable(executable, ["--version"]);
+    if (!result.ok && result.exitCode === null) {
+        throw new Error(`Failed to run ${executable} --version`);
+    }
+    if (!result.ok) {
+        return undefined;
+    }
+    const line = result.stdout.trim().split(/\r?\n/u)[0];
+    return line === undefined || line.length === 0 ? undefined : line;
+}
+//# sourceMappingURL=version.js.map

package/dist/shared/executable/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/shared/executable/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,UAAkB;IAC5D,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,UAAU,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IAC9D,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,iBAAiB,UAAU,YAAY,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AACpE,CAAC"}

package/dist/shared/failure-class.d.ts

@@ -0,0 +1,8 @@
+import type { FailureClass } from "../contracts/session.js";
+/**
+ * Best-effort classification of vendor error prose. The patterns are pinned
+ * by the vendor snapshot tests — when a runtime changes its wording, the
+ * snapshot moves and this table gets a conscious update.
+ */
+export declare function classifyFailure(reason: string): FailureClass;
+//# sourceMappingURL=failure-class.d.ts.map

package/dist/shared/failure-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-class.d.ts","sourceRoot":"","sources":["../../src/shared/failure-class.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAiB5D"}

package/dist/shared/failure-class.js

@@ -0,0 +1,24 @@
+/**
+ * Best-effort classification of vendor error prose. The patterns are pinned
+ * by the vendor snapshot tests — when a runtime changes its wording, the
+ * snapshot moves and this table gets a conscious update.
+ */
+export function classifyFailure(reason) {
+    if (/\b401\b|authentication|unauthorized|invalid (?:x-)?api[- ]?key|log(?:ged)? ?in/iu.test(reason)) {
+        return "auth";
+    }
+    if (/\b429\b|rate.?limit|quota|usage limit/iu.test(reason)) {
+        return "quota";
+    }
+    if (/\b400\b|invalid_request/iu.test(reason)) {
+        return "invalid_request";
+    }
+    if (/\b529\b|\b503\b|overloaded/iu.test(reason)) {
+        return "overloaded";
+    }
+    if (/\b\d{3}\b|error/iu.test(reason)) {
+        return "provider";
+    }
+    return "unknown";
+}
+//# sourceMappingURL=failure-class.js.map

package/dist/shared/failure-class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-class.js","sourceRoot":"","sources":["../../src/shared/failure-class.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,IAAI,kFAAkF,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACpG,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,yCAAyC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3D,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,2BAA2B,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7C,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,IAAI,8BAA8B,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAChD,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACrC,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/shared/installation.d.ts

@@ -0,0 +1,9 @@
+import type { InstallationProbe } from "../contracts/installation.js";
+/**
+ * An installation probed from an executable: the env var pins one candidate
+ * exclusively; otherwise the command name and fallbacks are tried in order and
+ * the first usable candidate wins. When readiness args are given, a candidate
+ * must run them successfully or the probe moves on to the next one.
+ */
+export declare function executableInstallation(envVar: string, command: string, fallbacks?: readonly string[], readiness?: readonly string[]): InstallationProbe;
+//# sourceMappingURL=installation.d.ts.map

package/dist/shared/installation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installation.d.ts","sourceRoot":"","sources":["../../src/shared/installation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAwB,MAAM,8BAA8B,CAAC;AAmB5F;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,SAAS,MAAM,EAAO,EACjC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAC5B,iBAAiB,CAgCnB"}

package/dist/shared/installation.js

@@ -0,0 +1,53 @@
+import { existsSync } from "node:fs";
+import { readExecutableVersion, resolveExecutable, runExecutable } from "./executable/index.js";
+// An entry with a path separator is a pinned path: it must exist as given and
+// never silently falls back to a different binary. A bare name resolves on PATH.
+function usable(entry) {
+    if (entry.includes("/") || entry.includes("\\")) {
+        return existsSync(entry) ? entry : null;
+    }
+    return resolveExecutable(entry);
+}
+async function versionSnapshot(command) {
+    const version = await readExecutableVersion(command);
+    return version === undefined
+        ? { kind: "available", via: "executable", command }
+        : { kind: "available", via: "executable", command, version };
+}
+/**
+ * An installation probed from an executable: the env var pins one candidate
+ * exclusively; otherwise the command name and fallbacks are tried in order and
+ * the first usable candidate wins. When readiness args are given, a candidate
+ * must run them successfully or the probe moves on to the next one.
+ */
+export function executableInstallation(envVar, command, fallbacks = [], readiness) {
+    return async () => {
+        const pinned = process.env[envVar];
+        const entries = pinned !== undefined && pinned !== "" ? [pinned] : [command, ...fallbacks];
+        const found = [];
+        for (const entry of entries) {
+            const candidate = usable(entry);
+            if (candidate !== null && !found.includes(candidate)) {
+                found.push(candidate);
+            }
+        }
+        const [first] = found;
+        if (first === undefined) {
+            return { kind: "not_found" };
+        }
+        if (readiness === undefined) {
+            return versionSnapshot(first);
+        }
+        for (const candidate of found) {
+            const result = await runExecutable(candidate, readiness);
+            if (!result.ok && result.exitCode === null) {
+                throw new Error(`Failed to run ${candidate} ${readiness.join(" ")}`);
+            }
+            if (result.ok) {
+                return versionSnapshot(candidate);
+            }
+        }
+        return { kind: "unsupported", reason: `${readiness.join(" ")} failed` };
+    };
+}
+//# sourceMappingURL=installation.js.map

package/dist/shared/installation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installation.js","sourceRoot":"","sources":["../../src/shared/installation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEhG,8EAA8E;AAC9E,iFAAiF;AACjF,SAAS,MAAM,CAAC,KAAa;IAC3B,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1C,CAAC;IACD,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,OAAe;IAC5C,MAAM,OAAO,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACrD,OAAO,OAAO,KAAK,SAAS;QAC1B,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE;QACnD,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACjE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAc,EACd,OAAe,EACf,YAA+B,EAAE,EACjC,SAA6B;IAE7B,OAAO,KAAK,IAAmC,EAAE;QAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,CAAC;QAE3F,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAChC,IAAI,SAAS,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACrD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;QACtB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QAC/B,CAAC;QACD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAED,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACzD,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;gBAC3C,MAAM,IAAI,KAAK,CAAC,iBAAiB,SAAS,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACvE,CAAC;YACD,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;gBACd,OAAO,eAAe,CAAC,SAAS,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;IAC1E,CAAC,CAAC;AACJ,CAAC"}

package/dist/shared/instant.d.ts

@@ -0,0 +1,4 @@
+import type { UtcInstant } from "../contracts/account-usage.js";
+/** Validate and serialize a Date as the public UTC-instant representation. */
+export declare function utcInstantFromDate(value: Date): UtcInstant | null;
+//# sourceMappingURL=instant.d.ts.map

package/dist/shared/instant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instant.d.ts","sourceRoot":"","sources":["../../src/shared/instant.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEhE,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,IAAI,GAAG,UAAU,GAAG,IAAI,CAAC"}

package/dist/shared/instant.js

@@ -0,0 +1,4 @@
+export function utcInstantFromDate(value) {
+    return Number.isFinite(value.getTime()) ? value.toISOString() : null;
+}
+//# sourceMappingURL=instant.js.map

package/dist/shared/instant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instant.js","sourceRoot":"","sources":["../../src/shared/instant.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,kBAAkB,CAAC,KAAW;IAC5C,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACvE,CAAC"}

package/dist/shared/json.d.ts

@@ -0,0 +1,10 @@
+import type { UtcInstant } from "../contracts/account-usage.js";
+/** Narrowing helpers for untyped JSON coming from native runtime surfaces. */
+export type JsonRecord = Record<string, unknown>;
+/** Parse JSON text; undefined (never a legal JSON value) signals invalid JSON. */
+export declare function parseJson(text: string): unknown;
+export declare function asRecord(value: unknown): JsonRecord | null;
+export declare function asNumber(value: unknown): number | null;
+/** Narrow an epoch timestamp in seconds or milliseconds to an ISO-8601 instant. */
+export declare function asEpochInstant(value: unknown): UtcInstant | null;
+//# sourceMappingURL=json.d.ts.map

package/dist/shared/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/shared/json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAGhE,8EAA8E;AAC9E,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAO/C;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAI1D;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAEtD;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAOhE"}

package/dist/shared/json.js

@@ -0,0 +1,29 @@
+import { utcInstantFromDate } from "./instant.js";
+/** Parse JSON text; undefined (never a legal JSON value) signals invalid JSON. */
+export function parseJson(text) {
+    try {
+        const value = JSON.parse(text);
+        return value;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function asRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value)
+        ? Object.fromEntries(Object.entries(value))
+        : null;
+}
+export function asNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+/** Narrow an epoch timestamp in seconds or milliseconds to an ISO-8601 instant. */
+export function asEpochInstant(value) {
+    const raw = asNumber(value);
+    if (raw === null) {
+        return null;
+    }
+    const instant = new Date(raw >= 1_000_000_000_000 ? raw : raw * 1000);
+    return utcInstantFromDate(instant);
+}
+//# sourceMappingURL=json.js.map

package/dist/shared/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/shared/json.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAKlD,kFAAkF;AAClF,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzE,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC3C,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5E,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,GAAG,IAAI,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IACtE,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC"}

package/dist/shared/seal-session.d.ts

@@ -0,0 +1,8 @@
+import type { AdapterSession, Session } from "../contracts/session.js";
+/**
+ * Derive the API face of a Session from what the adapter built. Method-style
+ * so consumers discover the policy in autocomplete instead of hunting for a
+ * free function; one implementation instead of one per adapter.
+ */
+export declare function sealSession(adapterSession: AdapterSession): Session;
+//# sourceMappingURL=seal-session.d.ts.map

package/dist/shared/seal-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seal-session.d.ts","sourceRoot":"","sources":["../../src/shared/seal-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,OAAO,EAGR,MAAM,yBAAyB,CAAC;AAEjC;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,cAAc,EAAE,cAAc,GAAG,OAAO,CAiBnE"}

package/dist/shared/seal-session.js

@@ -0,0 +1,24 @@
+/**
+ * Derive the API face of a Session from what the adapter built. Method-style
+ * so consumers discover the policy in autocomplete instead of hunting for a
+ * free function; one implementation instead of one per adapter.
+ */
+export function sealSession(adapterSession) {
+    const steerOrQueue = async (turn, input) => {
+        let reason = "runtime cannot steer";
+        if (turn.steer !== undefined) {
+            const steered = await turn.steer(input);
+            if (steered.kind === "accepted") {
+                return { landed: "steered" };
+            }
+            ({ reason } = steered);
+        }
+        if (adapterSession.queue !== undefined) {
+            await adapterSession.queue.add(input);
+            return { landed: "queued" };
+        }
+        return { landed: "rejected", reason };
+    };
+    return { ...adapterSession, steerOrQueue };
+}
+//# sourceMappingURL=seal-session.js.map

package/dist/shared/seal-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seal-session.js","sourceRoot":"","sources":["../../src/shared/seal-session.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,cAA8B;IACxD,MAAM,YAAY,GAAG,KAAK,EAAE,IAAU,EAAE,KAAa,EAA+B,EAAE;QACpF,IAAI,MAAM,GAAG,sBAAsB,CAAC;QACpC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACxC,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAChC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;YAC/B,CAAC;YACD,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC;QACzB,CAAC;QACD,IAAI,cAAc,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACtC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAC9B,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IACxC,CAAC,CAAC;IACF,OAAO,EAAE,GAAG,cAAc,EAAE,YAAY,EAAE,CAAC;AAC7C,CAAC"}

package/dist/shared/session-kernel.d.ts

@@ -0,0 +1,25 @@
+import type { SessionEventBody, SessionObserver, TurnOutcome, Unsubscribe } from "../contracts/session.js";
+/**
+ * Shared session mechanics every adapter needs: envelope stamping (seq,
+ * receivedAt), synchronous never-awaited observer fan-out with error
+ * swallowing, the single-active-turn gate, and settle-exactly-once turn
+ * handles. Adapters keep only runtime-specific pumping and control.
+ */
+export interface SessionKernel {
+    readonly sessionId: string;
+    subscribe(observer: SessionObserver): Unsubscribe;
+    /** Null while another turn is active — the contract's busy invariant. */
+    begin(): KernelTurn | null;
+    active(): KernelTurn | null;
+}
+export interface KernelTurn {
+    readonly id: string;
+    readonly outcome: Promise<TurnOutcome>;
+    settled(): boolean;
+    /** Stamps the envelope and fans out; ignored after the turn settled. */
+    emit(body: SessionEventBody): void;
+    /** Emits turn_ended and resolves the outcome exactly once. */
+    settle(outcome: TurnOutcome): void;
+}
+export declare function createSessionKernel(sessionId?: string): SessionKernel;
+//# sourceMappingURL=session-kernel.d.ts.map

package/dist/shared/session-kernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-kernel.d.ts","sourceRoot":"","sources":["../../src/shared/session-kernel.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,WAAW,EACZ,MAAM,yBAAyB,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,WAAW,CAAC;IAClD,yEAAyE;IACzE,KAAK,IAAI,UAAU,GAAG,IAAI,CAAC;IAC3B,MAAM,IAAI,UAAU,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACvC,OAAO,IAAI,OAAO,CAAC;IACnB,wEAAwE;IACxE,IAAI,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACnC,8DAA8D;IAC9D,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;CACpC;AAED,wBAAgB,mBAAmB,CAAC,SAAS,GAAE,MAAqB,GAAG,aAAa,CA+DnF"}

package/dist/shared/session-kernel.js

@@ -0,0 +1,64 @@
+import { randomUUID } from "node:crypto";
+export function createSessionKernel(sessionId = randomUUID()) {
+    const observers = new Set();
+    let seq = 0;
+    let activeTurn = null;
+    const fanOut = (turnId, body) => {
+        const event = {
+            sessionId,
+            turnId,
+            seq,
+            receivedAt: Date.now(),
+            ...body,
+        };
+        seq += 1;
+        for (const observer of observers) {
+            try {
+                observer(event);
+            }
+            catch {
+                // Observers are a side-tap; their failures must not touch the run.
+            }
+        }
+    };
+    const begin = () => {
+        if (activeTurn !== null && !activeTurn.settled()) {
+            return null;
+        }
+        const id = randomUUID();
+        let isSettled = false;
+        const { promise: outcome, resolve: resolveOutcome } = Promise.withResolvers();
+        const turn = {
+            id,
+            outcome,
+            settled: () => isSettled,
+            emit(body) {
+                if (!isSettled) {
+                    fanOut(id, body);
+                }
+            },
+            settle(result) {
+                if (!isSettled) {
+                    fanOut(id, { kind: "turn_ended", outcome: result });
+                    isSettled = true;
+                    resolveOutcome(result);
+                }
+            },
+        };
+        activeTurn = turn;
+        fanOut(id, { kind: "turn_started" });
+        return turn;
+    };
+    return {
+        sessionId,
+        subscribe(observer) {
+            observers.add(observer);
+            return () => {
+                observers.delete(observer);
+            };
+        },
+        begin,
+        active: () => (activeTurn !== null && !activeTurn.settled() ? activeTurn : null),
+    };
+}
+//# sourceMappingURL=session-kernel.js.map

package/dist/shared/session-kernel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-kernel.js","sourceRoot":"","sources":["../../src/shared/session-kernel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAgCzC,MAAM,UAAU,mBAAmB,CAAC,YAAoB,UAAU,EAAE;IAClE,MAAM,SAAS,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC7C,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,UAAU,GAAsB,IAAI,CAAC;IAEzC,MAAM,MAAM,GAAG,CAAC,MAAc,EAAE,IAAsB,EAAQ,EAAE;QAC9D,MAAM,KAAK,GAAG;YACZ,SAAS;YACT,MAAM;YACN,GAAG;YACH,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;YACtB,GAAG,IAAI;SACR,CAAC;QACF,GAAG,IAAI,CAAC,CAAC;QACT,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;YAAC,MAAM,CAAC;gBACP,mEAAmE;YACrE,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,GAAsB,EAAE;QACpC,IAAI,UAAU,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;YACjD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;QACxB,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,aAAa,EAAe,CAAC;QAC3F,MAAM,IAAI,GAAe;YACvB,EAAE;YACF,OAAO;YACP,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;YACxB,IAAI,CAAC,IAAI;gBACP,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;gBACnB,CAAC;YACH,CAAC;YACD,MAAM,CAAC,MAAM;gBACX,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;oBACpD,SAAS,GAAG,IAAI,CAAC;oBACjB,cAAc,CAAC,MAAM,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC;SACF,CAAC;QACF,UAAU,GAAG,IAAI,CAAC;QAClB,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,OAAO;QACL,SAAS;QACT,SAAS,CAAC,QAAQ;YAChB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,GAAG,EAAE;gBACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC7B,CAAC,CAAC;QACJ,CAAC;QACD,KAAK;QACL,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;KACjF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@botiverse/oar",
+  "version": "0.0.1",
+  "description": "Provider-independent contracts for observing agent runtimes",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./observe": {
+      "types": "./dist/observe/index.d.ts",
+      "import": "./dist/observe/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/botiverse/oar.git",
+    "directory": "packages/oar"
+  },
+  "license": "Apache-2.0",
+  "optionalDependencies": {
+    "@earendil-works/pi-coding-agent": "^0.84.2"
+  },
+  "dependencies": {
+    "cross-spawn": "^7.0.6"
+  },
+  "devDependencies": {
+    "@types/cross-spawn": "^6.0.6"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit"
+  }
+}