@vibesdotdev/tools 0.0.0-stage → 1.0.0-rc.3

package/dist/agents/schemas/event-kinds.d.ts

@@ -0,0 +1,248 @@
+/**
+ * Agent Event Runtime Kind Definitions
+ *
+ * Registers three new runtime kinds for the vibesOS agent lifecycle:
+ * - agent/event: what triggers agent execution
+ * - agent/event-source: where events come from
+ * - agent/execution-artifact: what agents produce
+ *
+ * These are data-only kinds — descriptors hold metadata, default
+ * implementations just store the descriptor. Custom implementations
+ * can add behavior (e.g., a webhook event source that validates signatures).
+ */
+import type { KindContext } from '@vibesdotdev/kernel/schemas/kind';
+import { type AgentEventDescriptor } from './event.ts';
+import { type AgentEventSourceDescriptor } from './event-source.ts';
+import { type AgentExecutionArtifactDescriptor } from './execution-artifact.ts';
+declare class DefaultAgentEvent {
+    readonly descriptor: AgentEventDescriptor;
+    constructor(descriptor: AgentEventDescriptor, _context: KindContext);
+}
+declare class DefaultAgentEventSource {
+    readonly descriptor: AgentEventSourceDescriptor;
+    constructor(descriptor: AgentEventSourceDescriptor, _context: KindContext);
+}
+declare class DefaultAgentExecutionArtifact {
+    readonly descriptor: AgentExecutionArtifactDescriptor;
+    constructor(descriptor: AgentExecutionArtifactDescriptor, _context: KindContext);
+}
+export declare const agentEventKind: {
+    id: string;
+    descriptorSchema: import("zod").ZodObject<{
+        id: import("zod").ZodString;
+        kind: import("zod").ZodLiteral<"agent/event">;
+        name: import("zod").ZodString;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+        sourceId: import("zod").ZodString;
+        eventType: import("zod").ZodEnum<{
+            message: "message";
+            system: "system";
+            schedule: "schedule";
+            webhook: "webhook";
+            "user-action": "user-action";
+            integration: "integration";
+        }>;
+        agentIds: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>;
+        payload: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+        priority: import("zod").ZodDefault<import("zod").ZodNumber>;
+        userId: import("zod").ZodOptional<import("zod").ZodString>;
+        projectId: import("zod").ZodOptional<import("zod").ZodString>;
+        organizationId: import("zod").ZodOptional<import("zod").ZodString>;
+        occurredAt: import("zod").ZodString;
+        hardware: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
+            consumer: "consumer";
+            cloud: "cloud";
+        }>>>;
+        enabled: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    }, import("zod/v4/core").$strip>;
+    defaultImplementation: typeof DefaultAgentEvent;
+    resolve: (candidates: AgentEventDescriptor[]) => {
+        id: string;
+        kind: "agent/event";
+        name: string;
+        sourceId: string;
+        eventType: "message" | "system" | "schedule" | "webhook" | "user-action" | "integration";
+        agentIds: string[];
+        payload: Record<string, unknown>;
+        priority: number;
+        occurredAt: string;
+        enabled: boolean;
+        description?: string | undefined;
+        userId?: string | undefined;
+        projectId?: string | undefined;
+        organizationId?: string | undefined;
+        hardware?: ("consumer" | "cloud")[] | undefined;
+        tags?: string[] | undefined;
+    };
+    contexts: never[];
+};
+export declare const agentEventSourceKind: {
+    id: string;
+    descriptorSchema: import("zod").ZodObject<{
+        id: import("zod").ZodString;
+        kind: import("zod").ZodLiteral<"agent/event-source">;
+        name: import("zod").ZodString;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+        sourceType: import("zod").ZodEnum<{
+            system: "system";
+            schedule: "schedule";
+            channel: "channel";
+            webhook: "webhook";
+            integration: "integration";
+        }>;
+        status: import("zod").ZodDefault<import("zod").ZodEnum<{
+            error: "error";
+            active: "active";
+            paused: "paused";
+            disconnected: "disconnected";
+        }>>;
+        agentIds: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>;
+        config: import("zod").ZodDefault<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+        filters: import("zod").ZodOptional<import("zod").ZodObject<{
+            eventTypes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            channels: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            guilds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            keywords: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            minPriority: import("zod").ZodOptional<import("zod").ZodNumber>;
+        }, import("zod/v4/core").$strip>>;
+        integrationId: import("zod").ZodOptional<import("zod").ZodString>;
+        schedule: import("zod").ZodOptional<import("zod").ZodObject<{
+            cron: import("zod").ZodOptional<import("zod").ZodString>;
+            intervalMs: import("zod").ZodOptional<import("zod").ZodNumber>;
+        }, import("zod/v4/core").$strip>>;
+        userId: import("zod").ZodOptional<import("zod").ZodString>;
+        projectId: import("zod").ZodOptional<import("zod").ZodString>;
+        organizationId: import("zod").ZodOptional<import("zod").ZodString>;
+        hardware: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
+            consumer: "consumer";
+            cloud: "cloud";
+        }>>>;
+        enabled: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    }, import("zod/v4/core").$strip>;
+    defaultImplementation: typeof DefaultAgentEventSource;
+    resolve: (candidates: AgentEventSourceDescriptor[]) => {
+        id: string;
+        kind: "agent/event-source";
+        name: string;
+        sourceType: "system" | "schedule" | "channel" | "webhook" | "integration";
+        status: "error" | "active" | "paused" | "disconnected";
+        agentIds: string[];
+        config: Record<string, unknown>;
+        enabled: boolean;
+        description?: string | undefined;
+        filters?: {
+            eventTypes?: string[] | undefined;
+            channels?: string[] | undefined;
+            guilds?: string[] | undefined;
+            keywords?: string[] | undefined;
+            minPriority?: number | undefined;
+        } | undefined;
+        integrationId?: string | undefined;
+        schedule?: {
+            cron?: string | undefined;
+            intervalMs?: number | undefined;
+        } | undefined;
+        userId?: string | undefined;
+        projectId?: string | undefined;
+        organizationId?: string | undefined;
+        hardware?: ("consumer" | "cloud")[] | undefined;
+        tags?: string[] | undefined;
+    };
+    contexts: never[];
+};
+export declare const agentExecutionArtifactKind: {
+    id: string;
+    descriptorSchema: import("zod").ZodObject<{
+        id: import("zod").ZodString;
+        kind: import("zod").ZodLiteral<"agent/execution-artifact">;
+        name: import("zod").ZodString;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+        artifactType: import("zod").ZodEnum<{
+            file: "file";
+            "chat-message": "chat-message";
+            "tool-result": "tool-result";
+            "dashboard-widget": "dashboard-widget";
+            "data-entry": "data-entry";
+            visualization: "visualization";
+            notification: "notification";
+            worktree: "worktree";
+            "draft-items": "draft-items";
+            "staged-config": "staged-config";
+            note: "note";
+        }>;
+        status: import("zod").ZodDefault<import("zod").ZodEnum<{
+            error: "error";
+            complete: "complete";
+            approved: "approved";
+            pending: "pending";
+            discarded: "discarded";
+        }>>;
+        agentId: import("zod").ZodString;
+        eventId: import("zod").ZodOptional<import("zod").ZodString>;
+        sessionId: import("zod").ZodOptional<import("zod").ZodString>;
+        roomId: import("zod").ZodOptional<import("zod").ZodString>;
+        content: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+        componentRef: import("zod").ZodOptional<import("zod").ZodString>;
+        fileRef: import("zod").ZodOptional<import("zod").ZodObject<{
+            path: import("zod").ZodOptional<import("zod").ZodString>;
+            url: import("zod").ZodOptional<import("zod").ZodString>;
+            mimeType: import("zod").ZodOptional<import("zod").ZodString>;
+            size: import("zod").ZodOptional<import("zod").ZodNumber>;
+        }, import("zod/v4/core").$strip>>;
+        summary: import("zod").ZodOptional<import("zod").ZodString>;
+        actions: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodObject<{
+            label: import("zod").ZodString;
+            command: import("zod").ZodString;
+            args: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>;
+        }, import("zod/v4/core").$strip>>>;
+        userId: import("zod").ZodOptional<import("zod").ZodString>;
+        projectId: import("zod").ZodOptional<import("zod").ZodString>;
+        organizationId: import("zod").ZodOptional<import("zod").ZodString>;
+        createdAt: import("zod").ZodString;
+        hardware: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
+            consumer: "consumer";
+            cloud: "cloud";
+        }>>>;
+        enabled: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    }, import("zod/v4/core").$strip>;
+    defaultImplementation: typeof DefaultAgentExecutionArtifact;
+    resolve: (candidates: AgentExecutionArtifactDescriptor[]) => {
+        id: string;
+        kind: "agent/execution-artifact";
+        name: string;
+        artifactType: "file" | "chat-message" | "tool-result" | "dashboard-widget" | "data-entry" | "visualization" | "notification" | "worktree" | "draft-items" | "staged-config" | "note";
+        status: "error" | "complete" | "approved" | "pending" | "discarded";
+        agentId: string;
+        content: Record<string, unknown>;
+        actions: {
+            label: string;
+            command: string;
+            args: string[];
+        }[];
+        createdAt: string;
+        enabled: boolean;
+        description?: string | undefined;
+        eventId?: string | undefined;
+        sessionId?: string | undefined;
+        roomId?: string | undefined;
+        componentRef?: string | undefined;
+        fileRef?: {
+            path?: string | undefined;
+            url?: string | undefined;
+            mimeType?: string | undefined;
+            size?: number | undefined;
+        } | undefined;
+        summary?: string | undefined;
+        userId?: string | undefined;
+        projectId?: string | undefined;
+        organizationId?: string | undefined;
+        hardware?: ("consumer" | "cloud")[] | undefined;
+        tags?: string[] | undefined;
+    };
+    contexts: never[];
+};
+export {};
+//# sourceMappingURL=event-kinds.d.ts.map

