@chaoschain/sdk 0.2.3 → 0.3.0

package/dist/index.js

@@ -4,7 +4,7 @@ import fs3__default from 'fs';
 import * as path3 from 'path';
 import path3__default from 'path';
 import * as crypto2 from 'crypto';
-import { createHash } from 'crypto';
+import { randomUUID, createHash } from 'crypto';
 import axios2 from 'axios';
 import * as http from 'http';
 import * as jose from 'jose';
@@ -12009,10 +12009,10 @@ var X402PaymentManager = class {
    */
   getTreasuryAddress(network) {
     const treasuries = {
-      "base-sepolia": "0x8004AA63c570c570eBF15376c0dB199918BFe9Fb",
-      "ethereum-sepolia": "0x8004a6090Cd10A7288092483047B097295Fb8847",
-      "optimism-sepolia": "0x8004a6090Cd10A7288092483047B097295Fb8847",
-      "linea-sepolia": "0x8004aa7C931bCE1233973a0C6A667f73F66282e7"
+      "base-sepolia": "0x20E7B2A2c8969725b88Dd3EF3a11Bc3353C83F70",
+      "ethereum-sepolia": "0x20E7B2A2c8969725b88Dd3EF3a11Bc3353C83F70",
+      "optimism-sepolia": "0x20E7B2A2c8969725b88Dd3EF3a11Bc3353C83F70",
+      "linea-sepolia": "0x20E7B2A2c8969725b88Dd3EF3a11Bc3353C83F70"
     };
     return treasuries[network] || treasuries["base-sepolia"];
   }
@@ -15365,10 +15365,189 @@ var StudioClient = class {
     return ethers.hexlify(ethers.randomBytes(32));
   }
 };
