@ziggs-ai/agent-sdk 0.1.4 → 0.1.6

package/src/ingress/normalizeIncoming.ts

@@ -1,4 +1,11 @@
-import { OPEN_AGREEMENT_TARGET } from '../tasks/taskCore.js';
+import { OPEN_AGREEMENT_TARGET } from '@ziggs-ai/api-client';
+
+/** Backend wire operations that map to FSM `proposal-resolved`. */
+const PROPOSAL_RESOLVED_OPERATIONS = new Set([
+  'proposal_approved',
+  'proposal_rejected',
+  'proposal_approved_execute',
+]);
 
 export interface NormalizedEvent {
   chatId: string | null;
@@ -7,7 +14,9 @@ export interface NormalizedEvent {
     senderType?: string;
     receiverId?: string;
     timestamp: number;
-    type: 'task_result' | 'message';
+    type: 'task_result' | 'message' | 'agreement_lifecycle';
+    operation?: string;
+    agreementId?: string;
     result?: unknown;
     text?: string;
   };
@@ -16,10 +25,10 @@ export interface NormalizedEvent {
 }
 
 interface WireParties {
-  creatorId?: string;
-  providerId?: string;
-  payerId?: string;
-  proposedToId?: string;
+  creator?: string;
+  provider?: string;
+  payer?: string;
+  proposedTo?: string;
 }
 
 interface WireTask {
@@ -42,6 +51,8 @@ interface WireMetadata {
   content_type?: string;
   contentType?: string;
   receiverId?: string;
+  operation?: string;
+  agreementId?: string;
   sender?: { id?: string; type?: string };
   receiver?: { id?: string };
   to?: { id?: string };
@@ -79,6 +90,16 @@ function isRelevantForAgent(ids: (string | null | undefined)[], ownAgentId: stri
   return ids.includes(ownAgentId) || ids.includes(OPEN_AGREEMENT_TARGET);
 }
 
+function isAgreementLifecycleNotification(metadata: WireMetadata): boolean {
+  const entryType = metadata.entryType || 'message';
+  const operation = metadata.operation;
+  return (
+    entryType === 'notification' &&
+    typeof operation === 'string' &&
+    PROPOSAL_RESOLVED_OPERATIONS.has(operation)
+  );
+}
+
 export function normalizeIncomingEvent({ text, metadata = {}, ownAgentId = null }: NormalizeArgs): NormalizedEvent {
   const taskData = metadata.task || null;
   const chatId = normalizeChatId(metadata);
@@ -92,11 +113,33 @@ export function normalizeIncomingEvent({ text, metadata = {}, ownAgentId = null
     timestamp: Date.now(),
   };
 
+  if (isAgreementLifecycleNotification(metadata)) {
+    const relevant =
+      !ownAgentId ||
+      !receiverId ||
+      receiverId === ownAgentId ||
+      receiverId === OPEN_AGREEMENT_TARGET;
+    const agreementId =
+      typeof metadata.agreementId === 'string' ? metadata.agreementId : '';
+    return {
+      chatId,
+      event: {
+        ...base,
+        type: 'agreement_lifecycle',
+        operation: metadata.operation,
+        agreementId,
+        text,
+      },
+      shouldProcess: relevant,
+      reason: relevant ? null : 'message_not_targeted_to_agent',
+    };
+  }
+
   if (isTaskRelated(metadata, taskData)) {
     const receiverFromMeta = metadata.receiver?.id || metadata.receiverId || null;
     const parties = taskData!.agreement?.parties ?? {};
     const candidateIds = [
-      parties.creatorId, parties.providerId, parties.payerId, parties.proposedToId,
+      parties.creator, parties.provider, parties.payer, parties.proposedTo,
       taskData!.agentId, taskData!.executorId, taskData!.payerId, taskData!.proposedTo, taskData!.createdBy,
       receiverFromMeta,
     ].filter(Boolean);

package/src/pricing/fleetDefaults.ts

@@ -0,0 +1,218 @@
+/**
+ * ZIG-368 — default paid pricing for Ziggs-operated (first-party) agents.
+ * Prices are in wallet cents (1 ZIG = 100 cents).
+ */
+import { FLEET_TIER_BY_AGENT_ID, type FleetPricingTier } 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: Record<FleetPricingTier, number> = {
+  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 (simulated)
+};
+
+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: string): FleetPricingTier | null {
+  if (!agentId || typeof agentId !== 'string') return null;
+  return FLEET_TIER_BY_AGENT_ID[agentId] ?? null;
+}
+
+export function isFirstPartyFleetAgent(agentId: string): boolean {
+  return resolveFleetTier(agentId) != null;
+}
+
+export function tierPriceCents(tier: FleetPricingTier): number {
+  return TIER_PRICE_CENTS[tier];
+}
+
+export function isZiggsOrchestrator(agentId: string): boolean {
+  return ZIGGS_ORCHESTRATOR_IDS.has(agentId);
+}
+
+export function isFreeAllowlistedExecutor(
+  executorId: string,
+  description?: string | null,
+): boolean {
+  if (!executorId) return false;
+  if (isEvalFreeExecutor(executorId)) return true;
+  if (FREE_TIER_A_AGENT_IDS.has(executorId)) return true;
+  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: string,
+  description?: string | null,
+): number | null {
+  if (isFreeAllowlistedExecutor(executorId, description)) return 0;
+  const tier = resolveFleetTier(executorId);
+  if (!tier) return null;
+  return tierPriceCents(tier);
+}
+
+export interface ProtocolPricingPayload {
+  price?: number | null;
+  description?: string;
+  agreementDescription?: string;
+  proposedTo?: string;
+  providerId?: string;
+  executorId?: string;
+  parentAgreementId?: string;
+  parentTaskId?: string;
+  [key: string]: unknown;
+}
+
+/**
+ * Apply ZIG-368 defaults when `price` is omitted (null/undefined).
+ * Explicit `price: 0` is kept (free-on-purpose).
+ */
+export function applyFleetAgreementPricing(
+  operation: 'agreement-propose' | 'agreement-subcontract',
+  payload: ProtocolPricingPayload,
+  actingAgentId: string,
+): ProtocolPricingPayload {
+  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) : '';
+
+  // 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).
+  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`. */
+export function applyFleetCounterPricing(
+  payload: ProtocolPricingPayload,
+  actingAgentId: string,
+): ProtocolPricingPayload {
+  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 };
+}
+
+/** User or agent direct-create / marketplace: default from provider specialist. */
+export function resolveDefaultPriceForProvider(
+  providerId: string,
+  description?: string | null,
+  explicitPrice?: number | null,
+): number | null {
+  if (typeof explicitPrice === 'number') return explicitPrice;
+  return resolveDefaultPriceCentsForExecutor(providerId, description);
+}
+
+/**
+ * Infer fleet actor when tool context omits agentId (ZIG-368 safety net).
+ */
+export function inferFleetPricingActorId(payload: ProtocolPricingPayload): string | null {
+  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: 'agreement-propose' | 'agreement-subcontract',
+  payload: ProtocolPricingPayload,
+  actingAgentId: string | null,
+): ProtocolPricingPayload {
+  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 as string | undefined),
+        );
+        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/src/pricing/fleetEvalFree.ts

@@ -0,0 +1,24 @@
+/**
+ * ZIG-395 — 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',
+  'messaging-only-agent',
+  'principal-agent',
+  'capability-probe-agent',
+]);
+
+export function isEvalFreePricingEnabled(): boolean {
+  return process.env.FLEET_EVAL_FREE_PRICING === 'true';
+}
+
+export function isEvalFreeExecutor(agentId: string): boolean {
+  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/src/pricing/fleetFreeTierA.gen.ts

@@ -0,0 +1,12 @@
+/**
+ * AUTO-GENERATED by scripts/build-fleet-tier-map.mjs — do not edit by hand.
+ * ZIG-368: Tier A trivial public lookups (free when price omitted).
+ */
+export const FREE_TIER_A_AGENT_IDS = new Set<string>([
+  "site-health-checker",
+  "timezone-expert",
+  "uv-index-advisor",
+  "weather-forecaster"
+]);
+
+export const FREE_TIER_A_COUNT = 4;