@framers/agentos-template-basic-tool 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Frame.dev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,146 @@
+# Template Extension for AgentOS
+
+A template for creating new AgentOS extensions.
+
+## Quick Start
+
+1. **Copy this template**:
+```bash
+cp -r ext-template ext-myextension
+cd ext-myextension
+```
+
+2. **Update package.json**:
+- Change name to `@framers/agentos-ext-{yourname}`
+- Update description, author, keywords
+
+3. **Update manifest.json**:
+- Change id to `com.framers.ext.{yourname}`
+- Update metadata
+
+4. **Implement your tools**:
+- Create tools in `src/tools/`
+- Implement `ITool` interface
+- Export from `src/index.ts`
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Watch mode
+npm run dev
+
+# Run tests
+npm test
+
+# Lint
+npm run lint
+```
+
+## Structure
+
+```
+ext-template/
+├── src/
+│   ├── index.ts           # Extension pack export
+│   ├── tools/
+│   │   └── exampleTool.ts # Example tool implementation
+│   └── types.ts           # TypeScript definitions
+├── test/
+│   └── unit/
+│       └── exampleTool.spec.ts
+├── manifest.json          # Extension metadata
+├── package.json
+└── README.md
+```
+
+## Creating a Tool
+
+```typescript
+import type { ITool, ToolExecutionContext, ToolExecutionResult } from '@framers/agentos';
+
+export class MyTool implements ITool {
+  readonly id = 'com.framers.ext.myext.myTool';
+  readonly name = 'myTool';
+  readonly displayName = 'My Tool';
+  readonly description = 'What this tool does';
+  
+  readonly inputSchema = {
+    type: 'object',
+    properties: {
+      // Define inputs
+    },
+    required: []
+  };
+  
+  async execute(input: any, context: ToolExecutionContext): Promise<ToolExecutionResult> {
+    try {
+      // Your implementation
+      return { success: true, output: {} };
+    } catch (error) {
+      return { success: false, error: error.message };
+    }
+  }
+}
+```
+
+## Configuration
+
+Extensions can access configuration through the context:
+
+```typescript
+async execute(input: any, context: ToolExecutionContext) {
+  const config = context.configuration?.['myext'] || {};
+  const apiKey = config.apiKey;
+  // Use configuration
+}
+```
+
+### Declaring Secrets
+
+If your tool needs an API key, declare it on the descriptor so hosts can surface the requirement:
+
+```ts
+requiredSecrets: [{ id: 'openai.apiKey' }],
+onActivate: (ctx) => {
+  exampleTool.setApiKey(ctx.getSecret?.('openai.apiKey'));
+},
+```
+
+Secret IDs correspond to `packages/agentos/src/config/extension-secrets.json` and are also visible inside the AgentOS client UI.
+
+## Testing
+
+Write comprehensive tests:
+
+```typescript
+import { describe, it, expect } from 'vitest';
+import { MyTool } from '../src/tools/myTool';
+
+describe('MyTool', () => {
+  it('executes correctly', async () => {
+    const tool = new MyTool();
+    const result = await tool.execute(
+      { /* input */ },
+      { /* context */ } as any
+    );
+    expect(result.success).toBe(true);
+  });
+});
+```
+
+## Publishing
+
+1. Build: `npm run build`
+2. Test: `npm test`
+3. Version: `npm version patch|minor|major`
+4. Publish: `npm publish --access public`
+
+## License
+
+MIT - See LICENSE

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @file Extension pack entry point
+ * @description Creates and exports the extension pack for AgentOS
+ */
+import type { ExtensionPack, ExtensionPackContext } from '@framers/agentos';
+/**
+ * Creates the extension pack with all tools, guardrails, and other extensions
+ */
+export declare function createExtensionPack(context: ExtensionPackContext): ExtensionPack;
+export default createExtensionPack;
+export { ExampleTool } from './tools/exampleTool';
+export type { ExampleToolInput, ExampleToolOutput } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAG5E;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA2ChF;AAGD,eAAe,mBAAmB,CAAC;AAGnC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,60 @@
+"use strict";
+// @ts-nocheck
+/**
+ * @file Extension pack entry point
+ * @description Creates and exports the extension pack for AgentOS
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExampleTool = void 0;
+exports.createExtensionPack = createExtensionPack;
+const exampleTool_1 = require("./tools/exampleTool");
+/**
+ * Creates the extension pack with all tools, guardrails, and other extensions
+ */
+function createExtensionPack(context) {
+    const { options = {} } = context;
+    // Initialize any services or configuration
+    const config = {
+        apiKey: options.apiKey || process.env.TEMPLATE_API_KEY,
+        endpoint: options.endpoint || 'https://api.example.com',
+        ...options
+    };
+    const tool = new exampleTool_1.ExampleTool(config);
+    return {
+        name: '@framers/agentos-ext-template',
+        version: '1.0.0',
+        descriptors: [
+            {
+                id: 'exampleTool',
+                kind: 'tool',
+                payload: tool,
+                priority: 10,
+                enableByDefault: true,
+                requiredSecrets: [{ id: 'openai.apiKey' }],
+                metadata: {
+                    category: 'utility',
+                    requiresApiKey: true,
+                    documentation: 'https://github.com/framersai/agentos-extensions/tree/main/packages/ext-template'
+                },
+                source: context.source,
+                onActivate: async (ctx) => {
+                    ctx.logger?.info('[Template Extension] Example tool activated');
+                    const secret = ctx.getSecret?.('openai.apiKey');
+                    if (secret) {
+                        tool.setApiKey(secret);
+                    }
+                },
+                onDeactivate: async (ctx) => {
+                    ctx.logger?.info('[Template Extension] Example tool deactivated');
+                }
+            }
+            // Add more tools, guardrails, etc. here
+        ]
+    };
+}
+// Default export for CommonJS compatibility
+exports.default = createExtensionPack;
+// Named exports for specific tools if needed
+var exampleTool_2 = require("./tools/exampleTool");
+Object.defineProperty(exports, "ExampleTool", { enumerable: true, get: function () { return exampleTool_2.ExampleTool; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,cAAc;AACd;;;GAGG;;;AAQH,kDA2CC;AAhDD,qDAAkD;AAElD;;GAEG;AACH,SAAgB,mBAAmB,CAAC,OAA6B;IAC/D,MAAM,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAEjC,2CAA2C;IAC3C,MAAM,MAAM,GAAG;QACb,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB;QACtD,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,yBAAyB;QACvD,GAAG,OAAO;KACX,CAAC;IAEF,MAAM,IAAI,GAAG,IAAI,yBAAW,CAAC,MAAM,CAAC,CAAC;IAErC,OAAO;QACL,IAAI,EAAE,+BAA+B;QACrC,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE;YACX;gBACE,EAAE,EAAE,aAAa;gBACjB,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,EAAE;gBACZ,eAAe,EAAE,IAAI;gBACrB,eAAe,EAAE,CAAC,EAAE,EAAE,EAAE,eAAe,EAAE,CAAC;gBAC1C,QAAQ,EAAE;oBACR,QAAQ,EAAE,SAAS;oBACnB,cAAc,EAAE,IAAI;oBACpB,aAAa,EAAE,iFAAiF;iBACjG;gBACD,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;oBACxB,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,6CAA6C,CAAC,CAAC;oBAChE,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC,eAAe,CAAC,CAAC;oBAChD,IAAI,MAAM,EAAE,CAAC;wBACX,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;oBACzB,CAAC;gBACH,CAAC;gBACD,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;oBAC1B,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,+CAA+C,CAAC,CAAC;gBACpE,CAAC;aACF;YACD,wCAAwC;SACzC;KACF,CAAC;AACJ,CAAC;AAED,4CAA4C;AAC5C,kBAAe,mBAAmB,CAAC;AAEnC,6CAA6C;AAC7C,mDAAkD;AAAzC,0GAAA,WAAW,OAAA"}

package/dist/tools/exampleTool.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @file Example tool implementation
+ * @description Demonstrates how to implement the ITool interface
+ */
+import type { ITool, ToolExecutionContext, ToolExecutionResult, JSONSchemaObject } from '@framers/agentos';
+import type { ExampleToolInput, ExampleToolOutput } from '../types';
+export declare class ExampleTool implements ITool<ExampleToolInput, ExampleToolOutput> {
+    readonly id = "com.framers.ext.template.exampleTool";
+    readonly name = "exampleTool";
+    readonly displayName = "Example Tool";
+    readonly description = "An example tool that demonstrates the AgentOS tool pattern";
+    readonly version = "1.0.0";
+    private config;
+    constructor(config?: Record<string, any>);
+    setApiKey(apiKey?: string): void;
+    /**
+     * Input schema for validation
+     */
+    readonly inputSchema: JSONSchemaObject;
+    /**
+     * Output schema for validation
+     */
+    readonly outputSchema: JSONSchemaObject;
+    /**
+     * Required permissions and capabilities
+     */
+    readonly permissions: {
+        requiredScopes: never[];
+        requiredCapabilities: never[];
+    };
+    /**
+     * Execute the tool
+     */
+    execute(input: ExampleToolInput, context: ToolExecutionContext): Promise<ToolExecutionResult<ExampleToolOutput>>;
+    /**
+     * Simulate an API call for demonstration
+     */
+    private simulateApiCall;
+}
+//# sourceMappingURL=exampleTool.d.ts.map

package/dist/tools/exampleTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exampleTool.d.ts","sourceRoot":"","sources":["../../src/tools/exampleTool.ts"],"names":[],"mappings":"AACA;;;GAGG;AAEH,OAAO,KAAK,EACV,KAAK,EACL,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEpE,qBAAa,WAAY,YAAW,KAAK,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;IAC5E,QAAQ,CAAC,EAAE,0CAA0C;IACrD,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,kBAAkB;IACtC,QAAQ,CAAC,WAAW,gEAAgE;IACpF,QAAQ,CAAC,OAAO,WAAW;IAE3B,OAAO,CAAC,MAAM,CAAsB;gBAExB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;IAIrC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAMvC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CA0BpC;IAEF;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAgBrC;IAEF;;OAEG;IACH,QAAQ,CAAC,WAAW;;;MAGlB;IAEF;;OAEG;IACG,OAAO,CACX,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;IA0DlD;;OAEG;YACW,eAAe;CAS9B"}

package/dist/tools/exampleTool.js

@@ -0,0 +1,148 @@
+"use strict";
+// @ts-nocheck
+/**
+ * @file Example tool implementation
+ * @description Demonstrates how to implement the ITool interface
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExampleTool = void 0;
+class ExampleTool {
+    id = 'com.framers.ext.template.exampleTool';
+    name = 'exampleTool';
+    displayName = 'Example Tool';
+    description = 'An example tool that demonstrates the AgentOS tool pattern';
+    version = '1.0.0';
+    config;
+    constructor(config = {}) {
+        this.config = config;
+    }
+    setApiKey(apiKey) {
+        if (apiKey) {
+            this.config.apiKey = apiKey;
+        }
+    }
+    /**
+     * Input schema for validation
+     */
+    inputSchema = {
+        type: 'object',
+        properties: {
+            message: {
+                type: 'string',
+                description: 'A message to process'
+            },
+            options: {
+                type: 'object',
+                properties: {
+                    uppercase: {
+                        type: 'boolean',
+                        description: 'Convert message to uppercase',
+                        default: false
+                    },
+                    repeat: {
+                        type: 'integer',
+                        description: 'Number of times to repeat the message',
+                        minimum: 1,
+                        maximum: 10,
+                        default: 1
+                    }
+                }
+            }
+        },
+        required: ['message']
+    };
+    /**
+     * Output schema for validation
+     */
+    outputSchema = {
+        type: 'object',
+        properties: {
+            result: {
+                type: 'string',
+                description: 'The processed message'
+            },
+            metadata: {
+                type: 'object',
+                properties: {
+                    originalLength: { type: 'integer' },
+                    processedLength: { type: 'integer' },
+                    processingTime: { type: 'number' }
+                }
+            }
+        }
+    };
+    /**
+     * Required permissions and capabilities
+     */
+    permissions = {
+        requiredScopes: [],
+        requiredCapabilities: []
+    };
+    /**
+     * Execute the tool
+     */
+    async execute(input, context) {
+        const startTime = Date.now();
+        try {
+            // Validate configuration
+            if (this.config.requiresApiKey && !this.config.apiKey) {
+                return {
+                    success: false,
+                    error: 'API key is required but not configured',
+                    details: {
+                        code: 'MISSING_API_KEY',
+                        help: 'Set the API key in extension configuration or environment variables'
+                    }
+                };
+            }
+            // Process the input
+            let result = input.message;
+            // Apply options
+            if (input.options?.uppercase) {
+                result = result.toUpperCase();
+            }
+            if (input.options?.repeat && input.options.repeat > 1) {
+                result = Array(input.options.repeat).fill(result).join(' ');
+            }
+            // Simulate async operation
+            await this.simulateApiCall();
+            const processingTime = Date.now() - startTime;
+            return {
+                success: true,
+                output: {
+                    result,
+                    metadata: {
+                        originalLength: input.message.length,
+                        processedLength: result.length,
+                        processingTime
+                    }
+                },
+                contentType: 'application/json'
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error occurred',
+                details: {
+                    timestamp: new Date().toISOString(),
+                    input,
+                    stack: error instanceof Error ? error.stack : undefined
+                }
+            };
+        }
+    }
+    /**
+     * Simulate an API call for demonstration
+     */
+    async simulateApiCall() {
+        // Simulate network delay
+        await new Promise(resolve => setTimeout(resolve, 100));
+        // Could make actual API calls here:
+        // const response = await fetch(this.config.endpoint, {
+        //   headers: { 'Authorization': `Bearer ${this.config.apiKey}` }
+        // });
+    }
+}
+exports.ExampleTool = ExampleTool;
+//# sourceMappingURL=exampleTool.js.map

package/dist/tools/exampleTool.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @file Type definitions for the template extension
+ */
+/**
+ * Input type for the example tool
+ */
+export interface ExampleToolInput {
+    message: string;
+    options?: {
+        uppercase?: boolean;
+        repeat?: number;
+    };
+}
+/**
+ * Output type for the example tool
+ */
+export interface ExampleToolOutput {
+    result: string;
+    metadata: {
+        originalLength: number;
+        processedLength: number;
+        processingTime: number;
+    };
+}
+/**
+ * Configuration options for the extension
+ */
+export interface ExtensionConfig {
+    apiKey?: string;
+    endpoint?: string;
+    requiresApiKey?: boolean;
+    debug?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE;QACR,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/dist/types.js

@@ -0,0 +1,7 @@
+"use strict";
+// @ts-nocheck
+/**
+ * @file Type definitions for the template extension
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,cAAc;AACd;;GAEG"}

package/manifest.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://agentos.sh/schemas/extension-manifest-v1.json",
+  "id": "com.framers.ext.template",
+  "name": "Template Extension",
+  "version": "1.0.0",
+  "description": "A template for creating new AgentOS extensions",
+  "author": {
+    "name": "Your Name",
+    "email": "your.email@example.com",
+    "url": "https://github.com/yourusername"
+  },
+  "license": "MIT",
+  "keywords": ["template", "example"],
+  "agentosVersion": "^2.0.0",
+  "categories": ["utility"],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/framersai/agentos-extensions"
+  },
+  "extensions": [
+    {
+      "kind": "tool",
+      "id": "exampleTool",
+      "displayName": "Example Tool",
+      "description": "An example tool implementation",
+      "entry": "./dist/tools/exampleTool.js"
+    }
+  ],
+  "configuration": {
+    "properties": {
+      "template.apiKey": {
+        "type": "string",
+        "description": "API key for external service",
+        "secret": true
+      },
+      "template.endpoint": {
+        "type": "string",
+        "default": "https://api.example.com",
+        "description": "API endpoint URL"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@framers/agentos-template-basic-tool",
+  "version": "1.0.0",
+  "description": "Template for creating AgentOS extensions",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "keywords": [
+    "agentos",
+    "extension",
+    "template"
+  ],
+  "author": {
+    "name": "Framers AI",
+    "email": "team@frame.dev",
+    "url": "https://frame.dev"
+  },
+  "contributors": [
+    {
+      "name": "Johnny Dunn",
+      "email": "johnnyfived@protonmail.com",
+      "url": "https://github.com/jddunn"
+    }
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/framersai/agentos-extensions",
+    "directory": "packages/ext-template"
+  },
+  "files": [
+    "dist",
+    "manifest.json",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "@framers/agentos": "^0.5.2"
+  },
+  "devDependencies": {
+    "@framers/agentos": "^0.5.2",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "test:coverage": "vitest --coverage",
+    "lint": "eslint src --ext .ts",
+    "clean": "rm -rf dist"
+  }
+}