package/dist/agents/schemas/event-kinds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-kinds.d.ts","sourceRoot":"","sources":["../../../src/agents/schemas/event-kinds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAA8B,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,EAAoC,KAAK,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AACtG,OAAO,EAEN,KAAK,gCAAgC,EACrC,MAAM,yBAAyB,CAAC;AAIjC,cAAM,iBAAiB;IAErB,QAAQ,CAAC,UAAU,EAAE,oBAAoB;gBAAhC,UAAU,EAAE,oBAAoB,EACzC,QAAQ,EAAE,WAAW;CAEtB;AAED,cAAM,uBAAuB;IAE3B,QAAQ,CAAC,UAAU,EAAE,0BAA0B;gBAAtC,UAAU,EAAE,0BAA0B,EAC/C,QAAQ,EAAE,WAAW;CAEtB;AAED,cAAM,6BAA6B;IAEjC,QAAQ,CAAC,UAAU,EAAE,gCAAgC;gBAA5C,UAAU,EAAE,gCAAgC,EACrD,QAAQ,EAAE,WAAW;CAEtB;AAID,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAIJ,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;CAE5C,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAIV,0BAA0B,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAElD,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAIhB,gCAAgC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAExD,CAAC"}

package/dist/agents/schemas/event-kinds.js

@@ -0,0 +1,57 @@
+/**
+ * Agent Event Runtime Kind Definitions
+ *
+ * Registers three new runtime kinds for the vibesOS agent lifecycle:
+ * - agent/event: what triggers agent execution
+ * - agent/event-source: where events come from
+ * - agent/execution-artifact: what agents produce
+ *
+ * These are data-only kinds — descriptors hold metadata, default
+ * implementations just store the descriptor. Custom implementations
+ * can add behavior (e.g., a webhook event source that validates signatures).
+ */
+import { AgentEventDescriptorSchema } from "./event.js";
+import { AgentEventSourceDescriptorSchema } from "./event-source.js";
+import { AgentExecutionArtifactDescriptorSchema } from "./execution-artifact.js";
+// Default implementations (data-only — store descriptor, no custom behavior)
+class DefaultAgentEvent {
+    descriptor;
+    constructor(descriptor, _context) {
+        this.descriptor = descriptor;
+    }
+}
+class DefaultAgentEventSource {
+    descriptor;
+    constructor(descriptor, _context) {
+        this.descriptor = descriptor;
+    }
+}
+class DefaultAgentExecutionArtifact {
+    descriptor;
+    constructor(descriptor, _context) {
+        this.descriptor = descriptor;
+    }
+}
+// Kind definitions
+export const agentEventKind = {
+    id: 'agent/event',
+    descriptorSchema: AgentEventDescriptorSchema,
+    defaultImplementation: DefaultAgentEvent,
+    resolve: (candidates) => candidates[0],
+    contexts: []
+};
+export const agentEventSourceKind = {
+    id: 'agent/event-source',
+    descriptorSchema: AgentEventSourceDescriptorSchema,
+    defaultImplementation: DefaultAgentEventSource,
+    resolve: (candidates) => candidates[0],
+    contexts: []
+};
+export const agentExecutionArtifactKind = {
+    id: 'agent/execution-artifact',
+    descriptorSchema: AgentExecutionArtifactDescriptorSchema,
+    defaultImplementation: DefaultAgentExecutionArtifact,
+    resolve: (candidates) => candidates[0],
+    contexts: []
+};
+//# sourceMappingURL=event-kinds.js.map

