@almadar/sdk 0.1.0-alpha.2

package/dist/server/index.js

@@ -0,0 +1,280 @@
+import { PauseController, isTraceEvent, traceToSSE, runRabit, runContextualEdit } from '@almadar-io/rabit';
+import { setupSSE, sendSSEEvent, closeSSE } from '@almadar/server';
+
+// src/server/index.ts
+function resolveUserId(opts, req) {
+  if (opts.userId) return opts.userId(req);
+  const header = req.headers["x-user-id"];
+  return typeof header === "string" && header.length > 0 ? header : "anonymous";
+}
+async function resolveExtraProviderConfig(opts, provider) {
+  if (!opts.resolveProviderConfig) return void 0;
+  return opts.resolveProviderConfig(provider);
+}
+function makeThreadId(workspace) {
+  return workspace.appId ?? `sdk-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+}
+function createGenerateHandler(opts) {
+  return async (req, res) => {
+    const body = req.body;
+    const rawPrompt = body["prompt"] ?? body["message"];
+    const prompt = typeof rawPrompt === "string" ? rawPrompt : "";
+    if (!prompt) {
+      res.status(400).json({ error: "prompt or message is required" });
+      return;
+    }
+    const provider = (typeof body["provider"] === "string" ? body["provider"] : void 0) ?? opts.provider ?? "deepseek";
+    const model = (typeof body["model"] === "string" ? body["model"] : void 0) ?? opts.model ?? "deepseek-v4-flash";
+    const userId = resolveUserId(opts, req);
+    let workspace;
+    try {
+      workspace = await opts.workspaceFactory(req);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      res.status(500).json({ error: `Workspace open failed: ${message}` });
+      return;
+    }
+    setupSSE(res);
+    const threadId = makeThreadId(workspace);
+    const abortController = new AbortController();
+    const pauseController = new PauseController();
+    const ctx = {
+      threadId,
+      workDir: workspace.workDir,
+      userId,
+      ...workspace.appId !== void 0 ? { appId: workspace.appId } : {}
+    };
+    const unsubscribe = workspace.subscribe({
+      onWrite(event) {
+        if (event.kind !== "trace") return;
+        if (!isTraceEvent(event.event)) return;
+        for (const sseEvent of traceToSSE(event.event, ctx)) {
+          sendSSEEvent(res, sseEvent);
+        }
+      }
+    });
+    sendSSEEvent(res, {
+      type: "start",
+      data: { threadId, skill: "rabit", workDir: workspace.workDir },
+      timestamp: Date.now()
+    });
+    res.on("close", () => {
+      abortController.abort();
+    });
+    const catalogMode = opts.catalogScope?.mode;
+    const stdAllowList = opts.catalogScope?.stdAllowList;
+    const extraProviderConfig = await resolveExtraProviderConfig(opts, provider);
+    const rabitOpts = {
+      prompt,
+      workDir: workspace.workDir,
+      userId,
+      provider,
+      model,
+      workspace,
+      signal: abortController.signal,
+      pauseController,
+      ...catalogMode !== void 0 ? { catalogMode } : {},
+      ...stdAllowList !== void 0 ? { stdAllowList } : {},
+      ...extraProviderConfig !== void 0 ? { providerConfig: extraProviderConfig } : {}
+    };
+    try {
+      const result = await runRabit(rabitOpts);
+      if (result.success && result.composedSchema !== null) {
+        sendSSEEvent(res, {
+          type: "complete",
+          data: {
+            threadId,
+            skill: "rabit",
+            workDir: workspace.workDir,
+            schemaGenerated: true,
+            appCompiled: false,
+            schema: result.composedSchema,
+            ...workspace.appId !== void 0 ? { appId: workspace.appId } : {}
+          },
+          timestamp: Date.now()
+        });
+        try {
+          await opts.onComplete?.(result.composedSchema, req);
+        } catch {
+        }
+      } else if (result.success) {
+        sendSSEEvent(res, {
+          type: "complete",
+          data: {
+            threadId,
+            skill: "rabit",
+            workDir: workspace.workDir,
+            schemaGenerated: false,
+            appCompiled: false
+          },
+          timestamp: Date.now()
+        });
+      } else {
+        const failList = result.failedOrbitals.join(", ");
+        sendSSEEvent(res, {
+          type: "error",
+          data: {
+            error: `Generation failed${failList.length > 0 ? `: ${failList}` : ""}`,
+            code: "failed"
+          },
+          timestamp: Date.now()
+        });
+      }
+    } catch (err) {
+      const isAbort = err instanceof Error && (err.name === "AbortError" || abortController.signal.aborted);
+      if (isAbort) {
+        sendSSEEvent(res, {
+          type: "cancelled",
+          data: { threadId, message: "Generation cancelled" },
+          timestamp: Date.now()
+        });
+      } else {
+        const message = err instanceof Error ? err.message : String(err);
+        sendSSEEvent(res, {
+          type: "error",
+          data: { error: message, code: "runtime" },
+          timestamp: Date.now()
+        });
+      }
+    } finally {
+      try {
+        unsubscribe();
+      } catch {
+      }
+      closeSSE(res);
+    }
+  };
+}
+function createEditHandler(opts) {
+  const generateHandler = createGenerateHandler(opts);
+  return async (req, res) => {
+    const body = req.body;
+    const focus = body["focus"];
+    if (focus === void 0 || focus === null) {
+      return generateHandler(req, res);
+    }
+    const rawInstruction = body["instruction"] ?? body["message"];
+    const instruction = typeof rawInstruction === "string" ? rawInstruction : "";
+    if (!instruction) {
+      res.status(400).json({ error: "instruction or message is required" });
+      return;
+    }
+    const provider = (typeof body["provider"] === "string" ? body["provider"] : void 0) ?? opts.provider ?? "deepseek";
+    const model = (typeof body["model"] === "string" ? body["model"] : void 0) ?? opts.model ?? "deepseek-v4-flash";
+    const userId = resolveUserId(opts, req);
+    let workspace;
+    try {
+      workspace = await opts.workspaceFactory(req);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      res.status(500).json({ error: `Workspace open failed: ${message}` });
+      return;
+    }
+    setupSSE(res);
+    const threadId = makeThreadId(workspace);
+    const abortController = new AbortController();
+    const ctx = {
+      threadId,
+      workDir: workspace.workDir,
+      userId,
+      ...workspace.appId !== void 0 ? { appId: workspace.appId } : {}
+    };
+    const unsubscribe = workspace.subscribe({
+      onWrite(event) {
+        if (event.kind !== "trace") return;
+        if (!isTraceEvent(event.event)) return;
+        for (const sseEvent of traceToSSE(event.event, ctx)) {
+          sendSSEEvent(res, sseEvent);
+        }
+      }
+    });
+    sendSSEEvent(res, {
+      type: "start",
+      data: { threadId, skill: "rabit", workDir: workspace.workDir },
+      timestamp: Date.now()
+    });
+    res.on("close", () => {
+      abortController.abort();
+    });
+    const extraProviderConfig = await resolveExtraProviderConfig(opts, provider);
+    try {
+      const editResult = await runContextualEdit({
+        // EditFocus is validated at runtime by rabit; we pass through as-is.
+        focus,
+        instruction,
+        workDir: workspace.workDir,
+        provider,
+        model,
+        userId,
+        workspace,
+        signal: abortController.signal,
+        ...extraProviderConfig !== void 0 ? { providerConfig: extraProviderConfig } : {}
+      });
+      if (!editResult.success) {
+        sendSSEEvent(res, {
+          type: "error",
+          data: {
+            error: editResult.error ?? "The edit did not change anything.",
+            code: "failed"
+          },
+          timestamp: Date.now()
+        });
+        return;
+      }
+      const rawSchema = workspace.readSchema();
+      let composedSchema = null;
+      if (rawSchema !== null) {
+        try {
+          composedSchema = JSON.parse(rawSchema);
+        } catch {
+        }
+      }
+      sendSSEEvent(res, {
+        type: "complete",
+        data: {
+          threadId,
+          skill: "rabit",
+          workDir: workspace.workDir,
+          schemaGenerated: composedSchema !== null,
+          appCompiled: false,
+          schemaPersisted: false,
+          ...composedSchema !== null ? { schema: composedSchema } : {},
+          ...workspace.appId !== void 0 ? { appId: workspace.appId } : {}
+        },
+        timestamp: Date.now()
+      });
+      if (composedSchema !== null) {
+        try {
+          await opts.onComplete?.(composedSchema, req);
+        } catch {
+        }
+      }
+    } catch (err) {
+      const isAbort = err instanceof Error && (err.name === "AbortError" || abortController.signal.aborted);
+      if (isAbort) {
+        sendSSEEvent(res, {
+          type: "cancelled",
+          data: { threadId, message: "Edit cancelled" },
+          timestamp: Date.now()
+        });
+      } else {
+        const message = err instanceof Error ? err.message : String(err);
+        sendSSEEvent(res, {
+          type: "error",
+          data: { error: message, code: "runtime" },
+          timestamp: Date.now()
+        });
+      }
+    } finally {
+      try {
+        unsubscribe();
+      } catch {
+      }
+      closeSSE(res);
+    }
+  };
+}
+
+export { createEditHandler, createGenerateHandler };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/server/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * `@almadar/sdk/server` — Express handler factories for the Almadar agent.\n *\n * Node-only. Never import this from browser or React code.\n *\n * Usage:\n *   import { createGenerateHandler, createEditHandler } from '@almadar/sdk/server';\n */\n\nimport type { Request, Response } from 'express';\nimport type { WorkspaceService } from '@almadar/workspace';\nimport type { OrbitalSchema } from '@almadar/core';\nimport type { ProviderConfig } from '@almadar/llm';\nimport {\n  runRabit,\n  runContextualEdit,\n  PauseController,\n  traceToSSE,\n  isTraceEvent,\n  type RabitOptions,\n  type MapperContext,\n} from '@almadar-io/rabit';\nimport {\n  setupSSE,\n  sendSSEEvent,\n  closeSSE,\n} from '@almadar/server';\n\n// ============================================================================\n// Types\n// ============================================================================\n\n// Canonical provider-credential type lives in `@almadar/llm`; re-export it so\n// callers get the exact shape `runRabit` consumes without a local shadow.\nexport type { ProviderConfig };\n\n// ============================================================================\n// Public option surface\n// ============================================================================\n\nexport interface GenerateHandlerOptions {\n  /** Open (or return) the workspace for this request. */\n  workspaceFactory: (req: Request) => Promise<WorkspaceService> | WorkspaceService;\n  /** LLM provider — defaults to `'deepseek'`. */\n  provider?: string;\n  /** LLM model — defaults to `'deepseek-v4-flash'`. */\n  model?: string;\n  /** Std-catalog scope forwarded to rabit. */\n  catalogScope?: {\n    mode: 'extend' | 'subset' | 'replace';\n    stdAllowList?: readonly string[];\n  };\n  /** Return explicit provider credentials for the given provider string. */\n  resolveProviderConfig?: (\n    provider: string,\n  ) => Promise<ProviderConfig | undefined> | ProviderConfig | undefined;\n  /** Called once with the final composed schema after a successful generate. */\n  onComplete?: (schema: OrbitalSchema, req: Request) => Promise<void> | void;\n  /** Derive a stable user id from the request — defaults to `'anonymous'`. */\n  userId?: (req: Request) => string;\n}\n\n// ============================================================================\n// Internal helpers\n// ============================================================================\n\nfunction resolveUserId(opts: GenerateHandlerOptions, req: Request): string {\n  if (opts.userId) return opts.userId(req);\n  const header = req.headers['x-user-id'];\n  return typeof header === 'string' && header.length > 0 ? header : 'anonymous';\n}\n\nasync function resolveExtraProviderConfig(\n  opts: GenerateHandlerOptions,\n  provider: string,\n): Promise<ProviderConfig | undefined> {\n  if (!opts.resolveProviderConfig) return undefined;\n  return opts.resolveProviderConfig(provider);\n}\n\nfunction makeThreadId(workspace: WorkspaceService): string {\n  return (\n    workspace.appId ??\n    `sdk-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`\n  );\n}\n\n// ============================================================================\n// createGenerateHandler\n// ============================================================================\n\n/**\n * Returns an Express route handler that streams a rabit generation run as SSE.\n *\n * Body shape accepted:\n *   `{ prompt?: string; message?: string; provider?: string; model?: string; appId?: string }`\n *\n * SSE events emitted:\n *   `start` → trace fan-out → `complete | error | cancelled`\n */\nexport function createGenerateHandler(\n  opts: GenerateHandlerOptions,\n): (req: Request, res: Response) => Promise<void> {\n  return async (req: Request, res: Response): Promise<void> => {\n    const body = req.body as Record<string, unknown>;\n    const rawPrompt = body['prompt'] ?? body['message'];\n    const prompt = typeof rawPrompt === 'string' ? rawPrompt : '';\n\n    if (!prompt) {\n      res.status(400).json({ error: 'prompt or message is required' });\n      return;\n    }\n\n    const provider =\n      (typeof body['provider'] === 'string' ? body['provider'] : undefined) ??\n      opts.provider ??\n      'deepseek';\n    const model =\n      (typeof body['model'] === 'string' ? body['model'] : undefined) ??\n      opts.model ??\n      'deepseek-v4-flash';\n    const userId = resolveUserId(opts, req);\n\n    let workspace: WorkspaceService;\n    try {\n      workspace = await opts.workspaceFactory(req);\n    } catch (err: unknown) {\n      const message = err instanceof Error ? err.message : String(err);\n      res.status(500).json({ error: `Workspace open failed: ${message}` });\n      return;\n    }\n\n    setupSSE(res);\n\n    const threadId = makeThreadId(workspace);\n    const abortController = new AbortController();\n    const pauseController = new PauseController();\n\n    const ctx: MapperContext = {\n      threadId,\n      workDir: workspace.workDir,\n      userId,\n      ...(workspace.appId !== undefined ? { appId: workspace.appId } : {}),\n    };\n\n    const unsubscribe = workspace.subscribe({\n      onWrite(event) {\n        if (event.kind !== 'trace') return;\n        if (!isTraceEvent(event.event)) return;\n        for (const sseEvent of traceToSSE(event.event, ctx)) {\n          sendSSEEvent(res, sseEvent);\n        }\n      },\n    });\n\n    sendSSEEvent(res, {\n      type: 'start',\n      data: { threadId, skill: 'rabit', workDir: workspace.workDir },\n      timestamp: Date.now(),\n    });\n\n    res.on('close', () => {\n      abortController.abort();\n    });\n\n    const catalogMode = opts.catalogScope?.mode;\n    const stdAllowList = opts.catalogScope?.stdAllowList;\n    const extraProviderConfig = await resolveExtraProviderConfig(opts, provider);\n\n    const rabitOpts: RabitOptions = {\n      prompt,\n      workDir: workspace.workDir,\n      userId,\n      provider,\n      model,\n      workspace,\n      signal: abortController.signal,\n      pauseController,\n      ...(catalogMode !== undefined ? { catalogMode } : {}),\n      ...(stdAllowList !== undefined ? { stdAllowList } : {}),\n      ...(extraProviderConfig !== undefined ? { providerConfig: extraProviderConfig } : {}),\n    };\n\n    try {\n      const result = await runRabit(rabitOpts);\n\n      if (result.success && result.composedSchema !== null) {\n        sendSSEEvent(res, {\n          type: 'complete',\n          data: {\n            threadId,\n            skill: 'rabit',\n            workDir: workspace.workDir,\n            schemaGenerated: true,\n            appCompiled: false,\n            schema: result.composedSchema,\n            ...(workspace.appId !== undefined ? { appId: workspace.appId } : {}),\n          },\n          timestamp: Date.now(),\n        });\n        try {\n          await opts.onComplete?.(result.composedSchema, req);\n        } catch {\n          // onComplete errors do not fail the SSE stream — schema was generated\n        }\n      } else if (result.success) {\n        sendSSEEvent(res, {\n          type: 'complete',\n          data: {\n            threadId,\n            skill: 'rabit',\n            workDir: workspace.workDir,\n            schemaGenerated: false,\n            appCompiled: false,\n          },\n          timestamp: Date.now(),\n        });\n      } else {\n        const failList = result.failedOrbitals.join(', ');\n        sendSSEEvent(res, {\n          type: 'error',\n          data: {\n            error: `Generation failed${failList.length > 0 ? `: ${failList}` : ''}`,\n            code: 'failed',\n          },\n          timestamp: Date.now(),\n        });\n      }\n    } catch (err: unknown) {\n      const isAbort =\n        err instanceof Error &&\n        (err.name === 'AbortError' || abortController.signal.aborted);\n      if (isAbort) {\n        sendSSEEvent(res, {\n          type: 'cancelled',\n          data: { threadId, message: 'Generation cancelled' },\n          timestamp: Date.now(),\n        });\n      } else {\n        const message = err instanceof Error ? err.message : String(err);\n        sendSSEEvent(res, {\n          type: 'error',\n          data: { error: message, code: 'runtime' },\n          timestamp: Date.now(),\n        });\n      }\n    } finally {\n      try {\n        unsubscribe();\n      } catch {\n        // best-effort\n      }\n      closeSSE(res);\n    }\n  };\n}\n\n// ============================================================================\n// createEditHandler\n// ============================================================================\n\n/**\n * Returns an Express route handler that streams a contextual-edit run as SSE.\n *\n * Body shape accepted:\n *   `{ focus: EditFocus; instruction?: string; message?: string; provider?: string; model?: string }`\n *\n * The `focus` field must be a valid `EditFocus` (orbital + trait + patternType\n * + path — see `@almadar/core`'s `EditFocus` type). The handler delegates\n * entirely to `runContextualEdit` from `@almadar-io/rabit`.\n *\n * TODO: when `focus` is absent the handler falls back to a full-regeneration\n * pass (`createGenerateHandler` semantics). Wire a dedicated delta-prompt edit\n * path here once rabit exposes a `runDeltaEdit` entry point.\n */\nexport function createEditHandler(\n  opts: GenerateHandlerOptions,\n): (req: Request, res: Response) => Promise<void> {\n  const generateHandler = createGenerateHandler(opts);\n\n  return async (req: Request, res: Response): Promise<void> => {\n    const body = req.body as Record<string, unknown>;\n    const focus = body['focus'];\n\n    // Without a focus, fall back to a full regeneration pass.\n    if (focus === undefined || focus === null) {\n      return generateHandler(req, res);\n    }\n\n    const rawInstruction = body['instruction'] ?? body['message'];\n    const instruction =\n      typeof rawInstruction === 'string' ? rawInstruction : '';\n\n    if (!instruction) {\n      res.status(400).json({ error: 'instruction or message is required' });\n      return;\n    }\n\n    const provider =\n      (typeof body['provider'] === 'string' ? body['provider'] : undefined) ??\n      opts.provider ??\n      'deepseek';\n    const model =\n      (typeof body['model'] === 'string' ? body['model'] : undefined) ??\n      opts.model ??\n      'deepseek-v4-flash';\n    const userId = resolveUserId(opts, req);\n\n    let workspace: WorkspaceService;\n    try {\n      workspace = await opts.workspaceFactory(req);\n    } catch (err: unknown) {\n      const message = err instanceof Error ? err.message : String(err);\n      res.status(500).json({ error: `Workspace open failed: ${message}` });\n      return;\n    }\n\n    setupSSE(res);\n\n    const threadId = makeThreadId(workspace);\n    const abortController = new AbortController();\n\n    const ctx: MapperContext = {\n      threadId,\n      workDir: workspace.workDir,\n      userId,\n      ...(workspace.appId !== undefined ? { appId: workspace.appId } : {}),\n    };\n\n    const unsubscribe = workspace.subscribe({\n      onWrite(event) {\n        if (event.kind !== 'trace') return;\n        if (!isTraceEvent(event.event)) return;\n        for (const sseEvent of traceToSSE(event.event, ctx)) {\n          sendSSEEvent(res, sseEvent);\n        }\n      },\n    });\n\n    sendSSEEvent(res, {\n      type: 'start',\n      data: { threadId, skill: 'rabit', workDir: workspace.workDir },\n      timestamp: Date.now(),\n    });\n\n    res.on('close', () => {\n      abortController.abort();\n    });\n\n    const extraProviderConfig = await resolveExtraProviderConfig(opts, provider);\n\n    try {\n      const editResult = await runContextualEdit({\n        // EditFocus is validated at runtime by rabit; we pass through as-is.\n        focus: focus as Parameters<typeof runContextualEdit>[0]['focus'],\n        instruction,\n        workDir: workspace.workDir,\n        provider,\n        model,\n        userId,\n        workspace,\n        signal: abortController.signal,\n        ...(extraProviderConfig !== undefined ? { providerConfig: extraProviderConfig } : {}),\n      });\n\n      if (!editResult.success) {\n        sendSSEEvent(res, {\n          type: 'error',\n          data: {\n            error: editResult.error ?? 'The edit did not change anything.',\n            code: 'failed',\n          },\n          timestamp: Date.now(),\n        });\n        return;\n      }\n\n      const rawSchema = workspace.readSchema();\n      let composedSchema: OrbitalSchema | null = null;\n      if (rawSchema !== null) {\n        try {\n          composedSchema = JSON.parse(rawSchema) as OrbitalSchema;\n        } catch {\n          // malformed schema — emit complete without it\n        }\n      }\n\n      sendSSEEvent(res, {\n        type: 'complete',\n        data: {\n          threadId,\n          skill: 'rabit',\n          workDir: workspace.workDir,\n          schemaGenerated: composedSchema !== null,\n          appCompiled: false,\n          schemaPersisted: false,\n          ...(composedSchema !== null ? { schema: composedSchema } : {}),\n          ...(workspace.appId !== undefined ? { appId: workspace.appId } : {}),\n        },\n        timestamp: Date.now(),\n      });\n\n      if (composedSchema !== null) {\n        try {\n          await opts.onComplete?.(composedSchema, req);\n        } catch {\n          // best-effort\n        }\n      }\n    } catch (err: unknown) {\n      const isAbort =\n        err instanceof Error &&\n        (err.name === 'AbortError' || abortController.signal.aborted);\n      if (isAbort) {\n        sendSSEEvent(res, {\n          type: 'cancelled',\n          data: { threadId, message: 'Edit cancelled' },\n          timestamp: Date.now(),\n        });\n      } else {\n        const message = err instanceof Error ? err.message : String(err);\n        sendSSEEvent(res, {\n          type: 'error',\n          data: { error: message, code: 'runtime' },\n          timestamp: Date.now(),\n        });\n      }\n    } finally {\n      try {\n        unsubscribe();\n      } catch {\n        // best-effort\n      }\n      closeSSE(res);\n    }\n  };\n}\n"]}

package/dist/types-BfWDIOGm.d.ts

@@ -0,0 +1,145 @@
+import { OrbitalSchema, EntityData, EventPayload } from '@almadar/core';
+
+/**
+ * Public SDK types. Canonical schema / payload types come from `@almadar/core`;
+ * the SDK adds the typed event union and HTTP-layer option shapes.
+ */
+
+/**
+ * Canonical JSON value type — the closure of every value that survives a
+ * `JSON.parse(JSON.stringify(x))` round-trip. Used as the JSON-parse output
+ * type so we never widen to `unknown` at HTTP boundaries.
+ *
+ * Mirrors `packages/almadar-agent/src/api-types.ts:25-31`.
+ */
+type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/**
+ * Lifecycle events emitted by the agent during a `generate()` call. Mirrors
+ * the SSE event types from
+ * `apps/builder/packages/server/src/routes/agent/deepagent.ts` — keep in sync
+ * when new events are added on the server.
+ */
+type AgentEvent = {
+    type: 'start';
+    threadId: string;
+    workDir: string;
+} | {
+    type: 'plan_committed';
+    orbitals: readonly string[];
+} | {
+    type: 'orbital_added';
+    orbital: string;
+} | {
+    type: 'schema_update';
+    schema: OrbitalSchema;
+} | {
+    type: 'app_created';
+    appId: string;
+    name: string;
+} | {
+    type: 'subagent_start';
+    subagent: string;
+} | {
+    type: 'subagent_progress';
+    subagent: string;
+    message: string;
+} | {
+    type: 'subagent_complete';
+    subagent: string;
+} | {
+    type: 'coordinator_decision';
+    decision: string;
+} | {
+    type: 'complete';
+    schema: OrbitalSchema;
+    appId?: string;
+} | {
+    type: 'error';
+    message: string;
+    code?: number;
+};
+/**
+ * Server-emitted error envelope. `code` maps to the SDK error subclasses:
+ * 4001 → ApiKeyError, 4029 → RateLimitedError, 4040 → CatalogOutOfScopeError.
+ */
+interface ApiErrorBody {
+    code: number;
+    message: string;
+    details?: EventPayload;
+}
+/**
+ * Async-mode (`generate({ async: true })`) server response. The client polls
+ * `statusUrl` until the job resolves.
+ */
+interface AsyncJobHandle {
+    jobId: string;
+    statusUrl: string;
+}
+interface GenerateOptions {
+    prompt: string;
+    endUserId?: string;
+    appId?: string;
+    /** Streaming callback for SSE events. */
+    onEvent?: (event: AgentEvent) => void;
+    /**
+     * When true, server responds with an `AsyncJobHandle` immediately and the
+     * client polls. Useful for generations expected to exceed proxy SSE timeouts.
+     */
+    async?: boolean;
+}
+interface GenerateResult {
+    schema: OrbitalSchema;
+    appId?: string;
+}
+/**
+ * Body of a `PUT /api/v1/agent/edit-schema`. Strictly structural; the SDK
+ * does not deep-type the patch — that's the server's job. Field types are
+ * `EventPayload`-compatible so callers can't sneak in arbitrary objects.
+ */
+interface EditSchemaPatch {
+    orbital?: string;
+    traitOverrides?: EventPayload;
+    config?: EventPayload;
+}
+interface CompileOptions {
+    target?: 'express' | 'hono';
+    shell?: 'typescript' | 'python' | 'mobile';
+}
+interface CompileResult {
+    downloadUrl: string;
+    expiresAt: string;
+}
+interface AlmadarClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+    fetch?: typeof fetch;
+}
+/**
+ * Props for `<AlmadarApp />` — renders an orbital schema. The runtime mode
+ * decides whether effects (persist/fetch/call-service) hit a backend or stay
+ * mocked in-browser.
+ */
+interface AlmadarAppProps {
+    schema: OrbitalSchema;
+    /**
+     * - `static`: pure client-side, no server effects. Use with `data`.
+     * - `mock` (default): in-browser fake server, faker-seeded if `data` is undefined.
+     * - `server`: real backend at `serverUrl`.
+     */
+    mode?: 'static' | 'mock' | 'server';
+    /** Seed data keyed by entity name (canonical `EntityData` shape). */
+    data?: EntityData;
+    /** Required when `mode === 'server'`. */
+    serverUrl?: string;
+    initialPagePath?: string;
+    height?: string;
+    className?: string;
+    theme?: 'copper' | 'wireframe' | 'default';
+}
+interface AlmadarAppRef {
+    emit(eventName: string, payload?: EventPayload): void;
+}
+
+export type { AgentEvent as A, CompileOptions as C, EditSchemaPatch as E, GenerateOptions as G, JsonValue as J, AlmadarAppProps as a, AlmadarAppRef as b, AlmadarClientOptions as c, ApiErrorBody as d, AsyncJobHandle as e, CompileResult as f, GenerateResult as g };

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "@almadar/sdk",
+  "version": "0.1.0-alpha.2",
+  "description": "Almadar SDK — embed agent-generated orbital schemas in your React app. AlmadarApp component + AlmadarClient HTTP client.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "peerDependencies": {
+    "@almadar/core": ">=10",
+    "@almadar/runtime": ">=6.13",
+    "@almadar/ui": ">=5.32",
+    "@almadar-io/rabit": ">=0.1.0",
+    "@almadar/workspace": ">=0.1.0",
+    "@almadar/server": ">=2.14.0",
+    "express": ">=4.0.0",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0",
+    "@almadar/llm": ">=2.24.0"
+  },
+  "peerDependenciesMeta": {
+    "@almadar-io/rabit": {
+      "optional": true
+    },
+    "@almadar/workspace": {
+      "optional": true
+    },
+    "@almadar/server": {
+      "optional": true
+    },
+    "express": {
+      "optional": true
+    },
+    "@almadar/llm": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@almadar/core": ">=10",
+    "@almadar/eslint-plugin": ">=2.7.0",
+    "@almadar/runtime": ">=6.13",
+    "@almadar/ui": ">=5.32",
+    "@almadar-io/rabit": ">=0.1.0",
+    "@almadar/workspace": ">=0.1.0",
+    "@almadar/server": ">=2.14.0",
+    "@testing-library/react": "^16.1.0",
+    "@types/express": "^4.17.21",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "10.0.0",
+    "express": "^4.21.0",
+    "happy-dom": "^15.11.7",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0",
+    "@almadar/llm": ">=2.24.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/almadar-io/almadar-sdk.git"
+  },
+  "license": "BSL-1.1",
+  "scripts": {
+    "build": "tsup",
+    "build:watch": "tsup --watch",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest --run"
+  }
+}