@agentshouse/mdruntime 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anton (trof3039)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/adapter.d.ts

@@ -0,0 +1,133 @@
+export type Authorization = object;
+export declare const ROOM_CONTRACT_VERSION = 1;
+export declare const VERSION_1_CAPABILITIES: readonly ['stable-file-ids', 'ranked-provider-search', 'room-version-notifications', 'room-history', 'provider-actions'];
+export type MdModelIdentity = {
+    identity: string;
+    version: string;
+};
+export type DiscoveredRoom = {
+    name: string;
+    locator: string;
+    roomVersion: string;
+    writeGrants: readonly string[];
+    providerOwnedPaths: readonly string[];
+};
+export type Capability = {
+    name: string;
+    limits?: readonly ProviderLimit[];
+    actions?: readonly ActionDeclaration[];
+};
+export type ActionDeclaration = {
+    name: string;
+    inputShape: unknown;
+    resultKind: unknown;
+};
+export type ProviderLimit = {
+    name: string;
+    value?: number | string;
+};
+export type Retention = {
+    history: number;
+    outcome: number;
+    refreshHorizon: number;
+};
+export type Discovery = {
+    kind: 'discovery';
+    supportedVersions: readonly number[];
+    mdModel: MdModelIdentity;
+    rooms: readonly DiscoveredRoom[];
+    capabilities: readonly Capability[];
+    providerLimits: readonly ProviderLimit[];
+    retention: Retention;
+    origins: readonly string[];
+};
+export type TransportUncertainty = {
+    kind: 'transport-uncertainty';
+};
+export type RoomNotReadable = {
+    kind: 'room-not-readable';
+    locator: string;
+};
+export type RevokedAuthorization = {
+    kind: 'revoked-authorization';
+};
+export type AdapterFailure = TransportUncertainty | RoomNotReadable | RevokedAuthorization;
+export type DiscoverResult = Discovery | TransportUncertainty | RevokedAuthorization;
+export type PageToken = string;
+export type BootstrapRequest = {
+    locator: string;
+    pageToken?: PageToken;
+};
+export type BootstrapResult = {
+    kind: 'bootstrap';
+    roomVersion: string;
+    pageToken?: PageToken;
+} | AdapterFailure;
+export type RefreshRequest = {
+    locator: string;
+    fromRoomVersion: string;
+    pageToken?: PageToken;
+};
+export type RefreshResult = {
+    kind: 'still-current';
+} | {
+    kind: 'net-advancement';
+    roomVersion: string;
+    pageToken?: PageToken;
+} | {
+    kind: 'beyond-horizon';
+} | AdapterFailure;
+export type MutationRequest = {
+    locator: string;
+    changeBatch: {
+        id: string;
+        baseRoomVersion: string;
+        changes: readonly unknown[];
+        preconditions: readonly unknown[];
+    };
+};
+export type MutationResult = {
+    kind: 'accepted';
+    roomVersion: string;
+} | {
+    kind: 'conflicted';
+    roomVersion: string;
+    text: string;
+} | {
+    kind: 'rejected';
+    text: string;
+} | AdapterFailure;
+export type HistoryRequest = {
+    locator: string;
+    path: string;
+    pageToken?: PageToken;
+};
+export type HistoryResult = {
+    kind: 'history';
+    revisions: readonly {
+        author: string;
+        time: string;
+    }[];
+    pageToken?: PageToken;
+} | AdapterFailure;
+export type ActionRequest = {
+    name: string;
+    input: unknown;
+};
+export type ActionResult = {
+    kind: 'action';
+    result: unknown;
+} | {
+    kind: 'rejected';
+    text: string;
+} | AdapterFailure;
+export type Adapter = {
+    authorize(): Promise<Authorization>;
+    discover(authorization: Authorization): Promise<DiscoverResult>;
+    bootstrap(authorization: Authorization, request: BootstrapRequest): Promise<BootstrapResult>;
+    refresh(authorization: Authorization, request: RefreshRequest): Promise<RefreshResult>;
+    mutate(authorization: Authorization, request: MutationRequest): Promise<MutationResult>;
+    history(authorization: Authorization, request: HistoryRequest): Promise<HistoryResult>;
+    action(authorization: Authorization, request: ActionRequest): Promise<ActionResult>;
+};
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

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

package/dist/adapter.js

