@fungi.computer/computer 0.0.1 → 0.2.0

package/dist/index.d.ts

@@ -1,10 +1,11 @@
+export { createLocalBackendReplayStore } from "./local-backend-replay.js";
 import { Workspace, WorkspaceProxy, WorkspaceServiceProxy, type WorkspaceStubHost } from "@fungi.computer/cloudflare-computer";
 import { type WorkerShellBackendOptions } from "@fungi.computer/cloudflare-computer/backends/worker-shell";
 import { type IWorkspaceContainerAPI } from "@fungi.computer/cloudflare-computer/backends/container";
 import { DurableObject } from "cloudflare:workers";
 import type { FilesPort } from "@fungi.computer/knapsack";
 import { z } from "zod";
-import { type ComputerExecutionBudget, type ComputerExecRequest, type ComputerOperationResult, type ComputerFileReadInput, type ComputerFileByteReadInput, type ComputerFileReplacement, type ComputerFileReplacementResult, type ComputerValue, writeInputSchema, writeOutputSchema, type ComputerProcess } from "./operation-contract.js";
+import { type ComputerExecutionBudget, type ComputerExecutionHostHooks, type ComputerExecRequest, type ComputerOperationResult, type ComputerFileReadInput, type ComputerFileByteReadInput, type ComputerFileReplacement, type ComputerFileReplacementResult, type ComputerValue, writeInputSchema, writeOutputSchema, type ComputerProcess } from "@fungi.computer/computer-contract";
 import { createWorkspaceFilesPort } from "./files.js";
 import { OnBoxVmContainerHost, type OnBoxVmEnv, type OnBoxVmPlacement } from "./on-box-vm.js";
 import { type AttachedBackend, type AttachedBackendView, type BackendNeed, type BackendRoute, type ContainerRuntimeStart, type HostedBacking } from "./computer-backends.js";
