@chaoschain/sdk 0.2.4 → 0.3.1

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { N as NetworkConfig, I as IntegrityProof, W as WalletConfig, a as NetworkInfo, C as ContractAddresses, G as GatewayClientConfig, b as GatewayHealthResponse, c as WorkflowStatus, S as ScoreSubmissionMode, P as PendingWorkResponse, d as WorkEvidenceResponse, A as AgentRole, e as ChaosChainSDKConfig, f as AgentMetadata, g as AgentRegistration, F as FeedbackParams, h as PaymentMethod, U as UploadOptions, i as UploadResult, j as WorkflowError } from './types-DZze-Z8B.cjs';
-export { O as AgencySignals, o as ComputeProvider, D as DKGNodeData, R as DemoAssessment, Z as EngineeringStudioPolicy, K as EvidencePackage, k as FeedbackRecord, u as PendingWorkItem, Y as ScoreRange, $ as SignalExtractionContext, n as StorageProvider, T as TEEAttestation, p as TransactionResult, l as ValidationRequest, V as ValidationRequestParams, q as ValidationStatus, Q as VerifierAssessment, L as WorkEvidenceVerificationResult, _ as WorkMandate, M as WorkVerificationResult, t as WorkflowProgress, s as WorkflowState, r as WorkflowType, m as X402Payment, X as X402PaymentParams, v as XMTPMessageData, E as composeScoreVector, H as composeScoreVectorWithDefaults, w as computeDepth, x as derivePoAScores, B as extractAgencySignals, J as rangeFit, y as validateEvidenceGraph, z as verifyWorkEvidence } from './types-DZze-Z8B.cjs';
+import { N as NetworkConfig, I as IntegrityProof, W as WalletConfig, a as NetworkInfo, C as ContractAddresses, G as GatewayClientConfig, b as GatewayHealthResponse, c as WorkflowStatus, S as ScoreSubmissionMode, P as PendingWorkResponse, d as WorkEvidenceResponse, A as AgentRole, e as ChaosChainSDKConfig, f as AgentMetadata, g as AgentRegistration, F as FeedbackParams, h as PaymentMethod, U as UploadOptions, i as UploadResult, j as WorkflowError } from './types-BBVtx_jV.cjs';
+export { O as AgencySignals, o as ComputeProvider, D as DKGNodeData, R as DemoAssessment, Z as EngineeringStudioPolicy, K as EvidencePackage, k as FeedbackRecord, u as PendingWorkItem, Y as ScoreRange, $ as SignalExtractionContext, n as StorageProvider, T as TEEAttestation, p as TransactionResult, l as ValidationRequest, V as ValidationRequestParams, q as ValidationStatus, Q as VerifierAssessment, L as WorkEvidenceVerificationResult, _ as WorkMandate, M as WorkVerificationResult, t as WorkflowProgress, s as WorkflowState, r as WorkflowType, m as X402Payment, X as X402PaymentParams, v as XMTPMessageData, E as composeScoreVector, H as composeScoreVectorWithDefaults, w as computeDepth, x as derivePoAScores, B as extractAgencySignals, J as rangeFit, y as validateEvidenceGraph, z as verifyWorkEvidence } from './types-BBVtx_jV.cjs';
 import { ethers } from 'ethers';
