@aicr/forge-sdk

Public SDK for the FORGE domain builder platform. Build, test, and run domain packs that generate structured artifacts through wizard, expert, and recipe modes.

Install

npm install @aicr/forge-sdk

Quick Start

import { createForgeSession, ForgeRegistry, MemoryPackLoader, MockAIProvider, MockRenderer, MemorySessionManager } from '@aicr/forge-sdk'

const registry = new ForgeRegistry()
registry.register('my-pack', { manifest, prompts: {} })

const session = await createForgeSession({
  packSlug: 'my-pack',
  mode: 'wizard',
  loader: new MemoryPackLoader(registry.packs),
  ai: new MockAIProvider(),
  renderer: new MockRenderer(),
  sessionManager: new MemorySessionManager(),
})

Key Exports

| Export | Description | |--------|------------| | createForgeSession | Create a FORGE session for a specific pack and mode | | ForgeRegistry | Register and manage domain packs | | forgeHeadless | Run FORGE without UI (testing, CI, scripting) | | initPack | Scaffold a new pack directory from template | | Engine types | Re-exports of PackManifest, SessionState, OutputRenderer, etc. | | Test utilities | MockAIProvider, MockRenderer, MemoryPackLoader, MemorySessionManager |

Pack Authoring

See the Pack Authoring Guide for a complete walkthrough.

License

MIT