@effect/ai 0.14.1 → 0.16.0

package/dist/dts/AiTool.d.ts

@@ -0,0 +1,288 @@
+/**
+ * @since 1.0.0
+ */
+import type * as Context_ from "effect/Context";
+import type * as Effect from "effect/Effect";
+import { type Pipeable } from "effect/Pipeable";
+import * as Schema from "effect/Schema";
+import * as AST from "effect/SchemaAST";
+import type * as Types from "effect/Types";
+import type { AiError } from "./AiError.js";
+/**
+ * @since 1.0.0
+ * @category Type Ids
+ */
+export declare const TypeId: unique symbol;
+/**
+ * @since 1.0.0
+ * @category Type Ids
+ */
+export type TypeId = typeof TypeId;
+/**
+ * A `AiTool` represents an action that a large language model can take within
+ * your application. The results of a tool call can be returned back to the
+ * large language model to be incorporated into its next response.
+ *
+ * @since 1.0.0
+ * @category Models
+ */
+export interface AiTool<out Name extends string, out Parameters extends AnyStructSchema = Schema.Struct<{}>, out Success extends Schema.Schema.Any = typeof Schema.Void, out Failure extends Schema.Schema.All = typeof Schema.Never, out Requirements = never> extends Pipeable {
+    readonly [TypeId]: {
+        readonly _Requirements: Types.Covariant<Requirements>;
+    };
+    /**
+     * The name of the tool.
+     */
+    readonly name: Name;
+    /**
+     * The optional description of the tool.
+     */
+    readonly description?: string | undefined;
+    /**
+     * A key for the tool, used to identify the tool within a `Context`.
+     */
+    readonly key: string;
+    /**
+     * A `Schema` representing the type of the parameters that a tool handler
+     * must be called with.
+     */
+    readonly parametersSchema: Parameters;
+    /**
+     * A `Schema` representing the type that a tool returns from its handler
+     * if successful.
+     */
+    readonly successSchema: Success;
+    /**
+     * A `Schema` representing the type that a tool returns from its handler
+     * if it fails.
+     */
+    readonly failureSchema: Failure;
+    /**
+     * Adds a requirement on a particular service for the tool call to be able to
+     * be executed.
+     */
+    addRequirement<Requirement>(): AiTool<Name, Parameters, Success, Failure, Requirements | Requirement>;
+    /**
+     * Set the schema to use for tool handler success.
+     */
+    setSuccess<SuccessSchema extends Schema.Schema.Any>(schema: SuccessSchema): AiTool<Name, Parameters, SuccessSchema, Failure>;
+    /**
+     * Set the schema to use for tool handler failure.
+     */
+    setFailure<FailureSchema extends Schema.Schema.Any>(schema: FailureSchema): AiTool<Name, Parameters, Success, FailureSchema>;
+    /**
+     * Set the schema for the tool parameters.
+     */
+    setParameters<ParametersSchema extends Schema.Struct<any> | Schema.Struct.Fields>(schema: ParametersSchema): AiTool<Name, ParametersSchema extends Schema.Struct<infer _> ? ParametersSchema : ParametersSchema extends Schema.Struct.Fields ? Schema.Struct<ParametersSchema> : never, Success>;
+}
+/**
+ * @since 1.0.0
+ * @category Guards
+ */
+export declare const isAiTool: (u: unknown) => u is AiTool<any, any, any, any, any>;
+/**
+ * @since 1.0.0
+ * @category Models
+ */
+export interface Any extends Pipeable {
+    readonly [TypeId]: {
+        readonly _Requirements: Types.Covariant<any>;
+    };
+    readonly name: string;
+    readonly description?: string | undefined;
+    readonly key: string;
+    readonly parametersSchema: AnyStructSchema;
+}
+/**
+ * @since 1.0.0
+ * @category Models
+ */
+export interface AnyWithProtocol extends Any {
+    readonly successSchema: Schema.Schema.Any;
+    readonly failureSchema: Schema.Schema.All;
+}
+/**
+ * Represents an `AiTool` that has been implemented within the application.
+ *
+ * @since 1.0.0
+ * @category Models
+ */
+export interface Handler<Name extends string> {
+    readonly _: unique symbol;
+    readonly name: Name;
+    readonly handler: (params: any) => Effect.Effect<any, any>;
+    readonly context: Context_.Context<never>;
+}
+/**
+ * A utility type which returns the type of the `Effect` that will be used to
+ * resolve a tool call.
+ *
+ * @since 1.0.0
+ * @category Utility Types
+ */
+export type HandlerEffect<Tool extends Any> = [Tool] extends [
+    AiTool<infer _Name, infer _Parameters, infer _Success, infer _Failure, infer _Requirements>
+] ? Effect.Effect<_Success["Type"], AiError | _Failure["Type"], _Parameters["Context"] | _Success["Context"] | _Failure["Context"] | _Requirements> : never;
+/**
+ * Represents the result of calling the handler for a particular tool.
+ *
+ * @since 1.0.0
+ * @category Models
+ */
+export interface HandlerResult<Tool extends Any> {
+    /**
+     * The result of executing the handler for a particular tool.
+     */
+    readonly result: Success<Tool>;
+    /**
+     * The encoded result of executing the handler for a particular tool, which
+     * is suitable for returning back to the large language model for
+     * incorporation into further responses.
+     */
+    readonly encodedResult: unknown;
+}
+/**
+ * A utility mapped type which associates tool names with tools.
+ *
+ * @since 1.0.0
+ * @category Utility Types
+ */
+export type ByName<Tools extends Any> = {
+    readonly [Tool in Tools as Tool["name"]]: Tool;
+};
+/**
+ * A utility type to extract the `Name` type from an `AiTool`.
+ *
+ * @since 1.0.0
+ * @category Utility Types
+ */
+export type Name<Tool> = Tool extends AiTool<infer _Name, infer _Parameters, infer _Success, infer _Failure, infer _Requirements> ? _Name : never;
+/**
+ * A utility type to extract the type of the parameters which an `AiTool` must
+ * be called with.
+ *
+ * @since 1.0.0
+ * @category Utility Types
+ */
+export type Parameters<Tool> = Tool extends AiTool<infer _Name, infer _Parameters, infer _Success, infer _Failure, infer _Requirements> ? _Parameters["Type"] : never;
+/**
+ * A utility type to extract the schema type of the parameters which an `AiTool`
+ * must be called with.
+ *
+ * @since 1.0.0
+ * @category Utility Types
+ */
+export type ParametersSchema<Tool> = Tool extends AiTool<infer _Name, infer _Parameters, infer _Success, infer _Failure, infer _Requirements> ? _Parameters : never;
+/**
+ * A utility type to extract the type of the response that an `AiTool` returns
+ * from its handler if successful.
+ *
+ * @since 1.0.0
+ * @category Utility Types
+ */
+export type Success<Tool> = Tool extends AiTool<infer _Name, infer _Parameters, infer _Success, infer _Failure, infer _Requirements> ? _Success["Type"] : never;
+/**
+ * A utility type to extract the schema type of the response that an `AiTool`
+ * returns from its handler if successful.
+ *
+ * @since 1.0.0
+ * @category Utility Types
+ */
+export type SuccessSchema<Tool> = Tool extends AiTool<infer _Name, infer _Parameters, infer _Success, infer _Failure, infer _Requirements> ? _Success : never;
+/**
+ * A utility type to extract the type of the response that an `AiTool` returns
+ * from its handler if it fails.
+ *
+ * @since 1.0.0
+ * @category Utility Types
+ */
+export type Failure<Tool> = Tool extends AiTool<infer _Name, infer _Parameters, infer _Success, infer _Failure, infer _Requirements> ? _Failure["Type"] : never;
+/**
+ * A utility type to extract the schema type of the response that an `AiTool`
+ * returns from its handler if it fails.
+ *
+ * @since 1.0.0
+ * @category Utility Types
+ */
+export type FailureSchema<Tool> = Tool extends AiTool<infer _Name, infer _Parameters, infer _Success, infer _Failure, infer _Requirements> ? _Failure : never;
+/**
+ * A utility type to the `Context` type from an `AiTool`.
+ *
+ * @since 1.0.0
+ * @category Utility Types
+ */
+export type Context<Tool> = Tool extends AiTool<infer _Name, infer _Parameters, infer _Success, infer _Failure, infer _Requirements> ? _Parameters["Context"] | _Success["Context"] | _Failure["Context"] | _Requirements : never;
+/**
+ * @since 1.0.0
+ * @category Utility Types
+ */
+export interface AnyStructSchema extends Pipeable {
+    readonly [Schema.TypeId]: any;
+    readonly make: any;
+    readonly Type: any;
+    readonly Encoded: any;
+    readonly Context: any;
+    readonly ast: AST.AST;
+    readonly fields: Schema.Struct.Fields;
+    readonly annotations: any;
+}
+/**
+ * @since 1.0.0
+ * @category Utility Types
+ */
+export interface AnyTaggedRequestSchema extends AnyStructSchema {
+    readonly _tag: string;
+    readonly success: Schema.Schema.Any;
+    readonly failure: Schema.Schema.All;
+}
+/**
+ * A utility type to convert a `Schema.TaggedRequest` into an `AiTool`.
+ *
+ * @since 1.0.0
+ * @category Utility Types
+ */
+export interface FromTaggedRequest<S extends AnyTaggedRequestSchema> extends AiTool<S["_tag"], S, S["success"], S["failure"]> {
+}
+/**
+ * A utility type which returns the handler type for an `AiTool`.
+ *
+ * @since 1.0.0
+ * @category Utility Types
+ */
+export type ToHandler<Tool extends Any> = Tool extends AiTool<infer _Name, infer _Parameters, infer _Success, infer _Failure, infer _Requirements> ? Handler<_Name> : never;
+/**
+ * Constructs an `AiTool` from a name and, optionally, a specification for the
+ * tool call's protocol.
+ *
+ * @since 1.0.0
+ * @category constructors
+ */
+export declare const make: <const Name extends string, Parameters extends Schema.Struct.Fields = {}, Success extends Schema.Schema.Any = typeof Schema.Void, Failure extends Schema.Schema.All = typeof Schema.Never>(name: Name, options?: {
+    /**
+     * An optional description of the tool.
+     */
+    readonly description?: string | undefined;
+    /**
+     * A `Schema` representing the type of the parameters that a tool call
+     * handler must be provided with.
+     */
+    readonly parameters?: Parameters;
+    /**
+     * A `Schema` representing the type that a tool returns from its handler if
+     * successful.
+     */
+    readonly success?: Success;
+    /**
+     * A `Schema` representing the type that a tool returns from its handler if
+     * it fails.
+     */
+    readonly failure?: Failure;
+}) => AiTool<Name, Schema.Struct<Parameters>, Success, Failure>;
+/**
+ * Constructs a new `AiTool` from a `Schema.TaggedRequest`.
+ *
+ * @since 1.0.0
+ * @category constructors
+ */
+export declare const fromTaggedRequest: <S extends AnyTaggedRequestSchema>(schema: S) => FromTaggedRequest<S>;
+//# sourceMappingURL=AiTool.d.ts.map

