@ziggs-ai/agent-sdk 0.1.8 → 0.1.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/agent-sdk",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Agent framework SDK for building autonomous agents on the Ziggs platform",
   "type": "module",
   "main": "src/index.ts",

package/src/adapters/McpAdapter.ts

@@ -103,8 +103,17 @@ function mapMcpTools(client: Client, tools: McpTool[]): ToolDefinition[] {
  *     await closeMcp();
  *   });
  */
-function buildDefaultWorkflow(description: string): Workflow {
+function buildDefaultWorkflow(description: string, mcpTools: McpTool[]): Workflow {
   const dflt = thinkingDefaults({ initial: 'idle' });
+  // Bind each MCP tool as an explicit action so runTurn includes them in the
+  // LLM API call and the decision schema. Without this, allowedToolNames is
+  // empty and the tools array passed to the LLM is also empty.
+  const toolActions = Object.fromEntries(
+    mcpTools.map(t => [t.name, {
+      tool: t.name,
+      prompt: { when: t.description || `Use ${t.name}` },
+    }]),
+  );
   return {
     id: 'mcp-agent',
     description: description || 'MCP-backed agent',
@@ -115,10 +124,31 @@ function buildDefaultWorkflow(description: string): Workflow {
         prompt: {
           role: 'You are a helpful agent powered by an MCP server.',
           goal: description || 'Help the user by calling the available tools.',
-          constraints: 'Use your tools to answer requests. When no action is needed, wait.',
+          constraints: 'Use your tools to answer the user\'s request. After gathering results, use "respond" to send the answer. Use "wait" only when no action is needed.',
         },
-        actions: { ...dflt.actions },
-        transitions: [...dflt.transitions],
+        actions: {
+          ...dflt.actions,
+          ...toolActions,
+          respond: {
+            prompt: {
+              instruction: 'Send your final answer to the user.',
+              when: 'You have gathered enough information and are ready to reply to the user.',
+              format: 'args: { receiverId: "<userId>", message: "<your answer>" }',
+            },
+            produces: 'message-sent',
+          },
+        },
+        transitions: [
+          { to: 'idle', when: (o) => o.kind === 'wait' },
+          { to: 'idle', when: (o) => o.kind === 'error' },
+          { to: 'done', when: (o) => o.kind === 'message-sent' },
+        ],
+      },
+      done: {
+        kind: 'parked',
+        transitions: [
+          { to: 'idle', when: (o) => o.kind === 'message-received' },
+        ],
       },
     },
   };
@@ -157,7 +187,7 @@ export async function createMcpAgent(options: CreateMcpAgentOptions): Promise<Mc
   const { tools: rawTools } = await client.listTools();
   const mcpTools = mapMcpTools(client, rawTools as McpTool[]);
 
-  const resolvedWorkflow = workflow ?? buildDefaultWorkflow(hostOptions.description ?? '');
+  const resolvedWorkflow = workflow ?? buildDefaultWorkflow(hostOptions.description ?? '', rawTools as McpTool[]);
 
   const host = new AgentHost({
     ...hostOptions,

package/src/runtime/validateWorkflow.ts

@@ -169,7 +169,7 @@ export function validateWorkflow(workflow: Workflow): ValidationResult {
         });
         if (!hasErrorFallthrough) {
           warnings.push(
-            `thinking state "${name}" has no fallthrough for { kind: 'error' } — empty/failed turns may silently recurse until the depth guard (ZIG-303). Add an error transition or spread thinkingDefaults().transitions.`,
+            `thinking state "${name}" has no fallthrough for { kind: 'error' } — empty/failed turns may silently recurse until the depth guard. Add an error transition or spread thinkingDefaults().transitions.`,
           );
         }
       }

package/src/server/tools/index.ts

@@ -42,6 +42,5 @@ export {
 export {
   CONTEXT_TOOLS,
   contextDiscoverTool,
-  contextListGrantsTool,
   contextDelegateTool,
 } from './tier2/contextTools.js';

package/src/server/tools/tier1/protocolRunner.ts

@@ -32,6 +32,7 @@ interface ProtocolPayload {
   parentAgreementId?: string;
   parentTaskId?: string;
   taskId?: string;
+  assigneeId?: string;
   status?: string;
   result?: unknown;
   plan?: unknown;
@@ -95,6 +96,7 @@ export async function dispatchProtocolOp(
         plan: payload.plan,
         planReviewTiming: payload.planReviewTiming,
         requireMidWorkPlanAck: payload.requireMidWorkPlanAck,
+        assigneeId: payload.assigneeId,
       });
     case 'task-update':
       if (!payload.taskId || !payload.status) return null;

package/src/server/tools/tier1/protocolTools.ts

@@ -87,9 +87,9 @@ export const taskUpdatePlanStepTool: ToolDefinition = defineTool(
 
 export const taskSpawnTool: ToolDefinition = defineTool(
   'task_spawn',
-  { agreementId: { type: 'string', required: true }, description: { type: 'string', required: true }, parentTaskId: 'string', plan: { type: 'object' }, planReviewTiming: 'string', requireMidWorkPlanAck: 'boolean' },
+  { agreementId: { type: 'string', required: true }, description: { type: 'string', required: true }, parentTaskId: 'string', assigneeId: { type: 'string', description: 'Explicitly hand this task to one specific agent (e.g. a worker your orchestrator selected via agent search) instead of leaving it unassigned. Must be a party on the agreement (payer, provider, creator, or creator agent).' }, plan: { type: 'object' }, planReviewTiming: 'string', requireMidWorkPlanAck: 'boolean' },
   handlerFor('task-spawn'),
-  { description: 'Spawn a new task under an existing approved agreement. Use when the contract is already in place.' },
+  { description: 'Spawn a new task under an existing approved agreement. Use when the contract is already in place. Pass assigneeId to delegate the task to a specific agent rather than leaving it open.' },
 );
 
 export const PROTOCOL_TOOLS: ToolDefinition[] = [

package/src/server/tools/tier2/contextTools.ts

@@ -18,17 +18,7 @@ export const contextDiscoverTool: ToolDefinition = defineTool(
   async (_args, ctx) => clientFor(ctx as Ctx).discover(),
   {
     description:
-      'List which chats, agreements, and org scopes this agent can reach via context grants (descriptors only — no message or artifact content).',
-  },
-);
-
-export const contextListGrantsTool: ToolDefinition = defineTool(
-  'context_list_grants',
-  {},
-  async (_args, ctx) => clientFor(ctx as Ctx).listGrants(),
-  {
-    description:
-      'List context grants held by this agent (grant ids and bounds). Does not fetch scoped content.',
+      'List every context grant this agent holds, as scope descriptors — grantId, scope, temporal, watermarkAt, expiresAt (no message or artifact content).',
   },
 );
 
@@ -69,6 +59,5 @@ export const contextDelegateTool: ToolDefinition = defineTool(
 
 export const CONTEXT_TOOLS = [
   contextDiscoverTool,
-  contextListGrantsTool,
   contextDelegateTool,
 ] as const;

package/src/server/ziggscontext/ZiggsContextClient.ts

@@ -69,14 +69,6 @@ export class ZiggsContextClient {
     return (res['reach'] as ContextReachDescriptor[]) || [];
   }
 
-  /** List persisted grant rows held by this agent (may include signedBytes). */
-  async listGrants(): Promise<unknown[]> {
-    this.requireActAsAgent('listGrants');
-    const res = (await this._get('/context/grants')) as Record<string, unknown>;
-    const grants = (res['grants'] as Array<Record<string, unknown>>) || [];
-    return grants.filter((g) => g['holderId'] === this.actAsAgentId);
-  }
-
   /** Holder delegates a narrower child grant. */
   async delegate(params: DelegateContextGrantParams): Promise<unknown> {
     this.requireActAsAgent('delegate');