-export { I as IPFSLocalStorage } from './IPFSLocal-azjjaiGR.cjs';
+export { I as IPFSLocalStorage } from './IPFSLocal-zRj6kG8e.cjs';
 
 /**
  * X402 Payment Manager for ChaosChain SDK
@@ -1032,6 +1032,174 @@ declare class StudioClient {
     generateSalt(): string;
 }
 
+/**
+ * Session — high-level wrapper for ChaosChain Engineering Studio sessions.
+ *
+ * Agents use this class to log work events without constructing raw event schemas,
+ * managing parent IDs, or thinking about DAGs. The gateway handles all of that.
+ *
+ * @example
+ * ```ts
+ * const session = await client.start({ studio_address: '0x...', agent_address: '0x...' });
+ * await session.log({ summary: 'Planning cache layer implementation' });
+ * await session.step('implementing', 'Added CacheService class');
+ * await session.step('testing', 'All 47 tests pass');
+ * 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. */
+    summary: string;
+    /** Canonical event type. Defaults to `"artifact_created"`. */
+    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 {
+    workflow_id: string | null;
+    data_hash: string | null;
+}
+declare class Session {
+    /** Session ID returned by the gateway. */
+    readonly sessionId: string;
+    private readonly gatewayUrl;
+    private readonly apiKey;
+    private readonly studioAddress;
+    private readonly agentAddress;
+    private readonly studioPolicyVersion;
+    private readonly workMandateId;
+    private readonly taskType;
+    private lastEventId;
+    /** @internal — use {@link SessionClient.start} to create instances. */
+    constructor(opts: {
+        sessionId: string;
+        gatewayUrl: string;
+        apiKey?: string;
+        lastEventId?: string | null;
+        studioAddress: string;
+        agentAddress: string;
+        studioPolicyVersion: string;
+        workMandateId: string;
+        taskType: string;
+    });
+    /**
+     * 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.
+     */
+    log(opts: SessionLogOptions): Promise<void>;
+    /**
+     * 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.
+     */
+    step(stepType: string, summary: string, agent?: SessionAgentOverride): Promise<void>;
+    /**
+     * 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.
+     */
+    complete(opts?: {
+        status?: 'completed' | 'failed';
+        summary?: string;
+    }): Promise<SessionCompleteResult>;
+    private post;
+}
+
+/**
+ * SessionClient — factory for creating ChaosChain Engineering Studio sessions.
+ *
+ * @example
+ * ```ts
+ * import { SessionClient } from '@chaoschain/sdk';
+ *
+ * const client = new SessionClient({ gatewayUrl: 'https://gateway.chaoscha.in', apiKey: 'cc_...' });
+ * const session = await client.start({
+ *   studio_address: '0xFA0795fD5D7F58eCAa7Eae35Ad9cB8AED9424Dd0',
+ *   agent_address: '0x9B4Cef62a0ce1671ccFEFA6a6D8cBFa165c49831',
+ *   task_type: 'feature',
+ * });
+ *
+ * await session.log({ summary: 'Started implementing cache layer' });
+ * await session.step('testing', 'All tests pass');
+ * const result = await session.complete();
+ * ```
+ */
+
+/** Configuration for {@link SessionClient}. */
+interface SessionClientConfig {
+    /** Gateway base URL (default: `"https://gateway.chaoscha.in"`). */
+    gatewayUrl?: string;
+    /** API key sent as `X-API-Key` header. */
+    apiKey?: string;
+}
+/** Options for {@link SessionClient.start}. */
+interface SessionStartOptions {
+    /** Studio contract address (required). */
+    studio_address: string;
+    /** Worker agent wallet address (required). */
+    agent_address: string;
+    /** Work mandate ID (default: `"generic-task"`). */
+    work_mandate_id?: string;
+    /** Task classification (default: `"general"`). */
+    task_type?: string;
+    /** Studio policy version (default: `"engineering-studio-default-v1"`). */
+    studio_policy_version?: string;
+    /** Client-provided session ID. Server generates one if omitted. */
+    session_id?: string;
+}
+declare class SessionClient {
+    private readonly gatewayUrl;
+    private readonly apiKey;
+    constructor(config?: SessionClientConfig);
+    /**
+     * 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.
+     */
+    start(opts: SessionStartOptions): Promise<Session>;
+}
+
 /**
  * Main ChaosChain SDK Class - Complete TypeScript implementation
  *
@@ -1059,7 +1227,9 @@ declare class ChaosChainSDK {
     a2aX402Extension?: A2AX402Extension;
     processIntegrity?: ProcessIntegrity;
     mandateManager?: MandateManager;
-    gateway: GatewayClient | null;
+    gateway: GatewayClient;
+    /** Session client for Engineering Studio session management. */
+    session: SessionClient;
     studio: StudioClient;
     readonly agentName: string;
     readonly agentDomain: string;
