@caretakerai/agent 0.0.3 → 0.0.4

package/README.md

@@ -0,0 +1,166 @@
+# Agent Framework Documentation
+
+The Agent Framework provides a flexible and extensible environment for building intelligent agents that can perform a variety of tasks. It is built on top of the `langchain` library and utilizes language models for natural language understanding and generation.
+
+## Key Components
+
+- `Agent`: The core class that represents an intelligent agent. It is initialized with a set of parameters that define its behavior, capabilities, and objectives.
+
+- `Activity`: Represents a single unit of work or thought that the agent performs. Activities can be of different kinds, such as `Observation`, `Thought`, or `Action`.
+
+- `Action`: A subclass of `Activity` that represents a concrete action the agent can take.
+
+- `Optimizer`: A component used to improve the agent's performance by optimizing its activities and decisions.
+
+## Initialization Parameters
+
+When creating an `Agent`, you must provide an `AgentPrams` object with the following properties:
+
+- `name`: The name of the agent.
+- `llm`: The language model the agent will use for understanding and generating text.
+- `actions`: A list of `Action` objects that the agent can perform.
+- `description`: (Optional) A description of the agent's purpose and capabilities.
+- `history`: (Optional) A list of `Activity` objects representing the agent's past experiences.
+- `examples`: (Optional) Examples of activities to guide the agent's behavior.
+- `constraints`: (Optional) A list of constraints that the agent must adhere to.
+- `objective`: (Optional) The goal the agent is trying to achieve.
+- `thoughtSuffix`: (Optional) A suffix to append to thoughts in the agent's output.
+- `actionSuffix`: (Optional) A suffix to append to actions in the agent's output.
+- `maxIterations`: (Optional) The maximum number of iterations the agent can perform in a single run.
+- `maxRetries`: (Optional) The maximum number of retries for actions.
+- `optimizer`: The optimizer used to improve the agent's performance.
+- `template`: (Optional) The template for generating prompts for the agent.
+- `logger`: (Optional) The logger the agent will use for outputting information.
+
+## Objective
+The `objective` parameter defines the goal or purpose that the Agent is trying to achieve. It is a guiding force for the Agent's behavior and decision-making process. When initializing an Agent, you can optionally provide an objective to inform the Agent's actions and ensure they align with the desired outcomes. Here is an example of how an objective might be set:
+
+```typescript
+const agent = new Agent({
+  // ... other parameters
+  objective: `Help the user with math calculations using specific actions.`,
+});
+```
+
+The objective will be included in the Agent's prompt template to provide context to the language model, ensuring that the Agent's interactions are focused and relevant to the goal.
+
+
+## Action
+Actions are the mechanisms through which an AI agent interacts with the application and its environment. They are the operational components that translate the agent's decisions into executable tasks. Each action extends from an abstract `Action` class, which provides a common structure and ensures compatibility with the agent framework.
+
+Here's an example of an `Action` subclass:
+
+```typescript
+import { Action, ActionInput } from '@caretaker/agent';
+
+export class Say extends Action {
+  async call(input: ActionInput): Promise<void> {
+    // Logic to perform the action, e.g., output a message
+    console.log(input.params.message);
+  }
+}
+```
+
+In this `Say` action example, the `call` method is where the action's specific behavior is implemented. When an agent decides to use the `Say` action, it will call this method, passing in the necessary parameters.
+
+Actions are defined and added to the agent's configuration, allowing the agent to use them during its processing loop. They serve as the bridge between the AI's decision-making capabilities and the application's functional operations, enabling the agent to perform tasks such as communicating with the user or calculating results.
+
+The parameters for actions are defined using JSON Schema, which provides a clear and enforceable structure for the data that an action can accept. This ensures that the agent and the actions it performs can interact with consistent and validated data formats.
+
+For example, in the `Say` action from `@say.ts`, the parameters are defined as follows:
+
+```typescript
+const SayParamsSchema = z.object({
+  message: z.string().describe('message to say to the user'),
+}).describe('Parameters for Say action');
+```
+
+This schema is then converted to a JSON Schema, which is used by the `Say` action to validate the parameters before the action is executed:
+
+```typescript
+const SayParamsJsonSchema = zodToJsonSchema(SayParamsSchema, 'SayParamsSchema')
+  .definitions!.SayParamsSchema as JSONSchema;
+```
+
+The use of JSON Schema in action parameters allows for the automatic validation of inputs, ensuring that only the correct data types and structures are passed to the action's `call` method. This is crucial for maintaining the integrity of the agent's operations and preventing runtime errors due to invalid data.
+
+
+The `Multiply` action example above demonstrates how to define an action with input parameters and a return type using Zod schemas and TypeScript. The `params` property is assigned a JSON Schema that is generated from the Zod schema, which is used for runtime validation of the action's input parameters. The `call` method implements the logic to multiply an array of numbers, which are provided as input parameters, and returns the multiplication result. This action can be used by the agent to perform multiplication operations as part of its task execution.
+
+
+```typescript
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { Action, ActionInput } from '@caretaker/agent';
+import { JSONSchema } from 'json-schema-to-typescript';
+
+// Define the parameters schema using Zod for the Multiply action
+const MultiplyParamsSchema = z.array(z.number()).describe('Array of numbers to multiply');
+// Infer the TypeScript type from the Zod schema
+type MultiplyParams = z.infer<typeof MultiplyParamsSchema>;
+// Convert the Zod schema to a JSON Schema for runtime validation
+const MultiplyParamsJsonSchema = zodToJsonSchema(MultiplyParamsSchema, 'MultiplyParamsSchema')
+  .definitions!.MultiplyParamsSchema as JSONSchema;
+
+// Define the result schema using Zod for the Multiply action
+const MultiplyResultSchema = z.number().describe('The result of the multiplication');
+// Infer the TypeScript type from the Zod schema
+type MultiplyResult = z.infer<typeof MultiplyResultSchema>;
+// Convert the Zod schema to a JSON Schema for runtime validation
+const MultiplyResultJsonSchema = zodToJsonSchema(MultiplyResultSchema, 'MultiplyResultSchema')
+  .definitions!.MultiplyResultSchema as JSONSchema;
+
+// Multiply action class definition
+export class Multiply extends Action<MultiplyParams, MultiplyResult> {
+  // Assign the JSON Schema to the params and result properties
+  readonly params = MultiplyParamsJsonSchema;
+  readonly result = MultiplyResultJsonSchema;
+  // Define whether this action should signal the agent to exit
+  readonly exit = false;
+  // Define the kind of action, which is the class name
+  readonly kind = Multiply.name;
+  // Provide a description for the action
+  readonly description = 'Multiply the numbers and provide you with the result.';
+  // Provide examples of usage (optional)
+  readonly examples = [];
+
+  // The call method is invoked by the agent when this action is performed
+  async call({ params }: ActionInput<MultiplyParams>): Promise<MultiplyResult> {
+    // Implement the action logic: multiply the numbers provided in params
+    return params.reduce((acc, n) => acc * n, 1);
+  }
+}
+```
+
+## Usage
+
+To use the Agent Framework, create an instance of the `Agent` class with the necessary parameters, including the language model, actions, and any optional configurations such as history, objectives, and optimizers. Then, invoke the `agent.invoke()` method to start the agent's processing loop. The agent will utilize the provided actions, such as `Say` to communicate with the user or `Multiply` to perform multiplication tasks, to fulfill its objectives within the given constraints.
+
+```typescript
+import { Agent, Activity, ActivityKind } from '@caretaker/agent';
+import { OpenAI } from 'langchain/llms/openai';
+import { Say } from './actions/say';
+
+const llm = new OpenAI({
+  modelName: 'gpt-3.5-turbo',
+  temperature: 0.7,
+  maxTokens: 256,
+});
+
+const agent = new Agent({
+  name: 'CalculatorAI',
+  description: 'An agent that performs arithmetic operations',
+  llm,
+  actions: [
+    new Say(),
+    // ... other actions
+  ],
+  history: [
+    new Activity({ kind: ActivityKind.Observation, input: 'The user says: How can you help me?' })
+  ],
+  // ... other parameters
+});
+
+await agent.invoke();
+```
+

