@manifesto-ai/sdk 0.1.0 → 1.2.0

package/README.md

@@ -1,66 +1,31 @@
 # @manifesto-ai/sdk
 
-> **SDK** is the public developer API layer for Manifesto applications. It presents ergonomic factory functions, lifecycle management, and hook systems while delegating all execution to the Runtime.
-
-> **Phase 1 Notice:** During the current phase, most users should install `@manifesto-ai/app`, which re-exports all SDK APIs. See [ADR-007](../../docs/internals/adr/007-sdk-runtime-split-kickoff.md) for details.
+> **SDK** is the canonical public developer API for Manifesto applications.
 
 ---
 
-## What is SDK?
+## Overview
 
-SDK owns the public contract shape that developers interact with. It provides `createApp()`, the `App` interface, and the hook system — but delegates all orchestration to `@manifesto-ai/runtime`.
+SDK owns the public contract for app creation and interaction.
+It provides `createApp()`, `createTestApp()`, `ManifestoApp`, and the hook primitives while delegating orchestration to Runtime.
 
-```
+```text
 Application Code
       |
       v
-    SDK (createApp, App, Hooks)       <-- you are here
+SDK (createApp, App, Hooks)
       |
       v
-    Runtime (orchestration, execution)
+Runtime (orchestration)
       |
       v
-    Core / Host / World
+Core / Host / World
 ```
 
 ---
 
-## What SDK Does
-
-| Responsibility | Description |
-|----------------|-------------|
-| App factory | `createApp(config)` — single entry point for creating apps |
-| App interface | `ManifestoApp` — thin facade over Runtime |
-| Lifecycle | `ready()` / `dispose()` with status tracking |
-| Hook system | Observable lifecycle with re-entrancy guards |
-| AppRef | Read-only facade for safe hook access |
-| Job queue | Deferred execution for hook-triggered actions |
-| Test helper | `createTestApp()` — minimal app for testing |
-
----
-
-## What SDK Does NOT Do
-
-| NOT Responsible For | Who Is |
-|--------------------|--------|
-| Execution orchestration | Runtime |
-| Effect execution | Host (via Runtime) |
-| Pure state computation | Core (via Runtime) |
-| Governance and lineage | World (via Runtime) |
-| Type/error definitions | Runtime |
-
----
-
 ## Installation
 
-During **Phase 1**, use `@manifesto-ai/app` as the canonical entry point:
-
-```bash
-pnpm add @manifesto-ai/app
-```
-
-For direct SDK access (preview):
-
 ```bash
 pnpm add @manifesto-ai/sdk
 ```
@@ -75,105 +40,65 @@ import { createApp } from "@manifesto-ai/sdk";
 const app = createApp({
   schema: counterSchema,
   effects: {
-    "api.save": async (params, ctx) => [
+    "api.save": async (params) => [
       { op: "set", path: "data.savedAt", value: params.timestamp },
     ],
   },
 });
 
 await app.ready();
-
-const handle = app.act("increment");
-await handle.completed();
-
-console.log(app.getState().data.count); // 1
+await app.act("increment").done();
+console.log(app.getState().data.count);
 ```
 
 ---
 
-## Core API
+## Main Exports
 
-### Factory Functions
+### Factory
 
 ```typescript
 function createApp(config: AppConfig): App;
 function createTestApp(domain: DomainSchema | string, opts?: Partial<AppConfig>): App;
 ```
 
-### App Interface
+### Class
 
 ```typescript
-interface App {
-  // Lifecycle
-  ready(): Promise<void>;
-  dispose(opts?): Promise<void>;
-  readonly status: AppStatus;
-  readonly hooks: Hookable<AppHooks>;
-
-  // Schema
-  getDomainSchema(): DomainSchema;
-
-  // Actions
-  act(type: string, input?: unknown, opts?): ActionHandle;
-  submitProposal(proposal): Promise<ProposalResult>;
-
-  // State
-  getState<T>(): AppState<T>;
-  subscribe(selector, listener, opts?): () => void;
-  getSnapshot(): Snapshot;
-
-  // Session
-  session(actorId: string, opts?): Session;
-
-  // Branch
-  currentBranch(): Branch;
-  listBranches(): Branch[];
-  switchBranch(branchId): Promise<void>;
-  fork(opts?): Promise<Branch>;
-
-  // World Query
-  getCurrentHead(): WorldId;
-  getWorld(worldId?): World;
-}
+class ManifestoApp implements App { /* ... */ }
 ```
 
