@chaoschain/sdk 0.2.4 → 0.3.1

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';
@@ -15365,6 +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: opts.agent?.agent_address ?? this.agentAddress,
+        role: opts.agent?.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, agent) {
+    const eventType = STEP_TYPE_MAP[stepType] ?? "artifact_created";
+    await this.log({ event_type: eventType, summary, agent });
+  }
+  /**
+   * 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 {
@@ -15382,8 +15565,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
@@ -15548,7 +15733,10 @@ var ChaosChainSDK = class _ChaosChainSDK {
     const gatewayConfig = config.gatewayConfig ?? (config.gatewayUrl ? { gatewayUrl: config.gatewayUrl } : {});
     this.gateway = new GatewayClient(gatewayConfig);
     const gatewayBaseUrl = gatewayConfig.baseUrl ?? gatewayConfig.gatewayUrl ?? "https://gateway.chaoscha.in";
-    console.log(`\u{1F310} Gateway client initialized: ${gatewayBaseUrl}`);
+    this.session = new SessionClient({
+      gatewayUrl: gatewayBaseUrl,
+      apiKey: gatewayConfig.auth?.apiKey
+    });
     this.studio = new StudioClient({
       provider: this.provider,
       signer: this.walletManager.getWallet(),
@@ -15561,16 +15749,6 @@ var ChaosChainSDK = class _ChaosChainSDK {
       );
       _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
@@ -15979,7 +16157,7 @@ var ChaosChainSDK = class _ChaosChainSDK {
    * Get SDK version
    */
   getVersion() {
-    return "0.2.4";
+    return "0.3.1";
   }
   /**
    * Get SDK capabilities summary
@@ -16009,9 +16187,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.
@@ -16775,7 +16955,7 @@ function verifyWorkEvidence(evidence, context) {
 }
 
 // src/index.ts
-var SDK_VERSION = "0.2.4";
+var SDK_VERSION = "0.3.1";
 var ERC8004_VERSION = "1.0";
 var X402_VERSION = "1.0";
 var src_default = ChaosChainSDK;
@@ -16801,6 +16981,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, composeScoreVectorWithDefaults, 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