@stack-spot/portal-network 0.149.0 → 0.150.0

package/dist/utils/StreamedArray.js

@@ -0,0 +1,148 @@
+import { CompletablePromise } from '@stack-spot/opa';
+import { StreamCanceledError } from '../error/StreamCanceledError.js';
+import { StreamError } from '../error/StreamError.js';
+import { StreamJsonError } from '../error/StreamJsonError.js';
+/**
+ * An array represented by a stream where each event contains an item of the array as a JSON string. This can be watched as the stream runs.
+ */
+export class StreamedArray {
+    /**
+     * @param response the fetch response.
+     * @param minChangeIntervalMS a stream can be too fast. This sets a minimum interval between running the listeners. The default is 50ms.
+     */
+    constructor({ eventsPromises, abortController, minChangeIntervalMS = 50, signal }) {
+        Object.defineProperty(this, "onChangeListeners", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "error", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "data", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "fullPromise", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new CompletablePromise()
+        });
+        Object.defineProperty(this, "abortController", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.abortController = abortController ?? new AbortController();
+        eventsPromises.forEach(eventsPromise => this.run(eventsPromise, minChangeIntervalMS));
+        if (signal) {
+            signal.addEventListener('abort', () => this.cancel());
+        }
+    }
+    async run(eventsPromise, minChangeIntervalMS) {
+        let lastChangeCall = 0;
+        try {
+            const events = await eventsPromise;
+            let flushed = true;
+            for await (const event of events) {
+                if (this.error)
+                    return;
+                if (event.data) {
+                    this.data.push(JSON.parse(event.data));
+                    if (new Date().getTime() - lastChangeCall >= minChangeIntervalMS) {
+                        this.onChangeListeners.forEach(l => l(this.data));
+                        lastChangeCall = new Date().getTime();
+                        flushed = true;
+                    }
+                    else {
+                        flushed = false;
+                    }
+                }
+            }
+            if (!flushed)
+                this.onChangeListeners.forEach(l => l(this.data));
+        }
+        catch (error) {
+            if (error instanceof DOMException && error.name === 'AbortError')
+                this.fail(new StreamCanceledError());
+            if (error instanceof SyntaxError)
+                this.fail(new StreamJsonError());
+            else if (error instanceof StreamError)
+                this.fail(error);
+            else
+                this.fail(new StreamError(error?.message || `${error}`));
+        }
+        if (!this.error)
+            this.complete();
+    }
+    clear() {
+        this.onChangeListeners = [];
+        this.abortController = undefined;
+    }
+    fail(error) {
+        this.error = error;
+        this.fullPromise.reject(this.error);
+        this.clear();
+    }
+    complete() {
+        this.fullPromise.resolve(this.data);
+        this.clear();
+    }
+    /**
+     * Returns the full value of the array once the stream finishes.
+     */
+    getValue() {
+        return this.fullPromise.promise;
+    }
+    /**
+     * Returns the streamed array with every item streamed until now. This will be the complete array if the stream has finished.
+     */
+    getPartialValue() {
+        return this.data;
+    }
+    /**
+     * Watches the array as it's streamed. This doesn't wait for the value to be complete.
+     *
+     * The listener is called whenever the value changes.
+     *
+     * @param listener the function to call with the new value.
+     * @returns a function that, when called, removes the listener.
+     */
+    onChange(listener) {
+        if (this.fullPromise.resolved) {
+            listener(this.data);
+            return () => { };
+        }
+        this.onChangeListeners.push(listener);
+        return () => {
+            const index = this.onChangeListeners?.findIndex(l => l === listener);
+            if (index !== undefined && index >= 0)
+                this.onChangeListeners?.splice(index, 1);
+        };
+    }
+    getStatus() {
+        if (this.error)
+            return 'error';
+        if (this.fullPromise.resolved)
+            return 'success';
+        return 'pending';
+    }
+    getError() {
+        return this.error;
+    }
+    /**
+     * If this is a stream and it's not yet finished, calling this function cancels the stream.
+     */
+    cancel() {
+        this.abortController?.abort(new StreamCanceledError());
+    }
+}
+//# sourceMappingURL=StreamedArray.js.map

