effect-assistant 0.0.0-stage → 0.1.0

package/dist/internal/loop.js

@@ -0,0 +1,166 @@
+import { fromCallId } from "../DecisionId.js";
+import { CallOrigin, DecisionRequested, ModelOutput, ModelPart, ToolResult, ToolStarted } from "../AssistantEvent.js";
+import { TurnDecisions } from "./decisions.js";
+import { unansweredCalls } from "./history.js";
+import { chatSpan, toolOutput, toolSpan } from "./telemetry.js";
+import { empty, failed, needsDecisionOf } from "./toolkit.js";
+import { isTurnEnding } from "./tools.js";
+import * as Predicate from "effect/Predicate";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import * as Stream from "effect/Stream";
+import * as Data from "effect/Data";
+import * as Option from "effect/Option";
+import * as Clock from "effect/Clock";
+import * as Prompt from "effect/ai/Prompt";
+import * as LanguageModel from "effect/ai/LanguageModel";
+import * as Model from "effect/ai/Model";
+//#region src/internal/loop.ts
+/** @internal */
+const TurnTools = Context.Reference("effect-assistant/TurnTools", { defaultValue: Option.none });
+const readHistory = (read) => "messages" in read ? {
+	messages: read.messages,
+	throughSeq: read.throughSeq
+} : {
+	messages: read,
+	throughSeq: void 0
+};
+const requestToolkit = (definitions) => ({
+	tools: Object.fromEntries(definitions.map((tool) => [tool.name, tool.needsApproval === void 0 ? tool : tool.setNeedsApproval(false)])),
+	handle: () => Effect.succeed(Stream.empty)
+});
+const generate = (prompt, definitions, toolChoice) => LanguageModel.generateText({
+	prompt,
+	toolkit: requestToolkit(definitions),
+	toolChoice
+});
+const decodePart = Schema.decodeUnknownOption(ModelPart);
+const modelParts = (content) => content.flatMap((part) => Option.toArray(decodePart(part)).filter((decoded) => !(decoded.type === "tool-call" && decoded.providerExecuted)));
+const toolCalls = (parts) => parts.flatMap((part) => part.type === "tool-call" ? [part] : []);
+const runCall = Effect.fnUntraced(function* (tools, call) {
+	const result = yield* Effect.gen(function* () {
+		const result = yield* tools.run(call);
+		yield* toolOutput(result.result);
+		return result;
+	}).pipe(toolSpan(call));
+	return ToolResult.make({
+		callId: call.id,
+		tool: call.name,
+		...result
+	});
+});
+const park = Effect.fnUntraced(function* (call) {
+	if (Option.isNone(yield* TurnDecisions)) return ToolResult.make({
+		callId: call.id,
+		tool: call.name,
+		...failed(`${call.name} needs the user's decision, and only the assistant can ask them. Don't run it: say in your answer what needs deciding, with the details.`, "NeedsDecision")
+	});
+	return DecisionRequested.make({
+		id: fromCallId(call.id),
+		origin: CallOrigin.make({
+			callId: call.id,
+			tool: call.name,
+			params: call.params
+		})
+	});
+}, (effect, call) => effect.pipe(toolSpan(call)));
+const runCalls = (tools, pending, history, then) => Stream.unwrap(Effect.gen(function* () {
+	const parks = yield* Effect.forEach(pending, ({ call, approved }) => approved ? Effect.succeed(false) : needsDecisionOf(tools, call, history));
+	const started = pending.flatMap(({ call }, i) => parks[i] ? [] : [value(ToolStarted.make({
+		callId: call.id,
+		tool: call.name
+	}))]);
+	const results = Effect.forEach(pending, ({ call }, i) => parks[i] ? park(call) : runCall(tools, call), { concurrency: "unbounded" });
+	const reread = (done) => done.some((event) => Predicate.isTagged(event, "DecisionRequested") || isFailure(event));
+	return Stream.fromIterable(started).pipe(Stream.concat(Stream.unwrap(Effect.gen(function* () {
+		const done = yield* results;
+		return Stream.fromIterable(done.map(value)).pipe(Stream.concat(then(reread(done))));
+	}))));
+}));
+const isFailure = (event) => Predicate.isTagged(event, "ToolResult") && event.outcome === "failure";
+const Steps = Data.taggedEnum();
+/** @internal */
+const value = (value) => Steps.Value({ value });
+/** @internal */
+const next = (state) => Stream.succeed(Steps.Next({ state }));
+/** @internal */
+const stop = () => Stream.succeed(Steps.Stop());
+const isValue = (step) => Predicate.isTagged(step, "Value");
+/** @internal */
+const loop = (initial, body) => {
+	const go = (state) => Stream.suspend(() => {
+		let after = Option.none();
+		return body(state).pipe(Stream.tap((step) => Effect.sync(() => after = Predicate.isTagged(step, "Next") ? Option.some(step.state) : after)), Stream.filter(isValue), Stream.map((step) => step.value), Stream.concat(Stream.suspend(() => Option.match(after, {
+			onNone: () => Stream.empty,
+			onSome: go
+		}))));
+	});
+	return go(initial);
+};
+/** @internal */
+const step = (options, then) => {
+	const toolkit = options.toolkit ?? empty;
+	const instructions = Predicate.isString(options.instructions) ? { text: options.instructions } : options.instructions;
+	const after = (result) => Stream.suspend(() => then(result));
+	return Stream.unwrap(Effect.gen(function* () {
+		const { messages: history, throughSeq } = readHistory(yield* options.history);
+		const cutOff = unansweredCalls(history);
+		const decisions = yield* TurnDecisions;
+		const approved = Option.isNone(decisions) ? [] : (yield* decisions.value.approved).filter((call) => toolkit.definitions.some((tool) => tool.name === call.name));
+		if (cutOff.length > 0 || approved.length > 0) {
+			const pending = [...cutOff.map((call) => ({
+				call,
+				approved: false
+			})), ...approved.map((call) => ({
+				call,
+				approved: true
+			}))];
+			return runCalls(toolkit, pending, history, () => after({
+				output: void 0,
+				done: false,
+				historyLength: history.length + pending.length
+			}));
+		}
+		const prompt = Prompt.fromMessages([Prompt.systemMessage({ content: instructions.text }), ...history]);
+		const name = yield* Effect.serviceOption(Model.ModelName);
+		const started = yield* Clock.currentTimeMillis;
+		const response = yield* generate(prompt, toolkit.definitions, options.toolChoice).pipe(chatSpan(prompt, instructions.attributes));
+		const metadata = response.content.find((part) => part.type === "response-metadata");
+		const output = ModelOutput.make({
+			parts: modelParts(response.content),
+			seenThroughSeq: throughSeq,
+			model: metadata?.modelId ?? Option.getOrUndefined(name),
+			responseId: metadata?.id,
+			usage: response.usage,
+			durationMillis: (yield* Clock.currentTimeMillis) - started
+		});
+		const calls = toolCalls(output.parts);
+		const historyLength = history.length + Prompt.fromResponseParts(output.parts).content.length + calls.length;
+		return Stream.make(value(output)).pipe(Stream.concat(runCalls(toolkit, calls.map((call) => ({
+			call,
+			approved: false
+		})), history, (reread) => after({
+			output,
+			done: calls.length === 0 || !reread && calls.some(isTurnEnding),
+			historyLength
+		}))));
+	}));
+};
+/** @internal */
+const run = (options) => {
+	const maxSteps = options.maxSteps ?? 16;
+	const afterDone = (steps, historyLength) => Stream.unwrap(Effect.gen(function* () {
+		const read = yield* options.history;
+		return readHistory(read).messages.length > historyLength ? next(steps) : stop();
+	}));
+	return loop(0, (steps) => step(options, (result) => {
+		const taken = result.output === void 0 ? steps : steps + 1;
+		if (taken >= maxSteps) return stop();
+		return result.done ? afterDone(taken, result.historyLength) : next(taken);
+	}));
+};
+//#endregion
+export { TurnTools, loop, next, run, step, stop, value };
+
+//# sourceMappingURL=loop.js.map

