@genispace/geniapp 0.1.0

package/dist/ai/components/ServerDataTable.d.ts

@@ -0,0 +1,89 @@
+import { ReactNode } from 'react';
+
+export type SortDir = 'asc' | 'desc';
+/**
+ * One column of a {@link ServerDataTable}. User-facing text is passed in by the
+ * caller (i18n-agnostic). A column is sortable when `sortKey` is set; the table
+ * then emits the server sort token `${sortKey}_${dir}` (e.g. `last_purchase_desc`),
+ * which the datasource maps to a whitelisted `ORDER BY` via CASE.
+ */
+export interface ServerColumn<Row> {
+    /** Stable column id (used for React keys). */
+    key: string;
+    /** Header content (already localized by the caller). */
+    header: ReactNode;
+    /** Server sort token base; presence makes the column sortable. */
+    sortKey?: string;
+    /** Cell renderer; defaults to the row's value at `key` stringified. */
+    cell?: (row: Row) => ReactNode;
+    className?: string;
+    headClassName?: string;
+}
+export interface ServerDataTableLabels {
+    empty: string;
+    error: string;
+    retry: string;
+    previous: string;
+    next: string;
+    /** Localized "Page N" label; receives the 1-based page number. */
+    page: (page: number) => string;
+    /** Accessible label for ascending sort toggle. */
+    sortAscLabel?: string;
+    /** Accessible label for descending sort toggle. */
+    sortDescLabel?: string;
+    /** Accessible label for the header "select all on this page" checkbox. */
+    selectAllLabel?: string;
+    /** Accessible label for a per-row select checkbox. */
+    selectRowLabel?: string;
+}
+export interface ServerDataTableProps<Row> {
+    columns: ServerColumn<Row>[];
+    /**
+     * Fetch one page. Return up to `limit` rows; the table internally requests
+     * `pageSize + 1` to detect "has more" without a COUNT query.
+     */
+    fetchRows: (args: {
+        limit: number;
+        offset: number;
+        sort?: string;
+    }) => Promise<Row[]>;
+    rowKey: (row: Row) => string;
+    labels: ServerDataTableLabels;
+    pageSize?: number;
+    /**
+     * When this value changes (e.g. the caller's search/filter state), pagination
+     * resets to the first page. `fetchRows` should be memoized over the same deps.
+     */
+    resetKey?: unknown;
+    initialSort?: {
+        sortKey: string;
+        dir: SortDir;
+    };
+    onRowClick?: (row: Row) => void;
+    emptyContent?: ReactNode;
+    className?: string;
+    /**
+     * Enable a leading checkbox column for row selection. Off by default so every
+     * existing usage is unchanged. When on, `selectedIds`/`onSelectionChange` make
+     * the selection controlled by the caller (keyed by `rowKey`).
+     */
+    selectable?: boolean;
+    /** Controlled set of selected row keys (only used when `selectable`). */
+    selectedIds?: Set<string>;
+    /** Called with the next selection whenever the user toggles a checkbox. */
+    onSelectionChange?: (next: Set<string>) => void;
+    /**
+     * Mobile (H5) row renderer. When provided, the table falls back to a stacked
+     * card list below the `sm` breakpoint instead of a horizontally-scrolling
+     * `<table>` — the H5 pattern for entity lists (see 12-h5-mobile-design.md §2.3).
+     * Receives the row; return the card body (the frame, tap target, selection
+     * checkbox and pagination are supplied by the table). Desktop is unaffected.
+     */
+    mobileCard?: (row: Row) => ReactNode;
+}
+/**
+ * Server-paginated, server-sorted data table for managed datasources. Renders one
+ * bounded page at a time (default 50 rows) — no client-side load-all, no COUNT.
+ * Generic over the row shape; all labels are injected for i18n.
+ */
+export declare function ServerDataTable<Row>({ columns, fetchRows, rowKey, labels, pageSize, resetKey, initialSort, onRowClick, emptyContent, className, selectable, selectedIds, onSelectionChange, mobileCard, }: ServerDataTableProps<Row>): import("react").JSX.Element;

package/dist/ai/components/Timeline.d.ts

