@theokit/sdk 4.20.0 → 4.21.0

package/dist/sandbox/linux-sandbox.d.cts

@@ -86,3 +86,30 @@ export interface CreateSandboxBackendOptions {
  * MISSING_BWRAP_WARNING. The durable posture lives in `resolveSandboxPosture` for the UI.
  */
 export declare function createSandboxBackend(opts: CreateSandboxBackendOptions): SandboxBackend;
+/** Reset para testes — o latch é estado de módulo e testes precisam de isolamento. */
+export declare function resetInteractiveWarnLatch(): void;
+export interface InteractiveWrapOptions {
+    mode: SandboxMode;
+    /** `true` mantém a rede. Default `false`, igual ao `run_shell` não-interativo. */
+    network?: boolean;
+    /** Injetável para testes; default é a detecção real memoizada. */
+    detect?: () => BwrapDetection;
+    /** Injetável para testes; default é `console.warn` com redação. */
+    warn?: (message: string) => void;
+}
+/**
+ * A composição que o caminho interativo precisa — o par de `createSandboxBackend`.
+ *
+ * `createSandboxBackend` resolve isto para o caminho não-interativo devolvendo um BACKEND pronto. O
+ * PTY não aceita um backend: ele é dono do spawn e só admite transformar o comando. Esta função
+ * entrega a MESMA decisão na forma que o PTY aceita — `(command, cwd) => string | null` —, pronta
+ * para `new PtyInteractiveBackend({ wrapCommand: interactiveWrapCommand({ mode }) })`.
+ *
+ * A detecção é consultada **a cada wrap**, não congelada na construção: uma sessão interativa vive
+ * por horas, e uma detecção positiva obsoleta continuaria afirmando confinamento depois de o binário
+ * sumir (a revalidação por `existsSync` vive dentro de `detectBwrapMemoizado`).
+ *
+ * As duas rotas que devolvem `null` são semanticamente diferentes e o código não as funde:
+ * `danger-full-access` é opt-out explícito e NÃO avisa; bwrap indisponível é falha e avisa uma vez.
+ */
+export declare function interactiveWrapCommand(opts: InteractiveWrapOptions): (command: string, cwd: string) => string | null;

package/dist/sandbox/linux-sandbox.d.ts

@@ -86,3 +86,30 @@ export interface CreateSandboxBackendOptions {
  * MISSING_BWRAP_WARNING. The durable posture lives in `resolveSandboxPosture` for the UI.
  */
 export declare function createSandboxBackend(opts: CreateSandboxBackendOptions): SandboxBackend;
+/** Reset para testes — o latch é estado de módulo e testes precisam de isolamento. */
+export declare function resetInteractiveWarnLatch(): void;
+export interface InteractiveWrapOptions {
+    mode: SandboxMode;
+    /** `true` mantém a rede. Default `false`, igual ao `run_shell` não-interativo. */
+    network?: boolean;
+    /** Injetável para testes; default é a detecção real memoizada. */
+    detect?: () => BwrapDetection;
+    /** Injetável para testes; default é `console.warn` com redação. */
+    warn?: (message: string) => void;
+}
+/**
+ * A composição que o caminho interativo precisa — o par de `createSandboxBackend`.
+ *
+ * `createSandboxBackend` resolve isto para o caminho não-interativo devolvendo um BACKEND pronto. O
+ * PTY não aceita um backend: ele é dono do spawn e só admite transformar o comando. Esta função
+ * entrega a MESMA decisão na forma que o PTY aceita — `(command, cwd) => string | null` —, pronta
+ * para `new PtyInteractiveBackend({ wrapCommand: interactiveWrapCommand({ mode }) })`.
+ *
+ * A detecção é consultada **a cada wrap**, não congelada na construção: uma sessão interativa vive
+ * por horas, e uma detecção positiva obsoleta continuaria afirmando confinamento depois de o binário
+ * sumir (a revalidação por `existsSync` vive dentro de `detectBwrapMemoizado`).
+ *
+ * As duas rotas que devolvem `null` são semanticamente diferentes e o código não as funde:
+ * `danger-full-access` é opt-out explícito e NÃO avisa; bwrap indisponível é falha e avisa uma vez.
+ */
+export declare function interactiveWrapCommand(opts: InteractiveWrapOptions): (command: string, cwd: string) => string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theokit/sdk",
-  "version": "4.20.0",
+  "version": "4.21.0",
   "description": "TypeScript SDK for the Theo agent harness \u2014 same surface, local or cloud.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/usetheodev/theokit-sdk#readme",