@the-focus-ai/artifacts 1.1.0 → 1.2.1

package/dist/src/front-matter.d.ts

@@ -0,0 +1,36 @@
+export interface SplitFrontMatter {
+    /** Raw YAML between the opening/closing `---` fences, or null if none. */
+    matter: string | null;
+    body: string;
+}
+/**
+ * Split Markdown into optional YAML front matter and the body.
+ * Preserves the exact matter text so editors can round-trip without reformat.
+ */
+export declare function splitFrontMatter(markdown: string): SplitFrontMatter;
+/**
+ * Reassemble Markdown from optional front matter and body.
+ * Empty/whitespace-only matter drops the fences entirely.
+ */
+export declare function joinFrontMatter(matter: string | null, body: string): string;
+/** Parse front-matter YAML into a plain object, or null if missing/invalid. */
+export declare function parseFrontMatterData(matter: string | null): Record<string, unknown> | null;
+/** Prefer a string `title` from front matter when present. */
+export declare function titleFromFrontMatter(matter: string | null): string | null;
+/**
+ * Title for a Living Doc: front-matter `title`, else first heading/line in the
+ * body (front matter itself is never used as the title).
+ */
+export declare function deriveMarkdownTitle(markdown: string): string | null;
+/** Body only — safe to feed to markdown-it / TipTap. */
+export declare function markdownBody(markdown: string): string;
+/** Serialize a plain object back to YAML suitable for front-matter fences. */
+export declare function serializeFrontMatterData(data: Record<string, unknown>): string;
+/**
+ * Parse a single field value from the front-matter editor.
+ * Prefer YAML scalars/collections; fall back to the raw string.
+ */
+export declare function parseFrontMatterFieldValue(raw: string): unknown;
+/** Format a value for display in a single-line field editor. */
+export declare function formatFrontMatterFieldValue(value: unknown): string;
+//# sourceMappingURL=front-matter.d.ts.map

package/dist/src/front-matter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"front-matter.d.ts","sourceRoot":"","sources":["../../src/front-matter.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAInE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAM3E;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,GAAG,IAAI,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAWhC;AAED,8DAA8D;AAC9D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAOzE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWnE;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,8EAA8E;AAC9E,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAER;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQ/D;AAED,gEAAgE;AAChE,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOlE"}

package/dist/src/front-matter.js

