@khoralabs/chat 0.1.0

package/README.md

@@ -0,0 +1,7 @@
+# `@khoralabs/chat`
+
+Signed chat ledger: domain service, persistence backends, and HTTP/WS transport.
+
+Requires **Bun** for hashing, `./sqlite`, and `./http/server`. Use `./turso-serverless` for Turso/libSQL-style SQL.
+
+See the [repo README](../../README.md) for the full entrypoint map.

package/dist/domain.d.ts

@@ -0,0 +1,10 @@
+export * from "./errors.js";
+export * from "./events.js";
+export * from "./hash.js";
+export * from "./ids.js";
+export * from "./lineage.js";
+export type * from "./persistence/core/persistence/types.js";
+export * from "./stream.js";
+export * from "./types.js";
+export * from "./validation.js";
+//# sourceMappingURL=domain.d.ts.map

package/dist/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../src/domain.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,mBAAmB,yCAAyC,CAAC;AAC7D,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,20 @@
+export declare class ChatError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare class ChatNotFoundError extends ChatError {
+    readonly resource: string;
+    readonly resourceId: string;
+    constructor(resource: string, resourceId: string);
+}
+export declare class ChatConflictError extends ChatError {
+    readonly reason: "head_conflict" | "idempotency_mismatch" | "stream_revision_conflict";
+    constructor(reason: "head_conflict" | "idempotency_mismatch" | "stream_revision_conflict", message: string);
+}
+export declare class ChatValidationError extends ChatError {
+    constructor(message: string);
+}
+export declare class ChatPermissionError extends ChatError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAMjD;AAED,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,sBAAsB,GAAG,0BAA0B,CAAC;gBAGrF,MAAM,EAAE,eAAe,GAAG,sBAAsB,GAAG,0BAA0B,EAC7E,OAAO,EAAE,MAAM;CAMlB;AAED,qBAAa,mBAAoB,SAAQ,SAAS;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,mBAAoB,SAAQ,SAAS;gBACpC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/events.d.ts

@@ -0,0 +1,59 @@
+import type { Channel, Post, ScopeRef, Thread, ThreadHead } from "./types.js";
+export type PostAppended = {
+    type: "post.appended";
+    threadId: string;
+    post: Post;
+};
+export type PostUpdated = {
+    type: "post.updated";
+    threadId: string;
+    post: Post;
+};
+export type PostDeleted = {
+    type: "post.deleted";
+    threadId: string;
+    postId: string;
+    deletedAtMs: number;
+};
+export type PostStreamStarted = {
+    type: "post.stream.started";
+    threadId: string;
+    post: Post;
+    revision: number;
+};
+export type PostStreamDelta = {
+    type: "post.stream.delta";
+    threadId: string;
+    post: Post;
+    revision: number;
+};
+export type PostStreamCompleted = {
+    type: "post.stream.completed";
+    threadId: string;
+    post: Post;
+    head: ThreadHead;
+    revision: number;
+};
+export type PostStreamAborted = {
+    type: "post.stream.aborted";
+    threadId: string;
+    postId: string;
+    revision: number;
+    deletedAtMs: number;
+};
+export type ThreadCreated = {
+    type: "thread.created";
+    thread: Thread;
+};
+export type ParticipantAdded = {
+    type: "participant.added";
+    threadId: string;
+    scope: ScopeRef;
+    role: string;
+};
+export type ChannelCreated = {
+    type: "channel.created";
+    channel: Channel;
+};
+export type ChatEvent = PostAppended | PostUpdated | PostDeleted | PostStreamStarted | PostStreamDelta | PostStreamCompleted | PostStreamAborted | ThreadCreated | ParticipantAdded | ChannelCreated;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE9E,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,qBAAqB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,qBAAqB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,QAAQ,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,SAAS,GACjB,YAAY,GACZ,WAAW,GACX,WAAW,GACX,iBAAiB,GACjB,eAAe,GACf,mBAAmB,GACnB,iBAAiB,GACjB,aAAa,GACb,gBAAgB,GAChB,cAAc,CAAC"}

package/dist/hash.d.ts

