@amigo-ai/platform-sdk 0.100.0 → 0.101.0

package/api.md

@@ -118,6 +118,18 @@ All workspace-scoped resources also expose `withOptions(options)`.
 - `get`
 - `harnessContext`
 
+### `runs`
+
+- `list`
+- `summary`
+- `get`
+- `trajectory`
+- `sendGuidance`
+- `takeOver`
+- `handBack`
+- `switchMode`
+- `accessToken`
+
 ### `agentDefinitions`
 
 - `list`

package/dist/index.cjs

@@ -1395,6 +1395,109 @@ var AgentRunsResource = class extends WorkspaceScopedResource {
   }
 };
 
+// src/resources/runs.ts
+var RunsResource = class extends WorkspaceScopedResource {
+  /**
+   * Paginated, newest-first list of runs. `kind` / `channel` / `status` are
+   * multi-value OR-filters (repeat within an axis, AND across axes); `status`
+   * accepts the virtual `live` (running + paused). `continuationToken` is the
+   * opaque cursor from a prior page — round-trip it verbatim.
+   */
+  async list(params) {
+    return extractData(
+      await this.client.GET("/v1/{workspace_id}/runs", {
+        params: {
+          path: { workspace_id: this.workspaceId },
+          query: {
+            limit: params?.limit,
+            continuation_token: params?.continuationToken,
+            kind: params?.kind,
+            channel: params?.channel,
+            status: params?.status,
+            sort_by: params?.sortBy
+          }
+        }
+      })
+    );
+  }
+  /** Aggregate run counts (total / live / by-status / by-kind). */
+  async summary(params) {
+    return extractData(
+      await this.client.GET("/v1/{workspace_id}/runs/summary", {
+        params: {
+          path: { workspace_id: this.workspaceId },
+          query: { kind: params?.kind, channel: params?.channel }
+        }
+      })
+    );
+  }
+  /** Resolve one run by its channel-neutral `run_id`, at any status. */
+  async get(runId) {
+    return extractData(
+      await this.client.GET("/v1/{workspace_id}/runs/{run_id}", {
+        params: { path: { workspace_id: this.workspaceId, run_id: runId } }
+      })
+    );
+  }
+  /**
+   * The ordered structural steps of a FRAMEWORK run's trajectory (perception /
+   * decision / tool / completion). 409 for conversation runs (they have per-turn
+   * detail via the conversation surface).
+   */
+  async trajectory(runId) {
+    return extractData(
+      await this.client.GET("/v1/{workspace_id}/runs/{run_id}/trajectory", {
+        params: { path: { workspace_id: this.workspaceId, run_id: runId } }
+      })
+    );
+  }
+  /** Send operator guidance to a LIVE run (the agent folds it into its next turn). */
+  async sendGuidance(runId, body) {
+    return extractData(
+      await this.client.POST("/v1/{workspace_id}/runs/{run_id}/guidance", {
+        params: { path: { workspace_id: this.workspaceId, run_id: runId } },
+        body
+      })
+    );
+  }
+  /** Take a live run over (operator drives). Returns the audio-leg coordinates for voice. */
+  async takeOver(runId, body) {
+    return extractData(
+      await this.client.POST("/v1/{workspace_id}/runs/{run_id}/takeover", {
+        params: { path: { workspace_id: this.workspaceId, run_id: runId } },
+        body
+      })
+    );
+  }
+  /** Hand a taken-over run back to the agent. */
+  async handBack(runId, body) {
+    return extractData(
+      await this.client.POST("/v1/{workspace_id}/runs/{run_id}/handback", {
+        params: { path: { workspace_id: this.workspaceId, run_id: runId } },
+        body
+      })
+    );
+  }
+  /** Switch the operator's mode on a live run (listen ↔ takeover). */
+  async switchMode(runId, body) {
+    return extractData(
+      await this.client.POST("/v1/{workspace_id}/runs/{run_id}/switch-mode", {
+        params: { path: { workspace_id: this.workspaceId, run_id: runId } },
+        body
+      })
+    );
+  }
+  /** Mint a run-scoped browser access token (voice takeover audio leg). */
+  async accessToken(runId, body) {
+    return extractData(
+      await this.client.POST("/v1/{workspace_id}/runs/{run_id}/access-token", {
+        params: { path: { workspace_id: this.workspaceId, run_id: runId } },
+        body
+      })
+    );
+  }
+};
+
 // src/resources/agent-definitions.ts
 var AgentDefinitionsResource = class extends WorkspaceScopedResource {
   async list(params) {
@@ -6219,6 +6322,7 @@ var AmigoClient = class _AmigoClient {
   tokens;
   agents;
   agentRuns;
+  runs;
   agentDefinitions;
   /** @deprecated Use `actions` instead */
   skills;
@@ -6360,6 +6464,7 @@ var AmigoClient = class _AmigoClient {
     mutable.tokens = new TokensResource(client, workspaceId2);
     mutable.agents = new AgentsResource(client, workspaceId2);
     mutable.agentRuns = new AgentRunsResource(client, workspaceId2);
+    mutable.runs = new RunsResource(client, workspaceId2);
     mutable.agentDefinitions = new AgentDefinitionsResource(client, workspaceId2);
     mutable.skills = new SkillsResource(client, workspaceId2);
     mutable.actions = new ActionsResource(client, workspaceId2);