@ziggs-ai/agent-sdk 0.20.0 → 0.21.0

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

@@ -0,0 +1,20 @@
+import { type ToolDefinition } from '../../../tools/defineTool.js';
+/**
+ * `task_replace_plan` — write the checklist of a task you hold.
+ *
+ * The hosted tool set could only UPDATE a step that already existed
+ * (`task_update_plan_step` takes a stepId), and a task created without a plan
+ * has none, so an agent had no way to record anything about its own work on
+ * the task row. That mattered the moment one agent served two customers: from
+ * the second customer's room it could not find the approval request it had
+ * sent under the first customer's hire, and told them it had never been sent
+ * (store-opening lab, 2026-09-15). The MCP surface has had
+ * `ziggs_task_replace_plan` all along; this is the same client call for the
+ * hosted brain.
+ *
+ * The plan is the agent's own notebook on the task: step results can carry
+ * ids (an approval agreement, an artifact), and `task_list` reads the plan back
+ * from any room the agent is woken in.
+ */
+export declare const taskReplacePlanTool: ToolDefinition;
+export declare const PLAN_TOOLS: ToolDefinition[];

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

@@ -0,0 +1,64 @@
+import { replaceTaskPlan } from '@ziggs-ai/api-client';
+import { defineTool } from '../../../tools/defineTool.js';
+import { credsFromToolContext } from '../../../tools/toolCreds.js';
+/**
+ * `task_replace_plan` — write the checklist of a task you hold.
+ *
+ * The hosted tool set could only UPDATE a step that already existed
+ * (`task_update_plan_step` takes a stepId), and a task created without a plan
+ * has none, so an agent had no way to record anything about its own work on
+ * the task row. That mattered the moment one agent served two customers: from
+ * the second customer's room it could not find the approval request it had
+ * sent under the first customer's hire, and told them it had never been sent
+ * (store-opening lab, 2026-09-15). The MCP surface has had
+ * `ziggs_task_replace_plan` all along; this is the same client call for the
+ * hosted brain.
+ *
+ * The plan is the agent's own notebook on the task: step results can carry
+ * ids (an approval agreement, an artifact), and `task_list` reads the plan back
+ * from any room the agent is woken in.
+ */
+export const taskReplacePlanTool = defineTool('task_replace_plan', {
+    taskId: { type: 'string', required: true, minLength: 1, pattern: '\\S' },
+    steps: {
+        type: 'array',
+        required: true,
+        items: {
+            type: 'object',
+            properties: {
+                stepId: {
+                    type: 'string',
+                    description: 'Stable id for this step. Omit to let the server assign step-<n>.',
+                },
+                description: { type: 'string', minLength: 1, pattern: '\\S' },
+                order: {
+                    type: 'integer',
+                    description: 'Position in the plan. Omit to use the array index.',
+                },
+                status: {
+                    type: 'string',
+                    enum: ['pending', 'in_progress', 'completed', 'skipped'],
+                    description: 'Step progress. Omit for pending.',
+                },
+                result: {
+                    type: 'object',
+                    description: 'What this step produced, as an object — e.g. { "agreementId": "agr_…" } for an approval you requested, or { "artifactId": "art_…" } for a pack you recorded. Stored with the step and read back by task_list.',
+                },
+            },
+            required: ['description'],
+        },
+        description: 'The FULL ordered step list. Existing steps are replaced wholesale, not appended to — read the current plan with task_list first and send it back with your changes.',
+    },
+}, async (args, ctx) => {
+    const creds = credsFromToolContext(ctx, 'task_replace_plan');
+    const taskId = typeof args.taskId === 'string' ? args.taskId.trim() : '';
+    if (!taskId)
+        throw new Error('task_replace_plan: taskId is required');
+    const steps = args.steps;
+    if (!Array.isArray(steps))
+        throw new Error('task_replace_plan: steps must be an array');
+    return replaceTaskPlan(taskId, steps, creds);
+}, {
+    description: 'Replace the plan of a task you hold with the full ordered step list. Use it to write your own checklist on a task that arrived without one, and to record what a step produced (an approval agreement id, an artifact id) so a later wake — in any room — can find it with task_list. Steps you do not send are removed; mark finished steps completed so closing the task does not rewrite them as skipped.',
+});
+export const PLAN_TOOLS = [taskReplacePlanTool];

package/dist/pricing/fleetDefaults.js

@@ -3,7 +3,6 @@
  * Prices are in wallet cents (1 ZIG = 100 cents).
  */
 import { FLEET_TIER_BY_AGENT_ID } from './fleetTierByAgentId.gen.js';
-import { FREE_TIER_A_AGENT_IDS } from './fleetFreeTierA.gen.js';
 import { isEvalFreeExecutor } from './fleetEvalFree.js';
 export const ZIGGS_OPERATOR_CUT_BPS = 1000; // 10%
 export const TIER_PRICE_CENTS = {
@@ -13,7 +12,6 @@ export const TIER_PRICE_CENTS = {
     D: 100, // 1 ZIG / call (hand-written demo agents)
 };
 const PING_DESCRIPTION_PATTERN = /\b(ping|health\s*check|healthcheck|liveness|readiness|heartbeat)\b/i;
-const TRIVIAL_LOOKUP_DESCRIPTION_PATTERN = /\b(what\s+time|current\s+time|local\s+time|world\s+clock|timezone|time\s+zone|weather|forecast|temperature|uv\s+index)\b/i;
 export function resolveFleetTier(agentId) {
     if (!agentId || typeof agentId !== 'string')
         return null;
@@ -30,15 +28,12 @@ export function isFreeAllowlistedExecutor(executorId, description) {
         return false;
     if (isEvalFreeExecutor(executorId))
         return true;
-    if (FREE_TIER_A_AGENT_IDS.has(executorId))
-        return true;
+    // A health check does not bill, whatever tier the executor is in. This is
+    // the only description-based exemption left: an agent whose work should cost
+    // nothing says so with a posted price of 0 on its own listing, where the
+    // buyer can see it, rather than through a rule inferred here.
     if (description && PING_DESCRIPTION_PATTERN.test(description))
         return true;
-    if (description &&
-        TRIVIAL_LOOKUP_DESCRIPTION_PATTERN.test(description) &&
-        FREE_TIER_A_AGENT_IDS.has(executorId)) {
-        return true;
-    }
     return false;
 }
 export function resolveDefaultPriceCentsForExecutor(executorId, description) {

package/dist/pricing/fleetTierByAgentId.gen.d.ts

@@ -4,4 +4,4 @@
  */
 export type FleetPricingTier = 'A' | 'B' | 'C' | 'D';
 export declare const FLEET_TIER_BY_AGENT_ID: Record<string, FleetPricingTier>;
-export declare const FLEET_TIER_MAP_SIZE = 767;
+export declare const FLEET_TIER_MAP_SIZE = 17;