@loomic/devtools

Developer tooling for the Loomic agentic runtime. Not needed in production — add this to your devDependencies.

What it does

• MockProvider — a deterministic AI provider for unit and integration tests; returns configurable AgentPlan responses without hitting any API
• ReplayRunner — replays a recorded sequence of signals and plans against the runtime for regression testing
• RuntimeLogger — structured, human-readable console logger that subscribes to runtime events; useful during development to trace the full run-loop cycle

Install

npm install --save-dev @loomic/devtools

Usage

// In tests
import { MockProvider } from '@loomic/devtools';
import { createAgenticRuntime } from '@loomic/runtime';

const runtime = createAgenticRuntime({
  provider: new MockProvider({
    plan: { uiOperations: [], toolCalls: [], memoryCandidates: [] },
  }),
});

// In development (attach to your runtime instance)
import { RuntimeLogger } from '@loomic/devtools';

const logger = new RuntimeLogger(runtime, { level: 'debug' });
logger.attach();