sandbox-guest

Import

Import

import * as api from "@fungi.computer/mycelium/sandbox-guest";

Exports

Kind	Export	Description
constconstant	sandboxGuestResultSchema	Closed guest envelope: guest exceptions cannot masquerade as host failures.
constconstant	sandboxNamespaceSegmentSchema	Parsed guest namespace segments; callbacks never cross this wire.
constconstant	sandboxTransportAliasSchema	A transport alias is interpolated as a strict JavaScript binding identifier.
constconstant	sandboxNamespacePathsSchema	Transport aliases mapped to their logical namespace paths.
constconstant	sandboxBindingNamesSchema	Serializable flat transport table; operation keys may have any namespace depth.
fnfunction	submittedSourceLocation()	Locate syntax in the submitted code, accounting for Codemode’s normalization.
fnfunction	sandboxBindingNames()	Serializable operation names; callbacks stay in the host’s existing binding table.
fnfunction	sandboxProviderOperationName()	Injective provider identifier: Codemode sanitizes dotted function names.
fnfunction	sandboxGuestProgram()	Capture name and text inside the guest, before Codemode erases Error.name.

sandboxGuestResultSchemaconstconstant

Signature

const sandboxGuestResultSchema: ZodLazy<
  ZodDiscriminatedUnion<
    [
      ZodObject<
        {
          ok: ZodLiteral<true>;
          value: ZodUnknown;
        },
        $strict
      >,
      ZodObject<
        {
          ok: ZodLiteral<false>;
          error: ZodObject<
            {
              kind: ZodLiteral<"guest_threw">;
              name: ZodString;
              message: ZodString;
              transportMessage: ZodOptional<ZodString>;
            },
            $strict
          >;
        },
        $strict
      >,
    ],
    "ok"
  >
>;

Closed guest envelope: guest exceptions cannot masquerade as host failures.

---

sandboxNamespaceSegmentSchemaconstconstant

Signature

const sandboxNamespaceSegmentSchema: ZodLazy<ZodString>;

Parsed guest namespace segments; callbacks never cross this wire.

---

sandboxTransportAliasSchemaconstconstant

Signature

const sandboxTransportAliasSchema: ZodLazy<ZodString>;

A transport alias is interpolated as a strict JavaScript binding identifier.

---

sandboxNamespacePathsSchemaconstconstant

Signature

const sandboxNamespacePathsSchema: ZodLazy<
  ZodRecord<ZodLazy<ZodString>, ZodArray<ZodLazy<ZodString>>>
>;

Transport aliases mapped to their logical namespace paths.

---

sandboxBindingNamesSchemaconstconstant

Signature

const sandboxBindingNamesSchema: ZodLazy<
  ZodRecord<ZodLazy<ZodString>, ZodArray<ZodString>>
>;

Serializable flat transport table; operation keys may have any namespace depth.

submittedSourceLocation()fnfunction

Signature

function submittedSourceLocation(
  normalized,
  submitted,
): Readonly<{
  line: number;
  column: number;
  excerpt: string;
}> | null;

Locate syntax in the submitted code, accounting for Codemode’s normalization.

Parameters

Parameter	Type
normalized	string
submitted	string

Returns

| Readonly<{ line: number; column: number; excerpt: string; }> | null

---

sandboxBindingNames()fnfunction

Signature

function sandboxBindingNames<A>(
  bindings,
): Readonly<Record<string, readonly string[]>>;

Serializable operation names; callbacks stay in the host’s existing binding table.

Type Parameters

Type Parameter
A

Parameters

Parameter	Type
bindings	Readonly<Record<string, Readonly<Record<string, A>>>>

Returns

Readonly<Record<string, readonly string[]>>

---

sandboxProviderOperationName()fnfunction

Signature

function sandboxProviderOperationName(operation): string;

Injective provider identifier: Codemode sanitizes dotted function names.

Parameters

Parameter	Type
operation	string

Returns

string

---

sandboxGuestProgram()fnfunction

Signature

function sandboxGuestProgram(
  normalized,
  bindings?,
  namespacePaths?,
  transportName?,
): string;

Capture name and text inside the guest, before Codemode erases Error.name.

Parameters

Parameter	Type
normalized	string
bindings	Readonly<Record<string, readonly string[]>>
namespacePaths	Readonly<Record<string, readonly string[]>>
transportName?	(operation) => string

Returns

string