@@ -89,7 +90,7 @@ declare class ContainerComputer extends ContainerComputerBase {
      * The hosted backend that terminals, processes and ports use: the first in
      * the default order, or none when only local machines are attached.
      */
-    protected hostedRoute(): Readonly<{
+    protected hostedRoute(backend?: string): Readonly<{
         id: string;
         backing: HostedBacking;
     }> | undefined;
@@ -114,9 +115,8 @@ declare class ContainerComputer extends ContainerComputerBase {
     protected workspace(): Workspace;
     /**
      * The current Workspace once its mount index is ready and its guest mount
-     * root exists. Every backend mounts `/workspace`, so a host write there
-     * (such as a Workflow step's one-shot Git credential file) must not depend
-     * on a guest having booted first.
+     * root exists. Every backend mounts `/workspace`, so an ordinary host file
+     * write there must not depend on a guest having booted first.
      */
     protected readyWorkspace(): Promise<Workspace>;
     /** `getWorkspace(stub)` reaches the current generation through this door. */
@@ -132,6 +132,16 @@ declare class ContainerComputer extends ContainerComputerBase {
 /** One upstream Cloudflare Workspace that advertises and runs its capabilities. */
 export declare class ComputerDO extends ContainerComputer {
     #private;
+    constructor(ctx: DurableObjectState, env: ComputerEnv);
+    /** Host-admitted settings write; egress reads the current durable value. */
+    internetAccess(enabled?: boolean): boolean;
+    /** Ordinary Computers have no credential host; resource hosts override it. */
+    protected executionHooks(): ComputerExecutionHostHooks | undefined;
+    /**
+     * Admission observes the actual native subscriber, never App completion,
+     * output silence, an accepted signal or this isolate's warm state.
+     */
+    executionIsLive(invocationId: string): Promise<boolean>;
     /** Persist the bounded set of ports admitted for preview on this Computer. */
     exposePort(input: {
         port: number;
@@ -201,17 +211,25 @@ export declare class ComputerDO extends ContainerComputer {
     protected applyPatchAfterAcceptance(input: {
         patch: string;
     }, accept: () => void): Promise<{
-        status: "completed" | "failed" | "cancelled";
+        status: "failed" | "completed" | "cancelled";
         exitCode: number;
         stdout: string;
         stderr: string;
-        truncated: boolean;
+        truncated: false | {
+            stream: "stdout" | "stderr";
+            keptBytes: number;
+            totalBytes: number;
+        }[];
     } | {
-        status: "completed" | "failed" | "cancelled";
+        status: "failed" | "completed" | "cancelled";
         exitCode: number;
         stdout: string;
         stderr: string;
-        truncated: boolean;
+        truncated: false | {
+            stream: "stdout" | "stderr";
+            keptBytes: number;
+            totalBytes: number;
+        }[];
         error: {
             kind: "mismatch";
         };
@@ -220,14 +238,15 @@ export declare class ComputerDO extends ContainerComputer {
     protected writeTextAfterAcceptance(input: z.output<typeof writeInputSchema>, accept: () => void): Promise<z.output<typeof writeOutputSchema>>;
     call(capabilityId: ComputerValue, input: ComputerValue): Promise<ComputerValue>;
     /** Resource hosts may accept authority once the Workspace is ready to dispatch. */
-    protected callAfterAcceptance(capabilityId: ComputerValue, input: ComputerValue, accept: () => void): Promise<ComputerValue>;
+    protected callAfterAcceptance(capabilityId: ComputerValue, input: ComputerValue, accept: () => void, executionContext?: ComputerValue): Promise<ComputerValue>;
     /**
      * Execute a host request once, after the host accepts current authority.
      * `exec` runs on the Workspace's built-in Worker shell unless it names an
      * attached backend; `bash` always runs on an attached backend, the named one
-     * or the first available in the default order.
+     * or the first available in the default order. Host-only `hosted` execution
+     * excludes local backends, including an explicitly named local backend.
      */
-    protected executeOperationAfterAcceptance(input: ComputerExecRequest, accept: () => void, kind: "exec" | "bash", budget?: ComputerExecutionBudget, signal?: AbortSignal): Promise<ComputerOperationResult>;
+    protected executeOperationAfterAcceptance(input: ComputerExecRequest, accept: () => void, kind: "exec" | "bash" | "hosted", budget?: ComputerExecutionBudget, signal?: AbortSignal, executionContext?: ComputerValue): Promise<ComputerOperationResult>;
     /**
      * Run one command on a routed backend. Owners admit and meter hosted
      * backends here; a member's own machine is neither reserved nor metered.
@@ -238,7 +257,7 @@ export declare class ComputerDO extends ContainerComputer {
     /** Start one long-running container process with a durable identity. */
     startProcess(input: ComputerValue): Promise<ComputerProcess>;
     /** The host accepts authority when the running slot is reserved. */
-    protected startProcessAfterAcceptance(input: ComputerValue, accept: () => void): Promise<ComputerProcess>;
+    protected startProcessAfterAcceptance(input: ComputerValue, accept: () => void, executionContext?: ComputerValue): Promise<ComputerProcess>;
     /** List this Computer's processes, reconciling live ones with computerd. */
     listProcesses(): Promise<{
         processes: ComputerProcess[];
@@ -270,13 +289,12 @@ export declare class ComputerDO extends ContainerComputer {
     protected replaceFileIfUnchangedAfterAcceptance(input: ComputerFileReplacement, accept: () => void): Promise<ComputerFileReplacementResult>;
 }
 export { WorkspaceProxy, WorkspaceServiceProxy };
-export { OnBoxVmContainerHost, onBoxVmPlacement, onBoxVmIngress, type OnBoxVmEnv, type OnBoxVmState, } from "./on-box-vm.js";
+export { OnBoxVmContainerHost, OnBoxVmTimeoutError, onBoxVmPlacement, onBoxVmIngress, type OnBoxVmEnv, type OnBoxVmOperation, type OnBoxVmState, } from "./on-box-vm.js";
 export { computerContainerSleepAfterMs } from "./container-policy.js";
 export * from "./computer-backends.js";
 export { LocalBackendOfflineError, localBackendAudience, localBackendDialPath, verifyLocalBackendDial, } from "./local-backend.js";
 /** Keep each native Workspace lease inside the operation that uses it. */
 export declare function createComputerFilesPort(computer: ComputerRpc): FilesPort;
 export { createWorkspaceFilesPort, type WorkspaceFilesOwner } from "./files.js";
-export * from "./operation-contract.js";
 export { ComputerOperationConflictError, ComputerOperationLimitError, ComputerRequestInvalidError, } from "./operation-record.js";
 export type { ContainerComputer };