package/dist/utils/StreamedArray.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamedArray.js","sourceRoot":"","sources":["../../src/utils/StreamedArray.tsx"],"names":[],"mappings":"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"}

package/dist/utils/StreamedJson.d.ts

@@ -1,6 +1,6 @@
 import { StreamError } from '../error/StreamError.js';
 import { FetchEventStream } from '../network/types.js';
-type StreamingStatus = 'pending' | 'success' | 'error';
+import { StreamingStatus } from '../types.js';
 interface ConstructorParams<T> {
     /**
      * The promise that results in the EventStream to build the final json.

package/dist/utils/StreamedJson.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StreamedJson.d.ts","sourceRoot":"","sources":["../../src/utils/StreamedJson.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEnD,KAAK,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAA;AAGtD,UAAU,iBAAiB,CAAC,CAAC;IAC3B;;OAEG;IACH,aAAa,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACzC;;OAEG;IACH,eAAe,EAAE,eAAe,CAAC;IACjC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,YAAY,CAAC,CAAC;IACzB,OAAO,CAAC,iBAAiB,CAA4B;IACrD,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,IAAI,CAAiB;IAC7B,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,SAAS,CAAC,CAA+D;IACjF,OAAO,CAAC,UAAU,CAAC,CAAa;IAEhC;;;OAGG;gBACS,EAAE,aAAa,EAAE,eAAe,EAAE,mBAAwB,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;YAOvG,GAAG;IA8BjB,OAAO,CAAC,KAAK;IAWb,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,QAAQ;IAKhB;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC;IAItB;;OAEG;IACH,eAAe,IAAI,OAAO,CAAC,CAAC,CAAC;IAI7B;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI;IAY9C,SAAS,IAAI,eAAe;IAM5B,QAAQ;IAIR;;OAEG;IACH,MAAM;CAGP"}
+{"version":3,"file":"StreamedJson.d.ts","sourceRoot":"","sources":["../../src/utils/StreamedJson.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAI1C,UAAU,iBAAiB,CAAC,CAAC;IAC3B;;OAEG;IACH,aAAa,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACzC;;OAEG;IACH,eAAe,EAAE,eAAe,CAAC;IACjC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,YAAY,CAAC,CAAC;IACzB,OAAO,CAAC,iBAAiB,CAA4B;IACrD,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,IAAI,CAAiB;IAC7B,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,SAAS,CAAC,CAA+D;IACjF,OAAO,CAAC,UAAU,CAAC,CAAa;IAEhC;;;OAGG;gBACS,EAAE,aAAa,EAAE,eAAe,EAAE,mBAAwB,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;YAOvG,GAAG;IA8BjB,OAAO,CAAC,KAAK;IAWb,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,QAAQ;IAKhB;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC;IAItB;;OAEG;IACH,eAAe,IAAI,OAAO,CAAC,CAAC,CAAC;IAI7B;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI;IAY9C,SAAS,IAAI,eAAe;IAM5B,QAAQ;IAIR;;OAEG;IACH,MAAM;CAGP"}

package/dist/utils/use-streamed-array.d.ts

@@ -0,0 +1,4 @@
+import { StreamingStatus } from '../types.js';
+import { StreamedArray } from './StreamedArray.js';
+export declare function useStreamedArray<T>(stream: StreamedArray<T> | undefined): (StreamingStatus | T[])[];
+//# sourceMappingURL=use-streamed-array.d.ts.map

package/dist/utils/use-streamed-array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-streamed-array.d.ts","sourceRoot":"","sources":["../../src/utils/use-streamed-array.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,6BAYvE"}

package/dist/utils/use-streamed-array.js

@@ -0,0 +1,15 @@
+import { useEffect, useState } from 'react';
+export function useStreamedArray(stream) {
+    const [array, setArray] = useState(stream?.getPartialValue() ?? []);
+    const [status, setStatus] = useState(stream?.getStatus() ?? 'pending');
+    useEffect(() => {
+        setArray(stream?.getPartialValue() ?? []);
+        setStatus(stream?.getStatus() ?? 'pending');
+        return stream?.onChange((values) => {
+            setArray(values);
+            setStatus(stream.getStatus());
+        });
+    }, [stream]);
+    return [array, status];
+}
+//# sourceMappingURL=use-streamed-array.js.map

package/dist/utils/use-streamed-array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-streamed-array.js","sourceRoot":"","sources":["../../src/utils/use-streamed-array.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAI3C,MAAM,UAAU,gBAAgB,CAAI,MAAoC;IACtE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAM,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAA;IACxE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAkB,MAAM,EAAE,SAAS,EAAE,IAAI,SAAS,CAAC,CAAA;IACvF,SAAS,CAAC,GAAG,EAAE;QACb,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAA;QACzC,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,SAAS,CAAC,CAAA;QAC3C,OAAO,MAAM,EAAE,QAAQ,CAAC,CAAC,MAAM,EAAE,EAAE;YACjC,QAAQ,CAAC,MAAM,CAAC,CAAA;YAChB,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAA;QAC/B,CAAC,CAAC,CAAA;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IACZ,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;AACxB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stack-spot/portal-network",
-  "version": "0.149.0",
+  "version": "0.150.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/api/agent-tools.ts

@@ -260,6 +260,15 @@ export type DeleteToolsRequest = {
     /** List of tool IDs to be deleted from the toolkit */
     tool_ids: string[];
 };