@@ -0,0 +1,10 @@
+export const ROOM_CONTRACT_VERSION = 1;
+export const VERSION_1_CAPABILITIES = [
+    'stable-file-ids',
+    'ranked-provider-search',
+    'room-version-notifications',
+    'room-history',
+    'provider-actions'
+];
+
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/workspace/packages/mdruntime/src/adapter.ts"],"sourcesContent":["export type Authorization = object;\n\nexport const ROOM_CONTRACT_VERSION = 1;\n\nexport const VERSION_1_CAPABILITIES = [\n  'stable-file-ids',\n  'ranked-provider-search',\n  'room-version-notifications',\n  'room-history',\n  'provider-actions',\n] as const;\n\nexport type MdModelIdentity = {\n  identity: string;\n  version: string;\n};\n\nexport type DiscoveredRoom = {\n  name: string;\n  locator: string;\n  roomVersion: string;\n  writeGrants: readonly string[];\n  providerOwnedPaths: readonly string[];\n};\n\nexport type Capability = {\n  name: string;\n  limits?: readonly ProviderLimit[];\n  actions?: readonly ActionDeclaration[];\n};\n\nexport type ActionDeclaration = {\n  name: string;\n  inputShape: unknown;\n  resultKind: unknown;\n};\n\nexport type ProviderLimit = {\n  name: string;\n  value?: number | string;\n};\n\nexport type Retention = {\n  history: number;\n  outcome: number;\n  refreshHorizon: number;\n};\n\nexport type Discovery = {\n  kind: 'discovery';\n  supportedVersions: readonly number[];\n  mdModel: MdModelIdentity;\n  rooms: readonly DiscoveredRoom[];\n  capabilities: readonly Capability[];\n  providerLimits: readonly ProviderLimit[];\n  retention: Retention;\n  origins: readonly string[];\n};\n\nexport type TransportUncertainty = { kind: 'transport-uncertainty' };\nexport type RoomNotReadable = { kind: 'room-not-readable'; locator: string };\nexport type RevokedAuthorization = { kind: 'revoked-authorization' };\n\nexport type AdapterFailure = TransportUncertainty | RoomNotReadable | RevokedAuthorization;\n\nexport type DiscoverResult = Discovery | TransportUncertainty | RevokedAuthorization;\n\nexport type PageToken = string;\n\nexport type BootstrapRequest = {\n  locator: string;\n  pageToken?: PageToken;\n};\n\nexport type BootstrapResult =\n  | { kind: 'bootstrap'; roomVersion: string; pageToken?: PageToken }\n  | AdapterFailure;\n\nexport type RefreshRequest = {\n  locator: string;\n  fromRoomVersion: string;\n  pageToken?: PageToken;\n};\n\nexport type RefreshResult =\n  | { kind: 'still-current' }\n  | { kind: 'net-advancement'; roomVersion: string; pageToken?: PageToken }\n  | { kind: 'beyond-horizon' }\n  | AdapterFailure;\n\nexport type MutationRequest = {\n  locator: string;\n  changeBatch: {\n    id: string;\n    baseRoomVersion: string;\n    changes: readonly unknown[];\n    preconditions: readonly unknown[];\n  };\n};\n\nexport type MutationResult =\n  | { kind: 'accepted'; roomVersion: string }\n  | { kind: 'conflicted'; roomVersion: string; text: string }\n  | { kind: 'rejected'; text: string }\n  | AdapterFailure;\n\nexport type HistoryRequest = {\n  locator: string;\n  path: string;\n  pageToken?: PageToken;\n};\n\nexport type HistoryResult =\n  | {\n      kind: 'history';\n      revisions: readonly { author: string; time: string }[];\n      pageToken?: PageToken;\n    }\n  | AdapterFailure;\n\nexport type ActionRequest = {\n  name: string;\n  input: unknown;\n};\n\nexport type ActionResult =\n  | { kind: 'action'; result: unknown }\n  | { kind: 'rejected'; text: string }\n  | AdapterFailure;\n\nexport type Adapter = {\n  authorize(): Promise<Authorization>;\n  discover(authorization: Authorization): Promise<DiscoverResult>;\n  bootstrap(authorization: Authorization, request: BootstrapRequest): Promise<BootstrapResult>;\n  refresh(authorization: Authorization, request: RefreshRequest): Promise<RefreshResult>;\n  mutate(authorization: Authorization, request: MutationRequest): Promise<MutationResult>;\n  history(authorization: Authorization, request: HistoryRequest): Promise<HistoryResult>;\n  action(authorization: Authorization, request: ActionRequest): Promise<ActionResult>;\n};\n"],"names":["ROOM_CONTRACT_VERSION","VERSION_1_CAPABILITIES"],"mappings":"AAEA,OAAO,MAAMA,wBAAwB,EAAE;AAEvC,OAAO,MAAMC,yBAAyB;IACpC;IACA;IACA;IACA;IACA;CACD,CAAU"}

package/dist/connection.d.ts

