@xemahq/kernel-contracts 0.49.1 → 0.49.3

package/dist/app-definition/index.d.ts

@@ -0,0 +1,10 @@
+export * from './lib/field-type';
+export * from './lib/page-kind';
+export * from './lib/component';
+export * from './lib/widget';
+export * from './lib/action';
+export * from './lib/automation';
+export * from './lib/authorization';
+export * from './lib/data-mode';
+export * from './lib/definition';
+//# sourceMappingURL=index.d.ts.map

package/dist/app-definition/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/app-definition/index.ts"],"names":[],"mappings":"AAMA,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/dist/app-definition/index.js

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./lib/field-type"), exports);
+__exportStar(require("./lib/page-kind"), exports);
+__exportStar(require("./lib/component"), exports);
+__exportStar(require("./lib/widget"), exports);
+__exportStar(require("./lib/action"), exports);
+__exportStar(require("./lib/automation"), exports);
+__exportStar(require("./lib/authorization"), exports);
+__exportStar(require("./lib/data-mode"), exports);
+__exportStar(require("./lib/definition"), exports);
+//# sourceMappingURL=index.js.map

package/dist/app-definition/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/app-definition/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAMA,mDAAiC;AACjC,kDAAgC;AAChC,kDAAgC;AAChC,+CAA6B;AAC7B,+CAA6B;AAC7B,mDAAiC;AACjC,sDAAoC;AACpC,kDAAgC;AAChC,mDAAiC"}

package/dist/app-definition/lib/action.d.ts

@@ -0,0 +1,45 @@
+export declare enum AppActionKind {
+    UpdateRecord = "updateRecord",
+    TransitionField = "transitionField",
+    InvokeAgent = "invokeAgent",
+    InvokeCapability = "invokeCapability"
+}
+export type AppAction = {
+    key: string;
+    label: string;
+    entityKey: string;
+    kind: AppActionKind.UpdateRecord;
+    config: {
+        set: Record<string, string | number | boolean | null>;
+    };
+} | {
+    key: string;
+    label: string;
+    entityKey: string;
+    kind: AppActionKind.TransitionField;
+    config: {
+        field: string;
+        order: string[];
+    };
+} | {
+    key: string;
+    label: string;
+    entityKey: string;
+    kind: AppActionKind.InvokeAgent;
+    config: {
+        agentRef: string;
+        promptTemplate: string;
+        targetField: string;
+        outputKey?: string;
+    };
+} | {
+    key: string;
+    label: string;
+    entityKey: string;
+    kind: AppActionKind.InvokeCapability;
+    config: {
+        capabilityRef: string;
+        input: Record<string, string | number | boolean | null>;
+    };
+};
+//# sourceMappingURL=action.d.ts.map

package/dist/app-definition/lib/action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../src/app-definition/lib/action.ts"],"names":[],"mappings":"AAQA,oBAAY,aAAa;IACvB,YAAY,iBAAiB;IAC7B,eAAe,oBAAoB;IACnC,WAAW,gBAAgB;IAK3B,gBAAgB,qBAAqB;CACtC;AAYD,MAAM,MAAM,SAAS,GACjB;IACE,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC,YAAY,CAAC;IACjC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAA;KAAE,CAAC;CACnE,GACD;IACE,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC,eAAe,CAAC;IACpC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC5C,GACD;IACE,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC,WAAW,CAAC;IAChC,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,GACD;IACE,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC,gBAAgB,CAAC;IACrC,MAAM,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;KACzD,CAAC;CACH,CAAC"}

package/dist/app-definition/lib/action.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppActionKind = void 0;
+var AppActionKind;
+(function (AppActionKind) {
+    AppActionKind["UpdateRecord"] = "updateRecord";
+    AppActionKind["TransitionField"] = "transitionField";
+    AppActionKind["InvokeAgent"] = "invokeAgent";
+    AppActionKind["InvokeCapability"] = "invokeCapability";
+})(AppActionKind || (exports.AppActionKind = AppActionKind = {}));
+//# sourceMappingURL=action.js.map

package/dist/app-definition/lib/action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.js","sourceRoot":"","sources":["../../../src/app-definition/lib/action.ts"],"names":[],"mappings":";;;AAQA,IAAY,aASX;AATD,WAAY,aAAa;IACvB,8CAA6B,CAAA;IAC7B,oDAAmC,CAAA;IACnC,4CAA2B,CAAA;IAK3B,sDAAqC,CAAA;AACvC,CAAC,EATW,aAAa,6BAAb,aAAa,QASxB"}

package/dist/app-definition/lib/authorization.d.ts

@@ -0,0 +1,29 @@
+export declare enum AppRowPolicyOp {
+    Eq = "Eq",
+    Ne = "Ne",
+    In = "In",
+    NotIn = "NotIn",
+    IsNull = "IsNull",
+    IsNotNull = "IsNotNull"
+}
+export declare enum AppRowPolicySubject {
+    Id = "id",
+    Tenant = "tenant"
+}
+export declare enum AppReadAccessMode {
+    None = "none",
+    Aggregate = "aggregate",
+    Rows = "rows"
+}
+export declare enum AppAggregateMeasure {
+    Count = "count",
+    Average = "average",
+    Sum = "sum",
+    Min = "min",
+    Max = "max"
+}
+export declare enum AppAgentAccess {
+    Allow = "allow",
+    Deny = "deny"
+}
+//# sourceMappingURL=authorization.d.ts.map

package/dist/app-definition/lib/authorization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorization.d.ts","sourceRoot":"","sources":["../../../src/app-definition/lib/authorization.ts"],"names":[],"mappings":"AAcA,oBAAY,cAAc;IACxB,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB;AAOD,oBAAY,mBAAmB;IAC7B,EAAE,OAAO;IACT,MAAM,WAAW;CAClB;AAGD,oBAAY,iBAAiB;IAE3B,IAAI,SAAS;IAEb,SAAS,cAAc;IAEvB,IAAI,SAAS;CACd;AAGD,oBAAY,mBAAmB;IAC7B,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;CACZ;AAGD,oBAAY,cAAc;IACxB,KAAK,UAAU;IACf,IAAI,SAAS;CACd"}

