@sixb/core 0.1.20 → 0.1.22

package/dist/chunk-9gyp8hg1.js

@@ -1,363 +0,0 @@
-// @bun
-import {
-  assertValidSchema
-} from "./chunk-1k89ecfr.js";
-import {
-  normalizeParams,
-  coerceParamsToTyped
-} from "./chunk-c85m1hyj.js";
-import {
-  isPlainRecord
-} from "./chunk-wy0qdqfm.js";
-
-// src/sandboxes/errors.ts
-class SandboxError2 extends Error {
-  name = "SandboxError";
-}
-
-class SandboxStateUnavailableError2 extends SandboxError2 {
-  name = "SandboxStateUnavailableError";
-}
-
-class SandboxNotRunningError2 extends SandboxError2 {
-  name = "SandboxNotRunningError";
-}
-
-class SandboxTimeoutError2 extends SandboxError2 {
-  name = "SandboxTimeoutError";
-}
-
-class SandboxIsolationUnavailableError2 extends SandboxError2 {
-  name = "SandboxIsolationUnavailableError";
-}
-
-// src/sandboxes/configuration.ts
-function createSandboxDefinition(config, ontology) {
-  const raw = config;
-  if (!isPlainRecord(raw) || config.params !== undefined && !isPlainRecord(raw.params) || config.resolve !== undefined && typeof config.resolve !== "function") {
-    throw new SandboxError2("[Sixb] Sandbox configuration requires a params object and a callable resolver when provided.");
-  }
-  for (const key of Object.keys(config)) {
-    if (!["params", "resolve", "source", "setup", "env", "network", "auth"].includes(key)) {
-      throw new SandboxError2("[Sixb] Unknown sandbox configuration field.");
-    }
-  }
-  if (config.auth !== undefined && typeof config.auth?.authorize !== "function") {
-    throw new SandboxError2("[Sixb] sandboxes.auth requires an authorize function.");
-  }
-  if (config.params !== undefined && config.resolve === undefined) {
-    throw new SandboxError2("[Sixb] Sandbox params require a resolve function.");
-  }
-  if (config.resolve !== undefined && (config.source !== undefined || config.setup !== undefined)) {
-    throw new SandboxError2("[Sixb] Use either static source/setup or resolve, not both.");
-  }
-  const invalid = (path) => new SandboxError2(`[Sixb] ${path} must be a valid parameter declaration; use param(schema).`);
-  for (const [id, value] of Object.entries(config.params ?? {})) {
-    const path = `sandboxes.params.${id}`;
-    if (!id.trim() || !isPlainRecord(value))
-      throw invalid(path);
-    for (const key of Object.keys(value)) {
-      if (!["schema", "required", "nullable", "description", "semanticType"].includes(key)) {
-        throw invalid(path);
-      }
-    }
-    if (value.required !== undefined && typeof value.required !== "boolean" || value.nullable !== undefined && typeof value.nullable !== "boolean" || value.description !== undefined && typeof value.description !== "string" || value.semanticType !== undefined && typeof value.semanticType !== "string")
-      throw invalid(path);
-    const schema = value.schema;
-    if (isPlainRecord(schema) && schema.type === "objectRef") {
-      if (typeof schema.objectTypeId !== "string" || !ontology.getObjectTypesById().has(schema.objectTypeId)) {
-        throw invalid(path);
-      }
-    } else {
-      assertValidSchema(schema, `${path}.schema`, invalid);
-    }
-  }
-  const params = structuredClone(config.params ?? {});
-  const environment = captureEnvironment({
-    ...config.source === undefined ? {} : { source: config.source },
-    ...config.setup === undefined ? {} : { setup: config.setup },
-    ...config.env === undefined ? {} : { env: config.env },
-    ...config.network === undefined ? {} : { network: config.network }
-  });
-  const resolve = config.resolve;
-  const authorize = config.auth?.authorize.bind(config.auth);
-  deepFreeze(params);
-  return Object.freeze({
-    params,
-    ...authorize ? { auth: Object.freeze({ authorize }) } : {},
-    resolve: async ({ params: input, sixb }) => {
-      const binding = normalizeParams(ontology.getValueTypesById(), params, input, {
-        kind: "sandbox",
-        id: "sandboxes",
-        path: "sandbox"
-      });
-      const typed = coerceParamsToTyped(params, binding, ontology.getValueTypesById());
-      if (!resolve)
-        return structuredClone(environment);
-      const resolved = captureEnvironment(await resolve({ params: typed, sixb }));
-      return {
-        ...structuredClone(environment),
-        ...resolved,
-        env: { ...environment.env, ...resolved.env }
-      };
-    }
-  });
-}
-function captureEnvironment(value) {
-  if (!isPlainRecord(value) || Object.keys(value).some((key) => !["source", "setup", "env", "network"].includes(key))) {
-    return fail("environment");
-  }
-  if (value.source !== undefined)
-    validateSource(value.source);
-  if (value.setup !== undefined)
-    validateSetup(value.setup);
-  if (value.env !== undefined)
-    validateEnv(value.env);
-  if (value.network !== undefined)
-    validateNetwork(value.network);
-  return structuredClone(value);
-}
-function fail(field) {
-  throw new SandboxError2(`[Sixb] Invalid sandbox ${field}.`);
-}
-function validateSource(source) {
-  if (!isPlainRecord(source) || source.type !== "git" || typeof source.url !== "string" || Object.keys(source).some((key) => !["type", "url", "revision", "access"].includes(key))) {
-    fail("source");
-  }
-  const url = parseUrl(source.url, "source URL");
-  if (url.protocol !== "https:" || url.username || url.password || url.search || url.hash) {
-    fail("source URL: expected credential-free HTTPS");
-  }
-  if (source.revision !== undefined && (typeof source.revision !== "string" || !source.revision.trim() || source.revision.startsWith("-") || /[\x00-\x1f]/.test(source.revision))) {
-    fail("source revision");
-  }
-  if (source.access !== undefined && source.access !== "read" && source.access !== "write") {
-    fail("source access");
-  }
-}
-function validateSetup(setup) {
-  if (!Array.isArray(setup) || setup.some((command) => typeof command !== "string" || !command.trim() || command.includes("\x00"))) {
-    fail("setup");
-  }
-}
-function validateEnv(env) {
-  if (!isPlainRecord(env) || Object.entries(env).some(([key, entry]) => !key || /[=\0]/.test(key) || typeof entry !== "string" || entry.includes("\x00"))) {
-    fail("env");
-  }
-}
-function validateNetwork(network) {
-  if (!isPlainRecord(network))
-    fail("network");
-  if (network.mode === "restricted") {
-    if (Object.keys(network).some((key) => key !== "mode" && key !== "allow") || !Array.isArray(network.allow)) {
-      fail("network");
-    }
-    for (const target of network.allow)
-      validateNetworkTarget(target);
-    return;
-  }
-  if (network.mode !== "none" && network.mode !== "all" || Object.keys(network).some((key) => key !== "mode")) {
-    fail("network");
-  }
-}
-function validateNetworkTarget(target) {
-  if (!isPlainRecord(target) || typeof target.name !== "string" || !target.name.trim() || typeof target.origin !== "string" || Object.keys(target).some((key) => key !== "name" && key !== "origin")) {
-    fail("network target");
-  }
-  const url = parseUrl(target.origin, "network origin");
-  if (!["http:", "https:"].includes(url.protocol) || url.origin !== target.origin) {
-    fail("network origin");
-  }
-}
-function parseUrl(value, field) {
-  try {
-    return new URL(value);
-  } catch {
-    return fail(field);
-  }
-}
-function deepFreeze(value, seen = new Set) {
-  if (seen.has(value))
-    return;
-  seen.add(value);
-  for (const child of Object.values(value)) {
-    if (child !== null && typeof child === "object")
-      deepFreeze(child, seen);
-  }
-  Object.freeze(value);
-}
-
-// src/sandboxes/config.ts
-function sandboxConfig2(options) {
-  if (options.auth !== undefined && typeof options.auth?.authorize !== "function") {
-    throw new SandboxError2("[Sixb] sandboxes.auth requires an authorize function.");
-  }
-  const authorize = options.auth?.authorize.bind(options.auth);
-  if (options.params !== undefined && options.resolve === undefined) {
-    throw new SandboxError2("[Sixb] Sandbox params require a resolve function.");
-  }
-  if (options.resolve !== undefined && typeof options.resolve !== "function") {
-    throw new SandboxError2("[Sixb] Sandbox resolve must be a function.");
-  }
-  if (options.resolve !== undefined && (options.source !== undefined || options.setup !== undefined)) {
-    throw new SandboxError2("[Sixb] Use either static source/setup or resolve, not both.");
-  }
-  const environment = captureEnvironment({
-    ...options.source === undefined ? {} : { source: options.source },
-    ...options.setup === undefined ? {} : { setup: options.setup },
-    ...options.env === undefined ? {} : { env: options.env },
-    ...options.network === undefined ? {} : { network: options.network }
-  });
-  return Object.freeze({
-    ...authorize ? { auth: Object.freeze({ authorize }) } : {},
-    ...environment,
-    ...options.params === undefined ? {} : { params: structuredClone(options.params) },
-    ...options.resolve === undefined ? {} : { resolve: options.resolve }
-  });
-}
-// src/sandboxes/environment.ts
-import { posix } from "path";
-function sandboxCreationEnvironment2(configuration, options) {
-  if (options.environment === undefined && configuration.resolve !== undefined) {
-    throw new SandboxError2("[Sixb] Dynamic sandbox configuration requires an execution-resolved environment.");
-  }
-  const environment = captureEnvironment(options.environment !== undefined ? options.environment : {
-    ...configuration.source === undefined ? {} : { source: configuration.source },
-    ...configuration.setup === undefined ? {} : { setup: configuration.setup }
-  });
-  if (environment.env !== undefined || environment.network !== undefined) {
-    throw new SandboxError2("[Sixb] Pass env and network as sandbox session options, not environment.");
-  }
-  if (environment.source) {
-    if ((configuration.auth !== undefined || environment.source.access === "write") && !options.requestCredentials?.length) {
-      throw new SandboxError2("[Sixb] Sandbox source authentication requires execution-prepared request credentials.");
-    }
-    const network = options.network ?? configuration.network ?? { mode: "none" };
-    const origin = new URL(environment.source.url).origin;
-    if (network.mode === "none" || network.mode === "restricted" && !network.allow.some((target) => target.origin === origin)) {
-      throw new SandboxError2("[Sixb] Sandbox network policy denies the source origin.");
-    }
-  }
-  options.signal?.throwIfAborted();
-  return environment;
-}
-function sandboxProjectDirectory2(session, hasSource) {
-  if (!hasSource)
-    return session;
-  const workingDirectory = posix.join(session.workingDirectory, "repository");
-  return {
-    id: session.id,
-    provider: session.provider,
-    get status() {
-      return session.status;
-    },
-    workingDirectory,
-    ...session.setRequestCredentials ? { setRequestCredentials: session.setRequestCredentials.bind(session) } : {},
-    runCommand: (command, args, options) => session.runCommand(command, args, { ...options, cwd: options?.cwd ?? workingDirectory }),
-    writeFiles: (files) => session.writeFiles(files.map((file) => ({
-      ...file,
-      path: posix.isAbsolute(file.path) ? file.path : posix.join(workingDirectory, file.path)
-    }))),
-    stop: () => session.stop(),
-    destroy: () => session.destroy()
-  };
-}
-async function initializeSandboxEnvironment2(session, environment, signal) {
-  environment = captureEnvironment(environment);
-  const run = async (sandbox, command, args) => {
-    signal?.throwIfAborted();
-    const result = await sandbox.runCommand(command, args, { timeout: 120000, signal });
-    if (result.exitCode !== 0 || result.timedOut) {
-      throw new SandboxError2("[Sixb] Sandbox environment initialization failed.");
-    }
-  };
-  signal?.throwIfAborted();
-  const sandbox = sandboxProjectDirectory2(session, environment.source !== undefined);
-  if (environment.source) {
-    await run(session, "git", ["clone", "--", environment.source.url, "repository"]);
-    if (environment.source.revision) {
-      await run(sandbox, "git", ["checkout", environment.source.revision, "--"]);
-    }
-  }
-  for (const command of environment.setup ?? [])
-    await run(sandbox, "bash", ["-lc", command]);
-  return sandbox;
-}
-// src/sandboxes/exec.ts
-var DEFAULT_KILL_EXIT_CODE = 137;
-async function exec2(options) {
-  const start = Date.now();
-  const [head, ...rest] = options.argv;
-  if (!head) {
-    return {
-      exitCode: 1,
-      stdout: "",
-      stderr: "[Sandbox] empty argv",
-      durationMs: 0
-    };
-  }
-  let proc;
-  try {
-    proc = Bun.spawn([head, ...rest], {
-      cwd: options.cwd,
-      env: options.env,
-      stdin: "ignore",
-      stdout: "pipe",
-      stderr: "pipe"
-    });
-  } catch (error) {
-    return {
-      exitCode: 127,
-      stdout: "",
-      stderr: error instanceof Error ? error.message : String(error),
-      durationMs: Date.now() - start
-    };
-  }
-  let timedOut = false;
-  let killed = false;
-  const timer = options.timeoutMs !== undefined && options.timeoutMs > 0 ? setTimeout(() => {
-    timedOut = true;
-    killed = true;
-    proc.kill("SIGKILL");
-  }, options.timeoutMs) : undefined;
-  const onAbort = () => {
-    if (!killed) {
-      killed = true;
-      proc.kill("SIGKILL");
-    }
-  };
-  options.signal?.addEventListener("abort", onAbort);
-  if (options.signal?.aborted) {
-    onAbort();
-  }
-  let stdout = "";
-  let stderr = "";
-  let exitCode = 0;
-  try {
-    const [stdoutText, stderrText, code] = await Promise.all([
-      new Response(proc.stdout).text(),
-      new Response(proc.stderr).text(),
-      proc.exited
-    ]);
-    stdout = stdoutText;
-    stderr = stderrText;
-    exitCode = typeof code === "number" ? code : DEFAULT_KILL_EXIT_CODE;
-  } finally {
-    if (timer !== undefined)
-      clearTimeout(timer);
-    options.signal?.removeEventListener("abort", onAbort);
-  }
-  if (killed && exitCode === 0) {
-    exitCode = DEFAULT_KILL_EXIT_CODE;
-  }
-  return {
-    exitCode,
-    stdout,
-    stderr,
-    durationMs: Date.now() - start,
-    ...timedOut ? { timedOut: true } : {}
-  };
-}
-export { SandboxError2, SandboxStateUnavailableError2, SandboxNotRunningError2, SandboxTimeoutError2, SandboxIsolationUnavailableError2, createSandboxDefinition, sandboxConfig2, sandboxCreationEnvironment2, sandboxProjectDirectory2, initializeSandboxEnvironment2, exec2 };
-
-//# debugId=C3376C4D866A438264756E2164756E21

