@chaoschain/sdk 0.3.2 → 0.3.3

package/dist/index.d.cts

@@ -2323,7 +2323,7 @@ declare class StudioManager {
  * @packageDocumentation
  */
 
-declare const SDK_VERSION = "0.3.2";
+declare const SDK_VERSION = "0.3.3";
 declare const ERC8004_VERSION = "1.0";
 declare const X402_VERSION = "1.0";
 

package/dist/index.d.ts

@@ -2323,7 +2323,7 @@ declare class StudioManager {
  * @packageDocumentation
  */
 
-declare const SDK_VERSION = "0.3.2";
+declare const SDK_VERSION = "0.3.3";
 declare const ERC8004_VERSION = "1.0";
 declare const X402_VERSION = "1.0";
 

package/dist/index.js

@@ -15375,10 +15375,16 @@ var STEP_TYPE_MAP = {
 var Session = class {
   /** Session ID returned by the gateway. */
   sessionId;
-  gatewayUrl;
-  apiKey;
+  /** Epoch number returned by the gateway. */
+  epoch;
+  /** Studio contract address for this session. */
   studioAddress;
+  /** Default agent wallet address for this session. */
   agentAddress;
+  /** URL to view this session's Evidence DAG in the browser. */
+  viewerUrl;
+  gatewayUrl;
+  apiKey;
   studioPolicyVersion;
   workMandateId;
   taskType;
@@ -15386,6 +15392,8 @@ var Session = class {
   /** @internal — use {@link SessionClient.start} to create instances. */
   constructor(opts) {
     this.sessionId = opts.sessionId;
+    this.epoch = opts.epoch;
+    this.viewerUrl = `${opts.gatewayUrl}/v1/sessions/${opts.sessionId}/viewer`;
     this.gatewayUrl = opts.gatewayUrl;
     this.apiKey = opts.apiKey;
     this.lastEventId = opts.lastEventId ?? null;
@@ -15401,7 +15409,12 @@ var Session = class {
    * 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.
+   * @param opts.summary - Human-readable description of what happened (required).
+   * @param opts.event_type - Canonical event type (default: `"artifact_created"`).
+   * @param opts.metadata - Arbitrary key-value metadata attached to the event.
+   * @param opts.agent - Override the session-level agent for this event.
+   *   Pass `{ agent_address, role? }` to emit the event from a different agent.
+   *   Valid roles: `"worker"`, `"verifier"`, `"collaborator"`. Defaults to `"worker"`.
    * @throws Error if the gateway returns a non-2xx status.
    */
   async log(opts) {
@@ -15444,8 +15457,9 @@ var Session = class {
    *
    * Unknown step types fall back to `artifact_created`.
    *
-   * @param stepType - Friendly step name.
+   * @param stepType - Friendly step name (`"planning"`, `"implementing"`, `"testing"`, `"debugging"`, `"completing"`).
    * @param summary - What happened in this step.
+   * @param agent - Optional agent override for this event. Same as `log({ agent })`.
    */
   async step(stepType, summary, agent) {
     const eventType = STEP_TYPE_MAP[stepType] ?? "artifact_created";
@@ -15455,11 +15469,13 @@ var Session = class {
    * 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.
+   * and returns the session result.
    *
-   * @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.
+   * @param opts.status - `"completed"` or `"failed"` (default: `"completed"`).
+   * @param opts.summary - Human-readable summary of the session outcome.
+   * @returns `{ workflow_id, data_hash, epoch }` — `workflow_id` and `data_hash`
+   *          may be `null` if the gateway workflow engine is not configured.
+   *          `epoch` is the epoch this session belongs to.
    * @throws Error if the gateway returns a non-2xx status.
    */
   async complete(opts) {
@@ -15469,7 +15485,8 @@ var Session = class {
     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
+      data_hash: data.data?.data_hash ?? null,
+      epoch: data.data.epoch
     };
   }
   // ---------------------------------------------------------------------------
@@ -15506,8 +15523,16 @@ var SessionClient = class {
    * 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.
+   * The returned session exposes `session.sessionId`, `session.epoch`,
+   * `session.studioAddress`, and `session.agentAddress`.
+   *
+   * @param opts.studio_address - Studio contract address (required).
+   * @param opts.agent_address - Worker agent wallet address (required).
+   * @param opts.task_type - Task classification: `"feature"`, `"bugfix"`, `"refactor"`, etc. (default: `"general"`).
+   * @param opts.work_mandate_id - Work mandate identifier (default: `"generic-task"`).
+   * @param opts.studio_policy_version - Studio policy version (default: `"engineering-studio-default-v1"`).
+   * @param opts.session_id - Client-provided session ID. Server generates one if omitted.
+   * @returns A live {@link Session} bound to the newly created session ID and epoch.
    * @throws Error if the gateway returns a non-2xx status.
    */
   async start(opts) {
@@ -15544,7 +15569,8 @@ var SessionClient = class {
       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"
+      taskType: opts.task_type ?? "general",
+      epoch: data.data.epoch
     });
   }
 };
@@ -16157,7 +16183,7 @@ var ChaosChainSDK = class _ChaosChainSDK {
    * Get SDK version
    */
   getVersion() {
-    return "0.3.2";
+    return "0.3.3";
   }
   /**
    * Get SDK capabilities summary
@@ -16955,7 +16981,7 @@ function verifyWorkEvidence(evidence, context) {
 }
 
 // src/index.ts
-var SDK_VERSION = "0.3.2";
+var SDK_VERSION = "0.3.3";
 var ERC8004_VERSION = "1.0";
 var X402_VERSION = "1.0";
 var src_default = ChaosChainSDK;