@nodetool-ai/sdk 0.8.1

package/README.md

@@ -0,0 +1,122 @@
+# `@nodetool-ai/sdk`
+
+TypeScript SDK for the NodeTool server.
+
+- **Fully-typed tRPC client** covering the entire `AppRouter` surface
+  (threads, messages, models, workflows, jobs, assets, settings, …) —
+  no separate API definition to maintain.
+- **`ChatSocket`** — typed event-emitter wrapper around the chat
+  WebSocket protocol (msgpack frames, with JSON fallback).
+- Works in browsers and Node ≥18. In Node, pass a `WebSocket`
+  constructor from the [`ws`](https://www.npmjs.com/package/ws) package.
+
+## Install
+
+This package lives inside the NodeTool monorepo. From a workspace
+that depends on it (`@nodetool-ai/sdk: "*"`), import directly:
+
+```ts
+import { createNodetoolClient } from "@nodetool-ai/sdk";
+```
+
+## Usage
+
+```ts
+import { createNodetoolClient } from "@nodetool-ai/sdk";
+
+const nodetool = createNodetoolClient({
+  baseUrl: "http://localhost:7777",
+  authToken: process.env.NODETOOL_TOKEN ?? null
+});
+
+// ── tRPC ──────────────────────────────────────────────────────
+const { threads } = await nodetool.trpc.threads.list.query({ limit: 50 });
+const thread = await nodetool.trpc.threads.create.mutate({ title: "Hi" });
+const { messages } = await nodetool.trpc.messages.list.query({
+  thread_id: thread.id,
+  limit: 100
+});
+
+// ── Convenience: list LLM models from configured providers ────
+const models = await nodetool.listLanguageModels();
+// → [{ id: "gpt-5.4-mini", name: "GPT 5.4 mini", provider: "openai" }, …]
+
+// ── Streaming chat WebSocket ──────────────────────────────────
+const socket = nodetool.chat();
+
+socket.on("chunk", (c) => {
+  // c.content — partial text; c.done — true on the final chunk
+});
+socket.on("message", (m) => {
+  // Final persisted assistant message (after stream completes)
+});
+socket.on("tool_call", (t) => {
+  // t.name, t.args
+});
+socket.on("error", (e) => console.error(e.message));
+socket.on("state", (s) => console.log("ws state:", s));
+
+socket.connect();
+socket.send({
+  threadId: thread.id,
+  text: "Hello!",
+  model: "fake-model-v1",
+  provider: "fake"
+});
+
+// To cancel an in-flight stream:
+socket.stop(thread.id);
+```
+
+## Node usage
+
+```ts
+import { WebSocket } from "ws";
+import { createNodetoolClient } from "@nodetool-ai/sdk";
+
+const nodetool = createNodetoolClient({
+  baseUrl: "http://localhost:7777",
+  WebSocket // pass the ws constructor explicitly
+});
+```
+
+## API surface
+
+```ts
+createNodetoolClient(opts: {
+  baseUrl: string;
+  authToken?: string | null;
+  fetch?: typeof fetch;
+  WebSocket?: typeof WebSocket;
+}): NodetoolClient
+
+interface NodetoolClient {
+  baseUrl: string;
+  authToken: string | null;
+  trpc: CreateTRPCClient<AppRouter>;        // full type-safe tRPC client
+  chat(): ChatSocket;                        // open a new chat WebSocket
+  listLanguageModels(): Promise<{
+    id: string; name: string; provider: string;
+  }[]>;
+}
+
+class ChatSocket {
+  connect(): void;
+  disconnect(): void;
+  send(opts: SendChatMessageOptions): void;
+  stop(threadId: string): void;
+  on<K extends keyof ChatEvents>(event: K, h: (p: ChatEvents[K]) => void): () => void;
+  getState(): ConnectionState;
+}
+```
+
+Discriminated `ChatEvent` union covers `chunk`, `message`, `tool_call`,
+`error`, `generation_stopped`, `thread_update`, `planning_update`,
+`task_update`, plus a `raw` catch-all for forward-compatible frames.
+
+## Worked example
+
+See [`examples/chat_app/`](../../examples/chat_app/) for a complete
+shadcn/ui chat client built on top of this SDK, plus a CLI smoke test
+([`scripts/live-test.mjs`](../../examples/chat_app/scripts/live-test.mjs))
+that exercises the same flow end-to-end.

package/dist/.nodetool-build-stamp

@@ -0,0 +1 @@
+2026-09-28T09:19:19.084Z

package/dist/chat.d.ts

@@ -0,0 +1,137 @@
+/**
+ * ChatSocket — typed wrapper around the unified NodeTool chat WebSocket.
+ *
+ * Wire format: msgpack frames by default (length-tagged, binary), with a JSON
+ * text fallback if msgpack encoding fails. Inbound frames are decoded and
+ * dispatched to the appropriate `on(<type>)` handlers as a discriminated
+ * union, so consumers never see raw bytes.
+ */
+import type { Chunk, Message, ToolCallUpdate, PlanningUpdate, TaskUpdate, ErrorMessage } from "@nodetool-ai/protocol";
+export type WebSocketCtor = typeof WebSocket;
+/**
+ * A field value as it comes off the wire. msgpack and JSON both decode into
+ * this domain, so a frame's own fields have a contract before anything narrows
+ * them to a protocol shape.
+ */
+export type ChatFrameValue = null | boolean | number | string | Uint8Array | ChatFrameValue[] | ChatFrameFields;
+export interface ChatFrameFields {
+    [field: string]: ChatFrameValue | undefined;
+}
+export type ConnectionState = "idle" | "connecting" | "connected" | "disconnected" | "reconnecting" | "error";
+/** A streamed text chunk. `done: true` marks the end of one assistant turn. */
+export interface ChatChunkEvent extends Chunk {
+    type: "chunk";
+}
+/** A complete persisted message (assistant final or echoed user input). */
+export interface ChatMessageEvent extends Message {
+    type: "message";
+    role: "user" | "assistant" | "system" | "tool";
+}
+/** Tool invocation announced mid-stream. */
+export interface ChatToolCallEvent extends ToolCallUpdate {
+}
+/** Server-side failure during chat processing. */
+export interface ChatErrorEvent extends ErrorMessage {
+}
+/** Ack frame after a `stop` command. */
+export interface ChatGenerationStoppedEvent {
+    type: "generation_stopped";
+    thread_id?: string | null;
+    job_id?: string | null;
+    message?: string;
+}
+/** A new derived title for a thread (e.g. after summarisation). */
+export interface ChatThreadUpdateEvent {
+    type: "thread_update";
+    thread_id: string;
+    title?: string;
+}
+/** Anything else — surfaced raw so callers can opt in to it. */
+export interface ChatRawEvent extends ChatFrameFields {
+    type: string;
+}
+export type ChatEvent = ChatChunkEvent | ChatMessageEvent | ChatToolCallEvent | ChatErrorEvent | ChatGenerationStoppedEvent | ChatThreadUpdateEvent | PlanningUpdate | TaskUpdate | ChatRawEvent;
+export interface SendChatMessageOptions {
+    threadId: string;
+    text: string;
+    model?: string | null;
+    provider?: string | null;
+    agentMode?: boolean;
+    tools?: string[] | null;
+    collections?: string[] | null;
+    /**
+     * Whether the turn's tool calls run, ask, or are blocked — `"auto"` runs
+     * everything, `"default"` parks actions on an approval request, `"plan"`
+     * blocks them. Omitted leaves the server's default (`"default"`), which
+     * needs a surface that can answer approvals.
+     */
+    permissionMode?: "plan" | "default" | "auto" | null;
+}
+export interface ChatSocketOptions {
+    /** Full WebSocket URL, e.g. `ws://localhost:7777/ws`. */
+    url: string;
+    authToken?: string | null;
+    /** Override for environments without a global `WebSocket`. */
+    WebSocket?: WebSocketCtor;
+    /** Initial reconnect backoff in ms (default 1500, capped at 15s). */
+    reconnectDelayMs?: number;
+    /** Max reconnect attempts before giving up (default 10, 0 disables). */
+    maxReconnect?: number;
+}
+type EventMap = {
+    chunk: ChatChunkEvent;
+    message: ChatMessageEvent;
+    tool_call: ChatToolCallEvent;
+    error: ChatErrorEvent;
+    generation_stopped: ChatGenerationStoppedEvent;
+    thread_update: ChatThreadUpdateEvent;
+    planning_update: PlanningUpdate;
+    task_update: TaskUpdate;
+    raw: ChatEvent;
+    state: ConnectionState;
+};
+type Listener<K extends keyof EventMap> = (payload: EventMap[K]) => void;
+export declare class ChatSocket {
+    private readonly url;
+    private readonly authToken;
+    private readonly Ctor;
+    private readonly reconnectDelayMs;
+    private readonly maxReconnect;
+    private socket;
+    private state;
+    private intentionalClose;
+    private reconnectAttempts;
+    private reconnectTimer;
+    private readonly listeners;
+    constructor(options: ChatSocketOptions);
+    /** Current connection state. */
+    getState(): ConnectionState;
+    /**
+     * Subscribe to an event. Returns an unsubscribe function.
+     *
+     * The `raw` event fires for every inbound frame, including types that don't
+     * have their own typed handler — useful for bridging future server events.
+     */
+    on<K extends keyof EventMap>(event: K, listener: Listener<K>): () => void;
+    /** Open the socket. No-op if already open or connecting. */
+    connect(): void;
+    /** Close the socket and cancel any pending reconnect. */
+    disconnect(): void;
+    /** Send a `chat_message` command. */
+    send(opts: SendChatMessageOptions): void;
+    /** Send a `stop` command for the given thread. */
+    stop(threadId: string): void;
+    /**
+     * Reattach to a thread's in-flight turn after a disconnect: the server
+     * replays every frame it stamped after `lastSeq`, so a dropped socket costs
+     * no output and no second inference.
+     */
+    resume(threadId: string, lastSeq: number): void;
+    private setState;
+    private emit;
+    private sendCommand;
+    private handleRaw;
+    private scheduleReconnect;
+}
+export {};
+//# sourceMappingURL=chat.d.ts.map

package/dist/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../src/chat.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,KAAK,EACL,OAAO,EAEP,cAAc,EACd,cAAc,EACd,UAAU,EACV,YAAY,EACb,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,aAAa,GAAG,OAAO,SAAS,CAAC;AAE7C;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACtB,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,UAAU,GACV,cAAc,EAAE,GAChB,eAAe,CAAC;AAEpB,MAAM,WAAW,eAAe;IAC9B,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;CAC7C;AAKD,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,YAAY,GACZ,WAAW,GACX,cAAc,GACd,cAAc,GACd,OAAO,CAAC;AAEZ,+EAA+E;AAC/E,MAAM,WAAW,cAAe,SAAQ,KAAK;IAC3C,IAAI,EAAE,OAAO,CAAC;CACf;AAED,2EAA2E;AAC3E,MAAM,WAAW,gBAAiB,SAAQ,OAAO;IAC/C,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;CAChD;AAED,4CAA4C;AAC5C,MAAM,WAAW,iBAAkB,SAAQ,cAAc;CAAG;AAE5D,kDAAkD;AAClD,MAAM,WAAW,cAAe,SAAQ,YAAY;CAAG;AAEvD,wCAAwC;AACxC,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,mEAAmE;AACnE,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,gEAAgE;AAChE,MAAM,WAAW,YAAa,SAAQ,eAAe;IACnD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,SAAS,GACjB,cAAc,GACd,gBAAgB,GAChB,iBAAiB,GACjB,cAAc,GACd,0BAA0B,GAC1B,qBAAqB,GACrB,cAAc,GACd,UAAU,GACV,YAAY,CAAC;AA6BjB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC9B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,8DAA8D;IAC9D,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,KAAK,QAAQ,GAAG;IAEd,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,KAAK,EAAE,cAAc,CAAC;IACtB,kBAAkB,EAAE,0BAA0B,CAAC;IAC/C,aAAa,EAAE,qBAAqB,CAAC;IACrC,eAAe,EAAE,cAAc,CAAC;IAChC,WAAW,EAAE,UAAU,CAAC;IAExB,GAAG,EAAE,SAAS,CAAC;IACf,KAAK,EAAE,eAAe,CAAC;CACxB,CAAC;AAEF,KAAK,QAAQ,CAAC,CAAC,SAAS,MAAM,QAAQ,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAQzE,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IAEtC,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAWxB;IAEF,YAAY,OAAO,EAAE,iBAAiB,EAarC;IAED,gCAAgC;IAChC,QAAQ,IAAI,eAAe,CAE1B;IAED;;;;;OAKG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAMxE;IAED,4DAA4D;IAC5D,OAAO,IAAI,IAAI,CAqCd;IAED,yDAAyD;IACzD,UAAU,IAAI,IAAI,CAOjB;IAED,qCAAqC;IACrC,IAAI,CAAC,IAAI,EAAE,sBAAsB,GAAG,IAAI,CAgBvC;IAED,kDAAkD;IAClD,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE3B;IAED;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAK9C;IAED,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,IAAI;IAWZ,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,SAAS;IAiBjB,OAAO,CAAC,iBAAiB;CAgB1B"}

package/dist/chat.js

@@ -0,0 +1,268 @@
+/**
+ * ChatSocket — typed wrapper around the unified NodeTool chat WebSocket.
+ *
+ * Wire format: msgpack frames by default (length-tagged, binary), with a JSON
+ * text fallback if msgpack encoding fails. Inbound frames are decoded and
+ * dispatched to the appropriate `on(<type>)` handlers as a discriminated
+ * union, so consumers never see raw bytes.
+ */
+import { pack, unpack } from "msgpackr";
+const DEFAULT_RECONNECT_MS = 1500;
+const DEFAULT_MAX_RECONNECT = 10;
+const MAX_RECONNECT_MS = 15_000;
+export class ChatSocket {
+    url;
+    authToken;
+    Ctor;
+    reconnectDelayMs;
+    maxReconnect;
+    socket = null;
+    state = "idle";
+    intentionalClose = false;
+    reconnectAttempts = 0;
+    reconnectTimer = null;
+    listeners = {
+        chunk: new Set(),
+        message: new Set(),
+        tool_call: new Set(),
+        error: new Set(),
+        generation_stopped: new Set(),
+        thread_update: new Set(),
+        planning_update: new Set(),
+        task_update: new Set(),
+        raw: new Set(),
+        state: new Set()
+    };
+    constructor(options) {
+        this.url = options.url;
+        this.authToken = options.authToken ?? null;
+        this.reconnectDelayMs = options.reconnectDelayMs ?? DEFAULT_RECONNECT_MS;
+        this.maxReconnect = options.maxReconnect ?? DEFAULT_MAX_RECONNECT;
+        const Ctor = options.WebSocket ?? globalCtor();
+        if (!Ctor) {
+            throw new Error("No `WebSocket` constructor available. Pass `WebSocket` from `ws` " +
+                "(Node) or run in a browser context.");
+        }
+        this.Ctor = Ctor;
+    }
+    /** Current connection state. */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Subscribe to an event. Returns an unsubscribe function.
+     *
+     * The `raw` event fires for every inbound frame, including types that don't
+     * have their own typed handler — useful for bridging future server events.
+     */
+    on(event, listener) {
+        const set = this.listeners[event];
+        set.add(listener);
+        return () => {
+            set.delete(listener);
+        };
+    }
+    /** Open the socket. No-op if already open or connecting. */
+    connect() {
+        if (this.socket &&
+            (this.socket.readyState === this.Ctor.OPEN ||
+                this.socket.readyState === this.Ctor.CONNECTING)) {
+            return;
+        }
+        this.intentionalClose = false;
+        this.setState("connecting");
+        let url = this.url;
+        if (this.authToken) {
+            url +=
+                (url.includes("?") ? "&" : "?") +
+                    "token=" +
+                    encodeURIComponent(this.authToken);
+        }
+        const ws = new this.Ctor(url);
+        ws.binaryType = "arraybuffer";
+        this.socket = ws;
+        ws.onopen = () => {
+            this.reconnectAttempts = 0;
+            this.setState("connected");
+        };
+        ws.onclose = () => {
+            this.socket = null;
+            if (this.intentionalClose) {
+                this.setState("disconnected");
+                return;
+            }
+            this.setState("reconnecting");
+            this.scheduleReconnect();
+        };
+        ws.onerror = () => this.setState("error");
+        ws.onmessage = (ev) => this.handleRaw(ev.data);
+    }
+    /** Close the socket and cancel any pending reconnect. */
+    disconnect() {
+        this.intentionalClose = true;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        this.socket?.close();
+    }
+    /** Send a `chat_message` command. */
+    send(opts) {
+        this.sendCommand({
+            command: "chat_message",
+            data: {
+                type: "message",
+                role: "user",
+                content: [{ type: "text", text: opts.text }],
+                thread_id: opts.threadId,
+                model: opts.model ?? null,
+                provider: opts.provider ?? null,
+                agent_mode: opts.agentMode ?? false,
+                tools: opts.tools ?? null,
+                collections: opts.collections ?? null,
+                permission_mode: opts.permissionMode ?? null
+            }
+        });
+    }
+    /** Send a `stop` command for the given thread. */
+    stop(threadId) {
+        this.sendCommand({ command: "stop", data: { thread_id: threadId } });
+    }
+    /**
+     * Reattach to a thread's in-flight turn after a disconnect: the server
+     * replays every frame it stamped after `lastSeq`, so a dropped socket costs
+     * no output and no second inference.
+     */
+    resume(threadId, lastSeq) {
+        this.sendCommand({
+            command: "resume_chat",
+            data: { thread_id: threadId, last_seq: lastSeq }
+        });
+    }
+    setState(state) {
+        if (this.state === state)
+            return;
+        this.state = state;
+        this.emit("state", state);
+    }
+    emit(event, payload) {
+        for (const fn of this.listeners[event]) {
+            try {
+                fn(payload);
+            }
+            catch (err) {
+                // Don't let one buggy listener break the dispatcher.
+                console.error("[ChatSocket] listener for", event, "threw:", err);
+            }
+        }
+    }
+    sendCommand(payload) {
+        if (!this.socket || this.socket.readyState !== this.Ctor.OPEN) {
+            throw new Error("WebSocket is not connected");
+        }
+        let frame;
+        try {
+            frame = pack(payload);
+        }
+        catch (err) {
+            console.warn("[ChatSocket] msgpack encode failed, falling back to JSON:", err);
+            frame = JSON.stringify(payload);
+        }
+        // SAFETY: msgpackr owns encoded frames, so their backing store is an
+        // ArrayBuffer. Its declaration also covers shared buffers supplied by callers.
+        this.socket.send(frame);
+    }
+    handleRaw(inbound) {
+        const frame = isTextFrame(inbound)
+            ? parseTextFrame(inbound)
+            : decodeBinaryFrame(inbound);
+        if (!frame)
+            return;
+        this.emit("raw", frame);
+        const type = frame.type;
+        if (isKnownEventType(type)) {
+            // SAFETY: `isKnownEventType` proved the tag is one of `EventMap`'s
+            // discriminated keys, so the frame is that key's payload. TypeScript
+            // cannot correlate a union key with its own payload across the generic
+            // `emit` call.
+            this.emit(type, frame);
+        }
+    }
+    scheduleReconnect() {
+        if (this.maxReconnect === 0) {
+            this.setState("error");
+            return;
+        }
+        if (this.reconnectAttempts >= this.maxReconnect) {
+            this.setState("error");
+            return;
+        }
+        this.reconnectAttempts++;
+        const delay = Math.min(this.reconnectDelayMs * this.reconnectAttempts, MAX_RECONNECT_MS);
+        this.reconnectTimer = setTimeout(() => this.connect(), delay);
+    }
+}
+const KNOWN_TYPES = new Set([
+    "chunk",
+    "message",
+    "tool_call",
+    "error",
+    "generation_stopped",
+    "thread_update",
+    "planning_update",
+    "task_update"
+]);
+function isKnownEventType(type) {
+    return KNOWN_TYPES.has(type);
+}
+function isTextFrame(inbound) {
+    return typeof inbound === "string";
+}
+/** `typeof` calls null, arrays and byte blobs "object" too; a frame body is none of those. */
+function isFrameFields(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        !Array.isArray(value) &&
+        !(value instanceof Uint8Array));
+}
+function isFrameTag(value) {
+    return typeof value === "string";
+}
+function toChatEvent(decoded) {
+    if (!isFrameFields(decoded) || !isFrameTag(decoded.type))
+        return null;
+    // SAFETY: the two predicates above establish exactly what `ChatEvent`'s
+    // widest member `ChatRawEvent` declares — a keyed frame body with a string
+    // `type`. Tags we model narrow further in `handleRaw`.
+    return decoded;
+}
+function parseTextFrame(text) {
+    try {
+        return toChatEvent(JSON.parse(text));
+    }
+    catch (err) {
+        console.error("[ChatSocket] failed to parse JSON frame:", err);
+        return null;
+    }
+}
+function decodeBinaryFrame(inbound) {
+    try {
+        return toChatEvent(unpack(frameBytes(inbound)));
+    }
+    catch (err) {
+        console.error("[ChatSocket] failed to decode msgpack frame:", err);
+        return null;
+    }
+}
+/** Some platforms deliver a Buffer-like view rather than a bare `ArrayBuffer`. */
+function frameBytes(inbound) {
+    return inbound instanceof ArrayBuffer
+        ? new Uint8Array(inbound)
+        : new Uint8Array(inbound.buffer, inbound.byteOffset, inbound.byteLength);
+}
+function globalCtor() {
+    if (typeof WebSocket !== "undefined")
+        return WebSocket;
+    return null;
+}
+//# sourceMappingURL=chat.js.map