package/dist/chunk-9gyp8hg1.js.map

@@ -1,14 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/sandboxes/errors.ts", "../src/sandboxes/configuration.ts", "../src/sandboxes/config.ts", "../src/sandboxes/environment.ts", "../src/sandboxes/exec.ts"],
-  "sourcesContent": [
-    "/**\n * Errors thrown by sandbox providers. Hosts can catch SandboxError at the\n * audit boundary while still distinguishing recoverable provider states.\n */\nexport class SandboxError extends Error {\n  readonly name: string = \"SandboxError\"\n}\n\n/** Confirmed missing/expired state. Never use for transport, authorization or session setup errors. */\nexport class SandboxStateUnavailableError extends SandboxError {\n  override readonly name = \"SandboxStateUnavailableError\"\n}\n\n/** runCommand / stop / destroy called after the sandbox is stopped or destroyed. */\nexport class SandboxNotRunningError extends SandboxError {\n  override readonly name = \"SandboxNotRunningError\"\n}\n\n/** Command exceeded its timeout and was killed. */\nexport class SandboxTimeoutError extends SandboxError {\n  override readonly name = \"SandboxTimeoutError\"\n}\n\n/** Requested isolation backend is not available on the host. */\nexport class SandboxIsolationUnavailableError extends SandboxError {\n  override readonly name = \"SandboxIsolationUnavailableError\"\n}\n",
-    "import { isPlainRecord } from \"../json\"\nimport type { OntologyRegistry } from \"../ontology/registry\"\nimport { assertValidSchema } from \"../ontology/validation/definition\"\nimport type { Sixb } from \"../runtime/sixb\"\nimport type { InferParams, ParamsConfig } from \"../shared/params/types\"\nimport { coerceParamsToTyped, normalizeParams } from \"../shared/params/validation\"\nimport type { SandboxSourceAuth } from \"./auth\"\nimport { SandboxError } from \"./errors\"\nimport type { SandboxNetworkPolicy } from \"./sandbox\"\n\n/** Static recipes accept an empty parameter record, not arbitrary undeclared keys. */\nexport type InferSandboxParams<TParams extends ParamsConfig> = keyof TParams extends never\n  ? Record<string, never>\n  : InferParams<TParams>\n\n/** Initial project contents, independent from the provider's runtime image or saved state. */\nexport interface SandboxSource {\n  readonly type: \"git\"\n  readonly url: string\n  readonly revision?: string\n  readonly access?: \"read\" | \"write\"\n}\n\n/** Host-side recipe. Environment values are guest-readable, never a Git credential channel. */\nexport interface SandboxEnvironment {\n  readonly source?: SandboxSource\n  readonly setup?: readonly string[]\n  readonly env?: Readonly<Record<string, string>>\n  readonly network?: SandboxNetworkPolicy\n}\n\nexport interface SandboxResolveContext<TParams = Record<string, unknown>> {\n  readonly params: TParams\n  /** Bound to the current execution; a stored binding is not authorization. */\n  readonly sixb: Sixb\n}\n\n// The recipe both declares and consumes this schema: keep it invariant instead of asking\n// TypeScript to compare the recursive ontology inference through callback variance.\n// Provider option interfaces must preserve this annotation when extending the config.\nexport interface SandboxConfig<in out TParams extends ParamsConfig = ParamsConfig>\n  extends SandboxEnvironment {\n  readonly auth?: SandboxSourceAuth\n  readonly params?: TParams\n  readonly resolve?: (\n    context: SandboxResolveContext<InferParams<NoInfer<TParams>>>\n  ) => SandboxEnvironment | Promise<SandboxEnvironment>\n}\n\n/** Registered project recipe; only thread params cross the durable boundary. */\nexport interface SandboxDefinition {\n  readonly auth?: SandboxSourceAuth\n  readonly params: ParamsConfig\n  readonly resolve: (context: SandboxResolveContext) => Promise<SandboxEnvironment>\n}\n\nexport function createSandboxDefinition<TParams extends ParamsConfig>(\n  config: SandboxConfig<TParams>,\n  ontology: OntologyRegistry\n): SandboxDefinition {\n  const raw: unknown = config\n  if (\n    !isPlainRecord(raw) ||\n    (config.params !== undefined && !isPlainRecord(raw.params)) ||\n    (config.resolve !== undefined && typeof config.resolve !== \"function\")\n  ) {\n    throw new SandboxError(\n      \"[Sixb] Sandbox configuration requires a params object and a callable resolver when provided.\"\n    )\n  }\n  for (const key of Object.keys(config)) {\n    if (![\"params\", \"resolve\", \"source\", \"setup\", \"env\", \"network\", \"auth\"].includes(key)) {\n      throw new SandboxError(\"[Sixb] Unknown sandbox configuration field.\")\n    }\n  }\n  if (config.auth !== undefined && typeof config.auth?.authorize !== \"function\") {\n    throw new SandboxError(\"[Sixb] sandboxes.auth requires an authorize function.\")\n  }\n  if (config.params !== undefined && config.resolve === undefined) {\n    throw new SandboxError(\"[Sixb] Sandbox params require a resolve function.\")\n  }\n  if (config.resolve !== undefined && (config.source !== undefined || config.setup !== undefined)) {\n    throw new SandboxError(\"[Sixb] Use either static source/setup or resolve, not both.\")\n  }\n  const invalid = (path: string) =>\n    new SandboxError(`[Sixb] ${path} must be a valid parameter declaration; use param(schema).`)\n  for (const [id, value] of Object.entries(config.params ?? {})) {\n    const path = `sandboxes.params.${id}`\n    if (!id.trim() || !isPlainRecord(value)) throw invalid(path)\n    for (const key of Object.keys(value)) {\n      if (![\"schema\", \"required\", \"nullable\", \"description\", \"semanticType\"].includes(key)) {\n        throw invalid(path)\n      }\n    }\n    if (\n      (value.required !== undefined && typeof value.required !== \"boolean\") ||\n      (value.nullable !== undefined && typeof value.nullable !== \"boolean\") ||\n      (value.description !== undefined && typeof value.description !== \"string\") ||\n      (value.semanticType !== undefined && typeof value.semanticType !== \"string\")\n    )\n      throw invalid(path)\n    const schema: unknown = value.schema\n    if (isPlainRecord(schema) && schema.type === \"objectRef\") {\n      if (\n        typeof schema.objectTypeId !== \"string\" ||\n        !ontology.getObjectTypesById().has(schema.objectTypeId)\n      ) {\n        throw invalid(path)\n      }\n    } else {\n      assertValidSchema(schema, `${path}.schema`, invalid)\n    }\n  }\n  const params = structuredClone(config.params ?? {}) as ParamsConfig\n  const environment = captureEnvironment({\n    ...(config.source === undefined ? {} : { source: config.source }),\n    ...(config.setup === undefined ? {} : { setup: config.setup }),\n    ...(config.env === undefined ? {} : { env: config.env }),\n    ...(config.network === undefined ? {} : { network: config.network }),\n  })\n  // Capture the function too: later mutation of application config must not change this host.\n  // Erase inference only after capturing its schema; every invocation validates and coerces below.\n  const resolve = config.resolve as SandboxConfig[\"resolve\"]\n  const authorize = config.auth?.authorize.bind(config.auth)\n  deepFreeze(params)\n  return Object.freeze({\n    params,\n    ...(authorize ? { auth: Object.freeze({ authorize }) } : {}),\n    resolve: async ({ params: input, sixb }: SandboxResolveContext) => {\n      const binding = normalizeParams(ontology.getValueTypesById(), params, input, {\n        kind: \"sandbox\",\n        id: \"sandboxes\",\n        path: \"sandbox\",\n      })\n      const typed = coerceParamsToTyped(params, binding, ontology.getValueTypesById())\n      if (!resolve) return structuredClone(environment)\n      const resolved = captureEnvironment(await resolve({ params: typed, sixb }))\n      return {\n        ...structuredClone(environment),\n        ...resolved,\n        env: { ...environment.env, ...resolved.env },\n      }\n    },\n  })\n}\n\n/** Capture declarative data only; never retain caller-owned objects or include values in errors. */\nexport function captureEnvironment(value: unknown): SandboxEnvironment {\n  if (\n    !isPlainRecord(value) ||\n    Object.keys(value).some((key) => ![\"source\", \"setup\", \"env\", \"network\"].includes(key))\n  ) {\n    return fail(\"environment\")\n  }\n  if (value.source !== undefined) validateSource(value.source)\n  if (value.setup !== undefined) validateSetup(value.setup)\n  if (value.env !== undefined) validateEnv(value.env)\n  if (value.network !== undefined) validateNetwork(value.network)\n  // Every field and discriminant has been checked above; return only an isolated snapshot.\n  return structuredClone(value) as SandboxEnvironment\n}\n\nfunction fail(field: string): never {\n  throw new SandboxError(`[Sixb] Invalid sandbox ${field}.`)\n}\n\nfunction validateSource(source: unknown): void {\n  if (\n    !isPlainRecord(source) ||\n    source.type !== \"git\" ||\n    typeof source.url !== \"string\" ||\n    Object.keys(source).some((key) => ![\"type\", \"url\", \"revision\", \"access\"].includes(key))\n  ) {\n    fail(\"source\")\n  }\n  const url = parseUrl(source.url, \"source URL\")\n  if (url.protocol !== \"https:\" || url.username || url.password || url.search || url.hash) {\n    fail(\"source URL: expected credential-free HTTPS\")\n  }\n  if (\n    source.revision !== undefined &&\n    (typeof source.revision !== \"string\" ||\n      !source.revision.trim() ||\n      source.revision.startsWith(\"-\") ||\n      /[\\x00-\\x1f]/.test(source.revision))\n  ) {\n    fail(\"source revision\")\n  }\n  if (source.access !== undefined && source.access !== \"read\" && source.access !== \"write\") {\n    fail(\"source access\")\n  }\n}\n\nfunction validateSetup(setup: unknown): void {\n  if (\n    !Array.isArray(setup) ||\n    setup.some(\n      (command) => typeof command !== \"string\" || !command.trim() || command.includes(\"\\0\")\n    )\n  ) {\n    fail(\"setup\")\n  }\n}\n\nfunction validateEnv(env: unknown): void {\n  if (\n    !isPlainRecord(env) ||\n    Object.entries(env).some(\n      ([key, entry]) =>\n        !key || /[=\\0]/.test(key) || typeof entry !== \"string\" || entry.includes(\"\\0\")\n    )\n  ) {\n    fail(\"env\")\n  }\n}\n\nfunction validateNetwork(network: unknown): void {\n  if (!isPlainRecord(network)) fail(\"network\")\n  if (network.mode === \"restricted\") {\n    if (\n      Object.keys(network).some((key) => key !== \"mode\" && key !== \"allow\") ||\n      !Array.isArray(network.allow)\n    ) {\n      fail(\"network\")\n    }\n    for (const target of network.allow) validateNetworkTarget(target)\n    return\n  }\n  if (\n    (network.mode !== \"none\" && network.mode !== \"all\") ||\n    Object.keys(network).some((key) => key !== \"mode\")\n  ) {\n    fail(\"network\")\n  }\n}\n\nfunction validateNetworkTarget(target: unknown): void {\n  if (\n    !isPlainRecord(target) ||\n    typeof target.name !== \"string\" ||\n    !target.name.trim() ||\n    typeof target.origin !== \"string\" ||\n    Object.keys(target).some((key) => key !== \"name\" && key !== \"origin\")\n  ) {\n    fail(\"network target\")\n  }\n  const url = parseUrl(target.origin, \"network origin\")\n  if (![\"http:\", \"https:\"].includes(url.protocol) || url.origin !== target.origin) {\n    fail(\"network origin\")\n  }\n}\n\nfunction parseUrl(value: string, field: string): URL {\n  try {\n    return new URL(value)\n  } catch {\n    return fail(field)\n  }\n}\n\nfunction deepFreeze(value: object, seen = new Set<object>()): void {\n  if (seen.has(value)) return\n  seen.add(value)\n  for (const child of Object.values(value)) {\n    if (child !== null && typeof child === \"object\") deepFreeze(child, seen)\n  }\n  Object.freeze(value)\n}\n",
-    "import type { ParamsConfig } from \"../shared/params/types\"\nimport { captureEnvironment, type SandboxConfig } from \"./configuration\"\nimport { SandboxError } from \"./errors\"\n\n/** Extract only the common recipe; provider credentials and infrastructure stay on the factory. */\nexport function sandboxConfig<TParams extends ParamsConfig>(\n  options: SandboxConfig<TParams>\n): SandboxConfig<TParams> {\n  if (options.auth !== undefined && typeof options.auth?.authorize !== \"function\") {\n    throw new SandboxError(\"[Sixb] sandboxes.auth requires an authorize function.\")\n  }\n  const authorize = options.auth?.authorize.bind(options.auth)\n  if (options.params !== undefined && options.resolve === undefined) {\n    throw new SandboxError(\"[Sixb] Sandbox params require a resolve function.\")\n  }\n  if (options.resolve !== undefined && typeof options.resolve !== \"function\") {\n    throw new SandboxError(\"[Sixb] Sandbox resolve must be a function.\")\n  }\n  if (\n    options.resolve !== undefined &&\n    (options.source !== undefined || options.setup !== undefined)\n  ) {\n    throw new SandboxError(\"[Sixb] Use either static source/setup or resolve, not both.\")\n  }\n  const environment = captureEnvironment({\n    ...(options.source === undefined ? {} : { source: options.source }),\n    ...(options.setup === undefined ? {} : { setup: options.setup }),\n    ...(options.env === undefined ? {} : { env: options.env }),\n    ...(options.network === undefined ? {} : { network: options.network }),\n  })\n  return Object.freeze({\n    ...(authorize ? { auth: Object.freeze({ authorize }) } : {}),\n    ...environment,\n    ...(options.params === undefined ? {} : { params: structuredClone(options.params) }),\n    ...(options.resolve === undefined ? {} : { resolve: options.resolve }),\n  })\n}\n",
-    "import { posix } from \"node:path\"\nimport type { ParamsConfig } from \"../shared/params/types\"\nimport type { SandboxConfig } from \"./configuration\"\nimport { captureEnvironment, type SandboxEnvironment } from \"./configuration\"\nimport { SandboxError } from \"./errors\"\nimport type { CreateSandboxOptions, Sandbox } from \"./sandbox\"\n\n/** Select and validate before provisioning. Only the execution runtime may resolve a recipe. */\nexport function sandboxCreationEnvironment<TParams extends ParamsConfig>(\n  configuration: SandboxConfig<TParams>,\n  options: CreateSandboxOptions\n): Pick<SandboxEnvironment, \"source\" | \"setup\"> {\n  if (options.environment === undefined && configuration.resolve !== undefined) {\n    throw new SandboxError(\n      \"[Sixb] Dynamic sandbox configuration requires an execution-resolved environment.\"\n    )\n  }\n  const environment = captureEnvironment(\n    options.environment !== undefined\n      ? options.environment\n      : {\n          ...(configuration.source === undefined ? {} : { source: configuration.source }),\n          ...(configuration.setup === undefined ? {} : { setup: configuration.setup }),\n        }\n  )\n  if (environment.env !== undefined || environment.network !== undefined) {\n    throw new SandboxError(\n      \"[Sixb] Pass env and network as sandbox session options, not environment.\"\n    )\n  }\n  if (environment.source) {\n    if (\n      (configuration.auth !== undefined || environment.source.access === \"write\") &&\n      !options.requestCredentials?.length\n    ) {\n      throw new SandboxError(\n        \"[Sixb] Sandbox source authentication requires execution-prepared request credentials.\"\n      )\n    }\n    const network = options.network ?? configuration.network ?? { mode: \"none\" }\n    const origin = new URL(environment.source.url).origin\n    if (\n      network.mode === \"none\" ||\n      (network.mode === \"restricted\" && !network.allow.some((target) => target.origin === origin))\n    ) {\n      throw new SandboxError(\"[Sixb] Sandbox network policy denies the source origin.\")\n    }\n  }\n  options.signal?.throwIfAborted()\n  return environment\n}\n\n/** Select the same project directory on creation and resume without touching saved files. */\nexport function sandboxProjectDirectory(session: Sandbox, hasSource: boolean): Sandbox {\n  if (!hasSource) return session\n  const workingDirectory = posix.join(session.workingDirectory, \"repository\")\n  return {\n    id: session.id,\n    provider: session.provider,\n    get status() {\n      return session.status\n    },\n    workingDirectory,\n    ...(session.setRequestCredentials\n      ? { setRequestCredentials: session.setRequestCredentials.bind(session) }\n      : {}),\n    runCommand: (command, args, options) =>\n      session.runCommand(command, args, { ...options, cwd: options?.cwd ?? workingDirectory }),\n    writeFiles: (files) =>\n      session.writeFiles(\n        files.map((file) => ({\n          ...file,\n          path: posix.isAbsolute(file.path) ? file.path : posix.join(workingDirectory, file.path),\n        }))\n      ),\n    stop: () => session.stop(),\n    destroy: () => session.destroy(),\n  }\n}\n\n/** Provider-side initialization, after the session network/credentials have been applied.\n * Call only on fresh creation. The caller owns cleanup if any command fails.\n */\nexport async function initializeSandboxEnvironment(\n  session: Sandbox,\n  environment: Pick<SandboxEnvironment, \"source\" | \"setup\">,\n  signal?: AbortSignal\n): Promise<Sandbox> {\n  environment = captureEnvironment(environment)\n  const run = async (sandbox: Sandbox, command: string, args: readonly string[]) => {\n    signal?.throwIfAborted()\n    const result = await sandbox.runCommand(command, args, { timeout: 120_000, signal })\n    if (result.exitCode !== 0 || result.timedOut) {\n      throw new SandboxError(\"[Sixb] Sandbox environment initialization failed.\")\n    }\n  }\n  signal?.throwIfAborted()\n  const sandbox = sandboxProjectDirectory(session, environment.source !== undefined)\n  if (environment.source) {\n    await run(session, \"git\", [\"clone\", \"--\", environment.source.url, \"repository\"])\n    if (environment.source.revision) {\n      await run(sandbox, \"git\", [\"checkout\", environment.source.revision, \"--\"])\n    }\n  }\n  for (const command of environment.setup ?? []) await run(sandbox, \"bash\", [\"-lc\", command])\n  return sandbox\n}\n",
-    "import type { CommandResult } from \"./sandbox\"\n\nexport interface ExecOptions {\n  readonly argv: readonly string[]\n  readonly cwd: string\n  readonly env: Readonly<Record<string, string>>\n  readonly timeoutMs?: number\n  readonly signal?: AbortSignal\n}\n\nconst DEFAULT_KILL_EXIT_CODE = 137\n\n/**\n * Spawn a child process and gather its {@link CommandResult}. Wraps Bun.spawn with timeout and\n * AbortSignal handling, and never throws. Command-agnostic: the wrapper makes no assumptions about\n * what it spawns, so sandbox providers share it. On timeout/abort it SIGKILLs the spawned process;\n * any provider whose spawned process merely fronts a longer-lived resource (e.g. a VM) is\n * responsible for reaping that resource in its own stop()/destroy().\n */\nexport async function exec(options: ExecOptions): Promise<CommandResult> {\n  const start = Date.now()\n\n  const [head, ...rest] = options.argv\n  if (!head) {\n    return {\n      exitCode: 1,\n      stdout: \"\",\n      stderr: \"[Sandbox] empty argv\",\n      durationMs: 0,\n    }\n  }\n\n  let proc: ReturnType<typeof Bun.spawn>\n  try {\n    proc = Bun.spawn([head, ...rest], {\n      cwd: options.cwd,\n      env: options.env,\n      stdin: \"ignore\",\n      stdout: \"pipe\",\n      stderr: \"pipe\",\n    })\n  } catch (error) {\n    return {\n      exitCode: 127,\n      stdout: \"\",\n      stderr: error instanceof Error ? error.message : String(error),\n      durationMs: Date.now() - start,\n    }\n  }\n\n  let timedOut = false\n  let killed = false\n\n  const timer =\n    options.timeoutMs !== undefined && options.timeoutMs > 0\n      ? setTimeout(() => {\n          timedOut = true\n          killed = true\n          proc.kill(\"SIGKILL\")\n        }, options.timeoutMs)\n      : undefined\n\n  const onAbort = (): void => {\n    if (!killed) {\n      killed = true\n      proc.kill(\"SIGKILL\")\n    }\n  }\n  options.signal?.addEventListener(\"abort\", onAbort)\n  if (options.signal?.aborted) {\n    onAbort()\n  }\n\n  let stdout = \"\"\n  let stderr = \"\"\n  let exitCode = 0\n  try {\n    const [stdoutText, stderrText, code] = await Promise.all([\n      new Response(proc.stdout as ReadableStream<Uint8Array>).text(),\n      new Response(proc.stderr as ReadableStream<Uint8Array>).text(),\n      proc.exited,\n    ])\n    stdout = stdoutText\n    stderr = stderrText\n    exitCode = typeof code === \"number\" ? code : DEFAULT_KILL_EXIT_CODE\n  } finally {\n    if (timer !== undefined) clearTimeout(timer)\n    options.signal?.removeEventListener(\"abort\", onAbort)\n  }\n\n  if (killed && exitCode === 0) {\n    exitCode = DEFAULT_KILL_EXIT_CODE\n  }\n\n  return {\n    exitCode,\n    stdout,\n    stderr,\n    durationMs: Date.now() - start,\n    ...(timedOut ? { timedOut: true } : {}),\n  }\n}\n"
-  ],
-  "mappings": "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",
-  "debugId": "C3376C4D866A438264756E2164756E21",
-  "names": []
-}

