spine-framework 0.1.0

package/dist/functions/triggers.d.ts

@@ -0,0 +1,203 @@
+/**
+ * @module triggers
+ * @audience core-contributor
+ * @layer api-handler
+ * @stability stable
+ *
+ * CRUD API for the `triggers` table, plus execution history access.
+ * Triggers bind event types to pipelines. When an event fires, the trigger
+ * engine evaluates active triggers via `_shared/trigger-engine.ts`.
+ *
+ * **Routed by:** `GET/POST/PATCH/DELETE /.netlify/functions/triggers`
+ *
+ * **Actions:**
+ * | method | ?action    | handler       |
+ * |--------|------------|---------------|
+ * | GET    | by-event   | listByEvent   |
+ * | GET    | executions | getExecutions |
+ * | POST   | toggle     | toggle        |
+ * | GET    | ?id        | get           |
+ * | GET    | (default)  | list          |
+ * | POST   | —          | create        |
+ * | PATCH  | —          | update        |
+ * | DELETE | —          | remove (soft) |
+ *
+ * **Authorization:** `create` requires system admin OR first-surface `canCreate`
+ * permission. All other operations use `ctx.db` RLS.
+ *
+ * Also exports `AGENT_EVENT_TYPES` constant and `getAgentEventTypes()` helper
+ * for referencing well-known agent event slugs in trigger configuration.
+ *
+ * @seeAlso trigger-engine.ts (checkAndFireTriggers — runtime evaluation)
+ * @seeAlso pipelines.ts (pipeline_id FK on triggers)
+ * @seeAlso audit.ts (emitLog for trigger.* events)
+ */
+/**
+ * Well-known agent event type slugs for use in trigger `event_type` config.
+ * These are emitted by `agent-runner.ts` during inference, tool dispatch,
+ * and escalation workflows.
+ */
+export declare const AGENT_EVENT_TYPES: {
+    readonly INFERENCE_COMPLETED: "agent.inference.completed";
+    readonly INFERENCE_FAILED: "agent.inference.failed";
+    readonly LOW_CONFIDENCE: "agent.inference.low_confidence";
+    readonly TOOL_CALLED: "agent.tool.called";
+    readonly TOOL_COMPLETED: "agent.tool.completed";
+    readonly TOOL_FAILED: "agent.tool.failed";
+    readonly MESSAGE_RECEIVED: "agent.message.received";
+    readonly MESSAGE_SENT: "agent.message.sent";
+    readonly THREAD_CREATED: "agent.thread.created";
+    readonly ESCALATION_TRIGGERED: "agent.escalation.triggered";
+    readonly ESCALATION_RESOLVED: "agent.escalation.resolved";
+    readonly HUMAN_HANDOFF: "agent.human.handoff";
+};
+/**
+ * @chunk-id    TRIGGERS_GET_AGENT_EVENT_TYPES_1_0_0
+ * @version     1.0.0
+ * @hash        ef90bc655886f31a4417d82b5bac35cfece4ba4e03770d71a449fc36e4cecb24
+ * @macro       Agent Event Types Helper
+ * @micro       Returns array of all agent event type slugs for UI dropdowns
+ * @inputs      None
+ * @outputs     string[] — All AGENT_EVENT_TYPES values
+ * @depends-on  [AGENT_EVENT_TYPES constant]
+ * @depended-by [UI components, trigger configuration forms]
+ * @side-effects [None]
+ * @tags        triggers, helper, event-types, ui
+ */
+export declare function getAgentEventTypes(): string[];
+/**
+ * @chunk-id    TRIGGERS_LIST_BY_EVENT_1_0_0
+ * @version     1.0.0
+ * @hash        c6d2127dc2ced6d0618b338d227d8823b699b86977fc14ce455a27a29a2b1fa5
+ * @macro       Triggers by Event List Handler
+ * @micro       Lists triggers filtered by event type with sanitization
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: any — Request body (unused for GET)
+ * @outputs     Array of sanitized trigger records with app/createdBy joins
+ * @depends-on  [createHandler, joins, sanitizeRecordData]
+ * @depended-by [Netlify function routing]
+ * @side-effects [DB queries, permission sanitization]
+ * @tags        triggers, list, event-type, crud
+ */
+export declare const listByEvent: (event: any, context: any) => Promise<any>;
+/**
+ * @chunk-id    TRIGGERS_LIST_1_0_0
+ * @version     1.0.0
+ * @hash        b65a861b2a1b7c63a6a2bbe395dfb6138fe00e0517a0eb40f012c2317fbcf45f
+ * @macro       Triggers List Handler
+ * @micro       Lists triggers with filtering and sanitization
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: any — Request body (unused for GET)
+ * @outputs     Array of sanitized trigger records with app/createdBy joins
+ * @depends-on  [createHandler, joins, sanitizeRecordData]
+ * @depended-by [Netlify function routing]
+ * @side-effects [DB queries, permission sanitization]
+ * @tags        triggers, list, crud, filtering
+ */
+export declare const list: (event: any, context: any) => Promise<any>;
+/**
+ * @chunk-id    TRIGGERS_GET_1_0_0
+ * @version     1.0.0
+ * @hash        106ae81cd0528145f976f7c8e0cc16cacaf32468d0e2950a16b8f167bb88143d
+ * @macro       Trigger Get Handler
+ * @micro       Returns single trigger record with joins and sanitization
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: any — Request body (unused for GET)
+ * @outputs     Sanitized trigger record with app/createdBy joins
+ * @depends-on  [createHandler, joins, sanitizeRecordData]
+ * @depended-by [Netlify function routing]
+ * @side-effects [DB single row query, permission sanitization]
+ * @tags        triggers, get, crud, single-record
+ */
+export declare const get: (event: any, context: any) => Promise<any>;
+/**
+ * @chunk-id    TRIGGERS_CREATE_1_0_0
+ * @version     1.0.0
+ * @hash        4411a0111e10158d29446e4b989fbccaf1e55057b4f809129eed33f93ee21901
+ * @macro       Trigger Create Handler
+ * @micro       Creates trigger with permission validation and audit logging
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: object — Trigger data including name, trigger_type, and optional fields
+ * @outputs     Inserted trigger record
+ * @depends-on  [createHandler, PermissionEngine, emitLog]
+ * @depended-by [Netlify function routing]
+ * @side-effects [DB insert, permission validation, audit logging]
+ * @tags        triggers, create, crud, permissions, audit
+ */
+export declare const create: (event: any, context: any) => Promise<any>;
+/**
+ * @chunk-id    TRIGGERS_UPDATE_1_0_0
+ * @version     1.0.0
+ * @hash        8c7ee9556f7e18c9b63746baaf49ae73a4526735227a828bc77aaf518d4796fb
+ * @macro       Trigger Update Handler
+ * @micro       Updates trigger with audit logging and before/after state
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: object — Trigger updates including id and updatable fields
+ * @outputs     Updated trigger record
+ * @depends-on  [createHandler, emitLog]
+ * @depended-by [Netlify function routing]
+ * @side-effects [DB update, audit logging]
+ * @tags        triggers, update, crud, audit
+ */
+export declare const update: (event: any, context: any) => Promise<any>;
+/**
+ * @chunk-id    TRIGGERS_REMOVE_1_0_0
+ * @version     1.0.0
+ * @hash        d25952bb0f5bcd15fb5272f6d54a975b8a0f1cc6b85bc514b0e91df2fcb35ad5
+ * @macro       Trigger Remove Handler
+ * @micro       Soft-deletes trigger with audit logging and before/after state
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: object — Trigger id for deletion
+ * @outputs     Updated trigger record with is_active: false
+ * @depends-on  [createHandler, emitLog]
+ * @depended-by [Netlify function routing]
+ * @side-effects [DB soft delete, audit logging]
+ * @tags        triggers, remove, soft-delete, audit
+ */
+export declare const remove: (event: any, context: any) => Promise<any>;
+/**
+ * @chunk-id    TRIGGERS_TOGGLE_1_0_0
+ * @version     1.0.0
+ * @hash        56add34659ac69c93b3570eb63f3bc3072d6a15083f79eaa7a9926f40f275373
+ * @macro       Trigger Toggle Handler
+ * @micro       Activates or deactivates trigger with audit logging
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: object — Trigger id and is_active boolean
+ * @outputs     Updated trigger record
+ * @depends-on  [createHandler, emitLog]
+ * @depended-by [Netlify function routing]
+ * @side-effects [DB update, audit logging]
+ * @tags        triggers, toggle, state-transition, audit
+ */
+export declare const toggle: (event: any, context: any) => Promise<any>;
+/**
+ * @chunk-id    TRIGGERS_GET_EXECUTIONS_1_0_0
+ * @version     1.0.0
+ * @hash        cf649749d76cd4d5909f96eb9193fd791f30f1e6268e1a0e6cb35ee4676d3071
+ * @macro       Trigger Executions Handler
+ * @micro       Returns paginated execution history for a trigger
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: any — Request body (unused for GET)
+ * @outputs     Array of trigger_executions rows ordered by triggered_at desc
+ * @depends-on  [createHandler]
+ * @depended-by [Netlify function routing]
+ * @side-effects [DB queries, pagination]
+ * @tags        triggers, executions, history, pagination
+ */
+export declare const getExecutions: (event: any, context: any) => Promise<any>;
+/**
+ * @chunk-id    TRIGGERS_HANDLER_1_0_0
+ * @version     1.0.0
+ * @hash        4efc53a8d92acf3346a939c519e3fbd0d64be57f4ee65a81ee213c5aba24e2ce
+ * @macro       Triggers Router
+ * @micro       Routes HTTP methods and actions to appropriate trigger handlers
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: any — Request body for POST/PATCH/DELETE operations
+ * @outputs     Varies — Depends on routed handler (listByEvent/getExecutions/toggle/list/get/create/update/remove)
+ * @depends-on  [createHandler, listByEvent, getExecutions, toggle, list, get, create, update, remove]
+ * @depended-by [Netlify function routing]
+ * @side-effects [Delegates to appropriate handler]
+ * @tags        triggers, router, crud, netlify-function
+ */
+export declare const handler: (event: any, context: any) => Promise<any>;
+//# sourceMappingURL=triggers.d.ts.map