package/dist/internal/loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.js","names":["AssistantEvent.ModelPart","Telemetry.toolOutput","Telemetry.toolSpan","Decisions.TurnDecisions","Toolkits.failed","DecisionId.fromCallId","Toolkits.needsDecisionOf","Toolkits.empty","History.unansweredCalls","Telemetry.chatSpan"],"sources":["../../src/internal/loop.ts"],"sourcesContent":["import type * as AiError from \"effect/ai/AiError\"\nimport * as LanguageModel from \"effect/ai/LanguageModel\"\nimport * as Model from \"effect/ai/Model\"\nimport * as Prompt from \"effect/ai/Prompt\"\nimport type * as Response from \"effect/ai/Response\"\nimport type * as Tool from \"effect/ai/Tool\"\nimport type * as Toolkit from \"effect/ai/Toolkit\"\nimport * as Clock from \"effect/Clock\"\nimport * as Context from \"effect/Context\"\nimport * as Data from \"effect/Data\"\nimport * as Effect from \"effect/Effect\"\nimport * as Option from \"effect/Option\"\nimport * as Predicate from \"effect/Predicate\"\nimport * as Schema from \"effect/Schema\"\nimport * as Stream from \"effect/Stream\"\nimport * as AssistantEvent from \"../AssistantEvent.ts\"\nimport * as DecisionId from \"../DecisionId.ts\"\nimport type * as Instructions from \"../Instructions.ts\"\nimport * as Decisions from \"./decisions.ts\"\nimport * as History from \"./history.ts\"\nimport * as Telemetry from \"./telemetry.ts\"\nimport * as Toolkits from \"./toolkit.ts\"\nimport { isTurnEnding } from \"./tools.ts\"\n\n/** @internal */\nexport type Event =\n  | AssistantEvent.ModelOutput\n  | AssistantEvent.ToolStarted\n  | AssistantEvent.ToolResult\n  | AssistantEvent.DecisionRequested\n\n// The assistant's own tools with the turn's services, so an app's own loop in a turn can message the user. A\n// specialist's run has none.\n/** @internal */\nexport const TurnTools = Context.Reference<Option.Option<Toolkits.Tools>>(\"effect-assistant/TurnTools\", {\n  defaultValue: Option.none\n})\n\n/** @internal */\nexport interface ChatHistory {\n  readonly messages: ReadonlyArray<Prompt.Message>\n  readonly throughSeq: number\n}\n\nconst readHistory = (read: ReadonlyArray<Prompt.Message> | ChatHistory) =>\n  \"messages\" in read\n    ? { messages: read.messages, throughSeq: read.throughSeq }\n    : { messages: read, throughSeq: undefined }\n\n// `AssistantLoop` takes native toolkits; turns and specialist runs come here with their tools already merged.\n/** @internal */\nexport interface StepOptions<R = never> {\n  readonly instructions: string | Instructions.Resolved\n  readonly toolkit?: Toolkits.Tools<R> | undefined\n  readonly history: Effect.Effect<ReadonlyArray<Prompt.Message> | ChatHistory>\n  readonly toolChoice?: LanguageModel.ToolChoice<string> | undefined\n}\n\n/** @internal */\nexport interface Options<R = never> extends StepOptions<R> {\n  readonly maxSteps?: number | undefined\n}\n\n// Its member docs show through `AssistantLoop.StepResult`.\n/** @internal */\nexport interface StepResult {\n  /** The model's output; unset when the step only ran calls a crash cut off. */\n  readonly output: AssistantEvent.ModelOutput | undefined\n  /**\n   * Whether the model is done: it made no tool calls, or ended its turn (`wait`, or a message\n   * with `wait: true`) and none of the step's calls failed.\n   */\n  readonly done: boolean\n  /**\n   * The history's length with this step's output and results: a longer one got something new meanwhile.\n   */\n  readonly historyLength: number\n}\n\n// The loop runs the calls itself, after storing each as started, so the model call runs none.\nconst requestToolkit = (definitions: ReadonlyArray<Tool.Any>): Toolkit.WithHandler<Record<string, Tool.Any>> => ({\n  // The loop decides which calls wait for the user's decision; the model call would ask for approvals of its own.\n  tools: Object.fromEntries(\n    definitions.map((tool) => [tool.name, tool.needsApproval === undefined ? tool : tool.setNeedsApproval(false)])\n  ),\n  handle: () => Effect.succeed(Stream.empty)\n})\n\n// Tool call resolution stays on with a toolkit that runs nothing: with it off, a call whose params don't fit its\n// tool's schema fails the whole model call, and here the model reads why instead.\nconst generate = (\n  prompt: Prompt.Prompt,\n  definitions: ReadonlyArray<Tool.Any>,\n  toolChoice: LanguageModel.ToolChoice<string> | undefined\n): Effect.Effect<\n  LanguageModel.GenerateTextResponse<Record<string, Tool.Any>, \"opaque\">,\n  AiError.AiError,\n  LanguageModel.LanguageModel\n> => LanguageModel.generateText({ prompt, toolkit: requestToolkit(definitions), toolChoice })\n\nconst decodePart = Schema.decodeUnknownOption(AssistantEvent.ModelPart)\n\nconst modelParts = (content: ReadonlyArray<Response.AllParts<Record<string, Tool.Any>>>) =>\n  content.flatMap((part) =>\n    Option.toArray(decodePart(part)).filter((decoded) => !(decoded.type === \"tool-call\" && decoded.providerExecuted))\n  )\n\nconst toolCalls = (parts: ReadonlyArray<AssistantEvent.ModelPart>): ReadonlyArray<AssistantEvent.ToolCallPart> =>\n  parts.flatMap((part) => (part.type === \"tool-call\" ? [part] : []))\n\nconst runCall = Effect.fnUntraced(function* <R>(tools: Toolkits.Tools<R>, call: AssistantEvent.ToolCallPart) {\n  const result = yield* Effect.gen(function* () {\n    const result = yield* tools.run(call)\n\n    yield* Telemetry.toolOutput(result.result)\n\n    return result\n  }).pipe(Telemetry.toolSpan(call))\n\n  return AssistantEvent.ToolResult.make({ callId: call.id, tool: call.name, ...result })\n})\n\ninterface Pending {\n  readonly call: AssistantEvent.ToolCallPart\n  readonly approved: boolean\n}\n\n// Only a turn parks: a specialist's call fails instead.\nconst park = Effect.fnUntraced(\n  function* (call: AssistantEvent.ToolCallPart) {\n    if (Option.isNone(yield* Decisions.TurnDecisions)) {\n      return AssistantEvent.ToolResult.make({\n        callId: call.id,\n        tool: call.name,\n        ...Toolkits.failed(\n          `${call.name} needs the user's decision, and only the assistant can ask them. Don't run it: say in your answer what needs deciding, with the details.`,\n          \"NeedsDecision\"\n        )\n      })\n    }\n\n    return AssistantEvent.DecisionRequested.make({\n      id: DecisionId.fromCallId(call.id),\n      origin: AssistantEvent.CallOrigin.make({ callId: call.id, tool: call.name, params: call.params })\n    })\n  },\n  (effect, call) => effect.pipe(Telemetry.toolSpan(call))\n)\n\n// Every `ToolStarted` is stored before any call runs. `then` is told whether the model has to read the results: one\n// failed, or waits for the user's decision.\nconst runCalls = <R, S, E, R2>(\n  tools: Toolkits.Tools<R>,\n  pending: ReadonlyArray<Pending>,\n  history: ReadonlyArray<Prompt.Message>,\n  then: (reread: boolean) => Stream.Stream<Step<never, S>, E, R2>\n): Stream.Stream<Step<Event, S>, E, R | R2> =>\n  Stream.unwrap(\n    Effect.gen(function* () {\n      const parks = yield* Effect.forEach(pending, ({ call, approved }) =>\n        approved ? Effect.succeed(false) : Toolkits.needsDecisionOf(tools, call, history)\n      )\n\n      const started = pending.flatMap(({ call }, i) =>\n        parks[i] ? [] : [value(AssistantEvent.ToolStarted.make({ callId: call.id, tool: call.name }))]\n      )\n\n      const results = Effect.forEach(pending, ({ call }, i) => (parks[i] ? park(call) : runCall(tools, call)), {\n        concurrency: \"unbounded\"\n      })\n\n      const reread = (done: ReadonlyArray<Event>) =>\n        done.some((event) => Predicate.isTagged(event, \"DecisionRequested\") || isFailure(event))\n\n      return Stream.fromIterable(started).pipe(\n        Stream.concat(\n          Stream.unwrap(\n            Effect.gen(function* () {\n              const done = yield* results\n\n              return Stream.fromIterable(done.map(value)).pipe(Stream.concat(then(reread(done))))\n            })\n          )\n        )\n      )\n    })\n  )\n\nconst isFailure = (event: Event) => Predicate.isTagged(event, \"ToolResult\") && event.outcome === \"failure\"\n\n/** @internal */\nexport type Step<A, S> = Data.TaggedEnum<{\n  Value: { readonly value: A }\n  Next: { readonly state: S }\n  Stop: Record<never, never>\n}>\n\ninterface StepDefinition extends Data.TaggedEnum.WithGenerics<2> {\n  readonly taggedEnum: Step<this[\"A\"], this[\"B\"]>\n}\n\nconst Steps = Data.taggedEnum<StepDefinition>()\n\n/** @internal */\nexport const value = <A>(value: A): Step<A, never> => Steps.Value({ value })\n\n/** @internal */\nexport const next = <S>(state: S): Stream.Stream<Step<never, S>> => Stream.succeed(Steps.Next({ state }))\n\n/** @internal */\n// oxlint-disable-next-line no-unnecessary-type-parameters -- `stop<number>()` types a loop's state where inference can't.\nexport const stop = <S = never>(): Stream.Stream<Step<never, S>> => Stream.succeed(Steps.Stop())\n\nconst isValue = <A, S>(step: Step<A, S>): step is Data.TaggedEnum.Value<Step<A, S>, \"Value\"> =>\n  Predicate.isTagged(step, \"Value\")\n\n// A body that ends without `next` or `stop` stops too.\n/** @internal */\nexport const loop = <S, A, E, R>(\n  initial: S,\n  body: (state: S) => Stream.Stream<Step<A, S>, E, R>\n): Stream.Stream<A, E, R> => {\n  const go = (state: S): Stream.Stream<A, E, R> =>\n    Stream.suspend(() => {\n      let after: Option.Option<S> = Option.none()\n\n      return body(state).pipe(\n        Stream.tap((step) =>\n          Effect.sync(() => (after = Predicate.isTagged(step, \"Next\") ? Option.some(step.state) : after))\n        ),\n        Stream.filter(isValue),\n        Stream.map((step) => step.value),\n        Stream.concat(Stream.suspend(() => Option.match(after, { onNone: () => Stream.empty, onSome: go })))\n      )\n    })\n\n  return go(initial)\n}\n\n/** @internal */\nexport const step = <R, S, E2 = never, R2 = never>(\n  options: StepOptions<R>,\n  then: (result: StepResult) => Stream.Stream<Step<never, S>, E2, R2>\n): Stream.Stream<Step<Event, S>, AiError.AiError | E2, LanguageModel.LanguageModel | R | R2> => {\n  const toolkit = options.toolkit ?? Toolkits.empty\n  const instructions = Predicate.isString(options.instructions) ? { text: options.instructions } : options.instructions\n\n  const after = (result: StepResult) => Stream.suspend(() => then(result))\n\n  return Stream.unwrap(\n    Effect.gen(function* () {\n      const { messages: history, throughSeq } = readHistory(yield* options.history)\n      // Calls a crash cut off, with no result: they run again, with the same ids, before the model goes on.\n      const cutOff = History.unansweredCalls(history)\n\n      // Calls the user approved: they run as the model made them, before the model goes on. Not in a loop without them.\n      const decisions = yield* Decisions.TurnDecisions\n\n      const approved = Option.isNone(decisions)\n        ? []\n        : (yield* decisions.value.approved).filter((call) =>\n            toolkit.definitions.some((tool) => tool.name === call.name)\n          )\n\n      if (cutOff.length > 0 || approved.length > 0) {\n        const pending = [\n          ...cutOff.map((call) => ({ call, approved: false })),\n          ...approved.map((call) => ({ call, approved: true }))\n        ]\n\n        return runCalls(toolkit, pending, history, () =>\n          after({ output: undefined, done: false, historyLength: history.length + pending.length })\n        )\n      }\n\n      const prompt = Prompt.fromMessages([Prompt.systemMessage({ content: instructions.text }), ...history])\n      const name = yield* Effect.serviceOption(Model.ModelName)\n      const started = yield* Clock.currentTimeMillis\n\n      const response = yield* generate(prompt, toolkit.definitions, options.toolChoice).pipe(\n        Telemetry.chatSpan(prompt, instructions.attributes)\n      )\n\n      const metadata = response.content.find((part) => part.type === \"response-metadata\")\n\n      const output = AssistantEvent.ModelOutput.make({\n        parts: modelParts(response.content),\n        seenThroughSeq: throughSeq,\n        model: metadata?.modelId ?? Option.getOrUndefined(name),\n        responseId: metadata?.id,\n        usage: response.usage,\n        durationMillis: (yield* Clock.currentTimeMillis) - started\n      })\n\n      const calls = toolCalls(output.parts)\n      const historyLength = history.length + Prompt.fromResponseParts(output.parts).content.length + calls.length\n\n      // A failed call doesn't end the turn: a message that failed never reached the user, so the model reads why. Nor\n      // does a parked one: the model asks the user for the decision it waits for.\n      return Stream.make(value(output)).pipe(\n        Stream.concat(\n          runCalls(\n            toolkit,\n            calls.map((call) => ({ call, approved: false })),\n            history,\n            (reread) =>\n              after({\n                output,\n                done: calls.length === 0 || (!reread && calls.some(isTurnEnding)),\n                historyLength\n              })\n          )\n        )\n      )\n    })\n  )\n}\n\n/** @internal */\nexport const run = <R = never>(\n  options: Options<R>\n): Stream.Stream<Event, AiError.AiError, LanguageModel.LanguageModel | R> => {\n  const maxSteps = options.maxSteps ?? 16\n\n  // Done: stop, unless something arrived while the model was working; then it reads that first.\n  const afterDone = (steps: number, historyLength: number) =>\n    Stream.unwrap(\n      Effect.gen(function* () {\n        const read = yield* options.history\n\n        return readHistory(read).messages.length > historyLength ? next(steps) : stop<number>()\n      })\n    )\n\n  return loop(0, (steps: number) =>\n    step(options, (result) => {\n      const taken = result.output === undefined ? steps : steps + 1\n\n      if (taken >= maxSteps) return stop<number>()\n\n      return result.done ? afterDone(taken, result.historyLength) : next(taken)\n    })\n  )\n}\n"],"mappings":"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"}

