@amigo-ai/platform-sdk 0.86.0 → 0.88.0

package/dist/resources/agent-definitions.js

@@ -0,0 +1,61 @@
+import { WorkspaceScopedResource, extractData } from './base.js';
+/**
+ * Native (bring-your-own) agent definition registry — the frameworks layer's
+ * registry for native framework agents (OpenAI SDK / Anthropic SDK) that run
+ * against the platform world-model tools. Register is an idempotent push: a new
+ * content hash mints a new immutable, clamp-validated version.
+ */
+export class AgentDefinitionsResource 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 },
+            },
+        });
+    }
+}
+//# sourceMappingURL=agent-definitions.js.map

package/dist/resources/agent-definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-definitions.js","sourceRoot":"","sources":["../../src/resources/agent-definitions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAahE;;;;;GAKG;AACH,MAAM,OAAO,wBAAyB,SAAQ,uBAAuB;IACnE,KAAK,CAAC,IAAI,CAAC,MAAmC;QAC5C,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,sCAAsC,EAAE;YAC5D,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;SACpE,CAAC,CACH,CAAA;IACH,CAAC;IAED,cAAc,CAAC,MAAmC;QAChD,OAAO,IAAI,CAAC,oBAAoB,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAA;IACjF,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ,CAAC,IAA6D;QAC1E,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sCAAsC,EAAE;YAC7D,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE;YACpD,IAAI;SACL,CAAC,CACH,CAAA;IACH,CAAC;IAED,6FAA6F;IAC7F,KAAK,CAAC,QAAQ,CAAC,IAA6D;QAC1E,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,+CAA+C,EAAE;YACtE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE;YACpD,IAAI;SACL,CAAC,CACH,CAAA;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,YAAoB;QAC5B,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,sDAAsD,EAAE;YAC5E,MAAM,EAAE;gBACN,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE;aACtE;SACF,CAAC,CACH,CAAA;IACH,CAAC;IAED,sEAAsE;IACtE,KAAK,CAAC,UAAU,CAAC,YAAoB,EAAE,OAAe;QACpD,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CACnB,yEAAyE,EACzE;YACE,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ,YAAY,EAAE,IAAI,CAAC,WAAW;oBAC9B,aAAa,EAAE,YAAY;oBAC3B,OAAO;iBACR;aACF;SACF,CACF,CACF,CAAA;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,YAAoB;QAChC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,sDAAsD,EAAE;YAC/E,MAAM,EAAE;gBACN,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE;aACtE;SACF,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/resources/agent-runs.js

@@ -0,0 +1,46 @@
+import { WorkspaceScopedResource, extractData } from './base.js';
+/**
+ * Framework agent runs — the RUN + CONTEXT edges of the framework-agnostic
+ * world-model harness.
+ *
+ * Launch a message through a framework harness (OpenAI SDK / Anthropic SDK)
+ * bound to a service + version set, or a native run from a registered/inline
+ * definition; poll it to a terminal status; and fetch the retrievable harness
+ * context a run is handed. A run executes the chosen framework unmodified
+ * against the platform MCP world-tools edge.
+ */
+export class AgentRunsResource 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 },
+            },
+        }));
+    }
+}
+//# sourceMappingURL=agent-runs.js.map

package/dist/resources/agent-runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runs.js","sourceRoot":"","sources":["../../src/resources/agent-runs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAEhE;;;;;;;;;GASG;AACH,MAAM,OAAO,iBAAkB,SAAQ,uBAAuB;IAC5D;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,IAAoD;QAC/D,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE;YACtD,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE;YACpD,IAAI;SACL,CAAC,CACH,CAAA;IACH,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,GAAG,CAAC,KAAa;QACrB,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,wCAAwC,EAAE;YAC9D,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE;SACpE,CAAC,CACH,CAAA;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAAC,MAAkD;QACrE,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,+CAA+C,EAAE;YACrE,MAAM,EAAE;gBACN,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE;gBACxC,qEAAqE;gBACrE,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,UAAU,EAAE;aACxE;SACF,CAAC,CACH,CAAA;IACH,CAAC;CACF"}

package/dist/types/generated/api.d.ts