package/dist/app-definition/lib/authorization.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppAgentAccess = exports.AppAggregateMeasure = exports.AppReadAccessMode = exports.AppRowPolicySubject = exports.AppRowPolicyOp = void 0;
+var AppRowPolicyOp;
+(function (AppRowPolicyOp) {
+    AppRowPolicyOp["Eq"] = "Eq";
+    AppRowPolicyOp["Ne"] = "Ne";
+    AppRowPolicyOp["In"] = "In";
+    AppRowPolicyOp["NotIn"] = "NotIn";
+    AppRowPolicyOp["IsNull"] = "IsNull";
+    AppRowPolicyOp["IsNotNull"] = "IsNotNull";
+})(AppRowPolicyOp || (exports.AppRowPolicyOp = AppRowPolicyOp = {}));
+var AppRowPolicySubject;
+(function (AppRowPolicySubject) {
+    AppRowPolicySubject["Id"] = "id";
+    AppRowPolicySubject["Tenant"] = "tenant";
+})(AppRowPolicySubject || (exports.AppRowPolicySubject = AppRowPolicySubject = {}));
+var AppReadAccessMode;
+(function (AppReadAccessMode) {
+    AppReadAccessMode["None"] = "none";
+    AppReadAccessMode["Aggregate"] = "aggregate";
+    AppReadAccessMode["Rows"] = "rows";
+})(AppReadAccessMode || (exports.AppReadAccessMode = AppReadAccessMode = {}));
+var AppAggregateMeasure;
+(function (AppAggregateMeasure) {
+    AppAggregateMeasure["Count"] = "count";
+    AppAggregateMeasure["Average"] = "average";
+    AppAggregateMeasure["Sum"] = "sum";
+    AppAggregateMeasure["Min"] = "min";
+    AppAggregateMeasure["Max"] = "max";
+})(AppAggregateMeasure || (exports.AppAggregateMeasure = AppAggregateMeasure = {}));
+var AppAgentAccess;
+(function (AppAgentAccess) {
+    AppAgentAccess["Allow"] = "allow";
+    AppAgentAccess["Deny"] = "deny";
+})(AppAgentAccess || (exports.AppAgentAccess = AppAgentAccess = {}));
+//# sourceMappingURL=authorization.js.map

package/dist/app-definition/lib/authorization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorization.js","sourceRoot":"","sources":["../../../src/app-definition/lib/authorization.ts"],"names":[],"mappings":";;;AAcA,IAAY,cAOX;AAPD,WAAY,cAAc;IACxB,2BAAS,CAAA;IACT,2BAAS,CAAA;IACT,2BAAS,CAAA;IACT,iCAAe,CAAA;IACf,mCAAiB,CAAA;IACjB,yCAAuB,CAAA;AACzB,CAAC,EAPW,cAAc,8BAAd,cAAc,QAOzB;AAOD,IAAY,mBAGX;AAHD,WAAY,mBAAmB;IAC7B,gCAAS,CAAA;IACT,wCAAiB,CAAA;AACnB,CAAC,EAHW,mBAAmB,mCAAnB,mBAAmB,QAG9B;AAGD,IAAY,iBAOX;AAPD,WAAY,iBAAiB;IAE3B,kCAAa,CAAA;IAEb,4CAAuB,CAAA;IAEvB,kCAAa,CAAA;AACf,CAAC,EAPW,iBAAiB,iCAAjB,iBAAiB,QAO5B;AAGD,IAAY,mBAMX;AAND,WAAY,mBAAmB;IAC7B,sCAAe,CAAA;IACf,0CAAmB,CAAA;IACnB,kCAAW,CAAA;IACX,kCAAW,CAAA;IACX,kCAAW,CAAA;AACb,CAAC,EANW,mBAAmB,mCAAnB,mBAAmB,QAM9B;AAGD,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,iCAAe,CAAA;IACf,+BAAa,CAAA;AACf,CAAC,EAHW,cAAc,8BAAd,cAAc,QAGzB"}

package/dist/app-definition/lib/automation.d.ts

@@ -0,0 +1,15 @@
+export declare enum AppAutomationTrigger {
+    RecordCreated = "recordCreated",
+    RecordUpdated = "recordUpdated",
+    Scheduled = "scheduled"
+}
+export interface AppAutomation {
+    key: string;
+    trigger: AppAutomationTrigger;
+    entityKey: string;
+    action: string;
+    schedule?: {
+        everyMinutes: number;
+    };
+}
+//# sourceMappingURL=automation.d.ts.map

package/dist/app-definition/lib/automation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automation.d.ts","sourceRoot":"","sources":["../../../src/app-definition/lib/automation.ts"],"names":[],"mappings":"AAcA,oBAAY,oBAAoB;IAC9B,aAAa,kBAAkB;IAC/B,aAAa,kBAAkB;IAC/B,SAAS,cAAc;CACxB;AAMD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,oBAAoB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAElB,MAAM,EAAE,MAAM,CAAC;IAMf,QAAQ,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CACrC"}

package/dist/app-definition/lib/automation.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppAutomationTrigger = void 0;
+var AppAutomationTrigger;
+(function (AppAutomationTrigger) {
+    AppAutomationTrigger["RecordCreated"] = "recordCreated";
+    AppAutomationTrigger["RecordUpdated"] = "recordUpdated";
+    AppAutomationTrigger["Scheduled"] = "scheduled";
+})(AppAutomationTrigger || (exports.AppAutomationTrigger = AppAutomationTrigger = {}));
+//# sourceMappingURL=automation.js.map

package/dist/app-definition/lib/automation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"automation.js","sourceRoot":"","sources":["../../../src/app-definition/lib/automation.ts"],"names":[],"mappings":";;;AAcA,IAAY,oBAIX;AAJD,WAAY,oBAAoB;IAC9B,uDAA+B,CAAA;IAC/B,uDAA+B,CAAA;IAC/B,+CAAuB,CAAA;AACzB,CAAC,EAJW,oBAAoB,oCAApB,oBAAoB,QAI/B"}