package/dist/chat.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,55 @@
+import { type CreateTRPCClient } from "@trpc/client";
+import type { AppRouter } from "@nodetool-ai/websocket/trpc";
+import { ChatSocket, type WebSocketCtor } from "./chat.js";
+export interface CreateNodetoolClientOptions {
+    /** Server base URL, e.g. `http://localhost:7777`. */
+    baseUrl: string;
+    /**
+     * Optional bearer token. Sent as `Authorization: Bearer <token>` on every
+     * tRPC and REST call, and appended as `?token=<token>` on the chat WebSocket.
+     */
+    authToken?: string | null;
+    /**
+     * Override `fetch`. Defaults to the global `fetch`. Pass a wrapped fetch to
+     * inject extra headers, observability, etc.
+     */
+    fetch?: typeof fetch;
+    /**
+     * `WebSocket` constructor for environments without a global one (e.g. Node).
+     * Browsers: leave undefined to use the built-in `WebSocket`.
+     * Node 18+: pass `WebSocket` from the `ws` package.
+     */
+    WebSocket?: WebSocketCtor;
+}
+export interface NodetoolClient {
+    /** Server base URL. */
+    readonly baseUrl: string;
+    /** Auth token used for new sockets and tRPC calls. */
+    readonly authToken: string | null;
+    /**
+     * Typed tRPC client covering the full {@link AppRouter} surface
+     * (threads, messages, models, workflows, jobs, assets, settings, …).
+     */
+    readonly trpc: CreateTRPCClient<AppRouter>;
+    /**
+     * Open a new chat WebSocket.  The returned {@link ChatSocket} is an
+     * event emitter for `chunk` / `message` / `tool_call` / `error` frames
+     * and exposes `send()` and `stop()` for outbound commands.
+     *
+     * Multiple chat sockets can be opened against the same client — typical use
+     * is one-per-active-thread.
+     */
+    chat(): ChatSocket;
+    /**
+     * Convenience helper: list every LLM model from every provider that
+     * advertises the `generate_message` capability and is configured for the
+     * current user. Output is a flat list with `{ id, name, provider }`.
+     */
+    listLanguageModels(): Promise<Array<{
+        id: string;
+        name: string;
+        provider: string;
+    }>>;
+}
+export declare function createNodetoolClient(options: CreateNodetoolClientOptions): NodetoolClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAE3D,MAAM,WAAW,2BAA2B;IAC1C,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC3C;;;;;;;OAOG;IACH,IAAI,IAAI,UAAU,CAAC;IACnB;;;;OAIG;IACH,kBAAkB,IAAI,OAAO,CAC3B,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CACtD,CAAC;CACH;AAeD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,2BAA2B,GACnC,cAAc,CA+DhB"}