package/dist/internal/schema.js

@@ -0,0 +1,14 @@
+import * as Schema from "effect/Schema";
+import * as Option from "effect/Option";
+import { flow } from "effect/Function";
+//#region src/internal/schema.ts
+const JsonText = Schema.fromJsonString(Schema.Unknown);
+/** @internal */
+const toJsonText = flow(Schema.encodeUnknownOption(JsonText), Option.getOrElse(() => ""));
+const decodeJsonText = Schema.decodeOption(Schema.fromJsonString(Schema.Json));
+/** @internal */
+const toJson = flow(Schema.encodeUnknownOption(JsonText), Option.flatMap(decodeJsonText), Option.getOrElse(() => null));
+//#endregion
+export { toJson, toJsonText };
+
+//# sourceMappingURL=schema.js.map

package/dist/internal/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","names":[],"sources":["../../src/internal/schema.ts"],"sourcesContent":["import { flow } from \"effect/Function\"\nimport * as Option from \"effect/Option\"\nimport * as Schema from \"effect/Schema\"\n\nconst JsonText = Schema.fromJsonString(Schema.Unknown)\n\n// A value with no JSON form (`undefined`, a cycle) is empty text rather than a defect.\n/** @internal */\nexport const toJsonText = flow(\n  Schema.encodeUnknownOption(JsonText),\n  Option.getOrElse(() => \"\")\n)\n\n/** @internal */\nexport const isJsonText = (text: string): boolean => Option.isSome(Schema.decodeOption(JsonText)(text))\n\nconst decodeJsonText = Schema.decodeOption(Schema.fromJsonString(Schema.Json))\n\n// As `JSON.stringify` writes it (a `Date` as its ISO string, a class as its fields), or `null` when it has none.\n/** @internal */\nexport const toJson = flow(\n  Schema.encodeUnknownOption(JsonText),\n  Option.flatMap(decodeJsonText),\n  Option.getOrElse((): Schema.Json => null)\n)\n"],"mappings":";;;;AAIA,MAAM,WAAW,OAAO,eAAe,OAAO,OAAO;;AAIrD,MAAa,aAAa,KACxB,OAAO,oBAAoB,QAAQ,GACnC,OAAO,gBAAgB,EAAE,CAC3B;AAKA,MAAM,iBAAiB,OAAO,aAAa,OAAO,eAAe,OAAO,IAAI,CAAC;;AAI7E,MAAa,SAAS,KACpB,OAAO,oBAAoB,QAAQ,GACnC,OAAO,QAAQ,cAAc,GAC7B,OAAO,gBAA6B,IAAI,CAC1C"}

