photon-grid-core 2.0.0 → 2.0.4

package/photon-ai/provider/response-parsing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-parsing.js","sourceRoot":"","sources":["../../../src/photon-ai/provider/response-parsing.ts"],"names":[],"mappings":"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"}

package/photon-ai/provider/system-prompt.d.ts

@@ -0,0 +1,26 @@
+import type { PhotonGridContext } from './ai-provider.types';
+/**
+ * Assembles the system instruction sent to a generative provider. This is the
+ * "rules of the game": the assistant's role, the **exact** JSON output
+ * contract, and the parameter conventions for turning an intent key into an
+ * executable command.
+ *
+ * It deliberately contains no grid-specific data (columns, live state) — that
+ * travels separately as the structured {@link PhotonGridContext} so it can be
+ * serialized once and reasoned over as data. Keeping the two apart means the
+ * instruction is stable and cache-friendly while the context changes per
+ * prompt.
+ *
+ * The output contract matches {@link import('./ai-provider.types').PhotonAIGeneration}
+ * exactly, so a well-formed response drops straight into the existing command
+ * pipeline with no bespoke parsing.
+ */
+export declare function buildSystemInstruction(extraInstruction?: string): string;
+/**
+ * Serializes the structured grid context into the compact, labelled block a
+ * provider sends alongside the user's command. Kept out of
+ * {@link buildSystemInstruction} so the two can be transmitted as distinct
+ * request parts (system rules vs. per-prompt data).
+ */
+export declare function serializeGridContext(context: PhotonGridContext): string;
+//# sourceMappingURL=system-prompt.d.ts.map

package/photon-ai/provider/system-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../../src/photon-ai/provider/system-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAmDxE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAOvE"}

package/photon-ai/provider/system-prompt.js

@@ -0,0 +1,82 @@
+/**
+ * Assembles the system instruction sent to a generative provider. This is the
+ * "rules of the game": the assistant's role, the **exact** JSON output
+ * contract, and the parameter conventions for turning an intent key into an
+ * executable command.
+ *
+ * It deliberately contains no grid-specific data (columns, live state) — that
+ * travels separately as the structured {@link PhotonGridContext} so it can be
+ * serialized once and reasoned over as data. Keeping the two apart means the
+ * instruction is stable and cache-friendly while the context changes per
+ * prompt.
+ *
+ * The output contract matches {@link import('./ai-provider.types').PhotonAIGeneration}
+ * exactly, so a well-formed response drops straight into the existing command
+ * pipeline with no bespoke parsing.
+ */
+export function buildSystemInstruction(extraInstruction) {
+    const base = [
+        'You are Photon AI, the built-in assistant for Photon Grid, an enterprise data grid.',
+        'Your job: translate the user\'s natural-language request into concrete grid actions,',
+        'and/or answer questions about the grid using the provided context.',
+        '',
+        'You will be given, as JSON:',
+        '  • capabilities — the ONLY actions you may emit (each has a "type" key and a description),',
+        '  • columns — every column with its colId, header, data type, and flags,',
+        '  • state — the grid\'s current sort, filters, grouping, row/selection counts.',
+        '',
+        'RESPOND WITH A SINGLE JSON OBJECT, and nothing else, matching this shape:',
+        '{',
+        '  "actions": [ { "type": <capability type>, "params": { ... } } ],',
+        '  "reply": <short, friendly, first-person sentence describing what you did or answering the question>',
+        '}',
+        '',
+        'RULES:',
+        '  1. "type" MUST be one of the capability "type" values verbatim. Never invent an action.',
+        '  2. Reference columns ONLY by their exact "colId" from the columns list (not the header text).',
+        '  3. A request may map to MULTIPLE actions (e.g. "hide id and sort by price desc") — list them in order.',
+        '  4. If the request is a question about the grid (counts, current sort/filter, etc.), answer it in',
+        '     "reply" using the state/columns context and return "actions": []. Prefer the matching info',
+        '     capability (e.g. rowCount, sortInfo) when one exists.',
+        '  5. If you cannot map the request to any capability, return "actions": [] and explain briefly in "reply".',
+        '  6. Never include markdown, code fences, comments, or trailing text outside the JSON object.',
+        '  7. Keep "reply" concise (one or two sentences) and never expose colIds or internal jargon to the user.',
+        '',
+        'PARAMETER CONVENTIONS (params object per action type):',
+        '  • Single-column actions — sortAscending, sortDescending, hideColumn, showColumn, selectColumn,',
+        '    moveColumnToStart, moveColumnToEnd: { "colId": "<colId>" }',
+        '  • Multi-column actions — pinLeft, pinRight, unpin, groupBy: { "colIds": ["<colId>", ...] }',
+        '  • applyFilter: { "colId": "<colId>", "operator": <operator>, "value": <typed value>, "valueTo": <typed value, only for inRange> }',
+        '  • pinHalf: { "sides": ["left"] | ["right"] | ["left", "right"] }',
+        '  • Row-index actions — selectRow, expandRow, collapseRow: { "index": <1-based row number> }',
+        '  • Every other action (clearSort, clearFilters, unpinAll, hideAllColumns, showAllColumns, ungroup,',
+        '    expandAllGroups, collapseAllGroups, clearSelection, selectAllCells, copyAllCells, and all info',
+        '    actions): {}',
+        '',
+        'FILTER OPERATORS by column type:',
+        '  • string: contains, notContains, equals, notEquals, startsWith, endsWith, blank, notBlank',
+        '  • number/currency/percentage: equals, notEquals, greaterThan, greaterThanOrEqual, lessThan,',
+        '    lessThanOrEqual, inRange (needs value + valueTo)',
+        '  • date/time: equals, before, after, inRange (needs value + valueTo). Dates as ISO strings "YYYY-MM-DD".',
+        '  • boolean: equals with value true/false',
+        '  • dropdown: equals with value taken from that column\'s "options" list',
+        '  Emit numbers as JSON numbers, booleans as JSON booleans, dates as ISO strings — never quote a number.',
+    ].join('\n');
+    const extra = extraInstruction?.trim();
+    return extra ? `${base}\n\nADDITIONAL INSTRUCTIONS:\n${extra}` : base;
+}
+/**
+ * Serializes the structured grid context into the compact, labelled block a
+ * provider sends alongside the user's command. Kept out of
+ * {@link buildSystemInstruction} so the two can be transmitted as distinct
+ * request parts (system rules vs. per-prompt data).
+ */
+export function serializeGridContext(context) {
+    return [
+        'GRID CONTEXT:',
+        `capabilities: ${JSON.stringify(context.capabilities)}`,
+        `columns: ${JSON.stringify(context.columns)}`,
+        `state: ${JSON.stringify(context.state)}`,
+    ].join('\n');
+}
+//# sourceMappingURL=system-prompt.js.map

