@framers/agentos 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/README.md +39 -13
  2. package/dist/cognitive_substrate/personas/definitions/atlas_systems_architect.json +2 -2
  3. package/dist/index.d.ts +1 -0
  4. package/dist/index.d.ts.map +1 -1
  5. package/dist/index.js +2 -0
  6. package/dist/index.js.map +1 -1
  7. package/package.json +1 -1
package/README.md CHANGED
@@ -274,19 +274,45 @@ for await (const chunk of agent.processRequest({
274
274
 
275
275
  ---
276
276
 
277
- ## Documentation
278
-
279
- | Guide | Description |
280
- |-------|-------------|
281
- | [Architecture](./docs/ARCHITECTURE.md) | System design and component overview |
282
- | [Planning Engine](./docs/PLANNING_ENGINE.md) | Multi-step task planning and execution |
283
- | [Human-in-the-Loop](./docs/HUMAN_IN_THE_LOOP.md) | Approval workflows and oversight |
284
- | [Agent Communication](./docs/AGENT_COMMUNICATION.md) | Inter-agent messaging patterns |
285
- | [RAG Configuration](./docs/RAG_MEMORY_CONFIGURATION.md) | Memory and retrieval setup |
286
- | [Structured Output](./docs/STRUCTURED_OUTPUT.md) | JSON schema validation |
287
- | [Evaluation Framework](./docs/EVALUATION_FRAMEWORK.md) | Testing and quality assurance |
288
- | [API Reference](./docs/api/index.html) | TypeDoc-generated API docs |
289
-
277
+ ## Documentation
278
+
279
+ ### Core Concepts
280
+
281
+ | Guide | Description |
282
+ |-------|-------------|
283
+ | [Architecture](./docs/ARCHITECTURE.md) | System design and component overview |
284
+ | [Deep Dive](./docs/AGENTOS_ARCHITECTURE_DEEP_DIVE.md) | Detailed architecture walkthrough |
285
+ | [Extensions](./docs/RFC_EXTENSION_STANDARDS.md) | Extension system and standards |
286
+ | [Ecosystem](./docs/ECOSYSTEM.md) | Related repos and packages |
287
+
288
+ ### Agent Features
289
+
290
+ | Guide | Description |
291
+ |-------|-------------|
292
+ | [Planning Engine](./docs/PLANNING_ENGINE.md) | Multi-step task planning and execution |
293
+ | [Human-in-the-Loop](./docs/HUMAN_IN_THE_LOOP.md) | Approval workflows and oversight |
294
+ | [Agent Communication](./docs/AGENT_COMMUNICATION.md) | Inter-agent messaging patterns |
295
+ | [Self-Building Agents](./docs/RECURSIVE_SELF_BUILDING_AGENTS.md) | Recursive agent construction |
296
+ | [Structured Output](./docs/STRUCTURED_OUTPUT.md) | JSON schema validation |
297
+ | [Evaluation Framework](./docs/EVALUATION_FRAMEWORK.md) | Testing and quality assurance |
298
+
299
+ ### Storage & Memory
300
+
301
+ | Guide | Description |
302
+ |-------|-------------|
303
+ | [RAG Configuration](./docs/RAG_MEMORY_CONFIGURATION.md) | Memory and retrieval setup |
304
+ | [SQL Storage](./docs/SQL_STORAGE_QUICKSTART.md) | SQLite/PostgreSQL setup |
305
+ | [Client-Side Storage](./docs/CLIENT_SIDE_STORAGE.md) | Browser storage options |
306
+ | [Migration Guide](./docs/MIGRATION_TO_STORAGE_ADAPTER.md) | Upgrading storage adapters |
307
+
308
+ ### Operations
309
+
310
+ | Guide | Description |
311
+ |-------|-------------|
312
+ | [Cost Optimization](./docs/COST_OPTIMIZATION.md) | Token usage and cost management |
313
+ | [Platform Support](./docs/PLATFORM_SUPPORT.md) | Supported platforms and environments |
314
+ | [Releasing](./docs/RELEASING.md) | How to publish new versions |
315
+ | [API Reference](./docs/api/index.html) | TypeDoc-generated API docs |
290
316
  ---
291
317
 
292
318
  ## Examples
package/dist/cognitive_substrate/personas/definitions/atlas_systems_architect.json CHANGED
@@ -2,8 +2,8 @@
2
2
  "id": "atlas-systems-architect",
3
3
  "version": "1.0.0",
4
4
  "name": "Atlas - Systems Architect",
5
- "role": "system",
6
- "systemPrompt": "You are Atlas, an expert systems architect and technical consultant. You excel at designing scalable, maintainable software architectures. You help users understand system design patterns, make architectural decisions, and plan technical implementations.\n\nYour approach:\n- Break down complex systems into understandable components\n- Consider scalability, reliability, and maintainability\n- Recommend industry best practices and proven patterns\n- Explain trade-offs clearly\n- Provide actionable implementation guidance\n\nYou communicate technical concepts clearly and help users navigate architectural decisions with confidence.",
5
+ "description": "Expert systems architect for technical design and architecture decisions",
6
+ "baseSystemPrompt": "You are Atlas, an expert systems architect and technical consultant. You excel at designing scalable, maintainable software architectures. You help users understand system design patterns, make architectural decisions, and plan technical implementations.\n\nYour approach:\n- Break down complex systems into understandable components\n- Consider scalability, reliability, and maintainability\n- Recommend industry best practices and proven patterns\n- Explain trade-offs clearly\n- Provide actionable implementation guidance\n\nYou communicate technical concepts clearly and help users navigate architectural decisions with confidence.",
7
7
  "modelPreference": {
8
8
  "primary": "openai/gpt-4o",
9
9
  "fallback": "openai/gpt-4o-mini"
package/dist/index.d.ts CHANGED
@@ -46,4 +46,5 @@ export { createLogger, setLoggerFactory, resetLoggerFactory } from './logging/lo
46
46
  export * from './types/rateLimitTypes';
47
47
  export * from './core/storage';
48
48
  export * from './rag';
49
+ export { EXTENSION_SECRET_DEFINITIONS, type ExtensionSecretDefinition, getSecretDefinition, resolveSecretForProvider, } from './config/extensionSecrets.js';
49
50
  //# sourceMappingURL=index.d.ts.map
package/dist/index.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iDAAiD,CAAC;AAChE,cAAc,yCAAyC,CAAC;AACxD,cAAc,mCAAmC,CAAC;AAClD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,yCAAyC,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AAEvF,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,YAAY,EACV,uBAAuB,EACvB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,YAAY,EACV,sBAAsB,EACtB,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,sCAAsC,CAAC;AAE9C,cAAc,iBAAiB,CAAC;AAEhC,cAAc,aAAa,CAAC;AAE5B,cAAc,mBAAmB,CAAC;AAElC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,sBAAsB,CAAC;AAErC,cAAc,mBAAmB,CAAC;AAElC,cAAc,kBAAkB,CAAC;AAEjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4CAA4C,CAAC;AAC3D,cAAc,4DAA4D,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,8DAA8D,CAAC;AACrG,cAAc,cAAc,CAAC;AAE7B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,YAAY,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7F,cAAc,wBAAwB,CAAC;AAEvC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,OAAO,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iDAAiD,CAAC;AAChE,cAAc,yCAAyC,CAAC;AACxD,cAAc,mCAAmC,CAAC;AAClD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,yCAAyC,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AAEvF,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,YAAY,EACV,uBAAuB,EACvB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,YAAY,EACV,sBAAsB,EACtB,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,sCAAsC,CAAC;AAE9C,cAAc,iBAAiB,CAAC;AAEhC,cAAc,aAAa,CAAC;AAE5B,cAAc,mBAAmB,CAAC;AAElC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,sBAAsB,CAAC;AAErC,cAAc,mBAAmB,CAAC;AAElC,cAAc,kBAAkB,CAAC;AAEjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4CAA4C,CAAC;AAC3D,cAAc,4DAA4D,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,8DAA8D,CAAC;AACrG,cAAc,cAAc,CAAC;AAE7B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,YAAY,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7F,cAAc,wBAAwB,CAAC;AAEvC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,OAAO,CAAC;AAEtB,OAAO,EACL,4BAA4B,EAC5B,KAAK,yBAAyB,EAC9B,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,8BAA8B,CAAC"}
package/dist/index.js CHANGED
@@ -56,4 +56,6 @@ export * from './types/rateLimitTypes.js';
56
56
  export * from './core/storage/index.js';
57
57
  // RAG (Retrieval Augmented Generation)
58
58
  export * from './rag/index.js';
59
+ // Extension Secrets Catalog
60
+ export { EXTENSION_SECRET_DEFINITIONS, getSecretDefinition, resolveSecretForProvider, } from './config/extensionSecrets.js';
59
61
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iDAAiD,CAAC;AAChE,cAAc,yCAAyC,CAAC;AACxD,cAAc,mCAAmC,CAAC;AAClD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,yCAAyC,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,mCAAmC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAOxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAU5E,kBAAkB;AAClB,cAAc,iBAAiB,CAAC;AAChC,2BAA2B;AAC3B,cAAc,aAAa,CAAC;AAC5B,qDAAqD;AACrD,cAAc,mBAAmB,CAAC;AAClC,yBAAyB;AACzB,cAAc,gBAAgB,CAAC;AAC/B,0BAA0B;AAC1B,cAAc,sBAAsB,CAAC;AACrC,uBAAuB;AACvB,cAAc,mBAAmB,CAAC;AAClC,kBAAkB;AAClB,cAAc,kBAAkB,CAAC;AACjC,oBAAoB;AACpB,cAAc,oBAAoB,CAAC;AACnC,cAAc,4CAA4C,CAAC;AAC3D,cAAc,4DAA4D,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,8DAA8D,CAAC;AACrG,cAAc,cAAc,CAAC;AAC7B,uBAAuB;AACvB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7F,mBAAmB;AACnB,cAAc,wBAAwB,CAAC;AACvC,mBAAmB;AACnB,cAAc,gBAAgB,CAAC;AAC/B,uCAAuC;AACvC,cAAc,OAAO,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iDAAiD,CAAC;AAChE,cAAc,yCAAyC,CAAC;AACxD,cAAc,mCAAmC,CAAC;AAClD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,yCAAyC,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,mCAAmC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAOxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAU5E,kBAAkB;AAClB,cAAc,iBAAiB,CAAC;AAChC,2BAA2B;AAC3B,cAAc,aAAa,CAAC;AAC5B,qDAAqD;AACrD,cAAc,mBAAmB,CAAC;AAClC,yBAAyB;AACzB,cAAc,gBAAgB,CAAC;AAC/B,0BAA0B;AAC1B,cAAc,sBAAsB,CAAC;AACrC,uBAAuB;AACvB,cAAc,mBAAmB,CAAC;AAClC,kBAAkB;AAClB,cAAc,kBAAkB,CAAC;AACjC,oBAAoB;AACpB,cAAc,oBAAoB,CAAC;AACnC,cAAc,4CAA4C,CAAC;AAC3D,cAAc,4DAA4D,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,8DAA8D,CAAC;AACrG,cAAc,cAAc,CAAC;AAC7B,uBAAuB;AACvB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7F,mBAAmB;AACnB,cAAc,wBAAwB,CAAC;AACvC,mBAAmB;AACnB,cAAc,gBAAgB,CAAC;AAC/B,uCAAuC;AACvC,cAAc,OAAO,CAAC;AACtB,4BAA4B;AAC5B,OAAO,EACL,4BAA4B,EAE5B,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,8BAA8B,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@framers/agentos",
3
- "version": "0.1.0",
3
+ "version": "0.1.2",
4
4
  "description": "Modular AgentOS orchestration library",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",