- Runtime contracts and workflow execution are - optional layers for declared events, actions, timers, and durable - automation. + Event and action interoperability lets + independent applications cooperate through shared contracts.{" "} + Durable runtime execution is an optional layer + for persisted workflows, timers, retries, and recovery.
@@ -310,6 +311,11 @@ easier to understand. Compare profiles, open the shared fixtures, and publish exact evidence. 03 + + Connect applications + Publish CloudEvents and invoke schema-validated actions through a local or durable bridge. + 04 + diff --git a/src/pages/interop/index.astro b/src/pages/interop/index.astro new file mode 100644 index 0000000..22c7541 --- /dev/null +++ b/src/pages/interop/index.astro @@ -0,0 +1,160 @@ +--- +import BaseLayout from "../../layouts/BaseLayout.astro"; +import CodeBlock from "../../components/CodeBlock.astro"; + +const eventSource = `const tasknotes = bridge.connect({ + application: "tasknotes", + implementation: "tasknotes.obsidian", + version: "5.0.0" +}); + +await tasknotes.registerEventSource({ + declaration_id: "tasknotes.events", + contracts: [{ contract: taskCompletedContract }] +}); + +await tasknotes.publishEvent({ + contract: { id: "tasknotes.task.completed", version: "1.0.0" }, + subject: "Tasks/Ship%20contracts.md", + correlation_id: "workflow-42", + data: { + task_id: "task-42", + task_path: "Tasks/Ship contracts.md", + title: "Ship contracts", + status: "done", + completed_at: "2026-07-28T10:15:00Z" + } +});`; + +const actionCaller = `const outcome = await workflows.invokeAction({ + request_id: "workflow:run-42:add-card", + contract: { id: "canvas.card.create", version: "^1.0.0" }, + requested_provider: { application: "canvas-bases" }, + correlation_id: "workflow-42", + causation_id: "evt-42", + idempotency_key: "run-42:add-card", + input: { + canvas_path: "TaskNotes/Canvases/Completed tasks.canvas", + card: { kind: "file", file: "Tasks/Ship contracts.md" } + } +}); + +if (outcome.status !== "succeeded") { + throw new Error(\`\${outcome.error.message} [\${outcome.error.code}]\`); +}`; +--- + +Interoperability profile 0.1
++ Applications can publish events and invoke actions without adopting + one universal runtime. JSON Schema proves compatibility; a separate + bridge grant supplies authority. +
+ +
+ Every record, event, and action is an ordinary first-class{" "}
+ mdbase.contract. Its discriminated shape names the
+ relevant JSON Schemas: record_schema,{" "}
+ data_schema, or action input and outcome schemas.
+
+ An application may be an event source, event consumer, action
+ caller, or action provider. A type file uses implements{" "}
+ only for record contracts; application declarations provide event
+ sources and action handlers.
+
+ Events multicast to every authorized compatible consumer. Actions
+ resolve to exactly one authorized provider before any side effect.
+ Multiple eligible providers produce ambiguous_provider{" "}
+ until the caller or policy selects one.
+
+ The profile uses CloudEvents structured JSON and adds exact contract + version, digest, application, and implementation attributes. The event + ID survives redelivery. Correlation and causation are explicit. Event + data always validates against the exact contract artifact. +
+
+ A logical request is admitted as an exact invocation with a selected
+ provider and concrete attempt. Its terminal outcome is{" "}
+ succeeded, rejected, failed,{" "}
+ cancelled, or outcome_indeterminate. Accepting a
+ message for delivery is never reported as successful execution.
+
| In the profile | Owned elsewhere |
|---|---|
| Contract identity, exact digests, envelopes, validation, resolution | +Workflow languages, scheduling, retries, and application behavior | +
| Correlation, causation, cancellation, duplicate and indeterminate semantics | +Persistence, journals, leases, recovery, and offline queues | +
| Identity and authorization context carried to a bridge | +The user grant or transport-specific policy engine | +
Runtime profile 0.1
-- mdbase separates passive collection semantics from declared provider - contracts and durable workflow execution. Hosts declare support for - each layer independently. + The event/action profile defines portable messages and provider + resolution. The runtime adds journals, scheduling, retries, and + recovery without inventing a second contract system.
- Portable event and action declarations, provider registration, - compatibility checks, and preflight. The TypeScript package - implements this browser-safe provider-host layer. + CloudEvents envelopes, exact contract evidence, role declarations, + boundary validation, and one-provider action resolution. The + browser-safe reference bridge implements this layer.
- Connect compiles exact application grants into runtime behavior, + Connect compiles exact application grants into transport behavior, supplies local or hosted collection authorities, and routes - notification signals. The runtime profile defines the contracts - that Connect hosts. + notification signals. It can bind the same portable envelopes + durably without becoming mandatory for local applications.
- Conformance uses atomic profiles. Provider hosts claim{" "}
- runtime_contracts/0.1. Workflow engines add{" "}
+ Conformance uses atomic profiles. Interoperability bridges claim{" "}
+ event_action_interop/0.1. Durable workflow engines add{" "}
workflow/0.1 after publishing shared fixture evidence.
event_action_interop/0.1 |
+ CloudEvents, declarations, validation, authorization boundaries, multicast, and action resolution | +Workflow syntax, scheduling, retries, persistence, or recovery | +||
runtime_contracts/0.1 |
- Declaration validation, registry behavior, compatibility, dispatch, preflight | -Watching, timers, durable execution, or recovery | +Legacy runtime-host behavior during migration to the interoperability substrate | +The portable event/action profile and durable execution evidence |
workflow/0.1 |
diff --git a/src/pages/sdk/connect-quickstart/index.astro b/src/pages/sdk/connect-quickstart/index.astro
index 4be4db0..7d220c1 100644
--- a/src/pages/sdk/connect-quickstart/index.astro
+++ b/src/pages/sdk/connect-quickstart/index.astro
@@ -43,7 +43,7 @@ const manifest = `{
"resources": [
{
"source": "contracts/workout.record.md",
- "document": "---\\nkind: mdbase.contract\\nid: workout.record\\nversion: 1.0.0\\nschema:\\n dialect: json-schema-2020-12\\n value:\\n $schema: https://json-schema.org/draft/2020-12/schema\\n type: object\\n additionalProperties: false\\n properties:\\n title: { type: string }\\n completed: { type: boolean, default: false }\\n required: [title]\\n---\\n"
+ "document": "---\\nkind: mdbase.contract\\ncontract_type: record\\nid: workout.record\\nversion: 1.0.0\\nrecord_schema:\\n dialect: json-schema-2020-12\\n value:\\n $schema: https://json-schema.org/draft/2020-12/schema\\n type: object\\n additionalProperties: false\\n properties:\\n title: { type: string }\\n completed: { type: boolean, default: false }\\n required: [title]\\n---\\n"
},
{
"source": "types/workout.md",
diff --git a/src/pages/sdk/contracts/index.astro b/src/pages/sdk/contracts/index.astro
index a4919f9..a2b6a92 100644
--- a/src/pages/sdk/contracts/index.astro
+++ b/src/pages/sdk/contracts/index.astro
@@ -52,22 +52,25 @@ export class WorklogCollection {
]}
>