package/dist/action.d.ts

@@ -1,22 +1,23 @@
 import type { Agent } from './agent';
-import type { Activity } from './activity';
-export interface ActionInput {
-    input: string;
+import { type JSONSchema } from 'json-schema-to-typescript';
+import { Activity } from './activity';
+export interface ActionInput<T> {
+    params: T;
     agent: Agent;
 }
 export interface ActionExample {
     description?: string;
     activities: Activity[];
 }
-export declare abstract class Action {
+export declare abstract class Action<P = any, R = any> {
     abstract get exit(): boolean;
     abstract get kind(): string;
     abstract get description(): string;
+    abstract get params(): JSONSchema;
+    abstract get result(): JSONSchema;
     abstract get examples(): ActionExample[];
-    abstract execute(input: ActionInput): Promise<string>;
-    toString(): string;
-    static parse(text: string): {
-        kind: string;
-        input: string;
-    };
+    abstract call(input: ActionInput<P>): Promise<R>;
+    private _examplesPrompt;
+    _prompt(template?: string): Promise<string>;
+    _call(input: string, agent: Agent): Promise<string>;
 }

package/dist/action.js

@@ -5,32 +5,75 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Action = void 0;
 const dedent_1 = __importDefault(require("dedent"));
+const ajv_1 = __importDefault(require("ajv"));
+const ajv_errors_1 = __importDefault(require("ajv-errors"));
+const prompts_1 = require("langchain/prompts");
+const json_schema_to_typescript_1 = require("json-schema-to-typescript");
 const constants_1 = require("./constants");
+const ajv = (0, ajv_errors_1.default)(new ajv_1.default({
+    useDefaults: true,
+    removeAdditional: true,
+    allErrors: true,
+}));
+const ACTION_TEMPLATE = (`
+\`\`\`ts
+{params}
+{result}
+/**
+{description}
+ * @kind {kind}
+ * @param {{{paramsType}}} params - {kind} action params
+ * @returns {{resultType}} {kind} action result
+ * /
+function {kind}(params: {paramsType}): {resultType}
+{examples}\`\`\`
+`).trim();
 class Action {
-    toString() {
-        const examples = this.examples
-            .reduce((acc, { description, activities }) => (0, dedent_1.default) `
-        ${acc}
-
-        ${description}
-        \`\`\`
-        ${activities.map(a => a.toString()).join(`\n${constants_1.ACTIVITY_SEP}\n`)}
-        \`\`\`
-      `.trim(), '');
-        return (0, dedent_1.default) `
-      ### ${this.kind}
-      ${this.description}
-
-      #### Examples
-      ${examples}
-      `.trim();
+    _examplesPrompt() {
+        return this.examples
+            .map(({ activities, description }) => [
+            (0, dedent_1.default) `
+        /**
+         * @example ${description}`,
+            activities.map(a => a.prompt())
+                .join(constants_1.ACTIVITY_SEP)
+                .split('\n')
+                .map(s => ` * ${s}`)
+                .join('\n'),
+            ' */'
+        ].join('\n'))
+            .join('\n\n') + '\n';
     }
-    static parse(text) {
-        const [kind, ...rest] = text.split('\n');
-        return {
-            kind: kind.trim(),
-            input: rest.join('\n'),
-        };
+    async _prompt(template = ACTION_TEMPLATE) {
+        const paramsType = `${this.kind}Params`;
+        const resultType = `${this.kind}Result`;
+        const partial = await prompts_1.PromptTemplate.fromTemplate(template).partial({
+            params: () => (0, json_schema_to_typescript_1.compile)(this.params, paramsType, { bannerComment: '' }),
+            result: () => (0, json_schema_to_typescript_1.compile)(this.result, resultType, { bannerComment: '' }),
+            examples: () => this._examplesPrompt()
+        });
+        return partial.format({
+            kind: this.kind,
+            description: this.description
+                .split('\n')
+                .map(s => ` * ${s}`)
+                .join('\n'),
+            paramsType,
+            resultType,
+        });
+    }
+    async _call(input, agent) {
+        const params = JSON.parse(input);
+        const validator = ajv.compile(this.params);
+        const isValid = validator(params);
+        if (!isValid) {
+            throw new Error(`Action "${this.kind}" params are not valid: ${ajv.errorsText(validator.errors)} `);
+        }
+        const result = await this.call({ params, agent });
+        if (typeof result === 'string') {
+            return result;
+        }
+        return JSON.stringify(result);
     }
 }
 exports.Action = Action;

package/dist/action.js.map

@@ -1 +1 @@
-{"version":3,"file":"action.js","sourceRoot":"","sources":["../src/action.ts"],"names":[],"mappings":";;;;;;AAAA,oDAA4B;AAG5B,2CAA2C;AAY3C,MAAsB,MAAM;IAQ1B,QAAQ;QACN,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ;aAC3B,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,IAAA,gBAAM,EAAA;UAChD,GAAG;;UAEH,WAAW;;UAEX,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,wBAAY,IAAI,CAAC;;OAEhE,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAEhB,OAAO,IAAA,gBAAM,EAAA;YACL,IAAI,CAAC,IAAI;QACb,IAAI,CAAC,WAAW;;;QAGhB,QAAQ;OACT,CAAC,IAAI,EAAE,CAAA;IACZ,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,IAAY;QACvB,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAExC,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;YACjB,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;SACvB,CAAC;IACJ,CAAC;CACF;AApCD,wBAoCC"}
+{"version":3,"file":"action.js","sourceRoot":"","sources":["../src/action.ts"],"names":[],"mappings":"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"}

package/dist/activity.d.ts

@@ -5,19 +5,16 @@ export declare enum ActivityKind {
 }
 export type ActivityParams = {
     kind: ActivityKind;
-    order: number;
     input: string;
-    tokens?: number;
+    attributes?: Record<string, string>;
 };
 export declare class Activity implements ActivityParams {
     kind: ActivityKind;
-    order: number;
+    attributes?: Record<string, string>;
     input: string;
-    tokens?: number;
-    static readonly defaults: Partial<ActivityParams>;
     constructor(params: ActivityParams);
-    toString(): string;
+    prompt(): string;
     toObject(): this;
-    static parse(text: string): Activity;
-    static fromObject({ kind, order, input }: Record<string, any>): Activity;
+    static fromObject({ kind, attributes, input }: Record<string, any>): Activity;
+    static parse(text: string): Activity[];
 }

package/dist/activity.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Activity = exports.ActivityKind = void 0;
+const xml_js_1 = require("xml-js");
 var ActivityKind;
 (function (ActivityKind) {
     ActivityKind["Observation"] = "Observation";
@@ -8,35 +9,36 @@ var ActivityKind;
     ActivityKind["Action"] = "Action";
 })(ActivityKind || (exports.ActivityKind = ActivityKind = {}));
 class Activity {
+    kind;
+    attributes;
+    input;
     constructor(params) {
         Object.assign(this, params);
     }
-    toString() {
-        return `//${this.kind} ${this.order}// ${this.input}`;
+    prompt() {
+        return (0, xml_js_1.js2xml)({ [this.kind]: { _attributes: this.attributes ?? {}, _text: `\n${this.input}\n`, } }, { compact: true })
+            .replaceAll('&lt;', '<')
+            .replaceAll('&gt;', '>');
     }
     toObject() {
         return { ...this };
     }
-    static parse(text) {
-        var _a, _b;
-        const kindRegexp = /^\/\/(.+?)\s/;
-        const orderRegexp = /^\/\/\w+\s(.+?)\/\//;
-        if (!kindRegexp.test(text)) {
-            throw new Error('Cannot parse kind from the given text');
-        }
-        const kind = (_a = text.match(kindRegexp)) === null || _a === void 0 ? void 0 : _a[1].trim();
-        if (!orderRegexp.test(text)) {
-            throw new Error('Cannot parse order from the given text');
-        }
-        const order = parseInt((_b = text.match(orderRegexp)) === null || _b === void 0 ? void 0 : _b[1].trim());
-        const input = text.replace(/^\/\/.+\/\/\s/, '');
-        const activity = new Activity({ kind, order, input });
-        return activity;
+    static fromObject({ kind, attributes, input }) {
+        return new Activity({ kind, attributes, input });
     }
-    static fromObject({ kind, order, input }) {
-        return new Activity({ kind, order, input });
+    static parse(text) {
+        const { elements: [root] } = (0, xml_js_1.xml2js)(`<root>${text}</root>`, { trim: true });
+        return root.elements.map(({ name, attributes, elements }) => {
+            const input = (0, xml_js_1.js2xml)({ elements })
+                .replaceAll('&lt;', '<')
+                .replaceAll('&gt;', '>');
+            return Activity.fromObject({
+                kind: name,
+                input: input,
+                attributes: attributes,
+            });
+        });
     }
 }
 exports.Activity = Activity;
-Activity.defaults = {};
 //# sourceMappingURL=activity.js.map

package/dist/activity.js.map

@@ -1 +1 @@
-{"version":3,"file":"activity.js","sourceRoot":"","sources":["../src/activity.ts"],"names":[],"mappings":";;;AAAA,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,2CAA2B,CAAA;IAC3B,mCAAmB,CAAA;IACnB,iCAAiB,CAAA;AACnB,CAAC,EAJW,YAAY,4BAAZ,YAAY,QAIvB;AASD,MAAa,QAAQ;IASnB,YAAY,MAAsB;QAChC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,QAAQ;QACN,OAAO,KAAK,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACxD,CAAC;IAED,QAAQ;QACN,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,IAAY;;QACvB,MAAM,UAAU,GAAG,cAAc,CAAC;QAClC,MAAM,WAAW,GAAG,qBAAqB,CAAC;QAE1C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC1B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;SAC1D;QAED,MAAM,IAAI,GAAG,MAAA,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,0CAAG,CAAC,EAAE,IAAI,EAAmB,CAAC;QAEjE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC3B,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;SAC3D;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAA,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,0CAAG,CAAC,EAAE,IAAI,EAAG,CAAC,CAAC;QAE7D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAEtD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAuB;QAC3D,OAAO,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9C,CAAC;;AA7CH,4BA8CC;AAxCiB,iBAAQ,GAA4B,EACnD,CAAA"}
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../src/activity.ts"],"names":[],"mappings":";;;AAAA,mCAAiD;AAKjD,IAAY,YAOX;AAPD,WAAY,YAAY;IAEtB,2CAA2B,CAAA;IAE3B,mCAAmB,CAAA;IAEnB,iCAAiB,CAAA;AACnB,CAAC,EAPW,YAAY,4BAAZ,YAAY,QAOvB;AAcD,MAAa,QAAQ;IACnB,IAAI,CAAgB;IACpB,UAAU,CAA0B;IACpC,KAAK,CAAU;IAEf,YAAY,MAAsB;QAChC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM;QACJ,OAAO,IAAA,eAAM,EACX,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,IAAI,CAAC,KAAK,IAAI,GAAG,EAAE,EACpF,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB;aACE,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC;aACvB,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,QAAQ;QACN,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAuB;QAChE,OAAO,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,IAAY;QACvB,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,IAAA,eAAM,EAAC,SAAS,IAAI,SAAS,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAE,CAAC;QAE7E,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAW,EAAE,EAAE;YACnE,MAAM,KAAK,GAAG,IAAA,eAAM,EAAC,EAAE,QAAQ,EAAE,CAAC;iBAC/B,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC;iBACvB,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAE3B,OAAO,QAAQ,CAAC,UAAU,CAAC;gBACzB,IAAI,EAAE,IAAI;gBACV,KAAK,EAAE,KAAK;gBACZ,UAAU,EAAE,UAAU;aACvB,CAAC,CAAC;QACL,CAAC,CAAC,CAAA;IACJ,CAAC;CACF;AAzCD,4BAyCC"}

package/dist/agent.d.ts

@@ -1,39 +1,48 @@
-import { BaseLanguageModel } from 'langchain/base_language';
+import { Logger } from 'winston';
 import { BasePromptTemplate } from 'langchain/prompts';
 import { Action } from './action';
 import { Activity } from './activity';
 import { Optimizer } from './types';
+import { BaseLLM } from 'langchain/dist/llms/base';
 interface AgentPrams {
     name: string;
     description: string;
-    llm: BaseLanguageModel;
+    llm: BaseLLM;
     actions: Action[];
-    activities?: Activity[];
-    example?: Activity[];
-    instruction: string;
+    history?: Activity[];
+    examples?: Activity[];
+    constrains?: string[];
+    objective?: string;
+    thoughtSuffix?: string;
+    actionSuffix?: string;
+    maxIterations?: number;
+    maxRetries?: number;
     optimizer: Optimizer;
     template?: BasePromptTemplate;
     stop?: string[];
+    logger?: Logger;
 }
 export declare class Agent implements AgentPrams {
     name: string;
     description: string;
-    llm: BaseLanguageModel;
+    llm: BaseLLM;
     actions: Action[];
-    activities: Activity[];
-    example: Activity[];
-    instruction: string;
+    history: Activity[];
+    examples: Activity[];
+    constrains: string[];
+    objective: string;
+    thoughtSuffix: string;
+    actionSuffix: string;
+    maxIterations: number;
+    maxRetries: number;
     optimizer: Optimizer;
+    logger: Logger;
     template?: BasePromptTemplate;
-    stop?: string[];
     static defaults: Partial<AgentPrams>;
-    static parseActivities(input: string): Activity[];
     constructor(params: AgentPrams);
-    appendActivity(...experience: Activity[]): void;
-    complete(experienceTemplate: Activity): Promise<Activity[]>;
-    think(latestActivity: Activity): Promise<void>;
-    act(latestActivity: Activity): Promise<void>;
-    execute(latestActivity: Activity): Promise<string>;
-    invoke(): Promise<string>;
+    addActivities(...activities: Activity[]): void;
+    prompt(params?: Record<string, string>): Promise<Activity[]>;
+    execute({ attributes, input }: Activity): Promise<string>;
+    invoke(params?: Record<string, any>): Promise<string>;
 }
 export {};

package/dist/agent.js

@@ -1,20 +1,82 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Agent = void 0;
+const dedent_1 = __importDefault(require("dedent"));
+const winston_1 = require("winston");
 const prompts_1 = require("langchain/prompts");
 const runnable_1 = require("langchain/schema/runnable");
 const output_parser_1 = require("langchain/schema/output_parser");
-const action_1 = require("./action");
 const constants_1 = require("./constants");
 const activity_1 = require("./activity");
 class Agent {
-    static parseActivities(input) {
-        return input
-            .split('\n//')
-            .filter(text => text)
-            .map(text => `//${text.replace(/^\/\//, '').trim()}`)
-            .map(text => activity_1.Activity.parse(text.trim()));
-    }
+    name;
+    description;
+    llm;
+    actions;
+    history;
+    examples;
+    constrains;
+    objective;
+    thoughtSuffix;
+    actionSuffix;
+    maxIterations;
+    maxRetries;
+    optimizer;
+    logger;
+    template;
+    static defaults = {
+        template: prompts_1.PromptTemplate.fromTemplate((0, dedent_1.default) `
+      # Objective
+      {objective}
+
+      # Constraints
+      {constraints}
+
+      # Actions
+      The only permissible actions you may take are listed below:
+      {actions}
+
+      **Continue the History with the following format in your response:**
+      {examples}
+
+      # History:
+      {history}
+      {suffix}
+    `.trim()),
+        objective: 'You are helpful assistant.',
+        thoughtSuffix: '<!-- Provide thought and action here -->',
+        actionSuffix: '<!-- Provide action here -->',
+        maxRetries: 7,
+        maxIterations: Number.MAX_SAFE_INTEGER,
+        logger: (0, winston_1.createLogger)({ transports: [new winston_1.transports.Console()] }),
+        examples: [
+            new activity_1.Activity({
+                kind: activity_1.ActivityKind.Observation,
+                input: 'The result of previously taken action',
+            }),
+            new activity_1.Activity({
+                kind: activity_1.ActivityKind.Thought,
+                input: 'You must always think before taking the action',
+            }),
+            new activity_1.Activity({
+                kind: activity_1.ActivityKind.Action,
+                attributes: { kind: 'the action kind to take, should be one of listed in Actions section' },
+                input: (0, dedent_1.default) `
+          <!-- The action input as valid JSON e.g. -->
+          {
+            "message": "hello!!"
+          }
+        `.trim(),
+            }),
+        ],
+        constrains: [
+            'Use only actions listed in Actions section.',
+            'Reject any request that are not related to your objective and cannot be fulfilled within the given list of actions.',
+        ]
+    };
     constructor(params) {
         const { actions } = params;
         if (!actions.length) {
@@ -22,94 +84,99 @@ class Agent {
         }
         Object.assign(this, Agent.defaults, params);
     }
-    appendActivity(...experience) {
-        experience.forEach(e => console.log(e.toString()));
-        this.activities.push(...experience);
+    addActivities(...activities) {
+        activities.forEach(a => this.logger.debug(a));
+        this.history.push(...activities);
     }
-    async complete(experienceTemplate) {
-        const activities = await this.optimizer.optimize(this.activities);
-        const completion = await runnable_1.RunnableSequence.from([
-            this.template,
-            this.llm.bind({ stop: this.stop }),
+    async prompt(params) {
+        let activities = [];
+        const history = async () => {
+            const history = [...await this.optimizer.optimize([...this.history, ...activities])];
+            const historyStrings = history.map(h => h.prompt()).join(constants_1.ACTIVITY_SEP);
+            return historyStrings;
+        };
+        const actions = async () => {
+            const actionsStrings = await Promise.all(this.actions.map(a => a._prompt()));
+            return actionsStrings.join(constants_1.ACTION_SEP);
+        };
+        const constraints = () => this.constrains.map((c, i) => `${i + 1}. ${c}`).join('\n');
+        const examples = async () => {
+            const examplesStrings = this.examples.map(h => h.prompt()).join(constants_1.ACTIVITY_SEP);
+            return examplesStrings;
+        };
+        const suffix = () => ([...this.history, ...activities].at(-1).kind === activity_1.ActivityKind.Observation
+            ? this.thoughtSuffix
+            : this.actionSuffix);
+        const template = await this.template.partial({
+            objective: this.objective,
+            history,
+            actions,
+            constraints,
+            examples,
+            suffix,
+        });
+        const seq = runnable_1.RunnableSequence.from([
+            template,
+            this.llm.bind({ stop: [`<${activity_1.ActivityKind.Observation}>`] }),
             new output_parser_1.StringOutputParser(),
-        ]).invoke({
-            instruction: this.instruction,
-            actions: this.actions.map((a, index) => `${index + 1}. ${a.toString()}`).join(constants_1.ACTION_SEP),
-            example: this.example.map(e => e.toString()).join(`\n`),
-            activities: [...activities, experienceTemplate].map(e => e.toString()).join(`\n`),
-        }, {
-            callbacks: [
-                {
-                    handleLLMStart: (llm, prompts) => {
-                    }
+        ]);
+        for (let i = 0; i < this.maxRetries; ++i) {
+            let completion = await seq.invoke(params ?? {});
+            try {
+                activities = [...activities, ...activity_1.Activity.parse(completion)];
+            }
+            catch (e) {
+                this.logger.warn(e);
+                this.logger.debug(`Retry ${i + 1} due to malformed output`);
+                continue;
+            }
+            const activity = activities.at(-1);
+            if (activity.kind === activity_1.ActivityKind.Thought) {
+                this.logger.debug(`Retry ${i + 1} due to missing action`);
+                continue;
+            }
+            if (activity.kind === activity_1.ActivityKind.Action) {
+                try {
+                    const observation = await this.execute(activity);
+                    return [...activities, new activity_1.Activity({ kind: activity_1.ActivityKind.Observation, input: observation })];
                 }
-            ]
-        });
-        return Agent.parseActivities(experienceTemplate.toString() + completion.trim());
-    }
-    async think(latestActivity) {
-        this.appendActivity(...(await this.complete(new activity_1.Activity({
-            kind: activity_1.ActivityKind.Thought,
-            order: latestActivity.order,
-            input: '',
-        }))));
-    }
-    async act(latestActivity) {
-        this.appendActivity(...(await this.complete(new activity_1.Activity({
-            kind: activity_1.ActivityKind.Action,
-            order: latestActivity.order,
-            input: '',
-        }))));
+                catch (e) {
+                    const err = e;
+                    activities.push(new activity_1.Activity({ kind: activity_1.ActivityKind.Observation, input: err.toString() }));
+                    this.logger.debug(`Retry ${i + 1} due to action error`);
+                    continue;
+                }
+            }
+        }
+        throw new Error('Max number of retries reached.');
     }
-    async execute(latestActivity) {
-        const { kind, input } = action_1.Action.parse(latestActivity.input);
+    async execute({ attributes, input }) {
+        const { kind } = attributes;
         const action = this.actions.find(a => a.kind === kind);
         if (!action) {
-            throw new Error(`Action "${kind}" is not permitted.`);
-        }
-        const observation = await action.execute({ agent: this, input });
-        this.appendActivity(new activity_1.Activity({
-            kind: activity_1.ActivityKind.Observation,
-            order: latestActivity.order + 1,
-            input: observation,
-        }));
-        if (action.exit) {
-            return observation;
+            throw new Error(`Action "${kind}" is not allowed.`);
         }
+        const observation = await action._call(input, this);
+        return observation;
     }
-    async invoke() {
-        var _a;
-        if (!this.activities.length) {
+    async invoke(params) {
+        if (!this.history.length) {
             throw new Error('Activity list must not be empty.');
         }
-        if (((_a = this.activities.at(-1)) === null || _a === void 0 ? void 0 : _a.kind) !== activity_1.ActivityKind.Observation) {
-            throw new Error('Lastest experience must be of Observation kind');
+        if (this.history.at(-1)?.kind !== activity_1.ActivityKind.Observation) {
+            throw new Error('Latest experience must be of Observation kind');
         }
-        while (true) {
-            const latestActivity = this.activities.at(-1);
-            if (latestActivity.kind === activity_1.ActivityKind.Observation) {
-                await this.think(latestActivity);
-            }
-            else if (latestActivity.kind === activity_1.ActivityKind.Thought) {
-                await this.act(latestActivity);
-            }
-            else if (latestActivity.kind === activity_1.ActivityKind.Action) {
-                const result = await this.execute(latestActivity);
-                if (result) {
-                    return result;
-                }
-            }
-            else {
-                throw new Error(`Activity "${latestActivity.kind}" is not permitted.`);
+        for (let i = 0; i < this.maxIterations; ++i) {
+            const activities = await this.prompt(params);
+            this.addActivities(...activities);
+            const activity = this.history.at(-2);
+            const action = this.actions.find(a => a.kind === activity.attributes.kind);
+            if (action.exit) {
+                return this.history.at(-1).input;
             }
         }
+        throw new Error('Max number of iterations reached.');
     }
 }
 exports.Agent = Agent;
-Agent.defaults = {
-    template: prompts_1.PromptTemplate.fromTemplate(constants_1.TEMPLATE),
-    stop: [`//${activity_1.ActivityKind.Observation}`],
-    activities: [],
-    example: []
-};
 //# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/constants.d.ts

@@ -1,3 +1,2 @@
 export declare const ACTION_SEP = "\n\n";
-export declare const ACTIVITY_SEP = "***";
-export declare const TEMPLATE: string;
+export declare const ACTIVITY_SEP = "\n";

package/dist/constants.js

@@ -1,24 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TEMPLATE = exports.ACTIVITY_SEP = exports.ACTION_SEP = void 0;
+exports.ACTIVITY_SEP = exports.ACTION_SEP = void 0;
 exports.ACTION_SEP = '\n\n';
-exports.ACTIVITY_SEP = '***';
-exports.TEMPLATE = `
-## Instruction
-{instruction}
-
-## Additional Requirements:
-1. I understand that there are no exceptions;
-2. I am not permitted to perform any actions other than those listed in section Actions;
-3. I must provide your thoughts on the observations before proceeding to the next action;
-4. I am strongly prohibited from using Observations, Actions, and Thoughts provided in the Action examples as the source of truth;
-
-## Actions
-The permissible actions I may take are listed below:
-{actions}
-
-## Context:
-{example}
-{activities}
-`.trim();
+exports.ACTIVITY_SEP = '\n';
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,UAAU,GAAG,MAAM,CAAA;AACnB,QAAA,YAAY,GAAG,KAAK,CAAC;AACrB,QAAA,QAAQ,GAAG;;;;;;;;;;;;;;;;;CAiBvB,CAAC,IAAI,EAAE,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,UAAU,GAAG,MAAM,CAAA;AACnB,QAAA,YAAY,GAAG,IAAI,CAAC"}

package/package.json

@@ -1,25 +1,33 @@
 {
   "name": "@caretakerai/agent",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "Single framework for building text-agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
-    "build": "tsc"
+    "build": "rimraf dist && tsc",
+    "build:watch": "tsc --watch"
   },
   "author": "",
   "license": "ISC",
   "dependencies": {
+    "ajv": "^8.12.0",
+    "ajv-errors": "^3.0.0",
     "debug": "^4.3.4",
-    "langchain": "^0.0.151"
+    "json-schema-to-typescript": "^13.1.1",
+    "langchain": "^0.0.191",
+    "xml-js": "^1.6.11"
   },
   "devDependencies": {
     "@types/node": "^20.4.1",
+    "rimraf": "^5.0.5",
     "tsx": "^3.12.7",
-    "typescript": "^5.2.2"
+    "typescript": "^5.2.2",
+    "winston": "^3.11.0"
   }
 }