@niscorp/vex 0.2.2 → 0.2.3

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.
Files changed (36) hide show
  1. package/CHANGELOG.md +121 -0
  2. package/DESIGN.md +66 -3
  3. package/DOCS.md +156 -12
  4. package/dist/adapters/express/index.cjs +102 -17
  5. package/dist/adapters/express/index.cjs.map +1 -1
  6. package/dist/adapters/express/index.d.cts +2 -2
  7. package/dist/adapters/express/index.d.ts +2 -2
  8. package/dist/adapters/express/index.js +2 -2
  9. package/dist/adapters/hono/index.cjs +121 -22
  10. package/dist/adapters/hono/index.cjs.map +1 -1
  11. package/dist/adapters/hono/index.d.cts +2 -2
  12. package/dist/adapters/hono/index.d.ts +2 -2
  13. package/dist/adapters/hono/index.js +21 -7
  14. package/dist/adapters/hono/index.js.map +1 -1
  15. package/dist/agent/index.cjs +2 -0
  16. package/dist/agent/index.cjs.map +1 -1
  17. package/dist/agent/index.d.cts +1 -1
  18. package/dist/agent/index.d.ts +1 -1
  19. package/dist/agent/index.js +1 -1
  20. package/dist/{chunk-HF25Q53I.js → chunk-H4BHW76Q.js} +6 -3
  21. package/dist/chunk-H4BHW76Q.js.map +1 -0
  22. package/dist/{chunk-HCEH55PP.js → chunk-IQM4SQE2.js} +123 -21
  23. package/dist/chunk-IQM4SQE2.js.map +1 -0
  24. package/dist/{handler-Cql8SJ3F.d.cts → handler-BGCL6_Si.d.ts} +3 -2
  25. package/dist/{handler-mICf9ins.d.ts → handler-CMrjTXNx.d.cts} +3 -2
  26. package/dist/index.cjs +163 -35
  27. package/dist/index.cjs.map +1 -1
  28. package/dist/index.d.cts +3 -3
  29. package/dist/index.d.ts +3 -3
  30. package/dist/index.js +44 -22
  31. package/dist/index.js.map +1 -1
  32. package/dist/{types-BRvMB6IM.d.cts → types-Bi-Lg86b.d.cts} +48 -2
  33. package/dist/{types-BRvMB6IM.d.ts → types-Bi-Lg86b.d.ts} +48 -2
  34. package/package.json +5 -5
  35. package/dist/chunk-HCEH55PP.js.map +0 -1
  36. package/dist/chunk-HF25Q53I.js.map +0 -1
@@ -1,6 +1,6 @@
1
1
  import { Env, Context, Hono } from 'hono';
2
- import { a as QueryEngine, ak as ScopeValues, S as ScopePolicy } from '../../types-BRvMB6IM.cjs';
3
- import { M as MutationClient, W as WriteEvent, E as ExecuteRecord } from '../../handler-Cql8SJ3F.cjs';
2
+ import { a as QueryEngine, al as ScopeValues, S as ScopePolicy } from '../../types-Bi-Lg86b.cjs';
3
+ import { M as MutationClient, W as WriteEvent, E as ExecuteRecord } from '../../handler-CMrjTXNx.cjs';
4
4
  import 'zod';
5
5
  import '@niscorp/prism';
6
6
  import '@niscorp/strata';
@@ -1,6 +1,6 @@
1
1
  import { Env, Context, Hono } from 'hono';
2
- import { a as QueryEngine, ak as ScopeValues, S as ScopePolicy } from '../../types-BRvMB6IM.js';
3
- import { M as MutationClient, W as WriteEvent, E as ExecuteRecord } from '../../handler-mICf9ins.js';
2
+ import { a as QueryEngine, al as ScopeValues, S as ScopePolicy } from '../../types-Bi-Lg86b.js';
3
+ import { M as MutationClient, W as WriteEvent, E as ExecuteRecord } from '../../handler-BGCL6_Si.js';
4
4
  import 'zod';
5
5
  import '@niscorp/prism';
6
6
  import '@niscorp/strata';
@@ -1,5 +1,5 @@
1
- import { handleDiscovery, handleQuery, handleFingerprintPatch, handleFingerprintDelete } from '../../chunk-HCEH55PP.js';
2
- import '../../chunk-HF25Q53I.js';
1
+ import { handleDiscovery, handleQuery, handleFingerprintPatch, handleFingerprintDelete } from '../../chunk-IQM4SQE2.js';
2
+ import '../../chunk-H4BHW76Q.js';
3
3
  import { Hono } from 'hono';
4
4
 
5
5
  var VEX_LIVE_ENV = "vexLive";
@@ -16,8 +16,18 @@ var fingerprintFromBody = (body) => {
16
16
  const fp = body["fingerprint"];
17
17
  return typeof fp === "string" && fp.length > 0 ? fp : void 0;
18
18
  };
