@dxos/compute 0.9.1-staging.ee54ba693a → 0.11.0

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

@@ -7,7 +7,7 @@ import * as Schema$ from 'effect/Schema';
 import type * as Types from 'effect/Types';
 import { Annotation, DXN, type Key, Migration, Obj, Type } from '@dxos/echo';
 import type { URI } from '@dxos/keys';
-import type { NoHandlerError } from './errors';
+import { type NoHandlerError } from './errors';
 import type { Operation } from './index';
 /**
  * Schema type that accepts any Encoded form but requires no Context.
@@ -293,6 +293,25 @@ export declare const NotifyOptionsAnnotation: Annotation.Annotation<{
         defaultValue?: string | undefined;
     }] | undefined;
 }>;
+/**
+ * A serializable reference to an operation invocation — the target operation's key plus its input.
+ * Describes a deferred/late-bound invocation that must survive a serialization boundary (e.g. riding
+ * on a process-failure error, or persisted) where a live {@link Definition} cannot. Resolve the key
+ * with `OperationHandlerSet.getHandlerByKey` and hand the result to the invoker. Carries no functions,
+ * so `input` must itself be serializable.
+ */
+export interface SerializedInvocation {
+    /** Target operation key as a URI (a DXN, e.g. `dxn:org.dxos.plugin.deck.operation.open`). */
+    readonly operation: URI.URI;
+    /** Input passed to the operation; must be serializable. */
+    readonly input?: unknown;
+}
+/**
+ * Builds a {@link SerializedInvocation} from a live {@link Definition} and its input — the serializable
+ * counterpart to a direct `invoke`, for describing an invocation that must cross a serialization
+ * boundary (e.g. a deferred toast action). Resolve it later with `OperationHandlerSet.getHandlerByKey`.
+ */
+export declare const prepare: <I, O>(operation: Definition<I, O>, input: I) => SerializedInvocation;
 /**
  * Options for operation invocation.
  */
@@ -316,6 +335,11 @@ export interface InvokeOptions {
      * Optional process-runtime tracing metadata (consumed by `@dxos/functions-runtime` when wired).
      */
     tracing?: unknown;
+    /**
+     * Specifies the runtime environment for the operation.
+     * By default, the operation is executed on the local runtime.
+     */
+    on?: 'edge' | 'local';
 }
 /**
  * Annotation that marks an operation as idempotent — safe to retry even if a previous execution
@@ -355,6 +379,53 @@ export declare const visible: <Def extends Definition.Any>(op: Def) => Def;
  * pickers, manual invocation). Reads from the persisted operation — the form every consumer holds.
  */
 export declare const isVisible: (op: PersistentOperation) => boolean;
+/**
+ * Projection marker for an operation exposed as an MCP tool to external agents.
+ * See plugin-projects `MILESTONE-5.md` §7.4 for the full contract.
+ */
+export declare const McpTool: Schema.Struct<{
+    /** Tool name as exposed to MCP clients; camelCase, domain-prefixed (e.g. `taskCreate`). */
+    name: typeof Schema.String;
+    /** Model-facing description; falls back to the operation's own description when absent. */
+    description: Schema.optional<typeof Schema.String>;
+    /**
+     * Safety class the server maps to MCP tool hints: `read` is side-effect free (readOnlyHint),
+     * `write` mutates space data, `destructive` deletes or is otherwise irreversible.
+     */
+    safety: Schema.Literal<["read", "write", "destructive"]>;
+    /** Aspect/toolset, for server-side filtering (e.g. `/mcp?toolsets=tasks`). */
+    aspect: Schema.optional<typeof Schema.String>;
+}>;
+export type McpTool = Schema$.Schema.Type<typeof McpTool>;
+/**
+ * Annotation that opts an operation into MCP projection. The annotation rides through
+ * {@link serialize} into the persisted record, so a remote projector (edge mcp-space-service)
+ * discovers tools from the operation registry rather than a hand-maintained table.
+ *
+ * Projected operations must be remotely invocable: refs (not live objects) in, JSON snapshots
+ * out, schemas that survive serialization, and worker-safe handlers — MILESTONE-5.md §7.4.
+ */
+export declare const McpToolAnnotation: Annotation.Annotation<{
+    readonly name: string;
+    readonly description?: string | undefined;
+    readonly safety: "destructive" | "read" | "write";
+    readonly aspect?: string | undefined;
+}>;
+/**
+ * Pipeable combinator that opts an operation into MCP projection. Apply at the definition site:
+ * `Operation.make({ ... }).pipe(Operation.mcpTool({ name: 'taskComplete', safety: 'write' }))`.
+ */
+export declare const mcpTool: (props: McpTool) => <Def extends Definition.Any>(op: Def) => Def;
+/**
+ * Returns the MCP projection descriptor when the operation is annotated for it, else undefined.
+ * Reads from the persisted operation — the form the projector holds.
+ */
+export declare const getMcpTool: (op: PersistentOperation) => McpTool | undefined;
+/**
+ * Pipeable combinator that marks an operation idempotent — see {@link IdempotentAnnotation}. Apply at
+ * the definition site: `Operation.make({ ... }).pipe(Operation.idempotent)`.
+ */
+export declare const idempotent: <Def extends Definition.Any>(op: Def) => Def;
 /**
  * Operation service interface - provides unified access to operation invocation and scheduling.
  * This service is automatically provided to operation handlers.
@@ -419,6 +490,13 @@ export declare const invoke: <I, O>(op: Operation.Definition<I, O>, ...args: voi
  * ```
  */
 export declare const schedule: <I, O>(op: Operation.Definition<I, O>, ...args: void extends I ? [input?: I, options?: InvokeOptions] : [input: I, options?: InvokeOptions]) => Effect.Effect<void, never, Service>;
