@olane/o-tool-registry 0.6.12 → 0.7.1

package/README.md

@@ -1,253 +0,0 @@
-# o-Tool Registry
-
-A registry of tools for the oLane network, including the OllamaIntelligenceTool for interacting with local Ollama instances.
-
-## OllamaIntelligenceTool
-
-The `OllamaIntelligenceTool` provides a comprehensive API interface to interact with a local Ollama instance. It supports chat completion, text generation, model management, and server status monitoring.
-
-### Features
-
-- **Chat Completion**: Multi-turn conversations with Ollama models
-- **Text Generation**: Single-prompt text generation
-- **Model Management**: List, pull, delete, and get information about models
-- **Server Status**: Check if Ollama server is running
-- **Configurable**: Customizable base URL and default model
-
-### Configuration
-
-The tool accepts the following configuration options:
-
-```typescript
-{
-  ollamaUrl: 'http://localhost:11434', // Default Ollama server URL
-  defaultModel: 'llama2'               // Default model to use
-}
-```
-
-### Available Methods
-
-#### 1. `completion` - Chat Completion
-
-Performs chat completion with a conversation history.
-
-**Parameters:**
-- `model` (string, optional): Model name to use (defaults to configured default)
-- `messages` (array, required): Array of chat messages with role and content
-- `options` (object, optional): Generation options (temperature, top_p, etc.)
-
-**Example:**
-```json
-{
-  "method": "completion",
-  "params": {
-    "model": "llama2",
-    "messages": [
-      {"role": "system", "content": "You are a helpful assistant."},
-      {"role": "user", "content": "What is the capital of France?"}
-    ],
-    "options": {
-      "temperature": 0.7,
-      "top_p": 0.9
-    }
-  }
-}
-```
-
-#### 2. `generate` - Text Generation
-
-Generates text from a single prompt.
-
-**Parameters:**
-- `model` (string, optional): Model name to use (defaults to configured default)
-- `prompt` (string, required): Text prompt for generation
-- `system` (string, optional): System prompt
-- `options` (object, optional): Generation options
-
-**Example:**
-```json
-{
-  "method": "generate",
-  "params": {
-    "model": "llama2",
-    "prompt": "Write a short story about a robot learning to paint.",
-    "system": "You are a creative writing assistant.",
-    "options": {
-      "temperature": 0.8,
-      "num_predict": 200
-    }
-  }
-}
-```
-
-#### 3. `list_models` - List Available Models
-
-Lists all available models on the Ollama server.
-
-**Parameters:** None
-
-**Example:**
-```json
-{
-  "method": "list_models",
-  "params": {}
-}
-```
-
-#### 4. `pull_model` - Pull a Model
-
-Downloads a model from the Ollama library.
-
-**Parameters:**
-- `model` (string, required): Model name to pull
-- `insecure` (boolean, optional): Allow insecure registry connections (default: false)
-
-**Example:**
-```json
-{
-  "method": "pull_model",
-  "params": {
-    "model": "llama2:7b",
-    "insecure": false
-  }
-}
-```
-
-#### 5. `delete_model` - Delete a Model
-
-Removes a model from the local Ollama installation.
-
-**Parameters:**
-- `model` (string, required): Model name to delete
-
-**Example:**
-```json
-{
-  "method": "delete_model",
-  "params": {
-    "model": "llama2:7b"
-  }
-}
-```
-
-#### 6. `model_info` - Get Model Information
-
-Retrieves detailed information about a specific model.
-
-**Parameters:**
-- `model` (string, optional): Model name (defaults to configured default)
-
-**Example:**
-```json
-{
-  "method": "model_info",
-  "params": {
-    "model": "llama2"
-  }
-}
-```
-
-#### 7. `status` - Check Server Status
-
-Checks if the Ollama server is running and accessible.
-
-**Parameters:** None
-
-**Example:**
-```json
-{
-  "method": "status",
-  "params": {}
-}
-```
-
-### Generation Options
-
-All generation methods support the following options:
-
-- `temperature` (number): Controls randomness (0.0 to 1.0)
-- `top_p` (number): Nucleus sampling parameter (0.0 to 1.0)
-- `top_k` (number): Top-k sampling parameter
-- `num_predict` (number): Maximum number of tokens to generate
-- `stop` (array): Array of strings to stop generation
-- `seed` (number): Random seed for reproducible results
-- `num_ctx` (number): Context window size
-- `num_gpu` (number): Number of GPUs to use
-- `num_thread` (number): Number of CPU threads to use
-- `repeat_penalty` (number): Penalty for repeating tokens
-- `repeat_last_n` (number): Number of tokens to consider for repetition penalty
-- `tfs_z` (number): Tail free sampling parameter
-- `mirostat` (number): Mirostat sampling algorithm (0, 1, or 2)
-- `mirostat_tau` (number): Mirostat target entropy
-- `mirostat_eta` (number): Mirostat learning rate
-- `penalize_newline` (boolean): Penalize newline tokens
-- `presence_penalty` (number): Presence penalty
-- `frequency_penalty` (number): Frequency penalty
-
-### Response Format
-
-All methods return a `ToolResult` object with the following structure:
-
-**Success Response:**
-```json
-{
-  "success": true,
-  "response": "Generated text content",
-  "model": "model_name",
-  "done": true,
-  "total_duration": 1234,
-  "eval_count": 50,
-  "eval_duration": 1000
-}
-```
-
-**Error Response:**
-```json
-{
-  "success": false,
-  "error": "Error description"
-}
-```
-
-### Prerequisites
-
-1. **Ollama Installation**: Make sure Ollama is installed and running locally
-2. **Model Availability**: Ensure the required models are available or can be pulled
-3. **Network Access**: The tool needs network access to pull models from the Ollama library
-
-### Getting Started
-
-1. Start your Ollama server:
-   ```bash
-   ollama serve
-   ```
-
-2. Pull a model (if not already available):
-   ```bash
-   ollama pull llama2
-   ```
-
-3. Use the tool through the oLane network with the appropriate method calls.
-
-### Error Handling
-
-The tool provides comprehensive error handling for:
-- Network connectivity issues
-- Invalid model names
-- Missing required parameters
-- Ollama server errors
-- Model availability issues
-
-### Performance Considerations
-
-- **Streaming**: The tool currently uses non-streaming responses for simplicity
-- **Timeout**: Consider setting appropriate timeouts for long-running operations
-- **Memory**: Large models may require significant memory resources
-- **GPU**: Enable GPU acceleration in Ollama for better performance
-
-### Security Notes
-
-- The tool connects to localhost by default for security
-- Use HTTPS when connecting to remote Ollama instances
-- Be cautious with the `insecure` flag when pulling models
-- Validate all input parameters before processing