package/dist/internal/skills.js

@@ -0,0 +1,28 @@
+import { ToolFailure, fail } from "../ToolFailure.js";
+import { empty, withContext } from "./toolkit.js";
+import { resolve } from "../Instructions.js";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import * as Tool from "effect/ai/Tool";
+import * as Toolkit from "effect/ai/Toolkit";
+//#region src/internal/skills.ts
+/** @internal */
+const toTools = (skills) => {
+	if (skills.length === 0) return empty;
+	const byName = new Map(skills.map((skill) => [skill.name, skill]));
+	const LoadSkill = Tool.make("load_skill", {
+		description: "Load a skill's instructions by name, in the same step as your first lookups (not in a step of its own). Follow them for the rest of the task.",
+		parameters: Schema.Struct({ name: Schema.Literals(skills.map((skill) => skill.name)) }),
+		success: Schema.String,
+		failure: ToolFailure
+	});
+	return withContext(Toolkit.make(LoadSkill), (context) => ({ load_skill: Effect.fnUntraced(function* ({ name }) {
+		const skill = byName.get(name);
+		if (skill === void 0) return yield* fail(`No skill named ${name}.`);
+		return (yield* resolve(skill.instructions).pipe(Effect.provideContext(context))).text;
+	}) }));
+};
+//#endregion
+export { toTools };
+
+//# sourceMappingURL=skills.js.map

package/dist/internal/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","names":["Toolkits.empty","ToolFailure.ToolFailure","Toolkits.withContext","ToolFailure.fail","Instructions.resolve"],"sources":["../../src/internal/skills.ts"],"sourcesContent":["import * as Tool from \"effect/ai/Tool\"\nimport * as Toolkit from \"effect/ai/Toolkit\"\nimport type * as Context from \"effect/Context\"\nimport * as Effect from \"effect/Effect\"\nimport * as Schema from \"effect/Schema\"\nimport * as Instructions from \"../Instructions.ts\"\nimport type { Skill } from \"../Skill.ts\"\nimport * as ToolFailure from \"../ToolFailure.ts\"\nimport * as Toolkits from \"./toolkit.ts\"\n\n/** @internal */\nexport const toTools = <R>(skills: ReadonlyArray<Skill<R>>): Toolkits.Tools<R> => {\n  if (skills.length === 0) return Toolkits.empty\n\n  const byName = new Map(skills.map((skill) => [skill.name, skill]))\n\n  const LoadSkill = Tool.make(\"load_skill\", {\n    description:\n      \"Load a skill's instructions by name, in the same step as your first lookups (not in a step of its own). Follow them for the rest of the task.\",\n    parameters: Schema.Struct({ name: Schema.Literals(skills.map((skill) => skill.name)) }),\n    success: Schema.String,\n    failure: ToolFailure.ToolFailure\n  })\n\n  // A skill's instructions resolve with the services of the loop that loads it.\n  return Toolkits.withContext(Toolkit.make(LoadSkill), (context: Context.Context<R>) => ({\n    load_skill: Effect.fnUntraced(function* ({ name }) {\n      const skill = byName.get(name)\n\n      if (skill === undefined) return yield* ToolFailure.fail(`No skill named ${name}.`)\n\n      const resolved = yield* Instructions.resolve(skill.instructions).pipe(Effect.provideContext(context))\n\n      return resolved.text\n    })\n  }))\n}\n"],"mappings":";;;;;;;;;AAWA,MAAa,WAAc,WAAuD;CAChF,IAAI,OAAO,WAAW,GAAG,OAAOA;CAEhC,MAAM,SAAS,IAAI,IAAI,OAAO,KAAK,UAAU,CAAC,MAAM,MAAM,KAAK,CAAC,CAAC;CAEjE,MAAM,YAAY,KAAK,KAAK,cAAc;EACxC,aACE;EACF,YAAY,OAAO,OAAO,EAAE,MAAM,OAAO,SAAS,OAAO,KAAK,UAAU,MAAM,IAAI,CAAC,EAAE,CAAC;EACtF,SAAS,OAAO;EAChB,SAASC;CACX,CAAC;CAGD,OAAOC,YAAqB,QAAQ,KAAK,SAAS,IAAI,aAAiC,EACrF,YAAY,OAAO,WAAW,WAAW,EAAE,QAAQ;EACjD,MAAM,QAAQ,OAAO,IAAI,IAAI;EAE7B,IAAI,UAAU,KAAA,GAAW,OAAO,OAAOC,KAAiB,kBAAkB,KAAK,EAAE;EAIjF,QAAO,OAFiBC,QAAqB,MAAM,YAAY,CAAC,CAAC,KAAK,OAAO,eAAe,OAAO,CAAC,EAAA,CAEpF;CAClB,CAAC,EACH,EAAE;AACJ"}

