@vpxa/kb 0.1.24 → 0.1.26

package/packages/dashboard/dist/assets/index-CHpVij2M.css

@@ -0,0 +1 @@
+.react-flow{--xy-edge-stroke-default:#b1b1b7;--xy-edge-stroke-width-default:1;--xy-edge-stroke-selected-default:#555;--xy-connectionline-stroke-default:#b1b1b7;--xy-connectionline-stroke-width-default:1;--xy-attribution-background-color-default:#ffffff80;--xy-minimap-background-color-default:#fff;--xy-minimap-mask-background-color-default:#f0f0f099;--xy-minimap-mask-stroke-color-default:transparent;--xy-minimap-mask-stroke-width-default:1;--xy-minimap-node-background-color-default:#e2e2e2;--xy-minimap-node-stroke-color-default:transparent;--xy-minimap-node-stroke-width-default:2;--xy-background-color-default:transparent;--xy-background-pattern-dots-color-default:#91919a;--xy-background-pattern-lines-color-default:#eee;--xy-background-pattern-cross-color-default:#e2e2e2;background-color:var(--xy-background-color,var(--xy-background-color-default));--xy-node-color-default:inherit;--xy-node-border-default:1px solid #1a192b;--xy-node-background-color-default:#fff;--xy-node-group-background-color-default:#f0f0f040;--xy-node-boxshadow-hover-default:0 1px 4px 1px #00000014;--xy-node-boxshadow-selected-default:0 0 0 .5px #1a192b;--xy-node-border-radius-default:3px;--xy-handle-background-color-default:#1a192b;--xy-handle-border-color-default:#fff;--xy-selection-background-color-default:#0059dc14;--xy-selection-border-default:1px dotted #0059dccc;--xy-controls-button-background-color-default:#fefefe;--xy-controls-button-background-color-hover-default:#f4f4f4;--xy-controls-button-color-default:inherit;--xy-controls-button-color-hover-default:inherit;--xy-controls-button-border-color-default:#eee;--xy-controls-box-shadow-default:0 0 2px 1px #00000014;--xy-edge-label-background-color-default:#fff;--xy-edge-label-color-default:inherit;--xy-resize-background-color-default:#3367d9;direction:ltr}.react-flow.dark{--xy-edge-stroke-default:#3e3e3e;--xy-edge-stroke-width-default:1;--xy-edge-stroke-selected-default:#727272;--xy-connectionline-stroke-default:#b1b1b7;--xy-connectionline-stroke-width-default:1;--xy-attribution-background-color-default:#96969640;--xy-minimap-background-color-default:#141414;--xy-minimap-mask-background-color-default:#3c3c3c99;--xy-minimap-mask-stroke-color-default:transparent;--xy-minimap-mask-stroke-width-default:1;--xy-minimap-node-background-color-default:#2b2b2b;--xy-minimap-node-stroke-color-default:transparent;--xy-minimap-node-stroke-width-default:2;--xy-background-color-default:#141414;--xy-background-pattern-dots-color-default:#777;--xy-background-pattern-lines-color-default:#777;--xy-background-pattern-cross-color-default:#777;--xy-node-color-default:#f8f8f8;--xy-node-border-default:1px solid #3c3c3c;--xy-node-background-color-default:#1e1e1e;--xy-node-group-background-color-default:#f0f0f040;--xy-node-boxshadow-hover-default:0 1px 4px 1px #ffffff14;--xy-node-boxshadow-selected-default:0 0 0 .5px #999;--xy-handle-background-color-default:#bebebe;--xy-handle-border-color-default:#1e1e1e;--xy-selection-background-color-default:#c8c8dc14;--xy-selection-border-default:1px dotted #c8c8dccc;--xy-controls-button-background-color-default:#2b2b2b;--xy-controls-button-background-color-hover-default:#3e3e3e;--xy-controls-button-color-default:#f8f8f8;--xy-controls-button-color-hover-default:#fff;--xy-controls-button-border-color-default:#5b5b5b;--xy-controls-box-shadow-default:0 0 2px 1px #00000014;--xy-edge-label-background-color-default:#141414;--xy-edge-label-color-default:#f8f8f8}.react-flow__background{background-color:var(--xy-background-color-props,var(--xy-background-color,var(--xy-background-color-default)));pointer-events:none;z-index:-1}.react-flow__container{width:100%;height:100%;position:absolute;top:0;left:0}.react-flow__pane{z-index:1}.react-flow__pane.draggable{cursor:grab}.react-flow__pane.dragging{cursor:grabbing}.react-flow__pane.selection{cursor:pointer}.react-flow__viewport{transform-origin:0 0;z-index:2;pointer-events:none}.react-flow__renderer{z-index:4}.react-flow__selection{z-index:6}.react-flow__nodesselection-rect:focus,.react-flow__nodesselection-rect:focus-visible{outline:none}.react-flow__edge-path{stroke:var(--xy-edge-stroke,var(--xy-edge-stroke-default));stroke-width:var(--xy-edge-stroke-width,var(--xy-edge-stroke-width-default));fill:none}.react-flow__connection-path{stroke:var(--xy-connectionline-stroke,var(--xy-connectionline-stroke-default));stroke-width:var(--xy-connectionline-stroke-width,var(--xy-connectionline-stroke-width-default));fill:none}.react-flow .react-flow__edges{position:absolute}.react-flow .react-flow__edges svg{pointer-events:none;position:absolute;overflow:visible}.react-flow__edge{pointer-events:visibleStroke}.react-flow__edge.selectable{cursor:pointer}.react-flow__edge.animated path{stroke-dasharray:5;animation:.5s linear infinite dashdraw}.react-flow__edge.animated path.react-flow__edge-interaction{stroke-dasharray:none;animation:none}.react-flow__edge.inactive{pointer-events:none}.react-flow__edge.selected,.react-flow__edge:focus,.react-flow__edge:focus-visible{outline:none}.react-flow__edge.selected .react-flow__edge-path,.react-flow__edge.selectable:focus .react-flow__edge-path,.react-flow__edge.selectable:focus-visible .react-flow__edge-path{stroke:var(--xy-edge-stroke-selected,var(--xy-edge-stroke-selected-default))}.react-flow__edge-textwrapper{pointer-events:all}.react-flow__edge .react-flow__edge-text{pointer-events:none;-webkit-user-select:none;user-select:none}.react-flow__arrowhead polyline{stroke:var(--xy-edge-stroke,var(--xy-edge-stroke-default))}.react-flow__arrowhead polyline.arrowclosed{fill:var(--xy-edge-stroke,var(--xy-edge-stroke-default))}.react-flow__connection{pointer-events:none}.react-flow__connection .animated{stroke-dasharray:5;animation:.5s linear infinite dashdraw}svg.react-flow__connectionline{z-index:1001;position:absolute;overflow:visible}.react-flow__nodes{pointer-events:none;transform-origin:0 0}.react-flow__node{-webkit-user-select:none;user-select:none;pointer-events:all;transform-origin:0 0;box-sizing:border-box;cursor:default;position:absolute}.react-flow__node.selectable{cursor:pointer}.react-flow__node.draggable{cursor:grab;pointer-events:all}.react-flow__node.draggable.dragging{cursor:grabbing}.react-flow__nodesselection{z-index:3;transform-origin:0 0;pointer-events:none}.react-flow__nodesselection-rect{pointer-events:all;cursor:grab;position:absolute}.react-flow__handle{pointer-events:none;background-color:var(--xy-handle-background-color,var(--xy-handle-background-color-default));border:1px solid var(--xy-handle-border-color,var(--xy-handle-border-color-default));border-radius:100%;width:6px;min-width:5px;height:6px;min-height:5px;position:absolute}.react-flow__handle.connectingfrom{pointer-events:all}.react-flow__handle.connectionindicator{pointer-events:all;cursor:crosshair}.react-flow__handle-bottom{top:auto;bottom:0;left:50%;transform:translate(-50%,50%)}.react-flow__handle-top{top:0;left:50%;transform:translate(-50%,-50%)}.react-flow__handle-left{top:50%;left:0;transform:translate(-50%,-50%)}.react-flow__handle-right{top:50%;right:0;transform:translate(50%,-50%)}.react-flow__edgeupdater{cursor:move;pointer-events:all}.react-flow__pane.selection .react-flow__panel{pointer-events:none}.react-flow__panel{z-index:5;margin:15px;position:absolute}.react-flow__panel.top{top:0}.react-flow__panel.bottom{bottom:0}.react-flow__panel.top.center,.react-flow__panel.bottom.center{left:50%;transform:translate(-15px)translate(-50%)}.react-flow__panel.left{left:0}.react-flow__panel.right{right:0}.react-flow__panel.left.center,.react-flow__panel.right.center{top:50%;transform:translateY(-15px)translateY(-50%)}.react-flow__attribution{background:var(--xy-attribution-background-color,var(--xy-attribution-background-color-default));margin:0;padding:2px 3px;font-size:10px}.react-flow__attribution a{color:#999;text-decoration:none}@keyframes dashdraw{0%{stroke-dashoffset:10px}}.react-flow__edgelabel-renderer{pointer-events:none;-webkit-user-select:none;user-select:none;width:100%;height:100%;position:absolute;top:0;left:0}.react-flow__viewport-portal{-webkit-user-select:none;user-select:none;width:100%;height:100%;position:absolute;top:0;left:0}.react-flow__minimap{background:var(--xy-minimap-background-color-props,var(--xy-minimap-background-color,var(--xy-minimap-background-color-default)))}.react-flow__minimap-svg{display:block}.react-flow__minimap-mask{fill:var(--xy-minimap-mask-background-color-props,var(--xy-minimap-mask-background-color,var(--xy-minimap-mask-background-color-default)));stroke:var(--xy-minimap-mask-stroke-color-props,var(--xy-minimap-mask-stroke-color,var(--xy-minimap-mask-stroke-color-default)));stroke-width:var(--xy-minimap-mask-stroke-width-props,var(--xy-minimap-mask-stroke-width,var(--xy-minimap-mask-stroke-width-default)))}.react-flow__minimap-node{fill:var(--xy-minimap-node-background-color-props,var(--xy-minimap-node-background-color,var(--xy-minimap-node-background-color-default)));stroke:var(--xy-minimap-node-stroke-color-props,var(--xy-minimap-node-stroke-color,var(--xy-minimap-node-stroke-color-default)));stroke-width:var(--xy-minimap-node-stroke-width-props,var(--xy-minimap-node-stroke-width,var(--xy-minimap-node-stroke-width-default)))}.react-flow__background-pattern.dots{fill:var(--xy-background-pattern-color-props,var(--xy-background-pattern-color,var(--xy-background-pattern-dots-color-default)))}.react-flow__background-pattern.lines{stroke:var(--xy-background-pattern-color-props,var(--xy-background-pattern-color,var(--xy-background-pattern-lines-color-default)))}.react-flow__background-pattern.cross{stroke:var(--xy-background-pattern-color-props,var(--xy-background-pattern-color,var(--xy-background-pattern-cross-color-default)))}.react-flow__controls{box-shadow:var(--xy-controls-box-shadow,var(--xy-controls-box-shadow-default));flex-direction:column;display:flex}.react-flow__controls.horizontal{flex-direction:row}.react-flow__controls-button{background:var(--xy-controls-button-background-color,var(--xy-controls-button-background-color-default));border:none;border-bottom:1px solid var(--xy-controls-button-border-color-props,var(--xy-controls-button-border-color,var(--xy-controls-button-border-color-default)));width:26px;height:26px;color:var(--xy-controls-button-color-props,var(--xy-controls-button-color,var(--xy-controls-button-color-default)));cursor:pointer;-webkit-user-select:none;user-select:none;justify-content:center;align-items:center;padding:4px;display:flex}.react-flow__controls-button svg{fill:currentColor;width:100%;max-width:12px;max-height:12px}.react-flow__edge.updating .react-flow__edge-path{stroke:#777}.react-flow__edge-text{font-size:10px}.react-flow__node.selectable:focus,.react-flow__node.selectable:focus-visible{outline:none}.react-flow__node-input,.react-flow__node-default,.react-flow__node-output,.react-flow__node-group{border-radius:var(--xy-node-border-radius,var(--xy-node-border-radius-default));width:150px;color:var(--xy-node-color,var(--xy-node-color-default));text-align:center;border:var(--xy-node-border,var(--xy-node-border-default));background-color:var(--xy-node-background-color,var(--xy-node-background-color-default));padding:10px;font-size:12px}.react-flow__node-input.selectable:hover,.react-flow__node-default.selectable:hover,.react-flow__node-output.selectable:hover,.react-flow__node-group.selectable:hover{box-shadow:var(--xy-node-boxshadow-hover,var(--xy-node-boxshadow-hover-default))}.react-flow__node-input.selectable.selected,.react-flow__node-input.selectable:focus,.react-flow__node-input.selectable:focus-visible,.react-flow__node-default.selectable.selected,.react-flow__node-default.selectable:focus,.react-flow__node-default.selectable:focus-visible,.react-flow__node-output.selectable.selected,.react-flow__node-output.selectable:focus,.react-flow__node-output.selectable:focus-visible,.react-flow__node-group.selectable.selected,.react-flow__node-group.selectable:focus,.react-flow__node-group.selectable:focus-visible{box-shadow:var(--xy-node-boxshadow-selected,var(--xy-node-boxshadow-selected-default))}.react-flow__node-group{background-color:var(--xy-node-group-background-color,var(--xy-node-group-background-color-default))}.react-flow__nodesselection-rect,.react-flow__selection{background:var(--xy-selection-background-color,var(--xy-selection-background-color-default));border:var(--xy-selection-border,var(--xy-selection-border-default))}.react-flow__nodesselection-rect:focus,.react-flow__nodesselection-rect:focus-visible,.react-flow__selection:focus,.react-flow__selection:focus-visible{outline:none}.react-flow__controls-button:hover{background:var(--xy-controls-button-background-color-hover-props,var(--xy-controls-button-background-color-hover,var(--xy-controls-button-background-color-hover-default)));color:var(--xy-controls-button-color-hover-props,var(--xy-controls-button-color-hover,var(--xy-controls-button-color-hover-default)))}.react-flow__controls-button:disabled{pointer-events:none}.react-flow__controls-button:disabled svg{fill-opacity:.4}.react-flow__controls-button:last-child{border-bottom:none}.react-flow__controls.horizontal .react-flow__controls-button{border-bottom:none;border-right:1px solid var(--xy-controls-button-border-color-props,var(--xy-controls-button-border-color,var(--xy-controls-button-border-color-default)))}.react-flow__controls.horizontal .react-flow__controls-button:last-child{border-right:none}.react-flow__resize-control{position:absolute}.react-flow__resize-control.left,.react-flow__resize-control.right{cursor:ew-resize}.react-flow__resize-control.top,.react-flow__resize-control.bottom{cursor:ns-resize}.react-flow__resize-control.top.left,.react-flow__resize-control.bottom.right{cursor:nwse-resize}.react-flow__resize-control.bottom.left,.react-flow__resize-control.top.right{cursor:nesw-resize}.react-flow__resize-control.handle{background-color:var(--xy-resize-background-color,var(--xy-resize-background-color-default));border:1px solid #fff;border-radius:1px;width:5px;height:5px;translate:-50% -50%}.react-flow__resize-control.handle.left{top:50%;left:0}.react-flow__resize-control.handle.right{top:50%;left:100%}.react-flow__resize-control.handle.top{top:0;left:50%}.react-flow__resize-control.handle.bottom{top:100%;left:50%}.react-flow__resize-control.handle.top.left,.react-flow__resize-control.handle.bottom.left{left:0}.react-flow__resize-control.handle.top.right,.react-flow__resize-control.handle.bottom.right{left:100%}.react-flow__resize-control.line{border-color:var(--xy-resize-background-color,var(--xy-resize-background-color-default));border-style:solid;border-width:0}.react-flow__resize-control.line.left,.react-flow__resize-control.line.right{width:1px;height:100%;top:0;transform:translate(-50%)}.react-flow__resize-control.line.left{border-left-width:1px;left:0}.react-flow__resize-control.line.right{border-right-width:1px;left:100%}.react-flow__resize-control.line.top,.react-flow__resize-control.line.bottom{width:100%;height:1px;left:0;transform:translateY(-50%)}.react-flow__resize-control.line.top{border-top-width:1px;top:0}.react-flow__resize-control.line.bottom{border-bottom-width:1px;top:100%}.react-flow__edge-textbg{fill:var(--xy-edge-label-background-color,var(--xy-edge-label-background-color-default))}.react-flow__edge-text{fill:var(--xy-edge-label-color,var(--xy-edge-label-color-default))}

package/packages/dashboard/dist/index.html

@@ -0,0 +1,18 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>KB Dashboard</title>
+    <style>
+      * { margin: 0; padding: 0; box-sizing: border-box; }
+      html, body, #root { width: 100%; height: 100%; overflow: hidden; }
+      body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; background: #0d1117; color: #c9d1d9; }
+    </style>
+    <script type="module" crossorigin src="/_dashboard/assets/index-9ysCkze9.js"></script>
+    <link rel="stylesheet" crossorigin href="/_dashboard/assets/index-CHpVij2M.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/packages/elicitation/dist/__tests__/build.test.d.ts

@@ -0,0 +1 @@
+export {};

package/packages/elicitation/dist/__tests__/build.test.js

@@ -0,0 +1,35 @@
+import { describe, expect, it } from 'vitest';
+import { buildElicitRequest, buildFormSchema } from '../build.js';
+import { field } from '../fields.js';
+describe('buildFormSchema', () => {
+    it('builds a schema from fields', () => {
+        const schema = buildFormSchema({
+            name: field.text('Name'),
+            confirm: field.confirm('OK?'),
+        });
+        expect(schema.type).toBe('object');
+        expect(Object.keys(schema.properties)).toEqual(['name', 'confirm']);
+        expect(schema.required).toBeUndefined();
+    });
+    it('includes required array when provided', () => {
+        const schema = buildFormSchema({ name: field.text('Name') }, ['name']);
+        expect(schema.required).toEqual(['name']);
+    });
+    it('omits required when empty array', () => {
+        const schema = buildFormSchema({ name: field.text('Name') }, []);
+        expect(schema.required).toBeUndefined();
+    });
+});
+describe('buildElicitRequest', () => {
+    it('builds a complete request', () => {
+        const req = buildElicitRequest('Choose your options:', {
+            color: field.select('Color', ['red', 'blue']),
+            count: field.number('Count', { minimum: 1 }),
+        }, ['color']);
+        expect(req.message).toBe('Choose your options:');
+        expect(req.schema.type).toBe('object');
+        expect(req.schema.properties.color.type).toBe('string');
+        expect(req.schema.properties.count.type).toBe('number');
+        expect(req.schema.required).toEqual(['color']);
+    });
+});

package/packages/elicitation/dist/__tests__/fields.test.d.ts

@@ -0,0 +1 @@
+export {};

package/packages/elicitation/dist/__tests__/fields.test.js

@@ -0,0 +1,81 @@
+import { describe, expect, it } from 'vitest';
+import { field } from '../fields.js';
+describe('field builders', () => {
+    describe('text', () => {
+        it('creates a text field with title only', () => {
+            const f = field.text('Name');
+            expect(f).toEqual({ type: 'string', title: 'Name' });
+        });
+        it('creates a text field with all options', () => {
+            const f = field.text('Query', {
+                description: 'Search query',
+                minLength: 1,
+                maxLength: 500,
+                default: 'hello',
+            });
+            expect(f.type).toBe('string');
+            expect(f.title).toBe('Query');
+            expect(f.description).toBe('Search query');
+            expect(f.minLength).toBe(1);
+            expect(f.maxLength).toBe(500);
+            expect(f.default).toBe('hello');
+        });
+        it('omits undefined optional fields', () => {
+            const f = field.text('Name', { description: 'test' });
+            expect(f).not.toHaveProperty('minLength');
+            expect(f).not.toHaveProperty('maxLength');
+            expect(f).not.toHaveProperty('default');
+        });
+    });
+    describe('select', () => {
+        it('creates a single-select field', () => {
+            const f = field.select('Color', ['red', 'green', 'blue']);
+            expect(f).toEqual({
+                type: 'string',
+                title: 'Color',
+                enum: ['red', 'green', 'blue'],
+            });
+        });
+        it('supports enumNames and default', () => {
+            const f = field.select('Size', ['s', 'm', 'l'], {
+                enumNames: ['Small', 'Medium', 'Large'],
+                default: 'm',
+            });
+            expect(f.enumNames).toEqual(['Small', 'Medium', 'Large']);
+            expect(f.default).toBe('m');
+        });
+    });
+    describe('multi', () => {
+        it('creates a multi-select field', () => {
+            const f = field.multi('Tags', ['a', 'b', 'c']);
+            expect(f).toEqual({
+                type: 'array',
+                title: 'Tags',
+                items: { type: 'string', enum: ['a', 'b', 'c'] },
+                uniqueItems: true,
+            });
+        });
+    });
+    describe('confirm', () => {
+        it('creates a boolean field', () => {
+            const f = field.confirm('Proceed?');
+            expect(f).toEqual({ type: 'boolean', title: 'Proceed?' });
+        });
+        it('supports default value', () => {
+            const f = field.confirm('Enable', { default: true });
+            expect(f.default).toBe(true);
+        });
+    });
+    describe('number', () => {
+        it('creates a number field', () => {
+            const f = field.number('Count');
+            expect(f).toEqual({ type: 'number', title: 'Count' });
+        });
+        it('creates an integer field with range', () => {
+            const f = field.number('Page', { integer: true, minimum: 1, maximum: 100 });
+            expect(f.type).toBe('integer');
+            expect(f.minimum).toBe(1);
+            expect(f.maximum).toBe(100);
+        });
+    });
+});

package/packages/elicitation/dist/__tests__/normalize.test.d.ts

@@ -0,0 +1 @@
+export {};

package/packages/elicitation/dist/__tests__/normalize.test.js

@@ -0,0 +1,60 @@
+import { describe, expect, it } from 'vitest';
+import { normalizeResponse } from '../normalize.js';
+describe('normalizeResponse', () => {
+    it('returns cancel for null input', () => {
+        expect(normalizeResponse(null)).toEqual({ action: 'cancel' });
+    });
+    it('returns cancel for undefined input', () => {
+        expect(normalizeResponse(undefined)).toEqual({ action: 'cancel' });
+    });
+    it('normalizes accept with valid content', () => {
+        const result = normalizeResponse({
+            action: 'accept',
+            content: { name: 'test', count: 42, ok: true },
+        });
+        expect(result.action).toBe('accept');
+        expect(result.content).toEqual({ name: 'test', count: 42, ok: true });
+    });
+    it('normalizes accept with string array content', () => {
+        const result = normalizeResponse({
+            action: 'accept',
+            content: { tags: ['a', 'b', 'c'] },
+        });
+        expect(result.action).toBe('accept');
+        expect(result.content).toEqual({ tags: ['a', 'b', 'c'] });
+    });
+    it('strips non-primitive content values', () => {
+        const result = normalizeResponse({
+            action: 'accept',
+            content: { valid: 'yes', nested: { bad: true } },
+        });
+        expect(result.content).toEqual({ valid: 'yes' });
+    });
+    it('strips mixed arrays', () => {
+        const result = normalizeResponse({
+            action: 'accept',
+            content: { mixed: [1, 'two'] },
+        });
+        // Mixed array is not all strings, should be stripped
+        expect(result.content).toEqual({});
+    });
+    it('normalizes decline without content', () => {
+        const result = normalizeResponse({ action: 'decline' });
+        expect(result).toEqual({ action: 'decline' });
+    });
+    it('normalizes cancel', () => {
+        const result = normalizeResponse({ action: 'cancel' });
+        expect(result).toEqual({ action: 'cancel' });
+    });
+    it('treats unknown action as cancel', () => {
+        const result = normalizeResponse({ action: 'timeout' });
+        expect(result).toEqual({ action: 'cancel' });
+    });
+    it('drops content when action is decline', () => {
+        const result = normalizeResponse({
+            action: 'decline',
+            content: { leftover: 'data' },
+        });
+        expect(result.content).toBeUndefined();
+    });
+});

package/packages/elicitation/dist/build.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Request builder — construct MCP-compatible elicitation request parameters.
+ */
+import type { ElicitFormSchema, ElicitOptions, FieldSchema } from './types.js';
+/** Build a form schema from a record of named fields. */
+export declare function buildFormSchema(fields: Record<string, FieldSchema>, required?: string[]): ElicitFormSchema;
+/**
+ * Build the full elicitation request options.
+ * `message` — prompt text shown above the form.
+ * `fields`  — record of field-id → FieldSchema.
+ * `required` — field ids that must be filled.
+ */
+export declare function buildElicitRequest(message: string, fields: Record<string, FieldSchema>, required?: string[]): ElicitOptions;

package/packages/elicitation/dist/build.js

@@ -0,0 +1,23 @@
+/**
+ * Request builder — construct MCP-compatible elicitation request parameters.
+ */
+/** Build a form schema from a record of named fields. */
+export function buildFormSchema(fields, required) {
+    return {
+        type: 'object',
+        properties: fields,
+        ...(required && required.length > 0 ? { required } : {}),
+    };
+}
+/**
+ * Build the full elicitation request options.
+ * `message` — prompt text shown above the form.
+ * `fields`  — record of field-id → FieldSchema.
+ * `required` — field ids that must be filled.
+ */
+export function buildElicitRequest(message, fields, required) {
+    return {
+        message,
+        schema: buildFormSchema(fields, required),
+    };
+}

package/packages/elicitation/dist/fields.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Field builders — create typed field schemas for MCP elicitation forms.
+ *
+ * Usage:
+ *   field.text('Name', { description: 'Your full name' })
+ *   field.select('Color', ['red', 'green', 'blue'])
+ *   field.confirm('Proceed?')
+ */
+import type { ArrayFieldSchema, BooleanFieldSchema, EnumFieldSchema, NumberFieldSchema, TextFieldSchema } from './types.js';
+export declare const field: {
+    /** Free text input. */
+    readonly text: (title: string, opts?: {
+        description?: string;
+        minLength?: number;
+        maxLength?: number;
+        default?: string;
+    }) => TextFieldSchema;
+    /** Single-select dropdown/radio. */
+    readonly select: (title: string, options: string[], opts?: {
+        description?: string;
+        enumNames?: string[];
+        default?: string;
+    }) => EnumFieldSchema;
+    /** Multi-select checkboxes. */
+    readonly multi: (title: string, options: string[], opts?: {
+        description?: string;
+    }) => ArrayFieldSchema;
+    /** Boolean checkbox / confirmation. */
+    readonly confirm: (title: string, opts?: {
+        description?: string;
+        default?: boolean;
+    }) => BooleanFieldSchema;
+    /** Numeric input. */
+    readonly number: (title: string, opts?: {
+        description?: string;
+        minimum?: number;
+        maximum?: number;
+        integer?: boolean;
+        default?: number;
+    }) => NumberFieldSchema;
+};

package/packages/elicitation/dist/fields.js

@@ -0,0 +1,62 @@
+/**
+ * Field builders — create typed field schemas for MCP elicitation forms.
+ *
+ * Usage:
+ *   field.text('Name', { description: 'Your full name' })
+ *   field.select('Color', ['red', 'green', 'blue'])
+ *   field.confirm('Proceed?')
+ */
+export const field = {
+    /** Free text input. */
+    text(title, opts) {
+        return {
+            type: 'string',
+            title,
+            ...(opts?.description !== undefined && { description: opts.description }),
+            ...(opts?.minLength !== undefined && { minLength: opts.minLength }),
+            ...(opts?.maxLength !== undefined && { maxLength: opts.maxLength }),
+            ...(opts?.default !== undefined && { default: opts.default }),
+        };
+    },
+    /** Single-select dropdown/radio. */
+    select(title, options, opts) {
+        return {
+            type: 'string',
+            title,
+            enum: options,
+            ...(opts?.description !== undefined && { description: opts.description }),
+            ...(opts?.enumNames !== undefined && { enumNames: opts.enumNames }),
+            ...(opts?.default !== undefined && { default: opts.default }),
+        };
+    },
+    /** Multi-select checkboxes. */
+    multi(title, options, opts) {
+        return {
+            type: 'array',
+            title,
+            items: { type: 'string', enum: options },
+            uniqueItems: true,
+            ...(opts?.description !== undefined && { description: opts.description }),
+        };
+    },
+    /** Boolean checkbox / confirmation. */
+    confirm(title, opts) {
+        return {
+            type: 'boolean',
+            title,
+            ...(opts?.description !== undefined && { description: opts.description }),
+            ...(opts?.default !== undefined && { default: opts.default }),
+        };
+    },
+    /** Numeric input. */
+    number(title, opts) {
+        return {
+            type: opts?.integer ? 'integer' : 'number',
+            title,
+            ...(opts?.description !== undefined && { description: opts.description }),
+            ...(opts?.minimum !== undefined && { minimum: opts.minimum }),
+            ...(opts?.maximum !== undefined && { maximum: opts.maximum }),
+            ...(opts?.default !== undefined && { default: opts.default }),
+        };
+    },
+};

package/packages/elicitation/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @kb/elicitation — MCP elicitation primitives.
+ *
+ * Provides field builders, request construction, and response normalization
+ * for MCP elicitation (interactive user input during tool execution).
+ */
+export type { ElicitAction, ElicitContent, ElicitFormSchema, ElicitOptions, ElicitResponse, Elicitor, FieldSchema, TextFieldSchema, EnumFieldSchema, ArrayFieldSchema, BooleanFieldSchema, NumberFieldSchema, } from './types.js';
+export { field } from './fields.js';
+export { buildFormSchema, buildElicitRequest } from './build.js';
+export { normalizeResponse } from './normalize.js';

package/packages/elicitation/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * @kb/elicitation — MCP elicitation primitives.
+ *
+ * Provides field builders, request construction, and response normalization
+ * for MCP elicitation (interactive user input during tool execution).
+ */
+// Field builders
+export { field } from './fields.js';
+// Request construction
+export { buildFormSchema, buildElicitRequest } from './build.js';
+// Response normalization
+export { normalizeResponse } from './normalize.js';

package/packages/elicitation/dist/normalize.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Response normalization — convert raw MCP ElicitResult into typed ElicitResponse.
+ */
+import type { ElicitContent, ElicitResponse } from './types.js';
+/** Raw elicitation result from the MCP SDK. */
+interface RawElicitResult {
+    action: string;
+    content?: Record<string, unknown>;
+}
+/**
+ * Normalize a raw MCP elicitation result into a typed response.
+ * Handles missing fields, unknown actions, and type coercion.
+ */
+export declare function normalizeResponse<T extends ElicitContent = ElicitContent>(raw: RawElicitResult | undefined | null): ElicitResponse<T>;
+export {};

package/packages/elicitation/dist/normalize.js

@@ -0,0 +1,31 @@
+/**
+ * Response normalization — convert raw MCP ElicitResult into typed ElicitResponse.
+ */
+const VALID_ACTIONS = new Set(['accept', 'decline', 'cancel']);
+/**
+ * Normalize a raw MCP elicitation result into a typed response.
+ * Handles missing fields, unknown actions, and type coercion.
+ */
+export function normalizeResponse(raw) {
+    if (!raw) {
+        return { action: 'cancel' };
+    }
+    const action = VALID_ACTIONS.has(raw.action)
+        ? raw.action
+        : 'cancel';
+    if (action !== 'accept' || !raw.content) {
+        return { action };
+    }
+    // Coerce content values to allowed types
+    const content = {};
+    for (const [key, value] of Object.entries(raw.content)) {
+        if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+            content[key] = value;
+        }
+        else if (Array.isArray(value) && value.every((v) => typeof v === 'string')) {
+            content[key] = value;
+        }
+        // Skip unknown types silently — defensive normalization
+    }
+    return { action, content: content };
+}

