@chaoschain/sdk 0.3.0 → 0.3.1

package/dist/index.d.cts

@@ -1047,6 +1047,15 @@ declare class StudioClient {
  * const { workflow_id, data_hash } = await session.complete();
  * ```
  */
+/** Valid agent roles accepted by the gateway for session events. */
+type SessionAgentRole = 'worker' | 'verifier' | 'collaborator';
+/** Per-event agent override. */
+interface SessionAgentOverride {
+    /** Wallet address of the agent emitting this event. */
+    agent_address: string;
+    /** Agent role (defaults to `"worker"`). Must be `worker`, `verifier`, or `collaborator`. */
+    role?: SessionAgentRole;
+}
 /** Options for {@link Session.log}. */
 interface SessionLogOptions {
     /** Human-readable description of what happened. */
@@ -1055,6 +1064,8 @@ interface SessionLogOptions {
     event_type?: string;
     /** Arbitrary metadata attached to the event. */
     metadata?: Record<string, unknown>;
+    /** Override the session-level agent for this event. */
+    agent?: SessionAgentOverride;
 }
 /** Result returned by {@link Session.complete}. */
 interface SessionCompleteResult {
@@ -1110,7 +1121,7 @@ declare class Session {
      * @param stepType - Friendly step name.
      * @param summary - What happened in this step.
      */
-    step(stepType: string, summary: string): Promise<void>;
+    step(stepType: string, summary: string, agent?: SessionAgentOverride): Promise<void>;
     /**
      * Complete the session.
      *
@@ -2696,7 +2707,7 @@ declare class StudioManager {
  * @packageDocumentation
  */
 
-declare const SDK_VERSION = "0.3.0";
+declare const SDK_VERSION = "0.3.1";
 declare const ERC8004_VERSION = "1.0";
 declare const X402_VERSION = "1.0";
 
@@ -2733,4 +2744,4 @@ declare function initChaosChainSDK(config: {
     enableStorage?: boolean;
 }): ChaosChainSDK;
 
-export { A2AX402Extension, AgentMetadata, AgentRegistration, AgentRegistrationError, AgentRole, AutoStorageManager, CHAOS_CORE_ABI, ChaosAgent, ChaosChainSDK, ChaosChainSDKConfig, ChaosChainSDKError, ConfigurationError, ContractAddresses, ContractError, ERC8004_VERSION, FeedbackParams, GatewayClient, GatewayClientConfig, GatewayConnectionError, GatewayError, GatewayTimeoutError, GoogleAP2Integration, IDENTITY_REGISTRY_ABI, PinataStorage as IPFSPinataStorage, IntegrityProof, IntegrityVerificationError, IrysStorage, IrysStorage as IrysStorageProvider, LocalIPFSStorage, MandateManager, NetworkConfig, PaymentError, type PaymentHeader, PaymentManager, PaymentMethod, PendingWorkResponse, PinataStorage, REPUTATION_REGISTRY_ABI, REWARDS_DISTRIBUTOR_ABI, ValidationError as SDKValidationError, SDK_VERSION, STUDIO_FACTORY_ABI, STUDIO_PROXY_ABI, Session, SessionClient, type SessionClientConfig, type SessionCompleteResult, type SessionLogOptions, type SessionStartOptions, type SettleRequest, type SettleResponse, type StorageBackend, StorageError, type StorageResult, StudioClient, type StudioClientConfig, StudioManager, type StudioManagerConfig, type Task, type TransferAuthorizationParams, UploadOptions, UploadResult, VALIDATION_REGISTRY_ABI, WalletConfig, WalletManager, WorkEvidenceResponse, type WorkerBid, WorkflowError, WorkflowFailedError, WorkflowStatus, type X402FacilitatorConfig, X402PaymentManager, type X402PaymentProof, type X402PaymentRequest$1 as X402PaymentRequest, type X402PaymentRequirements, X402Server, X402_VERSION, ZeroGStorage, ChaosChainSDK as default, getContractAddresses, getNetworkInfo, initChaosChainSDK };
+export { A2AX402Extension, AgentMetadata, AgentRegistration, AgentRegistrationError, AgentRole, AutoStorageManager, CHAOS_CORE_ABI, ChaosAgent, ChaosChainSDK, ChaosChainSDKConfig, ChaosChainSDKError, ConfigurationError, ContractAddresses, ContractError, ERC8004_VERSION, FeedbackParams, GatewayClient, GatewayClientConfig, GatewayConnectionError, GatewayError, GatewayTimeoutError, GoogleAP2Integration, IDENTITY_REGISTRY_ABI, PinataStorage as IPFSPinataStorage, IntegrityProof, IntegrityVerificationError, IrysStorage, IrysStorage as IrysStorageProvider, LocalIPFSStorage, MandateManager, NetworkConfig, PaymentError, type PaymentHeader, PaymentManager, PaymentMethod, PendingWorkResponse, PinataStorage, REPUTATION_REGISTRY_ABI, REWARDS_DISTRIBUTOR_ABI, ValidationError as SDKValidationError, SDK_VERSION, STUDIO_FACTORY_ABI, STUDIO_PROXY_ABI, Session, type SessionAgentOverride, type SessionAgentRole, SessionClient, type SessionClientConfig, type SessionCompleteResult, type SessionLogOptions, type SessionStartOptions, type SettleRequest, type SettleResponse, type StorageBackend, StorageError, type StorageResult, StudioClient, type StudioClientConfig, StudioManager, type StudioManagerConfig, type Task, type TransferAuthorizationParams, UploadOptions, UploadResult, VALIDATION_REGISTRY_ABI, WalletConfig, WalletManager, WorkEvidenceResponse, type WorkerBid, WorkflowError, WorkflowFailedError, WorkflowStatus, type X402FacilitatorConfig, X402PaymentManager, type X402PaymentProof, type X402PaymentRequest$1 as X402PaymentRequest, type X402PaymentRequirements, X402Server, X402_VERSION, ZeroGStorage, ChaosChainSDK as default, getContractAddresses, getNetworkInfo, initChaosChainSDK };

package/dist/index.d.ts

@@ -1047,6 +1047,15 @@ declare class StudioClient {
  * const { workflow_id, data_hash } = await session.complete();
  * ```
  */
+/** Valid agent roles accepted by the gateway for session events. */
+type SessionAgentRole = 'worker' | 'verifier' | 'collaborator';
+/** Per-event agent override. */
+interface SessionAgentOverride {
+    /** Wallet address of the agent emitting this event. */
+    agent_address: string;
+    /** Agent role (defaults to `"worker"`). Must be `worker`, `verifier`, or `collaborator`. */
+    role?: SessionAgentRole;
+}
 /** Options for {@link Session.log}. */
 interface SessionLogOptions {
     /** Human-readable description of what happened. */
@@ -1055,6 +1064,8 @@ interface SessionLogOptions {
     event_type?: string;
     /** Arbitrary metadata attached to the event. */
     metadata?: Record<string, unknown>;
+    /** Override the session-level agent for this event. */
+    agent?: SessionAgentOverride;
 }
 /** Result returned by {@link Session.complete}. */
 interface SessionCompleteResult {
@@ -1110,7 +1121,7 @@ declare class Session {
      * @param stepType - Friendly step name.
      * @param summary - What happened in this step.
      */
-    step(stepType: string, summary: string): Promise<void>;
+    step(stepType: string, summary: string, agent?: SessionAgentOverride): Promise<void>;
     /**
      * Complete the session.
      *
@@ -2696,7 +2707,7 @@ declare class StudioManager {
  * @packageDocumentation
  */
 
-declare const SDK_VERSION = "0.3.0";
+declare const SDK_VERSION = "0.3.1";
 declare const ERC8004_VERSION = "1.0";
 declare const X402_VERSION = "1.0";
 
@@ -2733,4 +2744,4 @@ declare function initChaosChainSDK(config: {
     enableStorage?: boolean;
 }): ChaosChainSDK;
 
-export { A2AX402Extension, AgentMetadata, AgentRegistration, AgentRegistrationError, AgentRole, AutoStorageManager, CHAOS_CORE_ABI, ChaosAgent, ChaosChainSDK, ChaosChainSDKConfig, ChaosChainSDKError, ConfigurationError, ContractAddresses, ContractError, ERC8004_VERSION, FeedbackParams, GatewayClient, GatewayClientConfig, GatewayConnectionError, GatewayError, GatewayTimeoutError, GoogleAP2Integration, IDENTITY_REGISTRY_ABI, PinataStorage as IPFSPinataStorage, IntegrityProof, IntegrityVerificationError, IrysStorage, IrysStorage as IrysStorageProvider, LocalIPFSStorage, MandateManager, NetworkConfig, PaymentError, type PaymentHeader, PaymentManager, PaymentMethod, PendingWorkResponse, PinataStorage, REPUTATION_REGISTRY_ABI, REWARDS_DISTRIBUTOR_ABI, ValidationError as SDKValidationError, SDK_VERSION, STUDIO_FACTORY_ABI, STUDIO_PROXY_ABI, Session, SessionClient, type SessionClientConfig, type SessionCompleteResult, type SessionLogOptions, type SessionStartOptions, type SettleRequest, type SettleResponse, type StorageBackend, StorageError, type StorageResult, StudioClient, type StudioClientConfig, StudioManager, type StudioManagerConfig, type Task, type TransferAuthorizationParams, UploadOptions, UploadResult, VALIDATION_REGISTRY_ABI, WalletConfig, WalletManager, WorkEvidenceResponse, type WorkerBid, WorkflowError, WorkflowFailedError, WorkflowStatus, type X402FacilitatorConfig, X402PaymentManager, type X402PaymentProof, type X402PaymentRequest$1 as X402PaymentRequest, type X402PaymentRequirements, X402Server, X402_VERSION, ZeroGStorage, ChaosChainSDK as default, getContractAddresses, getNetworkInfo, initChaosChainSDK };
+export { A2AX402Extension, AgentMetadata, AgentRegistration, AgentRegistrationError, AgentRole, AutoStorageManager, CHAOS_CORE_ABI, ChaosAgent, ChaosChainSDK, ChaosChainSDKConfig, ChaosChainSDKError, ConfigurationError, ContractAddresses, ContractError, ERC8004_VERSION, FeedbackParams, GatewayClient, GatewayClientConfig, GatewayConnectionError, GatewayError, GatewayTimeoutError, GoogleAP2Integration, IDENTITY_REGISTRY_ABI, PinataStorage as IPFSPinataStorage, IntegrityProof, IntegrityVerificationError, IrysStorage, IrysStorage as IrysStorageProvider, LocalIPFSStorage, MandateManager, NetworkConfig, PaymentError, type PaymentHeader, PaymentManager, PaymentMethod, PendingWorkResponse, PinataStorage, REPUTATION_REGISTRY_ABI, REWARDS_DISTRIBUTOR_ABI, ValidationError as SDKValidationError, SDK_VERSION, STUDIO_FACTORY_ABI, STUDIO_PROXY_ABI, Session, type SessionAgentOverride, type SessionAgentRole, SessionClient, type SessionClientConfig, type SessionCompleteResult, type SessionLogOptions, type SessionStartOptions, type SettleRequest, type SettleResponse, type StorageBackend, StorageError, type StorageResult, StudioClient, type StudioClientConfig, StudioManager, type StudioManagerConfig, type Task, type TransferAuthorizationParams, UploadOptions, UploadResult, VALIDATION_REGISTRY_ABI, WalletConfig, WalletManager, WorkEvidenceResponse, type WorkerBid, WorkflowError, WorkflowFailedError, WorkflowStatus, type X402FacilitatorConfig, X402PaymentManager, type X402PaymentProof, type X402PaymentRequest$1 as X402PaymentRequest, type X402PaymentRequirements, X402Server, X402_VERSION, ZeroGStorage, ChaosChainSDK as default, getContractAddresses, getNetworkInfo, initChaosChainSDK };

package/dist/index.js

@@ -15414,7 +15414,10 @@ var Session = class {
       causality: {
         parent_event_ids: this.lastEventId ? [this.lastEventId] : []
       },
-      agent: { agent_address: this.agentAddress, role: "worker" },
+      agent: {
+        agent_address: opts.agent?.agent_address ?? this.agentAddress,
+        role: opts.agent?.role ?? "worker"
+      },
       studio: {
         studio_address: this.studioAddress,
         studio_policy_version: this.studioPolicyVersion
@@ -15444,9 +15447,9 @@ var Session = class {
    * @param stepType - Friendly step name.
    * @param summary - What happened in this step.
    */
-  async step(stepType, summary) {
+  async step(stepType, summary, agent) {
     const eventType = STEP_TYPE_MAP[stepType] ?? "artifact_created";
-    await this.log({ event_type: eventType, summary });
+    await this.log({ event_type: eventType, summary, agent });
   }
   /**
    * Complete the session.
@@ -16154,7 +16157,7 @@ var ChaosChainSDK = class _ChaosChainSDK {
    * Get SDK version
    */
   getVersion() {
-    return "0.3.0";
+    return "0.3.1";
   }
   /**
    * Get SDK capabilities summary
@@ -16952,7 +16955,7 @@ function verifyWorkEvidence(evidence, context) {
 }
 
 // src/index.ts
-var SDK_VERSION = "0.3.0";
+var SDK_VERSION = "0.3.1";
 var ERC8004_VERSION = "1.0";
 var X402_VERSION = "1.0";
 var src_default = ChaosChainSDK;