@tianshu-ai/tianshu 0.3.0

package/plugins/workboard/dist/db/session-history.js

@@ -0,0 +1,224 @@
+// Read a worker session's transcript directly out of the shared
+// `messages` table.
+//
+// The table is owned by the host (`packages/server/src/chat/...`)
+// but its schema is part of the public migrations (001, 003), so
+// reading it from a plugin isn't a layering violation — it's the
+// same pattern as workboard reading `users` to look up display
+// names.
+//
+// What we return:
+//   - One entry per row, in chronological (created_at, rowid) order.
+//   - role mirrored from the DB column.
+//   - Raw `content` is JSON for assistant / tool-result rows and
+//     either JSON or plain text for user / system rows. We try to
+//     parse JSON; on failure we treat the row as plain text. The
+//     output shape is opinionated for *display* (kanban Execution
+//     tab, agent task_get_history) — not a verbatim re-export of
+//     pi-ai's wire format.
+export function readSessionHistory(db, sessionId) {
+    const rows = db
+        .prepare(`SELECT id, role, content, created_at
+       FROM messages
+       WHERE session_id = ?
+       ORDER BY created_at ASC, rowid ASC`)
+        .all(sessionId);
+    return rows.map(rowToEntry);
+}
+function rowToEntry(row) {
+    const base = {
+        id: row.id,
+        createdAt: row.created_at,
+        role: normaliseRole(row.role),
+    };
+    let parsed;
+    try {
+        parsed = JSON.parse(row.content);
+    }
+    catch {
+        return { ...base, text: row.content };
+    }
+    if (parsed && typeof parsed === "object") {
+        const obj = parsed;
+        // pi-ai stores `tool` rows with the envelope role set to
+        // "toolResult" and the meta (toolCallId / toolName / isError)
+        // *at the top level*, not inside the content array. Detect
+        // that shape early so we can build a HistoryToolResult.
+        const envelopeRole = typeof obj.role === "string" ? obj.role : "";
+        if (envelopeRole === "toolResult" || base.role === "tool") {
+            return toolResultEnvelopeToEntry(base, obj);
+        }
+        const content = obj.content;
+        if (typeof content === "string") {
+            return { ...base, text: content };
+        }
+        if (Array.isArray(content)) {
+            return contentArrayToEntry(base, content);
+        }
+    }
+    return { ...base, text: safeJson(parsed) };
+}
+/**
+ * Tool-result envelope shape:
+ *
+ *   {
+ *     role: "toolResult",
+ *     toolCallId: "toolu_...",
+ *     toolName: "browser_navigate",
+ *     content: [{ type: "text", text: "..." }, ...]   // or string
+ *     isError?: boolean,
+ *   }
+ *
+ * Top-level meta drives the chip; content goes into both
+ * `text` (so a UI without chip support still shows something)
+ * and `toolResult.text` (the chip body).
+ */
+function toolResultEnvelopeToEntry(base, envelope) {
+    const callId = typeof envelope.toolCallId === "string"
+        ? envelope.toolCallId
+        : typeof envelope.tool_use_id === "string"
+            ? envelope.tool_use_id
+            : typeof envelope.toolUseId === "string"
+                ? envelope.toolUseId
+                : "";
+    const name = typeof envelope.toolName === "string" ? envelope.toolName : "?";
+    const ok = typeof envelope.isError === "boolean" ? !envelope.isError : undefined;
+    const text = renderToolResultBody(envelope.content);
+    return {
+        ...base,
+        text,
+        toolResult: { callId, toolName: name, ok, text },
+    };
+}
+function contentArrayToEntry(base, parts) {
+    const textChunks = [];
+    const toolCalls = [];
+    let toolResult;
+    for (const part of parts) {
+        if (!part || typeof part !== "object")
+            continue;
+        const p = part;
+        const type = typeof p.type === "string" ? p.type : "";
+        switch (type) {
+            case "text":
+                if (typeof p.text === "string")
+                    textChunks.push(p.text);
+                break;
+            case "image":
+                textChunks.push(`[image${typeof p.mimeType === "string" ? ` ${p.mimeType}` : ""}]`);
+                break;
+            // pi-ai writes camelCase (`toolCall` / `toolResult`); the
+            // older snake_case forms come from Anthropic-style raw
+            // dumps. We accept both so this keeps working if the
+            // serialisation layer ever changes.
+            case "tool_use":
+            case "toolUse":
+            case "toolCall": {
+                const id = typeof p.id === "string"
+                    ? p.id
+                    : typeof p.toolCallId === "string"
+                        ? p.toolCallId
+                        : typeof p.toolUseId === "string"
+                            ? p.toolUseId
+                            : "";
+                const name = typeof p.name === "string"
+                    ? p.name
+                    : typeof p.toolName === "string"
+                        ? p.toolName
+                        : "?";
+                const input = p.input ?? p.arguments ?? p.args;
+                toolCalls.push({
+                    callId: id,
+                    toolName: name,
+                    argsJson: input === undefined ? "" : safeJson(input),
+                });
+                break;
+            }
+            case "tool_result":
+            case "toolResult": {
+                const id = typeof p.toolCallId === "string"
+                    ? p.toolCallId
+                    : typeof p.tool_use_id === "string"
+                        ? p.tool_use_id
+                        : typeof p.toolUseId === "string"
+                            ? p.toolUseId
+                            : "";
+                const name = typeof p.toolName === "string"
+                    ? p.toolName
+                    : typeof p.name === "string"
+                        ? p.name
+                        : "?";
+                const text = renderToolResultBody(p.content);
+                // pi-ai stores the verbose envelope under `details` for
+                // assistant-side rendering; isError on the top level
+                // signals a failed call.
+                const okFlag = typeof p.ok === "boolean"
+                    ? p.ok
+                    : typeof p.isError === "boolean"
+                        ? !p.isError
+                        : undefined;
+                toolResult = {
+                    callId: id,
+                    toolName: name,
+                    ok: okFlag,
+                    text,
+                };
+                // Don't smuggle the result into textChunks — that
+                // double-renders it once as the assistant message text
+                // and once in the tool-result chip. The chip alone is
+                // the truthful surface.
+                break;
+            }
+            default:
+                textChunks.push(`[${type || "?"}]`);
+                break;
+        }
+    }
+    return {
+        ...base,
+        text: textChunks.join("\n"),
+        ...(toolCalls.length > 0 ? { toolCalls } : {}),
+        ...(toolResult ? { toolResult } : {}),
+    };
+}
+function renderToolResultBody(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content)) {
+        return content === undefined ? "" : safeJson(content);
+    }
+    const chunks = [];
+    for (const part of content) {
+        if (typeof part === "string") {
+            chunks.push(part);
+            continue;
+        }
+        if (part && typeof part === "object") {
+            const p = part;
+            if (typeof p.text === "string") {
+                chunks.push(p.text);
+                continue;
+            }
+        }
+        chunks.push(safeJson(part));
+    }
+    return chunks.join("\n");
+}
+function normaliseRole(raw) {
+    if (raw === "user" ||
+        raw === "assistant" ||
+        raw === "tool" ||
+        raw === "system") {
+        return raw;
+    }
+    return "system";
+}
+function safeJson(v) {
+    try {
+        return JSON.stringify(v);
+    }
+    catch {
+        return String(v);
+    }
+}
+//# sourceMappingURL=session-history.js.map

