@agentuity/server 0.1.10 → 0.1.11

package/dist/api/sandbox/index.d.ts

@@ -19,6 +19,8 @@ export { SandboxClient } from './client';
 export type { SandboxClientOptions, SandboxInstance, ExecuteOptions } from './client';
 export { sandboxWriteFiles, sandboxReadFile, sandboxMkDir, sandboxRmDir, sandboxRmFile, sandboxListFiles, sandboxDownloadArchive, sandboxUploadArchive, sandboxSetEnv, } from './files';
 export type { WriteFilesParams, WriteFilesResult, ReadFileParams, MkDirParams, RmDirParams, RmFileParams, ListFilesParams, ListFilesResult, FileInfo, ArchiveFormat, DownloadArchiveParams, UploadArchiveParams, SetEnvParams, SetEnvResult, } from './files';
-export { snapshotCreate, snapshotGet, snapshotList, snapshotDelete, snapshotTag } from './snapshot';
-export type { SnapshotInfo, SnapshotFileInfo, SnapshotCreateParams, SnapshotGetParams, SnapshotListParams, SnapshotListResponse, SnapshotDeleteParams, SnapshotTagParams, } from './snapshot';
+export { snapshotCreate, snapshotGet, snapshotList, snapshotDelete, snapshotTag, snapshotBuildInit, snapshotBuildFinalize, } from './snapshot';
+export type { SnapshotInfo, SnapshotFileInfo, SnapshotCreateParams, SnapshotGetParams, SnapshotListParams, SnapshotListResponse, SnapshotDeleteParams, SnapshotTagParams, SnapshotBuildInitParams, SnapshotBuildInitResponse, SnapshotBuildFinalizeParams, } from './snapshot';
+export { SnapshotBuildFileSchema } from './snapshot-build';
+export type { SnapshotBuildFile } from './snapshot-build';
 //# sourceMappingURL=index.d.ts.map

package/dist/api/sandbox/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/sandbox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,YAAY,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,YAAY,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,YAAY,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,YAAY,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,YAAY,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EACX,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACtF,OAAO,EACN,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,aAAa,GACb,MAAM,SAAS,CAAC;AACjB,YAAY,EACX,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,WAAW,EACX,YAAY,EACZ,eAAe,EACf,eAAe,EACf,QAAQ,EACR,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,EACZ,YAAY,GACZ,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACpG,YAAY,EACX,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,GACjB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/sandbox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,YAAY,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,YAAY,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,YAAY,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,YAAY,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,YAAY,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EACX,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACtF,OAAO,EACN,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,aAAa,GACb,MAAM,SAAS,CAAC;AACjB,YAAY,EACX,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,WAAW,EACX,YAAY,EACZ,eAAe,EACf,eAAe,EACf,QAAQ,EACR,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,EACZ,YAAY,GACZ,MAAM,SAAS,CAAC;AACjB,OAAO,EACN,cAAc,EACd,WAAW,EACX,YAAY,EACZ,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,qBAAqB,GACrB,MAAM,YAAY,CAAC;AACpB,YAAY,EACX,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,GAC3B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/api/sandbox/index.js

@@ -9,5 +9,6 @@ export { executionGet, executionList } from './execution';
 export { SandboxResponseError, writeAndDrain } from './util';
 export { SandboxClient } from './client';
 export { sandboxWriteFiles, sandboxReadFile, sandboxMkDir, sandboxRmDir, sandboxRmFile, sandboxListFiles, sandboxDownloadArchive, sandboxUploadArchive, sandboxSetEnv, } from './files';
-export { snapshotCreate, snapshotGet, snapshotList, snapshotDelete, snapshotTag } from './snapshot';
+export { snapshotCreate, snapshotGet, snapshotList, snapshotDelete, snapshotTag, snapshotBuildInit, snapshotBuildFinalize, } from './snapshot';
+export { SnapshotBuildFileSchema } from './snapshot-build';
 //# sourceMappingURL=index.js.map

package/dist/api/sandbox/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/sandbox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEnC,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEnC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAO1D,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EACN,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,aAAa,GACb,MAAM,SAAS,CAAC;AAiBjB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/sandbox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEnC,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEnC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAO1D,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EACN,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,aAAa,GACb,MAAM,SAAS,CAAC;AAiBjB,OAAO,EACN,cAAc,EACd,WAAW,EACX,YAAY,EACZ,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,qBAAqB,GACrB,MAAM,YAAY,CAAC;AAcpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/api/sandbox/snapshot-build.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+/**
+ * Base schema for snapshot build configuration file (agentuity-snapshot.yaml)
+ * This is the canonical schema - used for JSON Schema generation.
+ */
+export declare const SnapshotBuildFileBaseSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    runtime: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    files: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Schema with validation refinement - use this for parsing/validation.
+ * Ensures at least one of dependencies, files, or env is specified.
+ */
+export declare const SnapshotBuildFileSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    runtime: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    files: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export type SnapshotBuildFile = z.infer<typeof SnapshotBuildFileSchema>;
+//# sourceMappingURL=snapshot-build.d.ts.map