+export type ListAgentsUsingToolsRequest = {
+    /** List of tool IDs to find agents that use at least one of them */
+    tool_ids: string[];
+};
+export type AgentUsingToolsResponse = {
+    id: string;
+    name: string;
+    avatar?: string | null;
+};
 export type AssignCustomToolsAgentRequest = {
     toolkit_id: string;
     tools_ids: string[];
@@ -312,7 +321,7 @@ export type ExecuteAgentToolRequest = {
 export type AgentToolExecutionResponse = {
     result: string;
 };
-export type AgentVisibilityLevelEnum = "built_in";
+export type AgentVisibilityLevelEnum = "built_in" | "recently_used";
 export type KnowledgeSourcesConfig = {
     knowledge_sources: string[];
     max_number_of_kos?: number;
@@ -328,7 +337,7 @@ export type ListAgentResponse = {
     created_at: string | null;
     visibility_level: string;
     avatar: string | null;
-    conversation_starter: string[] | null;
+    suggested_prompts: string[] | null;
     knowledge_sources_config: KnowledgeSourcesConfig;
     "type"?: string;
     system_prompt?: string;
@@ -465,6 +474,20 @@ export type AgentModel = {
     updated_by?: string | null;
     updated_at?: string | null;
 };
+export type ListAgentResponseV2 = {
+    id: string;
+    name: string;
+    slug: string;
+    created_by: string | null;
+    created_at: string | null;
+    visibility_level: string;
+    avatar: string | null;
+    conversation_starter: string[] | null;
+    knowledge_sources_config: KnowledgeSourcesConfig;
+    "type"?: string;
+    system_prompt?: string;
+    creator_name?: string;
+};
 export type InternalListToolkitsRequest = {
     /** List of toolkit IDs to retrieve */
     toolkit_ids: string[];
@@ -887,6 +910,39 @@ export function splitUploadedFilePreviewV1ToolkitsToolsPreviewFileUploadIdGet({
         })
     }));
 }
+/**
+ * List Agents Using Tools
+ */
+export function listAgentsUsingToolsV1ToolkitsToolkitIdToolsAgentsPost({ toolkitId, xAccountId, xUsername, xUserId, xUserFullName, authorization, listAgentsUsingToolsRequest }: {
+    toolkitId: string;
+    xAccountId?: string | null;
+    xUsername?: string | null;
+    xUserId?: string | null;
+    xUserFullName?: string | null;
+    authorization: string;
+    listAgentsUsingToolsRequest: ListAgentsUsingToolsRequest;
+}, opts?: Oazapfts.RequestOpts) {
+    return oazapfts.ok(oazapfts.fetchJson<{
+        status: 200;
+        data: AgentUsingToolsResponse[];
+    } | {
+        status: 404;
+    } | {
+        status: 422;
+        data: HttpValidationError;
+    }>(`/v1/toolkits/${encodeURIComponent(toolkitId)}/tools/agents`, oazapfts.json({
+        ...opts,
+        method: "POST",
+        body: listAgentsUsingToolsRequest,
+        headers: oazapfts.mergeHeaders(opts?.headers, {
+            "x-account-id": xAccountId,
+            "x-username": xUsername,
+            "x-user-id": xUserId,
+            "x-user-full-name": xUserFullName,
+            authorization
+        })
+    })));
+}
 /**
  * Assign Tools
  */
@@ -1273,6 +1329,78 @@ export function publishAgentV1AgentsAgentIdPublishPost({ agentId }: {
         method: "POST"
     }));
 }
