@sixb/core 0.1.10 → 0.1.12

package/dist/sandboxes/sandbox.d.ts

@@ -5,6 +5,8 @@
  * implement this interface while consumers only depend on Sandbox and
  * SandboxFactory.
  */
+import type { ParamsConfig } from "../shared/params/types";
+import type { SandboxConfig, SandboxEnvironment } from "./configuration";
 export type SandboxStatus = "running" | "stopped" | "failed";
 /**
  * Per-command overrides. Each field overrides the matching sandbox-level
@@ -66,8 +68,21 @@ export interface SandboxNetworkTarget {
     readonly name: string;
     readonly origin: string;
 }
+/** Host-only credentials injected outside the guest into one exact HTTPS request target.
+ * This selects authenticated requests, not the sandbox's general egress allowlist.
+ */
+export interface SandboxRequestCredential {
+    readonly origin: string;
+    readonly path: string;
+    readonly method: "GET" | "POST";
+    readonly headers: {
+        readonly Authorization: string;
+    };
+}
 /** Current execution defaults, supplied on both creation and resume, never recovered from files. */
 export interface SandboxSessionOptions {
+    /** Apply outside the guest before source/setup or resumed commands. Reject if unsupported. */
+    readonly requestCredentials?: readonly SandboxRequestCredential[];
     readonly workingDirectory?: string;
     readonly env?: Readonly<Record<string, string>>;
     readonly timeout?: number;
@@ -75,6 +90,10 @@ export interface SandboxSessionOptions {
 }
 /** Options accepted by every SandboxFactory.create. */
 export interface CreateSandboxOptions extends SandboxSessionOptions {
+    /** Cancel initialization; a provider request already in flight may still finish. */
+    readonly signal?: AbortSignal;
+    /** Replaces static source/setup, including {} to skip both. Required for dynamic recipes. */
+    readonly environment?: Pick<SandboxEnvironment, "source" | "setup">;
     /** Create new named state; reject an existing name or unsupported persistence before provisioning. */
     readonly persistence?: {
         readonly name: string;
@@ -90,6 +109,11 @@ export interface Sandbox {
     readonly provider: string;
     readonly status: SandboxStatus;
     readonly workingDirectory: string;
+    /** Optional secure injection capability. Replaces all credentials on this session only.
+     * An empty list removes injection. Secrets must never enter guest files, env or snapshots.
+     * Must not resume a stopped session or change defaults inherited by future sessions.
+     */
+    readonly setRequestCredentials?: (credentials: readonly SandboxRequestCredential[]) => Promise<void>;
     runCommand(command: string, args?: readonly string[], options?: RunCommandOptions): Promise<CommandResult>;
     /**
      * Materialize files into the sandbox so a subsequent {@link runCommand} can read them. Each
@@ -120,18 +144,26 @@ export interface Sandbox {
  * Callers own namespacing and must serialize the entire create/resume/use/stop/destroy lifecycle.
  * Credentials and current authority must be supplied again, never inferred from saved files.
  */
-export interface SandboxFactory {
+export interface SandboxFactory<in out TParams extends ParamsConfig = ParamsConfig> {
+    /** Supports initial and renewable host-only credentials on named persistent sessions. */
+    readonly supportsRequestCredentials?: boolean;
+    /** Common host-side environment recipe. Never a discovered Agent definition. */
+    readonly configuration?: SandboxConfig<TParams>;
     /** Create an ephemeral sandbox unless persistence is requested. Existing names must fail,
-     * never attach or overwrite. Unsupported providers must reject persistence before provisioning.
+     * never attach or overwrite. Apply the selected source/setup once, after session settings.
+     * Dynamic resolution and source authorization belong to the caller, never the provider.
+     * Unsupported providers must reject persistence before provisioning.
      * A persistent handle targets one session; operations must not automatically resume another VM.
      */
     create(options?: CreateSandboxOptions): Promise<Sandbox>;
     /**
      * Present only when named persistent creation and resume are supported.
      * Resume an existing, stopped sandbox. Missing/expired state throws SandboxStateUnavailableError;
-     * it must never create an empty replacement. An already running sandbox must be rejected.
+     * it must never create an empty replacement. Transport/auth/setup errors must not be classified
+     * as missing state. An already running sandbox must be rejected.
      * Returns a handle bound to the resumed session, with no automatic resume on use.
      * Runtime options must be provided again; no creation settings or persistence option are accepted.
+     * Never clone or replay setup on resume.
      */
     resume?(name: string, options?: ResumeSandboxOptions): Promise<Sandbox>;
 }

package/dist/sandboxes/sandbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../src/sandboxes/sandbox.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../src/sandboxes/sandbox.ts"],"names":[],"mappings":"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"}

package/dist/shared/params/builders.d.ts

@@ -0,0 +1,25 @@
+import type { SchemaOrRef } from "../../ontology";
+import type { QuantitativeTypeId } from "../../ontology/units";
+import type { ParamConfig } from "./types";
+export interface ParamOptions {
+    readonly description?: string;
+    readonly semanticType?: QuantitativeTypeId;
+    readonly nullable?: boolean;
+}
+type FieldFromOptions<TOptions, TKey extends string, TFallback> = TOptions extends Record<TKey, infer TValue> ? {
+    [K in TKey]: TValue;
+} : {
+    [K in TKey]?: TFallback;
+};
+type ParamResult<TSchema extends SchemaOrRef, TRequired extends boolean, TOptions extends ParamOptions | undefined> = {
+    schema: TSchema;
+    required: TRequired;
+} & FieldFromOptions<TOptions, "description", string> & FieldFromOptions<TOptions, "semanticType", QuantitativeTypeId> & FieldFromOptions<TOptions, "nullable", boolean>;
+/** Declare one required parameter. */
+export declare function param<const TSchema extends SchemaOrRef, const TOptions extends ParamOptions | undefined = undefined>(schema: TSchema, options?: TOptions): ParamResult<TSchema, true, TOptions>;
+/** Derive an optional parameter without changing its schema or metadata. */
+export declare function optional<const TParam extends ParamConfig>(paramConfig: TParam): Omit<TParam, "required"> & {
+    readonly required: false;
+};
+export {};
+//# sourceMappingURL=builders.d.ts.map

package/dist/shared/params/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/shared/params/builders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE1C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,kBAAkB,CAAA;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,KAAK,gBAAgB,CAAC,QAAQ,EAAE,IAAI,SAAS,MAAM,EAAE,SAAS,IAC5D,QAAQ,SAAS,MAAM,CAAC,IAAI,EAAE,MAAM,MAAM,CAAC,GACvC;KAAG,CAAC,IAAI,IAAI,GAAG,MAAM;CAAE,GACvB;KAAG,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,SAAS;CAAE,CAAA;AAEjC,KAAK,WAAW,CACd,OAAO,SAAS,WAAW,EAC3B,SAAS,SAAS,OAAO,EACzB,QAAQ,SAAS,YAAY,GAAG,SAAS,IACvC;IACF,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,SAAS,CAAA;CACpB,GAAG,gBAAgB,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,CAAC,GACnD,gBAAgB,CAAC,QAAQ,EAAE,cAAc,EAAE,kBAAkB,CAAC,GAC9D,gBAAgB,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAA;AAEjD,sCAAsC;AACtC,wBAAgB,KAAK,CACnB,KAAK,CAAC,OAAO,SAAS,WAAW,EACjC,KAAK,CAAC,QAAQ,SAAS,YAAY,GAAG,SAAS,GAAG,SAAS,EAC3D,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAS3E;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,KAAK,CAAC,MAAM,SAAS,WAAW,EACvD,WAAW,EAAE,MAAM,GAClB,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAA;CAAE,CAKzD"}

package/dist/shared/params/types.d.ts

@@ -0,0 +1,47 @@
+import type { DecimalValue, InferSchemaOrRef, ObjectRef, ObjectRefSchema, SchemaOrRef, ValueType } from "../../ontology";
+import type { QuantitativeTypeId } from "../../ontology/units";
+type Simplify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+/** One declarative parameter accepted by a Sixb definition. */
+export interface ParamConfig {
+    readonly schema: SchemaOrRef;
+    readonly required?: boolean;
+    readonly nullable?: boolean;
+    readonly description?: string;
+    readonly semanticType?: QuantitativeTypeId;
+}
+/** Parameter shape shared by definitions that accept validated invocation-time input. */
+export type ParamsConfig = Record<string, ParamConfig>;
+type RequiredParamKeys<TParams extends ParamsConfig> = {
+    [K in keyof TParams]-?: TParams[K]["required"] extends true ? K : never;
+}[keyof TParams];
+type OptionalParamKeys<TParams extends ParamsConfig> = Exclude<keyof TParams, RequiredParamKeys<TParams>>;
+/**
+ * Validated params normalize `date` and `timestamp` values back to `Date` for typed runtime
+ * consumers. The wider ontology inference keeps storage-facing values permissive.
+ */
+export type ParamPrimitiveSchemaValues = {
+    string: string;
+    uuid: string;
+    boolean: boolean;
+    integer: number;
+    double: number;
+    decimal: DecimalValue;
+    date: Date;
+    timestamp: Date;
+};
+type InferStructuredParamValue<TSchema extends SchemaOrRef, TValueTypes extends readonly ValueType[]> = TSchema extends {
+    type: "enum";
+    values: readonly (infer TValue)[];
+} ? TValue : TSchema extends ObjectRefSchema<infer TObjectTypeId> ? ObjectRef<TObjectTypeId> : InferSchemaOrRef<TSchema, TValueTypes>;
+type InferParamSchemaValue<TSchema extends SchemaOrRef, TValueTypes extends readonly ValueType[] = []> = TSchema extends keyof ParamPrimitiveSchemaValues ? ParamPrimitiveSchemaValues[TSchema] : InferStructuredParamValue<TSchema, TValueTypes>;
+type InferParamValue<TParam extends ParamConfig, TValueTypes extends readonly ValueType[] = []> = TParam["nullable"] extends true ? InferParamSchemaValue<TParam["schema"], TValueTypes> | null : InferParamSchemaValue<TParam["schema"], TValueTypes>;
+/** Infer the validated runtime input represented by a parameter config. */
+export type InferParams<TParams extends ParamsConfig, TValueTypes extends readonly ValueType[] = []> = string extends keyof TParams ? Record<string, unknown> : Simplify<{
+    [K in RequiredParamKeys<TParams>]: InferParamValue<TParams[K], TValueTypes>;
+} & {
+    [K in OptionalParamKeys<TParams>]?: InferParamValue<TParams[K], TValueTypes>;
+}>;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/params/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shared/params/types.ts"],"names":[],"mappings":"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"}

package/dist/shared/params/validation.d.ts

@@ -0,0 +1,15 @@
+import { type JsonValue } from "../../json";
+import type { ValueType } from "../../ontology";
+import type { ParamsConfig } from "./types";
+export interface ParamsOwner {
+    /** Lowercase singular name used in validation errors, for example `action` or `agent`. */
+    readonly kind: string;
+    readonly id: string;
+    /** Stable value path passed to ontology validation. Defaults to `id`. */
+    readonly path?: string;
+}
+/** Validate declarative params and normalize them to their durable JSON representation. */
+export declare function normalizeParams(valueTypesById: ReadonlyMap<string, ValueType>, paramsConfig: ParamsConfig, params: Record<string, unknown>, owner: ParamsOwner): Record<string, JsonValue>;
+/** Re-hydrate normalized storage values for typed runtime consumers. */
+export declare function coerceParamsToTyped(paramsConfig: ParamsConfig, params: Record<string, unknown>, valueTypesById: ReadonlyMap<string, ValueType>): Record<string, unknown>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/shared/params/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/shared/params/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAC1D,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAK5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C,MAAM,WAAW,WAAW;IAC1B,0FAA0F;IAC1F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,yEAAyE;IACzE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,CAC7B,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,EAC9C,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,EAAE,WAAW,GACjB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CA8C3B;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,GAC7C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBzB"}

package/dist/shares/internal.js

@@ -1,38 +1,39 @@
 // @bun
-import"../chunk-f4w3yp4f.js";
-import"../chunk-b19g04jk.js";
-import"../chunk-vsj3mdfj.js";
-import"../chunk-dz5h08xv.js";
+import"../chunk-hzw7yv5g.js";
+import"../chunk-z3y5kg1x.js";
+import"../chunk-3h7ctayx.js";
+import"../chunk-fc5zfxy1.js";
+import"../chunk-bbaa1fet.js";
 import"../chunk-v4jbb3rs.js";
-import"../chunk-ms2tmn1k.js";
+import"../chunk-vsg0g7h9.js";
 import {
   formatSessionCookieValue2,
   parseSessionCookieValue2
-} from "../chunk-g00bfdq6.js";
+} from "../chunk-2cxv584m.js";
 import"../chunk-q5gz3g2j.js";
 import"../chunk-pqajwytd.js";
-import"../chunk-e0d1rzef.js";
+import"../chunk-2h63nrde.js";
 import"../chunk-gfdh9kqa.js";
 import"../chunk-39tqv9hz.js";
-import"../chunk-7bs40fe1.js";
-import"../chunk-g53f0e4j.js";
+import"../chunk-69266efg.js";
+import"../chunk-xnx96gfy.js";
 import"../chunk-jgwb25gc.js";
-import"../chunk-8vj0rjgs.js";
-import"../chunk-93csa55g.js";
-import"../chunk-ap0g1g74.js";
-import"../chunk-p6a4npdx.js";
-import"../chunk-c5rkjrgp.js";
-import"../chunk-gqh45d2n.js";
-import"../chunk-z30bv4ga.js";
+import"../chunk-wjffn5m4.js";
+import"../chunk-axndsymr.js";
+import"../chunk-eyjzgav0.js";
+import"../chunk-hkw8rykk.js";
+import"../chunk-ybhz3j9g.js";
+import"../chunk-7ytf06d3.js";
+import"../chunk-yxb4c62x.js";
 import"../chunk-mmagke4x.js";
 import"../chunk-qma80ych.js";
-import"../chunk-358caqf5.js";
+import"../chunk-bfjv1adk.js";
 import"../chunk-jmfet9r4.js";
 import"../chunk-qf954wje.js";
-import"../chunk-pr2h4bv4.js";
+import"../chunk-tg4g4zh0.js";
 import {
   compileShareAccessPlan
-} from "../chunk-awbhdqyc.js";
+} from "../chunk-3ghw2t5q.js";
 import {
   intersectShareAccessPlans
 } from "../chunk-x9v4cx1d.js";
@@ -43,8 +44,8 @@ import {
   ShareSessionStorageError2
 } from "../chunk-z8fx5cgb.js";
 import"../chunk-s3csryxe.js";
-import"../chunk-653vwrzr.js";
-import"../chunk-f0rwz2vh.js";
+import"../chunk-y3ev53cq.js";
+import"../chunk-vpxss818.js";
 
 // src/shares/session-protocol.ts
 import { createHash, randomBytes, randomUUID, timingSafeEqual } from "crypto";
@@ -228,4 +229,4 @@ export {
   SharedSessionProtocol
 };
 
-//# debugId=46DFFB880F951EAC64756E2164756E21
+//# debugId=62AD42F4B15523F164756E2164756E21

package/dist/shares/internal.js.map

@@ -4,7 +4,7 @@
   "sourcesContent": [
     "import { createHash, randomBytes, randomUUID, timingSafeEqual } from \"node:crypto\"\nimport { formatSessionCookieValue, parseSessionCookieValue } from \"../auth/sessions\"\nimport type { SixbHostView } from \"../runtime\"\nimport type { ShareGrantRecord, ShareSessionRecord, Storage } from \"../storage\"\nimport { ShareSessionStorageError } from \"../storage\"\nimport { type ShareAccessPlan, snapshotShareAccessPlan } from \"./access-plan\"\nimport { compileShareAccessPlan } from \"./compiler\"\nimport { intersectShareAccessPlans } from \"./intersection\"\n\nexport const DEFAULT_SHARED_SESSION_INACTIVITY_TTL_MS = 15 * 60_000\n\nconst MAX_CREATE_ATTEMPTS = 5\nconst SECRET_PATTERN = /^[A-Za-z0-9_-]{43}$/\n\nexport interface SharedSessionContext {\n  readonly grantId: string\n  readonly sessionId: string\n  readonly destinationPath: string\n  readonly access: ShareAccessPlan\n  readonly expiresAt: Date\n  readonly absoluteExpiresAt: Date\n}\n\nexport interface SharedSessionCredential {\n  readonly context: SharedSessionContext\n  /** Opaque value for the HttpOnly shared-session cookie. */\n  readonly cookieValue: string\n}\n\nexport interface SharedSessionProtocolOptions {\n  readonly host: SixbHostView\n  readonly inactivityTtlMs?: number\n  readonly now?: () => Date\n}\n\n/**\n * Framework-owned shared-session lifecycle.\n *\n * Link and session secrets are verified here. Callers receive only an effective access plan built\n * from the issued snapshot intersected with the Share definition registered now.\n */\nexport class SharedSessionProtocol {\n  private readonly host: SixbHostView\n  private readonly inactivityTtlMs: number\n  private readonly now: () => Date\n\n  constructor(options: SharedSessionProtocolOptions) {\n    if (!options.host.storage.shareGrants || !options.host.storage.shareSessions) {\n      throw new Error(\"[Sixb] Shared sessions require share grant and session storage.\")\n    }\n    const inactivityTtlMs = options.inactivityTtlMs ?? DEFAULT_SHARED_SESSION_INACTIVITY_TTL_MS\n    if (!Number.isSafeInteger(inactivityTtlMs) || inactivityTtlMs <= 0) {\n      throw new Error(\"[Sixb] Shared session inactivity TTL must be a positive integer.\")\n    }\n    this.host = options.host\n    this.inactivityTtlMs = inactivityTtlMs\n    this.now = options.now ?? (() => new Date())\n  }\n\n  async exchange(grantId: string, secret: string): Promise<SharedSessionCredential | null> {\n    if (!validIdentifier(grantId) || !validSecret(secret)) return null\n    const now = this.currentTime()\n\n    for (let attempt = 0; attempt < MAX_CREATE_ATTEMPTS; attempt += 1) {\n      const sessionSecret = randomBytes(32).toString(\"base64url\")\n      const sessionId = `shs_${randomUUID()}`\n      try {\n        const result = await this.host.storage.transaction(async (tx) => {\n          const grant = await activeGrant(tx, this.host.projectId, grantId, now)\n          const secretMatches = secretMatchesHash(secret, grant?.tokenHash ?? \"\")\n          if (!grant || !secretMatches) return null\n          const sessions = requireSessions(tx)\n          const absoluteExpiresAt = new Date(grant.expiresAt)\n          const session = await sessions.create({\n            id: sessionId,\n            projectId: this.host.projectId,\n            grantId: grant.id,\n            tokenHash: sha256(sessionSecret),\n            createdAt: now,\n            expiresAt: inactivityDeadline(now, absoluteExpiresAt, this.inactivityTtlMs),\n            absoluteExpiresAt,\n          })\n          return { grant, session }\n        })\n        if (!result) return null\n        return {\n          context: this.context(result.grant, result.session),\n          cookieValue: formatSessionCookieValue(sessionId, sessionSecret),\n        }\n      } catch (error) {\n        if (\n          error instanceof ShareSessionStorageError &&\n          error.code === \"duplicate\" &&\n          attempt < MAX_CREATE_ATTEMPTS - 1\n        ) {\n          continue\n        }\n        throw error\n      }\n    }\n\n    return null\n  }\n\n  async resolve(\n    grantId: string,\n    cookieValue: string | undefined,\n    options: { readonly activity?: \"background\" | \"foreground\" } = {}\n  ): Promise<SharedSessionContext | null> {\n    if (!validIdentifier(grantId) || !validCookieValue(cookieValue)) return null\n    const credential = parseSessionCookieValue(cookieValue)\n    if (\n      !credential ||\n      !validIdentifier(credential.sessionId) ||\n      !validSecret(credential.sessionSecret)\n    ) {\n      return null\n    }\n    const now = this.currentTime()\n    const tokenHash = sha256(credential.sessionSecret)\n\n    const result = await this.host.storage.transaction(async (tx) => {\n      const sessions = requireSessions(tx)\n      const current = await sessions.getById({\n        projectId: this.host.projectId,\n        id: credential.sessionId,\n      })\n      const secretMatches = secretMatchesHash(credential.sessionSecret, current?.tokenHash ?? \"\")\n      if (\n        !current ||\n        current.grantId !== grantId ||\n        current.revokedAt !== undefined ||\n        current.expiresAt.getTime() <= now.getTime() ||\n        current.absoluteExpiresAt.getTime() <= now.getTime() ||\n        !secretMatches\n      ) {\n        return null\n      }\n\n      const grant = await activeGrant(tx, this.host.projectId, grantId, now)\n      if (!grant || current.absoluteExpiresAt.getTime() !== grant.expiresAt.getTime()) {\n        return null\n      }\n\n      if (options.activity !== \"foreground\") return { grant, session: current }\n\n      const renewed = await sessions.renewIfValid({\n        projectId: this.host.projectId,\n        id: current.id,\n        grantId,\n        tokenHash,\n        now,\n        expiresAt: inactivityDeadline(now, current.absoluteExpiresAt, this.inactivityTtlMs),\n      })\n      return renewed ? { grant, session: renewed } : null\n    })\n\n    return result ? this.context(result.grant, result.session) : null\n  }\n\n  async revoke(context: Pick<SharedSessionContext, \"grantId\" | \"sessionId\">): Promise<void> {\n    const revokedAt = this.currentTime()\n    await this.host.storage.transaction(async (tx) => {\n      const session = await requireSessions(tx).getById({\n        projectId: this.host.projectId,\n        id: context.sessionId,\n      })\n      if (!session || session.grantId !== context.grantId) return\n      await requireSessions(tx).revoke({\n        projectId: this.host.projectId,\n        id: context.sessionId,\n        revokedAt,\n      })\n    })\n  }\n\n  private context(grant: ShareGrantRecord, session: ShareSessionRecord): SharedSessionContext {\n    return {\n      grantId: grant.id,\n      sessionId: session.id,\n      destinationPath: grant.destinationPath,\n      access: effectiveAccess(this.host, grant),\n      expiresAt: new Date(session.expiresAt),\n      absoluteExpiresAt: new Date(session.absoluteExpiresAt),\n    }\n  }\n\n  private currentTime(): Date {\n    const now = this.now()\n    if (!(now instanceof Date) || !Number.isFinite(now.getTime())) {\n      throw new Error(\"[Sixb] Shared session clock returned an invalid date.\")\n    }\n    return new Date(now)\n  }\n}\n\nfunction effectiveAccess(host: SixbHostView, grant: ShareGrantRecord): ShareAccessPlan {\n  const definition = host.definitions.shares.getById(grant.definitionId)\n  if (!definition || definition.target.objectTypeId !== grant.target.objectTypeId) {\n    return snapshotShareAccessPlan({ grants: [] })\n  }\n  const current = compileShareAccessPlan({\n    share: definition,\n    target: grant.target,\n    ontology: host.definitions.ontology,\n    actions: host.definitions.actions,\n  })\n  return intersectShareAccessPlans(grant.authoritySnapshot.access, current)\n}\n\nasync function activeGrant(\n  storage: Storage,\n  projectId: string,\n  grantId: string,\n  now: Date\n): Promise<ShareGrantRecord | null> {\n  const grant = await storage.shareGrants?.getById({ projectId, id: grantId })\n  return !grant || grant.revokedAt !== undefined || grant.expiresAt.getTime() <= now.getTime()\n    ? null\n    : grant\n}\n\nfunction requireSessions(storage: Storage): NonNullable<Storage[\"shareSessions\"]> {\n  if (!storage.shareSessions) {\n    throw new Error(\"[Sixb] Shared session storage is not configured.\")\n  }\n  return storage.shareSessions\n}\n\nfunction inactivityDeadline(now: Date, absolute: Date, ttlMs: number): Date {\n  return new Date(Math.min(absolute.getTime(), now.getTime() + ttlMs))\n}\n\nfunction secretMatchesHash(secret: string, expectedHash: string): boolean {\n  const actual = createHash(\"sha256\").update(secret).digest()\n  const expected = /^[0-9a-f]{64}$/.test(expectedHash)\n    ? Buffer.from(expectedHash, \"hex\")\n    : Buffer.alloc(actual.length)\n  return timingSafeEqual(actual, expected)\n}\n\nfunction sha256(value: string): string {\n  return createHash(\"sha256\").update(value).digest(\"hex\")\n}\n\nfunction validIdentifier(value: unknown): value is string {\n  return (\n    typeof value === \"string\" && value.length > 0 && value.length <= 128 && value.trim() === value\n  )\n}\n\nfunction validSecret(value: unknown): value is string {\n  return typeof value === \"string\" && SECRET_PATTERN.test(value)\n}\n\nfunction validCookieValue(value: unknown): value is string {\n  return typeof value === \"string\" && value.length <= 256\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "46DFFB880F951EAC64756E2164756E21",
+  "mappings": "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",
+  "debugId": "62AD42F4B15523F164756E2164756E21",
   "names": []
 }

package/dist/storage/action-runs/failure.js

@@ -2,11 +2,12 @@
 import {
   serializeActionRunFailure2,
   parseActionRunFailure2
-} from "../../chunk-b19g04jk.js";
-import"../../chunk-f4w3yp4f.js";
+} from "../../chunk-3h7ctayx.js";
+import"../../chunk-hzw7yv5g.js";
+import"../../chunk-z3y5kg1x.js";
 export {
   parseActionRunFailure2 as parseActionRunFailure,
   serializeActionRunFailure2 as serializeActionRunFailure
 };
 
-//# debugId=98D27202CDFC037064756E2164756E21
+//# debugId=DFE8D9CC49D4A7AF64756E2164756E21

package/dist/storage/action-runs/failure.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "98D27202CDFC037064756E2164756E21",
+  "debugId": "DFE8D9CC49D4A7AF64756E2164756E21",
   "names": []
 }

package/dist/storage/action-runs/provider.js

@@ -1,7 +1,7 @@
 // @bun
 import {
   assertActionRunExecution2
-} from "../../chunk-vsj3mdfj.js";
+} from "../../chunk-fc5zfxy1.js";
 export {
   assertActionRunExecution2 as assertActionRunExecution
 };