-> See [sdk-SPEC-v0.1.0.md](docs/sdk-SPEC-v0.1.0.md) for the complete specification.
+### Runtime-Reexported Public Types/Errors
+
+SDK re-exports public contract types and errors (for example `AppConfig`, `AppState`, `ActionHandle`, `AppNotReadyError`).
 
 ---
 
 ## Relationship with Other Packages
 
-```
-App (facade) -> SDK -> Runtime -> Core / Host / World
-```
-
 | Relationship | Package | How |
 |--------------|---------|-----|
-| Re-exported by | `@manifesto-ai/app` | App re-exports createApp, createTestApp, hooks |
-| Delegates to | `@manifesto-ai/runtime` | All orchestration via AppRuntime |
-| Depends on | `@manifesto-ai/core` | Schema types |
-| Depends on | `@manifesto-ai/world` | World types |
+| Delegates to | `@manifesto-ai/runtime` | All orchestration via runtime pipeline |
+| Uses | `@manifesto-ai/core` | Schema and expression types |
+| Uses | `@manifesto-ai/world` | World protocol types |
+| Legacy predecessor | App facade package | Removed in R2 (see API retirement record) |
 
 ---
 
-## When to Use SDK Directly
+## Migration from Legacy App Facade
 
-**Most users should use `@manifesto-ai/app` during Phase 1.**
+Legacy app-facade imports should be replaced with `@manifesto-ai/sdk`.
 
-Use SDK directly when:
-- Building custom integrations that need only the public API surface
-- Creating framework-specific wrappers (React, Vue, etc.)
-- After Phase 2 transition when SDK becomes the primary entry point
+For automated rewrite guidance, see:
+- [docs/guides/migrate-app-to-sdk.md](../../docs/guides/migrate-app-to-sdk.md)
 
 ---
 
 ## Documentation
 
-| Document | Purpose |
-|----------|---------|
-| [sdk-SPEC-v0.1.0.md](docs/sdk-SPEC-v0.1.0.md) | Complete specification |
-| [VERSION-INDEX.md](docs/VERSION-INDEX.md) | Version history and reading guide |
-| [ADR-007](../../docs/internals/adr/007-sdk-runtime-split-kickoff.md) | Split rationale |
+- [sdk-SPEC-v0.1.0.md](docs/sdk-SPEC-v0.1.0.md)
+- [VERSION-INDEX.md](docs/VERSION-INDEX.md)
+- [ADR-008](../../docs/internals/adr/008-sdk-first-transition-and-app-retirement.md)
 
 ---
 

package/dist/__tests__/bootstrap.test.js

@@ -1,4 +1,5 @@
 import { describe, it, expect } from 'vitest';
