@derive-to/artifacts 0.0.0-stage → 0.6.0

package/dist/protocol/http.js

@@ -0,0 +1,72 @@
+import * as z from "zod/mini";
+import { verbSchema } from "./access.js";
+import { pointSchema, quoteSchema } from "./anchors.js";
+import { actorSchema, featureSchema } from "./extension.js";
+import { snapshotSchema, stateKeySchema } from "./state.js";
+/** MCP Apps' CSP declaration, by the same field names (`_meta.ui.csp`). Empty means the
+ *  artifact may reach nothing on the network, which is the default. */
+const domains = z.optional(z.array(z.string()));
+export const cspSchema = z.object({
+    connectDomains: domains,
+    resourceDomains: domains,
+    frameDomains: domains,
+    baseUriDomains: domains,
+});
+const timestamp = z.iso.datetime();
+const positiveInt = z.int().check(z.positive());
+export const versionSchema = z.object({
+    n: positiveInt,
+    createdAt: timestamp,
+    createdBy: actorSchema,
+    csp: cspSchema,
+});
+/** "page" scrolls; "slides" shows each top-level <section> as a 16:9 slide and can present. */
+export const ARTIFACT_KINDS = ["page", "slides"];
+export const artifactKindSchema = z.enum(ARTIFACT_KINDS);
+export const artifactSchema = z.object({
+    id: z.string(),
+    title: z.string(),
+    currentVersion: positiveInt,
+    createdAt: timestamp,
+    updatedAt: timestamp,
+    createdBy: actorSchema,
+    /** Who published the current version. */
+    updatedBy: actorSchema,
+    /** Plain text from the current version (its meta description or first paragraph). */
+    summary: z.string(),
+    /** How viewers lay it out, from the current version's <meta name="artifact-kind">. */
+    kind: artifactKindSchema,
+    /** Comment threads, and the latest distinct commenters (newest first, at most five). */
+    activity: z.object({
+        openThreads: z.int().check(z.nonnegative()),
+        threads: z.int().check(z.nonnegative()),
+        people: z.array(actorSchema),
+    }),
+    /** The verbs the requesting actor holds, so a UI can show only what works. */
+    can: z.array(verbSchema),
+    /** What the server's plugins offer for this artifact, so a UI shows only what exists. */
+    features: z.array(featureSchema),
+});
+export const commentSchema = z.object({
+    id: z.string(),
+    threadId: z.string(),
+    version: positiveInt,
+    quote: z.nullable(quoteSchema),
+    body: z.string().check(z.minLength(1), z.maxLength(10_000)),
+    author: actorSchema,
+    createdAt: timestamp,
+});
+export const threadStateSchema = z.enum(["open", "resolved", "outdated"]);
+export const threadSchema = z.object({
+    id: z.string(),
+    state: threadStateSchema,
+    comments: z.array(commentSchema).check(z.minLength(1)),
+});
+/** Server-sent events on `GET /artifacts/:id/events`. */
+export const eventSchema = z.discriminatedUnion("type", [
+    z.object({ type: z.literal("version.published"), version: versionSchema }),
+    z.object({ type: z.literal("thread.changed"), thread: threadSchema }),
+    z.object({ type: z.literal("state.changed"), key: stateKeySchema, snapshot: snapshotSchema }),
+    z.object({ type: z.literal("presence"), actor: actorSchema, cursor: z.nullable(pointSchema) }),
+]);
+//# sourceMappingURL=http.js.map

package/dist/protocol/http.js.map

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

package/dist/protocol/index.d.ts

@@ -0,0 +1,19 @@
+export * from "./access.js";
+export * from "./anchors.js";
+export * from "./define.js";
+export * from "./errors.js";
+export * from "./extension.js";
+export * from "./http.js";
+export * from "./inputs.js";
+export * from "./layout.js";
+export * from "./mentions.js";
+export * from "./methods.js";
+export * from "./presentation.js";
+export * from "./quote-match.js";
+export * from "./sharing.js";
+export * from "./state.js";
+export * from "./state-apply.js";
+export * from "./text.js";
+export * from "./tools.js";
+export * from "./viewer.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA"}

package/dist/protocol/index.js