package/packages/elicitation/dist/types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * MCP elicitation types.
+ *
+ * Elicitation allows tools to request structured input from the user via
+ * the MCP client. The schema follows JSON Schema constraints:
+ * only flat primitives and string arrays are supported.
+ */
+/** User action on the elicitation dialog. */
+export type ElicitAction = 'accept' | 'decline' | 'cancel';
+/** Flat content map — MCP only supports primitives + string arrays. */
+export type ElicitContent = Record<string, string | number | boolean | string[]>;
+/** Normalized elicitation response. */
+export interface ElicitResponse<T extends ElicitContent = ElicitContent> {
+    action: ElicitAction;
+    content?: T;
+}
+export interface TextFieldSchema {
+    type: 'string';
+    title: string;
+    description?: string;
+    minLength?: number;
+    maxLength?: number;
+    default?: string;
+}
+export interface EnumFieldSchema {
+    type: 'string';
+    title: string;
+    description?: string;
+    enum: string[];
+    enumNames?: string[];
+    default?: string;
+}
+export interface ArrayFieldSchema {
+    type: 'array';
+    title: string;
+    description?: string;
+    items: {
+        type: 'string';
+        enum: string[];
+    };
+    uniqueItems: true;
+}
+export interface BooleanFieldSchema {
+    type: 'boolean';
+    title: string;
+    description?: string;
+    default?: boolean;
+}
+export interface NumberFieldSchema {
+    type: 'number' | 'integer';
+    title: string;
+    description?: string;
+    minimum?: number;
+    maximum?: number;
+    default?: number;
+}
+export type FieldSchema = TextFieldSchema | EnumFieldSchema | ArrayFieldSchema | BooleanFieldSchema | NumberFieldSchema;
+/** JSON Schema object for the elicitation form. */
+export interface ElicitFormSchema {
+    type: 'object';
+    properties: Record<string, FieldSchema>;
+    required?: string[];
+}
+export interface ElicitOptions {
+    message: string;
+    schema: ElicitFormSchema;
+}
+/**
+ * High-level elicitation interface exposed to tools.
+ * Wraps `server.createElicitation()` with convenience methods.
+ */
+export interface Elicitor {
+    /** Whether the connected client supports elicitation. */
+    readonly available: boolean;
+    /** Ask a structured form question. */
+    ask<T extends ElicitContent = ElicitContent>(opts: ElicitOptions): Promise<ElicitResponse<T>>;
+    /** Yes/no confirmation. */
+    confirm(message: string): Promise<boolean>;
+    /** Pick one from a list. Returns null if declined/cancelled. */
+    selectOne(message: string, options: string[]): Promise<string | null>;
+    /** Pick many from a list. Returns empty array if declined/cancelled. */
+    selectMany(message: string, options: string[]): Promise<string[]>;
+    /** Free text prompt. Returns null if declined/cancelled. */
+    promptText(message: string, description?: string): Promise<string | null>;
+}