+/**
+ * Call inside an operation to stop the current invocation and have the system re-run it (e.g. a capped
+ * sync run with more work left). Surfaces as a {@link RunAgainError} defect; the trigger dispatcher
+ * re-queues the same event FIFO to continue. A caller invoking via `Operation.invoke` directly gets the
+ * defect and does not auto-continue.
+ */
+export declare const runAgain: () => Effect.Effect<never, void>;
 /**
  * Provides additional invocation options to all invocations.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"Operation.d.ts","sourceRoot":"","sources":["../../../src/Operation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,OAAO,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,GAAG,EAAc,KAAK,GAAG,EAAE,SAAS,EAAE,GAAG,EAAO,IAAI,EAAE,MAAM,YAAY,CAAC;AAC9F,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;GAGG;AACH,KAAK,MAAM,CAAC,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAE/C,eAAO,MAAM,gBAAgB,EAAG,sCAA+C,CAAC;AAChF,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,GAAG,CAAE,SAAQ,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAChG;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAE3B,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B;;WAEG;QACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB;;;WAGG;QACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAE7B;;WAEG;QAEH,QAAQ,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC;QAE7C;;;WAGG;QACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;KACjC,CAAC;IAEF;;;;OAIG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;IAEzC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,CAAC,SAAS,EAAE,CAAC;IAE1C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC,CAAC;IACnC,UAAiB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAC/B,CAAC,gBAAgB,CAAC,EAAE;YAClB,SAAS,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YACxC,SAAS,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACrC,SAAS,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;SACxC,CAAC;KACH;IAED;;OAEG;IACH,KAAY,GAAG,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAE5C;;OAEG;IACH,KAAY,KAAK,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAE/F;;OAEG;IACH,KAAY,MAAM,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,QAAQ,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAEhG;;;OAGG;IACH,KAAY,QAAQ,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,QAAQ,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAElG,KAAY,WAAW,CAAC,CAAC,SAAS,GAAG,IACnC,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC;CACjF;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAEvF,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,UAAU,CAAC,GAAG,IAAI,CAAC,GAAG;IACtD,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,UAAW,OAAO,KAAG,KAAK,IAAI,UAAU,CAAC,GAE1E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,UAAW,OAAO,KAAG,KAAK,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,CAE1F,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,GAAG,eAAe,GAAG,OAAO,GAAG,UAAU,CAAC,GAAG;IACrH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;CAClD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,IAAI,GAAI,KAAK,CAAC,CAAC,SAAS,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,SACxE,CAAC,KACP,UAAU,CACX,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAC/B,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAChC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAa3D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,WAAW,EAAE;IACxB,CAAC,GAAG,SAAS,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAC1C,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GACrG,CAAC,EAAE,EAAE,GAAG,KAAK,WAAW,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC,GAAG,SAAS,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAC1C,EAAE,EAAE,GAAG,EACP,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GACrG,WAAW,CAAC,GAAG,CAAC,CAAC;CAyBrB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,SAAS,CAAC,UAAU,CAAC,GAAG,WACrD,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,KAChC,SAAS,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAY,CAAC;AAM9D;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAEtF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACjC,EAAE,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EACpB,KAAK,EAAE,CAAC,EACR,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;;;;;;;;;;;;AAEzB;;;;GAIG;AAGH,qBAAa,mBAAoB,SAAQ,wBAuCxC;CAAG;AAIJ;;GAEG;AACH,eAAO,MAAM,MAAM,WAAY,mBAAmB,KAAG,MAAM,GAAG,SAAoC,CAAC;AAEnG;;GAEG;AACH,eAAO,MAAM,UAAU,WAAY,mBAAmB,KAAG,MAAM,GAAG,SAAwC,CAAC;AAE3G;;GAEG;AACH,eAAO,MAAM,SAAS,cAAe,UAAU,CAAC,GAAG,KAAG,mBAiBrD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,WAAY,mBAAmB,KAAG,UAAU,CAAC,GAoBpE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,WAAY,mBAAmB,UAAU,mBAAmB,SAoB/E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,KAAK;;;;OAgBjB,CAAC;AACF,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,aAAa;IACxB,wCAAwC;;;;;;IAExC,0CAA0C;;;;;;IAE1C,uCAAuC;;;;;;EAEvC,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,aAAa,CAAC,CAAC;AAErE;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;EAGlC,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,OAAO,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;IACtB;;OAEG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC;IACvB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,gCAG/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY,OAAQ,UAAU,CAAC,GAAG,KAAG,OAGvC,CAAC;AAEZ;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,GAClB,CAAC,cAAc,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,MACjD,GAAG,SAAS,UAAU,CAAC,GAAG,MAAM,GAAG,KAAG,GAMtC,CAAC;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,gCAG5B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,OAAO,GAxBjB,GAAG,SAAS,UAAU,CAAC,GAAG,iBAwB2B,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,SAAS,OAAQ,mBAAmB,KAAG,OACkB,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EACX,EAAE,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EAC9B,GAAG,IAAI,EAAE,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,KACjG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IAEtC;;;;OAIG;IACH,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EACb,EAAE,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EAC9B,GAAG,IAAI,EAAE,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,KACjG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAEzB;;;OAGG;IACH,aAAa,EAAE,CAAC,CAAC,EAAE,CAAC,EAClB,EAAE,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EAC9B,GAAG,IAAI,EAAE,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,KACjG,OAAO,CAAC;QAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;CAC3C;;AAED;;;;;;;;;;;;;;GAcG;AAEH,qBAAa,OAAQ,SAAQ,YAAmE;CAAG;AAMnG;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,EAAE,CAAC,MACrB,SAAS,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,WACrB,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,KACnG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAGxC,CAAC;AAEJ;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,CAAC,MACvB,SAAS,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,WACrB,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,KACnG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAGlC,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,qBAAqB,YAAa,aAAa,KAAG,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAc/F,CAAC;;;;;;;;;;;;;AAMJ;;;GAGG;AACH,qBAAa,0BAA2B,SAAQ,+BAe/C;CAAG;AAsBJ;;;GAGG;AACH,eAAO,MAAM,UAAU,6BAAe,CAAC"}
+{"version":3,"file":"Operation.d.ts","sourceRoot":"","sources":["../../../src/Operation.ts"],"names":[],"mappings":"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"}

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

@@ -7,9 +7,11 @@ import type * as Exit from 'effect/Exit';
 import * as Option from 'effect/Option';
 import * as Schema from 'effect/Schema';
 import * as Scope from 'effect/Scope';
+import * as Stream from 'effect/Stream';
 import type * as Types from 'effect/Types';
 import { Annotation } from '@dxos/echo';
 import { URI } from '@dxos/keys';
+import type { SerializedError } from '@dxos/protocols';
 import * as Operation from './Operation';
 import * as OperationHandlerSet from './OperationHandlerSet';
 import * as StorageService from './StorageService';
@@ -146,6 +148,11 @@ export declare const NotifyAnnotation: Annotation.Annotation<{
         defaultValue?: string | undefined;
     }] | undefined;
 }>;
+/**
+ * URI of the Instructions object steering the process's conversation. Persisted at spawn (like
+ * {@link TargetAnnotation}) so a re-hydrated process recovers its steering without reaching the Chat.
+ */
+export declare const InstructionsAnnotation: Annotation.Annotation<URI.URI>;
 /**
  * Marks a process as the harness host for its conversation (discovery substrate).
  */
