@polpo-ai/tools 0.15.41 → 0.15.42

package/dist/__tests__/typed-memory-tools.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=typed-memory-tools.test.d.ts.map

package/dist/__tests__/typed-memory-tools.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-memory-tools.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/typed-memory-tools.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/typed-memory-tools.test.js

@@ -0,0 +1,299 @@
+import { describe, expect, it } from "vitest";
+import { InMemoryMemoryItemStore, createMemoryItem, } from "@polpo-ai/core";
+import { createTypedMemoryTools, } from "../typed-memory-tools.js";
+const now = "2026-07-28T10:00:00.000Z";
+const toolContext = {
+    namespace: "project-a",
+    access: {
+        projectId: "project-a",
+        agentName: "support",
+        externalUserId: "user-a",
+        sessionId: "session-a",
+    },
+    surface: "chat",
+    now,
+};
+function createTools(grants, store = new InMemoryMemoryItemStore()) {
+    let id = 0;
+    return {
+        store,
+        tools: createTypedMemoryTools(store, {
+            agentName: "support",
+            context: toolContext,
+            grants,
+            writeScope: {
+                kind: "user",
+                subjectId: "user-a",
+                agentName: "support",
+            },
+            provenance: {
+                source: "tool",
+                actor: "agent",
+                runId: "run-a",
+                sessionId: "session-a",
+                toolName: "memory_remember",
+            },
+            createId: () => `memory-${++id}`,
+            createUsageId: () => `usage-${++id}`,
+            now: () => now,
+        }),
+    };
+}
+async function execute(tools, name, params) {
+    const tool = tools.find((candidate) => candidate.name === name);
+    if (!tool)
+        throw new Error(`Missing tool ${name}`);
+    return tool.execute("call-a", params);
+}
+describe("createTypedMemoryTools", () => {
+    it("returns no tools when no action is explicitly granted", () => {
+        expect(createTools({}).tools).toEqual([]);
+    });
+    it("can expose search without configuring any write authority", () => {
+        const tools = createTypedMemoryTools(new InMemoryMemoryItemStore(), {
+            agentName: "support",
+            context: toolContext,
+            grants: { search: true },
+        });
+        expect(tools.map((tool) => tool.name)).toEqual(["memory_search"]);
+    });
+    it("exposes only the explicitly granted actions", () => {
+        expect(createTools({ search: true }).tools.map((tool) => tool.name)).toEqual([
+            "memory_search",
+        ]);
+        expect(createTools({
+            remember: true,
+            update: true,
+            forget: true,
+            writableScopeKinds: ["user"],
+            writableKinds: ["fact"],
+        }).tools.map((tool) => tool.name)).toEqual([
+            "memory_remember",
+            "memory_update_item",
+            "memory_forget",
+        ]);
+    });
+    it("searches authorized memory read-only and records retrieval usage", async () => {
+        const { store, tools } = createTools({ search: true });
+        await store.create(createMemoryItem({
+            id: "memory-existing",
+            scope: {
+                kind: "user",
+                subjectId: "user-a",
+                agentName: "support",
+            },
+            kind: "fact",
+            content: "The customer's renewal date is in October.",
+            provenance: { source: "explicit", actor: "user" },
+        }, { now: () => now }), toolContext);
+        const result = await execute(tools, "memory_search", {
+            query: "renewal",
+            max_results: 3,
+            token_budget: 100,
+        });
+        expect(result.content[0].type).toBe("text");
+        const text = result.content[0].type === "text"
+            ? result.content[0].text
+            : "";
+        expect(JSON.parse(text)).toMatchObject({
+            total: 1,
+            results: [
+                {
+                    item: {
+                        id: "memory-existing",
+                        content: "The customer's renewal date is in October.",
+                    },
+                },
+            ],
+        });
+        expect(await store.listUsage("memory-existing", toolContext)).toEqual([
+            expect.objectContaining({
+                type: "retrieved",
+                runId: "run-a",
+                sessionId: "session-a",
+            }),
+        ]);
+        expect(await store.list({}, toolContext)).toHaveLength(1);
+    });
+    it("remembers only in the host-fixed scope and rejects semantic duplicates", async () => {
+        const { store, tools } = createTools({
+            remember: true,
+            writableScopeKinds: ["user"],
+            writableKinds: ["preference"],
+        });
+        const first = await execute(tools, "memory_remember", {
+            kind: "preference",
+            content: "Prefer concise status updates.",
+            confidence: 0.8,
+        });
+        expect(first.details).toMatchObject({
+            item: {
+                id: "memory-1",
+                scope: {
+                    kind: "user",
+                    subjectId: "user-a",
+                    agentName: "support",
+                },
+            },
+        });
+        await expect(execute(tools, "memory_remember", {
+            kind: "preference",
+            content: "  prefer   concise status updates. ",
+        })).rejects.toThrow("equivalent Memory item already exists");
+        expect(await store.list({}, toolContext)).toHaveLength(1);
+    });
+    it.each([
+        ["scope kind", {
+                remember: true,
+                writableScopeKinds: ["agent"],
+                writableKinds: ["preference"],
+            }],
+        ["memory kind", {
+                remember: true,
+                writableScopeKinds: ["user"],
+                writableKinds: ["fact"],
+            }],
+    ])("fails closed when the %s grant does not authorize a write", async (_name, grants) => {
+        const { store, tools } = createTools(grants);
+        await expect(execute(tools, "memory_remember", {
+            kind: "preference",
+            content: "Prefer concise status updates.",
+        })).rejects.toThrow("not granted");
+        expect(await store.list({}, toolContext)).toEqual([]);
+    });
+    it("never persists or echoes sensitive content", async () => {
+        const secret = "neutral-fixture-value-12345";
+        const { store, tools } = createTools({
+            remember: true,
+            writableScopeKinds: ["user"],
+            writableKinds: ["fact"],
+        });
+        await expect(execute(tools, "memory_remember", {
+            kind: "fact",
+            content: `api_key: ${secret}`,
+        })).rejects.toThrow("Memory write denied");
+        expect(await store.list({}, toolContext)).toEqual([]);
+    });
+    it("updates and forgets only when each destructive action is granted", async () => {
+        const { store, tools } = createTools({
+            remember: true,
+            update: true,
+            forget: true,
+            writableScopeKinds: ["user"],
+            writableKinds: ["fact", "preference"],
+        });
+        await execute(tools, "memory_remember", {
+            kind: "fact",
+            content: "The renewal date is September.",
+        });
+        const updated = await execute(tools, "memory_update_item", {
+            id: "memory-1",
+            content: "The renewal date is October.",
+            summary: "Renewal in October",
+        });
+        expect(updated.details).toMatchObject({
+            item: {
+                id: "memory-1",
+                content: "The renewal date is October.",
+            },
+        });
+        const forgotten = await execute(tools, "memory_forget", {
+            id: "memory-1",
+        });
+        expect(forgotten.details).toEqual({
+            itemId: "memory-1",
+            forgotten: true,
+        });
+        expect(await store.get("memory-1", toolContext)).toBeUndefined();
+    });
+    it("does not reveal whether an unauthorized item exists", async () => {
+        const store = new InMemoryMemoryItemStore();
+        await store.create(createMemoryItem({
+            id: "private-memory",
+            scope: {
+                kind: "user",
+                subjectId: "other-user",
+                agentName: "support",
+            },
+            kind: "fact",
+            content: "Private fact",
+            provenance: { source: "explicit", actor: "user" },
+        }, { now: () => now }), {
+            ...toolContext,
+            access: { ...toolContext.access, externalUserId: "other-user" },
+        });
+        const { tools } = createTools({
+            update: true,
+            forget: true,
+            writableScopeKinds: ["user"],
+            writableKinds: ["fact"],
+        }, store);
+        await expect(execute(tools, "memory_update_item", {
+            id: "private-memory",
+            content: "stolen",
+        })).rejects.toThrow("Memory item not found");
+        await expect(execute(tools, "memory_forget", {
+            id: "private-memory",
+        })).rejects.toThrow("Memory item not found");
+    });
+    it("keeps a completed write successful when usage telemetry fails", async () => {
+        class UsageFailureStore extends InMemoryMemoryItemStore {
+            async appendUsage() {
+                throw new Error("usage backend unavailable");
+            }
+        }
+        const errors = [];
+        const store = new UsageFailureStore();
+        const tools = createTypedMemoryTools(store, {
+            agentName: "support",
+            context: toolContext,
+            grants: {
+                remember: true,
+                writableScopeKinds: ["user"],
+                writableKinds: ["fact"],
+            },
+            writeScope: {
+                kind: "user",
+                subjectId: "user-a",
+                agentName: "support",
+            },
+            onUsageError: (error) => {
+                errors.push(error);
+            },
+            createId: () => "memory-a",
+            now: () => now,
+        });
+        const result = await execute(tools, "memory_remember", {
+            kind: "fact",
+            content: "The customer renewed.",
+        });
+        expect(result.details).toMatchObject({ remembered: true });
+        expect(errors).toHaveLength(1);
+        expect(await store.get("memory-a", toolContext)).toBeDefined();
+    });
+    it("rejects a host composition that binds tools to another agent", () => {
+        expect(() => createTypedMemoryTools(new InMemoryMemoryItemStore(), {
+            agentName: "other-agent",
+            context: toolContext,
+            grants: { search: true },
+        })).toThrow("does not match the agent");
+    });
+    it("rejects incomplete write grants at composition time", () => {
+        expect(() => createTypedMemoryTools(new InMemoryMemoryItemStore(), {
+            agentName: "support",
+            context: toolContext,
+            grants: { remember: true },
+            writeScope: { kind: "agent", agentName: "support" },
+        })).toThrow("require writable scope kinds");
+        expect(() => createTypedMemoryTools(new InMemoryMemoryItemStore(), {
+            agentName: "support",
+            context: toolContext,
+            grants: {
+                remember: true,
+                writableScopeKinds: ["agent"],
+                writableKinds: ["fact"],
+            },
+        })).toThrow("requires a host-fixed write scope");
+    });
+});
+//# sourceMappingURL=typed-memory-tools.test.js.map

