@once-agent/sdk 0.1.6 → 0.1.8

package/dist-cjs/local.js

@@ -0,0 +1,310 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalProtectionError = void 0;
+exports.protectLocal = protectLocal;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const node_util_1 = require("node:util");
+const binding_js_1 = require("./connect/binding.js");
+class LocalProtectionError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.code = code;
+        this.name = "LocalProtectionError";
+    }
+}
+exports.LocalProtectionError = LocalProtectionError;
+// Local mode accepts JSON-like data with no hidden behavior. Callable/provider
+// handles may travel through arguments by identity, but cannot be payloads or
+// receipts. The caller must keep their effect-bearing state stable.
+function copyData(value, allowHandles = false, seen = new Set(), location = "$", freeze = false) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return value;
+    if (typeof value === "number" && Number.isFinite(value) && !Object.is(value, -0))
+        return value;
+    if (allowHandles && (value === undefined || typeof value === "bigint" || typeof value === "symbol"))
+        return value;
+    if (allowHandles && typeof value === "function")
+        return value;
+    if (typeof value !== "object") {
+        throw new LocalProtectionError("UNSUPPORTED_VALUE", `Unsupported local data at ${location}.`);
+    }
+    if (node_util_1.types.isProxy(value)) {
+        throw new LocalProtectionError("UNSUPPORTED_VALUE", `Proxy at ${location} is unsupported.`);
+    }
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype !== Object.prototype && prototype !== null && prototype !== Array.prototype) {
+        if (allowHandles)
+            return value;
+        throw new LocalProtectionError("UNSUPPORTED_VALUE", `Unsupported object at ${location}.`);
+    }
+    const descriptors = Object.getOwnPropertyDescriptors(value);
+    const keys = Reflect.ownKeys(descriptors);
+    if (keys.includes("toJSON")) {
+        throw new LocalProtectionError("UNSUPPORTED_VALUE", `Serialization hook at ${location} is unsupported.`);
+    }
+    if (keys.some(key => typeof key === "symbol")) {
+        throw new LocalProtectionError("UNSUPPORTED_VALUE", `Symbol property at ${location} is unsupported.`);
+    }
+    if (keys.some(key => !("value" in descriptors[key]) ||
+        (!(Array.isArray(value) && key === "length") && !descriptors[key].enumerable))) {
+        throw new LocalProtectionError("UNSUPPORTED_VALUE", `Accessor or hidden property at ${location} is unsupported.`);
+    }
+    if (allowHandles && !Array.isArray(value) &&
+        keys.some(key => typeof descriptors[key].value === "function"))
+        return value;
+    if (seen.has(value)) {
+        throw new LocalProtectionError("UNSUPPORTED_VALUE", `Cyclic local data at ${location} is unsupported.`);
+    }
+    seen.add(value);
+    try {
+        if (Array.isArray(value)) {
+            if (prototype !== Array.prototype) {
+                throw new LocalProtectionError("UNSUPPORTED_VALUE", `Unsupported array at ${location}.`);
+            }
+            const array = value;
+            if (keys.length !== array.length + 1 ||
+                Array.from({ length: array.length }, (_, index) => String(index))
+                    .some(index => !Object.prototype.hasOwnProperty.call(descriptors, index))) {
+                throw new LocalProtectionError("UNSUPPORTED_VALUE", `Sparse or extended array at ${location} is unsupported.`);
+            }
+            const result = array.map((_, index) => copyData(descriptors[String(index)].value, allowHandles, seen, `${location}[${index}]`, freeze));
+            return freeze ? Object.freeze(result) : result;
+        }
+        const result = {};
+        for (const key of keys) {
+            Object.defineProperty(result, key, {
+                value: copyData(descriptors[key].value, allowHandles, seen, `${location}.${key}`, freeze),
+                enumerable: true,
+                writable: true,
+                configurable: true,
+            });
+        }
+        return freeze ? Object.freeze(result) : result;
+    }
+    finally {
+        seen.delete(value);
+    }
+}
+function encodeResult(value) {
+    const envelope = value === undefined
+        ? { hasValue: false }
+        : { hasValue: true, value: copyData(value) };
+    return (0, binding_js_1.canonicalizeConnectPayload)(envelope);
+}
+function decodeResult(encoded) {
+    try {
+        const envelope = JSON.parse(encoded);
+        if (envelope === null || typeof envelope !== "object" || Array.isArray(envelope) ||
+            typeof envelope.hasValue !== "boolean" ||
+            (envelope.hasValue && !Object.prototype.hasOwnProperty.call(envelope, "value")) ||
+            (!envelope.hasValue && Object.prototype.hasOwnProperty.call(envelope, "value")) ||
+            Object.keys(envelope).length !== (envelope.hasValue ? 2 : 1)) {
+            throw new Error("Malformed receipt envelope.");
+        }
+        const validated = copyData(envelope);
+        return (validated.hasValue ? validated.value : undefined);
+    }
+    catch (cause) {
+        throw new LocalProtectionError("STATE_UNAVAILABLE", "The stored local receipt is malformed. No operation was dispatched.", { cause });
+    }
+}
+/**
+ * Protect an existing async operation on one machine while keeping its call
+ * shape and dynamic receiver. Ordinary data arguments are snapshotted and
+ * frozen; opaque handles keep their identity. SQLite coordinates processes
+ * sharing the same durable local file.
+ * Uncertain outcomes remain blocked; this wrapper never redispatches after
+ * an ambiguous attempt, even if a lookup reports ABSENT.
+ */
+function protectLocal(operation, options) {
+    if (typeof operation !== "function" || typeof options?.id !== "function" || typeof options.payload !== "function") {
+        throw new LocalProtectionError("INVALID_CONFIGURATION", "protectLocal requires an async operation plus id and payload functions. The id must survive retries; payload must include every effect-bearing input.");
+    }
+    const statePath = node_path_1.default.resolve(options.statePath ?? node_path_1.default.join(process.cwd(), ".once", "operations.sqlite"));
+    const leaseMs = options.leaseMs ?? 30_000;
+    if (!Number.isSafeInteger(leaseMs) || leaseMs <= 0) {
+        throw new LocalProtectionError("INVALID_LEASE", "leaseMs must be a positive integer in milliseconds.");
+    }
+    return async function (...args) {
+        const callArgs = copyData(args, true, new Set(), "$args", true);
+        const id = options.id(...callArgs);
+        if (typeof id !== "string" || id.trim() === "") {
+            throw new LocalProtectionError("INVALID_ID", "A stable nonempty logical action id is required. Reuse it for retries and choose a new one for a separate intentional action.");
+        }
+        const payload = copyData(options.payload(...callArgs));
+        const fingerprint = (0, binding_js_1.fingerprintConnectPayload)(payload);
+        if (Number(process.versions.node.split(".")[0]) < 24 ||
+            (Number(process.versions.node.split(".")[0]) === 24 && Number(process.versions.node.split(".")[1]) < 15)) {
+            throw new LocalProtectionError("UNSUPPORTED_RUNTIME", "Local SQLite protection requires Node.js 24.15 or later. Use a supported Node runtime or the hosted Once execution path.");
+        }
+        let DatabaseSync;
+        try {
+            ({ DatabaseSync } = await Promise.resolve().then(() => __importStar(require("node:sqlite"))));
+        }
+        catch (cause) {
+            throw new LocalProtectionError("SQLITE_UNAVAILABLE", "Node SQLite is unavailable. Enable node:sqlite or use the hosted Once execution path; the operation was not dispatched.", { cause });
+        }
+        let db;
+        try {
+            (0, node_fs_1.mkdirSync)(node_path_1.default.dirname(statePath), { recursive: true });
+            db = new DatabaseSync(statePath, { timeout: 30_000 });
+            db.exec("PRAGMA journal_mode=WAL; PRAGMA synchronous=FULL; CREATE TABLE IF NOT EXISTS local_operations (id TEXT PRIMARY KEY, fingerprint TEXT NOT NULL, state TEXT NOT NULL CHECK(state IN ('CLAIMED','UNKNOWN','CONFIRMED')), result_json TEXT, owner TEXT, lease_until INTEGER);");
+        }
+        catch (cause) {
+            if (db) {
+                try {
+                    db.close();
+                }
+                catch { /* Preserve the initialization error. */ }
+            }
+            throw new LocalProtectionError("STATE_UNAVAILABLE", `Cannot open durable Once state at ${statePath}. The operation was not dispatched. Restore access to this same file before retrying.`, { cause });
+        }
+        const owner = (0, node_crypto_1.randomUUID)();
+        let shouldDispatch = false;
+        let row;
+        try {
+            db.exec("BEGIN IMMEDIATE");
+            row = db.prepare("SELECT fingerprint,state,result_json,owner,lease_until FROM local_operations WHERE id=?").get(id);
+            if (!row) {
+                db.prepare("INSERT INTO local_operations(id,fingerprint,state,result_json,owner,lease_until) VALUES(?,?,'CLAIMED',NULL,?,?)")
+                    .run(id, fingerprint, owner, Date.now() + leaseMs);
+                shouldDispatch = true;
+            }
+            db.exec("COMMIT");
+        }
+        catch (cause) {
+            if (db.isTransaction)
+                db.exec("ROLLBACK");
+            db.close();
+            throw new LocalProtectionError("STATE_UNAVAILABLE", "Could not atomically claim durable Once state. The operation was not dispatched; retry with the same id after restoring state access.", { cause });
+        }
+        try {
+            if (!shouldDispatch) {
+                if (row.fingerprint !== fingerprint) {
+                    throw new LocalProtectionError("CONFLICT", `Logical action ${id} has a different effect-bearing payload. Choose a new id only for a genuinely new action; no write was dispatched.`);
+                }
+                if (row.state === "CONFIRMED")
+                    return decodeResult(row.result_json);
+                if (row.state === "CLAIMED" && row.lease_until > Date.now()) {
+                    throw new LocalProtectionError("IN_FLIGHT", `Logical action ${id} is still in flight. Wait and retry with the same id; do not call the underlying operation directly.`);
+                }
+                // Persist uncertainty before any fallible external lookup.
+                db.prepare("UPDATE local_operations SET state='UNKNOWN',owner=NULL,lease_until=NULL WHERE id=? AND state='CLAIMED'").run(id);
+                if (!options.reconcile) {
+                    throw new LocalProtectionError("UNKNOWN", `Outcome of ${id} is unknown. Supply an authoritative reconcile callback or investigate provider truth; no second write was dispatched.`);
+                }
+                let observation;
+                try {
+                    observation = await options.reconcile({ id, payload: copyData(payload) });
+                }
+                catch (cause) {
+                    throw new LocalProtectionError("UNKNOWN", `Provider truth for ${id} is unavailable. No second write was dispatched.`, { cause });
+                }
+                if (observation?.state !== "CONFIRMED") {
+                    throw new LocalProtectionError("UNKNOWN", `Provider truth for ${id} did not confirm an effect. Local mode will not redispatch after an ambiguous attempt; investigate or use a provider idempotency integration.`);
+                }
+                if (!Object.prototype.hasOwnProperty.call(observation, "result")) {
+                    throw new LocalProtectionError("INVALID_TRUTH", "CONFIRMED provider truth must include a result; the outcome remains UNKNOWN and no second write was dispatched.");
+                }
+                let resultJson;
+                try {
+                    resultJson = encodeResult(observation.result);
+                }
+                catch (cause) {
+                    throw new LocalProtectionError("INVALID_TRUTH", "CONFIRMED provider truth needs a JSON-safe result. No second write was dispatched.", { cause });
+                }
+                const confirmation = db.prepare("UPDATE local_operations SET state='CONFIRMED',result_json=? WHERE id=? AND state='UNKNOWN'").run(resultJson, id);
+                if (confirmation.changes !== 1) {
+                    const latest = db.prepare("SELECT fingerprint,state,result_json,owner,lease_until FROM local_operations WHERE id=?").get(id);
+                    if (latest?.fingerprint === fingerprint && latest.state === "CONFIRMED" && latest.result_json !== null) {
+                        return decodeResult(latest.result_json);
+                    }
+                    throw new LocalProtectionError("UNKNOWN", `State changed while reconciling ${id}. Retry with the same id; no second write was dispatched.`);
+                }
+                return decodeResult(resultJson);
+            }
+            // Recheck handles whose state the selectors might have read while the
+            // claim was being established. A changed claim stays uncertain.
+            let currentFingerprint;
+            try {
+                if (options.id(...callArgs) !== id) {
+                    throw new Error("Logical action id changed.");
+                }
+                currentFingerprint = (0, binding_js_1.fingerprintConnectPayload)(copyData(options.payload(...callArgs)));
+            }
+            catch (cause) {
+                db.prepare("UPDATE local_operations SET state='UNKNOWN',owner=NULL,lease_until=NULL WHERE id=? AND state='CLAIMED' AND owner=?").run(id, owner);
+                throw new LocalProtectionError("PAYLOAD_DRIFT", `Payload of ${id} changed before dispatch. No operation was dispatched.`, { cause });
+            }
+            if (currentFingerprint !== fingerprint) {
+                db.prepare("UPDATE local_operations SET state='UNKNOWN',owner=NULL,lease_until=NULL WHERE id=? AND state='CLAIMED' AND owner=?").run(id, owner);
+                throw new LocalProtectionError("PAYLOAD_DRIFT", `Payload of ${id} changed before dispatch. No operation was dispatched.`);
+            }
+            let result;
+            try {
+                result = await operation.apply(this, callArgs);
+            }
+            catch (cause) {
+                db.prepare("UPDATE local_operations SET state='UNKNOWN',owner=NULL,lease_until=NULL WHERE id=? AND state='CLAIMED' AND owner=?").run(id, owner);
+                throw new LocalProtectionError("UNKNOWN", `Operation ${id} threw after dispatch; its external outcome may be unknown. Reconcile provider truth before retrying.`, { cause });
+            }
+            let resultJson;
+            try {
+                resultJson = encodeResult(result);
+            }
+            catch (cause) {
+                db.prepare("UPDATE local_operations SET state='UNKNOWN',owner=NULL,lease_until=NULL WHERE id=? AND state='CLAIMED' AND owner=?").run(id, owner);
+                throw new LocalProtectionError("UNREPLAYABLE_RESULT", `Operation ${id} returned a non-JSON-safe result. Outcome is UNKNOWN; return a JSON-safe receipt and reconcile before retrying.`, { cause });
+            }
+            const update = db.prepare("UPDATE local_operations SET state='CONFIRMED',result_json=?,owner=NULL,lease_until=NULL WHERE id=? AND state='CLAIMED' AND owner=?")
+                .run(resultJson, id, owner);
+            if (update.changes !== 1) {
+                throw new LocalProtectionError("EXECUTION_RIGHT_LOST", `Operation ${id} completed after its claim changed. Reconcile provider truth before retrying.`);
+            }
+            return decodeResult(resultJson);
+        }
+        finally {
+            db.close();
+        }
+    };
+}
+//# sourceMappingURL=local.js.map

