@dxos/compute 0.10.0 → 0.11.0

package/src/{Skill.ts → types/Skill.ts}

@@ -15,8 +15,8 @@ import { BaseError } from '@dxos/errors';
 // eslint-disable-next-line unused-imports/no-unused-imports
 import { type Text } from '@dxos/schema';
 
-import * as McpServer from './McpServer';
-import * as Operation from './Operation';
+import * as McpServer from '../McpServer';
+import * as Operation from '../Operation';
 import * as Template from './Template';
 import * as Trigger from './Trigger';
 

package/src/{Template.test.ts → types/Template.test.ts}

@@ -9,8 +9,8 @@ import { describe, expect, test } from 'vitest';
 import { registryLayer } from '@dxos/echo-client';
 import { DXN } from '@dxos/keys';
 
-import { FunctionNotFoundError } from './errors';
-import * as Operation from './Operation';
+import { FunctionNotFoundError } from '../errors';
+import * as Operation from '../Operation';
 import * as Template from './Template';
 
 describe('Template', () => {

package/src/{Template.ts → types/Template.ts}

@@ -14,8 +14,8 @@ import { log } from '@dxos/log';
 import { Text } from '@dxos/schema';
 import Handlebars from '@dxos/vendor-kbn-handlebars';
 
-import { FunctionNotFoundError } from './errors';
-import * as Operation from './Operation';
+import { FunctionNotFoundError } from '../errors';
+import * as Operation from '../Operation';
 
 /**
  * Template input kind determines how template variables are resolved.

package/src/{Trigger.ts → types/Trigger.ts}

@@ -4,6 +4,10 @@
 
 // @import-as-namespace
 
+import type { Atom } from '@effect-atom/atom';
+import * as Context from 'effect/Context';
+import type * as Effect from 'effect/Effect';
+import * as Exit from 'effect/Exit';
 import * as Schema from 'effect/Schema';
 import * as SchemaAST from 'effect/SchemaAST';
 
@@ -11,14 +15,15 @@ import { Annotation, DXN, Feed, Obj, type Query, QueryAST, Ref, Type } from '@dx
 import { HiddenAnnotation } from '@dxos/echo/Annotation';
 import { OptionsAnnotationId } from '@dxos/echo/Format';
 
-import * as Runnable from './Runnable';
+import * as Runnable from '../Runnable';
+import type * as TriggerEvent from './TriggerEvent';
 
 /**
  * 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 const Kinds = ['email', 'feed', 'subscription', 'timer', 'webhook'] as const;
+export const Kinds = ['email', 'feed', 'direct', 'subscription', 'timer', 'webhook'] as const;
 export type Kind = (typeof Kinds)[number];
 
 const kindLiteralAnnotations = { title: 'Kind' };
@@ -90,6 +95,19 @@ export const specSubscription = (
     : undefined,
 });
 
+/**
+ * Direct invocation only; never scheduled by the dispatcher (invoked on demand by a caller).
+ */
+export const DirectSpec = Schema.Struct({
+  kind: Schema.Literal('direct').annotations(kindLiteralAnnotations),
+});
+export type DirectSpec = Schema.Schema.Type<typeof DirectSpec>;
+
+/**
+ * Construct a Direct trigger spec.
+ */
+export const specDirect = (): DirectSpec => ({ kind: 'direct' });
+
 /**
  * Cron timer.
  */
@@ -138,9 +156,11 @@ export const specWebhook = (opts?: { method?: string; port?: number }): WebhookS
 /**
  * Trigger schema.
  */
-export const Spec = Schema.Union(EmailSpec, FeedSpec, SubscriptionSpec, TimerSpec, WebhookSpec).annotations({
-  title: 'Trigger',
-});
+export const Spec = Schema.Union(EmailSpec, FeedSpec, DirectSpec, SubscriptionSpec, TimerSpec, WebhookSpec).annotations(
+  {
+    title: 'Trigger',
+  },
+);
 export type Spec = Schema.Schema.Type<typeof Spec>;
 
 /**
@@ -165,10 +185,23 @@ export class Trigger extends Type.makeObject<Trigger>(DXN.make('org.dxos.type.tr
   Schema.Struct({
     /**
      * Runnable (operation or workflow) to invoke.
+     * Wired programmatically (see plugin-routine's `wireTriggers`); not user-editable, so hidden from forms.
      */
-    runnable: Schema.optional(Ref.Ref(Runnable.Runnable).annotations({ title: 'Runnable' })),
-    spec: Schema.optional(Spec),
-    enabled: Schema.optional(Schema.Boolean),
+    runnable: Ref.Ref(Runnable.Runnable).pipe(
+      Schema.annotations({ title: 'Runnable' }),
+      Annotation.FormInputAnnotation.set(false),
+      Schema.optional,
+    ),
+
+    spec: Spec.pipe(Schema.optional),
+
+    enabled: Schema.Boolean.pipe(Schema.optional),
+
+    /**
+     * Runs this trigger on the edge rather than locally.
+     * When unset, the trigger runs locally on the client.
+     */
+    remote: Schema.Boolean.pipe(Schema.annotations({ title: 'Remote' }), Schema.optional),
 
     concurrency: Schema.Number.pipe(
       Schema.annotations({
@@ -199,3 +232,88 @@ export class Trigger extends Type.makeObject<Trigger>(DXN.make('org.dxos.type.tr
 ) {}
 
 export const make = (props: Obj.MakeProps<typeof Trigger>) => Obj.make(Trigger, props);
+
+/**
+ * Checks if a trigger having this spec can be manually invoked (a `direct` or `timer` trigger).
+ */
+export const isManuallyInvokable = (spec?: Spec): boolean => spec?.kind === 'direct' || spec?.kind === 'timer';
+
+/**
+ * Runtime state of a trigger.
+ */
+export interface State {
+  /**
+   * Reference to the trigger object.
+   */
+  readonly trigger: Ref.Ref<Trigger>;
+
+  /**
+   * Where is this trigger running.
+   */
+  readonly environment: 'edge' | 'local';
+
+  /**
+   * Next scheduled cron execution. Set only for `timer` triggers.
+   */
+  readonly nextExecution?: Date;
+
+  /**
+   * Time until which scheduled invocations of this trigger are skipped after a genuine failure.
+   * Applies to all trigger kinds. Manual {@link TriggerDispatcher.invokeTrigger} calls bypass it.
+   */
+  readonly cooldownUntil?: Date;
+
+  /**
+   * Pending re-invocation requested via {@link Operation.runAgain} ({@link RunAgainError}).
+   * Retries are drained at the tail of the invocation queue, ordered by `enqueuedAt`.
+   */
+  readonly retry?: {
+    /**
+     * Event to replay on the retry. Re-running is assumed safe with the same input.
+     */
+    readonly event: TriggerEvent.TriggerEvent;
+
+    /**
+     * Monotonic sequence number used to order pending retries FIFO at the tail of the queue.
+     */
+    readonly enqueuedAt: number;
+  };
+
+  /**
+   * Result of the most recent invocation of this trigger.
+   */
+  readonly lastResult: Exit.Exit<unknown> | null;
+}
+
+export interface InvokeOptions {
+  trigger: Trigger;
+  event: TriggerEvent.TriggerEvent;
+}
+
+/**
+ * Service for monitoring trigger dispatcher state.
+ */
+export interface Monitor {
+  /**
+   * Triggers actively registered in the dispatcher.
+   * Could contain entries for both local and edge triggers, but only the edge ones are actually running.
+   */
+  readonly triggers: Atom.Atom<readonly State[]>;
+
+  readonly localDispatcherEnabled: boolean;
+
+  /**
+   * Invoke a trigger.
+   * Available only for direct and timer triggers.
+   * Invocation respects the trigger's concurrency limit.
+   */
+  readonly invokeTrigger: (options: InvokeOptions) => Effect.Effect<void>;
+}
+
+/**
+ * Service for monitoring trigger executions.
+ */
+export class TriggerMonitorService extends Context.Tag('@dxos/functions/TriggerMonitorService')<
+  TriggerMonitorService,
+  Monitor
+>() {}

package/src/{TriggerEvent.ts → types/TriggerEvent.ts}

@@ -30,20 +30,26 @@ export const FeedEvent = Schema.Struct({
 });
 export type FeedEvent = Schema.Schema.Type<typeof FeedEvent>;
 
+/**
+ * Kind of mutation a subscription trigger observed for its subject.
+ */
+export const SubscriptionMutationType = Schema.Literal('created', 'updated', 'deleted');
+export type SubscriptionMutationType = Schema.Schema.Type<typeof SubscriptionMutationType>;
+
 export const SubscriptionEvent = Schema.Struct({
   /**
    * Type of the mutation.
    */
-  // TODO(dmaretskyi): Specify enum.
-  type: Schema.String,
+  type: SubscriptionMutationType,
 
   /**
-   * Reference to the object that was changed or created.
+   * Reference to the object that was changed or created. For `deleted`, carries the object's URI;
+   * dereferencing may yield `undefined` since the object is gone.
    */
   subject: Ref.Ref(Obj.Unknown),
 
   /**
-   * @deprecated
+   * @deprecated Use `subject`.
    */
   changedObjectId: Schema.optional(Schema.String),
 });
@@ -52,6 +58,11 @@ export type SubscriptionEvent = Schema.Schema.Type<typeof SubscriptionEvent>;
 export const TimerEvent = Schema.Struct({ tick: Schema.Number });
 export type TimerEvent = Schema.Schema.Type<typeof TimerEvent>;
 
+export const DirectEvent = Schema.Struct({
+  data: Schema.optional(Schema.Record({ key: Schema.String, value: Schema.Any })),
+});
+export type DirectEvent = Schema.Schema.Type<typeof DirectEvent>;
+
 export const WebhookEvent = Schema.Struct({
   url: Schema.String,
   method: Schema.Literal('GET', 'POST'),
@@ -60,5 +71,12 @@ export const WebhookEvent = Schema.Struct({
 });
 export type WebhookEvent = Schema.Schema.Type<typeof WebhookEvent>;
 
-export const TriggerEvent = Schema.Union(EmailEvent, FeedEvent, SubscriptionEvent, TimerEvent, WebhookEvent);
+export const TriggerEvent = Schema.Union(
+  EmailEvent,
+  FeedEvent,
+  DirectEvent,
+  SubscriptionEvent,
+  TimerEvent,
+  WebhookEvent,
+);
 export type TriggerEvent = Schema.Schema.Type<typeof TriggerEvent>;

package/src/types/index.ts

@@ -0,0 +1,12 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+export * as Instructions from './Instructions';
+export * as Project from './Project';
+export * as Routine from './Routine';
+export * as Script from './Script';
+export * as Skill from './Skill';
+export * as Template from './Template';
+export * as Trigger from './Trigger';
+export * as TriggerEvent from './TriggerEvent';

package/dist/lib/neutral/AgentService.mjs

@@ -1,12 +0,0 @@
-import {
-  AgentService,
-  getSession,
-  hydrate
-} from "./chunk-VSAZPWSJ.mjs";
-import "./chunk-J5LGTIGS.mjs";
-export {
-  AgentService,
-  getSession,
-  hydrate
-};
-//# sourceMappingURL=AgentService.mjs.map

package/dist/lib/neutral/AgentService.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": [],
-  "sourcesContent": [],
-  "mappings": "",
-  "names": []
-}

package/dist/lib/neutral/StorageService.mjs

@@ -1,22 +0,0 @@
-import {
-  StorageService,
-  cell,
-  clear,
-  deleteKey,
-  get,
-  list,
-  set,
-  withDefault
-} from "./chunk-PF7XP7XP.mjs";
-import "./chunk-J5LGTIGS.mjs";
-export {
-  StorageService,
-  cell,
-  clear,
-  deleteKey,
-  get,
-  list,
-  set,
-  withDefault
-};
-//# sourceMappingURL=StorageService.mjs.map

package/dist/lib/neutral/StorageService.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": [],
-  "sourcesContent": [],
-  "mappings": "",
-  "names": []
-}

package/dist/lib/neutral/chunk-2ZN64ZS7.mjs

@@ -1,25 +0,0 @@
-import {
-  Fibonacci
-} from "./chunk-5VAXF6AH.mjs";
-import {
-  withHandler
-} from "./chunk-EVROJER7.mjs";
-
-// src/testing/fib.ts
-import * as Effect from "effect/Effect";
-var fib_default = Fibonacci.pipe(withHandler(Effect.fn(function* ({ iterations = 1e5 }) {
-  let a = 0n;
-  let b = 1n;
-  for (let i = 0; i < iterations; i++) {
-    a += b;
-    b = a - b;
-  }
-  return {
-    result: a.toString()
-  };
-})));
-
-export {
-  fib_default
-};
-//# sourceMappingURL=chunk-2ZN64ZS7.mjs.map

package/dist/lib/neutral/chunk-2ZN64ZS7.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/testing/fib.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport * as Operation from '../Operation';\nimport { Fibonacci } from './definitions';\n\nexport default Fibonacci.pipe(\n  Operation.withHandler(\n    Effect.fn(function* ({ iterations = 100_000 }) {\n      let a = 0n;\n      let b = 1n;\n      for (let i = 0; i < iterations; i++) {\n        a += b;\n        b = a - b;\n      }\n      return { result: a.toString() };\n    }),\n  ),\n);\n"],
-  "mappings": ";;;;;;;;AAIA,YAAYA,YAAY;AAKxB,IAAA,cAAeC,UAAUC,KACbC,YACDC,UAAG,WAAW,EAAEC,aAAa,IAAO,GAAE;AAC3C,MAAIC,IAAI;AACR,MAAIC,IAAI;AACR,WAASC,IAAI,GAAGA,IAAIH,YAAYG,KAAK;AACnCF,SAAKC;AACLA,QAAID,IAAIC;EACV;AACA,SAAO;IAAEE,QAAQH,EAAEI,SAAQ;EAAG;AAChC,CAAA,CAAA,CAAA;",
-  "names": ["Effect", "Fibonacci", "pipe", "withHandler", "fn", "iterations", "a", "b", "i", "result", "toString"]
-}

package/dist/lib/neutral/chunk-5VAXF6AH.mjs

@@ -1,53 +0,0 @@
-import {
-  make
-} from "./chunk-EVROJER7.mjs";
-
-// src/testing/definitions.ts
-import * as Schema from "effect/Schema";
-import { DXN } from "@dxos/keys";
-var Fibonacci = make({
-  meta: {
-    key: DXN.make("org.example.function.fib"),
-    name: "Fibonacci",
-    description: "Function that calculates a Fibonacci number"
-  },
-  input: Schema.Struct({
-    iterations: Schema.optional(Schema.Number).annotations({
-      description: "Number of iterations",
-      default: 1e5
-    })
-  }),
-  output: Schema.Struct({
-    result: Schema.String
-  })
-});
-var Reply = make({
-  meta: {
-    key: DXN.make("org.example.function.reply"),
-    name: "Reply",
-    description: "Function that echoes the input"
-  },
-  input: Schema.Any,
-  output: Schema.Any
-});
-var Sleep = make({
-  meta: {
-    key: DXN.make("org.example.function.sleep"),
-    name: "Sleep",
-    description: "Function that sleeps for a given amount of time"
-  },
-  input: Schema.Struct({
-    duration: Schema.optional(Schema.Number).annotations({
-      description: "Milliseconds to sleep",
-      default: 1e5
-    })
-  }),
-  output: Schema.Void
-});
-
-export {
-  Fibonacci,
-  Reply,
-  Sleep
-};
-//# sourceMappingURL=chunk-5VAXF6AH.mjs.map

package/dist/lib/neutral/chunk-5VAXF6AH.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/testing/definitions.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { DXN } from '@dxos/keys';\n\nimport * as Operation from '../Operation';\n\nexport const Fibonacci = Operation.make({\n  meta: {\n    key: DXN.make('org.example.function.fib'),\n    name: 'Fibonacci',\n    description: 'Function that calculates a Fibonacci number',\n  },\n  input: Schema.Struct({\n    iterations: Schema.optional(Schema.Number).annotations({\n      description: 'Number of iterations',\n      default: 100_000,\n    }),\n  }),\n  output: Schema.Struct({\n    result: Schema.String,\n  }),\n});\n\nexport const Reply = Operation.make({\n  meta: {\n    key: DXN.make('org.example.function.reply'),\n    name: 'Reply',\n    description: 'Function that echoes the input',\n  },\n  input: Schema.Any,\n  output: Schema.Any,\n});\n\nexport const Sleep = Operation.make({\n  meta: {\n    key: DXN.make('org.example.function.sleep'),\n    name: 'Sleep',\n    description: 'Function that sleeps for a given amount of time',\n  },\n  input: Schema.Struct({\n    duration: Schema.optional(Schema.Number).annotations({\n      description: 'Milliseconds to sleep',\n      default: 100_000,\n    }),\n  }),\n  output: Schema.Void,\n});\n"],
-  "mappings": ";;;;;AAIA,YAAYA,YAAY;AAExB,SAASC,WAAW;AAIb,IAAMC,YAAsBC,KAAK;EACtCC,MAAM;IACJC,KAAKC,IAAIH,KAAK,0BAAA;IACdI,MAAM;IACNC,aAAa;EACf;EACAC,OAAcC,cAAO;IACnBC,YAAmBC,gBAAgBC,aAAM,EAAEC,YAAY;MACrDN,aAAa;MACbO,SAAS;IACX,CAAA;EACF,CAAA;EACAC,QAAeN,cAAO;IACpBO,QAAeC;EACjB,CAAA;AACF,CAAA;AAEO,IAAMC,QAAkBhB,KAAK;EAClCC,MAAM;IACJC,KAAKC,IAAIH,KAAK,4BAAA;IACdI,MAAM;IACNC,aAAa;EACf;EACAC,OAAcW;EACdJ,QAAeI;AACjB,CAAA;AAEO,IAAMC,QAAkBlB,KAAK;EAClCC,MAAM;IACJC,KAAKC,IAAIH,KAAK,4BAAA;IACdI,MAAM;IACNC,aAAa;EACf;EACAC,OAAcC,cAAO;IACnBY,UAAiBV,gBAAgBC,aAAM,EAAEC,YAAY;MACnDN,aAAa;MACbO,SAAS;IACX,CAAA;EACF,CAAA;EACAC,QAAeO;AACjB,CAAA;",
-  "names": ["Schema", "DXN", "Fibonacci", "make", "meta", "key", "DXN", "name", "description", "input", "Struct", "iterations", "optional", "Number", "annotations", "default", "output", "result", "String", "Reply", "Any", "Sleep", "duration", "Void"]
-}