@@ -0,0 +1,35 @@
+import { ComponentType, ReactNode } from 'react';
+
+export interface TimelineProps {
+    children: ReactNode;
+    className?: string;
+}
+/** Vertical activity timeline rail. Wrap a list of <TimelineItem>. */
+export declare function Timeline({ children, className }: TimelineProps): import("react").JSX.Element;
+export interface TimelineItemProps {
+    /** Lucide icon for the node chip. */
+    icon?: ComponentType<{
+        className?: string;
+    }>;
+    /** Tailwind text-color class for the icon (e.g. "text-emerald-600"). */
+    dotClassName?: string;
+    /** Tailwind background tint for the node chip (e.g. "bg-emerald-500/10"). Defaults to muted. */
+    nodeClassName?: string;
+    /** Tailwind left-border accent class for the event card (e.g. "border-l-emerald-500"). */
+    accentClassName?: string;
+    title: ReactNode;
+    /** Right-aligned timestamp / relative time. */
+    time?: ReactNode;
+    /** Secondary meta line (channel, store, SA…). */
+    meta?: ReactNode;
+    /** Rich body (badges, amount, content). */
+    children?: ReactNode;
+    /** Hide the connector below the node (last item). */
+    isLast?: boolean;
+}
+/**
+ * One node on the vertical timeline: a filled, ringed icon chip on the rail (left)
+ * and a styled event card (right) with an accent edge. Newest-first ordering is
+ * the caller's job; pass node/accent classes per event type for distinct styling.
+ */
+export declare function TimelineItem({ icon: Icon, dotClassName, nodeClassName, accentClassName, title, time, meta, children, isLast, }: TimelineItemProps): import("react").JSX.Element;

package/dist/ai/components/useInfiniteRows.d.ts

@@ -0,0 +1,25 @@
+export interface UseInfiniteRowsResult<Row> {
+    rows: Row[];
+    loading: boolean;
+    hasMore: boolean;
+    error: string | null;
+    /** Manually request the next page. */
+    loadMore: () => void;
+    /** Clear + reload from offset 0. */
+    reset: () => void;
+    /** Attach to a sentinel element at the list tail; auto-loads on intersect. */
+    sentinelRef: (el: HTMLElement | null) => void;
+}
+/**
+ * Accumulating infinite-scroll over a paginated fetcher. `fetchPage` returns up
+ * to `limit` rows; when fewer than `limit` come back, there is no more data.
+ * Pass a `resetKey` that changes when the query identity changes (e.g. a new
+ * entity id or filter) to clear and reload from the top.
+ */
+export declare function useInfiniteRows<Row>(fetchPage: (args: {
+    limit: number;
+    offset: number;
+}) => Promise<Row[]>, opts?: {
+    pageSize?: number;
+    resetKey?: unknown;
+}): UseInfiniteRowsResult<Row>;

package/dist/ai/errors/userFacingError.d.ts

@@ -0,0 +1,14 @@
+export type UserFacingErrorKind = 'permission' | 'validation' | 'unavailable' | 'unknown';
+export type UserFacingErrorMessages = Record<UserFacingErrorKind, string>;
+export declare class UserFacingError extends Error {
+    readonly kind: UserFacingErrorKind;
+    constructor(kind: UserFacingErrorKind, message: string, cause?: unknown);
+}
+/** Read the original failure for branching or telemetry; never render this value. */
+export declare function diagnosticErrorText(error: unknown): string;
+export declare function classifyUserFacingError(error: unknown): UserFacingErrorKind;
+/**
+ * Converts an implementation-level failure into copy that is safe to render.
+ * The original failure is retained as `cause` and written to diagnostics only.
+ */
+export declare function toUserFacingError(error: unknown, messages: UserFacingErrorMessages, context?: string): UserFacingError;

package/dist/ai/errors/userFacingError.js

