@tianshu-ai/tianshu 0.3.0

package/packages/server/dist/chat/token-estimate.js

@@ -0,0 +1,67 @@
+// Cheap, vendor-agnostic token estimation.
+//
+// pi-ai doesn't expose a tokeniser per provider, and shipping
+// tiktoken / Anthropic-tokenizer for one heuristic is overkill. The
+// 4-chars-per-token rule of thumb is accurate within ±25% for English,
+// usually high-side for Chinese (which packs more meaning per char so
+// tokenisers compress aggressively). For our purposes \u2014 deciding
+// whether to compact at the 50% mark of a context window \u2014 a
+// systematic over-estimate is the conservative choice.
+//
+// We count:
+//   - all message content text (TextContent.text)
+//   - the byte-size of each base64 image we'd inline (1 token \u2248 4
+//     chars of base64)
+//   - tool-call argument JSON bodies
+//   - the system prompt
+//   - the JSON schema of every tool the agent has access to
+//
+// We DON'T count:
+//   - structural overhead (role markers, message boundaries) \u2014 small
+//     constant per message, swallowed by the conservative ratio
+//   - thinking blocks (provider-specific, often free)
+const CHARS_PER_TOKEN = 4;
+/**
+ * Estimate the number of tokens needed to send the given context to
+ * an LLM. Returns whole tokens. Always rounds up.
+ */
+export function estimateTokens(args) {
+    let chars = 0;
+    if (args.systemPrompt)
+        chars += args.systemPrompt.length;
+    for (const m of args.messages) {
+        if (typeof m.content === "string") {
+            chars += m.content.length;
+            continue;
+        }
+        if (!Array.isArray(m.content))
+            continue;
+        for (const part of m.content) {
+            const p = part;
+            if (p.type === "text" && typeof p.text === "string") {
+                chars += p.text.length;
+            }
+            else if (p.type === "image" && typeof p.data === "string") {
+                // base64 strings; each char is roughly one byte that the
+                // provider will need to ferry. Vision pricing is also\n        // usually per-pixel \u2014 over-estimating here is a feature.
+                chars += p.data.length;
+            }
+            else if (p.type === "toolCall") {
+                chars += JSON.stringify(p.arguments ?? {}).length;
+            }
+        }
+    }
+    if (args.tools && args.tools.length > 0) {
+        for (const t of args.tools) {
+            chars += (t.name?.length ?? 0) + (t.description?.length ?? 0);
+            try {
+                chars += JSON.stringify(t.parameters ?? {}).length;
+            }
+            catch {
+                /* schemas are plain objects \u2014 stringify shouldn't fail */
+            }
+        }
+    }
+    return Math.ceil(chars / CHARS_PER_TOKEN);
+}
+//# sourceMappingURL=token-estimate.js.map

package/packages/server/dist/chat/token-estimate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimate.js","sourceRoot":"","sources":["../../src/chat/token-estimate.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,EAAE;AACF,8DAA8D;AAC9D,oEAAoE;AACpE,uEAAuE;AACvE,sEAAsE;AACtE,sEAAsE;AACtE,kEAAkE;AAClE,uDAAuD;AACvD,EAAE;AACF,YAAY;AACZ,kDAAkD;AAClD,uEAAuE;AACvE,uBAAuB;AACvB,qCAAqC;AACrC,wBAAwB;AACxB,4DAA4D;AAC5D,EAAE;AACF,kBAAkB;AAClB,0EAA0E;AAC1E,gEAAgE;AAChE,sDAAsD;AAItD,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAI9B;IACC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,IAAI,CAAC,YAAY;QAAE,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;IAEzD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YAClC,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;YAAE,SAAS;QACxC,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,IACa,CAAC;YACxB,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACpD,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;YACzB,CAAC;iBAAM,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC5D,yDAAyD;gBACzD,8HAA8H;gBAC9H,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;YACzB,CAAC;iBAAM,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBACjC,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACpD,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3B,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;YAC9D,IAAI,CAAC;gBACH,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACrD,CAAC;YAAC,MAAM,CAAC;gBACP,+DAA+D;YACjE,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,eAAe,CAAC,CAAC;AAC5C,CAAC"}

