@agentshouse/mdruntime 0.1.0-alpha.1 → 0.1.0-alpha.10

package/dist/client.js

@@ -0,0 +1,227 @@
+import { answer, AUTHORIZATION_ENDED, carried, envelope, PROTOCOL_MISMATCH } from './wire.js';
+export function connectMdRuntime(port) {
+    let sequence = 0;
+    let refusal = null;
+    let ended = false;
+    const calls = new Map();
+    const acks = new Map();
+    const listeners = new Map();
+    const send = (message)=>{
+        port.postMessage(envelope(message));
+    };
+    function refuse(reported) {
+        refusal = reported;
+        for (const waiting of acks.values())waiting.settle();
+        acks.clear();
+        const failure = new Error(reported.reason);
+        for (const waiting of calls.values())waiting.fail(failure);
+        calls.clear();
+        for (const listener of listeners.values()){
+            if (listener.topic === 'connection-refusal') listener.notify(reported);
+        }
+    }
+    function end() {
+        ended = true;
+        const failure = new Error(AUTHORIZATION_ENDED);
+        for (const waiting of acks.values())waiting.fail(failure);
+        acks.clear();
+        for (const waiting of calls.values())waiting.fail(failure);
+        calls.clear();
+        listeners.clear();
+    }
+    port.addEventListener('message', (event)=>{
+        const wire = carried(event.data);
+        if (wire === null) return;
+        if (!wire.matching) {
+            refuse(PROTOCOL_MISMATCH);
+            return;
+        }
+        const message = answer(wire.message);
+        if (message === null) return;
+        if (message.kind === 'refusal') {
+            refuse(message.refusal);
+            return;
+        }
+        if (message.kind === 'ended') {
+            end();
+            return;
+        }
+        if (message.kind === 'event') {
+            listeners.get(message.id)?.notify(message.value);
+            return;
+        }
+        const subscribing = acks.get(message.id);
+        if (subscribing !== undefined) {
+            acks.delete(message.id);
+            if (message.kind === 'failure') {
+                listeners.delete(message.id);
+                subscribing.fail(new Error(message.message));
+            } else subscribing.settle();
+            return;
+        }
+        const waiting = calls.get(message.id);
+        if (waiting === undefined) return;
+        calls.delete(message.id);
+        if (message.kind === 'failure') waiting.fail(new Error(message.message));
+        else waiting.settle(message.value);
+    });
+    port.start();
+    send({
+        kind: 'hello'
+    });
+    function ask(member, input) {
+        if (ended) return Promise.reject(new Error(AUTHORIZATION_ENDED));
+        if (refusal !== null) return Promise.reject(new Error(refusal.reason));
+        const id = sequence += 1;
+        return new Promise((settle, fail)=>{
+            calls.set(id, {
+                settle: settle,
+                fail
+            });
+            send({
+                kind: 'call',
+                id,
+                member,
+                input
+            });
+        });
+    }
+    function watch(topic, input, notify) {
+        if (ended) return Promise.reject(new Error(AUTHORIZATION_ENDED));
+        const id = sequence += 1;
+        listeners.set(id, {
+            topic,
+            notify
+        });
+        const end = ()=>{
+            if (!listeners.delete(id)) return;
+            if (refusal === null) send({
+                kind: 'stop',
+                id
+            });
+        };
+        if (refusal !== null) {
+            if (topic === 'connection-refusal') notify(refusal);
+            return Promise.resolve(end);
+        }
+        return new Promise((settle, fail)=>{
+            acks.set(id, {
+                settle: ()=>settle(end),
+                fail
+            });
+            send({
+                kind: 'observe',
+                id,
+                topic,
+                input
+            });
+        });
+    }
+    return {
+        rooms: ()=>ask('rooms', []),
+        query: (options)=>ask('query', [
+                options
+            ]),
+        types: (locator)=>ask('types', [
+                locator
+            ]),
+        syncStatus: ()=>ask('syncStatus', []),
+        draft: {
+            list: ()=>ask('draft.list', []),
+            read: (locator, path)=>ask('draft.read', [
+                    locator,
+                    path
+                ]),
+            replace: (locator, path, content)=>ask('draft.replace', [
+                    locator,
+                    path,
+                    content
+                ]),
+            discard: (locator, path)=>ask('draft.discard', [
+                    locator,
+                    path
+                ])
+        },
+        save: (locator, changes, replacing)=>ask('save', [
+                locator,
+                changes,
+                replacing
+            ]),
+        outcome: (identifier)=>ask('outcome', [
+                identifier
+            ]),
+        queue: {
+            discard: (locator, identifier)=>ask('queue.discard', [
+                    locator,
+                    identifier
+                ])
+        },
+        presentation: {
+            read: ()=>ask('presentation.read', []),
+            write: (value)=>ask('presentation.write', [
+                    value
+                ])
+        },
+        conversation: {
+            list: ()=>ask('conversation.list', []),
+            read: (conversation)=>ask('conversation.read', [
+                    conversation
+                ]),
+            older: (conversation)=>ask('conversation.older', [
+                    conversation
+                ]),
+            compose: (conversation, instruction)=>ask('conversation.compose', [
+                    conversation,
+                    instruction
+                ]),
+            discard: (conversation)=>ask('conversation.discard', [
+                    conversation
+                ]),
+            create: (input)=>ask('conversation.create', [
+                    input
+                ]),
+            send: (conversation)=>ask('conversation.send', [
+                    conversation
+                ]),
+            answer: (conversation, answer)=>ask('conversation.answer', [
+                    conversation,
+                    answer
+                ]),
+            interrupt: (conversation)=>ask('conversation.interrupt', [
+                    conversation
+                ]),
+            kill: (conversation)=>ask('conversation.kill', [
+                    conversation
+                ]),
+            cancel: (conversation, turn)=>ask('conversation.cancel', [
+                    conversation,
+                    turn
+                ]),
+            delete: (conversation)=>ask('conversation.delete', [
+                    conversation
+                ])
+        },
+        history: (locator, path, query)=>ask('history', [
+                locator,
+                path,
+                query
+            ]),
+        call: (name, input)=>ask('call', [
+                name,
+                input
+            ]),
+        log: ()=>ask('log', []),
+        storageLoss: ()=>ask('storageLoss', []),
+        persistence: ()=>ask('persistence', []),
+        observe (topic, second, third) {
+            const positional = topic === 'query' || topic === 'queue' || topic === 'conversation';
+            const notify = positional ? third : second;
+            return watch(topic, positional ? [
+                second
+            ] : [], notify);
+        },
+        reauthorize: ()=>ask('reauthorize', [])
+    };
+}
+
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/workspace/packages/mdruntime/src/client.ts"],"sourcesContent":["import type { QueryOptions, QueryResult } from '@agentshouse/query';\nimport type { Change } from './change.js';\nimport type {\n  AppRoom,\n  ConnectionRefusal,\n  DraftEntry,\n  HistoryQuery,\n  RoomTypes,\n  SaveResult,\n} from './connection.js';\nimport type { HistoryResult } from './adapter.js';\nimport type { ConversationEntry, ConversationView, UnsentInstruction } from './conversation.js';\nimport type { CallResult, QueueEntry, SubmissionOutcome } from './outcome.js';\nimport type { SyncStatus } from './status.js';\nimport {\n  answer,\n  AUTHORIZATION_ENDED,\n  carried,\n  envelope,\n  PROTOCOL_MISMATCH,\n  type RuntimePort,\n  type WireMember,\n  type WireRequest,\n  type WireTopic,\n} from './wire.js';\n\nexport type MdRuntimeClient = {\n  rooms(): Promise<readonly AppRoom[]>;\n  query(options?: QueryOptions): Promise<QueryResult>;\n  types(locator: string): Promise<RoomTypes>;\n  syncStatus(): Promise<SyncStatus>;\n  draft: {\n    list(): Promise<readonly DraftEntry[]>;\n    read(locator: string, path: string): Promise<unknown>;\n    replace(locator: string, path: string, content: unknown): Promise<void>;\n    discard(locator: string, path: string): Promise<void>;\n  };\n  save(locator: string, changes: readonly Change[], replacing?: string): Promise<SaveResult>;\n  outcome(identifier: string): Promise<SubmissionOutcome | null>;\n  queue: { discard(locator: string, identifier: string): Promise<void> };\n  presentation: {\n    read(): Promise<unknown>;\n    write(value: unknown): Promise<void>;\n  };\n  conversation: {\n    list(): Promise<readonly ConversationEntry[]>;\n    read(conversation: string): Promise<ConversationView>;\n    older(conversation: string): Promise<CallResult | null>;\n    compose(conversation: string, instruction: UnsentInstruction): Promise<void>;\n    discard(conversation: string): Promise<void>;\n    create(input: unknown): Promise<CallResult>;\n    send(conversation: string): Promise<CallResult>;\n    answer(conversation: string, answer: unknown): Promise<CallResult>;\n    interrupt(conversation: string): Promise<CallResult>;\n    kill(conversation: string): Promise<CallResult>;\n    cancel(conversation: string, turn: string): Promise<CallResult>;\n    delete(conversation: string): Promise<CallResult>;\n  };\n  history(locator: string, path: string, query?: HistoryQuery): Promise<HistoryResult>;\n  call(name: string, input: unknown): Promise<CallResult>;\n  log(): Promise<string>;\n  storageLoss(): Promise<string | null>;\n  persistence(): Promise<boolean>;\n  observe: {\n    (topic: 'rooms', listener: (rooms: readonly AppRoom[]) => void): Promise<() => void>;\n    (\n      topic: 'connection-refusal',\n      listener: (refusal: ConnectionRefusal | null) => void,\n    ): Promise<() => void>;\n    (topic: 'storage-loss', listener: (statement: string | null) => void): Promise<() => void>;\n    (topic: 'sync-status', listener: (status: SyncStatus) => void): Promise<() => void>;\n    (\n      topic: 'query',\n      query: QueryOptions,\n      listener: (result: QueryResult) => void,\n    ): Promise<() => void>;\n    (\n      topic: 'queue',\n      locator: string,\n      listener: (entries: readonly QueueEntry[]) => void,\n    ): Promise<() => void>;\n    (topic: 'drafts', listener: (drafts: readonly DraftEntry[]) => void): Promise<() => void>;\n    (topic: 'presentation', listener: (value: unknown) => void): Promise<() => void>;\n    (\n      topic: 'conversation',\n      conversation: string,\n      listener: (view: ConversationView) => void,\n    ): Promise<() => void>;\n  };\n  reauthorize(): Promise<void>;\n};\n\nexport function connectMdRuntime(port: RuntimePort): MdRuntimeClient {\n  let sequence = 0;\n  let refusal: ConnectionRefusal | null = null;\n  let ended = false;\n  const calls = new Map<\n    number,\n    { settle: (value: unknown) => void; fail: (error: Error) => void }\n  >();\n  const acks = new Map<number, { settle: () => void; fail: (error: Error) => void }>();\n  const listeners = new Map<number, { topic: WireTopic; notify: (value: unknown) => void }>();\n\n  const send = (message: WireRequest) => {\n    port.postMessage(envelope(message));\n  };\n\n  function refuse(reported: ConnectionRefusal) {\n    refusal = reported;\n    for (const waiting of acks.values()) waiting.settle();\n    acks.clear();\n    const failure = new Error(reported.reason);\n    for (const waiting of calls.values()) waiting.fail(failure);\n    calls.clear();\n    for (const listener of listeners.values()) {\n      if (listener.topic === 'connection-refusal') listener.notify(reported);\n    }\n  }\n\n  function end() {\n    ended = true;\n    const failure = new Error(AUTHORIZATION_ENDED);\n    for (const waiting of acks.values()) waiting.fail(failure);\n    acks.clear();\n    for (const waiting of calls.values()) waiting.fail(failure);\n    calls.clear();\n    listeners.clear();\n  }\n\n  port.addEventListener('message', (event) => {\n    const wire = carried(event.data);\n    if (wire === null) return;\n    if (!wire.matching) {\n      refuse(PROTOCOL_MISMATCH);\n      return;\n    }\n    const message = answer(wire.message);\n    if (message === null) return;\n    if (message.kind === 'refusal') {\n      refuse(message.refusal);\n      return;\n    }\n    if (message.kind === 'ended') {\n      end();\n      return;\n    }\n    if (message.kind === 'event') {\n      listeners.get(message.id)?.notify(message.value);\n      return;\n    }\n    const subscribing = acks.get(message.id);\n    if (subscribing !== undefined) {\n      acks.delete(message.id);\n      if (message.kind === 'failure') {\n        listeners.delete(message.id);\n        subscribing.fail(new Error(message.message));\n      } else subscribing.settle();\n      return;\n    }\n    const waiting = calls.get(message.id);\n    if (waiting === undefined) return;\n    calls.delete(message.id);\n    if (message.kind === 'failure') waiting.fail(new Error(message.message));\n    else waiting.settle(message.value);\n  });\n  port.start();\n  send({ kind: 'hello' });\n\n  function ask<T>(member: WireMember, input: readonly unknown[]): Promise<T> {\n    if (ended) return Promise.reject(new Error(AUTHORIZATION_ENDED));\n    if (refusal !== null) return Promise.reject(new Error(refusal.reason));\n    const id = (sequence += 1);\n    return new Promise<T>((settle, fail) => {\n      calls.set(id, { settle: settle as (value: unknown) => void, fail });\n      send({ kind: 'call', id, member, input });\n    });\n  }\n\n  function watch(\n    topic: WireTopic,\n    input: readonly unknown[],\n    notify: (value: unknown) => void,\n  ): Promise<() => void> {\n    if (ended) return Promise.reject(new Error(AUTHORIZATION_ENDED));\n    const id = (sequence += 1);\n    listeners.set(id, { topic, notify });\n    const end = () => {\n      if (!listeners.delete(id)) return;\n      if (refusal === null) send({ kind: 'stop', id });\n    };\n    if (refusal !== null) {\n      if (topic === 'connection-refusal') notify(refusal);\n      return Promise.resolve(end);\n    }\n    return new Promise<() => void>((settle, fail) => {\n      acks.set(id, { settle: () => settle(end), fail });\n      send({ kind: 'observe', id, topic, input });\n    });\n  }\n\n  return {\n    rooms: () => ask<readonly AppRoom[]>('rooms', []),\n    query: (options?: QueryOptions) => ask<QueryResult>('query', [options]),\n    types: (locator: string) => ask<RoomTypes>('types', [locator]),\n    syncStatus: () => ask<SyncStatus>('syncStatus', []),\n    draft: {\n      list: () => ask<readonly DraftEntry[]>('draft.list', []),\n      read: (locator: string, path: string) => ask<unknown>('draft.read', [locator, path]),\n      replace: (locator: string, path: string, content: unknown) =>\n        ask<void>('draft.replace', [locator, path, content]),\n      discard: (locator: string, path: string) => ask<void>('draft.discard', [locator, path]),\n    },\n    save: (locator: string, changes: readonly Change[], replacing?: string) =>\n      ask<SaveResult>('save', [locator, changes, replacing]),\n    outcome: (identifier: string) => ask<SubmissionOutcome | null>('outcome', [identifier]),\n    queue: {\n      discard: (locator: string, identifier: string) =>\n        ask<void>('queue.discard', [locator, identifier]),\n    },\n    presentation: {\n      read: () => ask<unknown>('presentation.read', []),\n      write: (value: unknown) => ask<void>('presentation.write', [value]),\n    },\n    conversation: {\n      list: () => ask<readonly ConversationEntry[]>('conversation.list', []),\n      read: (conversation: string) => ask<ConversationView>('conversation.read', [conversation]),\n      older: (conversation: string) => ask<CallResult | null>('conversation.older', [conversation]),\n      compose: (conversation: string, instruction: UnsentInstruction) =>\n        ask<void>('conversation.compose', [conversation, instruction]),\n      discard: (conversation: string) => ask<void>('conversation.discard', [conversation]),\n      create: (input: unknown) => ask<CallResult>('conversation.create', [input]),\n      send: (conversation: string) => ask<CallResult>('conversation.send', [conversation]),\n      answer: (conversation: string, answer: unknown) =>\n        ask<CallResult>('conversation.answer', [conversation, answer]),\n      interrupt: (conversation: string) =>\n        ask<CallResult>('conversation.interrupt', [conversation]),\n      kill: (conversation: string) => ask<CallResult>('conversation.kill', [conversation]),\n      cancel: (conversation: string, turn: string) =>\n        ask<CallResult>('conversation.cancel', [conversation, turn]),\n      delete: (conversation: string) => ask<CallResult>('conversation.delete', [conversation]),\n    },\n    history: (locator: string, path: string, query?: HistoryQuery) =>\n      ask<HistoryResult>('history', [locator, path, query]),\n    call: (name: string, input: unknown) => ask<CallResult>('call', [name, input]),\n    log: () => ask<string>('log', []),\n    storageLoss: () => ask<string | null>('storageLoss', []),\n    persistence: () => ask<boolean>('persistence', []),\n    observe(\n      topic: WireTopic,\n      second: QueryOptions | string | ((value: never) => void),\n      third?: (value: never) => void,\n    ) {\n      const positional = topic === 'query' || topic === 'queue' || topic === 'conversation';\n      const notify = (positional ? third : second) as (value: unknown) => void;\n      return watch(topic, positional ? [second] : [], notify);\n    },\n    reauthorize: () => ask<void>('reauthorize', []),\n  };\n}\n\nexport type { RuntimePort } from './wire.js';\n"],"names":["answer","AUTHORIZATION_ENDED","carried","envelope","PROTOCOL_MISMATCH","connectMdRuntime","port","sequence","refusal","ended","calls","Map","acks","listeners","send","message","postMessage","refuse","reported","waiting","values","settle","clear","failure","Error","reason","fail","listener","topic","notify","end","addEventListener","event","wire","data","matching","kind","get","id","value","subscribing","undefined","delete","start","ask","member","input","Promise","reject","set","watch","resolve","rooms","query","options","types","locator","syncStatus","draft","list","read","path","replace","content","discard","save","changes","replacing","outcome","identifier","queue","presentation","write","conversation","older","compose","instruction","create","interrupt","kill","cancel","turn","history","call","name","log","storageLoss","persistence","observe","second","third","positional","reauthorize"],"mappings":"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"}