package/dist/__tests__/typed-memory-tools.test.js.map

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

package/dist/index.d.ts

@@ -26,6 +26,8 @@ export { createImageTools, ALL_IMAGE_TOOL_NAMES } from "./image-tools.js";
 export { createAudioTools, ALL_AUDIO_TOOL_NAMES } from "./audio-tools.js";
 export { createSearchTools, ALL_SEARCH_TOOL_NAMES } from "./search-tools.js";
 export { createMemoryTools } from "./memory-tools.js";
+export { ALL_TYPED_MEMORY_TOOL_NAMES, createTypedMemoryTools, } from "./typed-memory-tools.js";
+export type { CreateTypedMemoryToolsOptions, TypedMemoryToolGrants, TypedMemoryToolName, } from "./typed-memory-tools.js";
 export { NodeFileSystem } from "./adapters/node-filesystem.js";
 export { NodeShell } from "./adapters/node-shell.js";
 export { assertPathAllowed, resolveAllowedPaths, isPathAllowed } from "./path-sandbox.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,IAAI,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACnK,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAGjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGpF,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAC5G,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAGrD,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,UAAU,EACV,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,cAAc,EACd,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,IAAI,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACnK,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAGjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGpF,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAC5G,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,6BAA6B,EAC7B,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAGrD,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,UAAU,EACV,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,cAAc,EACd,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -29,6 +29,7 @@ export { createSearchTools, ALL_SEARCH_TOOL_NAMES } from "./search-tools.js";
 // Phone tools removed — VAPI integration moved out of the
 // first-class catalog. Future: MCP-based.
 export { createMemoryTools } from "./memory-tools.js";
