@love-moon/conductor-sdk 0.13.1 → 0.13.2

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # @love-moon/conductor-sdk
 
+## 0.13.2
+
+### Patch Changes
+
+- 6547b2c: Add read-only daemon queries and archived-task search to the CLI:
+  `conductor daemon list [--all]` (online daemons, version, AI backends),
+  `conductor daemon tools <host>` (installed AI tools and reachability),
+  `conductor daemon quota <host> [--tool] [--refresh]` (usage windows / balance
+  per tool), and `conductor task list --archived [--search] [--all-projects]
+[--page]`. The SDK's `BackendApiClient` gains `listAgents`,
+  `getAiManagerStatus`, `getAiManagerQuota` and `listAchievedTasks` over the
+  existing web API routes; no server change.
+- 8e3a4c3: Report how many model tokens each turn consumed. After every turn (or `/goal`)
+  `conductor fire` sends the turn's token count (fresh input + cache reads/writes +
+  output) over the new `task_turn_usage` websocket event, and the server adds it
+  to the task's running total shown in the task detail card. A persistent task's
+  total restarts with each round.
+
+  Failed or interrupted turns and `/compact` are counted too; when a turn's usage
+  is unknown the fire reports `null`, which clears the task's last-turn count.
+
+  - `@love-moon/conductor-sdk`: new `ConductorClient.sendTurnUsage(taskId, { tokens })`.
+  - `@love-moon/ai-sdk`: the Codex app-server provider's turn/goal `usage` now
+    carries `turnTotalTokens`, the turn's share of Codex's thread-cumulative total.
+    Claude and Codex turn errors carry the tokens spent before the failure as
+    `error.usage` (Claude sums streamed usage when an interrupted query ends
+    without a result).
+  - Claude and Codex backends are counted; other backends report nothing yet.
+
+- 6989999: `conductor task list --include-moved` also lists tasks moved into the project
+  from other projects (`project_id == P OR second_project_id == P`), with a MOVED
+  column naming the origin/target project. `--json` output now carries
+  `secondProjectId`. The SDK gains `TasksApi.listTasks({ includeMoved })`,
+  `BackendApiClient.listTasks({ projectScope: 'display' })` and
+  `Task/TaskSummary.secondProjectId`; it merges the server's existing real and
+  display scopes, so no server change is needed.
+
 ## 0.13.1
 
 ## 0.13.0

package/dist/api/tasks.d.ts