package/plugins/workboard/dist/db/session-history.js.map

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

package/plugins/workboard/dist/db/tasks.d.ts

@@ -0,0 +1,260 @@
+import type { TenantDbHandle } from "@tianshu/plugin-sdk";
+/**
+ * Task lifecycle — only three states.
+ *
+ *   ready       — in the queue, eligible for a worker (deps done,
+ *                 not labelled `awaiting-intervention` / `stalled`
+ *                 / `draft`). Newly-created tasks land here, and
+ *                 so do tasks the main agent revived via
+ *                 task_continue / task_retry_fresh.
+ *   in_progress — a worker has claimed it.
+ *   done        — task_complete, or main agent called task_abort.
+ *
+ * Failure modes are expressed via labels instead of a separate
+ * status column (mirrors the closed-source predecessor):
+ *
+ *   labels: ['awaiting-intervention']  the worker run failed or
+ *                        timed out; the pool stamped a reason
+ *                        and notified the parent session. The
+ *                        pool will NOT pick the task up again
+ *                        until the main agent clears the label
+ *                        (via task_continue / task_retry_fresh /
+ *                        task_abort). 008 introduced this.
+ *   labels: ['stalled']  legacy label. Treated identically to
+ *                        awaiting-intervention by the pool's
+ *                        skip filter. Existing rows from before
+ *                        008 keep working.
+ *   labels: ['draft']    not ready for the pool yet; pool skips.
+ *
+ * Migration history:
+ *   003 added the entry tree.
+ *   005 renamed `todo` → `ready`, folded `aborted` into `ready`.
+ *   006 turned the `stalled` STATUS into a `stalled` LABEL.
+ *   008 added timeout_ms / intervention_reason / intervention_at
+ *       and introduced the `awaiting-intervention` label that
+ *       replaces the auto-retry loop with main-agent dispatch.
+ */
+export type TaskStatus = "ready" | "in_progress" | "done";
+/** Display-only — the kanban shows exactly these three columns. */
+export declare const VISIBLE_STATUSES: TaskStatus[];
+export interface Task {
+    id: string;
+    projectSlug: string;
+    ownerUserId: string;
+    workerRole: string | null;
+    /** Structured replacement for `workerRole` (N+6.2). When set, the
+     *  pool dispatches to the matching `worker_agents` row regardless
+     *  of `workerRole`. Both fields coexist for one release; the pool
+     *  prefers `workerAgentId`. */
+    workerAgentId: string | null;
+    title: string;
+    description: string | null;
+    status: TaskStatus;
+    priority: number;
+    resultSummary: string | null;
+    /** Workspace paths (relative to the per-user home). */
+    resultFiles: string[];
+    sessionId: string | null;
+    /** Task ids that must reach status='done' before this task is
+     *  eligible for a worker. Owner-scoped: ids must belong to the
+     *  same user. Empty array = no prerequisites. */
+    dependsOn: string[];
+    /** Last failure reason; populated when the worker pool put a
+     *  task back into `ready` after a failed run, or stamped onto a
+     *  task that ended up in the final `stalled` graveyard. Null on
+     *  fresh tasks and on successful runs. */
+    failureReason: string | null;
+    /** Counter only. Bumped on every fresh claim. Doesn't drive
+     *  any policy after the 008 intervention model — the pool no
+     *  longer auto-retries; failures route to the parent agent
+     *  via the `awaiting-intervention` label. Kept here so the UI
+     *  / inbox can show "3rd time we tried this" if it wants. */
+    attempts: number;
+    /** Free-form labels. Three are reserved by the worker pool
+     *  (see `POOL_SKIP_LABELS`):
+     *    - `awaiting-intervention` — stamped by the pool on any
+     *      worker failure or watchdog timeout. The main (parent)
+     *      session is notified; the pool will not claim the task
+     *      again until the label is cleared (task_continue /
+     *      task_retry_fresh / task_abort do this).
+     *    - `stalled` — legacy alias kept for backwards-compat with
+     *      pre-008 rows + tools that still set it. Same skip
+     *      semantics as awaiting-intervention.
+     *    - `draft`   — user-set; same skip semantics. "Not ready
+     *      yet, don't pick up."
+     *  Anything else is user metadata; the UI renders verbatim. */
+    labels: string[];
+    /** Soft per-task budget in ms. Pool watchdog cancels the
+     *  worker if it's still running at started_at + timeout_ms,
+     *  and routes the task to intervention with a timeout reason.
+     *  Default 600_000 (10 minutes); main agent extends via
+     *  task_extend_timeout. */
+    timeoutMs: number;
+    /** Free-text reason populated when the pool stamps
+     *  `awaiting-intervention`. Cleared when the label is cleared
+     *  (i.e. on the next fresh claim). NULL on healthy rows. */
+    interventionReason: string | null;
+    /** ms timestamp the row entered awaiting-intervention. NULL
+     *  on healthy rows. */
+    interventionAt: number | null;
+    createdAt: number;
+    startedAt: number | null;
+    endedAt: number | null;
+    /**
+     * Session that asked for this task (typically a chat session
+     * whose LLM called `task_create`). Used by the worker pool's
+     * terminal hook to drop a task_done / task_stalled message into
+     * that session's inbox. NULL for tasks created outside an LLM
+     * call (kanban add button, REST API, sync from external).
+     */
+    parentSessionId: string | null;
+}
+/** Labels that take the row out of pool consideration even when
+ *  status='ready'. Mirrors the closed-source predecessor.
+ *
+ *  Order matters for diagnostics only — the pool checks
+ *  membership, not order. `awaiting-intervention` first because
+ *  it's the post-008 default failure label. */
+export declare const POOL_SKIP_LABELS: readonly string[];
+/** The single canonical failure label used by the post-008 pool.
+ *  Tools that revive a task should clear this. */
+export declare const INTERVENTION_LABEL = "awaiting-intervention";
+/** Default per-task watchdog budget. 10 minutes felt like the
+ *  shortest interval where "slow but making progress" wouldn't
+ *  trip the watchdog and "stuck on a dead model call" would. */
+export declare const DEFAULT_TASK_TIMEOUT_MS = 600000;
+export interface CreateTaskInput {
+    ownerUserId: string;
+    title: string;
+    description?: string | null;
+    projectSlug?: string;
+    workerRole?: string | null;
+    /** Pin the task to a specific worker agent (host DB id). When
+     *  set, the pool routes here instead of doing a role match. */
+    workerAgentId?: string | null;
+    priority?: number;
+    /** Task ids that must reach status='done' first. Caller is
+     *  responsible for filtering to ids belonging to the same owner;
+     *  the route layer does that today. */
+    dependsOn?: string[];
+    /** Free-form labels (deduped + trimmed). The reserved labels
+     *  `awaiting-intervention` / `stalled` / `draft` keep the task
+     *  out of the pool's claim filter (see POOL_SKIP_LABELS). */
+    labels?: string[];
+    /** Session that asked for this task. Stamped on every row that
+     *  was created from inside an LLM tool call so the worker pool
+     *  can later notify it. */
+    parentSessionId?: string | null;
+    /** Optional override for the per-task watchdog budget. Bigger
+     *  jobs (long research, full website generation) can ask for
+     *  more time up front rather than relying on the main agent
+     *  to extend on the fly. Falls back to DEFAULT_TASK_TIMEOUT_MS. */
+    timeoutMs?: number | null;
+}
+export declare function isTaskStatus(s: string): s is TaskStatus;
+/** Insert a fresh `ready` task. Caller supplies the id (UUID). */
+export declare function createTask(db: TenantDbHandle, id: string, input: CreateTaskInput): Task;
+export interface ListTasksOpts {
+    /** Filter by owner. v0 always passes the requesting user; the host
+     *  treats a tenant as a single trust domain (ADR-0001) so other
+     *  users in the same tenant could be allowed later, but for v0 we
+     *  scope the UI to "my tasks". */
+    ownerUserId?: string;
+    /** Filter by project slug; null means "any project". */
+    projectSlug?: string | null;
+    /** Filter by status; default returns the four visible columns. */
+    statuses?: TaskStatus[];
+    /** Hard cap on rows. Default 500. The board is per-user — no one
+     *  reasonably has more than a few hundred open tasks. */
+    limit?: number;
+}
+export declare function listTasks(db: TenantDbHandle, opts?: ListTasksOpts): Task[];
+export declare function getTask(db: TenantDbHandle, id: string): Task | null;
+export interface UpdateTaskPatch {
+    title?: string;
+    description?: string | null;
+    projectSlug?: string;
+    priority?: number;
+    workerRole?: string | null;
+    workerAgentId?: string | null;
+    status?: TaskStatus;
+    resultSummary?: string | null;
+    resultFiles?: string[];
+    sessionId?: string | null;
+    /** Replace the dependency list. Caller is responsible for vetting
+     *  ownership; the workboard route layer does that. Pass [] to
+     *  clear. */
+    dependsOn?: string[];
+    failureReason?: string | null;
+    attempts?: number;
+    /** Replace the labels list. Pass [] to clear. The pool's reserved
+     *  labels (`awaiting-intervention`, `stalled`, `draft`) follow
+     *  the same rules as everything else here — sanitised, deduped. */
+    labels?: string[];
+    startedAt?: number | null;
+    endedAt?: number | null;
+    /** Bump or shrink the watchdog budget. Used by
+     *  `task_extend_timeout`. */
+    timeoutMs?: number;
+    /** Free-text reason; pass `null` to clear (used when reviving
+     *  a task via task_continue / task_retry_fresh). */
+    interventionReason?: string | null;
+    interventionAt?: number | null;
+}
+/** Patch a task. Status transitions are validated by the caller —
+ *  this function trusts whatever it gets. Returns the updated row,
+ *  or null if the id doesn't exist. */
+export declare function updateTask(db: TenantDbHandle, id: string, patch: UpdateTaskPatch): Task | null;
+export declare function deleteTask(db: TenantDbHandle, id: string): boolean;
+export interface ProjectSummary {
+    projectSlug: string;
+    ready: number;
+    inProgress: number;
+    done: number;
+    total: number;
+}
+/** Group counts by project slug, scoped to one owner. Used by the
+ *  admin page's project filter dropdown. */
+export declare function listProjects(db: TenantDbHandle, ownerUserId: string): ProjectSummary[];
+/**
+ * Atomically claim one `ready` task, flipping it to `in_progress`
+ * and stamping `started_at`. Returns null if the board is empty
+ * (or all eligible tasks are blocked by unfinished dependencies).
+ *
+ * The claim is atomic in SQLite by virtue of running inside one
+ * statement (`UPDATE ... WHERE id = (SELECT ...)`), then re-reading
+ * the updated row. SQLite's serialised writer makes a "two workers
+ * grab the same row" race impossible.
+ *
+ * Dependency check: we walk eligible candidates in priority order
+ * and skip any whose `depends_on` contains an id whose row is not
+ * yet `done`. The check happens in JS rather than SQL because the
+ * column is JSON-encoded; in practice the eligible set is tiny so
+ * this is fine.
+ */
+export declare function claimNextTask(db: TenantDbHandle, opts?: {
+    workerRole?: string | null;
+    /** When set, only claim tasks whose `worker_agent_id` matches
+     *  this id, OR are unpinned and whose `worker_role` matches
+     *  the legacy role (so a worker covers both old and new
+     *  pinning surfaces). */
+    workerAgentId?: string | null;
+    sessionId?: string | null;
+}): Task | null;
+/**
+ * Whether the pool may claim this task right now.
+ *
+ * Three checks, all must pass:
+ *   1. status === 'ready' — caller pre-filters but we double-check
+ *      since `isEligible` is also called from the chat-side
+ *      `task_create`/`task_update` tools to compute the
+ *      "blocked" hint shown to the agent.
+ *   2. labels don't include any pool-skip label (`stalled`,
+ *      `draft`). These are the user's "don't pick this up yet"
+ *      signal.
+ *   3. every dependency is in status='done'. Missing rows count
+ *      as unsatisfied — a deleted prerequisite doesn't
+ *      auto-resolve. (Owner can re-point with task_update.)
+ */
+export declare function isEligible(db: TenantDbHandle, task: Task): boolean;
+//# sourceMappingURL=tasks.d.ts.map

package/plugins/workboard/dist/db/tasks.d.ts.map

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