@dxos/compute 0.8.4-main.fd6878d → 0.9.0

package/dist/types/src/Trace.d.ts

@@ -0,0 +1,266 @@
+import * as Context from 'effect/Context';
+import * as Effect from 'effect/Effect';
+import * as Layer from 'effect/Layer';
+import * as Schema from 'effect/Schema';
+import { Type } from '@dxos/echo';
+/**
+ * Writes ephemeral or persistent events to the trace.
+ * Exposed to processes and operations to record events to the trace.
+ */
+export interface TraceWriter {
+    write<T>(eventType: EventType<T>, payload: NoInfer<T>): void;
+}
+declare const TraceService_base: Context.TagClass<TraceService, "@dxos/functions/TraceService", TraceWriter>;
+/**
+ * Service that writes events to the trace.
+ * Exposed to processes and operations to record events to the trace.
+ */
+export declare class TraceService extends TraceService_base {
+}
+/**
+ * Writes an event to the trace.
+ */
+export declare function write<T>(eventType: EventType<T>, payload: NoInfer<T>): Effect.Effect<void, never, TraceService>;
+/**
+ * Defines an event type for the trace.
+ */
+export interface EventType<T> {
+    readonly key: string;
+    readonly schema: Schema.Schema<T, any>;
+    readonly isEphemeral: boolean;
+}
+export declare const EventType: <T>(key: string, opts: {
+    schema: Schema.Schema<T, any>;
+    isEphemeral: boolean;
+}) => EventType<T>;
+/**
+ * Extracts the payload type from an event type.
+ */
+export type PayloadType<E extends EventType<any>> = E extends EventType<infer T> ? T : never;
+export declare const Event: Schema.Struct<{
+    timestamp: typeof Schema.Number;
+    type: typeof Schema.String;
+    data: typeof Schema.Unknown;
+}>;
+export type Event = Schema.Schema.Type<typeof Event>;
+/**
+ * Checks if an event is of a given type.
+ */
+export declare const isOfType: <T, E extends Event>(eventType: EventType<T>, event: E) => event is E & {
+    data: T;
+};
+/**
+ * Extensible name informing which runtime executed the code that produced the event.
+ */
+export declare const RuntimeName: Schema.brand<typeof Schema.String, "@dxos/compute/Trace/RuntimeName">;
+export type RuntimeName = Schema.Schema.Type<typeof RuntimeName>;
+/**
+ * Common runtime names.
+ */
+export declare const CommonRuntimeName: {
+    /**
+     * Web app / CLI / Desktop app / Mobile app.
+     */
+    local: string & import("effect/Brand").Brand<"@dxos/compute/Trace/RuntimeName">;
+    edgeIntrinsic: string & import("effect/Brand").Brand<"@dxos/compute/Trace/RuntimeName">;
+    edgeWorkerLoader: string & import("effect/Brand").Brand<"@dxos/compute/Trace/RuntimeName">;
+    edgeWorkerForPlatforms: string & import("effect/Brand").Brand<"@dxos/compute/Trace/RuntimeName">;
+};
+/**
+ * Metadata on the context of a trace message.
+ */
+export declare const Meta: Schema.Struct<{
+    pid: Schema.optional<typeof Schema.String>;
+    parentPid: Schema.optional<typeof Schema.String>;
+    processName: Schema.optional<typeof Schema.String>;
+    /**
+     * Space the message was produced in.
+     * Stored as a string to avoid circular dependency on `@dxos/keys`.
+     */
+    space: Schema.optional<typeof Schema.String>;
+    /**
+     * ID of the conversation feed object if present.
+     */
+    conversationId: Schema.optional<import("@dxos/keys").EntityIdClass>;
+    /**
+     * ID of the trigger object if invocation resulted from a trigger.
+     */
+    triggerId: Schema.optional<import("@dxos/keys").EntityIdClass>;
+    /**
+     * ID of the tool call that created the current process.
+     */
+    toolCallId: Schema.optional<typeof Schema.String>;
+    /**
+     * Extensible name informing which runtime executed the code that produced the event.
+     */
+    runtimeName: Schema.optional<Schema.brand<typeof Schema.String, "@dxos/compute/Trace/RuntimeName">>;
+}>;
+export type Meta = Schema.Schema.Type<typeof Meta>;
+/**
+ * Checks if a runtime is an edge runtime.
+ */
+export declare const isEdgeRuntime: (name: RuntimeName) => boolean;
+/**
+ * Envelope for a set of events.
+ */
+export declare const MessageData: Schema.Struct<{
+    meta: Schema.Struct<{
+        pid: Schema.optional<typeof Schema.String>;
+        parentPid: Schema.optional<typeof Schema.String>;
+        processName: Schema.optional<typeof Schema.String>;
+        /**
+         * Space the message was produced in.
+         * Stored as a string to avoid circular dependency on `@dxos/keys`.
+         */
+        space: Schema.optional<typeof Schema.String>;
+        /**
+         * ID of the conversation feed object if present.
+         */
+        conversationId: Schema.optional<import("@dxos/keys").EntityIdClass>;
+        /**
+         * ID of the trigger object if invocation resulted from a trigger.
+         */
+        triggerId: Schema.optional<import("@dxos/keys").EntityIdClass>;
+        /**
+         * ID of the tool call that created the current process.
+         */
+        toolCallId: Schema.optional<typeof Schema.String>;
+        /**
+         * Extensible name informing which runtime executed the code that produced the event.
+         */
+        runtimeName: Schema.optional<Schema.brand<typeof Schema.String, "@dxos/compute/Trace/RuntimeName">>;
+    }>;
+    isEphemeral: typeof Schema.Boolean;
+    events: Schema.Array$<Schema.Struct<{
+        timestamp: typeof Schema.Number;
+        type: typeof Schema.String;
+        data: typeof Schema.Unknown;
+    }>>;
+}>;
+export type MessageData = Schema.Schema.Type<typeof MessageData>;
+export declare const Message: Type.Obj<{
+    readonly meta: {
+        readonly pid?: string | undefined;
+        readonly parentPid?: string | undefined;
+        readonly processName?: string | undefined;
+        readonly space?: string | undefined;
+        readonly conversationId?: string | undefined;
+        readonly triggerId?: string | undefined;
+        readonly toolCallId?: string | undefined;
+        readonly runtimeName?: (string & import("effect/Brand").Brand<"@dxos/compute/Trace/RuntimeName">) | undefined;
+    };
+    readonly isEphemeral: boolean;
+    readonly events: readonly {
+        readonly timestamp: number;
+        readonly type: string;
+        readonly data: unknown;
+    }[];
+}, Schema.Struct.Fields>;
+export type Message = Type.InstanceType<typeof Message>;
+/**
+ * Flattened representation of a signle event in a trace message.
+ * Events are stored in batched messages for efficiency, but flat representation is more convenient for consumption.
+ */
+export interface FlatEvent extends Event {
+    readonly meta: Meta;
+    readonly isEphemeral: boolean;
+}
+/**
+ * Flattens a trace message into a list of flat events.
+ */
+export declare const flatten: (message: Message) => FlatEvent[];
+/**
+ * Sink for complete trace messages.
+ */
+export interface Sink {
+    write(message: Message): void;
+}
+declare const TraceSink_base: Context.TagClass<TraceSink, "@dxos/functions/TraceSink", Sink>;
+/**
+ * Sink for complete trace messages.
+ * The Process Manager forwards trace messages to it.
+ */
+export declare class TraceSink extends TraceSink_base {
+}
+export declare const noopWriter: TraceWriter;
+export declare const writerLayerNoop: Layer.Layer<TraceService>;
+export declare const noopSink: Sink;
+export declare const layerNoop: Layer.Layer<TraceSink>;
+export declare const layerConsole: Layer.Layer<TraceSink>;
+/**
+ * Merge a set of sinks into a single sink.
+ *
+ * Each message is forwarded to every sink in order. Failures in one sink do not
+ * prevent downstream sinks from receiving the message.
+ */
+export declare const mergeSinks: (sinks: readonly Sink[]) => Sink;
+/**
+ * Builds a {@link TraceService} layer that wraps each `write` into a fresh {@link Message}
+ * and forwards it to the provided {@link TraceSink}. Intended for tests and lightweight
+ * fixtures.
+ *
+ * Options:
+ *   - `meta`: stamped on every emitted message (defaults to `{}`).
+ *   - `clock`: timestamp source (defaults to {@link Date.now}). Pass a monotonic counter
+ *     in tests to make event ordering deterministic when many writes happen in the same
+ *     millisecond.
+ */
+export declare const testTraceService: (opts?: {
+    meta?: Meta;
+    clock?: () => number;
+}) => Layer.Layer<TraceService, never, TraceSink>;
+/**
+ * Outcome of an operation invocation.
+ */
+export type OperationOutcome = 'success' | 'failure';
+/**
+ * Operation invocation started.
+ */
+export declare const OperationStart: EventType<{
+    readonly key: string;
+    readonly name?: string | undefined;
+    readonly icon?: string | undefined;
+}>;
+/**
+ * Operation invocation ended.
+ */
+export declare const OperationEnd: EventType<{
+    readonly key: string;
+    readonly name?: string | undefined;
+    readonly icon?: string | undefined;
+    readonly outcome: "failure" | "success";
+    readonly error?: string | undefined;
+}>;
+/**
+ * Operation input. Emitted as an ephemeral event alongside {@link OperationStart}
+ * so subscribers (such as the undo/redo history tracker) can observe the raw
+ * input payload without persisting it to long-lived sinks.
+ */
+export declare const OperationInput: EventType<{
+    readonly key: string;
+    readonly name?: string | undefined;
+    readonly input: unknown;
+}>;
+/**
+ * Operation output. Emitted as an ephemeral event just before
+ * {@link OperationEnd} for successful invocations so subscribers (such as the
+ * undo/redo history tracker) can observe the raw output payload without
+ * persisting it to long-lived sinks.
+ */
+export declare const OperationOutput: EventType<{
+    readonly key: string;
+    readonly name?: string | undefined;
+    readonly output: unknown;
+}>;
+/**
+ * Human-readable status update emitted by an agent or operation.
+ */
+export declare const StatusUpdate: EventType<{
+    readonly message: string;
+}>;
+/**
+ * Emit the current human-readable execution status to the trace.
+ */
+export declare const emitStatus: (message: string) => Effect.Effect<void, never, TraceService>;
+export {};
+//# sourceMappingURL=Trace.d.ts.map