package/dist/auth/index.d.ts

@@ -0,0 +1,4 @@
+export * from './oAuth.tool.js';
+export * from './methods/auth.methods.js';
+export * from './interfaces/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC"}

package/dist/auth/index.js

@@ -0,0 +1,3 @@
+export * from './oAuth.tool.js';
+export * from './methods/auth.methods.js';
+export * from './interfaces/index.js';

package/dist/auth/interfaces/index.d.ts

@@ -0,0 +1,4 @@
+export * from './oAuth-tokens.interface.js';
+export * from './oAuth-user-info.interface.js';
+export * from './oAuth.config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/auth/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/auth/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mBAAmB,CAAC"}

package/dist/auth/interfaces/index.js

@@ -0,0 +1,3 @@
+export * from './oAuth-tokens.interface.js';
+export * from './oAuth-user-info.interface.js';
+export * from './oAuth.config.js';

package/dist/auth/interfaces/oAuth-tokens.interface.d.ts

@@ -0,0 +1,9 @@
+export interface OAuthTokens {
+    access_token: string;
+    refresh_token?: string;
+    token_type: string;
+    expires_in?: number;
+    scope?: string;
+    [key: string]: any;
+}
+//# sourceMappingURL=oAuth-tokens.interface.d.ts.map

package/dist/auth/interfaces/oAuth-tokens.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oAuth-tokens.interface.d.ts","sourceRoot":"","sources":["../../../src/auth/interfaces/oAuth-tokens.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB"}

