llama-stack-client 0.4.3-rc3 → 0.4.4

package/dist/src/resources/tool-runtime.ts

@@ -0,0 +1,217 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+// All rights reserved.
+//
+// This source code is licensed under the terms described in the LICENSE file in
+// the root directory of this source tree.
+//
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../resource';
+import { isRequestOptions } from '../core';
+import * as Core from '../core';
+
+export class ToolRuntime extends APIResource {
+  /**
+   * Run a tool with the given arguments.
+   *
+   * @deprecated
+   */
+  invokeTool(
+    body: ToolRuntimeInvokeToolParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<ToolInvocationResult> {
+    return this._client.post('/v1/tool-runtime/invoke', { body, ...options });
+  }
+
+  /**
+   * List all tools in the runtime.
+   *
+   * @deprecated
+   */
+  listTools(
+    query?: ToolRuntimeListToolsParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<ToolRuntimeListToolsResponse>;
+  listTools(options?: Core.RequestOptions): Core.APIPromise<ToolRuntimeListToolsResponse>;
+  listTools(
+    query: ToolRuntimeListToolsParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<ToolRuntimeListToolsResponse> {
+    if (isRequestOptions(query)) {
+      return this.listTools({}, query);
+    }
+    return (
+      this._client.get('/v1/tool-runtime/list-tools', { query, ...options }) as Core.APIPromise<{
+        data: ToolRuntimeListToolsResponse;
+      }>
+    )._thenUnwrap((obj) => obj.data);
+  }
+}
+
+/**
+ * Tool definition used in runtime contexts.
+ */
+export interface ToolDef {
+  name: string;
+
+  description?: string | null;
+
+  input_schema?: { [key: string]: unknown } | null;
+
+  metadata?: { [key: string]: unknown } | null;
+
+  output_schema?: { [key: string]: unknown } | null;
+
+  toolgroup_id?: string | null;
+}
+
+/**
+ * Result of a tool invocation.
+ */
+export interface ToolInvocationResult {
+  /**
+   * A image content item
+   */
+  content?:
+    | string
+    | ToolInvocationResult.ImageContentItemOutput
+    | ToolInvocationResult.TextContentItem
+    | Array<ToolInvocationResult.ImageContentItemOutput | ToolInvocationResult.TextContentItem>
+    | null;
+
+  error_code?: number | null;
+
+  error_message?: string | null;
+
+  metadata?: { [key: string]: unknown } | null;
+}
+
+export namespace ToolInvocationResult {
+  /**
+   * A image content item
+   */
+  export interface ImageContentItemOutput {
+    /**
+     * A URL or a base64 encoded string
+     */
+    image: ImageContentItemOutput.Image;
+
+    type?: 'image';
+  }
+
+  export namespace ImageContentItemOutput {
+    /**
+     * A URL or a base64 encoded string
+     */
+    export interface Image {
+      data?: string | null;
+
+      /**
+       * A URL reference to external content.
+       */
+      url?: Image.URL | null;
+    }
+
+    export namespace Image {
+      /**
+       * A URL reference to external content.
+       */
+      export interface URL {
+        uri: string;
+      }
+    }
+  }
+
+  /**
+   * A text content item
+   */
+  export interface TextContentItem {
+    text: string;
+
+    type?: 'text';
+  }
+
+  /**
+   * A image content item
+   */
+  export interface ImageContentItemOutput {
+    /**
+     * A URL or a base64 encoded string
+     */
+    image: ImageContentItemOutput.Image;
+
+    type?: 'image';
+  }
+
+  export namespace ImageContentItemOutput {
+    /**
+     * A URL or a base64 encoded string
+     */
+    export interface Image {
+      data?: string | null;
+
+      /**
+       * A URL reference to external content.
+       */
+      url?: Image.URL | null;
+    }
+
+    export namespace Image {
+      /**
+       * A URL reference to external content.
+       */
+      export interface URL {
+        uri: string;
+      }
+    }
+  }
+
+  /**
+   * A text content item
+   */
+  export interface TextContentItem {
+    text: string;
+
+    type?: 'text';
+  }
+}
+
+export type ToolRuntimeListToolsResponse = Array<ToolDef>;
+
+export interface ToolRuntimeInvokeToolParams {
+  kwargs: { [key: string]: unknown };
+
+  tool_name: string;
+
+  authorization?: string | null;
+}
+
+export interface ToolRuntimeListToolsParams {
+  authorization?: string | null;
+
+  /**
+   * A URL reference to external content.
+   */
+  mcp_endpoint?: ToolRuntimeListToolsParams.McpEndpoint | null;
+
+  tool_group_id?: string | null;
+}
+
+export namespace ToolRuntimeListToolsParams {
+  /**
+   * A URL reference to external content.
+   */
+  export interface McpEndpoint {
+    uri: string;
+  }
+}
+
+export declare namespace ToolRuntime {
+  export {
+    type ToolDef as ToolDef,
+    type ToolInvocationResult as ToolInvocationResult,
+    type ToolRuntimeListToolsResponse as ToolRuntimeListToolsResponse,
+    type ToolRuntimeInvokeToolParams as ToolRuntimeInvokeToolParams,
+    type ToolRuntimeListToolsParams as ToolRuntimeListToolsParams,
+  };
+}

package/dist/src/resources/toolgroups.ts

@@ -0,0 +1,135 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+// All rights reserved.
+//
+// This source code is licensed under the terms described in the LICENSE file in
+// the root directory of this source tree.
+//
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../resource';
+import * as Core from '../core';
+
+export class Toolgroups extends APIResource {
+  /**
+   * List tool groups with optional provider.
+   *
+   * @deprecated
+   */
+  list(options?: Core.RequestOptions): Core.APIPromise<ToolgroupListResponse> {
+    return (
+      this._client.get('/v1/toolgroups', options) as Core.APIPromise<{ data: ToolgroupListResponse }>
+    )._thenUnwrap((obj) => obj.data);
+  }
+
+  /**
+   * Get a tool group by its ID.
+   *
+   * @deprecated
+   */
+  get(toolgroupId: string, options?: Core.RequestOptions): Core.APIPromise<ToolGroup> {
+    return this._client.get(`/v1/toolgroups/${toolgroupId}`, options);
+  }
+
+  /**
+   * Register a tool group.
+   *
+   * @deprecated
+   */
+  register(body: ToolgroupRegisterParams, options?: Core.RequestOptions): Core.APIPromise<void> {
+    return this._client.post('/v1/toolgroups', {
+      body,
+      ...options,
+      headers: { Accept: '*/*', ...options?.headers },
+    });
+  }
+
+  /**
+   * Unregister a tool group.
+   *
+   * @deprecated
+   */
+  unregister(toolgroupId: string, options?: Core.RequestOptions): Core.APIPromise<void> {
+    return this._client.delete(`/v1/toolgroups/${toolgroupId}`, {
+      ...options,
+      headers: { Accept: '*/*', ...options?.headers },
+    });
+  }
+}
+
+/**
+ * Response containing a list of tool groups.
+ */
+export interface ListToolGroupsResponse {
+  data: ToolgroupListResponse;
+}
+
+/**
+ * A group of related tools managed together.
+ */
+export interface ToolGroup {
+  /**
+   * Unique identifier for this resource in llama stack
+   */
+  identifier: string;
+
+  /**
+   * ID of the provider that owns this resource
+   */
+  provider_id: string;
+
+  args?: { [key: string]: unknown } | null;
+
+  /**
+   * A URL reference to external content.
+   */
+  mcp_endpoint?: ToolGroup.McpEndpoint | null;
+
+  /**
+   * Unique identifier for this resource in the provider
+   */
+  provider_resource_id?: string | null;
+
+  type?: 'tool_group';
+}
+
+export namespace ToolGroup {
+  /**
+   * A URL reference to external content.
+   */
+  export interface McpEndpoint {
+    uri: string;
+  }
+}
+
+export type ToolgroupListResponse = Array<ToolGroup>;
+
+export interface ToolgroupRegisterParams {
+  provider_id: string;
+
+  toolgroup_id: string;
+
+  args?: { [key: string]: unknown } | null;
+
+  /**
+   * A URL reference to external content.
+   */
+  mcp_endpoint?: ToolgroupRegisterParams.McpEndpoint | null;
+}
+
+export namespace ToolgroupRegisterParams {
+  /**
+   * A URL reference to external content.
+   */
+  export interface McpEndpoint {
+    uri: string;
+  }
+}
+
+export declare namespace Toolgroups {
+  export {
+    type ListToolGroupsResponse as ListToolGroupsResponse,
+    type ToolGroup as ToolGroup,
+    type ToolgroupListResponse as ToolgroupListResponse,
+    type ToolgroupRegisterParams as ToolgroupRegisterParams,
+  };
+}

package/dist/src/resources/tools.ts

@@ -0,0 +1,52 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+// All rights reserved.
+//
+// This source code is licensed under the terms described in the LICENSE file in
+// the root directory of this source tree.
+//
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../resource';
+import { isRequestOptions } from '../core';
+import * as Core from '../core';
+import * as ToolRuntimeAPI from './tool-runtime';
+
+export class Tools extends APIResource {
+  /**
+   * List tools with optional tool group.
+   *
+   * @deprecated
+   */
+  list(query?: ToolListParams, options?: Core.RequestOptions): Core.APIPromise<ToolListResponse>;
+  list(options?: Core.RequestOptions): Core.APIPromise<ToolListResponse>;
+  list(
+    query: ToolListParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<ToolListResponse> {
+    if (isRequestOptions(query)) {
+      return this.list({}, query);
+    }
+    return (
+      this._client.get('/v1/tools', { query, ...options }) as Core.APIPromise<{ data: ToolListResponse }>
+    )._thenUnwrap((obj) => obj.data);
+  }
+
+  /**
+   * Get a tool by its name.
+   *
+   * @deprecated
+   */
+  get(toolName: string, options?: Core.RequestOptions): Core.APIPromise<ToolRuntimeAPI.ToolDef> {
+    return this._client.get(`/v1/tools/${toolName}`, options);
+  }
+}
+
+export type ToolListResponse = Array<ToolRuntimeAPI.ToolDef>;
+
+export interface ToolListParams {
+  toolgroup_id?: string | null;
+}
+
+export declare namespace Tools {
+  export { type ToolListResponse as ToolListResponse, type ToolListParams as ToolListParams };
+}