Type Alias: SandboxOutcome

type SandboxOutcome =
  | {
      kind: "not-found";
      path: string;
    }
  | {
      axis: "read" | "write";
      kind: "denied-by-policy";
      path: string;
    }
  | {
      kind: "gate-declined";
      note?: string;
    }
  | {
      kind: "gate-unavailable";
      reason: "timeout" | "error";
    }
  | {
      bound: "maxTerminalPayloadBytes";
      kind: "over-budget";
      limit: number;
      observedAtLeast: number;
    }
  | {
      atDepth: number;
      bound: "maxDepth";
      kind: "scope-limited";
      shown: number;
    }
  | {
      kind: "not-a-regular-file";
      kind_: string;
      path: string;
    }
  | {
      kind: "is-a-directory";
      path: string;
    }
  | {
      input: string;
      kind: "path-rejected";
      reason: "escape" | "absolute-host" | "home" | "unc" | "device" | "nul";
    }
  | {
      kind: "outside-write-root";
      path: ModelPath;
      writeRoot: ModelWriteRoot;
    }
  | {
      exitCode: number;
      kind: "sandbox-violation";
      violations: readonly string[];
    }
  | {
      exitCode: number;
      kind: "nonzero-exit";
    }
  | {
      kind: "no-matches";
      pattern: string;
      scope: string;
    }
  | {
      kind: "unknown-media";
      mediaId: string;
    }
  | {
      detail: string;
      kind: "invalid-pattern";
      pattern: string;
    }
  | {
      kind: "not-a-directory";
      path: string;
    }
  | {
      detail: string;
      kind: "io-failure";
      path?: string;
    }
  | {
      kind: "aborted";
    }
  | {
      bound: "timeout_seconds";
      kind: "timed-out";
      limitSeconds: number;
    };

Defined in: src/batteries/sandbox/narrator.ts:4

Exhaustive model-facing sandbox outcome.

Union Members

Type Literal

{
  kind: "not-found";
  path: string;
}

---

Type Literal

{
  axis: "read" | "write";
  kind: "denied-by-policy";
  path: string;
}

---

Type Literal

{
  kind: "gate-declined";
  note?: string;
}

---

Type Literal

{
  kind: "gate-unavailable";
  reason: "timeout" | "error";
}

---

Type Literal

{
  bound: "maxTerminalPayloadBytes";
  kind: "over-budget";
  limit: number;
  observedAtLeast: number;
}

---

Type Literal

{
  atDepth: number;
  bound: "maxDepth";
  kind: "scope-limited";
  shown: number;
}

---

Type Literal

{
  kind: "not-a-regular-file";
  kind_: string;
  path: string;
}

---

Type Literal

{
  kind: "is-a-directory";
  path: string;
}

---

Type Literal

{
  input: string;
  kind: "path-rejected";
  reason: "escape" | "absolute-host" | "home" | "unc" | "device" | "nul";
}

---

Type Literal

{
  kind: "outside-write-root";
  path: ModelPath;
  writeRoot: ModelWriteRoot;
}

Model-facing root, conventionally /; NEVER the configured absolute host path.

---

Type Literal

{
  exitCode: number;
  kind: "sandbox-violation";
  violations: readonly string[];
}

---

Type Literal

{
  exitCode: number;
  kind: "nonzero-exit";
}

---

Type Literal

{
  kind: "no-matches";
  pattern: string;
  scope: string;
}

---

Type Literal

{
  kind: "unknown-media";
  mediaId: string;
}

---

Type Literal

{
  detail: string;
  kind: "invalid-pattern";
  pattern: string;
}

---

Type Literal

{
  kind: "not-a-directory";
  path: string;
}

---

Type Literal

{
  detail: string;
  kind: "io-failure";
  path?: string;
}

---

Type Literal

{
  kind: "aborted";
}

---

Type Literal

{
  bound: "timeout_seconds";
  kind: "timed-out";
  limitSeconds: number;
}