package/dist/agents/schemas/event-kinds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-kinds.js","sourceRoot":"","sources":["../../../src/agents/schemas/event-kinds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,0BAA0B,EAA6B,MAAM,YAAY,CAAC;AACnF,OAAO,EAAE,gCAAgC,EAAmC,MAAM,mBAAmB,CAAC;AACtG,OAAO,EACN,sCAAsC,EAEtC,MAAM,yBAAyB,CAAC;AAEjC,6EAA6E;AAE7E,MAAM,iBAAiB;IAEZ;IADV,YACU,UAAgC,EACzC,QAAqB;QADZ,eAAU,GAAV,UAAU,CAAsB;IAEvC,CAAC;CACJ;AAED,MAAM,uBAAuB;IAElB;IADV,YACU,UAAsC,EAC/C,QAAqB;QADZ,eAAU,GAAV,UAAU,CAA4B;IAE7C,CAAC;CACJ;AAED,MAAM,6BAA6B;IAExB;IADV,YACU,UAA4C,EACrD,QAAqB;QADZ,eAAU,GAAV,UAAU,CAAkC;IAEnD,CAAC;CACJ;AAED,mBAAmB;AAEnB,MAAM,CAAC,MAAM,cAAc,GAAG;IAC7B,EAAE,EAAE,aAAa;IACjB,gBAAgB,EAAE,0BAA0B;IAC5C,qBAAqB,EAAE,iBAAiB;IACxC,OAAO,EAAE,CAAC,UAAkC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAC9D,QAAQ,EAAE,EAAE;CACZ,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IACnC,EAAE,EAAE,oBAAoB;IACxB,gBAAgB,EAAE,gCAAgC;IAClD,qBAAqB,EAAE,uBAAuB;IAC9C,OAAO,EAAE,CAAC,UAAwC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IACpE,QAAQ,EAAE,EAAE;CACZ,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACzC,EAAE,EAAE,0BAA0B;IAC9B,gBAAgB,EAAE,sCAAsC;IACxD,qBAAqB,EAAE,6BAA6B;IACpD,OAAO,EAAE,CAAC,UAA8C,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAC1E,QAAQ,EAAE,EAAE;CACZ,CAAC"}

