@proteos/sdk 0.49.0 → 0.51.0

package/src/meta/types.ts

@@ -994,7 +994,6 @@ export interface List extends AuditFields {
   /** Row-selection affordance; absent normalizes to `on_demand`. */
   selection_mode?: SelectionMode
   /** Record page to open from this list; empty/absent = org default for the entity. */
-  default_page_slug?: string
   sorting: SortConfig[]
   filters: FilterGroup[]
 }
@@ -1018,7 +1017,6 @@ export const ListSchema = AuditFieldsSchema.extend({
   columns: z.array(ColumnSchema),
   actions: z.array(PageActionSchema).optional(),
   selection_mode: SelectionModeSchema.optional(),
-  default_page_slug: z.string().optional(),
   sorting: z.array(SortConfigSchema),
   filters: z.array(FilterGroupSchema),
 })
@@ -1044,7 +1042,6 @@ export interface CreateListRequest {
   columns: Column[]
   actions?: PageAction[]
   selection_mode?: SelectionMode
-  default_page_slug?: string
   sorting: SortConfig[]
   filters: FilterGroup[]
 }
@@ -1059,7 +1056,6 @@ export interface UpdateListRequest {
   actions?: PageAction[]
   selection_mode?: SelectionMode
   /** Set to '' to clear back to the org default. */
-  default_page_slug?: string
   sorting?: SortConfig[]
   filters?: FilterGroup[]
 }
@@ -1329,6 +1325,100 @@ export interface UpdateMenuConfigurationRequest {
   is_default?: boolean
 }
 
+// ============================================================================
+// AppConfiguration Types
+// ============================================================================
+
+/** What an app opens on: a list (records table) or a platform page. */
+export type AppHomeType = 'list' | 'page'
+
+export interface AppHome {
+  type: AppHomeType
+  reference: string
+}
+
+export const AppHomeSchema = z.object({
+  type: z.enum(['list', 'page']),
+  reference: z.string(),
+})
+
+/**
+ * AppConfiguration — a TYPED binding row: "how app X presents itself" to
+ * everyone (`profile_slug: ''` = the app's default configuration) or to one
+ * profile (an override). One row per (app, profile). The web merges
+ * override ⊕ default field-wise and falls through to structural defaults (menu
+ * `is_default`, first menu leaf, org-default agent, first page) for anything
+ * still unset.
+ */
+export interface AppConfiguration extends AuditFields {
+  slug: string
+  org_id: string
+  module_slug: string
+  app_slug: string
+  /** Bound profile; `''` = the default configuration for everyone. */
+  profile_slug: string
+  /** Home; absent = the first list/page leaf of the resolved menu. */
+  home?: AppHome | null
+  /** Menu to show; `''` = the app's `is_default` menu. */
+  menu_slug?: string
+  /** Agent Ask Proteos preselects in this app; `''` = the org default. */
+  default_agent_key?: string
+  /** Agents offered in this app; empty = every org agent. */
+  agent_keys?: string[]
+  /** entity_slug → record page slug opened from this app. */
+  record_pages?: Record<string, string>
+}
+
+export const AppConfigurationSchema = AuditFieldsSchema.extend({
+  slug: z.string(),
+  org_id: z.string(),
+  module_slug: z.string(),
+  app_slug: z.string(),
+  profile_slug: z.string(),
+  home: AppHomeSchema.nullable().optional(),
+  menu_slug: z.string().optional(),
+  default_agent_key: z.string().optional(),
+  agent_keys: z.array(z.string()).optional(),
+  record_pages: z.record(z.string()).optional(),
+})
+
+export interface ListAppConfigurationsOptions extends MetaListOptions {
+  slug?: string
+  module_slug?: string
+  app_slug?: string
+  profile_slug?: string
+  /** `true` = only default rows (no profile), `false` = only profile overrides.
+   *  An empty `profile_slug` is never sent, so this is how default rows are
+   *  selected. */
+  is_default?: boolean
+  menu_slug?: string
+}
+
+export interface CreateAppConfigurationRequest {
+  slug: string
+  module_slug?: string
+  app_slug: string
+  profile_slug?: string
+  home?: AppHome | null
+  menu_slug?: string
+  default_agent_key?: string
+  agent_keys?: string[]
+  record_pages?: Record<string, string>
+}
+
+/**
+ * Partial update. `home` is tri-state: absent = unchanged, `null` = clear,
+ * object = set. The (app_slug, profile_slug) binding is immutable.
+ */
+export interface UpdateAppConfigurationRequest {
+  module_slug?: string
+  home?: AppHome | null
+  menu_slug?: string
+  default_agent_key?: string
+  agent_keys?: string[]
+  record_pages?: Record<string, string>
+}
+
 // ============================================================================
 // App Types
 // ============================================================================

package/src/workflow/types.ts

@@ -456,6 +456,8 @@ export interface Workflow extends AuditFields {
   key: string
   name: string
   description: string
+  /** Slug of the module that deployed this workflow; empty when it is org-owned. */
+  module_slug: string
   status: WorkflowStatus
   graph: WorkflowGraph
   version: number
@@ -533,6 +535,15 @@ export interface ListWorkflowsOptions extends ListOptions {
   name?: string
   'name[contains]'?: string
   status?: WorkflowStatus
+  /**
+   * Restrict to one module's workflows. The empty string is meaningful: it
+   * matches only the org-owned workflows no module deployed.
+   *
+   * `sort_by` additionally accepts a comma-separated list of sortable fields
+   * (`module_slug,name`) so a grouped list can order by its grouping column
+   * first; `sort_direction` applies to all of them.
+   */
+  module_slug?: string
 }
 
 // ---------------------------------------------------------------------------
@@ -630,6 +641,8 @@ export interface ExecutionTriggerContext {
 export interface ExecutionError {
   code: string
   message: string
+  /** Machine-readable payload of the node error (a held send's earliest_allowed_at / rule_id, http_status …). */
+  details?: Record<string, unknown>
   /** Marks business failures the user can fix, vs infrastructure faults. */
   is_user_error?: boolean
 }