@shardworks/animator-apparatus 0.1.101

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 Sean Boots
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,260 @@
+# `@shardworks/animator-apparatus`
+
+The Animator brings animas to life. It is the guild's session apparatus — the single entry point for making an anima do work. Two API levels serve different callers:
+
+- **`summon()`** — the high-level "make an anima do a thing" call. Passes the role to The Loom for identity composition, then launches a session with the work prompt. This is what the summon relay, the CLI, and most callers use.
+- **`animate()`** — the low-level call for callers that compose their own `AnimaWeave` (e.g. The Parlour for multi-turn conversations).
+
+Both methods return an `AnimateHandle` synchronously — a `{ chunks, result }` pair. The `result` promise resolves when the session completes. The `chunks` async iterable yields output as the session runs when `streaming: true` is set; otherwise it completes immediately with no items.
+
+Depends on `@shardworks/stacks-apparatus` for persistence. Uses `@shardworks/loom-apparatus` for context composition (resolved at call time by `summon()`, not a startup dependency). The session provider (e.g. `@shardworks/claude-code-apparatus`) is discovered at runtime via guild config.
+
+---
+
+## Installation
+
+```json
+{
+  "dependencies": {
+    "@shardworks/animator-apparatus": "workspace:*"
+  }
+}
+```
+
+## API
+
+The Animator exposes its API via `guild().apparatus<AnimatorApi>('animator')`:
+
+```typescript
+import { guild } from '@shardworks/nexus-core';
+import type { AnimatorApi } from '@shardworks/animator-apparatus';
+
+const animator = guild().apparatus<AnimatorApi>('animator');
+```
+
+### `summon(request): AnimateHandle`
+
+Summon an anima — compose context via The Loom and launch a session. This is the primary entry point for dispatching work. Returns synchronously.
+
+```typescript
+const { result } = animator.summon({
+  prompt: 'Build the frobnicator module with tests',
+  role: 'artificer',              // passed to The Loom for composition
+  cwd: '/path/to/workdir',
+  metadata: {                     // optional, merged with auto-generated metadata
+    writId: 'wrt-8a4c9e2',
+  },
+});
+
+const session = await result;
+console.log(session.status);           // 'completed' | 'failed' | 'timeout'
+console.log(session.costUsd);          // 0.42
+console.log(session.metadata?.trigger); // 'summon' (auto-populated)
+console.log(session.metadata?.role);    // 'artificer' (auto-populated from request)
+```
+
+With streaming:
+
+```typescript
+const { chunks, result } = animator.summon({
+  prompt: 'Build the frobnicator module with tests',
+  role: 'artificer',
+  cwd: '/path/to/workdir',
+  streaming: true,
+});
+
+for await (const chunk of chunks) {
+  if (chunk.type === 'text') process.stdout.write(chunk.text);
+}
+
+const session = await result;
+```
+
+The Loom owns system prompt composition — given the role, it produces the system prompt from the anima's identity layers (role instructions, curriculum, temperament, charter). The work prompt bypasses The Loom and goes directly to the session provider. At MVP, the Loom does not yet compose a system prompt (returns `undefined`); the session runs with the work prompt only. As the Loom gains composition logic, `summon()` callers get richer sessions without changing their code.
+
+Requires The Loom apparatus to be installed. Throws with a clear error if not available.
+
+### `animate(request): AnimateHandle`
+
+Launch a session with a pre-composed context. Use this when you've already built an `AnimaWeave` yourself (e.g. The Parlour assembling inter-turn context for a multi-turn conversation). Returns synchronously.
+
+```typescript
+const { result } = animator.animate({
+  context: animaWeave,            // from The Loom or self-composed
+  prompt: 'Do the thing',         // work prompt, sent directly to provider
+  cwd: '/path/to/workdir',
+  conversationId: 'conv-xyz',    // optional, for multi-turn resume
+  metadata: {                     // optional, recorded as-is
+    trigger: 'consult',
+    animaName: 'coco',
+  },
+});
+
+const session = await result;
+```
+
+With streaming:
+
+```typescript
+const { chunks, result } = animator.animate({
+  context: animaWeave,
+  prompt: 'Build the feature',
+  cwd: '/path/to/workdir',
+  streaming: true,
+});
+
+for await (const chunk of chunks) {
+  if (chunk.type === 'text') process.stdout.write(chunk.text);
+}
+
+const session = await result;
+```
+
+If the session provider doesn't support streaming, `chunks` completes immediately with no items and `result` resolves normally via the non-streaming path — regardless of the `streaming` flag.
+
+### Types
+
+```typescript
+interface SummonRequest {
+  prompt: string;                // The work prompt (sent to provider directly)
+  role?: string;                 // Role name (passed to The Loom for composition)
+  cwd: string;                   // Working directory for the session
+  conversationId?: string;       // Optional, for multi-turn resume
+  metadata?: Record<string, unknown>; // Merged with { trigger: 'summon', role }
+  streaming?: boolean;           // Enable streaming output (default false)
+}
+
+interface AnimateRequest {
+  context: AnimaWeave;           // Pre-composed identity context
+  prompt?: string;               // Work prompt (sent to provider as initialPrompt)
+  cwd: string;
+  conversationId?: string;
+  metadata?: Record<string, unknown>;
+  streaming?: boolean;           // Enable streaming output (default false)
+}
+
+interface AnimateHandle {
+  chunks: AsyncIterable<SessionChunk>; // Empty when not streaming
+  result: Promise<SessionResult>;
+}
+
+interface SessionResult {
+  id: string;                    // Generated by The Animator (ses-{hex})
+  status: 'completed' | 'failed' | 'timeout';
+  startedAt: string;             // ISO-8601
+  endedAt: string;               // ISO-8601
+  durationMs: number;
+  provider: string;              // e.g. 'claude-code'
+  exitCode: number;
+  error?: string;
+  conversationId?: string;
+  providerSessionId?: string;
+  tokenUsage?: TokenUsage;
+  costUsd?: number;
+  metadata?: Record<string, unknown>;
+}
+
+type SessionChunk =
+  | { type: 'text'; text: string }
+  | { type: 'tool_use'; tool: string }
+  | { type: 'tool_result'; tool: string };
+```
+
+## Configuration
+
+The Animator reads its config from `guild.json["animator"]`:
+
+```json
+{
+  "animator": {
+    "sessionProvider": "claude-code"
+  }
+}
+```
+
+| Field | Type | Default | Description |
+|---|---|---|---|
+| `sessionProvider` | `string` | `'claude-code'` | Plugin id of the apparatus that implements `AnimatorSessionProvider`. Looked up via `guild().apparatus()`. |
+
+## Session Provider Interface
+
+Session providers are apparatus plugins whose `provides` object implements `AnimatorSessionProvider`:
+
+```typescript
+interface AnimatorSessionProvider {
+  name: string;
+  launch(config: SessionProviderConfig): Promise<SessionProviderResult>;
+  launchStreaming?(config: SessionProviderConfig): {
+    chunks: AsyncIterable<SessionChunk>;
+    result: Promise<SessionProviderResult>;
+  };
+}
+
+interface SessionProviderConfig {
+  systemPrompt?: string;         // From AnimaWeave (Loom output)
+  initialPrompt?: string;        // From AnimateRequest.prompt (work prompt)
+  model: string;
+  conversationId?: string;
+  cwd: string;
+}
+
+interface SessionProviderResult {
+  status: 'completed' | 'failed' | 'timeout';
+  exitCode: number;
+  error?: string;
+  providerSessionId?: string;
+  tokenUsage?: TokenUsage;
+  costUsd?: number;
+}
+```
+
+The Animator imports these types; provider packages import them from `@shardworks/animator-apparatus` and implement them.
+
+## Support Kit
+
+The Animator contributes a `sessions` book and inspection/dispatch tools:
+
+### Books
+
+| Book | Indexes | Description |
+|---|---|---|
+| `sessions` | `startedAt`, `status`, `conversationId`, `provider` | Session records — one per `animate()` call |
+
+### Tools
+
+| Tool | Permission | Description |
+|---|---|---|
+| `session-list` | `read` | List recent sessions with optional filters (status, provider, conversationId, limit) |
+| `session-show` | `read` | Show full detail for a single session by id |
+| `summon` | `animate` | Summon an anima from the CLI — compose context and launch a session |
+
+The `summon` tool is CLI-only (`callableBy: 'cli'`). It calls `animator.summon()` with the guild home as the working directory.
+
+## Exports
+
+The main export provides the apparatus factory, API types, and provider interface types:
+
+```typescript
+import {
+  createAnimator,
+  type AnimatorApi,
+  type AnimateHandle,
+  type AnimateRequest,
+  type SummonRequest,
+  type SessionResult,
+  type SessionChunk,
+  type TokenUsage,
+  type AnimatorSessionProvider,
+  type SessionProviderConfig,
+  type SessionProviderResult,
+  type SessionDoc,
+  type AnimatorConfig,
+} from '@shardworks/animator-apparatus';
+```
+
+The default export is a pre-created apparatus plugin instance:
+
+```typescript
+import animator from '@shardworks/animator-apparatus';
+// animator is { apparatus: { requires: ['stacks'], recommends: ['loom'], provides: AnimatorApi, ... } }
+```

