@snappedly-tools/shipyard 0.2.0 → 0.3.0

package/README.md

@@ -23,7 +23,8 @@ branches, logs, sessions, and commits.
 
 ## Quick start
 
-You need Node.js, Git, Docker, and credentials for your chosen coding agent.
+You need Node.js 20.18.1 or newer, Git, Docker, and credentials for your chosen
+coding agent.
 Run these commands inside the Git repository the agent should change:
 
 ```sh

package/dist/{SandboxProvider-KeFp_nju.d.ts → SandboxProvider-XJQqEdSf.d.ts}

@@ -16,6 +16,8 @@ interface InteractiveExecOptions {
     readonly stdout: NodeJS.WritableStream;
     readonly stderr: NodeJS.WritableStream;
     readonly cwd?: string;
+    /** Terminate the interactive process when the caller cancels the session. */
+    readonly signal?: AbortSignal;
 }
 /** Handle to a running bind-mount sandbox. */
 interface BindMountSandboxHandle {
@@ -48,6 +50,7 @@ interface BindMountSandboxHandle {
      * Optional — providers that support interactive sessions implement this.
      * The provider detects TTY mode from the streams (e.g. stdin.isTTY) and
      * allocates a pseudo-terminal accordingly.
+     * Implementations MUST terminate the underlying process when `signal` aborts.
      */
     interactiveExec?(args: string[], options: InteractiveExecOptions): Promise<{
         exitCode: number;
@@ -120,6 +123,7 @@ interface IsolatedSandboxHandle {
      * Optional — providers that support interactive sessions implement this.
      * The provider detects TTY mode from the streams (e.g. stdin.isTTY) and
      * allocates a pseudo-terminal accordingly.
+     * Implementations MUST terminate the underlying process when `signal` aborts.
      */
     interactiveExec?(args: string[], options: InteractiveExecOptions): Promise<{
         exitCode: number;