@@ -0,0 +1,48 @@
+const o = /\b(?:401|403|forbidden|unauthori[sz]ed|permission|access denied|not[_ -]?visible|missing (?:api )?auth(?:entication)?|session token)\b/i, u = /\b(?:400|409|422|validation|invalid|required|conflict|duplicate|already exists|business rule|not applicable)\b/i, c = /\b(?:408|429|5\d\d|timeout|timed out|network|failed to fetch|service unavailable|bad gateway|gateway timeout|api returned html|invalid json|unexpected token|vite_|api_base|shell_init|datasource not found|managed datasource|agent not found|collector failed)\b/i;
+class s extends Error {
+  kind;
+  constructor(n, e, i) {
+    super(e, i === void 0 ? void 0 : { cause: i }), this.name = "UserFacingError", this.kind = n;
+  }
+}
+function a(t) {
+  if (t instanceof Error) {
+    const n = t;
+    return [n.status, n.statusCode, n.code, n.message].filter(Boolean).join(" ");
+  }
+  if (t && typeof t == "object") {
+    const n = t;
+    return [n.status, n.statusCode, n.code, n.message].filter(Boolean).join(" ");
+  }
+  return String(t ?? "");
+}
+function r(t) {
+  if (!t || typeof t != "object") return null;
+  const n = t, e = n.status ?? n.statusCode, i = typeof e == "number" ? e : Number(e);
+  return Number.isInteger(i) ? i : null;
+}
+function l(t) {
+  return t instanceof s && t.cause !== void 0 ? a(t.cause) : a(t);
+}
+function d(t) {
+  if (t instanceof s) return t.kind;
+  const n = r(t);
+  if (n === 401 || n === 403) return "permission";
+  if (n === 400 || n === 404 || n === 409 || n === 422) return "validation";
+  if (n === 408 || n === 429 || n !== null && n >= 500) return "unavailable";
+  const e = a(t);
+  return o.test(e) ? "permission" : c.test(e) ? "unavailable" : u.test(e) ? "validation" : "unknown";
+}
+function f(t, n, e = "operation") {
+  if (t instanceof s) return t;
+  console.error(`[GeniApp] ${e} failed`, t);
+  const i = d(t);
+  return new s(i, n[i], t);
+}
+export {
+  s as UserFacingError,
+  d as classifyUserFacingError,
+  l as diagnosticErrorText,
+  f as toUserFacingError
+};
+//# sourceMappingURL=userFacingError.js.map

