@cello-protocol/daemon 0.0.131 → 0.0.133

package/dist/document-handlers.d.ts

@@ -0,0 +1,47 @@
+/**
+ * DOD-DOC-TOOLS-1 — the operator's surface onto documents.
+ *
+ * Until this module existed, nothing in production called `createDocument`. Every unit below it was
+ * built and tested, and none of it was reachable: no operator could propose a document, so no
+ * document existed, so the delivery sweep was a no-op by construction and the inbound path never
+ * had anything addressed to it. The layer was complete and unreachable, which reads exactly like a
+ * layer that works.
+ *
+ * ── WHY PROPOSE AND ACCEPT ARE SEPARATE VERBS ─────────────────────────────────────────────────
+ *
+ * A document is a standing agreement to apply a counterparty's signed operations to local state.
+ * That is a larger grant than receiving a message, and §16.3 puts a human consent decision in front
+ * of it. Accepting is the moment the operator agrees; everything after is the CRDT converging
+ * without asking again. So the proposal is recorded, listed, and answered once — never inferred
+ * from the first update arriving.
+ *
+ * ── WRITE IS FULL-CONTENT, NOT A PATCH ────────────────────────────────────────────────────────
+ *
+ * `cello_doc_write` takes the document's whole new text and the engine diffs it against the live
+ * doc. An agent that emits a patch has to be right about offsets in a document its peer is
+ * concurrently editing, and a wrong offset in a CRDT is not a rejected patch — it is a permanent,
+ * silent corruption that both sides converge on. Full content moves that problem to a diff run
+ * against the state the operator actually saw.
+ */
+import type { IpcHandler } from "./ipc-server.js";
+import type { Logger } from "./types.js";
+import type { DocumentLayer } from "./document-layer.js";
+import type { DocumentPublish } from "./document-publish.js";
+import type { DocumentDeliveryTransport } from "./document-delivery.js";
+export interface DocumentHandlerDeps {
+    handlers: Map<string, IpcHandler>;
+    logger: Logger;
+    layer: DocumentLayer;
+    publish: DocumentPublish;
+    /** Per-agent, because a session and a signature both belong to exactly one agent. */
+    transportFor(agentName: string): DocumentDeliveryTransport;
+    /** Which agent is this call for? Resolved from the connection, or named explicitly. */
+    resolveAgent(connectionId: string, explicit?: string): string | null;
+    /** Agent NAME to the stable owner key every document row is scoped by (M14-D5). */
+    ownerKeyFor(agentName: string): string | null;
+    /** Sign as the named agent. */
+    sign(agentName: string, tbs: Uint8Array): Promise<Uint8Array>;
+    now(): number;
+}
+export declare function registerDocumentHandlers(deps: DocumentHandlerDeps): void;
+//# sourceMappingURL=document-handlers.d.ts.map

package/dist/document-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-handlers.d.ts","sourceRoot":"","sources":["../src/document-handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAmBH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAMxE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,eAAe,CAAC;IACzB,qFAAqF;IACrF,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,yBAAyB,CAAC;IAC3D,uFAAuF;IACvF,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACrE,mFAAmF;IACnF,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC9C,+BAA+B;IAC/B,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9D,GAAG,IAAI,MAAM,CAAC;CACf;AAOD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CA4pBxE"}