effect 4.0.0-beta.99 → 4.0.0-rc.108

package/dist/unstable/ai/Chat.d.ts

@@ -30,17 +30,35 @@ declare const Chat_base: Context.ServiceClass<Chat, "effect/ai/Chat", Service>;
  *
  * **Example** (Accessing the Chat service)
  *
- * ```ts
- * import { Effect } from "effect"
- * import { Chat } from "effect/unstable/ai"
+ * ```ts import.meta.vitest
+ * import { Effect, Layer, Stream } from "effect"
+ * import { Chat, LanguageModel } from "effect/unstable/ai"
+ *
+ * const FakeLanguageModel = Layer.effect(
+ *   LanguageModel.LanguageModel,
+ *   LanguageModel.make({
+ *     generateText: () =>
+ *       Effect.succeed([{
+ *         type: "text",
+ *         text: "Quantum computers use quantum states to process information."
+ *       }]),
+ *     streamText: () => Stream.empty
+ *   })
+ * )
+ *
+ * const ChatLayer = Layer.effect(Chat.Chat, Chat.empty)
  *
  * const program = Effect.gen(function*() {
- *   const chat = yield* Chat.empty
+ *   const chat = yield* Chat.Chat
  *   const response = yield* chat.generateText({
  *     prompt: "Explain quantum computing in simple terms"
  *   })
- *   return response.content
+ *   return response.text
  * })
+ *
+ * await Effect.runPromise(
+ *   program.pipe(Effect.provide(Layer.merge(ChatLayer, FakeLanguageModel)))
+ * ) // => "Quantum computers use quantum states to process information."
  * ```
  *
  * @category services
@@ -74,16 +92,17 @@ export interface Service {
      *
      * **Example** (Inspecting chat history)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, Ref } from "effect"
      * import { Chat } from "effect/unstable/ai"
      *
      * const inspectHistory = Effect.gen(function*() {
-     *   const chat = yield* Chat.empty
+     *   const chat = yield* Chat.fromPrompt("Hello")
      *   const currentHistory = yield* Ref.get(chat.history)
-     *   console.log("Current conversation:", currentHistory)
-     *   return currentHistory
+     *   return currentHistory.content.length
      * })
+     *
+     * await Effect.runPromise(inspectHistory) // => 1
      * ```
      */
     readonly history: Ref.Ref<Prompt.Prompt>;
@@ -97,19 +116,17 @@ export interface Service {
      *
      * **Example** (Exporting chat history)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect } from "effect"
      * import { Chat } from "effect/unstable/ai"
      *
      * const saveChat = Effect.gen(function*() {
-     *   const chat = yield* Chat.empty
-     *   yield* chat.generateText({ prompt: "Hello!" })
-     *
+     *   const chat = yield* Chat.fromPrompt("Hello!")
      *   const exportedData = yield* chat.export
-     *
-     *   // Save to database or file system
-     *   return exportedData
+     *   return typeof exportedData
      * })
+     *
+     * await Effect.runPromise(saveChat) // => "object"
      * ```
      */
     readonly export: Effect.Effect<unknown, AiError.AiError>;
@@ -123,21 +140,17 @@ export interface Service {
      *
      * **Example** (Exporting chat history as JSON)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect } from "effect"
      * import { Chat } from "effect/unstable/ai"
      *
      * const backupChat = Effect.gen(function*() {
-     *   const chat = yield* Chat.empty
-     *
-     *   yield* chat.generateText({ prompt: "Explain photosynthesis" })
-     *
+     *   const chat = yield* Chat.fromPrompt("Explain photosynthesis")
      *   const jsonBackup = yield* chat.exportJson
-     *
-     *   yield* Effect.sync(() => localStorage.setItem("chat-backup", jsonBackup))
-     *
-     *   return jsonBackup
+     *   return JSON.parse(jsonBackup).content.length
      * })
+     *
+     * await Effect.runPromise(backupChat) // => 1
      * ```
      */
     readonly exportJson: Effect.Effect<string, AiError.AiError>;