@@ -222,6 +229,11 @@ export interface Monitor {
      * Atom for the process tree.
      */
     processTreeAtom: Atom.Atom<readonly Info[]>;
+    /**
+     * Stream ephemeral trace messages matching `filter` (DX-1125), sourced from local in-process
+     * runtimes and remote runtimes broadcasting over the space swarm. Used to drive live progress UI.
+     */
+    subscribeToTraceMessages(filter: Trace.Filter): Stream.Stream<Trace.Message>;
 }
 declare const ProcessMonitorService_base: Context.TagClass<ProcessMonitorService, "@dxos/functions/ProcessMonitorService", Monitor>;
 export declare class ProcessMonitorService extends ProcessMonitorService_base {
@@ -244,10 +256,10 @@ export interface Info {
      */
     readonly state: State;
     /**
-     * Error of the process.
-     * Only for process in FAILED state.
+     * How the process failed as a serializable {@link SerializedError} (its `context` carries any
+     * structured detail, e.g. a notify override), or `null` unless it is in FAILED state.
      */
-    readonly error: string | null;
+    readonly error: SerializedError | null;
     /**
      * UNIX timestamp in milliseconds.
      */

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

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

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

@@ -3,7 +3,7 @@ import * as Effect from 'effect/Effect';
 import * as Layer from 'effect/Layer';
 import * as Schema from 'effect/Schema';
 import { Obj, Ref, Type } from '@dxos/echo';
-import * as Trigger from './Trigger';
+import * as Trigger from './types/Trigger';
 /**
  * Writes ephemeral or persistent events to the trace.
  * Exposed to processes and operations to record events to the trace.
@@ -171,6 +171,52 @@ export interface FlatEvent extends Event {
  * Flattens a trace message into a list of flat events.
  */
 export declare const flatten: (message: Message) => FlatEvent[];
+/**
+ * `google.protobuf.Any` type URL for a trace message broadcast over the swarm.
+ */
+export declare const TRACE_MESSAGE_TYPE_URL = "dxos.compute.TraceMessage";
+/**
+ * Declarative, serializable filter over trace messages. All present fields are ANDed. `type` matches
+ * against event types within the message; the rest match against {@link Meta} fields. Refs
+ * (`conversation`, `trigger`) are matched by their DXN string.
+ */
+export interface Filter {
+    readonly type?: string;
+    readonly pid?: string;
+    readonly parentPid?: string;
+    readonly conversation?: string;
+    readonly trigger?: string;
+    readonly space?: string;
+    readonly runtimeName?: string;
+    readonly toolCallId?: string;
+}
+/**
+ * Derive the flat broadcast tag list for a message (DX-1125). The publisher emits all applicable tags;
+ * subscribers match a subset (logical OR).
+ */
+export declare const messageToTags: (message: Pick<MessageData, 'meta' | 'events'>) => string[];
+/**
+ * Pick the coarse subscription tag for a filter (DX-1125). The swarm cuts traffic to a superset of the
+ * filter using its most selective present dimension; the client re-applies the exact filter.
+ */
+export declare const subscriptionTagForFilter: (filter: Filter) => string | undefined;
+/**
+ * Exact (AND) filter match applied client-side after the coarse swarm subscription.
+ */
+export declare const matchesFilter: (message: Pick<MessageData, 'meta' | 'events'>, filter: Filter) => boolean;
+/**
+ * Encode a trace message for the broadcast envelope's `google.protobuf.Any.value` (DX-1125).
+ * The wire format is UTF-8 JSON of the message data (ref fields dropped — see {@link encodeMetaForWire}).
+ */
+export declare const encodeTraceMessage: (message: Pick<MessageData, 'meta' | 'isEphemeral' | 'events'>) => Uint8Array;
+/**
+ * Decode a broadcast trace message back into a {@link Message} object (DX-1125). The wire payload
+ * drops both ref meta fields (see {@link encodeMetaForWire}), so `tags` — the broadcast envelope's
+ * tag list — is required to restore them: `trigger` addresses work for cancellation, and
+ * `conversation` is what {@link matchesFilter} compares, so a subscription filtered by it matches
+ * nothing without this. Restored refs are address-only (`.uri`); they are never resolved.
+ */
+export declare const decodeTraceMessage: (bytes: Uint8Array, tags?: readonly string[]) => Message;
 /**
  * Sink for complete trace messages.
  */
@@ -258,11 +304,17 @@ export declare const OperationOutput: EventType<{
  * Human-readable status update emitted by an agent or operation.
  */
 export declare const StatusUpdate: EventType<{
-    readonly message: string;
+    readonly message?: string | undefined;
+    readonly progress?: {
+        readonly key: string;
+        readonly current?: number | undefined;
+        readonly total?: number | undefined;
+        readonly estimate?: number | undefined;
+    } | undefined;
 }>;
 /**
  * Emit the current human-readable execution status to the trace.
  */
-export declare const emitStatus: (message: string) => Effect.Effect<void, never, TraceService>;
+export declare const emitStatus: (messageOrData: string | PayloadType<typeof StatusUpdate>) => Effect.Effect<void, never, TraceService>;
 export {};
 //# sourceMappingURL=Trace.d.ts.map

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

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Trace.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Trace.test.d.ts","sourceRoot":"","sources":["../../../src/Trace.test.ts"],"names":[],"mappings":""}

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

@@ -1,4 +1,39 @@
 import { BaseError, type BaseErrorOptions } from '@dxos/errors';
+declare const RunAgainError_base: {
+    new (options?: BaseErrorOptions): {
+        cause?: unknown;
+        stack?: string;
+        name: "RunAgainError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "RunAgainError";
+    };
+    isError(error: unknown): error is Error;
+    name: "RunAgainError";
+    is(error: unknown): error is BaseError;
+    wrap(options?: Omit<BaseErrorOptions, 'cause'> & {
+        ifTypeDiffers?: boolean;
+    }): (error: unknown) => {
+        cause?: unknown;
+        stack?: string;
+        name: "RunAgainError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "RunAgainError";
+    };
+    extend<Name extends string = string>(name: Name, message?: string): any;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/**
+ * Raised when a function wants to yield to the scheduler to not exceed platform limits.
+ * The scheduler will re-run the function after the yield.
+ * It is assumed that the function can be retried with the same input.
+ * The function might have produced side-effects on the first run.
+ */
+export declare class RunAgainError extends RunAgainError_base {
+}
 declare const InvokerNotInitializedError_base: {
     new (options?: BaseErrorOptions): {
         cause?: unknown;
@@ -27,7 +62,6 @@ declare const InvokerNotInitializedError_base: {
     stackTraceLimit: number;
 };
 export declare class InvokerNotInitializedError extends InvokerNotInitializedError_base {
-    constructor();
 }
 declare const NoHandlerError_base: {
     new (options?: BaseErrorOptions): {

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/errors.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIhE,qBAAa,0BAA2B,SAAQ,+BAG/C;IACC,cAEC;CACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAED,qBAAa,cAAe,SAAQ,mBAAsE;IACxG,YAAY,YAAY,EAAE,MAAM,EAE/B;CACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAID,qBAAa,wBAAyB,SAAQ,6BAAgE;IAC5G,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,EAEvE;CACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAED,qBAAa,qBAAsB,SAAQ,0BAA0D;IACnG,YAAY,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,EAE3E;CACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAED,qBAAa,aAAc,SAAQ,kBAA8D;CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEpG,qBAAa,0BAA2B,SAAQ,+BAG/C;CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEJ,qBAAa,2BAA4B,SAAQ,gCAGhD;CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEJ,qBAAa,yBAA0B,SAAQ,8BAAmE;CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAErH;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,6BAG7C;CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEJ;;;;GAIG;AACH,qBAAa,+BAAgC,SAAQ,oCAGpD;CAAG"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/errors.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEhE;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,kBAA8C;CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIpF,qBAAa,0BAA2B,SAAQ,+BAG/C;CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEJ,qBAAa,cAAe,SAAQ,mBAAsE;IACxG,YAAY,YAAY,EAAE,MAAM,EAE/B;CACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAID,qBAAa,wBAAyB,SAAQ,6BAAgE;IAC5G,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,EAEvE;CACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAED,qBAAa,qBAAsB,SAAQ,0BAA0D;IACnG,YAAY,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,EAE3E;CACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAED,qBAAa,aAAc,SAAQ,kBAA8D;CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEpG,qBAAa,0BAA2B,SAAQ,+BAG/C;CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEJ,qBAAa,2BAA4B,SAAQ,gCAGhD;CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEJ,qBAAa,yBAA0B,SAAQ,8BAAmE;CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAErH;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,6BAG7C;CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEJ;;;;GAIG;AACH,qBAAa,+BAAgC,SAAQ,oCAGpD;CAAG"}

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

@@ -1,9 +1,10 @@
 export * from './errors';
+export * from './types';
+export * as AgentIdentity from './AgentIdentity';
 export * as AgentService from './AgentService';
-export * as Skill from './Skill';
+export * as Cancellation from './Cancellation';
 export * as Credential from './Credential';
 export * as Header from './Header';
-export * as Instructions from './Instructions';
 export * as LayerSpec from './LayerSpec';
 export * as McpServer from './McpServer';
 export * as Operation from './Operation';
@@ -11,11 +12,7 @@ export * as OperationHandlerSet from './OperationHandlerSet';
 export * as OperationRegistry from './OperationRegistry';
 export * as Process from './Process';
 export * as Runnable from './Runnable';
-export * as Script from './Script';
 export * as ServiceResolver from './ServiceResolver';
 export * as StorageService from './StorageService';
-export * as Template from './Template';
 export * as Trace from './Trace';
-export * as Trigger from './Trigger';
-export * as TriggerEvent from './TriggerEvent';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC;AAEzB,OAAO,KAAK,YAAY,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,YAAY,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,mBAAmB,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,iBAAiB,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,eAAe,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,cAAc,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,YAAY,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AAExB,OAAO,KAAK,aAAa,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,YAAY,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,YAAY,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,mBAAmB,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,iBAAiB,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,eAAe,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,cAAc,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC"}

package/dist/types/src/testing/index.d.ts

@@ -3,5 +3,6 @@ export { Fibonacci, Reply, Sleep } from './definitions';
 export { default as FibonacciHandler } from './fib';
 export { default as ReplyHandler } from './reply';
 export { default as SleepHandler } from './sleep';
+export * from './operation';
 export declare const ExampleHandlers: OperationHandlerSet.OperationHandlerSet;
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/testing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/testing/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,mBAAmB,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,SAAS,CAAC;AAElD,eAAO,MAAM,eAAe,yCAI3B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/testing/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,mBAAmB,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,SAAS,CAAC;AAClD,cAAc,aAAa,CAAC;AAE5B,eAAO,MAAM,eAAe,yCAI3B,CAAC"}

package/dist/types/src/testing/operation.d.ts

@@ -0,0 +1,5 @@
+import * as Layer from 'effect/Layer';
+import * as Operation from '../Operation';
+/** Noop `Operation.Service` for tests that must satisfy the type without invoking it. */
+export declare const operationServiceLayerNoop: Layer.Layer<Operation.Service>;
+//# sourceMappingURL=operation.d.ts.map

package/dist/types/src/testing/operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../../../src/testing/operation.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,KAAK,SAAS,MAAM,cAAc,CAAC;AAS1C,yFAAyF;AACzF,eAAO,MAAM,yBAAyB,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAGpE,CAAC"}

package/dist/types/src/{Instructions.d.ts → types/Instructions.d.ts}

@@ -2,6 +2,13 @@ import * as Schema from 'effect/Schema';
 import { Obj, Ref, Type } from '@dxos/echo';
 import { Text } from '@dxos/schema';
 import * as Skill from './Skill';
+/** A sentinel command the model recognizes in chat (e.g. `$track <text>`). */
+export declare const Command: Schema.Struct<{
+    sentinel: Schema.SchemaClass<string, string, never>;
+    description: Schema.optional<typeof Schema.String>;
+    prompt: Schema.SchemaClass<string, string, never>;
+}>;
+export type Command = Schema.Schema.Type<typeof Command>;
 declare const Instructions_base: Type.ObjClass<Instructions, {
     readonly name?: string | undefined;
     readonly description?: string | undefined;
@@ -10,6 +17,11 @@ declare const Instructions_base: Type.ObjClass<Instructions, {
     readonly text: import("@dxos/echo/internal").Ref<Text.Text & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
     readonly skills: readonly import("@dxos/echo/internal").Ref<Skill.Skill & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>[];
     readonly objects?: readonly import("@dxos/echo/internal").Ref<Obj.Unknown>[] | undefined;
+    readonly commands?: readonly {
+        readonly sentinel: string;
+        readonly description?: string | undefined;
+        readonly prompt: string;
+    }[] | undefined;
 }, {}>;
 /**
  * Prompt-based operation.
@@ -26,8 +38,9 @@ export type MakeProps = {
     text?: string;
     skills?: Ref.Ref<Skill.Skill>[];
     objects?: Ref.Ref<Obj.Unknown>[];
+    commands?: Command[];
 };
 /** Creates an Instructions object with an owned Markdown `text` body (parented so it cascades and deep-clones). */
-export declare const make: ({ name, description, input, output, text, skills, objects }: MakeProps) => Instructions;
+export declare const make: ({ name, description, input, output, text, skills, objects, commands, }: MakeProps) => Instructions;
 export {};
 //# sourceMappingURL=Instructions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Instructions.d.ts","sourceRoot":"","sources":["../../../../src/types/Instructions.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAuC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AAEjC,8EAA8E;AAC9E,eAAO,MAAM,OAAO;;;;EAIlB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC,CAAC;;;;;;;;;;;;;;;AAEzD;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,iBA4BjC;CAAG;AAEJ,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;IAChC,OAAO,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB,CAAC;AAEF,mHAAmH;AACnH,eAAO,MAAM,IAAI,2EASd,SAAS,KAAG,YAgBd,CAAC"}

package/dist/types/src/types/Instructions.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Instructions.test.d.ts.map

package/dist/types/src/types/Instructions.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Instructions.test.d.ts","sourceRoot":"","sources":["../../../../src/types/Instructions.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,53 @@
+import * as Schema from 'effect/Schema';
+import { Collection, Obj, Ref, Type } from '@dxos/echo';
+import { Outline, TaskSet } from '@dxos/types';
+import * as Instructions from './Instructions';
+import * as Routine from './Routine';
+import type * as Skill from './Skill';
+/** Lightweight inline goal: per-item status and addressability without document ceremony. */
+export declare const Goal: Schema.Struct<{
+    id: typeof Schema.String;
+    text: typeof Schema.String;
+    status: Schema.optional<Schema.Literal<["open", "met", "dropped"]>>;
+}>;
+export type Goal = Schema.Schema.Type<typeof Goal>;
+declare const Project_base: Type.ObjClass<Project, {
+    readonly name?: string | undefined;
+    readonly description?: string | undefined;
+    readonly instructions?: import("@dxos/echo/internal").Ref<Instructions.Instructions & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown> | undefined;
+    readonly routines: readonly import("@dxos/echo/internal").Ref<Routine.Routine & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>[];
+    readonly artifacts?: import("@dxos/echo/internal").Ref<Collection.Collection & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown> | undefined;
+    readonly goals?: readonly {
+        readonly id: string;
+        readonly text: string;
+        readonly status?: "dropped" | "met" | "open" | undefined;
+    }[] | undefined;
+    readonly outline?: import("@dxos/echo/internal").Ref<Outline.Outline & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown> | undefined;
+    readonly taskSet?: import("@dxos/echo/internal").Ref<TaskSet.TaskSet & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown> | undefined;
+}, {}>;
+/**
+ * A user-facing container for interactive, long-running work: instructions (skills + commands),
+ * routines, artifacts, and AI chat sessions in project context. Successor to `Topic`.
+ * Chats and agents attach via relations/queries (assistant-toolkit depends on compute, so no typed refs here).
+ */
+export declare class Project extends Project_base {
+}
+/** Factory wrapper around `Obj.make` for {@link Project}. */
+export declare const make: (props?: Omit<Partial<Obj.MakeProps<typeof Project>>, 'routines'> & {
+    routines?: ReadonlyArray<Ref.Ref<Routine.Routine>>;
+}) => Project;
+/** Bindings a chat session should receive when running in a project's context. */
+export type ContextBindings = {
+    skills: Ref.Ref<Skill.Skill>[];
+    objects: Ref.Ref<Obj.Unknown>[];
+};
+/**
+ * Bindings a chat session should receive when running in this project's context: the instructions'
+ * skills and context objects. The instructions object itself is NOT bound — its text/commands reach
+ * the system prompt through the chat's `instructions` ref, and a bound Instructions object would
+ * render as an inert context stub. Requires the instructions ref to be resolved (`.target`);
+ * unresolved refs contribute nothing.
+ */
+export declare const contextBindings: (project: Project) => ContextBindings;
+export {};
+//# sourceMappingURL=Project.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Project.d.ts","sourceRoot":"","sources":["../../../../src/types/Project.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAc,UAAU,EAAO,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEzE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,YAAY,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,KAAK,KAAK,MAAM,SAAS,CAAC;AAEtC,6FAA6F;AAC7F,eAAO,MAAM,IAAI;;;;EAIf,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;;;;;;;;;;;;;;;AAEnD;;;;GAIG;AACH,qBAAa,OAAQ,SAAQ,YA2B5B;CAAG;AAEJ,6DAA6D;AAC7D,eAAO,MAAM,IAAI,WACR,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,OAAO,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG;IAChE,QAAQ,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;CACpD,KACA,OAA0E,CAAC;AAE9E,kFAAkF;AAClF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;IAC/B,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;CACjC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,YAAa,OAAO,KAAG,eAmBlD,CAAC"}

package/dist/types/src/types/Project.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Project.test.d.ts.map

package/dist/types/src/types/Project.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Project.test.d.ts","sourceRoot":"","sources":["../../../../src/types/Project.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,42 @@
+import * as Schema from 'effect/Schema';
+import { Obj, Ref, Type } from '@dxos/echo';
+import type * as Operation from '../Operation';
+import * as Instructions from './Instructions';
+import * as Trigger from './Trigger';
+declare const Kinds: readonly ['runnable', 'instructions'];
+export declare const Kind: Schema.Literal<["runnable", "instructions"]>;
+export type Kind = (typeof Kinds)[number];
+declare const Routine_base: Type.ObjClass<Routine, {
+    readonly name?: string | undefined;
+    readonly description?: string | undefined;
+    readonly spec?: {
+        readonly kind: "runnable";
+        readonly runnable: import("@dxos/echo/internal").Ref<Operation.PersistentOperation & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
+    } | {
+        readonly kind: "instructions";
+        readonly instructions: import("@dxos/echo/internal").Ref<Instructions.Instructions & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
+    } | undefined;
+    readonly triggers: readonly import("@dxos/echo/internal").Ref<Trigger.Trigger & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>[];
+}, {}>;
+/**
+ * User-facing routine: a thin aggregate of an action (`runnable`) and the triggers that fire it.
+ * App-level only — EDGE stays unaware of it (triggers point directly at the runnable).
+ */
+export declare class Routine extends Routine_base {
+}
+/** Returns true when value is a Routine object. */
+export declare const instanceOf: (value: unknown) => value is Routine;
+/**
+ * The owned Instructions ref of an instructions-action routine, or undefined for an operation action.
+ * Classification is explicit in `spec.kind`, so this needs no `.target` dereference; callers resolve the ref
+ * reactively (`useObject`) or asynchronously (`Database.load`) as appropriate.
+ */
+export declare const instructionsRef: (routine: Pick<Routine, 'spec'>) => Ref.Ref<Instructions.Instructions> | undefined;
+/** The Operation (runnable) ref of an operation-action routine, or undefined for an instructions action. */
+export declare const runnableRef: (routine: Pick<Routine, 'spec'>) => Ref.Ref<Operation.PersistentOperation> | undefined;
+/** Factory wrapper around `Obj.make` for {@link Routine}. Trigger wiring lives in plugin-routine (`makeRoutine`). */
+export declare const make: (props: Omit<Obj.MakeProps<typeof Routine>, 'triggers'> & {
+    triggers?: ReadonlyArray<Ref.Ref<Trigger.Trigger>>;
+}) => Routine;
+export {};
+//# sourceMappingURL=Routine.d.ts.map