@framers/agentos 0.1.166 → 0.1.167

package/README.md

@@ -40,9 +40,9 @@ Unlike frameworks that focus purely on LLM orchestration, AgentOS treats each ag
 | Package | Description |
 |---------|-------------|
 | [`@framers/agentos`](https://www.npmjs.com/package/@framers/agentos) | Core runtime -- agents, providers, memory, RAG, orchestration, guardrails |
-| [`@framers/agentos-extensions`](https://www.npmjs.com/package/@framers/agentos-extensions) | Official extension registry (40+ extensions) |
+| [`@framers/agentos-extensions`](https://www.npmjs.com/package/@framers/agentos-extensions) | Official extension source/catalog (100+ extensions and templates) |
 | [`@framers/agentos-extensions-registry`](https://www.npmjs.com/package/@framers/agentos-extensions-registry) | Curated manifest builder for extension catalogs |
-| [`@framers/agentos-skills`](https://www.npmjs.com/package/@framers/agentos-skills) | 80+ curated SKILL.md skill definitions |
+| [`@framers/agentos-skills`](https://www.npmjs.com/package/@framers/agentos-skills) | 88 curated SKILL.md skill definitions |
 | [`@framers/agentos-skills-registry`](https://www.npmjs.com/package/@framers/agentos-skills-registry) | Skills catalog SDK (query helpers + snapshot factories) |
 | [`@framers/sql-storage-adapter`](https://www.npmjs.com/package/@framers/sql-storage-adapter) | Cross-platform SQL persistence (SQLite, sql.js, Postgres, IndexedDB) |
 
@@ -139,9 +139,21 @@ console.log(object);
 
 Failed parses are automatically retried with error feedback so the model can self-correct.
 
-### 4. Agent with Personality & Memory
+### 4. Create an Agent
 
-This is the key differentiator. Agents have HEXACO personality traits that shape their communication style, and cognitive memory that determines what they retain:
+The simplest possible agent — 3 lines:
+
+```typescript
+import { agent } from '@framers/agentos';
+
+const bot = agent({ provider: 'anthropic', instructions: 'You are a helpful assistant.' });
+const reply = await bot.session('demo').send('What is 2+2?');
+console.log(reply.text); // "4"
+```
+
+#### Agent with Personality & Memory
+
+The key differentiator. Agents have HEXACO personality traits that shape their communication style, and cognitive memory that determines what they retain:
 
 ```typescript
 import { agent } from '@framers/agentos';
@@ -299,9 +311,27 @@ for await (const chunk of stream.textStream) {
 }
 ```
 
-6 strategies: `sequential`, `parallel`, `debate`, `review-loop`, `hierarchical`, `graph`.
+6 strategies — each controls how agents coordinate:
 
-Auto-detection: when any agent declares `dependsOn`, strategy defaults to `graph`.
+```typescript
+// Sequential: A → B → C, each gets the previous output
+agency({ agents, strategy: 'sequential' });
+
+// Parallel: all agents run at once, synthesis agent merges results
+agency({ agents, strategy: 'parallel' });
+
+// Debate: agents argue across rounds, a judge picks the best
+agency({ agents, strategy: 'debate', maxRounds: 3 });
+
+// Review loop: drafter writes, reviewer critiques, iterate until approved
+agency({ agents, strategy: 'review-loop' });
+
+// Hierarchical: orchestrator dispatches sub-tasks to specialists
+agency({ agents, strategy: 'hierarchical' });
+
+// Graph (DAG): explicit dependency order via dependsOn
+agency({ agents, strategy: 'graph' }); // auto-detected when dependsOn is used
+```
 
 ### 7. Orchestration (Workflows, Graphs, Missions)
 

package/dist/core/llm/routing/PolicyAwareRouter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PolicyAwareRouter.d.ts","sourceRoot":"","sources":["../../../../src/core/llm/routing/PolicyAwareRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EACV,sBAAsB,EACtB,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAElC;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AAElE;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IACpD,SAAgB,QAAQ,4BAA4B;IAEpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAyB;IAE3D;;;;;OAKG;gBAED,OAAO,EAAE,sBAAsB,EAC/B,UAAU,CAAC,EAAE,YAAY,GAAG,IAAI,EAChC,SAAS,CAAC,EAAE,eAAe,EAC3B,iBAAiB,CAAC,EAAE,UAAU;IAQhC;;;OAGG;IACG,UAAU,CACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,gBAAgB,EAAE,GAAG,EACrB,aAAa,CAAC,EAAE,GAAG,GAClB,OAAO,CAAC,IAAI,CAAC;IAIhB;;;;;OAKG;IACG,WAAW,CACf,MAAM,EAAE,gBAAgB,EACxB,eAAe,CAAC,EAAE,SAAS,EAAE,GAC5B,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IA+BnC;;;;;OAKG;IACH,OAAO,CAAC,WAAW;CAyCpB"}
+{"version":3,"file":"PolicyAwareRouter.d.ts","sourceRoot":"","sources":["../../../../src/core/llm/routing/PolicyAwareRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EACV,sBAAsB,EACtB,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAElC;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AAElE;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IACpD,SAAgB,QAAQ,4BAA4B;IAEpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAyB;IAE3D;;;;;OAKG;gBAED,OAAO,EAAE,sBAAsB,EAC/B,UAAU,CAAC,EAAE,YAAY,GAAG,IAAI,EAChC,SAAS,CAAC,EAAE,eAAe,EAC3B,iBAAiB,CAAC,EAAE,UAAU;IAQhC;;;OAGG;IACG,UAAU,CACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,gBAAgB,EAAE,GAAG,EACrB,aAAa,CAAC,EAAE,GAAG,GAClB,OAAO,CAAC,IAAI,CAAC;IAIhB;;;;;OAKG;IACG,WAAW,CACf,MAAM,EAAE,gBAAgB,EACxB,eAAe,CAAC,EAAE,SAAS,EAAE,GAC5B,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IA+BnC;;;;;OAKG;IACH,OAAO,CAAC,WAAW;CA0CpB"}

package/dist/core/llm/routing/PolicyAwareRouter.js

@@ -77,6 +77,7 @@ export class PolicyAwareRouter {
                 async generateCompletion() {
                     throw new Error('Stub provider — resolve via AIModelProviderManager');
                 },
+                // eslint-disable-next-line require-yield
                 async *generateCompletionStream() {
                     throw new Error('Stub provider — resolve via AIModelProviderManager');
                 },

package/dist/core/llm/routing/PolicyAwareRouter.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/agentos",
-  "version": "0.1.166",
+  "version": "0.1.167",
   "description": "Modular AgentOS orchestration library",
   "type": "module",
   "main": "dist/index.js",
@@ -32,6 +32,21 @@
       "default": "./dist/api/streamText.js",
       "types": "./dist/api/streamText.d.ts"
     },
+    "./core/llm/routing/IModelRouter": {
+      "import": "./dist/core/llm/routing/IModelRouter.js",
+      "default": "./dist/core/llm/routing/IModelRouter.js",
+      "types": "./dist/core/llm/routing/IModelRouter.d.ts"
+    },
+    "./core/llm/routing/PolicyAwareRouter": {
+      "import": "./dist/core/llm/routing/PolicyAwareRouter.js",
+      "default": "./dist/core/llm/routing/PolicyAwareRouter.js",
+      "types": "./dist/core/llm/routing/PolicyAwareRouter.d.ts"
+    },
+    "./core/llm/routing/UncensoredModelCatalog": {
+      "import": "./dist/core/llm/routing/UncensoredModelCatalog.js",
+      "default": "./dist/core/llm/routing/UncensoredModelCatalog.js",
+      "types": "./dist/core/llm/routing/UncensoredModelCatalog.d.ts"
+    },
     "./config/extension-secrets.json": "./dist/config/extension-secrets.json",
     "./skills": {
       "import": "./dist/skills.js",
@@ -168,6 +183,31 @@
       "default": "./dist/voice-pipeline/index.js",
       "types": "./dist/voice-pipeline/index.d.ts"
     },
+    "./voice-pipeline/providers": {
+      "import": "./dist/voice-pipeline/providers/index.js",
+      "default": "./dist/voice-pipeline/providers/index.js",
+      "types": "./dist/voice-pipeline/providers/index.d.ts"
+    },
+    "./voice-pipeline/providers/index": {
+      "import": "./dist/voice-pipeline/providers/index.js",
+      "default": "./dist/voice-pipeline/providers/index.js",
+      "types": "./dist/voice-pipeline/providers/index.d.ts"
+    },
+    "./voice-pipeline/providers/*": {
+      "import": "./dist/voice-pipeline/providers/*.js",
+      "default": "./dist/voice-pipeline/providers/*.js",
+      "types": "./dist/voice-pipeline/providers/*.d.ts"
+    },
+    "./media/avatar": {
+      "import": "./dist/media/avatar/index.js",
+      "default": "./dist/media/avatar/index.js",
+      "types": "./dist/media/avatar/index.d.ts"
+    },
+    "./media/avatar/index": {
+      "import": "./dist/media/avatar/index.js",
+      "default": "./dist/media/avatar/index.js",
+      "types": "./dist/media/avatar/index.d.ts"
+    },
     "./query-router": {
       "import": "./dist/query-router/index.js",
       "default": "./dist/query-router/index.js",
@@ -250,7 +290,7 @@
   "devDependencies": {
     "@eslint/js": "^9.11.0",
     "@framers/agentos-extensions-registry": "^0.15.0",
-    "@framers/sql-storage-adapter": "^0.6.0",
+    "@framers/sql-storage-adapter": "^0.6.1",
     "@opentelemetry/context-async-hooks": "^2.0.1",
     "@opentelemetry/sdk-metrics": "^2.0.1",
     "@opentelemetry/sdk-trace-base": "^2.0.1",
@@ -302,7 +342,7 @@
     "zod": "^4.3.6"
   },
   "peerDependencies": {
-    "@framers/sql-storage-adapter": ">=0.6.0",
+    "@framers/sql-storage-adapter": "^0.6.1",
     "graphology": ">=0.25.0",
     "graphology-communities-louvain": ">=2.0.0",
     "graphology-types": ">=0.24.0",