package/dist/chunk-9k93ah50.js.map

@@ -1,11 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/objects/sdk/where.ts", "../src/objects/sdk/query-builder.ts"],
-  "sourcesContent": [
-    "/**\n * Where-clause builder for typed ObjectSet queries.\n *\n * Provides `createWhereBuilder` (predicate DSL) and `resolveWhere` (evaluator).\n * The builder emits object query IR predicates. Property predicates are created\n * on demand through a Proxy, so no runtime ontology access is required —\n * property names are constrained at compile time and validated server-side.\n */\nimport type { ObjectTypeWithPropertyTokens } from \"../../ontology/tokens\"\nimport type { ObjectWhereBuilder, ObjectWhereClause } from \"../../runtime/types\"\nimport type { ObjectQueryPredicate } from \"../query\"\n\nfunction createPropertyPredicate(propertyId: string) {\n  const comparison = (op: \"eq\" | \"neq\" | \"lt\" | \"lte\" | \"gt\" | \"gte\") => {\n    return (value: unknown) => ({\n      propertyId,\n      op,\n      value,\n    })\n  }\n\n  return {\n    eq: comparison(\"eq\"),\n    neq: comparison(\"neq\"),\n    lt: comparison(\"lt\"),\n    lte: comparison(\"lte\"),\n    gt: comparison(\"gt\"),\n    gte: comparison(\"gte\"),\n    in: (values: readonly unknown[]) => ({\n      propertyId,\n      op: \"in\",\n      values,\n    }),\n    exists: (value = true) => ({\n      propertyId,\n      op: \"exists\",\n      value,\n    }),\n    contains: (value: unknown) => ({\n      propertyId,\n      op: \"contains\",\n      value,\n    }),\n  }\n}\n\nexport function createWhereBuilder<\n  TObjectType extends ObjectTypeWithPropertyTokens,\n>(): ObjectWhereBuilder<TObjectType> {\n  const p = new Proxy(\n    {},\n    {\n      get: (_target, propertyId) =>\n        typeof propertyId === \"string\" ? createPropertyPredicate(propertyId) : undefined,\n    }\n  )\n\n  return {\n    p,\n    and: (...items: readonly ObjectQueryPredicate[]) => ({ op: \"and\", items }),\n    or: (...items: readonly ObjectQueryPredicate[]) => ({ op: \"or\", items }),\n    not: (item: ObjectQueryPredicate) => ({ op: \"not\", item }),\n  } as ObjectWhereBuilder<TObjectType>\n}\n\nexport function resolveWhere<TObjectType extends ObjectTypeWithPropertyTokens>(\n  whereFn?: (\n    builder: ObjectWhereBuilder<TObjectType>\n  ) => ObjectWhereClause<TObjectType> | readonly ObjectWhereClause<TObjectType>[]\n): ObjectQueryPredicate | undefined {\n  if (!whereFn) return undefined\n  const whereBuilder = createWhereBuilder<TObjectType>()\n  const whereInput = whereFn(whereBuilder)\n  if (!whereInput) return undefined\n  const predicates = (\n    Array.isArray(whereInput) ? whereInput : [whereInput]\n  ) as readonly ObjectQueryPredicate[]\n  if (predicates.length === 0) return undefined\n  return predicates.length === 1 ? predicates[0] : { op: \"and\", items: predicates }\n}\n",
-    "/**\n * Fluent ObjectSet query builder.\n *\n * This is the TypeScript authoring layer for object queries. It builds the\n * provider-neutral object query IR and delegates execution to an\n * `ObjectQueryExecutor` — the server runtime executor or the HTTP client\n * executor — so the same builder serves both sides.\n */\n\nimport type { RerankingModelRef } from \"../../models/reranking-model\"\nimport { OntologyValidationError } from \"../../ontology/errors\"\nimport type { LinkToken, ObjectTypeWithPropertyTokens, PropertyToken } from \"../../ontology/tokens\"\nimport { RuntimeError } from \"../../runtime/errors\"\nimport type {\n  ListResult,\n  ListResultWithoutTotal,\n  ObjectExpandBuilder,\n  ObjectExpandOptions,\n  ObjectQueryBuilder,\n  ObjectQueryFacetInput,\n  ObjectQueryFacetsResult,\n  ObjectQueryListOptions,\n  ObjectWhereBuilder,\n  ObjectWhereClause,\n  TwinObject,\n} from \"../../runtime/types\"\nimport { formatObjectQueryExplanation } from \"../query/explain-format\"\nimport type {\n  ObjectExpansion,\n  ObjectQuery,\n  ObjectQueryDirection,\n  ObjectQuerySortDirection,\n  ObjectQuerySortField,\n} from \"../query/ir\"\nimport { normalizeObjectQuery } from \"../query/normalize\"\nimport type { ObjectQueryExecutor } from \"./query-executor\"\nimport { resolveWhere } from \"./where\"\n\ntype QueryBuilderParams = {\n  query: ObjectQuery\n  executor: ObjectQueryExecutor\n}\n\nexport function createObjectQueryBuilder<TObjectType extends ObjectTypeWithPropertyTokens>(\n  params: QueryBuilderParams\n): ObjectQueryBuilder<TObjectType> {\n  return new ObjectQueryBuilderImpl<TObjectType>(\n    params\n  ) as unknown as ObjectQueryBuilder<TObjectType>\n}\n\n/**\n * Returns the same query running through the executor `decorate` wraps around the builder's own.\n *\n * Refinements copy their builder's executor, so every query derived from the result, and every\n * terminal it runs, goes through the decorated executor too.\n */\nexport function decorateObjectQueryExecutor<TObjectType extends ObjectTypeWithPropertyTokens>(\n  builder: ObjectQueryBuilder<TObjectType>,\n  decorate: (executor: ObjectQueryExecutor) => ObjectQueryExecutor\n): ObjectQueryBuilder<TObjectType> {\n  // Narrowed from `unknown`: narrowing the builder interface to the class relates both structures.\n  const source: unknown = builder\n  if (!(source instanceof ObjectQueryBuilderImpl)) {\n    throw new RuntimeError(\n      \"[Sixb] Only query builders created by createObjectQueryBuilder can change executor.\"\n    )\n  }\n  return new ObjectQueryBuilderImpl<TObjectType>({\n    ...source.params,\n    executor: decorate(source.params.executor),\n  }) as unknown as ObjectQueryBuilder<TObjectType>\n}\n\nclass ObjectQueryBuilderImpl<TObjectType extends ObjectTypeWithPropertyTokens> {\n  /** Not private because `decorateObjectQueryExecutor` reads it; the class is not exported. */\n  constructor(readonly params: QueryBuilderParams) {}\n\n  get ir(): ObjectQuery {\n    return normalizeObjectQuery(this.params.query)\n  }\n\n  where(\n    whereFn: (\n      builder: ObjectWhereBuilder<TObjectType>\n    ) => ObjectWhereClause<TObjectType> | readonly ObjectWhereClause<TObjectType>[]\n  ): ObjectQueryBuilder<TObjectType> {\n    const predicate = resolveWhere<TObjectType>(whereFn)\n    if (!predicate) return this as unknown as ObjectQueryBuilder<TObjectType>\n\n    return this.withQuery({\n      kind: \"filter\",\n      input: this.ir,\n      predicate,\n    })\n  }\n\n  search(\n    query: string,\n    options?: { fields?: readonly PropertyToken<TObjectType[\"id\"], string>[] }\n  ): ObjectQueryBuilder<TObjectType> {\n    return this.withQuery({\n      kind: \"text\",\n      input: this.ir,\n      query,\n      fields: options?.fields?.map(propertyTokenToId),\n    })\n  }\n\n  vector(profile: string, vector: string, options: { k: number }): ObjectQueryBuilder<TObjectType> {\n    if (typeof profile !== \"string\" || typeof vector !== \"string\") {\n      throw new Error(\"[Sixb] Vector search requires a named profile and search text\")\n    }\n    return this.withQuery({\n      kind: \"vector\",\n      input: this.ir,\n      profile,\n      vector,\n      k: options.k,\n    })\n  }\n\n  rerank(options: { model: RerankingModelRef }): ObjectQueryBuilder<TObjectType> {\n    if (options.model?.definition?.kind !== \"reranking\") {\n      throw new TypeError(\"[Sixb] rerank() requires an explicit reranking model.\")\n    }\n    return this.withQuery({\n      kind: \"rerank\",\n      input: this.ir,\n      model: { provider: options.model.providerId, modelId: options.model.modelId },\n    })\n  }\n\n  traverse(\n    link: LinkToken<TObjectType[\"id\"], string, string>,\n    options?: { direction?: \"outgoing\" }\n  ): ObjectQueryBuilder<ObjectTypeWithPropertyTokens>\n  traverse(\n    link: LinkToken<string, string, TObjectType[\"id\"] | readonly TObjectType[\"id\"][]>,\n    options: { direction: \"incoming\" }\n  ): ObjectQueryBuilder<ObjectTypeWithPropertyTokens>\n  traverse(\n    link: LinkToken,\n    options: { direction?: ObjectQueryDirection } = {}\n  ): ObjectQueryBuilder<ObjectTypeWithPropertyTokens> {\n    const direction = options.direction ?? \"outgoing\"\n    if (direction === \"outgoing\") {\n      requireSingleTargetObjectTypeId(link)\n    }\n\n    return new ObjectQueryBuilderImpl<ObjectTypeWithPropertyTokens>({\n      ...this.params,\n      query: {\n        kind: \"traverse\",\n        input: this.ir,\n        linkId: link.id,\n        direction,\n        // Several object types can declare a link with the same id. The token\n        // names exactly one source type, so incoming traversal pins it —\n        // matching the result type the fluent API advertises.\n        ...(direction === \"incoming\" ? { sourceObjectTypeId: link.objectTypeId } : {}),\n      },\n    }) as unknown as ObjectQueryBuilder<ObjectTypeWithPropertyTokens>\n  }\n\n  expand(\n    link: LinkToken<string, string, string | readonly string[]>,\n    optionsOrBuild?: ObjectExpandOptions<ObjectTypeWithPropertyTokens> | NestedExpandBuild,\n    build?: NestedExpandBuild\n  ): ObjectQueryBuilder<TObjectType> {\n    return this.withQuery({\n      kind: \"expand\",\n      input: this.ir,\n      expansions: [buildExpansion(link, optionsOrBuild, build)],\n    })\n  }\n\n  orderBy(\n    property: PropertyToken<TObjectType[\"id\"], string>,\n    direction?: ObjectQuerySortDirection\n  ): ObjectQueryBuilder<TObjectType> {\n    return this.withQuery(\n      appendSortField(this.ir, {\n        kind: \"property\",\n        propertyId: property.id,\n        direction,\n      })\n    )\n  }\n\n  orderByRelevance(direction?: ObjectQuerySortDirection): ObjectQueryBuilder<TObjectType> {\n    return this.withQuery(\n      appendSortField(this.ir, {\n        kind: \"relevance\",\n        direction,\n      })\n    )\n  }\n\n  limit(limit: number): ObjectQueryBuilder<TObjectType> {\n    return this.withQuery({\n      kind: \"limit\",\n      input: this.ir,\n      limit,\n    })\n  }\n\n  page(input: { pageSize: number; pageToken?: string }): ObjectQueryBuilder<TObjectType> {\n    return this.withQuery({\n      kind: \"page\",\n      input: this.ir,\n      pageSize: input.pageSize,\n      pageToken: input.pageToken,\n    })\n  }\n\n  validate() {\n    if (!this.params.executor.validate) {\n      throw new OntologyValidationError(\n        \"[Sixb] validate() requires ontology access and is not supported by this query executor. Execute the query to get server-side validation.\"\n      )\n    }\n    return this.params.executor.validate(this.ir)\n  }\n\n  explain() {\n    if (!this.params.executor.explain) {\n      throw new OntologyValidationError(\n        \"[Sixb] explain() requires ontology access and is not supported by this query executor.\"\n      )\n    }\n    return this.params.executor.explain(this.ir)\n  }\n\n  formatExplanation(): string {\n    return formatObjectQueryExplanation(this.explain())\n  }\n\n  async list(): Promise<ListResult<TwinObject<TObjectType>>>\n  async list(options: {\n    includeTotal: false\n    signal?: AbortSignal\n  }): Promise<ListResultWithoutTotal<TwinObject<TObjectType>>>\n  async list(options: {\n    includeTotal?: true\n    signal?: AbortSignal\n  }): Promise<ListResult<TwinObject<TObjectType>>>\n  async list(\n    options?: ObjectQueryListOptions\n  ): Promise<\n    ListResult<TwinObject<TObjectType>> | ListResultWithoutTotal<TwinObject<TObjectType>>\n  > {\n    const result = await this.params.executor.list(this.ir, {\n      includeTotal: options?.includeTotal,\n      signal: options?.signal,\n    })\n    const objects = result.objects.map((row) => row as unknown as TwinObject<TObjectType>)\n\n    if (options?.includeTotal === false) {\n      return {\n        objects,\n        hasMore: result.hasMore,\n        nextPageToken: result.nextPageToken,\n      }\n    }\n\n    return {\n      objects,\n      hasMore: result.hasMore,\n      nextPageToken: result.nextPageToken,\n      total: result.total ?? result.objects.length,\n    }\n  }\n\n  async count(): Promise<number> {\n    return this.params.executor.count(this.ir)\n  }\n\n  async exists(): Promise<boolean> {\n    return this.params.executor.exists(this.ir)\n  }\n\n  async facets(\n    input: readonly ObjectQueryFacetInput<TObjectType>[]\n  ): Promise<ObjectQueryFacetsResult> {\n    return this.params.executor.facets(\n      this.ir,\n      input.map((facet) => ({\n        propertyId: facet.property.id,\n        limit: facet.limit,\n      }))\n    )\n  }\n\n  async first(): Promise<TwinObject<TObjectType> | null> {\n    const result = await this.params.executor.list({ kind: \"limit\", input: this.ir, limit: 1 })\n    const row = result.objects[0]\n    return row ? (row as unknown as TwinObject<TObjectType>) : null\n  }\n\n  private withQuery(query: ObjectQuery): ObjectQueryBuilder<TObjectType> {\n    return new ObjectQueryBuilderImpl<TObjectType>({\n      ...this.params,\n      query,\n    }) as unknown as ObjectQueryBuilder<TObjectType>\n  }\n}\n\ntype AnyExpandBuilder = ObjectExpandBuilder<ObjectTypeWithPropertyTokens>\ntype NestedExpandBuild = (nested: AnyExpandBuilder) => AnyExpandBuilder\n\n/**\n * Runtime backing for the nested `.expand(..., (e) => …)` callback. Immutable,\n * mirroring the query builder: each `expand` returns a new instance so the\n * accumulated expansions are never shared between branches.\n */\nclass ObjectExpandBuilderImpl {\n  constructor(readonly expansions: readonly ObjectExpansion[] = []) {}\n\n  expand(\n    link: LinkToken<string, string, string | readonly string[]>,\n    optionsOrBuild?: ObjectExpandOptions<ObjectTypeWithPropertyTokens> | NestedExpandBuild,\n    build?: NestedExpandBuild\n  ): ObjectExpandBuilderImpl {\n    return new ObjectExpandBuilderImpl([\n      ...this.expansions,\n      buildExpansion(link, optionsOrBuild, build),\n    ])\n  }\n}\n\nfunction buildExpansion(\n  link: LinkToken<string, string, string | readonly string[]>,\n  optionsOrBuild: ObjectExpandOptions<ObjectTypeWithPropertyTokens> | NestedExpandBuild | undefined,\n  build: NestedExpandBuild | undefined\n): ObjectExpansion {\n  // `.expand(link, build)` and `.expand(link, options, build)` are both valid:\n  // a function in the second slot is the nested builder, otherwise it is options.\n  const options = typeof optionsOrBuild === \"function\" ? undefined : optionsOrBuild\n  const nestedBuild = typeof optionsOrBuild === \"function\" ? optionsOrBuild : build\n\n  let nested: readonly ObjectExpansion[] = []\n  if (nestedBuild) {\n    const result = nestedBuild(new ObjectExpandBuilderImpl() as unknown as AnyExpandBuilder)\n    nested = (result as unknown as ObjectExpandBuilderImpl).expansions\n  }\n\n  return {\n    linkId: link.id,\n    direction: \"outgoing\",\n    ...(options?.limit !== undefined ? { limit: options.limit } : {}),\n    ...(options?.orderBy ? { orderBy: options.orderBy.map(expansionSortToField) } : {}),\n    ...(nested.length > 0 ? { expand: nested } : {}),\n  }\n}\n\nfunction expansionSortToField(sort: {\n  property: PropertyToken\n  direction?: ObjectQuerySortDirection\n}): ObjectQuerySortField {\n  return { kind: \"property\", propertyId: sort.property.id, direction: sort.direction }\n}\n\nfunction appendSortField(\n  query: ObjectQuery,\n  field: Extract<ObjectQuery, { kind: \"sort\" }>[\"fields\"][number]\n): ObjectQuery {\n  if (query.kind === \"sort\") {\n    return {\n      ...query,\n      fields: [...query.fields, field],\n    }\n  }\n\n  return {\n    kind: \"sort\",\n    input: query,\n    fields: [field],\n  }\n}\n\nfunction propertyTokenToId(token: PropertyToken): string {\n  return token.id\n}\n\nfunction requireSingleTargetObjectTypeId(link: LinkToken): void {\n  const target = link.targetObjectTypeId\n  if (target === \"*\" || typeof target !== \"string\") {\n    throw new OntologyValidationError(\n      \"[Sixb] Object query traverse requires a single concrete outgoing target type\"\n    )\n  }\n}\n"
-  ],
-  "mappings": ";;;;;;;;;;;;;AAYA,SAAS,uBAAuB,CAAC,YAAoB;AAAA,EACnD,MAAM,aAAa,CAAC,OAAmD;AAAA,IACrE,OAAO,CAAC,WAAoB;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA;AAAA,EAGF,OAAO;AAAA,IACL,IAAI,WAAW,IAAI;AAAA,IACnB,KAAK,WAAW,KAAK;AAAA,IACrB,IAAI,WAAW,IAAI;AAAA,IACnB,KAAK,WAAW,KAAK;AAAA,IACrB,IAAI,WAAW,IAAI;AAAA,IACnB,KAAK,WAAW,KAAK;AAAA,IACrB,IAAI,CAAC,YAAgC;AAAA,MACnC;AAAA,MACA,IAAI;AAAA,MACJ;AAAA,IACF;AAAA,IACA,QAAQ,CAAC,QAAQ,UAAU;AAAA,MACzB;AAAA,MACA,IAAI;AAAA,MACJ;AAAA,IACF;AAAA,IACA,UAAU,CAAC,WAAoB;AAAA,MAC7B;AAAA,MACA,IAAI;AAAA,MACJ;AAAA,IACF;AAAA,EACF;AAAA;AAGK,SAAS,kBAEf,GAAoC;AAAA,EACnC,MAAM,IAAI,IAAI,MACZ,CAAC,GACD;AAAA,IACE,KAAK,CAAC,SAAS,eACb,OAAO,eAAe,WAAW,wBAAwB,UAAU,IAAI;AAAA,EAC3E,CACF;AAAA,EAEA,OAAO;AAAA,IACL;AAAA,IACA,KAAK,IAAI,WAA4C,EAAE,IAAI,OAAO,MAAM;AAAA,IACxE,IAAI,IAAI,WAA4C,EAAE,IAAI,MAAM,MAAM;AAAA,IACtE,KAAK,CAAC,UAAgC,EAAE,IAAI,OAAO,KAAK;AAAA,EAC1D;AAAA;AAGK,SAAS,YAA8D,CAC5E,SAGkC;AAAA,EAClC,IAAI,CAAC;AAAA,IAAS;AAAA,EACd,MAAM,eAAe,mBAAgC;AAAA,EACrD,MAAM,aAAa,QAAQ,YAAY;AAAA,EACvC,IAAI,CAAC;AAAA,IAAY;AAAA,EACjB,MAAM,aACJ,MAAM,QAAQ,UAAU,IAAI,aAAa,CAAC,UAAU;AAAA,EAEtD,IAAI,WAAW,WAAW;AAAA,IAAG;AAAA,EAC7B,OAAO,WAAW,WAAW,IAAI,WAAW,KAAK,EAAE,IAAI,OAAO,OAAO,WAAW;AAAA;;;ACnC3E,SAAS,yBAA0E,CACxF,QACiC;AAAA,EACjC,OAAO,IAAI,uBACT,MACF;AAAA;AASK,SAAS,2BAA6E,CAC3F,SACA,UACiC;AAAA,EAEjC,MAAM,SAAkB;AAAA,EACxB,IAAI,EAAE,kBAAkB,yBAAyB;AAAA,IAC/C,MAAM,IAAI,cACR,qFACF;AAAA,EACF;AAAA,EACA,OAAO,IAAI,uBAAoC;AAAA,OAC1C,OAAO;AAAA,IACV,UAAU,SAAS,OAAO,OAAO,QAAQ;AAAA,EAC3C,CAAC;AAAA;AAAA;AAGH,MAAM,uBAAyE;AAAA,EAExD;AAAA,EAArB,WAAW,CAAU,QAA4B;AAAA,IAA5B;AAAA;AAAA,MAEjB,EAAE,GAAgB;AAAA,IACpB,OAAO,sBAAqB,KAAK,OAAO,KAAK;AAAA;AAAA,EAG/C,KAAK,CACH,SAGiC;AAAA,IACjC,MAAM,YAAY,aAA0B,OAAO;AAAA,IACnD,IAAI,CAAC;AAAA,MAAW,OAAO;AAAA,IAEvB,OAAO,KAAK,UAAU;AAAA,MACpB,MAAM;AAAA,MACN,OAAO,KAAK;AAAA,MACZ;AAAA,IACF,CAAC;AAAA;AAAA,EAGH,MAAM,CACJ,OACA,SACiC;AAAA,IACjC,OAAO,KAAK,UAAU;AAAA,MACpB,MAAM;AAAA,MACN,OAAO,KAAK;AAAA,MACZ;AAAA,MACA,QAAQ,SAAS,QAAQ,IAAI,iBAAiB;AAAA,IAChD,CAAC;AAAA;AAAA,EAGH,MAAM,CAAC,SAAiB,QAAgB,SAAyD;AAAA,IAC/F,IAAI,OAAO,YAAY,YAAY,OAAO,WAAW,UAAU;AAAA,MAC7D,MAAM,IAAI,MAAM,+DAA+D;AAAA,IACjF;AAAA,IACA,OAAO,KAAK,UAAU;AAAA,MACpB,MAAM;AAAA,MACN,OAAO,KAAK;AAAA,MACZ;AAAA,MACA;AAAA,MACA,GAAG,QAAQ;AAAA,IACb,CAAC;AAAA;AAAA,EAGH,MAAM,CAAC,SAAwE;AAAA,IAC7E,IAAI,QAAQ,OAAO,YAAY,SAAS,aAAa;AAAA,MACnD,MAAM,IAAI,UAAU,uDAAuD;AAAA,IAC7E;AAAA,IACA,OAAO,KAAK,UAAU;AAAA,MACpB,MAAM;AAAA,MACN,OAAO,KAAK;AAAA,MACZ,OAAO,EAAE,UAAU,QAAQ,MAAM,YAAY,SAAS,QAAQ,MAAM,QAAQ;AAAA,IAC9E,CAAC;AAAA;AAAA,EAWH,QAAQ,CACN,MACA,UAAgD,CAAC,GACC;AAAA,IAClD,MAAM,YAAY,QAAQ,aAAa;AAAA,IACvC,IAAI,cAAc,YAAY;AAAA,MAC5B,gCAAgC,IAAI;AAAA,IACtC;AAAA,IAEA,OAAO,IAAI,uBAAqD;AAAA,SAC3D,KAAK;AAAA,MACR,OAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO,KAAK;AAAA,QACZ,QAAQ,KAAK;AAAA,QACb;AAAA,WAII,cAAc,aAAa,EAAE,oBAAoB,KAAK,aAAa,IAAI,CAAC;AAAA,MAC9E;AAAA,IACF,CAAC;AAAA;AAAA,EAGH,MAAM,CACJ,MACA,gBACA,OACiC;AAAA,IACjC,OAAO,KAAK,UAAU;AAAA,MACpB,MAAM;AAAA,MACN,OAAO,KAAK;AAAA,MACZ,YAAY,CAAC,eAAe,MAAM,gBAAgB,KAAK,CAAC;AAAA,IAC1D,CAAC;AAAA;AAAA,EAGH,OAAO,CACL,UACA,WACiC;AAAA,IACjC,OAAO,KAAK,UACV,gBAAgB,KAAK,IAAI;AAAA,MACvB,MAAM;AAAA,MACN,YAAY,SAAS;AAAA,MACrB;AAAA,IACF,CAAC,CACH;AAAA;AAAA,EAGF,gBAAgB,CAAC,WAAuE;AAAA,IACtF,OAAO,KAAK,UACV,gBAAgB,KAAK,IAAI;AAAA,MACvB,MAAM;AAAA,MACN;AAAA,IACF,CAAC,CACH;AAAA;AAAA,EAGF,KAAK,CAAC,OAAgD;AAAA,IACpD,OAAO,KAAK,UAAU;AAAA,MACpB,MAAM;AAAA,MACN,OAAO,KAAK;AAAA,MACZ;AAAA,IACF,CAAC;AAAA;AAAA,EAGH,IAAI,CAAC,OAAkF;AAAA,IACrF,OAAO,KAAK,UAAU;AAAA,MACpB,MAAM;AAAA,MACN,OAAO,KAAK;AAAA,MACZ,UAAU,MAAM;AAAA,MAChB,WAAW,MAAM;AAAA,IACnB,CAAC;AAAA;AAAA,EAGH,QAAQ,GAAG;AAAA,IACT,IAAI,CAAC,KAAK,OAAO,SAAS,UAAU;AAAA,MAClC,MAAM,IAAI,yBACR,0IACF;AAAA,IACF;AAAA,IACA,OAAO,KAAK,OAAO,SAAS,SAAS,KAAK,EAAE;AAAA;AAAA,EAG9C,OAAO,GAAG;AAAA,IACR,IAAI,CAAC,KAAK,OAAO,SAAS,SAAS;AAAA,MACjC,MAAM,IAAI,yBACR,wFACF;AAAA,IACF;AAAA,IACA,OAAO,KAAK,OAAO,SAAS,QAAQ,KAAK,EAAE;AAAA;AAAA,EAG7C,iBAAiB,GAAW;AAAA,IAC1B,OAAO,8BAA6B,KAAK,QAAQ,CAAC;AAAA;AAAA,OAY9C,KAAI,CACR,SAGA;AAAA,IACA,MAAM,SAAS,MAAM,KAAK,OAAO,SAAS,KAAK,KAAK,IAAI;AAAA,MACtD,cAAc,SAAS;AAAA,MACvB,QAAQ,SAAS;AAAA,IACnB,CAAC;AAAA,IACD,MAAM,UAAU,OAAO,QAAQ,IAAI,CAAC,QAAQ,GAAyC;AAAA,IAErF,IAAI,SAAS,iBAAiB,OAAO;AAAA,MACnC,OAAO;AAAA,QACL;AAAA,QACA,SAAS,OAAO;AAAA,QAChB,eAAe,OAAO;AAAA,MACxB;AAAA,IACF;AAAA,IAEA,OAAO;AAAA,MACL;AAAA,MACA,SAAS,OAAO;AAAA,MAChB,eAAe,OAAO;AAAA,MACtB,OAAO,OAAO,SAAS,OAAO,QAAQ;AAAA,IACxC;AAAA;AAAA,OAGI,MAAK,GAAoB;AAAA,IAC7B,OAAO,KAAK,OAAO,SAAS,MAAM,KAAK,EAAE;AAAA;AAAA,OAGrC,OAAM,GAAqB;AAAA,IAC/B,OAAO,KAAK,OAAO,SAAS,OAAO,KAAK,EAAE;AAAA;AAAA,OAGtC,OAAM,CACV,OACkC;AAAA,IAClC,OAAO,KAAK,OAAO,SAAS,OAC1B,KAAK,IACL,MAAM,IAAI,CAAC,WAAW;AAAA,MACpB,YAAY,MAAM,SAAS;AAAA,MAC3B,OAAO,MAAM;AAAA,IACf,EAAE,CACJ;AAAA;AAAA,OAGI,MAAK,GAA4C;AAAA,IACrD,MAAM,SAAS,MAAM,KAAK,OAAO,SAAS,KAAK,EAAE,MAAM,SAAS,OAAO,KAAK,IAAI,OAAO,EAAE,CAAC;AAAA,IAC1F,MAAM,MAAM,OAAO,QAAQ;AAAA,IAC3B,OAAO,MAAO,MAA6C;AAAA;AAAA,EAGrD,SAAS,CAAC,OAAqD;AAAA,IACrE,OAAO,IAAI,uBAAoC;AAAA,SAC1C,KAAK;AAAA,MACR;AAAA,IACF,CAAC;AAAA;AAEL;AAAA;AAUA,MAAM,wBAAwB;AAAA,EACP;AAAA,EAArB,WAAW,CAAU,aAAyC,CAAC,GAAG;AAAA,IAA7C;AAAA;AAAA,EAErB,MAAM,CACJ,MACA,gBACA,OACyB;AAAA,IACzB,OAAO,IAAI,wBAAwB;AAAA,MACjC,GAAG,KAAK;AAAA,MACR,eAAe,MAAM,gBAAgB,KAAK;AAAA,IAC5C,CAAC;AAAA;AAEL;AAEA,SAAS,cAAc,CACrB,MACA,gBACA,OACiB;AAAA,EAGjB,MAAM,UAAU,OAAO,mBAAmB,aAAa,YAAY;AAAA,EACnE,MAAM,cAAc,OAAO,mBAAmB,aAAa,iBAAiB;AAAA,EAE5E,IAAI,SAAqC,CAAC;AAAA,EAC1C,IAAI,aAAa;AAAA,IACf,MAAM,SAAS,YAAY,IAAI,uBAAwD;AAAA,IACvF,SAAU,OAA8C;AAAA,EAC1D;AAAA,EAEA,OAAO;AAAA,IACL,QAAQ,KAAK;AAAA,IACb,WAAW;AAAA,OACP,SAAS,UAAU,YAAY,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC;AAAA,OAC3D,SAAS,UAAU,EAAE,SAAS,QAAQ,QAAQ,IAAI,oBAAoB,EAAE,IAAI,CAAC;AAAA,OAC7E,OAAO,SAAS,IAAI,EAAE,QAAQ,OAAO,IAAI,CAAC;AAAA,EAChD;AAAA;AAGF,SAAS,oBAAoB,CAAC,MAGL;AAAA,EACvB,OAAO,EAAE,MAAM,YAAY,YAAY,KAAK,SAAS,IAAI,WAAW,KAAK,UAAU;AAAA;AAGrF,SAAS,eAAe,CACtB,OACA,OACa;AAAA,EACb,IAAI,MAAM,SAAS,QAAQ;AAAA,IACzB,OAAO;AAAA,SACF;AAAA,MACH,QAAQ,CAAC,GAAG,MAAM,QAAQ,KAAK;AAAA,IACjC;AAAA,EACF;AAAA,EAEA,OAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA,IACP,QAAQ,CAAC,KAAK;AAAA,EAChB;AAAA;AAGF,SAAS,iBAAiB,CAAC,OAA8B;AAAA,EACvD,OAAO,MAAM;AAAA;AAGf,SAAS,+BAA+B,CAAC,MAAuB;AAAA,EAC9D,MAAM,SAAS,KAAK;AAAA,EACpB,IAAI,WAAW,OAAO,OAAO,WAAW,UAAU;AAAA,IAChD,MAAM,IAAI,yBACR,8EACF;AAAA,EACF;AAAA;",
-  "debugId": "85B193053312F75F64756E2164756E21",
-  "names": []
-}

