@ziggs-ai/api-client 0.37.8 → 0.37.10

package/dist/capabilities/mcpBriefs.js

@@ -178,7 +178,7 @@ const BRIEFS = {
     },
     // Tasks
     ziggs_task_create: {
-        does: 'Creates a task under an active agreement, or a work graph under a root task. plan sets its checklist.',
+        does: 'Creates a task under an active agreement, or a job with its children in one call. plan sets its checklist.',
         changes: 'creates the tasks and notifies their assignees',
     },
     ziggs_task_get: {
@@ -200,7 +200,7 @@ const BRIEFS = {
         changes: 'closes the task, proving nobody read or paid; the same idempotencyKey is a no-op',
     },
     ziggs_task_cancel: {
-        does: 'Cancels one task. Cancelling a held graph’s root withdraws the graph.',
+        does: 'Cancels one task. Cancelling a job cancels its live children.',
         changes: 'the task is cancelled',
     },
     ziggs_task_acknowledge_control: {

package/dist/capabilities/tasks.js

@@ -72,14 +72,14 @@ export const cancelTaskCapability = {
     names: { sdk: 'task_cancel', mcp: 'ziggs_task_cancel' },
     title: 'Cancel a task',
     descriptions: {
-        sdk: 'Cancel one task (PATCH /tasks/:id/cancel). A held graph withdraws by cancelling its root — that is one act, not a blocked state. Cancel ends this task; it does not amend a live hire.',
+        sdk: 'Cancel one task (PATCH /tasks/:id/cancel). Cancelling a job cancels its live children — that is one act, not a blocked state. Cancel ends this task; it does not amend a live hire.',
     },
     annotation: 'destructive',
     params: {
         taskId: {
             type: 'string',
             required: true,
-            description: 'The task to cancel. For a held graph, pass the root.',
+            description: 'The task to cancel. To withdraw a whole job, pass the job.',
         },
     },
     needsAgentId: true,

package/dist/http/TaskClient.d.ts

@@ -41,21 +41,28 @@ export declare function acknowledgeTaskControl(taskId: string, requestId: string
  * subcontract inputs rather than teaching those routes to keep one.
  */
 export type PlanReviewTiming = 'with_proposal' | 'before_execution';
-export interface CreateTaskGraphNodeData {
-    nodeId: string;
+/**
+ * One child created with its parent, all or none. `name` only lets siblings
+ * name each other in `waitsOn`; it is not stored, and the create answers with
+ * the task id each name became.
+ */
+export interface CreateTaskChildData {
+    name: string;
     agreementId: string;
     description: string;
     title?: string;
     assigneeId?: string;
+    /** Names of sibling children in the same create that must finish first. */
     waitsOn?: string[];
     joinKind?: 'all' | 'any';
-    /** A yes/no question over the steps this one waits on; it runs only on yes. */
+    /** A yes/no question over the children this one waits on; it runs only on yes. */
     runIf?: string;
-}
-export interface CreateTaskGraphData {
-    nodes: CreateTaskGraphNodeData[];
     inputArtifactIds?: string[];
-    review?: 'before_execution';
+}
+/** What a create with children answers for each one. */
+export interface CreatedTaskChild {
+    name: string;
+    taskId: string;
 }
 export interface CreateTaskData {
     description: string;
@@ -89,8 +96,20 @@ export interface CreateTaskData {
      * the shape in its own control flow where nothing else can see it.
      */
     waitsOn?: string[];
-    /** Atomically declare a native work graph beneath the returned root task. */
-    graph?: CreateTaskGraphData;
+    /**
+     * How the task closes, fixed at create. `children` (the default when
+     * `children` is given) makes it a job that closes when its children close:
+     * completed when every child no sibling waits on completed or was skipped.
+     * `result` (the default otherwise) closes by its own result.
+     */
+    closesBy?: 'result' | 'children';
+    /**
+     * Children created with this task in one call, all or none. The job's
+     * `inputArtifactIds` go to the children that wait on nothing, and
+     * `planReviewTiming: before_execution` holds every child until this task's
+     * plan is acknowledged.
+     */
+    children?: CreateTaskChildData[];
     /**
      * When the answer stops being useful, ISO 8601. At the deadline
      * the holder posts what it has and where it is stuck, and stops. A deadline
@@ -115,7 +134,9 @@ export interface CreateTaskCheckBackData {
     /** Total reminders allowed per person asked, after the first ask. */
     maxReminders: number;
 }
-export declare function createTask(taskData: CreateTaskData, creds: Creds): Promise<Task>;
+export declare function createTask(taskData: CreateTaskData, creds: Creds): Promise<Task & {
+    children?: CreatedTaskChild[];
+}>;
 export declare function getTask(taskId: string, creds: Creds): Promise<Task>;
 export interface UpdateTaskStateData {
     result?: unknown;
@@ -212,7 +233,9 @@ export declare class TaskClient {
     constructor(operatorKey: string, agentId?: string);
     requestControl(taskId: string, request: Parameters<typeof requestTaskControl>[1]): Promise<TaskWriteConfirm>;
     acknowledgeControl(taskId: string, requestId: string, supported?: boolean): Promise<TaskWriteConfirm>;
-    createTask(data: CreateTaskData): Promise<Task>;
+    createTask(data: CreateTaskData): Promise<Task & {
+        children?: CreatedTaskChild[];
+    }>;
     getTask(taskId: string): Promise<Task>;
     updateTaskState(taskId: string, state: TaskState, data?: UpdateTaskStateData): Promise<TaskWriteConfirm>;
     getActiveTasksForAgent(agentId: string): Promise<Task[]>;

package/dist/http/TaskClient.js

@@ -112,7 +112,10 @@ export async function createTask(taskData, creds) {
     const task = extractTask(data);
     if (!task)
         throw new Error('Invalid response: task data not found');
-    return task;
+    const children = data?.children;
+    return Array.isArray(children)
+        ? { ...task, children: children }
+        : task;
 }
 export async function getTask(taskId, creds) {
     if (!taskId)

package/dist/types.d.ts

@@ -103,17 +103,16 @@ export interface Task {
      */
     heldByDeps?: boolean;
     joinKind?: 'all' | 'any';
-    graph?: {
-        nodes: Array<{
-            nodeId: string;
-            taskId: string;
-        }>;
-        review?: 'before_execution';
-    } | null;
-    graphNodeId?: string | null;
-    heldByGraphReview?: boolean;
     /**
-     * A graph step that runs only if a yes/no question holds over the steps it
+     * How the task closes, fixed at create. `children` makes it a job: never
+     * handed out, it closes when its children (the tasks naming it as their
+     * parent) close.
+     */
+    closesBy?: 'result' | 'children';
+    /** True while the task waits for its parent's plan to be acknowledged. */
+    heldByParentReview?: boolean;
+    /**
+     * A child that runs only if a yes/no question holds over the steps it
      * waits on. Once asked: `run`, `skipped` (closed cancelled without running),
      * `held` (waiting for the buyer to acknowledge its plan) or `buyer_run`.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/api-client",
-  "version": "0.37.8",
+  "version": "0.37.10",
   "description": "HTTP and WebSocket client for the Ziggs backend API",
   "type": "module",
   "main": "dist/index.js",
@@ -41,6 +41,10 @@
     "dist",
     "README.md"
   ],
+  "homepage": "https://ziggsai.com/docs",
+  "bugs": {
+    "url": "https://ziggsai.com/support"
+  },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"