package/dist/auth/interfaces/oAuth-tokens.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/auth/interfaces/oAuth-user-info.interface.d.ts

@@ -0,0 +1,8 @@
+export interface OAuthUserInfo {
+    sub: string;
+    email?: string;
+    name?: string;
+    picture?: string;
+    [key: string]: any;
+}
+//# sourceMappingURL=oAuth-user-info.interface.d.ts.map

package/dist/auth/interfaces/oAuth-user-info.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oAuth-user-info.interface.d.ts","sourceRoot":"","sources":["../../../src/auth/interfaces/oAuth-user-info.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB"}

package/dist/auth/interfaces/oAuth-user-info.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/auth/interfaces/oAuth.config.d.ts

@@ -0,0 +1,14 @@
+export interface OAuthConfig {
+    clientId: string;
+    clientSecret?: string;
+    redirectUri: string;
+    authorizationUrl: string;
+    tokenUrl: string;
+    userInfoUrl?: string;
+    scope?: string;
+    responseType?: 'code' | 'token';
+    grantType?: 'authorization_code' | 'client_credentials' | 'refresh_token';
+    tokenValidationUrl?: string;
+    tokenRevocationUrl?: string;
+}
+//# sourceMappingURL=oAuth.config.d.ts.map

package/dist/auth/interfaces/oAuth.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oAuth.config.d.ts","sourceRoot":"","sources":["../../../src/auth/interfaces/oAuth.config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,SAAS,CAAC,EAAE,oBAAoB,GAAG,oBAAoB,GAAG,eAAe,CAAC;IAC1E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/auth/interfaces/oAuth.config.js

@@ -0,0 +1 @@
+export {};

package/dist/auth/methods/auth.methods.d.ts

@@ -0,0 +1,5 @@
+import { oMethod } from '@olane/o-protocol';
+export declare const oauthMethods: {
+    [key: string]: oMethod;
+};
+//# sourceMappingURL=auth.methods.d.ts.map

package/dist/auth/methods/auth.methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.methods.d.ts","sourceRoot":"","sources":["../../../src/auth/methods/auth.methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,eAAO,MAAM,YAAY,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAwTlD,CAAC"}

package/dist/auth/methods/auth.methods.js

