@manifesto-ai/sdk

SDK is the canonical public developer API for Manifesto applications.

Overview

SDK owns the public contract for app creation and interaction. It provides createApp(), createTestApp(), ManifestoApp, and the hook primitives while delegating orchestration to Runtime.

Application Code
      |
      v
SDK (createApp, App, Hooks)
      |
      v
Runtime (orchestration)
      |
      v
Core / Host / World

Installation

pnpm add @manifesto-ai/sdk

Quick Example

import { createApp } from "@manifesto-ai/sdk";

const app = createApp({
  schema: counterSchema,
  effects: {
    "api.save": async (params) => [
      { op: "set", path: "data.savedAt", value: params.timestamp },
    ],
  },
});

await app.ready();
await app.act("increment").done();
console.log(app.getState().data.count);

Main Exports

Factory

function createApp(config: AppConfig): App;
function createTestApp(domain: DomainSchema | string, opts?: Partial<AppConfig>): App;

Class

class ManifestoApp implements App { /* ... */ }

Runtime-Reexported Public Types/Errors

SDK re-exports public contract types and errors (for example AppConfig, AppState, ActionHandle, AppNotReadyError).

Relationship with Other Packages

| Relationship | Package | How | |--------------|---------|-----| | 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) |

Migration from Legacy App Facade

Legacy app-facade imports should be replaced with @manifesto-ai/sdk.

For automated rewrite guidance, see:

• docs/guides/migrate-app-to-sdk.md

Documentation

• sdk-SPEC-v0.1.0.md
• VERSION-INDEX.md
• ADR-008

License

MIT