package/dist-cjs/local.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@once-agent/sdk",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Execution safety for side-effecting AI agent tools.",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,11 +26,13 @@
     "test:dataset-seal": "npm run build && node ./scripts/dataset-seal-regression.mjs",
     "test:dataset-progress": "npm run build && node ./scripts/dataset-progress-regression.mjs",
     "test:agent-discovery": "node ./scripts/agent-discovery-regression.mjs",
+    "test:doctor": "npm run build && node ./scripts/doctor-adoption-regression.mjs",
     "routing:check": "node ./scripts/agent-routing-conformance.mjs",
     "routing:cases": "node ./scripts/agent-routing-conformance.mjs --emit-cases",
     "test:routing-conformance": "node ./scripts/agent-routing-conformance-regression.mjs",
     "test:contract": "npm run build && tsc --noEmit --target ES2022 --module NodeNext --moduleResolution NodeNext --strict --types node ./scripts/sdk-contract-types.ts && node ./scripts/sdk-contract-runtime.mjs",
-    "test:release": "npm run benchmark:scan && npm run test:benchmark && npm run test:trace && npm run test:dataset-seal && npm run test:dataset-progress && npm run test:agent-discovery && npm run test:routing-conformance && npm run test:scanner-declarations && npm run test:contract && npm run test:protect && npm run test:capabilities && npm run test:transformer && npm run test:binding && npm run test:patch-planner && npm run test:transformer-protect && npm run test:apply && npm run test:id-conformance && npm run test:consumer && npm run test:activation && npm run test:package && npm run test:runtime-setup && npm run test:connect",
+    "test:release": "npm run benchmark:scan && npm run test:benchmark && npm run test:trace && npm run test:dataset-seal && npm run test:dataset-progress && npm run test:agent-discovery && npm run test:doctor && npm run test:routing-conformance && npm run test:scanner-declarations && npm run test:contract && npm run test:protect && npm run test:capabilities && npm run test:transformer && npm run test:binding && npm run test:patch-planner && npm run test:transformer-protect && npm run test:apply && npm run test:id-conformance && npm run test:consumer && npm run test:activation && npm run test:package && npm run test:runtime-setup && npm run test:connect",
+    "test:local": "npm run build && node --test ./test/local.test.mjs",
     "test:connect": "npm run build && node --test ./test/connect/*.test.mjs",
     "test:protect": "npm run build && node ./scripts/protect-regression.mjs",
     "test:capabilities": "npm run build && node ./scripts/capability-regression.mjs",
@@ -47,7 +49,8 @@
     "build:cjs": "tsc -p tsconfig.cjs.json && node ./scripts/write-cjs-package.mjs",
     "test:runtime-setup": "npm run build && node ./scripts/runtime-setup-regression.mjs",
     "test:activation": "npm run build && node ./scripts/activation-regression.mjs",
-    "test:setup-persistence": "npm run build && node ./scripts/setup-persistence-regression.mjs"
+    "test:setup-persistence": "npm run build && node ./scripts/setup-persistence-regression.mjs",
+    "prepack": "npm run build"
   },
   "keywords": [
     "ai",