package/dist/client.js

@@ -0,0 +1,70 @@
+import { createTRPCClient, httpBatchLink } from "@trpc/client";
+import { TRPC_MAX_BATCH_SIZE } from "@nodetool-ai/protocol";
+import { ChatSocket } from "./chat.js";
+function trimTrailingSlash(s) {
+    return s.endsWith("/") ? s.slice(0, -1) : s;
+}
+function defaultFetch() {
+    if (typeof fetch === "undefined") {
+        throw new Error("No global `fetch` available — pass `fetch` in CreateNodetoolClientOptions");
+    }
+    return fetch;
+}
+export function createNodetoolClient(options) {
+    const baseUrl = trimTrailingSlash(options.baseUrl);
+    const authToken = options.authToken ?? null;
+    const fetchImpl = options.fetch ?? defaultFetch();
+    const trpc = createTRPCClient({
+        links: [
+            httpBatchLink({
+                url: `${baseUrl}/trpc`,
+                // Cap the batch: tRPC joins every procedure name into one URL path
+                // segment, and Fastify's router rejects a segment over `maxParamLength`
+                // with a 404. A model-picker mount batched 116 procedures into a ~2900
+                // char path and got nothing back.
+                maxItems: TRPC_MAX_BATCH_SIZE,
+                // POST keeps the batched input in the request body instead of the URL,
+                // so large batches stay under reverse-proxy URL-length limits. See #3979.
+                methodOverride: "POST",
+                fetch: fetchImpl,
+                headers() {
+                    return authToken ? { Authorization: `Bearer ${authToken}` } : {};
+                }
+            })
+        ]
+    });
+    const wsUrl = baseUrl.replace(/^http(s?):\/\//, (_, s) => `ws${s}://`) + "/ws";
+    return {
+        baseUrl,
+        authToken,
+        trpc,
+        chat() {
+            return new ChatSocket({
+                url: wsUrl,
+                authToken,
+                WebSocket: options.WebSocket
+            });
+        },
+        async listLanguageModels() {
+            const providers = await trpc.models.providers.query();
+            const llmProviders = providers.filter((p) => p.capabilities.includes("generate_message"));
+            const groups = await Promise.all(llmProviders.map(async (p) => {
+                try {
+                    const models = await trpc.models.llmByProvider.query({
+                        provider: p.provider
+                    });
+                    return models.map((m) => ({
+                        id: m.id ?? m.name,
+                        name: m.name ?? m.id,
+                        provider: p.provider
+                    }));
+                }
+                catch {
+                    return [];
+                }
+            }));
+            return groups.flat();
+        }
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @nodetool-ai/sdk — TypeScript SDK for the NodeTool server.
+ *
+ * Surfaces:
+ *   - `createNodetoolClient()` — typed tRPC client (full AppRouter coverage)
+ *     plus a `.chat()` factory for the streaming WebSocket.
+ *   - `ChatSocket` — typed event-emitter wrapper around the chat WebSocket
+ *     protocol (msgpack frames, with JSON fallback).
+ *
+ * Works in both browsers (native `WebSocket`/`fetch`) and Node ≥18 (native
+ * `fetch`; pass a `WebSocket` constructor from the `ws` package).
+ */
+export { createNodetoolClient } from "./client.js";
+export type { NodetoolClient, CreateNodetoolClientOptions } from "./client.js";
+export { ChatSocket } from "./chat.js";
+export type { ChatEvent, ChatChunkEvent, ChatMessageEvent, ChatToolCallEvent, ChatErrorEvent, ChatGenerationStoppedEvent, ChatThreadUpdateEvent, ChatRawEvent, ChatFrameFields, ChatFrameValue, SendChatMessageOptions, ChatSocketOptions, ConnectionState, WebSocketCtor } from "./chat.js";
+export type { AppRouter } from "@nodetool-ai/websocket/trpc";
+export type { Chunk, ContentType, JobStatus, TaskUpdate, PlanningUpdate, ToolCallUpdate, ErrorMessage } from "@nodetool-ai/protocol";
+//# 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;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EACV,cAAc,EACd,2BAA2B,EAC5B,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EACV,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,0BAA0B,EAC1B,qBAAqB,EACrB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACd,MAAM,WAAW,CAAC;AAInB,YAAY,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAG7D,YAAY,EACV,KAAK,EACL,WAAW,EACX,SAAS,EACT,UAAU,EACV,cAAc,EACd,cAAc,EACd,YAAY,EACb,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * @nodetool-ai/sdk — TypeScript SDK for the NodeTool server.
+ *
+ * Surfaces:
+ *   - `createNodetoolClient()` — typed tRPC client (full AppRouter coverage)
+ *     plus a `.chat()` factory for the streaming WebSocket.
+ *   - `ChatSocket` — typed event-emitter wrapper around the chat WebSocket
+ *     protocol (msgpack frames, with JSON fallback).
+ *
+ * Works in both browsers (native `WebSocket`/`fetch`) and Node ≥18 (native
+ * `fetch`; pass a `WebSocket` constructor from the `ws` package).
+ */
+export { createNodetoolClient } from "./client.js";
+export { ChatSocket } from "./chat.js";
+//# 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;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAMnD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@nodetool-ai/sdk",
+  "version": "0.8.1",
+  "type": "module",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "description": "TypeScript SDK for the NodeTool server — typed tRPC client + chat WebSocket",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "nodetool-dev": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "node ../../scripts/build-typescript-workspace.mjs",
+    "lint": "node ../../scripts/run-tsc.mjs --noEmit"
+  },
+  "dependencies": {
+    "@nodetool-ai/protocol": "^0.8.1",
+    "@nodetool-ai/websocket": "^0.8.1",
+    "@trpc/client": "^11.17.0",
+    "msgpackr": "^1.10.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.13",
+    "typescript": "npm:@typescript/typescript6@6.0.2",
+    "ws": "^8.18.0"
+  },
+  "peerDependencies": {
+    "ws": "^8.18.0"
+  },
+  "peerDependenciesMeta": {
+    "ws": {
+      "optional": true
+    }
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nodetool-ai/nodetool.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://nodetool.ai",
+  "bugs": {
+    "url": "https://github.com/nodetool-ai/nodetool/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "nodetool",
+    "ai",
+    "workflow",
+    "workflow-automation",
+    "typescript",
+    "sdk",
+    "trpc",
+    "client",
+    "websocket",
+    "api-client"
+  ]
+}