pgkiln 0.79.0 → 0.81.0

package/db/migrations/144_workflow_migrate_branches.sql

@@ -0,0 +1,186 @@
+-- Sprint 149 (WS-6 leftover; APEX 26.2: in-flight workflow migration): running instances inside parallel branches
+-- move to a newer version too. Migration 123 refused them ("let them reach their join first").
+--
+-- An instance inside branches is at several steps at once: its main path waits at a join (or, nested, a branch
+-- waits at an inner join), and each open branch (active, waiting or faulted) is at a step of its own. Each of these
+-- positions is mapped like the main path was (p_map: old step → new step) and checked with the same rules (a task
+-- step stays a task step of the same task definition, a wait stays a wait, a join stays a join, no draft step, no
+-- call in flight). Branch rows also keep the parallel step that split them and the join they end at: the join is
+-- renamed through the mapping (it must be a join step of the new version; a branch can't be mapped onto its own
+-- join), the split through the mapping or else to the one parallel step of the new version that joins there. Branches that are already done keep their state, so a join counts them as before.
+--
+-- meta.migrate_workflows returns one row per position (the column branch: the branch's first step, null for the
+-- main path); applying moves every position of every instance in one transaction, or nothing.
+
+drop function meta.migrate_workflows(int, text, bigint[], jsonb, boolean, text);
+
+/** The problem that stops one position (a main path or a branch) from moving to p_to; null: it can move. */
+create function meta.workflow_position_problem(p_state text, p_from_steps jsonb, p_from text, p_to_steps jsonb, p_to text,
+                                               p_waiting_task bigint, p_task_name text, p_to_version text)
+returns text language plpgsql stable set search_path = meta, pg_catalog as $$
+declare
+  v_to   jsonb := (select s from jsonb_array_elements(p_to_steps) s where s->>'name' = p_to limit 1);
+  v_from jsonb := (select s from jsonb_array_elements(p_from_steps) s where s->>'name' = p_from limit 1);
+begin
+  if p_to is null or p_to = '' then
+    return format('no step of version %s is mapped to %s', p_to_version, coalesce(p_from, '(none)'));
+  elsif v_to is null then
+    return format('version %s has no step %s', p_to_version, p_to);
+  elsif v_to->>'type' = 'draft' then
+    return format('%s is a draft step', p_to);
+  elsif p_waiting_task is not null and v_to->>'type' <> 'task' then
+    return format('waits for a task: %s must be a task step', p_to);
+  elsif p_waiting_task is not null and upper(v_to->>'task') is distinct from p_task_name then
+    return format('waits for a task of %s, but %s creates %s', p_task_name, p_to, coalesce(v_to->>'task', '(none)'));
+  elsif p_state = 'waiting' and p_waiting_task is null and v_from->>'type' = 'invoke_api' then
+    return 'is calling a web service: try again when the call is done';
+  elsif p_state = 'waiting' and p_waiting_task is null and v_from->>'type' = 'wait' and v_to->>'type' <> 'wait' then
+    return format('waits at a wait step: %s must be a wait step', p_to);
+  elsif p_state = 'waiting' and p_waiting_task is null and v_from->>'type' = 'join' and v_to->>'type' <> 'join' then
+    return format('waits at a join: %s must be a join step', p_to);
+  end if;
+  return null;
+end
+$$;
+revoke all on function meta.workflow_position_problem(text, jsonb, text, jsonb, text, bigint, text, text) from public;
+
+/**
+ * Move running instances (p_ids) of a definition to a newer version (p_to_version: the active version or a later
+ * inactive one), each position at the step p_map gives for its current step. Returns one row per position (branch:
+ * the branch's first step, null for the main path) with the problem that stops it (null: it can move). With p_apply,
+ * nothing changes unless every position of every instance can move; then all move in this transaction, with a
+ * "migrated" event each and a row in meta.workflow_migration.
+ */
+create function meta.migrate_workflows(p_definition_id int, p_to_version text, p_ids bigint[], p_map jsonb, p_apply boolean, p_by text)
+returns table (workflow_id bigint, branch text, from_version text, from_step text, to_step text, problem text)
+language plpgsql set search_path = meta, pg_catalog as $$
+declare
+  d        meta.workflow_definition;
+  v_order  text[];
+  v_target int;
+  v_steps  jsonb;
+  w        record;
+  b        record;
+  v_rows   jsonb := '[]';
+  v_bad    text[] := '{}';
+  v_id     bigint;
+  v_join   text;
+  v_split  text;
+  r        jsonb;
+begin
+  select * into d from workflow_definition where id = p_definition_id;
+  if not found then
+    raise exception 'Workflow definition % does not exist.', p_definition_id;
+  end if;
+  if coalesce(cardinality(p_ids), 0) = 0 then
+    raise exception 'Choose the instances to migrate.';
+  end if;
+  if jsonb_typeof(coalesce(p_map, '{}')) <> 'object' then
+    raise exception 'The step mapping is a JSON object.';
+  end if;
+  -- versions from the oldest to the active one
+  v_order := array(select x->>'version' from jsonb_array_elements(d.inactive_versions) with ordinality o(x, i) order by i) || d.version;
+  v_target := array_position(v_order, p_to_version);
+  if v_target is null then
+    raise exception 'Workflow % has no version % to migrate to (the active version or an inactive one).', d.name, p_to_version;
+  end if;
+  v_steps := case when p_to_version = d.version then d.steps
+                  else (select x->'steps' from jsonb_array_elements(d.inactive_versions) x where x->>'version' = p_to_version limit 1) end;
+
+  foreach v_id in array (select array_agg(distinct x order by x) from unnest(p_ids) x) loop
+    select wf.id, wf.app_id, wf.definition_id, coalesce(wf.version, '1') as version, wf.state, wf.current_step, wf.steps, wf.waiting_task,
+           (select td.name from task tk join task_definition td on td.id = tk.definition_id where tk.id = wf.waiting_task) as task_name
+      into w from workflow wf where wf.id = v_id for update;
+    -- the main path
+    workflow_id := v_id;
+    branch := null;
+    from_version := w.version;
+    from_step := w.current_step;
+    to_step := case when w.current_step is not null then p_map->>w.current_step end;
+    problem := null;
+    if w.id is null or w.definition_id is distinct from d.id or w.app_id <> d.app_id then
+      problem := 'not an instance of this workflow';
+      from_version := null;
+      from_step := null;
+      to_step := null;
+    elsif w.state not in ('active', 'waiting', 'faulted') then
+      problem := format('is %s', w.state);
+    elsif coalesce(array_position(v_order, w.version), 0) >= v_target then
+      problem := format('runs version %s, which is not older than %s', w.version, p_to_version);
+    else
+      problem := meta.workflow_position_problem(w.state, w.steps, w.current_step, v_steps, to_step, w.waiting_task, w.task_name, p_to_version);
+    end if;
+    if problem is not null then
+      v_bad := v_bad || format('%s %s', v_id, problem);
+    end if;
+    v_rows := v_rows || jsonb_build_object('id', v_id, 'branch_id', null, 'branch', null, 'from_version', from_version, 'from_step', from_step, 'to_step', to_step);
+    return next;
+    continue when w.id is null or w.definition_id is distinct from d.id or w.app_id <> d.app_id
+               or w.state not in ('active', 'waiting', 'faulted') or coalesce(array_position(v_order, w.version), 0) >= v_target;
+
+    -- (144) each open branch, at a step of its own; its join and split through the mapping
+    for b in
+      select br.id, br.name, br.state, br.current_step, br.waiting_task, br.split_step, br.join_step,
+             (select td.name from task tk join task_definition td on td.id = tk.definition_id where tk.id = br.waiting_task) as task_name
+        from workflow_branch br where br.workflow_id = v_id and br.state in ('active', 'waiting', 'faulted') order by br.id
+    loop
+      branch := b.name;
+      from_step := b.current_step;
+      to_step := case when b.current_step is not null then p_map->>b.current_step end;
+      v_join := coalesce(nullif(p_map->>b.join_step, ''), b.join_step);
+      -- the parallel step that split it: mapped, else the one step of the new version that joins at its new join
+      v_split := coalesce(nullif(p_map->>b.split_step, ''),
+                          (select min(s->>'name') from jsonb_array_elements(v_steps) s where s->>'type' = 'parallel' and s->>'join' = v_join
+                            having count(*) = 1),
+                          b.split_step);
+      problem := meta.workflow_position_problem(b.state, w.steps, b.current_step, v_steps, to_step, b.waiting_task, b.task_name, p_to_version);
+      if problem is null and not exists (select 1 from jsonb_array_elements(v_steps) s where s->>'name' = v_join and s->>'type' = 'join') then
+        problem := format('ends at the join %s: version %s has no join step %s', b.join_step, p_to_version, v_join);
+      elsif problem is null and to_step = v_join then
+        problem := format('a branch can''t be mapped onto its own join %s', v_join);
+      end if;
+      if problem is not null then
+        v_bad := v_bad || format('%s (branch %s) %s', v_id, b.name, problem);
+      end if;
+      v_rows := v_rows || jsonb_build_object('id', v_id, 'branch_id', b.id, 'branch', b.name, 'from_version', w.version, 'from_step', b.current_step,
+                                             'to_step', to_step, 'join', v_join, 'split', v_split);
+      from_version := w.version;
+      return next;
+    end loop;
+  end loop;
+
+  if not p_apply then
+    return;
+  end if;
+  if cardinality(v_bad) > 0 then
+    raise exception 'Nothing was migrated: instance %.', array_to_string(v_bad, '; instance ');
+  end if;
+  for r in select * from jsonb_array_elements(v_rows) loop
+    if r->>'branch_id' is null then
+      update workflow set steps = v_steps, version = p_to_version, current_step = r->>'to_step', updated_at = now()
+       where id = (r->>'id')::bigint;
+      perform meta.workflow_log((r->>'id')::bigint, r->>'to_step', 'migrated',
+        format('version %s → %s: %s → %s (by %s)', r->>'from_version', p_to_version, r->>'from_step', r->>'to_step', p_by));
+    else
+      update workflow_branch set current_step = r->>'to_step', updated_at = now() where id = (r->>'branch_id')::bigint;
+      perform meta.workflow_log((r->>'id')::bigint, r->>'to_step', 'migrated',
+        format('version %s → %s: branch %s: %s → %s (by %s)', r->>'from_version', p_to_version, r->>'branch', r->>'from_step', r->>'to_step', p_by));
+    end if;
+  end loop;
+  -- every branch of a moved instance (done ones too: a join counts them) ends at and was split by the mapped steps
+  update workflow_branch br
+     set join_step = j.name,
+         split_step = coalesce(nullif(p_map->>br.split_step, ''),
+                               (select min(s->>'name') from jsonb_array_elements(v_steps) s where s->>'type' = 'parallel' and s->>'join' = j.name
+                                 having count(*) = 1),
+                               br.split_step)
+    from (select b2.id, coalesce(nullif(p_map->>b2.join_step, ''), b2.join_step) as name from workflow_branch b2) j
+   where j.id = br.id and br.workflow_id in (select distinct (x->>'id')::bigint from jsonb_array_elements(v_rows) x);
+  insert into workflow_migration (app_id, definition_name, to_version, mapping, workflow_ids, detail, migrated_by)
+  values (d.app_id, d.name, p_to_version, coalesce(p_map, '{}'),
+          array(select distinct (x->>'id')::bigint from jsonb_array_elements(v_rows) x order by 1), v_rows, p_by);
+  -- active ones go on with their new step
+  perform pg_notify('pgkiln_workflow', 'migrated');
+end
+$$;
+revoke all on function meta.migrate_workflows(int, text, bigint[], jsonb, boolean, text) from public;