19
+ var NOT_JSON = { error: "invalid_request", message: "Body must be JSON" };
19
20
  var vex = (config) => {
20
21
  const app = new Hono();
22
+ const jsonBodyOf = async (c) => {
23
+ try {
24
+ const body = await c.req.json();
25
+ return { parsed: true, body };
26
+ } catch (err) {
27
+ if (err instanceof SyntaxError) return { parsed: false };
28
+ throw err;
29
+ }
30
+ };
21
31
  const requestConfig = async (c) => {
22
32
  const policy = config.getPolicy ? await config.getPolicy(c) : void 0;
23
33
  const mutationPolicy = policy ?? config.mutations?.policy;
@@ -45,12 +55,15 @@ var vex = (config) => {
45
55
  app.get("/", async (c) => c.json(await handleDiscovery(await requestConfig(c))));
46
56
  app.post("/", async (c) => {
47
57
  const scope = config.getScope ? await config.getScope(c) : {};
48
- const body = await c.req.json();
49
- const result = await handleQuery(await requestConfig(c), body, scope, liveOf(c.env));
58
+ const read = await jsonBodyOf(c);
59
+ if (!read.parsed) return c.json(NOT_JSON, 400);
60
+ const result = await handleQuery(await requestConfig(c), read.body, scope, liveOf(c.env));
50
61
  return c.json(result.body, result.status);
51
62
  });
52
63
  app.patch("/", async (c) => {
53
- const body = await c.req.json();
64
+ const read = await jsonBodyOf(c);
65
+ if (!read.parsed) return c.json(NOT_JSON, 400);
66
+ const body = read.body;
54
67
  const fingerprint = fingerprintFromBody(body);
55
68
  if (fingerprint === void 0) {
56
69
  return c.json({ error: "invalid_request", message: "Body must include { fingerprint }" }, 400);
@@ -62,8 +75,9 @@ var vex = (config) => {
62
75
  return c.json(result.body, result.status);
63
76
  });
64
77
  app.delete("/", async (c) => {
65
- const body = await c.req.json();
66
- const fingerprint = fingerprintFromBody(body);
78
+ const read = await jsonBodyOf(c);
79
+ if (!read.parsed) return c.json(NOT_JSON, 400);
80
+ const fingerprint = fingerprintFromBody(read.body);
67
81
  if (fingerprint === void 0) {
68
82
  return c.json({ error: "invalid_request", message: "Body must include { fingerprint }" }, 400);
69
83
  }
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../src/adapters/hono/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { Hono } from 'hono';\nimport type { Context, Env } from 'hono';\nimport type { QueryEngine } from '../../types.js';\nimport type { ScopePolicy, ScopeValues } from '../../scope/scope.types.js';\nimport type { MutationClient } from '../../mutations/engine.js';\nimport { handleDiscovery, handleQuery, handleFingerprintPatch, handleFingerprintDelete } from '../../handler.js';\nimport type { WriteEvent, ExecuteRecord, VexLive } from '../../handler.js';\nimport type { QueryResponse } from '../../schemas/request.schema.js';\n\n// A request made IN-PROCESS may carry a follower in hono's env — the third\n// argument of `app.request(url, init, env)` — under this key. A request off\n// the network never can: its env is the runtime's (node's sockets, a\n// worker's bindings), so nothing a client sends reaches it. See `VexLive`.\nexport const VEX_LIVE_ENV = 'vexLive';\n\nconst liveOf = (env: unknown): VexLive | undefined => {\n if (env === null || typeof env !== 'object' || !(VEX_LIVE_ENV in env)) return undefined;\n const live: unknown = Reflect.get(env, VEX_LIVE_ENV);\n if (live === null || typeof live !== 'object' || !('signal' in live) || !('onChange' in live)) return undefined;\n const { signal, onChange } = live;\n if (!(signal instanceof AbortSignal) || typeof onChange !== 'function') return undefined;\n return { signal, onChange: (response: QueryResponse) => void Reflect.apply(onChange, undefined, [response]) };\n};\n\n// Generic over the hono Env so a host that mounts this under its own app\n// (with typed context variables — e.g. the resolved principal) reads them\n// in `getScope`/`getPolicy` without casts.\nexport type VexHonoConfig<E extends Env = Env> = {\n engine: QueryEngine;\n entities?: string[];\n // Replay-only posture: no generation, no fingerprint management.\n // (Writes are unaffected — mutation replay is always replay-only.)\n locked?: boolean;\n getScope?: (c: Context<E>) => Promise<ScopeValues> | ScopeValues;\n // Per-request ScopePolicy — a host that resolves policy per principal\n // (e.g. compiled from an ACL layer at login) returns it here; it governs\n // reads, mutation replay AND discovery on this endpoint. Absent (or\n // returning undefined), the engine default and `mutations.policy` apply.\n getPolicy?: (c: Context<E>) => Promise<ScopePolicy | undefined> | ScopePolicy | undefined;\n // The same principal's policy at a reach an entry demands — see\n // `OkCacheEntry.reach`. Bound per request, because the principal is.\n getPolicyForReach?: (c: Context<E>, reach: string) => Promise<ScopePolicy | undefined> | ScopePolicy | undefined;\n // Enables replay of `kind: 'mutation'` cache entries on this endpoint.\n // `policy` is the static fallback when `getPolicy` is absent; at least\n // one of the two must supply a policy for writes to run.\n // `onWrite` is the handler's write observer, passed through verbatim —\n // fired after a successful commit with per-statement writes and scope.\n mutations?: {\n client: MutationClient;\n policy?: ScopePolicy;\n onWrite?: (event: WriteEvent) => void;\n };\n // The execution observer, passed through verbatim — fired once per query or\n // mutation with vex-vocabulary facts. See `VexHandlerConfig.onExecute`.\n onExecute?: (record: ExecuteRecord) => void;\n};\n\n// Fingerprints may contain '/' (named slots like \"deals/table\"), so\n// management rides the request BODY, not the path.\nconst fingerprintFromBody = (body: unknown): string | undefined => {\n if (body === null || typeof body !== 'object') return undefined;\n const fp = (body as Record<string, unknown>)['fingerprint'];\n return typeof fp === 'string' && fp.length > 0 ? fp : undefined;\n};\n\nexport const vex = <E extends Env = Env>(config: VexHonoConfig<E>): Hono<E> => {\n const app = new Hono<E>();\n // The per-request policy (when configured) overrides everything policy-\n // shaped: reads (scopePolicy), writes (mutations.policy) and discovery.\n const requestConfig = async (c: Context<E>) => {\n const policy = config.getPolicy ? await config.getPolicy(c) : undefined;\n const mutationPolicy = policy ?? config.mutations?.policy;\n return {\n engine: config.engine,\n entities: config.entities,\n ...(config.locked === true ? { locked: true } : {}),\n ...(policy !== undefined ? { scopePolicy: policy } : {}),\n ...(config.getPolicyForReach !== undefined\n ? { policyForReach: (reach: string) => config.getPolicyForReach?.(c, reach) }\n : {}),\n ...(config.onExecute !== undefined ? { onExecute: config.onExecute } : {}),\n ...(config.mutations !== undefined && mutationPolicy !== undefined\n ? {\n mutations: {\n client: config.mutations.client,\n policy: mutationPolicy,\n ...(config.mutations.onWrite !== undefined ? { onWrite: config.mutations.onWrite } : {}),\n },\n }\n : {}),\n };\n };\n // Fingerprint management carries no per-request policy — it is refused\n // under `locked` and is an operator surface, not a principal one.\n const handlerConfig = {\n engine: config.engine,\n entities: config.entities,\n ...(config.locked === true ? { locked: true } : {}),\n };\n\n app.get('/', async (c) => c.json(await handleDiscovery(await requestConfig(c))));\n\n app.post('/', async (c) => {\n const scope = config.getScope ? await config.getScope(c) : {};\n const body: unknown = await c.req.json();\n const result = await handleQuery(await requestConfig(c), body, scope, liveOf(c.env));\n return c.json(result.body, result.status as 200);\n });\n\n app.patch('/', async (c) => {\n const body: unknown = await c.req.json();\n const fingerprint = fingerprintFromBody(body);\n if (fingerprint === undefined) {\n return c.json({ error: 'invalid_request', message: 'Body must include { fingerprint }' }, 400);\n }\n const wanted = (body as Record<string, unknown>)['protected'];\n const result = await handleFingerprintPatch(handlerConfig, fingerprint, {\n ...(typeof wanted === 'boolean' ? { protected: wanted } : {}),\n });\n return c.json(result.body, result.status as 200);\n });\n\n app.delete('/', async (c) => {\n const body: unknown = await c.req.json();\n const fingerprint = fingerprintFromBody(body);\n if (fingerprint === undefined) {\n return c.json({ error: 'invalid_request', message: 'Body must include { fingerprint }' }, 400);\n }\n const result = await handleFingerprintDelete(handlerConfig, fingerprint);\n return c.json(result.body, result.status as 200);\n });\n\n return app;\n};\n"]}
1
+ {"version":3,"sources":["../../../src/adapters/hono/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { Hono } from 'hono';\nimport type { Context, Env } from 'hono';\nimport type { QueryEngine } from '../../types.js';\nimport type { ScopePolicy, ScopeValues } from '../../scope/scope.types.js';\nimport type { MutationClient } from '../../mutations/engine.js';\nimport { handleDiscovery, handleQuery, handleFingerprintPatch, handleFingerprintDelete } from '../../handler.js';\nimport type { WriteEvent, ExecuteRecord, VexLive } from '../../handler.js';\nimport type { QueryResponse } from '../../schemas/request.schema.js';\n\n// A request made IN-PROCESS may carry a follower in hono's env — the third\n// argument of `app.request(url, init, env)` — under this key. A request off\n// the network never can: its env is the runtime's (node's sockets, a\n// worker's bindings), so nothing a client sends reaches it. See `VexLive`.\nexport const VEX_LIVE_ENV = 'vexLive';\n\nconst liveOf = (env: unknown): VexLive | undefined => {\n if (env === null || typeof env !== 'object' || !(VEX_LIVE_ENV in env)) return undefined;\n const live: unknown = Reflect.get(env, VEX_LIVE_ENV);\n if (live === null || typeof live !== 'object' || !('signal' in live) || !('onChange' in live)) return undefined;\n const { signal, onChange } = live;\n if (!(signal instanceof AbortSignal) || typeof onChange !== 'function') return undefined;\n return { signal, onChange: (response: QueryResponse) => void Reflect.apply(onChange, undefined, [response]) };\n};\n\n// Generic over the hono Env so a host that mounts this under its own app\n// (with typed context variables — e.g. the resolved principal) reads them\n// in `getScope`/`getPolicy` without casts.\nexport type VexHonoConfig<E extends Env = Env> = {\n engine: QueryEngine;\n entities?: string[];\n // Replay-only posture: no generation, no fingerprint management.\n // (Writes are unaffected — mutation replay is always replay-only.)\n locked?: boolean;\n getScope?: (c: Context<E>) => Promise<ScopeValues> | ScopeValues;\n // Per-request ScopePolicy — a host that resolves policy per principal\n // (e.g. compiled from an ACL layer at login) returns it here; it governs\n // reads, mutation replay AND discovery on this endpoint. Absent (or\n // returning undefined), the engine default and `mutations.policy` apply.\n getPolicy?: (c: Context<E>) => Promise<ScopePolicy | undefined> | ScopePolicy | undefined;\n // The same principal's policy at a reach an entry demands — see\n // `OkCacheEntry.reach`. Bound per request, because the principal is.\n getPolicyForReach?: (c: Context<E>, reach: string) => Promise<ScopePolicy | undefined> | ScopePolicy | undefined;\n // Enables replay of `kind: 'mutation'` cache entries on this endpoint.\n // `policy` is the static fallback when `getPolicy` is absent; at least\n // one of the two must supply a policy for writes to run.\n // `onWrite` is the handler's write observer, passed through verbatim —\n // fired after a successful commit with per-statement writes and scope.\n mutations?: {\n client: MutationClient;\n policy?: ScopePolicy;\n onWrite?: (event: WriteEvent) => void;\n };\n // The execution observer, passed through verbatim — fired once per query or\n // mutation with vex-vocabulary facts. See `VexHandlerConfig.onExecute`.\n onExecute?: (record: ExecuteRecord) => void;\n};\n\n// Fingerprints may contain '/' (named slots like \"deals/table\"), so\n// management rides the request BODY, not the path.\nconst fingerprintFromBody = (body: unknown): string | undefined => {\n if (body === null || typeof body !== 'object') return undefined;\n const fp = (body as Record<string, unknown>)['fingerprint'];\n return typeof fp === 'string' && fp.length > 0 ? fp : undefined;\n};\n\n// A body that is not JSON is the request's mistake, not the server's: it is\n// answered 400 in the surface's own error shape instead of thrown out of the\n// route. The content type is never read: JSON sent as text/plain (what `fetch`\n// sends for a string body) parses as it always has.\nconst NOT_JSON = { error: 'invalid_request', message: 'Body must be JSON' };\n\nexport const vex = <E extends Env = Env>(config: VexHonoConfig<E>): Hono<E> => {\n const app = new Hono<E>();\n // The body is read through hono's own `c.req.json()`, as it always was — so\n // a host middleware that read it first still shares hono's cache with this\n // adapter (before hono 4.2 that cache was kept per reader; reading the body\n // any other way here answered 500 to a valid request behind one). Only the\n // parse failing is caught: a body that cannot be read at all — consumed\n // outside hono, a stream that broke — is still a fault and still throws.\n const jsonBodyOf = async (c: Context<E>): Promise<{ parsed: true; body: unknown } | { parsed: false }> => {\n try {\n const body: unknown = await c.req.json();\n return { parsed: true, body };\n } catch (err) {\n if (err instanceof SyntaxError) return { parsed: false };\n throw err;\n }\n };\n // The per-request policy (when configured) overrides everything policy-\n // shaped: reads (scopePolicy), writes (mutations.policy) and discovery.\n const requestConfig = async (c: Context<E>) => {\n const policy = config.getPolicy ? await config.getPolicy(c) : undefined;\n const mutationPolicy = policy ?? config.mutations?.policy;\n return {\n engine: config.engine,\n entities: config.entities,\n ...(config.locked === true ? { locked: true } : {}),\n ...(policy !== undefined ? { scopePolicy: policy } : {}),\n ...(config.getPolicyForReach !== undefined\n ? { policyForReach: (reach: string) => config.getPolicyForReach?.(c, reach) }\n : {}),\n ...(config.onExecute !== undefined ? { onExecute: config.onExecute } : {}),\n ...(config.mutations !== undefined && mutationPolicy !== undefined\n ? {\n mutations: {\n client: config.mutations.client,\n policy: mutationPolicy,\n ...(config.mutations.onWrite !== undefined ? { onWrite: config.mutations.onWrite } : {}),\n },\n }\n : {}),\n };\n };\n // Fingerprint management carries no per-request policy — it is refused\n // under `locked` and is an operator surface, not a principal one.\n const handlerConfig = {\n engine: config.engine,\n entities: config.entities,\n ...(config.locked === true ? { locked: true } : {}),\n };\n\n app.get('/', async (c) => c.json(await handleDiscovery(await requestConfig(c))));\n\n app.post('/', async (c) => {\n const scope = config.getScope ? await config.getScope(c) : {};\n const read = await jsonBodyOf(c);\n if (!read.parsed) return c.json(NOT_JSON, 400);\n const result = await handleQuery(await requestConfig(c), read.body, scope, liveOf(c.env));\n return c.json(result.body, result.status as 200);\n });\n\n app.patch('/', async (c) => {\n const read = await jsonBodyOf(c);\n if (!read.parsed) return c.json(NOT_JSON, 400);\n const body = read.body;\n const fingerprint = fingerprintFromBody(body);\n if (fingerprint === undefined) {\n return c.json({ error: 'invalid_request', message: 'Body must include { fingerprint }' }, 400);\n }\n const wanted = (body as Record<string, unknown>)['protected'];\n const result = await handleFingerprintPatch(handlerConfig, fingerprint, {\n ...(typeof wanted === 'boolean' ? { protected: wanted } : {}),\n });\n return c.json(result.body, result.status as 200);\n });\n\n app.delete('/', async (c) => {\n const read = await jsonBodyOf(c);\n if (!read.parsed) return c.json(NOT_JSON, 400);\n const fingerprint = fingerprintFromBody(read.body);\n if (fingerprint === undefined) {\n return c.json({ error: 'invalid_request', message: 'Body must include { fingerprint }' }, 400);\n }\n const result = await handleFingerprintDelete(handlerConfig, fingerprint);\n return c.json(result.body, result.status as 200);\n });\n\n return app;\n};\n"]}
@@ -7,6 +7,7 @@ var strata = require('@niscorp/strata');
7
7
  var cortex = require('@niscorp/cortex');
8
8
 
9
9
  // src/errors.ts
10
+ var VEX_ERROR = /* @__PURE__ */ Symbol.for("@niscorp/vex:VexError");
10
11
  var VexError = class extends Error {
11
12
  code;
12
13
  details;
@@ -17,6 +18,7 @@ var VexError = class extends Error {
17
18
  this.details = details;
18
19
  }
19
20
  };
21
+ Object.defineProperty(VexError.prototype, VEX_ERROR, { value: true });
20
22
  var ContextRefSchema = zod.z.object({
21
23
  $context: zod.z.string().describe("Key to look up in the request context object")
22
24
  }).strict().describe("Reference to a caller-provided context value");
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/errors.ts","../../src/schemas/value.schema.ts","../../src/schemas/identifier.schema.ts","../../src/schemas/filter.schema.ts","../../src/schemas/compute.schema.ts","../../src/schemas/aggregate.schema.ts","../../src/schemas/query.schema.ts","../../src/agent/tools.ts","../../src/agent/query.agent.ts","../../src/agent/index.ts"],"names":["z","defineTool","exceedsDepth","depthRefusal","defineAgent","stepCount","outputRetries","repeatedCalls","ir","compile","execute","mappingAgent"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { QueryErrorCode } from './schemas/request.schema.js';\n\nexport class VexError extends Error {\n readonly code: QueryErrorCode;\n readonly details?: Record<string, unknown>;\n\n constructor(code: QueryErrorCode, message: string, details?: Record<string, unknown>) {\n super(message);\n this.name = 'VexError';\n this.code = code;\n this.details = details;\n }\n}\n","import { z } from 'zod';\n\nexport const ContextRefSchema = z\n .object({\n $context: z.string().describe('Key to look up in the request context object'),\n })\n .strict()\n .describe('Reference to a caller-provided context value');\n\nexport const ScopeRefSchema = z\n .object({\n $scope: z.string().describe('Key to look up in the server-side scope values'),\n })\n .strict()\n .describe('Reference to a server-injected scope value (access control)');\n\nexport const FieldOrValueSchema = z\n .union([\n z.string().describe('A field path (entity.field format) or a literal string'),\n z.number().describe('A literal number'),\n z.boolean().describe('A literal boolean'),\n z.null().describe('A literal null'),\n ContextRefSchema,\n ScopeRefSchema,\n ])\n .describe('A field path, literal value, or dynamic reference');\n\nexport type ContextRef = z.infer<typeof ContextRefSchema>;\nexport type ScopeRef = z.infer<typeof ScopeRefSchema>;\nexport type FieldOrValue = z.infer<typeof FieldOrValueSchema>;\n","import { z } from 'zod';\n\n// ═══════════════════════════════════════════════════════════════\n// THE NAMES A QUERY MAY SAY — and the one rule for telling them apart.\n//\n// Every string an author (a person, a seed, a model) puts in a NAME position\n// ends up in SQL text: a column reference, an output alias, a subquery alias.\n// Values never do — they bind as parameters or are quoted as literals. So a\n// name is the only place authored text meets the statement, and it is held to\n// a grammar that cannot carry anything but a name: letters, digits and\n// underscores, not starting with a digit.\n//\n// This is the parse-time half. The resolver checks the same predicates again,\n// because `engine.compile()` and `engine.test()` take a DSL that never went\n// through Zod, and the compiler refuses to emit a field position that did not\n// resolve against the introspected schema. Three layers, one grammar.\n//\n// `isFieldPathShape` is also what decides, in a value position, whether a\n// string is a column or a literal. It used to be \"contains a dot\", which made\n// every email address an unknown entity and every string with a dot a column\n// reference — so a literal like \"u1@x.com\" threw, and a string that merely\n// looked dotted went to SQL as a name. Now a column is exactly `ident.ident`,\n// and everything else is a literal.\n// ═══════════════════════════════════════════════════════════════\n\nconst IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;\nconst FIELD_PATH = /^[A-Za-z_][A-Za-z0-9_]*\\.[A-Za-z_][A-Za-z0-9_]*$/;\n\nexport const isIdentifier = (value: string): boolean => IDENTIFIER.test(value);\n\nexport const isFieldPathShape = (value: unknown): value is string => typeof value === 'string' && FIELD_PATH.test(value);\n\nexport const IdentifierSchema = z\n .string()\n .regex(IDENTIFIER, 'A name is letters, digits and underscores, not starting with a digit');\n\nexport const FieldPathSchema = z\n .string()\n .regex(FIELD_PATH, 'A field path is entity.field — each part letters, digits and underscores, not starting with a digit');\n","import { z } from 'zod';\nimport { ContextRefSchema, ScopeRefSchema, FieldOrValueSchema } from './value.schema.js';\nimport { FieldPathSchema } from './identifier.schema.js';\nimport type { ContextRef, ScopeRef, FieldOrValue } from './value.schema.js';\n\n// EXISTS — \"is there a row over there that points back at this one\".\n//\n// It is the same `{ from, filter }` a query already is, and deliberately no\n// more than that: no fields, no sort, no limit, nothing to select. EXISTS asks\n// whether a row is there, so anything that shapes output would be noise the\n// planner discards, and refusing it is what keeps this an operator rather than\n// an invitation to nest arbitrary SQL.\n//\n// The CORRELATION needs no new vocabulary. A dotted string on either side of a\n// comparison is already a field path, so pointing the inner table at the outer\n// one is an ordinary `eq` between two columns:\n//\n// { exists: { from: ['tasks'], filter: { eq: ['tasks.issue_id', 'issues.id'] } } }\n//\n// and `not` composes for NOT EXISTS. Whoever writes SQL writes this on the\n// first try, which is the entire design goal.\nexport type ExistsQuery = {\n from: string[];\n filter?: Filter;\n};\n\nexport type Filter =\n | { exists: ExistsQuery }\n | { eq: [FieldOrValue, FieldOrValue] }\n | { neq: [FieldOrValue, FieldOrValue] }\n | { gt: [FieldOrValue, FieldOrValue] }\n | { gte: [FieldOrValue, FieldOrValue] }\n | { lt: [FieldOrValue, FieldOrValue] }\n | { lte: [FieldOrValue, FieldOrValue] }\n | { in: [string, FieldOrValue[] | ContextRef | ScopeRef] }\n | { notIn: [string, FieldOrValue[] | ContextRef | ScopeRef] }\n | { like: [string, FieldOrValue] }\n | { ilike: [string, FieldOrValue] }\n | { isNull: string }\n | { isNotNull: string }\n | { and: Filter[] }\n | { or: Filter[] }\n | { not: Filter }\n | { semantic: { field: string; query: ContextRef | ScopeRef; minScore?: number } }\n | { fuzzy: { field: string; query: ContextRef | ScopeRef; maxDistance?: number } }\n | { optional: { key: string | string[]; then: Filter } };\n\nconst comparisonPair = z\n .tuple([FieldOrValueSchema, FieldOrValueSchema])\n .describe('[left, right] — both can be field paths, literals, or references');\n\nconst fieldString = FieldPathSchema.describe('Field path in entity.field format');\n\nconst collectionTarget = z\n .union([\n z.array(FieldOrValueSchema).min(1).describe('Array of literal values or references'),\n ContextRefSchema,\n ScopeRefSchema,\n ])\n .describe('A set of values or a reference that resolves to an array');\n\nconst ExistsSchema: z.ZodType<ExistsQuery> = z.lazy(() =>\n z\n .object({\n from: z.array(z.string()).min(1).describe('Entities the subquery reads. Joined by foreign key like any other from.'),\n filter: FilterSchema.optional().describe('The correlation, and any extra condition. Reference the outer query by its own entity path: { eq: [\"<inner>.<fk>\", \"<outer>.id\"] }.'),\n })\n .strict(),\n);\n\nexport const FilterSchema: z.ZodType<Filter> = z.lazy(() =>\n z.union([\n z.object({ exists: ExistsSchema }).strict().describe('EXISTS: true when the subquery matches at least one row. Wrap in `not` for NOT EXISTS.'),\n z.object({ eq: comparisonPair }).strict().describe('Equals: tests equality between two values'),\n z.object({ neq: comparisonPair }).strict().describe('Not equals'),\n z.object({ gt: comparisonPair }).strict().describe('Greater than'),\n z.object({ gte: comparisonPair }).strict().describe('Greater than or equal'),\n z.object({ lt: comparisonPair }).strict().describe('Less than'),\n z.object({ lte: comparisonPair }).strict().describe('Less than or equal'),\n z.object({ in: z.tuple([fieldString, collectionTarget]) }).strict().describe('Field value is in a set'),\n z.object({ notIn: z.tuple([fieldString, collectionTarget]) }).strict().describe('Field value is not in a set'),\n z.object({ like: z.tuple([fieldString, FieldOrValueSchema]) }).strict().describe('Case-sensitive LIKE pattern match (use % as wildcard)'),\n z.object({ ilike: z.tuple([fieldString, FieldOrValueSchema]) }).strict().describe('Case-insensitive ILIKE pattern match (use % as wildcard)'),\n z.object({ isNull: fieldString }).strict().describe('Field value is NULL'),\n z.object({ isNotNull: fieldString }).strict().describe('Field value is NOT NULL'),\n z.object({ and: z.array(FilterSchema).min(2) }).strict().describe('Logical AND: all conditions must be true'),\n z.object({ or: z.array(FilterSchema).min(2) }).strict().describe('Logical OR: at least one condition must be true'),\n z.object({ not: FilterSchema }).strict().describe('Logical NOT: negates the condition'),\n z.object({\n semantic: z.object({\n field: FieldPathSchema.describe('Vector column field path (entity.field)'),\n query: z.union([ContextRefSchema, ScopeRefSchema]).describe('Text to embed and compare'),\n minScore: z.number().min(0).max(1).optional().describe('Minimum cosine similarity (0–1)'),\n }).strict(),\n }).strict().describe('Semantic vector similarity search'),\n z.object({\n fuzzy: z.object({\n field: FieldPathSchema.describe('String field path'),\n query: z.union([ContextRefSchema, ScopeRefSchema]).describe('Text to fuzzy-match'),\n maxDistance: z.number().int().nonnegative().optional().describe('Maximum Levenshtein edit distance'),\n }).strict(),\n }).strict().describe('Fuzzy string match'),\n z.object({\n optional: z.object({\n key: z.union([z.string().min(1), z.array(z.string().min(1)).min(1)])\n .describe('The context key this condition depends on, or EVERY key it depends on. A condition referencing two keys must name both — gating on one leaves the other conditionally required, which surfaces as an empty result rather than as a condition that did not apply.'),\n // BARE, never `.describe()`d. That call CLONES the schema, and zod\n // detects a recursive reference by instance identity — a clone is a\n // different instance, so `to-json-schema` stops seeing the cycle and\n // expands the filter union into itself until the stack goes. Every\n // other recursive slot here (`not`, `and`, `or`) uses it bare for the\n // same reason; the description belongs on the wrapper below.\n then: FilterSchema,\n }).strict(),\n }).strict().describe(\n 'A condition the caller turns on by supplying context keys. When any named key is absent the condition is REMOVED from the query before it compiles — it does not match everything, it is not there. Absent means missing, undefined or null; \"\" is a value and keeps the condition. Direction follows position: under `and` supplying the key NARROWS, under `or` it WIDENS. Either way an absent key reads exactly as if the condition had never been written, and scope is injected afterwards regardless. Reads only: a mutation may not contain one, and neither may the inside of an `exists` (its correlation must be unconditional).',\n ),\n ]),\n);\n","import { z } from 'zod';\nimport { FieldOrValueSchema } from './value.schema.js';\nimport { FilterSchema } from './filter.schema.js';\n\nconst CaseWhenSchema = z\n .object({\n condition: FilterSchema,\n then: FieldOrValueSchema.describe('Value when condition is true'),\n })\n .strict();\n\nexport const ComputeExpressionSchema = z\n .union([\n z.object({ add: z.tuple([FieldOrValueSchema, FieldOrValueSchema]) }).strict().describe('Addition: a + b'),\n z.object({ subtract: z.tuple([FieldOrValueSchema, FieldOrValueSchema]) }).strict().describe('Subtraction: a - b'),\n z.object({ multiply: z.tuple([FieldOrValueSchema, FieldOrValueSchema]) }).strict().describe('Multiplication: a * b'),\n z.object({ divide: z.tuple([FieldOrValueSchema, FieldOrValueSchema]) }).strict().describe('Division: a / b'),\n z.object({ concat: z.array(FieldOrValueSchema).min(2) }).strict().describe('String concatenation'),\n z.object({ coalesce: z.array(FieldOrValueSchema).min(2) }).strict().describe('Returns first non-null value'),\n z.object({\n case: z\n .object({\n when: z.array(CaseWhenSchema).min(1).describe('Condition/result pairs evaluated in order'),\n else: FieldOrValueSchema.describe('Default value when no condition matches'),\n })\n .strict(),\n }).strict().describe('CASE WHEN conditional expression'),\n ])\n .describe('Computed expression: arithmetic, string, or conditional');\n\nexport type ComputeExpression = z.infer<typeof ComputeExpressionSchema>;\n","import { z } from 'zod';\nimport { ComputeExpressionSchema } from './compute.schema.js';\nimport { FieldPathSchema } from './identifier.schema.js';\n\nconst fieldPath = FieldPathSchema.describe('Field path in entity.field format');\n\n// SUM/AVG/MIN/MAX take either a field path or a compute expression — so the\n// argument can be a derived value (e.g. SUM(value * win_probability / 100)),\n// not just a column. A bare string stays valid (non-breaking).\nconst fieldOrExpr = z.union([fieldPath, ComputeExpressionSchema]).describe('A field path or a compute expression');\n\nexport const AggregateExpressionSchema = z\n .union([\n z.object({ count: z.union([FieldPathSchema, z.literal('*')]).describe('Field path or \"*\" for COUNT(*)') }).strict().describe('COUNT'),\n z.object({ countDistinct: FieldPathSchema.describe('Field path whose distinct non-null values are counted') }).strict().describe('COUNT(DISTINCT field)'),\n z.object({ sum: fieldOrExpr }).strict().describe('SUM'),\n z.object({ avg: fieldOrExpr }).strict().describe('AVG'),\n z.object({ min: fieldOrExpr }).strict().describe('MIN'),\n z.object({ max: fieldOrExpr }).strict().describe('MAX'),\n ])\n .describe('Aggregate function applied to a field or expression');\n\nexport type AggregateExpression = z.infer<typeof AggregateExpressionSchema>;\n","import { z } from 'zod';\nimport { FilterSchema } from './filter.schema.js';\nimport { ComputeExpressionSchema } from './compute.schema.js';\nimport { AggregateExpressionSchema } from './aggregate.schema.js';\nimport { FieldPathSchema, IdentifierSchema } from './identifier.schema.js';\nimport type { Filter } from './filter.schema.js';\nimport type { ComputeExpression } from './compute.schema.js';\nimport type { AggregateExpression } from './aggregate.schema.js';\n\nexport const SortEntrySchema = z\n .object({\n field: z.union([FieldPathSchema, IdentifierSchema]).describe('Field path (entity.field), computed field name, or aggregate alias'),\n dir: z.enum(['asc', 'desc']).default('asc').describe('Sort direction'),\n })\n .strict()\n .describe('Sort specification');\n\nexport type SortEntry = z.infer<typeof SortEntrySchema>;\n\nexport type Source = string | { as: string; query: Query };\n\n// A selected field: a bare `entity.field` path, or an aliased one whose output\n// key is `as` (so joined columns that would collide — three `name`s — get\n// distinct keys without a compute hack).\nexport type FieldRef = string | { field: string; as: string };\n\nexport type Query = {\n from: Source[];\n // Optional: a query may select only aggregates (e.g. a bare `COUNT(*)`); the\n // schema requires at least one of `fields` / `aggregate`.\n fields?: FieldRef[];\n filter?: Filter;\n compute?: Record<string, ComputeExpression>;\n aggregate?: Record<string, AggregateExpression>;\n groupBy?: string[];\n sort?: SortEntry[];\n limit?: number;\n distinct?: boolean;\n};\n\nconst SubquerySourceSchema = z\n .object({\n as: IdentifierSchema.describe('Alias for subquery results — use as prefix in field paths'),\n query: z.lazy((): z.ZodType<Query> => QuerySchema).describe('A nested query'),\n })\n .strict()\n .describe('Subquery data source: a nested query read as a table under `as`, its columns referenced as `<as>.<field>` anywhere in the outer query. Joined by foreign key like an entity when one links them; otherwise every outer row is paired with every subquery row (a cross join), so a one-row subquery puts its values beside each outer row.');\n\nconst SourceSchema = z\n .union([\n z.string().describe('Entity name from the database schema'),\n SubquerySourceSchema,\n ])\n .describe('Data source: entity name or subquery');\n\nconst FieldRefSchema = z\n .union([\n FieldPathSchema.describe('A column in entity.field format'),\n z\n .object({\n field: FieldPathSchema.describe('A column in entity.field format'),\n as: IdentifierSchema.describe('Output key for this column'),\n })\n .strict()\n .describe('An aliased column: output under `as` instead of the column name'),\n ])\n .describe('A selected field — a bare `entity.field`, or `{ field, as }` to alias the output key');\n\nexport const QuerySchema: z.ZodType<Query> = z.lazy(() =>\n z\n .object({\n from: z.array(SourceSchema).min(1).describe('Data sources — entity names or subqueries. Every entity used anywhere in the query must be listed here. Listed entities are JOINED FOR YOU along their foreign keys — a nullable key as a LEFT JOIN, so a row whose key is empty is kept, with the joined columns null. Never restate a join as a filter comparing the two keys: that throws those rows away.'),\n fields: z.array(FieldRefSchema).optional().describe('Raw columns to select — each `entity.field`, or `{ field, as }` to alias the output key (no SELECT *). Optional: omit it for an aggregate-only query (e.g. a bare COUNT). Do not list compute or aggregate aliases here — those are added automatically.'),\n filter: FilterSchema.optional().describe('Filter conditions'),\n compute: z.record(IdentifierSchema, ComputeExpressionSchema).optional().describe('Computed fields — key is output alias, value is the expression'),\n aggregate: z.record(IdentifierSchema, AggregateExpressionSchema).optional().describe('Aggregate functions — key is output alias, value is the function'),\n groupBy: z.array(FieldPathSchema).optional().describe('Fields to group by for aggregation'),\n sort: z.array(SortEntrySchema).optional().describe('Sort order'),\n limit: z.number().int().positive().optional().describe('Maximum rows to return'),\n distinct: z.boolean().optional().describe('Eliminate duplicate rows'),\n })\n .strict()\n .refine(\n (q) => (q.fields?.length ?? 0) > 0 || Object.keys(q.aggregate ?? {}).length > 0,\n { message: 'A query must select at least one of `fields` or `aggregate`.' },\n ),\n);\n\nexport { SubquerySourceSchema, SourceSchema };\n","import { z } from 'zod';\nimport { depthRefusal, exceedsDepth } from '@niscorp/strata';\nimport { defineTool } from '@niscorp/cortex';\nimport { QuerySchema } from '../schemas/query.schema.js';\nimport type { Query } from '../schemas/query.schema.js';\nimport type { Row } from '../adapters/adapter.types.js';\nimport type { DatabaseSchema, EntitySchema, FieldSchema } from '../schemas/database.schema.js';\nimport type { GenerationCaller } from '../types.js';\n\n// ═══════════════════════════════════════════════════════════════\n// Dependencies\n//\n// The tools hold no adapter and no policy. Everything they learn about the\n// data they learn through `read` — the engine's own pipeline, run as the\n// caller the generation is for — so a sample row, a distinct value and a\n// null count are all things that person could have read, and nothing else.\n// There is no SQL in this file.\n// ═══════════════════════════════════════════════════════════════\n\nexport type QueryToolDeps = {\n getSchema: () => DatabaseSchema | undefined;\n read: GenerationCaller['read'];\n};\n\n// ═══════════════════════════════════════════════════════════════\n// Tool input schemas + types\n// ═══════════════════════════════════════════════════════════════\n\nconst GetSchemaInputSchema = z.object({\n entities: z.array(z.string()).optional().describe('Filter to specific entity names'),\n});\nexport type GetSchemaInput = z.infer<typeof GetSchemaInputSchema>;\n\nconst GetSampleRowsInputSchema = z.object({\n entity: z.string().describe('Entity name to sample rows from'),\n limit: z.number().int().positive().max(50).optional().describe('Max rows to return (default: 5)'),\n});\nexport type GetSampleRowsInput = z.infer<typeof GetSampleRowsInputSchema>;\n\nconst GetDistinctValuesInputSchema = z.object({\n entity: z.string().describe('Entity name'),\n field: z.string().describe('Field name within the entity'),\n limit: z.number().int().positive().max(200).optional().describe('Max distinct values to return (default: 20)'),\n});\nexport type GetDistinctValuesInput = z.infer<typeof GetDistinctValuesInputSchema>;\n\nconst DescribeFieldInputSchema = z.object({\n entity: z.string().describe('Entity name'),\n field: z.string().describe('Field name within the entity'),\n});\nexport type DescribeFieldInput = z.infer<typeof DescribeFieldInputSchema>;\n\n// The draft query ITSELF at the root — no `dsl` wrapper. Models\n// naturally pass the query object directly, and a wrapper mismatch is\n// fatal on providers (Groq) that validate tool args SERVER-SIDE.\n//\n// SHALLOW: every top-level key of the query, and nothing below it. A model\n// takes a tool's parameter schema as the whole contract for its arguments —\n// qwen 3.8 27b does, and does not look the argument's shape up in the prompt\n// (measured 2026-09-27: given an empty object it sent `{}` until its step\n// limit; given `from` and `fields` it wrote only `from` and `fields`, never an\n// aggregate; given these nine keys it wrote correct aggregate + groupBy\n// queries at once). So the schema names every key a query can have. What\n// goes INSIDE each is the DSL spec's, in the prompt: the full recursive\n// schema cannot be the parameters — Groq refuses it (400, measured) — and the\n// real validation is this tool's QuerySchema safeParse, whose errors the model\n// reads and fixes. `test/agent/tools.test.ts` holds these keys to QuerySchema's.\nconst inSpec = (what: string): string => `${what} — written as the DSL spec (OUTPUT SCHEMA) says.`;\nconst TestQueryInputSchema = z\n .object({\n from: z.array(z.unknown()).describe(inSpec('The data sources: entity names (or subqueries); every entity the query uses is listed here')),\n fields: z.array(z.unknown()).optional().describe(inSpec('Raw columns to select, `entity.field` or `{ field, as }`; omit for an aggregate-only query')),\n filter: z.record(z.string(), z.unknown()).optional().describe(inSpec('Filter conditions')),\n compute: z.record(z.string(), z.unknown()).optional().describe(inSpec('Computed fields: output alias → expression')),\n aggregate: z.record(z.string(), z.unknown()).optional().describe(inSpec('Aggregates (count, sum, avg, …): output alias → function')),\n groupBy: z.array(z.unknown()).optional().describe(inSpec('Fields to group by, for aggregates')),\n sort: z.array(z.unknown()).optional().describe(inSpec('Sort order')),\n limit: z.number().optional().describe('Maximum rows to return.'),\n distinct: z.boolean().optional().describe('Eliminate duplicate rows.'),\n })\n .catchall(z.unknown())\n .describe('Your draft DSL query — the query object itself, NOT wrapped in any field.');\nexport type TestQueryInput = z.infer<typeof TestQueryInputSchema>;\n\nconst CannotSatisfyInputSchema = z.object({\n reason: z.string().describe('Why the request cannot be satisfied'),\n});\nexport type CannotSatisfyInput = z.infer<typeof CannotSatisfyInputSchema>;\n\n// ═══════════════════════════════════════════════════════════════\n// Result types\n// ═══════════════════════════════════════════════════════════════\n\ntype FieldStats = {\n type: string;\n nullable: boolean;\n cardinality: number;\n nullCount: number;\n min?: unknown;\n max?: unknown;\n};\n\ntype TestQueryResult = {\n rows: Row[];\n sql: string;\n warnings: string[];\n errors: string[];\n // On success only: what the model does now. A passing test is the moment\n // the run can end, and a model that is not told so tests the same query\n // again (measured: qwen 3.8 27b, until its stop).\n next?: string;\n};\n\nconst NEXT_AFTER_PASS =\n 'This query runs. If its rows answer the request, you are done: do not test it again — finish now with the envelope, its `data` being exactly this query. If not, change the query and test again.';\n\n// ═══════════════════════════════════════════════════════════════\n// Helpers\n// ═══════════════════════════════════════════════════════════════\n\ntype Located = { entity: EntitySchema } | { error: string };\ntype LocatedField = { entity: EntitySchema; field: FieldSchema } | { error: string };\n\n// The schema the tools are handed is already the caller's — tables their\n// policy cannot read are not in it — so \"not found\" and \"not yours\" are the\n// same answer, which is the point.\nconst locate = (deps: QueryToolDeps, entityName: string): Located => {\n const schema = deps.getSchema();\n if (schema === undefined) return { error: 'Schema not available' };\n const entity = schema.entities.find((e) => e.name === entityName);\n return entity === undefined ? { error: `Entity \"${entityName}\" not found` } : { entity };\n};\n\nconst locateField = (deps: QueryToolDeps, entityName: string, fieldName: string): LocatedField => {\n const located = locate(deps, entityName);\n if ('error' in located) return located;\n const field = located.entity.fields.find((f) => f.name === fieldName);\n return field === undefined\n ? { error: `Field \"${fieldName}\" not found on entity \"${entityName}\"` }\n : { entity: located.entity, field };\n};\n\nconst messageOf = (err: unknown): string => (err instanceof Error ? err.message : String(err));\n\n// A read that fails (a refused table, a column the grammar cannot name) is an\n// answer the model can use, not a crash of the run.\nconst attempt = async <T>(run: () => Promise<T>): Promise<T | { error: string }> => {\n try {\n return await run();\n } catch (err) {\n return { error: messageOf(err) };\n }\n};\n\nconst firstRow = (rows: Row[]): Row => rows[0] ?? {};\n\n// ═══════════════════════════════════════════════════════════════\n// Factory\n// ═══════════════════════════════════════════════════════════════\n\nexport const createQueryTools = (deps: QueryToolDeps): ReturnType<typeof defineTool>[] => {\n const getSchemaTool = defineTool({\n id: 'getSchema',\n name: 'getSchema',\n description: 'Returns the introspected database schema, optionally filtered to specific entities.',\n input: GetSchemaInputSchema,\n execute: (input: GetSchemaInput) => {\n const schema = deps.getSchema();\n if (!schema) return { error: 'Schema not available' };\n\n if (input.entities && input.entities.length > 0) {\n const filtered = {\n ...schema,\n entities: schema.entities.filter(e => input.entities?.includes(e.name)),\n };\n return JSON.stringify(filtered);\n }\n\n return JSON.stringify(schema);\n },\n });\n\n const getSampleRowsTool = defineTool({\n id: 'getSampleRows',\n name: 'getSampleRows',\n description: 'Returns sample rows from an entity table.',\n input: GetSampleRowsInputSchema,\n execute: async (input: GetSampleRowsInput) => {\n const located = locate(deps, input.entity);\n if ('error' in located) return located;\n const { entity } = located;\n // Vector columns are left out: hundreds of floats per row teach the\n // model nothing and cost the context window everything.\n const fields = entity.fields.filter((f) => f.normalizedType !== 'vector').map((f) => `${entity.name}.${f.name}`);\n const query: Query = { from: [entity.name], fields, limit: input.limit ?? 5 };\n return attempt(async () => (await deps.read(query)).rows);\n },\n });\n\n const getDistinctValuesTool = defineTool({\n id: 'getDistinctValues',\n name: 'getDistinctValues',\n description: 'Returns distinct values for a specific field in an entity.',\n input: GetDistinctValuesInputSchema,\n execute: async (input: GetDistinctValuesInput) => {\n const located = locateField(deps, input.entity, input.field);\n if ('error' in located) return located;\n const { entity, field } = located;\n const query: Query = { from: [entity.name], fields: [`${entity.name}.${field.name}`], distinct: true, limit: input.limit ?? 20 };\n return attempt(async () => (await deps.read(query)).rows.map((row) => row[field.name]));\n },\n });\n\n const describeFieldTool = defineTool({\n id: 'describeField',\n name: 'describeField',\n description: 'Returns statistics about a field: type, nullable, cardinality, null count, min/max for numeric/date types.',\n input: DescribeFieldInputSchema,\n execute: async (input: DescribeFieldInput) => {\n const located = locateField(deps, input.entity, input.field);\n if ('error' in located) return located;\n const { entity, field } = located;\n const path = `${entity.name}.${field.name}`;\n const isNumericOrDate = ['number', 'date', 'timestamp'].includes(field.normalizedType);\n\n return attempt(async (): Promise<FieldStats> => {\n const [counted, nulls, range] = await Promise.all([\n deps.read({ from: [entity.name], aggregate: { cardinality: { countDistinct: path } } }),\n deps.read({ from: [entity.name], aggregate: { null_count: { count: '*' } }, filter: { isNull: path } }),\n isNumericOrDate\n ? deps.read({ from: [entity.name], aggregate: { min_val: { min: path }, max_val: { max: path } } })\n : Promise.resolve(undefined),\n ]);\n\n const stats: FieldStats = {\n type: field.normalizedType,\n nullable: field.nullable,\n cardinality: Number(firstRow(counted.rows)['cardinality'] ?? 0),\n nullCount: Number(firstRow(nulls.rows)['null_count'] ?? 0),\n };\n if (range !== undefined) {\n stats.min = firstRow(range.rows)['min_val'];\n stats.max = firstRow(range.rows)['max_val'];\n }\n return stats;\n });\n },\n });\n\n const testQueryTool = defineTool({\n id: 'testQuery',\n name: 'testQuery',\n description:\n 'Validates a DSL query, compiles it to SQL, and executes it with synthetic parameters (LIMIT 5). ' +\n 'Pass the query object DIRECTLY as the arguments. Returns rows, SQL, warnings, and errors.',\n input: TestQueryInputSchema,\n execute: async (input: TestQueryInput): Promise<TestQueryResult> => {\n if (exceedsDepth(input)) return { rows: [], sql: '', warnings: [], errors: [depthRefusal()] };\n const parseResult = QuerySchema.safeParse(input);\n if (!parseResult.success) {\n const validationErrors = parseResult.error.issues.map(\n issue => `${issue.path.join('.')}: ${issue.message}`,\n );\n return { rows: [], sql: '', warnings: [], errors: validationErrors };\n }\n\n try {\n const { rows, sql, warnings } = await deps.read({ ...parseResult.data, limit: 5 });\n return { rows, sql, warnings, errors: [], next: NEXT_AFTER_PASS };\n } catch (err: unknown) {\n return { rows: [], sql: '', warnings: [], errors: [messageOf(err)] };\n }\n },\n });\n\n // The caller (createQueryDsl) watches for this tool's observation on\n // the run's event stream and aborts the run with the reason — the\n // v2 replacement for the v1 bus-emit + abort-rule pair.\n const cannotSatisfyTool = defineTool({\n id: 'cannotSatisfy',\n name: 'cannotSatisfy',\n description: 'Signal that the natural language request cannot be satisfied by the available schema. This ends the run.',\n input: CannotSatisfyInputSchema,\n execute: (input: CannotSatisfyInput) => ({ acknowledged: true, reason: input.reason }),\n });\n\n return [\n getSchemaTool,\n getSampleRowsTool,\n getDistinctValuesTool,\n describeFieldTool,\n testQueryTool,\n cannotSatisfyTool,\n ];\n};\n","import { defineAgent } from '@niscorp/cortex';\nimport type { AgentDefinition } from '@niscorp/cortex';\nimport { stepCount, outputRetries, repeatedCalls } from '@niscorp/cortex';\nimport { QuerySchema } from '../schemas/query.schema.js';\nimport type { Query } from '../schemas/query.schema.js';\nimport type { ScopeBinding } from '../types.js';\n\n// Per-invocation deps: the introspected database schema and the DSL\n// JSON Schema arrive per call (they vary with adapter and scope), so\n// they are context-function inputs — the agent itself is defined once.\nexport type VexQueryDeps = {\n schemaJson: string;\n dslSpecJson: string;\n // Who the caller is, in the schema's terms (describeCaller). Absent — a run\n // built without it — reads as a caller nothing identifies.\n caller?: string;\n};\n\n// WHO THE CALLER IS, for the agent: the columns their scope keys are bound to\n// (GenerationCaller.bindings) — the keys and the columns, never a value. With\n// none, the agent is told plainly that nothing here identifies them, so a\n// question about \"me\" is refused for the right reason rather than guessed at.\nexport const describeCaller = (bindings: readonly ScopeBinding[]): string =>\n bindings.length === 0\n ? 'The caller: no column in this schema is bound to anything that identifies the caller, so a request about \"me\", \"my\" or \"mine\" cannot be answered.'\n : [\n 'The caller — the person or service this query is for — is identified by server-side scope values bound to these columns:',\n ...bindings.map((b) => `- ${b.entity}.${b.field} is the caller's { \"$scope\": \"${b.key}\" }`),\n 'Such a column holds that value on the caller\\'s own rows. To mean the caller or what is theirs (\"me\", \"my\", \"mine\", \"our\"), filter the column with { \"$scope\": \"<key>\" } — the server binds the caller\\'s own value; you never see or write it.',\n ].join('\\n');\n\nconst INSTRUCTIONS = `You are Vex's query agent. You turn a caller's request — a natural-language \\`intent\\` and an example \\`shape\\` of the data they want back — into ONE query in Vex's DSL.\n\nContext gives you two things:\n- the database schema: the entities, fields, relations, and indexes that actually exist;\n- the DSL JSON Schema: the exact structure your query must take. Its field\n descriptions ARE the rules — read them and follow them. They are the single\n source of truth for how every part of a query is written.\n\nYour job is to RETRIEVE the data the request needs: choose the entities, columns,\nfilters, computed values, and aggregates the schema supports. A separate step runs\nafter you and reshapes, nests, combines and formats the rows, so you never nest.\nBut when a key of the shape is exactly ONE column or ONE aggregate, alias it to\nthat key (\\`{ \"field\": …, \"as\": \"<key>\" }\\`, or name the aggregate after the key):\nwhen every row already has exactly the shape's keys, that later step is skipped.\nA key that needs combining or formatting (a full name from two columns, a date\nwritten out) you leave to it — select the underlying columns under their own names.\n\nWork this way, every time:\n1. If you are unsure what exists or what values a field holds, inspect it with\n your tools before drafting.\n2. Draft the query.\n3. Call testQuery on the draft. You may NOT finish until testQuery has succeeded.\n If it returns an error, your query is wrong — read the error, fix the query,\n and call testQuery again. Repeat until it passes.\n4. Finish. Your envelope's \\`data\\` is the EXACT query that passed\n testQuery (optionally a one-line \\`reasoning\\`).\n5. If the request genuinely cannot be answered from the schema, call\n cannotSatisfy with a short reason instead of guessing.\n\nWorked example (illustrative — real entities and rules come from the schema):\nintent: \"each customer's contact line and how much they've spent, biggest first\"\nshape: [{ \"contact\": \"\", \"spent\": 0 }]\ndata: {\"from\":[\"customer\"],\"fields\":[\"customer.name\",\"customer.email\",{\"field\":\"customer.total_spent\",\"as\":\"spent\"}],\"sort\":[{\"field\":\"customer.total_spent\",\"dir\":\"desc\"}]}\n(\\`spent\\` is one column, so it is aliased; \\`contact\\` combines two, so they are selected as they are.)`;\n\nexport const vexQueryDslAgent: AgentDefinition<Query, VexQueryDeps> = defineAgent<Query, VexQueryDeps>({\n id: 'vex.query',\n description: 'Generates DSL queries from natural language intent and target shape.',\n instructions: INSTRUCTIONS,\n context: [\n ({ deps }) => `Database schema:\\n${deps.schemaJson}`,\n ({ deps }) => deps.caller ?? describeCaller([]),\n // Named OUTPUT SCHEMA because that is what the finish protocol refers to:\n // the query this agent returns is the envelope's `data`.\n ({ deps }) => `OUTPUT SCHEMA — the DSL specification (JSON Schema), the single source of truth for your query:\\n${deps.dslSpecJson}`,\n ],\n // The DSL spec above IS the schema documentation; don't inject it twice.\n output: { schema: QuerySchema, doc: 'off' },\n // Three identical testQuery calls with the same error in a row is a model\n // not reading the error; a fourth would cost a full prompt and change nothing.\n stopWhen: [stepCount(20), outputRetries(3), repeatedCalls(2)],\n});\n","import type { RunHandle } from '@niscorp/cortex';\nimport { VexError } from '../errors.js';\nimport { mappingAgent } from '@niscorp/prism/agent';\nimport { compile, execute } from '@niscorp/prism';\nimport type { JsonObject } from '@niscorp/prism';\nimport { createQueryTools } from './tools.js';\nimport { describeCaller, vexQueryDslAgent } from './query.agent.js';\nimport type { Query } from '../schemas/query.schema.js';\nimport type { GenerateDsl, MapToShape } from '../types.js';\nimport type { SignalClient } from '@niscorp/cortex';\n\n// ═══════════════════════════════════════════════════════════════\n// Re-exports\n// ═══════════════════════════════════════════════════════════════\n\nexport { vexQueryDslAgent, describeCaller } from './query.agent.js';\nexport type { VexQueryDeps } from './query.agent.js';\nexport { createQueryTools } from './tools.js';\nexport type { QueryToolDeps } from './tools.js';\n\n// ═══════════════════════════════════════════════════════════════\n// generateDsl hook factory — runs vexQueryDslAgent\n// ═══════════════════════════════════════════════════════════════\n\n// What the agent is built from. Who it runs FOR is not here: the engine hands\n// every generation its caller (a `read` capability under that caller's policy\n// and scope) and the schema that caller may see, so one hook serves every\n// principal and cannot be built with the wrong one baked in.\nexport type QueryDslConfig = {\n llm: SignalClient;\n queryJsonSchema: object;\n};\n\nconst reasonFrom = (args: unknown): string | undefined => {\n if (typeof args !== 'object' || args === null) return undefined;\n const reason = (args as Record<string, unknown>)['reason'];\n return typeof reason === 'string' ? reason : undefined;\n};\n\nexport const createQueryDsl = (config: QueryDslConfig): GenerateDsl => {\n return async (request, schema, caller) => {\n const tools = createQueryTools({ getSchema: () => schema, read: caller.read });\n\n const agentInput = {\n intent: request.intent,\n shape: request.shape,\n contextKeys: Object.keys(request.context),\n };\n\n // The agent signals \"cannot satisfy\" by calling its cannotSatisfy\n // tool. We watch the run's event stream for that observation,\n // capture the reason, and abort — distinguishing a real\n // unsatisfiable result (worth negative-caching) from a transient\n // failure.\n let unsatisfiableReason: string | undefined;\n let run: RunHandle<Query> | undefined;\n run = vexQueryDslAgent.run(agentInput, {\n llm: config.llm,\n deps: {\n schemaJson: JSON.stringify(schema),\n dslSpecJson: JSON.stringify(config.queryJsonSchema),\n caller: describeCaller(caller.bindings),\n },\n tools,\n onEvent: (event) => {\n if (\n event.type === 'tool-end' &&\n event.observation.kind === 'result' &&\n event.observation.toolId === 'cannotSatisfy'\n ) {\n unsatisfiableReason = reasonFrom(event.observation.args) ?? 'request cannot be satisfied';\n run?.abort();\n }\n },\n });\n\n const result = await run.result;\n if (!result.ok) {\n if (unsatisfiableReason !== undefined) {\n throw new VexError('unsatisfiable', unsatisfiableReason);\n }\n throw new VexError('agent_failed', `${result.error.code}: ${result.error.message}`);\n }\n return result.output.data;\n };\n};\n\n// ═══════════════════════════════════════════════════════════════\n// mapToShape hook factory — runs Prism's mappingAgent\n//\n// The mapping runs ONCE over { result }, and its output IS the result (array /\n// object / scalar). An array shape puts the rows in $.result; an object shape\n// puts the single (first) row there. The envelope here must match the\n// runtime's cache-hit path (engine/runtime.ts), which replays the cached IR against the same envelope. Keep them in lockstep.\n//\n// NOTE: for the agent to actually author a whole-set mapping (a `$map` over\n// `$.result` for arrays), its instructions must teach that — tracked as a\n// follow-up. Canned/relay paths use a hand-authored, seeded IR and are correct\n// today; this affects only live generation.\n// ═══════════════════════════════════════════════════════════════\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> =>\n typeof value === 'object' && value !== null && !Array.isArray(value);\n\n// ROWS THAT ARE ALREADY THE SHAPE need no mapping. True only when the shape is\n// flat (every value a scalar example) and the first row has EXACTLY the\n// shape's keys — nothing extra, nothing missing — each holding the kind of\n// value the shape shows (or null). The query agent aliases its columns to a\n// flat shape's keys for exactly this reason. Anything else — a nested shape, a\n// renamed or extra column, a count that came back as text — goes to the\n// mapping agent. No rows is not a fit: there is nothing to prove the columns\n// by, and the IR minted here is replayed later against rows that exist.\nexport const rowsFitShape = (rows: readonly Record<string, unknown>[], shape: unknown): boolean => {\n const example = Array.isArray(shape) ? shape[0] : shape;\n const first = rows[0];\n if (!isPlainObject(example) || first === undefined) return false;\n const keys = Object.keys(example);\n if (keys.length !== Object.keys(first).length) return false;\n return keys.every((key) => {\n const sample = example[key];\n if (typeof sample === 'object' && sample !== null) return false;\n if (!(key in first)) return false;\n const value = first[key];\n return value === null || typeof value === typeof sample;\n });\n};\n\n// The identity mapping over the envelope — what a fitting row set replays as.\nconst IDENTITY = { $ref: '$.result' };\n\nexport const createShapeMapper = (llm: SignalClient): MapToShape => {\n return async (rows, shape) => {\n // Array shape → map the whole set; a non-array shape → map the single\n // (first) row. The envelope here must match the runtime's (engine/runtime.ts).\n const single = !Array.isArray(shape);\n const envelope = { result: single ? (rows[0] ?? null) : rows } as unknown as JsonObject;\n\n // Already the shape: the identity, with no model call.\n if (rowsFitShape(rows, shape)) {\n const ir = await compile(IDENTITY);\n return { ir, transformed: execute(ir, envelope) };\n }\n\n const result = await mappingAgent.run(\n { sampleInput: envelope, targetShape: shape },\n { llm },\n ).result;\n\n if (!result.ok) throw new VexError('agent_failed', `${result.error.code}: ${result.error.message}`);\n\n const ir = await compile(result.output.data);\n const transformed = execute(ir, envelope);\n return { ir, transformed };\n };\n};\n"]}
1
+ {"version":3,"sources":["../../src/errors.ts","../../src/schemas/value.schema.ts","../../src/schemas/identifier.schema.ts","../../src/schemas/filter.schema.ts","../../src/schemas/compute.schema.ts","../../src/schemas/aggregate.schema.ts","../../src/schemas/query.schema.ts","../../src/agent/tools.ts","../../src/agent/query.agent.ts","../../src/agent/index.ts"],"names":["z","defineTool","exceedsDepth","depthRefusal","defineAgent","stepCount","outputRetries","repeatedCalls","ir","compile","execute","mappingAgent"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { QueryErrorCode } from './schemas/request.schema.js';\n\n// ONE CLASS, SEVERAL COPIES. The CommonJS build gives each entry point\n// (`@niscorp/vex`, `/hono`, `/express`, `/agent`) its own copy of this class,\n// and an app can load the ESM and CommonJS builds side by side — so an error\n// thrown by an engine from one entry is not an `instanceof` the VexError\n// another entry holds. Every copy puts the same mark on its prototype, under a\n// key the whole process shares, and `isVexError` reads the mark. Wherever vex\n// itself asks \"is this one of ours\", it asks that, never `instanceof`.\nconst VEX_ERROR = Symbol.for('@niscorp/vex:VexError');\n\nexport class VexError extends Error {\n readonly code: QueryErrorCode;\n readonly details?: Record<string, unknown>;\n\n constructor(code: QueryErrorCode, message: string, details?: Record<string, unknown>) {\n super(message);\n this.name = 'VexError';\n this.code = code;\n this.details = details;\n }\n}\n\n// On the prototype, not the instance: a subclass inherits it, and nothing an\n// app prints, serializes or enumerates on an error changes.\nObject.defineProperty(VexError.prototype, VEX_ERROR, { value: true });\n\nexport const isVexError = (err: unknown): err is VexError =>\n err instanceof VexError || (err instanceof Error && Reflect.get(err, VEX_ERROR) === true);\n","import { z } from 'zod';\n\nexport const ContextRefSchema = z\n .object({\n $context: z.string().describe('Key to look up in the request context object'),\n })\n .strict()\n .describe('Reference to a caller-provided context value');\n\nexport const ScopeRefSchema = z\n .object({\n $scope: z.string().describe('Key to look up in the server-side scope values'),\n })\n .strict()\n .describe('Reference to a server-injected scope value (access control)');\n\nexport const FieldOrValueSchema = z\n .union([\n z.string().describe('A field path (entity.field format) or a literal string'),\n z.number().describe('A literal number'),\n z.boolean().describe('A literal boolean'),\n z.null().describe('A literal null'),\n ContextRefSchema,\n ScopeRefSchema,\n ])\n .describe('A field path, literal value, or dynamic reference');\n\nexport type ContextRef = z.infer<typeof ContextRefSchema>;\nexport type ScopeRef = z.infer<typeof ScopeRefSchema>;\nexport type FieldOrValue = z.infer<typeof FieldOrValueSchema>;\n","import { z } from 'zod';\n\n// ═══════════════════════════════════════════════════════════════\n// THE NAMES A QUERY MAY SAY — and the one rule for telling them apart.\n//\n// Every string an author (a person, a seed, a model) puts in a NAME position\n// ends up in SQL text: a column reference, an output alias, a subquery alias.\n// Values never do — they bind as parameters or are quoted as literals. So a\n// name is the only place authored text meets the statement, and it is held to\n// a grammar that cannot carry anything but a name: letters, digits and\n// underscores, not starting with a digit.\n//\n// This is the parse-time half. The resolver checks the same predicates again,\n// because `engine.compile()` and `engine.test()` take a DSL that never went\n// through Zod, and the compiler refuses to emit a field position that did not\n// resolve against the introspected schema. Three layers, one grammar.\n//\n// `isFieldPathShape` is also what decides, in a value position, whether a\n// string is a column or a literal. It used to be \"contains a dot\", which made\n// every email address an unknown entity and every string with a dot a column\n// reference — so a literal like \"u1@x.com\" threw, and a string that merely\n// looked dotted went to SQL as a name. Now a column is exactly `ident.ident`,\n// and everything else is a literal.\n// ═══════════════════════════════════════════════════════════════\n\nconst IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;\nconst FIELD_PATH = /^[A-Za-z_][A-Za-z0-9_]*\\.[A-Za-z_][A-Za-z0-9_]*$/;\n\nexport const isIdentifier = (value: string): boolean => IDENTIFIER.test(value);\n\nexport const isFieldPathShape = (value: unknown): value is string => typeof value === 'string' && FIELD_PATH.test(value);\n\nexport const IdentifierSchema = z\n .string()\n .regex(IDENTIFIER, 'A name is letters, digits and underscores, not starting with a digit');\n\nexport const FieldPathSchema = z\n .string()\n .regex(FIELD_PATH, 'A field path is entity.field — each part letters, digits and underscores, not starting with a digit');\n","import { z } from 'zod';\nimport { ContextRefSchema, ScopeRefSchema, FieldOrValueSchema } from './value.schema.js';\nimport { FieldPathSchema } from './identifier.schema.js';\nimport type { ContextRef, ScopeRef, FieldOrValue } from './value.schema.js';\n\n// EXISTS — \"is there a row over there that points back at this one\".\n//\n// It is the same `{ from, filter }` a query already is, and deliberately no\n// more than that: no fields, no sort, no limit, nothing to select. EXISTS asks\n// whether a row is there, so anything that shapes output would be noise the\n// planner discards, and refusing it is what keeps this an operator rather than\n// an invitation to nest arbitrary SQL.\n//\n// The CORRELATION needs no new vocabulary. A dotted string on either side of a\n// comparison is already a field path, so pointing the inner table at the outer\n// one is an ordinary `eq` between two columns:\n//\n// { exists: { from: ['tasks'], filter: { eq: ['tasks.issue_id', 'issues.id'] } } }\n//\n// and `not` composes for NOT EXISTS. Whoever writes SQL writes this on the\n// first try, which is the entire design goal.\nexport type ExistsQuery = {\n from: string[];\n filter?: Filter;\n};\n\nexport type Filter =\n | { exists: ExistsQuery }\n | { eq: [FieldOrValue, FieldOrValue] }\n | { neq: [FieldOrValue, FieldOrValue] }\n | { gt: [FieldOrValue, FieldOrValue] }\n | { gte: [FieldOrValue, FieldOrValue] }\n | { lt: [FieldOrValue, FieldOrValue] }\n | { lte: [FieldOrValue, FieldOrValue] }\n | { in: [string, FieldOrValue[] | ContextRef | ScopeRef] }\n | { notIn: [string, FieldOrValue[] | ContextRef | ScopeRef] }\n | { like: [string, FieldOrValue] }\n | { ilike: [string, FieldOrValue] }\n | { isNull: string }\n | { isNotNull: string }\n | { and: Filter[] }\n | { or: Filter[] }\n | { not: Filter }\n | { semantic: { field: string; query: ContextRef | ScopeRef; minScore?: number } }\n | { fuzzy: { field: string; query: ContextRef | ScopeRef; maxDistance?: number } }\n | { optional: { key: string | string[]; then: Filter } };\n\nconst comparisonPair = z\n .tuple([FieldOrValueSchema, FieldOrValueSchema])\n .describe('[left, right] — both can be field paths, literals, or references');\n\nconst fieldString = FieldPathSchema.describe('Field path in entity.field format');\n\nconst collectionTarget = z\n .union([\n z.array(FieldOrValueSchema).min(1).describe('Array of literal values or references'),\n ContextRefSchema,\n ScopeRefSchema,\n ])\n .describe('A set of values or a reference that resolves to an array');\n\nconst ExistsSchema: z.ZodType<ExistsQuery> = z.lazy(() =>\n z\n .object({\n from: z.array(z.string()).min(1).describe('Entities the subquery reads. Joined by foreign key like any other from.'),\n filter: FilterSchema.optional().describe('The correlation, and any extra condition. Reference the outer query by its own entity path: { eq: [\"<inner>.<fk>\", \"<outer>.id\"] }.'),\n })\n .strict(),\n);\n\nexport const FilterSchema: z.ZodType<Filter> = z.lazy(() =>\n z.union([\n z.object({ exists: ExistsSchema }).strict().describe('EXISTS: true when the subquery matches at least one row. Wrap in `not` for NOT EXISTS.'),\n z.object({ eq: comparisonPair }).strict().describe('Equals: tests equality between two values'),\n z.object({ neq: comparisonPair }).strict().describe('Not equals'),\n z.object({ gt: comparisonPair }).strict().describe('Greater than'),\n z.object({ gte: comparisonPair }).strict().describe('Greater than or equal'),\n z.object({ lt: comparisonPair }).strict().describe('Less than'),\n z.object({ lte: comparisonPair }).strict().describe('Less than or equal'),\n z.object({ in: z.tuple([fieldString, collectionTarget]) }).strict().describe('Field value is in a set'),\n z.object({ notIn: z.tuple([fieldString, collectionTarget]) }).strict().describe('Field value is not in a set'),\n z.object({ like: z.tuple([fieldString, FieldOrValueSchema]) }).strict().describe('Case-sensitive LIKE pattern match (use % as wildcard)'),\n z.object({ ilike: z.tuple([fieldString, FieldOrValueSchema]) }).strict().describe('Case-insensitive ILIKE pattern match (use % as wildcard)'),\n z.object({ isNull: fieldString }).strict().describe('Field value is NULL'),\n z.object({ isNotNull: fieldString }).strict().describe('Field value is NOT NULL'),\n z.object({ and: z.array(FilterSchema).min(2) }).strict().describe('Logical AND: all conditions must be true'),\n z.object({ or: z.array(FilterSchema).min(2) }).strict().describe('Logical OR: at least one condition must be true'),\n z.object({ not: FilterSchema }).strict().describe('Logical NOT: negates the condition'),\n z.object({\n semantic: z.object({\n field: FieldPathSchema.describe('Vector column field path (entity.field)'),\n query: z.union([ContextRefSchema, ScopeRefSchema]).describe('Text to embed and compare'),\n minScore: z.number().min(0).max(1).optional().describe('Minimum cosine similarity (0–1)'),\n }).strict(),\n }).strict().describe('Semantic vector similarity search'),\n z.object({\n fuzzy: z.object({\n field: FieldPathSchema.describe('String field path'),\n query: z.union([ContextRefSchema, ScopeRefSchema]).describe('Text to fuzzy-match'),\n maxDistance: z.number().int().nonnegative().optional().describe('Maximum Levenshtein edit distance'),\n }).strict(),\n }).strict().describe('Fuzzy string match'),\n z.object({\n optional: z.object({\n key: z.union([z.string().min(1), z.array(z.string().min(1)).min(1)])\n .describe('The context key this condition depends on, or EVERY key it depends on. A condition referencing two keys must name both — gating on one leaves the other conditionally required, which surfaces as an empty result rather than as a condition that did not apply.'),\n // BARE, never `.describe()`d. That call CLONES the schema, and zod\n // detects a recursive reference by instance identity — a clone is a\n // different instance, so `to-json-schema` stops seeing the cycle and\n // expands the filter union into itself until the stack goes. Every\n // other recursive slot here (`not`, `and`, `or`) uses it bare for the\n // same reason; the description belongs on the wrapper below.\n then: FilterSchema,\n }).strict(),\n }).strict().describe(\n 'A condition the caller turns on by supplying context keys. When any named key is absent the condition is REMOVED from the query before it compiles — it does not match everything, it is not there. Absent means missing, undefined or null; \"\" is a value and keeps the condition. Direction follows position: under `and` supplying the key NARROWS, under `or` it WIDENS. Either way an absent key reads exactly as if the condition had never been written, and scope is injected afterwards regardless. Reads only: a mutation may not contain one, and neither may the inside of an `exists` (its correlation must be unconditional).',\n ),\n ]),\n);\n","import { z } from 'zod';\nimport { FieldOrValueSchema } from './value.schema.js';\nimport { FilterSchema } from './filter.schema.js';\n\nconst CaseWhenSchema = z\n .object({\n condition: FilterSchema,\n then: FieldOrValueSchema.describe('Value when condition is true'),\n })\n .strict();\n\nexport const ComputeExpressionSchema = z\n .union([\n z.object({ add: z.tuple([FieldOrValueSchema, FieldOrValueSchema]) }).strict().describe('Addition: a + b'),\n z.object({ subtract: z.tuple([FieldOrValueSchema, FieldOrValueSchema]) }).strict().describe('Subtraction: a - b'),\n z.object({ multiply: z.tuple([FieldOrValueSchema, FieldOrValueSchema]) }).strict().describe('Multiplication: a * b'),\n z.object({ divide: z.tuple([FieldOrValueSchema, FieldOrValueSchema]) }).strict().describe('Division: a / b'),\n z.object({ concat: z.array(FieldOrValueSchema).min(2) }).strict().describe('String concatenation'),\n z.object({ coalesce: z.array(FieldOrValueSchema).min(2) }).strict().describe('Returns first non-null value'),\n z.object({\n case: z\n .object({\n when: z.array(CaseWhenSchema).min(1).describe('Condition/result pairs evaluated in order'),\n else: FieldOrValueSchema.describe('Default value when no condition matches'),\n })\n .strict(),\n }).strict().describe('CASE WHEN conditional expression'),\n ])\n .describe('Computed expression: arithmetic, string, or conditional');\n\nexport type ComputeExpression = z.infer<typeof ComputeExpressionSchema>;\n","import { z } from 'zod';\nimport { ComputeExpressionSchema } from './compute.schema.js';\nimport { FieldPathSchema } from './identifier.schema.js';\n\nconst fieldPath = FieldPathSchema.describe('Field path in entity.field format');\n\n// SUM/AVG/MIN/MAX take either a field path or a compute expression — so the\n// argument can be a derived value (e.g. SUM(value * win_probability / 100)),\n// not just a column. A bare string stays valid (non-breaking).\nconst fieldOrExpr = z.union([fieldPath, ComputeExpressionSchema]).describe('A field path or a compute expression');\n\nexport const AggregateExpressionSchema = z\n .union([\n z.object({ count: z.union([FieldPathSchema, z.literal('*')]).describe('Field path or \"*\" for COUNT(*)') }).strict().describe('COUNT'),\n z.object({ countDistinct: FieldPathSchema.describe('Field path whose distinct non-null values are counted') }).strict().describe('COUNT(DISTINCT field)'),\n z.object({ sum: fieldOrExpr }).strict().describe('SUM'),\n z.object({ avg: fieldOrExpr }).strict().describe('AVG'),\n z.object({ min: fieldOrExpr }).strict().describe('MIN'),\n z.object({ max: fieldOrExpr }).strict().describe('MAX'),\n ])\n .describe('Aggregate function applied to a field or expression');\n\nexport type AggregateExpression = z.infer<typeof AggregateExpressionSchema>;\n","import { z } from 'zod';\nimport { FilterSchema } from './filter.schema.js';\nimport { ComputeExpressionSchema } from './compute.schema.js';\nimport { AggregateExpressionSchema } from './aggregate.schema.js';\nimport { FieldPathSchema, IdentifierSchema } from './identifier.schema.js';\nimport type { Filter } from './filter.schema.js';\nimport type { ComputeExpression } from './compute.schema.js';\nimport type { AggregateExpression } from './aggregate.schema.js';\n\nexport const SortEntrySchema = z\n .object({\n field: z.union([FieldPathSchema, IdentifierSchema]).describe('Field path (entity.field), computed field name, or aggregate alias'),\n dir: z.enum(['asc', 'desc']).default('asc').describe('Sort direction'),\n })\n .strict()\n .describe('Sort specification');\n\nexport type SortEntry = z.infer<typeof SortEntrySchema>;\n\nexport type Source = string | { as: string; query: Query };\n\n// A selected field: a bare `entity.field` path, or an aliased one whose output\n// key is `as` (so joined columns that would collide — three `name`s — get\n// distinct keys without a compute hack).\nexport type FieldRef = string | { field: string; as: string };\n\nexport type Query = {\n from: Source[];\n // Optional: a query may select only aggregates (e.g. a bare `COUNT(*)`); the\n // schema requires at least one of `fields` / `aggregate`.\n fields?: FieldRef[];\n filter?: Filter;\n compute?: Record<string, ComputeExpression>;\n aggregate?: Record<string, AggregateExpression>;\n groupBy?: string[];\n sort?: SortEntry[];\n limit?: number;\n distinct?: boolean;\n};\n\nconst SubquerySourceSchema = z\n .object({\n as: IdentifierSchema.describe('Alias for subquery results — use as prefix in field paths'),\n query: z.lazy((): z.ZodType<Query> => QuerySchema).describe('A nested query'),\n })\n .strict()\n .describe('Subquery data source: a nested query read as a table under `as`, its columns referenced as `<as>.<field>` anywhere in the outer query. Joined by foreign key like an entity when one links them; otherwise every outer row is paired with every subquery row (a cross join), so a one-row subquery puts its values beside each outer row.');\n\nconst SourceSchema = z\n .union([\n z.string().describe('Entity name from the database schema'),\n SubquerySourceSchema,\n ])\n .describe('Data source: entity name or subquery');\n\nconst FieldRefSchema = z\n .union([\n FieldPathSchema.describe('A column in entity.field format'),\n z\n .object({\n field: FieldPathSchema.describe('A column in entity.field format'),\n as: IdentifierSchema.describe('Output key for this column'),\n })\n .strict()\n .describe('An aliased column: output under `as` instead of the column name'),\n ])\n .describe('A selected field — a bare `entity.field`, or `{ field, as }` to alias the output key');\n\nexport const QuerySchema: z.ZodType<Query> = z.lazy(() =>\n z\n .object({\n from: z.array(SourceSchema).min(1).describe('Data sources — entity names or subqueries. Every entity used anywhere in the query must be listed here. Listed entities are JOINED FOR YOU along their foreign keys — a nullable key as a LEFT JOIN, so a row whose key is empty is kept, with the joined columns null. Never restate a join as a filter comparing the two keys: that throws those rows away.'),\n fields: z.array(FieldRefSchema).optional().describe('Raw columns to select — each `entity.field`, or `{ field, as }` to alias the output key (no SELECT *). Optional: omit it for an aggregate-only query (e.g. a bare COUNT). Do not list compute or aggregate aliases here — those are added automatically.'),\n filter: FilterSchema.optional().describe('Filter conditions'),\n compute: z.record(IdentifierSchema, ComputeExpressionSchema).optional().describe('Computed fields — key is output alias, value is the expression'),\n aggregate: z.record(IdentifierSchema, AggregateExpressionSchema).optional().describe('Aggregate functions — key is output alias, value is the function'),\n groupBy: z.array(FieldPathSchema).optional().describe('Fields to group by for aggregation'),\n sort: z.array(SortEntrySchema).optional().describe('Sort order'),\n limit: z.number().int().positive().optional().describe('Maximum rows to return'),\n distinct: z.boolean().optional().describe('Eliminate duplicate rows'),\n })\n .strict()\n .refine(\n (q) => (q.fields?.length ?? 0) > 0 || Object.keys(q.aggregate ?? {}).length > 0,\n { message: 'A query must select at least one of `fields` or `aggregate`.' },\n ),\n);\n\nexport { SubquerySourceSchema, SourceSchema };\n","import { z } from 'zod';\nimport { depthRefusal, exceedsDepth } from '@niscorp/strata';\nimport { defineTool } from '@niscorp/cortex';\nimport { QuerySchema } from '../schemas/query.schema.js';\nimport type { Query } from '../schemas/query.schema.js';\nimport type { Row } from '../adapters/adapter.types.js';\nimport type { DatabaseSchema, EntitySchema, FieldSchema } from '../schemas/database.schema.js';\nimport type { GenerationCaller } from '../types.js';\n\n// ═══════════════════════════════════════════════════════════════\n// Dependencies\n//\n// The tools hold no adapter and no policy. Everything they learn about the\n// data they learn through `read` — the engine's own pipeline, run as the\n// caller the generation is for — so a sample row, a distinct value and a\n// null count are all things that person could have read, and nothing else.\n// There is no SQL in this file.\n// ═══════════════════════════════════════════════════════════════\n\nexport type QueryToolDeps = {\n getSchema: () => DatabaseSchema | undefined;\n read: GenerationCaller['read'];\n};\n\n// ═══════════════════════════════════════════════════════════════\n// Tool input schemas + types\n// ═══════════════════════════════════════════════════════════════\n\nconst GetSchemaInputSchema = z.object({\n entities: z.array(z.string()).optional().describe('Filter to specific entity names'),\n});\nexport type GetSchemaInput = z.infer<typeof GetSchemaInputSchema>;\n\nconst GetSampleRowsInputSchema = z.object({\n entity: z.string().describe('Entity name to sample rows from'),\n limit: z.number().int().positive().max(50).optional().describe('Max rows to return (default: 5)'),\n});\nexport type GetSampleRowsInput = z.infer<typeof GetSampleRowsInputSchema>;\n\nconst GetDistinctValuesInputSchema = z.object({\n entity: z.string().describe('Entity name'),\n field: z.string().describe('Field name within the entity'),\n limit: z.number().int().positive().max(200).optional().describe('Max distinct values to return (default: 20)'),\n});\nexport type GetDistinctValuesInput = z.infer<typeof GetDistinctValuesInputSchema>;\n\nconst DescribeFieldInputSchema = z.object({\n entity: z.string().describe('Entity name'),\n field: z.string().describe('Field name within the entity'),\n});\nexport type DescribeFieldInput = z.infer<typeof DescribeFieldInputSchema>;\n\n// The draft query ITSELF at the root — no `dsl` wrapper. Models\n// naturally pass the query object directly, and a wrapper mismatch is\n// fatal on providers (Groq) that validate tool args SERVER-SIDE.\n//\n// SHALLOW: every top-level key of the query, and nothing below it. A model\n// takes a tool's parameter schema as the whole contract for its arguments —\n// qwen 3.8 27b does, and does not look the argument's shape up in the prompt\n// (measured 2026-09-27: given an empty object it sent `{}` until its step\n// limit; given `from` and `fields` it wrote only `from` and `fields`, never an\n// aggregate; given these nine keys it wrote correct aggregate + groupBy\n// queries at once). So the schema names every key a query can have. What\n// goes INSIDE each is the DSL spec's, in the prompt: the full recursive\n// schema cannot be the parameters — Groq refuses it (400, measured) — and the\n// real validation is this tool's QuerySchema safeParse, whose errors the model\n// reads and fixes. `test/agent/tools.test.ts` holds these keys to QuerySchema's.\nconst inSpec = (what: string): string => `${what} — written as the DSL spec (OUTPUT SCHEMA) says.`;\nconst TestQueryInputSchema = z\n .object({\n from: z.array(z.unknown()).describe(inSpec('The data sources: entity names (or subqueries); every entity the query uses is listed here')),\n fields: z.array(z.unknown()).optional().describe(inSpec('Raw columns to select, `entity.field` or `{ field, as }`; omit for an aggregate-only query')),\n filter: z.record(z.string(), z.unknown()).optional().describe(inSpec('Filter conditions')),\n compute: z.record(z.string(), z.unknown()).optional().describe(inSpec('Computed fields: output alias → expression')),\n aggregate: z.record(z.string(), z.unknown()).optional().describe(inSpec('Aggregates (count, sum, avg, …): output alias → function')),\n groupBy: z.array(z.unknown()).optional().describe(inSpec('Fields to group by, for aggregates')),\n sort: z.array(z.unknown()).optional().describe(inSpec('Sort order')),\n limit: z.number().optional().describe('Maximum rows to return.'),\n distinct: z.boolean().optional().describe('Eliminate duplicate rows.'),\n })\n .catchall(z.unknown())\n .describe('Your draft DSL query — the query object itself, NOT wrapped in any field.');\nexport type TestQueryInput = z.infer<typeof TestQueryInputSchema>;\n\nconst CannotSatisfyInputSchema = z.object({\n reason: z.string().describe('Why the request cannot be satisfied'),\n});\nexport type CannotSatisfyInput = z.infer<typeof CannotSatisfyInputSchema>;\n\n// ═══════════════════════════════════════════════════════════════\n// Result types\n// ═══════════════════════════════════════════════════════════════\n\ntype FieldStats = {\n type: string;\n nullable: boolean;\n cardinality: number;\n nullCount: number;\n min?: unknown;\n max?: unknown;\n};\n\ntype TestQueryResult = {\n rows: Row[];\n sql: string;\n warnings: string[];\n errors: string[];\n // On success only: what the model does now. A passing test is the moment\n // the run can end, and a model that is not told so tests the same query\n // again (measured: qwen 3.8 27b, until its stop).\n next?: string;\n};\n\nconst NEXT_AFTER_PASS =\n 'This query runs. If its rows answer the request, you are done: do not test it again — finish now with the envelope, its `data` being exactly this query. If not, change the query and test again.';\n\n// ═══════════════════════════════════════════════════════════════\n// Helpers\n// ═══════════════════════════════════════════════════════════════\n\ntype Located = { entity: EntitySchema } | { error: string };\ntype LocatedField = { entity: EntitySchema; field: FieldSchema } | { error: string };\n\n// The schema the tools are handed is already the caller's — tables their\n// policy cannot read are not in it — so \"not found\" and \"not yours\" are the\n// same answer, which is the point.\nconst locate = (deps: QueryToolDeps, entityName: string): Located => {\n const schema = deps.getSchema();\n if (schema === undefined) return { error: 'Schema not available' };\n const entity = schema.entities.find((e) => e.name === entityName);\n return entity === undefined ? { error: `Entity \"${entityName}\" not found` } : { entity };\n};\n\nconst locateField = (deps: QueryToolDeps, entityName: string, fieldName: string): LocatedField => {\n const located = locate(deps, entityName);\n if ('error' in located) return located;\n const field = located.entity.fields.find((f) => f.name === fieldName);\n return field === undefined\n ? { error: `Field \"${fieldName}\" not found on entity \"${entityName}\"` }\n : { entity: located.entity, field };\n};\n\nconst messageOf = (err: unknown): string => (err instanceof Error ? err.message : String(err));\n\n// A read that fails (a refused table, a column the grammar cannot name) is an\n// answer the model can use, not a crash of the run.\nconst attempt = async <T>(run: () => Promise<T>): Promise<T | { error: string }> => {\n try {\n return await run();\n } catch (err) {\n return { error: messageOf(err) };\n }\n};\n\nconst firstRow = (rows: Row[]): Row => rows[0] ?? {};\n\n// ═══════════════════════════════════════════════════════════════\n// Factory\n// ═══════════════════════════════════════════════════════════════\n\nexport const createQueryTools = (deps: QueryToolDeps): ReturnType<typeof defineTool>[] => {\n const getSchemaTool = defineTool({\n id: 'getSchema',\n name: 'getSchema',\n description: 'Returns the introspected database schema, optionally filtered to specific entities.',\n input: GetSchemaInputSchema,\n execute: (input: GetSchemaInput) => {\n const schema = deps.getSchema();\n if (!schema) return { error: 'Schema not available' };\n\n if (input.entities && input.entities.length > 0) {\n const filtered = {\n ...schema,\n entities: schema.entities.filter(e => input.entities?.includes(e.name)),\n };\n return JSON.stringify(filtered);\n }\n\n return JSON.stringify(schema);\n },\n });\n\n const getSampleRowsTool = defineTool({\n id: 'getSampleRows',\n name: 'getSampleRows',\n description: 'Returns sample rows from an entity table.',\n input: GetSampleRowsInputSchema,\n execute: async (input: GetSampleRowsInput) => {\n const located = locate(deps, input.entity);\n if ('error' in located) return located;\n const { entity } = located;\n // Vector columns are left out: hundreds of floats per row teach the\n // model nothing and cost the context window everything.\n const fields = entity.fields.filter((f) => f.normalizedType !== 'vector').map((f) => `${entity.name}.${f.name}`);\n const query: Query = { from: [entity.name], fields, limit: input.limit ?? 5 };\n return attempt(async () => (await deps.read(query)).rows);\n },\n });\n\n const getDistinctValuesTool = defineTool({\n id: 'getDistinctValues',\n name: 'getDistinctValues',\n description: 'Returns distinct values for a specific field in an entity.',\n input: GetDistinctValuesInputSchema,\n execute: async (input: GetDistinctValuesInput) => {\n const located = locateField(deps, input.entity, input.field);\n if ('error' in located) return located;\n const { entity, field } = located;\n const query: Query = { from: [entity.name], fields: [`${entity.name}.${field.name}`], distinct: true, limit: input.limit ?? 20 };\n return attempt(async () => (await deps.read(query)).rows.map((row) => row[field.name]));\n },\n });\n\n const describeFieldTool = defineTool({\n id: 'describeField',\n name: 'describeField',\n description: 'Returns statistics about a field: type, nullable, cardinality, null count, min/max for numeric/date types.',\n input: DescribeFieldInputSchema,\n execute: async (input: DescribeFieldInput) => {\n const located = locateField(deps, input.entity, input.field);\n if ('error' in located) return located;\n const { entity, field } = located;\n const path = `${entity.name}.${field.name}`;\n const isNumericOrDate = ['number', 'date', 'timestamp'].includes(field.normalizedType);\n\n return attempt(async (): Promise<FieldStats> => {\n const [counted, nulls, range] = await Promise.all([\n deps.read({ from: [entity.name], aggregate: { cardinality: { countDistinct: path } } }),\n deps.read({ from: [entity.name], aggregate: { null_count: { count: '*' } }, filter: { isNull: path } }),\n isNumericOrDate\n ? deps.read({ from: [entity.name], aggregate: { min_val: { min: path }, max_val: { max: path } } })\n : Promise.resolve(undefined),\n ]);\n\n const stats: FieldStats = {\n type: field.normalizedType,\n nullable: field.nullable,\n cardinality: Number(firstRow(counted.rows)['cardinality'] ?? 0),\n nullCount: Number(firstRow(nulls.rows)['null_count'] ?? 0),\n };\n if (range !== undefined) {\n stats.min = firstRow(range.rows)['min_val'];\n stats.max = firstRow(range.rows)['max_val'];\n }\n return stats;\n });\n },\n });\n\n const testQueryTool = defineTool({\n id: 'testQuery',\n name: 'testQuery',\n description:\n 'Validates a DSL query, compiles it to SQL, and executes it with synthetic parameters (LIMIT 5). ' +\n 'Pass the query object DIRECTLY as the arguments. Returns rows, SQL, warnings, and errors.',\n input: TestQueryInputSchema,\n execute: async (input: TestQueryInput): Promise<TestQueryResult> => {\n if (exceedsDepth(input)) return { rows: [], sql: '', warnings: [], errors: [depthRefusal()] };\n const parseResult = QuerySchema.safeParse(input);\n if (!parseResult.success) {\n const validationErrors = parseResult.error.issues.map(\n issue => `${issue.path.join('.')}: ${issue.message}`,\n );\n return { rows: [], sql: '', warnings: [], errors: validationErrors };\n }\n\n try {\n const { rows, sql, warnings } = await deps.read({ ...parseResult.data, limit: 5 });\n return { rows, sql, warnings, errors: [], next: NEXT_AFTER_PASS };\n } catch (err: unknown) {\n return { rows: [], sql: '', warnings: [], errors: [messageOf(err)] };\n }\n },\n });\n\n // The caller (createQueryDsl) watches for this tool's observation on\n // the run's event stream and aborts the run with the reason — the\n // v2 replacement for the v1 bus-emit + abort-rule pair.\n const cannotSatisfyTool = defineTool({\n id: 'cannotSatisfy',\n name: 'cannotSatisfy',\n description: 'Signal that the natural language request cannot be satisfied by the available schema. This ends the run.',\n input: CannotSatisfyInputSchema,\n execute: (input: CannotSatisfyInput) => ({ acknowledged: true, reason: input.reason }),\n });\n\n return [\n getSchemaTool,\n getSampleRowsTool,\n getDistinctValuesTool,\n describeFieldTool,\n testQueryTool,\n cannotSatisfyTool,\n ];\n};\n","import { defineAgent } from '@niscorp/cortex';\nimport type { AgentDefinition } from '@niscorp/cortex';\nimport { stepCount, outputRetries, repeatedCalls } from '@niscorp/cortex';\nimport { QuerySchema } from '../schemas/query.schema.js';\nimport type { Query } from '../schemas/query.schema.js';\nimport type { ScopeBinding } from '../types.js';\n\n// Per-invocation deps: the introspected database schema and the DSL\n// JSON Schema arrive per call (they vary with adapter and scope), so\n// they are context-function inputs — the agent itself is defined once.\nexport type VexQueryDeps = {\n schemaJson: string;\n dslSpecJson: string;\n // Who the caller is, in the schema's terms (describeCaller). Absent — a run\n // built without it — reads as a caller nothing identifies.\n caller?: string;\n};\n\n// WHO THE CALLER IS, for the agent: the columns their scope keys are bound to\n// (GenerationCaller.bindings) — the keys and the columns, never a value. With\n// none, the agent is told plainly that nothing here identifies them, so a\n// question about \"me\" is refused for the right reason rather than guessed at.\nexport const describeCaller = (bindings: readonly ScopeBinding[]): string =>\n bindings.length === 0\n ? 'The caller: no column in this schema is bound to anything that identifies the caller, so a request about \"me\", \"my\" or \"mine\" cannot be answered.'\n : [\n 'The caller — the person or service this query is for — is identified by server-side scope values bound to these columns:',\n ...bindings.map((b) => `- ${b.entity}.${b.field} is the caller's { \"$scope\": \"${b.key}\" }`),\n 'Such a column holds that value on the caller\\'s own rows. To mean the caller or what is theirs (\"me\", \"my\", \"mine\", \"our\"), filter the column with { \"$scope\": \"<key>\" } — the server binds the caller\\'s own value; you never see or write it.',\n ].join('\\n');\n\nconst INSTRUCTIONS = `You are Vex's query agent. You turn a caller's request — a natural-language \\`intent\\` and an example \\`shape\\` of the data they want back — into ONE query in Vex's DSL.\n\nContext gives you two things:\n- the database schema: the entities, fields, relations, and indexes that actually exist;\n- the DSL JSON Schema: the exact structure your query must take. Its field\n descriptions ARE the rules — read them and follow them. They are the single\n source of truth for how every part of a query is written.\n\nYour job is to RETRIEVE the data the request needs: choose the entities, columns,\nfilters, computed values, and aggregates the schema supports. A separate step runs\nafter you and reshapes, nests, combines and formats the rows, so you never nest.\nBut when a key of the shape is exactly ONE column or ONE aggregate, alias it to\nthat key (\\`{ \"field\": …, \"as\": \"<key>\" }\\`, or name the aggregate after the key):\nwhen every row already has exactly the shape's keys, that later step is skipped.\nA key that needs combining or formatting (a full name from two columns, a date\nwritten out) you leave to it — select the underlying columns under their own names.\n\nWork this way, every time:\n1. If you are unsure what exists or what values a field holds, inspect it with\n your tools before drafting.\n2. Draft the query.\n3. Call testQuery on the draft. You may NOT finish until testQuery has succeeded.\n If it returns an error, your query is wrong — read the error, fix the query,\n and call testQuery again. Repeat until it passes.\n4. Finish. Your envelope's \\`data\\` is the EXACT query that passed\n testQuery (optionally a one-line \\`reasoning\\`).\n5. If the request genuinely cannot be answered from the schema, call\n cannotSatisfy with a short reason instead of guessing.\n\nWorked example (illustrative — real entities and rules come from the schema):\nintent: \"each customer's contact line and how much they've spent, biggest first\"\nshape: [{ \"contact\": \"\", \"spent\": 0 }]\ndata: {\"from\":[\"customer\"],\"fields\":[\"customer.name\",\"customer.email\",{\"field\":\"customer.total_spent\",\"as\":\"spent\"}],\"sort\":[{\"field\":\"customer.total_spent\",\"dir\":\"desc\"}]}\n(\\`spent\\` is one column, so it is aliased; \\`contact\\` combines two, so they are selected as they are.)`;\n\nexport const vexQueryDslAgent: AgentDefinition<Query, VexQueryDeps> = defineAgent<Query, VexQueryDeps>({\n id: 'vex.query',\n description: 'Generates DSL queries from natural language intent and target shape.',\n instructions: INSTRUCTIONS,\n context: [\n ({ deps }) => `Database schema:\\n${deps.schemaJson}`,\n ({ deps }) => deps.caller ?? describeCaller([]),\n // Named OUTPUT SCHEMA because that is what the finish protocol refers to:\n // the query this agent returns is the envelope's `data`.\n ({ deps }) => `OUTPUT SCHEMA — the DSL specification (JSON Schema), the single source of truth for your query:\\n${deps.dslSpecJson}`,\n ],\n // The DSL spec above IS the schema documentation; don't inject it twice.\n output: { schema: QuerySchema, doc: 'off' },\n // Three identical testQuery calls with the same error in a row is a model\n // not reading the error; a fourth would cost a full prompt and change nothing.\n stopWhen: [stepCount(20), outputRetries(3), repeatedCalls(2)],\n});\n","import type { RunHandle } from '@niscorp/cortex';\nimport { VexError } from '../errors.js';\nimport { mappingAgent } from '@niscorp/prism/agent';\nimport { compile, execute } from '@niscorp/prism';\nimport type { JsonObject } from '@niscorp/prism';\nimport { createQueryTools } from './tools.js';\nimport { describeCaller, vexQueryDslAgent } from './query.agent.js';\nimport type { Query } from '../schemas/query.schema.js';\nimport type { GenerateDsl, MapToShape } from '../types.js';\nimport type { SignalClient } from '@niscorp/cortex';\n\n// ═══════════════════════════════════════════════════════════════\n// Re-exports\n// ═══════════════════════════════════════════════════════════════\n\nexport { vexQueryDslAgent, describeCaller } from './query.agent.js';\nexport type { VexQueryDeps } from './query.agent.js';\nexport { createQueryTools } from './tools.js';\nexport type { QueryToolDeps } from './tools.js';\n\n// ═══════════════════════════════════════════════════════════════\n// generateDsl hook factory — runs vexQueryDslAgent\n// ═══════════════════════════════════════════════════════════════\n\n// What the agent is built from. Who it runs FOR is not here: the engine hands\n// every generation its caller (a `read` capability under that caller's policy\n// and scope) and the schema that caller may see, so one hook serves every\n// principal and cannot be built with the wrong one baked in.\nexport type QueryDslConfig = {\n llm: SignalClient;\n queryJsonSchema: object;\n};\n\nconst reasonFrom = (args: unknown): string | undefined => {\n if (typeof args !== 'object' || args === null) return undefined;\n const reason = (args as Record<string, unknown>)['reason'];\n return typeof reason === 'string' ? reason : undefined;\n};\n\nexport const createQueryDsl = (config: QueryDslConfig): GenerateDsl => {\n return async (request, schema, caller) => {\n const tools = createQueryTools({ getSchema: () => schema, read: caller.read });\n\n const agentInput = {\n intent: request.intent,\n shape: request.shape,\n contextKeys: Object.keys(request.context),\n };\n\n // The agent signals \"cannot satisfy\" by calling its cannotSatisfy\n // tool. We watch the run's event stream for that observation,\n // capture the reason, and abort — distinguishing a real\n // unsatisfiable result (worth negative-caching) from a transient\n // failure.\n let unsatisfiableReason: string | undefined;\n let run: RunHandle<Query> | undefined;\n run = vexQueryDslAgent.run(agentInput, {\n llm: config.llm,\n deps: {\n schemaJson: JSON.stringify(schema),\n dslSpecJson: JSON.stringify(config.queryJsonSchema),\n caller: describeCaller(caller.bindings),\n },\n tools,\n onEvent: (event) => {\n if (\n event.type === 'tool-end' &&\n event.observation.kind === 'result' &&\n event.observation.toolId === 'cannotSatisfy'\n ) {\n unsatisfiableReason = reasonFrom(event.observation.args) ?? 'request cannot be satisfied';\n run?.abort();\n }\n },\n });\n\n const result = await run.result;\n if (!result.ok) {\n if (unsatisfiableReason !== undefined) {\n throw new VexError('unsatisfiable', unsatisfiableReason);\n }\n throw new VexError('agent_failed', `${result.error.code}: ${result.error.message}`);\n }\n return result.output.data;\n };\n};\n\n// ═══════════════════════════════════════════════════════════════\n// mapToShape hook factory — runs Prism's mappingAgent\n//\n// The mapping runs ONCE over { result }, and its output IS the result (array /\n// object / scalar). An array shape puts the rows in $.result; an object shape\n// puts the single (first) row there. The envelope here must match the\n// runtime's cache-hit path (engine/runtime.ts), which replays the cached IR against the same envelope. Keep them in lockstep.\n//\n// NOTE: for the agent to actually author a whole-set mapping (a `$map` over\n// `$.result` for arrays), its instructions must teach that — tracked as a\n// follow-up. Canned/relay paths use a hand-authored, seeded IR and are correct\n// today; this affects only live generation.\n// ═══════════════════════════════════════════════════════════════\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> =>\n typeof value === 'object' && value !== null && !Array.isArray(value);\n\n// ROWS THAT ARE ALREADY THE SHAPE need no mapping. True only when the shape is\n// flat (every value a scalar example) and the first row has EXACTLY the\n// shape's keys — nothing extra, nothing missing — each holding the kind of\n// value the shape shows (or null). The query agent aliases its columns to a\n// flat shape's keys for exactly this reason. Anything else — a nested shape, a\n// renamed or extra column, a count that came back as text — goes to the\n// mapping agent. No rows is not a fit: there is nothing to prove the columns\n// by, and the IR minted here is replayed later against rows that exist.\nexport const rowsFitShape = (rows: readonly Record<string, unknown>[], shape: unknown): boolean => {\n const example = Array.isArray(shape) ? shape[0] : shape;\n const first = rows[0];\n if (!isPlainObject(example) || first === undefined) return false;\n const keys = Object.keys(example);\n if (keys.length !== Object.keys(first).length) return false;\n return keys.every((key) => {\n const sample = example[key];\n if (typeof sample === 'object' && sample !== null) return false;\n if (!(key in first)) return false;\n const value = first[key];\n return value === null || typeof value === typeof sample;\n });\n};\n\n// The identity mapping over the envelope — what a fitting row set replays as.\nconst IDENTITY = { $ref: '$.result' };\n\nexport const createShapeMapper = (llm: SignalClient): MapToShape => {\n return async (rows, shape) => {\n // Array shape → map the whole set; a non-array shape → map the single\n // (first) row. The envelope here must match the runtime's (engine/runtime.ts).\n const single = !Array.isArray(shape);\n const envelope = { result: single ? (rows[0] ?? null) : rows } as unknown as JsonObject;\n\n // Already the shape: the identity, with no model call.\n if (rowsFitShape(rows, shape)) {\n const ir = await compile(IDENTITY);\n return { ir, transformed: execute(ir, envelope) };\n }\n\n const result = await mappingAgent.run(\n { sampleInput: envelope, targetShape: shape },\n { llm },\n ).result;\n\n if (!result.ok) throw new VexError('agent_failed', `${result.error.code}: ${result.error.message}`);\n\n const ir = await compile(result.output.data);\n const transformed = execute(ir, envelope);\n return { ir, transformed };\n };\n};\n"]}
@@ -1,4 +1,4 @@
1
- import { ad as ScopeBinding, b as Query, D as DatabaseSchema, x as GenerationCaller, G as GenerateDsl, K as MapToShape } from '../types-BRvMB6IM.cjs';
1
+ import { ae as ScopeBinding, b as Query, D as DatabaseSchema, x as GenerationCaller, G as GenerateDsl, K as MapToShape } from '../types-Bi-Lg86b.cjs';
2
2
  import { AgentDefinition, defineTool, SignalClient } from '@niscorp/cortex';
3
3
  import 'zod';
4
4
  import '@niscorp/prism';
@@ -1,4 +1,4 @@
1
- import { ad as ScopeBinding, b as Query, D as DatabaseSchema, x as GenerationCaller, G as GenerateDsl, K as MapToShape } from '../types-BRvMB6IM.js';
1
+ import { ae as ScopeBinding, b as Query, D as DatabaseSchema, x as GenerationCaller, G as GenerateDsl, K as MapToShape } from '../types-Bi-Lg86b.js';
2
2
  import { AgentDefinition, defineTool, SignalClient } from '@niscorp/cortex';
3
3
  import 'zod';
4
4
  import '@niscorp/prism';
@@ -1,4 +1,4 @@
1
- import { QuerySchema, VexError } from '../chunk-HF25Q53I.js';
1
+ import { QuerySchema, VexError } from '../chunk-H4BHW76Q.js';
2
2
  import { mappingAgent } from '@niscorp/prism/agent';
3
3
  import { compile, execute } from '@niscorp/prism';
4
4
  import { z } from 'zod';
@@ -149,6 +149,7 @@ var QuerySchema = z.lazy(
149
149
  );
150
150
 
151
151
  // src/errors.ts
152
+ var VEX_ERROR = /* @__PURE__ */ Symbol.for("@niscorp/vex:VexError");
152
153
  var VexError = class extends Error {
153
154
  code;
154
155
  details;
@@ -159,7 +160,9 @@ var VexError = class extends Error {
159
160
  this.details = details;
160
161
  }
161
162
  };
163
+ Object.defineProperty(VexError.prototype, VEX_ERROR, { value: true });
164
+ var isVexError = (err) => err instanceof VexError || err instanceof Error && Reflect.get(err, VEX_ERROR) === true;
162
165
 
163
- export { AggregateExpressionSchema, ComputeExpressionSchema, FilterSchema, QuerySchema, VexError, isFieldPathShape, isIdentifier };
164
- //# sourceMappingURL=chunk-HF25Q53I.js.map
165
- //# sourceMappingURL=chunk-HF25Q53I.js.map
166
+ export { AggregateExpressionSchema, ComputeExpressionSchema, FieldPathSchema, FilterSchema, QuerySchema, VexError, isFieldPathShape, isIdentifier, isVexError };
167
+ //# sourceMappingURL=chunk-H4BHW76Q.js.map
168
+ //# sourceMappingURL=chunk-H4BHW76Q.js.map