package/dist/collection.d.ts

@@ -0,0 +1,33 @@
+import { type Document, type Validation } from '@agentshouse/mdmodel';
+import type { Selector } from '@agentshouse/query';
+import type { AttachedModelBinding, ModelState } from './model.js';
+import type { MdModelIdentity } from './adapter.js';
+export declare const MD_MODEL: MdModelIdentity;
+export declare const PRESENTED: Selector;
+export type MdType = {
+    name: string;
+    path: string;
+    fields: Readonly<Record<string, unknown>>;
+    sections: Readonly<Record<string, unknown>>;
+};
+export type Collection = {
+    documents: Readonly<Record<string, Document>>;
+    composition: Composition;
+};
+export type Composition = {
+    collectionRoot: string;
+    model: ModelState;
+    selection: {
+        roots: readonly string[];
+        model: ModelState;
+    } | null;
+};
+export declare function governing(composition: Composition, path: string): ModelState;
+export declare function typesAt(composition: Composition, path: string): readonly MdType[];
+export declare function parseCollection(text: Readonly<Record<string, string>>, composition: Composition): Collection;
+export declare function readCollection(text: Readonly<Record<string, string>>, composition: Composition): Collection | null;
+export declare function validRoot(root: unknown): root is string;
+export declare function validateCollection(text: Readonly<Record<string, string>>, binaryTargets: readonly string[], composition: Composition, binding: AttachedModelBinding | null): Validation & {
+    source?: 'content' | 'model';
+};
+//# sourceMappingURL=collection.d.ts.map

