@jskit-ai/assistant-core 0.1.157 → 0.1.159

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/assistant-core",
-  "version": "0.1.157",
+  "version": "0.1.159",
   "type": "module",
   "scripts": {
     "test": "node --test"
@@ -11,16 +11,16 @@
     "./shared": "./src/shared/index.js"
   },
   "dependencies": {
-    "@jskit-ai/resource-core": "0.1.123",
-    "@jskit-ai/resource-crud-core": "0.1.123",
+    "@jskit-ai/resource-core": "0.1.125",
+    "@jskit-ai/resource-crud-core": "0.1.125",
     "dompurify": "^3.4.13",
     "json-rest-schema": "^1.0.17",
     "marked": "^17.0.4",
     "openai": "^6.22.0"
   },
   "peerDependencies": {
-    "@jskit-ai/http-runtime": "0.1.179",
-    "@jskit-ai/kernel": "0.1.181",
+    "@jskit-ai/http-runtime": "0.1.181",
+    "@jskit-ai/kernel": "0.1.183",
     "vue": "^3.5.13",
     "vuetify": "^4.0.0"
   },

package/src/server/lib/serviceToolCatalog.js

@@ -33,7 +33,7 @@ const ACTION_SEARCH_PARAMETERS = Object.freeze({
     query: {
       type: "string",
       maxLength: 200,
-      description: "Optional words or action-id fragments to match."
+      description: "Optional literal words or action-id fragments; every word must match. Use short resource or operation terms such as list. Omit query to browse all available actions."
     },
     cursor: {
       type: "string",
@@ -125,7 +125,7 @@ const ACTION_EXECUTE_OUTPUT_SCHEMA = Object.freeze({
 const DISCOVERY_TOOL_DESCRIPTORS = Object.freeze([
   Object.freeze({
     name: DISCOVERY_TOOL_NAMES.search,
-    description: "Search the actions available to the current user and surface. Returns compact paged matches without schemas.",
+    description: "Discover application actions available to the current user and surface, including list, search, and query operations for multiple records. Search before claiming a capability is unavailable. If terminology does not match, use broader terms or omit query to browse. Returns compact paged matches without schemas; follow nextCursor when more discovery is needed.",
     parameters: ACTION_SEARCH_PARAMETERS,
     outputSchema: ACTION_SEARCH_OUTPUT_SCHEMA
   }),

package/test/serviceToolCatalog.test.js

@@ -410,6 +410,56 @@ test("large authorized catalogs use compact paged discovery, exact contracts, an
   assert.equal(executions[0].context.channel, "automation");
 });
 
+test("operation search and unfiltered browsing discover collections despite different user terminology", async () => {
+  const catalog = createServiceToolCatalog(createActions([
+    action({ id: "library.books.list", extensions: { assistant: { description: "List books." } } }),
+    action({ id: "warehouse.assets.list", extensions: { assistant: { description: "List assets." } } }),
+    action({ id: "warehouse.assets.view" }),
+    action({ id: "private.assets.list", permission: { require: "all", permissions: ["private.read"] } })
+  ]), { maxDirectTools: 1 });
+  const context = { actor: { id: "7" }, surface: "admin" };
+  const toolSet = catalog.resolveToolSet(context);
+  const searchTool = catalog.toOpenAiToolSchema(toolSet.tools[0]);
+  assert.match(searchTool.function.description, /Search before claiming a capability is unavailable/u);
+  assert.match(searchTool.function.parameters.properties.query.description, /every word must match/u);
+  assert.match(searchTool.function.parameters.properties.query.description, /Omit query to browse/u);
+
+  const missedSearch = await catalog.executeToolCall({
+    toolName: "assistant_action_search",
+    argumentsText: JSON.stringify({ query: "vehicles" }),
+    context,
+    toolSet
+  });
+  assert.deepEqual(missedSearch, { ok: true, result: { items: [], nextCursor: null, total: 0 } });
+
+  const collectionSearch = await catalog.executeToolCall({
+    toolName: "assistant_action_search",
+    argumentsText: JSON.stringify({ query: "list" }),
+    context,
+    toolSet
+  });
+  assert.equal(collectionSearch.ok, true);
+  assert.deepEqual(collectionSearch.result.items.map((item) => item.actionId), [
+    "library.books.list", "warehouse.assets.list"
+  ]);
+
+  const browsedActions = [];
+  let cursor;
+  do {
+    const page = await catalog.executeToolCall({
+      toolName: "assistant_action_search",
+      argumentsText: JSON.stringify({ limit: 1, ...(cursor ? { cursor } : {}) }),
+      context,
+      toolSet
+    });
+    assert.equal(page.ok, true);
+    assert.equal(page.result.total, 3);
+    browsedActions.push(...page.result.items.map((item) => item.actionId));
+    cursor = page.result.nextCursor;
+  } while (cursor);
+  assert.deepEqual(browsedActions, ["library.books.list", "warehouse.assets.list", "warehouse.assets.view"]);
+});
+
 test("discovery mode bounds authorized always-available tools", () => {
   const definitions = Array.from({ length: 10 }, (_, index) => action({
     id: `demo.clock-${String(index + 1).padStart(2, "0")}.read`,