package/dist/agents/schemas/event-source.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Agent Event Source Schemas
+ *
+ * An event source is a runtime-discoverable origin of agent events.
+ * Sources connect agents to the outside world: messaging platforms,
+ * scheduled tasks, webhooks, system signals, etc.
+ */
+import * as z from 'zod/v4';
+export declare const EventSourceTypeSchema: z.ZodEnum<{
+    system: "system";
+    schedule: "schedule";
+    channel: "channel";
+    webhook: "webhook";
+    integration: "integration";
+}>;
+export declare const EventSourceStatusSchema: z.ZodEnum<{
+    error: "error";
+    active: "active";
+    paused: "paused";
+    disconnected: "disconnected";
+}>;
+export declare const AgentEventSourceDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodLiteral<"agent/event-source">;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    sourceType: z.ZodEnum<{
+        system: "system";
+        schedule: "schedule";
+        channel: "channel";
+        webhook: "webhook";
+        integration: "integration";
+    }>;
+    status: z.ZodDefault<z.ZodEnum<{
+        error: "error";
+        active: "active";
+        paused: "paused";
+        disconnected: "disconnected";
+    }>>;
+    agentIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    filters: z.ZodOptional<z.ZodObject<{
+        eventTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        channels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        guilds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        minPriority: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    integrationId: z.ZodOptional<z.ZodString>;
+    schedule: z.ZodOptional<z.ZodObject<{
+        cron: z.ZodOptional<z.ZodString>;
+        intervalMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    userId: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodOptional<z.ZodString>;
+    organizationId: z.ZodOptional<z.ZodString>;
+    hardware: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        consumer: "consumer";
+        cloud: "cloud";
+    }>>>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type EventSourceType = z.infer<typeof EventSourceTypeSchema>;
+export type EventSourceStatus = z.infer<typeof EventSourceStatusSchema>;
+export type AgentEventSourceDescriptor = z.infer<typeof AgentEventSourceDescriptorSchema>;
+//# sourceMappingURL=event-source.d.ts.map

package/dist/agents/schemas/event-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-source.d.ts","sourceRoot":"","sources":["../../../src/agents/schemas/event-source.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,eAAO,MAAM,qBAAqB;;;;;;EAMhC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;EAAwD,CAAC;AAE7F,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgD3C,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC"}

package/dist/agents/schemas/event-source.js

@@ -0,0 +1,57 @@
+/**
+ * Agent Event Source Schemas
+ *
+ * An event source is a runtime-discoverable origin of agent events.
+ * Sources connect agents to the outside world: messaging platforms,
+ * scheduled tasks, webhooks, system signals, etc.
+ */
+import * as z from 'zod/v4';
+export const EventSourceTypeSchema = z.enum([
+    'integration',
+    'schedule',
+    'webhook',
+    'system',
+    'channel'
+]);
+export const EventSourceStatusSchema = z.enum(['active', 'paused', 'error', 'disconnected']);
+export const AgentEventSourceDescriptorSchema = z.object({
+    id: z.string(),
+    kind: z.literal('agent/event-source'),
+    name: z.string(),
+    description: z.string().optional(),
+    /** What kind of source this is */
+    sourceType: EventSourceTypeSchema,
+    /** Current operational status */
+    status: EventSourceStatusSchema.default('disconnected'),
+    /** Which agents subscribe to events from this source */
+    agentIds: z.array(z.string()).default([]),
+    /** Source-specific connection config (integration ID, cron expression, URL, etc.) */
+    config: z.record(z.string(), z.unknown()).default({}),
+    /** Optional event filters — only forward events matching these criteria */
+    filters: z
+        .object({
+        eventTypes: z.array(z.string()).optional(),
+        channels: z.array(z.string()).optional(),
+        guilds: z.array(z.string()).optional(),
+        keywords: z.array(z.string()).optional(),
+        minPriority: z.number().int().min(0).max(10).optional()
+    })
+        .optional(),
+    /** For integration sources — reference to platform integration ID */
+    integrationId: z.string().optional(),
+    /** For schedule sources — cron expression or interval */
+    schedule: z
+        .object({
+        cron: z.string().optional(),
+        intervalMs: z.number().int().positive().optional()
+    })
+        .optional(),
+    /** Tenant scoping */
+    userId: z.string().optional(),
+    projectId: z.string().optional(),
+    organizationId: z.string().optional(),
+    hardware: z.array(z.enum(['consumer', 'cloud'])).optional(),
+    enabled: z.boolean().default(true),
+    tags: z.array(z.string()).optional()
+});
+//# sourceMappingURL=event-source.js.map

package/dist/agents/schemas/event-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-source.js","sourceRoot":"","sources":["../../../src/agents/schemas/event-source.ts"],"names":[],"mappings":"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"}

package/dist/agents/schemas/event.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Agent Event Schemas
+ *
+ * An agent event is something that happened which may trigger agent execution.
+ * Events flow from event sources into the agent loop via the runtime.
+ */
+import * as z from 'zod/v4';
+export declare const AgentEventTypeSchema: z.ZodEnum<{
+    message: "message";
+    system: "system";
+    schedule: "schedule";
+    webhook: "webhook";
+    "user-action": "user-action";
+    integration: "integration";
+}>;
+export declare const AgentEventDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodLiteral<"agent/event">;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    sourceId: z.ZodString;
+    eventType: z.ZodEnum<{
+        message: "message";
+        system: "system";
+        schedule: "schedule";
+        webhook: "webhook";
+        "user-action": "user-action";
+        integration: "integration";
+    }>;
+    agentIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    priority: z.ZodDefault<z.ZodNumber>;
+    userId: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodOptional<z.ZodString>;
+    organizationId: z.ZodOptional<z.ZodString>;
+    occurredAt: z.ZodString;
+    hardware: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        consumer: "consumer";
+        cloud: "cloud";
+    }>>>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type AgentEventType = z.infer<typeof AgentEventTypeSchema>;
+export type AgentEventDescriptor = z.infer<typeof AgentEventDescriptorSchema>;
+//# sourceMappingURL=event.d.ts.map