package/dist/ai/errors/userFacingError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userFacingError.js","sources":["../../../src/ai/errors/userFacingError.ts"],"sourcesContent":["export type UserFacingErrorKind = 'permission' | 'validation' | 'unavailable' | 'unknown';\n\nexport type UserFacingErrorMessages = Record<UserFacingErrorKind, string>;\n\ntype ErrorLike = {\n  message?: unknown;\n  status?: unknown;\n  statusCode?: unknown;\n  code?: unknown;\n};\n\nconst PERMISSION_PATTERN = /\\b(?:401|403|forbidden|unauthori[sz]ed|permission|access denied|not[_ -]?visible|missing (?:api )?auth(?:entication)?|session token)\\b/i;\nconst VALIDATION_PATTERN = /\\b(?:400|409|422|validation|invalid|required|conflict|duplicate|already exists|business rule|not applicable)\\b/i;\nconst UNAVAILABLE_PATTERN = /\\b(?:408|429|5\\d\\d|timeout|timed out|network|failed to fetch|service unavailable|bad gateway|gateway timeout|api returned html|invalid json|unexpected token|vite_|api_base|shell_init|datasource not found|managed datasource|agent not found|collector failed)\\b/i;\n\nexport class UserFacingError extends Error {\n  readonly kind: UserFacingErrorKind;\n\n  constructor(kind: UserFacingErrorKind, message: string, cause?: unknown) {\n    super(message, cause === undefined ? undefined : { cause });\n    this.name = 'UserFacingError';\n    this.kind = kind;\n  }\n}\n\nfunction errorDetails(error: unknown): string {\n  if (error instanceof Error) {\n    const value = error as Error & ErrorLike;\n    return [value.status, value.statusCode, value.code, value.message].filter(Boolean).join(' ');\n  }\n  if (error && typeof error === 'object') {\n    const value = error as ErrorLike;\n    return [value.status, value.statusCode, value.code, value.message].filter(Boolean).join(' ');\n  }\n  return String(error ?? '');\n}\n\nfunction errorStatus(error: unknown): number | null {\n  if (!error || typeof error !== 'object') return null;\n  const value = error as ErrorLike;\n  const candidate = value.status ?? value.statusCode;\n  const status = typeof candidate === 'number' ? candidate : Number(candidate);\n  return Number.isInteger(status) ? status : null;\n}\n\n/** Read the original failure for branching or telemetry; never render this value. */\nexport function diagnosticErrorText(error: unknown): string {\n  if (error instanceof UserFacingError && error.cause !== undefined) {\n    return errorDetails(error.cause);\n  }\n  return errorDetails(error);\n}\n\nexport function classifyUserFacingError(error: unknown): UserFacingErrorKind {\n  if (error instanceof UserFacingError) return error.kind;\n  const status = errorStatus(error);\n  if (status === 401 || status === 403) return 'permission';\n  if (status === 400 || status === 404 || status === 409 || status === 422) return 'validation';\n  if (status === 408 || status === 429 || (status !== null && status >= 500)) return 'unavailable';\n  const details = errorDetails(error);\n  if (PERMISSION_PATTERN.test(details)) return 'permission';\n  if (UNAVAILABLE_PATTERN.test(details)) return 'unavailable';\n  if (VALIDATION_PATTERN.test(details)) return 'validation';\n  return 'unknown';\n}\n\n/**\n * Converts an implementation-level failure into copy that is safe to render.\n * The original failure is retained as `cause` and written to diagnostics only.\n */\nexport function toUserFacingError(\n  error: unknown,\n  messages: UserFacingErrorMessages,\n  context = 'operation'\n): UserFacingError {\n  if (error instanceof UserFacingError) return error;\n  console.error(`[GeniApp] ${context} failed`, error);\n  const kind = classifyUserFacingError(error);\n  return new UserFacingError(kind, messages[kind], error);\n}\n"],"names":["PERMISSION_PATTERN","VALIDATION_PATTERN","UNAVAILABLE_PATTERN","UserFacingError","kind","message","cause","errorDetails","error","value","errorStatus","candidate","status","diagnosticErrorText","classifyUserFacingError","details","toUserFacingError","messages","context"],"mappings":"AAWA,MAAMA,IAAqB,2IACrBC,IAAqB,mHACrBC,IAAsB;AAErB,MAAMC,UAAwB,MAAM;AAAA,EAChC;AAAA,EAET,YAAYC,GAA2BC,GAAiBC,GAAiB;AACvE,UAAMD,GAASC,MAAU,SAAY,SAAY,EAAE,OAAAA,GAAO,GAC1D,KAAK,OAAO,mBACZ,KAAK,OAAOF;AAAA,EACd;AACF;AAEA,SAASG,EAAaC,GAAwB;AAC5C,MAAIA,aAAiB,OAAO;AAC1B,UAAMC,IAAQD;AACd,WAAO,CAACC,EAAM,QAAQA,EAAM,YAAYA,EAAM,MAAMA,EAAM,OAAO,EAAE,OAAO,OAAO,EAAE,KAAK,GAAG;AAAA,EAC7F;AACA,MAAID,KAAS,OAAOA,KAAU,UAAU;AACtC,UAAMC,IAAQD;AACd,WAAO,CAACC,EAAM,QAAQA,EAAM,YAAYA,EAAM,MAAMA,EAAM,OAAO,EAAE,OAAO,OAAO,EAAE,KAAK,GAAG;AAAA,EAC7F;AACA,SAAO,OAAOD,KAAS,EAAE;AAC3B;AAEA,SAASE,EAAYF,GAA+B;AAClD,MAAI,CAACA,KAAS,OAAOA,KAAU,SAAU,QAAO;AAChD,QAAMC,IAAQD,GACRG,IAAYF,EAAM,UAAUA,EAAM,YAClCG,IAAS,OAAOD,KAAc,WAAWA,IAAY,OAAOA,CAAS;AAC3E,SAAO,OAAO,UAAUC,CAAM,IAAIA,IAAS;AAC7C;AAGO,SAASC,EAAoBL,GAAwB;AAC1D,SAAIA,aAAiBL,KAAmBK,EAAM,UAAU,SAC/CD,EAAaC,EAAM,KAAK,IAE1BD,EAAaC,CAAK;AAC3B;AAEO,SAASM,EAAwBN,GAAqC;AAC3E,MAAIA,aAAiBL,EAAiB,QAAOK,EAAM;AACnD,QAAMI,IAASF,EAAYF,CAAK;AAChC,MAAII,MAAW,OAAOA,MAAW,IAAK,QAAO;AAC7C,MAAIA,MAAW,OAAOA,MAAW,OAAOA,MAAW,OAAOA,MAAW,IAAK,QAAO;AACjF,MAAIA,MAAW,OAAOA,MAAW,OAAQA,MAAW,QAAQA,KAAU,IAAM,QAAO;AACnF,QAAMG,IAAUR,EAAaC,CAAK;AAClC,SAAIR,EAAmB,KAAKe,CAAO,IAAU,eACzCb,EAAoB,KAAKa,CAAO,IAAU,gBAC1Cd,EAAmB,KAAKc,CAAO,IAAU,eACtC;AACT;AAMO,SAASC,EACdR,GACAS,GACAC,IAAU,aACO;AACjB,MAAIV,aAAiBL,EAAiB,QAAOK;AAC7C,UAAQ,MAAM,aAAaU,CAAO,WAAWV,CAAK;AAClD,QAAMJ,IAAOU,EAAwBN,CAAK;AAC1C,SAAO,IAAIL,EAAgBC,GAAMa,EAASb,CAAI,GAAGI,CAAK;AACxD;"}