package/photon-ai/provider/system-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../../src/photon-ai/provider/system-prompt.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,sBAAsB,CAAC,gBAAyB;IAC9D,MAAM,IAAI,GAAG;QACX,qFAAqF;QACrF,sFAAsF;QACtF,oEAAoE;QACpE,EAAE;QACF,6BAA6B;QAC7B,6FAA6F;QAC7F,0EAA0E;QAC1E,gFAAgF;QAChF,EAAE;QACF,2EAA2E;QAC3E,GAAG;QACH,oEAAoE;QACpE,uGAAuG;QACvG,GAAG;QACH,EAAE;QACF,QAAQ;QACR,2FAA2F;QAC3F,iGAAiG;QACjG,0GAA0G;QAC1G,oGAAoG;QACpG,iGAAiG;QACjG,4DAA4D;QAC5D,4GAA4G;QAC5G,+FAA+F;QAC/F,0GAA0G;QAC1G,EAAE;QACF,wDAAwD;QACxD,kGAAkG;QAClG,gEAAgE;QAChE,8FAA8F;QAC9F,qIAAqI;QACrI,oEAAoE;QACpE,8FAA8F;QAC9F,qGAAqG;QACrG,oGAAoG;QACpG,kBAAkB;QAClB,EAAE;QACF,kCAAkC;QAClC,6FAA6F;QAC7F,+FAA+F;QAC/F,sDAAsD;QACtD,2GAA2G;QAC3G,2CAA2C;QAC3C,0EAA0E;QAC1E,yGAAyG;KAC1G,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,KAAK,GAAG,gBAAgB,EAAE,IAAI,EAAE,CAAC;IACvC,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,iCAAiC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA0B;IAC7D,OAAO;QACL,eAAe;QACf,iBAAiB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE;QACvD,YAAY,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;QAC7C,UAAU,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;KAC1C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}