package/dist/animator.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The Animator — session launch and telemetry recording apparatus.
+ *
+ * Two API levels:
+ * - summon() — high-level: composes context via The Loom, then launches.
+ * - animate() — low-level: takes a pre-composed AnimaWeave + prompt.
+ *
+ * See: docs/specification.md (animator)
+ */
+import type { Plugin } from '@shardworks/nexus-core';
+/**
+ * Create the Animator apparatus plugin.
+ *
+ * Returns a Plugin with:
+ * - `requires: ['stacks']` — records session results
+ * - `provides: AnimatorApi` — the session launch API
+ * - `supportKit` — contributes `sessions` book + inspection tools
+ */
+export declare function createAnimator(): Plugin;
+//# sourceMappingURL=animator.d.ts.map

package/dist/animator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animator.d.ts","sourceRoot":"","sources":["../src/animator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,wBAAwB,CAAC;AAiMrE;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAkIvC"}

package/dist/animator.js

@@ -0,0 +1,265 @@
+/**
+ * The Animator — session launch and telemetry recording apparatus.
+ *
+ * Two API levels:
+ * - summon() — high-level: composes context via The Loom, then launches.
+ * - animate() — low-level: takes a pre-composed AnimaWeave + prompt.
+ *
+ * See: docs/specification.md (animator)
+ */
+import { guild, generateId } from '@shardworks/nexus-core';
+import { sessionList, sessionShow, summon as summonTool } from "./tools/index.js";
+// ── Core logic ───────────────────────────────────────────────────────
+/**
+ * Resolve the session provider apparatus.
+ *
+ * Looks up the provider by plugin id from guild config. The provider is
+ * an apparatus whose `provides` implements AnimatorSessionProvider.
+ * Arbor throws immediately if the plugin isn't loaded or has no provides.
+ */
+function resolveProvider(config) {
+    const pluginId = config.sessionProvider ?? 'claude-code';
+    return guild().apparatus(pluginId);
+}
+/**
+ * Resolve the model from guild settings.
+ */
+function resolveModel() {
+    const g = guild();
+    const guildConfig = g.guildConfig();
+    return guildConfig.settings?.model ?? 'sonnet';
+}
+/**
+ * Build the provider config from an AnimateRequest.
+ *
+ * The system prompt comes from the AnimaWeave (composed by The Loom).
+ * The work prompt comes from the request directly (bypasses The Loom).
+ * The streaming flag is passed through for the provider to honor (or ignore).
+ */
+function buildProviderConfig(request, model) {
+    return {
+        systemPrompt: request.context.systemPrompt,
+        initialPrompt: request.prompt,
+        model,
+        conversationId: request.conversationId,
+        cwd: request.cwd,
+        streaming: request.streaming,
+        tools: request.context.tools,
+    };
+}
+/**
+ * Build a SessionResult from provider output and session metadata.
+ */
+function buildSessionResult(id, startedAt, providerName, providerResult, request) {
+    const endedAt = new Date().toISOString();
+    const durationMs = new Date(endedAt).getTime() - new Date(startedAt).getTime();
+    return {
+        id,
+        status: providerResult.status,
+        startedAt,
+        endedAt,
+        durationMs,
+        provider: providerName,
+        exitCode: providerResult.exitCode,
+        error: providerResult.error,
+        conversationId: request.conversationId,
+        providerSessionId: providerResult.providerSessionId,
+        tokenUsage: providerResult.tokenUsage,
+        costUsd: providerResult.costUsd,
+        metadata: request.metadata,
+    };
+}
+/**
+ * Build a failed SessionResult when the provider throws.
+ */
+function buildFailedResult(id, startedAt, providerName, error, request) {
+    const endedAt = new Date().toISOString();
+    const durationMs = new Date(endedAt).getTime() - new Date(startedAt).getTime();
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    return {
+        id,
+        status: 'failed',
+        startedAt,
+        endedAt,
+        durationMs,
+        provider: providerName,
+        exitCode: 1,
+        error: errorMessage,
+        conversationId: request.conversationId,
+        metadata: request.metadata,
+    };
+}
+/**
+ * Convert a SessionResult to a SessionDoc for Stacks storage.
+ */
+function toSessionDoc(result) {
+    return {
+        id: result.id,
+        status: result.status,
+        startedAt: result.startedAt,
+        endedAt: result.endedAt,
+        durationMs: result.durationMs,
+        provider: result.provider,
+        exitCode: result.exitCode,
+        error: result.error,
+        conversationId: result.conversationId,
+        providerSessionId: result.providerSessionId,
+        tokenUsage: result.tokenUsage,
+        costUsd: result.costUsd,
+        metadata: result.metadata,
+    };
+}
+/**
+ * Record a session result to The Stacks.
+ *
+ * Errors are logged but never propagated — session data loss is
+ * preferable to masking the original failure. See § Error Handling Contract.
+ */
+async function recordSession(sessions, result) {
+    try {
+        await sessions.put(toSessionDoc(result));
+    }
+    catch (err) {
+        console.warn(`[animator] Failed to record session ${result.id}: ${err instanceof Error ? err.message : err}`);
+    }
+}
+/**
+ * Write the initial 'running' session record to The Stacks.
+ */
+async function recordRunning(sessions, id, startedAt, providerName, request) {
+    try {
+        await sessions.put({
+            id,
+            status: 'running',
+            startedAt,
+            provider: providerName,
+            conversationId: request.conversationId,
+            metadata: request.metadata,
+        });
+    }
+    catch (err) {
+        console.warn(`[animator] Failed to write initial session record ${id}: ${err instanceof Error ? err.message : err}`);
+    }
+}
+// ── Apparatus factory ────────────────────────────────────────────────
+/**
+ * Create the Animator apparatus plugin.
+ *
+ * Returns a Plugin with:
+ * - `requires: ['stacks']` — records session results
+ * - `provides: AnimatorApi` — the session launch API
+ * - `supportKit` — contributes `sessions` book + inspection tools
+ */
+export function createAnimator() {
+    let config = {};
+    let sessions;
+    const api = {
+        summon(request) {
+            // Resolve The Loom at call time — not a startup dependency.
+            // This allows the Animator to start without the Loom installed;
+            // only summon() requires it.
+            let loom;
+            try {
+                loom = guild().apparatus('loom');
+            }
+            catch {
+                throw new Error('summon() requires The Loom apparatus to be installed. ' +
+                    'Use animate() directly if you want to provide a pre-composed AnimaWeave.');
+            }
+            // We need to weave context before we can animate, but summon()
+            // must return synchronously. Wrap the async Loom call and the
+            // animate delegation into a single deferred flow.
+            const deferred = (async () => {
+                // Compose identity context via The Loom.
+                // The Loom owns system prompt composition — it produces the system
+                // prompt from the anima's identity layers (role instructions,
+                // curriculum, temperament, charter). MVP: returns empty (no
+                // systemPrompt); the session runs without one until the Loom
+                // gains composition logic. The work prompt bypasses the Loom.
+                const context = await loom.weave({
+                    role: request.role,
+                });
+                // Merge caller metadata with auto-generated summon metadata
+                const metadata = {
+                    trigger: 'summon',
+                    ...(request.role ? { role: request.role } : {}),
+                    ...request.metadata,
+                };
+                // Delegate to the standard animate path.
+                // The work prompt goes directly on the request — it is not
+                // a composition concern.
+                return this.animate({
+                    context,
+                    prompt: request.prompt,
+                    cwd: request.cwd,
+                    conversationId: request.conversationId,
+                    metadata,
+                    streaming: request.streaming,
+                });
+            })();
+            // Pipe chunks through — can't get them until the Loom weave resolves.
+            // Works for both streaming and non-streaming: non-streaming providers
+            // return empty chunks, so the generator yields nothing and completes.
+            async function* pipeChunks() {
+                const handle = await deferred;
+                yield* handle.chunks;
+            }
+            return {
+                chunks: pipeChunks(),
+                result: deferred.then((handle) => handle.result),
+            };
+        },
+        animate(request) {
+            const provider = resolveProvider(config);
+            const model = resolveModel();
+            const providerConfig = buildProviderConfig(request, model);
+            // Step 1: generate session id, capture startedAt
+            const id = generateId('ses', 4);
+            const startedAt = new Date().toISOString();
+            // Single path — the provider returns { chunks, result } regardless
+            // of whether streaming is enabled. Providers that don't support
+            // streaming return empty chunks; the Animator doesn't branch.
+            const { chunks, result: providerResultPromise } = provider.launch(providerConfig);
+            // Write initial record (fire and forget — don't block streaming)
+            const initPromise = recordRunning(sessions, id, startedAt, provider.name, request);
+            const result = (async () => {
+                await initPromise;
+                let sessionResult;
+                try {
+                    const providerResult = await providerResultPromise;
+                    sessionResult = buildSessionResult(id, startedAt, provider.name, providerResult, request);
+                }
+                catch (err) {
+                    sessionResult = buildFailedResult(id, startedAt, provider.name, err, request);
+                    await recordSession(sessions, sessionResult);
+                    throw err;
+                }
+                await recordSession(sessions, sessionResult);
+                return sessionResult;
+            })();
+            return { chunks, result };
+        },
+    };
+    return {
+        apparatus: {
+            requires: ['stacks'],
+            recommends: ['loom'],
+            supportKit: {
+                books: {
+                    sessions: {
+                        indexes: ['startedAt', 'status', 'conversationId', 'provider'],
+                    },
+                },
+                tools: [sessionList, sessionShow, summonTool],
+            },
+            provides: api,
+            start(_ctx) {
+                const g = guild();
+                config = g.guildConfig().animator ?? {};
+                const stacks = g.apparatus('stacks');
+                sessions = stacks.book('animator', 'sessions');
+            },
+        },
+    };
+}
+//# sourceMappingURL=animator.js.map

