@amigo-ai/platform-sdk 0.87.0 → 0.89.0

package/api.md

@@ -112,6 +112,22 @@ All workspace-scoped resources also expose `withOptions(options)`.
 - `getVersion`
 - `createVersion`
 
+### `agentRuns`
+
+- `create`
+- `get`
+- `harnessContext`
+
+### `agentDefinitions`
+
+- `list`
+- `listAutoPaging`
+- `register`
+- `validate`
+- `get`
+- `getVersion`
+- `archive`
+
 ### `skills`
 
 - `create`

package/dist/index.cjs

@@ -1353,6 +1353,116 @@ var AgentsResource = class extends WorkspaceScopedResource {
   }
 };
 
+// src/resources/agent-runs.ts
+var AgentRunsResource = class extends WorkspaceScopedResource {
+  /**
+   * Launch a framework agent run — a platform run (`service_id` + `framework`)
+   * or a native run (`native`). Non-blocking; returns a running `run_id`, poll
+   * {@link get}.
+   */
+  async create(body) {
+    return extractData(
+      await this.client.POST("/v1/{workspace_id}/agent-runs", {
+        params: { path: { workspace_id: this.workspaceId } },
+        body
+      })
+    );
+  }
+  /** Fetch a run snapshot: status, final text, trajectory, and token usage. */
+  async get(runId) {
+    return extractData(
+      await this.client.GET("/v1/{workspace_id}/agent-runs/{run_id}", {
+        params: { path: { workspace_id: this.workspaceId, run_id: runId } }
+      })
+    );
+  }
+  /**
+   * The CONTEXT edge — the retrievable, framework-neutral session bootstrap a
+   * service hands an agent: identity/instructions, world scope, tool
+   * descriptors, guardrails, the real enforced write-floor, and runtime. This
+   * is the exact context a remote framework would fetch before a run.
+   */
+  async harnessContext(params) {
+    return extractData(
+      await this.client.GET("/v1/{workspace_id}/agent-runs/harness-context", {
+        params: {
+          path: { workspace_id: this.workspaceId },
+          // camelCase args → snake_case wire query (service_id / version_set).
+          query: { service_id: params.serviceId, version_set: params.versionSet }
+        }
+      })
+    );
+  }
+};
+
+// src/resources/agent-definitions.ts
+var AgentDefinitionsResource = class extends WorkspaceScopedResource {
+  async list(params) {
+    return extractData(
+      await this.client.GET("/v1/{workspace_id}/agent-definitions", {
+        params: { path: { workspace_id: this.workspaceId }, query: params }
+      })
+    );
+  }
+  listAutoPaging(params) {
+    return this.iteratePaginatedList((pageParams) => this.list(pageParams), params);
+  }
+  /**
+   * Register (idempotent push) a native definition. An identical body re-push
+   * reports `created: false`; a changed body mints a new version.
+   */
+  async register(body) {
+    return extractData(
+      await this.client.POST("/v1/{workspace_id}/agent-definitions", {
+        params: { path: { workspace_id: this.workspaceId } },
+        body
+      })
+    );
+  }
+  /** Dry-run clamp validation — nothing is stored; 422 with the offending paths on failure. */
+  async validate(body) {
+    return extractData(
+      await this.client.POST("/v1/{workspace_id}/agent-definitions/validate", {
+        params: { path: { workspace_id: this.workspaceId } },
+        body
+      })
+    );
+  }
+  async get(definitionId) {
+    return extractData(
+      await this.client.GET("/v1/{workspace_id}/agent-definitions/{definition_id}", {
+        params: {
+          path: { workspace_id: this.workspaceId, definition_id: definitionId }
+        }
+      })
+    );
+  }
+  /** Fetch a specific immutable version, including its clamped body. */
+  async getVersion(definitionId, version) {
+    return extractData(
+      await this.client.GET(
+        "/v1/{workspace_id}/agent-definitions/{definition_id}/versions/{version}",
+        {
+          params: {
+            path: {
+              workspace_id: this.workspaceId,
+              definition_id: definitionId,
+              version
+            }
+          }
+        }
+      )
+    );
+  }
+  async archive(definitionId) {
+    await this.client.DELETE("/v1/{workspace_id}/agent-definitions/{definition_id}", {
+      params: {
+        path: { workspace_id: this.workspaceId, definition_id: definitionId }
+      }
+    });
+  }
+};
+
 // src/resources/skills.ts
 var SkillsResource = class extends WorkspaceScopedResource {
   /** Create a new skill */
@@ -6176,6 +6286,8 @@ var AmigoClient = class _AmigoClient {
   apiKeys;
   tokens;
   agents;
+  agentRuns;
+  agentDefinitions;
   /** @deprecated Use `actions` instead */
   skills;
   actions;
@@ -6316,6 +6428,8 @@ var AmigoClient = class _AmigoClient {
     mutable.apiKeys = new ApiKeysResource(client, workspaceId2);
     mutable.tokens = new TokensResource(client, workspaceId2);
     mutable.agents = new AgentsResource(client, workspaceId2);
+    mutable.agentRuns = new AgentRunsResource(client, workspaceId2);
+    mutable.agentDefinitions = new AgentDefinitionsResource(client, workspaceId2);
     mutable.skills = new SkillsResource(client, workspaceId2);
     mutable.actions = new ActionsResource(client, workspaceId2);
     mutable.operators = new OperatorsResource(client, workspaceId2);