@reactive-agents/prompts 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tyler Buell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,52 @@
+# @reactive-agents/prompts
+
+Prompt management for the [Reactive Agents](https://tylerjrbuell.github.io/reactive-agents-ts/) framework.
+
+A template engine with variable interpolation and a built-in library of agent prompts for common use cases.
+
+## Installation
+
+```bash
+bun add @reactive-agents/prompts effect
+```
+
+## Features
+
+- **Template engine** — `{{variable}}` interpolation with type-safe bindings
+- **Prompt library** — pre-built system prompts for researcher, coder, analyst, and more
+- **Versioning** — store and retrieve prompt versions
+
+## Usage
+
+```typescript
+import { PromptTemplate, PromptLibrary } from "@reactive-agents/prompts";
+
+// Use a built-in prompt
+const systemPrompt = PromptLibrary.get("researcher");
+
+// Or define your own
+const template = PromptTemplate.create({
+  template: "You are a {{role}} expert. Answer in {{language}}.",
+  variables: { role: "TypeScript", language: "English" },
+});
+
+const prompt = template.render({ role: "React", language: "Spanish" });
+```
+
+With the builder:
+
+```typescript
+import { ReactiveAgents } from "reactive-agents";
+
+const agent = await ReactiveAgents.create()
+  .withName("researcher")
+  .withProvider("anthropic")
+  .withPrompts({
+    system: PromptLibrary.get("researcher"),
+  })
+  .build();
+```
+
+## Documentation
+
+Full documentation at [tylerjrbuell.github.io/reactive-agents-ts](https://tylerjrbuell.github.io/reactive-agents-ts/)

package/dist/index.d.ts

@@ -0,0 +1,104 @@
+import { Schema, Effect, Context, Layer } from 'effect';
+import * as effect_Cause from 'effect/Cause';
+import * as effect_Types from 'effect/Types';
+
+declare const PromptVariableType: Schema.Literal<["string", "number", "boolean", "array", "object"]>;
+type PromptVariableType = typeof PromptVariableType.Type;
+declare const PromptVariableSchema: Schema.Struct<{
+    name: typeof Schema.String;
+    required: typeof Schema.Boolean;
+    type: Schema.Literal<["string", "number", "boolean", "array", "object"]>;
+    description: Schema.optional<typeof Schema.String>;
+    defaultValue: Schema.optional<typeof Schema.Unknown>;
+}>;
+type PromptVariable = typeof PromptVariableSchema.Type;
+declare const PromptTemplateSchema: Schema.Struct<{
+    id: typeof Schema.String;
+    name: typeof Schema.String;
+    version: typeof Schema.Number;
+    template: typeof Schema.String;
+    variables: Schema.Array$<Schema.Struct<{
+        name: typeof Schema.String;
+        required: typeof Schema.Boolean;
+        type: Schema.Literal<["string", "number", "boolean", "array", "object"]>;
+        description: Schema.optional<typeof Schema.String>;
+        defaultValue: Schema.optional<typeof Schema.Unknown>;
+    }>>;
+    metadata: Schema.optional<Schema.Struct<{
+        author: Schema.optional<typeof Schema.String>;
+        description: Schema.optional<typeof Schema.String>;
+        tags: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        model: Schema.optional<typeof Schema.String>;
+        maxTokens: Schema.optional<typeof Schema.Number>;
+    }>>;
+}>;
+type PromptTemplate = typeof PromptTemplateSchema.Type;
+declare const CompiledPromptSchema: Schema.Struct<{
+    templateId: typeof Schema.String;
+    version: typeof Schema.Number;
+    content: typeof Schema.String;
+    tokenEstimate: typeof Schema.Number;
+    variables: Schema.Record$<typeof Schema.String, typeof Schema.Unknown>;
+}>;
+type CompiledPrompt = typeof CompiledPromptSchema.Type;
+
+declare const PromptError_base: new <A extends Record<string, any> = {}>(args: effect_Types.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => effect_Cause.YieldableError & {
+    readonly _tag: "PromptError";
+} & Readonly<A>;
+declare class PromptError extends PromptError_base<{
+    readonly message: string;
+    readonly templateId?: string;
+    readonly cause?: unknown;
+}> {
+}
+declare const TemplateNotFoundError_base: new <A extends Record<string, any> = {}>(args: effect_Types.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => effect_Cause.YieldableError & {
+    readonly _tag: "TemplateNotFoundError";
+} & Readonly<A>;
+declare class TemplateNotFoundError extends TemplateNotFoundError_base<{
+    readonly templateId: string;
+    readonly version?: number;
+}> {
+}
+declare const VariableError_base: new <A extends Record<string, any> = {}>(args: effect_Types.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => effect_Cause.YieldableError & {
+    readonly _tag: "VariableError";
+} & Readonly<A>;
+declare class VariableError extends VariableError_base<{
+    readonly templateId: string;
+    readonly variableName: string;
+    readonly message: string;
+}> {
+}
+type PromptErrors = PromptError | TemplateNotFoundError | VariableError;
+
+declare const interpolate: (template: PromptTemplate, variables: Record<string, unknown>) => Effect.Effect<string, VariableError>;
+declare const estimateTokens: (text: string) => number;
+
+declare const reactTemplate: PromptTemplate;
+
+declare const planExecuteTemplate: PromptTemplate;
+
+declare const treeOfThoughtTemplate: PromptTemplate;
+
+declare const reflexionTemplate: PromptTemplate;
+
+declare const factCheckTemplate: PromptTemplate;
+
+declare const PromptService_base: Context.TagClass<PromptService, "PromptService", {
+    readonly register: (template: PromptTemplate) => Effect.Effect<void>;
+    readonly compile: (templateId: string, variables: Record<string, unknown>, options?: {
+        maxTokens?: number;
+    }) => Effect.Effect<CompiledPrompt, TemplateNotFoundError | VariableError>;
+    readonly compose: (prompts: readonly CompiledPrompt[], options?: {
+        separator?: string;
+        maxTokens?: number;
+    }) => Effect.Effect<CompiledPrompt>;
+    readonly getVersion: (templateId: string, version: number) => Effect.Effect<PromptTemplate, TemplateNotFoundError>;
+    readonly getVersionHistory: (templateId: string) => Effect.Effect<readonly PromptTemplate[]>;
+}>;
+declare class PromptService extends PromptService_base {
+}
+declare const PromptServiceLive: Layer.Layer<PromptService, never, never>;
+
+declare const createPromptLayer: () => Layer.Layer<PromptService>;
+
+export { type CompiledPrompt, CompiledPromptSchema, PromptError, type PromptErrors, PromptService, PromptServiceLive, type PromptTemplate, PromptTemplateSchema, type PromptVariable, PromptVariableSchema, PromptVariableType, TemplateNotFoundError, VariableError, createPromptLayer, estimateTokens, factCheckTemplate, interpolate, planExecuteTemplate, reactTemplate, reflexionTemplate, treeOfThoughtTemplate };

package/dist/index.js

@@ -0,0 +1,305 @@
+// src/types/template.ts
+import { Schema } from "effect";
+var PromptVariableType = Schema.Literal(
+  "string",
+  "number",
+  "boolean",
+  "array",
+  "object"
+);
+var PromptVariableSchema = Schema.Struct({
+  name: Schema.String,
+  required: Schema.Boolean,
+  type: PromptVariableType,
+  description: Schema.optional(Schema.String),
+  defaultValue: Schema.optional(Schema.Unknown)
+});
+var PromptTemplateSchema = Schema.Struct({
+  id: Schema.String,
+  name: Schema.String,
+  version: Schema.Number,
+  template: Schema.String,
+  variables: Schema.Array(PromptVariableSchema),
+  metadata: Schema.optional(
+    Schema.Struct({
+      author: Schema.optional(Schema.String),
+      description: Schema.optional(Schema.String),
+      tags: Schema.optional(Schema.Array(Schema.String)),
+      model: Schema.optional(Schema.String),
+      maxTokens: Schema.optional(Schema.Number)
+    })
+  )
+});
+var CompiledPromptSchema = Schema.Struct({
+  templateId: Schema.String,
+  version: Schema.Number,
+  content: Schema.String,
+  tokenEstimate: Schema.Number,
+  variables: Schema.Record({ key: Schema.String, value: Schema.Unknown })
+});
+
+// src/errors/errors.ts
+import { Data } from "effect";
+var PromptError = class extends Data.TaggedError("PromptError") {
+};
+var TemplateNotFoundError = class extends Data.TaggedError(
+  "TemplateNotFoundError"
+) {
+};
+var VariableError = class extends Data.TaggedError("VariableError") {
+};
+
+// src/services/template-engine.ts
+import { Effect } from "effect";
+var interpolate = (template, variables) => Effect.gen(function* () {
+  for (const v of template.variables) {
+    if (v.required && !(v.name in variables) && v.defaultValue === void 0) {
+      return yield* Effect.fail(
+        new VariableError({
+          templateId: template.id,
+          variableName: v.name,
+          message: "Required variable missing"
+        })
+      );
+    }
+  }
+  let content = template.template;
+  for (const [key, value] of Object.entries(variables)) {
+    content = content.replaceAll(`{{${key}}}`, String(value));
+  }
+  for (const v of template.variables) {
+    if (!v.required && !(v.name in variables) && v.defaultValue !== void 0) {
+      content = content.replaceAll(`{{${v.name}}}`, String(v.defaultValue));
+    }
+  }
+  return content;
+});
+var estimateTokens = (text) => Math.ceil(text.length / 4);
+
+// src/templates/reasoning/react.ts
+var reactTemplate = {
+  id: "reasoning.react",
+  name: "ReAct Reasoning",
+  version: 1,
+  template: `You are an AI assistant using the ReAct (Reasoning + Acting) framework.
+
+Task: {{task}}
+
+Available tools: {{tools}}
+
+For each step, follow this pattern:
+Thought: Analyze what you know and what you need to do next
+Action: Choose a tool and specify the input
+Observation: Review the tool result
+
+Continue until you can provide a final answer.
+
+{{#if constraints}}Constraints: {{constraints}}{{/if}}
+
+When you have enough information, respond with:
+Thought: I now have enough information to answer
+Final Answer: [your comprehensive answer]`,
+  variables: [
+    { name: "task", required: true, type: "string", description: "The task to accomplish" },
+    { name: "tools", required: true, type: "string", description: "Available tools list" },
+    { name: "constraints", required: false, type: "string", description: "Optional constraints", defaultValue: "" }
+  ]
+};
+
+// src/templates/reasoning/plan-execute.ts
+var planExecuteTemplate = {
+  id: "reasoning.plan-execute",
+  name: "Plan and Execute",
+  version: 1,
+  template: `You are an AI assistant using the Plan-and-Execute framework.
+
+Task: {{task}}
+
+Available tools: {{tools}}
+
+Phase 1 - Planning:
+Break the task into a numbered list of concrete steps. Each step should be independently executable.
+
+Phase 2 - Execution:
+Execute each step in order, using available tools as needed.
+
+Phase 3 - Synthesis:
+Combine all step results into a final comprehensive answer.
+
+{{#if constraints}}Constraints: {{constraints}}{{/if}}`,
+  variables: [
+    { name: "task", required: true, type: "string", description: "The task to accomplish" },
+    { name: "tools", required: true, type: "string", description: "Available tools list" },
+    { name: "constraints", required: false, type: "string", description: "Optional constraints", defaultValue: "" }
+  ]
+};
+
+// src/templates/reasoning/tree-of-thought.ts
+var treeOfThoughtTemplate = {
+  id: "reasoning.tree-of-thought",
+  name: "Tree of Thought",
+  version: 1,
+  template: `You are an AI assistant using the Tree-of-Thought reasoning framework.
+
+Problem: {{problem}}
+
+Generate {{branches}} different approaches to solve this problem.
+For each approach:
+1. Describe the approach
+2. Evaluate its strengths and weaknesses
+3. Rate its likelihood of success (0-1)
+
+Then select the most promising approach and develop it fully.
+
+{{#if evaluation_criteria}}Evaluation criteria: {{evaluation_criteria}}{{/if}}`,
+  variables: [
+    { name: "problem", required: true, type: "string", description: "The problem to solve" },
+    { name: "branches", required: false, type: "number", description: "Number of approaches to generate", defaultValue: 3 },
+    { name: "evaluation_criteria", required: false, type: "string", description: "Criteria for evaluating approaches", defaultValue: "" }
+  ]
+};
+
+// src/templates/reasoning/reflexion.ts
+var reflexionTemplate = {
+  id: "reasoning.reflexion",
+  name: "Reflexion",
+  version: 1,
+  template: `You are an AI assistant using the Reflexion framework for self-improving reasoning.
+
+Task: {{task}}
+
+{{#if previous_attempt}}
+Previous attempt:
+{{previous_attempt}}
+
+Reflection on previous attempt:
+{{reflection}}
+{{/if}}
+
+Instructions:
+1. Attempt to solve the task
+2. After your attempt, reflect on what went well and what could be improved
+3. If your solution is unsatisfactory, revise it based on your reflection
+
+Provide your final answer after reflection.`,
+  variables: [
+    { name: "task", required: true, type: "string", description: "The task to accomplish" },
+    { name: "previous_attempt", required: false, type: "string", description: "Previous attempt output", defaultValue: "" },
+    { name: "reflection", required: false, type: "string", description: "Reflection on previous attempt", defaultValue: "" }
+  ]
+};
+
+// src/templates/verification/fact-check.ts
+var factCheckTemplate = {
+  id: "verification.fact-check",
+  name: "Fact Check",
+  version: 1,
+  template: `You are a fact-checking assistant. Analyze the following claim for accuracy.
+
+Claim: {{claim}}
+
+{{#if context}}Context: {{context}}{{/if}}
+
+Instructions:
+1. Decompose the claim into individual factual assertions
+2. For each assertion, evaluate:
+   - Is it verifiable?
+   - What evidence supports or contradicts it?
+   - Confidence level (high/medium/low)
+3. Provide an overall verdict: Supported, Partially Supported, Unsupported, or Contradicted
+
+Respond with a structured analysis.`,
+  variables: [
+    { name: "claim", required: true, type: "string", description: "The claim to fact-check" },
+    { name: "context", required: false, type: "string", description: "Additional context", defaultValue: "" }
+  ]
+};
+
+// src/services/prompt-service.ts
+import { Context, Effect as Effect2, Layer, Ref } from "effect";
+var PromptService = class extends Context.Tag("PromptService")() {
+};
+var PromptServiceLive = Layer.effect(
+  PromptService,
+  Effect2.gen(function* () {
+    const templatesRef = yield* Ref.make(/* @__PURE__ */ new Map());
+    const latestRef = yield* Ref.make(/* @__PURE__ */ new Map());
+    return {
+      register: (template) => Effect2.gen(function* () {
+        const key = `${template.id}:${template.version}`;
+        yield* Ref.update(templatesRef, (m) => {
+          const n = new Map(m);
+          n.set(key, template);
+          return n;
+        });
+        yield* Ref.update(latestRef, (m) => {
+          const n = new Map(m);
+          const current = n.get(template.id) ?? 0;
+          if (template.version > current) n.set(template.id, template.version);
+          return n;
+        });
+      }),
+      compile: (templateId, variables, options) => Effect2.gen(function* () {
+        const latest = yield* Ref.get(latestRef);
+        const version = latest.get(templateId);
+        if (version == null) {
+          return yield* Effect2.fail(new TemplateNotFoundError({ templateId }));
+        }
+        const templates = yield* Ref.get(templatesRef);
+        const template = templates.get(`${templateId}:${version}`);
+        const content = yield* interpolate(template, variables);
+        const tokenEst = estimateTokens(content);
+        return {
+          templateId,
+          version,
+          content: options?.maxTokens && tokenEst > options.maxTokens ? content.slice(0, options.maxTokens * 4) : content,
+          tokenEstimate: Math.min(tokenEst, options?.maxTokens ?? tokenEst),
+          variables
+        };
+      }),
+      compose: (prompts, options) => Effect2.succeed({
+        templateId: "composed",
+        version: 1,
+        content: prompts.map((p) => p.content).join(options?.separator ?? "\n\n"),
+        tokenEstimate: prompts.reduce((s, p) => s + p.tokenEstimate, 0),
+        variables: {}
+      }),
+      getVersion: (templateId, version) => Effect2.gen(function* () {
+        const templates = yield* Ref.get(templatesRef);
+        const template = templates.get(`${templateId}:${version}`);
+        if (!template) {
+          return yield* Effect2.fail(new TemplateNotFoundError({ templateId, version }));
+        }
+        return template;
+      }),
+      getVersionHistory: (templateId) => Ref.get(templatesRef).pipe(
+        Effect2.map(
+          (m) => Array.from(m.values()).filter((t) => t.id === templateId).sort((a, b) => a.version - b.version)
+        )
+      )
+    };
+  })
+);
+
+// src/runtime.ts
+var createPromptLayer = () => PromptServiceLive;
+export {
+  CompiledPromptSchema,
+  PromptError,
+  PromptService,
+  PromptServiceLive,
+  PromptTemplateSchema,
+  PromptVariableSchema,
+  PromptVariableType,
+  TemplateNotFoundError,
+  VariableError,
+  createPromptLayer,
+  estimateTokens,
+  factCheckTemplate,
+  interpolate,
+  planExecuteTemplate,
+  reactTemplate,
+  reflexionTemplate,
+  treeOfThoughtTemplate
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types/template.ts","../src/errors/errors.ts","../src/services/template-engine.ts","../src/templates/reasoning/react.ts","../src/templates/reasoning/plan-execute.ts","../src/templates/reasoning/tree-of-thought.ts","../src/templates/reasoning/reflexion.ts","../src/templates/verification/fact-check.ts","../src/services/prompt-service.ts","../src/runtime.ts"],"sourcesContent":["import { Schema } from \"effect\";\n\nexport const PromptVariableType = Schema.Literal(\n  \"string\",\n  \"number\",\n  \"boolean\",\n  \"array\",\n  \"object\",\n);\nexport type PromptVariableType = typeof PromptVariableType.Type;\n\nexport const PromptVariableSchema = Schema.Struct({\n  name: Schema.String,\n  required: Schema.Boolean,\n  type: PromptVariableType,\n  description: Schema.optional(Schema.String),\n  defaultValue: Schema.optional(Schema.Unknown),\n});\nexport type PromptVariable = typeof PromptVariableSchema.Type;\n\nexport const PromptTemplateSchema = Schema.Struct({\n  id: Schema.String,\n  name: Schema.String,\n  version: Schema.Number,\n  template: Schema.String,\n  variables: Schema.Array(PromptVariableSchema),\n  metadata: Schema.optional(\n    Schema.Struct({\n      author: Schema.optional(Schema.String),\n      description: Schema.optional(Schema.String),\n      tags: Schema.optional(Schema.Array(Schema.String)),\n      model: Schema.optional(Schema.String),\n      maxTokens: Schema.optional(Schema.Number),\n    }),\n  ),\n});\nexport type PromptTemplate = typeof PromptTemplateSchema.Type;\n\nexport const CompiledPromptSchema = Schema.Struct({\n  templateId: Schema.String,\n  version: Schema.Number,\n  content: Schema.String,\n  tokenEstimate: Schema.Number,\n  variables: Schema.Record({ key: Schema.String, value: Schema.Unknown }),\n});\nexport type CompiledPrompt = typeof CompiledPromptSchema.Type;\n","import { Data } from \"effect\";\n\nexport class PromptError extends Data.TaggedError(\"PromptError\")<{\n  readonly message: string;\n  readonly templateId?: string;\n  readonly cause?: unknown;\n}> {}\n\nexport class TemplateNotFoundError extends Data.TaggedError(\n  \"TemplateNotFoundError\",\n)<{\n  readonly templateId: string;\n  readonly version?: number;\n}> {}\n\nexport class VariableError extends Data.TaggedError(\"VariableError\")<{\n  readonly templateId: string;\n  readonly variableName: string;\n  readonly message: string;\n}> {}\n\nexport type PromptErrors = PromptError | TemplateNotFoundError | VariableError;\n","import { Effect } from \"effect\";\nimport type { PromptTemplate, PromptVariable } from \"../types/template.js\";\nimport { VariableError } from \"../errors/errors.js\";\n\nexport const interpolate = (\n  template: PromptTemplate,\n  variables: Record<string, unknown>,\n): Effect.Effect<string, VariableError> =>\n  Effect.gen(function* () {\n    // Validate required variables\n    for (const v of template.variables) {\n      if (v.required && !(v.name in variables) && v.defaultValue === undefined) {\n        return yield* Effect.fail(\n          new VariableError({\n            templateId: template.id,\n            variableName: v.name,\n            message: \"Required variable missing\",\n          }),\n        );\n      }\n    }\n\n    let content = template.template;\n\n    // Interpolate provided variables\n    for (const [key, value] of Object.entries(variables)) {\n      content = content.replaceAll(`{{${key}}}`, String(value));\n    }\n\n    // Fill defaults for missing optional variables\n    for (const v of template.variables) {\n      if (!v.required && !(v.name in variables) && v.defaultValue !== undefined) {\n        content = content.replaceAll(`{{${v.name}}}`, String(v.defaultValue));\n      }\n    }\n\n    return content;\n  });\n\nexport const estimateTokens = (text: string): number =>\n  Math.ceil(text.length / 4);\n","import type { PromptTemplate } from \"../../types/template.js\";\n\nexport const reactTemplate: PromptTemplate = {\n  id: \"reasoning.react\",\n  name: \"ReAct Reasoning\",\n  version: 1,\n  template: `You are an AI assistant using the ReAct (Reasoning + Acting) framework.\n\nTask: {{task}}\n\nAvailable tools: {{tools}}\n\nFor each step, follow this pattern:\nThought: Analyze what you know and what you need to do next\nAction: Choose a tool and specify the input\nObservation: Review the tool result\n\nContinue until you can provide a final answer.\n\n{{#if constraints}}Constraints: {{constraints}}{{/if}}\n\nWhen you have enough information, respond with:\nThought: I now have enough information to answer\nFinal Answer: [your comprehensive answer]`,\n  variables: [\n    { name: \"task\", required: true, type: \"string\", description: \"The task to accomplish\" },\n    { name: \"tools\", required: true, type: \"string\", description: \"Available tools list\" },\n    { name: \"constraints\", required: false, type: \"string\", description: \"Optional constraints\", defaultValue: \"\" },\n  ],\n};\n","import type { PromptTemplate } from \"../../types/template.js\";\n\nexport const planExecuteTemplate: PromptTemplate = {\n  id: \"reasoning.plan-execute\",\n  name: \"Plan and Execute\",\n  version: 1,\n  template: `You are an AI assistant using the Plan-and-Execute framework.\n\nTask: {{task}}\n\nAvailable tools: {{tools}}\n\nPhase 1 - Planning:\nBreak the task into a numbered list of concrete steps. Each step should be independently executable.\n\nPhase 2 - Execution:\nExecute each step in order, using available tools as needed.\n\nPhase 3 - Synthesis:\nCombine all step results into a final comprehensive answer.\n\n{{#if constraints}}Constraints: {{constraints}}{{/if}}`,\n  variables: [\n    { name: \"task\", required: true, type: \"string\", description: \"The task to accomplish\" },\n    { name: \"tools\", required: true, type: \"string\", description: \"Available tools list\" },\n    { name: \"constraints\", required: false, type: \"string\", description: \"Optional constraints\", defaultValue: \"\" },\n  ],\n};\n","import type { PromptTemplate } from \"../../types/template.js\";\n\nexport const treeOfThoughtTemplate: PromptTemplate = {\n  id: \"reasoning.tree-of-thought\",\n  name: \"Tree of Thought\",\n  version: 1,\n  template: `You are an AI assistant using the Tree-of-Thought reasoning framework.\n\nProblem: {{problem}}\n\nGenerate {{branches}} different approaches to solve this problem.\nFor each approach:\n1. Describe the approach\n2. Evaluate its strengths and weaknesses\n3. Rate its likelihood of success (0-1)\n\nThen select the most promising approach and develop it fully.\n\n{{#if evaluation_criteria}}Evaluation criteria: {{evaluation_criteria}}{{/if}}`,\n  variables: [\n    { name: \"problem\", required: true, type: \"string\", description: \"The problem to solve\" },\n    { name: \"branches\", required: false, type: \"number\", description: \"Number of approaches to generate\", defaultValue: 3 },\n    { name: \"evaluation_criteria\", required: false, type: \"string\", description: \"Criteria for evaluating approaches\", defaultValue: \"\" },\n  ],\n};\n","import type { PromptTemplate } from \"../../types/template.js\";\n\nexport const reflexionTemplate: PromptTemplate = {\n  id: \"reasoning.reflexion\",\n  name: \"Reflexion\",\n  version: 1,\n  template: `You are an AI assistant using the Reflexion framework for self-improving reasoning.\n\nTask: {{task}}\n\n{{#if previous_attempt}}\nPrevious attempt:\n{{previous_attempt}}\n\nReflection on previous attempt:\n{{reflection}}\n{{/if}}\n\nInstructions:\n1. Attempt to solve the task\n2. After your attempt, reflect on what went well and what could be improved\n3. If your solution is unsatisfactory, revise it based on your reflection\n\nProvide your final answer after reflection.`,\n  variables: [\n    { name: \"task\", required: true, type: \"string\", description: \"The task to accomplish\" },\n    { name: \"previous_attempt\", required: false, type: \"string\", description: \"Previous attempt output\", defaultValue: \"\" },\n    { name: \"reflection\", required: false, type: \"string\", description: \"Reflection on previous attempt\", defaultValue: \"\" },\n  ],\n};\n","import type { PromptTemplate } from \"../../types/template.js\";\n\nexport const factCheckTemplate: PromptTemplate = {\n  id: \"verification.fact-check\",\n  name: \"Fact Check\",\n  version: 1,\n  template: `You are a fact-checking assistant. Analyze the following claim for accuracy.\n\nClaim: {{claim}}\n\n{{#if context}}Context: {{context}}{{/if}}\n\nInstructions:\n1. Decompose the claim into individual factual assertions\n2. For each assertion, evaluate:\n   - Is it verifiable?\n   - What evidence supports or contradicts it?\n   - Confidence level (high/medium/low)\n3. Provide an overall verdict: Supported, Partially Supported, Unsupported, or Contradicted\n\nRespond with a structured analysis.`,\n  variables: [\n    { name: \"claim\", required: true, type: \"string\", description: \"The claim to fact-check\" },\n    { name: \"context\", required: false, type: \"string\", description: \"Additional context\", defaultValue: \"\" },\n  ],\n};\n","import { Context, Effect, Layer, Ref } from \"effect\";\nimport type { PromptTemplate, CompiledPrompt } from \"../types/template.js\";\nimport { TemplateNotFoundError, VariableError } from \"../errors/errors.js\";\nimport { interpolate, estimateTokens } from \"./template-engine.js\";\n\nexport class PromptService extends Context.Tag(\"PromptService\")<\n  PromptService,\n  {\n    readonly register: (template: PromptTemplate) => Effect.Effect<void>;\n\n    readonly compile: (\n      templateId: string,\n      variables: Record<string, unknown>,\n      options?: { maxTokens?: number },\n    ) => Effect.Effect<CompiledPrompt, TemplateNotFoundError | VariableError>;\n\n    readonly compose: (\n      prompts: readonly CompiledPrompt[],\n      options?: { separator?: string; maxTokens?: number },\n    ) => Effect.Effect<CompiledPrompt>;\n\n    readonly getVersion: (\n      templateId: string,\n      version: number,\n    ) => Effect.Effect<PromptTemplate, TemplateNotFoundError>;\n\n    readonly getVersionHistory: (\n      templateId: string,\n    ) => Effect.Effect<readonly PromptTemplate[]>;\n  }\n>() {}\n\nexport const PromptServiceLive = Layer.effect(\n  PromptService,\n  Effect.gen(function* () {\n    const templatesRef = yield* Ref.make<Map<string, PromptTemplate>>(new Map());\n    const latestRef = yield* Ref.make<Map<string, number>>(new Map());\n\n    return {\n      register: (template) =>\n        Effect.gen(function* () {\n          const key = `${template.id}:${template.version}`;\n          yield* Ref.update(templatesRef, (m) => {\n            const n = new Map(m);\n            n.set(key, template);\n            return n;\n          });\n          yield* Ref.update(latestRef, (m) => {\n            const n = new Map(m);\n            const current = n.get(template.id) ?? 0;\n            if (template.version > current) n.set(template.id, template.version);\n            return n;\n          });\n        }),\n\n      compile: (templateId, variables, options) =>\n        Effect.gen(function* () {\n          const latest = yield* Ref.get(latestRef);\n          const version = latest.get(templateId);\n          if (version == null) {\n            return yield* Effect.fail(new TemplateNotFoundError({ templateId }));\n          }\n\n          const templates = yield* Ref.get(templatesRef);\n          const template = templates.get(`${templateId}:${version}`)!;\n\n          const content = yield* interpolate(template, variables);\n          const tokenEst = estimateTokens(content);\n\n          return {\n            templateId,\n            version,\n            content:\n              options?.maxTokens && tokenEst > options.maxTokens\n                ? content.slice(0, options.maxTokens * 4)\n                : content,\n            tokenEstimate: Math.min(tokenEst, options?.maxTokens ?? tokenEst),\n            variables,\n          };\n        }),\n\n      compose: (prompts, options) =>\n        Effect.succeed({\n          templateId: \"composed\",\n          version: 1,\n          content: prompts.map((p) => p.content).join(options?.separator ?? \"\\n\\n\"),\n          tokenEstimate: prompts.reduce((s, p) => s + p.tokenEstimate, 0),\n          variables: {},\n        }),\n\n      getVersion: (templateId, version) =>\n        Effect.gen(function* () {\n          const templates = yield* Ref.get(templatesRef);\n          const template = templates.get(`${templateId}:${version}`);\n          if (!template) {\n            return yield* Effect.fail(new TemplateNotFoundError({ templateId, version }));\n          }\n          return template;\n        }),\n\n      getVersionHistory: (templateId) =>\n        Ref.get(templatesRef).pipe(\n          Effect.map((m) =>\n            Array.from(m.values())\n              .filter((t) => t.id === templateId)\n              .sort((a, b) => a.version - b.version),\n          ),\n        ),\n    };\n  }),\n);\n","import type { Layer } from \"effect\";\nimport { PromptServiceLive, type PromptService } from \"./services/prompt-service.js\";\n\nexport const createPromptLayer = (): Layer.Layer<PromptService> => PromptServiceLive;\n"],"mappings":";AAAA,SAAS,cAAc;AAEhB,IAAM,qBAAqB,OAAO;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGO,IAAM,uBAAuB,OAAO,OAAO;AAAA,EAChD,MAAM,OAAO;AAAA,EACb,UAAU,OAAO;AAAA,EACjB,MAAM;AAAA,EACN,aAAa,OAAO,SAAS,OAAO,MAAM;AAAA,EAC1C,cAAc,OAAO,SAAS,OAAO,OAAO;AAC9C,CAAC;AAGM,IAAM,uBAAuB,OAAO,OAAO;AAAA,EAChD,IAAI,OAAO;AAAA,EACX,MAAM,OAAO;AAAA,EACb,SAAS,OAAO;AAAA,EAChB,UAAU,OAAO;AAAA,EACjB,WAAW,OAAO,MAAM,oBAAoB;AAAA,EAC5C,UAAU,OAAO;AAAA,IACf,OAAO,OAAO;AAAA,MACZ,QAAQ,OAAO,SAAS,OAAO,MAAM;AAAA,MACrC,aAAa,OAAO,SAAS,OAAO,MAAM;AAAA,MAC1C,MAAM,OAAO,SAAS,OAAO,MAAM,OAAO,MAAM,CAAC;AAAA,MACjD,OAAO,OAAO,SAAS,OAAO,MAAM;AAAA,MACpC,WAAW,OAAO,SAAS,OAAO,MAAM;AAAA,IAC1C,CAAC;AAAA,EACH;AACF,CAAC;AAGM,IAAM,uBAAuB,OAAO,OAAO;AAAA,EAChD,YAAY,OAAO;AAAA,EACnB,SAAS,OAAO;AAAA,EAChB,SAAS,OAAO;AAAA,EAChB,eAAe,OAAO;AAAA,EACtB,WAAW,OAAO,OAAO,EAAE,KAAK,OAAO,QAAQ,OAAO,OAAO,QAAQ,CAAC;AACxE,CAAC;;;AC5CD,SAAS,YAAY;AAEd,IAAM,cAAN,cAA0B,KAAK,YAAY,aAAa,EAI5D;AAAC;AAEG,IAAM,wBAAN,cAAoC,KAAK;AAAA,EAC9C;AACF,EAGG;AAAC;AAEG,IAAM,gBAAN,cAA4B,KAAK,YAAY,eAAe,EAIhE;AAAC;;;ACnBJ,SAAS,cAAc;AAIhB,IAAM,cAAc,CACzB,UACA,cAEA,OAAO,IAAI,aAAa;AAEtB,aAAW,KAAK,SAAS,WAAW;AAClC,QAAI,EAAE,YAAY,EAAE,EAAE,QAAQ,cAAc,EAAE,iBAAiB,QAAW;AACxE,aAAO,OAAO,OAAO;AAAA,QACnB,IAAI,cAAc;AAAA,UAChB,YAAY,SAAS;AAAA,UACrB,cAAc,EAAE;AAAA,UAChB,SAAS;AAAA,QACX,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAEA,MAAI,UAAU,SAAS;AAGvB,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,SAAS,GAAG;AACpD,cAAU,QAAQ,WAAW,KAAK,GAAG,MAAM,OAAO,KAAK,CAAC;AAAA,EAC1D;AAGA,aAAW,KAAK,SAAS,WAAW;AAClC,QAAI,CAAC,EAAE,YAAY,EAAE,EAAE,QAAQ,cAAc,EAAE,iBAAiB,QAAW;AACzE,gBAAU,QAAQ,WAAW,KAAK,EAAE,IAAI,MAAM,OAAO,EAAE,YAAY,CAAC;AAAA,IACtE;AAAA,EACF;AAEA,SAAO;AACT,CAAC;AAEI,IAAM,iBAAiB,CAAC,SAC7B,KAAK,KAAK,KAAK,SAAS,CAAC;;;ACtCpB,IAAM,gBAAgC;AAAA,EAC3C,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,SAAS;AAAA,EACT,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkBV,WAAW;AAAA,IACT,EAAE,MAAM,QAAQ,UAAU,MAAM,MAAM,UAAU,aAAa,yBAAyB;AAAA,IACtF,EAAE,MAAM,SAAS,UAAU,MAAM,MAAM,UAAU,aAAa,uBAAuB;AAAA,IACrF,EAAE,MAAM,eAAe,UAAU,OAAO,MAAM,UAAU,aAAa,wBAAwB,cAAc,GAAG;AAAA,EAChH;AACF;;;AC3BO,IAAM,sBAAsC;AAAA,EACjD,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,SAAS;AAAA,EACT,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBV,WAAW;AAAA,IACT,EAAE,MAAM,QAAQ,UAAU,MAAM,MAAM,UAAU,aAAa,yBAAyB;AAAA,IACtF,EAAE,MAAM,SAAS,UAAU,MAAM,MAAM,UAAU,aAAa,uBAAuB;AAAA,IACrF,EAAE,MAAM,eAAe,UAAU,OAAO,MAAM,UAAU,aAAa,wBAAwB,cAAc,GAAG;AAAA,EAChH;AACF;;;ACzBO,IAAM,wBAAwC;AAAA,EACnD,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,SAAS;AAAA,EACT,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaV,WAAW;AAAA,IACT,EAAE,MAAM,WAAW,UAAU,MAAM,MAAM,UAAU,aAAa,uBAAuB;AAAA,IACvF,EAAE,MAAM,YAAY,UAAU,OAAO,MAAM,UAAU,aAAa,oCAAoC,cAAc,EAAE;AAAA,IACtH,EAAE,MAAM,uBAAuB,UAAU,OAAO,MAAM,UAAU,aAAa,sCAAsC,cAAc,GAAG;AAAA,EACtI;AACF;;;ACtBO,IAAM,oBAAoC;AAAA,EAC/C,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,SAAS;AAAA,EACT,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkBV,WAAW;AAAA,IACT,EAAE,MAAM,QAAQ,UAAU,MAAM,MAAM,UAAU,aAAa,yBAAyB;AAAA,IACtF,EAAE,MAAM,oBAAoB,UAAU,OAAO,MAAM,UAAU,aAAa,2BAA2B,cAAc,GAAG;AAAA,IACtH,EAAE,MAAM,cAAc,UAAU,OAAO,MAAM,UAAU,aAAa,kCAAkC,cAAc,GAAG;AAAA,EACzH;AACF;;;AC3BO,IAAM,oBAAoC;AAAA,EAC/C,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,SAAS;AAAA,EACT,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeV,WAAW;AAAA,IACT,EAAE,MAAM,SAAS,UAAU,MAAM,MAAM,UAAU,aAAa,0BAA0B;AAAA,IACxF,EAAE,MAAM,WAAW,UAAU,OAAO,MAAM,UAAU,aAAa,sBAAsB,cAAc,GAAG;AAAA,EAC1G;AACF;;;ACzBA,SAAS,SAAS,UAAAA,SAAQ,OAAO,WAAW;AAKrC,IAAM,gBAAN,cAA4B,QAAQ,IAAI,eAAe,EAyB5D,EAAE;AAAC;AAEE,IAAM,oBAAoB,MAAM;AAAA,EACrC;AAAA,EACAC,QAAO,IAAI,aAAa;AACtB,UAAM,eAAe,OAAO,IAAI,KAAkC,oBAAI,IAAI,CAAC;AAC3E,UAAM,YAAY,OAAO,IAAI,KAA0B,oBAAI,IAAI,CAAC;AAEhE,WAAO;AAAA,MACL,UAAU,CAAC,aACTA,QAAO,IAAI,aAAa;AACtB,cAAM,MAAM,GAAG,SAAS,EAAE,IAAI,SAAS,OAAO;AAC9C,eAAO,IAAI,OAAO,cAAc,CAAC,MAAM;AACrC,gBAAM,IAAI,IAAI,IAAI,CAAC;AACnB,YAAE,IAAI,KAAK,QAAQ;AACnB,iBAAO;AAAA,QACT,CAAC;AACD,eAAO,IAAI,OAAO,WAAW,CAAC,MAAM;AAClC,gBAAM,IAAI,IAAI,IAAI,CAAC;AACnB,gBAAM,UAAU,EAAE,IAAI,SAAS,EAAE,KAAK;AACtC,cAAI,SAAS,UAAU,QAAS,GAAE,IAAI,SAAS,IAAI,SAAS,OAAO;AACnE,iBAAO;AAAA,QACT,CAAC;AAAA,MACH,CAAC;AAAA,MAEH,SAAS,CAAC,YAAY,WAAW,YAC/BA,QAAO,IAAI,aAAa;AACtB,cAAM,SAAS,OAAO,IAAI,IAAI,SAAS;AACvC,cAAM,UAAU,OAAO,IAAI,UAAU;AACrC,YAAI,WAAW,MAAM;AACnB,iBAAO,OAAOA,QAAO,KAAK,IAAI,sBAAsB,EAAE,WAAW,CAAC,CAAC;AAAA,QACrE;AAEA,cAAM,YAAY,OAAO,IAAI,IAAI,YAAY;AAC7C,cAAM,WAAW,UAAU,IAAI,GAAG,UAAU,IAAI,OAAO,EAAE;AAEzD,cAAM,UAAU,OAAO,YAAY,UAAU,SAAS;AACtD,cAAM,WAAW,eAAe,OAAO;AAEvC,eAAO;AAAA,UACL;AAAA,UACA;AAAA,UACA,SACE,SAAS,aAAa,WAAW,QAAQ,YACrC,QAAQ,MAAM,GAAG,QAAQ,YAAY,CAAC,IACtC;AAAA,UACN,eAAe,KAAK,IAAI,UAAU,SAAS,aAAa,QAAQ;AAAA,UAChE;AAAA,QACF;AAAA,MACF,CAAC;AAAA,MAEH,SAAS,CAAC,SAAS,YACjBA,QAAO,QAAQ;AAAA,QACb,YAAY;AAAA,QACZ,SAAS;AAAA,QACT,SAAS,QAAQ,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,SAAS,aAAa,MAAM;AAAA,QACxE,eAAe,QAAQ,OAAO,CAAC,GAAG,MAAM,IAAI,EAAE,eAAe,CAAC;AAAA,QAC9D,WAAW,CAAC;AAAA,MACd,CAAC;AAAA,MAEH,YAAY,CAAC,YAAY,YACvBA,QAAO,IAAI,aAAa;AACtB,cAAM,YAAY,OAAO,IAAI,IAAI,YAAY;AAC7C,cAAM,WAAW,UAAU,IAAI,GAAG,UAAU,IAAI,OAAO,EAAE;AACzD,YAAI,CAAC,UAAU;AACb,iBAAO,OAAOA,QAAO,KAAK,IAAI,sBAAsB,EAAE,YAAY,QAAQ,CAAC,CAAC;AAAA,QAC9E;AACA,eAAO;AAAA,MACT,CAAC;AAAA,MAEH,mBAAmB,CAAC,eAClB,IAAI,IAAI,YAAY,EAAE;AAAA,QACpBA,QAAO;AAAA,UAAI,CAAC,MACV,MAAM,KAAK,EAAE,OAAO,CAAC,EAClB,OAAO,CAAC,MAAM,EAAE,OAAO,UAAU,EACjC,KAAK,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,OAAO;AAAA,QACzC;AAAA,MACF;AAAA,IACJ;AAAA,EACF,CAAC;AACH;;;AC3GO,IAAM,oBAAoB,MAAkC;","names":["Effect","Effect"]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@reactive-agents/prompts",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsup --config ../../tsup.config.base.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "test:watch": "bun test --watch"
+  },
+  "dependencies": {
+    "effect": "^3.10.0",
+    "@reactive-agents/core": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "bun-types": "latest"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tylerjrbuell/reactive-agents-ts.git",
+    "directory": "packages/prompts"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "description": "Prompt management for Reactive Agents — template engine and built-in prompt library",
+  "homepage": "https://tylerjrbuell.github.io/reactive-agents-ts/",
+  "bugs": {
+    "url": "https://github.com/tylerjrbuell/reactive-agents-ts/issues"
+  }
+}