@ourofoundation/ouro-js 3.2.5 → 3.4.0

package/dist/schema/datasets.d.ts

@@ -209,14 +209,14 @@ declare const DatasetSchema: z.ZodObject<{
     stripe_meter_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     state: z.ZodEnum<{
         success: "success";
-        error: "error";
         queued: "queued";
         "in-progress": "in-progress";
         "timed-out": "timed-out";
+        error: "error";
     }>;
     source: z.ZodEnum<{
-        web: "web";
         api: "api";
+        web: "web";
     }>;
     created_at: z.ZodString;
     last_updated: z.ZodString;
@@ -251,15 +251,15 @@ declare const DatasetSchema: z.ZodObject<{
 }, z.core.$strip>;
 declare const CreateDatasetFromFileSchema: z.ZodPipe<z.ZodObject<{
     parent: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+    description: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        json: z.ZodRecord<z.ZodString, z.ZodAny>;
+        text: z.ZodString;
+    }, z.core.$strip>>>>;
     monetization: z.ZodOptional<z.ZodEnum<{
         none: "none";
         "pay-to-unlock": "pay-to-unlock";
         "pay-per-use": "pay-per-use";
     }>>;
-    description: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        json: z.ZodRecord<z.ZodString, z.ZodAny>;
-        text: z.ZodString;
-    }, z.core.$strip>>>>;
     parent_id: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodUUID>>>;
     license_id: z.ZodOptional<z.ZodString>;
     price: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
@@ -283,14 +283,14 @@ declare const CreateDatasetFromFileSchema: z.ZodPipe<z.ZodObject<{
     name_url_slug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     state: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
         success: "success";
-        error: "error";
         queued: "queued";
         "in-progress": "in-progress";
         "timed-out": "timed-out";
+        error: "error";
     }>>>;
     source: z.ZodDefault<z.ZodEnum<{
-        web: "web";
         api: "api";
+        web: "web";
     }>>;
     visibility: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
         organization: "organization";