package/dist/collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../src/collection.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAChG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,eAAO,MAAM,QAAQ,EAAE,eAAwE,CAAC;AAEhG,eAAO,MAAM,SAAS,EAAE,QAAyC,CAAC;AAElE,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1C,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC9C,WAAW,EAAE,WAAW,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE;QAAE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,GAAG,IAAI,CAAC;CACnE,CAAC;AASF,wBAAgB,SAAS,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAI5E;AAED,wBAAgB,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAGjF;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACtC,WAAW,EAAE,WAAW,GACvB,UAAU,CAOZ;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACtC,WAAW,EAAE,WAAW,GACvB,UAAU,GAAG,IAAI,CAenB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAEvD;AAyCD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACtC,aAAa,EAAE,SAAS,MAAM,EAAE,EAChC,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,oBAAoB,GAAG,IAAI,GACnC,UAAU,GAAG;IAAE,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAA;CAAE,CA4C/C"}

package/dist/collection.js

@@ -0,0 +1,115 @@
+import { parse, validate, VERSION } from '@agentshouse/mdmodel';
+import { beneath, normalize } from './paths.js';
+export const MD_MODEL = {
+    identity: '@agentshouse/mdmodel',
+    version: VERSION
+};
+export const PRESENTED = {
+    path: {
+        $regex: '\\.md$'
+    }
+};
+function selected(composition, path) {
+    return composition.selection !== null && composition.selection.roots.some((root)=>beneath(root, path));
+}
+export function governing(composition, path) {
+    return composition.selection !== null && selected(composition, path) ? composition.selection.model : composition.model;
+}
+export function typesAt(composition, path) {
+    const model = governing(composition, path);
+    return model.status === 'unavailable' ? [] : model.types;
+}
+export function parseCollection(text, composition) {
+    const documents = {};
+    for (const path of Object.keys(text).sort()){
+        const parsed = parse(text[path], path);
+        if (parsed.ok) documents[path] = parsed.document;
+    }
+    return {
+        documents,
+        composition
+    };
+}
+export function readCollection(text, composition) {
+    if (!validRoot(composition.collectionRoot)) return null;
+    const collection = parseCollection(text, composition);
+    if (Object.keys(collection.documents).length !== Object.keys(text).length) return null;
+    if (Object.entries(collection.documents).some(([path, document])=>!member(path, composition.collectionRoot) && !selected(composition, path) && document.type !== undefined && document.type !== 'any')) return null;
+    return collection;
+}
+export function validRoot(root) {
+    return typeof root === 'string' && normalize(root) === root;
+}
+function member(path, root) {
+    return root === '' || path.startsWith(`${root}/`);
+}
+function validateAgainst(documents, binaryTargets, prefix, model, binding) {
+    if (model.status === 'unavailable' || binding === null) {
+        const typed = Object.entries(documents).find(([, content])=>{
+            const parsed = parse(content);
+            return parsed.ok && parsed.document.type !== undefined && parsed.document.type !== 'any';
+        });
+        if (typed !== undefined) return {
+            verdict: 'refuse',
+            rule: 'model-unavailable',
+            file: `${prefix}${typed[0]}`,
+            version: VERSION
+        };
+        return validate(documents, {
+            binaryTargets
+        });
+    }
+    const verdict = binding.validate({
+        model: model.snapshot,
+        documents,
+        binaryTargets
+    });
+    if (verdict.verdict === 'refuse' && verdict.source === 'model') return verdict;
+    if (verdict.verdict === 'accept') return verdict;
+    return {
+        ...verdict,
+        file: `${prefix}${verdict.file}`,
+        ...verdict.referrers === undefined ? {} : {
+            referrers: verdict.referrers.map((path)=>`${prefix}${path}`)
+        }
+    };
+}
+export function validateCollection(text, binaryTargets, composition, binding) {
+    const prefix = composition.collectionRoot === '' ? '' : `${composition.collectionRoot}/`;
+    const collection = {};
+    const selection = {};
+    for (const [path, content] of Object.entries(text)){
+        if (member(path, composition.collectionRoot)) {
+            collection[path.slice(prefix.length)] = content;
+            continue;
+        }
+        if (selected(composition, path)) {
+            selection[path] = content;
+            continue;
+        }
+        const parsed = parse(content, path);
+        if (!parsed.ok) return {
+            verdict: 'refuse',
+            ...parsed.refusal
+        };
+        if (Object.hasOwn(parsed.document.fields, 'type') && parsed.document.fields.type !== 'any') {
+            return {
+                verdict: 'refuse',
+                rule: 'outside-collection-type',
+                file: path,
+                version: VERSION
+            };
+        }
+    }
+    const verdicts = [
+        validateAgainst(collection, binaryTargets.filter((path)=>member(path, composition.collectionRoot)).map((path)=>path.slice(prefix.length)), prefix, composition.model, binding)
+    ];
+    if (composition.selection !== null) {
+        verdicts.push(validateAgainst(selection, binaryTargets.filter((path)=>selected(composition, path)), '', composition.selection.model, binding));
+    }
+    const refusals = verdicts.filter((verdict)=>verdict.verdict === 'refuse');
+    if (refusals.length === 0) return verdicts[0];
+    return refusals.find((refusal)=>refusal.rule !== 'model-unavailable') ?? refusals[0];
+}
+
+//# sourceMappingURL=collection.js.map

