@ziggs-ai/api-client 0.10.1 → 0.10.2

package/dist/http/TaskClient.d.ts

@@ -1,4 +1,22 @@
 import { type Creds, type Task, type TaskState } from '../types.js';
+/**
+ * ZIG-1321 — thin confirmation from task write verbs. Full object stays on
+ * getTask / ziggs_task_get.
+ */
+export interface TaskWriteConfirm {
+    ok: true;
+    taskId: string;
+    state: TaskState;
+    updatedAt?: string;
+    status?: string;
+    stepCount?: number;
+    structureChanged?: boolean;
+    stepId?: string;
+    stepStatus?: string;
+    resultRecorded?: boolean;
+    terminalState?: string;
+    [key: string]: unknown;
+}
 /**
  * When the buyer reviews a task's plan. Task-rail only — an agreement has no
  * plan to review, which is why cut this from the propose/counter/
@@ -32,10 +50,10 @@ export interface UpdateTaskStateData {
      */
     idempotencyKey?: string;
 }
-export declare function updateTaskState(taskId: string, state: TaskState, data: UpdateTaskStateData | undefined, creds: Creds): Promise<Task>;
+export declare function updateTaskState(taskId: string, state: TaskState, data: UpdateTaskStateData | undefined, creds: Creds): Promise<TaskWriteConfirm>;
 export declare function getActiveTasksForAgent(agentId: string, creds: Creds): Promise<Task[]>;
 export declare function getActiveTasksForChat(chatId: string, creds: Creds): Promise<Task[]>;