package/dist/api/sandbox/snapshot-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-build.d.ts","sourceRoot":"","sources":["../../../src/api/sandbox/snapshot-build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;iBAqCgD,CAAC;AAEzF;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;iBAUnC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/api/sandbox/snapshot-build.js

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+/**
+ * Base schema for snapshot build configuration file (agentuity-snapshot.yaml)
+ * This is the canonical schema - used for JSON Schema generation.
+ */
+export const SnapshotBuildFileBaseSchema = z
+    .object({
+    version: z.literal(1).describe('Schema version, must be 1'),
+    runtime: z
+        .string()
+        .describe('Runtime identifier (name:tag format, e.g., bun:1, node:20, python:3.12)'),
+    name: z
+        .string()
+        .regex(/^[a-zA-Z0-9_-]+$/)
+        .optional()
+        .describe('Snapshot name (alphanumeric, underscores, dashes only)'),
+    description: z.string().optional().describe('Human-readable description of the snapshot'),
+    dependencies: z
+        .array(z.string())
+        .optional()
+        .describe('List of apt packages to install. Supports version pinning: package=version or package=version* for prefix matching'),
+    files: z
+        .array(z.string())
+        .optional()
+        .describe('Glob patterns for files to include from the build context. Supports negative patterns with ! prefix for exclusions'),
+    env: z
+        .record(z.string(), z.string())
+        .optional()
+        .describe('Environment variables to set. Use ${VAR} syntax for build-time substitution via --env flag'),
+    metadata: z
+        .record(z.string(), z.string())
+        .optional()
+        .describe('User-defined metadata key-value pairs. Use ${VAR} syntax for build-time substitution via --metadata flag'),
+})
+    .describe('Agentuity Snapshot Build File - defines a reproducible sandbox environment');
+/**
+ * Schema with validation refinement - use this for parsing/validation.
+ * Ensures at least one of dependencies, files, or env is specified.
+ */
+export const SnapshotBuildFileSchema = SnapshotBuildFileBaseSchema.refine((data) => {
+    const hasDependencies = data.dependencies && data.dependencies.length > 0;
+    const hasFiles = data.files && data.files.length > 0;
+    const hasEnv = data.env && Object.keys(data.env).length > 0;
+    return hasDependencies || hasFiles || hasEnv;
+}, {
+    message: 'At least one of dependencies, files, or env must be specified',
+});
+//# sourceMappingURL=snapshot-build.js.map

package/dist/api/sandbox/snapshot-build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-build.js","sourceRoot":"","sources":["../../../src/api/sandbox/snapshot-build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC;KAC1C,MAAM,CAAC;IACP,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAC3D,OAAO,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,yEAAyE,CAAC;IACrF,IAAI,EAAE,CAAC;SACL,MAAM,EAAE;SACR,KAAK,CAAC,kBAAkB,CAAC;SACzB,QAAQ,EAAE;SACV,QAAQ,CAAC,wDAAwD,CAAC;IACpE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACzF,YAAY,EAAE,CAAC;SACb,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CACR,oHAAoH,CACpH;IACF,KAAK,EAAE,CAAC;SACN,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CACR,oHAAoH,CACpH;IACF,GAAG,EAAE,CAAC;SACJ,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;SAC9B,QAAQ,EAAE;SACV,QAAQ,CACR,4FAA4F,CAC5F;IACF,QAAQ,EAAE,CAAC;SACT,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;SAC9B,QAAQ,EAAE;SACV,QAAQ,CACR,0GAA0G,CAC1G;CACF,CAAC;KACD,QAAQ,CAAC,4EAA4E,CAAC,CAAC;AAEzF;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,2BAA2B,CAAC,MAAM,CACxE,CAAC,IAAI,EAAE,EAAE;IACR,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAC5D,OAAO,eAAe,IAAI,QAAQ,IAAI,MAAM,CAAC;AAC9C,CAAC,EACD;IACC,OAAO,EAAE,+DAA+D;CACxE,CACD,CAAC"}

package/dist/api/sandbox/snapshot.d.ts

@@ -1,51 +1,80 @@
+import { z } from 'zod';
 import { APIClient } from '../api';