+var STEP_TYPE_MAP = {
+  planning: "plan_created",
+  testing: "test_run",
+  debugging: "debug_step",
+  implementing: "file_written",
+  completing: "submission_created"
+};
+var Session = class {
+  /** Session ID returned by the gateway. */
+  sessionId;
+  gatewayUrl;
+  apiKey;
+  studioAddress;
+  agentAddress;
+  studioPolicyVersion;
+  workMandateId;
+  taskType;
+  lastEventId;
+  /** @internal — use {@link SessionClient.start} to create instances. */
+  constructor(opts) {
+    this.sessionId = opts.sessionId;
+    this.gatewayUrl = opts.gatewayUrl;
+    this.apiKey = opts.apiKey;
+    this.lastEventId = opts.lastEventId ?? null;
+    this.studioAddress = opts.studioAddress;
+    this.agentAddress = opts.agentAddress;
+    this.studioPolicyVersion = opts.studioPolicyVersion;
+    this.workMandateId = opts.workMandateId;
+    this.taskType = opts.taskType;
+  }
+  /**
+   * Log a session event.
+   *
+   * Automatically generates `event_id`, `timestamp`, and chains `parent_event_ids`
+   * from the previous event so the gateway can build a causal DAG.
+   *
+   * @param opts - Event details. Only `summary` is required.
+   * @throws Error if the gateway returns a non-2xx status.
+   */
+  async log(opts) {
+    const eventId = randomUUID();
+    const event = {
+      event_id: eventId,
+      event_type: opts.event_type ?? "artifact_created",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      summary: opts.summary,
+      causality: {
+        parent_event_ids: this.lastEventId ? [this.lastEventId] : []
+      },
+      agent: { agent_address: this.agentAddress, role: "worker" },
+      studio: {
+        studio_address: this.studioAddress,
+        studio_policy_version: this.studioPolicyVersion
+      },
+      task: {
+        work_mandate_id: this.workMandateId,
+        task_type: this.taskType
+      },
+      ...opts.metadata ? { metadata: opts.metadata } : {}
+    };
+    await this.post(`/v1/sessions/${this.sessionId}/events`, [event]);
+    this.lastEventId = eventId;
+  }
+  /**
+   * Convenience wrapper around {@link log} that maps human-friendly step names
+   * to canonical event types.
+   *
+   * Mappings:
+   * - `"planning"` → `plan_created`
+   * - `"testing"` → `test_run`
+   * - `"debugging"` → `debug_step`
+   * - `"implementing"` → `file_written`
+   * - `"completing"` → `submission_created`
+   *
+   * Unknown step types fall back to `artifact_created`.
+   *
+   * @param stepType - Friendly step name.
+   * @param summary - What happened in this step.
+   */
+  async step(stepType, summary) {
+    const eventType = STEP_TYPE_MAP[stepType] ?? "artifact_created";
+    await this.log({ event_type: eventType, summary });
+  }
+  /**
+   * Complete the session.
+   *
+   * Triggers the on-chain WorkSubmission workflow (if the gateway is configured for it)
+   * and returns `workflow_id` + `data_hash` for downstream verification/scoring.
+   *
+   * @param opts - Optional status (`"completed"` | `"failed"`) and summary.
+   * @returns `{ workflow_id, data_hash }` — both may be `null` if the gateway
+   *          workflow engine is not configured.
+   * @throws Error if the gateway returns a non-2xx status.
+   */
+  async complete(opts) {
+    const body = {};
+    if (opts?.status) body.status = opts.status;
+    if (opts?.summary) body.summary = opts.summary;
+    const data = await this.post(`/v1/sessions/${this.sessionId}/complete`, body);
+    return {
+      workflow_id: data.data?.workflow_id ?? null,
+      data_hash: data.data?.data_hash ?? null
+    };
+  }
+  // ---------------------------------------------------------------------------
+  // Internal HTTP helper
+  // ---------------------------------------------------------------------------
+  async post(path4, body) {
+    const url = `${this.gatewayUrl}${path4}`;
+    const headers = { "Content-Type": "application/json" };
+    if (this.apiKey) headers["X-API-Key"] = this.apiKey;
+    try {
+      const res = await axios2({ method: "POST", url, data: body, headers, timeout: 3e4 });
+      return res.data;
+    } catch (err) {
+      const axiosErr = err;
+      const status = axiosErr.response?.status ?? 0;
+      const detail = JSON.stringify(axiosErr.response?.data ?? axiosErr.message);
+      throw new Error(`Session request failed: POST ${path4} \u2192 ${status} ${detail}`);
+    }
+  }
+};
+
+// src/session/SessionClient.ts
+var SessionClient = class {
+  gatewayUrl;
+  apiKey;
+  constructor(config = {}) {
+    this.gatewayUrl = (config.gatewayUrl ?? "https://gateway.chaoscha.in").replace(/\/$/, "");
+    this.apiKey = config.apiKey;
+  }
+  /**
+   * Create a new coding session on the gateway.
+   *
+   * Returns a {@link Session} instance that can be used to log events, run steps,
+   * and complete the session. The gateway persists all events and constructs the
+   * Evidence DAG automatically.
+   *
+   * @param opts - Session creation parameters.
+   * @returns A live {@link Session} bound to the newly created session ID.
+   * @throws Error if the gateway returns a non-2xx status.
+   */
+  async start(opts) {
+    const body = {
+      studio_address: opts.studio_address,
+      agent_address: opts.agent_address
+    };
+    if (opts.work_mandate_id) body.work_mandate_id = opts.work_mandate_id;
+    if (opts.task_type) body.task_type = opts.task_type;
+    if (opts.studio_policy_version) body.studio_policy_version = opts.studio_policy_version;
+    if (opts.session_id) body.session_id = opts.session_id;
+    const url = `${this.gatewayUrl}/v1/sessions`;
+    const headers = { "Content-Type": "application/json" };
+    if (this.apiKey) headers["X-API-Key"] = this.apiKey;
+    let data;
+    try {
+      const res = await axios2({ method: "POST", url, data: body, headers, timeout: 3e4 });
+      data = res.data;
+    } catch (err) {
+      const axiosErr = err;
+      const status = axiosErr.response?.status ?? 0;
+      const detail = JSON.stringify(axiosErr.response?.data ?? axiosErr.message);
+      throw new Error(`Failed to create session: POST /v1/sessions \u2192 ${status} ${detail}`);
+    }
+    const sessionId = data.data?.session_id;
+    if (!sessionId) {
+      throw new Error("Gateway response missing session_id");
+    }
+    return new Session({
+      sessionId,
+      gatewayUrl: this.gatewayUrl,
+      apiKey: this.apiKey,
+      studioAddress: opts.studio_address,
+      agentAddress: opts.agent_address,
+      studioPolicyVersion: opts.studio_policy_version ?? "engineering-studio-default-v1",
+      workMandateId: opts.work_mandate_id ?? "generic-task",
+      taskType: opts.task_type ?? "general"
+    });
+  }
+};
 
 // src/ChaosChainSDK.ts
 var ChaosChainSDK = class _ChaosChainSDK {
-  static warnedGatewayMissing = false;
   static warnedStudioClientProduction = false;
   // Core components
   walletManager;
@@ -15383,8 +15562,10 @@ var ChaosChainSDK = class _ChaosChainSDK {
   a2aX402Extension;
   processIntegrity;
   mandateManager;
-  // Gateway client for workflow submission (optional)
-  gateway = null;
+  // Gateway client for workflow submission (always initialized)
+  gateway;
+  /** Session client for Engineering Studio session management. */
+  session;
   // Studio client for direct on-chain operations
   studio;
   // Configuration
@@ -15546,41 +15727,25 @@ var ChaosChainSDK = class _ChaosChainSDK {
         this.computeProvider
       );
     }
-    if (config.gatewayConfig || config.gatewayUrl) {
-      const gatewayConfig = config.gatewayConfig || { gatewayUrl: config.gatewayUrl };
-      this.gateway = new GatewayClient(gatewayConfig);
-      console.log(
-        `\u{1F310} Gateway client initialized: ${gatewayConfig.baseUrl || gatewayConfig.gatewayUrl || "https://gateway.chaoscha.in"}`
-      );
-    }
+    const gatewayConfig = config.gatewayConfig ?? (config.gatewayUrl ? { gatewayUrl: config.gatewayUrl } : {});
+    this.gateway = new GatewayClient(gatewayConfig);
+    const gatewayBaseUrl = gatewayConfig.baseUrl ?? gatewayConfig.gatewayUrl ?? "https://gateway.chaoscha.in";
+    this.session = new SessionClient({
+      gatewayUrl: gatewayBaseUrl,
+      apiKey: gatewayConfig.auth?.apiKey
+    });
     this.studio = new StudioClient({
       provider: this.provider,
       signer: this.walletManager.getWallet(),
       network: typeof config.network === "string" ? config.network : config.network
     });
     const isLocalNetwork = String(config.network) === "local" /* LOCAL */ || String(config.network) === "local";
-    if (!this.gateway && !isLocalNetwork && !_ChaosChainSDK.warnedGatewayMissing) {
-      console.warn(
-        "\u26A0\uFE0F Gateway is not configured. For production workflows, use gatewayConfig to enable Gateway orchestration."
-      );
-      _ChaosChainSDK.warnedGatewayMissing = true;
-    }
     if (process.env.NODE_ENV === "production" && !isLocalNetwork && !_ChaosChainSDK.warnedStudioClientProduction) {
       console.warn(
         "\u26A0\uFE0F StudioClient is intended for low-level or testing use. In production, prefer Gateway workflows."
       );
       _ChaosChainSDK.warnedStudioClientProduction = true;
     }
-    console.log(`\u{1F680} ChaosChain SDK initialized for ${this.agentName}`);
-    console.log(`   Network: ${this.network}`);
-    console.log(`   Wallet: ${this.walletManager.getAddress()}`);
-    console.log(`   Features:`);
-    console.log(`     - ERC-8004: \u2705`);
-    console.log(`     - x402 Payments: ${this.x402PaymentManager ? "\u2705" : "\u274C"}`);
-    console.log(`     - Multi-Payment: ${this.paymentManager ? "\u2705" : "\u274C"}`);
-    console.log(`     - Google AP2: ${this.googleAP2 ? "\u2705" : "\u274C"}`);
-    console.log(`     - Process Integrity: ${this.processIntegrity ? "\u2705" : "\u274C"}`);
-    console.log(`     - Storage: \u2705`);
   }
   // ============================================================================
   // ERC-8004 Identity Methods