package/dist/ai/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @genispace/geniapp/ai — shared AI adopt UI, workflow results, managed datasource, integrations.
+ * Import only from this barrel in application code.
+ */
+export { createTableClient } from './managed-data/createTableClient';
+export { queryManagedDatasourceRows, queryManagedDatasourceRowsAll, findManagedAppDataSourceId, createGeniSpaceClient, } from './managed-data/queryManagedDatasource';
+export { executeManagedDatasourceOperation, executeManagedDatasourceTransaction, createTransactionDatasourceClient, type ManagedDatasourceOperationResult, type ExecuteManagedDatasourceParams, type TransactionDatasourceClient, } from './managed-data/executeManagedDatasource';
+export { emitManagedEvent, createManagedEventClient, type EmittedEventEnvelope, type ManagedEventClient, } from './managed-data/emitManagedEvent';
+export { DatasourceReadonlyTable } from './managed-data/DatasourceReadonlyTable';
+export { ServerDataTable, type ServerDataTableProps, type ServerColumn, type ServerDataTableLabels, type SortDir, } from './components/ServerDataTable';
+export { AsyncCombobox, type AsyncComboboxProps, type AsyncOption, type AsyncComboboxLabels, } from './components/AsyncCombobox';
+export { useInfiniteRows, type UseInfiniteRowsResult } from './components/useInfiniteRows';
+export { Timeline, TimelineItem, type TimelineProps, type TimelineItemProps } from './components/Timeline';
+export { EntityRef, useEntityNames, type EntityRefProps, type UseEntityNamesResult, } from './components/EntityRef';
+export { BulkActionBar, type BulkActionBarProps, type BulkAction, type BulkActionBarLabels, } from './components/BulkActionBar';
+export { AgentJobProgressInline, useAgentJobRunner, type AgentJobProgressInlineProps, type AgentJobProgressLabels, type AgentRunState, type AgentJobLike, type AgentTaskContext, type AgentJobStartOptions, type UseAgentJobRunnerResult, } from './components/AgentJobProgress';
+export { JobProgress, useAsyncJob, type JobProgressProps, type JobProgressLabels, type JobStatus, type JobProgressState, type JobResult, type JobRunner, type UseAsyncJobResult, } from './components/JobProgress';
+export { UserFacingError, classifyUserFacingError, diagnosticErrorText, toUserFacingError, type UserFacingErrorKind, type UserFacingErrorMessages, } from './errors/userFacingError';
+export { AppUiProviders } from './providers/AppUiProviders';
+export { AI_SIDEBAR_MIN, AI_SIDEBAR_MAX, MODAL_SIZE_WITH_AI, AI_ADOPT_MODAL_GRID_STYLE, AI_ADOPT_GRID_CLASS, AI_ADOPT_PAGE_GRID_CLASS, } from './layout/layoutConstants';
+export { ModalWithAiLayout } from './layout/ModalWithAiLayout';
+export { modalSizeForAi } from './layout/modalSizeForAi';
+export { DetailPageAiLayout } from './adopt/DetailPageAiLayout';
+export { AiSuggestionPanel, productDescriptionAdoptFields } from './adopt/AiSuggestionPanel';
+export type { AiSuggestionPanelProps } from './adopt/AiSuggestionPanel';
+export { BusinessGuidancePanel } from './adopt/BusinessGuidancePanel';
+export type { BusinessGuidancePanelProps } from './adopt/BusinessGuidancePanel';
+export { guidanceContentFromSummary, guidanceStatus } from './adopt/guidanceContent';
+export type { GuidanceContent, GuidanceLanguage } from './adopt/guidanceContent';
+export { parseAiSummary, getByPath, formatDisplayValue, localizedText } from './adopt/parseAiSummary';
+export { genericSummaryField, narrationAdoptField, recommendationAdoptField, descriptionAdoptField, synopsisAdoptField, noteAdoptField, internalNotesAdoptField, jobTitleAdoptField, appendTextAdoptField, } from './adopt/adoptPresets';
+export { PARTNER_GENIAPP, PARTNER_RECORD_PICKER_DS, probePartnerRecordPicker, loadPartnerRecordOptions, type PartnerRecordOption, type PartnerRecordRole, type LoadPartnerRecordOptionsParams, } from './integrations/partner/partnerRecordPicker';
+export { createPartnerRecordPickerHook, type PartnerRecordPickerHookOptions, } from './integrations/partner/createPartnerRecordPickerHook';
+export type { AdoptFieldConfig, AppTableClient, WorkflowResultRow } from './types';

