@dotcms/ai 26.10.20-1 → 26.10.21-1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotcms/ai",
-  "version": "26.10.20-1",
+  "version": "26.10.21-1",
   "description": "The dotCMS agentic runtime — run model-written or human-written code safely against a dotCMS instance, with auth and policy owned in one place.",
   "repository": {
     "type": "git",
@@ -8,6 +8,7 @@
     "directory": "core-web/libs/sdk/ai"
   },
   "dependencies": {
+    "@dotcms/types": "26.10.21-1",
     "tslib": "^2.3.0",
     "zod": "^4.1.9"
   },
@@ -23,34 +24,34 @@
       "default": "./runtime.cjs.js"
     },
     "./sandbox": {
-      "module": "./runtime.esm.js",
-      "types": "./src/sandbox/index.d.ts",
-      "import": "./runtime.cjs.mjs",
-      "default": "./runtime.cjs.js"
+      "module": "./sandbox.esm.js",
+      "types": "./sandbox.d.ts",
+      "import": "./sandbox.cjs.mjs",
+      "default": "./sandbox.cjs.js"
     },
     "./adapter": {
-      "module": "./runtime.esm.js",
-      "types": "./src/adapter/index.d.ts",
-      "import": "./runtime.cjs.mjs",
-      "default": "./runtime.cjs.js"
+      "module": "./adapter.esm.js",
+      "types": "./adapter.d.ts",
+      "import": "./adapter.cjs.mjs",
+      "default": "./adapter.cjs.js"
     },
     "./spec": {
       "module": "./spec.esm.js",
-      "types": "./src/spec/index.d.ts",
-      "import": "./spec.cjs.js",
+      "types": "./spec.d.ts",
+      "import": "./spec.cjs.mjs",
       "default": "./spec.cjs.js"
     },
+    "./tools": {
+      "module": "./tools.esm.js",
+      "types": "./tools.d.ts",
+      "import": "./tools.cjs.mjs",
+      "default": "./tools.cjs.js"
+    },
     ".": {
       "module": "./runtime.esm.js",
       "types": "./runtime.d.ts",
       "import": "./runtime.cjs.mjs",
       "default": "./runtime.cjs.js"
-    },
-    "./index": {
-      "module": "./index.esm.js",
-      "types": "./index.d.ts",
-      "import": "./index.cjs.mjs",
-      "default": "./index.cjs.js"
     }
   },
   "typesVersions": {
@@ -59,13 +60,16 @@
         "./runtime.d.ts"
       ],
       "sandbox": [
-        "./src/sandbox/index.d.ts"
+        "./sandbox.d.ts"
       ],
       "adapter": [
-        "./src/adapter/index.d.ts"
+        "./adapter.d.ts"
       ],
       "spec": [
-        "./src/spec/index.d.ts"
+        "./spec.d.ts"
+      ],
+      "tools": [
+        "./tools.d.ts"
       ]
     }
   },
@@ -77,6 +81,7 @@
     "agentic",
     "runtime",
     "sandbox",
+    "tools",
     "MCP",
     "model-context-protocol"
   ],

package/sandbox.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./sandbox.cjs.js').default;

package/sandbox.cjs.js

