@dotcms/ai 26.8.13-1 → 26.8.14-1-next.2533

package/src/adapter/context.d.ts

@@ -12,6 +12,7 @@ export interface SiteSummary {
     hostname: string;
     isDefault: boolean;
     archived: boolean;
+    live: boolean;
 }
 export interface LanguageSummary {
     id: number;

package/src/runtime.d.ts

@@ -65,6 +65,8 @@ export type { AdapterContext, AdapterDef, AdapterMethodDef, DefinedAdapter } fro
 export { DotCMSError, ValidationError, PolicyError, HttpError, TimeoutError, AbortError, SandboxError, RuntimeError, isDotCMSError, serializeError } from './sandbox/errors';
 export type { DotCMSErrorCode, SerializedDotCMSError } from './sandbox/errors';
 export type { SandboxResult, SandboxResultError } from './sandbox/types';
+export { formatSandboxResult } from './sandbox/format-result';
+export type { FormatSandboxResultOptions } from './sandbox/format-result';
 export { isBinaryResponseEnvelope } from './adapter/request-core';
 export type { BinaryResponseEnvelope, RequestOptions, RequestCallEvent } from './adapter/request-core';
 export type { DotCMSContext, ContentTypeSummary, SiteSummary, LanguageSummary, CurrentUserSummary } from './adapter/context';

package/src/sandbox/format-result.d.ts

@@ -0,0 +1,18 @@
+import type { SandboxResult } from './types';
+export interface FormatSandboxResultOptions {
+    /** Hard cap on the returned string (chars). Default {@link DEFAULT_MAX_CHARS}. */
+    maxChars?: number;
+    /** Tool-specific guidance appended inside the truncation notice. */
+    truncationHint?: string;
+}
+/**
+ * Render a {@link SandboxResult} into the single string a tool hands back to the model, and
+ * hard-cap its length so one query can't flood the context window.
+ *
+ * There is NO truncation anywhere else on the result path — whatever the model's code returns is
+ * stringified whole. This is the one place that bounds it. The cap is applied to the final
+ * combined string in BOTH the success and error branches (an `HttpError` body embedded in an
+ * error message can itself be huge). On truncation, a clear notice explains the cut and tells the
+ * model how to narrow the query rather than silently dropping data.
+ */
+export declare function formatSandboxResult(result: SandboxResult, options?: FormatSandboxResultOptions): string;

package/src/sandbox/index.d.ts

@@ -9,6 +9,8 @@ export { Executor, createExecutor } from './executor';
 export type { ExecutorOptions } from './executor';
 export { createWorkerSandbox } from './factory';
 export type { ISandbox, SandboxFactory } from './interface';
+export { formatSandboxResult } from './format-result';
+export type { FormatSandboxResultOptions } from './format-result';
 export { defineAdapter, isDefinedAdapter, describeAdapterForLLM } from './define-adapter';
 export type { AdapterContext, AdapterDef, AdapterMethodDef, DefinedAdapter, RequestLike } from './define-adapter';
 export { DotCMSError, ValidationError, PolicyError, HttpError, TimeoutError, AbortError, SandboxError, RuntimeError, isDotCMSError, serializeError } from './errors';
@@ -35,7 +37,7 @@ export interface Sandbox {
     run<T = unknown>(code: string): Promise<SandboxResult<T>>;
 }
 /**
- * Create a sandbox over a set of adapters — the generic entry point shown in §6.2.
+ * 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