@ziggs-ai/agent-sdk 0.42.0 → 0.42.2

package/CHANGELOG.md

@@ -32,6 +32,8 @@
 
 ## Unreleased
 
+- Expose the shared `task_delegate` capability on the hosted agent surface for recursive task assignments and approved artifact returns.
+
 ## 0.41.2
 
 ## 0.41.1

package/dist/Agent.d.ts

@@ -300,6 +300,12 @@ export declare class Agent {
     private carryExecutionState;
     /** Runtime control is a task fact, never model-interpreted message text. */
     private taskExecutionControl;
+    /**
+     * Control on an assignment the inbox will not run yet. No wake follows, so a
+     * resume is acknowledged here too once no run of the task is live; the wake
+     * path that would otherwise answer it never comes while the delivery is blocked.
+     */
+    private observeBlockedTaskControl;
     private acknowledgeExecutionControl;
     /**
      * Handler for a resource change (artifact created, task state transition,

package/dist/Agent.js

@@ -522,8 +522,10 @@ export class Agent {
         if (!this.taskService)
             return null;
         let task;
+        // Host control observation is separate from task work. Only execution state
+        // leaves this method; a stopped work context cannot observe its own stop.
         try {
-            task = await this.taskService.getTask(taskId);
+            task = await withWorkExecution(undefined, () => this.taskService.getTask(taskId));
         }
         catch (error) {
             // Unreadable is not a hold. The wake filter still drops a frame whose
@@ -537,6 +539,17 @@ export class Agent {
             return null;
         return { blocked: task.state === 'cancelled' || (task.state === 'active' && task.control?.action === 'pause'), closed: task.state === 'cancelled', control: task.control };
     }
+    /**
+     * Control on an assignment the inbox will not run yet. No wake follows, so a
+     * resume is acknowledged here too once no run of the task is live; the wake
+     * path that would otherwise answer it never comes while the delivery is blocked.
+     */
+    async observeBlockedTaskControl(taskId) {
+        const execution = await this.taskExecutionControl(taskId);
+        const idleResume = execution?.control?.action === 'resume' && !this.activeTaskRuns.get(taskId)?.size;
+        if (execution?.blocked || idleResume)
+            await this.acknowledgeExecutionControl(taskId, execution?.control);
+    }
     async acknowledgeExecutionControl(taskId, control) {
         if (control?.status !== 'requested')
             return;
@@ -1612,6 +1625,7 @@ export class Agent {
                 onResourceEvent: (event) => {
                     return this.handleResourceEvent(event);
                 },
+                onTaskControlCheck: (taskId) => this.observeBlockedTaskControl(taskId),
                 // work delivered by the inbox's task channel, not by a chat
                 // row — this is what reaches a task under a chat-less agreement or one
                 // the agent assigned to itself.

package/dist/brain/claudeSdkTools.d.ts

@@ -1,5 +1,5 @@
 import { type ToolDefinition } from '../tools/defineTool.js';
-import { cancelTaskTool, listTasksTool } from '../platform/tools/tier2/taskTools.js';
+import { cancelTaskTool, listTasksTool, delegateTaskTool } from '../platform/tools/tier2/taskTools.js';
 import type { EffectHandler, DeliveryWriteKeys } from '../types.js';
 import type { MemoryStore } from '../memory/MemoryStore.js';
 export interface ClaudeSdkToolContext extends Record<string, unknown> {
@@ -25,5 +25,5 @@ export interface ClaudeSdkToolContext extends Record<string, unknown> {
 }
 export declare const contextSnapshotTool: ToolDefinition;
 export declare const chatSendTool: ToolDefinition;
-export { listTasksTool, cancelTaskTool };
+export { listTasksTool, cancelTaskTool, delegateTaskTool };
 export declare const CLAUDE_SDK_TOOLS: ToolDefinition[];

package/dist/brain/claudeSdkTools.js

@@ -5,7 +5,7 @@ import { credsFromToolContext } from '../tools/toolCreds.js';
 import { sendChatMessage, presentSendResult } from '@ziggs-ai/api-client';
 import { defineTool } from '../tools/defineTool.js';
 import { listGrantsTool } from '../platform/tools/tier2/grantsTools.js';
-import { cancelTaskTool, listTasksTool } from '../platform/tools/tier2/taskTools.js';
+import { cancelTaskTool, listTasksTool, delegateTaskTool } from '../platform/tools/tier2/taskTools.js';
 import { CHAT_TOOLS } from '../platform/tools/tier2/chatTools.js';
 // default message-history cap. An uncapped snapshot returns the whole
 // chat — in a delegation chat that accumulates notification rows, every wake's
@@ -168,13 +168,14 @@ export const chatSendTool = defineTool('chat_send', {
 // task_list IS here: MCP delegates have ziggs_task_list; the hosted
 // Claude surface previously had no way to enumerate its own open tasks (reads
 // were prompt-injected only). Same GET /tasks capability as the MCP tool.
-export { listTasksTool, cancelTaskTool };
+export { listTasksTool, cancelTaskTool, delegateTaskTool };
 export const CLAUDE_SDK_TOOLS = [
     contextSnapshotTool,
     chatSendTool,
     listGrantsTool,
     listTasksTool,
     cancelTaskTool,
+    delegateTaskTool,
     // store-claim providers must open the buyer chat from the default
     // Claude surface (chat_open was tier-2 / email-agent opt-in only).
     ...CHAT_TOOLS,

package/dist/platform/inboxLoop.d.ts

@@ -32,6 +32,8 @@ export interface InboxLoopDeps {
      * public request burns a full Claude turn per published supplier.
      */
     onRequest?: (request: InboxRequestRef) => Promise<void>;
+    /** Host-only control observation for blocked task assignments; never a model wake. */
+    onTaskControlCheck?: (taskId: string) => Promise<void>;
     label?: string;
 }
 export interface InboxPassResult {

package/dist/platform/inboxLoop.js

@@ -205,6 +205,20 @@ export async function pollInboxOnce(deps, waitSeconds = 0, opts = {}) {
     if (blocked) {
         log(label, `${blocked} assignment(s) cannot run yet (no access or execution refused); left pending for the server to offer again`);
     }
+    if (deps.onTaskControlCheck) {
+        const blockedTasks = new Set([
+            ...envelope.deliveries.filter(d => mine(d) && d.kind === 'task-state' && d.executionBlocked && !d.outOfReach).map(d => d.resourceId),
+            ...(envelope.tasksAwaitingMe ?? []).filter(t => t.executionBlocked).map(t => t.taskId),
+        ]);
+        for (const taskId of blockedTasks) {
+            try {
+                await deps.onTaskControlCheck(taskId);
+            }
+            catch (error) {
+                warn(label, `task control observation failed for ${taskId}: ${error.message}`);
+            }
+        }
+    }
     const handledSoFar = new Set();
     const acknowledged = new Set();
     // A handled id the server would not settle (it lost access mid-wake) stays

package/dist/platform/tools/index.d.ts

@@ -24,7 +24,7 @@ export { PAYMENT_TOOLS, paymentBalanceTool } from './tier2/paymentTools.js';
 export { CONNECTION_TOOLS, connectionProxyTool, connectionListGrantsTool, requestConnectionTool, } from './tier2/connectionTools.js';
 export { CONTEXT_TOOLS, contextReadTool, accessRequestTool, contextDelegateTool, contextExpandReachTool, contextDiscoverGrantableTool, } from './tier2/contextTools.js';
 export { GRANTS_TOOLS, listGrantsTool } from './tier2/grantsTools.js';
-export { TASK_TOOLS, listTasksTool, cancelTaskTool } from './tier2/taskTools.js';
+export { TASK_TOOLS, listTasksTool, cancelTaskTool, delegateTaskTool } from './tier2/taskTools.js';
 export { PLAN_TOOLS, taskReplacePlanTool } from './tier2/planTools.js';
 export { LINK_TOOLS, linkProposeTool, linkListTool, } from './tier2/linkTools.js';
 export { INTRODUCTION_TOOLS, introductionMintTool, introductionRedeemTool, introductionListTool, introductionRevokeTool, } from './tier2/introductionTools.js';

package/dist/platform/tools/index.js

@@ -28,7 +28,7 @@ export { CONTEXT_TOOLS, contextReadTool, accessRequestTool, contextDelegateTool,
 // one grant lister across every rail (retires context_discover +
 // payment_list_grants). Always-available on the hosted agent — see CLAUDE_SDK_TOOLS.
 export { GRANTS_TOOLS, listGrantsTool } from './tier2/grantsTools.js';
-export { TASK_TOOLS, listTasksTool, cancelTaskTool } from './tier2/taskTools.js';
+export { TASK_TOOLS, listTasksTool, cancelTaskTool, delegateTaskTool } from './tier2/taskTools.js';
 export { PLAN_TOOLS, taskReplacePlanTool } from './tier2/planTools.js';
 // links (agreements with engagementKind 'link') — cross-org reach.
 ///1022: the rail is two tools; propose/claim/revoke ride the

package/dist/platform/tools/tier2/taskTools.d.ts

@@ -1,4 +1,5 @@
 import type { ToolDefinition } from '../../../tools/defineTool.js';
 export declare const listTasksTool: ToolDefinition;
+export declare const delegateTaskTool: ToolDefinition;
 export declare const cancelTaskTool: ToolDefinition;
 export declare const TASK_TOOLS: ToolDefinition[];

package/dist/platform/tools/tier2/taskTools.js

@@ -1,7 +1,8 @@
-import { cancelTaskCapability, listTasksCapability, TASK_CAPABILITIES } from '@ziggs-ai/api-client';
+import { delegateTaskCapability, cancelTaskCapability, listTasksCapability, TASK_CAPABILITIES } from '@ziggs-ai/api-client';
 import { toolFromCapability, toolsFromCapabilities } from '../../../tools/capabilityAdapter.js';
 // GET /tasks, defined once in api-client. MCP ziggs_task_list and this
 // hosted-Claude tool used to re-declare the same filters.
 export const listTasksTool = toolFromCapability(listTasksCapability);
+export const delegateTaskTool = toolFromCapability(delegateTaskCapability);
 export const cancelTaskTool = toolFromCapability(cancelTaskCapability);
 export const TASK_TOOLS = toolsFromCapabilities(TASK_CAPABILITIES);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/agent-sdk",
-  "version": "0.42.0",
+  "version": "0.42.2",
   "description": "Agent framework SDK for building autonomous agents on the Ziggs platform",
   "homepage": "https://ziggsai.com/docs",
   "bugs": {
@@ -30,8 +30,8 @@
     "@anthropic-ai/claude-agent-sdk": "^0.3.284",
     "@anthropic-ai/sdk": "^0.110.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@ziggs-ai/api-client": "0.38.0",
-    "@ziggs-ai/contracts": "^0.32.0",
+    "@ziggs-ai/api-client": "0.38.2",
+    "@ziggs-ai/contracts": "^0.33.1",
     "ajv": "^8.17.1",
     "dotenv": "^17.2.3",
     "openai": "^4.0.0",