@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/model/assist-edit.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/assist-edit.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { ScreenSeoTextField } from '@aglyn/aglyn/app-utils/screen-seo-fields'\nimport type { ReusableComponentProp } from '@aglyn/aglyn/foundation/definitions/platform.types'\n\n/**\n * Assist level 3, the edit contract (AGL-2906): what the chat door proposes\n * for a besigner canvas, and what the panel applies once the author says so.\n *\n * Shared by the server, which validates a model's proposal into these\n * shapes, and the client, which applies them. Pure data and pure functions,\n * so the panel imports it without pulling the palette or the runtime.\n *\n * ## The boundary\n *\n * A proposal is OPERATIONS, never a document. The server writes nothing: it\n * answers with ops that name elements already on the canvas, or a validated\n * subtree to insert, and the client applies them through the canvas's own\n * guarded mutators, on confirm, as one undoable step. Every change lands as\n * an unsaved edit on the version the editor has open — a draft — and on a\n * version the live site serves, the editor's own new-version flow runs first.\n */\n\n/** The eight operations a proposal may carry. */\nexport const ASSIST_EDIT_OP_KINDS = [\n  'insertSubtree',\n  'updateProps',\n  'updateSx',\n  'move',\n  'remove',\n  'setSeo',\n  'rename',\n  'saveAsComponent',\n] as const\n\nexport type AssistEditOpKind = (typeof ASSIST_EDIT_OP_KINDS)[number]\n\n/** The id of the besigner view's edit action — the one edit a view offers. */\nexport const ASSIST_EDIT_ACTION_ID = 'edit.canvas'\n\n/** The name of the structured-output tool a model proposes an edit through. */\nexport const ASSIST_EDIT_TOOL_NAME = 'propose_canvas_edit'\n\n/** The besigner documents the edit rung opens on: those that keep versions. */\nexport type AssistEditDocumentKind = 'screen' | 'component' | 'layout'\n\nexport const ASSIST_EDIT_DOCUMENT_KINDS: readonly AssistEditDocumentKind[] = [\n  'screen',\n  'component',\n  'layout',\n]\n\nconst COLLECTION_KINDS: Readonly<Record<string, AssistEditDocumentKind>> = {\n  screens: 'screen',\n  components: 'component',\n  layouts: 'layout',\n}\n\nconst BESIGNER_DOCUMENT_ROUTE =\n  /^\\/[^/]+\\/hosts\\/[^/]+\\/(screens|components|layouts)\\/([A-Za-z0-9_-]{1,64})\\/versions\\/([A-Za-z0-9_-]{1,64})\\/besigner\\/?$/\n\n/** The document a besigner route has open. */\nexport interface AssistEditDocument {\n  kind: AssistEditDocumentKind\n  documentId: string\n  versionId: string\n}\n\n/**\n * The open document off a console path, or null off a route the edit rung\n * serves. Only the versioned editors qualify — a template or an email editor\n * has no version to make first, so the rung does not open there.\n */\nexport function assistEditDocumentOf(route: string): AssistEditDocument | null {\n  const match = BESIGNER_DOCUMENT_ROUTE.exec(String(route ?? ''))\n  if (!match) return null\n  return {\n    kind: COLLECTION_KINDS[match[1]],\n    documentId: match[2],\n    versionId: match[3],\n  }\n}\n\n/* ------------------------------------------------------------------ *\n * What the client tells the server about the canvas\n * ------------------------------------------------------------------ */\n\n/** Elements a request describes at most — the selection, its surroundings, its subtree. */\nexport const ASSIST_EDIT_CONTEXT_MAX_NODES = 60\n/** Props described per element at most. */\nexport const ASSIST_EDIT_CONTEXT_MAX_PROPS = 16\n/** Characters of a string prop the selected element carries into a request. */\nexport const ASSIST_EDIT_SELECTED_TEXT_CHARS = 400\n/** Characters of a string prop every other element carries. */\nexport const ASSIST_EDIT_OUTLINE_TEXT_CHARS = 80\n\n/**\n * One element of the canvas outline a request carries. Ids, component ids\n * and short primitive values only — never a stored document, never markup.\n */\nexport interface AssistEditCanvasNode {\n  id: string\n  componentId: string\n  /** Null for the document root. */\n  parentId: string | null\n  /** Position among the parent's children. */\n  index: number\n  childCount: number\n  /** The layer name, when the author gave it one. */\n  name?: string\n  /** Primitive props, strings shortened. */\n  props?: Record<string, string | number | boolean>\n  /** The element's own styles — carried for the selected element only. */\n  sx?: Record<string, unknown>\n  /**\n   * Described by its place alone, without props: an element around the\n   * selection, there so the model knows it exists and can ask for it.\n   */\n  brief?: boolean\n  /**\n   * An element described earlier whose contents this one's are built like,\n   * the way the cards of a row are. Its own contents are left out.\n   */\n  like?: string\n}\n\nexport interface AssistEditCanvasContext {\n  /** The element the author has selected, or null. */\n  selectedId: string | null\n  /**\n   * Elements in the whole document, the root included, so the prompt can say\n   * how much of it `nodes` leaves out. Absent from an outline sent by a panel\n   * that predates it.\n   */\n  total?: number\n  nodes: AssistEditCanvasNode[]\n}\n\n/* ------------------------------------------------------------------ *\n * What the server proposes\n * ------------------------------------------------------------------ */\n\n/** An element of a validated subtree, in the flat shape the canvas stores. */\nexport interface AssistEditNode {\n  $id: string\n  componentId: string\n  pluginId?: string\n  parentId: string | null\n  nodes: string[]\n  props: Record<string, unknown>\n  sx?: Record<string, unknown>\n  hidden?: boolean\n}\n\n/**\n * Every op that acts on an element names the component the server validated\n * it as, so the client can refuse an element that has changed since.\n */\ninterface AssistEditNodeOpBase {\n  nodeId: string\n  componentId: string\n}\n\nexport interface AssistEditInsertOp {\n  op: 'insertSubtree'\n  parentId: string\n  /** The component the parent was validated as. */\n  parentComponentId: string\n  /** Position among the parent's children; null appends. */\n  index: number | null\n  rootId: string\n  nodes: Record<string, AssistEditNode>\n}\n\nexport interface AssistEditUpdatePropsOp extends AssistEditNodeOpBase {\n  op: 'updateProps'\n  /** Merged over the props the element has; nothing else it carries changes. */\n  props: Record<string, unknown>\n}\n\nexport interface AssistEditUpdateSxOp extends AssistEditNodeOpBase {\n  op: 'updateSx'\n  /** Merged over the element's own styles, one key at a time. */\n  sx: Record<string, unknown>\n}\n\nexport interface AssistEditMoveOp extends AssistEditNodeOpBase {\n  op: 'move'\n  parentId: string\n  /** The component the new parent was validated as. */\n  parentComponentId: string\n  index: number | null\n}\n\nexport interface AssistEditRemoveOp extends AssistEditNodeOpBase {\n  op: 'remove'\n}\n\nexport interface AssistEditRenameOp extends AssistEditNodeOpBase {\n  op: 'rename'\n  name: string\n}\n\nexport interface AssistEditSetSeoOp {\n  op: 'setSeo'\n  fields: Partial<Record<ScreenSeoTextField, string>>\n}\n\n/**\n * A property the promoted subtree declares (AGL-2908), in the shape the\n * Properties dialog stores one — without a default.\n *\n * The server never sees a full value: the outline it read the selection from\n * shortens every string. So the default is read off the live canvas at apply\n * time, from the very field the token is about to replace, which is what\n * makes the instance render what was there a moment before.\n */\nexport type AssistEditComponentProp = Omit<ReusableComponentProp, 'defaultValue'>\n\n/** Where one property's token goes: an element of the selection, and a field of it. */\nexport interface AssistEditPropBinding {\n  nodeId: string\n  /** The component the element was validated as, so a changed one is refused. */\n  componentId: string\n  /** A prop of that element, or `hideIf` for a part a Yes / no hides. */\n  field: string\n  /** The property whose `{{prop.<name>}}` token the field takes. */\n  prop: string\n}\n\n/**\n * Save the selection as a reusable component (AGL-2908), with the properties\n * the model proposed and the tokens bound into the tree.\n *\n * The only op that creates a document. It creates exactly the one the manual\n * Save as reusable component creates, through the same host resources route,\n * where the plan's entitlement and the route's allow-list are enforced — and\n * it changes the open canvas the same way that action does, by swapping the\n * promoted subtree for an instance. Nothing is published and nothing is\n * saved: the swap is an unsaved edit on the version the editor has open.\n */\nexport interface AssistEditSaveAsComponentOp extends AssistEditNodeOpBase {\n  op: 'saveAsComponent'\n  /** The name the component is created under. */\n  name: string\n  props: AssistEditComponentProp[]\n  bindings: AssistEditPropBinding[]\n}\n\nexport type AssistEditOp =\n  | AssistEditInsertOp\n  | AssistEditUpdatePropsOp\n  | AssistEditUpdateSxOp\n  | AssistEditMoveOp\n  | AssistEditRemoveOp\n  | AssistEditRenameOp\n  | AssistEditSetSeoOp\n  | AssistEditSaveAsComponentOp\n\n/** Where a proposal applies, as the server read it off the request. */\nexport interface AssistEditTarget extends AssistEditDocument {\n  hostId: string\n}\n\n/** The counts the card shows before the author decides. */\nexport interface AssistEditDiff {\n  /** Elements added, every element of every inserted subtree counted. */\n  added: number\n  /** Elements removed — each with whatever it contains. */\n  removed: number\n  propsChanged: number\n  stylesChanged: number\n  moved: number\n  renamed: number\n  /** Search fields filled in. */\n  seoFields: number\n  /** Properties the selection declares once it is saved as a component. */\n  componentProps: number\n  /** Selections saved as a reusable component — at most one per proposal. */\n  componentsSaved: number\n}\n\n/** The most reasons a proposal carries for the changes validation left out. */\nexport const ASSIST_EDIT_MAX_DROPPED_REASONS = 10\n\nexport interface AssistEditProposal {\n  id: typeof ASSIST_EDIT_ACTION_ID\n  /** One line, in the model's words, of what the edit does. */\n  summary: string\n  ops: AssistEditOp[]\n  diff: AssistEditDiff\n  /** Why each change the model wrote and validation refused was left out. */\n  dropped: string[]\n  target: AssistEditTarget\n}\n\n/** The counts for a list of ops. */\nexport function summarizeAssistEditOps(ops: readonly AssistEditOp[]): AssistEditDiff {\n  const diff: AssistEditDiff = {\n    added: 0,\n    removed: 0,\n    propsChanged: 0,\n    stylesChanged: 0,\n    moved: 0,\n    renamed: 0,\n    seoFields: 0,\n    componentProps: 0,\n    componentsSaved: 0,\n  }\n  for (const op of ops) {\n    switch (op.op) {\n      case 'insertSubtree':\n        diff.added += Object.keys(op.nodes).length\n        break\n      case 'remove':\n        diff.removed += 1\n        break\n      case 'updateProps':\n        diff.propsChanged += 1\n        break\n      case 'updateSx':\n        diff.stylesChanged += 1\n        break\n      case 'move':\n        diff.moved += 1\n        break\n      case 'rename':\n        diff.renamed += 1\n        break\n      case 'setSeo':\n        diff.seoFields += Object.keys(op.fields).length\n        break\n      case 'saveAsComponent':\n        diff.componentsSaved += 1\n        diff.componentProps += op.props.length\n        break\n    }\n  }\n  return diff\n}\n\nconst plural = (count: number, one: string, many: string): string =>\n  `${count} ${count === 1 ? one : many}`\n\n/** The diff as the lines a person reads, zero counts omitted. */\nexport function describeAssistEditDiff(diff: AssistEditDiff): string[] {\n  const lines: string[] = []\n  if (diff.added) lines.push(`${plural(diff.added, 'element', 'elements')} added`)\n  if (diff.removed) lines.push(`${plural(diff.removed, 'element', 'elements')} removed`)\n  if (diff.propsChanged) {\n    lines.push(`${plural(diff.propsChanged, 'element’s settings', 'elements’ settings')} changed`)\n  }\n  if (diff.stylesChanged) {\n    lines.push(`${plural(diff.stylesChanged, 'element', 'elements')} restyled`)\n  }\n  if (diff.moved) lines.push(`${plural(diff.moved, 'element', 'elements')} moved`)\n  if (diff.renamed) lines.push(`${plural(diff.renamed, 'layer', 'layers')} renamed`)\n  if (diff.seoFields) {\n    lines.push(`${plural(diff.seoFields, 'search field', 'search fields')} filled in`)\n  }\n  if (diff.componentsSaved) {\n    lines.push(\n      `saved as a reusable component with ${plural(diff.componentProps, 'property', 'properties')}`,\n    )\n  }\n  return lines\n}\n\n/** The word each op kind is counted under in the activity row. */\nconst OP_COUNT_WORDS: Readonly<Record<AssistEditOpKind, string>> = {\n  updateProps: 'set',\n  updateSx: 'restyle',\n  insertSubtree: 'insert',\n  move: 'move',\n  remove: 'remove',\n  rename: 'rename',\n  setSeo: 'seo',\n  saveAsComponent: 'component',\n}\n\n/** The applied ops counted by kind, as the activity row names them (`{ set: 3, insert: 1 }`). */\nexport function assistEditOpCounts(ops: readonly AssistEditOp[]): Record<string, number> {\n  const counts: Record<string, number> = {}\n  for (const op of ops) {\n    const word = OP_COUNT_WORDS[op.op]\n    if (word) counts[word] = (counts[word] ?? 0) + 1\n  }\n  return counts\n}\n\n/** The words `assistEditOpCounts` counts under, for a door that reads them back. */\nexport const ASSIST_EDIT_OP_COUNT_WORDS: readonly string[] = Object.values(OP_COUNT_WORDS)\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value)\n\n/**\n * Whether a `done` event's `edit` field is a proposal this client can apply.\n * The server built it, so this is a shape check rather than a validation: it\n * keeps a malformed or foreign payload from reaching the canvas mutators.\n */\nexport function isAssistEditProposal(value: unknown): value is AssistEditProposal {\n  if (!isRecord(value) || value['id'] !== ASSIST_EDIT_ACTION_ID) return false\n  const target = value['target']\n  if (!isRecord(target)) return false\n  if (!ASSIST_EDIT_DOCUMENT_KINDS.includes(target['kind'] as AssistEditDocumentKind)) return false\n  if (typeof target['documentId'] !== 'string' || !target['documentId']) return false\n  const ops = value['ops']\n  if (!Array.isArray(ops) || !ops.length) return false\n  return ops.every(\n    (op) => isRecord(op) && ASSIST_EDIT_OP_KINDS.includes(op['op'] as AssistEditOpKind),\n  )\n}\n\n/* ------------------------------------------------------------------ *\n * What the client reports once the author applied a proposal\n * ------------------------------------------------------------------ */\n\n/** The body of `POST /api/assist/edit-applied`. */\nexport interface AssistEditAppliedReport {\n  orgId: string\n  hostId: string\n  /** The exchange whose answer carried the proposal. */\n  exchangeId: string\n  documentKind: AssistEditDocumentKind\n  documentId: string\n  /** The version the edits landed on — a new one when the open one was live. */\n  versionId: string\n  opCounts: Record<string, number>\n}\n"],"names":["ASSIST_EDIT_OP_KINDS","ASSIST_EDIT_ACTION_ID","ASSIST_EDIT_TOOL_NAME","ASSIST_EDIT_DOCUMENT_KINDS","COLLECTION_KINDS","screens","components","layouts","BESIGNER_DOCUMENT_ROUTE","assistEditDocumentOf","route","match","exec","String","kind","documentId","versionId","ASSIST_EDIT_CONTEXT_MAX_NODES","ASSIST_EDIT_CONTEXT_MAX_PROPS","ASSIST_EDIT_SELECTED_TEXT_CHARS","ASSIST_EDIT_OUTLINE_TEXT_CHARS","ASSIST_EDIT_MAX_DROPPED_REASONS","summarizeAssistEditOps","ops","diff","added","removed","propsChanged","stylesChanged","moved","renamed","seoFields","componentProps","componentsSaved","op","Object","keys","nodes","length","fields","props","plural","count","one","many","describeAssistEditDiff","lines","push","OP_COUNT_WORDS","updateProps","updateSx","insertSubtree","move","remove","rename","setSeo","saveAsComponent","assistEditOpCounts","counts","word","ASSIST_EDIT_OP_COUNT_WORDS","values","isRecord","value","Array","isArray","isAssistEditProposal","target","includes","every"],"mappings":"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"}