package/packages/server/dist/chat/ws-protocol.d.ts

@@ -0,0 +1,244 @@
+import type { ChatMessage } from "./messages.js";
+export type ClientMsg = {
+    type: "hello";
+}
+/**
+ * Initial / refresh history fetch.
+ *
+ * Returns the most recent `limit` messages (ascending by
+ * created_at, like a chat log). Default 100; max 500. Older
+ * messages can be paged in via `history_more`.
+ *
+ * Without paging, busy users can rack up thousands of messages
+ * across sessions and a fresh socket would have to ship the
+ * whole transcript on connect — both server (one big query +
+ * frame) and client (one big render) suffer. With paging, the
+ * usual fast-path stays fast and only users who scroll up pay
+ * the cost of older history.
+ */
+ | {
+    type: "history";
+    limit?: number;
+}
+/**
+ * Page in older history, exclusive of `before`. Cursor is the
+ * oldest message id currently in the client's store; server
+ * returns the next `limit` messages older than that id.
+ */
+ | {
+    type: "history_more";
+    before: string;
+    limit?: number;
+} | {
+    type: "prompt";
+    content: string;
+    /** Optional model id (e.g. 'anthropic/claude-sonnet-4-6'). When
+     *  absent the server falls back to config.defaultModel. */
+    modelId?: string;
+    /**
+     * Files staged in the composer (per ADR-0003 §12).
+     *
+     * For image attachments the server constructs a multimodal
+     * UserMessage and inlines the file as base64 right before each
+     * LLM call. For non-image attachments the server adds a text
+     * note pointing at `path` so the agent can `read_file` it.
+     *
+     * Paths are user-home-relative ("/uploads/x.png" → the file
+     * lives at `<userHome>/uploads/x.png`).
+     */
+    attachments?: WireAttachment[];
+} | {
+    type: "abort";
+};
+export interface WireAttachment {
+    /** User-home-relative path, always starts with "/". */
+    path: string;
+    /** RFC 6838 mime type ("image/png", "application/pdf", …). */
+    mimeType: string;
+    /** Original filename for UI display. Optional. */
+    name?: string;
+    /** Byte size on disk, when the client knows. Optional. */
+    size?: number;
+}
+export type ServerMsg = {
+    type: "connected";
+    tenantId: string;
+    userId: string;
+}
+/**
+ * Replaces the client's current message list. Sent on initial
+ * `history` request and after a session switch. `hasMore` tells
+ * the client whether older pages exist (drives the "Load
+ * earlier" button visibility).
+ */
+ | {
+    type: "history";
+    messages: WireMessage[];
+    hasMore: boolean;
+}
+/**
+ * Prepends an older page to the client's current message list.
+ * Sent in response to `history_more`. `messages` are still in
+ * ascending order (oldest first).
+ */
+ | {
+    type: "history_page";
+    messages: WireMessage[];
+    hasMore: boolean;
+    before: string;
+} | {
+    type: "message_added";
+    message: WireMessage;
+} | {
+    type: "stream_start";
+} | {
+    type: "stream_delta";
+    delta: string;
+} | {
+    type: "stream_end";
+    message: WireMessage;
+} | {
+    type: "stream_error";
+    reason: string;
+}
+/** Agent invoked a tool. Sent before the tool runs so the UI can
+ *  render an in-progress chip. */
+ | {
+    type: "tool_call";
+    callId: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+/** Tool finished. `text` is the human-readable summary the LLM will
+ *  see; `ok` lets the UI tint failures. */
+ | {
+    type: "tool_result";
+    callId: string;
+    name: string;
+    ok: boolean;
+    text: string;
+}
+/** A compaction pass just landed. Sent for both auto-compact (
+ *  triggered by pi's `shouldCompact()` against the model's
+ *  context window) and manual `/compact` invocations. The UI
+ *  shows a "📌 history compacted" marker so the user knows
+ *  their next replies are running on a summary of the older
+ *  conversation. */
+ | {
+    type: "history_compacted";
+    reason: "auto" | "manual";
+    oldSessionId: string;
+    newSessionId: string;
+    summarisedCount: number;
+    keptCount: number;
+    durationMs: number;
+    /** Estimated context tokens before compaction. Only set on
+     *  the harness-driven auto-compact path; the legacy
+     *  /compact slash command still leaves this undefined. */
+    tokensBefore?: number;
+}
+/** Plugin enable/disable just landed. `enabled` lists plugin ids
+ *  that came online (and what they brought — tools / toolsets);
+ *  `disabled` lists what went away. The chat shell renders a
+ *  brief notice; the agent loop also gets a synthetic system
+ *  message so the model knows its tool surface changed. */
+ | {
+    type: "plugins_changed";
+    enabled: PluginsChangedDelta[];
+    disabled: PluginsChangedDelta[];
+};
+export interface PluginsChangedDelta {
+    pluginId: string;
+    displayName: string;
+    /** Tools the plugin advertises in its manifest contributes.tools[]. */
+    tools: string[];
+    /** Toolsets the plugin advertises in its manifest contributes.toolsets[]. */
+    toolsets: string[];
+}
+/**
+ * Display-only metadata for an assistant message. Populated by
+ * `toWire()` from the persisted `AssistantMessage` (pi-ai records
+ * model + usage on every turn). The chat shell renders these in a
+ * tiny line under the bubble — mirrors the closed-source predecessor
+ * (`packages/web/src/components/MessageBubble.tsx` MessageMeta).
+ *
+ * `contextWindow` lets the UI compute “12% ctx” without having to
+ * call the model registry itself; we resolve it server-side from the
+ * tenant config.
+ */
+export interface WireMessageMeta {
+    /** Provider/model id as recorded by pi-ai (e.g. "claude-sonnet-4-6"). */
+    model?: string;
+    usage?: {
+        input: number;
+        output: number;
+        totalTokens: number;
+    };
+    /** Active model's context window at the time we serialised, so the
+     *  client doesn't need to look it up. */
+    contextWindow?: number;
+}
+/** Single tool call inside an assistant message. */
+export interface WireToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+/** Tool result content surfaced for one tool call. */
+export interface WireToolResult {
+    callId: string;
+    name: string;
+    ok: boolean;
+    text: string;
+}
+/** Ordered building blocks for an assistant message — preserves the
+ *  pi-ai `content` array's interleaving of text and tool calls so
+ *  the UI can render them in author order. Legacy `text` +
+ *  `toolCalls` are still populated for backwards-compat. */
+export type WireAssistantBlock = {
+    kind: "text";
+    text: string;
+} | {
+    kind: "toolCall";
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+};
+/**
+ * Wire shape for one persisted message. The DB stores either a plain
+ * string (legacy) or a JSON-serialised pi-ai Message; on the wire we
+ * always present a clean `{ text, toolCalls?, toolResult? }` triple
+ * so the UI never has to JSON.parse content itself.
+ */
+export interface WireMessage {
+    id: string;
+    sessionId: string;
+    role: ChatMessage["role"];
+    /** Human-readable text. Empty string for tool-only assistant turns. */
+    text: string;
+    /** Tool calls authored by the assistant in this message, if any. */
+    toolCalls?: WireToolCall[];
+    /** Ordered text + tool-call blocks; only set on assistant messages.
+     *  Older client builds ignore this and fall back to
+     *  `text + toolCalls`. */
+    blocks?: WireAssistantBlock[];
+    /** When this message is a tool result, the structured details. */
+    toolResult?: WireToolResult;
+    /** Files attached to this user message (path + mimeType only — the
+     *  raw bytes stay on disk). The UI renders thumbnails / chips. */
+    attachments?: WireAttachment[];
+    /** Display-only metadata for assistant messages (model, token
+     *  usage, context window). Undefined for user / tool rows. */
+    meta?: WireMessageMeta;
+    createdAt: number;
+}
+/**
+ * Optional helper a caller can supply so we can stamp
+ * `contextWindow` onto the meta of an assistant message. Stays
+ * optional because tests and the legacy plain-text path don't have
+ * a tenant config in scope. */
+export interface ToWireOpts {
+    contextWindowFor?: (modelId: string) => number | undefined;
+}
+export declare function toWire(m: ChatMessage, opts?: ToWireOpts): WireMessage;
+//# sourceMappingURL=ws-protocol.d.ts.map

package/packages/server/dist/chat/ws-protocol.d.ts.map

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

package/packages/server/dist/chat/ws-protocol.js

@@ -0,0 +1,193 @@
+// WebSocket protocol for the (PR #21) minimal chat surface.
+//
+// Server → Client events follow the pi-ai naming so we can pass deltas
+// through with zero translation later when worker streams arrive.
+//
+// Wire format is JSON, one message per WebSocket frame.
+export function toWire(m, opts = {}) {
+    const base = {
+        id: m.id,
+        sessionId: m.sessionId,
+        role: m.role,
+        createdAt: m.createdAt,
+    };
+    // Try parsing the content as a structured pi-ai Message; fall back
+    // to treating it as plain text (legacy path).
+    const parsed = tryParse(m.content);
+    if (parsed && typeof parsed === "object" && parsed !== null && "role" in parsed) {
+        const obj = parsed;
+        if (obj.role === "assistant" && Array.isArray(obj.content)) {
+            const parts = obj.content;
+            const blocks = [];
+            for (const c of parts) {
+                if (c.type === "text" && typeof c.text === "string") {
+                    blocks.push({ kind: "text", text: c.text });
+                }
+                else if (c.type === "toolCall") {
+                    blocks.push({
+                        kind: "toolCall",
+                        id: String(c.id ?? ""),
+                        name: String(c.name ?? ""),
+                        arguments: c.arguments ?? {},
+                    });
+                }
+                // `thinking` and other future block types are intentionally
+                // dropped here — the UI surfaces them through other channels.
+            }
+            const text = blocks
+                .filter((b) => b.kind === "text")
+                .map((b) => b.text)
+                .join("");
+            const toolCalls = blocks
+                .filter((b) => b.kind === "toolCall")
+                .map(({ kind: _k, ...rest }) => rest);
+            const meta = extractAssistantMeta(obj, opts);
+            return {
+                ...base,
+                text,
+                toolCalls: toolCalls.length > 0 ? toolCalls : undefined,
+                blocks: blocks.length > 0 ? blocks : undefined,
+                meta,
+            };
+        }
+        if (obj.role === "toolResult") {
+            const content = Array.isArray(obj.content) ? obj.content : [];
+            const text = content
+                .filter((c) => c.type === "text" && typeof c.text === "string")
+                .map((c) => c.text)
+                .join("");
+            return {
+                ...base,
+                text,
+                toolResult: {
+                    callId: String(obj.toolCallId ?? ""),
+                    name: String(obj.toolName ?? ""),
+                    ok: !obj.isError,
+                    text,
+                },
+            };
+        }
+        if (obj.role === "user" && Array.isArray(obj.content)) {
+            const parts = obj.content;
+            const rawText = parts
+                .filter((c) => c.type === "text" && typeof c.text === "string")
+                .map((c) => c.text)
+                .join("");
+            // Strip the agent-facing "[Attached file: name (mime) — available
+            // at ./uploads/...]" markers we inject server-side so the user's
+            // bubble shows their actual prose. The chip strip rendered from
+            // `attachments[]` already conveys what's attached. The DB still
+            // carries the marker for the agent's pi-ai context.
+            const text = stripAgentAttachmentMarkers(rawText);
+            // Attachment metadata: prefer the sibling `attachments` field
+            // (server-set by SqliteSessionStorage.appendEntry for every
+            // attachment, image or not). Fall back to deriving it from
+            // ImageContent parts so legacy rows written before that field
+            // existed still render.
+            const stored = Array.isArray(obj.attachments)
+                ? obj.attachments
+                    .map((a) => ({
+                    path: typeof a.path === "string" ? a.path : "",
+                    mimeType: typeof a.mimeType === "string"
+                        ? a.mimeType
+                        : "application/octet-stream",
+                    name: typeof a.name === "string" ? a.name : undefined,
+                    size: typeof a.size === "number" ? a.size : undefined,
+                }))
+                    .filter((a) => a.path.length > 0)
+                : [];
+            const fromImageParts = stored.length === 0
+                ? parts
+                    .filter((c) => c.type === "image")
+                    .map((c) => ({
+                    path: typeof c.path === "string" ? c.path : "",
+                    mimeType: typeof c.mimeType === "string"
+                        ? c.mimeType
+                        : "application/octet-stream",
+                    name: typeof c.name === "string" ? c.name : undefined,
+                    size: typeof c.size === "number" ? c.size : undefined,
+                }))
+                    .filter((a) => a.path.length > 0)
+                : [];
+            const attachments = stored.length > 0 ? stored : fromImageParts;
+            return {
+                ...base,
+                text,
+                attachments: attachments.length > 0 ? attachments : undefined,
+            };
+        }
+    }
+    // Legacy: content is a bare string.
+    return { ...base, text: m.content };
+}
+/** Pull display-only meta off a parsed pi-ai AssistantMessage.
+ *  Returns undefined when nothing useful is present (legacy rows
+ *  without a usage block, etc.). */
+function extractAssistantMeta(obj, opts) {
+    const model = typeof obj.model === "string" && obj.model.length > 0
+        ? obj.model
+        : undefined;
+    const provider = typeof obj.provider === "string" && obj.provider.length > 0
+        ? obj.provider
+        : undefined;
+    let usage;
+    const u = obj.usage;
+    if (u && typeof u === "object") {
+        const input = numericField(u, "input");
+        const output = numericField(u, "output");
+        const totalTokens = numericField(u, "totalTokens");
+        if (input != null || output != null || totalTokens != null) {
+            usage = {
+                input: input ?? 0,
+                output: output ?? 0,
+                totalTokens: totalTokens ?? (input ?? 0) + (output ?? 0),
+            };
+        }
+    }
+    if (!model && !usage)
+        return undefined;
+    // pi-ai stores `model` as the bare model id and `provider` as the
+    // provider id; tenant config keys models by `<provider>/<model>`.
+    // Compose the lookup id when both are present so we don't have to
+    // teach `contextWindowFor` about that split.
+    const fullId = provider && model ? `${provider}/${model}` : model;
+    const contextWindow = fullId
+        ? opts.contextWindowFor?.(fullId) ?? undefined
+        : undefined;
+    return { model, usage, contextWindow };
+}
+function numericField(obj, key) {
+    const v = obj[key];
+    return typeof v === "number" && Number.isFinite(v) ? v : undefined;
+}
+function tryParse(s) {
+    if (!s || s[0] !== "{")
+        return null;
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        return null;
+    }
+}
+// Match the marker formats the chat handler injects so the agent
+// has a path for non-image attachments. Conservative — we only
+// strip our own markers, not arbitrary square-bracketed text the
+// user might have typed. Two phrasings are matched:
+//   - `— available at .<path>`  (legacy, written by pre-N+6.4
+//     persistUserPrompt rows still in the DB)
+//   - `— readable at .<path>`   (current, written by
+//     prepareUserInput)
+const ATTACHMENT_MARKER_RE = /\[Attached file: [^\]]*— (?:available|readable) at [^\]]*\]/g;
+function stripAgentAttachmentMarkers(text) {
+    if (!text.includes("[Attached file: "))
+        return text;
+    const stripped = text.replace(ATTACHMENT_MARKER_RE, "");
+    // Collapse the leftover blank lines / trailing whitespace.
+    return stripped
+        .split("\n")
+        .filter((line) => line.trim().length > 0)
+        .join("\n")
+        .trim();
+}
+//# sourceMappingURL=ws-protocol.js.map

package/packages/server/dist/chat/ws-protocol.js.map

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

package/packages/server/dist/cli.d.ts

@@ -0,0 +1,9 @@
+export interface ParsedArgs {
+    command: string;
+    positional: string[];
+    options: Record<string, string>;
+    flags: Set<string>;
+}
+export declare function parseArgs(argv: string[]): ParsedArgs;
+export declare function main(argv: string[]): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/packages/server/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AA8CA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACpB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAkBpD;AAiCD,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAyM1D"}