package/dist/ai/integrations/partner/createPartnerRecordPickerHook.d.ts

@@ -0,0 +1,15 @@
+import { PartnerRecordRole } from './partnerRecordPicker';
+
+export type PartnerRecordPickerHookOptions = {
+    role?: PartnerRecordRole;
+    partyType?: 'organization' | 'person';
+    legalEntityRef?: string;
+};
+export declare function createPartnerRecordPickerHook(buildApiRoot: () => string, hookOptions?: PartnerRecordPickerHookOptions): (enabled: boolean, ensureIds?: string[]) => {
+    pickerAvailable: boolean;
+    options: import('../../../hooks').ManagedPickerOption[];
+    loading: boolean;
+    loadError: string | null;
+    reload: () => Promise<void>;
+    providerGeniappId: string;
+};

package/dist/ai/integrations/partner/partnerRecordPicker.d.ts

@@ -0,0 +1,20 @@
+export declare const PARTNER_GENIAPP = "partner";
+export declare const PARTNER_RECORD_PICKER_DS = "partner_record_picker";
+export type PartnerRecordRole = 'customer' | 'supplier' | 'prospect' | 'service_provider' | 'manufacturer' | 'carrier' | 'franchisee' | 'equipment_owner';
+export type PartnerRecordOption = {
+    id: string;
+    label: string;
+    secondary?: string;
+    /** Read-only business details published by Partner for directory and picker experiences. */
+    snapshot?: Record<string, unknown>;
+};
+export type LoadPartnerRecordOptionsParams = {
+    role?: PartnerRecordRole;
+    partyType?: 'organization' | 'person';
+    legalEntityRef?: string;
+    limit?: number;
+    offset?: number;
+    ensureIds?: string[];
+};
+export declare function probePartnerRecordPicker(apiRoot: string, token: string | null): Promise<boolean>;
+export declare function loadPartnerRecordOptions(apiRoot: string, token: string | null, params?: LoadPartnerRecordOptionsParams): Promise<PartnerRecordOption[]>;

package/dist/ai/layout/ModalWithAiLayout.d.ts

@@ -0,0 +1,11 @@
+import { ReactNode } from 'react';
+
+/**
+ * Two-column body for modals/dialogs with AiSuggestionPanel (DESIGN_GUIDELINE §16.1).
+ * Uses inline grid columns so layout works even when Tailwind does not scan shared/ai/**.
+ */
+export declare function ModalWithAiLayout({ children, sidebar, className, }: {
+    children: ReactNode;
+    sidebar?: ReactNode | null;
+    className?: string;
+}): import("react").JSX.Element;

package/dist/ai/layout/aiUi.d.ts

@@ -0,0 +1,16 @@
+import { ComponentProps, ReactNode } from 'react';
+import { Button } from '../../kit';
+
+/** Read-only AI/workflow text block (matches shared-ui AiMessage; kept here for CI kit compatibility). */
+export declare function AiMessage({ children, className, }: {
+    children: ReactNode;
+    className?: string;
+}): import("react").JSX.Element;
+/** Field suggestion row for audit adopt (matches shared-ui AiSuggestion). */
+export declare function AiSuggestion({ label, children, action, className, }: {
+    label: string;
+    children: ReactNode;
+    action?: ReactNode;
+    className?: string;
+}): import("react").JSX.Element;
+export declare function AiSuggestionAction({ children, ...props }: ComponentProps<typeof Button>): import("react").JSX.Element;

package/dist/ai/layout/layoutConstants.d.ts

@@ -0,0 +1,19 @@
+import { CSSProperties } from 'react';
+
+/** AI adopt sidebar column (DESIGN_GUIDELINE §16.1). */
+export declare const AI_SIDEBAR_MIN = "280px";
+export declare const AI_SIDEBAR_MAX = "320px";
+/**
+ * Modal size when AiSuggestionPanel is shown beside the form.
+ * Uses `xl` for compatibility with published shared-ui; switch to `wide` once
+ * @genispace/geniapp exports AppModalSize `'wide'`.
+ */
+export declare const MODAL_SIZE_WITH_AI: "xl";
+export type ModalSizeWithAi = typeof MODAL_SIZE_WITH_AI;
+/** Modal / dialog: form + AI sidebar columns (inline — not dependent on Tailwind scan). */
+export declare const AI_ADOPT_MODAL_GRID_STYLE: CSSProperties;
+/** Tailwind class for apps that include shared/ai/** in content paths (optional). */
+export declare const AI_ADOPT_GRID_CLASS = "grid grid-cols-[minmax(0,1fr)_minmax(280px,320px)] gap-4";
+/** Full-page adopt layout: same columns from lg breakpoint upward. */
+export declare const AI_ADOPT_PAGE_GRID_CLASS = "space-y-6 lg:grid lg:grid-cols-[1fr_minmax(280px,320px)] lg:gap-6 lg:space-y-0";
+export declare const AI_ADOPT_MODAL_MAX_HEIGHT = "max-h-[70vh]";