package/dist/animator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"animator.js","sourceRoot":"","sources":["../src/animator.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @shardworks/animator-apparatus — The Animator.
+ *
+ * Session launch and telemetry recording: takes an AnimaWeave from The Loom,
+ * launches an AI process via a session provider, monitors it until exit, and
+ * records the result to The Stacks.
+ *
+ * See: docs/specification.md (animator)
+ */
+export { type AnimatorApi, type AnimateHandle, type AnimateRequest, type SummonRequest, type SessionResult, type SessionChunk, type TokenUsage, type SessionDoc, type AnimatorConfig, type AnimatorSessionProvider, type SessionProviderConfig, type SessionProviderResult, } from './types.ts';
+export { createAnimator } from './animator.ts';
+declare const _default: import("@shardworks/nexus-core").Plugin;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,cAAc,EAEnB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;;AAI/C,wBAAgC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+/**
+ * @shardworks/animator-apparatus — The Animator.
+ *
+ * Session launch and telemetry recording: takes an AnimaWeave from The Loom,
+ * launches an AI process via a session provider, monitors it until exit, and
+ * records the result to The Stacks.
+ *
+ * See: docs/specification.md (animator)
+ */
+import { createAnimator } from "./animator.js";
+// ── Animator API ─────────────────────────────────────────────────────
+export {} from "./types.js";
+export { createAnimator } from "./animator.js";
+// ── Default export: the apparatus plugin ──────────────────────────────
+export default createAnimator();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,wEAAwE;AAExE,OAAO,EAcN,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,yEAAyE;AAEzE,eAAe,cAAc,EAAE,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Animator tool re-exports.
+ */
+export { default as sessionList } from './session-list.ts';
+export { default as sessionShow } from './session-show.ts';
+export { default as summon } from './summon.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,7 @@
+/**
+ * Animator tool re-exports.
+ */
+export { default as sessionList } from "./session-list.js";
+export { default as sessionShow } from "./session-show.js";
+export { default as summon } from "./summon.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/tools/session-list.d.ts

@@ -0,0 +1,22 @@
+/**
+ * session-list tool — list recent sessions with optional filters.
+ *
+ * Queries The Animator's `sessions` book in The Stacks.
+ * Returns session summaries ordered by startedAt descending (newest first).
+ *
+ * See: docs/specification.md (animator § session-list tool)
+ */
+import { z } from 'zod';
+declare const _default: import("@shardworks/tools-apparatus").ToolDefinition<{
+    status: z.ZodOptional<z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        timeout: "timeout";
+        running: "running";
+    }>>;
+    provider: z.ZodOptional<z.ZodString>;
+    conversationId: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}>;
+export default _default;
+//# sourceMappingURL=session-list.d.ts.map

