@effect/ai 0.33.1 → 0.34.0

package/src/Chat.ts

@@ -78,10 +78,10 @@ import type * as Tool from "./Tool.js"
  * @example
  * ```ts
  * import { Chat } from "@effect/ai"
- * import { Effect } from "effect"
+ * import * as Effect from "effect/Effect"
  *
  * const useChat = Effect.gen(function* () {
- *   const chat = yield* Chat
+ *   const chat = yield* Chat.Chat
  *   const response = yield* chat.generateText({
  *     prompt: "Explain quantum computing in simple terms"
  *   })

package/src/EmbeddingModel.ts

@@ -69,10 +69,17 @@ import * as AiError from "./AiError.js"
  * @example
  * ```ts
  * import { EmbeddingModel } from "@effect/ai"
- * import { Effect } from "effect"
+ * import * as Effect from "effect/Effect"
+ *
+ * const cosineSimilarity = (a: ReadonlyArray<number>, b: ReadonlyArray<number>): number => {
+ *   const dot = a.reduce((sum, ai, i) => sum + ai * (b[i] ?? 0), 0)
+ *   const normA = Math.sqrt(a.reduce((sum, ai) => sum + ai * ai, 0))
+ *   const normB = Math.sqrt(b.reduce((sum, bi) => sum + bi * bi, 0))
+ *   return normA === 0 || normB === 0 ? 0 : dot / (normA * normB)
+ * }
  *
  * const useEmbeddings = Effect.gen(function* () {
- *   const embedder = yield* EmbeddingModel
+ *   const embedder = yield* EmbeddingModel.EmbeddingModel
  *
  *   const documentVector = yield* embedder.embed("This is a sample document")
  *   const queryVector = yield* embedder.embed("sample query")

package/src/LanguageModel.ts

@@ -83,10 +83,10 @@ import * as Toolkit from "./Toolkit.js"
  * @example
  * ```ts
  * import { LanguageModel } from "@effect/ai"
- * import { Effect } from "effect"
+ * import * as Effect from "effect/Effect"
  *
  * const useLanguageModel = Effect.gen(function* () {
- *   const model = yield* LanguageModel
+ *   const model = yield* LanguageModel.LanguageModel
  *   const response = yield* model.generateText({
  *     prompt: "What is machine learning?"
  *   })

package/src/Prompt.ts

@@ -611,7 +611,8 @@ export const toolCallPart = (params: PartConstructorParams<ToolCallPart>): ToolC
  *     temperature: 22,
  *     condition: "sunny",
  *     humidity: 65
- *   }
+ *   },
+ *   providerExecuted: false
  * })
  * ```
  *
@@ -635,6 +636,10 @@ export interface ToolResultPart extends BasePart<"tool-result", ToolResultPartOp
    * The result returned by the tool execution.
    */
   readonly result: unknown
+  /**
+   * Whether the tool was executed by the provider (true) or framework (false).
+   */
+  readonly providerExecuted: boolean
 }
 
 /**
@@ -660,6 +665,10 @@ export interface ToolResultPartEncoded extends BasePartEncoded<"tool-result", To
    * The result returned by the tool execution.
    */
   readonly result: unknown
+  /**
+   * Whether the tool was executed by the provider (true) or framework (false).
+   */
+  readonly providerExecuted: boolean
 }
 
 /**
@@ -683,6 +692,7 @@ export const ToolResultPart: Schema.Schema<ToolResultPart, ToolResultPartEncoded
   name: Schema.String,
   isFailure: Schema.Boolean,
   result: Schema.Unknown,
+  providerExecuted: Schema.Boolean,
   options: Schema.optionalWith(ProviderOptions, { default: constEmptyObject })
 }).pipe(
   Schema.attachPropertySignature(PartTypeId, PartTypeId),
@@ -1036,7 +1046,8 @@ export const userMessage = (params: MessageConstructorParams<UserMessage>): User
  *       result: {
  *         temperature: 72,
  *         condition: "sunny"
- *       }
+ *       },
+ *       providerExecuted: false
  *     }),
  *     Prompt.makePart("text", {
  *       text: "The weather in San Francisco is currently 72°F and sunny."
@@ -1150,7 +1161,8 @@ export const assistantMessage = (params: MessageConstructorParams<AssistantMessa
  *           { title: "TypeScript Handbook", url: "https://..." },
  *           { title: "Effective TypeScript", url: "https://..." }
  *         ]
- *       }
+ *       },
+ *       providerExecuted: false
  *     })
  *   ]
  * })
@@ -1624,12 +1636,18 @@ export const fromResponseParts = (parts: ReadonlyArray<Response.AnyPart>): Promp
 
       // Tool Result Parts
       case "tool-result": {
-        toolParts.push(makePart("tool-result", {
+        const toolPart = makePart("tool-result", {
           id: part.id,
           name: part.providerName ?? part.name,
           isFailure: part.isFailure,
-          result: part.encodedResult
-        }))
+          result: part.encodedResult,
+          providerExecuted: part.providerExecuted ?? false
+        })
+        if (part.providerExecuted) {
+          assistantParts.push(toolPart)
+        } else {
+          toolParts.push(toolPart)
+        }
       }
     }
   }

package/src/Telemetry.ts

@@ -627,11 +627,13 @@ export interface SpanTransformer {
  * @example
  * ```ts
  * import { Telemetry } from "@effect/ai"
- * import { Context, Effect } from "effect"
+ * import * as Effect from "effect/Effect"
+ *
+ * declare const myAIOperation: Effect.Effect<void>
  *
  * // Create a custom span transformer
  * const loggingTransformer: Telemetry.SpanTransformer = (options) => {
- *   console.log(`AI request completed: ${options.model}`)
+ *   console.log(`AI request completed: ${options.response.length} part(s)`)
  *   options.response.forEach((part, index) => {
  *     console.log(`Part ${index}: ${part.type}`)
  *   })

package/src/Tool.ts

@@ -1297,15 +1297,6 @@ export const getJsonSchema = <
 export const getJsonSchemaFromSchemaAst = (
   ast: AST.AST
 ): JsonSchema.JsonSchema7 => {
-  const props = AST.getPropertySignatures(ast)
-  if (props.length === 0) {
-    return {
-      type: "object",
-      properties: {},
-      required: [],
-      additionalProperties: false
-    }
-  }
   const $defs = {}
   const schema = JsonSchema.fromAST(ast, {
     definitions: $defs,