package/dist/types/src/Trace.d.ts.map

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

package/dist/types/src/Trigger.d.ts

@@ -0,0 +1,192 @@
+import * as Schema from 'effect/Schema';
+import { Feed, Obj, QueryAST, Type, type Query } from '@dxos/echo';
+/**
+ * Type discriminator for TriggerType.
+ * Every spec has a type field of type TriggerKind that we can use to understand which type we're working with.
+ * https://www.typescriptlang.org/docs/handbook/2/narrowing.html#discriminated-unions
+ */
+export declare const Kinds: readonly ['email', 'feed', 'subscription', 'timer', 'webhook'];
+export type Kind = (typeof Kinds)[number];
+export declare const EmailSpec: Schema.Struct<{
+    kind: Schema.Literal<["email"]>;
+}>;
+export type EmailSpec = Schema.Schema.Type<typeof EmailSpec>;
+/**
+ * Construct an Email trigger spec.
+ */
+export declare const specEmail: () => EmailSpec;
+export declare const FeedSpec: Schema.Struct<{
+    kind: Schema.Literal<["feed"]>;
+    feed: Schema.optional<Schema.SchemaClass<import("@dxos/echo/internal").Ref<{
+        readonly name?: string | undefined;
+        readonly kind?: string | undefined;
+        readonly namespace?: "data" | "trace" | undefined;
+    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>, import("@dxos/echo-protocol").EncodedReference, never>>;
+}>;
+export type FeedSpec = Schema.Schema.Type<typeof FeedSpec>;
+/**
+ * Construct a Feed trigger spec from a Feed object.
+ */
+export declare const specFeed: (feed: Feed.Feed) => FeedSpec;
+/**
+ * Subscription.
+ */
+export declare const SubscriptionSpec: Schema.Struct<{
+    kind: Schema.Literal<["subscription"]>;
+    query: Schema.Struct<{
+        raw: Schema.optional<Schema.SchemaClass<string, string, never>>;
+        ast: Schema.Schema<QueryAST.QueryFilterClause | QueryAST.QueryFromClause | QueryAST.QueryHierarchyTraversalClause | QueryAST.QueryIncomingReferencesClause | QueryAST.QueryLimitClause | QueryAST.QueryOptionsClause | QueryAST.QueryOrderClause | QueryAST.QueryReferenceTraversalClause | QueryAST.QueryRelationClause | QueryAST.QueryRelationTraversalClause | QueryAST.QuerySelectClause | QueryAST.QuerySetDifferenceClause | QueryAST.QueryUnionClause, QueryAST.QueryFilterClause | QueryAST.QueryFromClause | QueryAST.QueryHierarchyTraversalClause | QueryAST.QueryIncomingReferencesClause | QueryAST.QueryLimitClause | QueryAST.QueryOptionsClause | QueryAST.QueryOrderClause | QueryAST.QueryReferenceTraversalClause | QueryAST.QueryRelationClause | QueryAST.QueryRelationTraversalClause | QueryAST.QuerySelectClause | QueryAST.QuerySetDifferenceClause | QueryAST.QueryUnionClause, never>;
+    }>;
+    options: Schema.optional<Schema.Struct<{
+        deep: Schema.optional<Schema.SchemaClass<boolean, boolean, never>>;
+        delay: Schema.optional<Schema.SchemaClass<number, number, never>>;
+    }>>;
+}>;
+export type SubscriptionSpec = Schema.Schema.Type<typeof SubscriptionSpec>;
+/**
+ * Construct a Subscription trigger spec from a Query object.
+ */
+export declare const specSubscription: (query: Query.Query<any>, options?: {
+    deep?: boolean;
+    delay?: number;
+}) => SubscriptionSpec;
+/**
+ * Cron timer.
+ */
+export declare const TimerSpec: Schema.Struct<{
+    kind: Schema.Literal<["timer"]>;
+    cron: Schema.SchemaClass<string, string, never>;
+}>;
+export type TimerSpec = Schema.Schema.Type<typeof TimerSpec>;
+/**
+ * Construct a Timer trigger spec from a cron string.
+ */
+export declare const specTimer: (cron: string) => TimerSpec;
+/**
+ * Webhook.
+ */
+export declare const WebhookSpec: Schema.Struct<{
+    kind: Schema.Literal<["webhook"]>;
+    method: Schema.optional<Schema.SchemaClass<string, string, never>>;
+    port: Schema.optional<Schema.SchemaClass<number, number, never>>;
+}>;
+export type WebhookSpec = Schema.Schema.Type<typeof WebhookSpec>;
+/**
+ * Construct a Webhook trigger spec from a method and port.
+ */
+export declare const specWebhook: (opts?: {
+    method?: string;
+    port?: number;
+}) => WebhookSpec;
+/**
+ * Trigger schema.
+ */
+export declare const Spec: Schema.Union<[Schema.Struct<{
+    kind: Schema.Literal<["email"]>;
+}>, Schema.Struct<{
+    kind: Schema.Literal<["feed"]>;
+    feed: Schema.optional<Schema.SchemaClass<import("@dxos/echo/internal").Ref<{
+        readonly name?: string | undefined;
+        readonly kind?: string | undefined;
+        readonly namespace?: "data" | "trace" | undefined;
+    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>, import("@dxos/echo-protocol").EncodedReference, never>>;
+}>, Schema.Struct<{
+    kind: Schema.Literal<["subscription"]>;
+    query: Schema.Struct<{
+        raw: Schema.optional<Schema.SchemaClass<string, string, never>>;
+        ast: Schema.Schema<QueryAST.QueryFilterClause | QueryAST.QueryFromClause | QueryAST.QueryHierarchyTraversalClause | QueryAST.QueryIncomingReferencesClause | QueryAST.QueryLimitClause | QueryAST.QueryOptionsClause | QueryAST.QueryOrderClause | QueryAST.QueryReferenceTraversalClause | QueryAST.QueryRelationClause | QueryAST.QueryRelationTraversalClause | QueryAST.QuerySelectClause | QueryAST.QuerySetDifferenceClause | QueryAST.QueryUnionClause, QueryAST.QueryFilterClause | QueryAST.QueryFromClause | QueryAST.QueryHierarchyTraversalClause | QueryAST.QueryIncomingReferencesClause | QueryAST.QueryLimitClause | QueryAST.QueryOptionsClause | QueryAST.QueryOrderClause | QueryAST.QueryReferenceTraversalClause | QueryAST.QueryRelationClause | QueryAST.QueryRelationTraversalClause | QueryAST.QuerySelectClause | QueryAST.QuerySetDifferenceClause | QueryAST.QueryUnionClause, never>;
+    }>;
+    options: Schema.optional<Schema.Struct<{
+        deep: Schema.optional<Schema.SchemaClass<boolean, boolean, never>>;
+        delay: Schema.optional<Schema.SchemaClass<number, number, never>>;
+    }>>;
+}>, Schema.Struct<{
+    kind: Schema.Literal<["timer"]>;
+    cron: Schema.SchemaClass<string, string, never>;
+}>, Schema.Struct<{
+    kind: Schema.Literal<["webhook"]>;
+    method: Schema.optional<Schema.SchemaClass<string, string, never>>;
+    port: Schema.optional<Schema.SchemaClass<number, number, never>>;
+}>]>;
+export type Spec = Schema.Schema.Type<typeof Spec>;
+/**
+ * Function trigger.
+ * Function is invoked with the `payload` passed as input data.
+ * The event that triggers the function is available in the function context.
+ */
+declare const TriggerSchema: Type.Obj<{
+    readonly function?: import("@dxos/echo/internal").Ref<Obj.Unknown> | undefined;
+    readonly inputNodeId?: string | undefined;
+    readonly enabled?: boolean | undefined;
+    readonly spec?: {
+        readonly kind: "email";
+    } | {
+        readonly kind: "feed";
+        readonly feed?: import("@dxos/echo/internal").Ref<{
+            readonly name?: string | undefined;
+            readonly kind?: string | undefined;
+            readonly namespace?: "data" | "trace" | undefined;
+        } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown> | undefined;
+    } | {
+        readonly kind: "subscription";
+        readonly query: {
+            readonly raw?: string | undefined;
+            readonly ast: QueryAST.QueryFilterClause | QueryAST.QueryFromClause | QueryAST.QueryHierarchyTraversalClause | QueryAST.QueryIncomingReferencesClause | QueryAST.QueryLimitClause | QueryAST.QueryOptionsClause | QueryAST.QueryOrderClause | QueryAST.QueryReferenceTraversalClause | QueryAST.QueryRelationClause | QueryAST.QueryRelationTraversalClause | QueryAST.QuerySelectClause | QueryAST.QuerySetDifferenceClause | QueryAST.QueryUnionClause;
+        };
+        readonly options?: {
+            readonly deep?: boolean | undefined;
+            readonly delay?: number | undefined;
+        } | undefined;
+    } | {
+        readonly kind: "timer";
+        readonly cron: string;
+    } | {
+        readonly kind: "webhook";
+        readonly method?: string | undefined;
+        readonly port?: number | undefined;
+    } | undefined;
+    readonly concurrency?: number | undefined;
+    readonly input?: {
+        readonly [x: string]: any;
+    } | undefined;
+}, Schema.Struct.Fields>;
+export type Trigger = Type.InstanceType<typeof TriggerSchema>;
+export declare const Trigger: Type.Obj<Trigger>;
+export declare const make: (props: Obj.MakeProps<typeof Trigger>) => Obj.OfShape<{
+    readonly function?: import("@dxos/echo/internal").Ref<Obj.Unknown> | undefined;
+    readonly inputNodeId?: string | undefined;
+    readonly enabled?: boolean | undefined;
+    readonly spec?: {
+        readonly kind: "email";
+    } | {
+        readonly kind: "feed";
+        readonly feed?: import("@dxos/echo/internal").Ref<{
+            readonly name?: string | undefined;
+            readonly kind?: string | undefined;
+            readonly namespace?: "data" | "trace" | undefined;
+        } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown> | undefined;
+    } | {
+        readonly kind: "subscription";
+        readonly query: {
+            readonly raw?: string | undefined;
+            readonly ast: QueryAST.QueryFilterClause | QueryAST.QueryFromClause | QueryAST.QueryHierarchyTraversalClause | QueryAST.QueryIncomingReferencesClause | QueryAST.QueryLimitClause | QueryAST.QueryOptionsClause | QueryAST.QueryOrderClause | QueryAST.QueryReferenceTraversalClause | QueryAST.QueryRelationClause | QueryAST.QueryRelationTraversalClause | QueryAST.QuerySelectClause | QueryAST.QuerySetDifferenceClause | QueryAST.QueryUnionClause;
+        };
+        readonly options?: {
+            readonly deep?: boolean | undefined;
+            readonly delay?: number | undefined;
+        } | undefined;
+    } | {
+        readonly kind: "timer";
+        readonly cron: string;
+    } | {
+        readonly kind: "webhook";
+        readonly method?: string | undefined;
+        readonly port?: number | undefined;
+    } | undefined;
+    readonly concurrency?: number | undefined;
+    readonly input?: {
+        readonly [x: string]: any;
+    } | undefined;
+} & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object>>;
+export {};
+//# sourceMappingURL=Trigger.d.ts.map

package/dist/types/src/Trigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Trigger.d.ts","sourceRoot":"","sources":["../../../src/Trigger.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAmB,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAO,IAAI,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAIzF;;;;GAIG;AACH,eAAO,MAAM,KAAK,YAAI,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,CAAU,CAAC;AACpF,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;AAI1C,eAAO,MAAM,SAAS;;EAEpB,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,SAAS,QAAO,SAAgC,CAAC;AAG9D,eAAO,MAAM,QAAQ;;;;;;;EAGnB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,QAAQ,SAAU,IAAI,CAAC,IAAI,KAAG,QAGzC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;EAc3B,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,gBAAgB,UACpB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,YACb;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KAC3C,gBAWD,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS;;;EAMpB,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,SAAS,SAAU,MAAM,KAAG,SAAsC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,WAAW;;;;EAatB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,WAAW,UAAW;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,KAAG,WAItE,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;IAEf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnD;;;;GAIG;AACH,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA6ClB,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,aAAa,CAAC,CAAC;AAC9D,eAAO,MAAM,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAwB,CAAC;AAE/D,eAAO,MAAM,IAAI,UAAW,GAAG,CAAC,SAAS,CAAC,OAAO,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8KAA6B,CAAC"}

package/dist/types/src/TriggerEvent.d.ts

@@ -0,0 +1,83 @@
+import * as Schema from 'effect/Schema';
+import { Obj, Ref } from '@dxos/echo';
+export declare const EmailEvent: Schema.Struct<{
+    from: typeof Schema.String;
+    to: typeof Schema.String;
+    subject: typeof Schema.String;
+    created: typeof Schema.String;
+    body: typeof Schema.String;
+}>;
+export type EmailEvent = Schema.Schema.Type<typeof EmailEvent>;
+export declare const FeedEvent: Schema.Struct<{
+    feed: Ref.RefSchema<{
+        readonly name?: string | undefined;
+        readonly kind?: string | undefined;
+        readonly namespace?: "data" | "trace" | undefined;
+    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
+    item: typeof Schema.Any;
+    cursor: typeof Schema.String;
+}>;
+export type FeedEvent = Schema.Schema.Type<typeof FeedEvent>;
+export declare const SubscriptionEvent: Schema.Struct<{
+    /**
+     * Type of the mutation.
+     */
+    type: typeof Schema.String;
+    /**
+     * Reference to the object that was changed or created.
+     */
+    subject: Ref.RefSchema<Obj.Unknown>;
+    /**
+     * @deprecated
+     */
+    changedObjectId: Schema.optional<typeof Schema.String>;
+}>;
+export type SubscriptionEvent = Schema.Schema.Type<typeof SubscriptionEvent>;
+export declare const TimerEvent: Schema.Struct<{
+    tick: typeof Schema.Number;
+}>;
+export type TimerEvent = Schema.Schema.Type<typeof TimerEvent>;
+export declare const WebhookEvent: Schema.Struct<{
+    url: typeof Schema.String;
+    method: Schema.Literal<["GET", "POST"]>;
+    headers: Schema.Record$<typeof Schema.String, typeof Schema.String>;
+    bodyText: typeof Schema.String;
+}>;
+export type WebhookEvent = Schema.Schema.Type<typeof WebhookEvent>;
+export declare const TriggerEvent: Schema.Union<[Schema.Struct<{
+    from: typeof Schema.String;
+    to: typeof Schema.String;
+    subject: typeof Schema.String;
+    created: typeof Schema.String;
+    body: typeof Schema.String;
+}>, Schema.Struct<{
+    feed: Ref.RefSchema<{
+        readonly name?: string | undefined;
+        readonly kind?: string | undefined;
+        readonly namespace?: "data" | "trace" | undefined;
+    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
+    item: typeof Schema.Any;
+    cursor: typeof Schema.String;
+}>, Schema.Struct<{
+    /**
+     * Type of the mutation.
+     */
+    type: typeof Schema.String;
+    /**
+     * Reference to the object that was changed or created.
+     */
+    subject: Ref.RefSchema<Obj.Unknown>;
+    /**
+     * @deprecated
+     */
+    changedObjectId: Schema.optional<typeof Schema.String>;
+}>, Schema.Struct<{
+    tick: typeof Schema.Number;
+}>, Schema.Struct<{
+    url: typeof Schema.String;
+    method: Schema.Literal<["GET", "POST"]>;
+    headers: Schema.Record$<typeof Schema.String, typeof Schema.String>;
+    bodyText: typeof Schema.String;
+}>]>;
+export type TriggerEvent = Schema.Schema.Type<typeof TriggerEvent>;
+//# sourceMappingURL=TriggerEvent.d.ts.map

package/dist/types/src/TriggerEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TriggerEvent.d.ts","sourceRoot":"","sources":["../../../src/TriggerEvent.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAQ,GAAG,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAQ5C,eAAO,MAAM,UAAU;;;;;;EAMrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC,CAAC;AAE/D,eAAO,MAAM,SAAS;;;;;;;;EAIpB,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC,CAAC;AAE7D,eAAO,MAAM,iBAAiB;IAC5B;;OAEG;;IAIH;;OAEG;;IAGH;;OAEG;;EAEH,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE7E,eAAO,MAAM,UAAU;;EAAyC,CAAC;AACjE,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC,CAAC;AAE/D,eAAO,MAAM,YAAY;;;;;EAKvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,YAAY,CAAC,CAAC;AAEnE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;IA7BvB;;OAEG;;IAIH;;OAEG;;IAGH;;OAEG;;;;;;;;;IAgBuG,CAAC;AAC7G,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,YAAY,CAAC,CAAC"}