@weave-kit/engine 1.3.0 → 1.4.0

package/dist/core/prompts/catalog.js

@@ -0,0 +1,156 @@
+import { describeObject } from '../object/describe.js';
+import { resolvePermissionFor } from '../rbac/index.js';
+import { SchemaError } from '../types/errors.js';
+import { BUILTIN_PROMPTS } from './values.js';
+/**
+ * Built-in MCP prompts, derived from the schema (not authored business content),
+ * so a headless engine can still guide an agent to use its own tool surface:
+ *
+ *   explore_data           → the list_objects → describe_object → search_records flow
+ *   object_guide(object)   → one object's descriptor + which tools to use
+ *   build_filter(object)   → how to shape a search_records filter
+ *   run_workflow(object)   → the object's workflow transitions
+ *
+ * The surface is RBAC-filtered per identity (only readable objects appear), and
+ * every render re-checks the identity's permissions (list + get, like the tool
+ * surface). Instruction text is English (matching the tool descriptions); the
+ * schema payload is language-neutral JSON.
+ */
+const OBJECT_ARG_DESC = 'object name (see list_objects)';
+function text(message) {
+    return { role: 'user', content: { type: 'text', text: message } };
+}
+/** objects the identity may read (mirrors `list_objects`) */
+function readableObjects(registry, roles) {
+    return registry.list().filter((def) => resolvePermissionFor(registry, def, roles)?.read !== undefined);
+}
+/** the built-in prompts visible to the identity (empty when it can read nothing) */
+export function builtinPromptDescriptors(registry, roles) {
+    const readable = readableObjects(registry, roles);
+    if (readable.length === 0)
+        return [];
+    const prompts = [
+        {
+            name: BUILTIN_PROMPTS.EXPLORE,
+            description: 'Step-by-step guide to explore data with the built-in tools',
+        },
+        {
+            name: BUILTIN_PROMPTS.OBJECT_GUIDE,
+            description: 'Guidance for working with one object (fields, relations and your permissions)',
+            arguments: [{ name: 'object', description: OBJECT_ARG_DESC, required: true }],
+        },
+        {
+            name: BUILTIN_PROMPTS.BUILD_FILTER,
+            description: 'How to build a search_records filter for one object',
+            arguments: [{ name: 'object', description: OBJECT_ARG_DESC, required: true }],
+        },
+    ];
+    if (readable.some((def) => def.workflow !== undefined)) {
+        prompts.push({
+            name: BUILTIN_PROMPTS.RUN_WORKFLOW,
+            description: 'How to fire a workflow transition on one object',
+            arguments: [{ name: 'object', description: OBJECT_ARG_DESC, required: true }],
+        });
+    }
+    return prompts;
+}
+function requireArg(args, key, name, locale) {
+    const value = args[key];
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new SchemaError('prompt.args.invalid', { name, detail: `missing required argument "${key}"` }, locale);
+    }
+    return value;
+}
+function exploreText() {
+    return [
+        'Explore the data available to you through the WeaveKit tools.',
+        '',
+        '1. Call list_objects to see the objects your identity can read.',
+        '2. Call describe_object for one to get its fields, relations and your permissions.',
+        '3. Call search_records (with a filter/sort/limit) to read rows — rows are already scoped to what you may see.',
+        '4. Use get_record for one row, and create_record / update_record / delete_record to write (only permitted fields).',
+        '',
+        'Start with list_objects and tell me what you find.',
+    ].join('\n');
+}
+function objectGuideText(descriptor, name) {
+    return [
+        `Work with the "${name}" object.`,
+        '',
+        'Metadata (schema + your permissions):',
+        JSON.stringify(descriptor, null, 2),
+        '',
+        'Guidance:',
+        `- Read rows with search_records (object="${name}"); fetch one with get_record (id = the record id).`,
+        '- Write with create_record / update_record / delete_record; only fields your role permits are accepted.',
+        '- Row scope is applied automatically; use describe_object to refresh this metadata at any time.',
+    ].join('\n');
+}
+function buildFilterText(name, fields) {
+    const lines = fields.map((f) => `- ${f.name} (${f.type})`);
+    return [
+        `Build a search_records filter for "${name}".`,
+        '',
+        'Readable fields:',
+        ...lines,
+        '',
+        'Filter shape: { "<field>": <value> } for equality, or { "<field>": { "<op>": <value> } } for an operator',
+        '(eq, ne, gt, gte, lt, lte, in, contains, like). Multiple fields are AND\u2019d; use { "$or": [ ... ] } for OR.',
+        'sort is an array of { field, direction } (asc | desc).',
+        `Call search_records with object="${name}" and your filter.`,
+    ].join('\n');
+}
+function runWorkflowText(name, workflow) {
+    return [
+        `Fire a workflow transition on "${name}".`,
+        '',
+        'Workflow (states + transitions):',
+        JSON.stringify(workflow, null, 2),
+        '',
+        `Call workflow_transition with object="${name}", id=<record id>, and action=<a transition allowed from the`,
+        'record\u2019s current state and by your role \u2014 see describe_object \u2192 workflow).',
+    ].join('\n');
+}
+/**
+ * Render a built-in prompt. Throws `prompt.args.invalid` (missing/empty arg or a
+ * non-workflow object for `run_workflow`), `data.objectUnknown` (unknown object)
+ * or `rbac.denied.read` (identity may not read the object) — mapping to a
+ * protocol error at the MCP layer.
+ */
+export function renderBuiltinPrompt(registry, name, args, roles, locale) {
+    switch (name) {
+        case BUILTIN_PROMPTS.EXPLORE:
+            return { description: 'Explore the available data', messages: [text(exploreText())] };
+        case BUILTIN_PROMPTS.OBJECT_GUIDE: {
+            const object = requireArg(args, 'object', name, locale);
+            const descriptor = describeObject(registry, object, roles, locale);
+            return {
+                description: `Work with the "${object}" object`,
+                messages: [text(objectGuideText(descriptor, object))],
+            };
+        }
+        case BUILTIN_PROMPTS.BUILD_FILTER: {
+            const object = requireArg(args, 'object', name, locale);
+            const descriptor = describeObject(registry, object, roles, locale);
+            const fields = descriptor.fields.filter((f) => f.virtual !== true).map((f) => ({ name: f.name, type: f.type }));
+            return {
+                description: `Build a search_records filter for "${object}"`,
+                messages: [text(buildFilterText(object, fields))],
+            };
+        }
+        case BUILTIN_PROMPTS.RUN_WORKFLOW: {
+            const object = requireArg(args, 'object', name, locale);
+            const descriptor = describeObject(registry, object, roles, locale);
+            if (descriptor.workflow === undefined) {
+                throw new SchemaError('prompt.args.invalid', { name, detail: `object "${object}" has no workflow` }, locale);
+            }
+            return {
+                description: `Fire a workflow transition on "${object}"`,
+                messages: [text(runWorkflowText(object, descriptor.workflow))],
+            };
+        }
+        default:
+            throw new SchemaError('prompt.notFound', { name }, locale);
+    }
+}
+//# sourceMappingURL=catalog.js.map