package/dist/app-definition/lib/component.d.ts

@@ -0,0 +1,8 @@
+export declare enum AppComponentKind {
+    Code = "code"
+}
+export interface AppCodeComponent {
+    readonly kind: AppComponentKind.Code;
+    readonly source: string;
+}
+//# sourceMappingURL=component.d.ts.map

package/dist/app-definition/lib/component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../../src/app-definition/lib/component.ts"],"names":[],"mappings":"AA+BA,oBAAY,gBAAgB;IAE1B,IAAI,SAAS;CACd;AASD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC;IAErC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB"}

package/dist/app-definition/lib/component.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppComponentKind = void 0;
+var AppComponentKind;
+(function (AppComponentKind) {
+    AppComponentKind["Code"] = "code";
+})(AppComponentKind || (exports.AppComponentKind = AppComponentKind = {}));
+//# sourceMappingURL=component.js.map

package/dist/app-definition/lib/component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../../../src/app-definition/lib/component.ts"],"names":[],"mappings":";;;AA+BA,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IAE1B,iCAAa,CAAA;AACf,CAAC,EAHW,gBAAgB,gCAAhB,gBAAgB,QAG3B"}

package/dist/app-definition/lib/data-mode.d.ts

@@ -0,0 +1,6 @@
+export declare enum AppDataMode {
+    None = "none",
+    Owned = "owned",
+    Annotated = "annotated"
+}
+//# sourceMappingURL=data-mode.d.ts.map

package/dist/app-definition/lib/data-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-mode.d.ts","sourceRoot":"","sources":["../../../src/app-definition/lib/data-mode.ts"],"names":[],"mappings":"AAYA,oBAAY,WAAW;IACrB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,SAAS,cAAc;CACxB"}

package/dist/app-definition/lib/data-mode.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppDataMode = void 0;
+var AppDataMode;
+(function (AppDataMode) {
+    AppDataMode["None"] = "none";
+    AppDataMode["Owned"] = "owned";
+    AppDataMode["Annotated"] = "annotated";
+})(AppDataMode || (exports.AppDataMode = AppDataMode = {}));
+//# sourceMappingURL=data-mode.js.map

package/dist/app-definition/lib/data-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-mode.js","sourceRoot":"","sources":["../../../src/app-definition/lib/data-mode.ts"],"names":[],"mappings":";;;AAYA,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,4BAAa,CAAA;IACb,8BAAe,CAAA;IACf,sCAAuB,CAAA;AACzB,CAAC,EAJW,WAAW,2BAAX,WAAW,QAItB"}

package/dist/app-definition/lib/definition.d.ts

@@ -0,0 +1,56 @@
+import { AppFieldType } from './field-type';
+import { AppPageKind } from './page-kind';
+import { AppAction } from './action';
+import { AppAutomation } from './automation';
+import { AppWidget } from './widget';
+import { AppCodeComponent } from './component';
+export interface AppField {
+    key: string;
+    label: string;
+    type: AppFieldType;
+    required?: boolean;
+    enumValues?: string[];
+    referenceEntity?: string;
+    fields?: AppField[];
+    minItems?: number;
+    maxItems?: number;
+}
+export interface AppEntity {
+    key: string;
+    label: string;
+    fields: AppField[];
+}
+export interface AppSection {
+    key: string;
+    title: string;
+    description?: string;
+    fieldKeys: string[];
+}
+export interface AppPage {
+    slug: string;
+    title: string;
+    kind: AppPageKind;
+    entityKey?: string;
+    columns?: string[];
+    fields?: string[];
+    sections?: AppSection[];
+    widgets?: AppWidget[];
+    dateField?: string;
+    linkKey?: string;
+    component?: AppCodeComponent;
+}
+export interface AppLink {
+    key: string;
+    fromEntity: string;
+    refField: string;
+    toEntity: string;
+}
+export interface AppDefinition {
+    entities: AppEntity[];
+    pages: AppPage[];
+    navigation: string[];
+    actions?: AppAction[];
+    automations?: AppAutomation[];
+    links?: AppLink[];
+}
+//# sourceMappingURL=definition.d.ts.map

package/dist/app-definition/lib/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../src/app-definition/lib/definition.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAM/C,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,eAAe,CAAC,EAAE,MAAM,CAAC;IAKzB,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;IAEpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,EAAE,CAAC;CACpB;AAQD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAElB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IAExB,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IAEtB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,OAAO,CAAC,EAAE,MAAM,CAAC;IAOjB,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AASD,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,KAAK,EAAE,OAAO,EAAE,CAAC;IAEjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,aAAa,EAAE,CAAC;IAE9B,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;CACnB"}

package/dist/app-definition/lib/definition.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=definition.js.map

package/dist/app-definition/lib/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../src/app-definition/lib/definition.ts"],"names":[],"mappings":""}

package/dist/app-definition/lib/field-type.d.ts

@@ -0,0 +1,15 @@
+export declare enum AppFieldType {
+    String = "string",
+    Text = "text",
+    Number = "number",
+    Decimal = "decimal",
+    Boolean = "boolean",
+    Date = "date",
+    DateTime = "datetime",
+    Enum = "enum",
+    Reference = "reference",
+    User = "user",
+    Object = "object",
+    List = "list"
+}
+//# sourceMappingURL=field-type.d.ts.map

package/dist/app-definition/lib/field-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-type.d.ts","sourceRoot":"","sources":["../../../src/app-definition/lib/field-type.ts"],"names":[],"mappings":"AAQA,oBAAY,YAAY;IACtB,MAAM,WAAW;IACjB,IAAI,SAAS;IAEb,MAAM,WAAW;IAEjB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,SAAS,cAAc;IAEvB,IAAI,SAAS;IAKb,MAAM,WAAW;IAMjB,IAAI,SAAS;CACd"}

