@vibesdotdev/docs 0.0.0-stage → 1.0.0-rc.2

package/dist/documents/outline/parse-outline.js

@@ -0,0 +1,246 @@
+/**
+ * Drawing-set structure extraction — trade-neutral, in-isolate.
+ *
+ * Given the raw per-page text of a PDF (from the rasterization primitive's `pdftotext`
+ * pass) this derives each sheet's identity: its title-block NUMBER and TITLE, plus whether
+ * the page's text layer is garbled. That's document *structure* — the same shape a
+ * structural, MEP, or GC takeoff needs — so it lives in the generic documents package, not
+ * in a trade-specific place and not in the Docker container that only knows poppler.
+ *
+ * What is DELIBERATELY absent: a notion of "casework" (or another trade's relevance).
+ * Which sheets matter for a given takeoff is a DOMAIN judgment — the consuming surface's
+ * prompt/config tells the agent ("casework = millwork details / interior elevations /
+ * enlarged floor plans / the schedule"), and the model applies it to these titles. Baking a
+ * keyword list in here (as the old container `looksLikeCasework` did) both put org
+ * secret-sauce in shared infra AND had code doing a model's classification job — it flagged
+ * ~70% of a set from cross-sheet callouts, forcing a blind multi-page vision scan.
+ *
+ * HONEST BOUND on "neutral": every judgment this module makes about a page's IDENTITY is
+ * structural (field layout, reading order, letter/word statistics) and carries no trade
+ * vocabulary. The one exception is `detectSheetTitle`, a last-resort keyword fallback kept
+ * for sheets the set's own drawing index omits — it is a legacy title guess, explicitly
+ * labelled below, and it never decides relevance. Nothing here classifies a sheet.
+ *
+ * The rule every identity function obeys: a page's identity comes from THAT page. Nothing is
+ * borrowed from a neighbour or from the set-wide index because it happens to match, and when
+ * a page's own identity cannot be read the function returns a blank the agent can see. A
+ * confident wrong sheet number sends the agent to quote dimensions off the wrong drawing.
+ */
+/**
+ * Title-block / index sheet-number token, in the forms real sets actually print:
+ *
+ *   A-101 · A101 · A501 · A-101.1 · A2.01 · M1.02 · M-1.02 · FP-101 · G0.01
+ *
+ * A 1–2 letter discipline code, an optional hyphen, then either a 3-digit group or a dotted
+ * digit group. Two-digit equipment tags (VAV-02) and single-digit ids (P-1) never qualify.
+ *
+ * SHAPE ALONE CANNOT separate a sheet id from content noise — an equipment tag C840, a UL
+ * rating UL891 and a spec ref E814 are shape-identical to the hyphenless sheet id A101, so no
+ * amount of tightening this pattern distinguishes them, and tightening it to a literal hyphen
+ * + exactly three digits (as it briefly was) merely deleted the hyphenless and dotted
+ * conventions from the world. That call belongs to the STRUCTURE around a token instead: an
+ * index ROW is a standalone number FIELD followed by a caps-title FIELD; a title-block number
+ * is the LAST standalone number FIELD on the page that no index row on that page claims.
+ *
+ * Both readers therefore test a WHOLE ≥2-space-delimited column field — never a token fished
+ * out of running text, which is exactly where references to OTHER sheets live.
+ */
+const SHEET_NO_SOURCE = String.raw `[A-Z]{1,2}-?(?:\d{3}(?:\.\d{1,2})?|\d{1,2}\.\d{1,2})`;
+const SHEET_NO_FIELD_RE = new RegExp(String.raw `^${SHEET_NO_SOURCE}$`);
+/** A title block often prints its id and the id's LABEL in one cell — "SHEET NO.  A-221". The
+ *  label is anchored to the START of the field, so a reference living in running text ("SEE
+ *  SHEET A-521", "…sheets A-221, A-223") can never qualify. Document-structure vocabulary, not
+ *  a trade's. */
+const SHEET_NO_LABELLED_RE = new RegExp(String.raw `^(?:SHEET|DWG|DRAWING)\s*(?:NO\.?|NUMBER|#)?\s*[:.]?\s*(${SHEET_NO_SOURCE})$`);
+/** This field's sheet number when the FIELD ITSELF is one — either bare or behind its label.
+ *  '' when the field merely mentions a number somewhere inside other text. */
+function fieldSheetNumber(field) {
+    const token = field.trim();
+    if (SHEET_NO_FIELD_RE.test(token))
+        return token;
+    return SHEET_NO_LABELLED_RE.exec(token)?.[1] ?? '';
+}
+const TITLE_KEYWORDS = [
+    'INTERIOR ELEVATIONS', 'MILLWORK DETAILS', 'ENLARGED FLOOR PLAN', 'ENLARGED REFLECTED CEILING PLAN',
+    'REFLECTED CEILING PLAN', 'FINISH PLAN', 'FLOOR PLAN', 'DEMOLITION PLAN', 'PLAN DETAILS',
+    'PARTITION TYPES', 'DOOR SCHEDULE', 'WINDOW TYPES', 'EQUIPMENT SCHEDULE', 'FURNITURE',
+    'GENERAL INFORMATION', 'RENDERINGS', 'CASEWORK', 'COVER', 'SCHEDULE'
+];
+/**
+ * Parse the cover sheet's DRAWING INDEX into a canonical `number -> title` map. The index sits
+ * in a multi-column layout — "…project notes…  A-101  DEMOLITION PLAN  …" — so split each line
+ * on the ≥2-space column gap and read a standalone sheet-number FIELD immediately followed by a
+ * caps-title FIELD. Numbers embedded in note sentences ("…sheets A-221, A-223…") never form a
+ * standalone field, so they're rejected. This is the AUTHORITATIVE per-sheet identity.
+ */
+export function parseDrawingIndex(coverText) {
+    const map = new Map();
+    for (const raw of coverText.split('\n')) {
+        const fields = raw.split(/\s{2,}/).map((f) => f.trim()).filter(Boolean);
+        for (let i = 0; i < fields.length - 1; i++) {
+            if (!SHEET_NO_FIELD_RE.test(fields[i]))
+                continue;
+            const title = fields[i + 1].replace(/\s+/g, ' ').trim();
+            if (!/^[A-Z][A-Z0-9 &/,'.()-]{3,}$/.test(title))
+                continue;
+            if (!map.has(fields[i]))
+                map.set(fields[i], title);
+        }
+    }
+    return map;
+}
+/** How many index-shaped rows a page must print before it counts as a DRAWING INDEX page — a
+ *  LIST of other sheets rather than one sheet's own title block. A normal title block can print
+ *  "A-221  INTERIOR ELEVATIONS" as a single adjacent pair; a list is three or more. */
+const INDEX_PAGE_MIN_ROWS = 3;
+/**
+ * The sheet numbers a page prints as INDEX ROWS — i.e. the OTHER sheets it is listing, never
+ * its own identity. Empty unless the page prints a genuine list, so an ordinary title block is
+ * not mistaken for a one-row index of itself.
+ */
+function listedSheetNumbers(text) {
+    const rows = parseDrawingIndex((text || '').toUpperCase());
+    return rows.size >= INDEX_PAGE_MIN_ROWS ? new Set(rows.keys()) : new Set();
+}
+/**
+ * THIS page's own title-block sheet number.
+ *
+ * The title block is the bottom-right corner id, so in `-layout` text it is the LAST
+ * sheet-number token in reading order — read with the SAME column model `parseDrawingIndex`
+ * uses, and subject to two structural exclusions, both of which name a DIFFERENT sheet:
+ *
+ *   - The number must BE a whole ≥2-space-delimited column field (bare, or behind a
+ *     "SHEET NO." label anchored at the field start), not sit inside one. A title block prints
+ *     its id in its own cell; a reference to another sheet is USUALLY embedded in surrounding
+ *     text — a prose note ("…REFERENCING sheets A-221, A-223"), an instruction ("SEE A-101 FOR
+ *     DEMOLITION SCOPE"), a prose detail callout ("SEE DETAIL 3/A-521").
+ *
+ *     This exclusion is NOT sufficient on its own, and the difference matters. A detail callout
+ *     BUBBLE — the commonest annotation on an architectural sheet — extracts under
+ *     `pdftotext -layout` as the detail no. stacked over the sheet no., EACH ALONE IN ITS OWN
+ *     CELL. It is structurally indistinguishable from a title-block id, so "keep the last
+ *     standalone field" silently returned the CALLOUT's target and, through it, that sheet's
+ *     canonical index title — the exact wrong-sheet harm this function exists to prevent.
+ *     Hence the ambiguity rule below.
+ *   - A row of a drawing index this page itself prints (cover / index sheets) lists OTHER
+ *     sheets, never this one.
+ *
+ * It is NEVER borrowed from the set's drawing index. Membership in that index proves only that
+ * SOME sheet carries the number, not that this page is that sheet — the previous
+ * cross-validation walked tokens from the end and returned the first index MEMBER, which
+ * stamped the index page itself (and every sheet whose own number the index omitted) with the
+ * last indexed sheet's number, and through it that sheet's canonical title.
+ *
+ * When this page's own number cannot be read, return '' — an honest blank the agent can see
+ * beats a confident wrong sheet. There is deliberately no most-frequent-token fallback: the
+ * most frequent id-shaped token on a sheet is routinely an equipment tag or a spec reference.
+ */
+export function titleBlockSheetNumber(text) {
+    const upper = (text || '').toUpperCase();
+    const listed = listedSheetNumbers(upper);
+    const candidates = new Set();
+    for (const line of upper.split('\n')) {
+        for (const field of line.split(/\s{2,}/)) {
+            const token = fieldSheetNumber(field); // '' when embedded in text → another sheet
+            if (!token)
+                continue;
+            if (listed.has(token))
+                continue; // a row of the index THIS page prints
+            candidates.add(token);
+        }
+    }
+    // AMBIGUITY IS A BLANK, NOT A GUESS. A page prints its OWN id in the title block; if two or
+    // more DIFFERENT standalone ids survive, at least one of them names another sheet (a callout
+    // bubble, a short "REFERENCE DRAWINGS" table too small to read as an index) and nothing in
+    // the text layer says which. Picking one — the previous "last in reading order" — is a coin
+    // flip that, when it loses, hands the model a different sheet's number AND that sheet's
+    // canonical title. A blank is visibly unknown; a wrong sheet is invisibly wrong.
+    // The same id repeated (title block header + footer) is not ambiguity — hence the Set.
+    if (candidates.size !== 1)
+        return '';
+    return [...candidates][0] ?? '';
+}
+/** LEGACY keyword title guess — the one trade-flavoured thing left in this module. Used only
+ *  for a page the set's drawing index does not list, and only to put SOMETHING readable in
+ *  front of the model; it never decides relevance. Prefer the index title whenever it exists. */
+export function detectSheetTitle(text) {
+    const t = text.toUpperCase();
+    for (const title of TITLE_KEYWORDS)
+        if (t.includes(title))
+            return title;
+    return '';
+}
+/** A "word": a run of 3+ letters. Domain- and language-neutral — a legible Latin-alphabet page
+ *  carries them whatever trade drew it; a Caesar-shifted CAD font maps letters onto punctuation,
+ *  so a broken text layer carries none. */
+const WORD_RUN_RE = /[A-Za-z]{3,}/g;
+/** Three independent 3-letter runs is far beyond chance at the 0.00–0.01 letter ratio a
+ *  shifted-font layer scores, and is present on any legible page — including a letter-POOR one
+ *  (a bar list, a bill of quantities, a numeric table) whose column headers are its only prose. */
+const MIN_WORDS_FOR_LEGIBLE = 3;
+/** Below this letter ratio a page is too letter-poor to judge by prose alone (garbled sheets
+ *  score 0.00–0.01; legible architectural pages 0.51–0.94). */
+const LETTER_POOR_RATIO = 0.35;
+/**
+ * True when a page's text layer is GARBLED — a custom font encoding pdftotext can't decode
+ * (e.g. a Caesar-shifted CAD font extracts "DEMOLITION" as "'(02/,7,21").
+ *
+ * Two independent, DOMAIN-NEUTRAL tests must both fire: the page is letter-poor, AND no words
+ * survive it. The second test used to be "zero hits against an ARCHITECTURE keyword list",
+ * which condemned any legible document that simply isn't architectural — a rebar bar list, a
+ * bill of quantities, a numeric schedule — inside a package that must serve every trade. What
+ * actually separates a broken layer from a letter-poor legible one is not WHICH words appear
+ * (a domain judgment, and the model's job) but WHETHER ANY word appears at all.
+ *
+ * Mostly-graphic sheets (little text) are NOT garbled — they just have few characters.
+ */
+export function textLooksGarbled(text) {
+    const nonSpace = (text || '').replace(/\s+/g, '');
+    if (nonSpace.length < 200)
+        return false;
+    const letters = (nonSpace.match(/[A-Za-z]/g) || []).length;
+    if (letters / nonSpace.length >= LETTER_POOR_RATIO)
+        return false;
+    const words = ((text || '').match(WORD_RUN_RE) || []).length;
+    return words < MIN_WORDS_FOR_LEGIBLE;
+}
+/**
+ * Build the structural outline from the rasterizer's raw per-page text. Trade-neutral: emits
+ * number + title + garbled per sheet. The cover drawing index (first few sheets) supplies the
+ * canonical title for the sheets it lists; each page's NUMBER is read from that page's own
+ * title block. NO relevance flag — the consuming surface's prompt + the model decide which
+ * sheets a given takeoff needs.
+ */
+export function buildOutlineFromPages(raw) {
+    const { pageCount, pageWidthIn, pageHeightIn, pages } = raw;
+    const drawingIndex = parseDrawingIndex(pages.slice(0, 5).map((p) => p.text).join('\n'));
+    const sheets = [];
+    let garbledCount = 0;
+    for (const { page, text } of pages) {
+        if (!text || !text.trim())
+            continue;
+        if (pageCount > 0 && page > pageCount)
+            break;
+        if (textLooksGarbled(text)) {
+            garbledCount += 1;
+            sheets.push({ page, number: '', title: '', garbled: true });
+            continue;
+        }
+        const number = titleBlockSheetNumber(text);
+        // Canonical index title when the index lists THIS page's own number; otherwise the
+        // keyword guess — decided PER PAGE. Gating that fallback on whether the SET as a whole
+        // had a parseable index blanked the title of every sheet a partially-parsed index
+        // happened to miss (mechanical/plumbing/continuation sheets), titles the container on
+        // main always produced.
+        //
+        // The single page a keyword scan cannot speak for is a page that PRINTS the index: it
+        // carries every OTHER sheet's title, so a keyword hit there would be one more borrowed
+        // identity. That page gets '' unless the index names its own number.
+        const canonical = number ? drawingIndex.get(number) : undefined;
+        const title = canonical ?? (listedSheetNumbers(text).size > 0 ? '' : detectSheetTitle(text));
+        sheets.push({ page, number, title });
+    }
+    const textLayerReliable = sheets.length === 0 ? true : garbledCount / sheets.length < 0.5;
+    return { pageCount, pageWidthIn, pageHeightIn, sheets, textLayerReliable };
+}
+//# sourceMappingURL=parse-outline.js.map

package/dist/documents/outline/parse-outline.js.map

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

package/dist/documents/plugin.d.ts

@@ -0,0 +1,3 @@
+export declare const documentsPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default documentsPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/documents/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/documents/plugin.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,eAAe,6CAM1B,CAAC;AACH,eAAe,eAAe,CAAC"}

package/dist/documents/plugin.js

@@ -0,0 +1,13 @@
+/** Compatible full document composition. Use cloud.plugin or universal.plugin in portable hosts. */
+import { createRuntimePlugin } from '@vibesdotdev/kernel';
+import documentsCloudPlugin from "./documents.cloud.plugin.js";
+import documentsConsumerPlugin from "./documents.consumer.plugin.js";
+export const documentsPlugin = createRuntimePlugin({
+    id: 'documents.compatible',
+    async onRegister(runtime) {
+        await runtime.registerPlugin(documentsCloudPlugin);
+        await runtime.registerPlugin(documentsConsumerPlugin);
+    }
+});
+export default documentsPlugin;
+//# sourceMappingURL=plugin.js.map

package/dist/documents/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/documents/plugin.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,oBAAoB,MAAM,6BAA6B,CAAC;AAC/D,OAAO,uBAAuB,MAAM,gCAAgC,CAAC;AAErE,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;IAClD,EAAE,EAAE,sBAAsB;IAC1B,KAAK,CAAC,UAAU,CAAC,OAAO;QACvB,MAAM,OAAO,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC;QACnD,MAAM,OAAO,CAAC,cAAc,CAAC,uBAAuB,CAAC,CAAC;IACvD,CAAC;CACD,CAAC,CAAC;AACH,eAAe,eAAe,CAAC"}

package/dist/documents/presentations/capabilities/index.d.ts

@@ -0,0 +1,3 @@
+export * from './presentations.directory.kind.ts';
+export * from './presentations.surface.kind.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/documents/presentations/capabilities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/documents/presentations/capabilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC"}

package/dist/documents/presentations/capabilities/index.js

@@ -0,0 +1,3 @@
+export * from "./presentations.directory.kind.js";
+export * from "./presentations.surface.kind.js";
+//# sourceMappingURL=index.js.map

package/dist/documents/presentations/capabilities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/documents/presentations/capabilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC"}

package/dist/documents/presentations/capabilities/presentations.directory.impl.consumer.worker.d.ts

@@ -0,0 +1,333 @@
+import { type KindContext, type RuntimeDescriptor } from '@vibesdotdev/kernel';
+import { type CreatePresentationRequestInput, type WithdrawPresentationRequestInput } from '../schemas/index.ts';
+import type { PresentationsDirectoryCapability } from './presentations.directory.kind.ts';
+export default class ConsumerPresentationsDirectoryCapability implements PresentationsDirectoryCapability {
+    private readonly runtime;
+    constructor(_descriptor: RuntimeDescriptor, context: KindContext);
+    listSurfaces(input?: {
+        owner?: {
+            type: "user";
+            id: string;
+        } | {
+            type: "organization";
+            id: string;
+        } | undefined;
+        requires?: ("present.session" | "present.artifact" | "present.image" | "present.code" | "present.plan" | "input.pointer" | "input.touch" | "input.ink" | "input.keyboard" | "input.voice" | "review.comment" | "review.annotation" | "review.steering")[] | undefined;
+        includeBusy?: boolean | undefined;
+    }): Promise<{
+        id: string;
+        capabilities: ("present.session" | "present.artifact" | "present.image" | "present.code" | "present.plan" | "input.pointer" | "input.touch" | "input.ink" | "input.keyboard" | "input.voice" | "review.comment" | "review.annotation" | "review.steering")[];
+        label: string;
+        state: {
+            visibility: "unknown" | "background" | "foreground";
+            engagement: "unknown" | "active" | "idle";
+            availability: "available" | "busy" | "ask" | "do-not-disturb";
+            presentation: "idle" | "presenting";
+        };
+        client: string;
+        formFactor: "browser" | "desktop" | "tablet" | "phone" | "display";
+    }[]>;
+    createRequest(input: CreatePresentationRequestInput): Promise<{
+        id: string;
+        requester: {
+            id: string;
+            type: "agent";
+            roles?: string[] | undefined;
+            displayName?: string | undefined;
+        };
+        owner: {
+            type: "user";
+            id: string;
+        } | {
+            type: "organization";
+            id: string;
+        };
+        sessionId: string;
+        preferredSurfaceId: string | null;
+        selectedSurfaceId: string | null;
+        target: {
+            view: "session" | "artifact" | "image-review" | "code-review" | "plan-review";
+            link: {
+                kind: string;
+                id: string;
+                source: string;
+                role: string;
+            };
+            title?: string | undefined;
+            revision?: string | undefined;
+            anchor?: {
+                kind: "region";
+                rect: {
+                    x: number;
+                    y: number;
+                    width: number;
+                    height: number;
+                };
+            } | {
+                kind: "code";
+                path: string;
+                startLine: number;
+                endLine: number;
+            } | {
+                kind: "plan-node";
+                nodeId: string;
+            } | {
+                kind: "fragment";
+                id: string;
+            } | undefined;
+        };
+        message: string;
+        requestedCapabilities: ("present.session" | "present.artifact" | "present.image" | "present.code" | "present.plan" | "input.pointer" | "input.touch" | "input.ink" | "input.keyboard" | "input.voice" | "review.comment" | "review.annotation" | "review.steering")[];
+        urgency: "high" | "normal";
+        status: "failed" | "pending" | "completed" | "accepted" | "presenting" | "declined" | "expired" | "withdrawn";
+        revision: number;
+        createdAt: string;
+        updatedAt: string;
+        expiresAt: string;
+        respondedAt: string | null;
+        presentingAt: string | null;
+        completedAt: string | null;
+        note: string | null;
+    }>;
+    getRequest(requestId: string): Promise<{
+        id: string;
+        requester: {
+            id: string;
+            type: "agent";
+            roles?: string[] | undefined;
+            displayName?: string | undefined;
+        };
+        owner: {
+            type: "user";
+            id: string;
+        } | {
+            type: "organization";
+            id: string;
+        };
+        sessionId: string;
+        preferredSurfaceId: string | null;
+        selectedSurfaceId: string | null;
+        target: {
+            view: "session" | "artifact" | "image-review" | "code-review" | "plan-review";
+            link: {
+                kind: string;
+                id: string;
+                source: string;
+                role: string;
+            };
+            title?: string | undefined;
+            revision?: string | undefined;
+            anchor?: {
+                kind: "region";
+                rect: {
+                    x: number;
+                    y: number;
+                    width: number;
+                    height: number;
+                };
+            } | {
+                kind: "code";
+                path: string;
+                startLine: number;
+                endLine: number;
+            } | {
+                kind: "plan-node";
+                nodeId: string;
+            } | {
+                kind: "fragment";
+                id: string;
+            } | undefined;
+        };
+        message: string;
+        requestedCapabilities: ("present.session" | "present.artifact" | "present.image" | "present.code" | "present.plan" | "input.pointer" | "input.touch" | "input.ink" | "input.keyboard" | "input.voice" | "review.comment" | "review.annotation" | "review.steering")[];
+        urgency: "high" | "normal";
+        status: "failed" | "pending" | "completed" | "accepted" | "presenting" | "declined" | "expired" | "withdrawn";
+        revision: number;
+        createdAt: string;
+        updatedAt: string;
+        expiresAt: string;
+        respondedAt: string | null;
+        presentingAt: string | null;
+        completedAt: string | null;
+        note: string | null;
+    } | null>;
+    listRequests(input?: {
+        limit: number;
+        status?: ("failed" | "pending" | "completed" | "accepted" | "presenting" | "declined" | "expired" | "withdrawn")[] | undefined;
+        surfaceId?: string | undefined;
+    }): Promise<{
+        id: string;
+        requester: {
+            id: string;
+            type: "agent";
+            roles?: string[] | undefined;
+            displayName?: string | undefined;
+        };
+        owner: {
+            type: "user";
+            id: string;
+        } | {
+            type: "organization";
+            id: string;
+        };
+        sessionId: string;
+        preferredSurfaceId: string | null;
+        selectedSurfaceId: string | null;
+        target: {
+            view: "session" | "artifact" | "image-review" | "code-review" | "plan-review";
+            link: {
+                kind: string;
+                id: string;
+                source: string;
+                role: string;
+            };
+            title?: string | undefined;
+            revision?: string | undefined;
+            anchor?: {
+                kind: "region";
+                rect: {
+                    x: number;
+                    y: number;
+                    width: number;
+                    height: number;
+                };
+            } | {
+                kind: "code";
+                path: string;
+                startLine: number;
+                endLine: number;
+            } | {
+                kind: "plan-node";
+                nodeId: string;
+            } | {
+                kind: "fragment";
+                id: string;
+            } | undefined;
+        };
+        message: string;
+        requestedCapabilities: ("present.session" | "present.artifact" | "present.image" | "present.code" | "present.plan" | "input.pointer" | "input.touch" | "input.ink" | "input.keyboard" | "input.voice" | "review.comment" | "review.annotation" | "review.steering")[];
+        urgency: "high" | "normal";
+        status: "failed" | "pending" | "completed" | "accepted" | "presenting" | "declined" | "expired" | "withdrawn";
+        revision: number;
+        createdAt: string;
+        updatedAt: string;
+        expiresAt: string;
+        respondedAt: string | null;
+        presentingAt: string | null;
+        completedAt: string | null;
+        note: string | null;
+    }[]>;
+    withdrawRequest(input: WithdrawPresentationRequestInput): Promise<{
+        id: string;
+        requester: {
+            id: string;
+            type: "agent";
+            roles?: string[] | undefined;
+            displayName?: string | undefined;
+        };
+        owner: {
+            type: "user";
+            id: string;
+        } | {
+            type: "organization";
+            id: string;
+        };
+        sessionId: string;
+        preferredSurfaceId: string | null;
+        selectedSurfaceId: string | null;
+        target: {
+            view: "session" | "artifact" | "image-review" | "code-review" | "plan-review";
+            link: {
+                kind: string;
+                id: string;
+                source: string;
+                role: string;
+            };
+            title?: string | undefined;
+            revision?: string | undefined;
+            anchor?: {
+                kind: "region";
+                rect: {
+                    x: number;
+                    y: number;
+                    width: number;
+                    height: number;
+                };
+            } | {
+                kind: "code";
+                path: string;
+                startLine: number;
+                endLine: number;
+            } | {
+                kind: "plan-node";
+                nodeId: string;
+            } | {
+                kind: "fragment";
+                id: string;
+            } | undefined;
+        };
+        message: string;
+        requestedCapabilities: ("present.session" | "present.artifact" | "present.image" | "present.code" | "present.plan" | "input.pointer" | "input.touch" | "input.ink" | "input.keyboard" | "input.voice" | "review.comment" | "review.annotation" | "review.steering")[];
+        urgency: "high" | "normal";
+        status: "failed" | "pending" | "completed" | "accepted" | "presenting" | "declined" | "expired" | "withdrawn";
+        revision: number;
+        createdAt: string;
+        updatedAt: string;
+        expiresAt: string;
+        respondedAt: string | null;
+        presentingAt: string | null;
+        completedAt: string | null;
+        note: string | null;
+    }>;
+    listReviews(requestId: string): Promise<{
+        id: string;
+        requestId: string;
+        surfaceId: string;
+        submitter: {
+            type: "user" | "agent" | "service" | "operator";
+            id: string;
+            roles?: string[] | undefined;
+        };
+        accessGrantId: string | null;
+        targetRevision: string | null;
+        audience: "owner-only" | "request-participants";
+        items: ({
+            kind: "code-note";
+            path: string;
+            startLine: number;
+            endLine: number;
+            text: string;
+        } | {
+            kind: "comment";
+            text: string;
+        } | {
+            kind: "steering";
+            text: string;
+        } | {
+            kind: "region-note";
+            rect: {
+                x: number;
+                y: number;
+                width: number;
+                height: number;
+            };
+            text: string;
+        } | {
+            kind: "ink-stroke";
+            points: {
+                x: number;
+                y: number;
+                pressure?: number | undefined;
+            }[];
+            color: string;
+            width: number;
+        } | {
+            kind: "plan-note";
+            nodeId: string;
+            text: string;
+        })[];
+        createdAt: string;
+    }[]>;
+    private request;
+}
+//# sourceMappingURL=presentations.directory.impl.consumer.worker.d.ts.map

package/dist/documents/presentations/capabilities/presentations.directory.impl.consumer.worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentations.directory.impl.consumer.worker.d.ts","sourceRoot":"","sources":["../../../../src/documents/presentations/capabilities/presentations.directory.impl.consumer.worker.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,WAAW,EAAE,KAAK,iBAAiB,EAAmB,MAAM,qBAAqB,CAAC;AAGjH,OAAO,EAQN,KAAK,8BAA8B,EACnC,KAAK,gCAAgC,EACrC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,mCAAmC,CAAC;AAmC1F,MAAM,CAAC,OAAO,OAAO,wCAAyC,YAAW,gCAAgC;IACxG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;gBAEzB,WAAW,EAAE,iBAAiB,EAAE,OAAO,EAAE,WAAW;IAW1D,YAAY,CAAC,KAAK;;;;;;;;;;KAAgD;;;;;;;;;;;;;IAelE,aAAa,CAAC,KAAK,EAAE,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUnD,UAAU,CAAC,SAAS,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAO5B,YAAY,CAAC,KAAK;;;;KAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUlE,eAAe,CAAC,KAAK,EAAE,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkBvD,WAAW,CAAC,SAAS,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAQrB,OAAO;CA4BrB"}