@ziggs-ai/agent-sdk 0.12.0 → 0.14.0

package/dist/AgentHost.js

@@ -201,11 +201,13 @@ export class AgentHost {
             description: resolved.description || 'A helpful assistant',
             systemPrompt: resolved.systemPrompt,
             specialization: resolved.specialization ?? null,
+            requestMatchTags: resolved.requestMatchTags,
             tools: resolved.tools || [],
             // Copied deliberately: this object is an allow-list, so a field left out
             // here is silently dropped between the manifest and the runtime. That is
             // exactly how `respondsToProposals` reached the store as null for 133
-            // agents — the declaration existed and nothing carried it.
+            // agents — the declaration existed and nothing carried it. Same for
+            // `requestMatchTags` (always undefined at triage) and `telemetryIngest`.
             needs: resolved.needs,
             taskTools: resolved.taskTools,
             states: resolved.states,
@@ -219,6 +221,7 @@ export class AgentHost {
             metricsTap: resolved.metricsTap,
             wakeTap: resolved.wakeTap,
             inboxCatchUp: resolved.inboxCatchUp,
+            telemetryIngest: resolved.telemetryIngest,
             brain: resolved.brain,
             cognition: resolved.cognition ?? 'fsm',
             claudeMaxTurns: resolved.claudeMaxTurns,

package/dist/agent/ClaudeSdkAgent.js

@@ -197,8 +197,8 @@ function resolveOnBehalfAgreementId(rawEvent, contextSnap, agentId, sessionId) {
         ? contextSnap.agreements
         : [];
     const provides = ags.filter((a) => {
-        const p = a?.parties ?? a;
-        const providerIds = [p?.provider, p?.providerAgent, a?.providerId, a?.providerAgentId, a?.executorId];
+        const provider = a?.parties?.provider;
+        const providerIds = [provider?.actor, a?.providerId, a?.providerAgentId, a?.executorId];
         const isProvider = providerIds.some((x) => x === agentId);
         const status = a?.status != null ? String(a.status).toLowerCase() : '';
         const active = !status || status === 'active' || status === 'approved';

package/dist/agent/claudeCognition.js

@@ -151,6 +151,18 @@ function renderEventLines(event, lines) {
                 lines.push(`Agreement: ${agreementId}`);
             }
         }
+        // The other side of the same policy: a message this agent sent to a
+        // published agent landed and was NOT rung through. Nothing is wrong and
+        // nothing is lost, so this must not read as a refusal — but without it the
+        // sender waits on a reply that is never coming and its rational next move
+        // is to send again.
+        if (reason === 'contact_policy_withheld') {
+            lines.push('Your message was delivered and is readable, but the agent you wrote ' +
+                'to is not woken for it: its listing is claim-first, so it starts ' +
+                'work once you claim the listing. Do not resend — claim the listing ' +
+                '(ziggs_marketplace_view to find it, then ziggs_agreement_claim), or ' +
+                'wait if somebody else is claiming on your behalf.');
+        }
     }
     if (typeof event?.agreementId === 'string' && event.agreementId) {
         lines.push(`Agreement: ${event.agreementId}`);

package/dist/agent/claudeSdkTools.js

@@ -1,4 +1,5 @@
 import { randomUUID } from 'node:crypto';
+import { laneFromToolContext } from '../tools/toolCreds.js';
 import { listTasks } from '@ziggs-ai/api-client';
 import { defineTool } from '../tools/defineTool.js';
 import { listGrantsTool } from '../server/tools/tier2/grantsTools.js';
@@ -177,7 +178,10 @@ export const listTasksTool = defineTool('task_list', {
     const createdBy = args.createdByMe ? c.agentId : undefined;
     // the lane fences this to the engagement's tasks. Without it the
     // list is every task the agent's key can reach, across all its customers.
-    const laneId = c.chatId || c.sessionId || undefined;
+    // One reader for the lane, shared with the capability adapter and with
+    // hand-written tools — three copies of `chatId || sessionId` is how one of
+    // them ends up not claiming the reach the fence exists to grant.
+    const laneId = laneFromToolContext(c);
     return listTasks({
         state: args.state,
         cursor: args.cursor,

package/dist/cognition/validateContext.js

@@ -41,8 +41,11 @@ function validateAgreements(agreements, warn) {
         }
         if (ag['parties'] && typeof ag['parties'] === 'object') {
             const parties = ag['parties'];
+            // Each side is occupied when either column names somebody; a side with a
+            // principal and no actor is a party acting through its own credential.
             for (const key of ['creator', 'provider']) {
-                if (!parties[key])
+                const side = parties[key];
+                if (!side?.principal && !side?.actor)
                     warn(`${path}.parties.${key}`, 'missing');
             }
         }

package/dist/context/batch.d.ts

@@ -1,2 +1,5 @@
+import { type AgreementParties } from '@ziggs-ai/api-client';
 export declare function getBatchEvents(rawEvent: unknown): unknown[];
 export declare function isTaskResultRelevantToAgent(result: Record<string, unknown>, ownAgentId: string | null): boolean;
+/** The agreement's party slots on a task_result payload, when it carries one. */
+export declare function partiesOf(result: Record<string, unknown>): AgreementParties | undefined;

package/dist/context/batch.js

@@ -1,4 +1,4 @@
-import { isBroadcastTarget } from '@ziggs-ai/api-client';
+import { isBroadcastTarget, partyActorIds } from '@ziggs-ai/api-client';
 export function getBatchEvents(rawEvent) {
     if (!rawEvent)
         return [];
@@ -10,9 +10,12 @@ export function getBatchEvents(rawEvent) {
 export function isTaskResultRelevantToAgent(result, ownAgentId) {
     if (!ownAgentId)
         return true;
-    const parties = result['agreement']?.['parties'] ?? {};
+    const parties = partiesOf(result);
     return !!(result['creatorIsYou'] || result['providerIsYou'] || result['payerIsYou'] || result['proposedToIsYou'] ||
-        parties['creator'] === ownAgentId || parties['provider'] === ownAgentId ||
-        parties['payer'] === ownAgentId || parties['proposedTo'] === ownAgentId ||
-        isBroadcastTarget(parties['proposedTo']));
+        partyActorIds(parties).includes(ownAgentId) ||
+        isBroadcastTarget(parties?.proposedTo?.principal));
+}
+/** The agreement's party slots on a task_result payload, when it carries one. */
+export function partiesOf(result) {
+    return result['agreement']?.parties;
 }

package/dist/context/classifyEnvelope.js

@@ -1,8 +1,7 @@
 import { CONTEXT_RESET } from './applyEffects.js';
-import { getBatchEvents, isTaskResultRelevantToAgent } from './batch.js';
+import { getBatchEvents, isTaskResultRelevantToAgent, partiesOf } from './batch.js';
 function isTaskAssignment(result, ownAgentId) {
-    const parties = result['agreement']?.['parties'] ?? {};
-    const isProvider = result['providerIsYou'] || parties['provider'] === ownAgentId;
+    const isProvider = result['providerIsYou'] || partiesOf(result)?.provider?.actor === ownAgentId;
     return !!(isProvider && (result['state'] === 'active' || result['state'] === 'in-progress'));
 }
 export function classifyIncomingEvent(rawEvent, ownAgentId) {
@@ -22,9 +21,9 @@ export function classifyIncomingEvent(rawEvent, ownAgentId) {
             continue;
         const state = result['state'];
         const ag = result['agreement'];
-        const parties = ag?.['parties'] || {};
+        const parties = partiesOf(result);
         const proposalStatus = ag?.['proposal']?.['status'];
-        if (state === 'active' && proposalStatus === 'approved' && ownAgentId && parties['creator'] === ownAgentId) {
+        if (state === 'active' && proposalStatus === 'approved' && ownAgentId && parties?.creator?.actor === ownAgentId) {
             flags['approval'] = true;
             flags['taskAssignment'] = result;
             continue;

package/dist/context/routingLabels.js

@@ -1,5 +1,5 @@
 import { isProtocolToolName } from '../tasks/protocolRegistry.js';
-import { getBatchEvents, isTaskResultRelevantToAgent } from './batch.js';
+import { getBatchEvents, isTaskResultRelevantToAgent, partiesOf } from './batch.js';
 export function unwrapBatchEvent(event) {
     const e = event;
     if (e?.['type'] === 'batch' && Array.isArray(e['events']) && e['events'][0])
@@ -22,9 +22,8 @@ export function classifyWorkflowEvent(event, ownAgentId = null) {
         sawOwnTaskResult = true;
         const state = result['state'];
         const ag = result['agreement'];
-        const parties = ag?.['parties'] || {};
         const proposalStatus = ag?.['proposal'] ? ag['proposal']['status'] : undefined;
-        const isProvider = result['providerIsYou'] || parties['provider'] === ownAgentId;
+        const isProvider = result['providerIsYou'] || partiesOf(result)?.provider?.actor === ownAgentId;
         if (isProvider && (state === 'active' || state === 'in-progress'))
             return 'task_assignment';
         if (proposalStatus === 'approved' || (state === 'active' && proposalStatus === 'pending'))

package/dist/formatters/AgreementFormatter.d.ts

@@ -1,3 +1,4 @@
+import { type AgreementPartySide } from '@ziggs-ai/api-client';
 interface AgreementFormatterOptions {
     shortIds?: boolean;
     indentSize?: number;
@@ -10,7 +11,12 @@ export declare class AgreementFormatter {
     format(agreements: AnyObj[] | null | undefined): string;
     formatAgreement(ag: AnyObj, indent?: string): string;
     _renderTaskExecution(task: AnyObj, indent?: string): string;
-    _labelParty(id: string | null | undefined, isYou: boolean | undefined): string;
+    /**
+     * A side names up to two ids — the accountable principal and the agent that
+     * acted for it. Both are rendered: the agent has to recognize itself here,
+     * and the principal is who the deal is actually with.
+     */
+    _labelParty(side: AgreementPartySide | null | undefined, isYou: boolean | undefined): string;
     shortId(id: string | null | undefined): string;
     private _indent;
 }

package/dist/formatters/AgreementFormatter.js

@@ -1,3 +1,4 @@
+import { partySideIds } from '@ziggs-ai/api-client';
 export class AgreementFormatter {
     shortIds;
     indentSize;
@@ -37,14 +38,16 @@ export class AgreementFormatter {
         const status = (ag['status'] || 'unknown').toUpperCase();
         const agId = this.shortId(ag['agreementId']);
         const parties = ag['parties'] || {};
+        const side = (name) => parties[name];
         const lines = [
             `${indent}[${status}] Agreement ${agId}`,
-            `${indent}  Creator: ${this._labelParty(parties['creator'], ag['creatorIsYou'])}`,
-            `${indent}  Provider: ${this._labelParty(parties['provider'], ag['providerIsYou'])}`,
-            `${indent}  Payer: ${this._labelParty(parties['payer'], ag['payerIsYou'])}`,
+            `${indent}  Creator: ${this._labelParty(side('creator'), ag['creatorIsYou'])}`,
+            `${indent}  Provider: ${this._labelParty(side('provider'), ag['providerIsYou'])}`,
+            `${indent}  Payer: ${this._labelParty(side('payer'), ag['payerIsYou'])}`,
         ];
-        if (parties['proposedTo'])
-            lines.push(`${indent}  Proposed to: ${this._labelParty(parties['proposedTo'], ag['proposedToIsYou'])}`);
+        if (partySideIds(side('proposedTo')).length > 0) {
+            lines.push(`${indent}  Proposed to: ${this._labelParty(side('proposedTo'), ag['proposedToIsYou'])}`);
+        }
         const proposal = ag['proposal'];
         if (proposal?.['status'])
             lines.push(`${indent}  Proposal: ${proposal['status']}${proposal['respondedBy'] ? ` (by ${proposal['respondedBy']})` : ''}`);
@@ -111,10 +114,16 @@ export class AgreementFormatter {
         }
         return lines.join('\n');
     }
-    _labelParty(id, isYou) {
-        if (!id)
+    /**
+     * A side names up to two ids — the accountable principal and the agent that
+     * acted for it. Both are rendered: the agent has to recognize itself here,
+     * and the principal is who the deal is actually with.
+     */
+    _labelParty(side, isYou) {
+        const shown = partySideIds(side).join(' via ');
+        if (!shown)
             return 'N/A';
-        return isYou ? `You (${id})` : id;
+        return isYou ? `You (${shown})` : shown;
     }
     shortId(id) {
         if (!id)

package/dist/formatters/HistoryFormatter.d.ts

@@ -17,6 +17,11 @@ export declare class HistoryFormatter {
     formatParticipant(participant: AnyObj | null | undefined, agentId: string): string;
     formatOwner(task: AnyObj, agentId: string): string;
     formatExecutor(task: AnyObj, agentId: string): string;
+    /**
+     * One side of the task's agreement, or `fallback` when the frame carries no
+     * parties — a bare resource_changed skeleton has the task ids and nothing else.
+     */
+    private _formatSide;
     shortId(id: string | null | undefined): string;
     formatTime(timestamp: string | null | undefined): string;
     formatArgs(args: AnyObj | null | undefined): string;

package/dist/formatters/HistoryFormatter.js

@@ -1,3 +1,4 @@
+import { partySideIds } from '@ziggs-ai/api-client';
 export class HistoryFormatter {
     showTimestamps;
     shortIds;
@@ -67,7 +68,8 @@ export class HistoryFormatter {
             case 'created': {
                 const ag = task['agreement'];
                 const parties = ag?.['parties'] || {};
-                return `${timePrefix}Task created under agreement: "${desc}" (${ids})\n    Owner: ${this.formatOwner(task, agentId)}\n    Executor: ${this.formatExecutor(task, agentId)}\n    Proposed to: ${parties['proposedTo'] || 'N/A'}`;
+                const proposedTo = partySideIds(parties['proposedTo']).join(' via ');
+                return `${timePrefix}Task created under agreement: "${desc}" (${ids})\n    Owner: ${this.formatOwner(task, agentId)}\n    Executor: ${this.formatExecutor(task, agentId)}\n    Proposed to: ${proposedTo || 'N/A'}`;
             }
             case 'state_changed': {
                 const prev = service?.['previousState']?.['state'] || '?';
@@ -140,14 +142,21 @@ export class HistoryFormatter {
         return `${id} (${participant['type'] || 'unknown'})`;
     }
     formatOwner(task, agentId) {
-        const ag = task['agreement'];
-        const creatorId = ag?.['parties']?.['creator'] ?? task['agentId'];
-        return creatorId === agentId ? 'You' : String(creatorId ?? 'N/A');
+        return this._formatSide(task, 'creator', task['agentId'], agentId);
     }
     formatExecutor(task, agentId) {
-        const ag = task['agreement'];
-        const providerId = ag?.['parties']?.['provider'] ?? task['executorId'];
-        return providerId === agentId ? 'You' : String(providerId ?? 'N/A');
+        return this._formatSide(task, 'provider', task['executorId'], agentId);
+    }
+    /**
+     * One side of the task's agreement, or `fallback` when the frame carries no
+     * parties — a bare resource_changed skeleton has the task ids and nothing else.
+     */
+    _formatSide(task, role, fallback, agentId) {
+        const parties = task['agreement']?.['parties'];
+        const ids = partySideIds(parties?.[role]);
+        if (ids.length === 0)
+            return fallback === agentId ? 'You' : String(fallback ?? 'N/A');
+        return ids.includes(agentId) ? 'You' : ids.join(' via ');
     }
     shortId(id) {
         if (!id)

package/dist/index.d.ts

@@ -53,6 +53,7 @@ export { ToolManager } from './tools/ToolManager.js';
 export { ToolProvider } from './tools/ToolProvider.js';
 export { defineTool } from './tools/defineTool.js';
 export { recordReport } from './tools/recordReport.js';
+export { credsFromToolContext, laneFromToolContext } from './tools/toolCreds.js';
 export type { RecordReportInput, RecordReportResult, TaskReport } from './tools/recordReport.js';
 export { MCP_PROVIDER, describeNeed, normalizeNeeds, toolsForNeed, toolsForNeeds, unmetNeeds, unmetNeedsMessage, } from './tools/needs.js';
 export type { AgentNeed, ConnectionNeed } from './tools/needs.js';
@@ -62,7 +63,7 @@ export { HistoryFormatter, historyFormatter, AgreementFormatter, agreementFormat
 export { ProactiveTrigger } from './server/proactive/ProactiveTrigger.js';
 export { PollRegistry, declaredPolls, type PollBinding, type PollContext, type PollKind, type PollResult, } from './server/polls/PollKind.js';
 export { PollRunner, type PollRunnerOptions, type WakeTarget } from './server/polls/PollRunner.js';
-export { PROTOCOL_TOOLS, agreementProposeTool, agreementSubcontractTool, agreementRespondTool, agreementClaimTool, agreementCounterTool, agreementGetTool, agreementRevokeTool, agreementFulfillTool, taskCreateTool, taskSetResultTool, taskUpdatePlanStepTool, dispatchProtocolOp, PAYMENT_TOOLS, paymentBalanceTool, CONNECTION_TOOLS, connectionProxyTool, connectionListGrantsTool, requestConnectionTool, MCP_CONNECTION_TOOLS, mcpToolCallTool, mcpToolsListTool, DISCOVERY_TOOLS, agentSearchTool, agentGetTool, MARKETPLACE_TOOLS, marketplaceViewTool, CONTEXT_TOOLS, contextReadTool, contextDelegateTool, contextExpandReachTool, contextDiscoverGrantableTool, GRANTS_TOOLS, listGrantsTool, LINK_TOOLS, linkCreateInviteTool, linkListTool, ARTIFACT_TOOLS, recordArtifactTool, CHAT_TOOLS, openConversationTool, } from './server/tools/index.js';
+export { PROTOCOL_TOOLS, agreementProposeTool, agreementSubcontractTool, agreementRespondTool, agreementClaimTool, agreementCounterTool, agreementGetTool, agreementRevokeTool, agreementFulfillTool, taskCreateTool, taskSetResultTool, taskUpdatePlanStepTool, dispatchProtocolOp, PAYMENT_TOOLS, paymentBalanceTool, CONNECTION_TOOLS, connectionProxyTool, connectionListGrantsTool, requestConnectionTool, MCP_CONNECTION_TOOLS, mcpToolCallTool, mcpToolsListTool, DISCOVERY_TOOLS, agentSearchTool, agentGetTool, MARKETPLACE_TOOLS, marketplaceViewTool, CONTEXT_TOOLS, contextReadTool, contextDelegateTool, contextExpandReachTool, contextDiscoverGrantableTool, GRANTS_TOOLS, listGrantsTool, LINK_TOOLS, linkProposeTool, linkListTool, ARTIFACT_TOOLS, recordArtifactTool, CHAT_TOOLS, openConversationTool, } from './server/tools/index.js';
 export { CLAUDE_SDK_TOOLS } from './agent/claudeSdkTools.js';
 export { PROTOCOL_TOOL_NAMES, PROTOCOL_TOOL_TO_OPERATION, mapProtocolToolToOperation, isProtocolToolName } from './tasks/protocolRegistry.js';
 export { InMemoryStore, FileMemoryStore } from './memory/MemoryStore.js';

package/dist/index.js

@@ -55,6 +55,7 @@ export { ToolManager } from './tools/ToolManager.js';
 export { ToolProvider } from './tools/ToolProvider.js';
 export { defineTool } from './tools/defineTool.js';
 export { recordReport } from './tools/recordReport.js';
+export { credsFromToolContext, laneFromToolContext } from './tools/toolCreds.js';
 // An agent declares the access it cannot work without, and the declaration
 // produces the tools for it.
 export { MCP_PROVIDER, describeNeed, normalizeNeeds, toolsForNeed, toolsForNeeds, unmetNeeds, unmetNeedsMessage, } from './tools/needs.js';
@@ -76,7 +77,7 @@ export {
 // Tier 1 — protocol grammar (framework-managed via taskTools).
 PROTOCOL_TOOLS, agreementProposeTool, agreementSubcontractTool, agreementRespondTool, agreementClaimTool, agreementCounterTool, agreementGetTool, agreementRevokeTool, agreementFulfillTool, taskCreateTool, taskSetResultTool, taskUpdatePlanStepTool, dispatchProtocolOp, 
 // Tier 2 — opt-in capability bundles (spread into `tools:`).
-PAYMENT_TOOLS, paymentBalanceTool, CONNECTION_TOOLS, connectionProxyTool, connectionListGrantsTool, requestConnectionTool, MCP_CONNECTION_TOOLS, mcpToolCallTool, mcpToolsListTool, DISCOVERY_TOOLS, agentSearchTool, agentGetTool, MARKETPLACE_TOOLS, marketplaceViewTool, CONTEXT_TOOLS, contextReadTool, contextDelegateTool, contextExpandReachTool, contextDiscoverGrantableTool, GRANTS_TOOLS, listGrantsTool, LINK_TOOLS, linkCreateInviteTool, linkListTool, ARTIFACT_TOOLS, recordArtifactTool, CHAT_TOOLS, openConversationTool, } from './server/tools/index.js';
+PAYMENT_TOOLS, paymentBalanceTool, CONNECTION_TOOLS, connectionProxyTool, connectionListGrantsTool, requestConnectionTool, MCP_CONNECTION_TOOLS, mcpToolCallTool, mcpToolsListTool, DISCOVERY_TOOLS, agentSearchTool, agentGetTool, MARKETPLACE_TOOLS, marketplaceViewTool, CONTEXT_TOOLS, contextReadTool, contextDelegateTool, contextExpandReachTool, contextDiscoverGrantableTool, GRANTS_TOOLS, listGrantsTool, LINK_TOOLS, linkProposeTool, linkListTool, ARTIFACT_TOOLS, recordArtifactTool, CHAT_TOOLS, openConversationTool, } from './server/tools/index.js';
 // The always-on toolset for the hosted Claude cognition (parity guard
 // reads this as part of the real SDK registry).
 export { CLAUDE_SDK_TOOLS } from './agent/claudeSdkTools.js';

package/dist/ingress/normalizeIncoming.d.ts

@@ -1,3 +1,4 @@
+import type { AgreementParties } from '@ziggs-ai/api-client';
 export interface NormalizedEvent {
     chatId: string | null;
     event: {
@@ -25,12 +26,6 @@ export interface NormalizedEvent {
         text?: string;
     };
 }
-interface WireParties {
-    creator?: string;
-    provider?: string;
-    payer?: string;
-    proposedTo?: string;
-}
 interface WireTask {
     taskId?: string;
     agentId?: string;
@@ -42,7 +37,7 @@ interface WireTask {
     state?: string;
     proposal?: unknown;
     agreement?: {
-        parties?: WireParties;
+        parties?: AgreementParties;
     };
 }
 interface WireMetadata {
@@ -69,7 +64,7 @@ interface WireMetadata {
             proposal?: {
                 status?: string;
             };
-            parties?: WireParties;
+            parties?: AgreementParties;
             approvals?: Array<{
                 partyId?: string;
                 status?: string;

package/dist/pricing/fleetDefaults.d.ts

@@ -8,7 +8,6 @@ export declare const TIER_PRICE_CENTS: Record<FleetPricingTier, number>;
 export declare function resolveFleetTier(agentId: string): FleetPricingTier | null;
 export declare function isFirstPartyFleetAgent(agentId: string): boolean;
 export declare function tierPriceCents(tier: FleetPricingTier): number;
-export declare function isZiggsOrchestrator(agentId: string): boolean;
 export declare function isFreeAllowlistedExecutor(executorId: string, description?: string | null): boolean;
 export declare function resolveDefaultPriceCentsForExecutor(executorId: string, description?: string | null): number | null;
 export interface ProtocolPricingPayload {

package/dist/pricing/fleetDefaults.js

@@ -12,7 +12,6 @@ export const TIER_PRICE_CENTS = {
     C: 1500, // 15 ZIG / job (orchestrator, charged once at top)
     D: 100, // 1 ZIG / call (hand-written demo agents)
 };
-const ZIGGS_ORCHESTRATOR_IDS = new Set(['ziggs-agent']);
 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) {
@@ -26,9 +25,6 @@ export function isFirstPartyFleetAgent(agentId) {
 export function tierPriceCents(tier) {
     return TIER_PRICE_CENTS[tier];
 }
-export function isZiggsOrchestrator(agentId) {
-    return ZIGGS_ORCHESTRATOR_IDS.has(agentId);
-}
 export function isFreeAllowlistedExecutor(executorId, description) {
     if (!executorId)
         return false;
@@ -82,14 +78,13 @@ export function applyFleetAgreementPricing(operation, payload, actingAgentId) {
     }
     const proposedTo = next.proposedTo != null ? String(next.proposedTo) : '';
     const providerId = next.providerId != null ? String(next.providerId) : '';
-    // Ziggs scope proposal to human user — 15 ZIG once at top.
-    if (isZiggsOrchestrator(actingAgentId) &&
-        proposedTo &&
-        !isFirstPartyFleetAgent(proposedTo)) {
-        next.price = TIER_PRICE_CENTS.C;
-        return next;
-    }
-    // Tier C orchestrator proposing scope to a user (non-ziggs fleet orchestrators).
+    // A tier C orchestrator proposing scope to a user — 15 ZIG once at top.
+    //
+    // The ziggs delegate used to have its own branch above this one, keyed on a
+    // hardcoded id. It asked the same question with the same answer — that agent
+    // is tier C, so this line already priced it. A second way of asking the tier
+    // question the tier had already answered, which is the same shape that was
+    // removed from the backend copy.
     const actingTier = resolveFleetTier(actingAgentId);
     if (actingTier === 'C' && proposedTo && !isFirstPartyFleetAgent(proposedTo)) {
         next.price = TIER_PRICE_CENTS.C;

package/dist/runtime/PromptBuilder.js

@@ -1,6 +1,6 @@
 import { HistoryFormatter, AgreementFormatter } from '../formatters/index.js';
 import { validateContext } from '../cognition/validateContext.js';
-import { isBroadcastTarget, isOpaquePresentationRef } from '@ziggs-ai/api-client';
+import { isBroadcastTarget, isOpaquePresentationRef, partySideIds } from '@ziggs-ai/api-client';
 import { LANE_BOOK_KEY, allCollectedResults, allDelegatedAgreementIds, allPendingSubtasks, } from './taskBookkeeping.js';
 /** Rough chars-per-token ratio for budgeting (English/JSON averages ~4). */
 const CHARS_PER_TOKEN = 4;
@@ -191,12 +191,13 @@ ${this._renderDecisionSchemaFromActions(actions, senderMeta, ctxObj, omitMessage
         const creatorIsYou = task.creatorIsYou;
         const providerIsYou = task.providerIsYou;
         if (ag?.agreementId) {
+            const named = (name) => partySideIds(parties[name]).join(' via ');
             lines.push(`Agreement: ${ag.agreementId}${creatorIsYou ? ' (yours)' : ''}`);
-            lines.push(`  Creator: ${parties.creator ?? 'N/A'}${creatorIsYou ? ' (You)' : ''}`);
-            lines.push(`  Provider: ${parties.provider ?? 'N/A'}${providerIsYou ? ' (You)' : ''}`);
+            lines.push(`  Creator: ${named('creator') || 'N/A'}${creatorIsYou ? ' (You)' : ''}`);
+            lines.push(`  Provider: ${named('provider') || 'N/A'}${providerIsYou ? ' (You)' : ''}`);
             const proposal = ag.proposal;
             if (proposal?.status) {
-                lines.push(`  Proposal: ${proposal.status} (to ${parties.proposedTo}${task.proposedToIsYou ? ' - You' : ''})`);
+                lines.push(`  Proposal: ${proposal.status} (to ${named('proposedTo')}${task.proposedToIsYou ? ' - You' : ''})`);
             }
             const money = ag.money;
             if (typeof money?.price === 'number' && money.price > 0) {
@@ -300,22 +301,19 @@ ${this._renderDecisionSchemaFromActions(actions, senderMeta, ctxObj, omitMessage
         for (const ag of agreements || []) {
             const agId = ag?.agreementId;
             const parties = ag?.parties || {};
-            const roles = [
-                ['creator', 'creator'],
-                ['provider', 'provider'],
-                ['payer', 'payer'],
-                ['proposedTo', 'proposedTo'],
-            ];
-            for (const [field, role] of roles) {
-                const pid = parties[field];
-                if (!pid || pid === myAgentId)
-                    continue;
-                // Opaque presentation refs are not principal slots.
-                if (isOpaquePresentationRef(pid))
-                    continue;
-                if (!agreementParties.has(pid))
-                    agreementParties.set(pid, []);
-                agreementParties.get(pid).push({ agreementId: agId ?? '', role });
+            for (const role of ['creator', 'provider', 'payer', 'proposedTo']) {
+                // Both columns of a side are addressable and carry the same role: the
+                // principal is who the deal is with, the actor is who acts on it.
+                for (const pid of partySideIds(parties[role])) {
+                    if (pid === myAgentId)
+                        continue;
+                    // Opaque presentation refs are not principal slots.
+                    if (isOpaquePresentationRef(pid))
+                        continue;
+                    if (!agreementParties.has(pid))
+                        agreementParties.set(pid, []);
+                    agreementParties.get(pid).push({ agreementId: agId ?? '', role });
+                }
             }
         }
         // Chat keeps the full directory — including opaque `rpb_*` / `psn_*` refs
@@ -380,7 +378,7 @@ ${this._renderDecisionSchemaFromActions(actions, senderMeta, ctxObj, omitMessage
         lines.push('Set "action" to exactly one of the action names below.');
         lines.push('Message text is rendered as markdown (CommonMark + GFM). You MAY use **bold**, *italic*, `code`, fenced code blocks, lists, links, and tables when they improve clarity — plain text is also fine.\n');
         const replyTo = senderMeta.defaultReplyReceiverId || '<receiverId>';
-        const pendingProposals = (ctxObj.agreements || []).filter((a) => a.proposal?.status === 'pending' && (a.proposedToIsYou || isBroadcastTarget(a.parties?.proposedTo)));
+        const pendingProposals = (ctxObj.agreements || []).filter((a) => a.proposal?.status === 'pending' && (a.proposedToIsYou || isBroadcastTarget(a.parties?.proposedTo?.principal)));
         if (pendingProposals.length > 0) {
             lines.push(`PRIORITY: You have ${pendingProposals.length} pending proposal(s) directed at you. Respond BEFORE other actions.`);
             lines.push(`{"thought": "...", "action": "<action_bound_to_agreement_respond>", "args": {"agreementId": "<id>", "action": "approve|reject"}}\n`);

package/dist/runtime/buildOutcome.js

@@ -92,7 +92,7 @@ function singleEventToOutcome(ev, ownAgentId) {
         const parties = ag?.parties || {};
         const state = result.state;
         // Direct assignment to me (provider) — task spawned, citing an active agreement.
-        const isAssignedToMe = (result.providerIsYou || parties.provider === ownAgentId) &&
+        const isAssignedToMe = (result.providerIsYou || parties.provider?.actor === ownAgentId) &&
             (state === 'active' || state === 'in-progress');
         if (isAssignedToMe) {
             return { kind: 'task-assigned', task };
@@ -421,7 +421,7 @@ export function applyOutcomeToCtx(ctx, outcome) {
             const book = bookForDelegation(ctx);
             if (tid && !(tid in book.pendingSubtasks)) {
                 book.pendingSubtasks[tid] = {
-                    agentId: t.assigneeId ?? t.executorId ?? t.agreement?.parties?.provider ?? null,
+                    agentId: t.assigneeId ?? t.executorId ?? t.agreement?.parties?.provider?.actor ?? null,
                     spawnedAt: Date.now(),
                 };
             }
@@ -465,7 +465,7 @@ export function applyOutcomeToCtx(ctx, outcome) {
                 if (!existing) {
                     book.collectedResults.push({
                         taskId,
-                        agentId: pending?.agentId ?? t?.assigneeId ?? t?.executorId ?? t?.agreement?.parties?.provider ?? null,
+                        agentId: pending?.agentId ?? t?.assigneeId ?? t?.executorId ?? t?.agreement?.parties?.provider?.actor ?? null,
                         status: outcome.status,
                         result: payload,
                     });
@@ -479,7 +479,7 @@ export function applyOutcomeToCtx(ctx, outcome) {
                     existing.status = outcome.status;
                     existing.result = payload;
                     if (existing.agentId == null) {
-                        existing.agentId = t?.assigneeId ?? t?.executorId ?? t?.agreement?.parties?.provider ?? null;
+                        existing.agentId = t?.assigneeId ?? t?.executorId ?? t?.agreement?.parties?.provider?.actor ?? null;
                     }
                 }
                 if (agId) {

package/dist/runtime/kickoff.d.ts

@@ -11,15 +11,28 @@ export declare function buildKickoffState(initial: string): ThinkingState;
 export declare function buildClaimKickoffState(initial: string): ThinkingState;
 /**
  * Agreement-kickoff defaults. For every state whose transitions do not already
- * match the corresponding probe, append a transition to the injected kickoff
- * state. Appended LAST so any user transition on the same outcome always wins
- * (first match wins in AgentMachine._evaluateTransitions). Returns a NEW
- * workflow — input states are not mutated.
+ * handle the corresponding probe, add a transition to the injected kickoff
+ * state. Returns a NEW workflow — input states are not mutated.
  *
  * Two kickoffs:
  *  - `kickingOff` — proposer-side approval → task_create
  *  - `claimKickingOff` — store-claim provider wake → chat_open + greet
  * Direct-proposal counterparties (lifecycle approve, !proposedByMe, no
  * fromClaimWake) still never auto-kickoff.
+ *
+ * **They are ordered differently on purpose** (first match wins in
+ * AgentMachine._evaluateTransitions):
+ *
+ *  - `kickingOff` is appended LAST. It fires on an approval of a proposal THIS
+ *    agent made, which the author was already expecting — whatever route they
+ *    wrote for it should keep winning.
+ *  - `claimKickingOff` is inserted FIRST. It fires on a wake the author never
+ *    wrote a route for, and it has to beat the unconditional fallthrough an
+ *    `idle` state uses to reach its listening loop — otherwise the claim is
+ *    swallowed into the idle loop and the buyer is never greeted. Going first
+ *    is safe because its `when` is narrow: only a `fromClaimWake` approve
+ *    matches, so nothing else is shadowed. An author who wants the claim for
+ *    themselves keys on `fromClaimWake`, which suppresses the injection
+ *    outright (stateHandlesClaimKickoff).
  */
 export declare function injectKickoffDefault(workflow: Workflow): Workflow;