package/dist/core/prompts/catalog.js.map

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

package/dist/core/prompts/index.d.ts

@@ -0,0 +1,3 @@
+export * from './values.js';
+export * from './catalog.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/prompts/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/core/prompts/index.js

@@ -0,0 +1,3 @@
+export * from './values.js';
+export * from './catalog.js';
+//# sourceMappingURL=index.js.map

package/dist/core/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/prompts/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/core/prompts/values.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Built-in prompt names — single source of truth (`as const`, see AGENTS.md).
+ *
+ * The engine's built-in prompts are **schema-derived and identity-filtered**
+ * (see `catalog.ts`); they teach an agent to use the engine's own tool surface.
+ * A host provider must not reuse these names (`isBuiltinPromptName`).
+ */
+export declare const BUILTIN_PROMPTS: {
+    /** meta guide: list_objects → describe_object → search_records */
+    readonly EXPLORE: "explore_data";
+    /** embed one object's descriptor + tool guidance */
+    readonly OBJECT_GUIDE: "object_guide";
+    /** how to build a `search_records` filter for one object */
+    readonly BUILD_FILTER: "build_filter";
+    /** how to fire a workflow transition on one object */
+    readonly RUN_WORKFLOW: "run_workflow";
+};
+export type BuiltinPrompt = typeof BUILTIN_PROMPTS[keyof typeof BUILTIN_PROMPTS];
+/** true when a name is a reserved built-in prompt (a provider may not override it) */
+export declare function isBuiltinPromptName(name: string): boolean;
+//# sourceMappingURL=values.d.ts.map