@@ -15989,7 +16154,7 @@ var ChaosChainSDK = class _ChaosChainSDK {
    * Get SDK version
    */
   getVersion() {
-    return "0.2.3";
+    return "0.3.0";
   }
   /**
    * Get SDK capabilities summary
@@ -16019,9 +16184,11 @@ var ChaosChainSDK = class _ChaosChainSDK {
   }
   /**
    * Check if Gateway is configured.
+   * Always returns true in v0.3.0+. Gateway is always initialized pointing to
+   * https://gateway.chaoscha.in unless overridden via gatewayConfig.
    */
   isGatewayEnabled() {
-    return this.gateway !== null;
+    return true;
   }
   /**
    * Get Gateway client instance.
@@ -16444,24 +16611,51 @@ function resolveScoring(policy, mandate) {
 }
 function computeObserved(evidence) {
   const totalNodes = evidence.length;
+  const byId = /* @__PURE__ */ new Map();
   const childrenOf = /* @__PURE__ */ new Map();
   for (const e of evidence) {
+    byId.set(e.arweave_tx_id, e);
     childrenOf.set(e.arweave_tx_id, []);
   }
   let edgeCount = 0;
   let rootCount = 0;
-  let integrationNodeCount = 0;
   let artifactCount = 0;
   for (const e of evidence) {
     edgeCount += e.parent_ids.length;
     if (e.parent_ids.length === 0) rootCount++;
-    if (e.parent_ids.length > 1) integrationNodeCount++;
     if (e.artifact_ids.length > 0) artifactCount++;
     for (const pid of e.parent_ids) {
       const c = childrenOf.get(pid);
       if (c) c.push(e.arweave_tx_id);
     }
   }
+  const rootOrigins = /* @__PURE__ */ new Map();
+  function getRootOrigins(id) {
+    if (rootOrigins.has(id)) return rootOrigins.get(id);
+    const node = byId.get(id);
+    if (!node || node.parent_ids.length === 0) {
+      const s = /* @__PURE__ */ new Set([id]);
+      rootOrigins.set(id, s);
+      return s;
+    }
+    const origins = /* @__PURE__ */ new Set();
+    for (const pid of node.parent_ids) {
+      for (const r of getRootOrigins(pid)) origins.add(r);
+    }
+    rootOrigins.set(id, origins);
+    return origins;
+  }
+  for (const e of evidence) getRootOrigins(e.arweave_tx_id);
+  let integrationNodeCount = 0;
+  for (const e of evidence) {
+    if (e.parent_ids.length < 2) continue;
+    const parentRootSets = e.parent_ids.filter((pid) => byId.has(pid)).map((pid) => rootOrigins.get(pid));
+    const uniqueRoots = /* @__PURE__ */ new Set();
+    for (const s of parentRootSets) {
+      for (const r of s) uniqueRoots.add(r);
+    }
+    if (uniqueRoots.size >= 2) integrationNodeCount++;
+  }
   let terminalCount = 0;
   for (const [, children] of childrenOf) {
     if (children.length === 0) terminalCount++;
@@ -16594,12 +16788,13 @@ function extractAgencySignals(evidence, context) {
     durationMs: observed.durationMs
   };
   if (!scoring) {
-    initiativeSignal = Math.max(0, Math.min(1, rootRatio));
-    collaborationSignal = Math.max(0, Math.min(1, edgeDensity));
-    reasoningSignal = Math.max(0, Math.min(1, depthRatio));
+    const SOFT_CAP = 0.9;
+    initiativeSignal = Math.max(0, Math.min(SOFT_CAP, rootRatio));
+    collaborationSignal = Math.max(0, Math.min(SOFT_CAP, edgeDensity));
+    reasoningSignal = Math.max(0, Math.min(SOFT_CAP, depthRatio));
   } else {
     const ir = scoring.initiative.rootRatio;
-    initiativeSignal = rangeFit(rootRatio, ir.min, ir.target, ir.max);
+    const initiativeBase = rangeFit(rootRatio, ir.min, ir.target, ir.max);
     const cw = scoring.collaboration.weights;
     const ed = scoring.collaboration.edgeDensity;
     const intR = scoring.collaboration.integrationRatio;
@@ -16611,7 +16806,13 @@ function extractAgencySignals(evidence, context) {
     }
     collaborationSignal = Math.max(0, Math.min(1, collaborationSignal));
     const dr = scoring.reasoning.depthRatio;
-    reasoningSignal = rangeFit(depthRatio, dr.min, dr.target, dr.max);
+    const reasoningBase = rangeFit(depthRatio, dr.min, dr.target, dr.max);
+    const fragmentationPenalty = rootRatio > ir.max ? (rootRatio - ir.max) * 0.5 : 0;
+    const overcomplexityPenalty = depthRatio > dr.max ? (depthRatio - dr.max) * 0.5 : 0;
+    initiativeSignal = Math.max(0, Math.min(1, initiativeBase - fragmentationPenalty));
+    reasoningSignal = Math.max(0, Math.min(1, reasoningBase - overcomplexityPenalty));
+    observedBlock.fragmentationPenalty = fragmentationPenalty;
+    observedBlock.overcomplexityPenalty = overcomplexityPenalty;
     const compResult = computeComplianceSignal(evidence, observed, scoring, context?.workMandate);
     complianceSignal = compResult.signal;
     observedBlock.testsPresent = compResult.testsPresent;
@@ -16660,17 +16861,32 @@ function normalizeInput(value) {
   return Math.max(0, Math.min(1, v));
 }
 var CLAMP_100 = (v) => Math.max(0, Math.min(100, Math.round(v)));
+function resolveDimension(override, signal) {
+  if (override !== void 0) return normalizeInput(override);
+  return signal ?? 0;
+}
 function composeScoreVector(signals, assessment) {
-  const resolve = (override, signal) => {
-    if (override !== void 0) return normalizeInput(override);
-    return signal ?? 0;
-  };
+  if (assessment.complianceScore === void 0 || assessment.complianceScore === null) {
+    throw new Error("complianceScore is required for production scoring");
+  }
+  if (assessment.efficiencyScore === void 0 || assessment.efficiencyScore === null) {
+    throw new Error("efficiencyScore is required for production scoring");
+  }
+  return [
+    CLAMP_100(resolveDimension(assessment.initiativeScore, signals.initiativeSignal) * 100),
+    CLAMP_100(resolveDimension(assessment.collaborationScore, signals.collaborationSignal) * 100),
+    CLAMP_100(resolveDimension(assessment.reasoningScore, signals.reasoningSignal) * 100),
+    CLAMP_100(normalizeInput(assessment.complianceScore) * 100),
+    CLAMP_100(normalizeInput(assessment.efficiencyScore) * 100)
+  ];
+}
+function composeScoreVectorWithDefaults(signals, assessment) {
   return [
-    CLAMP_100(resolve(assessment?.initiativeScore, signals.initiativeSignal) * 100),
-    CLAMP_100(resolve(assessment?.collaborationScore, signals.collaborationSignal) * 100),
-    CLAMP_100(resolve(assessment?.reasoningScore, signals.reasoningSignal) * 100),
-    CLAMP_100(resolve(assessment?.complianceScore, signals.complianceSignal) * 100),
-    CLAMP_100(resolve(assessment?.efficiencyScore, signals.efficiencySignal) * 100)
+    CLAMP_100(resolveDimension(assessment?.initiativeScore, signals.initiativeSignal) * 100),
+    CLAMP_100(resolveDimension(assessment?.collaborationScore, signals.collaborationSignal) * 100),
+    CLAMP_100(resolveDimension(assessment?.reasoningScore, signals.reasoningSignal) * 100),
+    CLAMP_100(resolveDimension(assessment?.complianceScore, signals.complianceSignal) * 100),
+    CLAMP_100(resolveDimension(assessment?.efficiencyScore, signals.efficiencySignal) * 100)
   ];
 }
 function derivePoAScores(evidence, options) {
@@ -16684,7 +16900,7 @@ function derivePoAScores(evidence, options) {
     ];
   }
   const signals = extractAgencySignals(evidence);
-  return composeScoreVector(signals, {
+  return composeScoreVectorWithDefaults(signals, {
     complianceScore: options?.compliance,
     efficiencyScore: options?.efficiency
   });
@@ -16736,7 +16952,7 @@ function verifyWorkEvidence(evidence, context) {
 }
 
 // src/index.ts
-var SDK_VERSION = "0.2.3";
+var SDK_VERSION = "0.3.0";
 var ERC8004_VERSION = "1.0";
 var X402_VERSION = "1.0";
 var src_default = ChaosChainSDK;
@@ -16762,6 +16978,6 @@ mime-types/index.js:
    *)
 */
 
-export { A2AX402Extension, AgentRegistrationError, AgentRole, AutoStorageManager, CHAOS_CORE_ABI, ChaosAgent, ChaosChainSDK, ChaosChainSDKError, ConfigurationError, ContractError, ERC8004_VERSION, GatewayClient, GatewayConnectionError, GatewayError, GatewayTimeoutError, GoogleAP2Integration, IDENTITY_REGISTRY_ABI, IPFSLocalStorage, PinataStorage as IPFSPinataStorage, IntegrityVerificationError, IrysStorage, IrysStorage as IrysStorageProvider, LocalIPFSStorage, MandateManager, NetworkConfig, PaymentError, PaymentManager, PaymentMethod, PinataStorage, REPUTATION_REGISTRY_ABI, REWARDS_DISTRIBUTOR_ABI, ValidationError as SDKValidationError, SDK_VERSION, STUDIO_FACTORY_ABI, STUDIO_PROXY_ABI, StorageError, StudioClient, StudioManager, VALIDATION_REGISTRY_ABI, ValidationStatus, WalletManager, WorkflowFailedError, WorkflowState, WorkflowType, X402PaymentManager, X402Server, X402_VERSION, ZeroGStorage, composeScoreVector, computeDepth, src_default as default, derivePoAScores, extractAgencySignals, getContractAddresses2 as getContractAddresses, getNetworkInfo, initChaosChainSDK, rangeFit, validateEvidenceGraph, verifyWorkEvidence };
+export { A2AX402Extension, AgentRegistrationError, AgentRole, AutoStorageManager, CHAOS_CORE_ABI, ChaosAgent, ChaosChainSDK, ChaosChainSDKError, ConfigurationError, ContractError, ERC8004_VERSION, GatewayClient, GatewayConnectionError, GatewayError, GatewayTimeoutError, GoogleAP2Integration, IDENTITY_REGISTRY_ABI, IPFSLocalStorage, PinataStorage as IPFSPinataStorage, IntegrityVerificationError, IrysStorage, IrysStorage as IrysStorageProvider, LocalIPFSStorage, MandateManager, NetworkConfig, PaymentError, PaymentManager, PaymentMethod, PinataStorage, REPUTATION_REGISTRY_ABI, REWARDS_DISTRIBUTOR_ABI, ValidationError as SDKValidationError, SDK_VERSION, STUDIO_FACTORY_ABI, STUDIO_PROXY_ABI, Session, SessionClient, StorageError, StudioClient, StudioManager, VALIDATION_REGISTRY_ABI, ValidationStatus, WalletManager, WorkflowFailedError, WorkflowState, WorkflowType, X402PaymentManager, X402Server, X402_VERSION, ZeroGStorage, composeScoreVector, composeScoreVectorWithDefaults, computeDepth, src_default as default, derivePoAScores, extractAgencySignals, getContractAddresses2 as getContractAddresses, getNetworkInfo, initChaosChainSDK, rangeFit, validateEvidenceGraph, verifyWorkEvidence };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map