package/dist/storage/agents/in-memory.d.ts

@@ -1,5 +1,5 @@
 import type { ExecutionStorage } from "../executions";
-import type { AgentContextCheckpointRecord, AgentContextCheckpointStore, AgentMessageRecord, AgentMessageStore, AgentRunRecord, AgentRunStore, AgentStorage, AgentThreadRecord, AgentThreadStore, AppendAgentMessageInput, ConfirmAgentRunExecutionOwnershipInput, ConversationAgentRunRecord, CreateAgentContextCheckpointInput, CreateAgentRunInput, CreateAgentThreadInput, CreateSubagentRunInput, DeleteAgentMessagesByRunInput, FinishAgentRunInput, FinishQueuedAgentRunInput, ListAgentMessagesInput, ListAgentMessagesResult, ListAgentRunsInput, ListAgentRunsResult, ListAgentThreadsInput, ListAgentThreadsResult, ReclaimAgentRunInput, StartAgentRunInput, SubagentRunRecord } from "./types";
+import type { AgentContextCheckpointRecord, AgentContextCheckpointStore, AgentMessageRecord, AgentMessageStore, AgentRunRecord, AgentRunStore, AgentStorage, AgentThreadRecord, AgentThreadSandboxState, AgentThreadStore, AppendAgentMessageInput, ConfirmAgentRunExecutionOwnershipInput, ConversationAgentRunRecord, CreateAgentContextCheckpointInput, CreateAgentRunInput, CreateAgentThreadInput, CreateSubagentRunInput, DeleteAgentMessagesByRunInput, FinishAgentRunInput, FinishQueuedAgentRunInput, ListAgentMessagesInput, ListAgentMessagesResult, ListAgentRunsInput, ListAgentRunsResult, ListAgentThreadsInput, ListAgentThreadsResult, ReclaimAgentRunInput, StartAgentRunInput, SubagentRunRecord, TransitionAgentThreadSandboxInput } from "./types";
 /**
  * Shared in-memory state behind the four sub-stores. They are tiered for ergonomics
  * (`storage.runs.create(...)`), but several operations span tables — creating/finishing a run
@@ -21,6 +21,7 @@ export interface InMemoryAgentStorageSnapshot {
 declare class InMemoryAgentThreadStore implements AgentThreadStore {
     private readonly state;
     constructor(state: AgentStoreState);
+    transitionSandbox(input: TransitionAgentThreadSandboxInput): Promise<AgentThreadSandboxState>;
     create(input: CreateAgentThreadInput): Promise<AgentThreadRecord>;
     getById(params: {
         projectId: string;

package/dist/storage/agents/in-memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../../src/storage/agents/in-memory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../../src/storage/agents/in-memory.ts"],"names":[],"mappings":"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"}

package/dist/storage/agents/index.d.ts

@@ -2,6 +2,6 @@ export type { AgentStorageErrorCode } from "./errors";
 export { AgentStorageError } from "./errors";
 export type { InMemoryAgentStorageSnapshot } from "./in-memory";
 export { InMemoryAgentStorage } from "./in-memory";
-export type { AgentContextCheckpointReason, AgentContextCheckpointRecord, AgentContextCheckpointStore, AgentExecutionStatus, AgentMessageRecord, AgentMessageRole, AgentMessageStore, AgentRunDiagnostic, AgentRunDiagnosticCode, AgentRunDiagnosticSeverity, AgentRunExecution, AgentRunFailureCode, AgentRunFinishReason, AgentRunKind, AgentRunRecord, AgentRunStatus, AgentRunStore, AgentStorage, AgentThreadRecord, AgentThreadStatus, AgentThreadStore, AppendAgentMessageInput, ConfirmAgentRunExecutionOwnershipInput, ConversationAgentRunRecord, ConversationAgentRunSpec, CreateAgentContextCheckpointInput, CreateAgentRunInput, CreateAgentThreadInput, CreateSubagentRunInput, DeleteAgentMessagesByRunInput, FinishAgentRunInput, FinishQueuedAgentRunInput, ListAgentMessagesInput, ListAgentMessagesResult, ListAgentRunsInput, ListAgentRunsResult, ListAgentThreadsInput, ListAgentThreadsResult, ReclaimAgentRunInput, StartAgentRunInput, SubagentRunRecord, SubagentRunResult, SubagentRunSpec, } from "./types";
+export type { AgentContextCheckpointReason, AgentContextCheckpointRecord, AgentContextCheckpointStore, AgentExecutionStatus, AgentMessageRecord, AgentMessageRole, AgentMessageStore, AgentRunDiagnostic, AgentRunDiagnosticCode, AgentRunDiagnosticSeverity, AgentRunExecution, AgentRunFailureCode, AgentRunFinishReason, AgentRunKind, AgentRunRecord, AgentRunStatus, AgentRunStore, AgentStorage, AgentThreadRecord, AgentThreadSandboxParams, AgentThreadSandboxState, AgentThreadStatus, AgentThreadStore, AppendAgentMessageInput, ConfirmAgentRunExecutionOwnershipInput, ConversationAgentRunRecord, ConversationAgentRunSpec, CreateAgentContextCheckpointInput, CreateAgentRunInput, CreateAgentThreadInput, CreateSubagentRunInput, DeleteAgentMessagesByRunInput, FinishAgentRunInput, FinishQueuedAgentRunInput, ListAgentMessagesInput, ListAgentMessagesResult, ListAgentRunsInput, ListAgentRunsResult, ListAgentThreadsInput, ListAgentThreadsResult, ReclaimAgentRunInput, StartAgentRunInput, SubagentRunRecord, SubagentRunResult, SubagentRunSpec, TransitionAgentThreadSandboxInput, } from "./types";
 export { AGENT_RUN_DIAGNOSTIC_CODES, AGENT_RUN_FAILURE_CODES, AGENT_RUN_FINISH_REASONS, coerceAgentRunFinishReason, } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/storage/agents/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/agents/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAC5C,YAAY,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAA;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,YAAY,EACV,4BAA4B,EAC5B,4BAA4B,EAC5B,2BAA2B,EAC3B,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,sCAAsC,EACtC,0BAA0B,EAC1B,wBAAwB,EACxB,iCAAiC,EACjC,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,6BAA6B,EAC7B,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,GAChB,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/agents/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAC5C,YAAY,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAA;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,YAAY,EACV,4BAA4B,EAC5B,4BAA4B,EAC5B,2BAA2B,EAC3B,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,wBAAwB,EACxB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,sCAAsC,EACtC,0BAA0B,EAC1B,wBAAwB,EACxB,iCAAiC,EACjC,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,6BAA6B,EAC7B,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,iCAAiC,GAClC,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,SAAS,CAAA"}

package/dist/storage/agents/provider.d.ts

@@ -1,5 +1,9 @@
 import type { ExecutionRecord, ExecutionStorage } from "../executions";
-import type { AgentContextCheckpointRecord, AgentMessageRecord, AgentRunRecord, AgentThreadRecord, ConversationAgentRunSpec, CreateAgentContextCheckpointInput, CreateSubagentRunInput, SubagentRunRecord, SubagentRunResult } from "./types";
+import type { AgentContextCheckpointRecord, AgentMessageRecord, AgentRunRecord, AgentThreadRecord, AgentThreadSandboxParams, AgentThreadSandboxState, ConversationAgentRunSpec, CreateAgentContextCheckpointInput, CreateSubagentRunInput, SubagentRunRecord, SubagentRunResult, TransitionAgentThreadSandboxInput } from "./types";
+/** Shared state machine. Providers must lock the run, then thread, around this decision/write. */
+export declare function transitionAgentThreadSandbox(thread: AgentThreadRecord | null, run: AgentRunRecord | null, input: TransitionAgentThreadSandboxInput): AgentThreadSandboxState;
+/** Snapshot application parameters independently of worker-owned sandbox state. */
+export declare function snapshotAgentThreadSandboxParams(value: unknown): AgentThreadSandboxParams;
 /** Validate the provider-neutral model selection captured for a conversational turn. */
 export declare function assertConversationAgentRunSpec(spec: ConversationAgentRunSpec, prefix?: string): void;
 /** Validate the semantic link between a conversational Agent run and its immutable execution. */