@@ -0,0 +1,69 @@
+'use strict';
+
+var formatResult = require('./format-result.cjs.js');
+require('node:worker_threads');
+var errors = require('./errors.cjs.js');
+require('zod');
+
+/**
+ * `@dotcms/ai/sandbox` — the generic execution engine. ZERO dotCMS code lives here (a
+ * lint-enforced module boundary); this subpath is fully generic. The dotCMS wiring lives in
+ * `@dotcms/ai/adapter`, and the front door that combines them in `@dotcms/ai`.
+ */
+/**
+ * Create a sandbox over a set of adapters — the generic entry point.
+ *
+ * `defineAdapter` results are bound to the injected host `request` (and a per-run abort
+ * signal) via `withContext`; plain hand-built adapters are passed through untouched. Each
+ * `run()` gets its own `AbortController`, so a timeout aborts in-flight host work.
+ */
+function createSandbox(config) {
+    return {
+        async run(code) {
+            const controller = new AbortController();
+            const ctx = {
+                request: config.request ?? notProvided,
+                signal: controller.signal
+            };
+            const adapters = config.adapters.map((a) => formatResult.isDefinedAdapter(a) ? a.withContext(ctx) : a);
+            const executor = new formatResult.Executor({
+                config: {
+                    adapters,
+                    sandbox: {
+                        timeout: config.timeout,
+                        globals: config.globals,
+                        resourceLimits: config.resourceLimits,
+                        onTeardown: () => controller.abort()
+                    }
+                }
+            });
+            return executor.execute(code, {
+                adapters: adapters.map((a) => a.name)
+            });
+        }
+    };
+}
+const notProvided = () => {
+    throw new Error('This adapter needs a host `request` capability. Pass `request` to createSandbox(), ' +
+        'or use createRuntime() from "@dotcms/ai/runtime" which provides one.');
+};
+
+exports.Executor = formatResult.Executor;
+exports.createExecutor = formatResult.createExecutor;
+exports.createWorkerSandbox = formatResult.createWorkerSandbox;
+exports.defineAdapter = formatResult.defineAdapter;
+exports.describeAdapterForLLM = formatResult.describeAdapterForLLM;
+exports.formatSandboxResult = formatResult.formatSandboxResult;
+exports.isDefinedAdapter = formatResult.isDefinedAdapter;
+exports.AbortError = errors.AbortError;
+exports.DotCMSError = errors.DotCMSError;
+exports.HttpError = errors.HttpError;
+exports.NetworkError = errors.NetworkError;
+exports.PolicyError = errors.PolicyError;
+exports.RuntimeError = errors.RuntimeError;
+exports.SandboxError = errors.SandboxError;
+exports.TimeoutError = errors.TimeoutError;
+exports.ValidationError = errors.ValidationError;
+exports.isDotCMSError = errors.isDotCMSError;
+exports.serializeError = errors.serializeError;
+exports.createSandbox = createSandbox;

package/sandbox.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './sandbox.cjs.js';
+export { _default as default } from './sandbox.cjs.default.js';

package/sandbox.d.ts

@@ -0,0 +1 @@
+export * from "./src/sandbox";

package/sandbox.esm.js

@@ -0,0 +1,50 @@
+import { i as isDefinedAdapter, E as Executor } from './format-result.esm.js';
+export { c as createExecutor, a as createWorkerSandbox, d as defineAdapter, b as describeAdapterForLLM, f as formatSandboxResult } from './format-result.esm.js';
+import 'node:worker_threads';
+export { A as AbortError, D as DotCMSError, H as HttpError, N as NetworkError, P as PolicyError, R as RuntimeError, S as SandboxError, T as TimeoutError, V as ValidationError, i as isDotCMSError, s as serializeError } from './errors.esm.js';
+import 'zod';
+
+/**
+ * `@dotcms/ai/sandbox` — the generic execution engine. ZERO dotCMS code lives here (a
+ * lint-enforced module boundary); this subpath is fully generic. The dotCMS wiring lives in
+ * `@dotcms/ai/adapter`, and the front door that combines them in `@dotcms/ai`.
+ */
+/**
+ * Create a sandbox over a set of adapters — the generic entry point.
+ *
+ * `defineAdapter` results are bound to the injected host `request` (and a per-run abort
+ * signal) via `withContext`; plain hand-built adapters are passed through untouched. Each
+ * `run()` gets its own `AbortController`, so a timeout aborts in-flight host work.
+ */
+function createSandbox(config) {
+    return {
+        async run(code) {
+            const controller = new AbortController();
+            const ctx = {
+                request: config.request ?? notProvided,
+                signal: controller.signal
+            };
+            const adapters = config.adapters.map((a) => isDefinedAdapter(a) ? a.withContext(ctx) : a);
+            const executor = new Executor({
+                config: {
+                    adapters,
+                    sandbox: {
+                        timeout: config.timeout,
+                        globals: config.globals,
+                        resourceLimits: config.resourceLimits,
+                        onTeardown: () => controller.abort()
+                    }
+                }
+            });
+            return executor.execute(code, {
+                adapters: adapters.map((a) => a.name)
+            });
+        }
+    };
+}
+const notProvided = () => {
+    throw new Error('This adapter needs a host `request` capability. Pass `request` to createSandbox(), ' +
+        'or use createRuntime() from "@dotcms/ai/runtime" which provides one.');
+};
+
+export { Executor, createSandbox, isDefinedAdapter };

package/spec.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./spec.cjs.js').default;