package/dist/agents/schemas/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../../src/agents/schemas/event.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,eAAO,MAAM,oBAAoB;;;;;;;EAO/B,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgCrC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/agents/schemas/event.js

@@ -0,0 +1,41 @@
+/**
+ * Agent Event Schemas
+ *
+ * An agent event is something that happened which may trigger agent execution.
+ * Events flow from event sources into the agent loop via the runtime.
+ */
+import * as z from 'zod/v4';
+export const AgentEventTypeSchema = z.enum([
+    'message',
+    'schedule',
+    'webhook',
+    'system',
+    'user-action',
+    'integration'
+]);
+export const AgentEventDescriptorSchema = z.object({
+    id: z.string(),
+    kind: z.literal('agent/event'),
+    name: z.string(),
+    description: z.string().optional(),
+    /** Which event source produced this event */
+    sourceId: z.string(),
+    /** Event classification */
+    eventType: AgentEventTypeSchema,
+    /** Which agent(s) should handle this event (empty = broadcast to all) */
+    agentIds: z.array(z.string()).default([]),
+    /** Source-specific event payload */
+    payload: z.record(z.string(), z.unknown()),
+    /** Urgency — higher priority events may interrupt lower-priority work */
+    priority: z.number().int().min(0).max(10).default(5),
+    /** Tenant scoping */
+    userId: z.string().optional(),
+    projectId: z.string().optional(),
+    organizationId: z.string().optional(),
+    /** When the event occurred at the source */
+    occurredAt: z.string(),
+    hardware: z.array(z.enum(['consumer', 'cloud'])).optional(),
+    enabled: z.boolean().default(true),
+    tags: z.array(z.string()).optional()
+});
+//# sourceMappingURL=event.js.map