package/dist/storage/agents/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/storage/agents/provider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAGtE,OAAO,KAAK,EACV,4BAA4B,EAC5B,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,wBAAwB,EACxB,iCAAiC,EACjC,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,SAAS,CAAA;AAEhB,wFAAwF;AACxF,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,wBAAwB,EAC9B,MAAM,SAAS,GACd,IAAI,CAwBN;AAMD,iGAAiG;AACjG,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAA;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB,GAAG,OAAO,CAAC,eAAe,CAAC,CAe3B;AAED,8EAA8E;AAC9E,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,GAAG,IAAI,CA4DjG;AAED,0EAA0E;AAC1E,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,sBAAsB,GAC5B,GAAG,IAAI,iBAAiB,CAU1B;AAED,wEAAwE;AACxE,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,iBAAiB,GAAG,SAAS,EACrC,KAAK,EAAE,MAAM,EACb,MAAM,SAAS,GACd,OAAO,CAAC,MAAM,IAAI,iBAAiB,CAiBrC;AAED,kGAAkG;AAClG,wBAAgB,uCAAuC,CACrD,KAAK,EAAE,iCAAiC,EACxC,MAAM,SAAS,GACd,IAAI,CAyEN;AAED,iFAAiF;AACjF,wBAAgB,qCAAqC,CAAC,KAAK,EAAE;IAC3D,QAAQ,CAAC,MAAM,EAAE,iCAAiC,CAAA;IAClD,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAAA;IACnC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAA;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,GAAG;IAClC,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;CACnC,CAuCA;AAED,2EAA2E;AAC3E,wBAAgB,mCAAmC,CAAC,KAAK,EAAE;IACzD,QAAQ,CAAC,MAAM,EAAE,iCAAiC,CAAA;IAClD,QAAQ,CAAC,MAAM,EAAE,4BAA4B,GAAG,IAAI,CAAA;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,aAAa,EAAE,kBAAkB,GAAG,IAAI,CAAA;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,GAAG,IAAI,CAmCP;AAED,8FAA8F;AAC9F,wBAAgB,uCAAuC,CAAC,KAAK,EAAE;IAC7D,QAAQ,CAAC,MAAM,EAAE,iCAAiC,CAAA;IAClD,QAAQ,CAAC,QAAQ,EAAE,4BAA4B,CAAA;IAC/C,QAAQ,CAAC,MAAM,EAAE,4BAA4B,GAAG,IAAI,CAAA;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,GAAG,IAAI,CAcP;AAED,oGAAoG;AACpG,wBAAgB,wCAAwC,CACtD,MAAM,EAAE,4BAA4B,EACpC,KAAK,EAAE,iCAAiC,GACvC,OAAO,CAgBT"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/storage/agents/provider.ts"],"names":[],"mappings":"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"}

