Strand -> Thread (#369)

Author: harrysolovay

.changeset/empty-foxes-turn.md

@@ -0,0 +1,5 @@
+---
+"liminal": minor
+---
+
+Refactoring "strands" into "threads", which can provide a handle with which to operate on the thread context outside of the thread's sequencers arguments.

README.md

@@ -22,7 +22,7 @@ An effect is a conversation.
 ```ts
 import { FileSystem } from "@effect/platform"
 import { Effect } from "effect"
-import { L } from "liminal"
+import L from "liminal"
 
 const conversation = Effect.gen(function*() {
   // Set system instruction.
@@ -55,7 +55,7 @@ const conversation = Effect.gen(function*() {
   // Re-append messages.
   yield* L.append(...messages)
 }).pipe(
-  L.strand,
+  L.thread,
 )
 ```
 

bun.lock

@@ -1,5 +1,5 @@
 import { Console, Effect, flow } from "effect"
-import { L, LPretty } from "liminal"
+import L, { LPretty } from "liminal"
 
 export const logger = L.listen(flow(
   LPretty.event,

examples/_logger.ts

@@ -0,0 +1,3 @@
+export const SYSTEM = `
+  Unless otherwise specified, do not ask follow-up questions; Always reply to the best of your ability using the information you have.
+`

examples/_messages.ts

@@ -1,5 +1,5 @@
 import { Effect, Schema } from "effect"
-import { L } from "liminal"
+import L from "liminal"
 import { ModelLive } from "./_layers.ts"
 import { logger } from "./_logger.ts"
 
@@ -23,7 +23,7 @@ Effect.gen(function*() {
     i++
   }
 }).pipe(
-  L.strand,
+  L.thread,
   Effect.scoped,
   Effect.provide(ModelLive),
   Effect.runFork,

examples/activity_suggestions.ts

@@ -1,5 +1,5 @@
 import { Effect } from "effect"
-import { L } from "liminal"
+import L from "liminal"
 import { ModelLive } from "./_layers.ts"
 import { logger } from "./_logger.ts"
 
@@ -8,7 +8,7 @@ Effect.gen(function*() {
   yield* L.user`Hey.`
   yield* L.assistant
 }).pipe(
-  L.strand,
+  L.thread,
   Effect.provide(ModelLive),
   Effect.scoped,
   Effect.runFork,

examples/basic.ts

@@ -1,5 +1,5 @@
 import { Effect, Schema } from "effect"
-import { L } from "liminal"
+import L from "liminal"
 import { ModelLive } from "./_layers.ts"
 import { logger } from "./_logger.ts"
 
@@ -37,7 +37,7 @@ Effect.gen(function*() {
   }
   return { copy, qualityMetrics }
 }).pipe(
-  L.strand,
+  L.thread,
   Effect.scoped,
   Effect.provide(ModelLive),
   Effect.runFork,

examples/chaining.ts

@@ -1,6 +1,6 @@
 import { OpenAiLanguageModel } from "@effect/ai-openai"
 import { Console, Effect, Schema } from "effect"
-import { L } from "liminal"
+import L from "liminal"
 import { ClientLive, ModelLive } from "./_layers.ts"
 import { logger } from "./_logger.ts"
 
@@ -33,7 +33,7 @@ Effect.gen(function*() {
     Effect.flatMap((key) => Console.log(rewrites[key])),
   )
 }).pipe(
-  L.strand,
+  L.thread,
   Effect.scoped,
   Effect.provide([ModelLive, ClientLive]),
   Effect.runFork,

examples/compare_models.ts

@@ -2,7 +2,7 @@ import { Command, FileSystem } from "@effect/platform"
 import { BunContext } from "@effect/platform-bun"
 import { Effect, flow, Schema } from "effect"
 import * as Console from "effect/Console"
-import { L } from "liminal"
+import L from "liminal"
 import { ModelLive } from "./_layers.ts"
 
 // TODO: use this for actual docs
@@ -46,7 +46,7 @@ Effect.gen(function*() {
 
   yield* Console.log(suggestions)
 }).pipe(
-  L.strand,
+  L.thread,
   Effect.provide([ModelLive, BunContext.layer]),
   Effect.runFork,
 )