package/packages/elicitation/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * MCP elicitation types.
+ *
+ * Elicitation allows tools to request structured input from the user via
+ * the MCP client. The schema follows JSON Schema constraints:
+ * only flat primitives and string arrays are supported.
+ */
+export {};

package/packages/kb-client/dist/direct-client.d.ts

@@ -0,0 +1,37 @@
+import { IKBClient, KBGraphData, KBKnowledgeEntry, KBSearchResult, KBStatus } from "./types.js";
+import { IEmbedder } from "@kb/embeddings";
+import { IGraphStore, IKnowledgeStore } from "@kb/store";
+
+//#region packages/kb-client/src/direct-client.d.ts
+interface CuratedEntry {
+  path: string;
+  title: string;
+  category: string;
+  tags: string[];
+  content: string;
+}
+interface DirectClientDeps {
+  store: IKnowledgeStore;
+  embedder: IEmbedder;
+  graphStore?: IGraphStore;
+  /** Function to list curated entries */
+  listCurated?: () => Promise<CuratedEntry[]>;
+  /** Function to read a single curated entry */
+  readCurated?: (path: string) => Promise<CuratedEntry | null>;
+}
+declare class DirectKBClient implements IKBClient {
+  private readonly deps;
+  constructor(deps: DirectClientDeps);
+  getStatus(): Promise<KBStatus>;
+  search(query: string, options?: {
+    limit?: number;
+    mode?: 'hybrid' | 'semantic' | 'keyword';
+  }): Promise<KBSearchResult[]>;
+  listKnowledge(): Promise<KBKnowledgeEntry[]>;
+  readKnowledge(path: string): Promise<KBKnowledgeEntry | null>;
+  getGraph(query?: string): Promise<KBGraphData>;
+  getFileTree(): Promise<string[]>;
+  private getEdgesForNodes;
+}
+//#endregion
+export { DirectClientDeps, DirectKBClient };