package/dist/storage/agents/provider.js

@@ -1,5 +1,7 @@
 // @bun
 import {
+  transitionAgentThreadSandbox2,
+  snapshotAgentThreadSandboxParams2,
   assertConversationAgentRunSpec2,
   assertAgentRunExecution2,
   assertCreateSubagentRunInput2,
@@ -10,8 +12,8 @@ import {
   assertAgentContextCheckpointAnchors2,
   assertAgentContextCheckpointReplayState2,
   agentContextCheckpointMatchesCreateInput2
-} from "../../chunk-7bs40fe1.js";
-import"../../chunk-e0d1rzef.js";
+} from "../../chunk-69266efg.js";
+import"../../chunk-2h63nrde.js";
 import"../../chunk-pqajwytd.js";
 import"../../chunk-39tqv9hz.js";
 import"../../chunk-gfdh9kqa.js";
@@ -25,7 +27,9 @@ export {
   assertCreateAgentContextCheckpointInput2 as assertCreateAgentContextCheckpointInput,
   assertCreateSubagentRunInput2 as assertCreateSubagentRunInput,
   assertSubagentRunResult2 as assertSubagentRunResult,
-  subagentRunMatchesCreateInput2 as subagentRunMatchesCreateInput
+  snapshotAgentThreadSandboxParams2 as snapshotAgentThreadSandboxParams,
+  subagentRunMatchesCreateInput2 as subagentRunMatchesCreateInput,
+  transitionAgentThreadSandbox2 as transitionAgentThreadSandbox
 };
 
