@agentuity/core 1.0.31 → 1.0.33

package/dist/api/sandbox/runtime.js

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+import { APIResponseSchema } from "../api.js";
+import { throwSandboxError } from "./util.js";
+export const RuntimeRequirementsSchema = z
+    .object({
+    memory: z.string().optional().describe('Memory requirement (e.g., "1Gi")'),
+    cpu: z.string().optional().describe('CPU requirement (e.g., "1")'),
+    disk: z.string().optional().describe('Disk requirement (e.g., "500Mi")'),
+    networkEnabled: z.boolean().describe('Whether network access is enabled'),
+})
+    .describe('Runtime resource requirements');
+export const RuntimeInfoSchema = z
+    .object({
+    id: z.string().describe('Unique runtime identifier'),
+    name: z.string().describe('Runtime name (e.g., "bun:1", "python:3.14")'),
+    description: z.string().optional().describe('Optional description'),
+    iconUrl: z.string().optional().describe('URL for runtime icon'),
+    brandColor: z.string().optional().describe('Brand color for the runtime (hex color code)'),
+    url: z.string().optional().describe('URL for runtime documentation or homepage'),
+    tags: z.array(z.string()).optional().describe('Optional tags for categorization'),
+    requirements: RuntimeRequirementsSchema.optional().describe('Runtime resource requirements'),
+    readme: z.string().optional().describe('Readme content in markdown format'),
+})
+    .describe('Information about a sandbox runtime');
+export const ListRuntimesDataSchema = z
+    .object({
+    runtimes: z.array(RuntimeInfoSchema).describe('List of runtime entries'),
+    total: z.number().describe('Total number of runtimes'),
+})
+    .describe('List of sandbox runtimes');
+export const ListRuntimesResponseSchema = APIResponseSchema(ListRuntimesDataSchema);
+/**
+ * Lists available sandbox runtimes with optional pagination.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Optional parameters for pagination
+ * @returns List of runtimes with total count
+ * @throws {SandboxResponseError} If the request fails
+ */
+export async function runtimeList(client, params) {
+    const queryParams = new URLSearchParams();
+    if (params?.orgId) {
+        queryParams.set('orgId', params.orgId);
+    }
+    if (params?.limit !== undefined) {
+        queryParams.set('limit', params.limit.toString());
+    }
+    if (params?.offset !== undefined) {
+        queryParams.set('offset', params.offset.toString());
+    }
+    if (params?.sort) {
+        queryParams.set('sort', params.sort);
+    }
+    if (params?.direction) {
+        queryParams.set('direction', params.direction);
+    }
+    const queryString = queryParams.toString();
+    const url = `/sandbox/runtimes${queryString ? `?${queryString}` : ''}`;
+    const resp = await client.get(url, ListRuntimesResponseSchema);
+    if (resp.success) {
+        return {
+            runtimes: resp.data.runtimes.map((r) => ({
+                id: r.id,
+                name: r.name,
+                description: r.description,
+                iconUrl: r.iconUrl,
+                brandColor: r.brandColor,
+                url: r.url,
+                tags: r.tags,
+                requirements: r.requirements,
+                readme: r.readme,
+            })),
+            total: resp.data.total,
+        };
+    }
+    throwSandboxError(resp, {});
+}
+//# sourceMappingURL=runtime.js.map

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

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

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

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+/**
+ * Regex pattern for validating npm/bun package specifiers.
+ * Uses a blocklist approach: rejects shell injection characters while allowing
+ * all legitimate specifier formats (names, scoped packages, URLs, git refs, etc.).
+ *
+ * Valid examples: "typescript", "@types/node", "opencode-ai@1.2.3",
+ *   "https://github.com/user/repo", "git+https://github.com/user/repo.git",
+ *   "github:user/repo", "file:../local-pkg"
+ * Invalid examples: "foo bar", "pkg;rm -rf", "pkg|cat /etc/passwd", "$(evil)"
+ */
+export declare const NPM_PACKAGE_NAME_PATTERN: RegExp;
+/**
+ * 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>;
+    dir: z.ZodOptional<z.ZodString>;
+    dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    packages: 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>>;
+    public: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Schema with validation refinement - use this for parsing/validation.
+ * Ensures at least one of dependencies, files, env, or packages 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>;
+    dir: z.ZodOptional<z.ZodString>;
+    dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    packages: 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>>;
+    public: z.ZodOptional<z.ZodBoolean>;
+}, 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;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,QAAiB,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;iBAwDgD,CAAC;AAEzF;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;iBAWnC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

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

@@ -0,0 +1,72 @@
+import { z } from 'zod';
+/**
+ * Regex pattern for validating npm/bun package specifiers.
+ * Uses a blocklist approach: rejects shell injection characters while allowing
+ * all legitimate specifier formats (names, scoped packages, URLs, git refs, etc.).
+ *
+ * Valid examples: "typescript", "@types/node", "opencode-ai@1.2.3",
+ *   "https://github.com/user/repo", "git+https://github.com/user/repo.git",
+ *   "github:user/repo", "file:../local-pkg"
+ * Invalid examples: "foo bar", "pkg;rm -rf", "pkg|cat /etc/passwd", "$(evil)"
+ */
+export const NPM_PACKAGE_NAME_PATTERN = /^[^\s;`|$]+$/;
+/**
+ * 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'),
+    dir: z
+        .string()
+        .optional()
+        .describe('Subdirectory to use as the build context for file resolution (relative to the CLI directory argument)'),
+    dependencies: z
+        .array(z.string())
+        .optional()
+        .describe('List of apt packages to install. Supports version pinning: package=version or package=version* for prefix matching'),
+    packages: z
+        .array(z
+        .string()
+        .regex(NPM_PACKAGE_NAME_PATTERN, 'Invalid npm/bun package specifier: must not contain whitespace, semicolons, backticks, pipes, or dollar signs'))
+        .optional()
+        .describe('List of npm/bun packages to install globally via bun install -g. Example: opencode-ai, typescript'),
+    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(
+    // biome-ignore lint/suspicious/noTemplateCurlyInString: describes the ${VAR} substitution syntax for users
+    'Environment variables to set. Use ${VAR} syntax for build-time substitution via --env flag'),
+    metadata: z.record(z.string(), z.string()).optional().describe(
+    // biome-ignore lint/suspicious/noTemplateCurlyInString: describes the ${VAR} substitution syntax for users
+    'User-defined metadata key-value pairs. Use ${VAR} syntax for build-time substitution via --metadata flag'),
+    public: z
+        .boolean()
+        .optional()
+        .describe('Whether to make the snapshot publicly accessible (default: false)'),
+})
+    .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, env, or packages 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;
+    const hasPackages = data.packages && data.packages.length > 0;
+    return hasDependencies || hasFiles || hasEnv || hasPackages;
+}, {
+    message: 'At least one of dependencies, files, env, or packages 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;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,cAAc,CAAC;AAEvD;;;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,GAAG,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACR,uGAAuG,CACvG;IACF,YAAY,EAAE,CAAC;SACb,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CACR,oHAAoH,CACpH;IACF,QAAQ,EAAE,CAAC;SACT,KAAK,CACL,CAAC;SACC,MAAM,EAAE;SACR,KAAK,CACL,wBAAwB,EACxB,+GAA+G,CAC/G,CACF;SACA,QAAQ,EAAE;SACV,QAAQ,CACR,mGAAmG,CACnG;IACF,KAAK,EAAE,CAAC;SACN,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CACR,oHAAoH,CACpH;IACF,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ;IACxD,2GAA2G;IAC3G,4FAA4F,CAC5F;IACD,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ;IAC7D,2GAA2G;IAC3G,0GAA0G,CAC1G;IACD,MAAM,EAAE,CAAC;SACP,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,mEAAmE,CAAC;CAC/E,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,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9D,OAAO,eAAe,IAAI,QAAQ,IAAI,MAAM,IAAI,WAAW,CAAC;AAC7D,CAAC,EACD;IACC,OAAO,EAAE,yEAAyE;CAClF,CACD,CAAC"}