primitive-admin 1.1.0-alpha.9 → 1.2.0-alpha.0

package/dist/src/lib/prompt-schema-codegen.js

@@ -0,0 +1,462 @@
+/**
+ * The prompt declaration — #3330, project `server-functions` phase 4.
+ *
+ * A prompt's `[prompt.outputSchema]` already says what its answer looks like,
+ * and `config pull`/`push` already round-trip it. Until now nothing turned it
+ * into a type, so a function calling the prompt restated the shape by hand at
+ * the call site with nothing checking it — the same complaint the function
+ * input/output contract answered, one surface over.
+ *
+ * `functions/primitive-prompt-types.d.ts` is rendered from `prompts/*.toml`
+ * beside the other declarations and regenerated by `config push`,
+ * `config pull` and `primitive functions codegen`:
+ *
+ *   - `<Key>PromptOutput` for every prompt that declares an `outputSchema`,
+ *     through the SAME renderer `primitive-function-types.d.ts` uses, over the
+ *     same vendored descriptor, so what compiles is what the route validates.
+ *   - `PrimitivePromptSchemas`, keyed by prompt key, and the
+ *     `declare module "primitive-functions"` augmentation — the
+ *     `DatabaseSchemas`/`FunctionSchemas`/`DocumentSchemas` shape. Empty keeps
+ *     `PromptKeys` open (`string`); a pushed tree narrows it, so an undeclared
+ *     key is a compile error.
+ *
+ * A prompt that declares NO schema is `{}` under its key, not an entry with an
+ * `unknown` output. That is deliberate: `{}` does not extend `{ output: … }`,
+ * so the SDK's `PromptRunResult` falls to its open shape and `parsed` stays
+ * optional and `unknown` — and REMOVING a schema therefore turns a handler
+ * reading `parsed.field` into a compile error on the next push rather than a
+ * runtime `undefined`.
+ *
+ * ── The suffix ───────────────────────────────────────────────────────────
+ *
+ * `<Key>PromptOutput`, not `<Key>Output`. A function and the prompt it calls
+ * commonly share a key — the issue's own `categorize` — and `<Key>Output`
+ * already names the FUNCTION's output in the declaration beside this one.
+ *
+ * ── Identity is push's ───────────────────────────────────────────────────
+ *
+ * `config push` resolves a prompt file as
+ * `tomlData.prompt?.key || basename(file, ".toml")`, so `local.toml` carrying
+ * `key = "categorize"` is deployed as `categorize`. Reading the stem alone
+ * would type it under a key the platform never hears about, refuse the call
+ * the deployed prompt answers, and attach the schema to the wrong key. Same
+ * rule and same reason as `resolveFunctionKey` (CR3281-001) and
+ * `databaseTypeSources` (SO3182-003): the generator reads the key the platform
+ * will hear about, never the file name alone.
+ *
+ * ── Agents (#3798) ───────────────────────────────────────────────────────
+ *
+ * A `kind = "agent"` prompt is never run single-shot, so it has no `output`.
+ * Its entry is `{ agent: { variables; clientTools; events } }` instead —
+ * `<Key>AgentVariables` from `inputSchema` (the session's variables),
+ * `<Key>Tool<Name>Input`/`Output` for each CLIENT tool (a server tool's
+ * schemas are its function's, typed in the functions declaration) and
+ * `<Key>Event<Name>` for each event kind — and the SDK's `PromptKeys` excludes
+ * it, so `ctx.prompts.run("<agent>")` is a compile error. The same types go to
+ * the client side as `functions/generated/<key>.agent.generated.ts`
+ * (`renderAgentClientFiles`), which an app's web code imports. The
+ * declaration is read through `normalizeAgentDeclaration`, the one reader
+ * that applies an agent's defaults.
+ */
+import { existsSync, readdirSync, readFileSync } from "fs";
+import { basename, join } from "path";
+import { parseConfigToml } from "./config-toml.js";
+import { safeJsonParse } from "./workflow-payload.js";
+import { FunctionSchemaCodegenError, renderTypeDecl, } from "./function-schema-codegen.js";
+import { workflowTypeBaseName } from "./workflow-codegen/naming.js";
+import { tsStringLiteral } from "./codegen-shared/prettierStable.js";
+import { fingerprintToml } from "./db-codegen/dbFingerprint.js";
+import { normalizeAgentDeclaration, promptKindOf, resolveAgentDeclaration, } from "./generated-config-surfaces.js";
+/** The client-side artifact an agent prompt gets, beside the invokers (#3798). */
+export const AGENT_CLIENT_FILE_SUFFIX = ".agent.generated.ts";
+/** The regenerated declaration beside `primitive-function-types.d.ts`. */
+export const PROMPT_TYPES_DECLARATION_FILE = "primitive-prompt-types.d.ts";
+/** The key push will identify this file by. */
+function resolvePromptKey(source, table) {
+    return table?.key ? String(table.key) : source.key;
+}
+/**
+ * Every `prompts/*.toml` in a tree, read once.
+ *
+ * `withFileTypes` rather than a name filter alone: a `prompts/<key>.tests/`
+ * sidecar directory and anything that is not a regular `.toml` file are not
+ * prompt sources, and a directory read as one fails in the parser with a
+ * message about TOML instead of being ignored.
+ */
+export function promptSchemaSources(configDir) {
+    const dir = join(configDir, "prompts");
+    if (!existsSync(dir))
+        return [];
+    const sources = [];
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        if (!entry.isFile() || !entry.name.endsWith(".toml"))
+            continue;
+        const tomlPath = join(dir, entry.name);
+        let tomlContent;
+        try {
+            tomlContent = readFileSync(tomlPath, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        sources.push({ key: basename(entry.name, ".toml"), tomlPath, tomlContent });
+    }
+    return sources;
+}
+/** The tree-relative spelling of a source, for a message an author acts on. */
+function fileLabel(source) {
+    const at = source.tomlPath.lastIndexOf("/prompts/");
+    return at >= 0 ? source.tomlPath.slice(at + 1) : source.tomlPath;
+}
+/**
+ * Parse one file into the data the renderer needs.
+ *
+ * Throws a `FunctionSchemaCodegenError` naming the file for malformed TOML or
+ * malformed schema JSON — the honest "declares nothing" is for an ABSENT
+ * schema, never a broken one, because typing a broken schema as anything at
+ * all is a declaration that lies.
+ */
+export function describePromptSchema(source) {
+    let table;
+    try {
+        table = parseConfigToml(source.tomlContent)?.prompt ?? {};
+    }
+    catch (error) {
+        throw new FunctionSchemaCodegenError(`${fileLabel(source)}: the file does not parse as TOML (${error?.message ?? error})`);
+    }
+    const key = resolvePromptKey(source, table);
+    let outputSchema;
+    try {
+        // An inline `[prompt.outputSchema]` table and a JSON string alike — the
+        // config surface accepts both, so the generator has to read both.
+        outputSchema = safeJsonParse(table.outputSchema);
+    }
+    catch (error) {
+        throw new FunctionSchemaCodegenError(`${fileLabel(source)}: \`outputSchema\` is not valid JSON (${error?.message ?? error})`);
+    }
+    const typeBaseName = workflowTypeBaseName(key);
+    return {
+        key,
+        fileLabel: fileLabel(source),
+        outputSchema,
+        typeBaseName,
+        outputTypeName: `${typeBaseName}PromptOutput`,
+        agent: promptKindOf(table) === "agent"
+            ? describeAgentTypes(fileLabel(source), typeBaseName, table)
+            : null,
+    };
+}
+/**
+ * A declared name as a property key: bare when it is an identifier, quoted
+ * (the way Prettier quotes a string) when it carries a `-`.
+ */
+function propertyKey(name) {
+    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name) ? name : tsStringLiteral(name);
+}
+/**
+ * An agent prompt's contract, typed (#3798). The declaration is checked by the
+ * same rule push runs (its file-decidable half), so a malformed one fails here
+ * naming the file rather than typing something the platform refuses; two
+ * client tools (or two events) whose names sanitize to one identifier are
+ * refused naming both.
+ */
+function describeAgentTypes(label, typeBaseName, table) {
+    const resolution = resolveAgentDeclaration({ kind: "agent", agent: table.agent });
+    if (resolution.ok === false) {
+        throw new FunctionSchemaCodegenError(`${label}: ${resolution.refusals.map((r) => r.message).join("; ")}`);
+    }
+    let inputSchema;
+    try {
+        inputSchema = safeJsonParse(table.inputSchema);
+    }
+    catch (error) {
+        throw new FunctionSchemaCodegenError(`${label}: \`inputSchema\` is not valid JSON (${error?.message ?? error})`);
+    }
+    const declaration = normalizeAgentDeclaration(resolution.declaration);
+    const claimed = (what) => {
+        const byBase = new Map();
+        return (name) => {
+            const base = workflowTypeBaseName(name);
+            const other = byBase.get(base);
+            if (other !== undefined && other !== name) {
+                throw new FunctionSchemaCodegenError(`${label}: ${what} names '${other}' and '${name}' both name the ` +
+                    `generated type \`${typeBaseName}${what === "tool" ? "Tool" : "Event"}${base}\` — ` +
+                    "rename one so the two do not collide after sanitizing");
+            }
+            byBase.set(base, name);
+            return base;
+        };
+    };
+    const toolBase = claimed("tool");
+    const eventBase = claimed("event");
+    const clientTools = declaration.tools
+        .filter((tool) => tool.runs === "client")
+        .map((tool) => {
+        const base = `${typeBaseName}Tool${toolBase(tool.name)}`;
+        return {
+            name: tool.name,
+            input: {
+                name: tool.name,
+                typeName: `${base}Input`,
+                schema: tool.inputSchema,
+            },
+            output: {
+                name: tool.name,
+                typeName: `${base}Output`,
+                schema: tool.outputSchema,
+            },
+        };
+    });
+    const events = declaration.events.map((event) => ({
+        name: event.name,
+        typeName: `${typeBaseName}Event${eventBase(event.name)}`,
+        schema: event.schema,
+    }));
+    return {
+        variablesTypeName: `${typeBaseName}AgentVariables`,
+        inputSchema,
+        clientTools,
+        events,
+    };
+}
+/** Render one agent type, naming the file and the path when it cannot be. */
+function renderAgentType(prompt, typeName, schema, path) {
+    try {
+        return renderTypeDecl(typeName, schema);
+    }
+    catch (error) {
+        if (error instanceof FunctionSchemaCodegenError)
+            throw error;
+        throw new FunctionSchemaCodegenError(`${prompt.fileLabel}: \`${path}\` cannot be rendered as a TypeScript ` +
+            `type (${error?.message ?? error})`);
+    }
+}
+/** Every type declaration an agent contributes, in a fixed order. */
+function renderAgentTypeDecls(prompt) {
+    const agent = prompt.agent;
+    return [
+        renderAgentType(prompt, agent.variablesTypeName, agent.inputSchema, "inputSchema"),
+        ...agent.clientTools.flatMap((tool) => [
+            renderAgentType(prompt, tool.input.typeName, tool.input.schema, `tools.${tool.name}.inputSchema`),
+            renderAgentType(prompt, tool.output.typeName, tool.output.schema, `tools.${tool.name}.outputSchema`),
+        ]),
+        ...agent.events.map((event) => renderAgentType(prompt, event.typeName, event.schema, `events.${event.name}.schema`)),
+    ];
+}
+/** The one-line `{ agent: … }` entry of `PrimitivePromptSchemas`. */
+function agentSchemaEntry(prompt) {
+    const agent = prompt.agent;
+    const tools = agent.clientTools
+        .map((tool) => `${propertyKey(tool.name)}: { input: ${tool.input.typeName}; output: ${tool.output.typeName} }`)
+        .join("; ");
+    const events = agent.events
+        .map((event) => `${propertyKey(event.name)}: ${event.typeName}`)
+        .join("; ");
+    return (`{ agent: { variables: ${agent.variablesTypeName}; ` +
+        `clientTools: {${tools ? ` ${tools} ` : ""}}; ` +
+        `events: {${events ? ` ${events} ` : ""}} } }`);
+}
+/**
+ * Describe every source, sorted by key, refusing the two collisions that
+ * would silently render one prompt over another: two files resolving to one
+ * key (only reachable through an authored `[prompt] key`, since stems are
+ * unique), and two keys sanitizing to one identifier.
+ */
+function describeAll(sources) {
+    const described = sources.map((source) => ({
+        prompt: describePromptSchema(source),
+        source,
+    }));
+    described.sort((a, b) => a.prompt.key < b.prompt.key ? -1 : a.prompt.key > b.prompt.key ? 1 : 0);
+    const byKey = new Map();
+    for (const { prompt, source } of described) {
+        const other = byKey.get(prompt.key);
+        if (other !== undefined) {
+            throw new FunctionSchemaCodegenError(`${fileLabel(other)} and ${fileLabel(source)} both declare the prompt ` +
+                `key '${prompt.key}' — one file is one prompt, so rename or remove ` +
+                `one \`[prompt] key\``);
+        }
+        byKey.set(prompt.key, source);
+    }
+    const byBaseName = new Map();
+    for (const { prompt } of described) {
+        const other = byBaseName.get(prompt.typeBaseName);
+        if (other !== undefined && other !== prompt.key) {
+            throw new FunctionSchemaCodegenError(`prompt keys '${other}' and '${prompt.key}' both name the generated ` +
+                `type \`${prompt.outputTypeName}\` — rename one so the two do not ` +
+                `collide after sanitizing`);
+        }
+        byBaseName.set(prompt.typeBaseName, prompt.key);
+    }
+    // #3798 (CSO-3798-001) — an agent's types are named `<Key>Tool…`/`<Key>Event…`,
+    // so they can land on another prompt's name even when the two bases differ
+    // (event `prompt-output` of `advisor` and the output of `advisor-event`).
+    // Every declared name is registered, and a second claim is refused naming
+    // both sources rather than one silently redeclaring the other.
+    const byTypeName = new Map();
+    for (const { prompt } of described) {
+        for (const { typeName, path } of declaredTypeNames(prompt)) {
+            const where = `${prompt.fileLabel} (\`${path}\`)`;
+            const other = byTypeName.get(typeName);
+            if (other !== undefined) {
+                throw new FunctionSchemaCodegenError(`${other} and ${where} both declare the generated type ` +
+                    `\`${typeName}\` — rename one so the two do not collide after sanitizing`);
+            }
+            byTypeName.set(typeName, where);
+        }
+    }
+    return described;
+}
+/** Every type name a prompt's declarations emit, with the schema it comes from. */
+function declaredTypeNames(prompt) {
+    const agent = prompt.agent;
+    if (!agent) {
+        return prompt.outputSchema === undefined
+            ? []
+            : [{ typeName: prompt.outputTypeName, path: "outputSchema" }];
+    }
+    return [
+        { typeName: agent.variablesTypeName, path: "inputSchema" },
+        ...agent.clientTools.flatMap((tool) => [
+            { typeName: tool.input.typeName, path: `tools.${tool.name}.inputSchema` },
+            { typeName: tool.output.typeName, path: `tools.${tool.name}.outputSchema` },
+        ]),
+        ...agent.events.map((event) => ({
+            typeName: event.typeName,
+            path: `events.${event.name}.schema`,
+        })),
+    ];
+}
+const DECLARATION_HEADER = `// GENERATED by \`primitive config push\` from prompts/*.toml.
+// DO NOT EDIT — your changes are overwritten on the next push.
+//
+// It types \`ctx.prompts.run("<key>")\`: a prompt that declares an
+// \`[prompt.outputSchema]\` hands back \`parsed\` as \`<Key>PromptOutput\` on the
+// success arm, and a key this tree does not declare is a compile error. A
+// prompt that declares no output schema is \`{}\` here, so its \`parsed\` stays
+// optional and \`unknown\`.
+`;
+/**
+ * The declaration for a whole tree's prompts. Sorted by key so the bytes
+ * depend on the files and not on the order they were read in. The
+ * augmentation is emitted even for a tree with no prompt: an empty
+ * `PromptSchemas` keeps `PromptKeys` open (`string`), so nothing breaks.
+ */
+export function renderPromptSchemasDeclaration(sources) {
+    const prompts = describeAll(sources).map((entry) => entry.prompt);
+    const lines = [DECLARATION_HEADER];
+    for (const prompt of prompts) {
+        if (prompt.agent) {
+            for (const decl of renderAgentTypeDecls(prompt)) {
+                lines.push(decl);
+                lines.push("");
+            }
+            continue;
+        }
+        if (prompt.outputSchema === undefined)
+            continue;
+        try {
+            lines.push(renderTypeDecl(prompt.outputTypeName, prompt.outputSchema));
+        }
+        catch (error) {
+            if (error instanceof FunctionSchemaCodegenError)
+                throw error;
+            throw new FunctionSchemaCodegenError(`${prompt.fileLabel}: \`outputSchema\` cannot be rendered as a ` +
+                `TypeScript type (${error?.message ?? error})`);
+        }
+        lines.push("");
+    }
+    if (prompts.length === 0) {
+        lines.push("export interface PrimitivePromptSchemas {}");
+    }
+    else {
+        lines.push("export interface PrimitivePromptSchemas {");
+        for (const prompt of prompts) {
+            lines.push(prompt.agent
+                ? `  ${JSON.stringify(prompt.key)}: ${agentSchemaEntry(prompt)};`
+                : prompt.outputSchema === undefined
+                    ? `  ${JSON.stringify(prompt.key)}: {};`
+                    : `  ${JSON.stringify(prompt.key)}: { output: ${prompt.outputTypeName} };`);
+        }
+        lines.push("}");
+    }
+    lines.push("");
+    lines.push(`declare module "primitive-functions" {`);
+    lines.push(`  interface PromptSchemas extends PrimitivePromptSchemas {}`);
+    lines.push(`}`);
+    lines.push("");
+    return lines.join("\n");
+}
+/**
+ * Whether a source is an agent prompt, read leniently: a file that does not
+ * parse is not one here (the declaration renderer names the parse failure
+ * where it has always named it).
+ */
+function isAgentSource(source) {
+    try {
+        return promptKindOf(parseConfigToml(source.tomlContent)?.prompt) === "agent";
+    }
+    catch {
+        return false;
+    }
+}
+/** Whether a tree declares any agent prompt — the codegen gate (DSO-3798-005). */
+export function treeDeclaresAgentPrompt(configDir) {
+    return promptSchemaSources(configDir).some(isAgentSource);
+}
+/**
+ * The client-side artifact of each agent prompt — #3798:
+ * `<key>.agent.generated.ts`, carrying the agent's variables, client-tool and
+ * event types, the `<Key>AgentClientTools` / `<Key>AgentEvents` maps an app's
+ * session view is typed by, and `<Key>Agent.key`. Written beside the function
+ * invokers and owned by the same plan, so the invoker sweep keeps it; a
+ * Prettier fixed point, like them (#1565).
+ */
+export function renderAgentClientFiles(sources) {
+    const agents = describeAll(sources.filter(isAgentSource));
+    return agents.map(({ prompt, source }) => {
+        const agent = prompt.agent;
+        const base = prompt.typeBaseName;
+        const toolsMap = agent.clientTools.length === 0
+            ? `export interface ${base}AgentClientTools {}`
+            : [
+                `export interface ${base}AgentClientTools {`,
+                ...agent.clientTools.flatMap((tool) => [
+                    `  ${propertyKey(tool.name)}: {`,
+                    `    input: ${tool.input.typeName};`,
+                    `    output: ${tool.output.typeName};`,
+                    `  };`,
+                ]),
+                `}`,
+            ].join("\n");
+        const eventsMap = agent.events.length === 0
+            ? `export interface ${base}AgentEvents {}`
+            : [
+                `export interface ${base}AgentEvents {`,
+                ...agent.events.map((event) => `  ${propertyKey(event.name)}: ${event.typeName};`),
+                `}`,
+            ].join("\n");
+        const blocks = [
+            [
+                `// AUTO-GENERATED FROM ${prompt.fileLabel} — DO NOT EDIT.`,
+                "// Run `primitive functions codegen` to regenerate.",
+                `// fingerprint: ${fingerprintToml(source.tomlContent)}`,
+            ].join("\n"),
+            ...renderAgentTypeDecls(prompt),
+            `/** The client tools a member of the \`${prompt.key}\` agent answers, by name. */\n${toolsMap}`,
+            `/** The event kinds the \`${prompt.key}\` agent records, by name. */\n${eventsMap}`,
+            [
+                `/** The \`${prompt.key}\` agent: the key a session is created with. */`,
+                `export const ${base}Agent = {`,
+                `  key: ${tsStringLiteral(prompt.key)},`,
+                `} as const;`,
+            ].join("\n"),
+        ];
+        return {
+            key: prompt.key,
+            fileName: `${prompt.key}${AGENT_CLIENT_FILE_SUFFIX}`,
+            content: blocks.join("\n\n") + "\n",
+        };
+    });
+}
+//# sourceMappingURL=prompt-schema-codegen.js.map

