liminal 0.5.8 → 0.5.10

package/Agent.ts

@@ -5,11 +5,13 @@ import { MessageRegistry, MessageRegistryContext } from "./MessageRegistry.ts"
 import { ModelRegistry, ModelRegistryContext } from "./ModelRegistry.ts"
 import type { Rune } from "./Rune.ts"
 import type { Runic } from "./Runic.ts"
+import { ToolRegistry, ToolRegistryContext } from "./ToolRegistry.ts"
 
 export interface AgentConfig<T, E> {
   handler?: ((this: Fiber<T>, event: E) => void) | undefined
   models?: ModelRegistry
   messages?: MessageRegistry
+  tools?: ToolRegistry
   signal?: AbortSignal | undefined
 }
 
@@ -28,6 +30,7 @@ export function Agent<Y extends Rune, T>(
         [HandlerContext, config?.handler],
         [ModelRegistryContext, config?.models ?? new ModelRegistry()],
         [MessageRegistryContext, config?.messages ?? new MessageRegistry()],
+        [ToolRegistryContext, config?.tools ?? new ToolRegistry()],
       ])
         .run(() => new Fiber(runic).resolution().then(onfulfilled, onrejected))
     },

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # liminal
 
+## 0.5.10
+
+### Patch Changes
+
+- aef5564: Update Model interface to support streaming. Improve event-related functionality and emit fiber-related events.
+- Updated dependencies [aef5564]
+  - liminal-schema@0.0.4
+  - liminal-util@0.0.5
+
+## 0.5.9
+
+### Patch Changes
+
+- dbd5e93: Reintroduced tools and various examples.
+
 ## 0.5.8
 
 ### Patch Changes

package/Context.ts

@@ -14,15 +14,6 @@ export class Context extends Map<ContextHandle, unknown> {
     return super.get(context) as never
   }
 