-//# debugId=4C3BF4CE9626232F64756E2164756E21
+//# debugId=108B7D70531C190E64756E2164756E21

package/dist/storage/agents/provider.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "4C3BF4CE9626232F64756E2164756E21",
+  "debugId": "108B7D70531C190E64756E2164756E21",
   "names": []
 }

package/dist/storage/agents/types.d.ts

@@ -6,12 +6,58 @@ import type { SixbFailure } from "../../errors/types";
 import type { JsonValue } from "../../json";
 import type { LanguageModelRef } from "../../models";
 export type AgentThreadStatus = "active" | "archived";
+/** Immutable, non-secret application input. Never store resolved env or credentials here. */
+export type AgentThreadSandboxParams = Readonly<Record<string, JsonValue>>;
+/** Worker-owned state, independent from the immutable application binding. */
+export interface AgentThreadSandboxState {
+    /** Exact name passed to the provider. Replacements always receive a fresh name. */
+    readonly name: string;
+    readonly status: "new" | "busy" | "ready" | "blocked" | "unavailable";
+    readonly sourceFingerprint?: string;
+    readonly initialized: boolean;
+    /** Durable context boundary: local files from before this reset are no longer available. */
+    readonly resetAt?: string;
+    /** Never expires automatically: a delayed provider operation must not reach a successor. */
+    readonly owner?: {
+        readonly runId: string;
+        readonly executionToken: string;
+    };
+}
+export type TransitionAgentThreadSandboxInput = {
+    readonly projectId: string;
+    readonly id: string;
+} & ({
+    readonly action: "acquire";
+    readonly runId: string;
+    readonly executionToken: string;
+    readonly name: string;
+    readonly sourceFingerprint: string;
+} | {
+    readonly action: "replace";
+    readonly runId: string;
+    readonly executionToken: string;
+    readonly name: string;
+    readonly nextName: string;
+} | {
+    readonly action: "settle";
+    readonly runId: string;
+    readonly executionToken: string;
+    readonly name: string;
+    readonly status: "ready" | "blocked" | "unavailable";
+    readonly initialized: boolean;
+} | {
+    readonly action: "recreate";
+    readonly expectedSandboxName: string;
+    readonly name: string;
+});
 export interface AgentThreadRecord {
     readonly id: string;
     readonly projectId: string;
     /** Who owns/opened the thread. Reuses the canonical auth principal (gains `agent` later for free). */
     readonly ownerPrincipal: Principal;
     readonly title?: string;
+    readonly sandboxParams?: AgentThreadSandboxParams;
+    readonly sandboxState?: AgentThreadSandboxState;
     readonly status: AgentThreadStatus;
     /** Single-flight anchor: the id of the one run currently allowed to write, or `null` when idle. */
     readonly activeRunId: string | null;
@@ -25,6 +71,7 @@ export interface CreateAgentThreadInput {
     readonly projectId: string;
     readonly ownerPrincipal: Principal;
     readonly title?: string;
+    readonly sandboxParams?: AgentThreadSandboxParams;
     readonly status?: AgentThreadStatus;
     readonly createdAt?: Date;
     readonly updatedAt?: Date;
@@ -331,6 +378,8 @@ export interface CreateAgentContextCheckpointInput {
     readonly createdAt?: Date;
 }
 export interface AgentThreadStore {
+    /** Atomic run-fenced transition, or explicit idle-thread recreation. */
+    transitionSandbox(input: TransitionAgentThreadSandboxInput): Promise<AgentThreadSandboxState>;
     create(input: CreateAgentThreadInput): Promise<AgentThreadRecord>;
     getById(params: {
         projectId: string;