@@ -0,0 +1,30 @@
+import { type Adapter, type Authorization, type MdModelIdentity } from './adapter.js';
+export type AppRoom = {
+    name: string;
+    locator: string;
+    writeGrants: readonly string[];
+    providerOwnedPaths: readonly string[];
+    synchronizationAvailable: boolean;
+};
+export type ConnectionRefusalReason = 'no-matching-version' | 'missing-required-guarantee' | 'md-model-version-mismatch' | 'revoked-authorization';
+export type ConnectionRefusal = {
+    reason: ConnectionRefusalReason;
+    reauthorizationOffered: boolean;
+};
+export type MdRuntimeOptions = {
+    adapter: Adapter;
+    requiredGuarantees: readonly string[];
+    mdModel: MdModelIdentity;
+    authorization?: Authorization;
+    rooms?: readonly AppRoom[];
+    discoveryIntervalMs?: number;
+    signal?: AbortSignal;
+};
+export type MdRuntime = {
+    rooms(): readonly AppRoom[];
+    observe(topic: 'rooms', listener: (rooms: readonly AppRoom[]) => void): () => void;
+    observe(topic: 'connection-refusal', listener: (refusal: ConnectionRefusal | null) => void): () => void;
+    reauthorize(): Promise<void>;
+};
+export declare function createMdRuntime(options: MdRuntimeOptions): MdRuntime;
+//# sourceMappingURL=connection.d.ts.map

package/dist/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,aAAa,EAElB,KAAK,eAAe,EACrB,MAAM,cAAc,CAAC;AAMtB,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,wBAAwB,EAAE,OAAO,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAC/B,qBAAqB,GACrB,4BAA4B,GAC5B,2BAA2B,GAC3B,uBAAuB,CAAC;AAE5B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,uBAAuB,CAAC;IAChC,sBAAsB,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,OAAO,EAAE,eAAe,CAAC;IACzB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,KAAK,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,IAAI,SAAS,OAAO,EAAE,CAAC;IAC5B,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACnF,OAAO,CACL,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,KAAK,IAAI,GACpD,MAAM,IAAI,CAAC;IACd,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC;AAsBF,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAyKpE"}

package/dist/connection.js

