clanka 0.0.3 → 0.0.5

package/dist/Agent.d.ts

@@ -1,8 +1,8 @@
 /**
  * @since 1.0.0
  */
-import { Effect, FileSystem, Layer, Path, Schema, Scope, Stream } from "effect";
-import { LanguageModel, Prompt, Tool, Toolkit } from "effect/unstable/ai";
+import { Effect, FileSystem, Layer, Path, Schema, Scope, ServiceMap, Stream } from "effect";
+import { AiError, LanguageModel, Prompt, Tool, Toolkit } from "effect/unstable/ai";
 import { AgentTools } from "./AgentTools.ts";
 import { Executor } from "./Executor.ts";
 import { ToolkitRenderer } from "./ToolkitRenderer.ts";
@@ -13,15 +13,17 @@ import type { ChildProcessSpawner } from "effect/unstable/process";
  * @category Models
  */
 export interface Agent {
-    readonly output: Stream.Stream<Output, AgentFinished>;
+    readonly output: Stream.Stream<Output, AgentFinished | AiError.AiError>;
+    /**
+     * Send a message to the agent to steer its behavior. This is useful for
+     * providing feedback or new instructions while the agent is running.
+     *
+     * The effect will only complete once the message has been sent.
+     * Interrupting the effect will withdraw the message, so it will not be sent
+     * to the agent.
+     */
+    steer(message: string): Effect.Effect<void>;
 }
-/**
- * A layer that provides most of the common services needed to run an agent.
- *
- * @since 1.0.0
- * @category Services
- */
-export declare const layerServices: Layer.Layer<Tool.HandlersFor<typeof AgentTools.tools> | Executor | ToolkitRenderer, never, FileSystem.FileSystem | Path.Path | ChildProcessSpawner.ChildProcessSpawner>;
 /**
  * Start an agent in the given directory with the given prompt and tools.
  *
@@ -40,6 +42,25 @@ export declare const make: <Tools extends Record<string, Tool.Any> = {}, SE = ne
     /** Layer to use for subagents */
     readonly subagentModel?: Layer.Layer<LanguageModel.LanguageModel | ProviderName, SE, SR> | undefined;
 }) => Effect.Effect<Agent, never, Scope.Scope | FileSystem.FileSystem | Path.Path | Executor | LanguageModel.LanguageModel | ProviderName | ModelName | ToolkitRenderer | Tool.HandlersFor<Tools> | Tool.HandlersFor<typeof AgentTools.tools> | Tool.HandlerServices<Tools[keyof Tools]> | SR>;
