@lakitu/sdk 0.1.45 → 0.1.46

package/dist/sdk/template.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Template Configuration Module
+ *
+ * Type helpers for customizing the E2B sandbox template.
+ *
+ * @example
+ * ```typescript
+ * // convex/lakitu/template.config.ts
+ * import { defineTemplate } from '@lakitu/sdk/template';
+ *
+ * export default defineTemplate({
+ *   packages: {
+ *     apt: ["ffmpeg", "imagemagick"],
+ *     pip: ["pandas", "numpy"],
+ *     npm: ["sharp"],
+ *   },
+ *   services: ["redis"],
+ *   setup: ["pip install -r requirements.txt"],
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+/**
+ * Template configuration for customizing sandbox packages and services.
+ */
+export interface TemplateConfig {
+    /**
+     * Packages to install in the sandbox.
+     */
+    packages?: {
+        /** APT packages (Ubuntu) */
+        apt?: string[];
+        /** Python packages via pip */
+        pip?: string[];
+        /** Node.js packages via npm */
+        npm?: string[];
+    };
+    /**
+     * Services to pre-start in the sandbox.
+     * Currently supported: "redis", "postgres"
+     */
+    services?: ("redis" | "postgres" | string)[];
+    /**
+     * Custom setup commands to run after package installation.
+     * These run as the user (not root).
+     */
+    setup?: string[];
+    /**
+     * Environment variables to set in the sandbox.
+     */
+    env?: Record<string, string>;
+    /**
+     * Files to copy into the sandbox.
+     * Key is destination path, value is source path (relative to project root).
+     */
+    files?: Record<string, string>;
+}
+/**
+ * Define a template configuration with type checking.
+ *
+ * @param config - Template configuration object
+ * @returns The same config object (for type inference)
+ *
+ * @example
+ * ```typescript
+ * import { defineTemplate } from '@lakitu/sdk/template';
+ *
+ * export default defineTemplate({
+ *   packages: {
+ *     apt: ["ffmpeg"],
+ *     pip: ["opencv-python"],
+ *   },
+ *   setup: [
+ *     "pip install -r requirements.txt",
+ *   ],
+ * });
+ * ```
+ */
+export declare function defineTemplate(config: TemplateConfig): TemplateConfig;
+/**
+ * Default template configuration (empty - no customizations).
+ */
+export declare const DEFAULT_TEMPLATE_CONFIG: TemplateConfig;
+/**
+ * Merge two template configs, with the second taking precedence.
+ */
+export declare function mergeTemplateConfigs(base: TemplateConfig, override: TemplateConfig): TemplateConfig;
+//# sourceMappingURL=template.d.ts.map

package/dist/sdk/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../sdk/template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,CAAC,EAAE;QACT,4BAA4B;QAC5B,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;QACf,8BAA8B;QAC9B,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;QACf,+BAA+B;QAC/B,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;IAEF;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC,EAAE,CAAC;IAE7C;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAErE;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,cAUrC,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,cAAc,GACvB,cAAc,CAYhB"}

package/dist/sdk/template.js

@@ -0,0 +1,77 @@
+/**
+ * Template Configuration Module
+ *
+ * Type helpers for customizing the E2B sandbox template.
+ *
+ * @example
+ * ```typescript
+ * // convex/lakitu/template.config.ts
+ * import { defineTemplate } from '@lakitu/sdk/template';
+ *
+ * export default defineTemplate({
+ *   packages: {
+ *     apt: ["ffmpeg", "imagemagick"],
+ *     pip: ["pandas", "numpy"],
+ *     npm: ["sharp"],
+ *   },
+ *   services: ["redis"],
+ *   setup: ["pip install -r requirements.txt"],
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+/**
+ * Define a template configuration with type checking.
+ *
+ * @param config - Template configuration object
+ * @returns The same config object (for type inference)
+ *
+ * @example
+ * ```typescript
+ * import { defineTemplate } from '@lakitu/sdk/template';
+ *
+ * export default defineTemplate({
+ *   packages: {
+ *     apt: ["ffmpeg"],
+ *     pip: ["opencv-python"],
+ *   },
+ *   setup: [
+ *     "pip install -r requirements.txt",
+ *   ],
+ * });
+ * ```
+ */
+export function defineTemplate(config) {
+    return config;
+}
+/**
+ * Default template configuration (empty - no customizations).
+ */
+export const DEFAULT_TEMPLATE_CONFIG = {
+    packages: {
+        apt: [],
+        pip: [],
+        npm: [],
+    },
+    services: [],
+    setup: [],
+    env: {},
+    files: {},
+};
+/**
+ * Merge two template configs, with the second taking precedence.
+ */
+export function mergeTemplateConfigs(base, override) {
+    return {
+        packages: {
+            apt: [...(base.packages?.apt || []), ...(override.packages?.apt || [])],
+            pip: [...(base.packages?.pip || []), ...(override.packages?.pip || [])],
+            npm: [...(base.packages?.npm || []), ...(override.packages?.npm || [])],
+        },
+        services: [...(base.services || []), ...(override.services || [])],
+        setup: [...(base.setup || []), ...(override.setup || [])],
+        env: { ...(base.env || {}), ...(override.env || {}) },
+        files: { ...(base.files || {}), ...(override.files || {}) },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lakitu/sdk",
-  "version": "0.1.45",
+  "version": "0.1.46",
   "description": "Self-hosted AI agent framework for Convex + E2B with code execution",
   "type": "module",
   "main": "./dist/sdk/index.js",