@@ -152,9 +165,23 @@ export interface Service {
      *
      * **Example** (Generating chat responses)
      *
-     * ```ts
-     * import { Effect } from "effect"
-     * import { Chat } from "effect/unstable/ai"
+     * ```ts import.meta.vitest
+     * import { Effect, Layer, Stream } from "effect"
+     * import { Chat, LanguageModel } from "effect/unstable/ai"
+     *
+     * const FakeLanguageModel = Layer.effect(
+     *   LanguageModel.LanguageModel,
+     *   LanguageModel.make({
+     *     generateText: (options) =>
+     *       Effect.succeed([{
+     *         type: "text",
+     *         text: options.prompt.content.length === 1
+     *           ? "The capital of France is Paris."
+     *           : "Paris has about 2.1 million residents."
+     *       }]),
+     *     streamText: () => Stream.empty
+     *   })
+     * )
      *
      * const chatWithAI = Effect.gen(function*() {
      *   const chat = yield* Chat.empty
@@ -162,13 +189,13 @@ export interface Service {
      *   const response1 = yield* chat.generateText({
      *     prompt: "What is the capital of France?"
      *   })
-     *
      *   const response2 = yield* chat.generateText({
      *     prompt: "What's the population of that city?"
      *   })
-     *
-     *   return [response1.content, response2.content]
+     *   return [response1.text, response2.text]
      * })
+     *
+     * await Effect.runPromise(chatWithAI.pipe(Effect.provide(FakeLanguageModel))) // => ["The capital of France is Paris.", "Paris has about 2.1 million residents."]
      * ```
      */
     readonly generateText: {
@@ -196,22 +223,35 @@ export interface Service {
      *
      * **Example** (Streaming chat responses)
      *
-     * ```ts
-     * import { Effect, Stream } from "effect"
-     * import { Chat } from "effect/unstable/ai"
+     * ```ts import.meta.vitest
+     * import { Effect, Layer, Stream } from "effect"
+     * import { Chat, LanguageModel } from "effect/unstable/ai"
+     *
+     * const FakeLanguageModel = Layer.effect(
+     *   LanguageModel.LanguageModel,
+     *   LanguageModel.make({
+     *     generateText: () => Effect.succeed([]),
+     *     streamText: () =>
+     *       Stream.make(
+     *         { type: "text-delta", id: "story", delta: "A small probe reached orbit." },
+     *         { type: "text-delta", id: "story", delta: " It sent back a picture of Earth." }
+     *       )
+     *   })
+     * )
      *
      * const streamingChat = Effect.gen(function*() {
      *   const chat = yield* Chat.empty
-     *
-     *   const stream = yield* chat.streamText({
+     *   const story = yield* chat.streamText({
      *     prompt: "Write a short story about space exploration"
-     *   })
-     *
-     *   yield* Stream.runForEach(stream, (part) =>
-     *     part.type === "text-delta"
-     *       ? Effect.sync(() => process.stdout.write(part.delta))
-     *       : Effect.void)
+     *   }).pipe(
+     *     Stream.runFold(() => "", (text, part) =>
+     *       part.type === "text-delta" ? text + part.delta : text)
+     *   )
+     *   return story
      * })
+     *
+     * const story = await Effect.runPromise(streamingChat.pipe(Effect.provide(FakeLanguageModel)))
+     * story // => "A small probe reached orbit. It sent back a picture of Earth."
      * ```
      */
     readonly streamText: {
@@ -240,9 +280,9 @@ export interface Service {
      *
      * **Example** (Generating structured objects)
      *
-     * ```ts
-     * import { Effect, Schema } from "effect"
-     * import { Chat } from "effect/unstable/ai"
+     * ```ts import.meta.vitest
+     * import { Effect, Layer, Schema, Stream } from "effect"
+     * import { Chat, LanguageModel } from "effect/unstable/ai"
      *
      * const ContactSchema = Schema.Struct({
      *   name: Schema.String,
@@ -250,19 +290,28 @@ export interface Service {
      *   phone: Schema.optional(Schema.String)
      * })
      *
+     * const FakeLanguageModel = Layer.effect(
+     *   LanguageModel.LanguageModel,
+     *   LanguageModel.make({
+     *     generateText: () =>
+     *       Effect.succeed([{
+     *         type: "text",
+     *         text: '{"name":"John Doe","email":"john@example.com","phone":"555-1234"}'
+     *       }]),
+     *     streamText: () => Stream.empty
+     *   })
+     * )
+     *
      * const extractContact = Effect.gen(function*() {
      *   const chat = yield* Chat.empty
-     *
      *   const contact = yield* chat.generateObject({
      *     prompt: "Extract contact info: John Doe, john@example.com, 555-1234",
      *     schema: ContactSchema
      *   })
-     *
-     *   console.log(contact.object)
-     *   // { name: "John Doe", email: "john@example.com", phone: "555-1234" }
-     *
-     *   return contact.object
+     *   return [contact.value.name, contact.value.email, contact.value.phone]
      * })
+     *
+     * await Effect.runPromise(extractContact.pipe(Effect.provide(FakeLanguageModel))) // => ["John Doe", "john@example.com", "555-1234"]
      * ```
      */
     readonly generateObject: <ObjectEncoded extends Record<string, any>, ObjectSchema extends Schema.Encoder<ObjectEncoded, unknown>, Options extends NoExcessProperties<LanguageModel.GenerateObjectOptions<any, ObjectSchema>, Options>>(options: Options & LanguageModel.GenerateObjectOptions<LanguageModel.ExtractTools<Options>, ObjectSchema>) => Effect.Effect<LanguageModel.GenerateObjectResponse<LanguageModel.ExtractTools<Options>, ObjectSchema["Type"]>, LanguageModel.ExtractError<Options>, LanguageModel.ExtractServices<Options> | ObjectSchema["DecodingServices"] | LanguageModel.LanguageModel>;
@@ -277,21 +326,17 @@ export interface Service {
  *
  * **Example** (Creating an empty chat)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect } from "effect"
  * import { Chat } from "effect/unstable/ai"
  *
  * const freshChat = Effect.gen(function*() {
  *   const chat = yield* Chat.empty
- *
- *   const response = yield* chat.generateText({
- *     prompt: "Hello! Can you introduce yourself?"
- *   })
- *
- *   console.log(response.content)
- *
- *   return chat
+ *   const history = yield* chat.export
+ *   return (history as { content: ReadonlyArray<unknown> }).content.length
  * })
+ *
+ * await Effect.runPromise(freshChat) // => 0
  * ```
  *
  * @category constructors
@@ -308,7 +353,7 @@ export declare const empty: Effect.Effect<Service>;
  *
  * **Example** (Creating a chat from a system prompt)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect } from "effect"
  * import { Chat } from "effect/unstable/ai"
  *
@@ -318,17 +363,16 @@ export declare const empty: Effect.Effect<Service>;
  *     content: "You are a helpful assistant specialized in mathematics."
  *   }])
  *
- *   const response = yield* chat.generateText({
- *     prompt: "What is 2+2?"
- *   })
- *
- *   return response.content
+ *   const history = yield* chat.export
+ *   return (history as { content: ReadonlyArray<unknown> }).content.length
  * })