@@ -0,0 +1,177 @@
+import { ROOM_CONTRACT_VERSION, VERSION_1_CAPABILITIES } from './adapter.js';
+const DEFAULT_DISCOVERY_INTERVAL_MS = 60_000;
+const knownCapabilities = new Set(VERSION_1_CAPABILITIES);
+function asAppRoom(room) {
+    return {
+        name: room.name,
+        locator: room.locator,
+        writeGrants: room.writeGrants,
+        providerOwnedPaths: room.providerOwnedPaths,
+        synchronizationAvailable: true
+    };
+}
+function heldRoom(room) {
+    return {
+        name: room.name,
+        locator: room.locator,
+        writeGrants: room.writeGrants,
+        providerOwnedPaths: room.providerOwnedPaths,
+        synchronizationAvailable: false
+    };
+}
+export function createMdRuntime(options) {
+    const period = options.discoveryIntervalMs ?? DEFAULT_DISCOVERY_INTERVAL_MS;
+    let authorization = options.authorization;
+    let rooms = (options.rooms ?? []).map(heldRoom);
+    let refusal = null;
+    let discoveryPaused = false;
+    let timer;
+    let closed = false;
+    let chain = Promise.resolve();
+    let inflight = false;
+    let queued = false;
+    const roomListeners = new Set();
+    const refusalListeners = new Set();
+    function emitRooms() {
+        for (const listener of roomListeners)listener(rooms);
+    }
+    function emitRefusal() {
+        for (const listener of refusalListeners)listener(refusal);
+    }
+    function stopTimer() {
+        if (timer === undefined) return;
+        clearInterval(timer);
+        timer = undefined;
+    }
+    function startTimer() {
+        if (timer !== undefined) return;
+        timer = setInterval(()=>{
+            void enqueue();
+        }, period);
+    }
+    function refuse(reason) {
+        stopTimer();
+        discoveryPaused = true;
+        refusal = {
+            reason,
+            reauthorizationOffered: reason === 'revoked-authorization'
+        };
+        emitRefusal();
+    }
+    function applyDiscovery(discovered) {
+        const next = discovered.map(asAppRoom);
+        const listed = new Set(discovered.map((room)=>room.locator));
+        for (const room of rooms){
+            if (listed.has(room.locator)) continue;
+            next.push(heldRoom(room));
+        }
+        rooms = next;
+        emitRooms();
+    }
+    async function cycle() {
+        if (closed || authorization === undefined) return;
+        const result = await options.adapter.discover(authorization);
+        if (closed) return;
+        if (result.kind === 'transport-uncertainty') return;
+        if (result.kind === 'revoked-authorization') {
+            refuse('revoked-authorization');
+            return;
+        }
+        if (!result.supportedVersions.includes(ROOM_CONTRACT_VERSION)) {
+            refuse('no-matching-version');
+            return;
+        }
+        if (result.mdModel.identity !== options.mdModel.identity || result.mdModel.version !== options.mdModel.version) {
+            refuse('md-model-version-mismatch');
+            return;
+        }
+        const declared = new Set(result.capabilities.map((capability)=>capability.name));
+        for (const required of options.requiredGuarantees){
+            if (!knownCapabilities.has(required) || !declared.has(required)) {
+                refuse('missing-required-guarantee');
+                return;
+            }
+        }
+        if (refusal !== null) {
+            refusal = null;
+            emitRefusal();
+        }
+        applyDiscovery(result.rooms);
+    }
+    async function ensureAuthorization() {
+        if (authorization !== undefined) return;
+        authorization = await options.adapter.authorize();
+    }
+    async function connect() {
+        if (closed || discoveryPaused) return;
+        try {
+            await ensureAuthorization();
+            if (closed) return;
+            await cycle();
+        } catch  {
+            return;
+        } finally{
+            if (!closed && !discoveryPaused) startTimer();
+        }
+    }
+    async function run() {
+        try {
+            await connect();
+        } finally{
+            inflight = false;
+            if (queued && !closed) {
+                queued = false;
+                void enqueue();
+            }
+        }
+    }
+    function enqueue() {
+        if (inflight) {
+            queued = true;
+            return chain;
+        }
+        inflight = true;
+        chain = chain.then(run, run);
+        return chain;
+    }
+    function close() {
+        closed = true;
+        stopTimer();
+        roomListeners.clear();
+        refusalListeners.clear();
+    }
+    options.signal?.addEventListener('abort', close, {
+        once: true
+    });
+    if (options.signal?.aborted) close();
+    void enqueue();
+    return {
+        rooms () {
+            return rooms;
+        },
+        observe (topic, listener) {
+            if (topic === 'rooms') {
+                const notify = listener;
+                roomListeners.add(notify);
+                notify(rooms);
+                return ()=>{
+                    roomListeners.delete(notify);
+                };
+            }
+            const notify = listener;
+            refusalListeners.add(notify);
+            notify(refusal);
+            return ()=>{
+                refusalListeners.delete(notify);
+            };
+        },
+        async reauthorize () {
+            if (refusal === null || !refusal.reauthorizationOffered) return;
+            authorization = undefined;
+            discoveryPaused = false;
+            await enqueue();
+        }
+    };
+}
+
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/workspace/packages/mdruntime/src/connection.ts"],"sourcesContent":["import {\n  ROOM_CONTRACT_VERSION,\n  VERSION_1_CAPABILITIES,\n  type Adapter,\n  type Authorization,\n  type DiscoveredRoom,\n  type MdModelIdentity,\n} from './adapter.js';\n\nconst DEFAULT_DISCOVERY_INTERVAL_MS = 60_000;\n\nconst knownCapabilities = new Set<string>(VERSION_1_CAPABILITIES);\n\nexport type AppRoom = {\n  name: string;\n  locator: string;\n  writeGrants: readonly string[];\n  providerOwnedPaths: readonly string[];\n  synchronizationAvailable: boolean;\n};\n\nexport type ConnectionRefusalReason =\n  | 'no-matching-version'\n  | 'missing-required-guarantee'\n  | 'md-model-version-mismatch'\n  | 'revoked-authorization';\n\nexport type ConnectionRefusal = {\n  reason: ConnectionRefusalReason;\n  reauthorizationOffered: boolean;\n};\n\nexport type MdRuntimeOptions = {\n  adapter: Adapter;\n  requiredGuarantees: readonly string[];\n  mdModel: MdModelIdentity;\n  authorization?: Authorization;\n  rooms?: readonly AppRoom[];\n  discoveryIntervalMs?: number;\n  signal?: AbortSignal;\n};\n\nexport type MdRuntime = {\n  rooms(): readonly AppRoom[];\n  observe(topic: 'rooms', listener: (rooms: readonly AppRoom[]) => void): () => void;\n  observe(\n    topic: 'connection-refusal',\n    listener: (refusal: ConnectionRefusal | null) => void,\n  ): () => void;\n  reauthorize(): Promise<void>;\n};\n\nfunction asAppRoom(room: DiscoveredRoom): AppRoom {\n  return {\n    name: room.name,\n    locator: room.locator,\n    writeGrants: room.writeGrants,\n    providerOwnedPaths: room.providerOwnedPaths,\n    synchronizationAvailable: true,\n  };\n}\n\nfunction heldRoom(room: AppRoom): AppRoom {\n  return {\n    name: room.name,\n    locator: room.locator,\n    writeGrants: room.writeGrants,\n    providerOwnedPaths: room.providerOwnedPaths,\n    synchronizationAvailable: false,\n  };\n}\n\nexport function createMdRuntime(options: MdRuntimeOptions): MdRuntime {\n  const period = options.discoveryIntervalMs ?? DEFAULT_DISCOVERY_INTERVAL_MS;\n  let authorization: Authorization | undefined = options.authorization;\n  let rooms: AppRoom[] = (options.rooms ?? []).map(heldRoom);\n  let refusal: ConnectionRefusal | null = null;\n  let discoveryPaused = false;\n  let timer: ReturnType<typeof setInterval> | undefined;\n  let closed = false;\n  let chain: Promise<void> = Promise.resolve();\n  let inflight = false;\n  let queued = false;\n  const roomListeners = new Set<(rooms: readonly AppRoom[]) => void>();\n  const refusalListeners = new Set<(refusal: ConnectionRefusal | null) => void>();\n\n  function emitRooms() {\n    for (const listener of roomListeners) listener(rooms);\n  }\n\n  function emitRefusal() {\n    for (const listener of refusalListeners) listener(refusal);\n  }\n\n  function stopTimer() {\n    if (timer === undefined) return;\n    clearInterval(timer);\n    timer = undefined;\n  }\n\n  function startTimer() {\n    if (timer !== undefined) return;\n    timer = setInterval(() => {\n      void enqueue();\n    }, period);\n  }\n\n  function refuse(reason: ConnectionRefusalReason) {\n    stopTimer();\n    discoveryPaused = true;\n    refusal = {\n      reason,\n      reauthorizationOffered: reason === 'revoked-authorization',\n    };\n    emitRefusal();\n  }\n\n  function applyDiscovery(discovered: readonly DiscoveredRoom[]) {\n    const next = discovered.map(asAppRoom);\n    const listed = new Set(discovered.map((room) => room.locator));\n    for (const room of rooms) {\n      if (listed.has(room.locator)) continue;\n      next.push(heldRoom(room));\n    }\n    rooms = next;\n    emitRooms();\n  }\n\n  async function cycle() {\n    if (closed || authorization === undefined) return;\n    const result = await options.adapter.discover(authorization);\n    if (closed) return;\n    if (result.kind === 'transport-uncertainty') return;\n    if (result.kind === 'revoked-authorization') {\n      refuse('revoked-authorization');\n      return;\n    }\n    if (!result.supportedVersions.includes(ROOM_CONTRACT_VERSION)) {\n      refuse('no-matching-version');\n      return;\n    }\n    if (\n      result.mdModel.identity !== options.mdModel.identity ||\n      result.mdModel.version !== options.mdModel.version\n    ) {\n      refuse('md-model-version-mismatch');\n      return;\n    }\n    const declared = new Set(result.capabilities.map((capability) => capability.name));\n    for (const required of options.requiredGuarantees) {\n      if (!knownCapabilities.has(required) || !declared.has(required)) {\n        refuse('missing-required-guarantee');\n        return;\n      }\n    }\n    if (refusal !== null) {\n      refusal = null;\n      emitRefusal();\n    }\n    applyDiscovery(result.rooms);\n  }\n\n  async function ensureAuthorization() {\n    if (authorization !== undefined) return;\n    authorization = await options.adapter.authorize();\n  }\n\n  async function connect() {\n    if (closed || discoveryPaused) return;\n    try {\n      await ensureAuthorization();\n      if (closed) return;\n      await cycle();\n    } catch {\n      return;\n    } finally {\n      if (!closed && !discoveryPaused) startTimer();\n    }\n  }\n\n  async function run() {\n    try {\n      await connect();\n    } finally {\n      inflight = false;\n      if (queued && !closed) {\n        queued = false;\n        void enqueue();\n      }\n    }\n  }\n\n  function enqueue() {\n    if (inflight) {\n      queued = true;\n      return chain;\n    }\n    inflight = true;\n    chain = chain.then(run, run);\n    return chain;\n  }\n\n  function close() {\n    closed = true;\n    stopTimer();\n    roomListeners.clear();\n    refusalListeners.clear();\n  }\n\n  options.signal?.addEventListener('abort', close, { once: true });\n  if (options.signal?.aborted) close();\n\n  void enqueue();\n\n  return {\n    rooms() {\n      return rooms;\n    },\n    observe(topic: 'rooms' | 'connection-refusal', listener: (value: never) => void) {\n      if (topic === 'rooms') {\n        const notify = listener as (value: readonly AppRoom[]) => void;\n        roomListeners.add(notify);\n        notify(rooms);\n        return () => {\n          roomListeners.delete(notify);\n        };\n      }\n      const notify = listener as (value: ConnectionRefusal | null) => void;\n      refusalListeners.add(notify);\n      notify(refusal);\n      return () => {\n        refusalListeners.delete(notify);\n      };\n    },\n    async reauthorize() {\n      if (refusal === null || !refusal.reauthorizationOffered) return;\n      authorization = undefined;\n      discoveryPaused = false;\n      await enqueue();\n    },\n  };\n}\n"],"names":["ROOM_CONTRACT_VERSION","VERSION_1_CAPABILITIES","DEFAULT_DISCOVERY_INTERVAL_MS","knownCapabilities","Set","asAppRoom","room","name","locator","writeGrants","providerOwnedPaths","synchronizationAvailable","heldRoom","createMdRuntime","options","period","discoveryIntervalMs","authorization","rooms","map","refusal","discoveryPaused","timer","closed","chain","Promise","resolve","inflight","queued","roomListeners","refusalListeners","emitRooms","listener","emitRefusal","stopTimer","undefined","clearInterval","startTimer","setInterval","enqueue","refuse","reason","reauthorizationOffered","applyDiscovery","discovered","next","listed","has","push","cycle","result","adapter","discover","kind","supportedVersions","includes","mdModel","identity","version","declared","capabilities","capability","required","requiredGuarantees","ensureAuthorization","authorize","connect","run","then","close","clear","signal","addEventListener","once","aborted","observe","topic","notify","add","delete","reauthorize"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export type { ActionDeclaration, ActionRequest, ActionResult, Adapter, AdapterFailure, Authorization, BootstrapRequest, BootstrapResult, Capability, DiscoverResult, DiscoveredRoom, Discovery, HistoryRequest, HistoryResult, MdModelIdentity, MutationRequest, MutationResult, PageToken, ProviderLimit, RefreshRequest, RefreshResult, Retention, RevokedAuthorization, RoomNotReadable, TransportUncertainty, } from './adapter.js';
+export type { AppRoom, ConnectionRefusal, ConnectionRefusalReason, MdRuntime, MdRuntimeOptions, } from './connection.js';
+export { createMdRuntime } from './connection.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,OAAO,EACP,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,cAAc,EACd,cAAc,EACd,SAAS,EACT,cAAc,EACd,aAAa,EACb,eAAe,EACf,eAAe,EACf,cAAc,EACd,SAAS,EACT,aAAa,EACb,cAAc,EACd,aAAa,EACb,SAAS,EACT,oBAAoB,EACpB,eAAe,EACf,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,OAAO,EACP,iBAAiB,EACjB,uBAAuB,EACvB,SAAS,EACT,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createMdRuntime } from './connection.js';
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/workspace/packages/mdruntime/src/index.ts"],"sourcesContent":["export type {\n  ActionDeclaration,\n  ActionRequest,\n  ActionResult,\n  Adapter,\n  AdapterFailure,\n  Authorization,\n  BootstrapRequest,\n  BootstrapResult,\n  Capability,\n  DiscoverResult,\n  DiscoveredRoom,\n  Discovery,\n  HistoryRequest,\n  HistoryResult,\n  MdModelIdentity,\n  MutationRequest,\n  MutationResult,\n  PageToken,\n  ProviderLimit,\n  RefreshRequest,\n  RefreshResult,\n  Retention,\n  RevokedAuthorization,\n  RoomNotReadable,\n  TransportUncertainty,\n} from './adapter.js';\nexport type {\n  AppRoom,\n  ConnectionRefusal,\n  ConnectionRefusalReason,\n  MdRuntime,\n  MdRuntimeOptions,\n} from './connection.js';\nexport { createMdRuntime } from './connection.js';\n"],"names":["createMdRuntime"],"mappings":"AAkCA,SAASA,eAAe,QAAQ,kBAAkB"}

