@ai-matrx/records 0.17.0 → 0.20.0

package/dist/index.d.ts

@@ -6,7 +6,7 @@ declare const RETIRED_ACTOR_WORDS: {
     readonly human: "user";
 };
 declare const ABSENCE_REASONS: readonly ["never asked", "none", "refused", "conflicting"];
-declare const VALUE_ENVELOPE_KEYS: readonly ["ver", "src", "actor", "on_behalf_of", "at", "absent", "alternates", "dated"];
+declare const VALUE_ENVELOPE_KEYS: readonly ["ver", "src", "actor", "on_behalf_of", "at", "absent", "alternates", "dated", "pinned"];
 declare const VALUE_ALTERNATE_KEYS: readonly ["value", "src", "rank"];
 declare const STORAGE_MODES: readonly ["light", "heavy"];
 declare const RULE_USES: readonly ["validate", "compute", "membership", "applicability"];
@@ -369,6 +369,11 @@ declare const STORE_DOORS: readonly [{
     readonly args: "";
     readonly returns: "name";
     readonly security: "invoker";
+}, {
+    readonly name: "carry_unchanged_value_stamps";
+    readonly args: "p_old jsonb, p_new jsonb";
+    readonly returns: "jsonb";
+    readonly security: "invoker";
 }, {
     readonly name: "carrying_edges_in";
     readonly args: "p_organization_id uuid";
@@ -379,6 +384,56 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_item_type text, p_item_id uuid";
     readonly returns: "TABLE(container_type text, container_id uuid, conveys_max permission_level)";
     readonly security: "definer";
+}, {
+    readonly name: "checklist_declare";
+    readonly args: "p_organization_id uuid, p_spec jsonb, p_template_id uuid DEFAULT NULL::uuid";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "checklist_refusal";
+    readonly args: "p_spec jsonb";
+    readonly returns: "text";
+    readonly security: "invoker";
+}, {
+    readonly name: "checklist_run";
+    readonly args: "p_organization_id uuid, p_run_id uuid";
+    readonly returns: "TABLE(step_id uuid, step_order integer, ref text, title text, role text, assignee_name text, assignee_user_id uuid, due_on timestamp with time zone, due_state text, status text, finished boolean, requires text, requires_key text, requires_label text, requires_id uuid, evidence jsonb, blocked_by text[], may_complete boolean, refusal text)";
+    readonly security: "definer";
+}, {
+    readonly name: "checklist_runs";
+    readonly args: "p_organization_id uuid, p_about_table_id uuid DEFAULT NULL::uuid, p_about_record_id uuid DEFAULT NULL::uuid, p_include_closed boolean DEFAULT true, p_limit integer DEFAULT 100";
+    readonly returns: "TABLE(run_id uuid, name text, template_id uuid, template text, about_record_id uuid, about text, about_table_id uuid, started_at timestamp with time zone, started_by uuid, origin text, step_count integer, done integer, overdue integer, next_step text, next_due timestamp with time zone, closed_at timestamp with time zone)";
+    readonly security: "definer";
+}, {
+    readonly name: "checklist_start";
+    readonly args: "p_organization_id uuid, p_template_id uuid, p_about_record_id uuid DEFAULT NULL::uuid, p_roles jsonb DEFAULT '{}'::jsonb, p_starting_at timestamp with time zone DEFAULT NULL::timestamp with time zone";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "checklist_step_complete";
+    readonly args: "p_organization_id uuid, p_step_id uuid, p_evidence jsonb DEFAULT '{}'::jsonb";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "checklist_step_refusal";
+    readonly args: "p_organization_id uuid, p_step_id uuid";
+    readonly returns: "text";
+    readonly security: "definer";
+}, {
+    readonly name: "checklist_steps_table";
+    readonly args: "p_organization_id uuid";
+    readonly returns: "uuid";
+    readonly security: "definer";
+}, {
+    readonly name: "checklist_template_shape";
+    readonly args: "p_organization_id uuid, p_template_id uuid";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "checklist_templates";
+    readonly args: "p_organization_id uuid, p_about_table_id uuid DEFAULT NULL::uuid, p_limit integer DEFAULT 100";
+    readonly returns: "TABLE(template_id uuid, name text, about_table_id uuid, about_table text, steps integer, roles integer, trigger_kind text, trigger_status text, open_runs integer, total_runs integer, updated_at timestamp with time zone)";
+    readonly security: "definer";
 }, {
     readonly name: "choice_census";
     readonly args: "p_organization_id uuid, p_table_id uuid DEFAULT NULL::uuid";
@@ -494,6 +549,31 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_data jsonb";
     readonly returns: "uuid";
     readonly security: "invoker";
+}, {
+    readonly name: "context_resolve";
+    readonly args: "p_organization_id uuid, p_bindings jsonb, p_scope_slug text DEFAULT 'scopes'::text";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "conversation_scope";
+    readonly args: "p_organization_id uuid, p_conversation_id uuid";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "conversation_scope_bind";
+    readonly args: "p_organization_id uuid, p_conversation_id uuid, p_record_id uuid";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "conversation_scope_context";
+    readonly args: "p_organization_id uuid, p_conversation_id uuid, p_relations integer DEFAULT 12, p_history integer DEFAULT 15, p_siblings integer DEFAULT 8";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "conversation_scope_unbind";
+    readonly args: "p_organization_id uuid, p_conversation_id uuid";
+    readonly returns: "jsonb";
+    readonly security: "definer";
 }, {
     readonly name: "cross_organization_links_open";
     readonly args: "p_source_organization_id uuid, p_target_organization_id uuid";
@@ -609,6 +689,21 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_field_data jsonb, p_value jsonb";
     readonly returns: "text";
     readonly security: "invoker";
+}, {
+    readonly name: "doc_letterhead";
+    readonly args: "p_organization_id uuid";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "doc_name_token_pattern";
+    readonly args: "";
+    readonly returns: "text";
+    readonly security: "invoker";
+}, {
+    readonly name: "doc_name_tokens";
+    readonly args: "p_body text";
+    readonly returns: "TABLE(ordinal integer, raw text)";
+    readonly security: "invoker";
 }, {
     readonly name: "doc_render_body";
     readonly args: "p_organization_id uuid, p_template_id uuid, p_record_id uuid";
@@ -709,6 +804,11 @@ declare const STORE_DOORS: readonly [{
     readonly args: "";
     readonly returns: "TABLE(function_name text, identity_args text, why text)";
     readonly security: "invoker";
+}, {
+    readonly name: "doors_not_masking_fields";
+    readonly args: "";
+    readonly returns: "TABLE(function_name text, identity_args text, why text)";
+    readonly security: "invoker";
 }, {
     readonly name: "doors_not_on_one_ladder";
     readonly args: "";
@@ -719,6 +819,61 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_user_id uuid, p_organization_id uuid, p_id uuid, p_type text DEFAULT 'record'::text";
     readonly returns: "permission_level";
     readonly security: "definer";
+}, {
+    readonly name: "enrich_cells";
+    readonly args: "p_organization_id uuid, p_table_id uuid, p_field_keys text[] DEFAULT NULL::text[], p_record_ids uuid[] DEFAULT NULL::uuid[]";
+    readonly returns: "TABLE(record_id uuid, field_key text, agent_owned boolean, value jsonb, value_version integer, actor text, on_behalf_of text, written_at timestamp with time zone, source jsonb, absent_reason text, alternates jsonb, pinned boolean, stale boolean, due_at timestamp with time zone)";
+    readonly security: "definer";
+}, {
+    readonly name: "enrich_declare";
+    readonly args: "p_organization_id uuid, p_field_id uuid, p_spec jsonb";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "enrich_due";
+    readonly args: "p_organization_id uuid, p_field_id uuid, p_limit integer DEFAULT 50, p_include_fresh boolean DEFAULT false";
+    readonly returns: "TABLE(record_id uuid, title text, inputs jsonb, current_value jsonb, written_at timestamp with time zone, reason text, trimmed_to integer)";
+    readonly security: "definer";
+}, {
+    readonly name: "enrich_land";
+    readonly args: "p_organization_id uuid, p_field_id uuid, p_results jsonb, p_run jsonb DEFAULT '{}'::jsonb";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "enrich_normalize";
+    readonly args: "p_organization_id uuid, p_table_id uuid, p_field_key text, p_spec jsonb";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "enrich_pin";
+    readonly args: "p_organization_id uuid, p_record_id uuid, p_field_key text, p_pinned boolean DEFAULT true";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "enrich_run_class";
+    readonly args: "";
+    readonly returns: "text";
+    readonly security: "invoker";
+}, {
+    readonly name: "enrich_runs";
+    readonly args: "p_organization_id uuid, p_field_id uuid DEFAULT NULL::uuid, p_limit integer DEFAULT 50";
+    readonly returns: "TABLE(run_id uuid, field_id uuid, field_key text, model text, trigger_word text, rows_seen integer, rows_written integer, rows_absent integer, rows_below_floor integer, rows_pinned integer, rows_refused integer, cost_cents numeric, cost_per_row_cents numeric, ran_at timestamp with time zone)";
+    readonly security: "definer";
+}, {
+    readonly name: "enrich_sensitivity_rank";
+    readonly args: "p_word text";
+    readonly returns: "integer";
+    readonly security: "invoker";
+}, {
+    readonly name: "enrich_triggers";
+    readonly args: "";
+    readonly returns: "text[]";
+    readonly security: "invoker";
+}, {
+    readonly name: "enrichments";
+    readonly args: "p_organization_id uuid, p_table_id uuid DEFAULT NULL::uuid";
+    readonly returns: "TABLE(field_id uuid, table_id uuid, field_key text, label text, enrichment jsonb, enabled boolean, review_interval_days integer, rows_total integer, rows_filled integer, rows_stale integer, rows_pinned integer, rows_absent integer, runs integer, cost_cents numeric, cost_per_row_cents numeric, last_run_at timestamp with time zone, last_run jsonb)";
+    readonly security: "definer";
 }, {
     readonly name: "entity_field_declare";
     readonly args: "p_organization_id uuid, p_token text, p_spec jsonb";
@@ -944,6 +1099,11 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_current jsonb, p_target jsonb, p_field_key text DEFAULT NULL::text";
     readonly returns: "jsonb";
     readonly security: "invoker";
+}, {
+    readonly name: "history_restore_body";
+    readonly args: "p_current jsonb, p_target jsonb, p_field_key text, p_author jsonb";
+    readonly returns: "jsonb";
+    readonly security: "invoker";
 }, {
     readonly name: "history_retention";
     readonly args: "p_organization_id uuid, p_table_id uuid DEFAULT NULL::uuid";
@@ -969,6 +1129,36 @@ declare const STORE_DOORS: readonly [{
     readonly args: "";
     readonly returns: "TABLE(table_id uuid, home_record_id uuid, organization_id uuid, relation_id uuid)";
     readonly security: "invoker";
+}, {
+    readonly name: "inbound_addresses";
+    readonly args: "p_organization_id uuid, p_table_id uuid DEFAULT NULL::uuid";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "inbound_declare";
+    readonly args: "p_organization_id uuid, p_table_id uuid, p_label text DEFAULT NULL::text";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "inbound_domain";
+    readonly args: "p_organization_id uuid";
+    readonly returns: "text";
+    readonly security: "invoker";
+}, {
+    readonly name: "inbound_mail_land";
+    readonly args: "p_address text, p_mail jsonb, p_secret text DEFAULT NULL::text";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "inbound_mail_map";
+    readonly args: "p_organization_id uuid, p_table_id uuid, p_mail jsonb";
+    readonly returns: "jsonb";
+    readonly security: "invoker";
+}, {
+    readonly name: "inbound_set";
+    readonly args: "p_organization_id uuid, p_inbound_id uuid, p_enabled boolean";
+    readonly returns: "jsonb";
+    readonly security: "definer";
 }, {
     readonly name: "index_payload";
     readonly args: "p_organization_id uuid, p_table_id uuid, p_limit integer DEFAULT 1000";
@@ -979,6 +1169,11 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_data jsonb";
     readonly returns: "jsonb";
     readonly security: "invoker";
+}, {
+    readonly name: "io_cell";
+    readonly args: "p_organization_id uuid, p_field jsonb, p_word text, p_date_order text DEFAULT 'mdy'::text";
+    readonly returns: "jsonb";
+    readonly security: "invoker";
 }, {
     readonly name: "io_changed_field_ids";
     readonly args: "p_organization_id uuid, p_table_id uuid, p_old jsonb, p_new jsonb";
@@ -1024,21 +1219,61 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_organization_id uuid, p_table_id uuid, p_columns text[] DEFAULT NULL::text[], p_limit integer DEFAULT 10000, p_delimiter text DEFAULT chr(44), p_required text DEFAULT 'viewer'::text";
     readonly returns: "text";
     readonly security: "definer";
+}, {
+    readonly name: "io_import_begin";
+    readonly args: "p_organization_id uuid, p_table_id uuid, p_format text DEFAULT 'csv'::text, p_source_name text DEFAULT NULL::text, p_source_columns jsonb DEFAULT '[]'::jsonb, p_file_hash text DEFAULT NULL::text, p_policy jsonb DEFAULT '{}'::jsonb, p_dedupe_key text DEFAULT NULL::text, p_file_bytes bigint DEFAULT NULL::bigint, p_force boolean DEFAULT false";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "io_import_finish";
+    readonly args: "p_organization_id uuid, p_import_id uuid, p_unmapped text DEFAULT NULL::text";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "io_import_forget";
+    readonly args: "p_organization_id uuid, p_import_id uuid";
+    readonly returns: "boolean";
+    readonly security: "definer";
 }, {
     readonly name: "io_import_open";
     readonly args: "p_organization_id uuid, p_table_id uuid, p_format text DEFAULT 'csv'::text, p_source_name text DEFAULT NULL::text, p_source_columns jsonb DEFAULT '[]'::jsonb";
     readonly returns: "uuid";
     readonly security: "definer";
+}, {
+    readonly name: "io_import_plan";
+    readonly args: "p_organization_id uuid, p_table_id uuid, p_columns jsonb DEFAULT '[]'::jsonb";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "io_import_report";
+    readonly args: "p_organization_id uuid, p_import_id uuid, p_state text DEFAULT NULL::text, p_limit integer DEFAULT 100, p_offset integer DEFAULT 0";
+    readonly returns: "jsonb";
+    readonly security: "definer";
 }, {
     readonly name: "io_import_rows";
     readonly args: "p_organization_id uuid, p_import_id uuid, p_rows jsonb, p_mapping jsonb DEFAULT '{}'::jsonb";
     readonly returns: "jsonb";
     readonly security: "definer";
+}, {
+    readonly name: "io_imports";
+    readonly args: "p_organization_id uuid, p_table_id uuid DEFAULT NULL::uuid, p_limit integer DEFAULT 25";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "io_infer_column";
+    readonly args: "p_organization_id uuid, p_table_id uuid, p_header text, p_samples jsonb DEFAULT '[]'::jsonb";
+    readonly returns: "jsonb";
+    readonly security: "definer";
 }, {
     readonly name: "io_infer_type";
     readonly args: "p_samples jsonb";
     readonly returns: "text";
     readonly security: "invoker";
+}, {
+    readonly name: "io_money_unit";
+    readonly args: "p_word text";
+    readonly returns: "text";
+    readonly security: "invoker";
 }, {
     readonly name: "io_outbox_announce";
     readonly args: "";
@@ -1064,26 +1299,56 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_organization_id uuid, p_import_id uuid, p_column text";
     readonly returns: "boolean";
     readonly security: "definer";
+}, {
+    readonly name: "io_proposal_spec";
+    readonly args: "p_proposal jsonb";
+    readonly returns: "jsonb";
+    readonly security: "invoker";
 }, {
     readonly name: "io_record_changed";
     readonly args: "";
     readonly returns: "trigger";
     readonly security: "definer";
+}, {
+    readonly name: "io_relation_candidate";
+    readonly args: "p_organization_id uuid, p_table_id uuid, p_words text[]";
+    readonly returns: "uuid";
+    readonly security: "invoker";
 }, {
     readonly name: "io_restore";
     readonly args: "p_organization_id uuid, p_record_id uuid, p_version integer";
     readonly returns: "integer";
     readonly security: "definer";
+}, {
+    readonly name: "io_restore";
+    readonly args: "p_organization_id uuid, p_record_id uuid, p_version integer, p_author jsonb";
+    readonly returns: "integer";
+    readonly security: "definer";
 }, {
     readonly name: "io_revisions";
     readonly args: "p_organization_id uuid, p_record_id uuid";
     readonly returns: "TABLE(version integer, changed_at timestamp with time zone, changed_by uuid, summary text, operation text, changed_fields jsonb)";
     readonly security: "definer";
+}, {
+    readonly name: "io_sample_words";
+    readonly args: "p_samples jsonb";
+    readonly returns: "TABLE(word text)";
+    readonly security: "invoker";
+}, {
+    readonly name: "io_value_shape";
+    readonly args: "p_envelope jsonb";
+    readonly returns: "jsonb";
+    readonly security: "invoker";
 }, {
     readonly name: "is_a_retirement";
     readonly args: "p_old_deleted timestamp with time zone, p_new_deleted timestamp with time zone, p_old_data jsonb, p_new_data jsonb, p_old_table uuid, p_new_table uuid, p_old_org uuid, p_new_org uuid, p_old_class text, p_new_class text";
     readonly returns: "boolean";
     readonly security: "invoker";
+}, {
+    readonly name: "ladder_replanners";
+    readonly args: "p_roots text[] DEFAULT ARRAY['custom.has_visibility'::text, 'custom.effective_level'::text, 'custom.reaches_directly'::text, 'custom.visible_set'::text]";
+    readonly returns: "TABLE(fn text, lang text, why text, remedy text)";
+    readonly security: "definer";
 }, {
     readonly name: "list_door_disagreements";
     readonly args: "p_pretend text DEFAULT NULL::text, p_only_organization uuid DEFAULT NULL::uuid, p_sample integer DEFAULT 200";
@@ -1109,6 +1374,11 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_document jsonb, p_visible_keys text[], p_notices jsonb, p_by_id boolean DEFAULT false, p_key_ids jsonb DEFAULT '{}'::jsonb, p_declared_keys text[] DEFAULT NULL::text[]";
     readonly returns: "jsonb";
     readonly security: "invoker";
+}, {
+    readonly name: "mask_says_withheld";
+    readonly args: "p_mask jsonb, p_key text";
+    readonly returns: "boolean";
+    readonly security: "invoker";
 }, {
     readonly name: "merge_field_kernel_id";
     readonly args: "";
@@ -1184,6 +1454,11 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_organization_id uuid, p_target_id uuid DEFAULT NULL::uuid, p_limit integer DEFAULT 100";
     readonly returns: "TABLE(id uuid, verb text, target_kind text, target_id uuid, note text, applied_at timestamp with time zone, applied_by uuid, undone_at timestamp with time zone)";
     readonly security: "definer";
+}, {
+    readonly name: "mirror_asks_the_whole_database";
+    readonly args: "";
+    readonly returns: "TABLE(schema_name text, table_name text, policy_name text, why text)";
+    readonly security: "invoker";
 }, {
     readonly name: "my_level";
     readonly args: "p_organization_id uuid, p_id uuid, p_type text DEFAULT 'record'::text";
@@ -1249,6 +1524,11 @@ declare const STORE_DOORS: readonly [{
     readonly args: "";
     readonly returns: "uuid";
     readonly security: "invoker";
+}, {
+    readonly name: "pin_agent_cells";
+    readonly args: "p_new jsonb, p_old jsonb, p_agent_keys text[]";
+    readonly returns: "jsonb";
+    readonly security: "invoker";
 }, {
     readonly name: "portal_admits";
     readonly args: "p_organization_id uuid, p_user_id uuid DEFAULT NULL::uuid";
@@ -1499,6 +1779,11 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_organization_id uuid, p_table_id uuid, p_user uuid, p_required permission_level, p_sample integer";
     readonly returns: "TABLE(record_id uuid, set_based boolean, per_row boolean, verdict text)";
     readonly security: "definer";
+}, {
+    readonly name: "read_mask";
+    readonly args: "p_organization_id uuid, p_record_id uuid, p_action text DEFAULT 'read'::text";
+    readonly returns: "jsonb";
+    readonly security: "definer";
 }, {
     readonly name: "read_paths_outside_the_door";
     readonly args: "";
@@ -1579,6 +1864,16 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_organization_id uuid, p_record_id uuid, p_version integer";
     readonly returns: "jsonb";
     readonly security: "definer";
+}, {
+    readonly name: "record_restore_version";
+    readonly args: "p_organization_id uuid, p_record_id uuid, p_version integer, p_author jsonb";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "record_scope_context";
+    readonly args: "p_organization_id uuid, p_record_id uuid, p_relations integer DEFAULT 12, p_history integer DEFAULT 15, p_siblings integer DEFAULT 8";
+    readonly returns: "jsonb";
+    readonly security: "definer";
 }, {
     readonly name: "record_state_as_of";
     readonly args: "p_record_id uuid, p_at timestamp with time zone";
@@ -1809,6 +2104,66 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_pretend text DEFAULT NULL::text";
     readonly returns: "TABLE(organization_id uuid, organization_name text, member_id uuid, record_id uuid, table_id uuid, ladder boolean, read_door boolean, rls_mirror boolean, why text)";
     readonly security: "invoker";
+}, {
+    readonly name: "sign_request_cancel";
+    readonly args: "p_organization_id uuid, p_request_id uuid, p_reason text DEFAULT NULL::text";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "sign_request_create";
+    readonly args: "p_organization_id uuid, p_render_id uuid, p_field_key text, p_signer_email text, p_signer_name text, p_expires_in interval DEFAULT '14 days'::interval";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "sign_request_decline";
+    readonly args: "p_token text, p_reason text DEFAULT NULL::text, p_ip text DEFAULT NULL::text, p_user_agent text DEFAULT NULL::text";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "sign_request_public";
+    readonly args: "p_token text, p_origin text DEFAULT NULL::text";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "sign_request_remind";
+    readonly args: "p_organization_id uuid, p_request_id uuid";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "sign_request_sentence";
+    readonly args: "p_data jsonb";
+    readonly returns: "text";
+    readonly security: "invoker";
+}, {
+    readonly name: "sign_request_sign";
+    readonly args: "p_token text, p_signed_name text, p_mark text, p_image text DEFAULT NULL::text, p_ip text DEFAULT NULL::text, p_user_agent text DEFAULT NULL::text, p_origin text DEFAULT NULL::text";
+    readonly returns: "jsonb";
+    readonly security: "definer";
+}, {
+    readonly name: "sign_request_state";
+    readonly args: "p_data jsonb";
+    readonly returns: "text";
+    readonly security: "invoker";
+}, {
+    readonly name: "sign_request_unchanged";
+    readonly args: "p_organization_id uuid, p_request_id uuid";
+    readonly returns: "boolean";
+    readonly security: "definer";
+}, {
+    readonly name: "sign_requests";
+    readonly args: "p_organization_id uuid, p_record_id uuid";
+    readonly returns: "TABLE(request_id uuid, render_id uuid, record_id uuid, field_key text, document_title text, signer_name text, signer_email text, signer_has_account boolean, state text, sentence text, document_version integer, document_hash text, sent_at timestamp with time zone, expires_at timestamp with time zone, viewed_at timestamp with time zone, signed_at timestamp with time zone, declined_at timestamp with time zone, invalidated_at timestamp with time zone, signature_id uuid, signature_mark text, reminder_count integer)";
+    readonly security: "definer";
+}, {
+    readonly name: "sign_token_decode";
+    readonly args: "p_token text";
+    readonly returns: "bytea";
+    readonly security: "invoker";
+}, {
+    readonly name: "sign_token_encode";
+    readonly args: "p_bytes bytea";
+    readonly returns: "text";
+    readonly security: "invoker";
 }, {
     readonly name: "size_refusal";
     readonly args: "p_organization_id uuid, p_data jsonb";
@@ -1974,6 +2329,11 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_organization_id uuid, p_record_id uuid, p_field_key text, p_version integer";
     readonly returns: "jsonb";
     readonly security: "definer";
+}, {
+    readonly name: "value_restore";
+    readonly args: "p_organization_id uuid, p_record_id uuid, p_field_key text, p_version integer, p_author jsonb";
+    readonly returns: "jsonb";
+    readonly security: "definer";
 }, {
     readonly name: "value_versions";
     readonly args: "p_old jsonb, p_new jsonb";
@@ -2024,6 +2384,16 @@ declare const STORE_DOORS: readonly [{
     readonly args: "";
     readonly returns: "uuid";
     readonly security: "invoker";
+}, {
+    readonly name: "withheld_marker";
+    readonly args: "p_mask jsonb, p_key text";
+    readonly returns: "jsonb";
+    readonly security: "invoker";
+}, {
+    readonly name: "withheld_sentence";
+    readonly args: "p_mask jsonb, p_key text";
+    readonly returns: "text";
+    readonly security: "invoker";
 }, {
     readonly name: "work_approval_approvers";
     readonly args: "p_organization_id uuid, p_subject_id uuid, p_approver_id uuid DEFAULT NULL::uuid";
@@ -2246,6 +2616,10 @@ declare const STORE_KNOBS: readonly [{
     readonly key: "cross_organization_links";
     readonly value: "false";
     readonly type: "boolean";
+}, {
+    readonly key: "document_letterhead";
+    readonly value: "{}";
+    readonly type: "json";
 }, {
     readonly key: "document_max_bytes";
     readonly value: "1048576";
@@ -2258,6 +2632,26 @@ declare const STORE_KNOBS: readonly [{
     readonly key: "emergency_door_sweep_enabled";
     readonly value: "false";
     readonly type: "boolean";
+}, {
+    readonly key: "enrichment_batch_ceiling";
+    readonly value: "200";
+    readonly type: "integer";
+}, {
+    readonly key: "enrichment_confidence_floor";
+    readonly value: "0.6";
+    readonly type: "number";
+}, {
+    readonly key: "enrichment_cost_cap_cents";
+    readonly value: "2000";
+    readonly type: "integer";
+}, {
+    readonly key: "enrichment_model";
+    readonly value: "\"claude-fable-5-latest\"";
+    readonly type: "string";
+}, {
+    readonly key: "enrichment_sensitivity_ceiling";
+    readonly value: "\"internal\"";
+    readonly type: "string";
 }, {
     readonly key: "entity_custom_fields_guard";
     readonly value: "false";
@@ -2278,6 +2672,10 @@ declare const STORE_KNOBS: readonly [{
     readonly key: "field_sensitivity_levels";
     readonly value: "{\"edit\": {\"public\": \"editor\", \"internal\": \"editor\", \"restricted\": \"admin\", \"confidential\": \"admin\"}, \"read\": {\"public\": \"viewer\", \"internal\": \"viewer\", \"restricted\": \"admin\", \"confidential\": \"editor\"}}";
     readonly type: "json";
+}, {
+    readonly key: "inbound_domain";
+    readonly value: "\"inbound.matrxserver.com\"";
+    readonly type: "string";
 }, {
     readonly key: "member_default_level";
     readonly value: "\"viewer\"";
@@ -2339,13 +2737,16 @@ declare const STORE_KNOBS: readonly [{
  */
 declare const STORE_REFUSAL_CODES: readonly [{
     readonly code: "02000";
-    readonly raised_by: "dashboard_delete,dashboard_run,doc_render_body,doc_render_document,doc_render_read,doc_sign,doc_signature_intact,doc_signature_read,doc_template_delete,doc_template_read,doc_template_save,entity_field_retire,entity_field_update,entity_record_read,entity_value_write,external_history_event,external_rows,external_stub_upsert,external_writes_set,io_restore,migrate_delete,migrate_extract_parent,migrate_merge,migrate_reclass,migrate_rename,migrate_reparent,migrate_retype,migrate_split,migrate_undo,organization_clear,portal_card,portal_declare,portal_invite,portal_preview,portal_principal_bind,portal_revoke,read_record,record_delete,record_restore,record_restore_preview,record_table,record_update,relation_uncarry,share_access,share_grant,share_lane_set,share_people,share_revoke,visibility_as_of,work_approval_decide,work_approval_read,work_approval_request,work_assign,work_record_states,work_set_state";
+    readonly raised_by: "_checklist_instantiate,checklist_declare,checklist_run,checklist_step_complete,checklist_step_refusal,checklist_template_shape,conversation_scope_bind,dashboard_delete,dashboard_run,doc_letterhead,doc_render_body,doc_render_document,doc_render_read,doc_sign,doc_signature_intact,doc_signature_read,doc_template_delete,doc_template_read,doc_template_save,enrich_pin,entity_field_retire,entity_field_update,entity_record_read,entity_value_write,external_history_event,external_rows,external_stub_upsert,external_writes_set,io_restore,migrate_delete,migrate_extract_parent,migrate_merge,migrate_reclass,migrate_rename,migrate_reparent,migrate_retype,migrate_split,migrate_undo,organization_clear,portal_card,portal_declare,portal_invite,portal_preview,portal_principal_bind,portal_revoke,read_record,record_delete,record_restore,record_restore_preview,record_table,record_update,relation_uncarry,share_access,share_grant,share_lane_set,share_people,share_revoke,sign_request_cancel,sign_request_create,sign_request_remind,sign_request_unchanged,visibility_as_of,work_approval_decide,work_approval_read,work_approval_request,work_assign,work_record_states,work_set_state";
 }, {
     readonly code: "0A000";
-    readonly raised_by: "external_rows,external_source_declare,external_write_through,promote_field,promoted_index_expr,promoted_query_sql,promoted_read,rule_eval,work_assign";
+    readonly raised_by: "checklist_step_complete,external_rows,external_source_declare,external_write_through,promote_field,promoted_index_expr,promoted_query_sql,promoted_read,rule_eval,work_assign";
+}, {
+    readonly code: "22003";
+    readonly raised_by: "context_resolve";
 }, {
     readonly code: "22004";
-    readonly raised_by: "_entity_custom_fields_guard,_value_envelope,actor_word,agg_assert_key,agg_sql,anon_capture,anon_token_issue,anon_write,assert_client_may_reach,dashboard_block_normalize,dashboard_declare,dashboard_window_sql,doc_render_write,doc_sign,doc_signature_write,doc_template_save,external_history_event,external_rows,external_source_declare,external_stub_upsert,external_write_through,external_writes_set,field_history,form_declare,form_submit,home_add,io_comment_write,io_import_open,io_outbox_drain,io_restore,migrate_choice_keys,migrate_purge,migrate_reclass,migrate_split,migrate_undo,organization_clear,organization_contents,portal_declare,portal_invite,portal_principal_bind,query_across_homes,query_by_coordinates,query_rollup,record_delete,record_reparent,record_resolve,record_restore,record_update,record_write,relation_carry,relation_own,rule_declare,share_grant,table_declare,value_restore,work_approval_decide,work_approval_request,work_template_declare";
+    readonly raised_by: "_entity_custom_fields_guard,_value_envelope,actor_word,agg_assert_key,agg_sql,anon_capture,anon_token_issue,anon_write,assert_client_may_reach,checklist_declare,context_resolve,dashboard_block_normalize,dashboard_declare,dashboard_window_sql,doc_render_write,doc_sign,doc_signature_write,doc_template_save,enrich_land,enrich_normalize,external_history_event,external_rows,external_source_declare,external_stub_upsert,external_write_through,external_writes_set,field_history,form_declare,form_submit,home_add,io_comment_write,io_import_begin,io_infer_column,io_outbox_drain,io_restore,migrate_choice_keys,migrate_purge,migrate_reclass,migrate_split,migrate_undo,organization_clear,organization_contents,portal_declare,portal_invite,portal_principal_bind,query_across_homes,query_by_coordinates,query_rollup,record_delete,record_reparent,record_resolve,record_restore,record_update,record_write,relation_carry,relation_own,rule_declare,share_grant,sign_request_create,sign_request_sign,table_declare,value_restore,work_approval_decide,work_approval_request,work_template_declare";
 }, {
     readonly code: "22007";
     readonly raised_by: "dashboard_window_sql";
@@ -2354,28 +2755,28 @@ declare const STORE_REFUSAL_CODES: readonly [{
     readonly raised_by: "rule_eval";
 }, {
     readonly code: "22023";
-    readonly raised_by: "_entity_custom_fields_guard,_value_envelope,_work_shape_guard,actor_word,agg_assert_key,agg_sql,anon_token_issue,containment_parent,dashboard_block_normalize,dashboard_window_sql,doc_render_body,doc_render_write,doc_signature_write,entity_value_write,external_history_event,external_source_declare,external_stub_upsert,external_write_through,field_history,io_import_open,io_proposal_accept,migrate_merge,migrate_reclass,my_levels,organization_clear,portal_declare,query_by_coordinates,query_rollup,record_update,relation_carry,rule_eval,rule_members,share_grant,share_lane_set,table_rules,visibility_as_of,work_approval_request,work_list,work_slot_hold";
+    readonly raised_by: "_entity_custom_fields_guard,_value_envelope,_work_shape_guard,actor_word,agg_assert_key,agg_sql,anon_token_issue,containment_parent,dashboard_block_normalize,dashboard_window_sql,doc_render_body,doc_render_write,doc_signature_write,enrich_declare,enrich_land,enrich_normalize,enrich_pin,entity_value_write,external_history_event,external_source_declare,external_stub_upsert,external_write_through,field_history,io_import_begin,io_import_finish,io_import_plan,io_import_report,io_proposal_accept,migrate_merge,migrate_reclass,my_levels,organization_clear,pin_agent_cells,portal_declare,query_by_coordinates,query_rollup,record_update,relation_carry,rule_eval,rule_members,share_grant,share_lane_set,sign_request_create,sign_request_sign,table_rules,visibility_as_of,work_approval_request,work_list,work_slot_hold";
 }, {
     readonly code: "23503";
-    readonly raised_by: "_containment_guard,_field_document_for,_record_rule_uses,anon_publish,anon_rate_take,anon_token_issue,anon_write,assert_organization_wall,comment_write,dashboard_declare,delete_rule,doc_sign,doc_template_save,form_declare,form_submit,home_add,io_comment_write,io_import_rows,io_proposal_accept,migrate_demote,migrate_promote,promote_field,promote_table,record_applicability,record_reparent,relation_carry,relation_own,resolve_first_match,rule_applies,rule_declare,rule_eval,rule_members,rule_run,subscription_mute,work_set_state,work_take_assignment,work_template_instantiate";
+    readonly raised_by: "_checklist_instantiate,_containment_guard,_field_document_for,_record_rule_uses,anon_publish,anon_rate_take,anon_token_issue,anon_write,assert_organization_wall,checklist_declare,checklist_steps_table,comment_write,dashboard_declare,delete_rule,doc_sign,doc_template_save,enrich_declare,enrich_due,enrich_land,form_declare,form_submit,home_add,inbound_declare,inbound_mail_land,inbound_set,io_comment_write,io_import_begin,io_import_finish,io_import_report,io_import_rows,io_proposal_accept,migrate_demote,migrate_promote,promote_field,promote_table,record_applicability,record_reparent,relation_carry,relation_own,resolve_first_match,rule_applies,rule_declare,rule_eval,rule_members,rule_run,sign_request_create,subscription_mute,work_set_state,work_take_assignment,work_template_instantiate";
 }, {
     readonly code: "23505";
-    readonly raised_by: "_unique_rule_holds,doc_sign,doc_signature_write,entity_field_declare,field_declare,home_add,io_proposal_accept,relation_carry,relation_own,share_grant,work_approval_decide,work_slot_hold";
+    readonly raised_by: "_unique_rule_holds,doc_sign,doc_signature_write,entity_field_declare,field_declare,home_add,inbound_declare,io_proposal_accept,relation_carry,relation_own,share_grant,sign_request_cancel,sign_request_create,work_approval_decide,work_slot_hold";
 }, {
     readonly code: "23514";
-    readonly raised_by: "_containment_guard,_dated_values_guard,_derived_fields,_entity_custom_fields_guard,_field_class_guard,_field_document_for,_field_shape_guard,_field_type_parity_guard,_merge_field_shape_guard,_merge_field_temporal_guard,_promoted_field_cap_guard,_record_rule_uses,_resolve_choice_words,_rule_shape_guard,_rule_topology_guard,_store_relation_edge_names_its_field,_table_shape_guard,_value_envelope,_work_shape_guard,_workdoors_approval_guard,assert_entity_is_organization_scoped,doc_sign,doc_signature_write,doc_template_save,entity_field_declare,entity_field_retire,entity_field_update,entity_records_find,entity_table,field_declare,field_retire,field_update,home_add,migrate_merge,relation_carry,relation_own,validate_value_envelope,validate_values,work_set_state,work_slots_declare,work_take_assignment,work_template_instantiate";
+    readonly raised_by: "_checklist_instantiate,_checklist_step_guard,_containment_guard,_dated_values_guard,_derived_fields,_entity_custom_fields_guard,_field_class_guard,_field_document_for,_field_shape_guard,_field_type_parity_guard,_merge_field_shape_guard,_merge_field_temporal_guard,_promoted_field_cap_guard,_record_rule_uses,_resolve_choice_words,_rule_shape_guard,_rule_topology_guard,_store_relation_edge_names_its_field,_table_shape_guard,_value_envelope,_work_shape_guard,_workdoors_approval_guard,assert_entity_is_organization_scoped,checklist_declare,checklist_step_complete,doc_sign,doc_signature_write,doc_template_save,entity_field_declare,entity_field_retire,entity_field_update,entity_records_find,entity_table,field_declare,field_retire,field_update,home_add,io_import_rows,migrate_merge,relation_carry,relation_own,sign_request_create,sign_request_sign,validate_value_envelope,validate_values,work_set_state,work_slots_declare,work_take_assignment,work_template_instantiate";
 }, {
     readonly code: "40001";
     readonly raised_by: "has_visibility_at";
 }, {
     readonly code: "42501";
-    readonly raised_by: "_doc_render_immutable,_doc_signature_immutable,_field_definition_write,_field_write_door,_rule_definition_write,_store_door,anon_capture,anon_inbound_land,anon_publish,anon_token_issue,anon_token_verify,anon_write,assert_client_may_change,assert_client_may_open,assert_client_may_reach,assert_may_know_table,assert_organization_admin,assert_store_door,comment_write,entity_field_declare,entity_field_retire,entity_field_update,entity_value_write,external_write_through,form_declare,form_submit,io_comment_resolve,io_comment_write,io_restore,migrate_purge,migrate_reclass,my_levels,organization_clear,portal_declare,portal_invitation,portal_invite,portal_principal_bind,promote_table,query_visibility_parity,read_record,read_records,record_table,share_grant,subscription_mute,visibility_as_of,work_approval_decide,work_approval_read,work_approval_request,work_person";
+    readonly raised_by: "_doc_render_immutable,_doc_signature_immutable,_field_definition_write,_field_write_door,_rule_definition_write,_store_door,anon_capture,anon_inbound_land,anon_publish,anon_token_issue,anon_token_verify,anon_write,assert_client_may_change,assert_client_may_open,assert_client_may_reach,assert_may_know_table,assert_organization_admin,assert_store_door,checklist_run,comment_write,conversation_scope_bind,conversation_scope_unbind,enrich_declare,enrich_due,enrich_land,enrich_normalize,entity_field_declare,entity_field_retire,entity_field_update,entity_value_write,external_write_through,form_declare,form_submit,inbound_mail_land,io_comment_resolve,io_comment_write,io_import_begin,io_import_finish,io_restore,migrate_purge,migrate_reclass,my_levels,organization_clear,portal_declare,portal_invitation,portal_invite,portal_principal_bind,promote_table,query_visibility_parity,read_record,read_records,record_table,share_grant,subscription_mute,visibility_as_of,work_approval_decide,work_approval_read,work_approval_request,work_person";
 }, {
     readonly code: "42703";
     readonly raised_by: "entity_table,portal_declare";
 }, {
     readonly code: "53400";
-    readonly raised_by: "anon_rate_take,delete_cascade_closure,promote_field";
+    readonly raised_by: "anon_rate_take,delete_cascade_closure,enrich_due,enrich_land,promote_field";
 }, {
     readonly code: "54001";
     readonly raised_by: "record_delete";
@@ -3260,6 +3661,189 @@ interface FormSummary {
  */
 declare function publicFormPath(formId: string): string;
 
+/** What the store thinks one column of a file is. */
+interface ImportColumnPlan {
+    /** The heading exactly as the file spells it. */
+    header: string;
+    /** Set when this table already has the column; then `type` is that Field's. */
+    field_id: Uuid | null;
+    /** The key this column would become, or the key it matched. */
+    field_key: string;
+    label: string;
+    /**
+     * A parity type, or one of the three plain words (`text`, `long_text`,
+     * `number`). It is exactly what `custom.field_declare` takes, so a plan can be
+     * handed on with nothing in between to reinterpret it.
+     */
+    type: ParityFieldType | "text" | "long_text" | "number" | "relation";
+    matched: boolean;
+    /** One sentence, in words a person reads, saying why the store said that. */
+    why: string;
+    /** Present on a money column. */
+    unit?: string;
+    /** Present when the store read the column as a dropdown: its words. */
+    options?: string[];
+    /** Present when the column points at another Table. */
+    relation_target?: Uuid;
+    /** A slashed date whose day/month order cannot be read off the file. */
+    ambiguous?: boolean;
+    /** Another column of the same file would make the same key. */
+    collides_with?: string;
+    samples?: unknown[];
+}
+interface ImportPlan {
+    table_id: Uuid;
+    columns: ImportColumnPlan[];
+    matched: number;
+    unmatched: number;
+    fields: Array<{
+        field_id: Uuid;
+        key: string;
+        label: string;
+        type: string | null;
+    }>;
+}
+/** What a run does when it meets something. Both defaults cannot lose anything. */
+interface ImportPolicy {
+    /** `skip` leaves the record that is already there; `update` brings it up to date. */
+    on_duplicate?: "skip" | "update";
+    /** `propose` sends a new column to the ONE approvals inbox. `create` is an admin's. */
+    unmapped?: "propose" | "create" | "ignore";
+    /** How a slashed date is read. Chosen once for the run, never guessed per row. */
+    date_order?: "mdy" | "dmy";
+}
+interface ImportOpened {
+    import_id: Uuid;
+    state: "open" | "written" | "finished";
+    /**
+     * TRUE means these exact bytes already landed on this Table and NOTHING was
+     * written again. The numbers are the FIRST run's.
+     */
+    already: boolean;
+    rows_seen: number;
+    rows_written: number;
+    rows_duplicate: number;
+    source_name: string | null;
+    opened_at?: Timestamp;
+    message: string;
+}
+/** One row of the file, and what became of it. */
+type ImportOutcome = {
+    row: number;
+    outcome: "landed";
+    record_id: Uuid;
+} | {
+    row: number;
+    outcome: "duplicate";
+    record_id: Uuid;
+    updated: boolean;
+    reason: string;
+} | {
+    row: number;
+    outcome: "refused";
+    reason: string;
+    source: Record<string, unknown>;
+};
+interface ImportProposal {
+    column: string;
+    field_key: string;
+    label: string;
+    type: string;
+    why: string;
+    samples: unknown[];
+    state: "proposed" | "waiting" | "accepted" | "rejected" | "ignored" | "refused";
+    /** Set once the column is waiting in the approvals inbox. */
+    approval_id?: Uuid;
+    /** Set once an admin added it outright. */
+    field_id?: Uuid;
+    reason?: string;
+    options?: string[];
+    unit?: string;
+    relation_target?: Uuid;
+}
+interface ImportBatchResult {
+    import_id: Uuid;
+    rows_seen: number;
+    rows_written: number;
+    rows_duplicate: number;
+    rows_refused: number;
+    outcomes: ImportOutcome[];
+    proposals: ImportProposal[];
+}
+interface ImportFinished {
+    import_id: Uuid;
+    state: "finished";
+    rows_seen: number;
+    rows_written: number;
+    rows_duplicate: number;
+    rows_refused: number;
+    columns_offered: number;
+    columns_added: number;
+    columns_ignored: number;
+    proposals: ImportProposal[];
+    message: string;
+}
+/**
+ * The rows a person clicks through to. `capped` and `note` are the store saying
+ * out loud which part of the total it can still show — a number with nothing
+ * behind it is the thing this shape exists to prevent.
+ */
+interface ImportReport {
+    import_id: Uuid;
+    table_id: Uuid;
+    state: "refused" | "duplicate";
+    rows: Array<Record<string, unknown>>;
+    kept: number;
+    total: number;
+    capped: boolean;
+    note: string | null;
+}
+interface ImportRun {
+    import_id: Uuid;
+    table_id: Uuid;
+    format: "csv" | "xlsx";
+    source_name: string | null;
+    file_hash: string | null;
+    dedupe_key: string | null;
+    policy: ImportPolicy;
+    state: string;
+    rows_seen: number;
+    rows_written: number;
+    rows_duplicate: number;
+    rows_refused: number;
+    columns_offered: number;
+    opened_at: Timestamp;
+    finished_at: Timestamp | null;
+    created_by: Uuid | null;
+}
+/** DOOR-19. An address a Table owns, and what has arrived at it. */
+interface InboundAddress {
+    inbound_id: Uuid;
+    table_id: Uuid | null;
+    channel: string;
+    address: string;
+    source: string | null;
+    enabled: boolean;
+    last_received_at: Timestamp | null;
+    created_at: Timestamp;
+    received: number;
+}
+interface InboundDeclared {
+    inbound_id: Uuid;
+    table_id: Uuid;
+    address: string;
+    channel: string;
+    enabled: boolean;
+    /**
+     * THE ONE THING THAT COULD FAIL SILENTLY, SAID OUT LOUD. The address is real
+     * and stored the moment this comes back; whether mail REACHES it is a fact
+     * about DNS that no door can make true. Show this sentence wherever the
+     * address is shown.
+     */
+    mail_route: string;
+    message: string;
+}
+
 /** One portal as `custom.portals` reports it to its organization. */
 interface PortalSummary {
     portal_id: Uuid;
@@ -3518,6 +4102,174 @@ interface DashboardRunResult {
     blocks: DashboardBlockResult[];
 }
 
+/** VAL-8's whole vocabulary. There is no fourth word. */
+type HistoryActorKind = "user" | "agent" | "system";
+/**
+ * WHO WROTE A VERSION.
+ *
+ * `kind` is the store's own word for the author. `name` is a person as a person
+ * reads them — never a uuid; SCR-N-5 forbids printing one at a customer.
+ * `on_behalf_of` is present only for an agent, and for an agent it is ALWAYS
+ * present: an agent carries the exact authority of the person operating it
+ * (AGT-N-4), so a screen that showed the machine without the person would be
+ * hiding who is answerable.
+ */
+interface HistoryActor {
+    kind: HistoryActorKind;
+    user_id: Uuid | null;
+    name: string | null;
+    on_behalf_of: {
+        user_id: Uuid;
+        name: string | null;
+    } | null;
+}
+/**
+ * ONE FIELD THAT MOVED, with what it said before and what it says after.
+ *
+ * `label` is the Field's own label, so a timeline reads "Price" and not
+ * `day_rate`. `rule` is FLD-9's computed provenance AT THAT VERSION — which
+ * Rule, and which VERSION of the Rule, produced a derived value. `source` is
+ * VAL-1's provenance, resolved from the pointer the document interns it under,
+ * so a screen never prints `s3` at anybody.
+ */
+interface HistoryChange {
+    key: string;
+    field_id: Uuid | null;
+    label: string;
+    before: unknown;
+    after: unknown;
+    rule: {
+        rule_id: Uuid;
+        rule_version: number;
+        computed_at: Timestamp;
+    } | null;
+    source: Record<string, unknown> | null;
+    /** VAL-2: why a value is absent — never asked, none, refused, conflicting. */
+    absent_reason: string | null;
+    /** VAL-3: the other candidates the store kept, in rank order. */
+    alternates: unknown[] | null;
+}
+/** One version of one record, as `custom.record_history` answers it, newest first. */
+interface RecordHistoryEntry {
+    version: number;
+    occurred_at: Timestamp;
+    /** The machine word: `edit`, `merge`, `undo of merge`, `insert`… */
+    operation: string;
+    /** The same thing in the word a person used: "edited", "merge", "created". */
+    operation_label: string;
+    actor: HistoryActor;
+    changes: HistoryChange[];
+    /** Set when a compound verb wrote this version (HIS-8). */
+    migration_id: Uuid | null;
+    /**
+     * HIS-8: this version was written by a compound operation whose Migration log
+     * row is still there, so the WHOLE operation can be undone through
+     * `custom.migrate_undo`. An ordinary edit is never "undoable" in that sense —
+     * it is RESTORABLE, which is a different verb and a different button.
+     */
+    undoable: boolean;
+}
+/**
+ * ONE CHANGE TO ONE COLUMN, ANYWHERE IN A TABLE — the half of the question no
+ * revision panel answers. Airtable and Notion both make you open each record
+ * and look. Only records this person may see contribute, decided as a predicate
+ * in the same statement rather than a filter afterwards.
+ */
+interface FieldHistoryEntry {
+    record_id: Uuid;
+    /** The Table's own title field, so a row names a record and not a uuid. */
+    record_title: string;
+    version: number;
+    occurred_at: Timestamp;
+    operation_label: string;
+    actor: HistoryActor;
+    before: unknown;
+    after: unknown;
+}
+/**
+ * WHAT A RESTORE WOULD DO, BEFORE IT DOES IT.
+ *
+ * `before` on each change is what the record says NOW and `after` is what it
+ * would say. A key the target version did not have comes back with `after` of
+ * `null` — the screen says "cleared", because that is what the write does to
+ * it. Computed by the same body that computes the write, so the sentence and
+ * the act cannot drift.
+ */
+interface RestorePreview {
+    record_id: Uuid;
+    from_version: number;
+    to_version: number;
+    saved_at: Timestamp;
+    /** Present when the preview is for one column rather than the whole record. */
+    field_key: string | null;
+    changes: HistoryChange[];
+    count: number;
+}
+/** What a restore actually did. A NEW version, always. */
+interface RestoreResult {
+    record_id: Uuid;
+    restored_from_version: number;
+    /** The version the restore WROTE. */
+    version: number;
+    changed: HistoryChange[];
+    count: number;
+    /** Always `false`, and said out loud because it is what people fear. */
+    history_rewritten: boolean;
+    /** Present on a single-value restore. */
+    field_key?: string;
+}
+/** One comment, with the people on it named. */
+interface RecordComment {
+    id: Uuid;
+    body: string;
+    anchor: Record<string, unknown>;
+    /**
+     * The column this comment is about, when it is about one. Notion anchors a
+     * comment to a block; here the block is a Field, so "this price looks wrong"
+     * sits on the price instead of at the bottom of the record.
+     */
+    field_key: string | null;
+    parent_comment_id: Uuid | null;
+    created_by: Uuid;
+    created_by_name: string;
+    created_at: Timestamp;
+    resolved_at: Timestamp | null;
+    resolved_by: Uuid | null;
+    resolved_by_name: string | null;
+    mentions: Array<{
+        user_id: Uuid;
+        name: string;
+    }>;
+    /** Mine, so a screen offers Resolve on my own and Reply on everybody's. */
+    mine: boolean;
+}
+/**
+ * A RECORD'S WHOLE THREAD, AND WHAT THIS PERSON MAY DO IN IT.
+ *
+ * The two booleans come from the STORE, in the same call that answers the
+ * thread, because a composer drawn for somebody the write door will refuse is
+ * the defect lane UI-HONEST spent a night removing. `commenter` is the second
+ * rung: a viewer reads the conversation and cannot join it, which is exactly
+ * what the two rungs mean.
+ */
+interface CommentThreadRead {
+    record_id: Uuid;
+    comments: RecordComment[];
+    may_comment: boolean;
+    may_resolve: boolean;
+}
+/** What `custom.comment_write` answers. */
+interface CommentWritten {
+    comment_id: Uuid;
+    mentioned: Uuid[];
+    /**
+     * How many people were actually TOLD. "I mentioned three people" and "three
+     * people were told" are different facts and a screen that conflates them is
+     * lying quietly.
+     */
+    notified: number;
+}
+
 /** One token found in a body, in the order it appears. */
 interface DocToken {
     ordinal: number;
@@ -4349,4 +5101,102 @@ interface RecordsConfig {
     schema?: string;
 }
 
-export { ABSENCE_REASONS, ACTOR_VOCABULARY, type AbsenceReason, type Actor, type AggregateBucket, type AggregateFilter, type AggregateMeasure, type AggregateOperation, type AggregateRow, type AggregateWindow, type AnonTokenBinding, COMPUTE_ON, CONTEXT_POLICIES, type ChoiceOption, type ComputeOn, type ContextPolicy, type CustomFieldTableType, DELIVERIES, type DashboardBlock, type DashboardBlockKind, type DashboardBlockResult, type DashboardRunResult, type DashboardSummary, type Delivery, type DocRenderRow, type DocSignatureCheck, type DocSignatureRow, type DocTemplateRow, type DocToken, type DocUnresolvedToken, ENTITY_TOKENS, type EntityFieldRights, type EntityFieldValue, type EntityRecordMatch, type EntityRecordRead, type EntityRecordsFound, type EntityTableFacts, type EntityToken, type ExternalPrincipalCard, FIELD_SENSITIVITIES, FIELD_SOURCES, FRESHNESS, type Field, type FieldBehavior, type FieldPatch, type FieldProposal, type FieldRule, type FieldSensitivity, type FieldSource, type FieldTypeWord, type ForbiddenEnvelopeWord, type FormSummary, type Freshness, type HiddenFieldNotice, type Home, KERNEL_TABLES, type KernelTableName, MERGE_FIELD_MODIFIERS, MERGE_FIELD_SEMANTIC_TYPES, MERGE_FIELD_SOURCES, type MergeField, type MergeFieldModifier, type MergeFieldProvenance, type MergeFieldResolution, type MergeFieldSemanticType, type MergeFieldSource, type MergeFieldTransform, type MissingBehavior, type MyLevel, type MySubscription, type NewEntityFieldDeclaration, type NewFieldDeclaration, ON_DELETE, OVERRIDE_POLICIES, type OnDelete, type OverridePolicy, PARITY_FIELD_TYPES, PERMISSION_LEVELS, PER_VALUE_ACCESS_WORDS, type ParityFieldType, type ParityFieldTypeDescriptor, type PerValueAccessWord, type PermissionLevel, type PgError, type PortalCard, type PortalInvitation, type PortalPreviewRow, type PortalPrincipal, type PortalRevocation, type PortalSummary, type PortalTableExposure, type PredictedRefusal, type ProvenancePointer, type PublishBinding, RELATION_BINDINGS, RELATION_CARDINALITIES, RELATION_FLAVORS, RETIRED_ACTOR_WORDS, RULE_NODE_KINDS, RULE_USES, type ReadRow, type ReadValue, type RecordDocument, type RecordRead, type RecordRevision, type RecordsActor, type RecordsConfig, type RecordsDataSource, type RecordsError, type RecordsErrorCode, type RecordsErrorSink, type RecordsFilter, type RecordsRealtimePort, type RecordsResolverPort, type RecordsResponse, type RecordsResult, type RecordsTableQuery, type RegisteredTable, type Relation, type RelationBinding, type RelationCardinality, type RelationCarries, type RelationCoordinate, type RelationFlavor, type RelationProperties, type RelationTarget, type ResolutionTriple, type ResolvedPublishBinding, type RetiredActorWord, type Rule, type RuleAnswer, type RuleExpression, type RuleNodeKind, type RuleUse, STORAGE_MODES, STORE_DOORS, STORE_KNOBS, STORE_REFUSAL_CODES, type StaleWriteDetail, type StorageMode, type StoreDoorName, type StoreRefusalCode, type StoredRecord, type StuckRow, type Subscription, type SubscriptionBlock, type SubscriptionCadence, TABLE_DISPLAYS, TABLE_ORIGINS, TABLE_TYPES, type Table, type TableCapacity, type TableDisplay, type TableOrigin, type TableProposal, type TableType, type Timestamp, type Uuid, VALUE_ALTERNATE_KEYS, VALUE_ENVELOPE_KEYS, type ValueAlternate, type ValueAlternateKey, type ValueEnvelope, type ValueEnvelopeKey, type ValueSource, type WorkApprovalDecision, type WorkApprovalFiled, type WorkApprover, type WorkAssignment, type WorkAssignmentField, type WorkChange, type WorkDueState, type WorkGraph, type WorkInboxItem, type WorkInboxKind, type WorkInstantiation, type WorkListFlavour, type WorkListItem, type WorkOrigin, type WorkRecordState, type WorkSlotHold, type WorkState, type WorkTemplateNode, type WorkTemplateRelation, type WorkTurn, type WriteConflict, asPermissionLevel, atLeast, choiceSlug, choiceValuesOf, choicesOf, err, highestLevel, holdsARetiredChoice, isRecordsErr, isTheChosen, looksLikeAnId, measureKey, ok, optionKey, optionLabel, portalPath, publicFormPath };
+/** One value the agent was given, with the triple that makes it citable. */
+interface RecordScopeField {
+    key: string;
+    label: string;
+    type: string;
+    value: unknown;
+    /** DYN: a merge field resolves to a TRIPLE, not a string. */
+    cite: {
+        record_id: Uuid;
+        field_id: Uuid;
+        value_version: number;
+        written_at: string | null;
+    };
+}
+/** A Field the agent was NOT given, and which of the two reasons it is. */
+interface RecordScopeWithheld {
+    key: string;
+    label: string;
+    because: "masked" | "policy";
+    reason: string;
+    needs?: string;
+    /** The whole sentence, already written — a screen prints it rather than composing one. */
+    says: string;
+}
+interface RecordScopeRelation {
+    via: string;
+    target_id: Uuid;
+    foreign: boolean;
+    masked: boolean;
+    your_level: PermissionLevel | null;
+    card: Record<string, unknown> | null;
+    why: string | null;
+}
+interface RecordScopeHistoryEntry {
+    version: number;
+    at: string;
+    what: string;
+    who: string | null;
+    changes: Array<Record<string, unknown>>;
+}
+interface RecordScopeComment {
+    id: Uuid;
+    body: string;
+    created_at: string;
+    created_by_name: string;
+    field_key: string | null;
+}
+interface RecordScopeContext {
+    record: {
+        id: Uuid;
+        title: string;
+        table_id: Uuid;
+        table_name: string | null;
+        scope_type: string;
+        plural: string;
+        version: number;
+        updated_at: string;
+        your_level: PermissionLevel;
+    };
+    fields: RecordScopeField[];
+    withheld: RecordScopeWithheld[];
+    relations: RecordScopeRelation[];
+    history: RecordScopeHistoryEntry[];
+    comments: RecordScopeComment[];
+    may_comment: boolean;
+    siblings: {
+        shown: Array<{
+            id: Uuid;
+            title: string;
+        }>;
+        more_than_shown: boolean;
+        says: string;
+    };
+    /** Questions derived from THIS record's shape — never a fixed list. */
+    suggested: string[];
+    /** One sentence naming what is not in the conversation. Printed verbatim. */
+    says: string;
+    assembled_at: string;
+}
+/** What a conversation is about. `readable` false means the person lost access to it. */
+interface ConversationScope {
+    bound: boolean;
+    readable?: boolean;
+    record_id?: Uuid;
+    table_id?: Uuid;
+    scope_type?: string;
+    title?: string;
+    bound_at?: string;
+    bound_by?: Uuid;
+    because?: string;
+}
+interface ConversationScopeContext {
+    scope: ConversationScope;
+    context: RecordScopeContext | null;
+}
+/** `About: Acme Industrial` — the chip a bound chat wears. */
+declare function scopeChip(scope: ConversationScope): string;
+
+export { ABSENCE_REASONS, ACTOR_VOCABULARY, type AbsenceReason, type Actor, type AggregateBucket, type AggregateFilter, type AggregateMeasure, type AggregateOperation, type AggregateRow, type AggregateWindow, type AnonTokenBinding, COMPUTE_ON, CONTEXT_POLICIES, type ChoiceOption, type CommentThreadRead, type CommentWritten, type ComputeOn, type ContextPolicy, type ConversationScope, type ConversationScopeContext, type CustomFieldTableType, DELIVERIES, type DashboardBlock, type DashboardBlockKind, type DashboardBlockResult, type DashboardRunResult, type DashboardSummary, type Delivery, type DocRenderRow, type DocSignatureCheck, type DocSignatureRow, type DocTemplateRow, type DocToken, type DocUnresolvedToken, ENTITY_TOKENS, type EntityFieldRights, type EntityFieldValue, type EntityRecordMatch, type EntityRecordRead, type EntityRecordsFound, type EntityTableFacts, type EntityToken, type ExternalPrincipalCard, FIELD_SENSITIVITIES, FIELD_SOURCES, FRESHNESS, type Field, type FieldBehavior, type FieldHistoryEntry, type FieldPatch, type FieldProposal, type FieldRule, type FieldSensitivity, type FieldSource, type FieldTypeWord, type ForbiddenEnvelopeWord, type FormSummary, type Freshness, type HiddenFieldNotice, type HistoryActor, type HistoryActorKind, type HistoryChange, type Home, type ImportBatchResult, type ImportColumnPlan, type ImportFinished, type ImportOpened, type ImportOutcome, type ImportPlan, type ImportPolicy, type ImportProposal, type ImportReport, type ImportRun, type InboundAddress, type InboundDeclared, KERNEL_TABLES, type KernelTableName, MERGE_FIELD_MODIFIERS, MERGE_FIELD_SEMANTIC_TYPES, MERGE_FIELD_SOURCES, type MergeField, type MergeFieldModifier, type MergeFieldProvenance, type MergeFieldResolution, type MergeFieldSemanticType, type MergeFieldSource, type MergeFieldTransform, type MissingBehavior, type MyLevel, type MySubscription, type NewEntityFieldDeclaration, type NewFieldDeclaration, ON_DELETE, OVERRIDE_POLICIES, type OnDelete, type OverridePolicy, PARITY_FIELD_TYPES, PERMISSION_LEVELS, PER_VALUE_ACCESS_WORDS, type ParityFieldType, type ParityFieldTypeDescriptor, type PerValueAccessWord, type PermissionLevel, type PgError, type PortalCard, type PortalInvitation, type PortalPreviewRow, type PortalPrincipal, type PortalRevocation, type PortalSummary, type PortalTableExposure, type PredictedRefusal, type ProvenancePointer, type PublishBinding, RELATION_BINDINGS, RELATION_CARDINALITIES, RELATION_FLAVORS, RETIRED_ACTOR_WORDS, RULE_NODE_KINDS, RULE_USES, type ReadRow, type ReadValue, type RecordComment, type RecordDocument, type RecordHistoryEntry, type RecordRead, type RecordRevision, type RecordScopeComment, type RecordScopeContext, type RecordScopeField, type RecordScopeHistoryEntry, type RecordScopeRelation, type RecordScopeWithheld, type RecordsActor, type RecordsConfig, type RecordsDataSource, type RecordsError, type RecordsErrorCode, type RecordsErrorSink, type RecordsFilter, type RecordsRealtimePort, type RecordsResolverPort, type RecordsResponse, type RecordsResult, type RecordsTableQuery, type RegisteredTable, type Relation, type RelationBinding, type RelationCardinality, type RelationCarries, type RelationCoordinate, type RelationFlavor, type RelationProperties, type RelationTarget, type ResolutionTriple, type ResolvedPublishBinding, type RestorePreview, type RestoreResult, type RetiredActorWord, type Rule, type RuleAnswer, type RuleExpression, type RuleNodeKind, type RuleUse, STORAGE_MODES, STORE_DOORS, STORE_KNOBS, STORE_REFUSAL_CODES, type StaleWriteDetail, type StorageMode, type StoreDoorName, type StoreRefusalCode, type StoredRecord, type StuckRow, type Subscription, type SubscriptionBlock, type SubscriptionCadence, TABLE_DISPLAYS, TABLE_ORIGINS, TABLE_TYPES, type Table, type TableCapacity, type TableDisplay, type TableOrigin, type TableProposal, type TableType, type Timestamp, type Uuid, VALUE_ALTERNATE_KEYS, VALUE_ENVELOPE_KEYS, type ValueAlternate, type ValueAlternateKey, type ValueEnvelope, type ValueEnvelopeKey, type ValueSource, type WorkApprovalDecision, type WorkApprovalFiled, type WorkApprover, type WorkAssignment, type WorkAssignmentField, type WorkChange, type WorkDueState, type WorkGraph, type WorkInboxItem, type WorkInboxKind, type WorkInstantiation, type WorkListFlavour, type WorkListItem, type WorkOrigin, type WorkRecordState, type WorkSlotHold, type WorkState, type WorkTemplateNode, type WorkTemplateRelation, type WorkTurn, type WriteConflict, asPermissionLevel, atLeast, choiceSlug, choiceValuesOf, choicesOf, err, highestLevel, holdsARetiredChoice, isRecordsErr, isTheChosen, looksLikeAnId, measureKey, ok, optionKey, optionLabel, portalPath, publicFormPath, scopeChip };