@@ -334,8 +334,8 @@ declare const CreateDatasetFromFileSchema: z.ZodPipe<z.ZodObject<{
     team_id: string | null;
     org_id: string | null;
     name: string;
-    state: "success" | "error" | "queued" | "in-progress" | "timed-out";
-    source: "web" | "api";
+    state: "success" | "queued" | "in-progress" | "timed-out" | "error";
+    source: "api" | "web";
     visibility: "organization" | "public" | "private" | "monetized" | "inherit";
     created_at: string;
     last_updated: string;
@@ -361,11 +361,11 @@ declare const CreateDatasetFromFileSchema: z.ZodPipe<z.ZodObject<{
     };
     preview: Record<string, any>[];
     parent?: Record<string, any> | undefined;
-    monetization?: "none" | "pay-to-unlock" | "pay-per-use" | undefined;
     description?: {
         json: Record<string, any>;
         text: string;
     } | null | undefined;
+    monetization?: "none" | "pay-to-unlock" | "pay-per-use" | undefined;
     parent_id?: string | null | undefined;
     license_id?: string | undefined;
     price?: number | null | undefined;
@@ -382,8 +382,8 @@ declare const CreateDatasetFromFileSchema: z.ZodPipe<z.ZodObject<{
     team_id: string | null;
     org_id: string | null;
     name: string;
-    state: "success" | "error" | "queued" | "in-progress" | "timed-out";
-    source: "web" | "api";
+    state: "success" | "queued" | "in-progress" | "timed-out" | "error";
+    source: "api" | "web";
     visibility: "organization" | "public" | "private" | "monetized" | "inherit";
     created_at: string;
     last_updated: string;
@@ -409,11 +409,11 @@ declare const CreateDatasetFromFileSchema: z.ZodPipe<z.ZodObject<{
     };
     preview: Record<string, any>[];
     parent?: Record<string, any> | undefined;
-    monetization?: "none" | "pay-to-unlock" | "pay-per-use" | undefined;
     description?: {
         json: Record<string, any>;
         text: string;
     } | null | undefined;
+    monetization?: "none" | "pay-to-unlock" | "pay-per-use" | undefined;
     parent_id?: string | null | undefined;
     license_id?: string | undefined;
     price?: number | null | undefined;
@@ -428,15 +428,15 @@ declare const CreateDatasetFromFileSchema: z.ZodPipe<z.ZodObject<{
 }>>;
 declare const CreateDatasetFromSchemaSchema: z.ZodPipe<z.ZodObject<{
     parent: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+    description: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        json: z.ZodRecord<z.ZodString, z.ZodAny>;
+        text: z.ZodString;
+    }, z.core.$strip>>>>;
     monetization: z.ZodOptional<z.ZodEnum<{
         none: "none";
         "pay-to-unlock": "pay-to-unlock";
         "pay-per-use": "pay-per-use";
     }>>;
-    description: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        json: z.ZodRecord<z.ZodString, z.ZodAny>;
-        text: z.ZodString;
-    }, z.core.$strip>>>>;
     parent_id: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodUUID>>>;
     license_id: z.ZodOptional<z.ZodString>;
     price: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
@@ -460,14 +460,14 @@ declare const CreateDatasetFromSchemaSchema: z.ZodPipe<z.ZodObject<{
     name_url_slug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     state: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
         success: "success";
-        error: "error";
         queued: "queued";
         "in-progress": "in-progress";
         "timed-out": "timed-out";
+        error: "error";
     }>>>;
     source: z.ZodDefault<z.ZodEnum<{
-        web: "web";
         api: "api";
+        web: "web";
     }>>;
     visibility: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
         organization: "organization";
@@ -501,8 +501,8 @@ declare const CreateDatasetFromSchemaSchema: z.ZodPipe<z.ZodObject<{
     team_id: string | null;
     org_id: string | null;
     name: string;
-    state: "success" | "error" | "queued" | "in-progress" | "timed-out";
-    source: "web" | "api";
+    state: "success" | "queued" | "in-progress" | "timed-out" | "error";
+    source: "api" | "web";
     visibility: "organization" | "public" | "private" | "monetized" | "inherit";
     created_at: string;
     last_updated: string;
@@ -521,11 +521,11 @@ declare const CreateDatasetFromSchemaSchema: z.ZodPipe<z.ZodObject<{
     };
     preview: Record<string, any>[];
     parent?: Record<string, any> | undefined;
-    monetization?: "none" | "pay-to-unlock" | "pay-per-use" | undefined;
     description?: {
         json: Record<string, any>;
         text: string;
     } | null | undefined;
+    monetization?: "none" | "pay-to-unlock" | "pay-per-use" | undefined;
     parent_id?: string | null | undefined;
     license_id?: string | undefined;
     price?: number | null | undefined;
@@ -542,8 +542,8 @@ declare const CreateDatasetFromSchemaSchema: z.ZodPipe<z.ZodObject<{
     team_id: string | null;
     org_id: string | null;
     name: string;
-    state: "success" | "error" | "queued" | "in-progress" | "timed-out";
-    source: "web" | "api";
+    state: "success" | "queued" | "in-progress" | "timed-out" | "error";
+    source: "api" | "web";
     visibility: "organization" | "public" | "private" | "monetized" | "inherit";
     created_at: string;
     last_updated: string;
@@ -562,11 +562,11 @@ declare const CreateDatasetFromSchemaSchema: z.ZodPipe<z.ZodObject<{
     };
     preview: Record<string, any>[];
     parent?: Record<string, any> | undefined;
-    monetization?: "none" | "pay-to-unlock" | "pay-per-use" | undefined;
     description?: {
         json: Record<string, any>;
         text: string;
     } | null | undefined;
+    monetization?: "none" | "pay-to-unlock" | "pay-per-use" | undefined;
     parent_id?: string | null | undefined;
     license_id?: string | undefined;
     price?: number | null | undefined;
@@ -580,11 +580,36 @@ declare const CreateDatasetFromSchemaSchema: z.ZodPipe<z.ZodObject<{
     name_url_slug?: string | null | undefined;
 }>>;
 declare const updateDatasetSchema: z.ZodPipe<z.ZodObject<{
+    org_id: z.ZodOptional<z.ZodUUID>;
     parent: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>>;
-    source: z.ZodOptional<z.ZodEnum<{
-        web: "web";
-        api: "api";
-    }>>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        table_name: z.ZodString;
+        schema: z.ZodDefault<z.ZodLiteral<"datasets">>;
+        columns: z.ZodArray<z.ZodString>;
+        doi_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        external_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        paper_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        github_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        originality: z.ZodOptional<z.ZodEnum<{
+            original: "original";
+            derivative: "derivative";
+            "third-party": "third-party";
+        }>>;
+        source: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        reply_to_comment_id: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        type: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+        path: z.ZodOptional<z.ZodString>;
+        extension: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodUUID>;
+        bucket: z.ZodOptional<z.ZodEnum<{
+            "public-files": "public-files";
+            files: "files";
+        }>>;
+    }, z.core.$strip>>;
+    name: z.ZodOptional<z.ZodString>;
+    team_id: z.ZodOptional<z.ZodUUID>;
     visibility: z.ZodOptional<z.ZodEnum<{
         organization: "organization";
         public: "public";
@@ -592,6 +617,14 @@ declare const updateDatasetSchema: z.ZodPipe<z.ZodObject<{
         monetized: "monetized";
         inherit: "inherit";
     }>>;
+    description: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        json: z.ZodRecord<z.ZodString, z.ZodAny>;
+        text: z.ZodString;
+    }, z.core.$strip>>>>;
+    source: z.ZodOptional<z.ZodEnum<{
+        api: "api";
+        web: "web";
+    }>>;
     monetization: z.ZodOptional<z.ZodEnum<{
         none: "none";
         "pay-to-unlock": "pay-to-unlock";
@@ -599,18 +632,11 @@ declare const updateDatasetSchema: z.ZodPipe<z.ZodObject<{
     }>>;
     state: z.ZodOptional<z.ZodEnum<{
         success: "success";
-        error: "error";
         queued: "queued";
         "in-progress": "in-progress";
         "timed-out": "timed-out";
+        error: "error";
     }>>;
-    name: z.ZodOptional<z.ZodString>;
-    org_id: z.ZodOptional<z.ZodUUID>;
-    team_id: z.ZodOptional<z.ZodUUID>;
-    description: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        json: z.ZodRecord<z.ZodString, z.ZodAny>;
-        text: z.ZodString;
-    }, z.core.$strip>>>>;
     parent_id: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodUUID>>>;
     license_id: z.ZodOptional<z.ZodString>;
     license: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>>;
@@ -629,62 +655,14 @@ declare const updateDatasetSchema: z.ZodPipe<z.ZodObject<{
     stripe_product_id: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     stripe_price_id: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     stripe_meter_id: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
-    metadata: z.ZodOptional<z.ZodObject<{
-        table_name: z.ZodString;
-        schema: z.ZodDefault<z.ZodLiteral<"datasets">>;
-        columns: z.ZodArray<z.ZodString>;
-        doi_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
-        external_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
-        paper_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
-        github_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
-        originality: z.ZodOptional<z.ZodEnum<{
-            original: "original";
-            derivative: "derivative";
-            "third-party": "third-party";
-        }>>;
-        source: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
-        reply_to_comment_id: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
-        type: z.ZodOptional<z.ZodString>;
-        size: z.ZodOptional<z.ZodNumber>;
-        path: z.ZodOptional<z.ZodString>;
-        extension: z.ZodOptional<z.ZodString>;
-        name: z.ZodOptional<z.ZodString>;
-        id: z.ZodOptional<z.ZodUUID>;
-        bucket: z.ZodOptional<z.ZodEnum<{
-            "public-files": "public-files";
-            files: "files";
-        }>>;
-    }, z.core.$strip>>;
     preview: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>>;
     asset_type: z.ZodDefault<z.ZodLiteral<"dataset">>;
     last_updated: z.ZodDefault<z.ZodString>;
 }, z.core.$strip>, z.ZodTransform<{
     asset_type: "dataset";
     last_updated: string;
-    parent?: Record<string, any> | undefined;
-    source?: "web" | "api" | undefined;
-    visibility?: "organization" | "public" | "private" | "monetized" | "inherit" | undefined;
-    monetization?: "none" | "pay-to-unlock" | "pay-per-use" | undefined;
-    state?: "success" | "error" | "queued" | "in-progress" | "timed-out" | undefined;
-    name?: string | undefined;
     org_id?: string | undefined;
-    team_id?: string | undefined;
-    description?: {
-        json: Record<string, any>;
-        text: string;
-    } | null | undefined;
-    parent_id?: string | null | undefined;
-    license_id?: string | undefined;
-    license?: Record<string, any> | undefined;
-    name_url_slug?: string | null | undefined;
-    price?: number | null | undefined;
-    unit_cost?: number | null | undefined;
-    cost_accounting?: "fixed" | "variable" | null | undefined;
-    cost_unit?: string | null | undefined;
-    price_currency?: "usd" | "btc" | undefined;
-    stripe_product_id?: string | null | undefined;
-    stripe_price_id?: string | null | undefined;
-    stripe_meter_id?: string | null | undefined;
+    parent?: Record<string, any> | undefined;
     metadata?: {
         table_name: string;
         schema: "datasets";
@@ -704,22 +682,16 @@ declare const updateDatasetSchema: z.ZodPipe<z.ZodObject<{
         id?: string | undefined;
         bucket?: "public-files" | "files" | undefined;
     } | undefined;
-    preview?: Record<string, any>[] | undefined;
-}, {
-    asset_type: "dataset";
-    last_updated: string;
-    parent?: Record<string, any> | undefined;
-    source?: "web" | "api" | undefined;
-    visibility?: "organization" | "public" | "private" | "monetized" | "inherit" | undefined;
-    monetization?: "none" | "pay-to-unlock" | "pay-per-use" | undefined;
-    state?: "success" | "error" | "queued" | "in-progress" | "timed-out" | undefined;
     name?: string | undefined;
-    org_id?: string | undefined;
     team_id?: string | undefined;
+    visibility?: "organization" | "public" | "private" | "monetized" | "inherit" | undefined;
     description?: {
         json: Record<string, any>;
         text: string;
     } | null | undefined;
+    source?: "api" | "web" | undefined;
+    monetization?: "none" | "pay-to-unlock" | "pay-per-use" | undefined;
+    state?: "success" | "queued" | "in-progress" | "timed-out" | "error" | undefined;
     parent_id?: string | null | undefined;
     license_id?: string | undefined;
     license?: Record<string, any> | undefined;
@@ -732,6 +704,12 @@ declare const updateDatasetSchema: z.ZodPipe<z.ZodObject<{
     stripe_product_id?: string | null | undefined;
     stripe_price_id?: string | null | undefined;
     stripe_meter_id?: string | null | undefined;
+    preview?: Record<string, any>[] | undefined;
+}, {
+    asset_type: "dataset";
+    last_updated: string;
+    org_id?: string | undefined;
+    parent?: Record<string, any> | undefined;
     metadata?: {
         table_name: string;
         schema: "datasets";
@@ -751,6 +729,28 @@ declare const updateDatasetSchema: z.ZodPipe<z.ZodObject<{
         id?: string | undefined;
         bucket?: "public-files" | "files" | undefined;
     } | undefined;
+    name?: string | undefined;
+    team_id?: string | undefined;
+    visibility?: "organization" | "public" | "private" | "monetized" | "inherit" | undefined;
+    description?: {
+        json: Record<string, any>;
+        text: string;
+    } | null | undefined;
+    source?: "api" | "web" | undefined;
+    monetization?: "none" | "pay-to-unlock" | "pay-per-use" | undefined;
+    state?: "success" | "queued" | "in-progress" | "timed-out" | "error" | undefined;
+    parent_id?: string | null | undefined;
+    license_id?: string | undefined;
+    license?: Record<string, any> | undefined;
+    name_url_slug?: string | null | undefined;
+    price?: number | null | undefined;
+    unit_cost?: number | null | undefined;
+    cost_accounting?: "fixed" | "variable" | null | undefined;
+    cost_unit?: string | null | undefined;
+    price_currency?: "usd" | "btc" | undefined;
+    stripe_product_id?: string | null | undefined;
+    stripe_price_id?: string | null | undefined;
+    stripe_meter_id?: string | null | undefined;
     preview?: Record<string, any>[] | undefined;
 }>>;
 

package/dist/schema/datasets.js

@@ -1,2 +1,2 @@
-export{b as CreateDatasetFromFileSchema,c as CreateDatasetFromSchemaSchema,a as DatasetSchema,d as updateDatasetSchema}from'../chunk-7SSENGQL.js';import'../chunk-KZOOYWQ7.js';import'../chunk-WYHO26N6.js';import'../chunk-MB4EEZKP.js';import'../chunk-3N56ERWF.js';import'../chunk-7ABFUHWW.js';import'../chunk-DUBPWSCA.js';//# sourceMappingURL=datasets.js.map
+export{b as CreateDatasetFromFileSchema,c as CreateDatasetFromSchemaSchema,a as DatasetSchema,d as updateDatasetSchema}from'../chunk-U3F23ASS.js';import'../chunk-G2MXCB7Q.js';import'../chunk-CF56NFUG.js';import'../chunk-WLGOABHV.js';import'../chunk-3N56ERWF.js';import'../chunk-WRHPQNEL.js';import'../chunk-DUBPWSCA.js';//# sourceMappingURL=datasets.js.map
 //# sourceMappingURL=datasets.js.map

package/dist/schema/events.cjs

@@ -0,0 +1,2 @@
+'use strict';var chunkG24BRDHO_cjs=require('../chunk-G24BRDHO.cjs');Object.defineProperty(exports,"USER_SUBSCRIBABLE_WEBHOOK_EVENTS",{enumerable:true,get:function(){return chunkG24BRDHO_cjs.c}});Object.defineProperty(exports,"WEBHOOK_EVENTS",{enumerable:true,get:function(){return chunkG24BRDHO_cjs.a}});Object.defineProperty(exports,"WEBHOOK_EVENT_TYPES",{enumerable:true,get:function(){return chunkG24BRDHO_cjs.b}});//# sourceMappingURL=events.cjs.map
+//# sourceMappingURL=events.cjs.map

package/dist/schema/events.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"events.cjs"}

package/dist/schema/events.d.cts

@@ -0,0 +1,113 @@
+/**
+ * Shared registry of webhook event types emitted by the Ouro platform.
+ *
+ * This is the single source of truth used by the backend (event dispatch),
+ * the frontend (settings UI), the Python SDK (`ouro-py`), and the agent
+ * runtime (`ouro-agents`). Adding a new event type means adding a single
+ * entry here.
+ */
+interface WebhookEventDefinition {
+    /** Human-readable label rendered in the user-facing settings UI. */
+    label: string;
+    /** Whether users can subscribe to this event via a webhook URL. */
+    userSubscribable: boolean;
+    /** What kind of resource the event is bound to. Drives recipient resolution. */
+    scope: "asset" | "user" | "conversation";
+}
+declare const WEBHOOK_EVENTS: {
+    readonly comment: {
+        readonly label: "Comments";
+        readonly userSubscribable: true;
+        readonly scope: "asset";
+    };
+    readonly mention: {
+        readonly label: "Mentions";
+        readonly userSubscribable: true;
+        readonly scope: "asset";
+    };
+    readonly reference: {
+        readonly label: "References";
+        readonly userSubscribable: true;
+        readonly scope: "asset";
+    };
+    readonly reaction: {
+        readonly label: "Reactions";
+        readonly userSubscribable: true;
+        readonly scope: "asset";
+    };
+    readonly share: {
+        readonly label: "Shares";
+        readonly userSubscribable: true;
+        readonly scope: "asset";
+    };
+    readonly follow: {
+        readonly label: "Follows";
+        readonly userSubscribable: true;
+        readonly scope: "user";
+    };
+    readonly action: {
+        readonly label: "Actions";
+        readonly userSubscribable: true;
+        readonly scope: "asset";
+    };
+    readonly "asset.deleted": {
+        readonly label: "Asset deletions";
+        readonly userSubscribable: true;
+        readonly scope: "asset";
+    };
+    readonly "new-conversation": {
+        readonly label: "Conversations";
+        readonly userSubscribable: true;
+        readonly scope: "conversation";
+    };
+    readonly "new-message": {
+        readonly label: "Messages";
+        readonly userSubscribable: true;
+        readonly scope: "conversation";
+    };
+};
+type WebhookEventType = keyof typeof WEBHOOK_EVENTS;
+declare const WEBHOOK_EVENT_TYPES: WebhookEventType[];
+declare const USER_SUBSCRIBABLE_WEBHOOK_EVENTS: {
+    value: "comment" | "reference" | "mention" | "action" | "follow" | "share" | "reaction" | "asset.deleted" | "new-conversation" | "new-message";
+    label: string;
+}[];
+interface WebhookActor {
+    id: string;
+    username: string;
+    is_agent: boolean;
+}
+interface WebhookAssetRef {
+    id: string;
+    type: string;
+}
+interface WebhookOrgRef {
+    id: string;
+    name: string;
+}
+interface WebhookTeamRef {
+    id: string;
+    name: string;
+}
+/**
+ * Canonical envelope for every webhook event delivery.
+ *
+ * `data` is event-specific; consumers should branch on `event` and treat
+ * `data` as a typed payload accordingly.
+ */
+interface WebhookPayload<T extends WebhookEventType = WebhookEventType, D = unknown> {
+    /** Stable per-delivery UUID. Receivers should dedupe on this. */
+    delivery_id: string;
+    event: T;
+    /** ISO timestamp of when the event was produced (not when it was sent). */
+    timestamp: string;
+    /** The recipient user_id this delivery is targeted at. */
+    user_id: string;
+    /** Correlated in-app notification id when there is exactly one. */
+    notification_id?: string;
+    /** Correlated in-app notification ids when an event covers multiple. */
+    notification_ids?: string[];
+    data: D;
+}
+
+export { USER_SUBSCRIBABLE_WEBHOOK_EVENTS, WEBHOOK_EVENTS, WEBHOOK_EVENT_TYPES, type WebhookActor, type WebhookAssetRef, type WebhookEventDefinition, type WebhookEventType, type WebhookOrgRef, type WebhookPayload, type WebhookTeamRef };

package/dist/schema/events.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Shared registry of webhook event types emitted by the Ouro platform.
+ *
+ * This is the single source of truth used by the backend (event dispatch),
+ * the frontend (settings UI), the Python SDK (`ouro-py`), and the agent
+ * runtime (`ouro-agents`). Adding a new event type means adding a single
+ * entry here.
+ */
+interface WebhookEventDefinition {
+    /** Human-readable label rendered in the user-facing settings UI. */
+    label: string;
+    /** Whether users can subscribe to this event via a webhook URL. */
+    userSubscribable: boolean;
+    /** What kind of resource the event is bound to. Drives recipient resolution. */
+    scope: "asset" | "user" | "conversation";
+}
+declare const WEBHOOK_EVENTS: {
+    readonly comment: {
+        readonly label: "Comments";
+        readonly userSubscribable: true;
+        readonly scope: "asset";
+    };
+    readonly mention: {
+        readonly label: "Mentions";
+        readonly userSubscribable: true;
+        readonly scope: "asset";
+    };
+    readonly reference: {
+        readonly label: "References";
+        readonly userSubscribable: true;
+        readonly scope: "asset";
+    };
+    readonly reaction: {
+        readonly label: "Reactions";
+        readonly userSubscribable: true;
+        readonly scope: "asset";
+    };
+    readonly share: {
+        readonly label: "Shares";
+        readonly userSubscribable: true;
+        readonly scope: "asset";
+    };
+    readonly follow: {
+        readonly label: "Follows";
+        readonly userSubscribable: true;
+        readonly scope: "user";
+    };
+    readonly action: {
+        readonly label: "Actions";
+        readonly userSubscribable: true;
+        readonly scope: "asset";
+    };
+    readonly "asset.deleted": {
+        readonly label: "Asset deletions";
+        readonly userSubscribable: true;
+        readonly scope: "asset";
+    };
+    readonly "new-conversation": {
+        readonly label: "Conversations";
+        readonly userSubscribable: true;
+        readonly scope: "conversation";
+    };
+    readonly "new-message": {
+        readonly label: "Messages";
+        readonly userSubscribable: true;
+        readonly scope: "conversation";
+    };
+};
+type WebhookEventType = keyof typeof WEBHOOK_EVENTS;
+declare const WEBHOOK_EVENT_TYPES: WebhookEventType[];
+declare const USER_SUBSCRIBABLE_WEBHOOK_EVENTS: {
+    value: "comment" | "reference" | "mention" | "action" | "follow" | "share" | "reaction" | "asset.deleted" | "new-conversation" | "new-message";
+    label: string;
+}[];
+interface WebhookActor {
+    id: string;
+    username: string;
+    is_agent: boolean;
+}
+interface WebhookAssetRef {
+    id: string;
+    type: string;
+}
+interface WebhookOrgRef {
+    id: string;
+    name: string;
+}
+interface WebhookTeamRef {
+    id: string;
+    name: string;
+}
+/**
+ * Canonical envelope for every webhook event delivery.
+ *
+ * `data` is event-specific; consumers should branch on `event` and treat
+ * `data` as a typed payload accordingly.
+ */
+interface WebhookPayload<T extends WebhookEventType = WebhookEventType, D = unknown> {
+    /** Stable per-delivery UUID. Receivers should dedupe on this. */
+    delivery_id: string;
+    event: T;
+    /** ISO timestamp of when the event was produced (not when it was sent). */
+    timestamp: string;
+    /** The recipient user_id this delivery is targeted at. */
+    user_id: string;
+    /** Correlated in-app notification id when there is exactly one. */
+    notification_id?: string;
+    /** Correlated in-app notification ids when an event covers multiple. */
+    notification_ids?: string[];
+    data: D;
+}
+
+export { USER_SUBSCRIBABLE_WEBHOOK_EVENTS, WEBHOOK_EVENTS, WEBHOOK_EVENT_TYPES, type WebhookActor, type WebhookAssetRef, type WebhookEventDefinition, type WebhookEventType, type WebhookOrgRef, type WebhookPayload, type WebhookTeamRef };

package/dist/schema/events.js

@@ -0,0 +1,2 @@
+export{c as USER_SUBSCRIBABLE_WEBHOOK_EVENTS,a as WEBHOOK_EVENTS,b as WEBHOOK_EVENT_TYPES}from'../chunk-CIWFH5BJ.js';//# sourceMappingURL=events.js.map
+//# sourceMappingURL=events.js.map

package/dist/schema/events.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"events.js"}

package/dist/schema/files.cjs

@@ -1,2 +1,2 @@
-'use strict';var chunkOFSSOFOC_cjs=require('../chunk-OFSSOFOC.cjs');require('../chunk-FQ4F7DQH.cjs'),require('../chunk-IW4MZW5P.cjs'),require('../chunk-OIPOIY6M.cjs'),require('../chunk-GY6SLMMJ.cjs'),require('../chunk-3ZHWBPGA.cjs'),require('../chunk-7HF5VHUN.cjs');Object.defineProperty(exports,"CreateFileSchema",{enumerable:true,get:function(){return chunkOFSSOFOC_cjs.b}});Object.defineProperty(exports,"FileSchema",{enumerable:true,get:function(){return chunkOFSSOFOC_cjs.a}});Object.defineProperty(exports,"updateFileSchema",{enumerable:true,get:function(){return chunkOFSSOFOC_cjs.c}});//# sourceMappingURL=files.cjs.map
+'use strict';var chunkBQ5WODME_cjs=require('../chunk-BQ5WODME.cjs');require('../chunk-IP4OVRZB.cjs'),require('../chunk-UY43EQTO.cjs'),require('../chunk-VOY623ZD.cjs'),require('../chunk-GY6SLMMJ.cjs'),require('../chunk-43KB23BA.cjs'),require('../chunk-7HF5VHUN.cjs');Object.defineProperty(exports,"CreateFileSchema",{enumerable:true,get:function(){return chunkBQ5WODME_cjs.b}});Object.defineProperty(exports,"FileSchema",{enumerable:true,get:function(){return chunkBQ5WODME_cjs.a}});Object.defineProperty(exports,"updateFileSchema",{enumerable:true,get:function(){return chunkBQ5WODME_cjs.c}});//# sourceMappingURL=files.cjs.map
 //# sourceMappingURL=files.cjs.map