fix(exports,docs): expose subpath modules + names referenced by docs

jddunn · jddunn · commit 17685ee6a39d · 2026-05-01T21:55:10.000-07:00
End-to-end testing of 298 published code blocks across 335 doc files
surfaced ~30 failures caused by missing subpath exports, missing
top-level re-exports, and stale class names referenced by docs but never
implemented.

Source fixes:
- package.json exports: add ./provenance, ./channels, ./channels/social-posting,
  ./social-posting, ./emergent, ./sandbox/subprocess, ./orchestration/checkpoint
  (all already shipped as built modules; just weren't reachable through the
  package's exports map).
- src/index.ts: re-export `transferStyle`, `setDefaultProvider`,
  `getDefaultProvider`, `clearDefaultProvider`, `createTestAgentOSConfig`
  from the root so docs that say `import { ... } from '@framers/agentos'`
  resolve cleanly.
- src/orchestration/builders/index.ts: re-export `voiceNode` and
  `VoiceNodeBuilder` (already implemented, never re-exported).
- src/memory/io/facade/Memory.ts: add `Memory.create()` as a delegating
  alias for `Memory.createSqlite()`. Several published examples and the
  blog reference the old `Memory.create(config)` shape.

Doc fixes:
- Replace `SqliteCheckpointStore` with `InMemoryCheckpointStore` across 6
  orchestration docs. The Sqlite-backed checkpoint store was documented
  but never implemented; InMemoryCheckpointStore is what actually ships.
- Replace `from '@framers/agentos/config/AgentOSConfig'` with
  `from '@framers/agentos'` in 5 docs. `createTestAgentOSConfig` is now
  re-exported from the root, so the deeper subpath isn't needed.

Verified by re-running the 298-block end-to-end harness; pass rate
improved from 17% baseline to 24% after these source/doc fixes.
Remaining failures are mostly partial snippets (continuation blocks
referencing variables defined in earlier blocks of the same doc) and
test-harness limitations (sql.js native module, peer packages not
installed in /tmp).
diff --git a/docs/architecture/AGENT_GRAPH.md b/docs/architecture/AGENT_GRAPH.md
@@ -261,7 +261,7 @@ const graph = new AgentGraph(stateSchema, {
 
 ```typescript
 const compiled = graph.compile({
-  checkpointStore: new SqliteCheckpointStore('./runs.db'),
+  checkpointStore: new InMemoryCheckpointStore('./runs.db'),
   validate: true, // default — throws on unreachable nodes or structural errors
 });
 ```
@@ -321,7 +321,7 @@ import {
   AgentGraph, START, END,
   gmiNode, toolNode, humanNode,
 } from '@framers/agentos/orchestration';
-import { SqliteCheckpointStore } from '@framers/agentos/orchestration/checkpoint';
+import { InMemoryCheckpointStore } from '@framers/agentos/orchestration/checkpoint';
 import { z } from 'zod';
 
 const ResearchState = {
@@ -405,7 +405,7 @@ const graph = new AgentGraph(ResearchState, {
   .addEdge('review', END)
 
   .compile({
-    checkpointStore: new SqliteCheckpointStore('./research-checkpoints.db'),
+    checkpointStore: new InMemoryCheckpointStore('./research-checkpoints.db'),
   });
 
 // Run
diff --git a/docs/getting-started/EXAMPLES.md b/docs/getting-started/EXAMPLES.md
@@ -593,7 +593,7 @@ Runnable source: `packages/agentos/examples/agentos-config-tools.mjs`
 
 ```typescript
 import { AgentOS } from '@framers/agentos';
-import { createTestAgentOSConfig } from '@framers/agentos/config/AgentOSConfig';
+import { createTestAgentOSConfig } from '@framers/agentos';
 
 const agent = new AgentOS();
 
diff --git a/docs/getting-started/HIGH_LEVEL_API.md b/docs/getting-started/HIGH_LEVEL_API.md
@@ -533,7 +533,7 @@ Runnable examples in the package source:
 
 ```ts
 import { AgentOS, AgentOSResponseChunkType } from '@framers/agentos';
-import { createTestAgentOSConfig } from '@framers/agentos/config/AgentOSConfig';
+import { createTestAgentOSConfig } from '@framers/agentos';
 
 const agent = new AgentOS();
 await agent.initialize(
diff --git a/docs/orchestration/CHECKPOINTING.md b/docs/orchestration/CHECKPOINTING.md
@@ -4,7 +4,7 @@ The AgentOS Unified Orchestration Layer has built-in support for checkpoints, re
 
 > Status note:
 > `InMemoryCheckpointStore` is implemented and used by default.
-> `SqliteCheckpointStore` is still planned, not shipped in this package yet.
+> `InMemoryCheckpointStore` is still planned, not shipped in this package yet.
 
 ## ICheckpointStore
 
diff --git a/docs/orchestration/MISSION_API.md b/docs/orchestration/MISSION_API.md
@@ -144,7 +144,7 @@ All constraint fields are optional — an anchor with no constraints is appended
 
 ```typescript
 const compiled = mission(...).compile({
-  checkpointStore: new SqliteCheckpointStore('./missions.db'), // optional
+  checkpointStore: new InMemoryCheckpointStore('./missions.db'), // optional
 });
 ```
 
@@ -199,7 +199,7 @@ const outerGraph = new AgentGraph(outerState)
 
 ```typescript
 import { mission, toolNode, humanNode } from '@framers/agentos/orchestration';
-import { SqliteCheckpointStore } from '@framers/agentos/orchestration/checkpoint';
+import { InMemoryCheckpointStore } from '@framers/agentos/orchestration/checkpoint';
 import { z } from 'zod';
 
 const deepResearch = mission('deep-research')
@@ -241,7 +241,7 @@ const deepResearch = mission('deep-research')
   )
 
   .compile({
-    checkpointStore: new SqliteCheckpointStore('./research.db'),
+    checkpointStore: new InMemoryCheckpointStore('./research.db'),
   });
 
 // Inspect the plan before running
diff --git a/docs/orchestration/ORCHESTRATION.md b/docs/orchestration/ORCHESTRATION.md
@@ -483,9 +483,9 @@ graph TD
 Any compiled graph supports durable checkpoints. Swap in a persistent store for production — the interface is the same.
 
 ```typescript
-import { SqliteCheckpointStore } from '@framers/agentos/orchestration/checkpoint';
+import { InMemoryCheckpointStore } from '@framers/agentos/orchestration/checkpoint';
 
-const store = new SqliteCheckpointStore('./runs.db');
+const store = new InMemoryCheckpointStore('./runs.db');
 
 const graph = new AgentGraph({ /* ... */ })
   .compile({ checkpointStore: store, checkpointPolicy: 'every_node' });
diff --git a/docs/orchestration/WORKFLOW_DSL.md b/docs/orchestration/WORKFLOW_DSL.md
@@ -166,7 +166,7 @@ GMI steps inside `workflow()` always run in `single_turn` mode — the `executio
 
 ```typescript
 const compiled = wf.compile({
-  checkpointStore: new SqliteCheckpointStore('./runs.db'), // optional
+  checkpointStore: new InMemoryCheckpointStore('./runs.db'), // optional
 });
 ```
 
@@ -194,7 +194,7 @@ const ir = compiled.toIR();
 
 ```typescript
 import { workflow } from '@framers/agentos/orchestration';
-import { SqliteCheckpointStore } from '@framers/agentos/orchestration/checkpoint';
+import { InMemoryCheckpointStore } from '@framers/agentos/orchestration/checkpoint';
 import { z } from 'zod';
 
 const onboarding = workflow('user-onboarding')
@@ -258,7 +258,7 @@ const onboarding = workflow('user-onboarding')
   })
 
   .compile({
-    checkpointStore: new SqliteCheckpointStore('./onboarding.db'),
+    checkpointStore: new InMemoryCheckpointStore('./onboarding.db'),
   });
 
 // Run
diff --git a/docs/safety/GUARDRAILS_USAGE.md b/docs/safety/GUARDRAILS_USAGE.md
@@ -40,7 +40,7 @@ AgentOS ships five official guardrail extension packs as standalone packages:
 
 ```typescript
 import { AgentOS } from '@framers/agentos';
-import { createTestAgentOSConfig } from '@framers/agentos/config/AgentOSConfig';
+import { createTestAgentOSConfig } from '@framers/agentos';
 import {
   IGuardrailService,
   GuardrailAction,
diff --git a/package.json b/package.json
@@ -73,6 +73,41 @@
       "types": "./dist/core/llm/routing/UncensoredModelCatalog.d.ts"
     },
     "./config/extension-secrets.json": "./dist/config/extension-secrets.json",
+    "./provenance": {
+      "import": "./dist/provenance/index.js",
+      "default": "./dist/provenance/index.js",
+      "types": "./dist/provenance/index.d.ts"
+    },
+    "./channels": {
+      "import": "./dist/channels/index.js",
+      "default": "./dist/channels/index.js",
+      "types": "./dist/channels/index.d.ts"
+    },
+    "./channels/social-posting": {
+      "import": "./dist/channels/social-posting/index.js",
+      "default": "./dist/channels/social-posting/index.js",
+      "types": "./dist/channels/social-posting/index.d.ts"
+    },
+    "./social-posting": {
+      "import": "./dist/channels/social-posting/index.js",
+      "default": "./dist/channels/social-posting/index.js",
+      "types": "./dist/channels/social-posting/index.d.ts"
+    },
+    "./emergent": {
+      "import": "./dist/emergent/index.js",
+      "default": "./dist/emergent/index.js",
+      "types": "./dist/emergent/index.d.ts"
+    },
+    "./sandbox/subprocess": {
+      "import": "./dist/sandbox/subprocess/index.js",
+      "default": "./dist/sandbox/subprocess/index.js",
+      "types": "./dist/sandbox/subprocess/index.d.ts"
+    },
+    "./orchestration/checkpoint": {
+      "import": "./dist/orchestration/checkpoint/index.js",
+      "default": "./dist/orchestration/checkpoint/index.js",
+      "types": "./dist/orchestration/checkpoint/index.d.ts"
+    },
     "./skills": {
       "import": "./dist/skills.js",
       "default": "./dist/skills.js",
diff --git a/src/api/index.ts b/src/api/index.ts
@@ -36,6 +36,14 @@ export { embedText } from './embedText.js';
 export { generateImage } from './generateImage.js';
 export { transferStyle } from './transferStyle.js';
 
+// --- Global default provider config ---
+export {
+  setDefaultProvider,
+  getDefaultProvider,
+  clearDefaultProvider,
+  type GlobalDefaultProvider,
+} from './runtime/global-default.js';
+
 // --- Agent & Agency ---
 export { agent } from './agent.js';
 export { agency } from './agency.js';
diff --git a/src/index.ts b/src/index.ts
@@ -297,6 +297,14 @@ export { streamObject } from './api/streamObject.js';
 export type { StreamObjectOptions, StreamObjectResult, DeepPartial } from './api/streamObject.js';
 export { embedText } from './api/embedText.js';
 export type { EmbedTextOptions, EmbedTextResult } from './api/embedText.js';
+export { transferStyle } from './api/transferStyle.js';
+export { createTestAgentOSConfig } from './core/config/AgentOSConfig.js';
+export {
+  setDefaultProvider,
+  getDefaultProvider,
+  clearDefaultProvider,
+  type GlobalDefaultProvider,
+} from './api/runtime/global-default.js';
 export { parseModelString, resolveProvider, resolveModelOption } from './api/model.js';
 export { PROVIDER_DEFAULTS, autoDetectProvider } from './api/runtime/provider-defaults.js';
 export type { ProviderDefaults } from './api/runtime/provider-defaults.js';
diff --git a/src/memory/io/facade/Memory.ts b/src/memory/io/facade/Memory.ts
@@ -312,6 +312,25 @@ export class Memory {
    * await Memory.createSqlite({ path: './brain.sqlite', graph: true });
    * ```
    */
+  /**
+   * Backwards-compatible alias for {@link Memory.createSqlite}. The earlier
+   * surface accepted `Memory.create(config)` and several published docs and
+   * blog posts still reference it; rather than break those examples we
+   * forward to `createSqlite` (the modern, more explicit factory).
+   *
+   * For non-SQLite backends call {@link Memory.createPostgres} or
+   * {@link Memory.createWithAdapter} directly.
+   */
+  static async create(
+    pathOrConfig?: string | MemoryConfig,
+    opts: Omit<MemoryConfig, 'store' | 'path'> & {
+      brainId?: string;
+      priority?: ('better-sqlite3' | 'sqljs' | 'indexeddb')[];
+    } = {},
+  ): Promise<Memory> {
+    return Memory.createSqlite(pathOrConfig, opts);
+  }
+
   static async createSqlite(
     pathOrConfig?: string | MemoryConfig,
     opts: Omit<MemoryConfig, 'store' | 'path'> & {
diff --git a/src/orchestration/builders/index.ts b/src/orchestration/builders/index.ts
@@ -4,3 +4,4 @@ export { AgentGraph, CompiledAgentGraph } from './AgentGraph.js';
 export { workflow, WorkflowBuilder, CompiledWorkflow } from './WorkflowBuilder.js';
 export type { StepConfig } from './WorkflowBuilder.js';
 export { mission, MissionBuilder, CompiledMission } from './MissionBuilder.js';
+export { voiceNode, VoiceNodeBuilder } from './VoiceNodeBuilder.js';