package/dist/dts/AiTool.d.ts.map

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

package/dist/dts/AiToolkit.d.ts

@@ -3,154 +3,93 @@
  */
 import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
-import * as HashMap from "effect/HashMap";
-import * as Inspectable from "effect/Inspectable";
+import type { Inspectable } from "effect/Inspectable";
 import * as Layer from "effect/Layer";
-import type * as Schema from "effect/Schema";
-import type { Scope } from "effect/Scope";
-import type * as Types from "effect/Types";
+import type { Pipeable } from "effect/Pipeable";
+import type * as Scope from "effect/Scope";
+import * as AiTool from "./AiTool.js";
 /**
  * @since 1.0.0
- * @category type ids
+ * @category Type Ids
  */
 export declare const TypeId: unique symbol;
 /**
  * @since 1.0.0
- * @category type ids
+ * @category Type Ids
  */
 export type TypeId = typeof TypeId;
 /**
+ * An `AiToolkit` represents a set of tools that a large language model can
+ * use to augment its response.
+ *
  * @since 1.0.0
- * @category models
+ * @category Models
  */
-export interface AiToolkit<in out Tools extends Tool.AnySchema> extends Effect.Effect<Handlers<Tools>, never, Tool.Services<Tools> | Registry>, Inspectable.Inspectable {
+export interface AiToolkit<in out Tools extends AiTool.Any> extends Effect.Effect<ToHandler<Tools>, never, AiTool.ToHandler<Tools>>, Inspectable, Pipeable {
+    new (_: never): {};
     readonly [TypeId]: TypeId;
-    readonly tools: HashMap.HashMap<string, Tools>;
-    readonly add: <S extends Tool.AnySchema>(tool: S) => AiToolkit<Tools | S>;
-    readonly addAll: <ToAdd extends ReadonlyArray<Tool.AnySchema>>(...tools: ToAdd) => AiToolkit<Tools | ToAdd[number]>;
-    readonly concat: <T extends Tool.AnySchema>(that: AiToolkit<T>) => AiToolkit<Tools | T>;
-    readonly implement: <R, EX = never, RX = never>(f: (handlers: Handlers<Tools>) => Handlers<never, R> | Effect.Effect<Handlers<never, R>, EX, RX>) => Layer.Layer<Tool.ServiceFromTag<Tools["_tag"]> | Registry, EX, Exclude<R | RX, Scope>>;
-}
-/**
- * @since 1.0.0
- * @category models
- */
-export declare namespace AiToolkit {
-    /**
-     * @since 1.0.0
-     * @category models
-     */
-    type Tools<A> = A extends AiToolkit<infer Tools> ? Tools : never;
-    /**
-     * @since 1.0.0
-     * @category models
-     */
-    type SuccessSchema<A> = A extends AiToolkit<infer Tools> ? Tools["success"] : never;
-}
-/**
- * @since 1.0.0
- * @category tool
- */
-export declare namespace Tool {
-    /**
-     * @since 1.0.0
-     * @category tool
-     */
-    interface AnySchema {
-        readonly [Schema.TypeId]: any;
-        readonly _tag: string;
-        readonly Type: Schema.SerializableWithResult.All;
-        readonly success: Schema.Schema.Any;
-    }
-    /**
-     * @since 1.0.0
-     * @category tool
-     */
-    type Success<Tool extends AnySchema> = Schema.WithResult.Success<Tool["Type"]>;
-    /**
-     * @since 1.0.0
-     * @category tool
-     */
-    type Failure<Tool extends AnySchema> = Schema.WithResult.Failure<Tool["Type"]>;
-    /**
-     * @since 1.0.0
-     * @category tool
-     */
-    type Context<Tool extends AnySchema> = Schema.WithResult.Context<Tool["Type"]>;
-    /**
-     * @since 1.0.0
-     * @category tool
-     */
-    type Handler<Tool extends AnySchema, R> = (params: Tool["Type"]) => Effect.Effect<Success<Tool>, Failure<Tool>, R>;
     /**
-     * @since 1.0.0
-     * @category tool
+     * A map containing the tools that are part of this toolkit.
      */
-    type HandlerAny = (params: any) => Effect.Effect<any, any, any>;
+    readonly tools: AiTool.ByName<Tools>;
     /**
-     * @since 1.0.0
-     * @category tool
+     * Converts this toolkit into a `Context` object containing the handlers for
+     * all tools in the toolkit.
      */
-    interface Service<Tag extends string> {
-        readonly _: unique symbol;
-        readonly name: Types.Invariant<Tag>;
-    }
+    toContext<Handlers extends HandlersFrom<Tools>, EX = never, RX = never>(build: Handlers | Effect.Effect<Handlers, EX, RX>): Effect.Effect<Context.Context<AiTool.ToHandler<Tools>>, EX, RX>;
     /**
-     * @since 1.0.0
-     * @category tool
+     * Converts this toolkit into a `Layer` containing the handlers for all tools
+     * in the toolkit.
      */
-    type ServiceFromTag<Tag extends string> = Tag extends infer T ? T extends string ? Service<T> : never : never;
-    /**
-     * @since 1.0.0
-     * @category tool
-     */
-    type Services<Tools extends AnySchema> = ServiceFromTag<Tools["_tag"]>;
+    toLayer<Handlers extends HandlersFrom<Tools>, EX = never, RX = never>(build: Handlers | Effect.Effect<Handlers, EX, RX>): Layer.Layer<AiTool.ToHandler<Tools>, EX, Exclude<RX, Scope.Scope>>;
 }
-declare const Registry_base: Context.TagClass<Registry, "@effect/ai/AiToolkit/Registry", Map<Tool.AnySchema, Tool.HandlerAny>>;
 /**
  * @since 1.0.0
- * @category registry
+ * @category Models
  */
-export declare class Registry extends Registry_base {
-    static readonly Live: Layer.Layer<Registry>;
+export interface Any {
+    readonly [TypeId]: TypeId;
+    readonly tools: ReadonlyMap<string, AiTool.Any>;
 }
 /**
+ * Represents an `AiToolkit` which has been augmented with a handler function
+ * for resolving tool call requests.
+ *
  * @since 1.0.0
- * @category constructors
+ * @category Models
  */
-export declare const empty: AiToolkit<never>;
+export interface ToHandler<in out Tool extends AiTool.Any> {
+    readonly tools: ReadonlyArray<Tool>;
+    readonly handle: (toolName: AiTool.Name<Tool>, toolParams: AiTool.Parameters<Tool>) => AiTool.HandlerEffect<Tool>;
+}
 /**
+ * A utility mapped type which associates tool names with their handlers.
+ *
  * @since 1.0.0
- * @category handlers
+ * @category Utility Types
  */
-export declare const HandlersTypeId: unique symbol;
+export type HandlersFrom<Tool extends AiTool.Any> = {
+    [Name in Tool as Tool["name"]]: (params: AiTool.Parameters<Tool>) => AiTool.HandlerEffect<Tool>;
+};
 /**
+ * A utility type which returns the tools in an `AiToolkit`.
+ *
  * @since 1.0.0
- * @category handlers
+ * @category Utility Types
  */
-export type HandlersTypeId = typeof HandlersTypeId;
+export type Tools<Toolkit> = Toolkit extends AiToolkit<infer Tool> ? string extends Tool["name"] ? never : Tool : never;
 /**
+ * Constructs a new `AiToolkit` from the specified tools.
+ *
  * @since 1.0.0
- * @category handlers
+ * @category Constructors
  */
-export interface Handlers<in out Tools extends Tool.AnySchema, R = never> {
-    readonly [HandlersTypeId]: Handlers.Variance<Tools>;
-    readonly toolkit: AiToolkit<Tools>;
-    readonly handlers: HashMap.HashMap<string, Tool.Handler<any, R>>;
-    readonly handle: <Tag extends Types.Tags<Tools>, RH>(tag: Tag, f: Tool.Handler<Types.ExtractTag<Tools, Tag>, RH>) => Handlers<Types.ExcludeTag<Tools, Tag>, R | RH | Tool.Context<Types.ExtractTag<Tools, Tag>>>;
-}
+export declare const make: <const Tools extends ReadonlyArray<AiTool.Any>>(...tools: Tools) => AiToolkit<Tools[number]>;
 /**
+ * Merges this toolkit with one or more other toolkits.
+ *
  * @since 1.0.0
- * @category handlers
+ * @category Merging
  */
-export declare namespace Handlers {
-    /**
-     * @since 1.0.0
-     * @category handlers
-     */
-    interface Variance<Tools extends Tool.AnySchema> {
-        readonly _Tools: Types.Invariant<Tools>;
-    }
-}
-export {};
+export declare const merge: <const Toolkits extends ReadonlyArray<Any>>(...toolkits: Toolkits) => AiToolkit<Tools<Toolkits[number]>>;
 //# sourceMappingURL=AiToolkit.d.ts.map

package/dist/dts/AiToolkit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AiToolkit.d.ts","sourceRoot":"","sources":["../../src/AiToolkit.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AiToolkit.d.ts","sourceRoot":"","sources":["../../src/AiToolkit.ts"],"names":[],"mappings":"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"}

package/dist/dts/Tokenizer.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @since 1.0.0
+ */
 import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
 import type { AiError } from "./AiError.js";
@@ -5,27 +8,26 @@ import * as AiInput from "./AiInput.js";
 declare const Tokenizer_base: Context.TagClass<Tokenizer, "@effect/ai/Tokenizer", Tokenizer.Service>;
 /**
  * @since 1.0.0
- * @category tags
+ * @category Tags
  */
 export declare class Tokenizer extends Tokenizer_base {
 }
 /**
  * @since 1.0.0
- * @category models
  */
 export declare namespace Tokenizer {
     /**
      * @since 1.0.0
-     * @models
+     * @category Models
      */
     interface Service {
-        readonly tokenize: (content: AiInput.Input) => Effect.Effect<Array<number>, AiError>;
-        readonly truncate: (content: AiInput.Input, tokens: number) => Effect.Effect<AiInput.Input, AiError>;
+        readonly tokenize: (input: AiInput.Raw) => Effect.Effect<Array<number>, AiError>;
+        readonly truncate: (input: AiInput.Raw, tokens: number) => Effect.Effect<AiInput.AiInput, AiError>;
     }
 }
 /**
  * @since 1.0.0
- * @category constructors
+ * @category Constructors
  */
 export declare const make: (options: {
     readonly tokenize: (content: AiInput.AiInput) => Effect.Effect<Array<number>, AiError>;

package/dist/dts/Tokenizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Tokenizer.d.ts","sourceRoot":"","sources":["../../src/Tokenizer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE3C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;;AAEvC;;;GAGG;AACH,qBAAa,SAAU,SAAQ,cAG5B;CAAG;AAEN;;;GAGG;AACH,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC;;;OAGG;IACH,UAAiB,OAAO;QACtB,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAA;QACpF,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;KACrG;CACF;AAED;;;GAGG;AACH,eAAO,MAAM,IAAI,YAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAA;CACvF,KAAG,SAAS,CAAC,OAQV,CAAA"}
+{"version":3,"file":"Tokenizer.d.ts","sourceRoot":"","sources":["../../src/Tokenizer.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;;AAEvC;;;GAGG;AACH,qBAAa,SAAU,SAAQ,cAG5B;CAAG;AAEN;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC;;;OAGG;IACH,UAAiB,OAAO;QACtB,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAA;QAChF,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;KACnG;CACF;AAED;;;GAGG;AACH,eAAO,MAAM,IAAI,YAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAA;CACvF,KAAG,SAAS,CAAC,OAQV,CAAA"}

package/dist/dts/index.d.ts

@@ -2,6 +2,10 @@
  * @since 1.0.0
  */
 export * as AiChat from "./AiChat.js";
+/**
+ * @since 1.0.0
+ */
+export * as AiEmbeddingModel from "./AiEmbeddingModel.js";
 /**
  * @since 1.0.0
  */
@@ -13,11 +17,11 @@ export * as AiInput from "./AiInput.js";
 /**
  * @since 1.0.0
  */
-export * as AiModel from "./AiModel.js";
+export * as AiLanguageModel from "./AiLanguageModel.js";
 /**
  * @since 1.0.0
  */
-export * as AiModels from "./AiModels.js";
+export * as AiModel from "./AiModel.js";
 /**
  * @since 1.0.0
  */
@@ -26,10 +30,6 @@ export * as AiPlan from "./AiPlan.js";
  * @since 1.0.0
  */
 export * as AiResponse from "./AiResponse.js";
-/**
- * @since 1.0.0
- */
-export * as AiRole from "./AiRole.js";
 /**
  * @since 1.0.0
  */
@@ -37,15 +37,11 @@ export * as AiTelemetry from "./AiTelemetry.js";
 /**
  * @since 1.0.0
  */
-export * as AiToolkit from "./AiToolkit.js";
-/**
- * @since 1.0.0
- */
-export * as Completions from "./Completions.js";
+export * as AiTool from "./AiTool.js";
 /**
  * @since 1.0.0
  */
-export * as Embeddings from "./Embeddings.js";
+export * as AiToolkit from "./AiToolkit.js";
 /**
  * @since 1.0.0
  */

package/dist/dts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;GAEG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC;;GAEG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC;;GAEG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC;;GAEG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAEzC;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;GAEG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;GAEG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAE3C;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;GAEG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;GAEG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;GAEG;AACH,OAAO,KAAK,gBAAgB,MAAM,uBAAuB,CAAA;AAEzD;;GAEG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC;;GAEG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC;;GAEG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AAEvD;;GAEG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;GAEG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;GAEG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAE3C;;GAEG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA"}

package/dist/dts/internal/common.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=common.d.ts.map

package/dist/dts/internal/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/internal/common.ts"],"names":[],"mappings":""}