package/dist/app-definition/lib/field-type.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppFieldType = void 0;
+var AppFieldType;
+(function (AppFieldType) {
+    AppFieldType["String"] = "string";
+    AppFieldType["Text"] = "text";
+    AppFieldType["Number"] = "number";
+    AppFieldType["Decimal"] = "decimal";
+    AppFieldType["Boolean"] = "boolean";
+    AppFieldType["Date"] = "date";
+    AppFieldType["DateTime"] = "datetime";
+    AppFieldType["Enum"] = "enum";
+    AppFieldType["Reference"] = "reference";
+    AppFieldType["User"] = "user";
+    AppFieldType["Object"] = "object";
+    AppFieldType["List"] = "list";
+})(AppFieldType || (exports.AppFieldType = AppFieldType = {}));
+//# sourceMappingURL=field-type.js.map

package/dist/app-definition/lib/field-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-type.js","sourceRoot":"","sources":["../../../src/app-definition/lib/field-type.ts"],"names":[],"mappings":";;;AAQA,IAAY,YAyBX;AAzBD,WAAY,YAAY;IACtB,iCAAiB,CAAA;IACjB,6BAAa,CAAA;IAEb,iCAAiB,CAAA;IAEjB,mCAAmB,CAAA;IACnB,mCAAmB,CAAA;IACnB,6BAAa,CAAA;IACb,qCAAqB,CAAA;IACrB,6BAAa,CAAA;IACb,uCAAuB,CAAA;IAEvB,6BAAa,CAAA;IAKb,iCAAiB,CAAA;IAMjB,6BAAa,CAAA;AACf,CAAC,EAzBW,YAAY,4BAAZ,YAAY,QAyBvB"}

package/dist/app-definition/lib/page-kind.d.ts

@@ -0,0 +1,9 @@
+export declare enum AppPageKind {
+    List = "list",
+    Form = "form",
+    Detail = "detail",
+    Dashboard = "dashboard",
+    Timeline = "timeline",
+    Related = "related"
+}
+//# sourceMappingURL=page-kind.d.ts.map

package/dist/app-definition/lib/page-kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-kind.d.ts","sourceRoot":"","sources":["../../../src/app-definition/lib/page-kind.ts"],"names":[],"mappings":"AAKA,oBAAY,WAAW;IACrB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,SAAS,cAAc;IAMvB,QAAQ,aAAa;IAOrB,OAAO,YAAY;CACpB"}

package/dist/app-definition/lib/page-kind.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppPageKind = void 0;
+var AppPageKind;
+(function (AppPageKind) {
+    AppPageKind["List"] = "list";
+    AppPageKind["Form"] = "form";
+    AppPageKind["Detail"] = "detail";
+    AppPageKind["Dashboard"] = "dashboard";
+    AppPageKind["Timeline"] = "timeline";
+    AppPageKind["Related"] = "related";
+})(AppPageKind || (exports.AppPageKind = AppPageKind = {}));
+//# sourceMappingURL=page-kind.js.map

package/dist/app-definition/lib/page-kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-kind.js","sourceRoot":"","sources":["../../../src/app-definition/lib/page-kind.ts"],"names":[],"mappings":";;;AAKA,IAAY,WAkBX;AAlBD,WAAY,WAAW;IACrB,4BAAa,CAAA;IACb,4BAAa,CAAA;IACb,gCAAiB,CAAA;IACjB,sCAAuB,CAAA;IAMvB,oCAAqB,CAAA;IAOrB,kCAAmB,CAAA;AACrB,CAAC,EAlBW,WAAW,2BAAX,WAAW,QAkBtB"}

package/dist/app-definition/lib/widget.d.ts

@@ -0,0 +1,45 @@
+import { AppCodeComponent } from './component';
+export declare enum AppWidgetKind {
+    Stat = "stat",
+    Table = "table",
+    Chart = "chart"
+}
+export declare enum AppWidgetSourceKind {
+    Entity = "entity",
+    Capability = "capability",
+    Series = "series"
+}
+export declare enum AppWidgetAggregate {
+    Count = "count"
+}
+export declare enum AppChartType {
+    Bar = "bar",
+    Line = "line",
+    Donut = "donut"
+}
+export declare enum AppSeriesAggregateKind {
+    Count = "count",
+    Sum = "sum"
+}
+export type AppSeriesAggregate = {
+    kind: AppSeriesAggregateKind.Count;
+} | {
+    kind: AppSeriesAggregateKind.Sum;
+    field: string;
+};
+export interface AppWidgetSeriesSource {
+    entityKey: string;
+    groupBy: string;
+    aggregate: AppSeriesAggregate;
+    chartType: AppChartType;
+}
+export interface AppWidget {
+    kind: AppWidgetKind;
+    title: string;
+    entityKey?: string;
+    aggregate?: AppWidgetAggregate;
+    filter?: Record<string, string | number | boolean>;
+    series?: AppWidgetSeriesSource;
+    component?: AppCodeComponent;
+}
+//# sourceMappingURL=widget.d.ts.map

package/dist/app-definition/lib/widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget.d.ts","sourceRoot":"","sources":["../../../src/app-definition/lib/widget.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,KAAK,UAAU;IAMf,KAAK,UAAU;CAChB;AAQD,oBAAY,mBAAmB;IAC7B,MAAM,WAAW;IACjB,UAAU,eAAe;IACzB,MAAM,WAAW;CAClB;AAGD,oBAAY,kBAAkB;IAC5B,KAAK,UAAU;CAChB;AAOD,oBAAY,YAAY;IACtB,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAMD,oBAAY,sBAAsB;IAChC,KAAK,UAAU;IACf,GAAG,QAAQ;CACZ;AAMD,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,sBAAsB,CAAC,KAAK,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,sBAAsB,CAAC,GAAG,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAOxD,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAElB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,SAAS,EAAE,YAAY,CAAC;CACzB;AAQD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IAKd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAE/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAEnD,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAO/B,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B"}