package/src/lib/plugin-config.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { PluginConfigSchema } from '@aglyn/aglyn';
+import { type AiStepKind } from './providers/catalog';
+/**
+ * The org's AI settings (AGL-2939), stored in `pluginSettings/ai` and
+ * inherited per site the way every plugin setting is (AGL-428): which
+ * provider serves the workspace, and which catalog model each kind of step
+ * runs on. `platform` means "whatever the deployment's environment says",
+ * which is what every workspace runs with until it chooses.
+ *
+ * PURE DATA (type-only aglyn import): the client barrel registers it via
+ * '@aglyn/aglyn' and the /server entry via '@aglyn/aglyn/server'.
+ */
+/** The value that defers to the deployment's environment. */
+export declare const AI_SETTING_PLATFORM = "platform";
+/** The setting key each step kind's model override is stored under. */
+export declare const AI_STEP_MODEL_SETTING: Record<AiStepKind, string>;
+export declare const AI_CONFIG_SCHEMA: PluginConfigSchema;

package/src/lib/plugin-config.js

@@ -0,0 +1,118 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { _ as _extends } from "@swc/helpers/_/_extends";
+import { AI_PLUGIN_SETTINGS_ID } from "./constants.js";
+import { AI_CATALOG_PROVIDERS, AI_MODEL_CATALOG } from "./providers/catalog.js";
+/**
+ * The org's AI settings (AGL-2939), stored in `pluginSettings/ai` and
+ * inherited per site the way every plugin setting is (AGL-428): which
+ * provider serves the workspace, and which catalog model each kind of step
+ * runs on. `platform` means "whatever the deployment's environment says",
+ * which is what every workspace runs with until it chooses.
+ *
+ * PURE DATA (type-only aglyn import): the client barrel registers it via
+ * '@aglyn/aglyn' and the /server entry via '@aglyn/aglyn/server'.
+ */ /** The value that defers to the deployment's environment. */ export const AI_SETTING_PLATFORM = 'platform';
+/** The setting key each step kind's model override is stored under. */ export const AI_STEP_MODEL_SETTING = {
+    'assist.chat': 'chatModel',
+    'copy.element': 'copyElementModel',
+    'copy.section': 'copySectionModel',
+    'copy.blog': 'copyBlogModel',
+    'generate.section': 'generateModel',
+    'job.component': 'jobComponentModel',
+    'job.crm': 'jobCrmModel',
+    'job.experiment': 'jobExperimentModel',
+    'job.form': 'jobFormModel',
+    'job.insight': 'jobInsightModel',
+    'job.layout': 'jobLayoutModel',
+    'job.template': 'jobTemplateModel',
+    'job.page': 'jobPageModel',
+    'job.products': 'jobProductsModel',
+    'job.seo': 'jobSeoModel',
+    'job.text': 'jobTextModel',
+    'job.theme': 'jobThemeModel',
+    'job.plan': 'jobPlanModel',
+    'job.email': 'jobEmailModel',
+    'job.campaign': 'jobCampaignModel',
+    'job.workflow': 'jobWorkflowModel'
+};
+const MODEL_OPTIONS = [
+    {
+        value: AI_SETTING_PLATFORM,
+        label: 'Platform default'
+    },
+    ...AI_MODEL_CATALOG.map((entry)=>({
+            value: entry.id,
+            label: `${entry.label} (${entry.provider})`
+        }))
+];
+const modelField = (kind, label, description)=>({
+        key: AI_STEP_MODEL_SETTING[kind],
+        label,
+        type: 'select',
+        options: MODEL_OPTIONS,
+        description
+    });
+export const AI_CONFIG_SCHEMA = {
+    pluginId: AI_PLUGIN_SETTINGS_ID,
+    fields: [
+        {
+            key: 'provider',
+            label: 'AI provider',
+            type: 'select',
+            options: [
+                {
+                    value: AI_SETTING_PLATFORM,
+                    label: 'Platform default'
+                },
+                ...AI_CATALOG_PROVIDERS.map((provider)=>({
+                        value: provider.id,
+                        label: provider.label
+                    }))
+            ],
+            description: 'Which provider answers this workspace. A model chosen below must ' + 'be one the provider serves; otherwise the provider’s default for ' + 'that kind of step is used.'
+        },
+        modelField('assist.chat', 'Assistant model', 'The in-console assistant’s answers.'),
+        modelField('copy.element', 'Copy assistant (element) model', 'Rewriting one element’s text.'),
+        modelField('copy.section', 'Copy assistant (section) model', 'Writing a section’s copy.'),
+        modelField('copy.blog', 'Copy assistant (blog) model', 'Drafting a blog post.'),
+        modelField('generate.section', 'Section generation model', 'Generating a section’s structure.'),
+        modelField('job.component', 'Generation job (component) model', 'Generating a reusable component and its properties.'),
+        modelField('job.crm', 'Generation job (CRM) model', 'CRM record summaries and next steps, email drafts and import column matches.'),
+        modelField('job.experiment', 'Generation job (A/B test) model', 'Writing variants for an A/B test, and explaining what a test’s result means.'),
+        modelField('job.form', 'Generation job (form) model', 'Generating a form from a confirmed plan.'),
+        modelField('job.insight', 'Insights model', 'Answering a question about the site’s figures, and the weekly insights.'),
+        modelField('job.layout', 'Generation job (layout) model', 'Generating a shared layout from a confirmed plan.'),
+        modelField('job.template', 'Generation job (template) model', 'Generating a page template from a confirmed plan.'),
+        modelField('job.page', 'Generation job (page) model', 'Generating a page, one section at a time, from a confirmed plan.'),
+        modelField('job.products', 'Generation job (products) model', 'Writing product copy, and proposing products, categories and discounts for a store.'),
+        modelField('job.seo', 'Generation job (SEO) model', 'Search listings, image descriptions and a site audit’s fixes.'),
+        modelField('job.text', 'Generation job (text) model', 'The text step of a generation job.'),
+        modelField('job.theme', 'Generation job (theme) model', 'Proposing a change to a site’s theme.'),
+        modelField('job.plan', 'Generation job (plan) model', 'The plan step of a generation job.'),
+        modelField('job.email', 'Generation job (email) model', 'Generating an email design from a confirmed plan.'),
+        modelField('job.campaign', 'Generation job (campaign) model', 'Drafting a campaign and its email from a brief.'),
+        modelField('job.workflow', 'Generation job (automation) model', 'Drafting an automation from a description, and explaining one.')
+    ],
+    defaults: _extends({
+        provider: AI_SETTING_PLATFORM
+    }, Object.fromEntries(Object.values(AI_STEP_MODEL_SETTING).map((key)=>[
+            key,
+            AI_SETTING_PLATFORM
+        ])))
+};
+
+//# sourceMappingURL=plugin-config.js.map