+ *
+ * await Effect.runPromise(chatWithSystemPrompt) // => 1
  * ```
  *
  * **Example** (Restoring chat history from a prompt)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect } from "effect"
  * import { Chat } from "effect/unstable/ai"
  *
@@ -349,12 +393,11 @@ export declare const empty: Effect.Effect<Service>;
  *     }
  *   ])
  *
- *   const response = yield* chat.generateText({
- *     prompt: "I need help with TypeScript"
- *   })
- *
- *   return response
+ *   const history = yield* chat.export
+ *   return (history as { content: ReadonlyArray<unknown> }).content.length
  * })
+ *
+ * await Effect.runPromise(existingChat) // => 3
  * ```
  *
  * @category constructors
@@ -372,7 +415,7 @@ export declare const fromPrompt: (prompt: Prompt.RawInput) => Effect.Effect<Serv
  *
  * **Example** (Restoring chat data)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, Ref } from "effect"
  * import { Chat } from "effect/unstable/ai"
  *
@@ -392,18 +435,20 @@ export declare const fromPrompt: (prompt: Prompt.RawInput) => Effect.Effect<Serv
  *   const restoredChat = yield* Chat.fromExport(exported)
  *   const restoredHistory = yield* Ref.get(restoredChat.history)
  *
- *   console.log(restoredHistory.content.map((message) => message.role))
- *   // ["user", "assistant"]
- *
  *   const restoredResponse = restoredHistory.content[1]
  *   if (restoredResponse?.role === "assistant") {
  *     const restoredText = restoredResponse.content[0]
  *     if (restoredText?.type === "text") {
- *       console.log(restoredText.text)
- *       // "The project uses Effect."
+ *       return {
+ *         roles: restoredHistory.content.map((message) => message.role),
+ *         text: restoredText.text
+ *       }
  *     }
  *   }
+ *   return undefined
  * })