-export declare function cancelTask(taskId: string, creds: Creds): Promise<Task>;
+export declare function cancelTask(taskId: string, creds: Creds): Promise<TaskWriteConfirm>;
 export declare function getSubtasks(parentTaskId: string, creds: Creds): Promise<Task[]>;
 export interface PlanReplaceStep {
     /** Omit to let the server mint `step-<n>`. */
@@ -52,10 +70,10 @@ export interface PlanReplaceStep {
     /** Optional step output stored with this replace. */
     result?: unknown;
 }
-export declare function replaceTaskPlan(taskId: string, steps: PlanReplaceStep[], creds: Creds): Promise<Task>;
-export declare function updateTaskPlanStep(taskId: string, stepId: string, status: string, result: unknown, creds: Creds): Promise<Task>;
-export declare function reportTask(taskId: string, message: string | undefined, creds: Creds): Promise<Task>;
-export declare function setTaskSatisfaction(taskId: string, satisfaction: 'positive' | 'negative', creds: Creds): Promise<Task>;
+export declare function replaceTaskPlan(taskId: string, steps: PlanReplaceStep[], creds: Creds): Promise<TaskWriteConfirm>;
+export declare function updateTaskPlanStep(taskId: string, stepId: string, status: string, result: unknown, creds: Creds): Promise<TaskWriteConfirm>;
+export declare function reportTask(taskId: string, message: string | undefined, creds: Creds): Promise<TaskWriteConfirm>;
+export declare function setTaskSatisfaction(taskId: string, satisfaction: 'positive' | 'negative', creds: Creds): Promise<TaskWriteConfirm>;
 export interface ListTasksOptions {
     state?: string;
     cursor?: string;
@@ -85,15 +103,15 @@ export declare class TaskClient {
     constructor(operatorKey: string, agentId?: string);
     createTask(data: CreateTaskData): Promise<Task>;
     getTask(taskId: string): Promise<Task>;
-    updateTaskState(taskId: string, state: TaskState, data?: UpdateTaskStateData): Promise<Task>;
+    updateTaskState(taskId: string, state: TaskState, data?: UpdateTaskStateData): Promise<TaskWriteConfirm>;
     getActiveTasksForAgent(agentId: string): Promise<Task[]>;
     getActiveTasksForChat(chatId: string): Promise<Task[]>;
-    cancelTask(taskId: string): Promise<Task>;
+    cancelTask(taskId: string): Promise<TaskWriteConfirm>;
     getSubtasks(parentTaskId: string): Promise<Task[]>;
-    replaceTaskPlan(taskId: string, steps: PlanReplaceStep[]): Promise<Task>;
-    updateTaskPlanStep(taskId: string, stepId: string, status: string, result?: unknown): Promise<Task>;
-    reportTask(taskId: string, message?: string): Promise<Task>;
-    setTaskSatisfaction(taskId: string, satisfaction: 'positive' | 'negative'): Promise<Task>;
+    replaceTaskPlan(taskId: string, steps: PlanReplaceStep[]): Promise<TaskWriteConfirm>;
+    updateTaskPlanStep(taskId: string, stepId: string, status: string, result?: unknown): Promise<TaskWriteConfirm>;
+    reportTask(taskId: string, message?: string): Promise<TaskWriteConfirm>;
+    setTaskSatisfaction(taskId: string, satisfaction: 'positive' | 'negative'): Promise<TaskWriteConfirm>;
     listTasks(options?: ListTasksOptions): Promise<ListTasksResult>;
     countTasks(filters?: CountTasksFilters): Promise<number>;
 }

package/dist/http/TaskClient.js

@@ -24,10 +24,54 @@ function extractTask(data) {
     if (d['task'] && typeof d['task'] === 'object' && d['task']['taskId']) {
         return d['task'];
     }
-    if (d['taskId'])
+    // Top-level task document (GET / create). Do not treat ZIG-1321 thin write
+    // confirms (`ok: true`, no description) as a Task.
+    if (typeof d['taskId'] === 'string' && d['ok'] !== true) {
         return d;
+    }
     return null;
 }
+function extractWriteConfirm(data) {
+    if (!data || typeof data !== 'object')
+        return null;
+    const d = data;
+    // New thin shape (no nested task / no description dump).
+    if (typeof d['taskId'] === 'string' &&
+        typeof d['state'] === 'string' &&
+        d['task'] === undefined &&
+        d['description'] === undefined) {
+        return {
+            ok: true,
+            taskId: d['taskId'],
+            state: d['state'],
+            ...(typeof d['updatedAt'] === 'string' || d['updatedAt'] instanceof Date
+                ? { updatedAt: String(d['updatedAt']) }
+                : {}),
+            ...(typeof d['status'] === 'string' ? { status: d['status'] } : {}),
+            ...(typeof d['stepCount'] === 'number' ? { stepCount: d['stepCount'] } : {}),
+            ...(typeof d['structureChanged'] === 'boolean'
+                ? { structureChanged: d['structureChanged'] }
+                : {}),
+            ...(typeof d['stepId'] === 'string' ? { stepId: d['stepId'] } : {}),
+            ...(typeof d['stepStatus'] === 'string' ? { stepStatus: d['stepStatus'] } : {}),
+            ...(d['resultRecorded'] === true ? { resultRecorded: true } : {}),
+            ...(typeof d['terminalState'] === 'string'
+                ? { terminalState: d['terminalState'] }
+                : {}),
+        };
+    }
+    // Legacy fat echo — compress to the thin fields so callers stay forward-compat.
+    const task = extractTask(data);
+    if (!task?.taskId || !task.state)
+        return null;
+    return {
+        ok: true,
+        taskId: task.taskId,
+        state: task.state,
+        ...(task.updatedAt ? { updatedAt: task.updatedAt } : {}),
+        ...(typeof d['status'] === 'string' ? { status: d['status'] } : {}),
+    };
+}
 export async function createTask(taskData, creds) {
     if (!taskData)
         throw new Error('Task data is required for task creation');
@@ -85,10 +129,10 @@ export async function updateTaskState(taskId, state, data = {}, creds) {
         throwApiError(res, body, `Task state update failed: ${res.status} ${res.statusText}`);
     }
     const result = await res.json().catch(() => null);
-    const task = extractTask(result);
-    if (!task)
-        throw new Error('Invalid response: task data not found');
-    return task;
+    const confirm = extractWriteConfirm(result);
+    if (!confirm)
+        throw new Error('Invalid response: task write confirm not found');
+    return confirm;
 }
 export async function getActiveTasksForAgent(agentId, creds) {
     if (!agentId)
@@ -182,10 +226,10 @@ export async function cancelTask(taskId, creds) {
         throwApiError(res, body, `Task cancel failed: ${res.status} ${res.statusText}`);
     }
     const result = await res.json().catch(() => null);
-    const task = extractTask(result);
-    if (!task)
-        throw new Error('Invalid response: task data not found');
-    return task;
+    const confirm = extractWriteConfirm(result);
+    if (!confirm)
+        throw new Error('Invalid response: task write confirm not found');
+    return confirm;
 }
 export async function getSubtasks(parentTaskId, creds) {
     if (!parentTaskId)
@@ -219,10 +263,10 @@ export async function replaceTaskPlan(taskId, steps, creds) {
         throwApiError(res, responseBody, `Plan replace failed: ${res.status} ${res.statusText}`);
     }
     const data = await res.json().catch(() => null);
-    const task = extractTask(data);
-    if (!task)
-        throw new Error('Invalid response: task data not found');
-    return task;
+    const confirm = extractWriteConfirm(data);
+    if (!confirm)
+        throw new Error('Invalid response: task write confirm not found');
+    return confirm;
 }
 export async function updateTaskPlanStep(taskId, stepId, status, result, creds) {
     if (!taskId)
@@ -242,10 +286,10 @@ export async function updateTaskPlanStep(taskId, stepId, status, result, creds)
         throwApiError(res, responseBody, `Plan step update failed: ${res.status} ${res.statusText}`);
     }
     const data = await res.json().catch(() => null);
-    const task = extractTask(data);
-    if (!task)
-        throw new Error('Invalid response: task data not found');
-    return task;
+    const confirm = extractWriteConfirm(data);
+    if (!confirm)
+        throw new Error('Invalid response: task write confirm not found');
+    return confirm;
 }
 // ---------------------------------------------------------------------------
 // Reporting & satisfaction
@@ -264,10 +308,10 @@ export async function reportTask(taskId, message = '', creds) {
         throwApiError(res, body, `Task report failed: ${res.status} ${res.statusText}`);
     }
     const data = await res.json().catch(() => null);
-    const task = extractTask(data);
-    if (!task)
-        throw new Error('Invalid response: task data not found');
-    return task;
+    const confirm = extractWriteConfirm(data);
+    if (!confirm)
+        throw new Error('Invalid response: task write confirm not found');
+    return confirm;
 }
 export async function setTaskSatisfaction(taskId, satisfaction, creds) {
     if (!taskId)
@@ -285,10 +329,10 @@ export async function setTaskSatisfaction(taskId, satisfaction, creds) {
         throwApiError(res, body, `Task satisfaction failed: ${res.status} ${res.statusText}`);
     }
     const data = await res.json().catch(() => null);
-    const task = extractTask(data);
-    if (!task)
-        throw new Error('Invalid response: task data not found');
-    return task;
+    const confirm = extractWriteConfirm(data);
+    if (!confirm)
+        throw new Error('Invalid response: task write confirm not found');
+    return confirm;
 }
 export async function listTasks(options = {}, creds) {
     assertCreds(creds, 'list tasks');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/api-client",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "description": "HTTP and WebSocket client for the Ziggs backend API",
   "type": "module",
   "main": "dist/index.js",