package/dist/ai/layout/modalSizeForAi.d.ts

@@ -0,0 +1,5 @@
+import { AppModalSize } from '../../kit';
+import { MODAL_SIZE_WITH_AI } from './layoutConstants';
+
+/** Use wide modal when an AI adopt sidebar is shown; otherwise keep the app default. */
+export declare function modalSizeForAi<S extends AppModalSize>(hasAiSidebar: boolean, defaultSize: S): S | typeof MODAL_SIZE_WITH_AI;

package/dist/ai/locales/sharedAiCopy.d.ts

@@ -0,0 +1,6 @@
+import { default as en } from './en.json';
+
+export type SharedAiLanguage = 'en' | 'zh';
+export type SharedAiCopy = typeof en;
+/** English is the deterministic fallback; Chinese is used only after an explicit locale switch. */
+export declare function sharedAiCopy(language: SharedAiLanguage): SharedAiCopy;

package/dist/ai/managed-data/DatasourceReadonlyTable.d.ts

@@ -0,0 +1,11 @@
+export declare function DatasourceReadonlyTable({ title, hint, rows, columns, emptyLabel, }: {
+    title: string;
+    hint?: string;
+    rows: Record<string, unknown>[];
+    columns: Array<{
+        key: string;
+        label: string;
+        format?: (v: unknown) => string;
+    }>;
+    emptyLabel?: string;
+}): import("react").JSX.Element;

package/dist/ai/managed-data/createTableClient.d.ts

@@ -0,0 +1,7 @@
+import { AppTableClient } from '../types';
+
+/** Adapter for apps using apiList / apiUpdate style helpers. */
+export declare function createTableClient(handlers: {
+    list: <T>(table: string, params?: Record<string, string | number | boolean | null>) => Promise<T[]>;
+    update: (table: string, id: string, payload: Record<string, unknown>) => Promise<unknown>;
+}): AppTableClient;

package/dist/ai/managed-data/emitManagedEvent.d.ts

@@ -0,0 +1,18 @@
+export type EmittedEventEnvelope = {
+    id: string;
+    status: string;
+    eventName: string;
+    [k: string]: unknown;
+};
+/**
+ * Emit a Space-level event from a GeniApp. The app's installed events.json must
+ * declare the event; the payload is validated server-side against its schema.
+ */
+export declare function emitManagedEvent(apiRoot: string, accessToken: string | null, geniappIdentifier: string, eventName: string, payload: Record<string, unknown>, opts?: {
+    idempotencyKey?: string;
+}): Promise<EmittedEventEnvelope>;
+export type ManagedEventClient = (eventName: string, payload: Record<string, unknown>, opts?: {
+    idempotencyKey?: string;
+}) => Promise<EmittedEventEnvelope>;
+/** Factory for per-app event emitters. */
+export declare function createManagedEventClient(geniappIdentifier: string, resolveApiRoot: () => string, resolveAccessToken?: () => string | null): ManagedEventClient;

package/dist/ai/managed-data/executeManagedDatasource.d.ts

@@ -0,0 +1,21 @@
+/** Result from POST /datasources/:id/data for TRANSACTION / CREATE / UPDATE operations. */
+export type ManagedDatasourceOperationResult = {
+    operationType?: string;
+    affectedRows?: number;
+    insertId?: number | string;
+    executionTime?: number;
+    statementCount?: number;
+    [key: string]: unknown;
+};
+export type ExecuteManagedDatasourceParams = Record<string, string | number | boolean | null | undefined>;
+/**
+ * Execute a managed GeniApp datasource write operation (TRANSACTION, CREATE, UPDATE, etc.)
+ * via POST /datasources/:id/data. For TRANSACTION datasources with JSON payloads, pass
+ * `payload` as a JSON string (SQL uses `{{payload}}::jsonb`).
+ */
+export declare function executeManagedDatasourceOperation(apiRoot: string, accessToken: string | null, geniappIdentifier: string, seedIdentifier: string, params: ExecuteManagedDatasourceParams): Promise<ManagedDatasourceOperationResult>;
+/** Convenience wrapper for TRANSACTION datasources that accept a single JSON payload parameter. */
+export declare function executeManagedDatasourceTransaction(apiRoot: string, accessToken: string | null, geniappIdentifier: string, seedIdentifier: string, payload: unknown, payloadParamName?: string): Promise<ManagedDatasourceOperationResult>;
+export type TransactionDatasourceClient = (seedIdentifier: string, payload: unknown) => Promise<ManagedDatasourceOperationResult>;
+/** Factory for per-app transaction executors. */
+export declare function createTransactionDatasourceClient(geniappIdentifier: string, resolveApiRoot: () => string, resolveAccessToken?: () => string | null): TransactionDatasourceClient;