@@ -0,0 +1,47 @@
+import type { Mention, ScopeRef, SignedEnvelope } from "./types.js";
+export declare function sha256Hex(input: string | Uint8Array): string;
+export type CanonicalPostVersionPayload = {
+    postId: string;
+    versionId: string;
+    threadId: string;
+    author: ScopeRef;
+    role: string;
+    parts: unknown[];
+    metadata?: unknown;
+    mentions?: Mention[];
+    model?: unknown;
+    usage?: unknown;
+    parentVersionId?: string | null;
+    previousPostVersionId?: string | null;
+};
+export declare function canonicalPostVersionPayload(input: CanonicalPostVersionPayload): string;
+export declare function computeContentHash(payload: CanonicalPostVersionPayload): string;
+export declare function computeLineageHash(input: {
+    previousLineageHash: string | null;
+    contentHash: string;
+    postId: string;
+    versionId: string;
+}): string;
+export type CanonicalAclEventPayload = {
+    type: string;
+    targetType: "channel" | "thread";
+    targetId: string;
+    scope?: ScopeRef;
+    role?: string;
+    actor: ScopeRef;
+    previousAclEventId?: string | null;
+};
+export declare function canonicalAclEventPayload(input: CanonicalAclEventPayload): string;
+export declare function computeAclEventContentHash(payload: CanonicalAclEventPayload): string;
+export declare function signedPayloadBytes(payload: string): Uint8Array;
+export type SignablePostVersion = CanonicalPostVersionPayload & {
+    contentHash: string;
+    lineageHash: string;
+};
+export declare function canonicalSignedPostVersionPayload(input: SignablePostVersion): string;
+export declare function canonicalSignedAclEventPayload(input: {
+    contentHash: string;
+    payload: CanonicalAclEventPayload;
+}): string;
+export declare function maybeSignPayload(payload: string, signer: ScopeRef, sign: (payload: Uint8Array, signer: ScopeRef) => Promise<SignedEnvelope>): Promise<SignedEnvelope | undefined>;
+//# sourceMappingURL=hash.d.ts.map

package/dist/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEpE,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAI5D;AAiBD,MAAM,MAAM,2BAA2B,GAAG;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,QAAQ,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC,CAAC;AAEF,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,2BAA2B,GAAG,MAAM,CAetF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,2BAA2B,GAAG,MAAM,CAE/E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAST;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,SAAS,GAAG,QAAQ,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,QAAQ,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,wBAAwB,GAAG,MAAM,CAUhF;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CAEpF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAE9D;AAED,MAAM,MAAM,mBAAmB,GAAG,2BAA2B,GAAG;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAMpF;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,wBAAwB,CAAC;CACnC,GAAG,MAAM,CAKT;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,QAAQ,EAChB,IAAI,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,KAAK,OAAO,CAAC,cAAc,CAAC,GACvE,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAErC"}

package/dist/http/client.d.ts

@@ -0,0 +1,21 @@
+import type { UIMessage } from "ai";
+import type { ChatEvent, StartStreamedPostInput } from "../domain.js";
+import type { ChatService } from "../service.js";
+export type ChatFetchFn = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+export type ChatServiceClientOptions = {
+    baseUrl: string;
+    token: string;
+    fetchFn?: ChatFetchFn;
+    subscribeToThread?: (threadId: string, handler: (event: ChatEvent) => void) => () => void;
+};
+export type ChatServiceClient = Pick<ChatService, "getChannel" | "createChannel" | "getThread" | "createThread" | "listPosts" | "listThreads" | "appendPost" | "getThreadTip" | "listThreadParticipants" | "addThreadParticipant" | "setPostVersionSignature" | "startStreamedPost" | "applyPostDelta" | "completeStreamedPost" | "abortStreamedPost"> & {
+    subscribeToThread(threadId: string, handler: (event: ChatEvent) => void): () => void;
+};
+export declare function createChatClient(options: ChatServiceClientOptions): ChatServiceClient;
+export type StartStreamedPostBody = {
+    author: StartStreamedPostInput["author"];
+    message: UIMessage;
+    threadId: string;
+    idempotencyKey?: string;
+};
+//# sourceMappingURL=client.d.ts.map

package/dist/http/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/http/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,KAAK,EAGV,SAAS,EAMT,sBAAsB,EACvB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAuBjD,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEnG,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CAC3F,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,WAAW,EACT,YAAY,GACZ,eAAe,GACf,WAAW,GACX,cAAc,GACd,WAAW,GACX,aAAa,GACb,YAAY,GACZ,cAAc,GACd,wBAAwB,GACxB,sBAAsB,GACtB,yBAAyB,GACzB,mBAAmB,GACnB,gBAAgB,GAChB,sBAAsB,GACtB,mBAAmB,CACtB,GAAG;IACF,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACtF,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CA+ErF;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC"}