package/dist/app-definition/lib/widget.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppSeriesAggregateKind = exports.AppChartType = exports.AppWidgetAggregate = exports.AppWidgetSourceKind = exports.AppWidgetKind = void 0;
+var AppWidgetKind;
+(function (AppWidgetKind) {
+    AppWidgetKind["Stat"] = "stat";
+    AppWidgetKind["Table"] = "table";
+    AppWidgetKind["Chart"] = "chart";
+})(AppWidgetKind || (exports.AppWidgetKind = AppWidgetKind = {}));
+var AppWidgetSourceKind;
+(function (AppWidgetSourceKind) {
+    AppWidgetSourceKind["Entity"] = "entity";
+    AppWidgetSourceKind["Capability"] = "capability";
+    AppWidgetSourceKind["Series"] = "series";
+})(AppWidgetSourceKind || (exports.AppWidgetSourceKind = AppWidgetSourceKind = {}));
+var AppWidgetAggregate;
+(function (AppWidgetAggregate) {
+    AppWidgetAggregate["Count"] = "count";
+})(AppWidgetAggregate || (exports.AppWidgetAggregate = AppWidgetAggregate = {}));
+var AppChartType;
+(function (AppChartType) {
+    AppChartType["Bar"] = "bar";
+    AppChartType["Line"] = "line";
+    AppChartType["Donut"] = "donut";
+})(AppChartType || (exports.AppChartType = AppChartType = {}));
+var AppSeriesAggregateKind;
+(function (AppSeriesAggregateKind) {
+    AppSeriesAggregateKind["Count"] = "count";
+    AppSeriesAggregateKind["Sum"] = "sum";
+})(AppSeriesAggregateKind || (exports.AppSeriesAggregateKind = AppSeriesAggregateKind = {}));
+//# sourceMappingURL=widget.js.map

package/dist/app-definition/lib/widget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget.js","sourceRoot":"","sources":["../../../src/app-definition/lib/widget.ts"],"names":[],"mappings":";;;AASA,IAAY,aASX;AATD,WAAY,aAAa;IACvB,8BAAa,CAAA;IACb,gCAAe,CAAA;IAMf,gCAAe,CAAA;AACjB,CAAC,EATW,aAAa,6BAAb,aAAa,QASxB;AAQD,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,wCAAiB,CAAA;IACjB,gDAAyB,CAAA;IACzB,wCAAiB,CAAA;AACnB,CAAC,EAJW,mBAAmB,mCAAnB,mBAAmB,QAI9B;AAGD,IAAY,kBAEX;AAFD,WAAY,kBAAkB;IAC5B,qCAAe,CAAA;AACjB,CAAC,EAFW,kBAAkB,kCAAlB,kBAAkB,QAE7B;AAOD,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,2BAAW,CAAA;IACX,6BAAa,CAAA;IACb,+BAAe,CAAA;AACjB,CAAC,EAJW,YAAY,4BAAZ,YAAY,QAIvB;AAMD,IAAY,sBAGX;AAHD,WAAY,sBAAsB;IAChC,yCAAe,CAAA;IACf,qCAAW,CAAA;AACb,CAAC,EAHW,sBAAsB,sCAAtB,sBAAsB,QAGjC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/kernel-contracts",
-  "version": "0.49.1",
+  "version": "0.49.3",
   "description": "Consolidated Xema OS kernel wire contracts — pure types + zod schemas for the kernel protocol surfaces. One package, one npm scope, wildcard per-surface subpath exports. No framework/runtime deps.",
   "license": "Apache-2.0",
   "author": "Neuralchowder Inc. <developer@xema.dev> (https://xema.dev)",

package/src/app-definition/index.ts

@@ -0,0 +1,15 @@
+// The App Forge declarative-definition SHAPE contract — the closed enums and the
+// plain renderer-facing view models shared, byte-identically, by the app-forge
+// server (which references the enums from its zod validation schema) and the App
+// Forge web biome (which types its renderer view models with them). Pure Layer-0
+// leaf: enums + interfaces only, zero runtime deps. The zod validation logic and
+// the richer zod-inferred `*Def` types stay in the app-forge server.
+export * from './lib/field-type';
+export * from './lib/page-kind';
+export * from './lib/component';
+export * from './lib/widget';
+export * from './lib/action';
+export * from './lib/automation';
+export * from './lib/authorization';
+export * from './lib/data-mode';
+export * from './lib/definition';

package/src/app-definition/lib/action.ts

@@ -0,0 +1,66 @@
+/**
+ * Declarative record actions — the closed action-kind vocabulary + the action
+ * view models the App Forge renderer/builder interpret from the opaque
+ * definition JSON. Shared by the app-forge server's zod schema and the web
+ * surface. Stable wire strings.
+ */
+
+/** Closed set of declarative action kinds an app definition may declare. */
+export enum AppActionKind {
+  UpdateRecord = 'updateRecord',
+  TransitionField = 'transitionField',
+  InvokeAgent = 'invokeAgent',
+  /**
+   * Invoke a declared capability through the same governed path `invokeAgent`
+   * uses — the app's `capabilityPolicy` gate then the base capability router.
+   */
+  InvokeCapability = 'invokeCapability',
+}
+
+/**
+ * One executable record action — discriminated on `kind`.
+ *
+ * - `updateRecord` sets the configured field values on the record.
+ * - `transitionField` advances an enum field along the ordered `order` list.
+ * - `invokeAgent` invokes a platform agent (`agentRef`) with a `{{field-key}}`
+ *   templated prompt; the agent's text result is written into `targetField`.
+ * - `invokeCapability` invokes a capability ref the app's `capabilityPolicy`
+ *   must allow; `input` string values support `{{field-key}}` templating.
+ */
+export type AppAction =
+  | {
+      key: string;
+      label: string;
+      entityKey: string;
+      kind: AppActionKind.UpdateRecord;
+      config: { set: Record<string, string | number | boolean | null> };
+    }
+  | {
+      key: string;
+      label: string;
+      entityKey: string;
+      kind: AppActionKind.TransitionField;
+      config: { field: string; order: string[] };
+    }
+  | {
+      key: string;
+      label: string;
+      entityKey: string;
+      kind: AppActionKind.InvokeAgent;
+      config: {
+        agentRef: string;
+        promptTemplate: string;
+        targetField: string;
+        outputKey?: string;
+      };
+    }
+  | {
+      key: string;
+      label: string;
+      entityKey: string;
+      kind: AppActionKind.InvokeCapability;
+      config: {
+        capabilityRef: string;
+        input: Record<string, string | number | boolean | null>;
+      };
+    };