-export interface SnapshotFileInfo {
-    path: string;
-    size: number;
-}
-export interface SnapshotInfo {
-    snapshotId: string;
-    runtimeId?: string | null;
-    name: string;
-    description?: string | null;
-    tag?: string | null;
-    sizeBytes: number;
-    fileCount: number;
-    parentSnapshotId?: string | null;
-    createdAt: string;
-    downloadUrl?: string;
-    files?: SnapshotFileInfo[] | null;
-}
-export interface SnapshotCreateParams {
-    sandboxId: string;
-    name?: string;
-    description?: string;
-    tag?: string;
-    orgId?: string;
-}
-export interface SnapshotGetParams {
-    snapshotId: string;
-    orgId?: string;
-}
-export interface SnapshotListParams {
-    sandboxId?: string;
-    limit?: number;
-    offset?: number;
-    orgId?: string;
-}
-export interface SnapshotListResponse {
-    snapshots: SnapshotInfo[];
-    total: number;
-}
-export interface SnapshotDeleteParams {
-    snapshotId: string;
-    orgId?: string;
-}
-export interface SnapshotTagParams {
-    snapshotId: string;
-    tag: string | null;
-    orgId?: string;
-}
+declare const SnapshotFileInfoSchema: z.ZodObject<{
+    path: z.ZodString;
+    size: z.ZodNumber;
+}, z.core.$strip>;
+declare const SnapshotInfoSchema: z.ZodObject<{
+    snapshotId: z.ZodString;
+    runtimeId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    tag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    sizeBytes: z.ZodNumber;
+    fileCount: z.ZodNumber;
+    parentSnapshotId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    downloadUrl: z.ZodOptional<z.ZodString>;
+    files: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        size: z.ZodNumber;
+    }, z.core.$strip>>>>;
+    userMetadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
+}, z.core.$strip>;
+declare const SnapshotListDataSchema: z.ZodObject<{
+    snapshots: z.ZodArray<z.ZodObject<{
+        snapshotId: z.ZodString;
+        runtimeId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        tag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        sizeBytes: z.ZodNumber;
+        fileCount: z.ZodNumber;
+        parentSnapshotId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        createdAt: z.ZodString;
+        downloadUrl: z.ZodOptional<z.ZodString>;
+        files: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            size: z.ZodNumber;
+        }, z.core.$strip>>>>;
+        userMetadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+export type SnapshotFileInfo = z.infer<typeof SnapshotFileInfoSchema>;
+export type SnapshotInfo = z.infer<typeof SnapshotInfoSchema>;
+export type SnapshotListResponse = z.infer<typeof SnapshotListDataSchema>;
+declare const _SnapshotCreateParamsSchema: z.ZodObject<{
+    sandboxId: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tag: z.ZodOptional<z.ZodString>;
+    orgId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const _SnapshotGetParamsSchema: z.ZodObject<{
+    snapshotId: z.ZodString;
+    orgId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const _SnapshotListParamsSchema: z.ZodObject<{
+    sandboxId: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    orgId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const _SnapshotDeleteParamsSchema: z.ZodObject<{
+    snapshotId: z.ZodString;
+    orgId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const _SnapshotTagParamsSchema: z.ZodObject<{
+    snapshotId: z.ZodString;
+    tag: z.ZodNullable<z.ZodString>;
+    orgId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SnapshotCreateParams = z.infer<typeof _SnapshotCreateParamsSchema>;
+export type SnapshotGetParams = z.infer<typeof _SnapshotGetParamsSchema>;
+export type SnapshotListParams = z.infer<typeof _SnapshotListParamsSchema>;
+export type SnapshotDeleteParams = z.infer<typeof _SnapshotDeleteParamsSchema>;
+export type SnapshotTagParams = z.infer<typeof _SnapshotTagParamsSchema>;
 /**
  * Creates a snapshot of a sandbox's current state.
  *
@@ -90,4 +119,57 @@ export declare function snapshotDelete(client: APIClient, params: SnapshotDelete
  * @throws {SandboxResponseError} If the snapshot is not found or update fails
  */
 export declare function snapshotTag(client: APIClient, params: SnapshotTagParams): Promise<SnapshotInfo>;
+declare const _SnapshotBuildInitParamsSchema: z.ZodObject<{
+    runtime: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    tag: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    contentHash: z.ZodOptional<z.ZodString>;
+    force: z.ZodOptional<z.ZodBoolean>;
+    orgId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const SnapshotBuildInitResponseSchema: z.ZodObject<{
+    snapshotId: z.ZodOptional<z.ZodString>;
+    uploadUrl: z.ZodOptional<z.ZodString>;
+    s3Key: z.ZodOptional<z.ZodString>;
+    unchanged: z.ZodOptional<z.ZodBoolean>;
+    existingId: z.ZodOptional<z.ZodString>;
+    existingName: z.ZodOptional<z.ZodString>;
+    existingTag: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const _SnapshotBuildFinalizeParamsSchema: z.ZodObject<{
+    snapshotId: z.ZodString;
+    sizeBytes: z.ZodNumber;
+    fileCount: z.ZodNumber;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        size: z.ZodNumber;
+    }, z.core.$strip>>;
+    dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    orgId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SnapshotBuildInitParams = z.infer<typeof _SnapshotBuildInitParamsSchema>;
+export type SnapshotBuildInitResponse = z.infer<typeof SnapshotBuildInitResponseSchema>;
+export type SnapshotBuildFinalizeParams = z.infer<typeof _SnapshotBuildFinalizeParamsSchema>;
+/**
+ * Initialize a snapshot build by getting a presigned upload URL.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including runtime and optional name/tag/description
+ * @returns Snapshot ID and presigned upload URL
+ * @throws {SandboxResponseError} If the initialization fails
+ */
+export declare function snapshotBuildInit(client: APIClient, params: SnapshotBuildInitParams): Promise<SnapshotBuildInitResponse>;
+/**
+ * Finalize a snapshot build after uploading the archive.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including snapshot details and file metadata
+ * @returns The created snapshot information
+ * @throws {SandboxResponseError} If the finalization fails
+ */
+export declare function snapshotBuildFinalize(client: APIClient, params: SnapshotBuildFinalizeParams): Promise<SnapshotInfo>;
+export {};
 //# sourceMappingURL=snapshot.d.ts.map

package/dist/api/sandbox/snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/api/sandbox/snapshot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAA8C,MAAM,QAAQ,CAAC;AAqD/E,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACpC,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAaD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CACnC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,oBAAoB,GAC1B,OAAO,CAAC,YAAY,CAAC,CA2BvB;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAChC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,iBAAiB,GACvB,OAAO,CAAC,YAAY,CAAC,CAevB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,SAAS,EACjB,MAAM,GAAE,kBAAuB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAe/B;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CACnC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,oBAAoB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAChC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,iBAAiB,GACvB,OAAO,CAAC,YAAY,CAAC,CAgBvB"}
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/api/sandbox/snapshot.ts"],"names":[],"mappings":"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"}

package/dist/api/sandbox/snapshot.js

@@ -34,6 +34,11 @@ const SnapshotInfoSchema = z
         .nullable()
         .optional()
         .describe('List of files in the snapshot'),
+    userMetadata: z
+        .record(z.string(), z.string())
+        .nullable()
+        .optional()
+        .describe('User-defined metadata key-value pairs'),
 })
     .describe('Detailed information about a snapshot');
 const SnapshotCreateResponseSchema = APIResponseSchema(SnapshotInfoSchema);
@@ -46,6 +51,42 @@ const SnapshotListDataSchema = z
     .describe('Paginated list of snapshots');
 const SnapshotListResponseSchema = APIResponseSchema(SnapshotListDataSchema);
 const SnapshotDeleteResponseSchema = APIResponseSchemaNoData();
+const _SnapshotCreateParamsSchema = z
+    .object({
+    sandboxId: z.string().describe('ID of the sandbox to snapshot'),
+    name: z.string().optional().describe('Display name for the snapshot'),
+    description: z.string().optional().describe('Description of the snapshot'),
+    tag: z.string().optional().describe('Tag for the snapshot'),
+    orgId: z.string().optional().describe('Organization ID'),
+})
+    .describe('Parameters for creating a snapshot');
+const _SnapshotGetParamsSchema = z
+    .object({
+    snapshotId: z.string().describe('ID of the snapshot to retrieve'),
+    orgId: z.string().optional().describe('Organization ID'),
+})
+    .describe('Parameters for getting a snapshot');
+const _SnapshotListParamsSchema = z
+    .object({
+    sandboxId: z.string().optional().describe('Filter by sandbox ID'),
+    limit: z.number().optional().describe('Maximum number of snapshots to return'),
+    offset: z.number().optional().describe('Number of snapshots to skip'),
+    orgId: z.string().optional().describe('Organization ID'),
+})
+    .describe('Parameters for listing snapshots');
+const _SnapshotDeleteParamsSchema = z
+    .object({
+    snapshotId: z.string().describe('ID of the snapshot to delete'),
+    orgId: z.string().optional().describe('Organization ID'),
+})
+    .describe('Parameters for deleting a snapshot');
+const _SnapshotTagParamsSchema = z
+    .object({
+    snapshotId: z.string().describe('ID of the snapshot to tag'),
+    tag: z.string().nullable().describe('New tag (or null to remove)'),
+    orgId: z.string().optional().describe('Organization ID'),
+})
+    .describe('Parameters for tagging a snapshot');
 function buildQueryString(params) {
     const query = new URLSearchParams();
     for (const [key, value] of Object.entries(params)) {
@@ -154,4 +195,109 @@ export async function snapshotTag(client, params) {
     }
     throw new SandboxResponseError({ message: resp.message });
 }
+// ===== Snapshot Build API =====
+const _SnapshotBuildInitParamsSchema = z
+    .object({
+    runtime: z.string().describe('Runtime identifier (name:tag or runtime ID)'),
+    name: z.string().optional().describe('Display name for the snapshot'),
+    tag: z.string().optional().describe('Tag for the snapshot'),
+    description: z.string().optional().describe('Description of the snapshot'),
+    contentHash: z.string().optional().describe('SHA-256 hash of snapshot content for change detection'),
+    force: z.boolean().optional().describe('Force rebuild even if content is unchanged'),
+    orgId: z.string().optional().describe('Organization ID'),
+})
+    .describe('Parameters for initializing a snapshot build');
+const SnapshotBuildInitResponseSchema = z
+    .object({
+    snapshotId: z.string().optional().describe('Unique identifier for the snapshot being built'),
+    uploadUrl: z.string().optional().describe('Pre-signed URL for uploading the snapshot archive'),
+    s3Key: z.string().optional().describe('S3 key where the snapshot will be stored'),
+    unchanged: z.boolean().optional().describe('True if snapshot content is unchanged'),
+    existingId: z.string().optional().describe('ID of existing unchanged snapshot'),
+    existingName: z.string().optional().describe('Name of existing unchanged snapshot'),
+    existingTag: z.string().optional().describe('Tag of existing unchanged snapshot'),
+})
+    .describe('Response from snapshot build init API');
+const SnapshotBuildInitAPIResponseSchema = APIResponseSchema(SnapshotBuildInitResponseSchema);
+const _SnapshotBuildFinalizeParamsSchema = z
+    .object({
+    snapshotId: z.string().describe('Snapshot ID from init response'),
+    sizeBytes: z.number().describe('Total size of the snapshot in bytes'),
+    fileCount: z.number().describe('Number of files in the snapshot'),
+    files: z
+        .array(SnapshotFileInfoSchema)
+        .describe('List of files with path and size'),
+    dependencies: z
+        .array(z.string())
+        .optional()
+        .describe('List of apt packages to install'),
+    env: z
+        .record(z.string(), z.string())
+        .optional()
+        .describe('Environment variables to set'),
+    metadata: z
+        .record(z.string(), z.string())
+        .optional()
+        .describe('User-defined metadata key-value pairs'),
+    orgId: z.string().optional().describe('Organization ID'),
+})
+    .describe('Parameters for finalizing a snapshot build');
+/**
+ * Initialize a snapshot build by getting a presigned upload URL.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including runtime and optional name/tag/description
+ * @returns Snapshot ID and presigned upload URL
+ * @throws {SandboxResponseError} If the initialization fails
+ */
+export async function snapshotBuildInit(client, params) {
+    const { runtime, name, description, tag, contentHash, force, orgId } = params;
+    const queryString = buildQueryString({ orgId });
+    const url = `/sandbox/${API_VERSION}/snapshots/build${queryString}`;
+    const body = { runtime };
+    if (name)
+        body.name = name;
+    if (description)
+        body.description = description;
+    if (tag)
+        body.tag = tag;
+    if (contentHash)
+        body.contentHash = contentHash;
+    if (force)
+        body.force = force;
+    const resp = await client.post(url, body, SnapshotBuildInitAPIResponseSchema);
+    if (resp.success) {
+        return resp.data;
+    }
+    throw new SandboxResponseError({ message: resp.message });
+}
+/**
+ * Finalize a snapshot build after uploading the archive.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including snapshot details and file metadata
+ * @returns The created snapshot information
+ * @throws {SandboxResponseError} If the finalization fails
+ */
+export async function snapshotBuildFinalize(client, params) {
+    const { snapshotId, sizeBytes, fileCount, files, dependencies, env, metadata, orgId } = params;
+    const queryString = buildQueryString({ orgId });
+    const url = `/sandbox/${API_VERSION}/snapshots/${snapshotId}/finalize${queryString}`;
+    const body = {
+        sizeBytes,
+        fileCount,
+        files,
+    };
+    if (dependencies)
+        body.dependencies = dependencies;
+    if (env)
+        body.env = env;
+    if (metadata)
+        body.metadata = metadata;
+    const resp = await client.post(url, body, SnapshotGetResponseSchema);
+    if (resp.success) {
+        return resp.data;
+    }
+    throw new SandboxResponseError({ message: resp.message });
+}
 //# sourceMappingURL=snapshot.js.map

package/dist/api/sandbox/snapshot.js.map

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

package/dist/config.js

@@ -26,7 +26,7 @@ export function getServiceUrls(region) {
     };
 }
 function getDomainSuffix(region) {
-    if (region === 'local') {
+    if (region === 'local' || region === 'l') {
         return 'agentuity.io';
     }
     return 'agentuity.cloud';

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAAe;IAC5C,MAAM,QAAQ,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IACxD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACd,mHAAmH,CACnH,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAe;IAC7C,MAAM,cAAc,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,YAAY,GACjB,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,gBAAgB,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;IAErF,OAAO;QACN,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,YAAY;QAC5D,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,gBAAgB,CAAC,cAAc,EAAE,SAAS,CAAC;QACvF,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,YAAY;QACxD,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,YAAY;QAC5D,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,gBAAgB,CAAC,cAAc,EAAE,MAAM,CAAC;QAChF,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,YAAY;KAC1D,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,MAAe;IACvC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACxB,OAAO,cAAc,CAAC;IACvB,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC1B,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAe,EAAE,QAAiB;IAC3D,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,MAAM,KAAK,cAAc,EAAE,CAAC;QAC/B,OAAO,WAAW,QAAQ,IAAI,MAAM,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,WAAW,QAAQ,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;AAClD,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAAe;IAC5C,MAAM,QAAQ,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IACxD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACd,mHAAmH,CACnH,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAe;IAC7C,MAAM,cAAc,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,YAAY,GACjB,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,gBAAgB,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;IAErF,OAAO;QACN,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,YAAY;QAC5D,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,gBAAgB,CAAC,cAAc,EAAE,SAAS,CAAC;QACvF,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,YAAY;QACxD,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,YAAY;QAC5D,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,gBAAgB,CAAC,cAAc,EAAE,MAAM,CAAC;QAChF,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,YAAY;KAC1D,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,MAAe;IACvC,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QAC1C,OAAO,cAAc,CAAC;IACvB,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC1B,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAe,EAAE,QAAiB;IAC3D,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,MAAM,KAAK,cAAc,EAAE,CAAC;QAC/B,OAAO,WAAW,QAAQ,IAAI,MAAM,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,WAAW,QAAQ,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;AAClD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agentuity/server",
-	"version": "0.1.10",
+	"version": "0.1.11",
 	"license": "Apache-2.0",
 	"author": "Agentuity employees and contributors",
 	"type": "module",
@@ -25,12 +25,12 @@
 		"prepublishOnly": "bun run clean && bun run build"
 	},
 	"dependencies": {
-		"@agentuity/core": "0.1.10",
-		"@agentuity/schema": "0.1.10",
+		"@agentuity/core": "0.1.11",
+		"@agentuity/schema": "0.1.11",
 		"zod": "^4.3.5"
 	},
 	"devDependencies": {
-		"@agentuity/test-utils": "0.1.10",
+		"@agentuity/test-utils": "0.1.11",
 		"@types/bun": "latest",
 		"@types/node": "^22.0.0",
 		"bun-types": "latest",

package/src/api/sandbox/index.ts

@@ -49,7 +49,15 @@ export type {
 	SetEnvParams,
 	SetEnvResult,
 } from './files';
-export { snapshotCreate, snapshotGet, snapshotList, snapshotDelete, snapshotTag } from './snapshot';
+export {
+	snapshotCreate,
+	snapshotGet,
+	snapshotList,
+	snapshotDelete,
+	snapshotTag,
+	snapshotBuildInit,
+	snapshotBuildFinalize,
+} from './snapshot';
 export type {
 	SnapshotInfo,
 	SnapshotFileInfo,
@@ -59,4 +67,9 @@ export type {
 	SnapshotListResponse,
 	SnapshotDeleteParams,
 	SnapshotTagParams,
+	SnapshotBuildInitParams,
+	SnapshotBuildInitResponse,
+	SnapshotBuildFinalizeParams,
 } from './snapshot';
+export { SnapshotBuildFileSchema } from './snapshot-build';
+export type { SnapshotBuildFile } from './snapshot-build';

package/src/api/sandbox/snapshot-build.ts

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+
+/**
+ * Base schema for snapshot build configuration file (agentuity-snapshot.yaml)
+ * This is the canonical schema - used for JSON Schema generation.
+ */
+export const SnapshotBuildFileBaseSchema = z
+	.object({
+		version: z.literal(1).describe('Schema version, must be 1'),
+		runtime: z
+			.string()
+			.describe('Runtime identifier (name:tag format, e.g., bun:1, node:20, python:3.12)'),
+		name: z
+			.string()
+			.regex(/^[a-zA-Z0-9_-]+$/)
+			.optional()
+			.describe('Snapshot name (alphanumeric, underscores, dashes only)'),
+		description: z.string().optional().describe('Human-readable description of the snapshot'),
+		dependencies: z
+			.array(z.string())
+			.optional()
+			.describe(
+				'List of apt packages to install. Supports version pinning: package=version or package=version* for prefix matching'
+			),
+		files: z
+			.array(z.string())
+			.optional()
+			.describe(
+				'Glob patterns for files to include from the build context. Supports negative patterns with ! prefix for exclusions'
+			),
+		env: z
+			.record(z.string(), z.string())
+			.optional()
+			.describe(
+				'Environment variables to set. Use ${VAR} syntax for build-time substitution via --env flag'
+			),
+		metadata: z
+			.record(z.string(), z.string())
+			.optional()
+			.describe(
+				'User-defined metadata key-value pairs. Use ${VAR} syntax for build-time substitution via --metadata flag'
+			),
+	})
+	.describe('Agentuity Snapshot Build File - defines a reproducible sandbox environment');
+
+/**
+ * Schema with validation refinement - use this for parsing/validation.
+ * Ensures at least one of dependencies, files, or env is specified.
+ */
+export const SnapshotBuildFileSchema = SnapshotBuildFileBaseSchema.refine(
+	(data) => {
+		const hasDependencies = data.dependencies && data.dependencies.length > 0;
+		const hasFiles = data.files && data.files.length > 0;
+		const hasEnv = data.env && Object.keys(data.env).length > 0;
+		return hasDependencies || hasFiles || hasEnv;
+	},
+	{
+		message: 'At least one of dependencies, files, or env must be specified',
+	}
+);
+
+export type SnapshotBuildFile = z.infer<typeof SnapshotBuildFileSchema>;

package/src/api/sandbox/snapshot.ts

@@ -38,6 +38,11 @@ const SnapshotInfoSchema = z
 			.nullable()
 			.optional()
 			.describe('List of files in the snapshot'),
+		userMetadata: z
+			.record(z.string(), z.string())
+			.nullable()
+			.optional()
+			.describe('User-defined metadata key-value pairs'),
 	})
 	.describe('Detailed information about a snapshot');
 
@@ -52,60 +57,56 @@ const SnapshotListDataSchema = z
 const SnapshotListResponseSchema = APIResponseSchema(SnapshotListDataSchema);
 const SnapshotDeleteResponseSchema = APIResponseSchemaNoData();
 
-export interface SnapshotFileInfo {
-	path: string;
-	size: number;
-}
-
-export interface SnapshotInfo {
-	snapshotId: string;
-	runtimeId?: string | null;
-	name: string;
-	description?: string | null;
-	tag?: string | null;
-	sizeBytes: number;
-	fileCount: number;
-	parentSnapshotId?: string | null;
-	createdAt: string;
-	downloadUrl?: string;
-	files?: SnapshotFileInfo[] | null;
-}
+export type SnapshotFileInfo = z.infer<typeof SnapshotFileInfoSchema>;
+export type SnapshotInfo = z.infer<typeof SnapshotInfoSchema>;
+export type SnapshotListResponse = z.infer<typeof SnapshotListDataSchema>;
 
-export interface SnapshotCreateParams {
-	sandboxId: string;
-	name?: string;
-	description?: string;
-	tag?: string;
-	orgId?: string;
-}
+const _SnapshotCreateParamsSchema = z
+	.object({
+		sandboxId: z.string().describe('ID of the sandbox to snapshot'),
+		name: z.string().optional().describe('Display name for the snapshot'),
+		description: z.string().optional().describe('Description of the snapshot'),
+		tag: z.string().optional().describe('Tag for the snapshot'),
+		orgId: z.string().optional().describe('Organization ID'),
+	})
+	.describe('Parameters for creating a snapshot');
 
-export interface SnapshotGetParams {
-	snapshotId: string;
-	orgId?: string;
-}
+const _SnapshotGetParamsSchema = z
+	.object({
+		snapshotId: z.string().describe('ID of the snapshot to retrieve'),
+		orgId: z.string().optional().describe('Organization ID'),
+	})
+	.describe('Parameters for getting a snapshot');
 
-export interface SnapshotListParams {
-	sandboxId?: string;
-	limit?: number;
-	offset?: number;
-	orgId?: string;
-}
+const _SnapshotListParamsSchema = z
+	.object({
+		sandboxId: z.string().optional().describe('Filter by sandbox ID'),
+		limit: z.number().optional().describe('Maximum number of snapshots to return'),
+		offset: z.number().optional().describe('Number of snapshots to skip'),
+		orgId: z.string().optional().describe('Organization ID'),
+	})
+	.describe('Parameters for listing snapshots');
 
-export interface SnapshotListResponse {
-	snapshots: SnapshotInfo[];
-	total: number;
-}
+const _SnapshotDeleteParamsSchema = z
+	.object({
+		snapshotId: z.string().describe('ID of the snapshot to delete'),
+		orgId: z.string().optional().describe('Organization ID'),
+	})
+	.describe('Parameters for deleting a snapshot');
 
-export interface SnapshotDeleteParams {
-	snapshotId: string;
-	orgId?: string;
-}
+const _SnapshotTagParamsSchema = z
+	.object({
+		snapshotId: z.string().describe('ID of the snapshot to tag'),
+		tag: z.string().nullable().describe('New tag (or null to remove)'),
+		orgId: z.string().optional().describe('Organization ID'),
+	})
+	.describe('Parameters for tagging a snapshot');
 
-export interface SnapshotTagParams {
-	snapshotId: string;
-	tag: string | null;
-	orgId?: string;
-}
+export type SnapshotCreateParams = z.infer<typeof _SnapshotCreateParamsSchema>;
+export type SnapshotGetParams = z.infer<typeof _SnapshotGetParamsSchema>;
+export type SnapshotListParams = z.infer<typeof _SnapshotListParamsSchema>;
+export type SnapshotDeleteParams = z.infer<typeof _SnapshotDeleteParamsSchema>;
+export type SnapshotTagParams = z.infer<typeof _SnapshotTagParamsSchema>;
 
 function buildQueryString(params: Record<string, string | number | undefined>): string {
 	const query = new URLSearchParams();
@@ -267,3 +268,133 @@ export async function snapshotTag(
 
 	throw new SandboxResponseError({ message: resp.message });
 }
+
+// ===== Snapshot Build API =====
+
+const _SnapshotBuildInitParamsSchema = z
+	.object({
+		runtime: z.string().describe('Runtime identifier (name:tag or runtime ID)'),
+		name: z.string().optional().describe('Display name for the snapshot'),
+		tag: z.string().optional().describe('Tag for the snapshot'),
+		description: z.string().optional().describe('Description of the snapshot'),
+		contentHash: z.string().optional().describe('SHA-256 hash of snapshot content for change detection'),
+		force: z.boolean().optional().describe('Force rebuild even if content is unchanged'),
+		orgId: z.string().optional().describe('Organization ID'),
+	})
+	.describe('Parameters for initializing a snapshot build');
+
+const SnapshotBuildInitResponseSchema = z
+	.object({
+		snapshotId: z.string().optional().describe('Unique identifier for the snapshot being built'),
+		uploadUrl: z.string().optional().describe('Pre-signed URL for uploading the snapshot archive'),
+		s3Key: z.string().optional().describe('S3 key where the snapshot will be stored'),
+		unchanged: z.boolean().optional().describe('True if snapshot content is unchanged'),
+		existingId: z.string().optional().describe('ID of existing unchanged snapshot'),
+		existingName: z.string().optional().describe('Name of existing unchanged snapshot'),
+		existingTag: z.string().optional().describe('Tag of existing unchanged snapshot'),
+	})
+	.describe('Response from snapshot build init API');
+
+const SnapshotBuildInitAPIResponseSchema = APIResponseSchema(SnapshotBuildInitResponseSchema);
+
+const _SnapshotBuildFinalizeParamsSchema = z
+	.object({
+		snapshotId: z.string().describe('Snapshot ID from init response'),
+		sizeBytes: z.number().describe('Total size of the snapshot in bytes'),
+		fileCount: z.number().describe('Number of files in the snapshot'),
+		files: z
+			.array(SnapshotFileInfoSchema)
+			.describe('List of files with path and size'),
+		dependencies: z
+			.array(z.string())
+			.optional()
+			.describe('List of apt packages to install'),
+		env: z
+			.record(z.string(), z.string())
+			.optional()
+			.describe('Environment variables to set'),
+		metadata: z
+			.record(z.string(), z.string())
+			.optional()
+			.describe('User-defined metadata key-value pairs'),
+		orgId: z.string().optional().describe('Organization ID'),
+	})
+	.describe('Parameters for finalizing a snapshot build');
+
+export type SnapshotBuildInitParams = z.infer<typeof _SnapshotBuildInitParamsSchema>;
+export type SnapshotBuildInitResponse = z.infer<typeof SnapshotBuildInitResponseSchema>;
+export type SnapshotBuildFinalizeParams = z.infer<typeof _SnapshotBuildFinalizeParamsSchema>;
+
+/**
+ * Initialize a snapshot build by getting a presigned upload URL.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including runtime and optional name/tag/description
+ * @returns Snapshot ID and presigned upload URL
+ * @throws {SandboxResponseError} If the initialization fails
+ */
+export async function snapshotBuildInit(
+	client: APIClient,
+	params: SnapshotBuildInitParams
+): Promise<SnapshotBuildInitResponse> {
+	const { runtime, name, description, tag, contentHash, force, orgId } = params;
+	const queryString = buildQueryString({ orgId });
+	const url = `/sandbox/${API_VERSION}/snapshots/build${queryString}`;
+
+	const body: Record<string, string | boolean> = { runtime };
+	if (name) body.name = name;
+	if (description) body.description = description;
+	if (tag) body.tag = tag;
+	if (contentHash) body.contentHash = contentHash;
+	if (force) body.force = force;
+
+	const resp = await client.post<z.infer<typeof SnapshotBuildInitAPIResponseSchema>>(
+		url,
+		body,
+		SnapshotBuildInitAPIResponseSchema
+	);
+
+	if (resp.success) {
+		return resp.data;
+	}
+
+	throw new SandboxResponseError({ message: resp.message });
+}
+
+/**
+ * Finalize a snapshot build after uploading the archive.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including snapshot details and file metadata
+ * @returns The created snapshot information
+ * @throws {SandboxResponseError} If the finalization fails
+ */
+export async function snapshotBuildFinalize(
+	client: APIClient,
+	params: SnapshotBuildFinalizeParams
+): Promise<SnapshotInfo> {
+	const { snapshotId, sizeBytes, fileCount, files, dependencies, env, metadata, orgId } = params;
+	const queryString = buildQueryString({ orgId });
+	const url = `/sandbox/${API_VERSION}/snapshots/${snapshotId}/finalize${queryString}`;
+
+	const body: Record<string, unknown> = {
+		sizeBytes,
+		fileCount,
+		files,
+	};
+	if (dependencies) body.dependencies = dependencies;
+	if (env) body.env = env;
+	if (metadata) body.metadata = metadata;
+
+	const resp = await client.post<z.infer<typeof SnapshotGetResponseSchema>>(
+		url,
+		body,
+		SnapshotGetResponseSchema
+	);
+
+	if (resp.success) {
+		return resp.data;
+	}
+
+	throw new SandboxResponseError({ message: resp.message });
+}

package/src/config.ts

@@ -41,7 +41,7 @@ export function getServiceUrls(region?: string): ServiceUrls {
 }
 
 function getDomainSuffix(region?: string) {
-	if (region === 'local') {
+	if (region === 'local' || region === 'l') {
 		return 'agentuity.io';
 	}
 	return 'agentuity.cloud';