@framers/agentos 0.1.2 → 0.1.4

package/dist/core/guardrails/index.js

@@ -0,0 +1,56 @@
+/**
+ * @module guardrails
+ *
+ * Guardrails system for content safety and policy enforcement.
+ *
+ * Guardrails intercept content at two points:
+ * 1. **Input** - Before user messages enter the orchestration pipeline
+ * 2. **Output** - Before agent responses are streamed to the client
+ *
+ * @example Basic guardrail
+ * ```typescript
+ * import {
+ *   IGuardrailService,
+ *   GuardrailAction,
+ *   type GuardrailInputPayload
+ * } from '../../core/guardrails/index.js';
+ *
+ * class ContentFilter implements IGuardrailService {
+ *   async evaluateInput({ input }: GuardrailInputPayload) {
+ *     if (containsProhibitedContent(input.textInput)) {
+ *       return {
+ *         action: GuardrailAction.BLOCK,
+ *         reason: 'Content policy violation'
+ *       };
+ *     }
+ *     return null;
+ *   }
+ * }
+ * ```
+ *
+ * @example Cross-agent supervision
+ * ```typescript
+ * import {
+ *   ICrossAgentGuardrailService,
+ *   GuardrailAction
+ * } from '../../core/guardrails/index.js';
+ *
+ * class SupervisorGuardrail implements ICrossAgentGuardrailService {
+ *   observeAgentIds = ['worker-1', 'worker-2'];
+ *   canInterruptOthers = true;
+ *
+ *   async evaluateCrossAgentOutput({ sourceAgentId, chunk }) {
+ *     // Supervise worker agents' outputs
+ *   }
+ * }
+ * ```
+ */
+// Core guardrail interface and types
+export { GuardrailAction, } from './IGuardrailService.js';
+// Guardrail dispatcher functions
+export { createGuardrailBlockedStream, evaluateInputGuardrails, wrapOutputGuardrails, } from './guardrailDispatcher.js';
+// Cross-agent guardrail interface and types
+export { isCrossAgentGuardrail, shouldObserveAgent, } from './ICrossAgentGuardrailService.js';
+// Cross-agent guardrail dispatcher
+export { evaluateCrossAgentGuardrails, filterCrossAgentGuardrails, wrapWithCrossAgentGuardrails, } from './crossAgentGuardrailDispatcher.js';
+//# sourceMappingURL=index.js.map

package/dist/core/guardrails/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/guardrails/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,qCAAqC;AACrC,OAAO,EACL,eAAe,GAOhB,MAAM,qBAAqB,CAAC;AAE7B,iCAAiC;AACjC,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,EAGvB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAE/B,4CAA4C;AAC5C,OAAO,EAGL,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AAEvC,mCAAmC;AACnC,OAAO,EAGL,4BAA4B,EAC5B,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,iCAAiC,CAAC"}

package/dist/core/storage/SqlStorageAdapter.js