package/src/lib/plugin-config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/plugins/ai/src/lib/plugin-config.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { PluginConfigSchema } from '@aglyn/aglyn'\nimport { AI_PLUGIN_SETTINGS_ID } from './constants'\nimport { AI_CATALOG_PROVIDERS, AI_MODEL_CATALOG, type AiStepKind } from './providers/catalog'\n\n/**\n * The org's AI settings (AGL-2939), stored in `pluginSettings/ai` and\n * inherited per site the way every plugin setting is (AGL-428): which\n * provider serves the workspace, and which catalog model each kind of step\n * runs on. `platform` means \"whatever the deployment's environment says\",\n * which is what every workspace runs with until it chooses.\n *\n * PURE DATA (type-only aglyn import): the client barrel registers it via\n * '@aglyn/aglyn' and the /server entry via '@aglyn/aglyn/server'.\n */\n\n/** The value that defers to the deployment's environment. */\nexport const AI_SETTING_PLATFORM = 'platform'\n\n/** The setting key each step kind's model override is stored under. */\nexport const AI_STEP_MODEL_SETTING: Record<AiStepKind, string> = {\n  'assist.chat': 'chatModel',\n  'copy.element': 'copyElementModel',\n  'copy.section': 'copySectionModel',\n  'copy.blog': 'copyBlogModel',\n  'generate.section': 'generateModel',\n  'job.component': 'jobComponentModel',\n  'job.crm': 'jobCrmModel',\n  'job.experiment': 'jobExperimentModel',\n  'job.form': 'jobFormModel',\n  'job.insight': 'jobInsightModel',\n  'job.layout': 'jobLayoutModel',\n  'job.template': 'jobTemplateModel',\n  'job.page': 'jobPageModel',\n  'job.products': 'jobProductsModel',\n  'job.seo': 'jobSeoModel',\n  'job.text': 'jobTextModel',\n  'job.theme': 'jobThemeModel',\n  'job.plan': 'jobPlanModel',\n  'job.email': 'jobEmailModel',\n  'job.campaign': 'jobCampaignModel',\n  'job.workflow': 'jobWorkflowModel',\n}\n\nconst MODEL_OPTIONS = [\n  { value: AI_SETTING_PLATFORM, label: 'Platform default' },\n  ...AI_MODEL_CATALOG.map((entry) => ({\n    value: entry.id,\n    label: `${entry.label} (${entry.provider})`,\n  })),\n]\n\nconst modelField = (kind: AiStepKind, label: string, description: string) => ({\n  key: AI_STEP_MODEL_SETTING[kind],\n  label,\n  type: 'select' as const,\n  options: MODEL_OPTIONS,\n  description,\n})\n\nexport const AI_CONFIG_SCHEMA: PluginConfigSchema = {\n  pluginId: AI_PLUGIN_SETTINGS_ID,\n  fields: [\n    {\n      key: 'provider',\n      label: 'AI provider',\n      type: 'select',\n      options: [\n        { value: AI_SETTING_PLATFORM, label: 'Platform default' },\n        ...AI_CATALOG_PROVIDERS.map((provider) => ({ value: provider.id, label: provider.label })),\n      ],\n      description:\n        'Which provider answers this workspace. A model chosen below must ' +\n        'be one the provider serves; otherwise the provider’s default for ' +\n        'that kind of step is used.',\n    },\n    modelField('assist.chat', 'Assistant model', 'The in-console assistant’s answers.'),\n    modelField('copy.element', 'Copy assistant (element) model', 'Rewriting one element’s text.'),\n    modelField('copy.section', 'Copy assistant (section) model', 'Writing a section’s copy.'),\n    modelField('copy.blog', 'Copy assistant (blog) model', 'Drafting a blog post.'),\n    modelField('generate.section', 'Section generation model', 'Generating a section’s structure.'),\n    modelField('job.component', 'Generation job (component) model', 'Generating a reusable component and its properties.'),\n    modelField('job.crm', 'Generation job (CRM) model', 'CRM record summaries and next steps, email drafts and import column matches.'),\n    modelField(\n      'job.experiment',\n      'Generation job (A/B test) model',\n      'Writing variants for an A/B test, and explaining what a test’s result means.',\n    ),\n    modelField('job.form', 'Generation job (form) model', 'Generating a form from a confirmed plan.'),\n    modelField('job.insight', 'Insights model', 'Answering a question about the site’s figures, and the weekly insights.'),\n    modelField('job.layout', 'Generation job (layout) model', 'Generating a shared layout from a confirmed plan.'),\n    modelField('job.template', 'Generation job (template) model', 'Generating a page template from a confirmed plan.'),\n    modelField('job.page', 'Generation job (page) model', 'Generating a page, one section at a time, from a confirmed plan.'),\n    modelField('job.products', 'Generation job (products) model', 'Writing product copy, and proposing products, categories and discounts for a store.'),\n    modelField('job.seo', 'Generation job (SEO) model', 'Search listings, image descriptions and a site audit’s fixes.'),\n    modelField('job.text', 'Generation job (text) model', 'The text step of a generation job.'),\n    modelField('job.theme', 'Generation job (theme) model', 'Proposing a change to a site’s theme.'),\n    modelField('job.plan', 'Generation job (plan) model', 'The plan step of a generation job.'),\n    modelField('job.email', 'Generation job (email) model', 'Generating an email design from a confirmed plan.'),\n    modelField('job.campaign', 'Generation job (campaign) model', 'Drafting a campaign and its email from a brief.'),\n    modelField('job.workflow', 'Generation job (automation) model', 'Drafting an automation from a description, and explaining one.'),\n  ],\n  defaults: {\n    provider: AI_SETTING_PLATFORM,\n    ...Object.fromEntries(\n      Object.values(AI_STEP_MODEL_SETTING).map((key) => [key, AI_SETTING_PLATFORM]),\n    ),\n  },\n}\n"],"names":["AI_PLUGIN_SETTINGS_ID","AI_CATALOG_PROVIDERS","AI_MODEL_CATALOG","AI_SETTING_PLATFORM","AI_STEP_MODEL_SETTING","MODEL_OPTIONS","value","label","map","entry","id","provider","modelField","kind","description","key","type","options","AI_CONFIG_SCHEMA","pluginId","fields","defaults","Object","fromEntries","values"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;AAGD,SAASA,qBAAqB,QAAQ,iBAAa;AACnD,SAASC,oBAAoB,EAAEC,gBAAgB,QAAyB,yBAAqB;AAE7F;;;;;;;;;CASC,GAED,2DAA2D,GAC3D,OAAO,MAAMC,sBAAsB,WAAU;AAE7C,qEAAqE,GACrE,OAAO,MAAMC,wBAAoD;IAC/D,eAAe;IACf,gBAAgB;IAChB,gBAAgB;IAChB,aAAa;IACb,oBAAoB;IACpB,iBAAiB;IACjB,WAAW;IACX,kBAAkB;IAClB,YAAY;IACZ,eAAe;IACf,cAAc;IACd,gBAAgB;IAChB,YAAY;IACZ,gBAAgB;IAChB,WAAW;IACX,YAAY;IACZ,aAAa;IACb,YAAY;IACZ,aAAa;IACb,gBAAgB;IAChB,gBAAgB;AAClB,EAAC;AAED,MAAMC,gBAAgB;IACpB;QAAEC,OAAOH;QAAqBI,OAAO;IAAmB;OACrDL,iBAAiBM,GAAG,CAAC,CAACC,QAAW,CAAA;YAClCH,OAAOG,MAAMC,EAAE;YACfH,OAAO,GAAGE,MAAMF,KAAK,CAAC,EAAE,EAAEE,MAAME,QAAQ,CAAC,CAAC,CAAC;QAC7C,CAAA;CACD;AAED,MAAMC,aAAa,CAACC,MAAkBN,OAAeO,cAAyB,CAAA;QAC5EC,KAAKX,qBAAqB,CAACS,KAAK;QAChCN;QACAS,MAAM;QACNC,SAASZ;QACTS;IACF,CAAA;AAEA,OAAO,MAAMI,mBAAuC;IAClDC,UAAUnB;IACVoB,QAAQ;QACN;YACEL,KAAK;YACLR,OAAO;YACPS,MAAM;YACNC,SAAS;gBACP;oBAAEX,OAAOH;oBAAqBI,OAAO;gBAAmB;mBACrDN,qBAAqBO,GAAG,CAAC,CAACG,WAAc,CAAA;wBAAEL,OAAOK,SAASD,EAAE;wBAAEH,OAAOI,SAASJ,KAAK;oBAAC,CAAA;aACxF;YACDO,aACE,sEACA,sEACA;QACJ;QACAF,WAAW,eAAe,mBAAmB;QAC7CA,WAAW,gBAAgB,kCAAkC;QAC7DA,WAAW,gBAAgB,kCAAkC;QAC7DA,WAAW,aAAa,+BAA+B;QACvDA,WAAW,oBAAoB,4BAA4B;QAC3DA,WAAW,iBAAiB,oCAAoC;QAChEA,WAAW,WAAW,8BAA8B;QACpDA,WACE,kBACA,mCACA;QAEFA,WAAW,YAAY,+BAA+B;QACtDA,WAAW,eAAe,kBAAkB;QAC5CA,WAAW,cAAc,iCAAiC;QAC1DA,WAAW,gBAAgB,mCAAmC;QAC9DA,WAAW,YAAY,+BAA+B;QACtDA,WAAW,gBAAgB,mCAAmC;QAC9DA,WAAW,WAAW,8BAA8B;QACpDA,WAAW,YAAY,+BAA+B;QACtDA,WAAW,aAAa,gCAAgC;QACxDA,WAAW,YAAY,+BAA+B;QACtDA,WAAW,aAAa,gCAAgC;QACxDA,WAAW,gBAAgB,mCAAmC;QAC9DA,WAAW,gBAAgB,qCAAqC;KACjE;IACDS,UAAU;QACRV,UAAUR;OACPmB,OAAOC,WAAW,CACnBD,OAAOE,MAAM,CAACpB,uBAAuBI,GAAG,CAAC,CAACO,MAAQ;YAACA;YAAKZ;SAAoB;AAGlF,EAAC"}

package/src/lib/plugin.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * The Aglyn AI plugin's console half (AGL-2939): the assistant dock, the
+ * besigner copy assistant's provider, the billing, member and staff cards,
+ * the member tables' credit columns and the Assist signal staff page — each
+ * mounted through a shell-owned zone (AGL-2940) or the staff area's generic
+ * route, so no console page imports this plugin.
+ *
+ * No `featureFlag` on the extension: the plugin's doors are gated one by
+ * one — the dock reads the `release_assist` verdict the shell hands it, the
+ * generative doors answer 404 behind `release_ai_generative`, the billing
+ * cards render only where the plan sells a band — and a flag here would
+ * switch off the released doors with the unreleased ones.
+ */
+export declare function registerAiConsole(): void;