+/**
+ * List Agents
+ */
+export function listAgentsV2AgentsGet({ name, slug, visibility, size, page, xAccountId, xUsername, xUserId, xUserFullName, authorization }: {
+    name?: string | null;
+    slug?: string | null;
+    visibility?: AgentVisibilityLevelEnum | VisibilityLevelEnum;
+    size?: number;
+    page?: number;
+    xAccountId?: string | null;
+    xUsername?: string | null;
+    xUserId?: string | null;
+    xUserFullName?: string | null;
+    authorization: string;
+}, opts?: Oazapfts.RequestOpts) {
+    return oazapfts.ok(oazapfts.fetchJson<{
+        status: 200;
+        data: ListAgentResponseV2[];
+    } | {
+        status: 404;
+    } | {
+        status: 422;
+        data: HttpValidationError;
+    }>(`/v2/agents${QS.query(QS.explode({
+        name,
+        slug,
+        visibility,
+        size,
+        page
+    }))}`, {
+        ...opts,
+        headers: oazapfts.mergeHeaders(opts?.headers, {
+            "x-account-id": xAccountId,
+            "x-username": xUsername,
+            "x-user-id": xUserId,
+            "x-user-full-name": xUserFullName,
+            authorization
+        })
+    }));
+}
+/**
+ * Search Agents
+ */
+export function searchAgentsV2AgentsSearchPost({ xAccountId, xUsername, xUserId, xUserFullName, authorization, searchAgentsRequest }: {
+    xAccountId?: string | null;
+    xUsername?: string | null;
+    xUserId?: string | null;
+    xUserFullName?: string | null;
+    authorization: string;
+    searchAgentsRequest: SearchAgentsRequest;
+}, opts?: Oazapfts.RequestOpts) {
+    return oazapfts.ok(oazapfts.fetchJson<{
+        status: 200;
+        data: ListAgentResponseV2[];
+    } | {
+        status: 404;
+    } | {
+        status: 422;
+        data: HttpValidationError;
+    }>("/v2/agents/search", oazapfts.json({
+        ...opts,
+        method: "POST",
+        body: searchAgentsRequest,
+        headers: oazapfts.mergeHeaders(opts?.headers, {
+            "x-account-id": xAccountId,
+            "x-username": xUsername,
+            "x-user-id": xUserId,
+            "x-user-full-name": xUserFullName,
+            authorization
+        })
+    })));
+}
 /**
  * Internal List Toolkits By Ids
  */

package/src/api/agent.ts

@@ -27,6 +27,10 @@ export type KnowledgeSourcesConfigRequestPart = {
     /** List of knowledge source ids (ULID). */
     knowledge_sources: string[];
 };