package/dist/tools/session-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-list.d.ts","sourceRoot":"","sources":["../../src/tools/session-list.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;;;;;;;;;AAIxB,wBA6CG"}

package/dist/tools/session-list.js

@@ -0,0 +1,57 @@
+/**
+ * session-list tool — list recent sessions with optional filters.
+ *
+ * Queries The Animator's `sessions` book in The Stacks.
+ * Returns session summaries ordered by startedAt descending (newest first).
+ *
+ * See: docs/specification.md (animator § session-list tool)
+ */
+import { tool } from '@shardworks/tools-apparatus';
+import { guild } from '@shardworks/nexus-core';
+import { z } from 'zod';
+export default tool({
+    name: 'session-list',
+    description: 'List recent sessions with optional filters',
+    instructions: 'Returns session summaries ordered by start time (newest first). ' +
+        'Use for investigating recent activity, debugging, or reporting. ' +
+        'Filters by indexed fields only — use Stacks queries directly for metadata fields.',
+    params: {
+        status: z.enum(['running', 'completed', 'failed', 'timeout']).optional()
+            .describe('Filter by session status'),
+        provider: z.string().optional()
+            .describe('Filter by provider name (e.g. "claude-code")'),
+        conversationId: z.string().optional()
+            .describe('Filter by conversation id'),
+        limit: z.number().optional().default(20)
+            .describe('Maximum results (default: 20)'),
+    },
+    permission: 'read',
+    handler: async (params) => {
+        const stacks = guild().apparatus('stacks');
+        const sessions = stacks.readBook('animator', 'sessions');
+        const where = [];
+        if (params.status)
+            where.push(['status', '=', params.status]);
+        if (params.provider)
+            where.push(['provider', '=', params.provider]);
+        if (params.conversationId)
+            where.push(['conversationId', '=', params.conversationId]);
+        const results = await sessions.find({
+            where: where.length > 0 ? where : undefined,
+            orderBy: ['startedAt', 'desc'],
+            limit: params.limit,
+        });
+        // Return summary projection
+        return results.map((s) => ({
+            id: s.id,
+            status: s.status,
+            provider: s.provider,
+            startedAt: s.startedAt,
+            endedAt: s.endedAt,
+            durationMs: s.durationMs,
+            exitCode: s.exitCode,
+            costUsd: s.costUsd,
+        }));
+    },
+});
+//# sourceMappingURL=session-list.js.map