package/dist/core/prompts/values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../../src/core/prompts/values.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,eAAe;IAC1B,kEAAkE;;IAElE,oDAAoD;;IAEpD,4DAA4D;;IAE5D,sDAAsD;;CAE9C,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAIjF,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD"}

package/dist/core/prompts/values.js

@@ -0,0 +1,23 @@
+/**
+ * Built-in prompt names — single source of truth (`as const`, see AGENTS.md).
+ *
+ * The engine's built-in prompts are **schema-derived and identity-filtered**
+ * (see `catalog.ts`); they teach an agent to use the engine's own tool surface.
+ * A host provider must not reuse these names (`isBuiltinPromptName`).
+ */
+export const BUILTIN_PROMPTS = {
+    /** meta guide: list_objects → describe_object → search_records */
+    EXPLORE: 'explore_data',
+    /** embed one object's descriptor + tool guidance */
+    OBJECT_GUIDE: 'object_guide',
+    /** how to build a `search_records` filter for one object */
+    BUILD_FILTER: 'build_filter',
+    /** how to fire a workflow transition on one object */
+    RUN_WORKFLOW: 'run_workflow',
+};
+const builtinNames = Object.values(BUILTIN_PROMPTS);
+/** true when a name is a reserved built-in prompt (a provider may not override it) */
+export function isBuiltinPromptName(name) {
+    return builtinNames.includes(name);
+}
+//# sourceMappingURL=values.js.map

package/dist/core/prompts/values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.js","sourceRoot":"","sources":["../../../src/core/prompts/values.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,kEAAkE;IAClE,OAAO,EAAE,cAAc;IACvB,oDAAoD;IACpD,YAAY,EAAE,cAAc;IAC5B,4DAA4D;IAC5D,YAAY,EAAE,cAAc;IAC5B,sDAAsD;IACtD,YAAY,EAAE,cAAc;CACpB,CAAC;AAGX,MAAM,YAAY,GAAsB,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;AAEvE,sFAAsF;AACtF,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC"}

package/dist/core/provider/index.d.ts

@@ -2,4 +2,5 @@ export * from './alerts/index.js';
 export * from './identity/index.js';
 export * from './event/index.js';
 export * from './capabilities/index.js';
+export * from './prompts/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/provider/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/provider/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/provider/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC"}

package/dist/core/provider/index.js

@@ -2,4 +2,5 @@ export * from './alerts/index.js';
 export * from './identity/index.js';
 export * from './event/index.js';
 export * from './capabilities/index.js';
+export * from './prompts/index.js';
 //# sourceMappingURL=index.js.map

package/dist/core/provider/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/provider/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/provider/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC"}

package/dist/core/provider/prompts/index.d.ts

@@ -0,0 +1,3 @@
+export type { PromptArgument, PromptRole, PromptMessage, PromptDescriptor, PromptResult, PromptSubject, PromptsProvider, } from './types.js';
+export { PROMPTS_API } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/provider/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/provider/prompts/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/provider/prompts/index.js