package/db/migrations/145_remote_databases.sql

@@ -0,0 +1,41 @@
+-- Sprint 150 (AP-7 leftover; APEX: REST Enabled SQL services, regions on another database): remote databases.
+--
+-- A remote database is another PostgreSQL database whose tables applications query as if they were local: pgkiln
+-- makes a postgres_fdw server for it, a user mapping (the remote user and password: kept by PostgreSQL in
+-- pg_user_mapping, which only superusers and the server's owner can read; pgkiln itself never stores the password),
+-- and imports the remote schema's tables (all, or the ones named) as foreign tables into a local schema of their
+-- own. Regions, lists of values, reports, forms and grids then use <local schema>.<table> like any table: as the
+-- application's database role, in its transaction, with the grants given here (SELECT, optionally INSERT, UPDATE,
+-- DELETE). The remote side's own rights decide what the remote user may do there.
+--
+-- Administrators manage them (Workspace utilities → Remote databases); the rows are installation data, never
+-- exported with an application (the foreign tables are database objects, like the application's own tables).
+
+create table meta.remote_database (
+  id            serial primary key,
+  -- the static id: upper case, used in messages and the server's name
+  name          text not null unique check (name ~ '^[A-Z][A-Z0-9_]{0,29}$'),
+  description   text check (length(description) <= 1000),
+  host          text not null check (length(host) between 1 and 253),
+  port          int not null default 5432 check (port between 1 and 65535),
+  dbname        text not null check (length(dbname) between 1 and 63),
+  user_name     text not null check (length(user_name) between 1 and 63),
+  remote_schema text not null default 'public' check (length(remote_schema) between 1 and 63),
+  -- the schema the foreign tables go into; pgkiln's own (marked by its comment), dropped with the remote database
+  local_schema  text not null unique check (local_schema ~ '^[a-z_][a-z0-9_]{0,62}$'),
+  -- the remote tables to import; empty: all of the remote schema's tables and views
+  tables        text[] not null default '{}',
+  -- application database roles granted USAGE on the schema and SELECT (and with writable INSERT, UPDATE, DELETE)
+  grant_roles   text[] not null default '{}',
+  writable      boolean not null default false,
+  -- the postgres_fdw server: pgkiln_rdb_<name in lower case>
+  server_name   text not null unique,
+  imported_at   timestamptz,
+  imported      int,
+  error         text,
+  created_by    text not null,
+  updated_by    text not null,
+  updated_at    timestamptz not null default now()
+);
+revoke all on meta.remote_database from public;
+comment on table meta.remote_database is 'Remote PostgreSQL databases imported as foreign tables (postgres_fdw) into a local schema (150); installation data, administrators only, never exported. Passwords live only in the user mapping.';

package/db/migrations/146_database_model_providers.sql

@@ -0,0 +1,53 @@
+-- Sprint 151 (AP-1 leftover; APEX: a Vector Provider with an ONNX model loaded in the database): vector providers of
+-- type database_model. The model runs inside PostgreSQL, through an extension (engine), with no AI service:
+--
+--   {"name": "DOCS_E5", "type": "database_model", "engine": "pgml", "model": "intfloat/e5-small-v2", "dimensions": 384}
+--
+-- engine pgml (PostgresML): pgml.embed(model, text) runs the model (Hugging Face transformers, ONNX among them) in the
+-- database server and returns real[]. Like a function provider, meta.embed() runs it as the caller (its grants
+-- apply: the application's role needs USAGE on schema pgml), so vector columns are kept at once by their trigger,
+-- searches embed the search text in the query, and a Retrieve tool needs no AI service. The model name is a
+-- parameter, never SQL. Other engines can be added here (the list in src/ai/embeddings.ts names them).
+
+create or replace function meta.embed(p_text text, p_provider text, p_app int default null) returns real[]
+language plpgsql stable set search_path = meta, pg_catalog as $$
+declare
+  v   jsonb := meta.vector_provider(p_provider, p_app);
+  fn  text;
+  r   real[];
+begin
+  if v is null then
+    raise exception 'meta.embed: there is no vector provider %', upper(p_provider);
+  end if;
+  if p_text is null then
+    return null;
+  end if;
+  if v->>'type' = 'database_model' then
+    -- (146) a model in the database
+    if v->>'engine' is distinct from 'pgml' then
+      raise exception 'meta.embed: vector provider % has engine %, which pgkiln doesn''t know (pgml)', v->>'name', coalesce(v->>'engine', '(none)');
+    end if;
+    if coalesce(v->>'model', '') !~ '^[A-Za-z0-9][A-Za-z0-9._:/@-]{0,199}$' then
+      raise exception 'meta.embed: the model of vector provider % is a model name', v->>'name';
+    end if;
+    if to_regprocedure('pgml.embed(text, text, jsonb)') is null then
+      raise exception 'meta.embed: vector provider % runs model % with PostgresML, which is not installed in this database (create extension pgml)', v->>'name', v->>'model'
+        using errcode = '42883';
+    end if;
+    execute 'select (pgml.embed($1, $2))::real[]' into r using v->>'model', p_text;
+  elsif v->>'type' = 'function' then
+    fn := v->>'function';
+    if fn !~ '^[A-Za-z_][A-Za-z0-9_]{0,62}\.[A-Za-z_][A-Za-z0-9_]{0,62}$' then
+      raise exception 'meta.embed: the function of vector provider % is schema.name', v->>'name';
+    end if;
+    execute format('select (%I.%I($1))::real[]', split_part(fn, '.', 1), split_part(fn, '.', 2)) into r using p_text;
+  else
+    raise exception 'meta.embed: vector provider % uses AI service %, which the pgkiln server calls: use it in a vector search configuration, a Retrieve tool or a vector column (Table Properties › Add vector column); in SQL only function and database model providers embed',
+      v->>'name', v->>'service';
+  end if;
+  if r is not null and cardinality(r) is distinct from (v->>'dimensions')::int then
+    raise exception 'meta.embed: vector provider % returned % dimensions, it has %', v->>'name', cardinality(r), v->>'dimensions';
+  end if;
+  return r;
+end
+$$;

package/docs/apex-feature-parity.md

@@ -7,7 +7,7 @@ open item and open an issue or pull request; see [CONTRIBUTING.md](../CONTRIBUTI
 Legend: ✅ available · 🟡 partial (see notes) · ❌ not yet · ➖ not planned (a deliberate choice,
 or better served by the PostgreSQL ecosystem; see the notes and [extensions](guide/15-extensions.md))
 
-Last reviewed: 2026-11-05 against **APEX 26.2** (sprint 147: `pgkiln advise --offline` checks an export's files without a database (AP-10 leftover); sprint 146: the Advisor checks JSON sources' views against their data profile (AP-8 leftover); sprint 145: the texts that offered AI with "Claude or OpenAI" name all four providers: Claude, OpenAI, Gemini and OpenAI-compatible services (AP-11); sprint 144: `pgkiln advise` for CI with text, JSON and SARIF output (APEXlang static analysis / SQLcl CodeScan), security checks in the Advisor, and working copies and locks from the command line and MCP (the Working Copy APIs) (AP-10); sprint 143: the interactive report's 26.2 dialogs: *is one of* / *is not one of* filters with the column's values and counts, *is between* two values (dates with the date picker in the application's format), relative periods on date columns, and the column order by drag and drop or arrow buttons, followed by downloads and the PDF (AP-9); sprint 142: JSON sources with a data profile and updatable views whose arrays are rows, document views of a table with its children (APEX's duality views), JSON path columns in reports (AP-8); sprint 141: static workspace files (`#WORKSPACE_FILES#`), remote servers for REST data sources, catalogs and AI services (an environment variable per environment), and workspace-level web credentials (AP-7); sprint 140: the items Shuttle (ordered), Select One and Select Many, the regions Classic Report (report templates, pagination types), Breadcrumb and Help Text with a page help text, and a [mapping of every APEX item and region type](#item-and-region-types-one-by-one) (AP-4); sprint 139: OpenTelemetry, traces with a span per SQL statement, web call, AI request and tool call, logs, metrics and `/metrics` for Prometheus, browser spans relayed by pgkiln, per workspace off or its own collector (AP-6); sprint 138: an application's Utilities tab with a dashboard, database object dependencies, change history per component, Upgrade application, UI defaults (APEX's Attribute Dictionary), application and page checksums and an icon browser (AP-5); sprint 137: Create page as a grid of page types with previews, the page types interactive report, smart filters, search page, data loading, tree, timeline, media list, content row, comments, dashboard, wizard, unified task list and workflow console, a Feature tab with nine features that install once, and Create page as copy with shared components mapped or copied (AP-3); sprint 136: vector providers (an AI service with an embedding model or a SQL function), `meta.embed`, *Add vector column* in Table Properties with an HNSW index and a queue that keeps embeddings current, search types vector and hybrid (reciprocal rank fusion with full-text) and a Retrieve (RAG) tool for AI agents, all as the app's role through RLS, on pgvector (AP-1); sprint 135: full-text search configurations, APEX's Oracle Text search type on PostgreSQL full-text search with stemming, ranking, highlights, *Did you mean* and *Add full-text search* in Table Properties (AP-2); sprint 134: the builder also in Italiano, 中文 (简体), 中文 (繁體), 日本語 and 한국어, APEX's ten builder languages plus Nederlands (SEC-5); sprints 121, 123–125: the builder in Deutsch, English, Español, Français, Nederlands and Português, step by step: the frame, sign-in, Workspace home, App Builder, Page Designer menus, the SQL Workshop's home, SQL Worksheet, Object Browser and Table Properties, Shared Components, application settings, users, identity providers, developers and workspaces (WS-7); sprint 122: *Ask in your own words* sets faceted search and smart filter facets, smart filters read a typed phrase (WS-5), and Sample Maps, Sample Approvals, Sample Data Loading and Sample Files in the App Gallery (WS-8); sprint 120: the App Gallery's single-topic sample apps (charts, cards, calendar, interactive grids, dynamic actions, reporting), the UX Pattern Catalog and a Utility Apps tab with Lookup Lists, Release Notes and Announcements (WS-8); sprint 119: data security per table, a roles × columns matrix and masked values per application role in a masking view, the same identity for pages, AI tools, REST, AutoREST and MCP (WS-13); sprint 118: Administration → Mail queue with delivery per hour and per workspace, the slowest provider calls and failures with Retry and Purge, a workspace's own mail service, and workspace network access lists that narrow the installation's allow-list (WS-9); sprint 117: Pillar Light and Pillar Dark navigation appearances with a header strip, clearer navigation tree states, subtle colour utilities, RTL; sprint 116: the comparison moved from 26.1 to 26.2, with a section for the 26.2 workspace items WS-1 … WS-13 and OCI managed identities; the App Builder list with Updated by, working copies and the lock; `pgkiln import --only`, a file-level import; stale rows on facet menus and blueprints fixed; sprint 115: popup LOVs that load on scroll, Wait Popup dynamic actions and dynamic actions on menu entries; sprint 114: Workflow 26.2 with custom task outcomes, task events and notifications, Send E-Mail and draft steps, migrating running instances and the diagram as SVG / PNG; sprint 113: Team Development with issues, labels, milestones, templates, a board and a set-up wizard; sprint 112: AI interactive reports with chips, Undo, computed columns and a phrase parser that needs no AI service; sprint 111: AI Agents with tools as a shared component, a Navigate tool with checksummed URLs, Gemini and OpenAI-compatible services; sprint 110: Data Reporter as a workspace tool with datasets, reporting applications, editors and viewers, published reports with stable URLs and pins; sprint 109: the Workspace home above the App Builder and SQL Workshop, with a summary, top applications, users and developers, and an optional release check; sprint 108: the code editor's syntax colours in the builder's light and dark themes, read-only SQL highlighted, the Data Modeler in dark mode; sprint 107: a transaction mode in the SQL Worksheet with Commit and Rollback; DA-18: JavaScript (MLE) not planned, plv8 where installed; sprint 106: the change log of DDL change sets with Flyway, Liquibase and SQL downloads; sprint 104: RESTful Services modules, templates and handlers with PL/pgSQL and media handlers, privileges, OpenAPI and Try it; sprint 103: Schema Export / Import with pg_dump and pg_restore; sprint 102: the SQL Monitor with live sessions, Top SQL and a statement's plan; sprint 101: Scheduling of pg_cron jobs with a schedule builder, run now and run history; sprint 100: RESTful Services, tables and views published as REST endpoints with paging, filters, keys and OpenAPI; sprint 99: Administration → Database Users for PostgreSQL roles; sprint 98: the Data Modeler with relational diagrams, DDL and a data dictionary; sprint 97: charts of a query in the worksheet, saved charts and their dashboard; sprint 96: the SQL Workshop's Launchpad with pins and tool groups, the builder's search with Ctrl+K; sprint 95: Table Properties: create, edit or copy a table in a form with a DDL preview and Apply in one transaction; sprint 94: an object's menu with Open in a panel, Quick DDL, Add index / trigger / policy and Drop with dependents; sprint 93: worksheets saved as SQL Scripts with tabs and a Files list, Format, Convert case, find and replace, bind and substitution variables; sprint 92: the worksheet's Query Result with sort, value dialog, copy and downloads, plans as a tree with the slowest step and misestimates, SQL History with status, search and run again; sprint 91: the SQL Worksheet like Database Actions' SQL: navigator, Run Statement at the cursor and Run Script with a log per statement, Explain Plan, Autotrace, notices, history, Run as an application role; sprint 90: Comment Out in the page designer, gallery labels in title case; sprint 89: the Object Browser's schema, one row of tabs, blank NULLs, Modify column; sprint 88: home cards with colour bands and round icons, the hero on the page background, a page footer with the version and Back to top; sprint 87: the Create Application wizard reloads the page list for a schema, RLS badges, the alias from the name; sprint 86: the page designer by page number, HTML error pages in the builder; sprint 85: the Form Designer, beyond APEX; sprint 84: the date picker, facet menus; sprint 83: Component Settings and Component Groups; sprint 82: Report Queries; sprint 81: Application Computations and Shortcuts in Shared Components; sprint 80: the master grid's first row selected when the page opens and after a search; grid cells as text with their format mask until edited, with cell navigation by arrow keys, Enter, F2 and Escape; sprint 79: generated dashboards with sums, donuts and lines, leaving out charts that say nothing; applications open in their own light or dark mode until the user chooses, per application; a user menu with Appearance and Sign in when signed out; the developer toolbar's App and Page texts and debug state; the report search's column scope in the magnifier; sprint 78: generated faceted search reports with one column per foreign key, the faceted search's total row count, Show all and Yes/No values, one search field, friendly headings and number formats in generated grids and master-detail pages, friendly names in the Create Application wizard's page list; sprint 77: the Page Designer's layout and tree by display position, button positions, the tree's context menu with Duplicate and Copy to other page, Show Common / Show All, Go to group and the Template Options dialog; display positions, button positions and side-column page templates at runtime; sprint 76: the interactive report's menus and pagination, date items in the date format; sprint 75: the SQL Workshop's Object Browser and tabs; sprint 74: the builder's information architecture: Shared Components grid, Settings tabs, application home search and tasks; sprint 73: the Create Application wizard on one page with page types and features; sprint 72: the runtime chrome compared with APEX 26.2's: the developer toolbar, the Iris look, the navigation bar's Help menu and Install button; sprint 71: generated applications compared with APEX 26.2's: labels, foreign key names in reports, file columns, format masks, the Home page and the dashboard; sprint 70: treemap, sunburst and timeline charts; sprint 69: dragging tasks on a Gantt chart; sprint 68: the Data Reporter's welcome page, Find my workspace; sprint 67: REST source catalogs from OpenAPI documents, a workspace's export and import (two rows added); sprint 66: a blueprint from an existing application; sprint 65: facet charts; sprint 64: approval vacation rules and expiration policies; sprint 63: range, box plot and stock charts; sprint 62: workspace preferences (SQL Workshop and RESTful services per workspace), extension links, Manage backups across applications, SQL Workshop utilities with object reports, About Database and a database monitor; sprint 61: the builder's screens compared with APEX 26.1: the workspace sign-in page, the Administration menu with workspace message, environment banner and utilization, the SQL Workshop home, the App Gallery, application groups and cross application reports (four rows added); sprint 60: isolated workspaces with their own database logins, row-level security on pgkiln's tables and workspace database roles, workspace administrators; sprint 59: the Page Designer's help pane, Quick edit from the developer toolbar; sprint 58: page groups; sprint 57: region templates hero, title bar, buttons container, inline dialog and drawer, wizard with wizard progress, the carousel; sprint 56: Generate DDL and Schema Comparison in the SQL Workshop, `pgkiln ddl` and `pgkiln compare`; sprint 55: an editable login page with a Login region and the Minimal page template, Forgot password through the application's mail service; sprint 54: interactive grid views, the single row view, group by and chart; sprint 53: application settings, user preferences and items kept per user, dynamic translations, `meta.data_export` and data export downloads, display image and geocoded address items; sprint 52: every dynamic action event and action, Ajax callbacks, an error handling function, the session timeout warning; sprint 51: checked imports, application backups, availability and Run only, feedback, type-specific attribute help; sprint 50: lost update detection, warn on unsaved changes, the URL and search regions with search configurations, the developer toolbar with a session state viewer, and e-mail through SMTP with OAuth2, Microsoft Graph, Amazon SES and HTTP APIs; import checks, application availability, property help and e-mail compared again; 2026-10-06: pgkiln 0.31.0, in progress: static application files and the Execute JavaScript dynamic action; region, item, dynamic action and process plug-ins; conditional and dynamic theme styles; XML and Excel in `meta.parse_data`, zips in SQL, `meta.v_boolean`; file items in S3-compatible object storage; map layers by the visible area and as vector tiles; a graphical query builder; tenants for workflows and tasks; application files as YAML and region static IDs; Lucide icons and icon modifiers; PWA push notifications; 0.30.0: 136 icons and an icon picker; an axe-core accessibility audit; cropping pictures; session sharing between applications; twenty-two built-in languages; 0.29.0: workspaces; the Iris base style; drawers; built-in template components including the metric card; Theme Roller dark-mode colours, live preview and template options on items and report columns; report selection across pages; instance settings; fourteen built-in languages; 0.28.0: AI with Claude and OpenAI; 0.27.0: Data Reporter; sample data generator; create application from several sheets, pasted data or existing tables; 0.26.0: working copies with a three-way merge; theme, library and boilerplate applications with subscriptions; 0.25.0: Gantt, pyramid and polar charts; map layers, clustering and server-side spatial filters; REST data sources that write back from forms and grids and synchronise into tables, OAuth2 password and refresh-token grants; debug messages per request and an install/upgrade log; `meta.web_request()` and `meta.parse_data()`; Theme Roller style variants and template options; 0.24.0: automations with several actions, error handling per row and runs from SQL; invoke-API workflow steps; Unload Data in the Data Workshop; create page wizards for cards, calendar, chart, map, faceted search, form and master-detail; create an application from a file; 0.23.0: interactive grid aggregates, frozen/moved/resized columns, layouts and saved grid reports, master-detail, row actions and copy/paste; download processes, execution chains in the background, workflow processes, branches to a function's URL or another app, the Dialog Closed event; number format masks, automatic time zone, runtime messages in German, French and Spanish; SQL scripts, Quick SQL, a query builder, XML loading and data load definitions; custom authentication, lists, page and application locks with developer comments, supporting objects; 0.22.0: keyset paging, report PDFs and REST collections streamed from a cursor, database-account authentication; 0.21.0: HTTP-header authentication behind a reverse proxy; 0.20.0: a popup list of values with server-side search; 0.19.0: row-range pagination, maximum row counts and row limits, lazy loading and caching of regions, streamed CSV/Excel downloads; 0.18.0: calendar week/day/list views with drag and drop, bubble/gauge/funnel/radar charts and drill-down, smart filters, a region display selector and more facet types, computations, conditional branches, build options, menu buttons, REST data sources and web credentials, rich text/Markdown, rating, combobox, date range and QR code items; 0.17.0: an App Builder home, workspace dashboard and utilities like APEX's; 0.16.0: a Page Designer with drag-and-drop layout, a code editor with autocomplete, template components and plug-ins, parallel branches and versions of workflows, the `pgkiln` command line with one file per component; 0.15.0: drop and paste files, heat maps, filtering a report by the map area; 0.14.0: stacked, combo, scatter and pie charts, several files per upload item; 0.13.0: map and tree regions; 0.12.0: REST modules in the builder; 0.11.0: workflows and Progressive Web Apps; 0.10.0: LDAP, SAML, "Keep me signed in", document templates, JSON loading, approvals and the task list; pgkiln installs no application, HR is an example).
+Last reviewed: 2026-11-05 against **APEX 26.2** (sprint 153: Database users in the eleven builder languages (WS-7 leftover); sprint 152: Workspace utilities, the dashboard, Mail queue, Network access, Instance settings and LDAP directories in the eleven builder languages (WS-7 leftover); sprint 151: vector providers with a model in the database, PostgresML (APEX's ONNX models, AP-1 leftover); sprint 150: remote databases, another PostgreSQL database's tables as foreign tables the applications query (REST Enabled SQL, AP-7 leftover); sprint 149: running workflow instances inside parallel branches migrate to a newer version (WS-6 leftover); sprint 148: the AI assistant streams its answers as the model writes them (WS-4 leftover); sprint 147: `pgkiln advise --offline` checks an export's files without a database (AP-10 leftover); sprint 146: the Advisor checks JSON sources' views against their data profile (AP-8 leftover); sprint 145: the texts that offered AI with "Claude or OpenAI" name all four providers: Claude, OpenAI, Gemini and OpenAI-compatible services (AP-11); sprint 144: `pgkiln advise` for CI with text, JSON and SARIF output (APEXlang static analysis / SQLcl CodeScan), security checks in the Advisor, and working copies and locks from the command line and MCP (the Working Copy APIs) (AP-10); sprint 143: the interactive report's 26.2 dialogs: *is one of* / *is not one of* filters with the column's values and counts, *is between* two values (dates with the date picker in the application's format), relative periods on date columns, and the column order by drag and drop or arrow buttons, followed by downloads and the PDF (AP-9); sprint 142: JSON sources with a data profile and updatable views whose arrays are rows, document views of a table with its children (APEX's duality views), JSON path columns in reports (AP-8); sprint 141: static workspace files (`#WORKSPACE_FILES#`), remote servers for REST data sources, catalogs and AI services (an environment variable per environment), and workspace-level web credentials (AP-7); sprint 140: the items Shuttle (ordered), Select One and Select Many, the regions Classic Report (report templates, pagination types), Breadcrumb and Help Text with a page help text, and a [mapping of every APEX item and region type](#item-and-region-types-one-by-one) (AP-4); sprint 139: OpenTelemetry, traces with a span per SQL statement, web call, AI request and tool call, logs, metrics and `/metrics` for Prometheus, browser spans relayed by pgkiln, per workspace off or its own collector (AP-6); sprint 138: an application's Utilities tab with a dashboard, database object dependencies, change history per component, Upgrade application, UI defaults (APEX's Attribute Dictionary), application and page checksums and an icon browser (AP-5); sprint 137: Create page as a grid of page types with previews, the page types interactive report, smart filters, search page, data loading, tree, timeline, media list, content row, comments, dashboard, wizard, unified task list and workflow console, a Feature tab with nine features that install once, and Create page as copy with shared components mapped or copied (AP-3); sprint 136: vector providers (an AI service with an embedding model or a SQL function), `meta.embed`, *Add vector column* in Table Properties with an HNSW index and a queue that keeps embeddings current, search types vector and hybrid (reciprocal rank fusion with full-text) and a Retrieve (RAG) tool for AI agents, all as the app's role through RLS, on pgvector (AP-1); sprint 135: full-text search configurations, APEX's Oracle Text search type on PostgreSQL full-text search with stemming, ranking, highlights, *Did you mean* and *Add full-text search* in Table Properties (AP-2); sprint 134: the builder also in Italiano, 中文 (简体), 中文 (繁體), 日本語 and 한국어, APEX's ten builder languages plus Nederlands (SEC-5); sprints 121, 123–125: the builder in Deutsch, English, Español, Français, Nederlands and Português, step by step: the frame, sign-in, Workspace home, App Builder, Page Designer menus, the SQL Workshop's home, SQL Worksheet, Object Browser and Table Properties, Shared Components, application settings, users, identity providers, developers and workspaces (WS-7); sprint 122: *Ask in your own words* sets faceted search and smart filter facets, smart filters read a typed phrase (WS-5), and Sample Maps, Sample Approvals, Sample Data Loading and Sample Files in the App Gallery (WS-8); sprint 120: the App Gallery's single-topic sample apps (charts, cards, calendar, interactive grids, dynamic actions, reporting), the UX Pattern Catalog and a Utility Apps tab with Lookup Lists, Release Notes and Announcements (WS-8); sprint 119: data security per table, a roles × columns matrix and masked values per application role in a masking view, the same identity for pages, AI tools, REST, AutoREST and MCP (WS-13); sprint 118: Administration → Mail queue with delivery per hour and per workspace, the slowest provider calls and failures with Retry and Purge, a workspace's own mail service, and workspace network access lists that narrow the installation's allow-list (WS-9); sprint 117: Pillar Light and Pillar Dark navigation appearances with a header strip, clearer navigation tree states, subtle colour utilities, RTL; sprint 116: the comparison moved from 26.1 to 26.2, with a section for the 26.2 workspace items WS-1 … WS-13 and OCI managed identities; the App Builder list with Updated by, working copies and the lock; `pgkiln import --only`, a file-level import; stale rows on facet menus and blueprints fixed; sprint 115: popup LOVs that load on scroll, Wait Popup dynamic actions and dynamic actions on menu entries; sprint 114: Workflow 26.2 with custom task outcomes, task events and notifications, Send E-Mail and draft steps, migrating running instances and the diagram as SVG / PNG; sprint 113: Team Development with issues, labels, milestones, templates, a board and a set-up wizard; sprint 112: AI interactive reports with chips, Undo, computed columns and a phrase parser that needs no AI service; sprint 111: AI Agents with tools as a shared component, a Navigate tool with checksummed URLs, Gemini and OpenAI-compatible services; sprint 110: Data Reporter as a workspace tool with datasets, reporting applications, editors and viewers, published reports with stable URLs and pins; sprint 109: the Workspace home above the App Builder and SQL Workshop, with a summary, top applications, users and developers, and an optional release check; sprint 108: the code editor's syntax colours in the builder's light and dark themes, read-only SQL highlighted, the Data Modeler in dark mode; sprint 107: a transaction mode in the SQL Worksheet with Commit and Rollback; DA-18: JavaScript (MLE) not planned, plv8 where installed; sprint 106: the change log of DDL change sets with Flyway, Liquibase and SQL downloads; sprint 104: RESTful Services modules, templates and handlers with PL/pgSQL and media handlers, privileges, OpenAPI and Try it; sprint 103: Schema Export / Import with pg_dump and pg_restore; sprint 102: the SQL Monitor with live sessions, Top SQL and a statement's plan; sprint 101: Scheduling of pg_cron jobs with a schedule builder, run now and run history; sprint 100: RESTful Services, tables and views published as REST endpoints with paging, filters, keys and OpenAPI; sprint 99: Administration → Database Users for PostgreSQL roles; sprint 98: the Data Modeler with relational diagrams, DDL and a data dictionary; sprint 97: charts of a query in the worksheet, saved charts and their dashboard; sprint 96: the SQL Workshop's Launchpad with pins and tool groups, the builder's search with Ctrl+K; sprint 95: Table Properties: create, edit or copy a table in a form with a DDL preview and Apply in one transaction; sprint 94: an object's menu with Open in a panel, Quick DDL, Add index / trigger / policy and Drop with dependents; sprint 93: worksheets saved as SQL Scripts with tabs and a Files list, Format, Convert case, find and replace, bind and substitution variables; sprint 92: the worksheet's Query Result with sort, value dialog, copy and downloads, plans as a tree with the slowest step and misestimates, SQL History with status, search and run again; sprint 91: the SQL Worksheet like Database Actions' SQL: navigator, Run Statement at the cursor and Run Script with a log per statement, Explain Plan, Autotrace, notices, history, Run as an application role; sprint 90: Comment Out in the page designer, gallery labels in title case; sprint 89: the Object Browser's schema, one row of tabs, blank NULLs, Modify column; sprint 88: home cards with colour bands and round icons, the hero on the page background, a page footer with the version and Back to top; sprint 87: the Create Application wizard reloads the page list for a schema, RLS badges, the alias from the name; sprint 86: the page designer by page number, HTML error pages in the builder; sprint 85: the Form Designer, beyond APEX; sprint 84: the date picker, facet menus; sprint 83: Component Settings and Component Groups; sprint 82: Report Queries; sprint 81: Application Computations and Shortcuts in Shared Components; sprint 80: the master grid's first row selected when the page opens and after a search; grid cells as text with their format mask until edited, with cell navigation by arrow keys, Enter, F2 and Escape; sprint 79: generated dashboards with sums, donuts and lines, leaving out charts that say nothing; applications open in their own light or dark mode until the user chooses, per application; a user menu with Appearance and Sign in when signed out; the developer toolbar's App and Page texts and debug state; the report search's column scope in the magnifier; sprint 78: generated faceted search reports with one column per foreign key, the faceted search's total row count, Show all and Yes/No values, one search field, friendly headings and number formats in generated grids and master-detail pages, friendly names in the Create Application wizard's page list; sprint 77: the Page Designer's layout and tree by display position, button positions, the tree's context menu with Duplicate and Copy to other page, Show Common / Show All, Go to group and the Template Options dialog; display positions, button positions and side-column page templates at runtime; sprint 76: the interactive report's menus and pagination, date items in the date format; sprint 75: the SQL Workshop's Object Browser and tabs; sprint 74: the builder's information architecture: Shared Components grid, Settings tabs, application home search and tasks; sprint 73: the Create Application wizard on one page with page types and features; sprint 72: the runtime chrome compared with APEX 26.2's: the developer toolbar, the Iris look, the navigation bar's Help menu and Install button; sprint 71: generated applications compared with APEX 26.2's: labels, foreign key names in reports, file columns, format masks, the Home page and the dashboard; sprint 70: treemap, sunburst and timeline charts; sprint 69: dragging tasks on a Gantt chart; sprint 68: the Data Reporter's welcome page, Find my workspace; sprint 67: REST source catalogs from OpenAPI documents, a workspace's export and import (two rows added); sprint 66: a blueprint from an existing application; sprint 65: facet charts; sprint 64: approval vacation rules and expiration policies; sprint 63: range, box plot and stock charts; sprint 62: workspace preferences (SQL Workshop and RESTful services per workspace), extension links, Manage backups across applications, SQL Workshop utilities with object reports, About Database and a database monitor; sprint 61: the builder's screens compared with APEX 26.1: the workspace sign-in page, the Administration menu with workspace message, environment banner and utilization, the SQL Workshop home, the App Gallery, application groups and cross application reports (four rows added); sprint 60: isolated workspaces with their own database logins, row-level security on pgkiln's tables and workspace database roles, workspace administrators; sprint 59: the Page Designer's help pane, Quick edit from the developer toolbar; sprint 58: page groups; sprint 57: region templates hero, title bar, buttons container, inline dialog and drawer, wizard with wizard progress, the carousel; sprint 56: Generate DDL and Schema Comparison in the SQL Workshop, `pgkiln ddl` and `pgkiln compare`; sprint 55: an editable login page with a Login region and the Minimal page template, Forgot password through the application's mail service; sprint 54: interactive grid views, the single row view, group by and chart; sprint 53: application settings, user preferences and items kept per user, dynamic translations, `meta.data_export` and data export downloads, display image and geocoded address items; sprint 52: every dynamic action event and action, Ajax callbacks, an error handling function, the session timeout warning; sprint 51: checked imports, application backups, availability and Run only, feedback, type-specific attribute help; sprint 50: lost update detection, warn on unsaved changes, the URL and search regions with search configurations, the developer toolbar with a session state viewer, and e-mail through SMTP with OAuth2, Microsoft Graph, Amazon SES and HTTP APIs; import checks, application availability, property help and e-mail compared again; 2026-10-06: pgkiln 0.31.0, in progress: static application files and the Execute JavaScript dynamic action; region, item, dynamic action and process plug-ins; conditional and dynamic theme styles; XML and Excel in `meta.parse_data`, zips in SQL, `meta.v_boolean`; file items in S3-compatible object storage; map layers by the visible area and as vector tiles; a graphical query builder; tenants for workflows and tasks; application files as YAML and region static IDs; Lucide icons and icon modifiers; PWA push notifications; 0.30.0: 136 icons and an icon picker; an axe-core accessibility audit; cropping pictures; session sharing between applications; twenty-two built-in languages; 0.29.0: workspaces; the Iris base style; drawers; built-in template components including the metric card; Theme Roller dark-mode colours, live preview and template options on items and report columns; report selection across pages; instance settings; fourteen built-in languages; 0.28.0: AI with Claude and OpenAI; 0.27.0: Data Reporter; sample data generator; create application from several sheets, pasted data or existing tables; 0.26.0: working copies with a three-way merge; theme, library and boilerplate applications with subscriptions; 0.25.0: Gantt, pyramid and polar charts; map layers, clustering and server-side spatial filters; REST data sources that write back from forms and grids and synchronise into tables, OAuth2 password and refresh-token grants; debug messages per request and an install/upgrade log; `meta.web_request()` and `meta.parse_data()`; Theme Roller style variants and template options; 0.24.0: automations with several actions, error handling per row and runs from SQL; invoke-API workflow steps; Unload Data in the Data Workshop; create page wizards for cards, calendar, chart, map, faceted search, form and master-detail; create an application from a file; 0.23.0: interactive grid aggregates, frozen/moved/resized columns, layouts and saved grid reports, master-detail, row actions and copy/paste; download processes, execution chains in the background, workflow processes, branches to a function's URL or another app, the Dialog Closed event; number format masks, automatic time zone, runtime messages in German, French and Spanish; SQL scripts, Quick SQL, a query builder, XML loading and data load definitions; custom authentication, lists, page and application locks with developer comments, supporting objects; 0.22.0: keyset paging, report PDFs and REST collections streamed from a cursor, database-account authentication; 0.21.0: HTTP-header authentication behind a reverse proxy; 0.20.0: a popup list of values with server-side search; 0.19.0: row-range pagination, maximum row counts and row limits, lazy loading and caching of regions, streamed CSV/Excel downloads; 0.18.0: calendar week/day/list views with drag and drop, bubble/gauge/funnel/radar charts and drill-down, smart filters, a region display selector and more facet types, computations, conditional branches, build options, menu buttons, REST data sources and web credentials, rich text/Markdown, rating, combobox, date range and QR code items; 0.17.0: an App Builder home, workspace dashboard and utilities like APEX's; 0.16.0: a Page Designer with drag-and-drop layout, a code editor with autocomplete, template components and plug-ins, parallel branches and versions of workflows, the `pgkiln` command line with one file per component; 0.15.0: drop and paste files, heat maps, filtering a report by the map area; 0.14.0: stacked, combo, scatter and pie charts, several files per upload item; 0.13.0: map and tree regions; 0.12.0: REST modules in the builder; 0.11.0: workflows and Progressive Web Apps; 0.10.0: LDAP, SAML, "Keep me signed in", document templates, JSON loading, approvals and the task list; pgkiln installs no application, HR is an example).
 
 ## At a glance
 
@@ -20,11 +20,11 @@ Last reviewed: 2026-11-05 against **APEX 26.2** (sprint 147: `pgkiln advise --of
 | Security | 22 | 0 | 0 | 0 | An editable login page and Forgot password; a session timeout warning; On par or stricter (CSP without `unsafe-inline`); OIDC, SAML and LDAP; header authentication behind a proxy; database accounts; custom authentication |
 | User interface | 12 | 0 | 0 | 0 | Region templates incl. hero, inline dialog and drawer, wizard and carousel; Universal Theme-like and responsive; a Theme Roller with style variants and conditional, dynamic styles; about 1,700 icons with Font APEX-like modifiers |
 | Globalization | 6 | 0 | 0 | 0 | One translated app like 26.1 with dynamic translations of table values; number format masks and automatic time zone; twenty-two built-in languages |
-| Data and integration | 16 | 0 | 0 | 1 | Remote servers, static workspace files and workspace web credentials; REST source catalogs from OpenAPI documents; Generate DDL and schema comparison; `meta.data_export` and data export downloads (CSV, JSON, XML, HTML, Excel, PDF); e-mail through SMTP (password or OAuth2), Microsoft Graph, Amazon SES and HTTP APIs; REST APIs via PostgREST, REST data sources that write back and synchronise, web credentials with OAuth2 grants, CSV/XLSX/JSON/XML loading with saved definitions and unloading, SQL scripts and Quick SQL, report PDFs and document templates |
+| Data and integration | 17 | 0 | 0 | 0 | Remote servers, static workspace files and workspace web credentials; REST source catalogs from OpenAPI documents; Generate DDL and schema comparison; `meta.data_export` and data export downloads (CSV, JSON, XML, HTML, Excel, PDF); e-mail through SMTP (password or OAuth2), Microsoft Graph, Amazon SES and HTTP APIs; REST APIs via PostgREST, REST data sources that write back and synchronise, web credentials with OAuth2 grants, CSV/XLSX/JSON/XML loading with saved definitions and unloading, SQL scripts and Quick SQL, report PDFs and document templates |
 | Workflow, automation and AI | 6 | 0 | 0 | 0 | Scheduled automations with several actions and runs from SQL, approvals, a task list and workflows with parallel branches, versions and invoke-API steps; AI with Claude, OpenAI, Gemini or an OpenAI-compatible service: *Generate text with AI*, an assistant region with tools, natural-language report filters and blueprints |
 | Administration | 15 | 0 | 0 | 0 | OpenTelemetry traces, logs and metrics to the team's own monitoring and `/metrics` for Prometheus (24.2); An APEX-like sign-in with a workspace and a Workspace home; a mail queue dashboard, a workspace's own mail service and network access list (26.1 / 26.2); a workspace's components exported and imported as one file; workspace message, environment banner and utilization; isolated workspaces with their own database logins and roles, and workspace administrators; application availability and Run only, automatic backups, user feedback; a developer toolbar with a session state viewer and debug per session; Top SQL per app; debug messages per request; an install/upgrade log |
 | APEX 26.2 workspace (WS-1 … WS-13) | 13 | 0 | 0 | 1 | Workspace home, Data Reporter as a workspace tool, Team Development, AI Agents, AI interactive reports, Workflow 26.2, the mail queue, workspace mail and network access, the 26.1 component details, the App Builder list's details, the Pillar navigation appearances and data security per table (rows, columns and masked values), the App Gallery's single-topic sample apps, UX Pattern Catalog and Utility Apps; the builder in eleven languages (APEX's ten and Nederlands) |
-| **Total** | **171** | **0** | **0** | **3** | 174 APEX features compared: 98% available, none missing, 3 deliberately not planned |
+| **Total** | **172** | **0** | **0** | **2** | 174 APEX features compared: 99% available, none missing, 2 deliberately not planned |
 
 (Counts are of the rows in the tables below. A review on 2026-10-06 added 18 rows for APEX features that were
 not compared before, one on 2026-10-12 added two more (property help, application availability), and one on
@@ -285,7 +285,7 @@ review is a diff. Not counted in [At a glance](#at-a-glance): the rows above com
 | JSON sources, duality views (24.2) | ✅ | (sprint 142, AP-8) Shared Components → **JSON Sources** ([chapter 19](guide/19-rest-data-sources.md#json-sources-and-document-views)): a `jsonb` column with a data profile proposed from the documents; `security_invoker` views with a typed column per path and a view per array (stable row keys), whose triggers write only the changed paths, so unknown keys stay; forms, reports, grids, master-detail, AutoREST and MCP use them like tables; Create page makes a form with detail grids. Table Properties → **Document view**: a row and its child rows as one `jsonb` document, written back in one statement (the duality view). JSON path columns in reports. (sprint 146) The Advisor names views that no longer match their profile |
 | Remote Servers (Workspace Utilities): a named base URL per environment for REST data sources, catalogs and AI services | ✅ | (sprint 141, AP-7) Workspace utilities → **Remote servers** ([chapter 19](guide/19-rest-data-sources.md#remote-servers)): a static id, this installation's base URL and/or an environment variable `PGKILN_SERVER_<NAME>` that wins when set, and a default web credential. REST data sources (a server and a path), REST source catalogs and AI services name a server, so changing it moves every source at once; the resolved URL passes the allow-list, the workspace's network access list (which shows each server's host) and the address checks. In the workspace export (an existing server keeps its local URL) |
 | Static Workspace Files (`#WORKSPACE_FILES#`), workspace-level Web Credentials | ✅ | (sprint 141, AP-7) Workspace utilities → **Static workspace files**: CSS, JavaScript, images and fonts with the static application files' types (no HTML), size limit and headers, served to each application of the workspace at `/a/<alias>/workspace-files/<name>`, loaded with `#WORKSPACE_FILES#name` and written as `#WORKSPACE_FILES#` / `#APP_FILES#` in HTML and templates ([chapter 16](guide/16-files.md#static-workspace-files)). **Web credentials** of the workspace, used by name by its applications (an application's own of the same name wins); secrets encrypted, write-only, never exported. Both in the workspace export |
-| Remote database regions (REST Enabled SQL), database links | ➖ | Not built: regions on another database were left out of sprint 141. `postgres_fdw` or `dblink` bring another PostgreSQL database's tables into the application's own |
+| Remote database regions (REST Enabled SQL), database links | ✅ | (sprint 150, AP-7 leftover) Workspace utilities → **Remote databases** ([chapter 3](guide/03-builder.md#remote-databases)), administrators: another PostgreSQL database's tables (all of a schema, or the ones named) as `postgres_fdw` foreign tables in a local schema of their own, granted (read only, or also INSERT / UPDATE / DELETE) to chosen application roles; regions, reports, forms, grids and lists of values use them like the application's own tables, as its role in its transaction. The password lives only in PostgreSQL's user mapping; *Test the connection* imports in a transaction that is rolled back; *Import again* picks up remote changes. Other databases than PostgreSQL: their own foreign data wrapper (e.g. `oracle_fdw`, `mysql_fdw`) by hand |
 | E-mail: `APEX_MAIL`, the Send E-Mail process, e-mail templates | ✅ | (sprint 50) `meta.send_mail`, `meta.send_mail_template`, `meta.add_mail_attachment` and `meta.mail_status`, queued in the caller's transaction and sent by the server after the commit with retries; the **send_email** process; Shared Components → **E-mail templates** (`#NAME#` escaped in HTML, `#NAME!RAW#`; exported). Further than APEX (SMTP with a password only, through `UTL_SMTP`): **mail services** for SMTP with a password or **OAuth2** (XOAUTH2, e.g. Exchange Online after the end of basic authentication), **Microsoft 365 through Graph**, **Amazon SES**, **Resend, Postmark, SendGrid and Mailgun**, or log only; encrypted write-only secrets, allowed senders, a service, From address and daily limit per application, a mail log with retry and cancel ([chapter 6](guide/06-processing.md#sending-e-mail)). No bounce or delivery webhooks, no mail in workflows other than from SQL steps |
 
 ## Workflow, automation and AI
@@ -296,7 +296,7 @@ review is a diff. Not counted in [At a glance](#at-a-glance): the rows above com
 | Workflow (26.1: parallel flows, multi-tenancy) | ✅ | Workflow definitions of task, SQL, switch, wait, **invoke API** (a REST data source or URL through the invoke-API code, response values and the HTTP status into variables, retryable faults, no transaction open during the call) and end steps with variables, started from application SQL, run by the server (NOTIFY + polling) as the app's role; console region (terminate, retry a faulted step); diagram in the builder. **Parallel branches** (split, then a join that waits for all or for the first branch) and **versions** (development, active, inactive; running instances keep theirs) ([chapter 6](guide/06-processing.md#workflows)). (0.31) **Tenants**: `meta.set_tenant()` (APEX: `APEX_SESSION.SET_TENANT_ID`); workflows, their tasks, background chains, the task list, the console and every action follow the session's tenant ([chapter 6](guide/06-processing.md#tenants)). (sprint 114, 26.1 / 26.2) **Send E-Mail** steps (a template or subject and body), **draft** steps allowed only in development versions, branching on custom task outcomes, **migrating running instances** to a newer version (step mapping, preview, one transaction, a log; not yet for instances inside open parallel branches: [chapter 6](guide/06-processing.md#migrating-instances)) and the diagram as **SVG / PNG** |
 | Automations (scheduled) | ✅ | Shared Components → Automations: cron schedules with time zones, once or per row of a query, **several ordered actions** with their own conditions, **error handling** (stop, skip the row and continue, or disable; row errors in the run history), roles, run history and Run now, **on-demand runs from SQL** with `meta.run_automation()` (like `APEX_AUTOMATION.EXECUTE`, synchronous in the caller's transaction), safe with several servers ([chapter 6](guide/06-processing.md#automations)) |
 | AI assistant, natural-language reports (NL2IR), AI agents and tools (26.1) | ✅ | Region type **AI assistant**: a conversation per session, context queries (RAG over developer queries, run as the app's role, read-only), and **tools** the model may call: SQL with bound arguments checked against declared parameters (read-only unless marked as writing, row limit, timeout) and REST data sources, each optionally behind an authorization scheme. **AI Interactive Reports** (sprint 112; 26.1 / 26.2): an "Ask in your own words" box turns a question into the report's own settings (filters, highlights, search, sort, control break, totals, group by, pivot, chart and computed columns such as "bonus is 10% of salary"), never SQL, limited to its shown columns; each setting is a chip with Edit and Remove, plus Undo. Without an AI service a built-in phrase parser (English, Dutch, German) answers ([chapter 4](guide/04-pages-and-regions.md#ask-in-your-own-words-ai-interactive-reports)). (sprint 122) Conditions a facet can hold set the page's **faceted search and smart filters** facets (values, excluded values, custom ranges, stars), shown as chips; smart filters with `"ask": true` read a typed phrase and offer it as one suggestion. (sprint 111) **AI Agents** as a shared component (26.1 / 26.2): an AI service, system prompt, reasoning effort (low / medium / high, mapped per provider), approved tools, max steps and tokens and an authorization scheme; an assistant region names one. **AI Tools**: SQL (read-only transaction, the app role through RLS, timeout), PL/pgSQL function, REST data source, JavaScript action (a registered action or custom-event dynamic action), and **Navigate**: pgkiln builds the checksummed URL, only to pages the user may open. Every tool call is logged with its arguments (debug and Activity → AI usage). Providers add Gemini and OpenAI-compatible endpoints (Ollama, vLLM, Azure OpenAI). Answers are not streamed; no OCI provider. `pgvector` covers semantic search on the data side (sprint 136) A **Retrieve (RAG)** tool type: the model gives a text, the agent gets the best rows of a search configuration (vector or hybrid) as the app's role in a read-only transaction, logged like other tools |
-| Vector providers, `APEX_AI.GET_VECTOR_EMBEDDINGS`, vector search (24.2) | ✅ | (sprint 136, AP-1) Shared Components → **Vector providers** (exported with the application): an AI service with an embedding model (OpenAI `text-embedding-3-*`, Gemini, any OpenAI-compatible endpoint such as Ollama; the key stays with the service) or a SQL / PL/pgSQL function returning `vector`, with its dimensions, checked on every embedding and against vector columns; **Test**. `meta.embed(text, provider)` for function providers in SQL (as the caller; AI services are called by the server only). Workspace utilities → Vector providers: pgvector detected, *Create extension vector* for administrators, the workspace's providers and vector columns. SQL Workshop › Table Properties › **Add vector column**: `vector(n)`, an HNSW index and a trigger that re-embeds changed rows, at once (function) or through a queue the server works in batches within the provider's requests per minute and the app's daily AI limits, logged under AI usage; **Backfill** with progress ([chapter 3](guide/03-builder.md#vector-providers)). No ONNX models in the database (use a function provider, e.g. pgml or pgai) |
+| Vector providers, `APEX_AI.GET_VECTOR_EMBEDDINGS`, vector search (24.2) | ✅ | (sprint 136, AP-1) Shared Components → **Vector providers** (exported with the application): an AI service with an embedding model (OpenAI `text-embedding-3-*`, Gemini, any OpenAI-compatible endpoint such as Ollama; the key stays with the service) or a SQL / PL/pgSQL function returning `vector`, with its dimensions, checked on every embedding and against vector columns; **Test**. `meta.embed(text, provider)` for function providers in SQL (as the caller; AI services are called by the server only). Workspace utilities → Vector providers: pgvector detected, *Create extension vector* for administrators, the workspace's providers and vector columns. SQL Workshop › Table Properties › **Add vector column**: `vector(n)`, an HNSW index and a trigger that re-embeds changed rows, at once (function) or through a queue the server works in batches within the provider's requests per minute and the app's daily AI limits, logged under AI usage; **Backfill** with progress ([chapter 3](guide/03-builder.md#vector-providers)). (sprint 151) Models in the database as a provider type of their own: PostgresML's `pgml.embed` runs a Hugging Face model (ONNX among them) inside PostgreSQL, as the query's role, with no AI service |
 | *Generate Text with AI* process, structured outputs (26.1) | ✅ | **AI services** (Workspace utilities, administrators): Claude through `@anthropic-ai/sdk` or OpenAI through `openai`, encrypted write-only keys (or `ANTHROPIC_API_KEY` / `OPENAI_API_KEY`), per-app access with daily request and token limits, a usage log. Page process `ai_generate` (text into an item, or structured output into several items with a schema built from the items or your own) and a dynamic action that runs it without a page submit; `meta.ai_generate` / `ai_result` / `ai_available` from SQL ([chapter 6](guide/06-processing.md)). Prompts, item values included, go to the chosen provider |
 | Blueprints, spec-driven development (26.1) | ✅ | Create → **From a blueprint**: a JSON spec of tables (types, required, unique, allowed values, references), pages, navigation and sample data; optionally drafted by AI from a description; always reviewed (problems, SQL, pages, menu) before the application is created in one transaction; saved blueprints; (sprint 66) **a blueprint from an existing application** (its tables, pages, menu and optionally sample rows, with notes on what didn't carry over) |
 
@@ -333,7 +333,7 @@ row above where there is one.
 | WS-4 AI Agents with tools | ✅ | (sprint 111) AI Agents and AI Tools as shared components, a Navigate tool, Gemini and OpenAI-compatible services ([Workflow, automation and AI](#workflow-automation-and-ai)) |
 | WS-5 AI interactive reports: chips, computed columns | ✅ | (sprint 112) *Ask in your own words* with chips, Undo and computed columns; a phrase parser that needs no AI service; (sprint 122) phrases set faceted search and smart filter facets |
 | WS-6 Workflow 26.2: outcomes, migrating running instances, drafts, diagram export | ✅ | (sprint 114) Custom task outcomes, task events, Send E-Mail and draft steps, migrating running instances, the diagram as SVG / PNG ([Workflow, automation and AI](#workflow-automation-and-ai)) |
-| WS-7 The builder in more languages | ✅ | (sprint 121) The builder in Deutsch, English, Español, Français, Nederlands and Português, and (sprint 134, SEC-5) Italiano, 中文 (简体), 中文 (繁體), 日本語 and 한국어 with CJK font stacks: links on the sign-in page, a language menu in the status bar, the choice stored per developer (migration 127); builder texts are keyed message files with a coverage check in CI, also for the builder's own JavaScript (sprint 123). Translated (sprints 121, 123–125): the builder's frame, sign-in page, Workspace home, App Builder home, an application's home and tabs, the Page Designer's toolbar, menus, tree and gallery, the SQL Workshop's home and tabs, the SQL Worksheet, Object Browser and Table Properties, Shared Components, an application's settings, Users, identity providers, Developers and Workspaces ([chapter 3](guide/03-builder.md#choosing-the-builder-language)). Still English: the rest of Administration (mail queue, network access, database users, dashboard, utilities, LDAP, instance settings), the other SQL Workshop tools and the region and report settings, until they move over; by design the property editor's and component forms' field names and help |
+| WS-7 The builder in more languages | ✅ | (sprint 121) The builder in Deutsch, English, Español, Français, Nederlands and Português, and (sprint 134, SEC-5) Italiano, 中文 (简体), 中文 (繁體), 日本語 and 한국어 with CJK font stacks: links on the sign-in page, a language menu in the status bar, the choice stored per developer (migration 127); builder texts are keyed message files with a coverage check in CI, also for the builder's own JavaScript (sprint 123). Translated (sprints 121, 123–125): the builder's frame, sign-in page, Workspace home, App Builder home, an application's home and tabs, the Page Designer's toolbar, menus, tree and gallery, the SQL Workshop's home and tabs, the SQL Worksheet, Object Browser and Table Properties, Shared Components, an application's settings, Users, identity providers, Developers and Workspaces ([chapter 3](guide/03-builder.md#choosing-the-builder-language)). (sprint 152) Workspace utilities, the dashboard, Mail queue, Network access, Instance settings and LDAP directories; (sprint 153) Database users. Still English: the other SQL Workshop tools and the region and report settings, until they move over; by design the property editor's and component forms' field names and help |
 | WS-8 App Gallery: more sample apps, Utility Apps | ✅ | (sprint 120) Four tabs with counts and a search that also works without JavaScript ([chapter 3](guide/03-builder.md#app-gallery)). *Sample Apps*: HR Demo, Tasks, ten single-topic apps (Sample Charts, Sample Cards, Sample Calendar, Sample Interactive Grids, Sample Dynamic Actions, Sample Reporting; sprint 122: Sample Maps, Sample Approvals, Sample Data Loading, Sample Files) and the **UX Pattern Catalog**, each with its own schema, data, demo account and explanatory texts, installed by administrators from one SQL file in one transaction; *Utility Apps*: Lookup Lists, Release Notes and Announcements as blueprints any developer installs into the workspace. APEX's 27 sample apps include topics pgkiln shows in HR Demo instead (REST, trees, collections); no remote catalogue |
 | WS-9 Mail queue reporting, workspace SMTP, workspace network ACLs | ✅ | (sprint 118) Administration → Mail queue (per hour and per workspace / application, the slowest provider calls, failures with the provider's answer, Retry and Purge), a workspace's own mail service, and a workspace's network access list that narrows the installation's allow-list for every outgoing call ([Administration](#administration)) |
 | WS-10 Universal Theme 26.2: Pillar appearances, navigation polish | ✅ | (sprint 117) Theme Roller → Navigation appearance Pillar Light / Pillar Dark per application or style, with a header strip colour for light and dark mode; the current page filled, its parents bold with an accent guide line; `u-color-*-subtle` utilities; a lighter processing indicator; RTL mirrored |
@@ -462,7 +462,7 @@ Sources: [APEX 26.2 new features](https://docs.oracle.com/en/database/oracle/ape
 | Progressive Web App | Settings → Progressive Web App |
 | Static Application Files, Static Workspace Files | Static Application Files; Static workspace files in Workspace utilities (sprint 141) |
 | Report Layouts, Report Queries | The same names (Files and Reports, sprint 82): a report query is one query printed as PDF with a report layout, Excel, CSV, JSON, XML or HTML (`?doc=NAME`, document buttons); APEX's several queries for one layout: a document template's JSON columns |
-| REST Data Sources, Web Credentials, REST Enabled SQL, Data Load Definitions, JSON Sources | The same names (Data Sources; JSON Sources since sprint 142); web credentials of the workspace and Remote Servers in Workspace utilities (sprint 141); REST Enabled SQL ➖ not planned (one database) |
+| REST Data Sources, Web Credentials, REST Enabled SQL, Data Load Definitions, JSON Sources | The same names (Data Sources; JSON Sources since sprint 142); web credentials of the workspace and Remote Servers in Workspace utilities (sprint 141); REST Enabled SQL: Remote databases (`postgres_fdw`, sprint 150) |
 | Workflows, Task Definitions, Automations | The same names |
 | Text Messages, Translate, Dynamic Translations, Globalization Attributes | Translations and Text Messages, Dynamic Translations, Settings → Globalization |
 | Map Backgrounds | ➖ Not planned per application: the installation's map tile server (`MAP_TILE_URL`) is every map's background |

package/docs/guide/03-builder.md

@@ -385,6 +385,38 @@ another workspace's file is never served to an application, its servers and cred
   one). Secrets are encrypted with `PGKILN_SECRET_KEY`, write-only, never exported and never readable by the runtime
   role; `pgkiln admin rotate-key` and the lockout checks include them.
 
+### Remote databases
+
+(sprint 150; APEX: *REST Enabled SQL*, regions on another database) Workspace utilities → **Remote databases**
+(`/builder/remote-databases`, administrators): another PostgreSQL database whose tables the applications query as if
+they were their own. pgkiln uses PostgreSQL's [`postgres_fdw`](15-extensions.md): a superuser runs `create extension
+postgres_fdw` once (the page offers it when pgkiln's owner connection is a superuser) and, when the owner role is not
+one, `grant usage on foreign data wrapper postgres_fdw to` it.
+
+A remote database has a **name** (a static id, `CRM`), the **host**, **port** and **database** as the *database
+server* reaches them (it makes the connection, not pgkiln), the remote **user** and **password**, the **remote schema**
+(`public`), a new **local schema** (`crm`), the **tables** to import (comma separated; empty: every table and view of
+the remote schema) and the **application database roles** to grant them to, read only or also INSERT, UPDATE and
+DELETE. *Add and import* makes, in one transaction:
+
+- a foreign server `pgkiln_rdb_crm` with the host, port and database, and a user mapping with the user and password.
+  The password is kept by PostgreSQL alone (`pg_user_mapping`, which only superusers and the server's owner can read):
+  pgkiln never stores it, never shows it, and needs it again only to rename the remote database or move it to
+  another local schema;
+- the local schema (marked as this remote database's by its comment: an existing schema of anything else is refused),
+  with the remote tables as foreign tables (`import foreign schema … limit to (…)`);
+- the grants: USAGE on the schema and SELECT (and INSERT, UPDATE, DELETE) on its tables to the chosen roles, and to
+  nobody else.
+
+Regions, reports, forms, grids, lists of values and processes then use `crm.customers` like any table, as the
+application's role in its transaction; what the remote user may read or change on the other side is what they may.
+**Test the connection** does the same in a transaction that is rolled back (a wrong password or host says so, and
+nothing stays). **Import again** drops the foreign tables and imports them again (new tables or columns on the remote
+side; a view of yours on one of them stops it and says which). **Delete** drops the local schema with its foreign
+tables and the server. Remote databases are installation data: they are not exported with an application (the
+foreign tables are database objects, like the application's own tables). For other databases, a foreign data wrapper
+of their own (`oracle_fdw`, `mysql_fdw`, `tds_fdw`) works the same way, set up by hand.
+
 ### Isolated workspaces
 
 On a workspace's page an administrator chooses **Isolate this workspace** (Workspace utilities → Workspaces → the
@@ -489,7 +521,9 @@ home page and tabs, (sprint 123) the **SQL Worksheet** (with its messages in the
 and **Table Properties**, and (sprint 124) **Shared Components** (the overview, every component type's list and
 editor frame, access control, breadcrumbs, component settings) and an application's **Settings**, and (sprint 125)
 the administration screens: **Users** (accounts and identity providers), **Developers** and **Workspaces** (with
-utilization). Other builder pages are still in English (they move over screen by screen); so are the
+utilization), and (sprint 152) **Workspace utilities**, the workspace **Dashboard**, **Mail queue**, **Network
+access**, **Instance settings** (its frame: each setting's own label and help, and the lockout checks' details, stay
+English) and **LDAP directories**, and (sprint 153) **Database users**. Other builder pages are still in English (they move over screen by screen); so are the
 Page Designer's property names and their help (and, the same way, the field names and help of a shared component's
 form), the links to this guide, and any SQL the builder generates.
 
@@ -1940,14 +1974,22 @@ agents use one. Providers are part of the application: Shared Components → Gen
     `mxbai-embed-large` (1024) … The key, base URL and daily limits are the service's: **the key stays with the
     AI service** (encrypted, write-only, never exported); the export carries only the service's name. Texts per
     request and requests per minute limit the background embedding of queued rows;
+  - *Model in the database* (sprint 151; APEX: an ONNX model loaded in the database): the model runs inside
+    PostgreSQL through an extension, with no AI service and nothing leaving the database. The **engine** is
+    `pgml` (PostgresML: `pgml.embed(model, text)`, which loads Hugging Face models, ONNX among them, on its first
+    call) and the **model** its name: `intfloat/e5-small-v2` (384 dimensions), `Alibaba-NLP/gte-base-en-v1.5`
+    (768), `mixedbread-ai/mxbai-embed-large-v1` (1024) … The form says when PostgresML is not installed. Like a
+    function, it runs as the role of the query: grant usage on schema `pgml` to the application's role. Vector
+    columns of such a provider are kept **at once** by their trigger, and searches embed the search text in the
+    query;
   - *SQL or PL/pgSQL function*: `schema.name` of a function `(text)` returning `vector`, `real[]` or
-    `float8[]`, e.g. a model inside the database (`pgml.embed`, `ai.openai_embed` of pgai) or your own;
+    `float8[]`, e.g. `ai.openai_embed` of pgai, an ONNX runtime in PL/Python, or your own;
 - the **dimensions**: every embedding is checked against them, and a vector column is `vector(n)` with this *n*
   (an HNSW index takes up to 2,000).
 
 **Test** embeds a sample text and shows how many dimensions came back. A provider's page lists the search
 configurations and vector columns that use it. In SQL, `meta.embed(text, 'DOC_EMBEDDINGS')` returns a function
-provider's embedding as `real[]` (cast it: `meta.embed(…)::vector`), running the function **as the role of the
+or database model provider's embedding as `real[]` (cast it: `meta.embed(…)::vector`), running the function **as the role of the
 query** (its grants apply: grant execute on it to the application's role). An AI service is called by the pgkiln
 server, never from SQL: `meta.embed` says so for such a provider; use it through a search configuration, a
 Retrieve tool or a vector column's queue.

package/docs/guide/04-pages-and-regions.md

@@ -1424,8 +1424,14 @@ decides who may use the region; tools may also be PL/pgSQL functions, JavaScript
 pages), or the developer gives the region a system prompt and, optionally,
 **context queries** and **tools**; the model then answers questions about the application's data,
 calling the tools when it needs to, like an agent. It works without JavaScript (the message is
-posted and the page comes back with the answer); with JavaScript the Send button shows that the
-assistant is thinking and Ctrl+Enter sends.
+posted and the page comes back with the answer); with JavaScript the answer **streams** (sprint 148): the
+message appears in the conversation, the answer is written into it as the model produces it (as plain text), the
+tool being used is named under it, and when the answer is complete the page loads with it formatted, with its links
+and the agent's browser actions. Ctrl+Enter sends. Streaming uses server-sent events (`Accept: text/event-stream` on
+the same Send URL: `text` pieces as JSON strings, `tool` names, then `done` with the page to load); a proxy in front of
+pgkiln must not buffer the response (pgkiln sends `X-Accel-Buffering: no` for nginx). OpenAI, Gemini and
+OpenAI-compatible services are asked to stream with their usage; an endpoint that refuses streaming (HTTP 400) gets
+the ordinary request once.
 
 - **Conversations** are kept per session and region (`meta.ai_conversation`): a follow-up question
   sends the earlier messages along. *New conversation* starts over; signing out (or the session's

package/docs/guide/06-processing.md

@@ -1212,10 +1212,21 @@ they wait for and their wait, logged in each instance's history (*migrated*, `ve
 - a step without a mapping, or mapped to a step the version doesn't have (or a draft);
 - an instance waiting for a task must go to a task step that creates a task of the same definition;
   one at a `wait` step to a `wait` step (its wait goes on), one at a join to a join;
-- an instance inside parallel branches, or calling a web service at that moment: try again later.
+- an instance calling a web service at that moment: try again later.
+
+**Inside parallel branches** (sprint 149, migration 144) an instance is at several steps at once: its main path
+waits at the join, and each open branch (active, waiting or faulted) is at a step of its own. The page lists those
+steps with the instance (*branches at A, B*) and asks a mapping for each; the preview has a row per path (*main*,
+*branch A*), and the instance moves only as a whole. Each branch follows the rules above, and the join it ends at
+must map to a join step of the new version (a branch can't be mapped onto its own join). The branches' rows then name
+the new join and the parallel step that splits there (the mapped one, else the one parallel step of the new version
+that joins at that join), so the join counts them as before, done branches included; each moved branch has its own
+*migrated* event (`version 1 → 2: branch A: A → A2 (by admin)`). A branch the new version adds to a parallel step does
+not start for an instance already past its split.
 
 The database function is `meta.migrate_workflows(definition_id, version, ids, mapping, apply, by)` (the owner's,
-for the builder and scripts; not for applications).
+for the builder and scripts; not for applications): one row per path, with the column `branch` (null for the main
+path).
 
 <a id="diagram-export"></a>**The diagram as a file.** Under the diagram, **Download SVG** downloads the whole model
 of the version shown (`/builder/apps/<app>/shared/workflow_definition/<id>/diagram.svg?v=<version>`), a standalone

package/docs/guide/15-extensions.md

@@ -22,7 +22,7 @@ setup`) and on practically every managed service. Install with `create extension
 | **pg_stat_statements** | Which SQL is slow or called most, per role, so per app (`db_role`) | Monitor Activity → Top SQL; SQL Workshop → SQL Monitor (Top SQL, a statement's totals) |
 | **tablefunc** | `crosstab()` for pivot tables | Interactive report *Pivot* |
 | **ltree** | Hierarchies (org charts, categories, menus) with fast subtree queries | Tree region, `CONNECT BY` |
-| **postgres_fdw**, **file_fdw** | Query another PostgreSQL database, or a CSV file, as if it were a table | Remote servers / database links |
+| **postgres_fdw**, **file_fdw** | Query another PostgreSQL database, or a CSV file, as if it were a table; Workspace utilities → [Remote databases](03-builder.md#remote-databases) sets postgres_fdw up (sprint 150) | REST Enabled SQL / database links |
 | **dblink** | Run a statement on a separate connection, the usual stand-in for Oracle's **autonomous transactions** (e.g. error logging that survives a rollback) | `PRAGMA AUTONOMOUS_TRANSACTION` |
 | **amcheck**, **pg_buffercache** | Integrity checks and cache insight for DBAs | |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pgkiln",
-  "version": "0.79.0",
+  "version": "0.81.0",
   "description": "Open source low-code, SQL-driven application builder for PostgreSQL, inspired by Oracle APEX",
   "keywords": [
     "postgresql",

package/public/app.css

@@ -1877,6 +1877,8 @@ td.to-col-center, th.to-col-center { text-align: center; }
 .assistant-text p, .assistant-text ul, .assistant-text ol { margin: 0 0 0.4rem; }
 .assistant-text > :last-child { margin-bottom: 0; }
 .assistant-text ul, .assistant-text ol { padding-left: 1.25rem; }
+/* (sprint 148) an answer while it streams: plain text, its line breaks kept, until the page shows it formatted */
+.assistant-text .assistant-streaming { white-space: pre-wrap; overflow-wrap: anywhere; }
 .assistant-tools { display: block; margin-top: 0.25rem; }
 .assistant-input textarea { width: 100%; box-sizing: border-box; }
 .assistant-actions { display: flex; flex-wrap: wrap; gap: 0.5rem; margin: 0.4rem 0; }