package/dist/collection.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/workspace/packages/mdruntime/src/collection.ts"],"sourcesContent":["import { parse, validate, VERSION, type Document, type Validation } from '@agentshouse/mdmodel';\nimport type { Selector } from '@agentshouse/query';\nimport { beneath, normalize } from './paths.js';\nimport type { AttachedModelBinding, ModelState } from './model.js';\nimport type { MdModelIdentity } from './adapter.js';\n\nexport const MD_MODEL: MdModelIdentity = { identity: '@agentshouse/mdmodel', version: VERSION };\n\nexport const PRESENTED: Selector = { path: { $regex: '\\\\.md$' } };\n\nexport type MdType = {\n  name: string;\n  path: string;\n  fields: Readonly<Record<string, unknown>>;\n  sections: Readonly<Record<string, unknown>>;\n};\n\nexport type Collection = {\n  documents: Readonly<Record<string, Document>>;\n  composition: Composition;\n};\n\nexport type Composition = {\n  collectionRoot: string;\n  model: ModelState;\n  selection: { roots: readonly string[]; model: ModelState } | null;\n};\n\nfunction selected(composition: Composition, path: string): boolean {\n  return (\n    composition.selection !== null &&\n    composition.selection.roots.some((root) => beneath(root, path))\n  );\n}\n\nexport function governing(composition: Composition, path: string): ModelState {\n  return composition.selection !== null && selected(composition, path)\n    ? composition.selection.model\n    : composition.model;\n}\n\nexport function typesAt(composition: Composition, path: string): readonly MdType[] {\n  const model = governing(composition, path);\n  return model.status === 'unavailable' ? [] : model.types;\n}\n\nexport function parseCollection(\n  text: Readonly<Record<string, string>>,\n  composition: Composition,\n): Collection {\n  const documents: Record<string, Document> = {};\n  for (const path of Object.keys(text).sort()) {\n    const parsed = parse(text[path], path);\n    if (parsed.ok) documents[path] = parsed.document;\n  }\n  return { documents, composition };\n}\n\nexport function readCollection(\n  text: Readonly<Record<string, string>>,\n  composition: Composition,\n): Collection | null {\n  if (!validRoot(composition.collectionRoot)) return null;\n  const collection = parseCollection(text, composition);\n  if (Object.keys(collection.documents).length !== Object.keys(text).length) return null;\n  if (\n    Object.entries(collection.documents).some(\n      ([path, document]) =>\n        !member(path, composition.collectionRoot) &&\n        !selected(composition, path) &&\n        document.type !== undefined &&\n        document.type !== 'any',\n    )\n  )\n    return null;\n  return collection;\n}\n\nexport function validRoot(root: unknown): root is string {\n  return typeof root === 'string' && normalize(root) === root;\n}\n\nfunction member(path: string, root: string): boolean {\n  return root === '' || path.startsWith(`${root}/`);\n}\n\ntype Refusal = Extract<Validation, { verdict: 'refuse' }> & { source?: 'content' | 'model' };\n\nfunction validateAgainst(\n  documents: Readonly<Record<string, string>>,\n  binaryTargets: readonly string[],\n  prefix: string,\n  model: ModelState,\n  binding: AttachedModelBinding | null,\n): Validation & { source?: 'content' | 'model' } {\n  if (model.status === 'unavailable' || binding === null) {\n    const typed = Object.entries(documents).find(([, content]) => {\n      const parsed = parse(content);\n      return parsed.ok && parsed.document.type !== undefined && parsed.document.type !== 'any';\n    });\n    if (typed !== undefined)\n      return {\n        verdict: 'refuse',\n        rule: 'model-unavailable',\n        file: `${prefix}${typed[0]}`,\n        version: VERSION,\n      };\n    return validate(documents, { binaryTargets });\n  }\n  const verdict = binding.validate({ model: model.snapshot, documents, binaryTargets });\n  if (verdict.verdict === 'refuse' && verdict.source === 'model') return verdict;\n  if (verdict.verdict === 'accept') return verdict;\n  return {\n    ...verdict,\n    file: `${prefix}${verdict.file}`,\n    ...(verdict.referrers === undefined\n      ? {}\n      : { referrers: verdict.referrers.map((path) => `${prefix}${path}`) }),\n  };\n}\n\nexport function validateCollection(\n  text: Readonly<Record<string, string>>,\n  binaryTargets: readonly string[],\n  composition: Composition,\n  binding: AttachedModelBinding | null,\n): Validation & { source?: 'content' | 'model' } {\n  const prefix = composition.collectionRoot === '' ? '' : `${composition.collectionRoot}/`;\n  const collection: Record<string, string> = {};\n  const selection: Record<string, string> = {};\n  for (const [path, content] of Object.entries(text)) {\n    if (member(path, composition.collectionRoot)) {\n      collection[path.slice(prefix.length)] = content;\n      continue;\n    }\n    if (selected(composition, path)) {\n      selection[path] = content;\n      continue;\n    }\n    const parsed = parse(content, path);\n    if (!parsed.ok) return { verdict: 'refuse', ...parsed.refusal };\n    if (Object.hasOwn(parsed.document.fields, 'type') && parsed.document.fields.type !== 'any') {\n      return { verdict: 'refuse', rule: 'outside-collection-type', file: path, version: VERSION };\n    }\n  }\n  const verdicts = [\n    validateAgainst(\n      collection,\n      binaryTargets\n        .filter((path) => member(path, composition.collectionRoot))\n        .map((path) => path.slice(prefix.length)),\n      prefix,\n      composition.model,\n      binding,\n    ),\n  ];\n  if (composition.selection !== null) {\n    verdicts.push(\n      validateAgainst(\n        selection,\n        binaryTargets.filter((path) => selected(composition, path)),\n        '',\n        composition.selection.model,\n        binding,\n      ),\n    );\n  }\n  const refusals = verdicts.filter((verdict): verdict is Refusal => verdict.verdict === 'refuse');\n  if (refusals.length === 0) return verdicts[0];\n  return refusals.find((refusal) => refusal.rule !== 'model-unavailable') ?? refusals[0];\n}\n"],"names":["parse","validate","VERSION","beneath","normalize","MD_MODEL","identity","version","PRESENTED","path","$regex","selected","composition","selection","roots","some","root","governing","model","typesAt","status","types","parseCollection","text","documents","Object","keys","sort","parsed","ok","document","readCollection","validRoot","collectionRoot","collection","length","entries","member","type","undefined","startsWith","validateAgainst","binaryTargets","prefix","binding","typed","find","content","verdict","rule","file","snapshot","source","referrers","map","validateCollection","slice","refusal","hasOwn","fields","verdicts","filter","push","refusals"],"mappings":"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"}