+ *
+ * await Effect.runPromise(restoreChat) // => { roles: ["user", "assistant"], text: "The project uses Effect." }
  * ```
  *
  * @category constructors
@@ -421,29 +466,19 @@ export declare const fromExport: (data: unknown) => Effect.Effect<Service, Schem
  *
  * **Example** (Restoring chat history from JSON)
  *
- * ```ts
- * import { Effect } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, Ref } from "effect"
  * import { Chat } from "effect/unstable/ai"
  *
  * const restoreFromJson = Effect.gen(function*() {
- *   // Load JSON from localStorage or file system
- *   const jsonData = localStorage.getItem("my-chat-backup")
- *   if (!jsonData) return yield* Chat.empty
- *
+ *   const original = yield* Chat.fromPrompt("Hello")
+ *   const jsonData = yield* original.exportJson
  *   const restoredChat = yield* Chat.fromJson(jsonData)
+ *   const history = yield* Ref.get(restoredChat.history)
+ *   return history.content.length
+ * })
  *
- *   // Chat history is now restored
- *   const response = yield* restoredChat.generateText({
- *     prompt: "What were we talking about?"
- *   })
- *
- *   return response
- * }).pipe(
- *   Effect.catchTag("SchemaError", (error) => {
- *     console.log("Invalid JSON format:", error.message)
- *     return Chat.empty // Fallback to empty chat
- *   })
- * )
+ * await Effect.runPromise(restoreFromJson) // => 1
  * ```
  *
  * @category constructors
@@ -573,7 +608,7 @@ export declare const makePersisted: (options: {
  *
  * @see {@link makePersisted} for the effect constructor when building the service directly instead of providing it as a layer
  *
- * @category constructors
+ * @category layers
  * @since 4.0.0
  */
 export declare const layerPersisted: (options: {

package/dist/unstable/ai/Chat.d.ts.map

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

package/dist/unstable/ai/Chat.js

@@ -43,17 +43,35 @@ import * as Prompt from "./Prompt.js";
  *
  * **Example** (Accessing the Chat service)
  *
- * ```ts
- * import { Effect } from "effect"
- * import { Chat } from "effect/unstable/ai"
+ * ```ts import.meta.vitest
+ * import { Effect, Layer, Stream } from "effect"
+ * import { Chat, LanguageModel } from "effect/unstable/ai"
+ *
+ * const FakeLanguageModel = Layer.effect(
+ *   LanguageModel.LanguageModel,
+ *   LanguageModel.make({
+ *     generateText: () =>
+ *       Effect.succeed([{
+ *         type: "text",
+ *         text: "Quantum computers use quantum states to process information."
+ *       }]),
+ *     streamText: () => Stream.empty
+ *   })
+ * )
+ *
+ * const ChatLayer = Layer.effect(Chat.Chat, Chat.empty)
  *
  * const program = Effect.gen(function*() {
- *   const chat = yield* Chat.empty
+ *   const chat = yield* Chat.Chat
  *   const response = yield* chat.generateText({
  *     prompt: "Explain quantum computing in simple terms"
  *   })
- *   return response.content
+ *   return response.text
  * })
+ *
+ * await Effect.runPromise(
+ *   program.pipe(Effect.provide(Layer.merge(ChatLayer, FakeLanguageModel)))
+ * ) // => "Quantum computers use quantum states to process information."
  * ```
  *
  * @category services
@@ -136,21 +154,17 @@ const makeUnsafe = history => {
  *
  * **Example** (Creating an empty chat)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect } from "effect"
  * import { Chat } from "effect/unstable/ai"
  *
  * const freshChat = Effect.gen(function*() {
  *   const chat = yield* Chat.empty
- *
- *   const response = yield* chat.generateText({
- *     prompt: "Hello! Can you introduce yourself?"
- *   })
- *
- *   console.log(response.content)
- *
- *   return chat
+ *   const history = yield* chat.export
+ *   return (history as { content: ReadonlyArray<unknown> }).content.length
  * })
+ *
+ * await Effect.runPromise(freshChat) // => 0
  * ```
  *
  * @category constructors
@@ -167,7 +181,7 @@ export const empty = /*#__PURE__*/Effect.sync(() => makeUnsafe(Ref.makeUnsafe(Pr
  *
  * **Example** (Creating a chat from a system prompt)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect } from "effect"
  * import { Chat } from "effect/unstable/ai"
  *
@@ -177,17 +191,16 @@ export const empty = /*#__PURE__*/Effect.sync(() => makeUnsafe(Ref.makeUnsafe(Pr
  *     content: "You are a helpful assistant specialized in mathematics."
  *   }])
  *
- *   const response = yield* chat.generateText({
- *     prompt: "What is 2+2?"
- *   })
- *
- *   return response.content
+ *   const history = yield* chat.export
+ *   return (history as { content: ReadonlyArray<unknown> }).content.length
  * })
+ *
+ * await Effect.runPromise(chatWithSystemPrompt) // => 1
  * ```
  *
  * **Example** (Restoring chat history from a prompt)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect } from "effect"
  * import { Chat } from "effect/unstable/ai"
  *