+export { ALL_TYPED_MEMORY_TOOL_NAMES, createTypedMemoryTools, } from "./typed-memory-tools.js";
 // Adapters (FileSystem/Shell implementations)
 export { NodeFileSystem } from "./adapters/node-filesystem.js";
 export { NodeShell } from "./adapters/node-shell.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,oBAAoB;AACpB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,IAAI,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGnK,qDAAqD;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAGvD,0BAA0B;AAC1B,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAC5G,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,0DAA0D;AAC1D,0CAA0C;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,8CAA8C;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,qBAAqB;AACrB,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,4BAA4B;AAC5B,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAU3B,OAAO,EACL,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,oBAAoB;AACpB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,IAAI,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGnK,qDAAqD;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAGvD,0BAA0B;AAC1B,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAC5G,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,0DAA0D;AAC1D,0CAA0C;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAOjC,8CAA8C;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,qBAAqB;AACrB,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,4BAA4B;AAC5B,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAU3B,OAAO,EACL,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC"}

package/dist/typed-memory-tools.d.ts

@@ -0,0 +1,35 @@
+import { type MemoryItemStore, type MemoryKind, type MemoryProvenance, type MemoryScope, type MemoryScopeKind, type MemoryStoreContext, type MemoryUsageEvent, type PolpoTool } from "@polpo-ai/core";
+export declare const ALL_TYPED_MEMORY_TOOL_NAMES: readonly ["memory_search", "memory_remember", "memory_update_item", "memory_forget"];
+export type TypedMemoryToolName = (typeof ALL_TYPED_MEMORY_TOOL_NAMES)[number];
+export interface TypedMemoryToolGrants {
+    readonly search?: boolean;
+    readonly remember?: boolean;
+    readonly update?: boolean;
+    readonly forget?: boolean;
+    /** Required to execute remember/update/forget. Missing means fail closed. */
+    readonly writableScopeKinds?: readonly MemoryScopeKind[];
+    /** Required to execute remember/update/forget. Missing means fail closed. */
+    readonly writableKinds?: readonly MemoryKind[];
+}
+export interface CreateTypedMemoryToolsOptions {
+    readonly agentName: string;
+    readonly context: MemoryStoreContext;
+    readonly grants: TypedMemoryToolGrants;
+    /** Fixed by the host; the model cannot choose a broader write scope. */
+    readonly writeScope?: MemoryScope;
+    /** Fixed by the host; the model cannot claim trusted provenance. */
+    readonly provenance?: MemoryProvenance;
+    readonly createId?: () => string;
+    readonly createUsageId?: () => string;
+    readonly now?: () => Date | string;
+    /** Usage telemetry is best-effort and must not change tool semantics. */
+    readonly onUsageError?: (error: unknown, event: MemoryUsageEvent) => void | Promise<void>;
+}
+/**
+ * Creates typed Memory tools for one already-authorized invocation.
+ *
+ * No tool is returned unless its action is explicitly granted. Write scope and
+ * provenance are host-owned closure values, never model-controlled arguments.
+ */
+export declare function createTypedMemoryTools(store: MemoryItemStore, value: CreateTypedMemoryToolsOptions): PolpoTool<any>[];
+//# sourceMappingURL=typed-memory-tools.d.ts.map

