primitive-admin 1.1.0-alpha.83 → 1.1.0-alpha.85

package/dist/src/lib/function-document-types.js

@@ -165,12 +165,24 @@ function documentSchemaProblem(source) {
         if (!data?.models) {
             return `${fileLabel(source)} has no [models] section`;
         }
+        // #3501 — a push is an authoring door, so a field name the engine
+        // reserves stops the schema here rather than at the server. `type` maps to
+        // the internal `_type` column, so a model declaring it would seed a
+        // document whose filters match the MODEL NAME instead of the stored value.
         loadSchemaFromTomlString(stringifyConfigToml({ models: data.models }), {
             strict: false,
+            rejectReservedFieldNames: true,
         });
     }
     catch (error) {
-        return `${fileLabel(source)} does not parse: ${String(error?.message ?? error).split("\n")[0]}`;
+        const message = String(error?.message ?? error).split("\n")[0];
+        // A reserved name is not a syntax error — the file parses, and saying it
+        // does not would send the author looking for a typo (matched on the
+        // error's NAME so the CLI needs no second import from js-bao).
+        if (error?.name === "ReservedFieldNameError") {
+            return `${fileLabel(source)} declares a reserved field name: ${message}`;
+        }
+        return `${fileLabel(source)} does not parse: ${message}`;
     }
     return null;
 }
@@ -252,21 +264,30 @@ export function renderDocumentTypesDeclaration(source) {
     }
     let schemas = [];
     let problem = null;