package/dist/memory.d.ts

@@ -0,0 +1,16 @@
+import { type Adapter, type Capability, type DiscoveredRoom, type MdModelIdentity, type ProviderLimit, type Retention } from './adapter.js';
+export type MemoryAdapterOptions = {
+    rooms?: readonly DiscoveredRoom[];
+    mdModel?: MdModelIdentity;
+    supportedVersions?: readonly number[];
+    capabilities?: readonly Capability[];
+    providerLimits?: readonly ProviderLimit[];
+    retention?: Retention;
+    origins?: readonly string[];
+};
+export type MemoryAdapter = Adapter & {
+    setRooms(rooms: readonly DiscoveredRoom[]): void;
+    script(operation: keyof Adapter, answer: unknown): void;
+};
+export declare function createMemoryAdapter(options?: MemoryAdapterOptions): MemoryAdapter;
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,OAAO,EAIZ,KAAK,UAAU,EAEf,KAAK,cAAc,EAGnB,KAAK,eAAe,EAGpB,KAAK,aAAa,EAGlB,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAClC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,YAAY,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACrC,cAAc,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,IAAI,CAAC;IACjD,MAAM,CAAC,SAAS,EAAE,MAAM,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CACzD,CAAC;AASF,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG,aAAa,CA2GrF"}