+declare const AgentModelConfig_base: ServiceMap.Reference<{
+    readonly systemPromptTransform?: <A, E, R>(system: string, effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+    readonly supportsAssistantPrefill?: boolean | undefined;
+    readonly supportsNoTools?: boolean | undefined;
+}>;
+/**
+ * @since 1.0.0
+ * @category System prompts
+ */
+export declare class AgentModelConfig extends AgentModelConfig_base {
+    static readonly layer: (options: typeof AgentModelConfig.Service) => Layer.Layer<never, never, never>;
+}
+/**
+ * A layer that provides most of the common services needed to run an agent.
+ *
+ * @since 1.0.0
+ * @category Services
+ */
+export declare const layerServices: Layer.Layer<Tool.HandlersFor<typeof AgentTools.tools> | Executor | ToolkitRenderer, never, FileSystem.FileSystem | Path.Path | ChildProcessSpawner.ChildProcessSpawner>;
 declare const ReasoningStart_base: Schema.ExtendableClass<ReasoningStart, Schema.TaggedStruct<"ReasoningStart", {}>, {}>;
 /**
  * @since 1.0.0
@@ -63,24 +84,38 @@ declare const ReasoningEnd_base: Schema.ExtendableClass<ReasoningEnd, Schema.Tag
  */
 export declare class ReasoningEnd extends ReasoningEnd_base {
 }
-declare const ScriptStart_base: Schema.ExtendableClass<ScriptStart, Schema.TaggedStruct<"ScriptStart", {
-    readonly script: Schema.String;
-}>, {}>;
+declare const ScriptStart_base: Schema.ExtendableClass<ScriptStart, Schema.TaggedStruct<"ScriptStart", {}>, {}>;
 /**
  * @since 1.0.0
  * @category Output
  */
 export declare class ScriptStart extends ScriptStart_base {
 }
-declare const ScriptEnd_base: Schema.ExtendableClass<ScriptEnd, Schema.TaggedStruct<"ScriptEnd", {
-    readonly output: Schema.String;
+declare const ScriptDelta_base: Schema.ExtendableClass<ScriptDelta, Schema.TaggedStruct<"ScriptDelta", {
+    readonly delta: Schema.String;
 }>, {}>;
+/**
+ * @since 1.0.0
+ * @category Output
+ */
+export declare class ScriptDelta extends ScriptDelta_base {
+}
+declare const ScriptEnd_base: Schema.ExtendableClass<ScriptEnd, Schema.TaggedStruct<"ScriptEnd", {}>, {}>;
 /**
  * @since 1.0.0
  * @category Output
  */
 export declare class ScriptEnd extends ScriptEnd_base {
 }
+declare const ScriptOutput_base: Schema.ExtendableClass<ScriptOutput, Schema.TaggedStruct<"ScriptOutput", {
+    readonly output: Schema.String;
+}>, {}>;
+/**
+ * @since 1.0.0
+ * @category Output
+ */
+export declare class ScriptOutput extends ScriptOutput_base {
+}
 declare const AgentFinished_base: Schema.ErrorClass<AgentFinished, Schema.TaggedStruct<"AgentFinished", {
     readonly summary: Schema.String;
 }>, import("effect/Cause").YieldableError>;
@@ -90,36 +125,50 @@ declare const AgentFinished_base: Schema.ErrorClass<AgentFinished, Schema.Tagged
  */
 export declare class AgentFinished extends AgentFinished_base {
 }
+declare const SubagentStart_base: Schema.ExtendableClass<SubagentStart, Schema.TaggedStruct<"SubagentStart", {
+    readonly id: Schema.Number;
+    readonly prompt: Schema.String;
+    readonly model: Schema.String;
+    readonly provider: Schema.String;
+}>, {}>;
 /**
  * @since 1.0.0
  * @category Output
  */
-export declare const OutputPart: Schema.Union<readonly [typeof ReasoningStart, typeof ReasoningDelta, typeof ReasoningEnd, typeof ScriptStart, typeof ScriptEnd]>;
+export declare class SubagentStart extends SubagentStart_base {
+    get modelAndProvider(): string;
+}
+declare const SubagentComplete_base: Schema.ExtendableClass<SubagentComplete, Schema.TaggedStruct<"SubagentComplete", {
+    readonly id: Schema.Number;
+    readonly summary: Schema.String;
+}>, {}>;
 /**
  * @since 1.0.0
  * @category Output
  */
-export type OutputPart = typeof OutputPart.Type;
-declare const SubagentPart_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
-    readonly _tag: "SubagentPart";
-} & Readonly<A>;
+export declare class SubagentComplete extends SubagentComplete_base {
+}
+export type ContentPart = ReasoningStart | ReasoningDelta | ReasoningEnd | ScriptStart | ScriptDelta | ScriptEnd | ScriptOutput;
+export declare const ContentPart: Schema.Union<readonly [typeof ReasoningStart, typeof ReasoningDelta, typeof ReasoningEnd, typeof ScriptStart, typeof ScriptDelta, typeof ScriptEnd, typeof ScriptOutput]>;
+declare const SubagentPart_base: Schema.ExtendableClass<SubagentPart, Schema.TaggedStruct<"SubagentPart", {
+    readonly id: Schema.Number;
+    readonly part: Schema.Union<readonly [typeof ReasoningStart, typeof ReasoningDelta, typeof ReasoningEnd, typeof ScriptStart, typeof ScriptDelta, typeof ScriptEnd, typeof ScriptOutput]>;
+}>, {}>;
 /**
  * @since 1.0.0
  * @category Output
  */
-export declare class SubagentPart extends SubagentPart_base<{
-    id: number;
-    prompt: string;
-    model: string;
-    provider: string;
-    output: Stream.Stream<Output, AgentFinished>;
-}> {
-    get modelAndProvider(): string;
+export declare class SubagentPart extends SubagentPart_base {
 }
 /**
  * @since 1.0.0
  * @category Output
  */
-export type Output = OutputPart | SubagentPart;
+export type Output = ContentPart | SubagentStart | SubagentComplete | SubagentPart;
+/**
+ * @since 1.0.0
+ * @category Output
+ */
+export declare const Output: Schema.Union<readonly [typeof ReasoningStart, typeof ReasoningDelta, typeof ReasoningEnd, typeof ScriptStart, typeof ScriptDelta, typeof ScriptEnd, typeof ScriptOutput, typeof SubagentStart, typeof SubagentComplete, typeof SubagentPart]>;
 export {};
 //# sourceMappingURL=Agent.d.ts.map

package/dist/Agent.d.ts.map

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