pgkiln 0.69.0 → 0.71.0

package/src/builder/features.ts

@@ -0,0 +1,313 @@
+import type { FastifyInstance } from 'fastify';
+import { owner, type Client } from '../db.ts';
+import { html, raw, type Raw } from '../html.ts';
+import { icon } from '../icons.ts';
+import { appPublicKey } from '../push.ts';
+import { secretKeyConfigured } from '../secrets.ts';
+import { appOr404 } from './forms.ts';
+import { createLoginPage } from './login-page.ts';
+import { ABOUT_PAGE, ACTIVITY_PAGE, addAboutPage, addAccessSchemes, addActivityPage, ensureAdminScheme } from './newapp.ts';
+import { appHeader, back, BASE, csrf, developer, flash, region, send, shell, type Req } from './ui.ts';
+
+// (sprint 137, AP-3) Add feature (APEX: Create a Page → Feature, and App home → Tasks → Add Feature Page):
+// the Create Application wizard's features (newapp.ts) and a few more, added to an existing application.
+// Each says what it adds before it creates anything, refuses to install twice, and shows as installed
+// (greyed out) on the Create page grid's Feature tab afterwards. Everything is a plain form.
+
+/** The page number of the Configuration page (Configuration options). */
+export const CONFIG_PAGE = 9020;
+
+interface AppRow {
+  id: number;
+  alias: string;
+  name: string;
+  authentication: string;
+  feedback: boolean;
+  pwa: boolean;
+  pwa_push: boolean;
+  login_page: number | null;
+  theme: Record<string, unknown> | null;
+}
+
+export interface Feature {
+  key: string;
+  label: string;
+  icon: string;
+  help: string;
+  /** what installing adds, in words */
+  adds: (a: AppRow) => string[];
+  /** installed already */
+  installed: (c: Client, a: AppRow) => Promise<boolean>;
+  /** why it can't be installed (when not installed), or null */
+  blocked?: (c: Client, a: AppRow) => Promise<string | null>;
+  /** fields of the review form */
+  fields?: (a: AppRow) => Promise<Raw | string>;
+  /** install (in the caller's transaction); returns the page to open, if any */
+  install: (c: Client, a: AppRow, b: Record<string, unknown>) => Promise<number | null>;
+}
+
+const pageExists = async (c: Client, appId: number, no: number) => !!(await c.query('select 1 from meta.page where app_id = $1 and page_no = $2', [appId, no])).rowCount;
+const pageId = async (c: Client, appId: number, no: number) => (await c.query<{ id: number }>('select id from meta.page where app_id = $1 and page_no = $2', [appId, no])).rows[0]?.id ?? null;
+/** a page of the feature: the page number holds a component whose code mentions the marker */
+const pageHas = async (c: Client, appId: number, no: number, marker: string) =>
+  !!(await c.query(
+    `select 1 from meta.page p where p.app_id = $1 and p.page_no = $2
+        and (exists (select 1 from meta.region r where r.page_id = p.id and r.source like '%' || $3 || '%')
+          or exists (select 1 from meta.item i where i.page_id = p.id and i.lov like '%' || $3 || '%')
+          or exists (select 1 from meta.process x where x.page_id = p.id and x.code like '%' || $3 || '%'))`,
+    [appId, no, marker],
+  )).rowCount;
+
+const EMAIL = /^[^\s@,;<>"]+@[^\s@,;<>"]+\.[^\s@,;<>"]+$/;
+
+export const FEATURE_LIST: Feature[] = [
+  {
+    key: 'access',
+    label: 'Access control',
+    icon: 'lock',
+    help: 'Authorization schemes for the roles admin, contributor and reader, to put on pages, regions and buttons.',
+    adds: () => [
+      'Authorization schemes CONTRIBUTOR (role admin or contributor) and READER (admin, contributor or reader), and ADMIN when the application has none',
+      'Give users their roles under Shared Components → Users (application access)',
+    ],
+    installed: async (c, a) => (await c.query(`select count(*)::int as n from meta.authz_scheme where app_id = $1 and name in ('CONTRIBUTOR', 'READER')`, [a.id])).rows[0].n === 2,
+    install: async (c, a) => {
+      await addAccessSchemes(c, a.id);
+      return null;
+    },
+  },
+  {
+    key: 'activity',
+    label: 'Activity reporting',
+    icon: 'activity',
+    help: 'A page for administrators with the page views per day and the latest activity.',
+    adds: () => [
+      `Page ${ACTIVITY_PAGE} "Activity" (authorization ADMIN): a chart of the page views per day and a report of the latest activity, from meta.app_activity()`,
+      'A navigation entry Activity for administrators',
+      'Authorization scheme ADMIN (role admin) when the application has none',
+    ],
+    installed: (c, a) => pageHas(c, a.id, ACTIVITY_PAGE, 'meta.app_activity'),
+    blocked: async (c, a) => ((await pageExists(c, a.id, ACTIVITY_PAGE)) ? `Page ${ACTIVITY_PAGE} is in use by another page.` : null),
+    install: async (c, a) => {
+      await addActivityPage(c, a.id);
+      return pageId(c, a.id, ACTIVITY_PAGE);
+    },
+  },
+  {
+    key: 'config',
+    label: 'Configuration options',
+    icon: 'sliders',
+    help: 'A page where the application\'s administrators switch build options on and off while it runs.',
+    adds: () => [
+      `Page ${CONFIG_PAGE} "Configuration" (authorization ADMIN): the configurable build options as switches, and Save`,
+      'The build options ticked below become configurable (Shared Components → Build options → Configurable)',
+      'A navigation entry Configuration for administrators',
+    ],
+    installed: (c, a) => pageHas(c, a.id, CONFIG_PAGE, 'meta.set_configurable_options'),
+    blocked: async (c, a) => ((await pageExists(c, a.id, CONFIG_PAGE)) ? `Page ${CONFIG_PAGE} is in use by another page.` : null),
+    fields: async (a) => {
+      const opts = (await owner.query<{ name: string; description: string | null; status: string; configurable: boolean }>(
+        'select name, description, status, configurable from meta.build_option where app_id = $1 order by name', [a.id])).rows;
+      return opts.length
+        ? html`<fieldset class="prop-group"><legend>Configurable build options</legend><div class="qb-pick">${opts.map((o) =>
+            html`<label class="check"><input type="checkbox" name="options" value="${o.name}"${o.configurable ? raw(' checked') : ''}> ${o.name} <span class="muted small">${o.status}${o.description ? `, ${o.description}` : ''}</span></label>`)}</div></fieldset>`
+        : html`<p class="muted">The application has no build options yet: add them under Shared Components → Build options and tick <em>Configurable</em>; the page shows them as they come.</p>`;
+    },
+    install: async (c, a, b) => {
+      const chosen = ([] as unknown[]).concat(b.options ?? []).map(String);
+      await c.query('update meta.build_option set configurable = (name = any($2)) where app_id = $1', [a.id, chosen]);
+      await ensureAdminScheme(c, a.id);
+      const home = (await c.query('select home_page from meta.app where id = $1', [a.id])).rows[0].home_page;
+      const page = (await c.query(`insert into meta.page (app_id, page_no, name, title, parent_page, authz) values ($1, $2, 'Configuration', 'Configuration', $3, 'ADMIN') returning id`, [a.id, CONFIG_PAGE, home])).rows[0].id;
+      const regionId = (await c.query(`insert into meta.region (page_id, seq, title, type) values ($1, 10, 'Configuration options', 'form') returning id`, [page])).rows[0].id;
+      const item = `P${CONFIG_PAGE}_OPTIONS`;
+      await c.query(
+        `insert into meta.item (page_id, region_id, seq, name, label, type, lov, config, help) values ($1, $2, 10, $3, 'Options', 'checkbox_group',
+           'select description as d, name as r from meta.configurable_options()', '{"switches": true}', 'Switched on: the parts of the application that belong to the option are shown.')`,
+        [page, regionId, item],
+      );
+      await c.query(
+        `insert into meta.computation (page_id, seq, item_name, point, type, expression) values ($1, 10, $2, 'before_header', 'sql_query',
+           'select string_agg(name, '':'' order by name) from meta.configurable_options() where enabled')`,
+        [page, item],
+      );
+      await c.query(`insert into meta.button (page_id, region_id, seq, name, label, action, hot) values ($1, $2, 10, 'SAVE', 'Save', 'submit', true)`, [page, regionId]);
+      await c.query(
+        `insert into meta.process (page_id, seq, name, type, code, when_button, success_message) values ($1, 10, 'Save the configuration', 'sql', $2, 'SAVE', 'Configuration saved.')`,
+        [page, `select meta.set_configurable_options(:${item})`],
+      );
+      await c.query(`insert into meta.nav_entry (app_id, seq, label, icon, target_page, authz) values ($1, 9020, 'Configuration', 'sliders', $2, 'ADMIN')`, [a.id, CONFIG_PAGE]);
+      return page;
+    },
+  },
+  {
+    key: 'email',
+    label: 'E-mail reporting',
+    icon: 'mail',
+    help: 'A weekly e-mail to the administrators with the application\'s activity, the rows as a CSV file.',
+    adds: () => [
+      'Application setting EMAIL_REPORT_TO: the addresses the report goes to (Shared Components → Application settings)',
+      'Automation EMAIL_REPORTING, every Monday at 07:00 UTC: meta.send_activity_report() with the last 7 days (Shared Components → Automations)',
+      'Mail goes out through the application\'s mail service (Workspace utilities → Mail services); without addresses nothing is sent',
+    ],
+    installed: async (c, a) => !!(await c.query(`select 1 from meta.automation where app_id = $1 and name = 'EMAIL_REPORTING'`, [a.id])).rowCount,
+    fields: async () => html`<div class="field"><label class="label" for="f_report_to">Send it to</label>
+        <input id="f_report_to" name="report_to" type="text" placeholder="admin@example.com, boss@example.com" autocomplete="off">
+        <small class="help">Comma separated; may stay empty and be set later in Shared Components → Application settings (EMAIL_REPORT_TO).</small></div>`,
+    install: async (c, a, b) => {
+      const to = String(b.report_to ?? '').split(',').map((x) => x.trim()).filter(Boolean);
+      const bad = to.find((x) => !EMAIL.test(x));
+      if (bad) throw new Error(`"${bad.slice(0, 100)}" is not an e-mail address.`);
+      if (to.join(', ').length > 4000) throw new Error('Too many addresses.');
+      await c.query(
+        `insert into meta.app_setting (app_id, name, value, description) values ($1, 'EMAIL_REPORT_TO', $2, 'E-mail reporting: the addresses of the weekly activity report (comma separated)')
+         on conflict (app_id, name) do nothing`,
+        [a.id, to.join(', ') || null],
+      );
+      await c.query(
+        `insert into meta.automation (app_id, name, description, schedule, time_zone) values ($1, 'EMAIL_REPORTING', 'E-mail reporting: the activity of the last 7 days to EMAIL_REPORT_TO', '0 7 * * 1', 'UTC')`,
+        [a.id],
+      );
+      await c.query(`insert into meta.automation_action (app_id, automation_name, seq, name, code) values ($1, 'EMAIL_REPORTING', 10, 'Send the activity report', $2)`, [a.id, CODE_EMAIL]);
+      return null;
+    },
+  },
+  {
+    key: 'feedback',
+    label: 'Feedback',
+    icon: 'message-square',
+    help: 'Users send feedback from the header; you read it under the application\'s Activity → Feedback.',
+    adds: () => ['A Feedback entry in the header for signed-in users (Settings → Feedback)', 'Their feedback, with the page, under Activity → Feedback in the builder'],
+    installed: async (_c, a) => a.feedback,
+    install: async (c, a) => {
+      await c.query('update meta.app set feedback = true, updated_at = now() where id = $1', [a.id]);
+      return null;
+    },
+  },
+  {
+    key: 'about',
+    label: 'About page',
+    icon: 'info',
+    help: 'An About page in a Help menu of the header.',
+    adds: () => [`Page ${ABOUT_PAGE} "About" with the application's name and the pages of its menu`, 'A Help menu with About in the navigation bar (list NAVBAR), unless the application has a navigation bar list already'],
+    installed: (c, a) => pageExists(c, a.id, ABOUT_PAGE),
+    install: async (c, a) => {
+      await addAboutPage(c, a.id);
+      return pageId(c, a.id, ABOUT_PAGE);
+    },
+  },
+  {
+    key: 'login',
+    label: 'Login page',
+    icon: 'log-in',
+    help: 'The application\'s own login page instead of the built-in sign-in page, editable in the Page Designer.',
+    adds: () => ['Page 9999 (or the next free number) "Login": public, page template Minimal, with a Login region', 'It becomes the login page (Settings → Sign-in methods)'],
+    installed: async (_c, a) => a.login_page !== null,
+    blocked: async (_c, a) => (a.authentication === 'none' ? 'The application has no sign-in (authentication none).' : null),
+    install: async (c, a) => (await createLoginPage(c, a)).page,
+  },
+  {
+    key: 'theme',
+    label: 'Theme style selection',
+    icon: 'palette',
+    help: 'Users choose the light or the dark theme in their user menu (Appearance).',
+    adds: () => ['Appearance in the user menu: light, dark or the device\'s setting (Settings → Theme → Users may choose)'],
+    installed: async (_c, a) => a.theme?.user_choice !== false,
+    install: async (c, a) => {
+      await c.query(`update meta.app set theme = coalesce(theme, '{}') - 'user_choice', updated_at = now() where id = $1`, [a.id]);
+      return null;
+    },
+  },
+  {
+    key: 'push',
+    label: 'Push notifications',
+    icon: 'bell',
+    help: 'Notifications to the users\' devices, from processes and SQL (meta.send_push); the application becomes installable.',
+    adds: () => ['Install as an app (PWA): a manifest, a service worker and an Install button', 'Push notifications: users subscribe on My account; send with the send_push process or meta.send_push', 'The application\'s push key pair (kept encrypted)'],
+    installed: async (_c, a) => a.pwa_push,
+    blocked: async () => (secretKeyConfigured() ? null : 'Push notifications need PGKILN_SECRET_KEY in the server\'s environment.'),
+    install: async (c, a) => {
+      await c.query('update meta.app set pwa = true, pwa_push = true, updated_at = now() where id = $1', [a.id]);
+      return null;
+    },
+  },
+];
+
+const CODE_EMAIL = `select meta.send_activity_report(meta.get_app_setting('EMAIL_REPORT_TO'), 7)`;
+
+const FEATURES_BY_KEY = new Map(FEATURE_LIST.map((f) => [f.key, f]));
+
+async function appRow(id: string | number, c?: Client): Promise<AppRow | null> {
+  const q = 'select id, alias, name, authentication, feedback, pwa, pwa_push, login_page, theme from meta.app where id = $1';
+  return c ? ((await c.query<AppRow>(q, [id])).rows[0] ?? null) : ((await owner.one<AppRow>(q, [id])) ?? null);
+}
+
+/** Each feature with whether it is installed or blocked, for the Feature tab. */
+export async function featureStates(appId: number) {
+  return owner.tx(async (c) => {
+    const a = (await appRow(appId, c))!;
+    const out: { f: Feature; installed: boolean; blocked: string | null }[] = [];
+    for (const f of FEATURE_LIST) {
+      const installed = await f.installed(c, a);
+      out.push({ f, installed, blocked: installed ? null : ((await f.blocked?.(c, a)) ?? null) });
+    }
+    return out;
+  });
+}
+
+export async function featureRoutes(app: FastifyInstance) {
+  // the review: what the feature adds, and Install (or why not)
+  app.get(`${BASE}/apps/:id/features/:key`, async (req: Req, reply) => {
+    const s = await developer(req, reply);
+    if (!s) return;
+    const a0 = await appOr404(req.params.id);
+    const f = FEATURES_BY_KEY.get(String(req.params.key));
+    if (!a0 || !f) return reply.code(404).send('Not found');
+    const a = (await appRow(a0.id))!;
+    const { installed, blocked } = await owner.tx(async (c) => {
+      const installed = await f.installed(c, a);
+      return { installed, blocked: installed ? null : ((await f.blocked?.(c, a)) ?? null) };
+    });
+    const main = html`${appHeader(a0, 'pages', s)}
+      ${region(f.label, html`
+        <p class="muted u-mt0">${icon(f.icon)} ${f.help}</p>
+        ${installed
+          ? html`<p class="alert alert-info" role="status">${f.label} is installed in this application already.</p>`
+          : blocked ? html`<p class="alert alert-error" role="status">${blocked}</p>` : ''}
+        <h3>${installed ? 'It added' : 'It adds'}</h3>
+        <ul class="cp-adds">${f.adds(a).map((x) => html`<li>${x}</li>`)}</ul>
+        ${installed || blocked
+          ? html`<div class="buttons"><a class="btn" href="${BASE}/apps/${a.id}/create-page?tab=feature">Back to the features</a></div>`
+          : html`<form method="post" action="${BASE}/apps/${a.id}/features/${f.key}">${csrf(s)}
+              ${f.fields ? await f.fields(a) : ''}
+              <div class="buttons"><a class="btn" href="${BASE}/apps/${a.id}/create-page?tab=feature">Cancel</a><button class="btn btn-hot">Add ${f.label.toLowerCase()}</button></div>
+            </form>`}`)}`;
+    return send(reply, s, shell(s, `${f.label} · ${a.name}`, [['App Builder', BASE], [a.name, `${BASE}/apps/${a.id}`], ['Create page', `${BASE}/apps/${a.id}/create-page?tab=feature`], [f.label]], main));
+  });
+
+  app.post(`${BASE}/apps/:id/features/:key`, async (req: Req, reply) => {
+    const s = await developer(req, reply);
+    if (!s) return;
+    const f = FEATURES_BY_KEY.get(String(req.params.key));
+    if (!f || !(await appRow(req.params.id))) return reply.code(404).send('Not found');
+    const b = (req.body ?? {}) as Record<string, unknown>;
+    try {
+      const page = await owner.tx(async (c) => {
+        // one at a time per application, and never twice
+        await c.query('select 1 from meta.app where id = $1 for update', [req.params.id]);
+        const a = (await appRow(req.params.id, c))!;
+        if (await f.installed(c, a)) throw new Error(`${f.label} is installed in this application already.`);
+        const blocked = await f.blocked?.(c, a);
+        if (blocked) throw new Error(blocked);
+        return f.install(c, a, b);
+      });
+      // the push key pair after the commit (as the Create Application wizard does)
+      if (f.key === 'push') await appPublicKey(Number(req.params.id)).catch(() => undefined);
+      flash(s, `${f.label} added.`);
+      return back(reply, s, page ? `${BASE}/pages/${page}` : `${BASE}/apps/${req.params.id}/create-page?tab=feature`);
+    } catch (e) {
+      flash(s, (e as Error).message, 'error');
+      return back(reply, s, `${BASE}/apps/${req.params.id}/features/${f.key}`);
+    }
+  });
+}

package/src/builder/home.ts

@@ -295,6 +295,9 @@ export async function homeRoutes(app: FastifyInstance) {
           : s.workspace && (await workspaceAdmin(s.username, s.workspace.id))
             ? card(`${BASE}/workspaces/${s.workspace.id}`, icon('layers'), `Workspace ${s.workspace.name}`, 'Its name, developers, preferences and extension links (workspace administrators).')
             : ''}
+        ${card(`${BASE}/ui-defaults`, icon('sliders-horizontal'), 'UI defaults', 'Labels, format masks, help and lists of values per table column, used by the page wizards.')}
+        ${card(`${BASE}/icons`, icon('image'), 'Icons', 'Browse the icons of the icon picker.')}
+        ${card(`${BASE}/vector-providers`, icon('search'), 'Vector providers', 'Embeddings for search by meaning: the applications\' vector providers, their vector columns, and whether pgvector is installed.')}
         ${(await isAdmin(s.username)) ? card(`${BASE}/ai`, icon('bolt'), 'AI services', 'Claude and OpenAI for the applications: models, keys, limits and usage (administrators).') : ''}
         ${(await isAdmin(s.username)) ? card(`${BASE}/mail`, icon('send'), 'Mail services', 'SMTP, Microsoft 365, Amazon SES, Resend, Postmark, SendGrid or Mailgun for the applications\' e-mail (administrators).') : ''}
         ${(await isAdmin(s.username)) ? card(`${BASE}/installation`, icon('history'), 'Installation', 'Version, install and upgrade runs, applied migrations (administrators).') : ''}

package/src/builder/i18n/de.ts

@@ -285,6 +285,7 @@ export const de: BuilderMessages = {
   'app.tab.api': 'REST-API',
   'app.tab.settings': 'Einstellungen',
   'app.tab.advisor': 'Advisor',
+  'app.tab.utilities': 'Dienstprogramme',
   'app.lock_refused': 'Änderungen werden abgelehnt, bis die Sperre aufgehoben ist.',
   'app.search_pages': 'Seiten durchsuchen',
   'app.search_placeholder': 'Seitenname oder -nummer',
@@ -318,6 +319,9 @@ export const de: BuilderMessages = {
   'app.table_or_view': 'Tabelle oder View (Mastertabelle für Master-Detail)',
   'app.no_access': '{table} (kein Zugriff für {role})',
   'app.ai_pages': 'Seiten mit KI erstellen',
+  'app.all_page_types': "Alle Seitentypen, Funktionen und Kopien",
+  'app.task.add_feature': "Funktionsseite hinzufügen",
+  'app.task.copy_page': "Seite als Kopie erstellen",
   'app.ai_pages_note': '(beschreiben Sie sie mit eigenen Worten)',
   'app.blank': 'Leere Seite erstellen',
   'app.page_number': 'Seitennummer',
@@ -1065,6 +1069,40 @@ export const de: BuilderMessages = {
   'fts.gin_yes': "GIN-Index",
   'fts.gin_no': "kein GIN-Index",
   'fts.added': "Volltextsuche zu {table} hinzugefügt: Spalte {column} mit Index {index}.",
+  // (sprint 136, AP-1) Table Properties › Add vector column
+  'vec.add': "Vektorspalte hinzufügen",
+  'vec.title': "Vektorspalte für {table}",
+  'vec.intro': "Fügt eine Embedding-Spalte vector(n) hinzu (n: die Dimensionen des Vektoranbieters), einen HNSW-Index für die Distanz und einen Trigger, der eine Zeile neu einbettet, wenn sich ihre Quellspalten ändern. Eine Suchkonfiguration vom Typ vector oder hybrid oder das Retrieve-Werkzeug eines KI-Agenten findet Zeilen dann nach Bedeutung. Die vorhandenen Zeilen werden sofort für ihre Embeddings eingereiht.",
+  'vec.existing': "Vektorspalten jetzt",
+  'vec.provider': "Vektoranbieter",
+  'vec.provider_help': "Gemeinsame Komponenten › Vektoranbieter der Anwendungen dieses Arbeitsbereichs. Suchen Sie mit demselben Anbieter.",
+  'vec.keep': "Aktuell halten",
+  'vec.keep_help': "Ein Funktionsanbieter kann das Embedding sofort im Trigger setzen. Einen KI-Dienst ruft der Server auf: Der Trigger reiht die Zeile ein, und der Server bettet eingereihte Zeilen stapelweise ein, innerhalb der Anfragen pro Minute des Anbieters und der täglichen KI-Limits der Anwendung.",
+  'vec.mode_set': "vom Trigger gesetzt, sofort",
+  'vec.mode_queue': "für den Server eingereiht",
+  'vec.sources': "Quellspalten",
+  'vec.sources_help': "Der Text, der eingebettet wird: diese Spalten, eine pro Zeile. Eine Änderung an einer davon bettet die Zeile neu ein.",
+  'vec.distance': "Distanz",
+  'vec.distance_help': "cosine für die meisten Embedding-Modelle; die Suchkonfiguration verwendet dieselbe Distanz.",
+  'vec.column': "Vektorspalte",
+  'vec.no_key': "Die Tabelle braucht einen Primärschlüssel aus einer Spalte: Die Warteschlange findet Zeilen darüber.",
+  'vec.pick_provider': "Wählen Sie einen Vektoranbieter.",
+  'vec.no_providers': "Noch keine Anwendung dieses Arbeitsbereichs hat einen Vektoranbieter: Fügen Sie einen unter Gemeinsame Komponenten › Vektoranbieter hinzu.",
+  'vec.missing': "Die Erweiterung pgvector ist in dieser Datenbank nicht installiert, daher kann noch keine Vektorspalte hinzugefügt werden.",
+  'vec.missing_create': "Der Datenbankserver hat pgvector {version}: Erstellen Sie die Erweiterung unter Arbeitsbereich-Dienstprogramme › Vektoranbieter.",
+  'vec.missing_admin': "Der Datenbankserver hat pgvector {version}: Ein Administrator erstellt die Erweiterung (Arbeitsbereich-Dienstprogramme › Vektoranbieter).",
+  'vec.missing_package': "Der Datenbankserver hat das Paket pgvector nicht: Installieren Sie es (z. B. apt install postgresql-17-pgvector oder das Docker-Image pgvector/pgvector) und erstellen Sie dann die Erweiterung.",
+  'vec.utilities': "Arbeitsbereich-Dienstprogramme › Vektoranbieter",
+  'vec.kept_by': "gepflegt von {provider} aus {columns}",
+  'vec.not_kept': "kein Trigger hält sie aktuell",
+  'vec.progress': "Eingebettete Zeilen von {column}",
+  'vec.counts': "{done} von {total} Zeilen eingebettet, {queued} eingereiht",
+  'vec.failing': "{n} fehlgeschlagen",
+  'vec.reembed_all': "alle Zeilen, nicht nur die ohne Embedding",
+  'vec.backfill': "Nachfüllen",
+  'vec.refresh': "Aktualisieren",
+  'vec.backfill_queued': "{n} Zeilen von {column} für ihre Embeddings eingereiht.",
+  'vec.added': "Vektorspalte {column} zu {table} hinzugefügt; {n} Zeilen für ihre Embeddings eingereiht.",
   // ------------------------------------------------------------ Shared Components (sprint 124)
   'comp.nav_entry': 'Navigationseintrag',
   'comp.nav_entry.plural': 'Navigationsmenü',

package/src/builder/i18n/en.ts

@@ -288,6 +288,7 @@ export const en = {
   'app.tab.api': 'REST API',
   'app.tab.settings': 'Settings',
   'app.tab.advisor': 'Advisor',
+  'app.tab.utilities': 'Utilities',
   'app.lock_refused': 'Changes are refused until it is unlocked.',
   'app.search_pages': 'Search pages',
   'app.search_placeholder': 'Page name or number',
@@ -321,6 +322,9 @@ export const en = {
   'app.table_or_view': 'Table or view (master table for master detail)',
   'app.no_access': '{table} (no access for {role})',
   'app.ai_pages': 'Create pages with AI',
+  'app.all_page_types': "All page types, features and copies",
+  'app.task.add_feature': "Add feature page",
+  'app.task.copy_page': "Create page as copy",
   'app.ai_pages_note': '(describe them in your own words)',
   'app.blank': 'Create blank page',
   'app.page_number': 'Page number',
@@ -1069,6 +1073,40 @@ export const en = {
   'fts.gin_yes': "GIN index",
   'fts.gin_no': "no GIN index",
   'fts.added': "Added full-text search to {table}: column {column} with index {index}.",
+  // (sprint 136, AP-1) Table Properties › Add vector column
+  'vec.add': "Add vector column",
+  'vec.title': "Vector column on {table}",
+  'vec.intro': "Adds an embedding column vector(n) (n: the vector provider's dimensions), an HNSW index for the distance, and a trigger that re-embeds a row when its source columns change. A search configuration of type vector or hybrid, or an AI agent's Retrieve tool, then finds rows by meaning. The rows there are now are queued for their embeddings at once.",
+  'vec.existing': "Vector columns now",
+  'vec.provider': "Vector provider",
+  'vec.provider_help': "Shared Components › Vector providers of this workspace's applications. Search with the same provider.",
+  'vec.keep': "Keep current",
+  'vec.keep_help': "A function provider can set the embedding in the trigger, at once. An AI service is called by the server: the trigger queues the row and the server embeds queued rows in batches, within the provider's requests per minute and the application's daily AI limits.",
+  'vec.mode_set': "set by the trigger, at once",
+  'vec.mode_queue': "queued for the server",
+  'vec.sources': "Source columns",
+  'vec.sources_help': "The text that is embedded: these columns, one per line. A change to one of them re-embeds the row.",
+  'vec.distance': "Distance",
+  'vec.distance_help': "cosine for most embedding models; the search configuration uses the same distance.",
+  'vec.column': "Vector column",
+  'vec.no_key': "The table needs a primary key of one column: the queue finds rows by it.",
+  'vec.pick_provider': "Choose a vector provider.",
+  'vec.no_providers': "No application of this workspace has a vector provider yet: add one under Shared Components › Vector providers.",
+  'vec.missing': "The pgvector extension is not installed in this database, so a vector column can't be added yet.",
+  'vec.missing_create': "The database server has pgvector {version}: create the extension under Workspace utilities › Vector providers.",
+  'vec.missing_admin': "The database server has pgvector {version}: an administrator creates the extension (Workspace utilities › Vector providers).",
+  'vec.missing_package': "The database server doesn't have the pgvector package: install it (e.g. apt install postgresql-17-pgvector, or the pgvector/pgvector Docker image), then create the extension.",
+  'vec.utilities': "Workspace utilities › Vector providers",
+  'vec.kept_by': "kept by {provider} from {columns}",
+  'vec.not_kept': "no trigger keeps it current",
+  'vec.progress': "Embedded rows of {column}",
+  'vec.counts': "{done} of {total} rows embedded, {queued} queued",
+  'vec.failing': "{n} failing",
+  'vec.reembed_all': "all rows, not only those without an embedding",
+  'vec.backfill': "Backfill",
+  'vec.refresh': "Refresh",
+  'vec.backfill_queued': "{n} rows of {column} queued for their embeddings.",
+  'vec.added': "Added the vector column {column} to {table}; {n} rows queued for their embeddings.",
   // ------------------------------------------------------------ Shared Components (sprint 124)
   'comp.nav_entry': 'Navigation entry',
   'comp.nav_entry.plural': 'Navigation menu',

package/src/builder/i18n/es.ts

@@ -285,6 +285,7 @@ export const es: BuilderMessages = {
   'app.tab.api': 'API REST',
   'app.tab.settings': 'Configuración',
   'app.tab.advisor': 'Asesor',
+  'app.tab.utilities': 'Utilidades',
   'app.lock_refused': 'Los cambios se rechazan hasta que se desbloquee.',
   'app.search_pages': 'Buscar páginas',
   'app.search_placeholder': 'Nombre o número de página',
@@ -318,6 +319,9 @@ export const es: BuilderMessages = {
   'app.table_or_view': 'Tabla o vista (tabla maestra para maestro-detalle)',
   'app.no_access': '{table} (sin acceso para {role})',
   'app.ai_pages': 'Crear páginas con IA',
+  'app.all_page_types': "Todos los tipos de página, funciones y copias",
+  'app.task.add_feature': "Agregar página de función",
+  'app.task.copy_page': "Crear página como copia",
   'app.ai_pages_note': '(descríbalas con sus propias palabras)',
   'app.blank': 'Crear página en blanco',
   'app.page_number': 'Número de página',
@@ -1065,6 +1069,40 @@ export const es: BuilderMessages = {
   'fts.gin_yes': "índice GIN",
   'fts.gin_no': "sin índice GIN",
   'fts.added': "Búsqueda de texto completo añadida a {table}: columna {column} con el índice {index}.",
+  // (sprint 136, AP-1) Table Properties › Add vector column
+  'vec.add': "Añadir columna vectorial",
+  'vec.title': "Columna vectorial en {table}",
+  'vec.intro': "Añade una columna de embedding vector(n) (n: las dimensiones del proveedor de vectores), un índice HNSW para la distancia y un disparador que vuelve a calcular el embedding de una fila cuando cambian sus columnas de origen. Una configuración de búsqueda de tipo vector o hybrid, o la herramienta Retrieve de un agente de IA, encuentra entonces las filas por su significado. Las filas que ya existen se ponen en cola enseguida para sus embeddings.",
+  'vec.existing': "Columnas vectoriales actuales",
+  'vec.provider': "Proveedor de vectores",
+  'vec.provider_help': "Componentes compartidos › Proveedores de vectores de las aplicaciones de este espacio de trabajo. Busque con el mismo proveedor.",
+  'vec.keep': "Mantener al día",
+  'vec.keep_help': "Un proveedor de tipo función puede fijar el embedding en el disparador, enseguida. A un servicio de IA lo llama el servidor: el disparador pone la fila en cola y el servidor calcula los embeddings por lotes, dentro de las solicitudes por minuto del proveedor y los límites diarios de IA de la aplicación.",
+  'vec.mode_set': "fijado por el disparador, enseguida",
+  'vec.mode_queue': "en cola para el servidor",
+  'vec.sources': "Columnas de origen",
+  'vec.sources_help': "El texto del que se calcula el embedding: estas columnas, una por línea. Un cambio en una de ellas vuelve a calcular el embedding de la fila.",
+  'vec.distance': "Distancia",
+  'vec.distance_help': "cosine para la mayoría de los modelos de embedding; la configuración de búsqueda usa la misma distancia.",
+  'vec.column': "Columna vectorial",
+  'vec.no_key': "La tabla necesita una clave primaria de una sola columna: la cola encuentra las filas por ella.",
+  'vec.pick_provider': "Elija un proveedor de vectores.",
+  'vec.no_providers': "Ninguna aplicación de este espacio de trabajo tiene aún un proveedor de vectores: añada uno en Componentes compartidos › Proveedores de vectores.",
+  'vec.missing': "La extensión pgvector no está instalada en esta base de datos, así que todavía no se puede añadir una columna vectorial.",
+  'vec.missing_create': "El servidor de base de datos tiene pgvector {version}: cree la extensión en Utilidades del espacio de trabajo › Proveedores de vectores.",
+  'vec.missing_admin': "El servidor de base de datos tiene pgvector {version}: un administrador crea la extensión (Utilidades del espacio de trabajo › Proveedores de vectores).",
+  'vec.missing_package': "El servidor de base de datos no tiene el paquete pgvector: instálelo (p. ej. apt install postgresql-17-pgvector, o la imagen de Docker pgvector/pgvector) y cree luego la extensión.",
+  'vec.utilities': "Utilidades del espacio de trabajo › Proveedores de vectores",
+  'vec.kept_by': "mantenida por {provider} a partir de {columns}",
+  'vec.not_kept': "ningún disparador la mantiene al día",
+  'vec.progress': "Filas de {column} con embedding",
+  'vec.counts': "{done} de {total} filas con embedding, {queued} en cola",
+  'vec.failing': "{n} con error",
+  'vec.reembed_all': "todas las filas, no solo las que no tienen embedding",
+  'vec.backfill': "Completar",
+  'vec.refresh': "Actualizar",
+  'vec.backfill_queued': "{n} filas de {column} en cola para sus embeddings.",
+  'vec.added': "Columna vectorial {column} añadida a {table}; {n} filas en cola para sus embeddings.",
   // ------------------------------------------------------------ Shared Components (sprint 124)
   'comp.nav_entry': 'Entrada de navegación',
   'comp.nav_entry.plural': 'Menú de navegación',

package/src/builder/i18n/fr.ts

@@ -285,6 +285,7 @@ export const fr: BuilderMessages = {
   'app.tab.api': 'API REST',
   'app.tab.settings': 'Paramètres',
   'app.tab.advisor': 'Conseiller',
+  'app.tab.utilities': 'Utilitaires',
   'app.lock_refused': "Les modifications sont refusées jusqu'à son déverrouillage.",
   'app.search_pages': 'Rechercher des pages',
   'app.search_placeholder': 'Nom ou numéro de page',
@@ -318,6 +319,9 @@ export const fr: BuilderMessages = {
   'app.table_or_view': 'Table ou vue (table maître pour maître-détail)',
   'app.no_access': '{table} (aucun accès pour {role})',
   'app.ai_pages': "Créer des pages avec l'IA",
+  'app.all_page_types': "Tous les types de page, fonctionnalités et copies",
+  'app.task.add_feature': "Ajouter une page de fonctionnalité",
+  'app.task.copy_page': "Créer une page par copie",
   'app.ai_pages_note': '(décrivez-les avec vos propres mots)',
   'app.blank': 'Créer une page vierge',
   'app.page_number': 'Numéro de page',
@@ -1065,6 +1069,40 @@ export const fr: BuilderMessages = {
   'fts.gin_yes': "index GIN",
   'fts.gin_no': "pas d'index GIN",
   'fts.added': "Recherche plein texte ajoutée à {table} : colonne {column} avec l'index {index}.",
+  // (sprint 136, AP-1) Table Properties › Add vector column
+  'vec.add': "Ajouter une colonne vectorielle",
+  'vec.title': "Colonne vectorielle sur {table}",
+  'vec.intro': "Ajoute une colonne d'embedding vector(n) (n : les dimensions du fournisseur de vecteurs), un index HNSW pour la distance et un déclencheur qui recalcule l'embedding d'une ligne quand ses colonnes sources changent. Une configuration de recherche de type vector ou hybrid, ou l'outil Retrieve d'un agent IA, trouve alors les lignes par leur sens. Les lignes existantes sont mises en file d'attente tout de suite pour leurs embeddings.",
+  'vec.existing': "Colonnes vectorielles actuelles",
+  'vec.provider': "Fournisseur de vecteurs",
+  'vec.provider_help': "Composants partagés › Fournisseurs de vecteurs des applications de cet espace de travail. Recherchez avec le même fournisseur.",
+  'vec.keep': "Tenir à jour",
+  'vec.keep_help': "Un fournisseur de type fonction peut définir l'embedding dans le déclencheur, tout de suite. Un service IA est appelé par le serveur : le déclencheur met la ligne en file d'attente et le serveur calcule les embeddings par lots, dans la limite des requêtes par minute du fournisseur et des limites IA quotidiennes de l'application.",
+  'vec.mode_set': "défini par le déclencheur, tout de suite",
+  'vec.mode_queue': "en file d'attente pour le serveur",
+  'vec.sources': "Colonnes sources",
+  'vec.sources_help': "Le texte dont on calcule l'embedding : ces colonnes, une par ligne. Une modification de l'une d'elles recalcule l'embedding de la ligne.",
+  'vec.distance': "Distance",
+  'vec.distance_help': "cosine pour la plupart des modèles d'embedding ; la configuration de recherche utilise la même distance.",
+  'vec.column': "Colonne vectorielle",
+  'vec.no_key': "La table a besoin d'une clé primaire d'une seule colonne : la file d'attente retrouve les lignes par elle.",
+  'vec.pick_provider': "Choisissez un fournisseur de vecteurs.",
+  'vec.no_providers': "Aucune application de cet espace de travail n'a encore de fournisseur de vecteurs : ajoutez-en un sous Composants partagés › Fournisseurs de vecteurs.",
+  'vec.missing': "L'extension pgvector n'est pas installée dans cette base de données : impossible d'ajouter une colonne vectorielle pour l'instant.",
+  'vec.missing_create': "Le serveur de base de données dispose de pgvector {version} : créez l'extension sous Utilitaires de l'espace de travail › Fournisseurs de vecteurs.",
+  'vec.missing_admin': "Le serveur de base de données dispose de pgvector {version} : un administrateur crée l'extension (Utilitaires de l'espace de travail › Fournisseurs de vecteurs).",
+  'vec.missing_package': "Le serveur de base de données n'a pas le paquet pgvector : installez-le (p. ex. apt install postgresql-17-pgvector, ou l'image Docker pgvector/pgvector), puis créez l'extension.",
+  'vec.utilities': "Utilitaires de l'espace de travail › Fournisseurs de vecteurs",
+  'vec.kept_by': "tenue par {provider} à partir de {columns}",
+  'vec.not_kept': "aucun déclencheur ne la tient à jour",
+  'vec.progress': "Lignes de {column} avec embedding",
+  'vec.counts': "{done} lignes sur {total} avec embedding, {queued} en file d'attente",
+  'vec.failing': "{n} en échec",
+  'vec.reembed_all': "toutes les lignes, pas seulement celles sans embedding",
+  'vec.backfill': "Compléter",
+  'vec.refresh': "Actualiser",
+  'vec.backfill_queued': "{n} lignes de {column} mises en file d'attente pour leurs embeddings.",
+  'vec.added': "Colonne vectorielle {column} ajoutée à {table} ; {n} lignes en file d'attente pour leurs embeddings.",
   // ------------------------------------------------------------ Shared Components (sprint 124)
   'comp.nav_entry': 'Entrée de navigation',
   'comp.nav_entry.plural': 'Menu de navigation',

package/src/builder/i18n/it.ts

@@ -285,6 +285,7 @@ export const it: BuilderMessages = {
   'app.tab.api': 'API REST',
   'app.tab.settings': 'Impostazioni',
   'app.tab.advisor': 'Advisor',
+  'app.tab.utilities': 'Utilità',
   'app.lock_refused': 'Le modifiche vengono rifiutate finché non viene sbloccata.',
   'app.search_pages': 'Cerca pagine',
   'app.search_placeholder': 'Nome o numero della pagina',
@@ -318,6 +319,9 @@ export const it: BuilderMessages = {
   'app.table_or_view': 'Tabella o vista (tabella master per master-dettaglio)',
   'app.no_access': '{table} (nessun accesso per {role})',
   'app.ai_pages': 'Crea pagine con l’AI',
+  'app.all_page_types': "Tutti i tipi di pagina, funzionalità e copie",
+  'app.task.add_feature': "Aggiungi pagina di funzionalità",
+  'app.task.copy_page': "Crea pagina come copia",
   'app.ai_pages_note': '(descriverle con parole proprie)',
   'app.blank': 'Crea pagina vuota',
   'app.page_number': 'Numero di pagina',
@@ -1065,6 +1069,40 @@ export const it: BuilderMessages = {
   'fts.gin_yes': "indice GIN",
   'fts.gin_no': "nessun indice GIN",
   'fts.added': "Ricerca full-text aggiunta a {table}: colonna {column} con l'indice {index}.",
+  // (sprint 136, AP-1) Table Properties › Add vector column
+  'vec.add': "Aggiungi colonna vettoriale",
+  'vec.title': "Colonna vettoriale su {table}",
+  'vec.intro': "Aggiunge una colonna di embedding vector(n) (n: le dimensioni del provider di vettori), un indice HNSW per la distanza e un trigger che ricalcola l'embedding di una riga quando cambiano le sue colonne di origine. Una configurazione di ricerca di tipo vector o hybrid, o lo strumento Retrieve di un agente IA, trova allora le righe per significato. Le righe già presenti vengono messe subito in coda per i loro embedding.",
+  'vec.existing': "Colonne vettoriali attuali",
+  'vec.provider': "Provider di vettori",
+  'vec.provider_help': "Componenti condivisi › Provider di vettori delle applicazioni di questo workspace. Cerca con lo stesso provider.",
+  'vec.keep': "Mantieni aggiornata",
+  'vec.keep_help': "Un provider di tipo funzione può impostare l'embedding nel trigger, subito. Un servizio IA è chiamato dal server: il trigger mette in coda la riga e il server calcola gli embedding a lotti, entro le richieste al minuto del provider e i limiti IA giornalieri dell'applicazione.",
+  'vec.mode_set': "impostato dal trigger, subito",
+  'vec.mode_queue': "in coda per il server",
+  'vec.sources': "Colonne di origine",
+  'vec.sources_help': "Il testo di cui si calcola l'embedding: queste colonne, una per riga. Una modifica a una di esse ricalcola l'embedding della riga.",
+  'vec.distance': "Distanza",
+  'vec.distance_help': "cosine per la maggior parte dei modelli di embedding; la configurazione di ricerca usa la stessa distanza.",
+  'vec.column': "Colonna vettoriale",
+  'vec.no_key': "La tabella ha bisogno di una chiave primaria di una sola colonna: la coda trova le righe tramite essa.",
+  'vec.pick_provider': "Scegli un provider di vettori.",
+  'vec.no_providers': "Nessuna applicazione di questo workspace ha ancora un provider di vettori: aggiungine uno in Componenti condivisi › Provider di vettori.",
+  'vec.missing': "L'estensione pgvector non è installata in questo database, quindi non è ancora possibile aggiungere una colonna vettoriale.",
+  'vec.missing_create': "Il server del database ha pgvector {version}: crea l'estensione in Utilità del workspace › Provider di vettori.",
+  'vec.missing_admin': "Il server del database ha pgvector {version}: un amministratore crea l'estensione (Utilità del workspace › Provider di vettori).",
+  'vec.missing_package': "Il server del database non ha il pacchetto pgvector: installalo (ad es. apt install postgresql-17-pgvector, o l'immagine Docker pgvector/pgvector), poi crea l'estensione.",
+  'vec.utilities': "Utilità del workspace › Provider di vettori",
+  'vec.kept_by': "mantenuta da {provider} a partire da {columns}",
+  'vec.not_kept': "nessun trigger la mantiene aggiornata",
+  'vec.progress': "Righe di {column} con embedding",
+  'vec.counts': "{done} righe su {total} con embedding, {queued} in coda",
+  'vec.failing': "{n} non riuscite",
+  'vec.reembed_all': "tutte le righe, non solo quelle senza embedding",
+  'vec.backfill': "Completa",
+  'vec.refresh': "Aggiorna",
+  'vec.backfill_queued': "{n} righe di {column} messe in coda per i loro embedding.",
+  'vec.added': "Colonna vettoriale {column} aggiunta a {table}; {n} righe in coda per i loro embedding.",
   // ------------------------------------------------------------ Shared Components (sprint 124)
   'comp.nav_entry': 'Voce di navigazione',
   'comp.nav_entry.plural': 'Menu di navigazione',