+export type CustomToolRequest = {
+    toolkit_id?: string;
+    tools_ids?: string[];
+};
 export type NewAgentRequest = {
     name: string;
     slug: string;
@@ -38,6 +42,7 @@ export type NewAgentRequest = {
     llm_config?: (LlmConfigRequestPart) | null;
     knowledge_sources_config?: (KnowledgeSourcesConfigRequestPart) | null;
     builtin_tools_ids?: string[];
+    custom_tools?: CustomToolRequest[];
     detail_mode?: boolean;
     model_name?: string | null;
     model_id?: string | null;
@@ -102,6 +107,7 @@ export type KnowledgeSourceResponse = {
     knowledge_sources: string[];
     knowledge_sources_details?: KnowledgeSourceDetailResponse[];
 };
+export type VisibilityLevel = "PERSONAL" | "SHARED" | "WORKSPACE" | "ACCOUNT" | "FAVORITE";
 export type ZonedDateTime = string;
 export type BuiltinToolResponse = {
     id?: string;
@@ -115,12 +121,28 @@ export type BuiltinToolkitResponse = {
     image_url?: string;
     tools?: BuiltinToolResponse[];
 };
+export type CustomToolResponse = {
+    id?: string;
+    name?: string;
+    description?: string;
+    method?: string;
+    url?: string;
+};
+export type CustomToolkitResponse = {
+    id?: string;
+    name?: string;
+    description?: string;
+    avatar?: string;
+    secret_id?: string;
+    tools?: CustomToolResponse[];
+};
 export type ToolkitsInAgentResponse = {
     builtins?: BuiltinToolkitResponse[];
+    customs?: CustomToolkitResponse[];
 };
 export type ModifiedAgentRequest = {
-    name?: string | null;
-    slug?: string | null;
+    name: string;
+    slug: string;
     description?: string | null;
     avatar?: string | null;
     suggested_prompts?: string[] | null;
@@ -130,6 +152,7 @@ export type ModifiedAgentRequest = {
     knowledge_sources_config?: (KnowledgeSourcesConfigRequestPart) | null;
     use_only?: boolean | null;
     builtin_tools_ids?: string[];
+    custom_tools?: CustomToolRequest[];
     detail_mode?: boolean | null;
     model_name?: string | null;
     model_id?: string | null;
@@ -144,7 +167,6 @@ export type ForkAgentRequest = {
     slug?: string;
     name?: string | null;
 };
-export type VisibilityLevel = "PERSONAL" | "SHARED" | "WORKSPACE" | "ACCOUNT" | "FAVORITE";
 export type PublishRequest = {
     level: VisibilityLevel;
     use_only?: boolean;
@@ -160,7 +182,7 @@ export type AgentResponse = {
     llm_config?: LlmConfigResponse;
     suggested_prompts?: string[];
     knowledge_sources_config?: KnowledgeSourceResponse;
-    visibility_level: string;
+    visibility_level: VisibilityLevel;
     use_only: boolean;
     creator_name: string;
     created_by: string;
@@ -380,7 +402,7 @@ export function getV1AgentByAgentId({ agentId }: {
             llm_config?: LlmConfigResponse;
             suggested_prompts?: string[];
             knowledge_sources_config?: KnowledgeSourceResponse;
-            visibility_level: string;
+            visibility_level: VisibilityLevel;
             use_only: boolean;
             creator_name: string;
             created_by: string;
@@ -673,7 +695,7 @@ export function getV1AgentByAgentSlugExists({ agentSlug }: {
             llm_config?: LlmConfigResponse;
             suggested_prompts?: string[];
             knowledge_sources_config?: KnowledgeSourceResponse;
-            visibility_level: string;
+            visibility_level: VisibilityLevel;
             use_only: boolean;
             creator_name: string;
             created_by: string;
@@ -737,44 +759,6 @@ export function getV1Agents({ visibility }: {
         ...opts
     }));
 }
-/**
- * Create agents trial
- */
-export function postV1AgentsTrial(opts?: Oazapfts.RequestOpts) {
-    return oazapfts.ok(oazapfts.fetchJson<{
-        status: 204;
-    } | {
-        status: 404;
-        data: {
-            code?: string;
-            details?: string;
-            additionalInformation?: {
-                [key: string]: any;
-            } | null;
-        };
-    } | {
-        status: 422;
-        data: {
-            code?: string;
-            details?: string;
-            additionalInformation?: {
-                [key: string]: any;
-            } | null;
-        };
-    } | {
-        status: 500;
-        data: {
-            code?: string;
-            details?: string;
-            additionalInformation?: {
-                [key: string]: any;
-            } | null;
-        };
-    }>("/v1/agents/trial", {
-        ...opts,
-        method: "POST"
-    }));
-}
 /**
  * Creates a new built-in AI Agent.
  */
@@ -836,7 +820,7 @@ export function getV1PublicAgentByAgentId({ agentId }: {
             llm_config?: LlmConfigResponse;
             suggested_prompts?: string[];
             knowledge_sources_config?: KnowledgeSourceResponse;
-            visibility_level: string;
+            visibility_level: VisibilityLevel;
             use_only: boolean;
             creator_name: string;
             created_by: string;
@@ -1033,7 +1017,7 @@ export function getV1PublicAgentByAgentSlugExists({ agentSlug }: {
             llm_config?: LlmConfigResponse;
             suggested_prompts?: string[];
             knowledge_sources_config?: KnowledgeSourceResponse;
-            visibility_level: string;
+            visibility_level: VisibilityLevel;
             use_only: boolean;
             creator_name: string;
             created_by: string;
@@ -1097,41 +1081,3 @@ export function getV1PublicAgents({ visibility }: {
         ...opts
     }));
 }
-/**
- * Create agents trial
- */
-export function postV1PublicAgentsTrial(opts?: Oazapfts.RequestOpts) {
-    return oazapfts.ok(oazapfts.fetchJson<{
-        status: 204;
-    } | {
-        status: 404;
-        data: {
-            code?: string;
-            details?: string;
-            additionalInformation?: {
-                [key: string]: any;
-            } | null;
-        };
-    } | {
-        status: 422;
-        data: {
-            code?: string;
-            details?: string;
-            additionalInformation?: {
-                [key: string]: any;
-            } | null;
-        };
-    } | {
-        status: 500;
-        data: {
-            code?: string;
-            details?: string;
-            additionalInformation?: {
-                [key: string]: any;
-            } | null;
-        };
-    }>("/v1/public/agents/trial", {
-        ...opts,
-        method: "POST"
-    }));
-}

package/src/client/agent-tools.ts

@@ -1,9 +1,11 @@
 import { HttpError } from '@oazapfts/runtime'
-import { createToolkitToolsV1ToolkitsToolkitIdToolsPost, createToolkitV1ToolkitsPost, defaults, deleteToolkitToolsV1ToolkitsToolkitIdToolsDelete, deleteToolkitV1ToolkitsToolkitIdDelete, editToolkitToolV1ToolkitsToolkitIdToolsToolIdPut, getPublicToolKitsV1BuiltinToolkitGet, getToolkitToolV1ToolkitsToolkitIdToolsToolIdGet, getToolkitV1ToolkitsToolkitIdGet, HttpValidationError, listToolkitsV1ToolkitsGet, updateToolkitV1ToolkitsToolkitIdPatch } from '../api/agent-tools'
+import { createToolkitToolsV1ToolkitsToolkitIdToolsPost, createToolkitV1ToolkitsPost, defaults, deleteToolkitToolsV1ToolkitsToolkitIdToolsDelete, deleteToolkitV1ToolkitsToolkitIdDelete, editToolkitToolV1ToolkitsToolkitIdToolsToolIdPut, getPublicToolKitsV1BuiltinToolkitGet, getToolkitToolV1ToolkitsToolkitIdToolsToolIdGet, getToolkitV1ToolkitsToolkitIdGet, HttpValidationError, listAgentsUsingToolsV1ToolkitsToolkitIdToolsAgentsPost, listToolkitsV1ToolkitsGet, updateToolkitV1ToolkitsToolkitIdPatch } from '../api/agent-tools'
 import apis from '../apis.json'
 import { StackspotAPIError } from '../error/StackspotAPIError'
 import { ReactQueryNetworkClient } from '../network/ReactQueryNetworkClient'
+import { FetchEventStream } from '../network/types'
 import { removeAuthorizationParam } from '../utils/remove-authorization-param'
+import { StreamedArray } from '../utils/StreamedArray'
 import { AgentToolsOpenAPIPreview } from './types'
 
 class AgentToolsClient extends ReactQueryNetworkClient {
@@ -21,7 +23,7 @@ class AgentToolsClient extends ReactQueryNetworkClient {
     })
   }
 
-  tools = this.query(getPublicToolKitsV1BuiltinToolkitGet)
+  tools = this.query(removeAuthorizationParam(getPublicToolKitsV1BuiltinToolkitGet))
 
   /**
    * Get list of Toolkits
@@ -60,22 +62,19 @@ class AgentToolsClient extends ReactQueryNetworkClient {
    */
   deleteToolFromToolkit = this.mutation(removeAuthorizationParam(deleteToolkitToolsV1ToolkitsToolkitIdToolsDelete))
   /**
-   * Previews an uploaded open api file.
+   * Previews an uploaded open api file as a stream where each array item is an OpenAPI operation.
    */
-  previewUploadedAPI = this.query({
-    name: 'previewUploadedAPI',
-    request: async (signal, params: { fileUploadId: string }) => {
-      const url = `/v1/toolkits/tools/preview/${encodeURIComponent(params.fileUploadId)}`
-      const events = await this.stream(url, { signal })
-      const result: AgentToolsOpenAPIPreview[] = []
-      for await (const event of events) {
-        if (event.data) {
-          result.push(JSON.parse(event.data))
-        }
-      }
-      return result
-    },
-  })
+  streamUploadedAPIs = ({ fileUploadIds, signal }: { fileUploadIds: string[], signal?: AbortSignal }) => {
+    const promises: Promise<FetchEventStream>[] = fileUploadIds.map((id) => {
+      const url = `/v1/toolkits/tools/preview/${encodeURIComponent(id)}`
+      return this.stream(url, { signal })
+    })
+    return new StreamedArray<AgentToolsOpenAPIPreview>({ eventsPromises: promises, signal })
+  }
+  /**
+   * Lists the agents using the tools passed as parameter.
+   */
+  agentsUsingTools = this.query(removeAuthorizationParam(listAgentsUsingToolsV1ToolkitsToolkitIdToolsAgentsPost))
 }
 
 export const agentToolsClient = new AgentToolsClient()

package/src/client/agent.ts

@@ -1,5 +1,9 @@
 import { HttpError } from '@oazapfts/runtime'
-import { defaults, deleteV1AgentByAgentIdFavorite, getV1AgentByAgentId, getV1Agents, getV1PublicAgentByAgentId, getV1PublicAgents, postV1AgentByAgentIdFavorite, postV1AgentsTrial, putV1AgentByAgentId, VisibilityLevel } from '../api/agent'
+import {
+  defaults, deleteV1AgentByAgentIdFavorite, getV1AgentByAgentId, getV1Agents, getV1PublicAgentByAgentId, getV1PublicAgents,
+  postV1AgentByAgentIdFavorite, putV1AgentByAgentId,
+  VisibilityLevel,
+} from '../api/agent'
 import apis from '../apis.json'
 import { StackspotAPIError } from '../error/StackspotAPIError'
 import { ReactQueryNetworkClient } from '../network/ReactQueryNetworkClient'
@@ -68,6 +72,7 @@ class AgentClient extends ReactQueryNetworkClient {
 
       if (shouldIncludeBuiltInAgent) {
         const builtInsAgents = publicAgents?.map((agent) => ({ ...agent, builtIn: true, visibility_level: 'BUILT-IN' }))
+        // @ts-ignore fixme: above, BUILT-IN is not a valid value for the enum VisibilityLevel.
         allAgents.push(...builtInsAgents)
       }
 
@@ -133,11 +138,6 @@ class AgentClient extends ReactQueryNetworkClient {
    * Removes the resource of type Agent from the list of favorites.
    */
   removeFavoriteAgent = this.mutation(deleteV1AgentByAgentIdFavorite)
-
-  /**
-   * Create a test agent if it does not exist
-   */
-  createTrialAgents = this.mutation(postV1AgentsTrial)
   /**
    * Updates an agent
    */