@@ -1273,6 +1443,8 @@ declare class ChaosChainSDK {
     getCapabilities(): Record<string, any>;
     /**
      * 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(): boolean;
     /**
@@ -2535,7 +2707,7 @@ declare class StudioManager {
  * @packageDocumentation
  */
 
-declare const SDK_VERSION = "0.2.4";
+declare const SDK_VERSION = "0.3.1";
 declare const ERC8004_VERSION = "1.0";
 declare const X402_VERSION = "1.0";
 
@@ -2572,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, 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

@@ -1,7 +1,7 @@
-import { N as NetworkConfig, I as IntegrityProof, W as WalletConfig, a as NetworkInfo, C as ContractAddresses, G as GatewayClientConfig, b as GatewayHealthResponse, c as WorkflowStatus, S as ScoreSubmissionMode, P as PendingWorkResponse, d as WorkEvidenceResponse, A as AgentRole, e as ChaosChainSDKConfig, f as AgentMetadata, g as AgentRegistration, F as FeedbackParams, h as PaymentMethod, U as UploadOptions, i as UploadResult, j as WorkflowError } from './types-DZze-Z8B.js';
-export { O as AgencySignals, o as ComputeProvider, D as DKGNodeData, R as DemoAssessment, Z as EngineeringStudioPolicy, K as EvidencePackage, k as FeedbackRecord, u as PendingWorkItem, Y as ScoreRange, $ as SignalExtractionContext, n as StorageProvider, T as TEEAttestation, p as TransactionResult, l as ValidationRequest, V as ValidationRequestParams, q as ValidationStatus, Q as VerifierAssessment, L as WorkEvidenceVerificationResult, _ as WorkMandate, M as WorkVerificationResult, t as WorkflowProgress, s as WorkflowState, r as WorkflowType, m as X402Payment, X as X402PaymentParams, v as XMTPMessageData, E as composeScoreVector, H as composeScoreVectorWithDefaults, w as computeDepth, x as derivePoAScores, B as extractAgencySignals, J as rangeFit, y as validateEvidenceGraph, z as verifyWorkEvidence } from './types-DZze-Z8B.js';
+import { N as NetworkConfig, I as IntegrityProof, W as WalletConfig, a as NetworkInfo, C as ContractAddresses, G as GatewayClientConfig, b as GatewayHealthResponse, c as WorkflowStatus, S as ScoreSubmissionMode, P as PendingWorkResponse, d as WorkEvidenceResponse, A as AgentRole, e as ChaosChainSDKConfig, f as AgentMetadata, g as AgentRegistration, F as FeedbackParams, h as PaymentMethod, U as UploadOptions, i as UploadResult, j as WorkflowError } from './types-BBVtx_jV.js';
+export { O as AgencySignals, o as ComputeProvider, D as DKGNodeData, R as DemoAssessment, Z as EngineeringStudioPolicy, K as EvidencePackage, k as FeedbackRecord, u as PendingWorkItem, Y as ScoreRange, $ as SignalExtractionContext, n as StorageProvider, T as TEEAttestation, p as TransactionResult, l as ValidationRequest, V as ValidationRequestParams, q as ValidationStatus, Q as VerifierAssessment, L as WorkEvidenceVerificationResult, _ as WorkMandate, M as WorkVerificationResult, t as WorkflowProgress, s as WorkflowState, r as WorkflowType, m as X402Payment, X as X402PaymentParams, v as XMTPMessageData, E as composeScoreVector, H as composeScoreVectorWithDefaults, w as computeDepth, x as derivePoAScores, B as extractAgencySignals, J as rangeFit, y as validateEvidenceGraph, z as verifyWorkEvidence } from './types-BBVtx_jV.js';
 import { ethers } from 'ethers';
-export { I as IPFSLocalStorage } from './IPFSLocal-BqyHRp_l.js';
+export { I as IPFSLocalStorage } from './IPFSLocal-B4hnMEfS.js';
 
 /**
  * X402 Payment Manager for ChaosChain SDK
@@ -1032,6 +1032,174 @@ declare class StudioClient {
     generateSalt(): string;
 }
 
+/**
+ * Session — high-level wrapper for ChaosChain Engineering Studio sessions.
+ *
+ * Agents use this class to log work events without constructing raw event schemas,
+ * managing parent IDs, or thinking about DAGs. The gateway handles all of that.
+ *
+ * @example
+ * ```ts
+ * const session = await client.start({ studio_address: '0x...', agent_address: '0x...' });
+ * await session.log({ summary: 'Planning cache layer implementation' });
+ * await session.step('implementing', 'Added CacheService class');
+ * await session.step('testing', 'All 47 tests pass');
+ * 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. */
+    summary: string;
+    /** Canonical event type. Defaults to `"artifact_created"`. */
+    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 {
+    workflow_id: string | null;
+    data_hash: string | null;
+}
+declare class Session {
+    /** Session ID returned by the gateway. */
+    readonly sessionId: string;
+    private readonly gatewayUrl;
+    private readonly apiKey;
+    private readonly studioAddress;
+    private readonly agentAddress;
+    private readonly studioPolicyVersion;
+    private readonly workMandateId;
+    private readonly taskType;
+    private lastEventId;
+    /** @internal — use {@link SessionClient.start} to create instances. */
+    constructor(opts: {
+        sessionId: string;
+        gatewayUrl: string;
+        apiKey?: string;
+        lastEventId?: string | null;
+        studioAddress: string;
+        agentAddress: string;
+        studioPolicyVersion: string;
+        workMandateId: string;
+        taskType: string;
+    });
+    /**
+     * 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.
+     */
+    log(opts: SessionLogOptions): Promise<void>;
+    /**
+     * 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.
+     */
+    step(stepType: string, summary: string, agent?: SessionAgentOverride): Promise<void>;
+    /**
+     * 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.
+     */
+    complete(opts?: {
+        status?: 'completed' | 'failed';
+        summary?: string;
+    }): Promise<SessionCompleteResult>;
+    private post;
+}
+
+/**
+ * SessionClient — factory for creating ChaosChain Engineering Studio sessions.
+ *
+ * @example
+ * ```ts
+ * import { SessionClient } from '@chaoschain/sdk';
+ *
+ * const client = new SessionClient({ gatewayUrl: 'https://gateway.chaoscha.in', apiKey: 'cc_...' });
+ * const session = await client.start({
+ *   studio_address: '0xFA0795fD5D7F58eCAa7Eae35Ad9cB8AED9424Dd0',
+ *   agent_address: '0x9B4Cef62a0ce1671ccFEFA6a6D8cBFa165c49831',
+ *   task_type: 'feature',
+ * });
+ *
+ * await session.log({ summary: 'Started implementing cache layer' });
+ * await session.step('testing', 'All tests pass');
+ * const result = await session.complete();
+ * ```
+ */
+
+/** Configuration for {@link SessionClient}. */
+interface SessionClientConfig {
+    /** Gateway base URL (default: `"https://gateway.chaoscha.in"`). */
+    gatewayUrl?: string;
+    /** API key sent as `X-API-Key` header. */
+    apiKey?: string;
+}
+/** Options for {@link SessionClient.start}. */
+interface SessionStartOptions {
+    /** Studio contract address (required). */
+    studio_address: string;
+    /** Worker agent wallet address (required). */
+    agent_address: string;
+    /** Work mandate ID (default: `"generic-task"`). */
+    work_mandate_id?: string;
+    /** Task classification (default: `"general"`). */
+    task_type?: string;
+    /** Studio policy version (default: `"engineering-studio-default-v1"`). */
+    studio_policy_version?: string;
+    /** Client-provided session ID. Server generates one if omitted. */
+    session_id?: string;
+}
+declare class SessionClient {
+    private readonly gatewayUrl;
+    private readonly apiKey;
+    constructor(config?: SessionClientConfig);
+    /**
+     * 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.
+     */
+    start(opts: SessionStartOptions): Promise<Session>;
+}
+
 /**
  * Main ChaosChain SDK Class - Complete TypeScript implementation
  *
@@ -1059,7 +1227,9 @@ declare class ChaosChainSDK {
     a2aX402Extension?: A2AX402Extension;
     processIntegrity?: ProcessIntegrity;
     mandateManager?: MandateManager;
-    gateway: GatewayClient | null;
+    gateway: GatewayClient;
+    /** Session client for Engineering Studio session management. */
+    session: SessionClient;
     studio: StudioClient;
     readonly agentName: string;
     readonly agentDomain: string;
@@ -1273,6 +1443,8 @@ declare class ChaosChainSDK {
     getCapabilities(): Record<string, any>;
     /**
      * 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(): boolean;
     /**
@@ -2535,7 +2707,7 @@ declare class StudioManager {
  * @packageDocumentation
  */
 
-declare const SDK_VERSION = "0.2.4";
+declare const SDK_VERSION = "0.3.1";
 declare const ERC8004_VERSION = "1.0";
 declare const X402_VERSION = "1.0";
 
@@ -2572,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, 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 };