@ai-sdk/harness 1.0.53 → 1.0.55

package/src/errors/harness-sandbox-authentication-error.ts

@@ -0,0 +1,38 @@
+import { AISDKError } from '@ai-sdk/provider';
+import { HarnessError } from './harness-error';
+
+const name = 'AI_HarnessSandboxAuthenticationError';
+const marker = `vercel.ai.error.${name}`;
+const symbol = Symbol.for(marker);
+
+/**
+ * Thrown when a sandbox provider cannot authenticate or authorize the
+ * operation needed to create or resume a harness sandbox. Providers should
+ * preserve the underlying SDK failure as `cause` and supply a message that
+ * explains how the consumer can configure credentials.
+ */
+export class HarnessSandboxAuthenticationError extends HarnessError {
+  private readonly [symbol] = true;
+
+  readonly sandboxProviderId: string;
+
+  constructor({
+    message,
+    sandboxProviderId,
+    cause,
+  }: {
+    message: string;
+    sandboxProviderId: string;
+    cause?: unknown;
+  }) {
+    super({ message, cause });
+    Object.defineProperty(this, 'name', { value: name });
+    this.sandboxProviderId = sandboxProviderId;
+  }
+
+  static isInstance(
+    error: unknown,
+  ): error is HarnessSandboxAuthenticationError {
+    return AISDKError.hasMarker(error, marker);
+  }
+}

package/src/index.ts

@@ -1,3 +1,4 @@
 export * from './v1';
 export * from './errors/harness-error';
 export * from './errors/harness-capability-unsupported-error';
+export * from './errors/harness-sandbox-authentication-error';

package/src/utils/sandbox-channel.ts