package/dist/http/client.js

@@ -0,0 +1,367 @@
+import { createRequire } from "node:module";
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/errors.ts
+class ChatError extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "ChatError";
+    this.code = code;
+  }
+}
+
+class ChatNotFoundError extends ChatError {
+  resource;
+  resourceId;
+  constructor(resource, resourceId) {
+    super("not_found", `${resource} not found: ${resourceId}`);
+    this.name = "ChatNotFoundError";
+    this.resource = resource;
+    this.resourceId = resourceId;
+  }
+}
+
+class ChatConflictError extends ChatError {
+  reason;
+  constructor(reason, message) {
+    super("conflict", message);
+    this.name = "ChatConflictError";
+    this.reason = reason;
+  }
+}
+
+class ChatValidationError extends ChatError {
+  constructor(message) {
+    super("validation", message);
+    this.name = "ChatValidationError";
+  }
+}
+
+class ChatPermissionError extends ChatError {
+  constructor(message) {
+    super("permission_denied", message);
+    this.name = "ChatPermissionError";
+  }
+}
+// src/hash.ts
+function sha256Hex(input) {
+  const hasher = new Bun.CryptoHasher("sha256");
+  hasher.update(input);
+  return hasher.digest("hex");
+}
+function stableStringify(value) {
+  if (value === undefined) {
+    return "null";
+  }
+  if (value === null || typeof value !== "object") {
+    return JSON.stringify(value);
+  }
+  if (Array.isArray(value)) {
+    return `[${value.map((item) => stableStringify(item)).join(",")}]`;
+  }
+  const record = value;
+  const keys = Object.keys(record).sort();
+  return `{${keys.map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`).join(",")}}`;
+}
+function canonicalPostVersionPayload(input) {
+  return stableStringify({
+    postId: input.postId,
+    versionId: input.versionId,
+    threadId: input.threadId,
+    author: input.author,
+    role: input.role,
+    parts: input.parts,
+    metadata: input.metadata ?? null,
+    mentions: input.mentions ?? null,
+    model: input.model ?? null,
+    usage: input.usage ?? null,
+    parentVersionId: input.parentVersionId ?? null,
+    previousPostVersionId: input.previousPostVersionId ?? null
+  });
+}
+function computeContentHash(payload) {
+  return sha256Hex(canonicalPostVersionPayload(payload));
+}
+function computeLineageHash(input) {
+  return sha256Hex(stableStringify({
+    previousLineageHash: input.previousLineageHash,
+    contentHash: input.contentHash,
+    postId: input.postId,
+    versionId: input.versionId
+  }));
+}
+function canonicalAclEventPayload(input) {
+  return stableStringify({
+    type: input.type,
+    targetType: input.targetType,
+    targetId: input.targetId,
+    scope: input.scope ?? null,
+    role: input.role ?? null,
+    actor: input.actor,
+    previousAclEventId: input.previousAclEventId ?? null
+  });
+}
+function computeAclEventContentHash(payload) {
+  return sha256Hex(canonicalAclEventPayload(payload));
+}
+function signedPayloadBytes(payload) {
+  return new TextEncoder().encode(payload);
+}
+function canonicalSignedPostVersionPayload(input) {
+  return stableStringify({
+    contentHash: input.contentHash,
+    lineageHash: input.lineageHash,
+    payload: JSON.parse(canonicalPostVersionPayload(input))
+  });
+}
+function canonicalSignedAclEventPayload(input) {
+  return stableStringify({
+    contentHash: input.contentHash,
+    payload: JSON.parse(canonicalAclEventPayload(input.payload))
+  });
+}
+async function maybeSignPayload(payload, signer, sign) {
+  return sign(signedPayloadBytes(payload), signer);
+}
+// src/ids.ts
+function createId() {
+  return crypto.randomUUID();
+}
+function scopeKey(scope) {
+  return `${scope.type}:${scope.id}`;
+}
+function scopeRefFromKey(key) {
+  const separatorIndex = key.indexOf(":");
+  if (separatorIndex === -1) {
+    throw new Error(`Invalid scope key: ${key}`);
+  }
+  return {
+    type: key.slice(0, separatorIndex),
+    id: key.slice(separatorIndex + 1)
+  };
+}
+// src/lineage.ts
+function walkLineageFromHead(headVersionId, versionsById) {
+  const lineage = [];
+  let currentId = headVersionId;
+  const seenPostIds = new Set;
+  while (currentId) {
+    const version = versionsById.get(currentId);
+    if (!version)
+      break;
+    if (!seenPostIds.has(version.postId)) {
+      lineage.push(version);
+      seenPostIds.add(version.postId);
+    }
+    currentId = version.previousPostVersionId;
+  }
+  return lineage.reverse();
+}
+function lineageBetween(headVersionId, ancestorVersionId, versionsById) {
+  const lineage = walkLineageFromHead(headVersionId, versionsById);
+  const startIndex = lineage.findIndex((version) => version.id === ancestorVersionId);
+  if (startIndex === -1)
+    return null;
+  return lineage.slice(startIndex);
+}
+function postFromVersion(version, index, deletedAtMs) {
+  return {
+    ...version,
+    id: version.postId,
+    status: "complete",
+    versionId: version.id,
+    previousVersionId: version.parentVersionId ?? null,
+    index,
+    updatedAtMs: version.parentVersionId ? version.createdAtMs : null,
+    deletedAtMs: deletedAtMs ?? null
+  };
+}
+// src/stream.ts
+function rebuildStreamCacheFromEvents(events) {
+  const sorted = [...events].sort((a, b) => a.revision - b.revision);
+  let message = null;
+  let mentions;
+  let model;
+  let usage;
+  let revision = 0;
+  for (const event of sorted) {
+    if (event.eventType === "stream.started") {
+      if (!event.message) {
+        throw new Error(`stream.started event ${event.id} missing message`);
+      }
+      message = event.message;
+      mentions = event.mentions;
+      model = event.model;
+      usage = event.usage;
+      revision = event.revision;
+      continue;
+    }
+    if (event.eventType === "stream.delta") {
+      if (!event.message) {
+        throw new Error(`stream.delta event ${event.id} missing message`);
+      }
+      message = event.message;
+      if (event.mentions !== undefined)
+        mentions = event.mentions;
+      if (event.model !== undefined)
+        model = event.model;
+      if (event.usage !== undefined)
+        usage = event.usage;
+      revision = event.revision;
+      continue;
+    }
+    if (event.eventType === "stream.completed" || event.eventType === "stream.aborted") {
+      revision = event.revision;
+    }
+  }
+  if (!message) {
+    throw new Error("stream events did not produce a message");
+  }
+  return { message, mentions, model, usage, revision };
+}
+function streamingPostFromCache(input) {
+  return {
+    ...input.message,
+    id: input.postId,
+    status: "streaming",
+    threadId: input.threadId,
+    author: input.author,
+    mentions: input.mentions,
+    model: input.model,
+    usage: input.usage,
+    index: input.index,
+    streamRevision: input.streamRevision,
+    createdAtMs: input.createdAtMs,
+    updatedAtMs: input.updatedAtMs ?? null,
+    deletedAtMs: input.deletedAtMs ?? null
+  };
+}
+function mergeThreadPostsForList(lineagePosts, activePosts) {
+  const byIndex = new Map;
+  for (const item of lineagePosts) {
+    byIndex.set(item.index, item.post);
+  }
+  for (const post of activePosts) {
+    if (post.status === "streaming" || post.status === "aborted") {
+      byIndex.set(post.index, post);
+    }
+  }
+  return [...byIndex.entries()].sort(([a], [b]) => a - b).map(([, post]) => post);
+}
+// src/validation.ts
+function assertThreadRoot(root) {
+  if (root.type === "channel") {
+    if (!root.channelId.trim()) {
+      throw new ChatValidationError("channel root requires channelId");
+    }
+    return;
+  }
+  if (!root.postId.trim()) {
+    throw new ChatValidationError("post root requires postId");
+  }
+}
+function assertNonEmptyString(value, label) {
+  if (!value.trim()) {
+    throw new ChatValidationError(`${label} is required`);
+  }
+}
+// src/http/client.ts
+async function readJson(res) {
+  const text = await res.text();
+  if (!res.ok) {
+    let message = `Chat request failed ${res.status}`;
+    try {
+      const data = JSON.parse(text);
+      if (data.error !== undefined && data.error.length > 0)
+        message = data.error;
+    } catch {
+      if (text.length > 0)
+        message = text;
+    }
+    if (res.status === 404) {
+      const match = /^(channel|thread|post) not found: (.+)$/i.exec(message);
+      if (match?.[1] !== undefined && match[2] !== undefined) {
+        throw new ChatNotFoundError(match[1].toLowerCase(), match[2]);
+      }
+    }
+    throw new Error(message);
+  }
+  return text.length > 0 ? JSON.parse(text) : {};
+}
+function createChatClient(options) {
+  const baseUrl = options.baseUrl.replace(/\/$/, "");
+  const fetchFn = options.fetchFn ?? fetch;
+  async function post(path, body) {
+    const res = await fetchFn(`${baseUrl}${path}`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${options.token}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(body)
+    });
+    return readJson(res);
+  }
+  return {
+    getChannel(id) {
+      return post("/channels/get", { channelId: id });
+    },
+    createChannel(input) {
+      return post("/channels/create", input);
+    },
+    getThread(id) {
+      return post("/threads/get", { threadId: id });
+    },
+    createThread(input) {
+      return post("/threads/create", input);
+    },
+    listThreads(input) {
+      return post("/threads/list", input);
+    },
+    listPosts(input) {
+      return post("/threads/list-posts", input);
+    },
+    async appendPost(input) {
+      return post("/threads/append-post", input);
+    },
+    async getThreadTip(threadId) {
+      const result = await post("/threads/tip", { threadId });
+      return result.tip;
+    },
+    async listThreadParticipants(threadId) {
+      const result = await post("/threads/list-participants", { threadId });
+      return result.participants;
+    },
+    addThreadParticipant(input) {
+      return post("/threads/add-participant", input);
+    },
+    async setPostVersionSignature(versionId, signature) {
+      await post("/posts/set-signature", { versionId, signature });
+    },
+    startStreamedPost(input) {
+      return post("/internal/chat/streamed-posts", input);
+    },
+    applyPostDelta(input) {
+      return post(`/internal/chat/posts/${encodeURIComponent(input.postId)}/deltas`, input);
+    },
+    completeStreamedPost(input) {
+      return post(`/internal/chat/posts/${encodeURIComponent(input.postId)}/complete`, input);
+    },
+    abortStreamedPost(input) {
+      return post(`/internal/chat/posts/${encodeURIComponent(input.postId)}/abort`, input);
+    },
+    subscribeToThread(threadId, handler) {
+      if (options.subscribeToThread !== undefined) {
+        return options.subscribeToThread(threadId, handler);
+      }
+      const wsUrl = `${baseUrl.replace(/^http/, "ws")}/ws/threads/${encodeURIComponent(threadId)}?token=${encodeURIComponent(options.token)}`;
+      const ws = new WebSocket(wsUrl);
+      ws.onmessage = (event) => handler(JSON.parse(String(event.data)));
+      return () => ws.close();
+    }
+  };
+}
+export {
+  createChatClient
+};

package/dist/http/config.d.ts

@@ -0,0 +1,5 @@
+export declare function resolveChatDataDir(): string;
+export declare function resolveChatDbPath(): string;
+export declare function chatInternalToken(): string;
+export declare function chatHttpPort(): number;
+//# sourceMappingURL=config.d.ts.map

package/dist/http/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/http/config.ts"],"names":[],"mappings":"AAEA,wBAAgB,kBAAkB,IAAI,MAAM,CAI3C;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAI1C;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAM1C;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

package/dist/http/index.d.ts

@@ -0,0 +1,6 @@
+export { type ChatFetchFn, type ChatServiceClient, type ChatServiceClientOptions, createChatClient, type StartStreamedPostBody, } from "./client.js";
+export { chatHttpPort, chatInternalToken, resolveChatDataDir, resolveChatDbPath, } from "./config.js";
+export { type AuthorizeRequest, createChatRoutes, createChatRoutesWithParams, createTokenAuthorizer, dispatchChatRoute, type RouteHandler, readJson, requireInternalToken, } from "./routes.js";
+export { type ChatHttpServerHandle, type StartChatHttpServerOptions, startChatHttpServer, } from "./server.js";
+export { type ChatHttpRuntime, type ChatStorage, type ChatStorageConfig, type CreateChatHttpRuntimeOptions, createChatHttpRuntime, createChatStorage, isChatNotFound, } from "./service.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,gBAAgB,EACrB,gBAAgB,EAChB,0BAA0B,EAC1B,qBAAqB,EACrB,iBAAiB,EACjB,KAAK,YAAY,EACjB,QAAQ,EACR,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,EACjC,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,GACf,MAAM,cAAc,CAAC"}