@@ -0,0 +1,105 @@
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+// Opening fence at the start of the file, then YAML, then a closing fence.
+const FRONT_MATTER_RE = /^---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)([\s\S]*)$/;
+/**
+ * Split Markdown into optional YAML front matter and the body.
+ * Preserves the exact matter text so editors can round-trip without reformat.
+ */
+export function splitFrontMatter(markdown) {
+    const match = markdown.match(FRONT_MATTER_RE);
+    if (!match)
+        return { matter: null, body: markdown };
+    return { matter: match[1], body: match[2] ?? "" };
+}
+/**
+ * Reassemble Markdown from optional front matter and body.
+ * Empty/whitespace-only matter drops the fences entirely.
+ */
+export function joinFrontMatter(matter, body) {
+    if (matter === null)
+        return body;
+    const trimmed = matter.replace(/^\uFEFF/, "").replace(/\s+$/, "");
+    if (trimmed.length === 0)
+        return body;
+    const bodyPart = body.replace(/^\r?\n/, "");
+    return `---\n${trimmed}\n---\n${bodyPart}`;
+}
+/** Parse front-matter YAML into a plain object, or null if missing/invalid. */
+export function parseFrontMatterData(matter) {
+    if (matter === null)
+        return null;
+    try {
+        const data = parseYaml(matter);
+        if (data && typeof data === "object" && !Array.isArray(data)) {
+            return data;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Prefer a string `title` from front matter when present. */
+export function titleFromFrontMatter(matter) {
+    const data = parseFrontMatterData(matter);
+    if (!data)
+        return null;
+    const title = data.title;
+    if (typeof title !== "string")
+        return null;
+    const trimmed = title.trim();
+    return trimmed.length > 0 ? trimmed.slice(0, 200) : null;
+}
+/**
+ * Title for a Living Doc: front-matter `title`, else first heading/line in the
+ * body (front matter itself is never used as the title).
+ */
+export function deriveMarkdownTitle(markdown) {
+    const { matter, body } = splitFrontMatter(markdown);
+    const fromMatter = titleFromFrontMatter(matter);
+    if (fromMatter)
+        return fromMatter;
+    for (const line of body.split("\n")) {
+        const heading = line.match(/^#{1,6}\s+(.+?)\s*$/);
+        if (heading)
+            return heading[1].slice(0, 200);
+        if (line.trim().length > 0)
+            return line.trim().slice(0, 200);
+    }
+    return null;
+}
+/** Body only — safe to feed to markdown-it / TipTap. */
+export function markdownBody(markdown) {
+    return splitFrontMatter(markdown).body;
+}
+/** Serialize a plain object back to YAML suitable for front-matter fences. */
+export function serializeFrontMatterData(data) {
+    return stringifyYaml(data, { lineWidth: 0 }).replace(/\n$/, "");
+}
+/**
+ * Parse a single field value from the front-matter editor.
+ * Prefer YAML scalars/collections; fall back to the raw string.
+ */
+export function parseFrontMatterFieldValue(raw) {
+    const trimmed = raw.trim();
+    if (trimmed.length === 0)
+        return "";
+    try {
+        return parseYaml(trimmed);
+    }
+    catch {
+        return raw;
+    }
+}
+/** Format a value for display in a single-line field editor. */
+export function formatFrontMatterFieldValue(value) {
+    if (value === null || value === undefined)
+        return "";
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number" || typeof value === "boolean") {
+        return String(value);
+    }
+    return stringifyYaml(value, { lineWidth: 0 }).replace(/\n$/, "");
+}
+//# sourceMappingURL=front-matter.js.map

package/dist/src/front-matter.js.map

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

package/dist/src/http.d.ts

@@ -1,6 +1,11 @@
 import type { IncomingMessage, ServerResponse } from "node:http";
+import { type ServeLivingDocViewInput } from "./living-doc.js";
 import { type ServePublicationInput } from "./publication.js";
 export declare function writeWebResponseToNodeResponse(webResponse: Response, nodeResponse: ServerResponse): Promise<void>;
 export declare function servePublicationNodeRequest(nodeRequest: IncomingMessage, nodeResponse: ServerResponse, dependencies: Omit<ServePublicationInput, "request">): Promise<void>;
+export declare function serveLivingDocViewNodeRequest(nodeRequest: IncomingMessage, nodeResponse: ServerResponse, dependencies: Omit<ServeLivingDocViewInput, "request">): Promise<void>;
+export declare function nodeRequestToWebRequest(request: IncomingMessage): Promise<Request>;
+export declare function nodeRequestUrl(request: IncomingMessage): string;
 export declare function publicationRequestUrl(request: IncomingMessage): string;
+export declare function livingDocViewRequestUrl(request: IncomingMessage): string;
 //# sourceMappingURL=http.d.ts.map

package/dist/src/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,kBAAkB,CAAC;AAE1B,wBAAsB,8BAA8B,CAClD,WAAW,EAAE,QAAQ,EACrB,YAAY,EAAE,cAAc,GAC3B,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,eAAe,EAC5B,YAAY,EAAE,cAAc,EAC5B,YAAY,EAAE,IAAI,CAAC,qBAAqB,EAAE,SAAS,CAAC,GACnD,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAKtE"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,kBAAkB,CAAC;AAE1B,wBAAsB,8BAA8B,CAClD,WAAW,EAAE,QAAQ,EACrB,YAAY,EAAE,cAAc,GAC3B,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,eAAe,EAC5B,YAAY,EAAE,cAAc,EAC5B,YAAY,EAAE,IAAI,CAAC,qBAAqB,EAAE,SAAS,CAAC,GACnD,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAsB,6BAA6B,CACjD,WAAW,EAAE,eAAe,EAC5B,YAAY,EAAE,cAAc,EAC5B,YAAY,EAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,CAAC,GACrD,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAI/D;AAWD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAKtE;AA2CD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAMxE"}

package/dist/src/http.js

@@ -1,3 +1,4 @@
+import { serveLivingDocViewRequest, } from "./living-doc.js";
 import { servePublicationRequest, } from "./publication.js";
 export async function writeWebResponseToNodeResponse(webResponse, nodeResponse) {
     nodeResponse.statusCode = webResponse.status;
@@ -21,6 +22,38 @@ export async function servePublicationNodeRequest(nodeRequest, nodeResponse, dep
     });
     await writeWebResponseToNodeResponse(response, nodeResponse);
 }
+export async function serveLivingDocViewNodeRequest(nodeRequest, nodeResponse, dependencies) {
+    const request = new Request(livingDocViewRequestUrl(nodeRequest), {
+        method: nodeRequest.method,
+        headers: nodeRequest.headers,
+    });
+    const response = await serveLivingDocViewRequest({
+        request,
+        ...dependencies,
+    });
+    await writeWebResponseToNodeResponse(response, nodeResponse);
+}
+export async function nodeRequestToWebRequest(request) {
+    const body = await readNodeRequestBody(request);
+    return new Request(nodeRequestUrl(request), {
+        method: request.method,
+        headers: request.headers,
+        body: body.length > 0 ? new Uint8Array(body) : undefined,
+    });
+}
+export function nodeRequestUrl(request) {
+    const host = request.headers.host ?? "localhost";
+    const protocol = request.headers["x-forwarded-proto"] ?? "https";
+    return `${protocol}://${host}${request.url ?? "/"}`;
+}
+function readNodeRequestBody(request) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        request.on("data", (chunk) => chunks.push(Buffer.from(chunk)));
+        request.on("end", () => resolve(Buffer.concat(chunks)));
+        request.on("error", reject);
+    });
+}
 export function publicationRequestUrl(request) {
     const host = request.headers.host ?? "localhost";
     const protocol = request.headers["x-forwarded-proto"] ?? "https";
@@ -59,4 +92,33 @@ function queryPathFromVercelCatchAll(path) {
 function isString(value) {
     return typeof value === "string";
 }
+export function livingDocViewRequestUrl(request) {
+    const host = request.headers.host ?? "localhost";
+    const protocol = request.headers["x-forwarded-proto"] ?? "https";
+    const viewPath = livingDocPathFromVercelRequest(request);
+    const search = new URL(request.url ?? "/", "https://localhost").search;
+    return `${protocol}://${host}/d/${viewPath}${search}`;
+}
+function livingDocPathFromVercelRequest(request) {
+    const queryOpaque = request.query?.opaque;
+    const queryPath = request.query?.path;
+    if (typeof queryOpaque === "string") {
+        return [queryOpaque, queryPathFromVercelCatchAll(queryPath)]
+            .filter(Boolean)
+            .join("/");
+    }
+    if (Array.isArray(queryOpaque) && typeof queryOpaque[0] === "string") {
+        return [queryOpaque[0], queryPathFromVercelCatchAll(queryPath)]
+            .filter(Boolean)
+            .join("/");
+    }
+    const pathname = new URL(request.url ?? "/", "https://localhost").pathname;
+    const apiPrefix = "/api/d/";
+    if (pathname.startsWith(apiPrefix))
+        return pathname.slice(apiPrefix.length);
+    const publicPrefix = "/d/";
+    if (pathname.startsWith(publicPrefix))
+        return pathname.slice(publicPrefix.length);
+    return pathname.split("/").filter(Boolean).at(-1) ?? "";
+}
 //# sourceMappingURL=http.js.map

package/dist/src/http.js.map

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

package/dist/src/index.d.ts

@@ -1,8 +1,15 @@
 export * from "./auth.js";
+export * from "./diff.js";
+export * from "./doc-asset-collect.js";
+export * from "./doc-asset-rewrite.js";
+export * from "./front-matter.js";
+export * from "./living-doc.js";
 export * from "./local-config.js";
 export * from "./publication.js";
 export * from "./remote-api.js";
 export * from "./local-config.js";
 export * from "./storage/artifact-content.js";
+export * from "./storage/doc-asset-content.js";
+export * from "./storage/living-doc-metadata.js";
 export * from "./storage/publication-metadata.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC"}

package/dist/src/index.js

@@ -1,8 +1,15 @@
 export * from "./auth.js";
+export * from "./diff.js";
+export * from "./doc-asset-collect.js";
+export * from "./doc-asset-rewrite.js";
+export * from "./front-matter.js";
+export * from "./living-doc.js";
 export * from "./local-config.js";
 export * from "./publication.js";
 export * from "./remote-api.js";
 export * from "./local-config.js";
 export * from "./storage/artifact-content.js";
+export * from "./storage/doc-asset-content.js";
+export * from "./storage/living-doc-metadata.js";
 export * from "./storage/publication-metadata.js";
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC"}

package/dist/src/living-doc.d.ts

@@ -0,0 +1,184 @@
+import { type PublisherTokenStore } from "./auth.js";
+import { type DocAssetContentStore } from "./storage/doc-asset-content.js";
+import { type CommentOrigin, type LivingDoc, type LivingDocComment, type LivingDocMetadataStore, type LivingDocSuggestion, type SuggestionStatus } from "./storage/living-doc-metadata.js";
+export { collectDocAssets, extractRelativeImageRefs, readCollectedDocAsset, toHostedAssetPath, type CollectedDocAsset, type CollectDocAssetsResult, } from "./doc-asset-collect.js";
+export { rewriteDocAssetMarkdown } from "./doc-asset-rewrite.js";
+export { deriveMarkdownTitle, formatFrontMatterFieldValue, joinFrontMatter, markdownBody, parseFrontMatterData, parseFrontMatterFieldValue, serializeFrontMatterData, splitFrontMatter, titleFromFrontMatter, } from "./front-matter.js";
+export { contentTypeForDocAssetPath, createVercelBlobDocAssetContentStore, docAssetBlobPath, InMemoryDocAssetContentStore, normalizeDocAssetPath, VercelBlobDocAssetContentStore, type DocAssetContentStore, } from "./storage/doc-asset-content.js";
+export declare const livingDocViewPrefix = "/d";
+export declare const livingDocReviewPrefix = "/r";
+export declare const maxLivingDocMarkdownBytes: number;
+export declare const maxLivingDocTextBytes: number;
+export interface PublishDocAssetPayload {
+    relativeRef: string;
+    assetPath: string;
+    contentType?: string;
+    /** Raw file bytes (Buffer) or base64 string from the API. */
+    data: Buffer | string;
+}
+export interface PublishLivingDocInput {
+    markdown: string;
+    publisherEmail: string;
+    publicBaseUrl: string;
+    store: LivingDocMetadataStore;
+    title?: string | null;
+    opaqueId?: string;
+    reviewId?: string;
+    contentStore?: DocAssetContentStore;
+    assets?: PublishDocAssetPayload[];
+}
+export interface PublishLivingDocResult {
+    opaqueId: string;
+    reviewId: string;
+    title: string | null;
+    viewUrl: string;
+    reviewUrl: string;
+    uploadedAssets: string[];
+}
+export declare function publishLivingDoc(input: PublishLivingDocInput): Promise<PublishLivingDocResult>;
+export interface PullLivingDocInput {
+    opaqueId: string;
+    publisherEmail: string;
+    store: LivingDocMetadataStore;
+}
+export interface PulledComment {
+    id: string;
+    origin: CommentOrigin;
+    author: string | null;
+    anchorQuote: string;
+    body: string;
+    createdAt: string;
+}
+export interface PulledSuggestion {
+    id: string;
+    anchorQuote: string;
+    anchorStart: number | null;
+    replacement: string;
+    note: string | null;
+    status: SuggestionStatus;
+}
+export interface PullLivingDocResult {
+    opaqueId: string;
+    title: string | null;
+    versionNumber: number;
+    previousVersionNumber: number | null;
+    markdown: string;
+    diffFromPreviousVersion: string | null;
+    openComments: PulledComment[];
+    priorSuggestions: PulledSuggestion[];
+}
+/**
+ * Cut an immutable Version of the Living Doc and return the current Markdown,
+ * a diff versus the previous Version, and the open Reviewer feedback. This is
+ * the turn boundary: each pull advances the version number.
+ */
+export declare function pullLivingDocFeedback(input: PullLivingDocInput): Promise<PullLivingDocResult>;
+export interface RespondSuggestionInput {
+    anchorQuote: string;
+    replacement: string;
+    note?: string | null;
+    anchorStart?: number | null;
+}
+export interface RespondReplyInput {
+    parentCommentId: string;
+    body: string;
+}
+export interface RespondLivingDocInput {
+    opaqueId: string;
+    publisherEmail: string;
+    store: LivingDocMetadataStore;
+    suggestions?: RespondSuggestionInput[];
+    replies?: RespondReplyInput[];
+}
+export interface RespondLivingDocResult {
+    opaqueId: string;
+    versionNumber: number;
+    createdSuggestions: PulledSuggestion[];
+    createdReplies: PulledComment[];
+}
+/**
+ * The agent's half of the round: post span-anchored Suggestions (never applied
+ * automatically) and replies to open Comments. Suggestions target the latest
+ * pulled Version.
+ */
+export declare function respondToLivingDoc(input: RespondLivingDocInput): Promise<RespondLivingDocResult>;
+export interface RemoveLivingDocInput {
+    opaqueId: string;
+    publisherEmail: string;
+    store: LivingDocMetadataStore;
+}
+export interface RemoveLivingDocResult {
+    opaqueId: string;
+    status: "removed" | "not-found";
+}
+/**
+ * Removal disables the Living Doc: the View Link and Review Link both stop
+ * serving it. This is the kill switch for a leaked Review Link.
+ */
+export declare function removeLivingDoc(input: RemoveLivingDocInput): Promise<RemoveLivingDocResult>;
+export interface ReviewStateResult {
+    opaqueId: string;
+    title: string | null;
+    versionNumber: number;
+    markdown: string;
+    comments: LivingDocComment[];
+    pendingSuggestions: LivingDocSuggestion[];
+}
+export declare function getReviewState(store: LivingDocMetadataStore, reviewId: string): Promise<ReviewStateResult>;
+export declare function saveReviewMarkdown(store: LivingDocMetadataStore, reviewId: string, markdown: string): Promise<LivingDoc>;
+export interface AddReviewerCommentInput {
+    anchorQuote: string;
+    body: string;
+    anchorStart?: number | null;
+    anchorEnd?: number | null;
+    author?: string | null;
+}
+export declare function addReviewerComment(store: LivingDocMetadataStore, reviewId: string, input: AddReviewerCommentInput): Promise<LivingDocComment>;
+export declare function resolveReviewerComment(store: LivingDocMetadataStore, reviewId: string, commentId: string): Promise<LivingDocComment>;
+export interface DecideSuggestionResult {
+    suggestion: LivingDocSuggestion;
+    markdown: string;
+    applied: boolean;
+    occurrenceCount: number;
+}
+/**
+ * Accept or reject an agent Suggestion. Accepting applies the change to the
+ * live Markdown at the anchored quote — when the quote matches more than one
+ * place, the occurrence nearest the Suggestion's anchorStart offset wins. If
+ * the quote no longer exists (the Reviewer edited past it), the Suggestion
+ * stays pending so its replacement text remains visible on the review surface
+ * instead of vanishing with an accepted-but-unapplied status.
+ */
+export declare function decideSuggestion(store: LivingDocMetadataStore, reviewId: string, suggestionId: string, decision: Extract<SuggestionStatus, "accepted" | "rejected">): Promise<DecideSuggestionResult>;
+export interface ServeLivingDocViewInput {
+    request: Request;
+    store: LivingDocMetadataStore;
+    contentStore?: DocAssetContentStore;
+}
+export declare function serveLivingDocViewRequest({ request, store, contentStore, }: ServeLivingDocViewInput): Promise<Response>;
+export interface HandleAgentApiInput {
+    request: Request;
+    store: LivingDocMetadataStore;
+    tokenStore: PublisherTokenStore;
+    publicBaseUrl?: string;
+    contentStore?: DocAssetContentStore;
+}
+export declare function handleLivingDocAgentApiRequest({ request, store, tokenStore, publicBaseUrl, contentStore, }: HandleAgentApiInput): Promise<Response>;
+export interface HandleReviewApiInput {
+    request: Request;
+    store: LivingDocMetadataStore;
+}
+export declare function handleReviewApiRequest({ request, store, }: HandleReviewApiInput): Promise<Response>;
+export declare function livingDocViewUrl(publicBaseUrl: string, opaqueId: string): string;
+export declare function livingDocAssetUrl(publicBaseUrl: string, opaqueId: string, assetPath: string): string;
+export declare function livingDocReviewUrl(publicBaseUrl: string, reviewId: string): string;
+export declare function livingDocViewRouteFromUrl(url: string): {
+    opaqueId: string;
+    assetPath: string;
+} | null;
+export declare function opaqueIdFromViewUrl(url: string): string | null;
+export declare function reviewIdFromReviewUrl(url: string): string | null;
+export declare function opaqueIdFromViewReference(reference: string): string;
+export declare function livingDocSafetyHeaders(headers?: HeadersInit): Headers;
+export declare function createReviewId(): string;
+//# sourceMappingURL=living-doc.d.ts.map

package/dist/src/living-doc.d.ts.map

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