@@ -0,0 +1,2 @@
+export { PROMPTS_API } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/core/provider/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/provider/prompts/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/provider/prompts/types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * MCP prompts seam.
+ *
+ * MCP exposes three primitives: **tools** (the model calls), **resources** (the
+ * app/user attaches context) and **prompts** (the *user* triggers a template
+ * that expands into a set of messages). Prompts are inherently user-facing and
+ * often business-flavored, so the engine does not author them: it ships a small
+ * set of **schema-derived** built-in prompts (see `core/prompts`) and lets a host
+ * inject its own via this provider seam.
+ *
+ * The engine treats provider content as opaque (it only keeps the shape) — a
+ * console/enterprise/plugin supplies the business templates. With no provider
+ * configured only the built-in prompts are exposed.
+ */
+/** one argument a prompt accepts (MCP arguments are always strings) */
+export interface PromptArgument {
+    name: string;
+    description?: string;
+    required?: boolean;
+}
+/** the roles a prompt message may carry (mirrors the MCP protocol) */
+export type PromptRole = 'user' | 'assistant';
+/** one message a prompt expands to */
+export interface PromptMessage {
+    role: PromptRole;
+    content: {
+        type: 'text';
+        text: string;
+    };
+}
+/** a prompt as advertised by `prompts/list` */
+export interface PromptDescriptor {
+    name: string;
+    description?: string;
+    arguments?: PromptArgument[];
+}
+/** the expansion of a prompt, returned by `prompts/get` */
+export interface PromptResult {
+    description?: string;
+    messages: PromptMessage[];
+}
+/** the identity context a provider filters by (never a secret) */
+export interface PromptSubject {
+    subjectId: string;
+    roles: string[];
+}
+/**
+ * A host-injected prompt provider. `list` returns the descriptors visible to
+ * the subject; `get` expands one (return `null` for an unknown name so the
+ * engine can answer `prompt.notFound`). Both may be async.
+ */
+export interface PromptsProvider {
+    list(ctx: PromptSubject): PromptDescriptor[] | Promise<PromptDescriptor[]>;
+    get(name: string, args: Record<string, string>, ctx: PromptSubject): PromptResult | null | Promise<PromptResult | null>;
+}
+/** contract version for `PromptsProvider` implementers (stable seam) */
+export declare const PROMPTS_API = 1;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/provider/prompts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/provider/prompts/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,sEAAsE;AACtE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,WAAW,CAAC;AAE9C,sCAAsC;AACtC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC;AAED,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,GAAG,EAAE,aAAa,GAAG,gBAAgB,EAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC3E,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,aAAa,GAAG,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;CACzH;AAED,wEAAwE;AACxE,eAAO,MAAM,WAAW,IAAI,CAAC"}

package/dist/core/provider/prompts/types.js

@@ -0,0 +1,17 @@
+/**
+ * MCP prompts seam.
+ *
+ * MCP exposes three primitives: **tools** (the model calls), **resources** (the
+ * app/user attaches context) and **prompts** (the *user* triggers a template
+ * that expands into a set of messages). Prompts are inherently user-facing and
+ * often business-flavored, so the engine does not author them: it ships a small
+ * set of **schema-derived** built-in prompts (see `core/prompts`) and lets a host
+ * inject its own via this provider seam.
+ *
+ * The engine treats provider content as opaque (it only keeps the shape) — a
+ * console/enterprise/plugin supplies the business templates. With no provider
+ * configured only the built-in prompts are exposed.
+ */
+/** contract version for `PromptsProvider` implementers (stable seam) */
+export const PROMPTS_API = 1;
+//# sourceMappingURL=types.js.map

package/dist/core/provider/prompts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/provider/prompts/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA+CH,wEAAwE;AACxE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC"}

package/dist/version.d.ts

@@ -1,5 +1,5 @@
 /** engine version — single source of truth for CLI, ops routes and MCP metadata */
-export declare const version = "1.3.0";
+export declare const version = "1.4.0";
 /**
  * Frozen public-contract version (G1). Bump only on a **breaking** change to the
  * frozen surface (schema/workflow format, REST routes, MCP tool names, event

package/dist/version.js

@@ -1,5 +1,5 @@
 /** engine version — single source of truth for CLI, ops routes and MCP metadata */
-export const version = '1.3.0';
+export const version = '1.4.0';
 /**
  * Frozen public-contract version (G1). Bump only on a **breaking** change to the
  * frozen surface (schema/workflow format, REST routes, MCP tool names, event

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weave-kit/engine",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "WeaveKit engine — a metadata-driven headless backend runtime with Git-versioned metadata",
   "type": "module",
   "main": "./dist/index.js",