package/dist/chunk-b38szspf.js.map

@@ -1,11 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/storage/action-runs/types.ts", "../src/storage/action-runs/failure.ts"],
-  "sourcesContent": [
-    "import type { ActionSubject } from \"../../actions\"\nimport type { SixbErrorCode, SixbFailure } from \"../../errors/types\"\nimport type { JsonValue } from \"../../json\"\n\n/**\n * How a run ended. A run is recorded once, when it ends: while it executes, the request that runs\n * it is its only state.\n */\nexport type ActionRunStatus = \"succeeded\" | \"failed\"\n\n/** The phases of a run, in the order it reaches them. */\nexport const ACTION_RUN_PHASES = [\"validation\", \"writeback\", \"edits\", \"commit\", \"effects\"] as const\n\nexport type ActionRunPhase = (typeof ACTION_RUN_PHASES)[number]\n\nexport type ActionRunParams = Readonly<Record<string, JsonValue>>\n\n/** Error codes an action run or phase record can persist and expose. */\nexport const ACTION_RUN_FAILURE_CODES = [\n  \"internal.unexpected\",\n  \"runtime.cancelled\",\n  \"action.phase_failed\",\n  \"action.read_conflict\",\n  \"action.timeout\",\n] as const satisfies readonly [SixbErrorCode, ...SixbErrorCode[]]\n\nexport type ActionRunFailureCode = (typeof ACTION_RUN_FAILURE_CODES)[number]\n\nexport interface ActionRunFailureDetails<TPhase extends ActionRunPhase = ActionRunPhase> {\n  readonly actionId: string\n  readonly runId: string\n  readonly phase: TPhase\n}\n\n/** Portable failure record with Action's required correlation details. */\nexport interface ActionRunFailure<TPhase extends ActionRunPhase = ActionRunPhase>\n  extends Omit<SixbFailure<ActionRunFailureCode>, \"details\"> {\n  readonly details: ActionRunFailureDetails<TPhase>\n}\n\nexport type ActionRunWritebackRecord =\n  | {\n      readonly status: \"succeeded\"\n      readonly completedAt: Date\n      readonly result: JsonValue\n      readonly error?: never\n    }\n  | {\n      readonly status: \"failed\"\n      readonly completedAt: Date\n      readonly result?: never\n      readonly error: ActionRunFailure<\"writeback\">\n    }\n\nexport type ActionRunEffectsRecord =\n  | {\n      readonly status: \"succeeded\"\n      readonly completedAt: Date\n      readonly error?: never\n    }\n  | {\n      readonly status: \"failed\"\n      readonly completedAt: Date\n      readonly error: ActionRunFailure<\"effects\">\n    }\n\ninterface ActionRunRecordFields {\n  readonly id: string\n  readonly projectId: string\n  readonly executionId: string\n  readonly actionId: string\n  readonly subject: ActionSubject\n  /** The last phase the run reached. */\n  readonly phase: ActionRunPhase\n  readonly startedAt: Date\n  readonly finishedAt: Date\n  readonly params: ActionRunParams\n  readonly idempotencyKey: string\n  readonly writeback?: ActionRunWritebackRecord\n}\n\n/** A run's terminal record, as it is written once when the run ends. */\nexport type RecordActionRunInput =\n  | (ActionRunRecordFields & { readonly status: \"succeeded\"; readonly error?: never })\n  | (ActionRunRecordFields & { readonly status: \"failed\"; readonly error: ActionRunFailure })\n\n/**\n * A recorded run. Its effects run after its record is written, so their outcome is the one part\n * recorded later, on a succeeded run that committed edits.\n */\nexport type ActionRunRecord = RecordActionRunInput & {\n  readonly effects?: ActionRunEffectsRecord\n}\n\nexport type RecordActionEffectsInput =\n  | {\n      readonly id: string\n      readonly projectId: string\n      readonly status: \"succeeded\"\n      readonly completedAt?: Date\n    }\n  | {\n      readonly id: string\n      readonly projectId: string\n      readonly status: \"failed\"\n      readonly completedAt?: Date\n      readonly error: ActionRunFailure<\"effects\">\n    }\n\nexport interface ListActionRunsInput {\n  readonly projectId: string\n  readonly actionId?: string\n  readonly actionIds?: readonly string[]\n  readonly subject?: ActionSubject\n  readonly objectTypeId?: string\n  readonly objectTypeIds?: readonly string[]\n  readonly primaryId?: string\n  readonly statuses?: readonly ActionRunStatus[]\n  readonly startedAfter?: Date\n  readonly startedBefore?: Date\n  readonly limit?: number\n  readonly offset?: number\n  readonly order?: \"asc\" | \"desc\"\n}\n\nexport interface ListActionRunsResult {\n  readonly runs: readonly ActionRunRecord[]\n  readonly hasMore: boolean\n  readonly total: number\n}\n\nexport interface ActionRunStorage {\n  /**\n   * Insert a run's terminal record.\n   *\n   * A run is recorded once: a run id that already has a record is refused with an\n   * `ActionRunError`, and so is an execution that already recorded another run. The execution must\n   * be the trusted primitive execution created for this run.\n   */\n  record(input: RecordActionRunInput): Promise<ActionRunRecord>\n  /**\n   * Record the outcome of the effects of a succeeded run that committed edits, once. Recording an\n   * equal outcome again returns the run unchanged.\n   */\n  recordEffects(input: RecordActionEffectsInput): Promise<ActionRunRecord>\n  getById(params: { projectId: string; id: string }): Promise<ActionRunRecord | null>\n  /** Runs ordered by `startedAt`, then id. */\n  list(input: ListActionRunsInput): Promise<ListActionRunsResult>\n}\n",
-    "import { parseSixbFailure } from \"../../errors/internal\"\nimport { isPlainRecord } from \"../../json\"\nimport {\n  ACTION_RUN_FAILURE_CODES,\n  ACTION_RUN_PHASES,\n  type ActionRunFailure,\n  type ActionRunFailureDetails,\n  type ActionRunPhase,\n} from \"./types\"\n\n/** Serializes the canonical failure plus Action's typed lifecycle extension. */\nexport function serializeActionRunFailure<TPhase extends ActionRunPhase>(\n  failure: ActionRunFailure<TPhase>,\n  expectedPhase?: TPhase\n): string {\n  const parsed =\n    expectedPhase === undefined\n      ? parseActionRunFailure(failure)\n      : parseActionRunFailure(failure, expectedPhase)\n  return JSON.stringify(parsed)\n}\n\n/** Validates and detaches an Action failure read from a storage boundary. */\nexport function parseActionRunFailure<TPhase extends ActionRunPhase>(\n  value: unknown,\n  expectedPhase: TPhase\n): ActionRunFailure<TPhase>\nexport function parseActionRunFailure(value: unknown): ActionRunFailure\nexport function parseActionRunFailure(\n  value: unknown,\n  expectedPhase?: ActionRunPhase\n): ActionRunFailure {\n  const candidate = parseStoredActionRunFailureValue(value)\n  const failure = parseSixbFailure(candidate, ACTION_RUN_FAILURE_CODES)\n  const details = failure.details\n  if (\n    !isPlainRecord(details) ||\n    typeof details.actionId !== \"string\" ||\n    typeof details.runId !== \"string\" ||\n    typeof details.phase !== \"string\" ||\n    !(ACTION_RUN_PHASES as readonly string[]).includes(details.phase)\n  ) {\n    throw new Error(\n      \"[Sixb] Stored failure is invalid: Action details must contain actionId, runId, and a known phase.\"\n    )\n  }\n  if (expectedPhase !== undefined && details.phase !== expectedPhase) {\n    throw new Error(`[Sixb] Stored Action ${expectedPhase} failure has phase '${details.phase}'.`)\n  }\n\n  return {\n    ...failure,\n    details: details as unknown as ActionRunFailureDetails,\n  }\n}\n\nfunction parseStoredActionRunFailureValue(value: unknown): unknown {\n  if (typeof value !== \"string\") return value\n  try {\n    return JSON.parse(value) as unknown\n  } catch {\n    throw new Error(\"[Sixb] Stored failure is invalid: value is not valid JSON.\")\n  }\n}\n"
-  ],
-  "mappings": ";;;;;;;;;AAWO,IAAM,qBAAoB,CAAC,cAAc,aAAa,SAAS,UAAU,SAAS;AAOlF,IAAM,4BAA2B;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;;;ACbO,SAAS,0BAAwD,CACtE,SACA,eACQ;AAAA,EACR,MAAM,SACJ,kBAAkB,YACd,uBAAsB,OAAO,IAC7B,uBAAsB,SAAS,aAAa;AAAA,EAClD,OAAO,KAAK,UAAU,MAAM;AAAA;AASvB,SAAS,sBAAqB,CACnC,OACA,eACkB;AAAA,EAClB,MAAM,YAAY,iCAAiC,KAAK;AAAA,EACxD,MAAM,UAAU,kBAAiB,WAAW,yBAAwB;AAAA,EACpE,MAAM,UAAU,QAAQ;AAAA,EACxB,IACE,CAAC,cAAc,OAAO,KACtB,OAAO,QAAQ,aAAa,YAC5B,OAAO,QAAQ,UAAU,YACzB,OAAO,QAAQ,UAAU,YACzB,CAAE,mBAAwC,SAAS,QAAQ,KAAK,GAChE;AAAA,IACA,MAAM,IAAI,MACR,mGACF;AAAA,EACF;AAAA,EACA,IAAI,kBAAkB,aAAa,QAAQ,UAAU,eAAe;AAAA,IAClE,MAAM,IAAI,MAAM,wBAAwB,oCAAoC,QAAQ,SAAS;AAAA,EAC/F;AAAA,EAEA,OAAO;AAAA,OACF;AAAA,IACH;AAAA,EACF;AAAA;AAGF,SAAS,gCAAgC,CAAC,OAAyB;AAAA,EACjE,IAAI,OAAO,UAAU;AAAA,IAAU,OAAO;AAAA,EACtC,IAAI;AAAA,IACF,OAAO,KAAK,MAAM,KAAK;AAAA,IACvB,MAAM;AAAA,IACN,MAAM,IAAI,MAAM,4DAA4D;AAAA;AAAA;",
-  "debugId": "79EFE10C9637F4B164756E2164756E21",
-  "names": []
-}