package/src/app-definition/lib/authorization.ts

@@ -0,0 +1,57 @@
+/**
+ * Declarative-authorization closed vocabulary for an app entity — row-policy
+ * operators/subjects, read-access modes, aggregate measures, and agent access.
+ * These are the enums referenced by the app-forge server's authorization zod
+ * schemas (`z.nativeEnum(...)`); the AUTHOR-facing sub-schemas and the
+ * cross-validation logic stay in the server. Stable wire strings.
+ */
+
+/**
+ * Closed set of row-policy comparison operators. NO expression language and NO
+ * client-supplied predicate — a clause is `{field, op, …}` only. `Eq`/`Ne`
+ * compare a field to a subject-bound value or a literal; `In`/`NotIn` test
+ * membership in a literal list; `IsNull`/`IsNotNull` are unary.
+ */
+export enum AppRowPolicyOp {
+  Eq = 'Eq',
+  Ne = 'Ne',
+  In = 'In',
+  NotIn = 'NotIn',
+  IsNull = 'IsNull',
+  IsNotNull = 'IsNotNull',
+}
+
+/**
+ * What a row-policy clause (or tenancy) binds a field against. Closed — the only
+ * two request-time subject facts a policy may reference: the caller's identity
+ * (`id`) and its resolved tenant (`tenant`).
+ */
+export enum AppRowPolicySubject {
+  Id = 'id',
+  Tenant = 'tenant',
+}
+
+/** Read shape an entity exposes. Closed. */
+export enum AppReadAccessMode {
+  /** Nobody reads rows OR aggregates. */
+  None = 'none',
+  /** Only k-anonymised aggregates. */
+  Aggregate = 'aggregate',
+  /** Full rows, subject to `rowPolicy` + field masking. */
+  Rows = 'rows',
+}
+
+/** Closed set of aggregate measures a widget/aggregate path may compute. */
+export enum AppAggregateMeasure {
+  Count = 'count',
+  Average = 'average',
+  Sum = 'sum',
+  Min = 'min',
+  Max = 'max',
+}
+
+/** Whether the agent capability path may touch an entity. Closed. */
+export enum AppAgentAccess {
+  Allow = 'allow',
+  Deny = 'deny',
+}

package/src/app-definition/lib/automation.ts

@@ -0,0 +1,37 @@
+/**
+ * Declarative automations — the closed trigger vocabulary + the automation view
+ * model the App Forge renderer/builder interpret from the opaque definition
+ * JSON. Shared by the app-forge server's zod schema and the web surface.
+ */
+
+/**
+ * Closed set of automation triggers.
+ *
+ * - `recordCreated` / `recordUpdated` fire transactionally-adjacent to a record
+ *   write, against the written record.
+ * - `scheduled` fires on a cluster-singleton Temporal Schedule and runs its
+ *   action against every record of the bound entity on each tick.
+ */
+export enum AppAutomationTrigger {
+  RecordCreated = 'recordCreated',
+  RecordUpdated = 'recordUpdated',
+  Scheduled = 'scheduled',
+}
+
+/**
+ * Trigger → action binding, run server-side after a record is created or
+ * updated (or on a schedule), from the PUBLISHED definition.
+ */
+export interface AppAutomation {
+  key: string;
+  trigger: AppAutomationTrigger;
+  entityKey: string;
+  /** Key of the action to execute (must target the same entity). */
+  action: string;
+  /**
+   * REQUIRED when `trigger` is `scheduled` (and MUST be absent otherwise): the
+   * action runs against every record of the entity every `everyMinutes`
+   * minutes (integer 1..44640). Server-validated at publish.
+   */
+  schedule?: { everyMinutes: number };
+}

package/src/app-definition/lib/component.ts

@@ -0,0 +1,48 @@
+/**
+ * Custom-UI code component — the ADDITIVE Wave-12 extension to the App Forge
+ * declarative definition (plan `runtime-app-platform.md` Wave 12 / D19). A page
+ * or widget MAY carry a `component: { kind: 'code', source }` to render an
+ * author-written UI component INSTEAD of the generic declarative renderer.
+ *
+ * This surface is the SHAPE contract only — the closed `AppComponentKind` enum
+ * plus the plain {@link AppCodeComponent} interface shared, byte-identically,
+ * by the app-forge server (whose zod schema validates it) and the App Forge web
+ * renderer (which draws it). The COMPILE step (server-side esbuild against a
+ * pinned `@xemahq/app-ui`, the SRI'd ESM chunk, and the opaque-origin iframe
+ * runtime) is NOT part of this contract — it is the large multi-wave runtime the
+ * plan defers. Declaring a code component is additive: an absent `component`
+ * (the default on every page/widget today) preserves the current declarative
+ * behavior exactly.
+ *
+ * **Cost is not free and the platform must say so.** The moment a definition
+ * carries a code component, publishing it means COMPILING it, and the app stops
+ * being live-on-keystroke (plan Wave 12). Until the compiler + iframe runtime
+ * ship, the app-forge publish path FAILS CLOSED on any definition containing a
+ * code component (`APP_CUSTOM_UI_NOT_YET_AVAILABLE`) — it never silently accepts
+ * or ignores one.
+ */
+
+/**
+ * Closed set of custom-UI component kinds. Only `code` exists — a
+ * server-compiled, author-authored component. A future non-code kind (e.g. a
+ * pinned marketplace component) is a one-line addition here plus a matching
+ * discriminated variant. Stable wire string; never compare against a free-form
+ * string.
+ */
+export enum AppComponentKind {
+  /** An author-written UI component, compiled server-side against `@xemahq/app-ui`. */
+  Code = 'code',
+}
+
+/**
+ * A `kind: 'code'` custom-UI component authored against the pinned
+ * `@xemahq/app-ui` surface. `source` is the raw component module text; it is
+ * validated (length-bounded) and — once the compiler ships — type-checked and
+ * responsive-linted at PUBLISH time, never at author-keystroke time. Carried
+ * inside the opaque app-definition JSON on a page or widget.
+ */
+export interface AppCodeComponent {
+  readonly kind: AppComponentKind.Code;
+  /** The raw component module source authored against `@xemahq/app-ui`. */
+  readonly source: string;
+}