package/dist/connection.d.ts

@@ -1,29 +1,107 @@
-import { type Adapter, type Authorization, type MdModelIdentity } from './adapter.js';
+import { type QueryBinding } from './query.js';
+import { type AttachedModelBinding, type TypesResult } from './model.js';
+import { type QueryOptions, type QueryResult } from '@agentshouse/query';
+import { type Adapter, type Authorization, type HistoryResult, type ProviderRefusal } from './adapter.js';
+import { type ConversationSurface, type ConversationView } from './conversation.js';
+import type { Change } from './change.js';
+import { type CallResult, type QueueEntry, type SubmissionOutcome } from './outcome.js';
+import { type SaveRefusal } from './save.js';
+import { type SyncStatus } from './status.js';
+import { type RuntimeShell } from './durability.js';
+export type AppTypedSelection = {
+    roots: readonly string[];
+    attachedModel: import('./model.js').ModelIdentity | null;
+    model: TypesResult;
+};
 export type AppRoom = {
+    collectionRoot: string;
     name: string;
     locator: string;
-    writeGrants: readonly string[];
+    operations: import('./adapter.js').OperationScopes;
+    replica: import('./adapter.js').ReplicaAdmission;
+    attachedModel: import('./model.js').ModelIdentity | null;
+    model: TypesResult;
+    typedSelection: AppTypedSelection | null;
     providerOwnedPaths: readonly string[];
+    roomVersion: string | null;
     synchronizationAvailable: boolean;
+    refusal: ProviderRefusal | null;
+};
+export type RoomTypes = {
+    collection: TypesResult;
+    typedSelection: TypesResult | null;
 };