package/dist/src/lib/prompt-schema-codegen.js.map

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

package/dist/src/lib/query-operators.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Shared constant for the query operators an operation `filter` may use,
+ * plus a helper to find operator keys that aren't in the supported set.
+ *
+ * Background (issue #1255): a database-operation `filter` uses Mongo-style
+ * operators (`$gte`, `$in`, ...). A typo like `$gt` → `$gte` or an invented
+ * `$foo` silently passes `config push` (the server only validates `filter` is
+ * an object) and then throws `InvalidOperatorError` at *query execution*.
+ * The CLI can warn about unknown operators at push time so the author fixes
+ * it before it reaches runtime.
+ *
+ * The set mirrors the runtime translator
+ * (`packages/js-bao/src/query/JsonQueryTranslator.ts`): field operators
+ * (`translateFieldCondition` / substring ops) plus the two logical
+ * combinators special-cased in `translateFilter` (`$and` / `$or`).
+ *
+ * `$not` is intentionally NOT included — it is not a runtime operator; the
+ * translator only special-cases `$and` / `$or`, so `$not` would throw at
+ * execution just like any other unknown operator (codex review, #1255).
+ *
+ * This is deliberately a single source of truth so the validator and any
+ * future emitter/detector agree on what "known" means.
+ */
+/** Field-level comparison / membership / string operators. */
+export declare const FIELD_QUERY_OPERATORS: readonly string[];
+/** Logical combinators (arrays of sub-filters). */
+export declare const LOGICAL_QUERY_OPERATORS: readonly string[];
+/**
+ * Every operator the runtime query translator accepts. Any `$`-prefixed
+ * *key* inside a filter that is not in this set is unknown.
+ */
+export declare const SUPPORTED_QUERY_OPERATORS: ReadonlySet<string>;
+/**
+ * Recursively collect the distinct `$`-prefixed *keys* used in a filter (or
+ * any nested value) that are not in {@link SUPPORTED_QUERY_OPERATORS}.
+ *
+ * Only object *keys* are considered operators — matching the runtime
+ * convention (`walk-operation.ts`: `$`-prefixed keys are operators). String
+ * *values* like `$params.activeSince` are substitution references, never
+ * operators, so they are never flagged. `$and` / `$or` values are arrays of
+ * sub-filter objects and are walked recursively.
+ */
+export declare function collectUnknownOperators(value: any): string[];

package/dist/src/lib/query-operators.js

@@ -0,0 +1,80 @@
+/**
+ * Shared constant for the query operators an operation `filter` may use,
+ * plus a helper to find operator keys that aren't in the supported set.
+ *
+ * Background (issue #1255): a database-operation `filter` uses Mongo-style
+ * operators (`$gte`, `$in`, ...). A typo like `$gt` → `$gte` or an invented
+ * `$foo` silently passes `config push` (the server only validates `filter` is
+ * an object) and then throws `InvalidOperatorError` at *query execution*.
+ * The CLI can warn about unknown operators at push time so the author fixes
+ * it before it reaches runtime.
+ *
+ * The set mirrors the runtime translator
+ * (`packages/js-bao/src/query/JsonQueryTranslator.ts`): field operators
+ * (`translateFieldCondition` / substring ops) plus the two logical
+ * combinators special-cased in `translateFilter` (`$and` / `$or`).
+ *
+ * `$not` is intentionally NOT included — it is not a runtime operator; the
+ * translator only special-cases `$and` / `$or`, so `$not` would throw at
+ * execution just like any other unknown operator (codex review, #1255).
+ *
+ * This is deliberately a single source of truth so the validator and any
+ * future emitter/detector agree on what "known" means.
+ */
+/** Field-level comparison / membership / string operators. */
+export const FIELD_QUERY_OPERATORS = [
+    "$eq",
+    "$ne",
+    "$gt",
+    "$gte",
+    "$lt",
+    "$lte",
+    "$in",
+    "$nin",
+    "$exists",
+    "$contains",
+    "$startsWith",
+    "$endsWith",
+    "$containsText",
+];
+/** Logical combinators (arrays of sub-filters). */
+export const LOGICAL_QUERY_OPERATORS = ["$and", "$or"];
+/**
+ * Every operator the runtime query translator accepts. Any `$`-prefixed
+ * *key* inside a filter that is not in this set is unknown.
+ */
+export const SUPPORTED_QUERY_OPERATORS = new Set([
+    ...FIELD_QUERY_OPERATORS,
+    ...LOGICAL_QUERY_OPERATORS,
+]);
+/**
+ * Recursively collect the distinct `$`-prefixed *keys* used in a filter (or
+ * any nested value) that are not in {@link SUPPORTED_QUERY_OPERATORS}.
+ *
+ * Only object *keys* are considered operators — matching the runtime
+ * convention (`walk-operation.ts`: `$`-prefixed keys are operators). String
+ * *values* like `$params.activeSince` are substitution references, never
+ * operators, so they are never flagged. `$and` / `$or` values are arrays of
+ * sub-filter objects and are walked recursively.
+ */
+export function collectUnknownOperators(value) {
+    const unknown = new Set();
+    walk(value, unknown);
+    return [...unknown];
+}
+function walk(value, unknown) {
+    if (Array.isArray(value)) {
+        for (const item of value)
+            walk(item, unknown);
+        return;
+    }
+    if (value !== null && typeof value === "object") {
+        for (const [key, child] of Object.entries(value)) {
+            if (key.startsWith("$") && !SUPPORTED_QUERY_OPERATORS.has(key)) {
+                unknown.add(key);
+            }
+            walk(child, unknown);
+        }
+    }
+}
+//# sourceMappingURL=query-operators.js.map

package/dist/src/lib/query-operators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-operators.js","sourceRoot":"","sources":["../../../src/lib/query-operators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,qBAAqB,GAAsB;IACtD,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,SAAS;IACT,WAAW;IACX,aAAa;IACb,WAAW;IACX,eAAe;CAChB,CAAC;AAEF,mDAAmD;AACnD,MAAM,CAAC,MAAM,uBAAuB,GAAsB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE1E;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAwB,IAAI,GAAG,CAAC;IACpE,GAAG,qBAAqB;IACxB,GAAG,uBAAuB;CAC3B,CAAC,CAAC;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAU;IAChD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACrB,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;AACtB,CAAC;AAED,SAAS,IAAI,CAAC,KAAU,EAAE,OAAoB;IAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9C,OAAO;IACT,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/D,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;YACD,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/lib/record-filter.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Parse the shared `--filter` / `--filter-file` option pair used by the record
+ * read/query verbs on both surfaces: `databases records` (`query`, `count`,
+ * `aggregate`, `delete-all`) and `documents records` (`query`, `count`,
+ * `aggregate`).
+ *
+ * `--filter` takes an inline JSON object; `--filter-file` reads the filter from
+ * a JSON file, or a TOML file (either a top-level table or a `[filter]` section).
+ * The two options are mutually exclusive. All validation happens CLI-side so a
+ * malformed filter produces a clear error rather than a server 500.
+ *
+ * Exits the process with a clear message on bad input. Returns `undefined` when
+ * neither option is supplied.
+ */
+export declare function parseFilterOptions(options: {
+    filter?: string;
+    filterFile?: string;
+}): Record<string, any> | undefined;