package/dist/functions/triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../../.framework/functions/triggers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAWH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;CAoBpB,CAAA;AAGV;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C;AAMD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,4CAmCtB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,IAAI,4CAkCf,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,GAAG,4CAiBd,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM,4CAmDjB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM,4CAiDjB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM,4CAwCjB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM,4CAyBjB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,4CAoBxB,CAAA;AAMF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,OAAO,4CAqClB,CAAA"}

package/dist/functions/types.d.ts

@@ -0,0 +1,151 @@
+/**
+ * @module types
+ * @audience core-contributor
+ * @layer api-handler
+ * @stability stable
+ *
+ * CRUD API for the `types` table. Types are the schema configuration objects
+ * that define `design_schema`, `validation_schema`, field definitions, and
+ * view configurations for runtime entities (`items`, `people`, `accounts`).
+ *
+ * **Routed by:** `GET/POST/PATCH/DELETE /.netlify/functions/types`
+ *
+ * **Authorization model:**
+ * - All reads use `ctx.db` (RLS-scoped) and are sanitized via `sanitizeRecordData`.
+ * - All writes (`create`, `update`, `remove`) require `isSystemAdmin` AND the
+ *   caller's account must be a master tenant (`accounts.parent_id IS NULL`).
+ * - Unauthenticated `list` calls receive minimal fields only (id, slug, name, kind).
+ *
+ * **Design schema auto-sync:** `update` regenerates `validation_schema` automatically
+ * via `generateValidationSchema` whenever `design_schema` changes.
+ *
+ * INVARIANT: type slugs must be unique per (kind, app_id) combination.
+ * INVARIANT: `ownership` of system types cannot be changed (to prevent constraint violations).
+ * INVARIANT: `app_id = null` for system types; must be provided for app/tenant types.
+ *
+ * @seeAlso middleware.ts (createHandler, CoreContext)
+ * @seeAlso permissions.ts (PermissionEngine, sanitizeRecordData, validateUpdatePermissions)
+ * @seeAlso schema-utils.ts (generateValidationSchema — auto-called on design_schema updates)
+ * @seeAlso audit.ts (emitLog for type.created / type.updated / type.deleted)
+ */
+/**
+ * @chunk-id    TYPES_LIST_1_0_0
+ * @version     1.0.0
+ * @hash        0cfcf45a5a70d17002599b77e1c45bf7d3de456bc474e68a89ff44069d711b91
+ * @macro       Types List Handler
+ * @micro       Lists types with filtering, authentication-based response, and sanitization
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: any — Request body (unused for GET)
+ * @outputs     Array of type records with app join, sanitized and schema-aware
+ * @depends-on  [createHandler, joins, sanitizeRecordData]
+ * @depended-by [Netlify function routing]
+ * @side-effects [DB queries, permission sanitization, schema preservation]
+ * @tags        types, list, crud, filtering, authentication
+ */
+export declare const list: (event: any, context: any) => Promise<any>;
+/**
+ * @chunk-id    TYPES_GET_1_0_0
+ * @version     1.0.0
+ * @hash        435ff5a93d05f74e0299b515d32f50ceb5c526b517a6972ef65c3bdaa75c218f
+ * @macro       Type Get Handler
+ * @micro       Returns single type record with joins and sanitization
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: any — Request body (unused for GET)
+ * @outputs     Sanitized type record with app join
+ * @depends-on  [createHandler, joins, sanitizeRecordData]
+ * @depended-by [Netlify function routing]
+ * @side-effects [DB single row query, permission sanitization]
+ * @tags        types, get, crud, single-record
+ */
+export declare const get: (event: any, context: any) => Promise<any>;
+/**
+ * @chunk-id    TYPES_GET_BY_SLUG_1_0_0
+ * @version     1.0.0
+ * @hash        6585200f3ecdef92e2912849afd5d72a3968fe13b464cdf43f33a888edda4163
+ * @macro       Type Get By Slug Handler
+ * @micro       Returns single type record by slug with joins and sanitization
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: any — Request body (unused for GET)
+ * @outputs     Sanitized type record with app join
+ * @depends-on  [createHandler, joins, sanitizeRecordData]
+ * @depended-by [Netlify function routing]
+ * @side-effects [DB single row query, permission sanitization]
+ * @tags        types, get, crud, single-record, slug
+ */
+export declare const getBySlug: (event: any, context: any) => Promise<any>;
+/**
+ * @chunk-id    TYPES_GET_SCHEMA_1_0_0
+ * @version     1.0.0
+ * @hash        2cff73f363bb53c145d64b5b2fc788de592a94321000425f6b2ab82489c9a1e4
+ * @macro       Type Schema Handler
+ * @micro       Returns design_schema for a type via RPC
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: any — Request body (unused for GET)
+ * @outputs     {design_schema: object} — Type design schema
+ * @depends-on  [createHandler]
+ * @depended-by [Netlify function routing]
+ * @side-effects [DB RPC call, RLS enforcement]
+ * @tags        types, schema, rpc, design-schema
+ */
+export declare const getSchema: (event: any, context: any) => Promise<any>;
+/**
+ * @chunk-id    TYPES_CREATE_1_0_0
+ * @version     1.0.0
+ * @hash        c226d40910e332c0c89bfbb0d09f2b6a04b45a0a104c70d485ebd08c2c07cbe0
+ * @macro       Type Create Handler
+ * @micro       Creates type with system admin validation, schema generation, and audit logging
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: object — Type data including kind, slug, name, and optional fields
+ * @outputs     Inserted type record
+ * @depends-on  [createHandler, adminDb, permissions, generateValidationSchema, emitLog]
+ * @depended-by [Netlify function routing]
+ * @side-effects [DB insert, master tenant validation, schema generation, audit logging]
+ * @tags        types, create, crud, system-admin, schema-generation, audit
+ */
+export declare const create: (event: any, context: any) => Promise<any>;
+/**
+ * @chunk-id    TYPES_UPDATE_1_0_0
+ * @version     1.0.0
+ * @hash        7778ce63ecc3dd50fe50680c4f1199a59db4c4dae734cf7a2d58cc2de76b9a6a
+ * @macro       Type Update Handler
+ * @micro       Updates type with validation, schema regeneration, and audit logging
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: object — Type updates including id and updatable fields
+ * @outputs     Updated type record
+ * @depends-on  [createHandler, adminDb, permissions, generateValidationSchema, emitLog]
+ * @depended-by [Netlify function routing]
+ * @side-effects [DB update, field validation, schema regeneration, audit logging]
+ * @tags        types, update, crud, system-admin, schema-generation, audit
+ */
+export declare const update: (event: any, context: any) => Promise<any>;
+/**
+ * @chunk-id    TYPES_REMOVE_1_0_0
+ * @version     1.0.0
+ * @hash        eef22a9e3f661c71c65ba5d69ce7e60c2c2bfccec986ad2309290217f5332455
+ * @macro       Type Remove Handler
+ * @micro       Soft-deletes type with system admin validation and audit logging
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: object — Type id for deletion
+ * @outputs     Updated type record with is_active: false
+ * @depends-on  [createHandler, adminDb, permissions, emitLog]
+ * @depended-by [Netlify function routing]
+ * @side-effects [DB soft delete, master tenant validation, audit logging]
+ * @tags        types, remove, soft-delete, system-admin, audit
+ */
+export declare const remove: (event: any, context: any) => Promise<any>;
+/**
+ * @chunk-id    TYPES_HANDLER_1_0_0
+ * @version     1.0.0
+ * @hash        70e9e120f669468bd7aa45d7a2b8b4cf9a13a2323f897a6fc2bd389d960f8adc
+ * @macro       Types Router
+ * @micro       Routes HTTP methods and actions to appropriate type handlers
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: any — Request body for POST/PATCH/DELETE operations
+ * @outputs     Varies — Depends on routed handler (list/get/getBySlug/getSchema/create/update/remove)
+ * @depends-on  [createHandler, list, get, getBySlug, getSchema, create, update, remove]
+ * @depended-by [Netlify function routing]
+ * @side-effects [Delegates to appropriate handler]
+ * @tags        types, router, crud, netlify-function
+ */
+export declare const handler: (event: any, context: any) => Promise<any>;
+//# sourceMappingURL=types.d.ts.map

package/dist/functions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../.framework/functions/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAaH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,IAAI,4CAgEf,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,GAAG,4CAkBd,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,SAAS,4CAkBpB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,SAAS,4CAiBpB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM,4CAoGjB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM,4CA2GjB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM,4CAsEjB,CAAA;AAMF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,OAAO,4CAwBlB,CAAA"}