-export type ConnectionRefusalReason = 'no-matching-version' | 'missing-required-guarantee' | 'md-model-version-mismatch' | 'revoked-authorization';
+export type ConnectionRefusalReason = 'no-matching-version' | 'missing-required-guarantee' | 'md-model-version-mismatch' | 'revoked-authorization' | 'client-host-protocol-mismatch';
 export type ConnectionRefusal = {
     reason: ConnectionRefusalReason;
     reauthorizationOffered: boolean;
+    refusal: ProviderRefusal | null;
 };
 export type MdRuntimeOptions = {
     adapter: Adapter;
+    shell: RuntimeShell;
+    modelBinding: AttachedModelBinding | null;
+    queryBinding: QueryBinding | null;
     requiredGuarantees: readonly string[];
-    mdModel: MdModelIdentity;
     authorization?: Authorization;
-    rooms?: readonly AppRoom[];
     discoveryIntervalMs?: number;
     signal?: AbortSignal;
 };
+export type SaveResult = {
+    outcome: 'saved';
+    id: string;
+} | ({
+    outcome: 'refused';
+} & SaveRefusal);
+export type DraftEntry = {
+    readonly locator: string;
+    readonly path: string;
+    readonly content: unknown;
+};
+export type DraftSurface = {
+    list(): Promise<readonly DraftEntry[]>;
+    read(locator: string, path: string): unknown;
+    replace(locator: string, path: string, content: unknown): Promise<void>;
+    discard(locator: string, path: string): Promise<void>;
+};
+export type QueueSurface = {
+    discard(locator: string, identifier: string): Promise<void>;
+};
+export type PresentationSurface = {
+    read(app: string): Promise<unknown>;
+    write(app: string, value: unknown): Promise<void>;
+};
+export type HistoryQuery = {
+    revision?: string;
+    pageToken?: string;
+};
 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;
