@lumetra/engram-ax 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- {"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;GAIG;AACH;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,wBAAwB,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;QACrD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,KAAK,CACX,cAAc,GACd,cAAc,GACd,cAAc,GACd,eAAe,GACf,eAAe,GACf,cAAc,CACjB,CAAC;CACH;AAOD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,YAAY,EACpB,IAAI,GAAE,kBAAuB,GAC5B,gBAAgB,EAAE,CA8IpB"}
1
+ {"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;GAIG;AACH;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,wBAAwB,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;QACrD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,KAAK,CACX,cAAc,GACd,cAAc,GACd,cAAc,GACd,eAAe,GACf,eAAe,GACf,cAAc,CACjB,CAAC;CACH;AAOD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,YAAY,EACpB,IAAI,GAAE,kBAAuB,GAC5B,gBAAgB,EAAE,CA0JpB"}
package/dist/tools.js CHANGED
@@ -45,7 +45,9 @@ export function engramTools(client, opts = {}) {
45
45
  },
46
46
  bucket: {
47
47
  type: "string",
48
- description: "Optional bucket name to scope the memory. Defaults to the client's default bucket.",
48
+ description: "Bucket name to store the memory in. OMIT this field to use the " +
49
+ "agent's configured default bucket — do NOT pass the literal " +
50
+ "string 'default'.",
49
51
  },
50
52
  },
51
53
  required: ["content"],
@@ -54,7 +56,7 @@ export function engramTools(client, opts = {}) {
54
56
  const { content, bucket } = (args ?? {});
55
57
  if (!content)
56
58
  throw new Error("store_memory: `content` is required");
57
- await client.storeMemory(content, bucket);
59
+ await client.storeMemory(content, bucket || undefined);
58
60
  return { ok: true };
59
61
  },
60
62
  },
@@ -72,7 +74,11 @@ export function engramTools(client, opts = {}) {
72
74
  },
73
75
  bucket: {
74
76
  type: "string",
75
- description: "Optional bucket name to search. Defaults to the client's default bucket.",
77
+ description: "Bucket name to search. OMIT this field to use the agent's " +
78
+ "configured default bucket — do NOT pass the literal string " +
79
+ "'default' (that explicitly targets a bucket called 'default', " +
80
+ "which is usually wrong). Only set this when you specifically " +
81
+ "need to query a different named bucket.",
76
82
  },
77
83
  },
78
84
  required: ["query"],
@@ -81,7 +87,8 @@ export function engramTools(client, opts = {}) {
81
87
  const { query, bucket } = (args ?? {});
82
88
  if (!query)
83
89
  throw new Error("query_memory: `query` is required");
84
- const res = await client.queryMemory(query, bucket);
90
+ // Treat empty string as undefined so the client falls back to defaultBucket.
91
+ const res = await client.queryMemory(query, bucket || undefined);
85
92
  return { answer: res.answer ?? "", success: res.success ?? true };
86
93
  },
87
94
  },
@@ -106,13 +113,17 @@ export function engramTools(client, opts = {}) {
106
113
  parameters: {
107
114
  type: "object",
108
115
  properties: {
109
- bucket: { type: "string", description: "Bucket name." },
116
+ bucket: {
117
+ type: "string",
118
+ description: "Bucket to list. OMIT this field to use the agent's configured " +
119
+ "default bucket — do NOT pass the literal string 'default'.",
120
+ },
110
121
  limit: { type: "number", description: "Max memories to return (default 50)." },
111
122
  },
112
123
  },
113
124
  func: async (args) => {
114
125
  const { bucket, limit } = (args ?? {});
115
- return client.listMemories(bucket, limit);
126
+ return client.listMemories(bucket || undefined, limit);
116
127
  },
117
128
  },
118
129
  delete_memory: {
package/dist/tools.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lumetra/engram-ax",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Engram memory adapter for the ax (@ax-llm/ax) agent framework.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",