package/dist/typed-memory-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-memory-tools.d.ts","sourceRoot":"","sources":["../src/typed-memory-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAOL,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EAErB,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AAExB,eAAO,MAAM,2BAA2B,sFAK9B,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAC7B,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,6EAA6E;IAC7E,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACzD,6EAA6E;IAC7E,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,wEAAwE;IACxE,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC;IAClC,oEAAoE;IACpE,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,MAAM,CAAC;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,GAAG,MAAM,CAAC;IACnC,yEAAyE;IACzE,QAAQ,CAAC,YAAY,CAAC,EAAE,CACtB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,gBAAgB,KACpB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AA2HD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,6BAA6B,GACnC,SAAS,CAAC,GAAG,CAAC,EAAE,CA2MlB"}

package/dist/typed-memory-tools.js

@@ -0,0 +1,277 @@
+import { Type } from "@sinclair/typebox";
+import { nanoid } from "nanoid";
+import { MEMORY_KINDS, MemoryConflictError, createMemoryItem, normalizeMemoryScope, } from "@polpo-ai/core";
+export const ALL_TYPED_MEMORY_TOOL_NAMES = [
+    "memory_search",
+    "memory_remember",
+    "memory_update_item",
+    "memory_forget",
+];
+const memoryKindSchema = Type.Union(MEMORY_KINDS.map((kind) => Type.Literal(kind)));
+const MemorySearchSchema = Type.Object({
+    query: Type.String({
+        minLength: 1,
+        maxLength: 2_000,
+        description: "What to recall from authorized typed Memory.",
+    }),
+    kinds: Type.Optional(Type.Array(memoryKindSchema, {
+        maxItems: MEMORY_KINDS.length,
+    })),
+    token_budget: Type.Optional(Type.Integer({ minimum: 0, maximum: 32_000 })),
+    max_results: Type.Optional(Type.Integer({ minimum: 0, maximum: 100 })),
+});
+const MemoryRememberSchema = Type.Object({
+    kind: memoryKindSchema,
+    content: Type.String({
+        minLength: 1,
+        maxLength: 32_000,
+        description: "The durable fact, preference, or episode to remember.",
+    }),
+    summary: Type.Optional(Type.String({ minLength: 1, maxLength: 2_000 })),
+    confidence: Type.Optional(Type.Number({ minimum: 0, maximum: 1 })),
+    expires_at: Type.Optional(Type.String({
+        description: "Optional ISO-8601 expiry timestamp.",
+    })),
+    pending: Type.Optional(Type.Boolean({
+        description: "Store as pending instead of active.",
+    })),
+});
+const MemoryUpdateSchema = Type.Object({
+    id: Type.String({ minLength: 1, maxLength: 256 }),
+    content: Type.Optional(Type.String({ minLength: 1, maxLength: 32_000 })),
+    summary: Type.Optional(Type.Union([
+        Type.String({ minLength: 1, maxLength: 2_000 }),
+        Type.Null(),
+    ])),
+    confidence: Type.Optional(Type.Union([
+        Type.Number({ minimum: 0, maximum: 1 }),
+        Type.Null(),
+    ])),
+    expires_at: Type.Optional(Type.Union([Type.String(), Type.Null()])),
+});
+const MemoryForgetSchema = Type.Object({
+    id: Type.String({ minLength: 1, maxLength: 256 }),
+});
+function operationTime(options) {
+    const value = options.now?.() ?? options.context.now ?? new Date();
+    const parsed = value instanceof Date ? value : new Date(value);
+    if (!Number.isFinite(parsed.getTime())) {
+        throw new Error("Memory operation time must be valid");
+    }
+    return parsed.toISOString();
+}
+async function appendUsage(store, options, memoryId, type, requestId) {
+    const event = {
+        id: options.createUsageId?.() ?? `memory-usage-${nanoid(16)}`,
+        memoryId,
+        type,
+        at: operationTime(options),
+        ...(options.provenance?.runId
+            ? { runId: options.provenance.runId }
+            : {}),
+        ...(options.provenance?.sessionId
+            ? { sessionId: options.provenance.sessionId }
+            : {}),
+        requestId,
+    };
+    try {
+        await store.appendUsage(event, options.context);
+    }
+    catch (error) {
+        try {
+            await options.onUsageError?.(error, event);
+        }
+        catch {
+            // Usage telemetry cannot change the completed Memory operation.
+        }
+    }
+}
+function assertWriteGrant(options, item) {
+    const scopes = options.grants.writableScopeKinds;
+    const kinds = options.grants.writableKinds;
+    if (!scopes?.includes(item.scope.kind) || !kinds?.includes(item.kind)) {
+        throw new Error("Memory write is not granted for this scope and kind");
+    }
+}
+async function getWritableItem(store, options, id) {
+    const item = await store.get(id, options.context, {
+        includeInactive: true,
+        includeExpired: true,
+    });
+    if (!item)
+        throw new Error("Memory item not found");
+    assertWriteGrant(options, item);
+    return item;
+}
+function resultText(value) {
+    return JSON.stringify(value);
+}
+/**
+ * Creates typed Memory tools for one already-authorized invocation.
+ *
+ * No tool is returned unless its action is explicitly granted. Write scope and
+ * provenance are host-owned closure values, never model-controlled arguments.
+ */
+export function createTypedMemoryTools(store, value) {
+    const hasWriteAction = Boolean(value.grants.remember
+        || value.grants.update
+        || value.grants.forget);
+    if (hasWriteAction
+        && (!value.grants.writableScopeKinds?.length
+            || !value.grants.writableKinds?.length)) {
+        throw new Error("Memory write grants require writable scope kinds and Memory kinds");
+    }
+    if (value.grants.remember && !value.writeScope) {
+        throw new Error("Memory remember grant requires a host-fixed write scope");
+    }
+    const options = {
+        ...value,
+        context: {
+            ...value.context,
+            access: { ...value.context.access },
+        },
+        ...(value.writeScope
+            ? { writeScope: normalizeMemoryScope(value.writeScope) }
+            : {}),
+        provenance: {
+            source: "tool",
+            actor: "agent",
+            toolName: "memory_remember",
+            ...(value.provenance ?? {}),
+        },
+    };
+    if (options.context.access.agentName !== options.agentName) {
+        throw new Error("Memory tool context does not match the agent");
+    }
+    const tools = [];
+    if (options.grants.search) {
+        const search = {
+            name: "memory_search",
+            label: "Search Memory",
+            description: "Search only the typed Memory authorized for this agent and user context.",
+            parameters: MemorySearchSchema,
+            async execute(toolCallId, params) {
+                const results = await store.search({
+                    query: params.query,
+                    kinds: params.kinds,
+                    tokenBudget: params.token_budget,
+                    maxResults: params.max_results,
+                }, options.context);
+                for (const result of results) {
+                    await appendUsage(store, options, result.item.id, "retrieved", toolCallId);
+                }
+                const data = { total: results.length, results };
+                return {
+                    content: [{ type: "text", text: resultText(data) }],
+                    details: data,
+                };
+            },
+        };
+        tools.push(search);
+    }
+    if (options.grants.remember) {
+        const remember = {
+            name: "memory_remember",
+            label: "Remember",
+            description: "Store one durable typed Memory item in the host-authorized scope.",
+            parameters: MemoryRememberSchema,
+            async execute(toolCallId, params) {
+                if (!options.writeScope) {
+                    throw new Error("Memory write scope is not configured");
+                }
+                assertWriteGrant(options, {
+                    scope: options.writeScope,
+                    kind: params.kind,
+                });
+                const item = createMemoryItem({
+                    scope: options.writeScope,
+                    kind: params.kind,
+                    content: params.content,
+                    summary: params.summary,
+                    provenance: options.provenance,
+                    confidence: params.confidence,
+                    status: params.pending ? "pending" : "active",
+                    expiresAt: params.expires_at,
+                }, {
+                    createId: options.createId,
+                    now: options.now,
+                });
+                const duplicate = await store.findDedupeCandidate(item, options.context);
+                if (duplicate) {
+                    throw new MemoryConflictError("An equivalent Memory item already exists");
+                }
+                const created = await store.create(item, options.context);
+                await appendUsage(store, options, created.id, "written", toolCallId);
+                return {
+                    content: [{
+                            type: "text",
+                            text: resultText({ remembered: true, item: created }),
+                        }],
+                    details: { remembered: true, item: created },
+                };
+            },
+        };
+        tools.push(remember);
+    }
+    if (options.grants.update) {
+        const update = {
+            name: "memory_update_item",
+            label: "Update Memory",
+            description: "Update one existing typed Memory item when the host grants its scope and kind.",
+            parameters: MemoryUpdateSchema,
+            async execute(toolCallId, params) {
+                await getWritableItem(store, options, params.id);
+                const patch = {
+                    ...(params.content === undefined ? {} : { content: params.content }),
+                    ...(params.summary === undefined ? {} : { summary: params.summary }),
+                    ...(params.confidence === undefined
+                        ? {}
+                        : { confidence: params.confidence }),
+                    ...(params.expires_at === undefined
+                        ? {}
+                        : { expiresAt: params.expires_at }),
+                };
+                if (Object.keys(patch).length === 0) {
+                    throw new Error("Memory update requires at least one field");
+                }
+                const item = await store.update(params.id, patch, options.context);
+                if (!item)
+                    throw new Error("Memory item not found");
+                await appendUsage(store, options, item.id, "updated", toolCallId);
+                return {
+                    content: [{
+                            type: "text",
+                            text: resultText({ updated: true, item }),
+                        }],
+                    details: { updated: true, item },
+                };
+            },
+        };
+        tools.push(update);
+    }
+    if (options.grants.forget) {
+        const forget = {
+            name: "memory_forget",
+            label: "Forget Memory",
+            description: "Soft-delete one typed Memory item when the host grants its scope and kind.",
+            parameters: MemoryForgetSchema,
+            async execute(toolCallId, params) {
+                await getWritableItem(store, options, params.id);
+                const forgotten = await store.forget(params.id, options.context);
+                if (!forgotten)
+                    throw new Error("Memory item not found");
+                await appendUsage(store, options, params.id, "forgotten", toolCallId);
+                return {
+                    content: [{
+                            type: "text",
+                            text: resultText({ forgotten: true, itemId: params.id }),
+                        }],
+                    details: { forgotten: true, itemId: params.id },
+                };
+            },
+        };
+        tools.push(forget);
+    }
+    return tools;
+}
+//# sourceMappingURL=typed-memory-tools.js.map

package/dist/typed-memory-tools.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polpo-ai/tools",
-  "version": "0.15.41",
+  "version": "0.15.42",
   "description": "Agent tools for Polpo — coding, browser, email, search, and more. Core tools work everywhere, extended tools are opt-in.",
   "type": "module",
   "main": "dist/index.js",
@@ -20,8 +20,8 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@sinclair/typebox": "^0.34.0",
     "nanoid": "^5.0.0",
-    "@polpo-ai/llm": "0.15.41",
-    "@polpo-ai/core": "0.15.41"
+    "@polpo-ai/core": "0.15.42",
+    "@polpo-ai/llm": "0.15.42"
   },
   "optionalDependencies": {
     "@ai-sdk/anthropic": "^2.0.79",