@@ -0,0 +1,302 @@
+export const oauthMethods = {
+    configure: {
+        name: 'configure',
+        description: 'Configure OAuth service settings',
+        dependencies: [],
+        parameters: [
+            {
+                name: 'serviceName',
+                type: 'string',
+                value: 'string',
+                description: 'Name of the OAuth service (e.g., myapp-auth, custom-provider)',
+                required: true,
+            },
+            {
+                name: 'clientId',
+                type: 'string',
+                value: 'string',
+                description: 'OAuth client ID from your service',
+                required: true,
+            },
+            {
+                name: 'clientSecret',
+                type: 'string',
+                value: 'string',
+                description: 'OAuth client secret (optional for public clients)',
+                required: false,
+            },
+            {
+                name: 'redirectUri',
+                type: 'string',
+                value: 'string',
+                description: 'OAuth redirect URI registered with your service',
+                required: true,
+            },
+            {
+                name: 'authorizationUrl',
+                type: 'string',
+                value: 'string',
+                description: 'OAuth authorization endpoint URL from your service',
+                required: true,
+            },
+            {
+                name: 'tokenUrl',
+                type: 'string',
+                value: 'string',
+                description: 'OAuth token endpoint URL from your service',
+                required: true,
+            },
+            {
+                name: 'userInfoUrl',
+                type: 'string',
+                value: 'string',
+                description: 'User info endpoint URL from your service',
+                required: false,
+            },
+            {
+                name: 'scope',
+                type: 'string',
+                value: 'string',
+                description: 'OAuth scope (default: openid profile email)',
+                required: false,
+            },
+            {
+                name: 'responseType',
+                type: 'string',
+                value: 'string',
+                description: 'OAuth response type (default: code)',
+                required: false,
+            },
+            {
+                name: 'grantType',
+                type: 'string',
+                value: 'string',
+                description: 'OAuth grant type (default: authorization_code)',
+                required: false,
+            },
+            {
+                name: 'tokenValidationUrl',
+                type: 'string',
+                value: 'string',
+                description: 'Token validation endpoint URL from your service',
+                required: false,
+            },
+            {
+                name: 'tokenRevocationUrl',
+                type: 'string',
+                value: 'string',
+                description: 'Token revocation endpoint URL from your service',
+                required: false,
+            },
+        ],
+    },
+    getAuthorizationUrl: {
+        name: 'getAuthorizationUrl',
+        description: 'Get OAuth authorization URL',
+        dependencies: [],
+        parameters: [
+            {
+                name: 'serviceName',
+                type: 'string',
+                value: 'string',
+                description: 'Name of the OAuth service',
+                required: true,
+            },
+            {
+                name: 'state',
+                type: 'string',
+                value: 'string',
+                description: 'OAuth state parameter for CSRF protection',
+                required: false,
+            },
+            {
+                name: 'scope',
+                type: 'string',
+                value: 'string',
+                description: 'Override default scope',
+                required: false,
+            },
+            {
+                name: 'additionalParams',
+                type: 'object',
+                value: 'object',
+                description: 'Additional query parameters to include in authorization URL',
+                required: false,
+            },
+        ],
+    },
+    exchangeCode: {
+        name: 'exchangeCode',
+        description: 'Exchange authorization code for access token',
+        dependencies: [],
+        parameters: [
+            {
+                name: 'serviceName',
+                type: 'string',
+                value: 'string',
+                description: 'Name of the OAuth service',
+                required: true,
+            },
+            {
+                name: 'code',
+                type: 'string',
+                value: 'string',
+                description: 'Authorization code from OAuth callback',
+                required: true,
+            },
+            {
+                name: 'state',
+                type: 'string',
+                value: 'string',
+                description: 'OAuth state parameter',
+                required: false,
+            },
+        ],
+    },
+    refreshToken: {
+        name: 'refreshToken',
+        description: 'Refresh access token using refresh token',
+        dependencies: [],
+        parameters: [
+            {
+                name: 'serviceName',
+                type: 'string',
+                value: 'string',
+                description: 'Name of the OAuth service',
+                required: true,
+            },
+            {
+                name: 'refreshToken',
+                type: 'string',
+                value: 'string',
+                description: 'Refresh token to exchange for new access token',
+                required: true,
+            },
+        ],
+    },
+    getUserInfo: {
+        name: 'getUserInfo',
+        description: 'Get user information using access token',
+        dependencies: [],
+        parameters: [
+            {
+                name: 'serviceName',
+                type: 'string',
+                value: 'string',
+                description: 'Name of the OAuth service',
+                required: true,
+            },
+            {
+                name: 'accessToken',
+                type: 'string',
+                value: 'string',
+                description: 'Access token to use for user info request',
+                required: true,
+            },
+            {
+                name: 'userInfoUrl',
+                type: 'string',
+                value: 'string',
+                description: 'Override default user info URL',
+                required: false,
+            },
+        ],
+    },
+    validateToken: {
+        name: 'validateToken',
+        description: 'Validate access token',
+        dependencies: [],
+        parameters: [
+            {
+                name: 'serviceName',
+                type: 'string',
+                value: 'string',
+                description: 'Name of the OAuth service',
+                required: true,
+            },
+            {
+                name: 'accessToken',
+                type: 'string',
+                value: 'string',
+                description: 'Access token to validate',
+                required: true,
+            },
+            {
+                name: 'tokenValidationUrl',
+                type: 'string',
+                value: 'string',
+                description: 'Override default token validation URL',
+                required: false,
+            },
+        ],
+    },
+    revokeToken: {
+        name: 'revokeToken',
+        description: 'Revoke access or refresh token',
+        dependencies: [],
+        parameters: [
+            {
+                name: 'serviceName',
+                type: 'string',
+                value: 'string',
+                description: 'Name of the OAuth service',
+                required: true,
+            },
+            {
+                name: 'token',
+                type: 'string',
+                value: 'string',
+                description: 'Token to revoke (access or refresh token)',
+                required: true,
+            },
+            {
+                name: 'tokenType',
+                type: 'string',
+                value: 'string',
+                description: 'Type of token to revoke (access_token or refresh_token)',
+                required: false,
+            },
+            {
+                name: 'tokenRevocationUrl',
+                type: 'string',
+                value: 'string',
+                description: 'Override default token revocation URL',
+                required: false,
+            },
+        ],
+    },
+    listServices: {
+        name: 'listServices',
+        description: 'List all configured OAuth services',
+        dependencies: [],
+        parameters: [],
+    },
+    getStoredTokens: {
+        name: 'getStoredTokens',
+        description: 'Get stored tokens for OAuth service',
+        dependencies: [],
+        parameters: [
+            {
+                name: 'serviceName',
+                type: 'string',
+                value: 'string',
+                description: 'Name of the OAuth service (if not provided, returns all)',
+                required: false,
+            },
+        ],
+    },
+    clearTokens: {
+        name: 'clearTokens',
+        description: 'Clear stored tokens for OAuth service',
+        dependencies: [],
+        parameters: [
+            {
+                name: 'serviceName',
+                type: 'string',
+                value: 'string',
+                description: 'Name of the OAuth service (if not provided, clears all)',
+                required: false,
+            },
+        ],
+    },
+};