@@ -259,8 +259,8 @@ export class SandboxChannel<
   /**
    * Mark that the host is tearing the session down. The next socket close is
    * then treated as terminal rather than triggering a reconnect. Call before
-   * sending a `shutdown` / `detach` message whose ack the bridge follows with a
-   * socket close.
+   * sending a `stop` / `destroy` message whose completion closes the bridge
+   * socket.
    */
   beginClose(): void {
     this.closing = true;

package/src/v1/harness-v1-bootstrap.ts

@@ -16,12 +16,6 @@ export interface HarnessV1BootstrapFile {
  */
 export interface HarnessV1BootstrapCommand {
   readonly command: string;
-  /**
-   * Absolute working directories are used as-is. Relative working directories
-   * are resolved against the sandbox's default working directory. When
-   * omitted, the command runs from the recipe's bootstrap directory.
-   */
-  readonly workingDirectory?: string;
 }
 
 /**

package/src/v1/harness-v1-bridge-protocol.ts

@@ -39,7 +39,7 @@ import {
  *     member schemas from `harness-v1-stream-part.ts`), because the part type is
  *     compile-time only and the frames need runtime validation at the boundary.
  *  2. The transport/control frames that are NOT consumer events — `bridge-hello`
- *     (handshake), `bridge-detach` (resume payload), `bridge-thread` (a resume
+ *     (handshake), `bridge-stop` (runtime resume data), `bridge-thread` (a resume
  *     coordinate some runtimes announce). These ride the same socket.
  *  3. The INBOUND command vocabulary the host sends back: the shared commands
  *     live here; the per-adapter `start` payload extends
@@ -123,17 +123,17 @@ export const harnessV1BridgeHelloSchema = z.object({
 });
 
 /**
- * The bridge's reply to an inbound `detach`. Carries the adapter-specific
+ * The bridge's reply to an inbound `stop`. Carries the adapter-specific
  * payload the host serializes into lifecycle state `data`.
  */
-export const harnessV1BridgeDetachSchema = z.object({
-  type: z.literal('bridge-detach'),
+export const harnessV1BridgeStopSchema = z.object({
+  type: z.literal('bridge-stop'),
   data: z.unknown(),
 });
 
 /**
  * A resume coordinate the bridge proactively announces (e.g. Codex's thread id)
- * so the host can cache it for a later resume without waiting for `detach`.
+ * so the host can cache it for a later resume without waiting for `stop`.
  */
 export const harnessV1BridgeThreadSchema = z.object({
   type: z.literal('bridge-thread'),
@@ -198,7 +198,7 @@ export const harnessV1BridgeOutboundMessageSchema = z.discriminatedUnion(
     harnessV1ErrorPartSchema,
     harnessV1RawPartSchema,
     harnessV1BridgeHelloSchema,
-    harnessV1BridgeDetachSchema,
+    harnessV1BridgeStopSchema,
     harnessV1BridgeThreadSchema,
     harnessV1BridgeSandboxLogSchema,
     harnessV1BridgeDebugEventSchema,
@@ -277,8 +277,8 @@ export const harnessV1BridgeAbortInboundSchema = z.object({
   type: z.literal('abort'),
 });
 
-export const harnessV1BridgeShutdownInboundSchema = z.object({
-  type: z.literal('shutdown'),
+export const harnessV1BridgeDestroyInboundSchema = z.object({
+  type: z.literal('destroy'),
 });
 
 /**
@@ -291,11 +291,11 @@ export const harnessV1BridgeResumeInboundSchema = z.object({
 });
 
 /**
- * The bridge replies with `bridge-detach` carrying any cached resume payload,
+ * The bridge replies with `bridge-stop` carrying any runtime resume data,
  * then exits.
  */
-export const harnessV1BridgeDetachInboundSchema = z.object({
-  type: z.literal('detach'),
+export const harnessV1BridgeStopInboundSchema = z.object({
+  type: z.literal('stop'),
 });
 
 /**
@@ -308,9 +308,9 @@ export const harnessV1BridgeInboundCommandSchemas = [
   harnessV1BridgeToolApprovalResponseInboundSchema,
   harnessV1BridgeUserMessageInboundSchema,
   harnessV1BridgeAbortInboundSchema,
-  harnessV1BridgeShutdownInboundSchema,
+  harnessV1BridgeDestroyInboundSchema,
   harnessV1BridgeResumeInboundSchema,
-  harnessV1BridgeDetachInboundSchema,
+  harnessV1BridgeStopInboundSchema,
 ] as const;
 
 /**

package/src/v1/harness-v1-sandbox-provider.ts

@@ -23,6 +23,12 @@ export interface HarnessV1SandboxProvider {
    */
   readonly bridgePorts?: ReadonlyArray<number>;
 
+  /**
+   * Providers should throw `HarnessSandboxAuthenticationError` when sandbox
+   * acquisition fails because credentials are missing, invalid, or not
+   * authorized. This lets framework integrations distinguish configuration
+   * failures from general sandbox infrastructure errors.
+   */
   readonly createSession: (options?: {
     /**
      * Stable per-session identifier. When supplied, the provider names the

package/src/v1/index.ts

@@ -61,15 +61,15 @@ export {
   harnessV1BridgeAbortInboundSchema,
   harnessV1BridgeBuiltinToolFilteringSchema,
   harnessV1BridgeDebugEventSchema,
-  harnessV1BridgeDetachInboundSchema,
-  harnessV1BridgeDetachSchema,
+  harnessV1BridgeDestroyInboundSchema,
   harnessV1BridgeHelloSchema,
   harnessV1BridgeInboundCommandSchemas,
   harnessV1BridgeOutboundMessageSchema,
   harnessV1BridgeReadySchema,
   harnessV1BridgeResumeInboundSchema,
   harnessV1BridgeSandboxLogSchema,
-  harnessV1BridgeShutdownInboundSchema,
+  harnessV1BridgeStopInboundSchema,
+  harnessV1BridgeStopSchema,
   harnessV1BridgeStartBaseSchema,
   harnessV1BridgeThreadSchema,
   harnessV1BridgeToolApprovalResponseInboundSchema,