package/dist/agents/schemas/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../../src/agents/schemas/event.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC1C,SAAS;IACT,UAAU;IACV,SAAS;IACT,QAAQ;IACR,aAAa;IACb,aAAa;CACb,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAElC,6CAA6C;IAC7C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IAEpB,2BAA2B;IAC3B,SAAS,EAAE,oBAAoB;IAE/B,yEAAyE;IACzE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAEzC,oCAAoC;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAE1C,yEAAyE;IACzE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAEpD,qBAAqB;IACrB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAErC,4CAA4C;IAC5C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IAEtB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3D,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAClC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC"}

package/dist/agents/schemas/execution-artifact.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Agent Execution Artifact Schemas
+ *
+ * An execution artifact is something an agent produced during execution.
+ * Artifacts are stored, queryable, and renderable in vibesOS dashboards.
+ *
+ * This replaces the limited SurfaceArtifact system (worktree, draft-items,
+ * staged-config, note) with a runtime-discoverable, extensible model.
+ */
+import * as z from 'zod/v4';
+export declare const ArtifactTypeSchema: z.ZodEnum<{
+    file: "file";
+    "chat-message": "chat-message";
+    "tool-result": "tool-result";
+    "dashboard-widget": "dashboard-widget";
+    "data-entry": "data-entry";
+    visualization: "visualization";
+    notification: "notification";
+    worktree: "worktree";
+    "draft-items": "draft-items";
+    "staged-config": "staged-config";
+    note: "note";
+}>;
+export declare const ArtifactStatusSchema: z.ZodEnum<{
+    error: "error";
+    complete: "complete";
+    approved: "approved";
+    pending: "pending";
+    discarded: "discarded";
+}>;
+export declare const AgentExecutionArtifactDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodLiteral<"agent/execution-artifact">;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    artifactType: z.ZodEnum<{
+        file: "file";
+        "chat-message": "chat-message";
+        "tool-result": "tool-result";
+        "dashboard-widget": "dashboard-widget";
+        "data-entry": "data-entry";
+        visualization: "visualization";
+        notification: "notification";
+        worktree: "worktree";
+        "draft-items": "draft-items";
+        "staged-config": "staged-config";
+        note: "note";
+    }>;
+    status: z.ZodDefault<z.ZodEnum<{
+        error: "error";
+        complete: "complete";
+        approved: "approved";
+        pending: "pending";
+        discarded: "discarded";
+    }>>;
+    agentId: z.ZodString;
+    eventId: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    roomId: z.ZodOptional<z.ZodString>;
+    content: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    componentRef: z.ZodOptional<z.ZodString>;
+    fileRef: z.ZodOptional<z.ZodObject<{
+        path: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    summary: z.ZodOptional<z.ZodString>;
+    actions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        command: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    userId: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodOptional<z.ZodString>;
+    organizationId: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    hardware: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        consumer: "consumer";
+        cloud: "cloud";
+    }>>>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type ArtifactType = z.infer<typeof ArtifactTypeSchema>;
+export type ArtifactStatus = z.infer<typeof ArtifactStatusSchema>;
+export type AgentExecutionArtifactDescriptor = z.infer<typeof AgentExecutionArtifactDescriptorSchema>;
+//# sourceMappingURL=execution-artifact.d.ts.map

package/dist/agents/schemas/execution-artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-artifact.d.ts","sourceRoot":"","sources":["../../../src/agents/schemas/execution-artifact.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAY7B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;EAM/B,CAAC;AAEH,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoEjD,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,sCAAsC,CAC7C,CAAC"}