package/dist/memory.js

@@ -0,0 +1,132 @@
+import { ROOM_CONTRACT_VERSION } from './adapter.js';
+async function resolveScript(answer, fallback) {
+    if (answer === undefined) return fallback();
+    return typeof answer === 'function' ? answer() : answer;
+}
+export function createMemoryAdapter(options = {}) {
+    let rooms = options.rooms === undefined ? [] : [
+        ...options.rooms
+    ];
+    const mdModel = options.mdModel ?? {
+        identity: 'mdmodel',
+        version: '1.0.0'
+    };
+    const supportedVersions = options.supportedVersions ?? [
+        ROOM_CONTRACT_VERSION
+    ];
+    const capabilities = options.capabilities ?? [];
+    const providerLimits = options.providerLimits ?? [];
+    const retention = options.retention ?? {
+        history: 1,
+        outcome: 1,
+        refreshHorizon: 1
+    };
+    const origins = options.origins ?? [
+        'https://origin.example'
+    ];
+    const scripts = {};
+    function discovery() {
+        return {
+            kind: 'discovery',
+            supportedVersions,
+            mdModel,
+            rooms: [
+                ...rooms
+            ],
+            capabilities,
+            providerLimits,
+            retention,
+            origins
+        };
+    }
+    return {
+        setRooms (next) {
+            rooms = [
+                ...next
+            ];
+        },
+        script (operation, answer) {
+            if (answer === undefined) delete scripts[operation];
+            else scripts[operation] = answer;
+        },
+        async authorize () {
+            return resolveScript(scripts.authorize, ()=>({}));
+        },
+        async discover (_authorization) {
+            return resolveScript(scripts.discover, discovery);
+        },
+        async bootstrap (_authorization, request) {
+            return resolveScript(scripts.bootstrap, ()=>{
+                const room = rooms.find((entry)=>entry.locator === request.locator);
+                if (room === undefined) {
+                    return {
+                        kind: 'room-not-readable',
+                        locator: request.locator
+                    };
+                }
+                return {
+                    kind: 'bootstrap',
+                    roomVersion: room.roomVersion
+                };
+            });
+        },
+        async refresh (_authorization, request) {
+            return resolveScript(scripts.refresh, ()=>{
+                const room = rooms.find((entry)=>entry.locator === request.locator);
+                if (room === undefined) {
+                    return {
+                        kind: 'room-not-readable',
+                        locator: request.locator
+                    };
+                }
+                if (request.fromRoomVersion === room.roomVersion) {
+                    return {
+                        kind: 'still-current'
+                    };
+                }
+                return {
+                    kind: 'net-advancement',
+                    roomVersion: room.roomVersion
+                };
+            });
+        },
+        async mutate (_authorization, request) {
+            return resolveScript(scripts.mutate, ()=>{
+                const room = rooms.find((entry)=>entry.locator === request.locator);
+                if (room === undefined) {
+                    return {
+                        kind: 'room-not-readable',
+                        locator: request.locator
+                    };
+                }
+                return {
+                    kind: 'rejected',
+                    text: ''
+                };
+            });
+        },
+        async history (_authorization, request) {
+            return resolveScript(scripts.history, ()=>{
+                const room = rooms.find((entry)=>entry.locator === request.locator);
+                if (room === undefined) {
+                    return {
+                        kind: 'room-not-readable',
+                        locator: request.locator
+                    };
+                }
+                return {
+                    kind: 'history',
+                    revisions: []
+                };
+            });
+        },
+        async action (_authorization, _request) {
+            return resolveScript(scripts.action, ()=>({
+                    kind: 'rejected',
+                    text: ''
+                }));
+        }
+    };
+}
+
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/workspace/packages/mdruntime/src/memory.ts"],"sourcesContent":["import {\n  ROOM_CONTRACT_VERSION,\n  type ActionRequest,\n  type ActionResult,\n  type Adapter,\n  type Authorization,\n  type BootstrapRequest,\n  type BootstrapResult,\n  type Capability,\n  type DiscoverResult,\n  type DiscoveredRoom,\n  type HistoryRequest,\n  type HistoryResult,\n  type MdModelIdentity,\n  type MutationRequest,\n  type MutationResult,\n  type ProviderLimit,\n  type RefreshRequest,\n  type RefreshResult,\n  type Retention,\n} from './adapter.js';\n\nexport type MemoryAdapterOptions = {\n  rooms?: readonly DiscoveredRoom[];\n  mdModel?: MdModelIdentity;\n  supportedVersions?: readonly number[];\n  capabilities?: readonly Capability[];\n  providerLimits?: readonly ProviderLimit[];\n  retention?: Retention;\n  origins?: readonly string[];\n};\n\nexport type MemoryAdapter = Adapter & {\n  setRooms(rooms: readonly DiscoveredRoom[]): void;\n  script(operation: keyof Adapter, answer: unknown): void;\n};\n\ntype Script<T> = T | (() => T | Promise<T>);\n\nasync function resolveScript<T>(answer: Script<T> | undefined, fallback: () => T | Promise<T>) {\n  if (answer === undefined) return fallback();\n  return typeof answer === 'function' ? (answer as () => T | Promise<T>)() : answer;\n}\n\nexport function createMemoryAdapter(options: MemoryAdapterOptions = {}): MemoryAdapter {\n  let rooms = options.rooms === undefined ? [] : [...options.rooms];\n  const mdModel = options.mdModel ?? { identity: 'mdmodel', version: '1.0.0' };\n  const supportedVersions = options.supportedVersions ?? [ROOM_CONTRACT_VERSION];\n  const capabilities = options.capabilities ?? [];\n  const providerLimits = options.providerLimits ?? [];\n  const retention = options.retention ?? { history: 1, outcome: 1, refreshHorizon: 1 };\n  const origins = options.origins ?? ['https://origin.example'];\n  const scripts: Partial<Record<keyof Adapter, unknown>> = {};\n\n  function discovery(): DiscoverResult {\n    return {\n      kind: 'discovery',\n      supportedVersions,\n      mdModel,\n      rooms: [...rooms],\n      capabilities,\n      providerLimits,\n      retention,\n      origins,\n    };\n  }\n\n  return {\n    setRooms(next) {\n      rooms = [...next];\n    },\n    script(operation, answer) {\n      if (answer === undefined) delete scripts[operation];\n      else scripts[operation] = answer;\n    },\n    async authorize() {\n      return resolveScript<Authorization>(\n        scripts.authorize as Script<Authorization> | undefined,\n        () => ({}),\n      );\n    },\n    async discover(_authorization: Authorization) {\n      return resolveScript<DiscoverResult>(\n        scripts.discover as Script<DiscoverResult> | undefined,\n        discovery,\n      );\n    },\n    async bootstrap(_authorization: Authorization, request: BootstrapRequest) {\n      return resolveScript<BootstrapResult>(\n        scripts.bootstrap as Script<BootstrapResult> | undefined,\n        () => {\n          const room = rooms.find((entry) => entry.locator === request.locator);\n          if (room === undefined) {\n            return { kind: 'room-not-readable', locator: request.locator };\n          }\n          return { kind: 'bootstrap', roomVersion: room.roomVersion };\n        },\n      );\n    },\n    async refresh(_authorization: Authorization, request: RefreshRequest) {\n      return resolveScript<RefreshResult>(\n        scripts.refresh as Script<RefreshResult> | undefined,\n        () => {\n          const room = rooms.find((entry) => entry.locator === request.locator);\n          if (room === undefined) {\n            return { kind: 'room-not-readable', locator: request.locator };\n          }\n          if (request.fromRoomVersion === room.roomVersion) {\n            return { kind: 'still-current' };\n          }\n          return { kind: 'net-advancement', roomVersion: room.roomVersion };\n        },\n      );\n    },\n    async mutate(_authorization: Authorization, request: MutationRequest) {\n      return resolveScript<MutationResult>(\n        scripts.mutate as Script<MutationResult> | undefined,\n        () => {\n          const room = rooms.find((entry) => entry.locator === request.locator);\n          if (room === undefined) {\n            return { kind: 'room-not-readable', locator: request.locator };\n          }\n          return { kind: 'rejected', text: '' };\n        },\n      );\n    },\n    async history(_authorization: Authorization, request: HistoryRequest) {\n      return resolveScript<HistoryResult>(\n        scripts.history as Script<HistoryResult> | undefined,\n        () => {\n          const room = rooms.find((entry) => entry.locator === request.locator);\n          if (room === undefined) {\n            return { kind: 'room-not-readable', locator: request.locator };\n          }\n          return {\n            kind: 'history',\n            revisions: [],\n          };\n        },\n      );\n    },\n    async action(_authorization: Authorization, _request: ActionRequest) {\n      return resolveScript<ActionResult>(\n        scripts.action as Script<ActionResult> | undefined,\n        () => ({\n          kind: 'rejected',\n          text: '',\n        }),\n      );\n    },\n  };\n}\n"],"names":["ROOM_CONTRACT_VERSION","resolveScript","answer","fallback","undefined","createMemoryAdapter","options","rooms","mdModel","identity","version","supportedVersions","capabilities","providerLimits","retention","history","outcome","refreshHorizon","origins","scripts","discovery","kind","setRooms","next","script","operation","authorize","discover","_authorization","bootstrap","request","room","find","entry","locator","roomVersion","refresh","fromRoomVersion","mutate","text","revisions","action","_request"],"mappings":"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"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@agentshouse/mdruntime",
+  "version": "0.1.0-alpha.1",
+  "description": "The headless core of MD App",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=24.20.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./memory": {
+      "types": "./dist/memory.d.ts",
+      "import": "./dist/memory.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agentshouse/mdruntime.git",
+    "directory": "packages/mdruntime"
+  },
+  "homepage": "https://github.com/agentshouse/mdruntime#readme",
+  "bugs": {
+    "url": "https://github.com/agentshouse/mdruntime/issues"
+  }
+}