package/packages/kb-client/dist/direct-client.js

@@ -0,0 +1 @@
+const e=1e3;var t=class{constructor(e){this.deps=e}async getStatus(){let e=await this.deps.store.getStats();return{totalRecords:e.totalRecords,totalFiles:e.totalFiles,lastIndexedAt:e.lastIndexedAt??null,onboarded:e.totalRecords>0}}async search(e,t){let n=t?.limit??10,i=t?.mode??`hybrid`;if(i===`keyword`)return(await this.deps.store.ftsSearch(e,{limit:n})).map(r);let a=await this.deps.embedder.embedQuery(e);if(i===`semantic`)return(await this.deps.store.search(a,{limit:n})).map(r);let[o,s]=await Promise.all([this.deps.store.search(a,{limit:n*2}),this.deps.store.ftsSearch(e,{limit:n*2}).catch(()=>[])]),c=new Map;for(let e of[...o,...s]){let t=c.get(e.record.id);(!t||e.score>t.score)&&c.set(e.record.id,e)}return[...c.values()].sort((e,t)=>t.score-e.score).slice(0,n).map(r)}async listKnowledge(){return this.deps.listCurated?(await this.deps.listCurated()).map(n):[]}async readKnowledge(e){if(!this.deps.readCurated)return null;let t=await this.deps.readCurated(e);return t?n(t):null}async getGraph(t){if(!this.deps.graphStore)return{nodes:[],edges:[]};let n=await this.deps.graphStore.findNodes(t?{namePattern:t,limit:500}:{limit:500});if(n.length===0)return{nodes:[],edges:[]};let r=t?await this.getEdgesForNodes(n):await this.deps.graphStore.findEdges({limit:e});return{nodes:n.map(e=>({id:e.id,name:e.name,type:e.type,...e.sourcePath?{sourcePath:e.sourcePath}:{}})),edges:i(r).map(e=>({fromId:e.fromId,toId:e.toId,type:e.type}))}}async getFileTree(){return this.deps.store.listSourcePaths()}async getEdgesForNodes(t){let n=this.deps.graphStore;if(!n)return[];let r=t.flatMap(t=>[n.findEdges({fromId:t.id,limit:e}),n.findEdges({toId:t.id,limit:e})]);return(await Promise.all(r)).flat()}};function n(e){return{path:e.path,title:e.title,category:e.category,tags:e.tags,content:e.content}}function r(e){return{sourcePath:e.record.sourcePath,contentType:e.record.contentType,score:e.score,content:e.record.content,headingPath:e.record.headingPath,startLine:e.record.startLine,endLine:e.record.endLine}}function i(e){let t=new Map;for(let n of e)t.set(n.id,n);return[...t.values()]}export{t as DirectKBClient};