package/dist/internal/specialists.js

@@ -0,0 +1,273 @@
+import { fromKey } from "../InputId.js";
+import { RunId, make } from "../RunId.js";
+import { SpecialistFinished, SpecialistStarted } from "../AssistantEvent.js";
+import { CurrentChat } from "../CurrentChat.js";
+import { Brief, Runner, SpecialistError } from "../Specialist.js";
+import { TurnDecisions } from "./decisions.js";
+import { toolMessage, userText } from "./history.js";
+import { agentOutput, agentSpan } from "./telemetry.js";
+import { ToolFailure, fail } from "../ToolFailure.js";
+import { empty, fromToolkitOrEmpty, fromWithHandler, merge } from "./toolkit.js";
+import { TurnTools, run } from "./loop.js";
+import { withCatalog } from "../Skill.js";
+import { toTools } from "./skills.js";
+import { mapText } from "./instructions.js";
+import * as Predicate from "effect/Predicate";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import * as Stream from "effect/Stream";
+import * as Exit from "effect/Exit";
+import * as Option from "effect/Option";
+import * as Ref from "effect/Ref";
+import * as Cause from "effect/Cause";
+import * as Fiber from "effect/Fiber";
+import * as FiberSet from "effect/FiberSet";
+import * as Semaphore from "effect/Semaphore";
+import * as Prompt from "effect/ai/Prompt";
+import * as Tool from "effect/ai/Tool";
+import * as Toolkit from "effect/ai/Toolkit";
+import * as FiberMap from "effect/FiberMap";
+import * as Queue from "effect/Queue";
+//#region src/internal/specialists.ts
+/** @internal */
+const briefText = (brief) => [
+	`Goal: ${brief.goal}`,
+	brief.context && `Context: ${brief.context}`,
+	brief.successCriteria && `Done when: ${brief.successCriteria}`,
+	brief.report && `Report back: ${brief.report}`,
+	brief.limits && `Limits: ${brief.limits}`
+].filter(Boolean).join("\n");
+const finalText = (output) => output.parts.flatMap((part) => part.type === "text" ? [part.text] : []).join("").trim();
+/** @internal */
+const runBrief = Effect.fnUntraced(function* (handler, options) {
+	const { history, inbox } = options;
+	const answer = yield* Ref.make("");
+	const add = (messages) => Ref.update(history, (all) => [...all, ...messages]);
+	const current = Effect.gen(function* () {
+		yield* add(yield* Queue.clear(inbox));
+		return yield* Ref.get(history);
+	});
+	const run$1 = {
+		runId: options.runId,
+		chatId: options.chatId,
+		brief: options.brief,
+		history: current,
+		loop: (loop) => {
+			const skills = loop.skills ?? [];
+			return run({
+				instructions: mapText(loop.instructions, (text) => withCatalog(text, skills)),
+				toolkit: merge(toTools(skills), fromToolkitOrEmpty(loop.toolkit)),
+				history: current,
+				maxSteps: loop.maxSteps ?? 8
+			});
+		}
+	};
+	const record = Effect.fnUntraced(function* (event) {
+		if (Predicate.isTagged(event, "ToolStarted") || Predicate.isTagged(event, "DecisionRequested")) return;
+		if (Predicate.isTagged(event, "ToolResult")) return yield* add([toolMessage(event)]);
+		yield* add(Prompt.fromResponseParts(event.parts).content);
+		const text = finalText(event);
+		if (text.length > 0) yield* Ref.set(answer, text);
+	});
+	yield* Stream.runForEach(handler(run$1), record);
+	const text = yield* Ref.get(answer);
+	yield* agentOutput(text);
+	return text;
+}, (effect, _handler, options) => effect.pipe(agentSpan(options.specialist.name, { chatId: options.chatId })));
+const unanswered = (cause) => Cause.hasInterruptsOnly(cause) ? { status: "stopped" } : {
+	status: "failed",
+	error: String(Cause.squash(cause))
+};
+/** @internal */
+const finished = (specialist, run, outcome) => SpecialistFinished.make({
+	id: fromKey(`${run.runId}:${run.brief}`),
+	runId: run.runId,
+	specialist,
+	brief: run.brief,
+	goal: run.goal,
+	...outcome
+});
+const RunIdInput = RunId.annotate({ description: "The runId spawn_specialist returned." });
+const RunStatus = (status) => Schema.Struct({
+	runId: RunId,
+	status: Schema.Literals(status)
+});
+const MessageSpecialist = Tool.make("message_specialist", {
+	description: "Send more to one of your specialists: new instructions for a running one (it reads them at its next step), or a follow-up for a finished one (it continues with what it already found).",
+	parameters: Schema.Struct({
+		runId: RunIdInput,
+		message: Schema.String
+	}),
+	success: RunStatus(["steered", "continued"]),
+	failure: ToolFailure,
+	dependencies: [Runner]
+});
+const StopSpecialist = Tool.make("stop_specialist", {
+	description: "Stop one of your running specialists, for example when the user changed their mind. It posts no answer.",
+	parameters: Schema.Struct({ runId: RunIdInput }),
+	success: RunStatus(["stopped"]),
+	failure: ToolFailure,
+	dependencies: [Runner]
+});
+const refused = (effect) => Effect.catch(effect, (error) => fail(error.message, { reason: error.reason }));
+/** @internal */
+const toolkit = Effect.fnUntraced(function* (specialists) {
+	if (specialists.length === 0) return empty;
+	const catalog = specialists.map((specialist) => `- ${specialist.name}: ${specialist.description}`).join("\n");
+	const SpawnSpecialist = Tool.make("spawn_specialist", {
+		description: `Start a specialist on a job. It works in the background and its report arrives as a <specialist> input, often within seconds. Write a self-contained brief: it can't see this chat. For a quick question, just call wait; for slow work, tell the user in one line first.\nPass one of these as specialist:\n${catalog}`,
+		parameters: Schema.Struct({
+			specialist: Schema.Literals(specialists.map((specialist) => specialist.name)).annotate({ description: "The specialist to start, by name." }),
+			...Brief.fields
+		}),
+		success: RunStatus(["started"]),
+		failure: ToolFailure,
+		dependencies: [Runner]
+	});
+	const SpecialistTools = Toolkit.make(SpawnSpecialist, MessageSpecialist, StopSpecialist);
+	const handlers = yield* SpecialistTools.toHandlers({
+		spawn_specialist: Effect.fnUntraced(function* ({ specialist, ...brief }) {
+			return {
+				runId: yield* refused(Runner.use((runner) => runner.spawn({
+					specialist,
+					brief
+				}))),
+				status: "started"
+			};
+		}),
+		message_specialist: Effect.fnUntraced(function* ({ runId, message }) {
+			return {
+				runId,
+				status: yield* refused(Runner.use((runner) => runner.message(runId, message)))
+			};
+		}),
+		stop_specialist: Effect.fnUntraced(function* ({ runId }) {
+			yield* refused(Runner.use((runner) => runner.stop(runId)));
+			return {
+				runId,
+				status: "stopped"
+			};
+		})
+	});
+	return fromWithHandler(yield* Effect.provideContext(SpecialistTools, handlers));
+});
+const warm = "15 minutes";
+/** @internal */
+const makeRunner = Effect.fnUntraced(function* (options) {
+	const { chat } = options;
+	const runs = /* @__PURE__ */ new Map();
+	const byName = new Map(options.specialists.map((entry) => [entry.specialist.name, entry]));
+	const working = yield* FiberMap.make();
+	const forgetting = yield* FiberMap.make();
+	const background = yield* FiberSet.make();
+	const report = Effect.fnUntraced(function* (run, outcome) {
+		const brief = yield* Ref.get(run.briefs);
+		yield* options.report(finished(run.specialist.name, {
+			runId: run.runId,
+			brief,
+			goal: run.goal
+		}, outcome));
+	});
+	const once = (run) => runBrief(run.handler, {
+		specialist: run.specialist,
+		runId: run.runId,
+		brief: run.brief,
+		history: run.history,
+		inbox: run.inbox,
+		chatId: chat.chatId
+	}).pipe(Effect.provideContext(Context.merge(options.model, services)), Effect.provideService(TurnDecisions, Option.none()), Effect.provideService(TurnTools, Option.none()), Effect.matchCause({
+		onSuccess: (answer) => ({
+			status: "answered",
+			report: answer
+		}),
+		onFailure: unanswered
+	}));
+	const untilCaughtUp = Effect.fnUntraced(function* (run) {
+		let outcome = yield* once(run);
+		while ((yield* Queue.size(run.inbox)) > 0) outcome = yield* once(run);
+		return outcome;
+	});
+	const work = Effect.fnUntraced(function* (run) {
+		yield* chat.append([SpecialistStarted.make({
+			runId: run.runId,
+			specialist: run.specialist.name,
+			goal: run.goal
+		})]);
+		let finished = false;
+		while (!finished) {
+			const exit = yield* Fiber.await(yield* FiberMap.run(working, run.runId, untilCaughtUp(run)));
+			const outcome = Exit.isSuccess(exit) ? exit.value : unanswered(exit.cause);
+			finished = yield* run.lock.withPermit(Effect.gen(function* () {
+				if (outcome.status !== "stopped" && (yield* Queue.size(run.inbox)) > 0) return false;
+				yield* report(run, outcome);
+				yield* Ref.set(run.busy, false);
+				yield* FiberMap.run(forgetting, run.runId, Effect.gen(function* () {
+					yield* Effect.sleep(warm);
+					runs.delete(run.runId);
+				}));
+				return true;
+			}));
+		}
+	}, (effect, run) => Effect.onInterrupt(effect, () => report(run, { status: "cut_off" })));
+	const launch = Effect.fnUntraced(function* (run) {
+		yield* FiberMap.remove(forgetting, run.runId);
+		yield* FiberSet.run(background, options.holding(work(run)));
+	});
+	const send = Effect.fnUntraced(function* (run, text) {
+		yield* Ref.update(run.briefs, (n) => n + 1);
+		if (yield* Ref.get(run.busy)) {
+			yield* Queue.offer(run.inbox, userText(text));
+			return "steered";
+		}
+		yield* Ref.update(run.history, (all) => [...all, userText(text)]);
+		yield* Ref.set(run.busy, true);
+		yield* launch(run);
+		return "continued";
+	});
+	const runner = Runner.of({
+		spawn: Effect.fnUntraced(function* (request) {
+			const found = byName.get(request.specialist);
+			if (found === void 0) return yield* new SpecialistError({
+				reason: "UnknownSpecialist",
+				message: `No specialist named ${request.specialist}.`
+			});
+			const run = {
+				runId: yield* make(),
+				specialist: found.specialist,
+				handler: found.handler,
+				goal: request.brief.goal,
+				brief: request.brief,
+				history: yield* Ref.make([userText(briefText(request.brief))]),
+				inbox: yield* Queue.unbounded(),
+				briefs: yield* Ref.make(1),
+				busy: yield* Ref.make(true),
+				lock: yield* Semaphore.make(1)
+			};
+			runs.set(run.runId, run);
+			yield* launch(run);
+			return run.runId;
+		}),
+		message: Effect.fnUntraced(function* (runId, text) {
+			const run = runs.get(runId);
+			if (run === void 0) return yield* new SpecialistError({
+				reason: "RunNotFound",
+				message: `Run ${runId} is no longer available. Spawn a new one with the full context.`
+			});
+			return yield* run.lock.withPermit(send(run, text));
+		}),
+		stop: Effect.fnUntraced(function* (runId) {
+			if (!(yield* FiberMap.has(working, runId))) return yield* new SpecialistError({
+				reason: "NotRunning",
+				message: `Run ${runId} isn't running.`
+			});
+			yield* FiberMap.remove(working, runId);
+		})
+	});
+	const services = Context.make(CurrentChat, options.handle).pipe(Context.add(Runner, runner));
+	return runner;
+});
+//#endregion
+export { briefText, finished, makeRunner, runBrief, toolkit };
+
+//# sourceMappingURL=specialists.js.map