@@ -0,0 +1,19 @@
+export * from "./access.js";
+export * from "./anchors.js";
+export * from "./define.js";
+export * from "./errors.js";
+export * from "./extension.js";
+export * from "./http.js";
+export * from "./inputs.js";
+export * from "./layout.js";
+export * from "./mentions.js";
+export * from "./methods.js";
+export * from "./presentation.js";
+export * from "./quote-match.js";
+export * from "./sharing.js";
+export * from "./state.js";
+export * from "./state-apply.js";
+export * from "./text.js";
+export * from "./tools.js";
+export * from "./viewer.js";
+//# sourceMappingURL=index.js.map

package/dist/protocol/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA"}

package/dist/protocol/inputs.d.ts

@@ -0,0 +1,62 @@
+import * as z from "zod/mini";
+/**
+ * One input schema per operation, used by every face (REST and MCP), so the two never accept
+ * different things for the same action.
+ */
+export declare const MAX_HTML_CHARS: number;
+/** An artifact id from any face. */
+export declare const artifactIdInput: z.ZodMiniString<string>;
+export declare const titleInput: z.ZodMiniString<string>;
+export declare const htmlInput: z.ZodMiniString<string>;
+export declare const commentBodyInput: z.ZodMiniString<string>;
+/** A version number from a path or an argument: a whole number from 1. */
+export declare const versionNumberInput: z.ZodMiniInt;
+export declare const versionParamInput: z.ZodMiniNumber<unknown>;
+/**
+ * A domain an artifact may reach: an `http(s)` or `ws(s)` origin, optionally with one
+ * leading `*.` label. A bare `*` or a bare scheme (`https:`) would open the network to
+ * everything, and quotes, semicolons or spaces could break out of the directive, so all of
+ * those are refused rather than dropped.
+ */
+export declare const cspDomainInput: z.ZodMiniString<string>;
+/** What an artifact declares it may reach, as input. Stored values read through `cspSchema`. */
+export declare const cspInput: z.ZodMiniDefault<z.ZodMiniObject<{
+    connectDomains: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+    resourceDomains: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+    frameDomains: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+    baseUriDomains: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+}, z.core.$strip>>;
+/** A page of artifacts. Query strings arrive as text, so `limit` and `mine` are coerced. */
+export declare const listInput: z.ZodMiniObject<{
+    limit: z.ZodMiniOptional<z.ZodMiniNumber<unknown>>;
+    cursor: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    search: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    mine: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniBoolean<boolean>, z.ZodMiniCodec<z.ZodMiniString<unknown>, z.ZodMiniBoolean<unknown>>]>>;
+}, z.core.$strip>;
+export declare const createInput: z.ZodMiniObject<{
+    title: z.ZodMiniString<string>;
+    html: z.ZodMiniString<string>;
+    csp: z.ZodMiniDefault<z.ZodMiniObject<{
+        connectDomains: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+        resourceDomains: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+        frameDomains: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+        baseUriDomains: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const renameInput: z.ZodMiniObject<{
+    title: z.ZodMiniString<string>;
+}, z.core.$strip>;
+export declare const publishInput: z.ZodMiniObject<{
+    html: z.ZodMiniString<string>;
+    csp: z.ZodMiniDefault<z.ZodMiniObject<{
+        connectDomains: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+        resourceDomains: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+        frameDomains: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+        baseUriDomains: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+    }, z.core.$strip>>;
+    expected: z.ZodMiniInt;
+    addresses: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+}, z.core.$strip>;
+/** Base64 bytes of an uploaded asset, at most `maxBytes` once decoded. */
+export declare const assetDataInput: (maxBytes: number) => z.ZodMiniBase64;
+//# sourceMappingURL=inputs.d.ts.map

package/dist/protocol/inputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../../src/protocol/inputs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAE7B;;;GAGG;AAEH,eAAO,MAAM,cAAc,QAAkB,CAAA;AAE7C,oCAAoC;AACpC,eAAO,MAAM,eAAe,yBAAoD,CAAA;AAChF,eAAO,MAAM,UAAU,yBAA+D,CAAA;AACtF,eAAO,MAAM,SAAS,yBAAgE,CAAA;AACtF,eAAO,MAAM,gBAAgB,yBAAkE,CAAA;AAC/F,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,cAA8B,CAAA;AAC7D,eAAO,MAAM,iBAAiB,0BAAiD,CAAA;AAE/E;;;;;GAKG;AACH,eAAO,MAAM,cAAc,yBAKxB,CAAA;AAGH,gGAAgG;AAChG,eAAO,MAAM,QAAQ;;;;;kBAQpB,CAAA;AAED,4FAA4F;AAC5F,eAAO,MAAM,SAAS;;;;;iBAKpB,CAAA;AAEF,eAAO,MAAM,WAAW;;;;;;;;;iBAAkE,CAAA;AAC1F,eAAO,MAAM,WAAW;;iBAAkC,CAAA;AAC1D,eAAO,MAAM,YAAY;;;;;;;;;;iBAOvB,CAAA;AACF,0EAA0E;AAC1E,eAAO,MAAM,cAAc,aAAc,MAAM,oBACa,CAAA"}

package/dist/protocol/inputs.js

@@ -0,0 +1,51 @@
+import * as z from "zod/mini";
+/**
+ * One input schema per operation, used by every face (REST and MCP), so the two never accept
+ * different things for the same action.
+ */
+export const MAX_HTML_CHARS = 5 * 1024 * 1024;
+/** An artifact id from any face. */
+export const artifactIdInput = z.string().check(z.minLength(1), z.maxLength(64));
+export const titleInput = z.string().check(z.trim(), z.minLength(1), z.maxLength(300));
+export const htmlInput = z.string().check(z.minLength(1), z.maxLength(MAX_HTML_CHARS));
+export const commentBodyInput = z.string().check(z.trim(), z.minLength(1), z.maxLength(10_000));
+/** A version number from a path or an argument: a whole number from 1. */
+export const versionNumberInput = z.int().check(z.positive());
+export const versionParamInput = z.coerce.number().check(z.int(), z.positive());
+/**
+ * A domain an artifact may reach: an `http(s)` or `ws(s)` origin, optionally with one
+ * leading `*.` label. A bare `*` or a bare scheme (`https:`) would open the network to
+ * everything, and quotes, semicolons or spaces could break out of the directive, so all of
+ * those are refused rather than dropped.
+ */
+export const cspDomainInput = z
+    .string()
+    .check(z.maxLength(253), z.regex(/^(https?|wss?):\/\/(\*\.)?[a-z0-9-]+(\.[a-z0-9-]+)*(:\d{1,5})?$/i));
+const domains = z.optional(z.array(cspDomainInput).check(z.maxLength(50)));
+/** What an artifact declares it may reach, as input. Stored values read through `cspSchema`. */
+export const cspInput = z._default(z.object({
+    connectDomains: domains,
+    resourceDomains: domains,
+    frameDomains: domains,
+    baseUriDomains: domains,
+}), {});
+/** A page of artifacts. Query strings arrive as text, so `limit` and `mine` are coerced. */
+export const listInput = z.object({
+    limit: z.optional(z.coerce.number().check(z.int(), z.minimum(1), z.maximum(200))),
+    cursor: z.optional(z.string().check(z.maxLength(200))),
+    search: z.optional(z.string().check(z.maxLength(300))),
+    mine: z.optional(z.union([z.boolean(), z.stringbool()])),
+});
+export const createInput = z.object({ title: titleInput, html: htmlInput, csp: cspInput });
+export const renameInput = z.object({ title: titleInput });
+export const publishInput = z.object({
+    html: htmlInput,
+    csp: cspInput,
+    /** The version the caller read; if someone published since, the publish is refused. */
+    expected: versionNumberInput,
+    /** Thread ids this version answers; they resolve with a note. */
+    addresses: z.optional(z.array(z.string().check(z.maxLength(64))).check(z.maxLength(50))),
+});
+/** Base64 bytes of an uploaded asset, at most `maxBytes` once decoded. */
+export const assetDataInput = (maxBytes) => z.base64().check(z.maxLength(4 * Math.ceil(maxBytes / 3)));
+//# sourceMappingURL=inputs.js.map

package/dist/protocol/inputs.js.map

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

package/dist/protocol/layout.d.ts

@@ -0,0 +1,33 @@
+import * as z from "zod/mini";
+export declare const LAYOUT_ATTRIBUTE = "data-open-artifact-layout";
+export declare const REGION_ATTRIBUTE = "data-open-artifact-region";
+export declare const ELEMENT_ATTRIBUTE = "data-open-artifact-element";
+export declare const HANDLE_ATTRIBUTE = "data-open-artifact-handle";
+/** A page declares the parts a person may arrange. Widget content stays opaque. */
+export declare const artifactLayoutSchema: z.ZodMiniObject<{
+    version: z.ZodMiniLiteral<1>;
+    regions: z.ZodMiniArray<z.ZodMiniObject<{
+        id: z.ZodMiniString<string>;
+        mode: z.ZodMiniEnum<{
+            canvas: "canvas";
+            columns: "columns";
+            flow: "flow";
+        }>;
+        gap: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+    }, z.core.$strip>>;
+    elements: z.ZodMiniArray<z.ZodMiniObject<{
+        id: z.ZodMiniString<string>;
+        region: z.ZodMiniString<string>;
+        x: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+        y: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+        width: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+        height: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ArtifactLayout = z.infer<typeof artifactLayoutSchema>;
+export type LayoutElement = ArtifactLayout["elements"][number];
+/** Identity and membership are checked before the layout reaches the DOM or storage. */
+export declare const validateLayout: (input: unknown) => ArtifactLayout;
+/** Safe inside an application/json script, including titles supplied by an agent. */
+export declare const serializeLayout: (layout: ArtifactLayout) => string;
+//# sourceMappingURL=layout.d.ts.map

package/dist/protocol/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/protocol/layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAE7B,eAAO,MAAM,gBAAgB,8BAA8B,CAAA;AAC3D,eAAO,MAAM,gBAAgB,8BAA8B,CAAA;AAC3D,eAAO,MAAM,iBAAiB,+BAA+B,CAAA;AAC7D,eAAO,MAAM,gBAAgB,8BAA8B,CAAA;AAM3D,mFAAmF;AACnF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;iBAuB/B,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AACjE,MAAM,MAAM,aAAa,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;AAE9D,wFAAwF;AACxF,eAAO,MAAM,cAAc,UAAW,OAAO,KAAG,cAW/C,CAAA;AAED,qFAAqF;AACrF,eAAO,MAAM,eAAe,WAAY,cAAc,WACW,CAAA"}

package/dist/protocol/layout.js

@@ -0,0 +1,45 @@
+import * as z from "zod/mini";
+export const LAYOUT_ATTRIBUTE = "data-open-artifact-layout";
+export const REGION_ATTRIBUTE = "data-open-artifact-region";
+export const ELEMENT_ATTRIBUTE = "data-open-artifact-element";
+export const HANDLE_ATTRIBUTE = "data-open-artifact-handle";
+// IDs are opaque source identities, including existing host widget IDs.
+const id = z.string().check(z.minLength(1));
+const fraction = z.number().check(z.minimum(0), z.maximum(1));
+/** A page declares the parts a person may arrange. Widget content stays opaque. */
+export const artifactLayoutSchema = z.object({
+    version: z.literal(1),
+    regions: z
+        .array(z.object({
+        id,
+        mode: z.enum(["flow", "columns", "canvas"]),
+        gap: z.optional(z.number().check(z.minimum(0), z.maximum(64))),
+    }))
+        .check(z.minLength(1), z.maxLength(100)),
+    elements: z
+        .array(z.object({
+        id,
+        region: id,
+        x: z.optional(fraction),
+        y: z.optional(z.number().check(z.minimum(0), z.maximum(100000))),
+        width: z.optional(z.number().check(z.minimum(0.05), z.maximum(1))),
+        height: z.optional(z.number().check(z.minimum(48), z.maximum(10000))),
+    }))
+        .check(z.maxLength(1000)),
+});
+/** Identity and membership are checked before the layout reaches the DOM or storage. */
+export const validateLayout = (input) => {
+    const layout = artifactLayoutSchema.parse(input);
+    const regions = new Set(layout.regions.map((region) => region.id));
+    const elements = new Set(layout.elements.map((element) => element.id));
+    if (regions.size !== layout.regions.length || elements.size !== layout.elements.length)
+        throw new Error("Layout identifiers must be unique.");
+    if (layout.elements.some((element) => !regions.has(element.region)))
+        throw new Error("Every element must belong to a declared region.");
+    if (layout.elements.some((element) => (element.x ?? 0) + (element.width ?? 1) > 1.000001))
+        throw new Error("An element must fit inside its region.");
+    return layout;
+};
+/** Safe inside an application/json script, including titles supplied by an agent. */
+export const serializeLayout = (layout) => JSON.stringify(validateLayout(layout)).replace(/</g, "\\u003c");
+//# sourceMappingURL=layout.js.map

package/dist/protocol/layout.js.map

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

package/dist/protocol/mentions.d.ts

@@ -0,0 +1,16 @@
+import type { Actor } from "./extension.js";
+export type BodyPart = {
+    text: string;
+} | {
+    mention: Pick<Actor, "id" | "name">;
+};
+/** The token to insert for a person. */
+export declare const mentionToken: ({ id, name }: Pick<Actor, "id" | "name">) => string;
+/** Split a body into text and mentions, for rendering. */
+export declare const bodyParts: (body: string) => BodyPart[];
+/** Everyone a body mentions, once each. */
+export declare const mentionsIn: (body: string) => Pick<Actor, "id" | "name">[];
+/** Turn the readable "@Ada Park" a person typed (after picking Ada) into tokens. Longest
+ *  names first, so "@Ada Parker" never becomes "@Ada Park" plus "er". */
+export declare const tokenizeMentions: (text: string, people: readonly Pick<Actor, "id" | "name">[]) => string;
+//# sourceMappingURL=mentions.d.ts.map

package/dist/protocol/mentions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentions.d.ts","sourceRoot":"","sources":["../../src/protocol/mentions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAM3C,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,CAAC,CAAA;CAAE,CAAA;AAEjF,wCAAwC;AACxC,eAAO,MAAM,YAAY,iBAAkB,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,CAAC,KAAG,MAC3B,CAAA;AAE7C,0DAA0D;AAC1D,eAAO,MAAM,SAAS,SAAU,MAAM,KAAG,QAAQ,EAWhD,CAAA;AAED,2CAA2C;AAC3C,eAAO,MAAM,UAAU,SAAU,MAAM,KAAG,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,CAAC,EAKnE,CAAA;AAID;yEACyE;AACzE,eAAO,MAAM,gBAAgB,SAAU,MAAM,UAAU,SAAS,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,CAAC,EAAE,WAUvF,CAAA"}

package/dist/protocol/mentions.js

@@ -0,0 +1,35 @@
+/** A mention inside a comment body: `@[Ada Park](u_42)`. Plain text, so a comment reads fine
+ *  anywhere, and the id survives renames. */
+const MENTION = /@\[([^\]\n]{1,200})\]\(([^)\s]{1,200})\)/g;
+/** The token to insert for a person. */
+export const mentionToken = ({ id, name }) => `@[${name.replace(/[[\]\n]/g, "")}](${id})`;
+/** Split a body into text and mentions, for rendering. */
+export const bodyParts = (body) => {
+    const parts = [];
+    let at = 0;
+    for (const match of body.matchAll(MENTION)) {
+        const [whole, name = "", id = ""] = match;
+        if (match.index > at)
+            parts.push({ text: body.slice(at, match.index) });
+        parts.push({ mention: { id, name } });
+        at = match.index + whole.length;
+    }
+    if (at < body.length)
+        parts.push({ text: body.slice(at) });
+    return parts;
+};
+/** Everyone a body mentions, once each. */
+export const mentionsIn = (body) => {
+    const seen = new Map();
+    for (const part of bodyParts(body))
+        if ("mention" in part && !seen.has(part.mention.id))
+            seen.set(part.mention.id, part.mention);
+    return [...seen.values()];
+};
+const escapeRegExp = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+/** Turn the readable "@Ada Park" a person typed (after picking Ada) into tokens. Longest
+ *  names first, so "@Ada Parker" never becomes "@Ada Park" plus "er". */
+export const tokenizeMentions = (text, people) => [...people]
+    .toSorted((a, b) => b.name.length - a.name.length)
+    .reduce((current, person) => current.replace(new RegExp(`(^|[^\\]\\w])@${escapeRegExp(person.name)}(?![\\w])`, "g"), (_, before) => `${before}${mentionToken(person)}`), text);
+//# sourceMappingURL=mentions.js.map

package/dist/protocol/mentions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentions.js","sourceRoot":"","sources":["../../src/protocol/mentions.ts"],"names":[],"mappings":"AAEA;6CAC6C;AAC7C,MAAM,OAAO,GAAG,2CAA2C,CAAA;AAI3D,wCAAwC;AACxC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,EAAE,EAAE,EAAE,IAAI,EAA8B,EAAU,EAAE,CAC/E,KAAK,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,CAAA;AAE7C,0DAA0D;AAC1D,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAc,EAAE;IACpD,MAAM,KAAK,GAAe,EAAE,CAAA;IAC5B,IAAI,EAAE,GAAG,CAAC,CAAA;IACV,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,MAAM,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,GAAG,KAAK,CAAA;QACzC,IAAI,KAAK,CAAC,KAAK,GAAG,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACvE,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAA;QACrC,EAAE,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAA;IACjC,CAAC;IACD,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IAC1D,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,2CAA2C;AAC3C,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAgC,EAAE;IACvE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAsC,CAAA;IAC1D,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,IAAI,CAAC;QAChC,IAAI,SAAS,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;IAC9F,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;AAC3B,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA;AAElF;yEACyE;AACzE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,MAA6C,EAAE,EAAE,CAC9F,CAAC,GAAG,MAAM,CAAC;KACR,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;KACjD,MAAM,CACL,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAClB,OAAO,CAAC,OAAO,CACb,IAAI,MAAM,CAAC,iBAAiB,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,EACtE,CAAC,CAAC,EAAE,MAAc,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,EAAE,CAC1D,EACH,IAAI,CACL,CAAA"}

package/dist/protocol/methods.d.ts

@@ -0,0 +1,146 @@
+import * as z from "zod/mini";
+/** Every message the extension adds to MCP Apps: only what MCP itself cannot carry (screen
+ *  coordination and live push). Data travels as MCP tools; see `appTools`. Nothing here
+ *  shadows a `ui/*` method. */
+export declare const methods: {
+    readonly stateChanged: import("./define.js").NotificationSpec<z.ZodMiniObject<{
+        key: z.ZodMiniString<unknown>;
+        snapshot: z.ZodMiniObject<{
+            items: z.ZodMiniNullable<z.ZodMiniArray<typeof import("./state.js").stateItemSchema>>;
+            version: z.ZodMiniInt;
+            mine: typeof import("./slot-map.js").slotMapSchema;
+            itemId: z.ZodMiniOptional<z.ZodMiniString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    readonly anchors: import("./define.js").NotificationSpec<z.ZodMiniObject<{
+        anchors: z.ZodMiniArray<z.ZodMiniObject<{
+            id: z.ZodMiniString<string>;
+            quote: z.ZodMiniObject<{
+                exact: z.ZodMiniString<string>;
+                prefix: z.ZodMiniString<string>;
+                suffix: z.ZodMiniString<string>;
+                element: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                sourceSelector: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            }, z.core.$strip>;
+            quiet: z.ZodMiniBoolean<boolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    readonly focusAnchor: import("./define.js").NotificationSpec<z.ZodMiniObject<{
+        id: z.ZodMiniString<string>;
+    }, z.core.$strip>>;
+    /** Turn text editing on, or off; off answers with `edits` (none when `discard`). */
+    readonly editing: import("./define.js").NotificationSpec<z.ZodMiniObject<{
+        on: z.ZodMiniBoolean<boolean>;
+        discard: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+        layout: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+        text: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+        labels: z.ZodMiniOptional<z.ZodMiniObject<{
+            move: z.ZodMiniString<string>;
+            resize: z.ZodMiniString<string>;
+            instructions: z.ZodMiniString<string>;
+            changed: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    /** Present a slides artifact one slide at a time, from `slide` (0-based), or stop. */
+    readonly present: import("./define.js").NotificationSpec<z.ZodMiniObject<{
+        on: z.ZodMiniBoolean<boolean>;
+        slide: z.ZodMiniOptional<z.ZodMiniInt>;
+    }, z.core.$strip>>;
+    /** Ask the view for the page as it looks now, for printing live data; it answers with `page`. */
+    readonly snapshot: import("./define.js").NotificationSpec<z.ZodMiniObject<{}, z.core.$strip>>;
+    /** The record currently open in the host. This is local selection, not shared state. */
+    readonly selectedLink: import("./define.js").NotificationSpec<z.ZodMiniObject<{
+        url: z.ZodMiniNullable<z.ZodMiniString<string>>;
+    }, z.core.$strip>>;
+    readonly selection: import("./define.js").NotificationSpec<z.ZodMiniObject<{
+        quote: z.ZodMiniNullable<z.ZodMiniObject<{
+            exact: z.ZodMiniString<string>;
+            prefix: z.ZodMiniString<string>;
+            suffix: z.ZodMiniString<string>;
+            element: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            sourceSelector: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        }, z.core.$strip>>;
+        rect: z.ZodMiniNullable<z.ZodMiniObject<{
+            top: z.ZodMiniNumber<number>;
+            left: z.ZodMiniNumber<number>;
+            width: z.ZodMiniNumber<number>;
+            height: z.ZodMiniNumber<number>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    readonly anchorPositions: import("./define.js").NotificationSpec<z.ZodMiniObject<{
+        positions: z.ZodMiniArray<z.ZodMiniObject<{
+            id: z.ZodMiniString<string>;
+            rect: z.ZodMiniObject<{
+                top: z.ZodMiniNumber<number>;
+                left: z.ZodMiniNumber<number>;
+                width: z.ZodMiniNumber<number>;
+                height: z.ZodMiniNumber<number>;
+            }, z.core.$strip>;
+            slide: z.ZodMiniOptional<z.ZodMiniInt>;
+        }, z.core.$strip>>;
+        missing: z.ZodMiniArray<z.ZodMiniString<string>>;
+    }, z.core.$strip>>;
+    readonly anchorActivated: import("./define.js").NotificationSpec<z.ZodMiniObject<{
+        id: z.ZodMiniString<string>;
+    }, z.core.$strip>>;
+    readonly edits: import("./define.js").NotificationSpec<z.ZodMiniObject<{
+        edits: z.ZodMiniArray<z.ZodMiniObject<{
+            quote: z.ZodMiniObject<{
+                exact: z.ZodMiniString<string>;
+                prefix: z.ZodMiniString<string>;
+                suffix: z.ZodMiniString<string>;
+                element: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                sourceSelector: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            }, z.core.$strip>;
+            text: z.ZodMiniString<string>;
+        }, z.core.$strip>>;
+        layout: z.ZodMiniOptional<z.ZodMiniObject<{
+            version: z.ZodMiniLiteral<1>;
+            regions: z.ZodMiniArray<z.ZodMiniObject<{
+                id: z.ZodMiniString<string>;
+                mode: z.ZodMiniEnum<{
+                    canvas: "canvas";
+                    columns: "columns";
+                    flow: "flow";
+                }>;
+                gap: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+            }, z.core.$strip>>;
+            elements: z.ZodMiniArray<z.ZodMiniObject<{
+                id: z.ZodMiniString<string>;
+                region: z.ZodMiniString<string>;
+                x: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+                y: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+                width: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+                height: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    /** Whether this version declares a valid layout, separate from host support. */
+    readonly layoutReady: import("./define.js").NotificationSpec<z.ZodMiniObject<{
+        available: z.ZodMiniBoolean<boolean>;
+    }, z.core.$strip>>;
+    /** The slide in view while presenting, and how many there are. */
+    readonly slide: import("./define.js").NotificationSpec<z.ZodMiniObject<{
+        index: z.ZodMiniInt;
+        count: z.ZodMiniInt;
+        titles: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+        scrollTo: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+    }, z.core.$strip>>;
+    /** The page as rendered now, without scripts, answering `snapshot`. */
+    readonly page: import("./define.js").NotificationSpec<z.ZodMiniObject<{
+        html: z.ZodMiniString<string>;
+    }, z.core.$strip>>;
+    /** The viewer asked to stop presenting from inside the page (Esc). */
+    readonly exitPresent: import("./define.js").NotificationSpec<z.ZodMiniObject<{}, z.core.$strip>>;
+    /** Escape in the artifact lets the host close its expanded reader. */
+    readonly escape: import("./define.js").NotificationSpec<z.ZodMiniObject<{}, z.core.$strip>>;
+    readonly cursor: import("./define.js").NotificationSpec<z.ZodMiniObject<{
+        cursor: z.ZodMiniNullable<z.ZodMiniObject<{
+            x: z.ZodMiniNumber<number>;
+            y: z.ZodMiniNumber<number>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+};
+export type Methods = typeof methods;
+export type Params<K extends keyof Methods> = z.infer<Methods[K]["params"]>;
+//# sourceMappingURL=methods.d.ts.map

package/dist/protocol/methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.d.ts","sourceRoot":"","sources":["../../src/protocol/methods.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAc7B;;+BAE+B;AAC/B,eAAO,MAAM,OAAO;aAElB,YAAY;;;;;;;;;aAIZ,OAAO;;;;;;;;;;;;;aAIP,WAAW;;;IAIX,oFAAoF;aACpF,OAAO;;;;;;;;;;;;IAkBP,sFAAsF;aACtF,OAAO;;;;IAEP,iGAAiG;aACjG,QAAQ;IAER,wFAAwF;aACxF,YAAY;;;aAMZ,SAAS;;;;;;;;;;;;;;;aAIT,eAAe;;;;;;;;;;;;;aAIf,eAAe;;;aAIf,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIL,gFAAgF;aAChF,WAAW;;;IAIX,kEAAkE;aAClE,KAAK;;;;;;IAUL,uEAAuE;aACvE,IAAI;;;IAIJ,sEAAsE;aACtE,WAAW;IACX,sEAAsE;aACtE,MAAM;aACN,MAAM;;;;;;CAIE,CAAA;AAEV,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAA;AACpC,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,MAAM,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA"}

package/dist/protocol/methods.js

@@ -0,0 +1,57 @@
+import * as z from "zod/mini";
+import { anchorPositionSchema, anchorSchema, pointSchema, quoteSchema, rectSchema, textEditSchema, } from "./anchors.js";
+import { defineNotification } from "./define.js";
+import { artifactLayoutSchema } from "./layout.js";
+import { escapeNotification, exitPresentNotification, presentNotification } from "./presentation.js";
+import { snapshotSchema, stateKeySchema } from "./state.js";
+/** Every message the extension adds to MCP Apps: only what MCP itself cannot carry (screen
+ *  coordination and live push). Data travels as MCP tools; see `appTools`. Nothing here
+ *  shadows a `ui/*` method. */
+export const methods = {
+    // Host → view notifications.
+    stateChanged: defineNotification("artifact/notifications/state-changed", z.object({ key: stateKeySchema, snapshot: snapshotSchema })),
+    anchors: defineNotification("artifact/notifications/anchors", z.object({ anchors: z.array(anchorSchema) })),
+    focusAnchor: defineNotification("artifact/notifications/focus-anchor", z.object({ id: z.string() })),
+    /** Turn text editing on, or off; off answers with `edits` (none when `discard`). */
+    editing: defineNotification("artifact/notifications/editing", z.object({
+        on: z.boolean(),
+        discard: z.optional(z.boolean()),
+        layout: z.optional(z.boolean()),
+        text: z.optional(z.boolean()),
+        labels: z.optional(z.object({
+            move: z.string(),
+            resize: z.string(),
+            instructions: z.string(),
+            changed: z.optional(z.string()),
+        })),
+    })),
+    /** Present a slides artifact one slide at a time, from `slide` (0-based), or stop. */
+    present: presentNotification,
+    /** Ask the view for the page as it looks now, for printing live data; it answers with `page`. */
+    snapshot: defineNotification("artifact/notifications/snapshot", z.object({})),
+    /** The record currently open in the host. This is local selection, not shared state. */
+    selectedLink: defineNotification("artifact/notifications/selected-link", z.object({ url: z.nullable(z.string().check(z.maxLength(8192))) })),
+    // View → host notifications.
+    selection: defineNotification("artifact/notifications/selection", z.object({ quote: z.nullable(quoteSchema), rect: z.nullable(rectSchema) })),
+    anchorPositions: defineNotification("artifact/notifications/anchor-positions", z.object({ positions: z.array(anchorPositionSchema), missing: z.array(z.string()) })),
+    anchorActivated: defineNotification("artifact/notifications/anchor-activated", z.object({ id: z.string() })),
+    edits: defineNotification("artifact/notifications/edits", z.object({ edits: z.array(textEditSchema), layout: z.optional(artifactLayoutSchema) })),
+    /** Whether this version declares a valid layout, separate from host support. */
+    layoutReady: defineNotification("artifact/notifications/layout-ready", z.object({ available: z.boolean() })),
+    /** The slide in view while presenting, and how many there are. */
+    slide: defineNotification("artifact/notifications/slide", z.object({
+        index: z.int().check(z.nonnegative()),
+        count: z.int().check(z.nonnegative()),
+        titles: z.optional(z.array(z.string().check(z.maxLength(160)))),
+        /** Host scroll offset for a selected slide in the expanded reading page. */
+        scrollTo: z.optional(z.number().check(z.nonnegative())),
+    })),
+    /** The page as rendered now, without scripts, answering `snapshot`. */
+    page: defineNotification("artifact/notifications/page", z.object({ html: z.string().check(z.maxLength(16_000_000)) })),
+    /** The viewer asked to stop presenting from inside the page (Esc). */
+    exitPresent: exitPresentNotification,
+    /** Escape in the artifact lets the host close its expanded reader. */
+    escape: escapeNotification,
+    cursor: defineNotification("artifact/notifications/cursor", z.object({ cursor: z.nullable(pointSchema) })),
+};
+//# sourceMappingURL=methods.js.map

package/dist/protocol/methods.js.map

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