@bpmnkit/proxy 0.0.12 → 0.0.13

package/dist/index.js

@@ -643,6 +643,14 @@ const server = http.createServer(async (req, res) => {
             }
         }
         // Step 3: Execute search against Camunda
+        // Coerce variables filter.value to JSON-serialized string form.
+        // The Camunda API stores variable values as JSON strings (e.g. "3355" for the number 3355).
+        // If the AI emits a number or boolean, stringify it to match the stored representation.
+        if (spec.endpoint === "variables" &&
+            spec.filter.value !== undefined &&
+            typeof spec.filter.value !== "string") {
+            spec.filter.value = JSON.stringify(spec.filter.value);
+        }
         const finalSpec = spec;
         let items = [];
         let total = 0;
@@ -657,6 +665,44 @@ const server = http.createServer(async (req, res) => {
                     const result = (await r.json());
                     items = result.items ?? [];
                     total = result.page?.totalItems ?? items.length;
+                    // Enrich variable results with instance startDate (best-effort, single batch request)
+                    const keys = [
+                        ...new Set(items
+                            .map((v) => v.processInstanceKey)
+                            .filter((k) => typeof k === "string")),
+                    ];
+                    if (keys.length > 0) {
+                        try {
+                            const ir = await fetch(`${baseUrl}/process-instances/search`, {
+                                method: "POST",
+                                headers: apiHeaders,
+                                body: JSON.stringify({
+                                    filter: { processInstanceKey: { $in: keys } },
+                                    page: { limit: keys.length },
+                                }),
+                            });
+                            if (ir.ok) {
+                                const instResult = (await ir.json());
+                                const instMap = new Map((instResult.items ?? []).map((inst) => [inst.processInstanceKey, inst]));
+                                items = items.map((v) => {
+                                    const inst = instMap.get(v.processInstanceKey);
+                                    return {
+                                        ...v,
+                                        instanceStartDate: inst?.startDate ?? null,
+                                        instanceProcessName: inst?.processDefinitionName ?? null,
+                                        instanceProcessId: inst?.processDefinitionId ?? null,
+                                        instanceState: inst?.state ?? null,
+                                        instanceIsSubprocess: inst != null &&
+                                            inst.parentProcessInstanceKey != null &&
+                                            inst.parentProcessInstanceKey !== "",
+                                    };
+                                });
+                            }
+                        }
+                        catch {
+                            // Enrichment is best-effort; variable results are still returned
+                        }
+                    }
                 }
             }
             else {

package/dist/prompt.js

@@ -193,12 +193,15 @@ export function buildSearchSystemPrompt() {
         "",
         'Variable filter fields (endpoint "variables"):',
         "  name: string (exact variable name)",
-        '  value: any (JSON-serialized: "hello", 42, true)',
+        '  value: string (JSON-serialized form — number 3355 → "3355", boolean true → "true", string hello → "\\"hello\\"")',
         "  processInstanceKey: string",
         "  isTruncated: boolean",
         "  tenantId: string",
         "",
-        'Use "instances" for process instance queries. Use "variables" for variable/value queries.',
+        'Use "instances" for queries about process state, definition, incidents, or dates.',
+        'Use "variables" whenever a variable name or value is mentioned — even if phrased as "instances with variable X" or "find instances where variable Y equals Z" (the instances endpoint has no variable filter; use variables instead).',
+        "",
+        'Example: "find instances with the variable value 3355" → {"endpoint":"variables","filter":{"value":"3355"}}',
         "Omit filter fields that are not relevant. Output ONLY the JSON object.",
     ].join("\n");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bpmnkit/proxy",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "description": "Local proxy server for BPMN Kit — AI bridge (SSE/MCP) and Camunda API proxy using stored CLI profiles",
   "type": "module",
   "bin": {
@@ -17,7 +17,7 @@
   },
   "dependencies": {
     "@bpmnkit/api": "0.0.12",
-    "@bpmnkit/core": "0.0.12",
+    "@bpmnkit/core": "0.0.13",
     "@bpmnkit/profiles": "0.0.9"
   },
   "publishConfig": {