@aigne/core 1.72.0 → 1.74.0-beta

package/lib/cjs/prompt/compact/user-memory-extractor.js

@@ -1,124 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AIUserMemoryExtractor = void 0;
-const zod_1 = require("zod");
-const ai_agent_js_1 = require("../../agents/ai-agent.js");
-const type_utils_js_1 = require("../../utils/type-utils.js");
-const EXTRACTOR_INSTRUCTIONS = `\
-You are a user memory extractor. Your task is to extract long-term user memory facts from session memory that represent verified, persistent user characteristics.
-
-## Session Memory Facts (from current session)
-
-${"```"}yaml alt="session-facts"
-{{ sessionFacts | yaml.stringify }}
-${"```"}
-
-## Existing User Memory Facts
-
-${"```"}yaml alt="existing-user-facts"
-{{ existingUserFacts | yaml.stringify }}
-${"```"}
-
-## Guidelines
-
-1. **Extract session facts into long-term user memory**:
-   - Promote facts that represent lasting user characteristics (preferences, skills, working style)
-   - Filter out temporary or session-specific information
-   - Aggregate patterns observed across multiple sessions
-   - Verify consistency with existing user memory
-
-2. **User memory should focus on USER characteristics**:
-   - **Preferences**: Lasting tool/framework/language preferences the user likes to use
-   - **Skills**: Confirmed technical expertise and proficiency levels of the user
-   - **Working style**: User's communication preferences, workflow patterns, coding standards
-   - **Personal context**: Stable personal context (timezone, team structure, role, work hours)
-   - **Project basic info**: What projects the user is working on and their role in them
-     - Example: "User is building an AI Agent framework called aigne-framework"
-     - Example: "User is the tech lead on a React e-commerce project"
-     - DO NOT include project technical details, architecture, or implementation specifics
-
-3. **DO NOT include in user memory**:
-   - Session-specific tasks or temporary goals
-   - Bugs or issues being debugged in a specific session
-   - One-time decisions or experimental choices
-   - Unverified assumptions or single-instance observations
-   - **Project technical details**: architecture decisions, tech stack specifics, implementation details
-   - **Project problems**: current bugs, issues, technical debt, or temporary blockers
-   - Information about the codebase structure or specific files/modules
-
-4. **Output only changes (CRITICAL)**:
-   - Only output facts that need to be added or updated
-   - DO NOT output facts that already exist and don't need changes
-   - Each label in newFacts must be unique
-   - When a label already exists in user memory:
-     - Include it in newFacts ONLY if session provides new information to update it
-     - Omit it from newFacts if it doesn't need changes
-   - Use the same label format as session memory: "pref-*", "skill-*", "proj-*", "ctx-*"
-
-5. **When to output a fact in newFacts**:
-   - **New fact**: Extracting a brand new user characteristic not in existing user memory
-   - **Updated fact**: Session provides new information that enhances an existing fact
-   - **Refined fact**: Multiple sessions show patterns that refine existing facts
-   - DO NOT output if: The fact already exists and session doesn't add new information
-
-6. **When to remove facts** (add labels to removeFacts):
-   - Facts are proven to be outdated or incorrect
-   - User explicitly changed their approach permanently
-   - Facts are redundant with newer, better facts
-
-7. **Confidence scoring**:
-   - Higher confidence (0.8-1.0): Verified across multiple sessions or explicitly stated
-   - Medium confidence (0.5-0.7): Observed patterns but limited data
-   - Lower confidence (0.3-0.4): Tentative patterns, may need more verification
-   - Below 0.3: Don't extract into user memory yet
-
-8. **Extraction criteria**:
-   - Only extract facts that are clearly valuable long-term
-   - Prefer quality over quantity - fewer high-confidence facts are better
-   - When in doubt, wait for more sessions to verify the pattern
-
-Output the extracted user memory facts and any facts to remove.`;
-class AIUserMemoryExtractor extends ai_agent_js_1.AIAgent {
-    constructor(options) {
-        super({
-            name: "UserMemoryExtractor",
-            description: "Extracts long-term user memory facts from session memory",
-            inputSchema: zod_1.z.object({
-                sessionFacts: zod_1.z
-                    .array(zod_1.z.object({
-                    label: zod_1.z.string(),
-                    fact: zod_1.z.string(),
-                    confidence: (0, zod_1.optional)(zod_1.z.number()),
-                    tags: (0, zod_1.optional)(zod_1.z.array(zod_1.z.string())),
-                }))
-                    .describe("Session memory facts to extract from"),
-                existingUserFacts: (0, zod_1.optional)(zod_1.z
-                    .array(zod_1.z.object({
-                    label: zod_1.z.string(),
-                    fact: zod_1.z.string(),
-                    confidence: (0, zod_1.optional)(zod_1.z.number()),
-                    tags: (0, zod_1.optional)(zod_1.z.array(zod_1.z.string())),
-                }))
-                    .describe("Existing user memory facts for context and deduplication")),
-            }),
-            outputSchema: zod_1.z.object({
-                newFacts: zod_1.z
-                    .array(zod_1.z.object({
-                    label: zod_1.z.string().describe("Short, semantic label for the fact (must be unique)"),
-                    fact: zod_1.z.string().describe("The extracted fact content"),
-                    confidence: (0, zod_1.optional)(zod_1.z.number().min(0).max(1).describe("Confidence score (0-1)")),
-                    tags: (0, zod_1.optional)(zod_1.z.array(zod_1.z.string()).describe("Classification tags")),
-                }))
-                    .describe("Facts to add or update in user memory. Only include facts that are new or need updates. Do not include unchanged facts."),
-                removeFacts: (0, zod_1.optional)(zod_1.z.array(zod_1.z.string()).describe("Labels of facts to remove from user memory")),
-            }),
-            instructions: EXTRACTOR_INSTRUCTIONS,
-            taskRenderMode: "hide",
-            ...(0, type_utils_js_1.omitBy)(options ?? {}, (v) => (0, type_utils_js_1.isNil)(v)),
-            session: {
-                mode: "disabled",
-            },
-        });
-    }
-}
-exports.AIUserMemoryExtractor = AIUserMemoryExtractor;

package/lib/cjs/prompt/context/afs/history.d.ts

@@ -1,9 +0,0 @@
-import type { AFSListOptions } from "@aigne/afs";
-import type { Agent } from "../../../agents/agent.js";
-export declare function getHistories({ filter, agent, }: {
-    filter: AFSListOptions["filter"];
-    agent: Agent;
-}): Promise<{
-    role: "user" | "agent";
-    content: unknown;
-}[]>;

package/lib/cjs/prompt/context/afs/history.js

@@ -1,33 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getHistories = getHistories;
-const afs_history_1 = require("@aigne/afs-history");
-const type_utils_js_1 = require("../../../utils/type-utils.js");
-async function getHistories({ filter, agent, }) {
-    const afs = agent?.afs;
-    if (!afs)
-        return [];
-    const historyModule = (await afs.listModules()).find((m) => m.module instanceof afs_history_1.AFSHistory);
-    if (!historyModule)
-        return [];
-    const history = (await afs.list(historyModule.path, {
-        filter,
-        limit: 10,
-        orderBy: [["createdAt", "desc"]],
-    })).data;
-    return history
-        .reverse()
-        .map((i) => {
-        if (!i.content)
-            return;
-        const { input, output } = i.content;
-        if (!input || !output)
-            return;
-        return [
-            { role: "user", content: input },
-            { role: "agent", content: output },
-        ];
-    })
-        .filter(type_utils_js_1.isNonNullable)
-        .flat();
-}

package/lib/cjs/prompt/context/afs/index.d.ts

@@ -1,20 +0,0 @@
-import type { AFSRootListOptions, AFSRootSearchOptions } from "@aigne/afs";
-import type { Agent, AgentInvokeOptions } from "../../../agents/agent.js";
-export declare function createAFSContext(agent?: Agent<any, any>, context?: AgentInvokeOptions["context"]): {
-    readonly enabled: boolean;
-    description: string;
-    readonly modules: Promise<Pick<{
-        name: string;
-        path: string;
-        description?: string;
-        module: import("@aigne/afs").AFSModule;
-    }, "path" | "name" | "description">[]> | undefined;
-    readonly histories: Promise<{
-        role: "user" | "agent";
-        content: unknown;
-    }[]>;
-    readonly skills: never[] | Promise<Pick<Agent<any, any>, "name" | "description">[]>;
-    list(path: string, options?: AFSRootListOptions): Promise<any>;
-    read(path: string): Promise<import("@aigne/afs").AFSEntry<any> | undefined>;
-    search(path: string, query: string, options?: AFSRootSearchOptions): Promise<any>;
-};

package/lib/cjs/prompt/context/afs/index.js

@@ -1,54 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createAFSContext = createAFSContext;
-const type_utils_js_1 = require("../../../utils/type-utils.js");
-const afs_builtin_prompt_js_1 = require("../../prompts/afs-builtin-prompt.js");
-const index_js_1 = require("../../skills/afs/index.js");
-const history_js_1 = require("./history.js");
-function createAFSContext(agent, context) {
-    const afs = agent?.afs;
-    return {
-        get enabled() {
-            return !!afs;
-        },
-        description: afs_builtin_prompt_js_1.AFS_DESCRIPTION_PROMPT_TEMPLATE,
-        get modules() {
-            return afs
-                ?.listModules()
-                .then((list) => list.map((i) => (0, type_utils_js_1.pick)(i, ["name", "path", "description"])));
-        },
-        get histories() {
-            if (!agent)
-                return Promise.resolve([]);
-            return (0, history_js_1.getHistories)({
-                agent,
-                filter: {
-                    agentId: agent.name,
-                    userId: context?.userContext.userId,
-                    sessionId: context?.userContext.sessionId,
-                },
-            });
-        },
-        get skills() {
-            const afs = agent?.afs;
-            if (!afs)
-                return [];
-            return (0, index_js_1.getAFSSkills)(afs).then((skills) => skills.map((s) => (0, type_utils_js_1.pick)(s, ["name", "description"])));
-        },
-        async list(path, options) {
-            if (!afs)
-                throw new Error("AFS is not configured for this agent.");
-            return (await afs.list(path, { ...options, context, format: options?.format || "simple-list" })).data;
-        },
-        async read(path) {
-            if (!afs)
-                throw new Error("AFS is not configured for this agent.");
-            return (await afs.read(path)).data;
-        },
-        async search(path, query, options = {}) {
-            if (!afs)
-                throw new Error("AFS is not configured for this agent.");
-            return (await afs.search(path, query, { ...options, context })).data;
-        },
-    };
-}

package/lib/cjs/prompt/context/index.d.ts

@@ -1,31 +0,0 @@
-import type { PromptBuildOptions } from "../prompt-builder.js";
-export declare function createPromptBuilderContext(options: PromptBuildOptions): {
-    $afs: {
-        readonly enabled: boolean;
-        description: string;
-        readonly modules: Promise<Pick<{
-            name: string;
-            path: string;
-            description?: string;
-            module: import("@aigne/afs/.").AFSModule;
-        }, "path" | "name" | "description">[]> | undefined;
-        readonly histories: Promise<{
-            role: "user" | "agent";
-            content: unknown;
-        }[]>;
-        readonly skills: never[] | Promise<Pick<import("../../index.js").Agent<any, any>, "name" | "description">[]>;
-        list(path: string, options?: import("@aigne/afs/.").AFSRootListOptions): Promise<any>;
-        read(path: string): Promise<import("@aigne/afs/.").AFSEntry<any> | undefined>;
-        search(path: string, query: string, options?: import("@aigne/afs/.").AFSRootSearchOptions): Promise<any>;
-    };
-    $agent: {
-        readonly skills: Pick<import("../../index.js").Agent<any, any>, "name" | "description">[] | undefined;
-    };
-    $meta?: {
-        usage?: import("../../index.js").ContextUsage;
-        [key: string]: unknown;
-    };
-    userId?: string;
-    sessionId?: string;
-    userContext: import("../../index.js").UserContext | undefined;
-};

package/lib/cjs/prompt/context/index.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createPromptBuilderContext = createPromptBuilderContext;
-const type_utils_js_1 = require("../../utils/type-utils.js");
-const index_js_1 = require("./afs/index.js");
-function createPromptBuilderContext(options) {
-    return {
-        userContext: options.context?.userContext,
-        ...options.context?.userContext,
-        ...options.input,
-        $afs: (0, index_js_1.createAFSContext)(options.agent, options.context),
-        $agent: {
-            get skills() {
-                return options.agent?.skills.map((s) => (0, type_utils_js_1.pick)(s, ["name", "description"]));
-            },
-        },
-    };
-}

package/lib/cjs/prompt/filters/index.d.ts

@@ -1,2 +0,0 @@
-import type { Environment } from "nunjucks";
-export declare function setupFilters(env: Environment): void;

package/lib/cjs/prompt/filters/index.js

@@ -1,51 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.setupFilters = setupFilters;
-const tson = __importStar(require("@zenoaihq/tson"));
-const yaml_1 = require("yaml");
-function setupFilters(env) {
-    env.addFilter("yaml.stringify", async (obj, cb) => {
-        cb(null, (0, yaml_1.stringify)(await obj));
-    }, true);
-    env.addFilter("json.stringify", async (obj, ...args) => {
-        const jsonArgs = args.slice(0, -1);
-        const cb = args[args.length - 1];
-        cb(null, JSON.stringify(await obj, ...jsonArgs));
-    }, true);
-    env.addFilter("tson.stringify", async (obj, cb) => {
-        cb(null, tson.dumps(await obj));
-    }, true);
-}

package/lib/cjs/prompt/prompt-builder.d.ts

@@ -1,50 +0,0 @@
-import type { GetPromptResult } from "@modelcontextprotocol/sdk/types.js";
-import { Agent, type Message } from "../agents/agent.js";
-import { type AIAgent } from "../agents/ai-agent.js";
-import type { ChatModel, ChatModelInput, ChatModelInputMessage } from "../agents/chat-model.js";
-import { type FileUnionContent } from "../agents/model.js";
-import type { Context } from "../aigne/context.js";
-import { AgentSession } from "./agent-session.js";
-import { ChatMessagesTemplate } from "./template.js";
-export interface PromptBuilderOptions {
-    instructions?: string | ChatMessagesTemplate;
-    workingDir?: string;
-}
-export interface PromptBuildOptions {
-    context?: Context;
-    agent?: AIAgent;
-    input?: Message;
-    model?: ChatModel;
-    outputSchema?: Agent["outputSchema"];
-}
-export declare class PromptBuilder {
-    static from(instructions: string | {
-        path: string;
-    } | GetPromptResult, { workingDir }?: {
-        workingDir?: string;
-    }): PromptBuilder;
-    private static fromFile;
-    private static fromMCPPromptResult;
-    constructor(options?: PromptBuilderOptions);
-    instructions?: string | ChatMessagesTemplate;
-    workingDir?: string;
-    copy(): PromptBuilder;
-    build(options: PromptBuildOptions): Promise<Omit<ChatModelInput, "messages"> & {
-        session: AgentSession;
-        userMessage: ChatModelInputMessage;
-        toolAgents?: Agent[];
-    }>;
-    buildPrompt(options: Pick<PromptBuildOptions, "input" | "context"> & {
-        inputFileKey?: string;
-    }): Promise<{
-        prompt: string;
-        image?: FileUnionContent[];
-    }>;
-    private getTemplateVariables;
-    private buildMessages;
-    private mergeMessages;
-    protected deprecatedMemories(message: string | undefined, options: PromptBuildOptions): Promise<ChatModelInputMessage[]>;
-    private convertMemoriesToMessages;
-    private buildResponseFormat;
-    private buildTools;
-}