@framers/agentos 0.1.113 → 0.1.114

package/dist/config/AgentOSConfig.js

@@ -25,7 +25,10 @@ export function validateEnvironmentConfig(env) {
         errors.push('Missing required environment variable: DATABASE_URL');
     }
     // Warnings for missing optional but recommended variables
-    if (!env.OPENAI_API_KEY && !env.ANTHROPIC_API_KEY && !env.OPENROUTER_API_KEY && !env.OLLAMA_BASE_URL) {
+    if (!env.OPENAI_API_KEY &&
+        !env.ANTHROPIC_API_KEY &&
+        !env.OPENROUTER_API_KEY &&
+        !env.OLLAMA_BASE_URL) {
         warnings.push('No LLM provider API keys configured. AgentOS will have limited functionality.');
     }
     if (!env.DEFAULT_PERSONA_ID) {
@@ -34,7 +37,7 @@ export function validateEnvironmentConfig(env) {
     return {
         isValid: errors.length === 0,
         errors,
-        warnings
+        warnings,
     };
 }
 /**
@@ -62,18 +65,21 @@ export function getEnvironmentConfig() {
         ENABLE_PERSISTENCE: process.env.ENABLE_PERSISTENCE || 'true',
         ENABLE_UTILITY_AI: process.env.ENABLE_UTILITY_AI || 'false',
         MAX_CONCURRENT_STREAMS: process.env.MAX_CONCURRENT_STREAMS || '1000',
-        MAX_TOOL_CALL_ITERATIONS: process.env.MAX_TOOL_CALL_ITERATIONS || '5'
+        MAX_TOOL_CALL_ITERATIONS: process.env.MAX_TOOL_CALL_ITERATIONS || '5',
     };
     const validation = validateEnvironmentConfig(env);
     // Log warnings
     if (validation.warnings.length > 0) {
         console.warn('AgentOS Configuration Warnings:');
-        validation.warnings.forEach(warning => console.warn(`  - ${warning}`));
+        validation.warnings.forEach((warning) => console.warn(`  - ${warning}`));
     }
     // Throw error if validation fails
     if (!validation.isValid) {
-        const errorMessage = `AgentOS Configuration Errors:\n${validation.errors.map(e => `  - ${e}`).join('\n')}`;
-        throw new GMIError(errorMessage, GMIErrorCode.CONFIGURATION_ERROR, { errors: validation.errors, warnings: validation.warnings });
+        const errorMessage = `AgentOS Configuration Errors:\n${validation.errors.map((e) => `  - ${e}`).join('\n')}`;
+        throw new GMIError(errorMessage, GMIErrorCode.CONFIGURATION_ERROR, {
+            errors: validation.errors,
+            warnings: validation.warnings,
+        });
     }
     return env;
 }
@@ -114,8 +120,8 @@ function createModelProviderManagerConfig(env) {
                 baseURL: 'https://api.openai.com/v1',
                 defaultModel: 'gpt-4o',
                 maxRetries: 3,
-                timeout: 60000
-            }
+                timeout: 60000,
+            },
         });
     }
     // OpenRouter Provider
@@ -129,8 +135,8 @@ function createModelProviderManagerConfig(env) {
                 baseURL: 'https://openrouter.ai/api/v1',
                 defaultModel: 'openai/gpt-4o',
                 maxRetries: 3,
-                timeout: 60000
-            }
+                timeout: 60000,
+            },
         });
     }
     // Ollama Provider (local)
@@ -142,12 +148,12 @@ function createModelProviderManagerConfig(env) {
             config: {
                 baseURL: env.OLLAMA_BASE_URL,
                 defaultModel: 'llama3.2',
-                timeout: 120000 // Longer timeout for local models
-            }
+                timeout: 120000, // Longer timeout for local models
+            },
         });
     }
     // Ensure at least one provider is marked as default
-    if (providers.length > 0 && !providers.some(p => p.isDefault)) {
+    if (providers.length > 0 && !providers.some((p) => p.isDefault)) {
         providers[0].isDefault = true;
     }
     return { providers };
@@ -158,9 +164,13 @@ function createModelProviderManagerConfig(env) {
  */
 function _createLemonSqueezyService(_env) {
     return {
-        initialize: async () => { },
+        initialize: async () => {
+            /* implementation */
+        },
         verifyWebhookSignature: (_rawBody, _signature) => true,
-        processWebhookEvent: async (_eventName, _data) => { }
+        processWebhookEvent: async (_eventName, _data) => {
+            /* implementation */
+        },
     };
 }
 /**
@@ -182,10 +192,11 @@ async function createUtilityAIService(env) {
 /**
  * Main function to create the complete AgentOS configuration.
  *
+ * @param options - Optional runtime tool inputs to apply to the generated config.
  * @returns Promise resolving to a complete AgentOSConfig
  * @throws GMIError if configuration creation fails
  */
-export async function createAgentOSConfig() {
+export async function createAgentOSConfig(options = {}) {
     console.log('AgentOS Config: Starting configuration creation...');
     try {
         // Load and validate environment
@@ -203,13 +214,13 @@ export async function createAgentOSConfig() {
             defaultWorkingMemoryType: 'in_memory',
             defaultGMIBaseConfigDefaults: {
                 defaultLlmProviderId: 'openai',
-                defaultLlmModelId: 'gpt-4o'
-            }
+                defaultLlmModelId: 'gpt-4o',
+            },
         };
         const orchestratorConfig = {
             maxToolCallIterations: parseInt(env.MAX_TOOL_CALL_ITERATIONS || '5'),
             defaultAgentTurnTimeoutMs: 120000,
-            enableConversationalPersistence: env.ENABLE_PERSISTENCE === 'true'
+            enableConversationalPersistence: env.ENABLE_PERSISTENCE === 'true',
         };
         const promptEngineConfig = {
             defaultTemplateName: 'openai_chat',
@@ -248,18 +259,21 @@ export async function createAgentOSConfig() {
             globalDisabledTools: [],
             toolRegistrySettings: {
                 allowDynamicRegistration: true,
-                persistRegistry: false
-            }
+                persistRegistry: false,
+            },
         };
         const toolPermissionManagerConfig = {
             strictCapabilityChecking: true,
             logToolCalls: env.NODE_ENV === 'development',
             toolToSubscriptionFeatures: {
                 // Example: map specific tools to subscription features
-                'advanced_search_tool': [
-                    { flag: 'FEATURE_ADVANCED_SEARCH', description: 'Access to advanced search capabilities' }
-                ]
-            }
+                advanced_search_tool: [
+                    {
+                        flag: 'FEATURE_ADVANCED_SEARCH',
+                        description: 'Access to advanced search capabilities',
+                    },
+                ],
+            },
         };
         const turnPlanning = {
             enabled: true,
@@ -286,13 +300,13 @@ export async function createAgentOSConfig() {
             },
             maxActiveConversationsInMemory: 1000,
             inactivityTimeoutMs: 3600000,
-            persistenceEnabled: env.ENABLE_PERSISTENCE === 'true'
+            persistenceEnabled: env.ENABLE_PERSISTENCE === 'true',
         };
         const streamingManagerConfig = {
             maxConcurrentStreams: parseInt(env.MAX_CONCURRENT_STREAMS || '1000'),
             defaultStreamInactivityTimeoutMs: 300000, // 5 minutes
             maxClientsPerStream: 10,
-            onClientSendErrorBehavior: 'log_and_continue'
+            onClientSendErrorBehavior: 'log_and_continue',
         };
         const modelProviderManagerConfig = createModelProviderManagerConfig(env);
         // Assemble final configuration
@@ -319,6 +333,8 @@ export async function createAgentOSConfig() {
             utilityAIService,
             turnPlanning,
             extensionSecrets: Object.keys(extensionSecrets).length ? extensionSecrets : undefined,
+            ...(options.tools ? { tools: options.tools } : {}),
+            ...(options.externalTools ? { externalTools: options.externalTools } : {}),
         };
         console.log('AgentOS Config: Configuration created successfully');
         console.log(`AgentOS Config: Environment: ${env.NODE_ENV}`);
@@ -339,13 +355,14 @@ export async function createAgentOSConfig() {
  * Helper function to create a test configuration for development/testing.
  * This bypasses some environment requirements and uses sensible defaults.
  *
+ * @param options - Optional runtime tool inputs to apply to the generated config.
  * @returns Promise resolving to a test AgentOSConfig
  */
-export async function createTestAgentOSConfig() {
+export async function createTestAgentOSConfig(options = {}) {
     // Set minimal test environment
     if (!process.env.DATABASE_URL) {
         process.env.DATABASE_URL = 'file:./test.db';
     }
-    return createAgentOSConfig();
+    return createAgentOSConfig(options);
 }
 //# sourceMappingURL=AgentOSConfig.js.map

package/dist/config/AgentOSConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"AgentOSConfig.js","sourceRoot":"","sources":["../../src/config/AgentOSConfig.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAe9C,6BAA6B;AAC7B,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AA+CvE;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,GAA+B;IACvE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,qBAAqB;IACrB,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;IACrE,CAAC;IAED,0DAA0D;IAC1D,IAAI,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,GAAG,CAAC,kBAAkB,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QACrG,QAAQ,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;IACjG,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC5B,MAAM;QACN,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,GAAG,GAA+B;QACtC,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY;QACtC,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB;QAC9C,oBAAoB,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB;QACtD,mBAAmB,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB;QACpD,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;QAC1C,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAChD,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB;QAClD,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,wBAAwB;QACxE,oBAAoB,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB;QACtD,2BAA2B,EAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B;QACpE,qBAAqB,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB;QACxD,0EAA0E;QAC1E,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,cAAc;QACpE,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,aAAa;QAC/C,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,MAAM;QAC5D,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO;QAC3D,sBAAsB,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,MAAM;QACpE,wBAAwB,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,GAAG;KACtE,CAAC;IAEF,MAAM,UAAU,GAAG,yBAAyB,CAAC,GAAG,CAAC,CAAC;IAElD,eAAe;IACf,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAChD,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,kCAAkC;IAClC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,YAAY,GAAG,kCAAkC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3G,MAAM,IAAI,QAAQ,CAChB,YAAY,EACZ,YAAY,CAAC,mBAAmB,EAChC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAC7D,CAAC;IACJ,CAAC;IAED,OAAO,GAAwB,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,SAAS,yBAAyB,CAAC,GAAsB;IACvD,OAAO;QACL,aAAa,EAAE,YAAY;QAC3B,UAAU,EAAE,aAAa;QACzB,OAAO,EAAE;YACP,kBAAkB,EAAE,GAAG,CAAC,QAAQ,KAAK,aAAa;YAClD,eAAe,EAAE,QAAQ;YACzB,gBAAgB,EAAE,GAAG,CAAC,kBAAkB,IAAI,cAAc;YAC1D,uBAAuB,EAAE,IAAI;SAC9B;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,gCAAgC,CAAC,GAAsB;IAC9D,MAAM,SAAS,GAA0B,EAAE,CAAC;IAE5C,kBAAkB;IAClB,IAAI,GAAG,CAAC,cAAc,EAAE,CAAC;QACvB,SAAS,CAAC,IAAI,CAAC;YACb,UAAU,EAAE,QAAQ;YACpB,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI,EAAE,mCAAmC;YACpD,MAAM,EAAE;gBACN,MAAM,EAAE,GAAG,CAAC,cAAc;gBAC1B,OAAO,EAAE,2BAA2B;gBACpC,YAAY,EAAE,QAAQ;gBACtB,UAAU,EAAE,CAAC;gBACb,OAAO,EAAE,KAAK;aACf;SACF,CAAC,CAAC;IACL,CAAC;IAED,sBAAsB;IACtB,IAAI,GAAG,CAAC,kBAAkB,EAAE,CAAC;QAC3B,SAAS,CAAC,IAAI,CAAC;YACb,UAAU,EAAE,YAAY;YACxB,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,CAAC,GAAG,CAAC,cAAc,EAAE,gDAAgD;YAChF,MAAM,EAAE;gBACN,MAAM,EAAE,GAAG,CAAC,kBAAkB;gBAC9B,OAAO,EAAE,8BAA8B;gBACvC,YAAY,EAAE,eAAe;gBAC7B,UAAU,EAAE,CAAC;gBACb,OAAO,EAAE,KAAK;aACf;SACF,CAAC,CAAC;IACL,CAAC;IAED,0BAA0B;IAC1B,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;QACxB,SAAS,CAAC,IAAI,CAAC;YACb,UAAU,EAAE,QAAQ;YACpB,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,GAAG,CAAC,kBAAkB;YACzD,MAAM,EAAE;gBACN,OAAO,EAAE,GAAG,CAAC,eAAe;gBAC5B,YAAY,EAAE,UAAU;gBACxB,OAAO,EAAE,MAAM,CAAC,kCAAkC;aACnD;SACF,CAAC,CAAC;IACL,CAAC;IAED,oDAAoD;IACpD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9D,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC;IAChC,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,SAAS,0BAA0B,CAAC,IAAuB;IACzD,OAAO;QACL,UAAU,EAAE,KAAK,IAAI,EAAE,GAAwB,CAAC;QAChD,sBAAsB,EAAE,CAAC,QAAgB,EAAE,UAAkB,EAAE,EAAE,CAAC,IAAI;QACtE,mBAAmB,EAAE,KAAK,EAAE,UAAkB,EAAE,KAAU,EAAE,EAAE,GAAwB,CAAC;KACxF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,sBAAsB,CAAC,GAAsB;IAC1D,IAAI,GAAG,CAAC,iBAAiB,KAAK,MAAM,EAAE,CAAC;QACrC,yCAAyC;QACzC,gDAAgD;QAChD,uCAAuC;QACvC,oBAAoB;IACtB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;IAElE,IAAI,CAAC;QACH,gCAAgC;QAChC,MAAM,GAAG,GAAG,oBAAoB,EAAE,CAAC;QAEnC,uBAAuB;QACvB,MAAM,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;QAE9D,MAAM,gBAAgB,GAAG,GAAG,CAAC,kBAAkB,IAAI,cAAc,CAAC;QAElE,iCAAiC;QACjC,MAAM,gBAAgB,GAAG,MAAM,sBAAsB,CAAC,GAAG,CAAC,CAAC;QAE3D,6CAA6C;QAC7C,MAAM,gBAAgB,GAAqB;YACzC,mBAAmB,EAAE,yBAAyB,CAAC,GAAG,CAAC;YACnD,kCAAkC,EAAE,EAAE;YACtC,wBAAwB,EAAE,WAAW;YACrC,4BAA4B,EAAE;gBAC5B,oBAAoB,EAAE,QAAQ;gBAC9B,iBAAiB,EAAE,QAAQ;aAC5B;SACF,CAAC;QAEF,MAAM,kBAAkB,GAA8B;YACpD,qBAAqB,EAAE,QAAQ,CAAC,GAAG,CAAC,wBAAwB,IAAI,GAAG,CAAC;YACpE,yBAAyB,EAAE,MAAM;YACjC,+BAA+B,EAAE,GAAG,CAAC,kBAAkB,KAAK,MAAM;SACnE,CAAC;QAEF,MAAM,kBAAkB,GAAuB;YAC7C,mBAAmB,EAAE,aAAa;YAClC,kBAAkB,EAAE,EAAE;YACtB,aAAa,EAAE;gBACb,QAAQ,EAAE,WAAW;gBACrB,eAAe,EAAE,eAAe;aACjC;YACD,iBAAiB,EAAE;gBACjB,kBAAkB,EAAE,EAAE;gBACtB,mBAAmB,EAAE,IAAI;gBACzB,yBAAyB,EAAE,GAAG;gBAC9B,yBAAyB,EAAE,IAAI;aAChC;YACD,iBAAiB,EAAE;gBACjB,mBAAmB,EAAE,IAAI;gBACzB,wBAAwB,EAAE,UAAU;gBACpC,kCAAkC,EAAE,IAAI;aACzC;YACD,0BAA0B,EAAE;gBAC1B,kBAAkB,EAAE,EAAE;gBACtB,yBAAyB,EAAE,CAAC;gBAC5B,0BAA0B,EAAE,eAAe;gBAC3C,0BAA0B,EAAE,kBAAkB;aAC/C;YACD,WAAW,EAAE;gBACX,aAAa,EAAE,IAAI;gBACnB,mBAAmB,EAAE,GAAG;aACzB;SACF,CAAC;QAEF,MAAM,sBAAsB,GAA2B;YACrD,cAAc,EAAE,2BAA2B;YAC3C,wBAAwB,EAAE,KAAK;YAC/B,sBAAsB,EAAE,EAAE;YAC1B,YAAY,EAAE,GAAG,CAAC,QAAQ,KAAK,aAAa;YAC5C,mBAAmB,EAAE,EAAE;YACvB,oBAAoB,EAAE;gBACpB,wBAAwB,EAAE,IAAI;gBAC9B,eAAe,EAAE,KAAK;aACvB;SACF,CAAC;QAEF,MAAM,2BAA2B,GAAgC;YAC/D,wBAAwB,EAAE,IAAI;YAC9B,YAAY,EAAE,GAAG,CAAC,QAAQ,KAAK,aAAa;YAC5C,0BAA0B,EAAE;gBAC1B,uDAAuD;gBACvD,sBAAsB,EAAE;oBACtB,EAAE,IAAI,EAAE,yBAAyB,EAAE,WAAW,EAAE,wCAAwC,EAAE;iBAC3F;aACF;SACF,CAAC;QAEF,MAAM,YAAY,GAAG;YACnB,OAAO,EAAE,IAAI;YACb,sBAAsB,EAAE,WAAoB;YAC5C,qBAAqB,EAAE,IAAI;YAC3B,SAAS,EAAE;gBACT,OAAO,EAAE,IAAI;gBACb,oBAAoB,EAAE,IAAI;gBAC1B,gBAAgB,EAAE,IAAI;gBACtB,aAAa,EAAE,IAAI;gBACnB,WAAW,EAAE,KAAc;gBAC3B,oBAAoB,EAAE,IAAI;gBAC1B,wBAAwB,EAAE,YAAqB;gBAC/C,UAAU,EAAE,CAAC;gBACb,cAAc,EAAE,GAAG;aACpB;SACF,CAAC;QAEF,MAAM,yBAAyB,GAA8B;YAC3D,gCAAgC,EAAE;gBAChC,wBAAwB,EAAE,GAAG;gBAC7B,4BAA4B,EAAE,IAAI;gBAClC,0BAA0B,EAAE,CAAC;gBAC7B,0BAA0B,EAAE,CAAC;aAC9B;YACD,8BAA8B,EAAE,IAAI;YACpC,mBAAmB,EAAE,OAAO;YAC5B,kBAAkB,EAAE,GAAG,CAAC,kBAAkB,KAAK,MAAM;SACtD,CAAC;QAEF,MAAM,sBAAsB,GAA2B;YACrD,oBAAoB,EAAE,QAAQ,CAAC,GAAG,CAAC,sBAAsB,IAAI,MAAM,CAAC;YACpE,gCAAgC,EAAE,MAAM,EAAE,YAAY;YACtD,mBAAmB,EAAE,EAAE;YACvB,yBAAyB,EAAE,kBAAkB;SAC9C,CAAC;QAEF,MAAM,0BAA0B,GAAG,gCAAgC,CAAC,GAAG,CAAC,CAAC;QAEzE,+BAA+B;QAC/B,MAAM,gBAAgB,GAA2B,EAAE,CAAC;QACpD,IAAI,GAAG,CAAC,cAAc;YAAE,gBAAgB,CAAC,eAAe,CAAC,GAAG,GAAG,CAAC,cAAc,CAAC;QAC/E,IAAI,GAAG,CAAC,kBAAkB;YAAE,gBAAgB,CAAC,mBAAmB,CAAC,GAAG,GAAG,CAAC,kBAAkB,CAAC;QAC3F,IAAI,GAAG,CAAC,iBAAiB;YAAE,gBAAgB,CAAC,kBAAkB,CAAC,GAAG,GAAG,CAAC,iBAAiB,CAAC;QACxF,IAAI,GAAG,CAAC,cAAc;YAAE,gBAAgB,CAAC,eAAe,CAAC,GAAG,GAAG,CAAC,cAAc,CAAC;QAE/E,MAAM,MAAM,GAAkB;YAC5B,gBAAgB;YAChB,kBAAkB;YAClB,kBAAkB;YAClB,sBAAsB;YACtB,2BAA2B;YAC3B,yBAAyB;YACzB,sBAAsB;YACtB,0BAA0B;YAC1B,gBAAgB;YAChB,MAAM;YACN,gBAAgB;YAChB,YAAY;YACZ,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;SACtF,CAAC;QAEF,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,gCAAgC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,wCAAwC,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC;QAC9E,OAAO,CAAC,GAAG,CAAC,6CAA6C,0BAA0B,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;QACxG,OAAO,CAAC,GAAG,CAAC,oCAAoC,gBAAgB,EAAE,CAAC,CAAC;QAEpE,OAAO,MAAM,CAAC;IAEhB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,iDAAiD,EAAE,KAAK,CAAC,CAAC;QAExE,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC9B,MAAM,KAAK,CAAC;QACd,CAAC;QAED,MAAM,IAAI,QAAQ,CAChB,2CAA2C,KAAK,CAAC,OAAO,EAAE,EAC1D,YAAY,CAAC,mBAAmB,EAChC,EAAE,aAAa,EAAE,KAAK,EAAE,CACzB,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAC3C,+BAA+B;IAC/B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,gBAAgB,CAAC;IAC9C,CAAC;IAED,OAAO,mBAAmB,EAAE,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"AgentOSConfig.js","sourceRoot":"","sources":["../../src/config/AgentOSConfig.ts"],"names":[],"mappings":"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"}

package/dist/core/guardrails/IGuardrailService.d.ts

@@ -264,7 +264,7 @@ export interface GuardrailConfig {
      *
      * - `'per-chunk'` — evaluate every TEXT_DELTA individually (default behavior).
      * - `'sentence-buffered'` — accumulate chunks and evaluate at sentence
-     *   boundaries using {@link SentenceBoundaryBuffer}. The previous sentence
+     *   boundaries using the internal sentence boundary buffer. The previous sentence
      *   is included as overlap context for safety evaluation.
      *
      * Only applies when {@link evaluateStreamingChunks} is `true`.

package/dist/core/images/IImageProvider.d.ts

@@ -126,6 +126,84 @@ export interface ImageGenerationResult {
     images: GeneratedImage[];
     usage?: ImageProviderUsage;
 }
+/** The kind of editing operation to perform. */
+export type ImageEditMode = 'img2img' | 'inpaint' | 'outpaint';
+/**
+ * Provider-level request for image editing.
+ *
+ * Passed to {@link IImageProvider.editImage} by the high-level
+ * {@link editImage} helper after normalising user input.
+ */
+export interface ImageEditRequest {
+    /** Model identifier to use for the edit. */
+    modelId: string;
+    /** Source image as a raw `Buffer`. */
+    image: Buffer;
+    /** Text prompt describing the desired changes. */
+    prompt: string;
+    /** Optional mask for inpainting (white = edit region, black = keep). */
+    mask?: Buffer;
+    /** Editing mode. Defaults to `'img2img'`. */
+    mode?: ImageEditMode;
+    /**
+     * How much the output may deviate from the source.
+     * `0` = identical, `1` = completely redrawn.  Default `0.75`.
+     */
+    strength?: number;
+    /** Negative prompt describing content to avoid. */
+    negativePrompt?: string;
+    /** Desired output dimensions (e.g. `"1024x1024"`). */
+    size?: string;
+    /** Seed for reproducible output. */
+    seed?: number;
+    /** Number of output images. */
+    n?: number;
+    /** Arbitrary provider-specific options. */
+    providerOptions?: ImageProviderOptionBag | Record<string, unknown>;
+}
+/**
+ * Provider-level request for image upscaling / super-resolution.
+ *
+ * Passed to {@link IImageProvider.upscaleImage} by the high-level
+ * {@link upscaleImage} helper.
+ */
+export interface ImageUpscaleRequest {
+    /** Model identifier to use for upscaling. */
+    modelId: string;
+    /** Source image as a raw `Buffer`. */
+    image: Buffer;
+    /** Integer scale factor (e.g. `2` or `4`). */
+    scale?: 2 | 4;
+    /** Target width in pixels (alternative to `scale`). */
+    width?: number;
+    /** Target height in pixels (alternative to `scale`). */
+    height?: number;
+    /** Arbitrary provider-specific options. */
+    providerOptions?: ImageProviderOptionBag | Record<string, unknown>;
+}
+/**
+ * Provider-level request for generating image variations.
+ *
+ * Passed to {@link IImageProvider.variateImage} by the high-level
+ * {@link variateImage} helper.
+ */
+export interface ImageVariateRequest {
+    /** Model identifier to use for variation generation. */
+    modelId: string;
+    /** Source image as a raw `Buffer`. */
+    image: Buffer;
+    /** Number of variations to generate. */
+    n?: number;
+    /**
+     * How different from the original (`0` = identical, `1` = very different).
+     * Default `0.5`.
+     */
+    variance?: number;
+    /** Desired output size (e.g. `"1024x1024"`). */
+    size?: string;
+    /** Arbitrary provider-specific options. */
+    providerOptions?: ImageProviderOptionBag | Record<string, unknown>;
+}
 export interface IImageProvider {
     readonly providerId: string;
     readonly isInitialized: boolean;
@@ -134,6 +212,21 @@ export interface IImageProvider {
     generateImage(request: ImageGenerationRequest): Promise<ImageGenerationResult>;
     listAvailableModels?(): Promise<ImageModelInfo[]>;
     shutdown?(): Promise<void>;
+    /**
+     * Perform an image-to-image edit, inpainting, or outpainting operation.
+     * Providers that do not support editing should leave this `undefined`.
+     */
+    editImage?(request: ImageEditRequest): Promise<ImageGenerationResult>;
+    /**
+     * Upscale / super-resolve an image.
+     * Providers that do not support upscaling should leave this `undefined`.
+     */
+    upscaleImage?(request: ImageUpscaleRequest): Promise<ImageGenerationResult>;
+    /**
+     * Generate visual variations of the supplied image.
+     * Providers that do not support variations should leave this `undefined`.
+     */
+    variateImage?(request: ImageVariateRequest): Promise<ImageGenerationResult>;
 }
 export declare function getImageProviderOptions<T extends object>(providerId: string, providerOptions?: ImageGenerationRequest['providerOptions']): T | undefined;
 export declare function parseDataUrl(value: string): {

package/dist/core/images/IImageProvider.d.ts.map

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

package/dist/core/images/IImageProvider.js.map

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

package/dist/core/images/ImageOperationError.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @file ImageOperationError.ts
+ * Custom error types for unsupported image operations.
+ *
+ * These errors are thrown by the high-level API functions (editImage,
+ * upscaleImage, variateImage) when the resolved provider does not
+ * implement the requested capability.  Callers can catch these by class
+ * to provide actionable error messages or fall back to another provider.
+ */
+/**
+ * Thrown when an image editing operation (img2img, inpaint, outpaint) is
+ * requested from a provider that does not implement `editImage`.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await editImage({ provider: 'openrouter', image: buf, prompt: '...' });
+ * } catch (err) {
+ *   if (err instanceof ImageEditNotSupportedError) {
+ *     console.log('Try a different provider for editing.');
+ *   }
+ * }
+ * ```
+ */
+export declare class ImageEditNotSupportedError extends Error {
+    /** The provider that was asked to perform the edit. */
+    readonly providerId: string;
+    constructor(providerId: string);
+}
+/**
+ * Thrown when an upscale operation is requested from a provider that does
+ * not implement `upscaleImage`.
+ *
+ * @see {@link ImageEditNotSupportedError} for the editing equivalent.
+ */
+export declare class ImageUpscaleNotSupportedError extends Error {
+    /** The provider that was asked to perform the upscale. */
+    readonly providerId: string;
+    constructor(providerId: string);
+}
+/**
+ * Thrown when a variation operation is requested from a provider that does
+ * not implement `variateImage`.
+ *
+ * @see {@link ImageEditNotSupportedError} for the editing equivalent.
+ */
+export declare class ImageVariationNotSupportedError extends Error {
+    /** The provider that was asked to produce variations. */
+    readonly providerId: string;
+    constructor(providerId: string);
+}
+//# sourceMappingURL=ImageOperationError.d.ts.map

package/dist/core/images/ImageOperationError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageOperationError.d.ts","sourceRoot":"","sources":["../../../src/core/images/ImageOperationError.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;GAcG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,uDAAuD;IACvD,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEvB,UAAU,EAAE,MAAM;CAK/B;AAED;;;;;GAKG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,0DAA0D;IAC1D,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEvB,UAAU,EAAE,MAAM;CAK/B;AAED;;;;;GAKG;AACH,qBAAa,+BAAgC,SAAQ,KAAK;IACxD,yDAAyD;IACzD,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEvB,UAAU,EAAE,MAAM;CAK/B"}

package/dist/core/images/ImageOperationError.js

@@ -0,0 +1,58 @@
+/**
+ * @file ImageOperationError.ts
+ * Custom error types for unsupported image operations.
+ *
+ * These errors are thrown by the high-level API functions (editImage,
+ * upscaleImage, variateImage) when the resolved provider does not
+ * implement the requested capability.  Callers can catch these by class
+ * to provide actionable error messages or fall back to another provider.
+ */
+/**
+ * Thrown when an image editing operation (img2img, inpaint, outpaint) is
+ * requested from a provider that does not implement `editImage`.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await editImage({ provider: 'openrouter', image: buf, prompt: '...' });
+ * } catch (err) {
+ *   if (err instanceof ImageEditNotSupportedError) {
+ *     console.log('Try a different provider for editing.');
+ *   }
+ * }
+ * ```
+ */
+export class ImageEditNotSupportedError extends Error {
+    constructor(providerId) {
+        super(`Image editing is not supported by provider "${providerId}".`);
+        this.name = 'ImageEditNotSupportedError';
+        this.providerId = providerId;
+    }
+}
+/**
+ * Thrown when an upscale operation is requested from a provider that does
+ * not implement `upscaleImage`.
+ *
+ * @see {@link ImageEditNotSupportedError} for the editing equivalent.
+ */
+export class ImageUpscaleNotSupportedError extends Error {
+    constructor(providerId) {
+        super(`Image upscaling is not supported by provider "${providerId}".`);
+        this.name = 'ImageUpscaleNotSupportedError';
+        this.providerId = providerId;
+    }
+}
+/**
+ * Thrown when a variation operation is requested from a provider that does
+ * not implement `variateImage`.
+ *
+ * @see {@link ImageEditNotSupportedError} for the editing equivalent.
+ */
+export class ImageVariationNotSupportedError extends Error {
+    constructor(providerId) {
+        super(`Image variations are not supported by provider "${providerId}".`);
+        this.name = 'ImageVariationNotSupportedError';
+        this.providerId = providerId;
+    }
+}
+//# sourceMappingURL=ImageOperationError.js.map

package/dist/core/images/ImageOperationError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageOperationError.js","sourceRoot":"","sources":["../../../src/core/images/ImageOperationError.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAInD,YAAY,UAAkB;QAC5B,KAAK,CAAC,+CAA+C,UAAU,IAAI,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IAItD,YAAY,UAAkB;QAC5B,KAAK,CAAC,iDAAiD,UAAU,IAAI,CAAC,CAAC;QACvE,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;QAC5C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,+BAAgC,SAAQ,KAAK;IAIxD,YAAY,UAAkB;QAC5B,KAAK,CAAC,mDAAmD,UAAU,IAAI,CAAC,CAAC;QACzE,IAAI,CAAC,IAAI,GAAG,iCAAiC,CAAC;QAC9C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF"}

package/dist/core/images/imageToBuffer.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Converts an image input from any of the supported formats into a `Buffer`.
+ *
+ * Supported input formats:
+ * - **`Buffer`** — returned as-is.
+ * - **Base64 data URL** — e.g. `data:image/png;base64,iVBOR...`.  The base64
+ *   payload is extracted and decoded.
+ * - **Raw base64 string** — a string that does not look like a URL or file
+ *   path is assumed to be raw base64 data.
+ * - **`file://` URL** — resolved to a local filesystem path and read.
+ * - **HTTP/HTTPS URL** — fetched via `globalThis.fetch` and buffered.
+ * - **Local file path** — any other string is treated as an absolute or
+ *   relative filesystem path and read with `fs.readFile`.
+ *
+ * @param input - The image in any supported format.
+ * @returns A `Buffer` containing the raw image bytes.
+ *
+ * @throws {TypeError} When `input` is neither a string nor a Buffer.
+ * @throws {Error} When a remote URL fetch fails or the file cannot be read.
+ *
+ * @example
+ * ```ts
+ * const buf1 = await imageToBuffer('data:image/png;base64,iVBOR...');
+ * const buf2 = await imageToBuffer(fs.readFileSync('photo.png'));
+ * const buf3 = await imageToBuffer('https://example.com/photo.png');
+ * const buf4 = await imageToBuffer('/absolute/path/to/image.jpg');
+ * ```
+ */
+export declare function imageToBuffer(input: string | Buffer): Promise<Buffer>;
+/**
+ * Converts a Node.js `Buffer` into a DOM-compatible `BlobPart`.
+ *
+ * Recent TypeScript DOM typings require `BlobPart` byte views to be backed by a
+ * concrete `ArrayBuffer`, while `Buffer` is typed as `ArrayBufferLike`. Returning
+ * a plain `Uint8Array` avoids that mismatch for multipart image uploads.
+ *
+ * @param input - Raw image bytes stored in a Node.js `Buffer`.
+ * @returns An `ArrayBuffer` safe to pass into `new Blob([...])`.
+ */
+export declare function bufferToBlobPart(input: Buffer): ArrayBuffer;
+//# sourceMappingURL=imageToBuffer.d.ts.map

package/dist/core/images/imageToBuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageToBuffer.d.ts","sourceRoot":"","sources":["../../../src/core/images/imageToBuffer.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiD3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAI3D"}