@@ -807,6 +807,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/{workspace_id}/agent-runs/harness-context": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Fetch the neutral session-bootstrap context for a service
+         * @description The retrievable CONTEXT edge of the world-model harness: identity + reference instructions, world scope, tool descriptors, guardrails, and the REAL server-enforced write-floor — the byte-identical projection the hosted runner renders from, so a customer's own framework can bootstrap a session against the same world model. PHI-free (the API-run projection carries no scoped entities or rendered caller prose).
+         */
+        get: operations["get_harness_context_v1__workspace_id__agent_runs_harness_context_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/{workspace_id}/agent-runs/{run_id}": {
         parameters: {
             query?: never;
@@ -8237,7 +8257,7 @@ export interface components {
              * Framework
              * @enum {string}
              */
-            framework: "claude-agent-sdk" | "openai-agents" | "crewai";
+            framework: "claude-agent-sdk" | "openai-agents";
             /** Name */
             name: string;
             /**
@@ -8268,7 +8288,7 @@ export interface components {
              * Framework
              * @enum {string}
              */
-            framework: "claude-agent-sdk" | "openai-agents" | "crewai";
+            framework: "claude-agent-sdk" | "openai-agents";
             /** Name */
             name: string;
             /**
@@ -8296,7 +8316,7 @@ export interface components {
              * Framework
              * @enum {string}
              */
-            framework: "claude-agent-sdk" | "openai-agents" | "crewai";
+            framework: "claude-agent-sdk" | "openai-agents";
             /** Has Write Tools */
             has_write_tools: boolean;
             /** Validator Rev */
@@ -8317,6 +8337,46 @@ export interface components {
             /** Version */
             version: number;
         };
+        /**
+         * AgentIdentity
+         * @description Who the agent IS — platform-authored only; ``None`` for native runs
+         *     (a customer's own definition carries its own identity). Named
+         *     ``AgentIdentity`` (not ``Identity``) to avoid colliding with the existing
+         *     ``config.models.Identity`` OpenAPI schema (a same-name collision would
+         *     force-rename that shipped schema — a breaking spec change).
+         */
+        AgentIdentity: {
+            /**
+             * Developed By
+             * @default
+             */
+            developed_by?: string;
+            /**
+             * Entry Actor Name
+             * @default
+             */
+            entry_actor_name?: string;
+            /**
+             * Initial State
+             * @default
+             */
+            initial_state?: string;
+            /**
+             * Instructions
+             * @default
+             */
+            instructions?: string;
+            /**
+             * Name
+             * @default
+             */
+            name?: string;
+            /**
+             * Role
+             * @default
+             */
+            role?: string;
+        };
         /** AgentResponse */
         AgentResponse: {
             /**
@@ -16017,6 +16077,26 @@ export interface components {
             /** Name */
             name: string;
         };
+        /** Guardrails */
+        Guardrails: {
+            /**
+             * Global Action Guidelines
+             * @default []
+             */
+            global_action_guidelines?: string[];
+            /**
+             * Global Boundary Constraints
+             * @default []
+             */
+            global_boundary_constraints?: string[];
+            /**
+             * Guardrails
+             * @default []
+             */
+            guardrails?: {
+                [key: string]: unknown;
+            }[];
+        };
         /** HTTPValidationError */
         HTTPValidationError: {
             /** Detail */
@@ -16059,6 +16139,33 @@ export interface components {
             /** Regulatory Basis */
             regulatory_basis: string;
         };
+        /**
+         * HarnessContext
+         * @description The neutral, retrievable session-bootstrap context for ANY framework.
+         */
+        HarnessContext: {
+            /**
+             * Config Fingerprint
+             * @default
+             */
+            config_fingerprint?: string;
+            /**
+             * Context Version
+             * @default 1
+             */
+            context_version?: number;
+            guardrails: components["schemas"]["Guardrails"];
+            identity?: components["schemas"]["AgentIdentity"] | null;
+            runtime: components["schemas"]["Runtime"];
+            /**
+             * Source
+             * @default
+             */
+            source?: string;
+            tools: components["schemas"]["Tools"];
+            world_scope: components["schemas"]["WorldScope"];
+            write_floor: components["schemas"]["WriteFloor"];
+        };
         /** HealFieldRequest */
         HealFieldRequest: {
             /** Context */
@@ -20394,7 +20501,7 @@ export interface components {
              * Framework
              * @enum {string}
              */
-            framework: "claude-agent-sdk" | "openai-agents" | "crewai";
+            framework: "claude-agent-sdk" | "openai-agents";
             /** Has Write Tools */
             has_write_tools: boolean;
             /** Version */
@@ -21114,6 +21221,29 @@ export interface components {
             /** Tags */
             tags?: string[];
         };
+        /** Runtime */
+        Runtime: {
+            /**
+             * Caller Context
+             * @default
+             */
+            caller_context?: string;
+            /**
+             * Channel Kind
+             * @default
+             */
+            channel_kind?: string;
+            /**
+             * Engage Model
+             * @default
+             */
+            engage_model?: string;
+            /**
+             * Language
+             * @default
+             */
+            language?: string;
+        };
         /** SafetyState */
         SafetyState: {
             /**
@@ -24965,6 +25095,23 @@ export interface components {
              */
             type: "tool_call_started";
         };
+        /** ToolDescriptor */
+        ToolDescriptor: {
+            /**
+             * Description
+             * @default
+             */
+            description?: string;
+            /**
+             * Input Schema
+             * @default {}
+             */
+            input_schema?: {
+                [key: string]: unknown;
+            };
+            /** Name */
+            name: string;
+        };
         /** ToolExecuteRequest */
         ToolExecuteRequest: {
             /**
@@ -25089,6 +25236,28 @@ export interface components {
              */
             total_calls?: number;
         };
+        /**
+         * Tools
+         * @description Discovery hint — the neutral descriptors. NOT the enforcement (the MCP
+         *     edge is; a remote agent discovers live schemas from the server too).
+         */
+        Tools: {
+            /**
+             * Descriptors
+             * @default []
+             */
+            descriptors?: components["schemas"]["ToolDescriptor"][];
+            /**
+             * Read Tool Names
+             * @default []
+             */
+            read_tool_names?: string[];
+            /**
+             * Write Tool Names
+             * @default []
+             */
+            write_tool_names?: string[];
+        };
         /**
          * TraceAnalysisListItem
          * @description Compact summary of a trace analysis row for list views.
@@ -26651,7 +26820,7 @@ export interface components {
              * Framework
              * @enum {string}
              */
-            framework: "claude-agent-sdk" | "openai-agents" | "crewai";
+            framework: "claude-agent-sdk" | "openai-agents";
             /** Has Write Tools */
             has_write_tools: boolean;
             /**
@@ -27260,6 +27429,28 @@ export interface components {
             /** Sources */
             sources?: components["schemas"]["SourceBreakdownItem"][];
         };
+        /**
+         * WorldScope
+         * @description The world slice — ids only (the leaf stays I/O-free). This is the
+         *     read/subject scope, NOT the write bound (see ``write_floor``).
+         */
+        WorldScope: {
+            /**
+             * Allow Create
+             * @default false
+             */
+            allow_create?: boolean;
+            /**
+             * Scoped Entity Ids
+             * @default []
+             */
+            scoped_entity_ids?: string[];
+            /**
+             * Workspace Id
+             * Format: uuid
+             */
+            workspace_id: string;
+        };
         /**
          * WrapUpRequest
          * @description Request to record operator intervention wrap-up.
@@ -27283,6 +27474,48 @@ export interface components {
             /** Success */
             success: boolean;
         };
+        /**
+         * WriteFloor
+         * @description The REAL server-enforced write bound (audit G8) — advisory to render;
+         *     the MCP edge enforces it regardless of what a client does.
+         */
+        WriteFloor: {
+            /**
+             * Allow Create
+             * @default false
+             */
+            allow_create?: boolean;
+            /**
+             * Clinical Write Principal
+             * @default provider-only
+             */
+            clinical_write_principal?: string;
+            /**
+             * Clinical Write Scope
+             * @default any-entity-in-workspace
+             */
+            clinical_write_scope?: string;
+            /**
+             * Enforced At
+             * @default mcp-world-tools-edge
+             */
+            enforced_at?: string;
+            /**
+             * Enrichment Write Scope
+             * @default caller-anchor-only
+             */
+            enrichment_write_scope?: string;
+            /**
+             * Requires Entity Anchor
+             * @default true
+             */
+            requires_entity_anchor?: boolean;
+            /**
+             * Unanchored Or Api Key Writes
+             * @default none
+             */
+            unanchored_or_api_key_writes?: string;
+        };
         /** @enum {string} */
         _Access: "read" | "write";
         _DatasetSlug: string;
@@ -30016,7 +30249,7 @@ export interface operations {
     list_agent_definitions_v1__workspace_id__agent_definitions_get: {
         parameters: {
             query?: {
-                framework?: ("claude-agent-sdk" | "openai-agents" | "crewai") | null;
+                framework?: ("claude-agent-sdk" | "openai-agents") | null;
                 include_archived?: boolean;
                 limit?: number;
                 continuation_token?: unknown;
@@ -30249,6 +30482,40 @@ export interface operations {
             };
         };
     };
+    get_harness_context_v1__workspace_id__agent_runs_harness_context_get: {
+        parameters: {
+            query: {
+                service_id: string;
+                version_set?: string;
+            };
+            header?: never;
+            path: {
+                workspace_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HarnessContext"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
     get_agent_run_v1__workspace_id__agent_runs__run_id__get: {
         parameters: {
             query?: never;