+    query(options?: QueryOptions): QueryResult;
+    types(locator: string): RoomTypes;
+    syncStatus(): SyncStatus;
+    draft: DraftSurface;
+    conversation: ConversationSurface;
+    presentation: PresentationSurface;
+    save(locator: string, changes: readonly Change[], replacing?: string): Promise<SaveResult>;
+    outcome(identifier: string): SubmissionOutcome | null;
+    queue: QueueSurface;
+    history(locator: string, path: string, query?: HistoryQuery): Promise<HistoryResult>;
+    call(name: string, input: unknown): Promise<CallResult>;
+    log(): string;
+    storageLoss(): string | null;
+    persistence(): boolean;
+    observe: {
+        (topic: 'rooms', listener: (rooms: readonly AppRoom[]) => void): () => void;
+        (topic: 'connection-refusal', listener: (refusal: ConnectionRefusal | null) => void): () => void;
+        (topic: 'storage-loss', listener: (statement: string | null) => void): () => void;
+        (topic: 'sync-status', listener: (status: SyncStatus) => void): () => void;
+        (topic: 'query', query: QueryOptions, listener: (result: QueryResult) => void): () => void;
+        (topic: 'queue', locator: string, listener: (entries: readonly QueueEntry[]) => void): () => void;
+        (topic: 'drafts', listener: (drafts: readonly DraftEntry[]) => void): () => void;
+        (topic: 'presentation', app: string, listener: (value: unknown) => void): () => void;
+        (topic: 'conversation', conversation: string, listener: (view: ConversationView) => void): () => void;
+    };
     reauthorize(): Promise<void>;
 };
 export declare function createMdRuntime(options: MdRuntimeOptions): MdRuntime;

package/dist/connection.d.ts.map

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