@@ -2,6 +2,8 @@ import { ApiClient, SdkClientOptions } from './shared.js';
 export interface Task {
     id: string;
     projectId: string | null;
+    /** Project the task was moved to in the web UI (display-only); null if not moved. */
+    secondProjectId?: string | null;
     issueId?: string | null;
     title: string;
     status: string;
@@ -91,6 +93,11 @@ export interface ListTasksInput {
     projectId?: string;
     issueId?: string;
     status?: string | string[];
+    /**
+     * Also include tasks moved into `projectId` from other projects (their
+     * `secondProjectId` is `projectId`), i.e. `projectId == P OR secondProjectId == P`.
+     */
+    includeMoved?: boolean;
 }
 export interface CreateTaskInput {
     projectId: string;

package/dist/api/tasks.js

@@ -30,6 +30,7 @@ const normalizeTask = (payload) => {
                     ? null
                     : String(payload.project_id)
                 : null,
+        secondProjectId: payload.secondProjectId ?? payload.second_project_id ?? null,
         issueId: payload.issueId ?? payload.issue_id ?? null,
         title: String(payload.title ?? ''),
         status: String(payload.status ?? ''),
@@ -134,10 +135,22 @@ export class TasksApi {
         // The server `/api/tasks` only filters on `project_id`; status / issue
         // filtering happens client-side here so we can support both string and
         // array `status` shapes from the facade input.
-        const tasks = await this.client.listTasks({
-            projectId: input.projectId,
-        });
-        let normalized = tasks.map((entry) => normalizeTask(typeof entry.asObject === 'function' ? entry.asObject() : entry));
+        const fetchNormalized = async (projectScope) => (await this.client.listTasks({ projectId: input.projectId, projectScope })).map((entry) => normalizeTask(typeof entry.asObject === 'function' ? entry.asObject() : entry));
+        let normalized;
+        if (input.includeMoved && input.projectId) {
+            // Real scope has every task whose projectId is P; display scope adds the
+            // ones moved in. Merging the two existing scopes needs no server change.
+            const [real, display] = await Promise.all([
+                fetchNormalized('real'),
+                fetchNormalized('display'),
+            ]);
+            const seen = new Set(real.map((task) => task.id));
+            const sortTime = (task) => Date.parse(task.updatedAt ?? task.createdAt ?? '') || 0;
+            normalized = [...real, ...display.filter((task) => !seen.has(task.id))].sort((a, b) => sortTime(b) - sortTime(a));
+        }
+        else {
+            normalized = await fetchNormalized('real');
+        }
         if (input.issueId) {
             normalized = normalized.filter((task) => task.issueId === input.issueId);
         }

package/dist/backend/client.d.ts

@@ -78,7 +78,8 @@ export declare class TaskSummary {
     readonly createdAt?: string | null | undefined;
     readonly updatedAt?: string | null | undefined;
     readonly grouping?: (TaskGroupingSummary | null) | undefined;
-    constructor(id: string, projectId: string | null, title: string, status: string, backendType?: string | null | undefined, sessionId?: string | null | undefined, sessionFilePath?: string | null | undefined, createdAt?: string | null | undefined, updatedAt?: string | null | undefined, grouping?: (TaskGroupingSummary | null) | undefined);
+    readonly secondProjectId?: string | null | undefined;
+    constructor(id: string, projectId: string | null, title: string, status: string, backendType?: string | null | undefined, sessionId?: string | null | undefined, sessionFilePath?: string | null | undefined, createdAt?: string | null | undefined, updatedAt?: string | null | undefined, grouping?: (TaskGroupingSummary | null) | undefined, secondProjectId?: string | null | undefined);
     static fromJSON(payload: Record<string, any>): TaskSummary;
 }
 export declare class BackendApiClient {
@@ -104,6 +105,7 @@ export declare class BackendApiClient {
     listTasks(params?: {
         projectId?: string;
         status?: string;
+        projectScope?: 'real' | 'display';
     }): Promise<TaskSummary[]>;
     createTask(params: BackendCreateTaskParams): Promise<TaskSummary>;
     /**
@@ -245,6 +247,26 @@ export declare class BackendApiClient {
     listScheduledMessages(taskId: string): Promise<Record<string, any>[]>;
     createScheduledMessage(taskId: string, params: Record<string, unknown>): Promise<Record<string, any>>;
     deleteScheduledMessage(taskId: string, scheduleId: string): Promise<void>;
+    /** Daemons (agents) currently connected for this user. */
+    listAgents(): Promise<Record<string, any>[]>;
+    /** Install / network status of the AI tools on a daemon. */
+    getAiManagerStatus(agentHost: string): Promise<Record<string, any>>;
+    /** Usage-window / balance quota of the AI tools on a daemon. */
+    getAiManagerQuota(agentHost: string, params?: {
+        tool?: string;
+        forceRefresh?: boolean;
+    }): Promise<Record<string, any>>;
+    /** Search archived (achieved) tasks by title and transcript; 10 per page. */
+    listAchievedTasks(params?: {
+        query?: string;
+        projectId?: string;
+        page?: number;
+    }): Promise<{
+        tasks: Record<string, any>[];
+        total: number;
+        page: number;
+        totalPages: number;
+    }>;
     private request;
     private buildUrl;
     private sendRequest;

package/dist/backend/client.js

@@ -75,7 +75,8 @@ export class TaskSummary {
     createdAt;
     updatedAt;
     grouping;
-    constructor(id, projectId, title, status, backendType, sessionId, sessionFilePath, createdAt, updatedAt, grouping) {
+    secondProjectId;
+    constructor(id, projectId, title, status, backendType, sessionId, sessionFilePath, createdAt, updatedAt, grouping, secondProjectId) {
         this.id = id;
         this.projectId = projectId;
         this.title = title;
@@ -86,6 +87,7 @@ export class TaskSummary {
         this.createdAt = createdAt;
         this.updatedAt = updatedAt;
         this.grouping = grouping;
+        this.secondProjectId = secondProjectId;
     }
     static fromJSON(payload) {
         const id = payload.id ? String(payload.id) : '';
@@ -112,7 +114,7 @@ export class TaskSummary {
                     : null,
             }
             : null;
-        return new TaskSummary(id, payload.project_id ? String(payload.project_id) : null, title, status, payload.backend_type ?? payload.backendType ?? null, payload.session_id ?? payload.sessionId ?? null, payload.session_file_path ?? payload.sessionFilePath ?? null, payload.created_at ?? null, payload.updated_at ?? null, grouping);
+        return new TaskSummary(id, payload.project_id ? String(payload.project_id) : null, title, status, payload.backend_type ?? payload.backendType ?? null, payload.session_id ?? payload.sessionId ?? null, payload.session_file_path ?? payload.sessionFilePath ?? null, payload.created_at ?? null, payload.updated_at ?? null, grouping, payload.second_project_id ?? payload.secondProjectId ?? null);
     }
 }
 export class BackendApiClient {
@@ -157,10 +159,12 @@ export class BackendApiClient {
         const query = new URLSearchParams();
         if (params.projectId) {
             query.set('project_id', params.projectId);
-            // Match the task's REAL project. By default the server groups by where the
-            // user filed a task in the web UI (display-only), which would hide this
-            // project's filed-out tasks from agents and include foreign ones.
-            query.set('project_scope', 'real');
+            // Match the task's REAL project unless the caller asks for the web UI's
+            // display grouping (the server default), which hides this project's
+            // moved-out tasks and includes the ones moved in via `second_project_id`.
+            if (params.projectScope !== 'display') {
+                query.set('project_scope', 'real');
+            }
         }
         if (params.status) {
             query.set('status', params.status);
@@ -503,10 +507,54 @@ export class BackendApiClient {
             headers: agentActorHeaders(),
         });
     }
+    /** Daemons (agents) currently connected for this user. */
+    async listAgents() {
+        const response = await this.request('GET', '/api/agents');
+        const payload = await this.parseJson(response);
+        if (!Array.isArray(payload)) {
+            throw new BackendApiError('Invalid agents response: expected list', response.status, payload);
+        }
+        return payload;
+    }
+    /** Install / network status of the AI tools on a daemon. */
+    async getAiManagerStatus(agentHost) {
+        const query = new URLSearchParams({ agentHost });
+        const response = await this.request('GET', '/api/ai-manager/status', { query, timeoutMs: 45_000 });
+        return this.parseJson(response);
+    }
+    /** Usage-window / balance quota of the AI tools on a daemon. */
+    async getAiManagerQuota(agentHost, params = {}) {
+        const query = new URLSearchParams({ agentHost });
+        if (params.tool)
+            query.set('tool', params.tool);
+        if (params.forceRefresh)
+            query.set('forceRefresh', '1');
+        // The server waits up to 30s for the daemon to query every provider.
+        const response = await this.request('GET', '/api/ai-manager/quota', { query, timeoutMs: 45_000 });
+        return this.parseJson(response);
+    }
+    /** Search archived (achieved) tasks by title and transcript; 10 per page. */
+    async listAchievedTasks(params = {}) {
+        const query = new URLSearchParams();
+        if (params.query)
+            query.set('q', params.query);
+        if (params.projectId)
+            query.set('projectId', params.projectId);
+        if (params.page)
+            query.set('page', String(params.page));
+        const response = await this.request('GET', '/api/tasks/achieved', { query });
+        const payload = await this.parseJson(response);
+        if (!payload || !Array.isArray(payload.tasks)) {
+            throw new BackendApiError('Invalid achieved tasks response', response.status, payload);
+        }
+        return payload;
+    }
     async request(method, pathname, opts = {}) {
         const url = this.buildUrl(pathname, opts.query);
         const controller = typeof AbortController !== 'undefined' ? new AbortController() : null;
-        const timeout = controller ? setTimeout(() => controller.abort(), this.timeoutMs) : null;
+        const timeout = controller
+            ? setTimeout(() => controller.abort(), opts.timeoutMs ?? this.timeoutMs)
+            : null;
         try {
             let response = await this.sendRequest(url, method, opts.body, controller, opts.headers);
             if (response.status === 404 &&

package/dist/client.d.ts

@@ -118,6 +118,13 @@ export declare class ConductorClient {
     sendMessage(taskId: string, content: string, metadata?: Record<string, any>): Promise<Record<string, any>>;
     sendTaskStatus(taskId: string, payload: Record<string, any>): Promise<Record<string, any>>;
     sendRuntimeStatus(taskId: string, payload: Record<string, any>): Promise<Record<string, any>>;
+    /**
+     * Report the tokens one finished turn consumed; the server adds them to the task total.
+     * `null` marks a failed turn whose usage is unknown.
+     */
+    sendTurnUsage(taskId: string, payload: {
+        tokens: number | null;
+    }): Promise<Record<string, any>>;
     sendAgentResume(payload?: {
         active_tasks?: string[];
         source?: string;

package/dist/client.js

@@ -305,6 +305,17 @@ export class ConductorClient {
         });
         return { delivered: true };
     }
+    /**
+     * Report the tokens one finished turn consumed; the server adds them to the task total.
+     * `null` marks a failed turn whose usage is unknown.
+     */
+    async sendTurnUsage(taskId, payload) {
+        await this.sendEnvelope({
+            type: 'task_turn_usage',
+            payload: { task_id: taskId, tokens: payload.tokens },
+        });
+        return { delivered: true };
+    }
     async sendAgentResume(payload = {}) {
         const storedCursor = this.downstreamCursorStore.get(this.agentHost);
         const lastAppliedCursor = payload.last_applied_cursor ?? (storedCursor

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@love-moon/conductor-sdk",
-  "version": "0.13.1",
+  "version": "0.13.2",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/lovemoon-ai/conductor.git"
@@ -33,5 +33,5 @@
     "typescript": "^5.6.3",
     "vitest": "^2.1.4"
   },
-  "gitCommitId": "b82ba1c"
+  "gitCommitId": "d60a6a2"
 }