@@ -208,12 +221,11 @@ export const empty = /*#__PURE__*/Effect.sync(() => makeUnsafe(Ref.makeUnsafe(Pr
  *     }
  *   ])
  *
- *   const response = yield* chat.generateText({
- *     prompt: "I need help with TypeScript"
- *   })
- *
- *   return response
+ *   const history = yield* chat.export
+ *   return (history as { content: ReadonlyArray<unknown> }).content.length
  * })
+ *
+ * await Effect.runPromise(existingChat) // => 3
  * ```
  *
  * @category constructors
@@ -231,7 +243,7 @@ export const fromPrompt = prompt => Effect.sync(() => makeUnsafe(Ref.makeUnsafe(
  *
  * **Example** (Restoring chat data)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, Ref } from "effect"
  * import { Chat } from "effect/unstable/ai"
  *
@@ -251,18 +263,20 @@ export const fromPrompt = prompt => Effect.sync(() => makeUnsafe(Ref.makeUnsafe(
  *   const restoredChat = yield* Chat.fromExport(exported)
  *   const restoredHistory = yield* Ref.get(restoredChat.history)
  *
- *   console.log(restoredHistory.content.map((message) => message.role))
- *   // ["user", "assistant"]
- *
  *   const restoredResponse = restoredHistory.content[1]
  *   if (restoredResponse?.role === "assistant") {
  *     const restoredText = restoredResponse.content[0]
  *     if (restoredText?.type === "text") {
- *       console.log(restoredText.text)
- *       // "The project uses Effect."
+ *       return {
+ *         roles: restoredHistory.content.map((message) => message.role),
+ *         text: restoredText.text
+ *       }
  *     }
  *   }
+ *   return undefined
  * })
+ *
+ * await Effect.runPromise(restoreChat) // => { roles: ["user", "assistant"], text: "The project uses Effect." }
  * ```
  *
  * @category constructors
@@ -280,29 +294,19 @@ export const fromExport = data => Effect.flatMap(decodeHistory(data), fromPrompt
  *
  * **Example** (Restoring chat history from JSON)
  *
- * ```ts
- * import { Effect } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, Ref } from "effect"
  * import { Chat } from "effect/unstable/ai"
  *
  * const restoreFromJson = Effect.gen(function*() {
- *   // Load JSON from localStorage or file system
- *   const jsonData = localStorage.getItem("my-chat-backup")
- *   if (!jsonData) return yield* Chat.empty
- *
+ *   const original = yield* Chat.fromPrompt("Hello")
+ *   const jsonData = yield* original.exportJson
  *   const restoredChat = yield* Chat.fromJson(jsonData)
+ *   const history = yield* Ref.get(restoredChat.history)
+ *   return history.content.length
+ * })
  *
- *   // Chat history is now restored
- *   const response = yield* restoredChat.generateText({
- *     prompt: "What were we talking about?"
- *   })
- *
- *   return response
- * }).pipe(
- *   Effect.catchTag("SchemaError", (error) => {
- *     console.log("Invalid JSON format:", error.message)
- *     return Chat.empty // Fallback to empty chat
- *   })
- * )
+ * await Effect.runPromise(restoreFromJson) // => 1
  * ```
  *
  * @category constructors
@@ -324,7 +328,7 @@ export const fromJson = data => Effect.flatMap(decodeHistoryJson(data), fromProm
  * @category errors
  * @since 4.0.0
  */
-export class ChatNotFoundError extends /*#__PURE__*/Schema.ErrorClass("effect/ai/Chat/ChatNotFoundError")({
+export class ChatNotFoundError extends /*#__PURE__*/Schema.Error("effect/ai/Chat/ChatNotFoundError")({
   _tag: /*#__PURE__*/Schema.tag("ChatNotFoundError"),
   chatId: Schema.String
 }) {}
@@ -475,7 +479,7 @@ export const makePersisted = /*#__PURE__*/Effect.fnUntraced(function* (options)
  *
  * @see {@link makePersisted} for the effect constructor when building the service directly instead of providing it as a layer
  *
- * @category constructors
+ * @category layers
  * @since 4.0.0
  */
 export const layerPersisted = options => Layer.effect(Persistence)(makePersisted(options));