@corti/sdk 4.2.0 → 5.0.0-rc

package/dist/cjs/api/resources/agentic/resources/agents/client/Client.d.ts

@@ -0,0 +1,279 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../../../BaseClient.js";
+import { type NormalizedClientOptionsWithAuth } from "../../../../../../BaseClient.js";
+import * as core from "../../../../../../core/index.js";
+import * as Corti from "../../../../../index.js";
+import { ConnectorsClient } from "../resources/connectors/client/Client.js";
+import { TasksClient } from "../resources/tasks/client/Client.js";
+export declare namespace AgentsClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class AgentsClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<AgentsClient.Options>;
+    protected _tasks: TasksClient | undefined;
+    protected _connectors: ConnectorsClient | undefined;
+    constructor(options: AgentsClient.Options);
+    get tasks(): TasksClient;
+    get connectors(): ConnectorsClient;
+    /**
+     * @beta This endpoint is in pre-release and may change.
+     *
+     * Lists agents visible to the caller. `private` agents are visible only to
+     * their creator/service principal; `unlisted` agents are omitted (fetch by
+     * ID instead); `public` agents are listed tenant-wide.
+     * The `visibility`, `lifecycle`, `label`, and `q` filter parameters are accepted but not yet honored by the server; the response is unfiltered.
+     *
+     * @param {Corti.agentic.AgenticAgentsListRequest} request
+     * @param {AgentsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.BadRequestError}
+     * @throws {@link Corti.UnauthorizedError}
+     *
+     * @example
+     *     await client.agentic.agents.list({
+     *         label: ["team=coding"],
+     *         q: "coder"
+     *     })
+     */
+    list(request?: Corti.agentic.AgenticAgentsListRequest, requestOptions?: AgentsClient.RequestOptions): Promise<core.Page<Corti.AgenticAgentsResponse, Corti.AgenticAgentsListResponse>>;
+    /**
+     * @beta This endpoint is in pre-release and may change.
+     *
+     * Creates a new agent. The server assigns the UUIDv7 `id`.
+     *
+     * @param {Corti.agentic.AgenticAgentsCreateRequest} request
+     * @param {AgentsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.BadRequestError}
+     * @throws {@link Corti.UnauthorizedError}
+     * @throws {@link Corti.ForbiddenError}
+     * @throws {@link Corti.ConflictError}
+     * @throws {@link Corti.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agentic.agents.create({
+     *         name: "coder",
+     *         description: "Returns ICD-10 codes for a clinical encounter.",
+     *         systemPrompt: "Respond with only the ICD-10 code.",
+     *         model: "corti-default",
+     *         visibility: "private",
+     *         lifecycle: "persistent",
+     *         connectors: [{
+     *                 type: "registry",
+     *                 name: "pubmed-expert"
+     *             }, {
+     *                 type: "mcp",
+     *                 name: "policybot",
+     *                 url: "https://mcp.example.com",
+     *                 auth: {
+     *                     type: "oauth2",
+     *                     scope: "read:policies",
+     *                     redirectUrl: "https://app.corti.ai/oauth/callback"
+     *                 }
+     *             }, {
+     *                 type: "schema",
+     *                 name: "submit_code",
+     *                 description: "Submit the final ICD-10 code for the encounter along with a confidence score.",
+     *                 schema: {
+     *                     "type": "object",
+     *                     "properties": {
+     *                         "code": {
+     *                             "type": "string",
+     *                             "description": "The selected ICD-10 code."
+     *                         },
+     *                         "confidence": {
+     *                             "type": "number",
+     *                             "minimum": 0,
+     *                             "maximum": 1
+     *                         }
+     *                     },
+     *                     "required": [
+     *                         "code"
+     *                     ]
+     *                 },
+     *                 transition: "complete"
+     *             }],
+     *         labels: {
+     *             "team": "coding",
+     *             "env": "prod"
+     *         }
+     *     })
+     */
+    create(request: Corti.agentic.AgenticAgentsCreateRequest, requestOptions?: AgentsClient.RequestOptions): core.HttpResponsePromise<Corti.AgenticAgentsResponse>;
+    private __create;
+    /**
+     * @beta This endpoint is in pre-release and may change.
+     *
+     * @param {Corti.CommonAgentIdValue} agentId - Agent identifier (prefixed UUIDv7).
+     * @param {AgentsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.UnauthorizedError}
+     * @throws {@link Corti.ForbiddenError}
+     * @throws {@link Corti.NotFoundError}
+     *
+     * @example
+     *     await client.agentic.agents.get("agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40")
+     */
+    get(agentId: Corti.CommonAgentIdValue, requestOptions?: AgentsClient.RequestOptions): core.HttpResponsePromise<Corti.AgenticAgentsResponse>;
+    private __get;
+    /**
+     * @beta This endpoint is in pre-release and may change.
+     *
+     * Deletes a `persistent` agent. `ephemeral` agents are expired in place.
+     * Idempotent: deleting an already-deleted agent returns `204`.
+     *
+     * @param {Corti.CommonAgentIdValue} agentId - Agent identifier (prefixed UUIDv7).
+     * @param {AgentsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.UnauthorizedError}
+     * @throws {@link Corti.ForbiddenError}
+     * @throws {@link Corti.NotFoundError}
+     *
+     * @example
+     *     await client.agentic.agents.delete("agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40")
+     */
+    delete(agentId: Corti.CommonAgentIdValue, requestOptions?: AgentsClient.RequestOptions): core.HttpResponsePromise<void>;
+    private __delete;
+    /**
+     * @beta This endpoint is in pre-release and may change.
+     *
+     * Partially updates an agent using JSON Merge Patch (RFC 7386).
+     * Omitted fields are unchanged; `null` clears a field; arrays replace.
+     *
+     * @param {Corti.CommonAgentIdValue} agentId - Agent identifier (prefixed UUIDv7).
+     * @param {Corti.agentic.AgenticAgentsPatchRequest} request
+     * @param {AgentsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.BadRequestError}
+     * @throws {@link Corti.UnauthorizedError}
+     * @throws {@link Corti.ForbiddenError}
+     * @throws {@link Corti.NotFoundError}
+     * @throws {@link Corti.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agentic.agents.update("agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40", {
+     *         name: "coder-v2",
+     *         connectors: [{
+     *                 type: "registry",
+     *                 name: "pubmed-expert"
+     *             }]
+     *     })
+     */
+    update(agentId: Corti.CommonAgentIdValue, request?: Corti.agentic.AgenticAgentsPatchRequest, requestOptions?: AgentsClient.RequestOptions): core.HttpResponsePromise<Corti.AgenticAgentsResponse>;
+    private __update;
+    /**
+     * @beta This endpoint is in pre-release and may change.
+     *
+     * Returns the A2A v1.0 agent card describing the agent's capabilities,
+     * skills, and supported protocol interfaces. Served at the standard
+     * `.well-known` location for agent discovery.
+     *
+     * @param {Corti.CommonAgentIdValue} agentId - Agent identifier (prefixed UUIDv7).
+     * @param {AgentsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.UnauthorizedError}
+     * @throws {@link Corti.NotFoundError}
+     *
+     * @example
+     *     await client.agentic.agents.card("agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40")
+     */
+    card(agentId: Corti.CommonAgentIdValue, requestOptions?: AgentsClient.RequestOptions): core.HttpResponsePromise<Corti.AgenticAgentCardResponse>;
+    private __card;
+    /**
+     * @beta This endpoint is in pre-release and may change.
+     *
+     * The `JSONRPC` protocol binding for A2A v1.0. Accepts a single JSON-RPC 2.0
+     * request whose `method` is one of `SendMessage`, `SendStreamingMessage`,
+     * `GetTask`, `ListTasks`, `CancelTask`, or `SubscribeToTask`.
+     *
+     * Streaming methods (`SendStreamingMessage`, `SubscribeToTask`) respond with
+     * `text/event-stream`; all others respond with a single JSON-RPC response.
+     *
+     * @param {Corti.CommonAgentIdValue} agentId - Agent identifier (prefixed UUIDv7).
+     * @param {Corti.agentic.AgenticAgentsJsonRpcRequest} request
+     * @param {AgentsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.UnauthorizedError}
+     * @throws {@link Corti.NotFoundError}
+     *
+     * @example
+     *     await client.agentic.agents.jsonRpc("agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40", {
+     *         id: "1",
+     *         method: "SendMessage",
+     *         params: {
+     *             "message": {
+     *                 "role": "ROLE_USER",
+     *                 "messageId": "msg.0192f4c8-5f8d-7e61-924d-6fb09b5ead73",
+     *                 "parts": [
+     *                     {
+     *                         "text": "Code this encounter."
+     *                     }
+     *                 ]
+     *             }
+     *         }
+     *     })
+     */
+    jsonRpc(agentId: Corti.CommonAgentIdValue, request: Corti.agentic.AgenticAgentsJsonRpcRequest, requestOptions?: AgentsClient.RequestOptions): core.HttpResponsePromise<Corti.AgenticAgentsJsonRpcResponse>;
+    private __jsonRpc;
+    /**
+     * @beta This endpoint is in pre-release and may change.
+     *
+     * The `HTTP+JSON` binding of A2A `SendMessage`.
+     *
+     * @param {Corti.CommonAgentIdValue} agentId - Agent identifier (prefixed UUIDv7).
+     * @param {Corti.AgenticAgentsSendMessageRequest} request
+     * @param {AgentsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.BadRequestError}
+     * @throws {@link Corti.UnauthorizedError}
+     * @throws {@link Corti.NotFoundError}
+     *
+     * @example
+     *     await client.agentic.agents.sendMessage("agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40", {
+     *         message: {
+     *             messageId: "msg.0192f4c8-5f8d-7e61-924d-6fb09b5ead73",
+     *             role: "ROLE_USER",
+     *             parts: [{
+     *                     text: "What is the ICD-10 code for asthma?"
+     *                 }]
+     *         }
+     *     })
+     */
+    sendMessage(agentId: Corti.CommonAgentIdValue, request: Corti.AgenticAgentsSendMessageRequest, requestOptions?: AgentsClient.RequestOptions): core.HttpResponsePromise<Corti.AgenticAgentsSendMessageResponse>;
+    private __sendMessage;
+    /**
+     * @beta This endpoint is in pre-release and may change.
+     *
+     * The `HTTP+JSON` binding of A2A `SendStreamingMessage`. Responds with a
+     * `text/event-stream` of `Task`, `statusUpdate`, and `artifactUpdate` events.
+     */
+    streamMessage(agentId: Corti.CommonAgentIdValue, request: Corti.AgenticAgentsSendMessageRequest, requestOptions?: AgentsClient.RequestOptions): core.HttpResponsePromise<core.Stream<Corti.AgenticAgentsStreamEventResponse>>;
+    private __streamMessage;
+    /**
+     * @beta This endpoint is in pre-release and may change.
+     *
+     * Returns invocation metrics for the agent over the half-open `[from, to)`
+     * time range (UTC), bucketed at the requested `granularity`. The response
+     * echoes the resolved range and granularity, a `totals` summary across the
+     * whole range, and one `buckets` entry per period that had activity (the
+     * array is empty when there was none). When `from`/`to` are omitted, the
+     * range defaults to the last 30 days.
+     *
+     * @param {Corti.CommonAgentIdValue} agentId - Agent identifier (prefixed UUIDv7).
+     * @param {Corti.agentic.AgenticAgentsUsageRequest} request
+     * @param {AgentsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.BadRequestError}
+     * @throws {@link Corti.UnauthorizedError}
+     * @throws {@link Corti.NotFoundError}
+     *
+     * @example
+     *     await client.agentic.agents.usage("agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40", {
+     *         from: new Date("2026-05-19T00:00:00.000Z"),
+     *         to: new Date("2026-05-20T00:00:00.000Z")
+     *     })
+     */
+    usage(agentId: Corti.CommonAgentIdValue, request?: Corti.agentic.AgenticAgentsUsageRequest, requestOptions?: AgentsClient.RequestOptions): core.HttpResponsePromise<Corti.AgentsUsageReportResponse>;
+    private __usage;
+}