@ziggs-ai/agent-sdk 0.12.0 → 0.14.0

package/dist/tools/toolCreds.js

@@ -0,0 +1,49 @@
+/**
+ * toolCreds.ts — the credentials a tool acts under, read off its own context.
+ *
+ * A custom tool builds `{ operatorKey, agentId }` by hand and stops there, so
+ * every call it makes runs on the narrowest reach fence there is: the agent's
+ * own org. `AgentHost` already threads the wake's lane into the tool context
+ * (as `chatId` / `sessionId`, which is what the capability adapter reads), and
+ * the backend's fence is "own org ∪ the orgs of the parties to this lane" — so
+ * a tool that does not pass it loses reach it is entitled to, and loses it
+ * SILENTLY: enumerations come back short rather than refused.
+ *
+ * Measured on a five-node graph run: a coordinator asking which tasks it had
+ * created saw 0 of 5 with no lane and 5 of 5 with its own lane declared. The
+ * `task_list({ createdByMe: true })` convergence check that `lab-hirer`'s prompt
+ * recommends would therefore answer "nothing yet" and rebuild the whole graph,
+ * billing every worker twice.
+ *
+ * So: one reader, used by every tool, rather than a field each author has to
+ * remember. Omitting the lane can only narrow reach, never widen it, which is
+ * why forgetting it never fails loudly.
+ */
+const str = (ctx, key) => {
+    const value = ctx?.[key];
+    return typeof value === 'string' && value.trim() ? value : undefined;
+};
+/**
+ * The wake's lane, as the backend's `X-Ziggs-Lane` expects it: a chat id, or
+ * `agrn-<agreementId>` for an agreement lane. Undefined when the tool is
+ * running outside any lane (a bootstrap sweep, a test), which the fence reads
+ * as "own org only".
+ */
+export function laneFromToolContext(ctx) {
+    return str(ctx, 'chatId') ?? str(ctx, 'sessionId');
+}
+/**
+ * The creds a tool should act under. Throws when the context is missing what a
+ * call needs, rather than building something that 401s later somewhere else.
+ */
+export function credsFromToolContext(ctx, toolName) {
+    const where = toolName ? `${toolName}: ` : '';
+    const operatorKey = str(ctx, 'operatorKey');
+    if (!operatorKey)
+        throw new Error(`${where}operatorKey missing from tool context`);
+    const agentId = str(ctx, 'agentId');
+    if (!agentId)
+        throw new Error(`${where}agentId missing from tool context`);
+    const laneId = laneFromToolContext(ctx);
+    return { operatorKey, agentId, ...(laneId ? { laneId } : {}) };
+}

package/dist/types.d.ts

@@ -4,15 +4,11 @@
  * One outcome vocabulary, one ctx shape, one transition signature.
  * Every state — parked or thinking — re-enters with exactly one Outcome.
  */
+import type { AgreementParties } from '@ziggs-ai/api-client';
 import type { AgentNeed } from './tools/needs.js';
 export interface AgreementRef {
     agreementId: string;
-    parties?: {
-        creator?: string;
-        provider?: string;
-        payer?: string;
-        proposedTo?: string;
-    };
+    parties?: AgreementParties;
     proposal?: {
         status?: 'pending' | 'approved' | 'rejected' | 'cancelled';
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/agent-sdk",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "Agent framework SDK for building autonomous agents on the Ziggs platform",
   "type": "module",
   "main": "dist/index.js",
@@ -26,7 +26,7 @@
     "@anthropic-ai/claude-agent-sdk": "^0.3.204",
     "@anthropic-ai/sdk": "^0.110.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@ziggs-ai/api-client": "0.11.0",
+    "@ziggs-ai/api-client": "0.13.0",
     "ajv": "^8.17.1",
     "dotenv": "^17.2.3",
     "openai": "^4.0.0",