@ziggs-ai/agent-sdk 0.1.3 → 0.1.5

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;