+    let reserved = false;
     try {
         const data = parseConfigToml(source.content);
         schemas = data?.models
             ? loadSchemaFromTomlString(stringifyConfigToml({ models: data.models }), {
                 strict: false,
+                // #3501 — the same refusal `documentSchemaProblem` makes, so a
+                // model the push will not carry is not typed here either. A
+                // generated `type?: string` would promise a field whose filters
+                // match the model name instead of the stored value.
+                rejectReservedFieldNames: true,
             })
             : [];
     }
     catch (error) {
         problem = String(error?.message ?? error);
+        reserved = error?.name === "ReservedFieldNameError";
     }
     if (problem !== null) {
         // No augmentation: an untyped handle is what a schemaless project gets
         // anyway, and the file is named so the author knows where to look.
-        lines.push(`// ${fileLabel(source)} does not parse, so it contributes no types:`);
+        lines.push(reserved
+            ? `// ${fileLabel(source)} declares a reserved field name, so it contributes no types:`
+            : `// ${fileLabel(source)} does not parse, so it contributes no types:`);
         for (const line of problem.split("\n").slice(0, 3))
             lines.push(`//   ${line}`);
         lines.push("export interface PrimitiveDocumentSchemas {}");

package/dist/src/lib/function-document-types.js.map

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

package/dist/src/lib/generated-config-surfaces.d.ts

@@ -87,6 +87,27 @@ export interface ConfigField {
     field: string;
     /** Key inside the TOML table (often identical to `field`). */
     tomlKey: string;
+    /**
+     * The SUB-TABLE inside this field's table that the key is authored under
+     * (#3626) — `tomlGroup: "chat"` means `[configs.chat].systemPrompt` rather
+     * than `systemPrompt` at the `[[configs]]` root.
+     *
+     * A statement of WHERE a key is authored and nothing else (#1976): the pull
+     * projection writes it there, the push builder reads it from there, the
+     * unknown-key check stops accepting it at the root, and the declared-type
+     * check labels it with the group. No behavior is attached, and the WIRE stays
+     * flat — the admin and app API bodies carry `systemPrompt` beside `questions`
+     * exactly as before, each its own typed column.
+     *
+     * Prompts are the first object to need it: a prompt declares a `kind` and a
+     * `[[configs]]` entry may carry only the block named by that kind, so the
+     * next kind (embeddings, rerank) is a group declaration plus its fields
+     * rather than another round of implicit discrimination.
+     *
+     * The group must be declared in the table's `tomlGroups`
+     * (`findBadTomlGroupDeclarations`).
+     */
+    tomlGroup?: string;
     type: FieldType;
     /** "whenSet" omits the key on pull when the value is empty; see #1033's `emit`. */
     emit: "always" | "whenSet";
@@ -165,6 +186,20 @@ export interface ConfigTable {
     /** The `models.yaml` model backing this table — the coverage anchor. */
     model: string;
     fields: readonly ConfigField[];
+    /**
+     * The CLOSED set of sub-table names this table's fields may be authored under
+     * (#3626), each with the reason it exists. A field's `tomlGroup` must name
+     * one of these, and a name declared here that no field uses is a failure —
+     * both checked by `findBadTomlGroupDeclarations`, the same rule `notExposed`
+     * follows one level down: absence from a hand-written list is never a
+     * decision.
+     *
+     * Omitted on every table whose keys are all authored at its root, which is
+     * all of them but `prompt`'s `[[configs]]`.
+     */
+    tomlGroups?: Readonly<Record<string, {
+        note: string;
+    }>>;
     /** Every model field not in `fields`, with its reason. Coverage is exhaustive. */
     notExposed: Readonly<Record<string, NotExposed>>;
     /**
@@ -559,8 +594,37 @@ export declare function findUnclassifiedSecretishFields(table: ConfigTable, mode
  * when the module or the export is missing (#2644 behavior 2b).
  */
 export declare function handlerReferences(table: ConfigTable): string[];
-/** TOML keys this table accepts: the exposed fields plus the declared extras. */
+/** The group names this table declares, sorted. Empty for an ungrouped table. */
+export declare function tomlGroupNames(table: ConfigTable): string[];
+/** The TOML keys accepted INSIDE `group`: every field that declares it. */
+export declare function acceptedGroupTomlKeys(table: ConfigTable, group: string): Set<string>;
+/**
+ * TOML keys this table accepts AT ITS ROOT: the UNGROUPED fields, the declared
+ * group names, and the declared extras.
+ *
+ * A grouped leaf written at the root (`questions` directly under `[[configs]]`)
+ * is therefore an unknown key rather than one the payload builder silently
+ * ignores (SO3626-013) — the builder reads a grouped field only from
+ * `source[group][tomlKey]`, so accepting it here would drop the author's value
+ * without a word. The nine deprecated flat chat keys stay accepted through
+ * their `tomlOnlyKeys` declarations, which is what keeps old files pushing.
+ */
 export declare function acceptedTomlKeys(table: ConfigTable): Set<string>;
+/**
+ * Keys inside a group table that no field declares under it, as
+ * `"<group>.<key>"` — plus the bare `"<group>"` for a group value that is not a
+ * table at all (`chat = "yes"`), which has no keys to check and would otherwise
+ * be read as an empty block.
+ */
+export declare function findUnknownGroupedTomlKeys(tomlTable: unknown, table: ConfigTable): string[];
+/**
+ * Group declarations that do not hold together: a field naming a group the
+ * table does not declare, a declared group no field is authored under, and a
+ * declaration with no reason. All three are failures, for the reason
+ * `notExposed` carries a note — a name in a list with nothing behind it reads
+ * as a decision and is not one.
+ */
+export declare function findBadTomlGroupDeclarations(table: ConfigTable): string[];
 /** Top-level TOML keys this object's file accepts: its tables plus the extras. */
 export declare function acceptedTomlDocumentKeys(surface: ConfigObjectSurface): Set<string>;
 /**
@@ -2102,6 +2166,123 @@ export declare function hasPromptReasoning(input: PromptReasoningInput): boolean
  * error and what the admin routes answer 400 with.
  */
 export declare function resolvePromptReasoning(input: PromptReasoningInput): PromptReasoningResolution;
+/**
+ * What a prompt's KIND admits — issue #3626.
+ *
+ * A prompt declares `[prompt] kind = "chat" | "decisions"`. The kind decides
+ * the input envelope (`variables` rendered into templates for chat, a `state`
+ * value for decisions), the provider endpoint the executor posts to, and which
+ * `[configs.<kind>]` block a `[[configs]]` entry may carry. Adding a kind is a
+ * group declaration plus its fields, not another round of implicit
+ * discrimination: the earlier design inferred "this is a decisions config" from
+ * the presence of `questions` on a table otherwise shaped for chat, and refused
+ * the nine chat keys one by one.
+ *
+ * This module is the whole rule. `resolvePromptKind` is called by the CLI's
+ * push preflight through the vendored artifact, by `createAppPrompt`,
+ * `createPromptConfig` and `updatePromptConfig`, so a refusal at push and a
+ * refusal at the admin route cannot disagree — the `resolvePromptReasoning`
+ * posture of #3358, for the same reason.
+ *
+ * Pure and dependency-free, like every module under `src/config-surface/`.
+ */
+/** The kinds a prompt may declare. An omitted `kind` is `chat`. */
+export declare const PROMPT_KINDS: readonly ["chat", "decisions"];
+export type PromptKind = (typeof PROMPT_KINDS)[number];
+/**
+ * The nine settings that describe a CHAT COMPLETION and nothing else. They are
+ * authored under `[configs.chat]`; the flat spelling is deprecated (#3642).
+ */
+export declare const CHAT_CONFIG_KEYS: readonly ["systemPrompt", "userPromptTemplate", "temperature", "topP", "maxTokens", "outputFormat", "outputSchema", "reasoningEffort", "reasoningBudget"];
+export type ChatConfigKey = (typeof CHAT_CONFIG_KEYS)[number];
+/** The settings that describe a DECISIONS request. */
+export declare const DECISIONS_CONFIG_KEYS: readonly ["questions"];
+/**
+ * The WIRE field names each kind's block holds. The config surface declares the
+ * same grouping through `ConfigField.tomlGroup`, and the drift guard asserts
+ * the two agree — so a chat key added to the surface without a home here (or
+ * the reverse) fails `cli-unit-tests` rather than being accepted under a
+ * decisions prompt.
+ */
+export declare const PROMPT_KIND_BLOCKS: Readonly<Record<PromptKind, readonly string[]>>;
+/** The question types TypeSafe's System One models answer. */
+export declare const DECISIONS_QUESTION_TYPES: readonly ["choice", "score", "noul"];
+export type DecisionsQuestionType = (typeof DECISIONS_QUESTION_TYPES)[number];
+/**
+ * The prompt's kind, normalized.
+ *
+ * Every reader goes through this: rows created before #3626 carry no `kind`
+ * attribute at all, and an absent one is `chat` everywhere — the detail route,
+ * pull, diff, execution and codegen.
+ */
+export declare function promptKindOf(prompt: unknown): PromptKind;
+/** The config values the rule reads — the wire spelling, not the TOML one. */
+export interface PromptKindConfigInput {
+    systemPrompt?: unknown;
+    userPromptTemplate?: unknown;
+    temperature?: unknown;
+    topP?: unknown;
+    maxTokens?: unknown;
+    outputFormat?: unknown;
+    outputSchema?: unknown;
+    reasoningEffort?: unknown;
+    reasoningBudget?: unknown;
+    questions?: unknown;
+}
+export interface PromptKindInput {
+    /** `[prompt].kind`. `null`, `undefined` and `""` are unset, meaning `chat`. */
+    kind?: unknown;
+    provider?: unknown;
+    model?: unknown;
+    /**
+     * The EFFECTIVE config: the payload value where the request carries one, the
+     * stored value otherwise. `outputSchema` here is the CONFIG's own field —
+     * never the prompt-level schema, which is legal on either kind (§3, SO3626-003).
+     */
+    config: PromptKindConfigInput;
+}
+export type PromptKindResolution = {
+    ok: true;
+    kind: "chat";
+} | {
+    ok: true;
+    kind: "decisions";
+    questions: Record<string, unknown>;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * The one rule: does this (kind, provider, config) triple describe something
+ * the platform can run?
+ *
+ * `{ ok: true, kind: "chat" }` is today's behavior byte for byte. The decisions
+ * arm returns the NORMALIZED questions so the caller stores one spelling
+ * whichever transport the author used.
+ */
+export declare function resolvePromptKind(input: PromptKindInput): PromptKindResolution;
+/** What the hoist did to one `[[configs]]` entry. */
+export interface DeprecatedChatKeyHoist {
+    /** A COPY of the entry with the flat chat keys moved under `chat`. */
+    entry: Record<string, unknown>;
+    /** The flat keys that were moved, sorted — what the warning names. */
+    moved: string[];
+    /** Keys set BOTH flat and under `[configs.chat]`; the caller refuses these. */
+    conflicts: string[];
+}
+/**
+ * Move the deprecated flat chat keys of one `[[configs]]` entry under `chat`
+ * — #3626 §4, the blob-bucket `accessPolicy` precedent made reusable.
+ *
+ * Push keeps accepting the nine keys flat so no existing file breaks, and pull
+ * rewrites them, so one pull-then-push migrates a file. A key present in BOTH
+ * spellings is not merged: the grouped value is left standing and the key is
+ * reported in `conflicts`, which the caller turns into a refusal naming the
+ * entry. Nothing else in the entry is touched — `providerConfig` is
+ * provider-keyed rather than chat-keyed (D3626-002) and `questions` has no flat
+ * spelling at all (SO3626-013).
+ */
+export declare function hoistDeprecatedChatKeys(entry: unknown): DeprecatedChatKeyHoist;
 export declare const PROMPT_SURFACE: ConfigObjectSurface;
 export declare const INTEGRATION_SURFACE: ConfigObjectSurface;
 export declare const WEBHOOK_SURFACE: ConfigObjectSurface;