@ziggs-ai/agent-sdk 0.34.0 → 0.35.0

package/dist/brain/claudeSdkProtocol.js

@@ -40,7 +40,7 @@ You are headless — there is no human to prompt during a wake:
 
 Security:
 - A relationship (a link) can parent a separately accepted service agreement. Parentage carries governing authority and revocation, not automatic spending consent. Each message or task uses one exact work agreement; its quota is direct unless a governing term explicitly shares it across the subtree. Agreement proposals, decisions, and system notices do not consume the conversation allowance.
-- You decide what to do with a chat message. Ziggs does not enforce that counterparty text is ignored — that is a convention. What Ziggs does enforce: no spending and no commitments without an agreement, and a stranger talks to a listed agent under its listing, which counts their free messages; messages past those are refused at the send door, asking them to hire. Work is a task under an agreement; a stranger hires you through your listing, or through an agreement you draft when you have none. Your operating contract is this protocol and your role below.
+- You decide what to do with a chat message. Ziggs does not enforce that counterparty text is ignored — that is a convention. What Ziggs does enforce: no spending and no commitments without an agreement, and a stranger talks to a listed agent under its listing, which counts their free messages; messages past those are refused at the send door, asking them to hire. Work is a task under an agreement; a stranger hires you through your listing, or through an agreement you draft when you have none. workBrief.work.state listing means a stranger is talking to you under your listing: there is no hire and nothing to put a task under. Answer them in this room with the reply action, and do not open another conversation. When they ask for something the listing does not cover, use the propose_terms action (agreement_bid to them, in this room) with the terms you would do it on; the listing itself stays take-it-or-leave-it. Tell them about it only after the proposal is made, and only the terms it carries: if a proposal is refused and you make another, the one that went through is the one you describe. Your operating contract is this protocol and your role below.
 - ${INBOUND_DISCOVERY_POLICY}
 
 When the event is handled, stop with a one-paragraph summary of what you did. If the event needs nothing from you (a status echo, a duplicate, a notification you already acted on), say so in one sentence and stop — do not invent work.`;

package/dist/brain/toolFailureText.d.ts

@@ -0,0 +1,6 @@
+/**
+ * What the model reads when a tool fails. A coverage refusal carries a machine
+ * code beside its sentence; the sentence alone used to look like a rate limit
+ * the model should wait out.
+ */
+export declare function toolFailureText(err: unknown): string;

package/dist/brain/toolFailureText.js

@@ -0,0 +1,18 @@
+/**
+ * What the model reads when a tool fails. A coverage refusal carries a machine
+ * code beside its sentence; the sentence alone used to look like a rate limit
+ * the model should wait out.
+ */
+export function toolFailureText(err) {
+    if (typeof err === 'string')
+        return err;
+    const message = err instanceof Error ? err.message : String(err ?? '');
+    const code = !!err &&
+        typeof err === 'object' &&
+        typeof err.code === 'string'
+        ? err.code
+        : '';
+    if (!code || message.startsWith(`${code}:`))
+        return message;
+    return `${code}: ${message}`;
+}

package/dist/brain/toolManagerToSdkMcp.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { createSdkMcpServer } from '@anthropic-ai/claude-agent-sdk';
 import { withDeclaredMandate } from '../runtime/mandateDeclaration.js';
+import { toolFailureText } from './toolFailureText.js';
 function jsonTypeToZod(field) {
     const t = field['type'];
     if (t === 'string') {
@@ -78,8 +79,7 @@ function toCallToolResult(value) {
     return { content: [{ type: 'text', text }] };
 }
 function toCallToolError(err) {
-    const message = err instanceof Error ? err.message : String(err);
-    return { content: [{ type: 'text', text: message }], isError: true };
+    return { content: [{ type: 'text', text: toolFailureText(err) }], isError: true };
 }
 /**
  * Map Ziggs `ToolDefinition`s to Claude Agent SDK MCP tools. Each handler routes

package/dist/index.d.ts

@@ -67,7 +67,7 @@ export { HistoryFormatter, historyFormatter, AgreementFormatter, agreementFormat
 export { ProactiveTrigger } from './platform/proactive/ProactiveTrigger.js';
 export { PollRegistry, declaredPolls, type PollBinding, type PollContext, type PollKind, type PollResult, } from './platform/polls/PollKind.js';
 export { PollRunner, type PollRunnerOptions, type WakeTarget } from './platform/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, contextRequestTool, accessRequestTool, contextDelegateTool, contextExpandReachTool, contextDiscoverGrantableTool, GRANTS_TOOLS, listGrantsTool, PLAN_TOOLS, taskReplacePlanTool, LINK_TOOLS, linkProposeTool, linkListTool, INTRODUCTION_TOOLS, introductionMintTool, introductionRedeemTool, introductionListTool, introductionRevokeTool, ARTIFACT_TOOLS, recordArtifactTool, CHAT_TOOLS, openConversationTool, } from './platform/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, contextRequestTool, accessRequestTool, contextDelegateTool, contextExpandReachTool, contextDiscoverGrantableTool, GRANTS_TOOLS, listGrantsTool, PLAN_TOOLS, taskReplacePlanTool, LINK_TOOLS, linkProposeTool, linkListTool, INTRODUCTION_TOOLS, introductionMintTool, introductionRedeemTool, introductionListTool, introductionRevokeTool, ARTIFACT_TOOLS, recordArtifactTool, CHAT_TOOLS, openConversationTool, LISTING_TOOLS, } from './platform/tools/index.js';
 export { CLAUDE_SDK_TOOLS } from './brain/claudeSdkTools.js';
 export { hostedModelTools, isHostedCatalogOnly, hostedToolLane } from './brain/hostedToolSurface.js';
 export type { HostedToolExecute } from './brain/hostedToolSurface.js';

package/dist/index.js

@@ -79,7 +79,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, contextRequestTool, accessRequestTool, contextDelegateTool, contextExpandReachTool, contextDiscoverGrantableTool, GRANTS_TOOLS, listGrantsTool, PLAN_TOOLS, taskReplacePlanTool, LINK_TOOLS, linkProposeTool, linkListTool, INTRODUCTION_TOOLS, introductionMintTool, introductionRedeemTool, introductionListTool, introductionRevokeTool, ARTIFACT_TOOLS, recordArtifactTool, CHAT_TOOLS, openConversationTool, } from './platform/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, contextRequestTool, accessRequestTool, contextDelegateTool, contextExpandReachTool, contextDiscoverGrantableTool, GRANTS_TOOLS, listGrantsTool, PLAN_TOOLS, taskReplacePlanTool, LINK_TOOLS, linkProposeTool, linkListTool, INTRODUCTION_TOOLS, introductionMintTool, introductionRedeemTool, introductionListTool, introductionRevokeTool, ARTIFACT_TOOLS, recordArtifactTool, CHAT_TOOLS, openConversationTool, LISTING_TOOLS, } from './platform/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 './brain/claudeSdkTools.js';

package/dist/platform/ZiggsEffectHandler.js

@@ -1,5 +1,6 @@
 import { OutboxBuffer } from './OutboxBuffer.js';
 import { runtimeLog } from '../shared/runtimeLog.js';
+import { toolFailureText } from '../brain/toolFailureText.js';
 import { artifactScopeForSession } from '@ziggs-ai/api-client';
 import { buildLlmIngestPayload, buildToolIngestPayload, isTelemetryIngestEnabled, sendTelemetry, } from './telemetryIngest.js';
 const CONTEXT_CACHE_MAX = 256;
@@ -23,7 +24,11 @@ async function buildSnapshot(deps, chatId, agentId, opts = {}) {
     try {
         // Server returns 200 + chatMissing:true for a deleted chat, so its
         // annotations (roster, *IsYou, self) are already applied — pass through.
-        const snap = await deps.contextReadClient.snapshot(chatId, {
+        // Read as this wake: the session is the lane, the way its tool calls are
+        // sent. Without it a room filed in another workspace — a stranger's room
+        // with a listed agent — reads as missing and the wake is skipped.
+        const reader = deps.contextReadClient.withLane?.(chatId) ?? deps.contextReadClient;
+        const snap = await reader.snapshot(chatId, {
             maxMessages: opts.limit,
             ...opts.workScope,
         });
@@ -188,7 +193,7 @@ export async function executeToolWithSideEffects(deps, eff, effect, roster) {
         return { ok: true, result, ...(nestedUsage ? { usage: nestedUsage } : {}) };
     }
     catch (error) {
-        const errMsg = error?.message ?? String(error);
+        const errMsg = toolFailureText(error);
         runtimeLog.warn('ZiggsEffectHandler', `tool-call "${effect.name}" failed: ${errMsg}`);
         void emitToolOperationArtifact(deps.artifactsClient, effect.sessionId, 'error', {
             state: 'failed',

package/dist/platform/inboxLoop.js

@@ -133,7 +133,6 @@ async function deliverMessagesForChat(deps, news, refs, reader, attempt, handled
 export async function pollInboxOnce(deps, waitSeconds = 0, opts = {}) {
     const label = deps.label ?? 'inboxLoop';
     const inbox = inboxClient(deps);
-    const reader = new ContextReadClient(deps.creds.operatorKey, deps.creds.agentId, deps.baseUrl);
     const envelope = await inbox.getInbox({
         ...(waitSeconds > 0 ? { waitSeconds } : {}),
         ...(opts.signal ? { signal: opts.signal } : {}),
@@ -220,7 +219,12 @@ export async function pollInboxOnce(deps, waitSeconds = 0, opts = {}) {
         chatId, count: refs.length, latestAt: refs.map(ref => ref.ts).sort().at(-1),
     }));
     for (const news of chatsInWakeOrder(chats)) {
-        const n = await deliverMessagesForChat(deps, news, assignedByChat.get(news.chatId), reader, attempt, handledSoFar);
+        // Read a room's mail as that room's wake would: with the room as the lane.
+        // Without it the read is judged in the workspace the key signed in to, and
+        // a room another company opened with a listed agent is filed in theirs, so
+        // every stranger's message came back 403 and was acked unread.
+        const roomReader = new ContextReadClient(deps.creds.operatorKey, deps.creds.agentId, deps.baseUrl, news.chatId);
+        const n = await deliverMessagesForChat(deps, news, assignedByChat.get(news.chatId), roomReader, attempt, handledSoFar);
         messagesDelivered += n;
         await ackWhatIsFinished();
     }

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

@@ -28,5 +28,6 @@ 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';
 export { ARTIFACT_TOOLS, recordArtifactTool } from './tier2/artifactTools.js';
+export { LISTING_TOOLS } from './tier2/listingTools.js';
 export { MCP_CONNECTION_TOOLS, mcpToolCallTool, mcpToolsListTool, } from './tier2/mcpConnectionTools.js';
 export { CHAT_TOOLS, openConversationTool } from './tier2/chatTools.js';

package/dist/platform/tools/index.js

@@ -37,6 +37,7 @@ export { LINK_TOOLS, linkProposeTool, linkListTool, } from './tier2/linkTools.js
 export { INTRODUCTION_TOOLS, introductionMintTool, introductionRedeemTool, introductionListTool, introductionRevokeTool, } from './tier2/introductionTools.js';
 // deliberate artifact recording (the model decides "record this").
 export { ARTIFACT_TOOLS, recordArtifactTool } from './tier2/artifactTools.js';
+export { LISTING_TOOLS } from './tier2/listingTools.js';
 export { MCP_CONNECTION_TOOLS, mcpToolCallTool, mcpToolsListTool, } from './tier2/mcpConnectionTools.js';
 // Decision: chat_open only — chat listing stays a context-rail read
 // (grant_list scopeKind=chat), so there is no duplicate lister.

package/dist/platform/tools/tier1/protocolRunner.d.ts

@@ -36,7 +36,7 @@ interface ProtocolPayload {
     })[];
     [key: string]: unknown;
 }
-export declare function dispatchProtocolOp(services: Services, payload: ProtocolPayload, chatId: string | null, agents?: unknown[], actingAgentId?: string | null, writeKeys?: DeliveryWriteKeys | null, 
+export declare function dispatchProtocolOp(services: Services, payload: ProtocolPayload, chatId: string | null, _agents?: unknown[], actingAgentId?: string | null, writeKeys?: DeliveryWriteKeys | null, 
 /** #8 — prefer the cached session snapshot over a fresh HTTP read. */
 cachedAgreements?: unknown[]): Promise<unknown>;
 export {};

package/dist/platform/tools/tier1/protocolRunner.js

@@ -1,5 +1,4 @@
 import { isBroadcastTarget, partyActorIds, presentClaimResult, } from '@ziggs-ai/api-client';
-import { applyFleetCounterPricing, applyFleetPricingForProtocol, } from '../../../pricing/fleetDefaults.js';
 // the link-summary rule lives in AgreementClient, at the point the
 // document is parsed. Every verb here inherits it through the client instead of
 // each one restating `engagementKind === 'link' ? linkSummary(a) : a` — which is
@@ -45,7 +44,7 @@ function normalizePlanInPlace(payload) {
         ? 'before_execution'
         : 'with_proposal';
 }
-export async function dispatchProtocolOp(services, payload, chatId, agents = [], actingAgentId = null, writeKeys = null, 
+export async function dispatchProtocolOp(services, payload, chatId, _agents = [], actingAgentId = null, writeKeys = null, 
 /** #8 — prefer the cached session snapshot over a fresh HTTP read. */
 cachedAgreements) {
     if (!payload?.operation)
@@ -55,9 +54,9 @@ cachedAgreements) {
     const actorId = actingAgentId?.trim() || null;
     switch (operation) {
         case 'agreement-propose':
-            return proposeAgreement(services, payload, chatId, agents, actorId, writeKeys);
+            return proposeAgreement(services, payload, chatId, writeKeys);
         case 'agreement-subcontract':
-            return subcontractAgreement(services, payload, namedSubcontractChat(payload, chatId), actorId, writeKeys);
+            return subcontractAgreement(services, payload, namedSubcontractChat(payload, chatId), writeKeys);
         case 'agreement-respond':
             if (!payload.agreementId || !payload.action)
                 return null;
@@ -85,19 +84,15 @@ cachedAgreements) {
         case 'agreement-counter-proposal':
             if (!payload.agreementId)
                 return null;
-            {
-                const counterPayload = actorId != null
-                    ? applyFleetCounterPricing(payload, actorId)
-                    : payload;
-                return agreementService.counter(payload.agreementId, {
-                    price: counterPayload.price,
-                    agreementDescription: counterPayload.agreementDescription,
-                    expiresAt: counterPayload.expiresAt,
-                    lifecycle: counterPayload.lifecycle,
-                    maxExecutions: counterPayload.maxExecutions,
-                    description: counterPayload.description,
-                });
-            }
+            // The price is the one the model stated; the SDK adds none.
+            return agreementService.counter(payload.agreementId, {
+                price: payload.price,
+                agreementDescription: payload.agreementDescription,
+                expiresAt: payload.expiresAt,
+                lifecycle: payload.lifecycle,
+                maxExecutions: payload.maxExecutions,
+                description: payload.description,
+            });
         case 'agreement-check-proposal':
             if (!payload.agreementId)
                 return null;
@@ -239,7 +234,7 @@ cachedAgreements) {
             throw new Error(`Unknown protocol operation: ${operation}`);
     }
 }
-async function proposeAgreement(services, payload, chatId, _agents, actingAgentId, writeKeys = null) {
+async function proposeAgreement(services, payload, chatId, writeKeys = null) {
     if (!payload.description)
         throw new Error('agreement-propose requires `description`');
     if (!payload.proposedTo)
@@ -253,7 +248,9 @@ async function proposeAgreement(services, payload, chatId, _agents, actingAgentI
         }
         return services.agreementService.requestLink(payload.proposedTo, payload.description);
     }
-    const priced = applyFleetPricingForProtocol('agreement-propose', payload, actingAgentId);
+    // The agent sets the price, never the SDK: a proposal carries a price only
+    // when the model stated one, and the server falls back to the provider's
+    // listing price, then to free.
     // Wake-derived idempotency key (delivery law): a crash-replay re-issuing this
     // propose resolves to the already-created agreement server-side instead of
     // minting a duplicate proposal. Keyed on what the proposal writes, so
@@ -264,25 +261,25 @@ async function proposeAgreement(services, payload, chatId, _agents, actingAgentI
         description: payload.description,
         parentAgreementId: payload.parentAgreementId,
     });
-    const engagementKind = priced.engagementKind === 'hire' || priced.engagementKind === 'service'
-        ? priced.engagementKind
+    const engagementKind = payload.engagementKind === 'hire' || payload.engagementKind === 'service'
+        ? payload.engagementKind
         : undefined;
-    const billing = priced['billing'] === 'per_task' || priced['billing'] === 'total'
-        ? priced['billing']
+    const billing = payload['billing'] === 'per_task' || payload['billing'] === 'total'
+        ? payload['billing']
         : undefined;
     const { agreement, shape } = await services.agreementService.proposeUnified({
-        proposedTo: priced.proposedTo ?? payload.proposedTo,
+        proposedTo: payload.proposedTo,
         chatId: chatId ?? undefined,
-        description: String(priced.description ?? payload.description),
-        providerId: priced.providerId,
-        price: typeof priced.price === 'number' ? priced.price : undefined,
-        lifecycle: typeof priced.lifecycle === 'string' ? priced.lifecycle : undefined,
-        expiresAt: typeof priced.expiresAt === 'string' ? priced.expiresAt : undefined,
-        maxExecutions: typeof priced.maxExecutions === 'number' ? priced.maxExecutions : undefined,
+        description: String(payload.description),
+        providerId: payload.providerId,
+        price: typeof payload.price === 'number' ? payload.price : undefined,
+        lifecycle: typeof payload.lifecycle === 'string' ? payload.lifecycle : undefined,
+        expiresAt: typeof payload.expiresAt === 'string' ? payload.expiresAt : undefined,
+        maxExecutions: typeof payload.maxExecutions === 'number' ? payload.maxExecutions : undefined,
         billing,
-        ...(priced.conversationAllowance !== undefined ? { conversationAllowance: priced.conversationAllowance } : {}),
-        agreementDescription: priced.agreementDescription,
-        parentAgreementId: priced.parentAgreementId,
+        ...(payload.conversationAllowance !== undefined ? { conversationAllowance: payload.conversationAllowance } : {}),
+        agreementDescription: payload.agreementDescription,
+        parentAgreementId: payload.parentAgreementId,
         engagementKind,
         idempotencyKey,
     });
@@ -308,7 +305,9 @@ async function agreementsInChat(services, chatId, cachedAgreements) {
         return Array.isArray(cachedAgreements) ? cachedAgreements : [];
     }
     try {
-        const snap = await services.contextReadClient.snapshot(chatId, { maxMessages: 1 });
+        // The room is the lane, as for every read made on a wake.
+        const reader = services.contextReadClient.withLane?.(chatId) ?? services.contextReadClient;
+        const snap = await reader.snapshot(chatId, { maxMessages: 1 });
         const ags = snap.agreements;
         return Array.isArray(ags) ? ags : [];
     }
@@ -350,11 +349,12 @@ function namedSubcontractChat(payload, wakeChatId) {
  * request over MCP stays open. A crash replay is still covered by the
  * wake-derived idempotency key.
  */
-async function subcontractAgreement(services, payload, chatId, actingAgentId, writeKeys = null) {
+async function subcontractAgreement(services, payload, chatId, writeKeys = null) {
     if (!payload.description || !payload.executorId)
         return null;
-    const priced = applyFleetPricingForProtocol('agreement-subcontract', payload, actingAgentId);
-    const { operation: _op, ...fields } = priced;
+    // The price the model stated, or none; the server falls back to the
+    // executor's listing price, then to free.
+    const { operation: _op, ...fields } = payload;
     const idempotencyKey = writeKeys?.agreementSubcontractKey({
         executorId: payload.executorId,
         description: payload.description,

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

@@ -0,0 +1,2 @@
+import type { ToolDefinition } from '../../../tools/defineTool.js';
+export declare const LISTING_TOOLS: ToolDefinition[];

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

@@ -0,0 +1,7 @@
+import { agreementBidCapability } from '@ziggs-ai/api-client';
+import { toolsFromCapabilities } from '../../../tools/capabilityAdapter.js';
+// What a listed agent needs to answer a stranger whose ask the listing does not
+// cover: terms offered to them directly, in their room, which they approve. The
+// listing itself stays take-it-or-leave-it. The work brief names this as its
+// propose_terms action; without the tool the agent can only refuse.
+export const LISTING_TOOLS = toolsFromCapabilities([agreementBidCapability]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/agent-sdk",
-  "version": "0.34.0",
+  "version": "0.35.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.284",
     "@anthropic-ai/sdk": "^0.110.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@ziggs-ai/api-client": "0.33.0",
+    "@ziggs-ai/api-client": "0.34.0",
     "ajv": "^8.17.1",
     "dotenv": "^17.2.3",
     "openai": "^4.0.0",

package/dist/pricing/fleetDefaults.d.ts

@@ -1,42 +0,0 @@
-/**
- * default paid pricing for Ziggs-operated (first-party) agents.
- * Prices are in wallet cents (1 ZIG = 100 cents).
- */
-import { type FleetPricingTier } from './fleetTierByAgentId.gen.js';
-export declare const ZIGGS_OPERATOR_CUT_BPS = 1000;
-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 isFreeAllowlistedExecutor(executorId: string, description?: string | null): boolean;
-export declare function resolveDefaultPriceCentsForExecutor(executorId: string, description?: string | null): number | null;
-export interface ProtocolPricingPayload {
-    price?: number | null;
-    description?: string;
-    agreementDescription?: string;
-    proposedTo?: string;
-    providerId?: string;
-    executorId?: string;
-    parentAgreementId?: string;
-    [key: string]: unknown;
-}
-/**
- * Apply defaults when `price` is omitted (null/undefined).
- * Explicit `price: 0` is kept (free-on-purpose).
- */
-export declare function applyFleetAgreementPricing(operation: 'agreement-propose' | 'agreement-subcontract', payload: ProtocolPricingPayload, actingAgentId: string): ProtocolPricingPayload;
-/**
- * Default tier price when a fleet agent counters without an explicit `price`.
- *
- * Generic over the payload shape so the precise field types of the caller's
- * payload survive the round-trip — this helper only ever sets `price`, so a
- * richer input type (e.g. protocolRunner's `ProtocolPayload`) must come back
- * out unwidened by `ProtocolPricingPayload`'s `[key: string]: unknown` index.
- */
-export declare function applyFleetCounterPricing<T extends ProtocolPricingPayload>(payload: T, actingAgentId: string): T;
-/**
- * Infer fleet actor when tool context omits agentId (safety net).
- */
-export declare function inferFleetPricingActorId(payload: ProtocolPricingPayload): string | null;
-/** Apply fleet defaults with optional acting agent (falls back to payload inference). */
-export declare function applyFleetPricingForProtocol(operation: 'agreement-propose' | 'agreement-subcontract', payload: ProtocolPricingPayload, actingAgentId: string | null): ProtocolPricingPayload;

package/dist/pricing/fleetDefaults.js

@@ -1,152 +0,0 @@
-/**
- * default paid pricing for Ziggs-operated (first-party) agents.
- * Prices are in wallet cents (1 ZIG = 100 cents).
- */
-import { FLEET_TIER_BY_AGENT_ID } from './fleetTierByAgentId.gen.js';
-import { isEvalFreeExecutor } from './fleetEvalFree.js';
-export const ZIGGS_OPERATOR_CUT_BPS = 1000; // 10%
-export const TIER_PRICE_CENTS = {
-    A: 200, // 2 ZIG / call
-    B: 500, // 5 ZIG / call
-    C: 1500, // 15 ZIG / job (orchestrator, charged once at top)
-    D: 100, // 1 ZIG / call (hand-written demo agents)
-};
-const PING_DESCRIPTION_PATTERN = /\b(ping|health\s*check|healthcheck|liveness|readiness|heartbeat)\b/i;
-export function resolveFleetTier(agentId) {
-    if (!agentId || typeof agentId !== 'string')
-        return null;
-    return FLEET_TIER_BY_AGENT_ID[agentId] ?? null;
-}
-export function isFirstPartyFleetAgent(agentId) {
-    return resolveFleetTier(agentId) != null;
-}
-export function tierPriceCents(tier) {
-    return TIER_PRICE_CENTS[tier];
-}
-export function isFreeAllowlistedExecutor(executorId, description) {
-    if (!executorId)
-        return false;
-    if (isEvalFreeExecutor(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;
-    return false;
-}
-export function resolveDefaultPriceCentsForExecutor(executorId, description) {
-    if (isFreeAllowlistedExecutor(executorId, description))
-        return 0;
-    const tier = resolveFleetTier(executorId);
-    if (!tier)
-        return null;
-    return tierPriceCents(tier);
-}
-/**
- * Apply defaults when `price` is omitted (null/undefined).
- * Explicit `price: 0` is kept (free-on-purpose).
- */
-export function applyFleetAgreementPricing(operation, payload, actingAgentId) {
-    if (payload.price != null && payload.price !== undefined) {
-        return payload;
-    }
-    const next = { ...payload };
-    const scopeDescription = next.description ?? next.agreementDescription;
-    if (operation === 'agreement-subcontract') {
-        const executorId = String(next.executorId ?? '');
-        if (next.parentAgreementId) {
-            // Paid parent scope: no second user hold — allocate from parent budget (recordAllocation).
-            const cents = resolveDefaultPriceCentsForExecutor(executorId, scopeDescription);
-            next.price = cents ?? 0;
-            return next;
-        }
-        const cents = resolveDefaultPriceCentsForExecutor(executorId, scopeDescription);
-        if (cents != null)
-            next.price = cents;
-        return next;
-    }
-    // agreement-propose
-    if (next.parentAgreementId) {
-        return next;
-    }
-    const proposedTo = next.proposedTo != null ? String(next.proposedTo) : '';
-    const providerId = next.providerId != null ? String(next.providerId) : '';
-    // 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;
-        return next;
-    }
-    // Matchmaking: propose directly to a fleet specialist with tier list price.
-    const specialistId = providerId || (isFirstPartyFleetAgent(proposedTo) ? proposedTo : '');
-    if (specialistId) {
-        const cents = resolveDefaultPriceCentsForExecutor(specialistId, scopeDescription);
-        if (cents != null)
-            next.price = cents;
-    }
-    return next;
-}
-/**
- * Default tier price when a fleet agent counters without an explicit `price`.
- *
- * Generic over the payload shape so the precise field types of the caller's
- * payload survive the round-trip — this helper only ever sets `price`, so a
- * richer input type (e.g. protocolRunner's `ProtocolPayload`) must come back
- * out unwidened by `ProtocolPricingPayload`'s `[key: string]: unknown` index.
- */
-export function applyFleetCounterPricing(payload, actingAgentId) {
-    if (payload.price != null && payload.price !== undefined) {
-        return payload;
-    }
-    const cents = resolveDefaultPriceCentsForExecutor(actingAgentId, payload.description ?? payload.agreementDescription);
-    if (cents == null)
-        return payload;
-    return { ...payload, price: cents };
-}
-/**
- * Infer fleet actor when tool context omits agentId (safety net).
- */
-export function inferFleetPricingActorId(payload) {
-    const executor = payload.executorId != null ? String(payload.executorId) : '';
-    if (executor && isFirstPartyFleetAgent(executor))
-        return executor;
-    const provider = payload.providerId != null ? String(payload.providerId) : '';
-    if (provider && isFirstPartyFleetAgent(provider))
-        return provider;
-    const proposed = payload.proposedTo != null ? String(payload.proposedTo) : '';
-    if (proposed && isFirstPartyFleetAgent(proposed))
-        return proposed;
-    return null;
-}
-/** Apply fleet defaults with optional acting agent (falls back to payload inference). */
-export function applyFleetPricingForProtocol(operation, payload, actingAgentId) {
-    const actor = actingAgentId?.trim() || inferFleetPricingActorId(payload);
-    if (!actor) {
-        if (operation === 'agreement-propose') {
-            const specialist = (payload.providerId != null ? String(payload.providerId) : '') ||
-                (payload.proposedTo != null && isFirstPartyFleetAgent(String(payload.proposedTo))
-                    ? String(payload.proposedTo)
-                    : '');
-            if (specialist) {
-                const cents = resolveDefaultPriceCentsForExecutor(specialist, payload.description ?? payload.agreementDescription);
-                if (cents != null)
-                    return { ...payload, price: cents };
-            }
-        }
-        if (operation === 'agreement-subcontract' && payload.executorId) {
-            const cents = resolveDefaultPriceCentsForExecutor(String(payload.executorId), payload.description);
-            if (cents != null)
-                return { ...payload, price: cents };
-        }
-        return payload;
-    }
-    return applyFleetAgreementPricing(operation, payload, actor);
-}

package/dist/pricing/fleetEvalFree.d.ts

@@ -1,7 +0,0 @@
-/**
- * eval/harness free pricing via env flag (no SANDBOX id-shape regex).
- */
-/** Capability-probe + test harness agents (agents/test/). */
-export declare const EVAL_HARNESS_AGENT_IDS: Set<string>;
-export declare function isEvalFreePricingEnabled(): boolean;
-export declare function isEvalFreeExecutor(agentId: string): boolean;

package/dist/pricing/fleetEvalFree.js

@@ -1,23 +0,0 @@
-/**
- * eval/harness free pricing via env flag (no SANDBOX id-shape regex).
- */
-/** Capability-probe + test harness agents (agents/test/). */
-export const EVAL_HARNESS_AGENT_IDS = new Set([
-    'minimal-context-agent',
-    'forwarding-agent',
-    'failing-agent',
-    'principal-agent',
-    'capability-probe-agent',
-]);
-export function isEvalFreePricingEnabled() {
-    return process.env.FLEET_EVAL_FREE_PRICING === 'true';
-}
-export function isEvalFreeExecutor(agentId) {
-    if (!isEvalFreePricingEnabled() || !agentId)
-        return false;
-    if (agentId === 'eval-user')
-        return true;
-    if (agentId.endsWith('--eval'))
-        return true;
-    return EVAL_HARNESS_AGENT_IDS.has(agentId);
-}

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

@@ -1,7 +0,0 @@
-/**
- * AUTO-GENERATED by scripts/build-fleet-tier-map.mjs — do not edit by hand.
- * Local default pricing; the server resolves an agent's own pricing tier.
- */
-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 = 17;

package/dist/pricing/fleetTierByAgentId.gen.js

@@ -1,20 +0,0 @@
-export const FLEET_TIER_BY_AGENT_ID = {
-    "ziggs-agent": "C",
-    "ziggs-agent--eval": "C",
-    "coffee-agent": "D",
-    "coffee-agent--eval": "D",
-    "delivery-agent": "D",
-    "delivery-agent--eval": "D",
-    "expense-agent": "D",
-    "fruit-agent": "D",
-    "vendor-agent": "D",
-    "shopper-agent": "D",
-    "hire-agent": "B",
-    "ziggs-docs-agent": "B",
-    "agent-definer": "B",
-    "linear-janitor": "B",
-    "shipped-digest": "B",
-    "docs-reviewer": "B",
-    "email-agent": "B"
-};
-export const FLEET_TIER_MAP_SIZE = 17;