package/packages/kb-client/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { IKBClient, KBGraphData, KBKnowledgeEntry, KBSearchResult, KBStatus } from "./types.js";
+import { DirectClientDeps, DirectKBClient } from "./direct-client.js";
+import { McpKBClient } from "./mcp-client.js";
+import { ParsedContent, extractStructured, extractText, parseToolResult, tryParseJson } from "./parsers.js";
+export { type DirectClientDeps, DirectKBClient, type IKBClient, type KBGraphData, type KBKnowledgeEntry, type KBSearchResult, type KBStatus, McpKBClient, type ParsedContent, extractStructured, extractText, parseToolResult, tryParseJson };

package/packages/kb-client/dist/index.js

@@ -0,0 +1 @@
+import{DirectKBClient as e}from"./direct-client.js";import{extractStructured as t,extractText as n,parseToolResult as r,tryParseJson as i}from"./parsers.js";import{McpKBClient as a}from"./mcp-client.js";export{e as DirectKBClient,a as McpKBClient,t as extractStructured,n as extractText,r as parseToolResult,i as tryParseJson};

package/packages/kb-client/dist/mcp-client.d.ts

@@ -0,0 +1,19 @@
+import { IKBClient, KBGraphData, KBKnowledgeEntry, KBSearchResult, KBStatus } from "./types.js";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+
+//#region packages/kb-client/src/mcp-client.d.ts
+declare class McpKBClient implements IKBClient {
+  private readonly client;
+  constructor(client: Client);
+  getStatus(): Promise<KBStatus>;
+  search(query: string, options?: {
+    limit?: number;
+    mode?: 'hybrid' | 'semantic' | 'keyword';
+  }): Promise<KBSearchResult[]>;
+  listKnowledge(): Promise<KBKnowledgeEntry[]>;
+  readKnowledge(path: string): Promise<KBKnowledgeEntry | null>;
+  getGraph(query?: string): Promise<KBGraphData>;
+  getFileTree(): Promise<string[]>;
+}
+//#endregion
+export { McpKBClient };