package/dist/internal/specialists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specialists.js","names":["run","Loop.run","Skill.withCatalog","Toolkits.merge","Skills.toTools","Toolkits.fromToolkitOrEmpty","Telemetry.agentOutput","Telemetry.agentSpan","InputId.fromKey","RunId.RunId","ToolFailure.ToolFailure","Specialist.Runner","ToolFailure.fail","Toolkits.empty","Toolkits.fromWithHandler","Decisions.TurnDecisions","Loop.TurnTools","Specialist.SpecialistError","RunId.make"],"sources":["../../src/internal/specialists.ts"],"sourcesContent":["import type * as LanguageModel from \"effect/ai/LanguageModel\"\nimport * as Prompt from \"effect/ai/Prompt\"\nimport * as Tool from \"effect/ai/Tool\"\nimport * as Toolkit from \"effect/ai/Toolkit\"\nimport * as Cause from \"effect/Cause\"\nimport * as Context from \"effect/Context\"\nimport * as Effect from \"effect/Effect\"\nimport * as Exit from \"effect/Exit\"\nimport * as Fiber from \"effect/Fiber\"\nimport * as FiberMap from \"effect/FiberMap\"\nimport * as FiberSet from \"effect/FiberSet\"\nimport * as Option from \"effect/Option\"\nimport * as Predicate from \"effect/Predicate\"\nimport * as Queue from \"effect/Queue\"\nimport * as Ref from \"effect/Ref\"\nimport * as Schema from \"effect/Schema\"\nimport * as Semaphore from \"effect/Semaphore\"\nimport * as Stream from \"effect/Stream\"\nimport * as AssistantEvent from \"../AssistantEvent.ts\"\nimport type * as AssistantLoop from \"../AssistantLoop.ts\"\nimport * as Loop from \"./loop.ts\"\nimport { CurrentChat } from \"../CurrentChat.ts\"\nimport * as InputId from \"../InputId.ts\"\nimport * as RunId from \"../RunId.ts\"\nimport * as Skill from \"../Skill.ts\"\nimport * as Skills from \"./skills.ts\"\nimport * as Specialist from \"../Specialist.ts\"\nimport * as ToolFailure from \"../ToolFailure.ts\"\nimport * as Decisions from \"./decisions.ts\"\nimport { toolMessage, userText } from \"./history.ts\"\nimport { mapText } from \"./instructions.ts\"\nimport * as Telemetry from \"./telemetry.ts\"\nimport * as Toolkits from \"./toolkit.ts\"\nimport type { Writer } from \"./writer.ts\"\n\n/** @internal */\nexport type RunHandler = (run: Specialist.Run) => Stream.Stream<AssistantLoop.Event, unknown, Specialist.RunServices>\n\n/** @internal */\nexport const briefText = (brief: Specialist.Brief): string =>\n  [\n    `Goal: ${brief.goal}`,\n    brief.context && `Context: ${brief.context}`,\n    brief.successCriteria && `Done when: ${brief.successCriteria}`,\n    brief.report && `Report back: ${brief.report}`,\n    brief.limits && `Limits: ${brief.limits}`\n  ]\n    .filter(Boolean)\n    .join(\"\\n\")\n\nconst finalText = (output: AssistantEvent.ModelOutput): string =>\n  output.parts\n    .flatMap((part) => (part.type === \"text\" ? [part.text] : []))\n    .join(\"\")\n    .trim()\n\n// The answer is the last text the model wrote.\n/** @internal */\nexport const runBrief = Effect.fnUntraced(\n  function* (\n    handler: RunHandler,\n    options: {\n      readonly specialist: Specialist.Any\n      readonly runId: RunId.RunId\n      readonly brief: Specialist.Brief\n      readonly history: Ref.Ref<ReadonlyArray<Prompt.Message>>\n      readonly inbox: Queue.Queue<Prompt.Message>\n      readonly chatId: Writer[\"chatId\"]\n    }\n  ) {\n    const { history, inbox } = options\n    const answer = yield* Ref.make(\"\")\n    const add = (messages: ReadonlyArray<Prompt.Message>) => Ref.update(history, (all) => [...all, ...messages])\n\n    // Read before every model call, when no tool calls are open: messages sent meanwhile join it now.\n    const current = Effect.gen(function* () {\n      yield* add(yield* Queue.clear(inbox))\n\n      return yield* Ref.get(history)\n    })\n\n    const run: Specialist.Run = {\n      runId: options.runId,\n      chatId: options.chatId,\n      brief: options.brief,\n      history: current,\n      loop: (loop) => {\n        const skills = loop.skills ?? []\n\n        return Loop.run({\n          instructions: mapText(loop.instructions, (text) => Skill.withCatalog(text, skills)),\n          toolkit: Toolkits.merge(Skills.toTools(skills), Toolkits.fromToolkitOrEmpty(loop.toolkit)),\n          history: current,\n          maxSteps: loop.maxSteps ?? 8\n        })\n      }\n    }\n\n    // A run lives in memory, so there's nothing to run again after a crash: `ToolStarted` isn't kept. A run parks no\n    // call (it has no user to ask), so there's no `DecisionRequested` either.\n    const record = Effect.fnUntraced(function* (event: AssistantLoop.Event) {\n      if (Predicate.isTagged(event, \"ToolStarted\") || Predicate.isTagged(event, \"DecisionRequested\")) return\n\n      if (Predicate.isTagged(event, \"ToolResult\")) return yield* add([toolMessage(event)])\n\n      yield* add(Prompt.fromResponseParts(event.parts).content)\n      const text = finalText(event)\n\n      if (text.length > 0) yield* Ref.set(answer, text)\n    })\n\n    yield* Stream.runForEach(handler(run), record)\n\n    const text = yield* Ref.get(answer)\n\n    yield* Telemetry.agentOutput(text)\n\n    return text\n  },\n  (effect, _handler, options) => effect.pipe(Telemetry.agentSpan(options.specialist.name, { chatId: options.chatId }))\n)\n\ntype Outcome =\n  | { readonly status: \"answered\"; readonly report: string }\n  | { readonly status: \"failed\"; readonly error: string }\n  | { readonly status: \"stopped\" | \"cut_off\" }\n\n// Only `stop` interrupts a brief's loop alone; a failure or a defect failed it.\nconst unanswered = (cause: Cause.Cause<unknown>): Outcome =>\n  Cause.hasInterruptsOnly(cause) ? { status: \"stopped\" } : { status: \"failed\", error: String(Cause.squash(cause)) }\n\n// The id is fixed per run and brief, so a replay is stored once.\n/** @internal */\nexport const finished = (\n  specialist: string,\n  run: { readonly runId: RunId.RunId; readonly brief: number; readonly goal: string },\n  outcome: Outcome\n): AssistantEvent.SpecialistFinished =>\n  AssistantEvent.SpecialistFinished.make({\n    id: InputId.fromKey(`${run.runId}:${run.brief}`),\n    runId: run.runId,\n    specialist,\n    brief: run.brief,\n    goal: run.goal,\n    ...outcome\n  })\n\nconst RunIdInput = RunId.RunId.annotate({ description: \"The runId spawn_specialist returned.\" })\n\nconst RunStatus = <const Status extends string>(status: ReadonlyArray<Status>) =>\n  Schema.Struct({ runId: RunId.RunId, status: Schema.Literals(status) })\n\nconst MessageSpecialist = Tool.make(\"message_specialist\", {\n  description:\n    \"Send more to one of your specialists: new instructions for a running one (it reads them at its next step), or a follow-up for a finished one (it continues with what it already found).\",\n  parameters: Schema.Struct({ runId: RunIdInput, message: Schema.String }),\n  success: RunStatus([\"steered\", \"continued\"]),\n  failure: ToolFailure.ToolFailure,\n  dependencies: [Specialist.Runner]\n})\n\nconst StopSpecialist = Tool.make(\"stop_specialist\", {\n  description:\n    \"Stop one of your running specialists, for example when the user changed their mind. It posts no answer.\",\n  parameters: Schema.Struct({ runId: RunIdInput }),\n  success: RunStatus([\"stopped\"]),\n  failure: ToolFailure.ToolFailure,\n  dependencies: [Specialist.Runner]\n})\n\nconst refused = <A, R>(effect: Effect.Effect<A, Specialist.SpecialistError, R>) =>\n  Effect.catch(effect, (error) => ToolFailure.fail(error.message, { reason: error.reason }))\n\n/** @internal */\nexport const toolkit = Effect.fnUntraced(function* (\n  specialists: ReadonlyArray<Specialist.Any>\n): Effect.fn.Return<Toolkits.Tools<Specialist.Runner>> {\n  if (specialists.length === 0) return Toolkits.empty\n\n  const catalog = specialists.map((specialist) => `- ${specialist.name}: ${specialist.description}`).join(\"\\n\")\n\n  const SpawnSpecialist = Tool.make(\"spawn_specialist\", {\n    description: `Start a specialist on a job. It works in the background and its report arrives as a <specialist> input, often within seconds. Write a self-contained brief: it can't see this chat. For a quick question, just call wait; for slow work, tell the user in one line first.\\nPass one of these as specialist:\\n${catalog}`,\n    parameters: Schema.Struct({\n      specialist: Schema.Literals(specialists.map((specialist) => specialist.name)).annotate({\n        description: \"The specialist to start, by name.\"\n      }),\n      ...Specialist.Brief.fields\n    }),\n    success: RunStatus([\"started\"]),\n    failure: ToolFailure.ToolFailure,\n    dependencies: [Specialist.Runner]\n  })\n\n  const SpecialistTools = Toolkit.make(SpawnSpecialist, MessageSpecialist, StopSpecialist)\n\n  const handlers = yield* SpecialistTools.toHandlers({\n    spawn_specialist: Effect.fnUntraced(function* ({ specialist, ...brief }) {\n      const runId = yield* refused(Specialist.Runner.use((runner) => runner.spawn({ specialist, brief })))\n\n      return { runId, status: \"started\" }\n    }),\n    message_specialist: Effect.fnUntraced(function* ({ runId, message }) {\n      const status = yield* refused(Specialist.Runner.use((runner) => runner.message(runId, message)))\n\n      return { runId, status }\n    }),\n    stop_specialist: Effect.fnUntraced(function* ({ runId }) {\n      yield* refused(Specialist.Runner.use((runner) => runner.stop(runId)))\n\n      return { runId, status: \"stopped\" }\n    })\n  })\n\n  return Toolkits.fromWithHandler(yield* Effect.provideContext(SpecialistTools, handlers))\n})\n\n// How long a finished run stays available for follow-ups.\nconst warm = \"15 minutes\"\n\ninterface Run {\n  readonly runId: RunId.RunId\n  readonly specialist: Specialist.Any\n  readonly handler: RunHandler\n  readonly goal: string\n  readonly brief: Specialist.Brief\n  readonly history: Ref.Ref<ReadonlyArray<Prompt.Message>>\n  // Messages sent while it works; the loop reads them at its next step.\n  readonly inbox: Queue.Queue<Prompt.Message>\n  // Counts follow-ups too; numbers the reports.\n  readonly briefs: Ref.Ref<number>\n  // Read and changed under `lock`.\n  readonly busy: Ref.Ref<boolean>\n  // Orders a message against the run finishing, so none is dropped or starts a second loop.\n  readonly lock: Semaphore.Semaphore\n}\n\n/** @internal */\nexport const makeRunner = Effect.fnUntraced(function* (options: {\n  readonly chat: Writer\n  readonly handle: CurrentChat[\"Service\"]\n  readonly specialists: ReadonlyArray<{\n    readonly specialist: Specialist.Any\n    readonly handler: RunHandler\n  }>\n  readonly model: Context.Context<LanguageModel.LanguageModel>\n  // An interruption keeps the hold.\n  readonly holding: (effect: Effect.Effect<void>) => Effect.Effect<void>\n  readonly report: (finished: AssistantEvent.SpecialistFinished) => Effect.Effect<void>\n}) {\n  const { chat } = options\n  const runs = new Map<string, Run>()\n  const byName = new Map(options.specialists.map((entry) => [entry.specialist.name, entry]))\n  // The brief loops working now, and the finished runs' countdowns to being forgotten.\n  const working = yield* FiberMap.make<string, Outcome>()\n  const forgetting = yield* FiberMap.make<string>()\n  const background = yield* FiberSet.make()\n\n  const report = Effect.fnUntraced(function* (run: Run, outcome: Outcome) {\n    const brief = yield* Ref.get(run.briefs)\n\n    yield* options.report(finished(run.specialist.name, { runId: run.runId, brief, goal: run.goal }, outcome))\n  })\n\n  const once = (run: Run) =>\n    runBrief(run.handler, {\n      specialist: run.specialist,\n      runId: run.runId,\n      brief: run.brief,\n      history: run.history,\n      inbox: run.inbox,\n      chatId: chat.chatId\n    }).pipe(\n      Effect.provideContext(Context.merge(options.model, services)),\n      // Spawned from a turn, a run would inherit the turn's decisions: it can't park a call or run an approved one.\n      Effect.provideService(Decisions.TurnDecisions, Option.none()),\n      // Nor its own tools: a run can't message the user.\n      Effect.provideService(Loop.TurnTools, Option.none()),\n      Effect.matchCause({\n        onSuccess: (answer): Outcome => ({ status: \"answered\", report: answer }),\n        onFailure: unanswered\n      })\n    )\n\n  // A message that arrived after the last read: keep working before reporting.\n  const untilCaughtUp = Effect.fnUntraced(function* (run: Run) {\n    let outcome = yield* once(run)\n\n    while ((yield* Queue.size(run.inbox)) > 0) outcome = yield* once(run)\n\n    return outcome\n  })\n\n  const work = Effect.fnUntraced(\n    function* (run: Run) {\n      yield* chat.append([\n        AssistantEvent.SpecialistStarted.make({\n          runId: run.runId,\n          specialist: run.specialist.name,\n          goal: run.goal\n        })\n      ])\n\n      let finished = false\n\n      while (!finished) {\n        const exit = yield* Fiber.await(yield* FiberMap.run(working, run.runId, untilCaughtUp(run)))\n        const outcome = Exit.isSuccess(exit) ? exit.value : unanswered(exit.cause)\n\n        finished = yield* run.lock.withPermit(\n          Effect.gen(function* () {\n            // A message steered in after the loop's last read: work on it before reporting.\n            if (outcome.status !== \"stopped\" && (yield* Queue.size(run.inbox)) > 0) return false\n\n            yield* report(run, outcome)\n            yield* Ref.set(run.busy, false)\n            yield* FiberMap.run(\n              forgetting,\n              run.runId,\n              Effect.gen(function* () {\n                yield* Effect.sleep(warm)\n                runs.delete(run.runId)\n              })\n            )\n\n            return true\n          })\n        )\n      }\n    },\n    // A shutdown interrupts the whole run: no turn can start now, so the report waits for the chat's next start.\n    (effect, run) => Effect.onInterrupt(effect, () => report(run, { status: \"cut_off\" }))\n  )\n\n  const launch = Effect.fnUntraced(function* (run: Run) {\n    yield* FiberMap.remove(forgetting, run.runId)\n    yield* FiberSet.run(background, options.holding(work(run)))\n  })\n\n  // Under the run's lock.\n  const send = Effect.fnUntraced(function* (run: Run, text: string): Effect.fn.Return<\"steered\" | \"continued\"> {\n    yield* Ref.update(run.briefs, (n) => n + 1)\n\n    if (yield* Ref.get(run.busy)) {\n      yield* Queue.offer(run.inbox, userText(text))\n\n      return \"steered\"\n    }\n\n    yield* Ref.update(run.history, (all) => [...all, userText(text)])\n    yield* Ref.set(run.busy, true)\n    yield* launch(run)\n\n    return \"continued\"\n  })\n\n  const runner = Specialist.Runner.of({\n    spawn: Effect.fnUntraced(function* (request: Specialist.SpawnRequest) {\n      const found = byName.get(request.specialist)\n\n      if (found === undefined) {\n        return yield* new Specialist.SpecialistError({\n          reason: \"UnknownSpecialist\",\n          message: `No specialist named ${request.specialist}.`\n        })\n      }\n\n      const run: Run = {\n        runId: yield* RunId.make(),\n        specialist: found.specialist,\n        handler: found.handler,\n        goal: request.brief.goal,\n        brief: request.brief,\n        history: yield* Ref.make<ReadonlyArray<Prompt.Message>>([userText(briefText(request.brief))]),\n        inbox: yield* Queue.unbounded<Prompt.Message>(),\n        briefs: yield* Ref.make(1),\n        busy: yield* Ref.make(true),\n        lock: yield* Semaphore.make(1)\n      }\n\n      runs.set(run.runId, run)\n      yield* launch(run)\n\n      return run.runId\n    }),\n    message: Effect.fnUntraced(function* (\n      runId: RunId.RunId,\n      text: string\n    ): Effect.fn.Return<\"steered\" | \"continued\", Specialist.SpecialistError> {\n      const run = runs.get(runId)\n\n      if (run === undefined) {\n        return yield* new Specialist.SpecialistError({\n          reason: \"RunNotFound\",\n          message: `Run ${runId} is no longer available. Spawn a new one with the full context.`\n        })\n      }\n\n      return yield* run.lock.withPermit(send(run, text))\n    }),\n    stop: Effect.fnUntraced(function* (runId: RunId.RunId) {\n      if (!(yield* FiberMap.has(working, runId))) {\n        return yield* new Specialist.SpecialistError({ reason: \"NotRunning\", message: `Run ${runId} isn't running.` })\n      }\n\n      yield* FiberMap.remove(working, runId)\n    })\n  })\n\n  // What a run's handler gets: its chat, this runner, and (merged in `once`) the model.\n  const services = Context.make(CurrentChat, options.handle).pipe(Context.add(Specialist.Runner, runner))\n\n  return runner\n})\n"],"mappings":"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"}