package/dist/tools/session-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-list.js","sourceRoot":"","sources":["../../src/tools/session-list.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAe,IAAI,CAAC;IAClB,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,4CAA4C;IACzD,YAAY,EACV,kEAAkE;QAClE,kEAAkE;QAClE,mFAAmF;IACrF,MAAM,EAAE;QACN,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;aACrE,QAAQ,CAAC,0BAA0B,CAAC;QACvC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;aAC5B,QAAQ,CAAC,8CAA8C,CAAC;QAC3D,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;aAClC,QAAQ,CAAC,2BAA2B,CAAC;QACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;aACrC,QAAQ,CAAC,+BAA+B,CAAC;KAC7C;IACD,UAAU,EAAE,MAAM;IAClB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,KAAK,EAAE,CAAC,SAAS,CAAY,QAAQ,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAa,UAAU,EAAE,UAAU,CAAC,CAAC;QAErE,MAAM,KAAK,GAAqB,EAAE,CAAC;QACnC,IAAI,MAAM,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC9D,IAAI,MAAM,CAAC,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QACpE,IAAI,MAAM,CAAC,cAAc;YAAE,KAAK,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,GAAG,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;QAEtF,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC;YAClC,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;YAC3C,OAAO,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;YAC9B,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC,CAAC;QAEH,4BAA4B;QAC5B,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,OAAO,EAAE,CAAC,CAAC,OAAO;SACnB,CAAC,CAAC,CAAC;IACN,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/session-show.d.ts

@@ -0,0 +1,14 @@
+/**
+ * session-show tool — show full detail for a single session by id.
+ *
+ * Reads the complete session record from The Animator's `sessions` book
+ * in The Stacks, including tokenUsage, metadata, and all indexed fields.
+ *
+ * See: docs/specification.md (animator § session-show tool)
+ */
+import { z } from 'zod';
+declare const _default: import("@shardworks/tools-apparatus").ToolDefinition<{
+    id: z.ZodString;
+}>;
+export default _default;
+//# sourceMappingURL=session-show.d.ts.map

package/dist/tools/session-show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-show.d.ts","sourceRoot":"","sources":["../../src/tools/session-show.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;AAIxB,wBAoBG"}