package/packages/kb-client/dist/mcp-client.js

@@ -0,0 +1,4 @@
+import{extractStructured as e,extractText as t}from"./parsers.js";var n=class{constructor(e){this.client=e}async getStatus(){let e=await this.client.callTool({name:`status`,arguments:{}}),t=i(e);if(t)return{totalRecords:l(t.totalRecords),totalFiles:l(t.totalFiles),lastIndexedAt:d(t.lastIndexedAt),onboarded:!!t.onboarded};let n=r(e);return{totalRecords:a(n,/Records:\s*(\d+)/i),totalFiles:a(n,/Files:\s*(\d+)/i),lastIndexedAt:null,onboarded:!/not onboarded/i.test(n)}}async search(e,t){let n=await this.client.callTool({name:`search`,arguments:{query:e,limit:t?.limit??10,search_mode:t?.mode??`hybrid`}}),a=i(n);return a?.results?a.results.map(e=>({sourcePath:f(e.sourcePath??e.path),contentType:f(e.contentType,`unknown`),score:l(e.score),content:f(e.content??e.snippet),headingPath:p(e.headingPath),startLine:u(e.startLine),endLine:u(e.endLine)})):o(r(n))}async listKnowledge(){let e=i(await this.client.callTool({name:`list`,arguments:{}}));return e?.entries?e.entries.map(e=>({path:f(e.path),title:f(e.title),category:f(e.category),tags:m(e.tags),content:f(e.content)})):[]}async readKnowledge(e){try{let t=r(await this.client.callTool({name:`read`,arguments:{path:e}}));return!t||/not found/i.test(t)?null:{path:e,title:e.split(`/`).pop()??e,category:e.split(`/`).at(-2)??`uncategorized`,tags:[],content:t}}catch{return null}}async getGraph(e){let t=s(r(await this.client.callTool({name:`graph`,arguments:{action:`find_nodes`,...e?{name_pattern:e}:{},limit:500}})));return t.length===0?{nodes:[],edges:[]}:{nodes:t,edges:c(r(await this.client.callTool({name:`graph`,arguments:{action:`find_edges`,limit:1e3}})))}}async getFileTree(){let e=await this.client.callTool({name:`find`,arguments:{glob:`**/*`,limit:1e4}}),t=i(e);return t?.results?t.results.map(e=>typeof e==`string`?e:e.path??``).filter(e=>e.length>0):r(e).split(`
+`).map(e=>e.trim()).filter(e=>e.length>0)}};function r(e){return t(e)}function i(t){return e(t)}function a(e,t){let n=t.exec(e);return n?Number.parseInt(n[1],10):0}function o(e){let t=[],n=e.split(/\n(?=\d+\.\s|\*\*)/);for(let e of n){let n=/(?:\*\*|`)([^*`]+?)(?:\*\*|`)/.exec(e),r=/score:\s*([\d.]+)/i.exec(e);n&&t.push({sourcePath:n[1].trim(),contentType:`unknown`,score:r?Number.parseFloat(r[1]):0,content:e.replace(/^.*\n/,``).trim().slice(0,200)})}return t}function s(e){let t=[];for(let n of e.split(`
+`)){let e=/\*\*(.+?)\*\*\s*\(([^,)]+)(?:,\s*id:\s*`?([\w-]+)`?)?/.exec(n);e&&t.push({id:e[3]??`node-${t.length}`,name:e[1],type:e[2]})}return t}function c(e){let t=[];for(let n of e.split(`
+`)){let e=/`?([\w-]+)`?\s*[—-]+\[(\w+)\][→>]\s*`?([\w-]+)`?/.exec(n);e&&t.push({fromId:e[1],toId:e[3],type:e[2]})}return t}function l(e){return typeof e==`number`?e:0}function u(e){return typeof e==`number`?e:void 0}function d(e){return typeof e==`string`?e:null}function f(e,t=``){return typeof e==`string`?e:t}function p(e){return typeof e==`string`?e:void 0}function m(e){return Array.isArray(e)?e.filter(e=>typeof e==`string`):[]}export{n as McpKBClient};