package/src/app-definition/lib/data-mode.ts

@@ -0,0 +1,17 @@
+/**
+ * `AppDataMode` — how an entity's data plane is provisioned per channel. Closed
+ * set; an entity omitting it defaults to {@link AppDataMode.Owned}. Referenced
+ * by the app-forge server's zod schema (`z.enum(AppDataMode)`); the
+ * `resolveDataMode` helper and the `AppDataModeSchema` stay in the server.
+ *
+ * - `None`      — provision NO records at all.
+ * - `Owned`     — the app owns the rows (the default); preview provisioning
+ *                 generates synthetic rows for it.
+ * - `Annotated` — owned rows that also carry provenance/annotation; preview
+ *                 provisioning generates synthetic rows and marks them synthetic.
+ */
+export enum AppDataMode {
+  None = 'none',
+  Owned = 'owned',
+  Annotated = 'annotated',
+}

package/src/app-definition/lib/definition.ts

@@ -0,0 +1,113 @@
+/**
+ * The declarative App Forge definition VIEW MODELS — the plain, renderer-facing
+ * interfaces the App Forge web biome interprets from the opaque app-definition
+ * JSON, plus the top-level {@link AppDefinition} shape.
+ *
+ * These are the SHAPE contract shared with the frontend; the app-forge server's
+ * zod schemas (validation, `superRefine`, and the richer zod-inferred `*Def`
+ * types carrying authorization sub-shapes) stay server-side and are NOT mirrored
+ * here. This surface carries only the closed enums and the plain interfaces the
+ * renderer needs.
+ */
+import { AppFieldType } from './field-type';
+import { AppPageKind } from './page-kind';
+import { AppAction } from './action';
+import { AppAutomation } from './automation';
+import { AppWidget } from './widget';
+import { AppCodeComponent } from './component';
+
+/**
+ * One entity field. `object`/`list` fields carry a recursive nested `fields[]`
+ * item shape; `list` additionally carries `minItems`/`maxItems` count bounds.
+ */
+export interface AppField {
+  key: string;
+  label: string;
+  type: AppFieldType;
+  required?: boolean;
+  /** Only for `type: AppFieldType.Enum`. */
+  enumValues?: string[];
+  /** Only for `type: AppFieldType.Reference` — key of the target entity. */
+  referenceEntity?: string;
+  /**
+   * Nested item shape — the typed sub-fields of an `object` field or of each
+   * item of a `list`. Present iff `type` is `object` or `list`; recursive.
+   */
+  fields?: AppField[];
+  /** `list` only: minimum item count. */
+  minItems?: number;
+  /** `list` only: maximum item count. */
+  maxItems?: number;
+}
+
+export interface AppEntity {
+  key: string;
+  label: string;
+  fields: AppField[];
+}
+
+/**
+ * A Form-page SECTION: a pure LAYOUT grouping over the page's field keys.
+ * `fieldKeys` names entity fields rendered together under `title` (in order); it
+ * is presentation metadata ONLY and changes no storage. A field may appear in at
+ * most one section; fields in no section render ungrouped.
+ */
+export interface AppSection {
+  key: string;
+  title: string;
+  description?: string;
+  fieldKeys: string[];
+}
+
+export interface AppPage {
+  slug: string;
+  title: string;
+  kind: AppPageKind;
+  /** Bound entity for list/form/detail/timeline pages. */
+  entityKey?: string;
+  /** list: subset of field keys shown as columns. */
+  columns?: string[];
+  /** form: subset of field keys included in the form. */
+  fields?: string[];
+  /** form: optional section layout grouping the page's fields. */
+  sections?: AppSection[];
+  /** dashboard: widgets rendered from the widget-data endpoint. */
+  widgets?: AppWidget[];
+  /** timeline: the declared date/datetime field records are ordered by (desc). */
+  dateField?: string;
+  /** related: key of the {@link AppLink} this page reverse-looks-up. */
+  linkKey?: string;
+  /**
+   * Custom-UI (Wave 12): an author-written code component that renders this page
+   * INSTEAD of the generic declarative renderer. Additive — absent ⇒ the page
+   * renders declaratively (today's behavior). A definition carrying any code
+   * component is compile-gated at publish (see {@link AppCodeComponent}).
+   */
+  component?: AppCodeComponent;
+}
+
+/**
+ * An INTRA-APP link: `fromEntity.refField` is a `reference` to `toEntity`. A
+ * `related` page on a detail of `toEntity` reverse-looks-up the `fromEntity`
+ * records whose `refField` equals the subject record's id. The lookup runs
+ * SERVER-SIDE, so the row policy always applies. Cross-owner links are NOT this
+ * shape.
+ */
+export interface AppLink {
+  key: string;
+  fromEntity: string;
+  refField: string;
+  toEntity: string;
+}
+
+/** The declarative app definition — purely renderer-interpreted, no scripting. */
+export interface AppDefinition {
+  entities: AppEntity[];
+  pages: AppPage[];
+  /** Ordered page slugs shown in the app's navigation. */
+  navigation: string[];
+  actions?: AppAction[];
+  automations?: AppAutomation[];
+  /** Intra-app relationships a `related` page reverse-looks-up. */
+  links?: AppLink[];
+}

package/src/app-definition/lib/field-type.ts