package/dist/tools/session-show.js

@@ -0,0 +1,31 @@
+/**
+ * session-show tool — show full detail for a single session by id.
+ *
+ * Reads the complete session record from The Animator's `sessions` book
+ * in The Stacks, including tokenUsage, metadata, and all indexed fields.
+ *
+ * See: docs/specification.md (animator § session-show tool)
+ */
+import { tool } from '@shardworks/tools-apparatus';
+import { guild } from '@shardworks/nexus-core';
+import { z } from 'zod';
+export default tool({
+    name: 'session-show',
+    description: 'Show full detail for a single session by id',
+    instructions: 'Returns the complete session record from The Stacks, including ' +
+        'tokenUsage, metadata, and all indexed fields.',
+    params: {
+        id: z.string().describe('Session id'),
+    },
+    permission: 'read',
+    handler: async (params) => {
+        const stacks = guild().apparatus('stacks');
+        const sessions = stacks.readBook('animator', 'sessions');
+        const session = await sessions.get(params.id);
+        if (!session) {
+            throw new Error(`Session "${params.id}" not found.`);
+        }
+        return session;
+    },
+});
+//# sourceMappingURL=session-show.js.map

package/dist/tools/session-show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-show.js","sourceRoot":"","sources":["../../src/tools/session-show.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAe,IAAI,CAAC;IAClB,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,6CAA6C;IAC1D,YAAY,EACV,iEAAiE;QACjE,+CAA+C;IACjD,MAAM,EAAE;QACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;KACtC;IACD,UAAU,EAAE,MAAM;IAClB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,KAAK,EAAE,CAAC,SAAS,CAAY,QAAQ,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAa,UAAU,EAAE,UAAU,CAAC,CAAC;QAErE,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,YAAY,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/summon.d.ts

@@ -0,0 +1,17 @@
+/**
+ * summon tool — dispatch an anima session from the CLI.
+ *
+ * High-level entry point: composes context via The Loom (passing the
+ * role for system prompt composition), then launches a session via
+ * The Animator. The work prompt goes directly to the provider.
+ *
+ * Usage:
+ *   nsg summon --prompt "Build the frobnicator" --role artificer
+ */
+import { z } from 'zod';
+declare const _default: import("@shardworks/tools-apparatus").ToolDefinition<{
+    prompt: z.ZodString;
+    role: z.ZodOptional<z.ZodString>;
+}>;
+export default _default;
+//# sourceMappingURL=summon.d.ts.map

package/dist/tools/summon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summon.d.ts","sourceRoot":"","sources":["../../src/tools/summon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;;AAGxB,wBAqCG"}

package/dist/tools/summon.js

@@ -0,0 +1,48 @@
+/**
+ * summon tool — dispatch an anima session from the CLI.
+ *
+ * High-level entry point: composes context via The Loom (passing the
+ * role for system prompt composition), then launches a session via
+ * The Animator. The work prompt goes directly to the provider.
+ *
+ * Usage:
+ *   nsg summon --prompt "Build the frobnicator" --role artificer
+ */
+import { tool } from '@shardworks/tools-apparatus';
+import { guild } from '@shardworks/nexus-core';
+import { z } from 'zod';
+export default tool({
+    name: 'summon',
+    description: 'Summon an anima — compose context and launch a session',
+    instructions: 'Dispatches an anima session. Provide a work prompt (what the anima should do) ' +
+        'and optionally a role name (for system prompt composition). The Loom composes ' +
+        'the identity context from the role; the prompt goes directly to the AI process. ' +
+        'Returns the session result with id, status, cost, and token usage.',
+    params: {
+        prompt: z.string().describe('The work prompt — what the anima should do'),
+        role: z.string().optional().describe('Role to summon (e.g. "artificer", "scribe")'),
+    },
+    callableBy: 'cli',
+    permission: 'animate',
+    handler: async (params) => {
+        const animator = guild().apparatus('animator');
+        const cwd = guild().home;
+        const { result } = animator.summon({
+            prompt: params.prompt,
+            role: params.role,
+            cwd,
+        });
+        const session = await result;
+        return {
+            id: session.id,
+            status: session.status,
+            provider: session.provider,
+            durationMs: session.durationMs,
+            exitCode: session.exitCode,
+            costUsd: session.costUsd,
+            tokenUsage: session.tokenUsage,
+            error: session.error,
+        };
+    },
+});
+//# sourceMappingURL=summon.js.map