package/dist/ai/managed-data/queryManagedDatasource.d.ts

@@ -0,0 +1,28 @@
+import { GeniSpace } from 'genispace';
+
+export declare function findManagedAppDataSourceId(client: GeniSpace, seedIdentifier: string, geniappIdentifier: string): Promise<string | null>;
+export declare function createGeniSpaceClient(apiRoot: string, accessToken: string | null): GeniSpace;
+type DsQueryParams = Record<string, string | number | boolean | undefined>;
+/**
+ * Run one READ query with pagination expressed in a way EVERY API version
+ * honors.
+ *
+ * Why this exists: `GET /datasources/:id/data` derives the `{{offset}}` SQL
+ * binding from `(page - 1) * limit` and OVERWRITES any `offset` sent as a plain
+ * query param (see api datasource.service `getDataSourceData`). So a bare
+ * `{ limit, offset }` GET silently pins `{{offset}}` to 0 — page turns fetch
+ * the same first page. Newer API branches may honor the `offset` param
+ * directly, so every request here keeps `page`, `limit` and `offset` mutually
+ * consistent (`offset === (page - 1) * limit`); both interpretations then
+ * yield the same window.
+ *
+ * - `offset` aligned to `limit` → one request with the matching `page`.
+ * - misaligned `offset` (e.g. ServerDataTable's `limit = pageSize + 1`,
+ *   `offset = pageIndex * pageSize`) → stitch the two aligned windows that
+ *   cover the requested range.
+ */
+export declare function queryReadRowsPaged(gs: GeniSpace, datasourceId: string, params: DsQueryParams): Promise<Record<string, unknown>[]>;
+export declare function queryManagedDatasourceRows(apiRoot: string, accessToken: string | null, geniappIdentifier: string, seedIdentifier: string, params?: DsQueryParams): Promise<Record<string, unknown>[]>;
+/** Fetch all rows from a managed datasource, paginating at the API max limit (1000). */
+export declare function queryManagedDatasourceRowsAll(apiRoot: string, accessToken: string | null, geniappIdentifier: string, seedIdentifier: string, params?: Record<string, string | number | boolean | undefined>): Promise<Record<string, unknown>[]>;
+export {};

package/dist/ai/providers/AppUiProviders.d.ts

@@ -0,0 +1,6 @@
+import { ReactNode } from 'react';
+
+/** Mount once at GeniApp root (enables kit toast, tooltips). */
+export declare function AppUiProviders({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;

package/dist/ai/types/app-ai.types.d.ts

@@ -0,0 +1,29 @@
+export interface WorkflowResultRow {
+    id: string;
+    run_no?: string | null;
+    source_record_key?: string | null;
+    summary?: string | null;
+    status?: string | null;
+    owner?: string | null;
+    created_at?: string | null;
+}
+export interface AdoptFieldConfig {
+    /** i18n key or plain label */
+    label: string;
+    /** Dot path in parsed summary JSON */
+    summaryPath: string;
+    /** Target column on the business record */
+    targetField: string;
+    /** Optional transform before PATCH */
+    toValue?: (raw: unknown, parsed: Record<string, unknown> | null, language?: 'en' | 'zh') => unknown;
+}
+export interface AppTableClient {
+    list<T>(table: string, options?: {
+        filters?: Record<string, string | number | boolean | null>;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        items: T[];
+    }>;
+    update(table: string, id: string, payload: Record<string, unknown>): Promise<unknown>;
+}

package/dist/ai/types/index.d.ts

@@ -0,0 +1 @@
+export type { WorkflowResultRow, AdoptFieldConfig, AppTableClient } from './app-ai.types';

package/dist/ai.d.ts

@@ -0,0 +1 @@
+export * from './ai/index';