@@ -0,0 +1,34 @@
+/**
+ * Closed set of field types a declarative app entity supports. This is the
+ * single source of truth for BOTH the app-forge server (whose zod validation
+ * references it via `z.enum(AppFieldType)`) and the App Forge web renderer
+ * (whose view models type `AppField.type` with it). The values are stable wire
+ * strings that appear inside the opaque app-definition JSON — never compare
+ * against a free-form string.
+ */
+export enum AppFieldType {
+  String = 'string',
+  Text = 'text',
+  /** Binary-float money-UNSAFE number → `DOUBLE PRECISION`. */
+  Number = 'number',
+  /** Exact fixed-point number (money-safe) → `NUMERIC(38,9)`. */
+  Decimal = 'decimal',
+  Boolean = 'boolean',
+  Date = 'date',
+  DateTime = 'datetime',
+  Enum = 'enum',
+  Reference = 'reference',
+  /** A subject id (e.g. `user:<id>`) → `TEXT` holding the ref. */
+  User = 'user',
+  /**
+   * A nested, embedded object — a fixed set of typed sub-fields stored inline in
+   * ONE record. Maps to a `JSONB` column; requires a `fields[]` sub-schema.
+   */
+  Object = 'object',
+  /**
+   * A REPEATABLE list of typed objects — an array of `Object`-shaped items stored
+   * inline in ONE record. Requires a `fields[]` item sub-schema; carries an
+   * optional `minItems`/`maxItems` count bound. Maps to a `JSONB` column.
+   */
+  List = 'list',
+}

package/src/app-definition/lib/page-kind.ts

@@ -0,0 +1,24 @@
+/**
+ * Closed set of page kinds the generic App Forge renderer knows how to draw.
+ * Lives inside the opaque app-definition JSON; shared by the server's zod
+ * schema and the web renderer's `AppPage.kind` view model. Stable wire strings.
+ */
+export enum AppPageKind {
+  List = 'list',
+  Form = 'form',
+  Detail = 'detail',
+  Dashboard = 'dashboard',
+  /**
+   * A chronological view of ONE entity's records ordered by a declared
+   * `date`/`datetime` field (desc by default), sorted SERVER-SIDE inside the
+   * authorization fence.
+   */
+  Timeline = 'timeline',
+  /**
+   * A reverse-reference view: on a detail context (a record of entity A), the
+   * records of entity B that REFERENCE that record through a declared link. The
+   * lookup is a server-side `eq` filter on the ref field, permission-filtered by
+   * the row policy.
+   */
+  Related = 'related',
+}

package/src/app-definition/lib/widget.ts

@@ -0,0 +1,105 @@
+/**
+ * Dashboard-widget closed vocabulary + the widget view models the App Forge
+ * renderer interprets from the opaque app-definition JSON. Shared by the
+ * app-forge server's zod schema and the web renderer. All values are stable
+ * wire strings — never compare against a free-form string.
+ */
+import { AppCodeComponent } from './component';
+
+/** Closed set of dashboard widget kinds. */
+export enum AppWidgetKind {
+  Stat = 'stat',
+  Table = 'table',
+  /**
+   * A chart of a server-side group-by SERIES. Its render shape is a chart
+   * ({@link AppChartType}); its data source is an {@link AppWidgetSeriesSource}
+   * group-by aggregation resolved INSIDE the authorization fence.
+   */
+  Chart = 'chart',
+}
+
+/**
+ * Closed discriminator for a widget's DATA SOURCE. A widget draws from an
+ * ENTITY (a server-side count over the app's own store), a CAPABILITY (a
+ * governed capability query), or a SERIES (an entity group-by → a chart).
+ * Exactly one.
+ */
+export enum AppWidgetSourceKind {
+  Entity = 'entity',
+  Capability = 'capability',
+  Series = 'series',
+}
+
+/** Closed set of server-side entity-widget aggregations (phase 1: count only). */
+export enum AppWidgetAggregate {
+  Count = 'count',
+}
+
+/**
+ * Closed set of chart render shapes a series (chart) widget may declare. Maps
+ * 1:1 onto the kernel `@xemahq/ui-kernel/ui` chart primitives (BarChart /
+ * LineChart / DonutChart).
+ */
+export enum AppChartType {
+  Bar = 'bar',
+  Line = 'line',
+  Donut = 'donut',
+}
+
+/**
+ * Closed set of series (group-by) aggregation measures. `count` counts the
+ * policy-visible rows per group; `sum` sums a numeric/decimal field per group.
+ */
+export enum AppSeriesAggregateKind {
+  Count = 'count',
+  Sum = 'sum',
+}
+
+/**
+ * A series (chart) widget's group-by aggregation. `count` counts the
+ * policy-visible rows per group; `sum` sums a numeric field per group.
+ */
+export type AppSeriesAggregate =
+  | { kind: AppSeriesAggregateKind.Count }
+  | { kind: AppSeriesAggregateKind.Sum; field: string };
+
+/**
+ * The SERIES source of a chart widget: a server-side group-by aggregation over
+ * an entity, resolved inside the authorization fence. Lives inside the opaque
+ * definition JSON.
+ */
+export interface AppWidgetSeriesSource {
+  entityKey: string;
+  /** The field whose distinct values become the chart buckets. */
+  groupBy: string;
+  aggregate: AppSeriesAggregate;
+  chartType: AppChartType;
+}
+
+/**
+ * One dashboard widget as authored in the definition. Exactly one data source:
+ * an entity source (`entityKey` + optional `aggregate`/`filter`), a capability
+ * source (out of the renderer view model — resolved server-side), or a series
+ * source (`series`, rendered as a chart).
+ */
+export interface AppWidget {
+  kind: AppWidgetKind;
+  title: string;
+  /**
+   * Entity source — present for stat/table widgets. Absent for a chart widget
+   * (whose entity lives on {@link series}) and a capability widget.
+   */
+  entityKey?: string;
+  aggregate?: AppWidgetAggregate;
+  /** Simple equals filter: field key → required value. */
+  filter?: Record<string, string | number | boolean>;
+  /** Series (chart) source — present iff `kind === AppWidgetKind.Chart`. */
+  series?: AppWidgetSeriesSource;
+  /**
+   * Custom-UI (Wave 12): an author-written code component that renders this
+   * widget INSTEAD of the generic declarative widget renderer. Additive — absent
+   * ⇒ the widget renders declaratively (today's behavior). Compile-gated at
+   * publish (see {@link AppCodeComponent}).
+   */
+  component?: AppCodeComponent;
+}