package/dist/tools/summon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summon.js","sourceRoot":"","sources":["../../src/tools/summon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAe,IAAI,CAAC;IAClB,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,wDAAwD;IACrE,YAAY,EACV,gFAAgF;QAChF,gFAAgF;QAChF,kFAAkF;QAClF,oEAAoE;IACtE,MAAM,EAAE;QACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;QACzE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;KACpF;IACD,UAAU,EAAE,KAAK;IACjB,UAAU,EAAE,SAAS;IACrB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACxB,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAC,SAAS,CAAc,UAAU,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC;QAEzB,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC;YACjC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,GAAG;SACJ,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC;QAE7B,OAAO;YACL,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,287 @@
+/**
+ * The Animator — public types.
+ *
+ * These types form the contract between The Animator apparatus and all
+ * callers (summon relay, nsg consult, etc.). No implementation details.
+ *
+ * See: docs/specification.md (animator)
+ */
+import type { AnimaWeave } from '@shardworks/loom-apparatus';
+import type { ResolvedTool } from '@shardworks/tools-apparatus';
+/** A chunk of output from a running session. */
+export type SessionChunk = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'tool_use';
+    tool: string;
+} | {
+    type: 'tool_result';
+    tool: string;
+};
+export interface AnimateRequest {
+    /** The anima weave from The Loom (composed identity context). */
+    context: AnimaWeave;
+    /**
+     * The work prompt — what the anima should do.
+     * Passed directly to the session provider as the initial prompt.
+     * This bypasses The Loom — it is not a composition concern.
+     */
+    prompt?: string;
+    /**
+     * Working directory for the session.
+     * The session provider launches the AI process here.
+     */
+    cwd: string;
+    /**
+     * Optional conversation id to resume a multi-turn conversation.
+     * If provided, the session provider resumes the existing conversation
+     * rather than starting a new one.
+     */
+    conversationId?: string;
+    /**
+     * Caller-supplied metadata recorded alongside the session.
+     * The Animator stores this as-is — it does not interpret the contents.
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Enable streaming output. When true, the returned `chunks` iterable
+     * yields output as the session produces it. When false (default), the
+     * `chunks` iterable completes immediately with no items.
+     *
+     * Either way, the return shape is the same: `{ chunks, result }`.
+     */
+    streaming?: boolean;
+}
+export interface SessionResult {
+    /** Unique session id (generated by The Animator). */
+    id: string;
+    /** Terminal status. */
+    status: 'completed' | 'failed' | 'timeout';
+    /** When the session started (ISO-8601). */
+    startedAt: string;
+    /** When the session ended (ISO-8601). */
+    endedAt: string;
+    /** Wall-clock duration in milliseconds. */
+    durationMs: number;
+    /** Provider name (e.g. 'claude-code'). */
+    provider: string;
+    /** Numeric exit code from the provider process. */
+    exitCode: number;
+    /** Error message if failed. */
+    error?: string;
+    /** Conversation id (for multi-turn resume). */
+    conversationId?: string;
+    /** Session id from the provider (e.g. for --resume). */
+    providerSessionId?: string;
+    /** Token usage from the provider, if available. */
+    tokenUsage?: TokenUsage;
+    /** Cost in USD from the provider, if available. */
+    costUsd?: number;
+    /** Caller-supplied metadata, recorded as-is. */
+    metadata?: Record<string, unknown>;
+}
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+}
+export interface SummonRequest {
+    /**
+     * The work prompt — what the anima should do.
+     * Passed directly to the session provider as the initial prompt.
+     */
+    prompt: string;
+    /**
+     * The role to summon (e.g. 'artificer', 'scribe').
+     * Passed to The Loom for context composition and recorded in session metadata.
+     */
+    role?: string;
+    /**
+     * Working directory for the session.
+     * The session provider launches the AI process here.
+     */
+    cwd: string;
+    /**
+     * Optional conversation id to resume a multi-turn conversation.
+     */
+    conversationId?: string;
+    /**
+     * Additional metadata to record alongside the session.
+     * Merged with auto-generated metadata (trigger: 'summon', role).
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Enable streaming output. When true, the returned `chunks` iterable
+     * yields output as the session produces it. When false (default), the
+     * `chunks` iterable completes immediately with no items.
+     */
+    streaming?: boolean;
+}
+/** The return value from animate() and summon(). */
+export interface AnimateHandle {
+    /**
+     * Async iterable of output chunks from the session. When streaming is
+     * disabled (the default), this iterable completes immediately with no
+     * items. When streaming is enabled, it yields chunks as the session
+     * produces output.
+     */
+    chunks: AsyncIterable<SessionChunk>;
+    /**
+     * Promise that resolves to the final SessionResult after the session
+     * completes (or fails/times out) and the result is recorded to The Stacks.
+     */
+    result: Promise<SessionResult>;
+}
+export interface AnimatorApi {
+    /**
+     * Summon an anima — compose context via The Loom and launch a session.
+     *
+     * This is the high-level "make an anima do a thing" entry point.
+     * Internally calls The Loom for context composition (passing the role),
+     * then animate() for session launch and recording. The work prompt
+     * bypasses the Loom and goes directly to the provider.
+     *
+     * Requires The Loom apparatus to be installed. Throws if not available.
+     *
+     * Auto-populates session metadata with `trigger: 'summon'` and `role`.
+     *
+     * Returns synchronously — the async work lives inside `result` and `chunks`.
+     */
+    summon(request: SummonRequest): AnimateHandle;
+    /**
+     * Animate a session — launch an AI process with the given context.
+     *
+     * This is the low-level entry point for callers that compose their own
+     * AnimaWeave (e.g. The Parlour for multi-turn conversations).
+     *
+     * Records the session result to The Stacks before `result` resolves.
+     *
+     * Set `streaming: true` on the request to receive output chunks as the
+     * session runs. When streaming is disabled (default), the `chunks`
+     * iterable completes immediately with no items.
+     *
+     * Returns synchronously — the async work lives inside `result` and `chunks`.
+     */
+    animate(request: AnimateRequest): AnimateHandle;
+}
+/**
+ * A session provider — pluggable backend that knows how to launch and
+ * communicate with a specific AI system.
+ *
+ * Implemented as an apparatus plugin whose `provides` object satisfies
+ * this interface. The Animator discovers the provider via guild config:
+ * `guild.json["animator"]["sessionProvider"]` names the plugin id.
+ *
+ * The provider always returns `{ chunks, result }` — the same shape as
+ * AnimateHandle. When `config.streaming` is true, the provider MAY yield
+ * output chunks as the session runs. When false (or when the provider
+ * does not support streaming), the chunks iterable completes immediately
+ * with no items. The Animator does not branch on streaming capability —
+ * it passes the flag through and trusts the provider to do the right thing.
+ */
+export interface AnimatorSessionProvider {
+    /** Human-readable name (e.g. 'claude-code'). */
+    name: string;
+    /**
+     * Launch a session. Returns `{ chunks, result }` synchronously.
+     *
+     * The `result` promise resolves when the AI process exits.
+     * The `chunks` async iterable yields output when `config.streaming`
+     * is true and the provider supports streaming; otherwise it completes
+     * immediately with no items.
+     *
+     * Providers that don't support streaming simply ignore the flag and
+     * return empty chunks — no separate method needed.
+     */
+    launch(config: SessionProviderConfig): {
+        chunks: AsyncIterable<SessionChunk>;
+        result: Promise<SessionProviderResult>;
+    };
+}
+export interface SessionProviderConfig {
+    /** System prompt for the AI process. May be undefined if composition is not yet implemented. */
+    systemPrompt?: string;
+    /** Initial user message (e.g. writ description). */
+    initialPrompt?: string;
+    /** Model to use (from guild settings). */
+    model: string;
+    /** Optional conversation id for resume. */
+    conversationId?: string;
+    /** Working directory for the session. */
+    cwd: string;
+    /**
+     * Enable streaming output. When true, the provider should yield output
+     * chunks as the session produces them. When false (default), the chunks
+     * iterable should complete immediately with no items.
+     *
+     * Providers that don't support streaming may ignore this flag.
+     */
+    streaming?: boolean;
+    /**
+     * Resolved tools for this session. When present, the provider should
+     * configure an MCP server with these tool definitions.
+     *
+     * The Loom resolves role → permissions → tools via the Instrumentarium.
+     * The Animator passes them through from the AnimaWeave.
+     */
+    tools?: ResolvedTool[];
+}
+export interface SessionProviderResult {
+    /** Exit status. */
+    status: 'completed' | 'failed' | 'timeout';
+    /** Numeric exit code from the process. */
+    exitCode: number;
+    /** Error message if failed. */
+    error?: string;
+    /** Provider's session id (e.g. for --resume). */
+    providerSessionId?: string;
+    /** Token usage, if the provider can report it. */
+    tokenUsage?: TokenUsage;
+    /** Cost in USD, if the provider can report it. */
+    costUsd?: number;
+}
+/**
+ * The session document stored in The Stacks' `sessions` book.
+ * Includes all SessionResult fields plus the `id` required by BookEntry.
+ */
+export interface SessionDoc {
+    id: string;
+    /**
+     * Session status. Initially written as `'running'` when the session is
+     * launched (Step 2), then updated to a terminal status (`'completed'`,
+     * `'failed'`, or `'timeout'`) after the provider exits (Step 5).
+     * The `'running'` state is transient — it only exists between Steps 2 and 5.
+     * `SessionResult.status` only includes terminal states.
+     */
+    status: 'running' | 'completed' | 'failed' | 'timeout';
+    startedAt: string;
+    endedAt?: string;
+    durationMs?: number;
+    provider: string;
+    exitCode?: number;
+    error?: string;
+    conversationId?: string;
+    providerSessionId?: string;
+    tokenUsage?: TokenUsage;
+    costUsd?: number;
+    metadata?: Record<string, unknown>;
+    /** Index signature required by BookEntry. */
+    [key: string]: unknown;
+}
+/** Plugin configuration stored at guild.json["animator"]. */
+export interface AnimatorConfig {
+    /**
+     * Plugin id of the apparatus that implements AnimatorSessionProvider.
+     * The Animator looks this up via guild().apparatus() at animate-time.
+     * Defaults to 'claude-code' if not specified.
+     */
+    sessionProvider?: string;
+}
+declare module '@shardworks/nexus-core' {
+    interface GuildConfig {
+        animator?: AnimatorConfig;
+    }
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,10 @@
+/**
+ * The Animator — public types.
+ *
+ * These types form the contract between The Animator apparatus and all
+ * callers (summon relay, nsg consult, etc.). No implementation details.
+ *
+ * See: docs/specification.md (animator)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@shardworks/animator-apparatus",
+  "version": "0.1.101",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/shardworks/nexus",
+    "directory": "packages/plugins/animator"
+  },
+  "description": "The Animator — session launch and telemetry recording apparatus",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "zod": "4.3.6",
+    "@shardworks/nexus-core": "0.1.101",
+    "@shardworks/loom-apparatus": "0.1.101",
+    "@shardworks/tools-apparatus": "0.1.101",
+    "@shardworks/stacks-apparatus": "0.1.101"
+  },
+  "devDependencies": {
+    "@types/node": "25.5.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "node --disable-warning=ExperimentalWarning --experimental-transform-types --test 'src/**/*.test.ts'",
+    "typecheck": "tsc --noEmit"
+  }
+}