@@ -115,41 +115,41 @@ export class SqlStorageAdapter {
         // Resolve the appropriate storage adapter for the platform
         this.adapter = await resolveStorageAdapter(this.config);
         // Create conversations table
-        await this.adapter.exec(`
-      CREATE TABLE IF NOT EXISTS conversations (
-        id TEXT PRIMARY KEY,
-        userId TEXT NOT NULL,
-        agentId TEXT,
-        createdAt INTEGER NOT NULL,
-        lastActivity INTEGER NOT NULL,
-        title TEXT,
-        metadata TEXT
-      );
-      CREATE INDEX IF NOT EXISTS idx_conversations_userId ON conversations(userId);
-      CREATE INDEX IF NOT EXISTS idx_conversations_agentId ON conversations(agentId);
-      CREATE INDEX IF NOT EXISTS idx_conversations_lastActivity ON conversations(lastActivity);
+        await this.adapter.exec(`
+      CREATE TABLE IF NOT EXISTS conversations (
+        id TEXT PRIMARY KEY,
+        userId TEXT NOT NULL,
+        agentId TEXT,
+        createdAt INTEGER NOT NULL,
+        lastActivity INTEGER NOT NULL,
+        title TEXT,
+        metadata TEXT
+      );
+      CREATE INDEX IF NOT EXISTS idx_conversations_userId ON conversations(userId);
+      CREATE INDEX IF NOT EXISTS idx_conversations_agentId ON conversations(agentId);
+      CREATE INDEX IF NOT EXISTS idx_conversations_lastActivity ON conversations(lastActivity);
     `);
         // Create messages table with foreign key
-        await this.adapter.exec(`
-      CREATE TABLE IF NOT EXISTS messages (
-        id TEXT PRIMARY KEY,
-        conversationId TEXT NOT NULL,
-        role TEXT NOT NULL CHECK(role IN ('user', 'assistant', 'system', 'tool')),
-        content TEXT NOT NULL,
-        timestamp INTEGER NOT NULL,
-        model TEXT,
-        promptTokens INTEGER,
-        completionTokens INTEGER,
-        totalTokens INTEGER,
-        toolCalls TEXT,
-        toolCallId TEXT,
-        name TEXT,
-        metadata TEXT,
-        FOREIGN KEY (conversationId) REFERENCES conversations(id) ON DELETE CASCADE
-      );
-      CREATE INDEX IF NOT EXISTS idx_messages_conversationId ON messages(conversationId);
-      CREATE INDEX IF NOT EXISTS idx_messages_timestamp ON messages(timestamp);
-      CREATE INDEX IF NOT EXISTS idx_messages_role ON messages(role);
+        await this.adapter.exec(`
+      CREATE TABLE IF NOT EXISTS messages (
+        id TEXT PRIMARY KEY,
+        conversationId TEXT NOT NULL,
+        role TEXT NOT NULL CHECK(role IN ('user', 'assistant', 'system', 'tool')),
+        content TEXT NOT NULL,
+        timestamp INTEGER NOT NULL,
+        model TEXT,
+        promptTokens INTEGER,
+        completionTokens INTEGER,
+        totalTokens INTEGER,
+        toolCalls TEXT,
+        toolCallId TEXT,
+        name TEXT,
+        metadata TEXT,
+        FOREIGN KEY (conversationId) REFERENCES conversations(id) ON DELETE CASCADE
+      );
+      CREATE INDEX IF NOT EXISTS idx_messages_conversationId ON messages(conversationId);
+      CREATE INDEX IF NOT EXISTS idx_messages_timestamp ON messages(timestamp);
+      CREATE INDEX IF NOT EXISTS idx_messages_role ON messages(role);
     `);
         this.initialized = true;
     }
@@ -178,7 +178,7 @@ export class SqlStorageAdapter {
     async createConversation(conversation) {
         this.ensureInitialized();
         const metadataJson = conversation.metadata ? JSON.stringify(conversation.metadata) : null;
-        await this.adapter.run(`INSERT INTO conversations (id, userId, agentId, createdAt, lastActivity, title, metadata)
+        await this.adapter.run(`INSERT INTO conversations (id, userId, agentId, createdAt, lastActivity, title, metadata)
        VALUES (?, ?, ?, ?, ?, ?, ?)`, [
             conversation.id,
             conversation.userId,
@@ -220,8 +220,8 @@ export class SqlStorageAdapter {
         }
         const updated = { ...existing, ...updates };
         const metadataJson = updated.metadata ? JSON.stringify(updated.metadata) : null;
-        await this.adapter.run(`UPDATE conversations 
-       SET userId = ?, agentId = ?, createdAt = ?, lastActivity = ?, title = ?, metadata = ?
+        await this.adapter.run(`UPDATE conversations 
+       SET userId = ?, agentId = ?, createdAt = ?, lastActivity = ?, title = ?, metadata = ?
        WHERE id = ?`, [
             updated.userId,
             updated.agentId || null,
@@ -289,8 +289,8 @@ export class SqlStorageAdapter {
         const toolCallsJson = message.toolCalls ? JSON.stringify(message.toolCalls) : null;
         const metadataJson = message.metadata ? JSON.stringify(message.metadata) : null;
         // Insert message
-        await this.adapter.run(`INSERT INTO messages 
-       (id, conversationId, role, content, timestamp, model, promptTokens, completionTokens, totalTokens, toolCalls, toolCallId, name, metadata)
+        await this.adapter.run(`INSERT INTO messages 
+       (id, conversationId, role, content, timestamp, model, promptTokens, completionTokens, totalTokens, toolCalls, toolCallId, name, metadata)
        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
             message.id,
             message.conversationId,
@@ -405,11 +405,11 @@ export class SqlStorageAdapter {
      */
     async getConversationTokenUsage(conversationId) {
         this.ensureInitialized();
-        const row = await this.adapter.get(`SELECT 
-        SUM(promptTokens) as promptTokens,
-        SUM(completionTokens) as completionTokens,
-        SUM(totalTokens) as totalTokens
-       FROM messages 
+        const row = await this.adapter.get(`SELECT 
+        SUM(promptTokens) as promptTokens,
+        SUM(completionTokens) as completionTokens,
+        SUM(totalTokens) as totalTokens
+       FROM messages 
        WHERE conversationId = ?`, [conversationId]);
         return {
             promptTokens: row?.promptTokens || 0,

package/package.json

@@ -1,84 +1,84 @@
-{
-  "name": "@framers/agentos",
-  "version": "0.1.2",
-  "description": "Modular AgentOS orchestration library",
-  "type": "module",
-  "main": "dist/index.js",
-  "module": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": "./dist/index.js",
-    "./package.json": "./package.json",
-    "./*": "./dist/*.js"
-  },
-  "files": [
-    "dist"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "clean": "rimraf dist tsconfig.build.tsbuildinfo",
-    "build": "npm run clean && tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json && node scripts/fix-esm-imports.mjs",
-    "typecheck": "tsc --noEmit",
-    "lint": "node scripts/strip-nbsp.mjs && eslint \"src/**/*.{ts,js}\"",
-    "test": "vitest run",
-    "dev:test": "vitest",
-    "docs:clean": "rimraf docs/api ../../docs-generated/library ../../docs-generated/api",
-    "docs": "npm run docs:clean && pnpm --dir ../../ exec typedoc --options packages/agentos/typedoc.json && pnpm --dir ../../ exec typedoc --options typedoc.json && pnpm --dir ../../ exec node scripts/generate-api-docs.js && pnpm --dir ../../ exec node apps/agentos-landing/scripts/copy-docs.js",
-    "docs:watch": "npm run docs:clean && pnpm --dir ../../ exec typedoc --options packages/agentos/typedoc.json && pnpm --dir ../../ exec typedoc --options typedoc.json && pnpm --dir ../../ exec node scripts/generate-api-docs.js && concurrently \"pnpm --dir ../../ exec typedoc --options packages/agentos/typedoc.json --watch\" \"pnpm --dir ../../ exec typedoc --options typedoc.json --watch\" \"pnpm --dir ../../ exec node apps/agentos-landing/scripts/copy-docs.js --watch\""
-  },
-  "keywords": [
-    "agentos",
-    "orchestration",
-    "typescript",
-    "llm",
-    "tools"
-  ],
-  "author": "Voice Chat Assistant Team",
-  "license": "Apache-2.0",
-  "devDependencies": {
-    "@semantic-release/changelog": "^6.0.3",
-    "@semantic-release/commit-analyzer": "^13.0.0",
-    "@semantic-release/git": "^10.0.1",
-    "@semantic-release/github": "^9.2.4",
-    "@semantic-release/npm": "^12.0.1",
-    "@semantic-release/release-notes-generator": "^14.0.1",
-    "conventional-changelog-conventionalcommits": "^7.0.2",
-    "@types/natural": "^5.1.5",
-    "@types/node": "^20.12.12",
-    "eslint": "^9.11.0",
-    "eslint-config-prettier": "^9.1.0",
-    "eslint-plugin-import": "^2.29.1",
-    "@eslint/js": "^9.11.0",
-    "typescript-eslint": "^8.0.0",
-    "prettier": "^3.3.2",
-    "rimraf": "^5.0.7",
-    "semantic-release": "^24.1.0",
-    "ts-node": "^10.9.2",
-    "tsc-alias": "^1.8.10",
-    "tsconfig-paths": "^4.2.0",
-    "tsx": "^4.20.0",
-    "typedoc": "^0.25.13",
-    "typescript": "^5.4.5",
-    "vitest": "^1.6.0"
-  },
-  "dependencies": {
-    "ajv": "^8.17.1",
-    "ajv-formats": "^3.0.1",
-    "axios": "^1.7.7",
-    "lru-cache": "^11.1.0",
-    "natural": "^6.12.0",
-    "pino": "^9.14.0",
-    "uuid": "^11.1.0"
-  },
-  "peerDependencies": {
-    "typescript": ">=5.0.0",
-    "@framers/sql-storage-adapter": ">=0.4.0"
-  },
-  "peerDependenciesMeta": {
-    "@framers/sql-storage-adapter": {
-      "optional": true
-    }
-  }
-}
+{
+  "name": "@framers/agentos",
+  "version": "0.1.4",
+  "description": "Modular AgentOS orchestration library",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json",
+    "./*": "./dist/*.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "clean": "rimraf dist tsconfig.build.tsbuildinfo",
+    "build": "npm run clean && tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json && node scripts/fix-esm-imports.mjs",
+    "typecheck": "tsc --noEmit",
+    "lint": "node scripts/strip-nbsp.mjs && eslint \"src/**/*.{ts,js}\"",
+    "test": "vitest run",
+    "dev:test": "vitest",
+    "docs:clean": "rimraf docs/api ../../docs-generated/library ../../docs-generated/api",
+    "docs": "npm run docs:clean && pnpm --dir ../../ exec typedoc --options packages/agentos/typedoc.json && pnpm --dir ../../ exec typedoc --options typedoc.json && pnpm --dir ../../ exec node scripts/generate-api-docs.js && pnpm --dir ../../ exec node apps/agentos.sh/scripts/copy-docs.js",
+    "docs:watch": "npm run docs:clean && pnpm --dir ../../ exec typedoc --options packages/agentos/typedoc.json && pnpm --dir ../../ exec typedoc --options typedoc.json && pnpm --dir ../../ exec node scripts/generate-api-docs.js && concurrently \"pnpm --dir ../../ exec typedoc --options packages/agentos/typedoc.json --watch\" \"pnpm --dir ../../ exec typedoc --options typedoc.json --watch\" \"pnpm --dir ../../ exec node apps/agentos.sh/scripts/copy-docs.js --watch\""
+  },
+  "keywords": [
+    "agentos",
+    "orchestration",
+    "typescript",
+    "llm",
+    "tools"
+  ],
+  "author": "Voice Chat Assistant Team",
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.0",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^9.2.4",
+    "@semantic-release/npm": "^12.0.1",
+    "@semantic-release/release-notes-generator": "^14.0.1",
+    "conventional-changelog-conventionalcommits": "^7.0.2",
+    "@types/natural": "^5.1.5",
+    "@types/node": "^20.12.12",
+    "eslint": "^9.11.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-import": "^2.29.1",
+    "@eslint/js": "^9.11.0",
+    "typescript-eslint": "^8.0.0",
+    "prettier": "^3.3.2",
+    "rimraf": "^5.0.7",
+    "semantic-release": "^24.1.0",
+    "ts-node": "^10.9.2",
+    "tsc-alias": "^1.8.10",
+    "tsconfig-paths": "^4.2.0",
+    "tsx": "^4.20.0",
+    "typedoc": "^0.25.13",
+    "typescript": "^5.4.5",
+    "vitest": "^1.6.0"
+  },
+  "dependencies": {
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "axios": "^1.7.7",
+    "lru-cache": "^11.1.0",
+    "natural": "^6.12.0",
+    "pino": "^9.14.0",
+    "uuid": "^11.1.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0",
+    "@framers/sql-storage-adapter": ">=0.4.0"
+  },
+  "peerDependenciesMeta": {
+    "@framers/sql-storage-adapter": {
+      "optional": true
+    }
+  }
+}