-  getOrInit<V>(context: ContextHandle<V>, init: () => V): V {
-    if (this.has(context)) {
-      return this.get(context) as V
-    }
-    const instance = init()
-    this.set(context, instance)
-    return instance
-  }
-
   set<V>(context: ContextHandle<V>, value: V): this {
     super.set(context, value)
     return this
@@ -44,7 +35,7 @@ export class Context extends Map<ContextHandle, unknown> {
 }
 
 export type ContextHandle<V = any> = {
-  clone?: ((value: V) => V) | undefined
+  clone: ((value: V) => V) | undefined
 }
 
 export function ContextHandle<V>(clone?: (value: V) => V): ContextHandle<V> {

package/EventBase.ts

@@ -7,6 +7,12 @@ export interface EventBase<B extends symbol = symbol, K extends string = string>
 
 export function EventBase<B extends symbol, K extends string>(brand: B, type: K) {
   return class implements EventBase<B, K> {
+    static is<T>(this: new(...args: any) => T, value: unknown): value is T {
+      return typeof value === "object" && value !== null
+        && "brand" in value && value.brand === brand
+        && "type" in value && value.type === type
+    }
+
     readonly brand = brand
     readonly type = type
 

package/Fiber.ts

@@ -1,8 +1,9 @@
 import { attachCustomInspect } from "liminal-util"
 import { Context } from "./Context.ts"
+import { type Handler, HandlerContext } from "./Handler.ts"
+import { FiberCreated, FiberRejected, FiberResolved, FiberStarted } from "./LEvent.ts"
 import type { Rune } from "./Rune.ts"
 import { Runic } from "./Runic.ts"
-
 export type FiberStatus<T> = {
   type: "untouched"
 } | {
@@ -29,6 +30,7 @@ export class Fiber<T = any> {
   #runic: Runic<Rune, T>
   declare readonly parent?: Fiber
   #context: Context = Context.ensure()
+  #handler?: Handler = this.#context.get(HandlerContext)
 
   signal: AbortSignal
   either: AbortSignal
@@ -48,10 +50,11 @@ export class Fiber<T = any> {
       this.signal,
     ])
     this.abort = controller.abort.bind(controller)
+    this.#handler?.call(this, new FiberCreated())
   }
 
-  static async join<F extends Array<Fiber>>(fibers: F): Promise<{ [I in keyof F]: F[I]["T"] }> {
-    return await Promise.all(fibers.map((fiber) => fiber.resolution())) as never
+  fork<T>(runic: Runic<Rune, T>): Fiber<T> {
+    return new Fiber(runic, this)
   }
 
   resolution(this: Fiber<T>): Promise<T> {
@@ -64,6 +67,7 @@ export class Fiber<T = any> {
           self: this.signal,
           promise,
         }
+        this.#handler?.call(this, new FiberStarted())
         const iterator = Runic.unwrap(this.#runic)
         let nextArg: unknown
         this.#context.run(async () => {
@@ -75,9 +79,19 @@ export class Fiber<T = any> {
               current = await iterator.next(nextArg)
             }
             const { value } = current
+            this.status = {
+              type: "resolved",
+              value,
+            }
+            this.#handler?.call(this, new FiberResolved(value))
             abort()
             resolve(value)
           } catch (exception) {
+            this.status = {
+              type: "rejected",
+              exception,
+            }
+            this.#handler?.call(this, new FiberRejected(exception))
             abort(exception)
             reject(exception)
           }

package/L/L.ts

@@ -6,5 +6,6 @@ export * from "./branch.ts"
 export * from "./catch.ts"
 export * from "./emit.ts"
 export * from "./model.ts"
+export * from "./stream.ts"
 export * from "./system.ts"
 export * from "./user.ts"

package/L/_common.ts

@@ -0,0 +1,6 @@
+export class RequestCounter {
+  static count: number = 0
+  static next(): number {
+    return this.count++
+  }
+}

package/L/_infer.ts

@@ -1,10 +1,11 @@
 import type { SchemaObject } from "liminal-schema"
 import { assert } from "liminal-util"
-import { Context, ContextHandle } from "../Context.ts"
+import { Context } from "../Context.ts"
 import { InferenceRequested, Inferred, type LEvent } from "../LEvent.ts"
 import { MessageRegistryContext } from "../MessageRegistry.ts"
 import { ModelRegistryContext } from "../ModelRegistry.ts"
 import type { Rune } from "../Rune.ts"
+import { RequestCounter } from "./_common.ts"
 import { emit } from "./emit.ts"
 import { rune } from "./rune.ts"
 
@@ -14,20 +15,18 @@ export function* _infer(schema?: SchemaObject): Generator<Rune<LEvent>, string>
   assert(modelRegistry)
   const model = modelRegistry.peek()
   assert(model)
-  const requestId = context.getOrInit(InferenceRequestCounterContext, () => new InferenceRequestCounter()).next()
+  const requestId = RequestCounter.next()
   yield* emit(new InferenceRequested(requestId, schema))
   const messageRegistry = context.get(MessageRegistryContext)
   assert(messageRegistry)
-  const inference = yield* rune(() => model.resolve(messageRegistry.messages, schema))
+  const inference = yield* rune((fiber) =>
+    model
+      .seal({
+        messages: messageRegistry.messages,
+        schema,
+        signal: fiber.signal,
+      })
+      .resolve(), "infer")
   yield* emit(new Inferred(requestId, inference))
   return inference
 }
-
-class InferenceRequestCounter {
-  count: number = 0
-  next(): number {
-    return this.count++
-  }
-}
-
-const InferenceRequestCounterContext: ContextHandle<InferenceRequestCounter> = ContextHandle()

package/L/assistant.ts

@@ -15,7 +15,7 @@ export const assistant: assistant = Object.assign(
     const inference = yield* _infer(schema)
     yield* _message("assistant", [{ part: inference }])
     const input = JSON.parse(inference)
-    return yield* rune(() => validate(type, input))
+    return yield* rune(() => validate(type, input), "validate_assistant_message")
   },
   {
     *[Symbol.iterator]() {

package/L/branch.ts

@@ -1,5 +1,4 @@
 import { Context } from "../Context.ts"
-import { Fiber } from "../Fiber.ts"
 import { type Rune } from "../Rune.ts"
 import type { Runic } from "../Runic.ts"
 import { rune } from "./rune.ts"
@@ -15,22 +14,20 @@ export function branch<XR extends Record<keyof any, Runic>>(
 ): branch<Runic.Y<XR[keyof XR]> | Rune<never>, { [K in keyof XR]: Runic.T<XR[K]> }>
 export function* branch(value: Runic | Array<Runic> | Record<keyof any, Runic>): branch<Rune, any> {
   const context = Context.ensure()
-  const parent = yield* rune((fiber) => fiber)
+  const parent = yield* rune
   if (Array.isArray(value)) {
-    const fibers = value.map((runic) => context.clone().run(() => new Fiber(runic, parent)))
-    return yield* rune(() => Fiber.join(fibers))
+    const fibers = value.map((runic) => context.clone().run(() => parent.fork(runic)))
+    return yield* rune(() => Promise.all(fibers.map((fiber) => fiber.resolution())), "branch")
   } else if (typeof value === "object") {
-    const fibers = Object.values(value).map(
-      (runic) => context.clone().run(() => new Fiber(runic, parent)),
-    )
+    const fibers = Object.values(value).map((runic) => context.clone().run(() => parent.fork(runic)))
     return yield* rune(async () => {
       const keys = Object.keys(value)
-      return await Fiber
-        .join(fibers)
+      return await Promise
+        .all(fibers.map((fiber) => fiber.resolution()))
         .then((resolved) => resolved.map((value, i) => [keys[i], value]))
         .then(Object.fromEntries)
-    })
+    }, "branch")
   }
-  const fiber = context.clone().run(() => new Fiber(typeof value === "function" ? value() : value, parent))
-  return yield* rune(() => fiber.resolution())
+  const fiber = context.clone().run(() => parent.fork(typeof value === "function" ? value() : value))
+  return yield* rune(() => fiber.resolution(), "branch")
 }

package/L/catch.ts

@@ -1,17 +1,16 @@
-import { Fiber } from "../Fiber.ts"
 import type { Rune } from "../Rune.ts"
 import type { Runic } from "../Runic.ts"
 import { rune } from "./rune.ts"
 
 export { catch_ as catch }
 function* catch_<Y extends Rune, T>(runic: Runic<Y, T>): Generator<Rune<Y>, CatchResult<T>> {
-  return yield* rune(async () => {
+  return yield* rune(async (fiber) => {
     try {
-      return { resolved: await new Fiber(runic).resolution() }
+      return { resolved: await fiber.fork(runic).resolution() }
     } catch (exception: unknown) {
       return { rejected: exception }
     }
-  })
+  }, "catch")
 }
 Object.defineProperty(catch_, "name", { value: "catch" })
 

package/L/emit.ts

@@ -9,6 +9,6 @@ export interface emit<E> extends Generator<Rune<E>, void> {}
 export function* emit<const E>(event: EnsureNarrow<E>): emit<E> {
   const context = Context.ensure()
   const handler = context.get(HandlerContext)
-  const fiber = yield* rune((fiber) => fiber)
+  const fiber = yield* rune
   handler?.call(fiber, event)
 }

package/L/rune.ts

@@ -1,19 +1,30 @@
 import { Fiber } from "../Fiber.ts"
 import { type Rune, RuneKey } from "../Rune.ts"
 
-export interface rune<T> extends Iterable<Rune<never>, T> {
-  <E>(): Generator<Rune<E>, T>
+export interface rune extends Iterable<Rune<never>, Fiber> {
+  <R>(source: (fiber: Fiber) => R, debug?: string): Iterable<Rune<never>, Awaited<R>> & {
+    <E>(): Generator<Rune<E>, Awaited<R>>
+  }
 }
-
-export function rune<R>(source: (fiber: Fiber) => R): rune<Awaited<R>> {
-  return Object.assign(
-    function*<E>(): Generator<Rune<E>, Awaited<R>> {
-      return yield Object.assign(source, { [RuneKey]: true } as never)
-    },
-    {
-      *[Symbol.iterator](): Generator<Rune<never>, Awaited<R>> {
-        return yield Object.assign(source, { [RuneKey]: true } as never)
+export const rune: rune = Object.assign(
+  function<R>(source: (fiber: Fiber) => R, debug?: string) {
+    return Object.assign(
+      function*<E>(): Generator<Rune<E>, Awaited<R>> {
+        return yield Object.assign(source, { [RuneKey]: true, debug } as never)
       },
+      {
+        *[Symbol.iterator](): Generator<Rune<never>, Awaited<R>> {
+          return yield Object.assign(source, { [RuneKey]: true, debug } as never)
+        },
+      },
+    )
+  },
+  {
+    *[Symbol.iterator](): Generator<Rune<never>, Fiber> {
+      return yield Object.assign((fiber: Fiber) => fiber, {
+        [RuneKey]: true,
+        debug: "get_current_fiber",
+      } as never)
     },
-  )
-}
+  },
+)

package/L/stream.ts

@@ -0,0 +1,32 @@
+import { assert } from "liminal-util"
+import { Context } from "../Context.ts"
+import { InferenceRequested, type LEvent } from "../LEvent.ts"
+import { MessageRegistryContext } from "../MessageRegistry.ts"
+import { ModelRegistryContext } from "../ModelRegistry.ts"
+import { type Rune } from "../Rune.ts"
+import { RequestCounter } from "./_common.ts"
+import { emit } from "./emit.ts"
+import { rune } from "./rune.ts"
+
+export interface stream extends Iterable<Rune<LEvent>, ReadableStream<string>> {}
+
+export const stream: stream = {
+  *[Symbol.iterator](): Generator<Rune<LEvent>, ReadableStream<string>> {
+    const context = Context.ensure()
+    const modelRegistry = context.get(ModelRegistryContext)
+    assert(modelRegistry)
+    const model = modelRegistry.peek()
+    assert(model)
+    const requestId = RequestCounter.next()
+    yield* emit(new InferenceRequested(requestId))
+    const messageRegistry = context.get(MessageRegistryContext)
+    assert(messageRegistry)
+    return yield* rune((fiber) =>
+      model
+        .seal({
+          messages: messageRegistry.messages,
+          signal: fiber.signal,
+        })
+        .stream(), "stream")
+  },
+}

package/LEvent.ts

@@ -12,6 +12,12 @@ export type LEvent =
   | MessageAppended
   | ModelRegistered
 
+export namespace LEvent {
+  export function is(value: unknown): value is LEvent {
+    return typeof value === "object" && value !== null && "brand" in value && value.brand === LEventTag
+  }
+}
+
 export const LEventTag: unique symbol = Symbol.for("liminal/LEvent")
 export type LEventTag = typeof LEventTag
 
@@ -56,7 +62,8 @@ export class FiberResolved extends EventBase(LEventTag, "fiber_resolved") {
     super()
   }
 }
-
-export function isLEvent(value: unknown): value is LEvent {
-  return typeof value === "object" && value !== null && LEventTag in value
+export class FiberRejected extends EventBase(LEventTag, "fiber_rejected") {
+  constructor(readonly reason: any) {
+    super()
+  }
 }

package/Model.ts

@@ -1,14 +1,25 @@
-import type { Schema } from "liminal-schema"
+import type { SchemaObject } from "liminal-schema"
 import { attachCustomInspect } from "liminal-util"
 import type { Message } from "./Message.ts"
 
 export class Model {
   constructor(
     readonly vendor: string,
-    readonly resolve: (messages: Array<Message>, schema?: Schema) => Promise<string>,
+    readonly seal: (envelope: Envelope) => SealedEnvelope,
   ) {}
 
   static {
     attachCustomInspect(this, ({ vendor }) => ({ vendor }))
   }
 }
+
+export interface Envelope {
+  messages: Array<Message>
+  schema?: SchemaObject | undefined
+  signal?: AbortSignal
+}
+
+export interface SealedEnvelope {
+  resolve(): Promise<string>
+  stream(): ReadableStream<string>
+}

package/ModelRegistry.ts

@@ -6,14 +6,6 @@ export class ModelRegistry {
   declare head?: ModelRegistryNode | undefined
   declare tail?: ModelRegistryNode | undefined
 
-  constructor(models?: Array<Model>) {
-    if (models) {
-      for (const model of models) {
-        this.register(model)
-      }
-    }
-  }
-
   peek() {
     return this.tail?.model
   }

package/Rune.ts

@@ -4,6 +4,7 @@ export interface Rune<out E = any> {
   E: E
   (fiber: Fiber): any
   [RuneKey]: true
+  debug?: string
 }
 
 export declare namespace Rune {

package/Tool.ts

@@ -0,0 +1,34 @@
+import {
+  type LType,
+  Schema,
+  type SchemaObject,
+  toJSONSchema,
+  validate,
+  type Value,
+  type ValueObject,
+} from "liminal-schema"
+
+export class Tool {
+  static async make<T extends ValueObject>(
+    description: string,
+    type: LType<T>,
+    f: (arg: T) => Value | Promise<Value>,
+  ) {
+    const schema = toJSONSchema(type)
+    return new Tool(
+      await Schema.id(schema, description),
+      description,
+      schema,
+      async (arg) => {
+        return await f(await validate(type, arg) as never)
+      },
+    )
+  }
+
+  constructor(
+    readonly name: string,
+    readonly description: string,
+    readonly parameterSchema: SchemaObject,
+    readonly f: (arg: any) => Value | Promise<Value>,
+  ) {}
+}

package/ToolRegistry.ts

@@ -0,0 +1,5 @@
+import { ContextHandle } from "liminal"
+import type { Tool } from "./Tool"
+
+export class ToolRegistry extends Set<Tool> {}
+export const ToolRegistryContext: ContextHandle<ToolRegistry> = ContextHandle()

package/dist/Agent.d.ts

@@ -3,10 +3,12 @@ import { MessageRegistry } from "./MessageRegistry.ts";
 import { ModelRegistry } from "./ModelRegistry.ts";
 import type { Rune } from "./Rune.ts";
 import type { Runic } from "./Runic.ts";
+import { ToolRegistry } from "./ToolRegistry.ts";
 export interface AgentConfig<T, E> {
     handler?: ((this: Fiber<T>, event: E) => void) | undefined;
     models?: ModelRegistry;
     messages?: MessageRegistry;
+    tools?: ToolRegistry;
     signal?: AbortSignal | undefined;
 }
 export interface Agent<out T, out E> extends PromiseLike<T> {

package/dist/Agent.js

@@ -3,6 +3,7 @@ import { Fiber } from "./Fiber.js";
 import { HandlerContext } from "./Handler.js";
 import { MessageRegistry, MessageRegistryContext } from "./MessageRegistry.js";
 import { ModelRegistry, ModelRegistryContext } from "./ModelRegistry.js";
+import { ToolRegistry, ToolRegistryContext } from "./ToolRegistry.js";
 export function Agent(runic, config) {
     return {
         then(onfulfilled, onrejected) {
@@ -10,6 +11,7 @@ export function Agent(runic, config) {
                 [HandlerContext, config?.handler],
                 [ModelRegistryContext, config?.models ?? new ModelRegistry()],
                 [MessageRegistryContext, config?.messages ?? new MessageRegistry()],
+                [ToolRegistryContext, config?.tools ?? new ToolRegistry()],
             ])
                 .run(() => new Fiber(runic).resolution().then(onfulfilled, onrejected));
         },

package/dist/Agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"Agent.js","sourceRoot":"","sources":["../Agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC9E,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAgBxE,MAAM,UAAU,KAAK,CACnB,KAAkB,EAClB,MAAkC;IAElC,OAAO;QACL,IAAI,CAAC,WAAW,EAAE,UAAU;YAC1B,OAAO,IAAI,OAAO,CAAC;gBACjB,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC;gBACjC,CAAC,oBAAoB,EAAE,MAAM,EAAE,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;gBAC7D,CAAC,sBAAsB,EAAE,MAAM,EAAE,QAAQ,IAAI,IAAI,eAAe,EAAE,CAAC;aACpE,CAAC;iBACC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAA;QAC3E,CAAC;KACsD,CAAA;AAC3D,CAAC"}
+{"version":3,"file":"Agent.js","sourceRoot":"","sources":["../Agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC9E,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAGxE,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAerE,MAAM,UAAU,KAAK,CACnB,KAAkB,EAClB,MAAkC;IAElC,OAAO;QACL,IAAI,CAAC,WAAW,EAAE,UAAU;YAC1B,OAAO,IAAI,OAAO,CAAC;gBACjB,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC;gBACjC,CAAC,oBAAoB,EAAE,MAAM,EAAE,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;gBAC7D,CAAC,sBAAsB,EAAE,MAAM,EAAE,QAAQ,IAAI,IAAI,eAAe,EAAE,CAAC;gBACnE,CAAC,mBAAmB,EAAE,MAAM,EAAE,KAAK,IAAI,IAAI,YAAY,EAAE,CAAC;aAC3D,CAAC;iBACC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAA;QAC3E,CAAC;KACsD,CAAA;AAC3D,CAAC"}

package/dist/Context.d.ts

@@ -1,12 +1,11 @@
 export declare class Context extends Map<ContextHandle, unknown> {
     static ensure(): Context;
     get<V>(context: ContextHandle<V>): V | undefined;
-    getOrInit<V>(context: ContextHandle<V>, init: () => V): V;
     set<V>(context: ContextHandle<V>, value: V): this;
     run<R>(callback: () => R): R;
     clone(overrides?: Iterable<[ContextHandle, unknown]>): Context;
 }
 export type ContextHandle<V = any> = {
-    clone?: ((value: V) => V) | undefined;
+    clone: ((value: V) => V) | undefined;
 };
 export declare function ContextHandle<V>(clone?: (value: V) => V): ContextHandle<V>;

package/dist/Context.js

@@ -10,14 +10,6 @@ export class Context extends Map {
     get(context) {
         return super.get(context);
     }
-    getOrInit(context, init) {
-        if (this.has(context)) {
-            return this.get(context);
-        }
-        const instance = init();
-        this.set(context, instance);
-        return instance;
-    }
     set(context, value) {
         super.set(context, value);
         return this;

package/dist/Context.js.map

@@ -1 +1 @@
-{"version":3,"file":"Context.js","sourceRoot":"","sources":["../Context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEpD,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAW,CAAA;AAEhD,MAAM,OAAO,OAAQ,SAAQ,GAA2B;IACtD,MAAM,CAAC,MAAM;QACX,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAA;QAClC,MAAM,CAAC,OAAO,CAAC,CAAA;QACf,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,GAAG,CAAI,OAAyB;QAC9B,OAAO,KAAK,CAAC,GAAG,CAAC,OAAO,CAAU,CAAA;IACpC,CAAC;IAED,SAAS,CAAI,OAAyB,EAAE,IAAa;QACnD,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAM,CAAA;QAC/B,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,EAAE,CAAA;QACvB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;QAC3B,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,GAAG,CAAI,OAAyB,EAAE,KAAQ;QACxC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QACzB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,GAAG,CAAI,QAAiB;QACtB,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACpC,CAAC;IAED,KAAK,CAAC,SAA8C;QAClD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC,CAAA;QACtC,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YAC7C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAA;YACrD,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;CACF;AAMD,MAAM,UAAU,aAAa,CAAI,KAAuB;IACtD,OAAO,EAAE,KAAK,EAAE,CAAA;AAClB,CAAC"}
+{"version":3,"file":"Context.js","sourceRoot":"","sources":["../Context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEpD,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAW,CAAA;AAEhD,MAAM,OAAO,OAAQ,SAAQ,GAA2B;IACtD,MAAM,CAAC,MAAM;QACX,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAA;QAClC,MAAM,CAAC,OAAO,CAAC,CAAA;QACf,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,GAAG,CAAI,OAAyB;QAC9B,OAAO,KAAK,CAAC,GAAG,CAAC,OAAO,CAAU,CAAA;IACpC,CAAC;IAED,GAAG,CAAI,OAAyB,EAAE,KAAQ;QACxC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QACzB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,GAAG,CAAI,QAAiB;QACtB,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACpC,CAAC;IAED,KAAK,CAAC,SAA8C;QAClD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC,CAAA;QACtC,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YAC7C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAA;YACrD,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;CACF;AAMD,MAAM,UAAU,aAAa,CAAI,KAAuB;IACtD,OAAO,EAAE,KAAK,EAAE,CAAA;AAClB,CAAC"}

package/dist/EventBase.d.ts

@@ -7,4 +7,5 @@ export declare function EventBase<B extends symbol, K extends string>(brand: B,
         readonly brand: B;
         readonly type: K;
     };
+    is<T>(this: new (...args: any) => T, value: unknown): value is T;
 };

package/dist/EventBase.js

@@ -1,6 +1,11 @@
 import { attachCustomInspect } from "liminal-util";
 export function EventBase(brand, type) {
     return class {
+        static is(value) {
+            return typeof value === "object" && value !== null
+                && "brand" in value && value.brand === brand
+                && "type" in value && value.type === type;
+        }
         brand = brand;
         type = type;
         static {

package/dist/EventBase.js.map

@@ -1 +1 @@
-{"version":3,"file":"EventBase.js","sourceRoot":"","sources":["../EventBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAOlD,MAAM,UAAU,SAAS,CAAqC,KAAQ,EAAE,IAAO;IAC7E,OAAO;QACI,KAAK,GAAG,KAAK,CAAA;QACb,IAAI,GAAG,IAAI,CAAA;QAEpB;YACE,mBAAmB,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;QACvE,CAAC;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"EventBase.js","sourceRoot":"","sources":["../EventBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAOlD,MAAM,UAAU,SAAS,CAAqC,KAAQ,EAAE,IAAO;IAC7E,OAAO;QACL,MAAM,CAAC,EAAE,CAAkC,KAAc;YACvD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;mBAC7C,OAAO,IAAI,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK;mBACzC,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAA;QAC7C,CAAC;QAEQ,KAAK,GAAG,KAAK,CAAA;QACb,IAAI,GAAG,IAAI,CAAA;QAEpB;YACE,mBAAmB,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;QACvE,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/Fiber.d.ts

@@ -27,8 +27,6 @@ export declare class Fiber<T = any> {
     abort: (reason?: any) => void;
     status: FiberStatus<T>;
     constructor(runic: Runic<Rune, T>, parent?: Fiber);
-    static join<F extends Array<Fiber>>(fibers: F): Promise<{
-        [I in keyof F]: F[I]["T"];
-    }>;
+    fork<T>(runic: Runic<Rune, T>): Fiber<T>;
     resolution(this: Fiber<T>): Promise<T>;
 }

package/dist/Fiber.js

@@ -1,11 +1,14 @@
 import { attachCustomInspect } from "liminal-util";
 import { Context } from "./Context.js";
+import { HandlerContext } from "./Handler.js";
+import { FiberCreated, FiberRejected, FiberResolved, FiberStarted } from "./LEvent.js";
 import { Runic } from "./Runic.js";
 export class Fiber {
     static nextIndex = 0;
     index = Fiber.nextIndex++;
     #runic;
     #context = Context.ensure();
+    #handler = this.#context.get(HandlerContext);
     signal;
     either;
     abort;
@@ -22,9 +25,10 @@ export class Fiber {
             this.signal,
         ]);
         this.abort = controller.abort.bind(controller);
+        this.#handler?.call(this, new FiberCreated());
     }
-    static async join(fibers) {
-        return await Promise.all(fibers.map((fiber) => fiber.resolution()));
+    fork(runic) {
+        return new Fiber(runic, this);
     }
     resolution() {
         const { status, abort } = this;
@@ -36,6 +40,7 @@ export class Fiber {
                     self: this.signal,
                     promise,
                 };
+                this.#handler?.call(this, new FiberStarted());
                 const iterator = Runic.unwrap(this.#runic);
                 let nextArg;
                 this.#context.run(async () => {
@@ -47,10 +52,20 @@ export class Fiber {
                             current = await iterator.next(nextArg);
                         }
                         const { value } = current;
+                        this.status = {
+                            type: "resolved",
+                            value,
+                        };
+                        this.#handler?.call(this, new FiberResolved(value));
                         abort();
                         resolve(value);
                     }
                     catch (exception) {
+                        this.status = {
+                            type: "rejected",
+                            exception,
+                        };
+                        this.#handler?.call(this, new FiberRejected(exception));
                         abort(exception);
                         reject(exception);
                     }