+import * as sdk from '../index.js';
 describe('@manifesto-ai/sdk bootstrap', () => {
     it('SdkManifest type is importable and structurally correct', () => {
         // Type-level verification: the manifest type constrains to expected shape
@@ -11,24 +12,22 @@ describe('@manifesto-ai/sdk bootstrap', () => {
         expect(manifest.specVersion).toBe('0.1.0');
         expect(manifest.phase).toBe('bootstrap');
     });
-    it('package entry point resolves without error', async () => {
-        const mod = await import('../index.js');
-        expect(mod).toBeDefined();
+    it('package entry point resolves without error', () => {
+        expect(sdk).toBeDefined();
     });
-    it('exports SDK components', async () => {
-        const mod = await import('../index.js');
+    it('exports SDK components', () => {
         // App Factory
-        expect(mod.createApp).toBeDefined();
-        expect(mod.createTestApp).toBeDefined();
+        expect(sdk.createApp).toBeDefined();
+        expect(sdk.createTestApp).toBeDefined();
         // ManifestoApp
-        expect(mod.ManifestoApp).toBeDefined();
+        expect(sdk.ManifestoApp).toBeDefined();
         // Hooks
-        expect(mod.AppRefImpl).toBeDefined();
-        expect(mod.createAppRef).toBeDefined();
-        expect(mod.HookableImpl).toBeDefined();
-        expect(mod.JobQueue).toBeDefined();
-        expect(mod.HookContextImpl).toBeDefined();
-        expect(mod.createHookContext).toBeDefined();
+        expect(sdk.AppRefImpl).toBeDefined();
+        expect(sdk.createAppRef).toBeDefined();
+        expect(sdk.HookableImpl).toBeDefined();
+        expect(sdk.JobQueue).toBeDefined();
+        expect(sdk.HookContextImpl).toBeDefined();
+        expect(sdk.createHookContext).toBeDefined();
     });
 });
 //# sourceMappingURL=bootstrap.test.js.map

package/dist/__tests__/bootstrap.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.test.js","sourceRoot":"","sources":["../../src/__tests__/bootstrap.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAG9C,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,0EAA0E;QAC1E,MAAM,QAAQ,GAAgB;YAC5B,IAAI,EAAE,mBAAmB;YACzB,WAAW,EAAE,OAAO;YACpB,KAAK,EAAE,WAAW;SACnB,CAAC;QAEF,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAChD,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;QACtC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QAExC,cAAc;QACd,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;QAExC,eAAe;QACf,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;QAEvC,QAAQ;QACR,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"bootstrap.test.js","sourceRoot":"","sources":["../../src/__tests__/bootstrap.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC;AAGnC,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,0EAA0E;QAC1E,MAAM,QAAQ,GAAgB;YAC5B,IAAI,EAAE,mBAAmB;YACzB,WAAW,EAAE,OAAO;YACpB,KAAK,EAAE,WAAW;SACnB,CAAC;QAEF,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAChD,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,cAAc;QACd,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;QAExC,eAAe;QACf,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;QAEvC,QAAQ;QACR,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/public-exports.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=public-exports.test.d.ts.map

package/dist/__tests__/public-exports.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-exports.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/public-exports.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/public-exports.test.js

@@ -0,0 +1,58 @@
+import { describe, expect, it } from 'vitest';
+import * as sdk from '../index.js';
+describe('sdk public exports contract', () => {
+    it('exposes the expected runtime value exports only', () => {
+        const exportedKeys = Object.keys(sdk).sort();
+        const expectedKeys = [
+            'ActionFailedError',
+            'ActionNotFoundError',
+            'ActionPreparationError',
+            'ActionRejectedError',
+            'ActionTimeoutError',
+            'AppDisposedError',
+            'AppNotReadyError',
+            'AppRefImpl',
+            'BranchHeadNotFoundError',
+            'BranchNotFoundError',
+            'DomainCompileError',
+            'HandleDetachedError',
+            'HookContextImpl',
+            'HookMutationError',
+            'HookableImpl',
+            'JobQueue',
+            'ManifestoApp',
+            'ManifestoAppError',
+            'MemoryDisabledError',
+            'MissingDefaultActorError',
+            'PluginInitError',
+            'ReservedEffectTypeError',
+            'ReservedNamespaceError',
+            'SchemaMismatchOnResumeError',
+            'SystemActionDisabledError',
+            'SystemActionRoutingError',
+            'WorldNotFoundError',
+            'WorldNotInLineageError',
+            'WorldSchemaHashMismatchError',
+            'createApp',
+            'createAppRef',
+            'createHookContext',
+            'createTestApp',
+        ].sort();
+        expect(exportedKeys).toEqual(expectedKeys);
+    });
+    it('does not expose non-contract helpers from former app facade', () => {
+        const forbidden = [
+            'createSilentPolicyService',
+            'createStrictPolicyService',
+            'createDefaultPolicyService',
+            'createInMemoryWorldStore',
+            'withDxAliases',
+            'validateSchemaCompatibility',
+            'withPlatformNamespaces',
+        ];
+        for (const key of forbidden) {
+            expect(sdk[key]).toBeUndefined();
+        }
+    });
+});
+//# sourceMappingURL=public-exports.test.js.map

package/dist/__tests__/public-exports.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-exports.test.js","sourceRoot":"","sources":["../../src/__tests__/public-exports.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC;AAEnC,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAE7C,MAAM,YAAY,GAAG;YACnB,mBAAmB;YACnB,qBAAqB;YACrB,wBAAwB;YACxB,qBAAqB;YACrB,oBAAoB;YACpB,kBAAkB;YAClB,kBAAkB;YAClB,YAAY;YACZ,yBAAyB;YACzB,qBAAqB;YACrB,oBAAoB;YACpB,qBAAqB;YACrB,iBAAiB;YACjB,mBAAmB;YACnB,cAAc;YACd,UAAU;YACV,cAAc;YACd,mBAAmB;YACnB,qBAAqB;YACrB,0BAA0B;YAC1B,iBAAiB;YACjB,yBAAyB;YACzB,wBAAwB;YACxB,6BAA6B;YAC7B,2BAA2B;YAC3B,0BAA0B;YAC1B,oBAAoB;YACpB,wBAAwB;YACxB,8BAA8B;YAC9B,WAAW;YACX,cAAc;YACd,mBAAmB;YACnB,eAAe;SAChB,CAAC,IAAI,EAAE,CAAC;QAET,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,SAAS,GAAG;YAChB,2BAA2B;YAC3B,2BAA2B;YAC3B,4BAA4B;YAC5B,0BAA0B;YAC1B,eAAe;YACf,6BAA6B;YAC7B,wBAAwB;SACzB,CAAC;QAEF,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC5B,MAAM,CAAE,GAA+B,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QAChE,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,12 +1,15 @@
 /**
- * @manifesto-ai/sdk v0.1.0
+ * @manifesto-ai/sdk v1.0.0
  *
  * Public developer API layer for the Manifesto protocol stack.
+ * Canonical entry point since Phase 2 (ADR-008).
  *
  * @see sdk-SPEC-v0.1.0.md
  * @packageDocumentation
  */
 export type { SdkManifest } from './manifest.js';
+export type { AppStatus, RuntimeKind, Unsubscribe, ActionPhase, ActionResult, CompletedActionResult, RejectedActionResult, FailedActionResult, PreparationFailedActionResult, ExecutionStats, ActionUpdate, ActionUpdateDetail, ActorPolicyConfig, SystemActionsConfig, DisposeOptions, DoneOptions, ActOptions, ForkOptions, SessionOptions, SubscribeOptions, LineageOptions, AppState, SystemState, SnapshotMeta, MemoryHubConfig, BackfillConfig, RecallRequest, RecallResult, MemoryMaintenanceOptions, MigrationLink, MigrationContext, MigrationFn, App, ActionHandle, Branch, Session, MemoryFacade, SystemFacade, SystemMemoryFacade, Hookable, HookContext, EnqueueOptions, AppPlugin, AppHooks, MemoryProvider, MemoryVerifier, MemoryIngestEntry, MemorySelectionView, ProveResult, Requirement, AppConfig, AppRef, Proposal, ProposalResult, ExecutionKey, ExecutionKeyPolicy, ProposalId, ActorId, BranchId, ApprovedScope, AuthorityDecision, PolicyService, ArtifactRef, Intent, SchemaCompatibilityResult, MemoryStore, StoredMemoryRecord, MemoryRecordInput, MemoryFilter, World, WorldId, Snapshot, Patch, WorldHead, Effects, AppEffectContext, EffectHandler, ErrorValue, MelText, } from '@manifesto-ai/runtime';
+export { ManifestoAppError, AppNotReadyError, AppDisposedError, ActionRejectedError, ActionFailedError, ActionPreparationError, ActionTimeoutError, ActionNotFoundError, HandleDetachedError, HookMutationError, ReservedEffectTypeError, SystemActionDisabledError, SystemActionRoutingError, MemoryDisabledError, BranchNotFoundError, WorldNotFoundError, WorldSchemaHashMismatchError, WorldNotInLineageError, ReservedNamespaceError, MissingDefaultActorError, DomainCompileError, PluginInitError, SchemaMismatchOnResumeError, BranchHeadNotFoundError, } from '@manifesto-ai/runtime';
 export { createApp, createTestApp } from './create-app.js';
 export { ManifestoApp } from './app.js';
 export { AppRefImpl, createAppRef } from './hooks/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAMjD,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAM3D,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAMxC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC5D,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAMjD,YAAY,EAEV,SAAS,EACT,WAAW,EACX,WAAW,EAGX,WAAW,EAGX,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,6BAA6B,EAC7B,cAAc,EAGd,YAAY,EACZ,kBAAkB,EAGlB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,cAAc,EAGd,QAAQ,EACR,WAAW,EACX,YAAY,EAGZ,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,wBAAwB,EAGxB,aAAa,EACb,gBAAgB,EAChB,WAAW,EAGX,GAAG,EACH,YAAY,EACZ,MAAM,EACN,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,QAAQ,EACR,WAAW,EACX,cAAc,EAGd,SAAS,EAGT,QAAQ,EAGR,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EAGX,WAAW,EAGX,SAAS,EACT,MAAM,EACN,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,OAAO,EACP,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,MAAM,EACN,yBAAyB,EACzB,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,KAAK,EACL,OAAO,EACP,QAAQ,EACR,KAAK,EACL,SAAS,EAGT,OAAO,EACP,gBAAgB,EAChB,aAAa,EAGb,UAAU,EAGV,OAAO,GACR,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EAEL,iBAAiB,EAGjB,gBAAgB,EAChB,gBAAgB,EAGhB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EAGnB,iBAAiB,EAGjB,uBAAuB,EAGvB,yBAAyB,EACzB,wBAAwB,EAGxB,mBAAmB,EAGnB,mBAAmB,EACnB,kBAAkB,EAClB,4BAA4B,EAC5B,sBAAsB,EAGtB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,eAAe,EAGf,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAM3D,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAMxC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC5D,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,13 +1,46 @@
+/**
+ * @manifesto-ai/sdk v1.0.0
+ *
+ * Public developer API layer for the Manifesto protocol stack.
+ * Canonical entry point since Phase 2 (ADR-008).
+ *
+ * @see sdk-SPEC-v0.1.0.md
+ * @packageDocumentation
+ */
 // =============================================================================
-// App Factory (SDK-CREATE)
+// Public Errors (re-exported from Runtime)
+// =============================================================================
+export { 
+// Base
+ManifestoAppError, 
+// Lifecycle
+AppNotReadyError, AppDisposedError, 
+// Action
+ActionRejectedError, ActionFailedError, ActionPreparationError, ActionTimeoutError, ActionNotFoundError, HandleDetachedError, 
+// Hook
+HookMutationError, 
+// Effects
+ReservedEffectTypeError, 
+// System
+SystemActionDisabledError, SystemActionRoutingError, 
+// Memory
+MemoryDisabledError, 
+// Branch/World
+BranchNotFoundError, WorldNotFoundError, WorldSchemaHashMismatchError, WorldNotInLineageError, 
+// Other
+ReservedNamespaceError, MissingDefaultActorError, DomainCompileError, PluginInitError, 
+// Resume & Recovery
+SchemaMismatchOnResumeError, BranchHeadNotFoundError, } from '@manifesto-ai/runtime';
+// =============================================================================
+// App Factory
 // =============================================================================
 export { createApp, createTestApp } from './create-app.js';
 // =============================================================================
-// ManifestoApp (SDK-APP)
+// ManifestoApp
 // =============================================================================
 export { ManifestoApp } from './app.js';
 // =============================================================================
-// Hooks (SDK-HOOKS)
+// Hook Internals (public for advanced integrations)
 // =============================================================================
 export { AppRefImpl, createAppRef } from './hooks/index.js';
 export { HookableImpl } from './hooks/index.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAEhF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE3D,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA2HH,gFAAgF;AAChF,2CAA2C;AAC3C,gFAAgF;AAEhF,OAAO;AACL,OAAO;AACP,iBAAiB;AAEjB,YAAY;AACZ,gBAAgB,EAChB,gBAAgB;AAEhB,SAAS;AACT,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB;AAEnB,OAAO;AACP,iBAAiB;AAEjB,UAAU;AACV,uBAAuB;AAEvB,SAAS;AACT,yBAAyB,EACzB,wBAAwB;AAExB,SAAS;AACT,mBAAmB;AAEnB,eAAe;AACf,mBAAmB,EACnB,kBAAkB,EAClB,4BAA4B,EAC5B,sBAAsB;AAEtB,QAAQ;AACR,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,eAAe;AAEf,oBAAoB;AACpB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAE/B,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE3D,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,gFAAgF;AAChF,oDAAoD;AACpD,gFAAgF;AAEhF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@manifesto-ai/sdk",
-  "version": "0.1.0",
+  "version": "1.2.0",
   "description": "Manifesto SDK - Public developer API layer",
   "author": "eggplantiny <eggplantiny@gmail.com>",
   "license": "MIT",
@@ -36,8 +36,8 @@
   ],
   "dependencies": {
     "@manifesto-ai/core": "2.4.0",
-    "@manifesto-ai/runtime": "0.1.0",
-    "@manifesto-ai/world": "2.3.0"
+    "@manifesto-ai/runtime": "0.1.2",
+    "@manifesto-ai/world": "2.4.0"
   },
   "devDependencies": {
     "typescript": "^5.9.3"