package/dist/auth/oAuth.tool.d.ts

@@ -0,0 +1,20 @@
+import { oToolConfig, oVirtualTool } from '@olane/o-tool';
+export declare class OAuthTool extends oVirtualTool {
+    private oauthConfigs;
+    private tokenStore;
+    constructor(config: oToolConfig);
+    _tool_configure(request: any): Promise<any>;
+    _tool_getAuthorizationUrl(request: any): Promise<any>;
+    _tool_exchangeCode(request: any): Promise<any>;
+    _tool_refreshToken(request: any): Promise<any>;
+    _tool_getUserInfo(request: any): Promise<any>;
+    _tool_validateToken(request: any): Promise<any>;
+    _tool_revokeToken(request: any): Promise<any>;
+    _tool_listServices(request: any): Promise<any>;
+    _tool_getStoredTokens(request: any): Promise<any>;
+    _tool_clearTokens(request: any): Promise<any>;
+    private generateCodeVerifier;
+    private generateCodeChallenge;
+    private base64URLEncode;
+}
+//# sourceMappingURL=oAuth.tool.d.ts.map

package/dist/auth/oAuth.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oAuth.tool.d.ts","sourceRoot":"","sources":["../../src/auth/oAuth.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAO1D,qBAAa,SAAU,SAAQ,YAAY;IACzC,OAAO,CAAC,YAAY,CAAuC;IAC3D,OAAO,CAAC,UAAU,CAAuC;gBAE7C,MAAM,EAAE,WAAW;IAWzB,eAAe,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAuC3C,yBAAyB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAqDrD,kBAAkB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAuE9C,kBAAkB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAuE9C,iBAAiB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAgD7C,mBAAmB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAgD/C,iBAAiB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAoF7C,kBAAkB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAU9C,qBAAqB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAyCjD,iBAAiB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IA4BnD,OAAO,CAAC,oBAAoB;YAMd,qBAAqB;IAOnC,OAAO,CAAC,eAAe;CAMxB"}