@derive-to/artifacts 0.0.0-stage → 0.6.0

package/dist/protocol/collection.js

@@ -0,0 +1,168 @@
+import { STATE_LIMITS } from "./state-limits.js";
+export { isStateKey, STATE_KEY_PATTERN, STATE_LIMITS } from "./state-limits.js";
+export const DEFAULT_COLLECTION_DIALECT = {
+    actorField: "__actor",
+    slotField: "__slot",
+    incrementKey: "__increment",
+    strictIds: false,
+};
+const MAX_INCREMENT = 1_000_000;
+const error = (code, message) => ({
+    code,
+    error: message,
+});
+const validId = (id) => typeof id === "string" && id.length > 0 && id.length <= 128;
+const objectOf = (value) => value !== null && typeof value === "object" && !Array.isArray(value)
+    ? value
+    : null;
+const incrementOf = (value, key) => {
+    const marker = objectOf(value);
+    if (!marker || Object.keys(marker).length !== 1)
+        return null;
+    const by = marker[key];
+    return typeof by === "number" && Number.isFinite(by) && Math.abs(by) <= MAX_INCREMENT ? by : null;
+};
+const fieldsOf = (mutation) => mutation.op === "add"
+    ? mutation.value
+    : mutation.op === "update"
+        ? mutation.patch
+        : (mutation.value ?? {});
+const reservedField = (fields, reserved, stored) => Object.keys(fields).find((key) => reserved.has(key) &&
+    (stored ? key === "__proto__" || key === "constructor" || key === "prototype" : key !== "id"));
+const invalidOwnership = (row, dialect) => {
+    const actor = row[dialect.actorField];
+    const slot = row[dialect.slotField];
+    return ((actor === undefined) !== (slot === undefined) ||
+        (actor !== undefined && typeof actor !== "string") ||
+        (slot !== undefined && !validId(slot)));
+};
+const idFor = (row, context) => {
+    const given = row["id"];
+    const supplied = Object.hasOwn(row, "id");
+    if (context.dialect.strictIds && supplied && (!validId(given) || context.seen.has(given)))
+        return error("invalid", "Shared-state item ids must be unique 1-128 character strings.");
+    const id = validId(given) && !context.seen.has(given) ? given : context.options.mintId?.();
+    if (!validId(id) || context.seen.has(id))
+        return error("invalid", "Every shared-state item needs a unique id.");
+    context.seen.add(id);
+    return id;
+};
+const readRow = (item, context) => {
+    const row = objectOf(item);
+    if (!row)
+        return error("invalid", "Every shared-state item must be an object.");
+    const key = reservedField(row, context.reserved, context.options.stored ?? false);
+    if (key)
+        return error("reserved", `The field "${key}" is reserved.`);
+    if (context.options.stored && invalidOwnership(row, context.dialect))
+        return error("invalid", "Stored actor-scoped state is invalid.");
+    const id = idFor(row, context);
+    return typeof id === "string" ? { ...row, id } : id;
+};
+const readRows = (value, options, dialect, reserved) => {
+    if (!Array.isArray(value))
+        return error("invalid", "Shared state must be an array.");
+    if (value.length > STATE_LIMITS.items)
+        return error("items", "This collection is full.");
+    const context = { options, dialect, reserved, seen: new Set() };
+    const items = [];
+    for (const valueRow of value) {
+        const row = readRow(valueRow, context);
+        if (!Object.hasOwn(row, "id"))
+            return row;
+        items.push(row);
+    }
+    return items;
+};
+const add = (items, row) => items.length >= STATE_LIMITS.items
+    ? error("items", "This collection is full.")
+    : { items: [...items, row], itemId: row.id, changed: true };
+const setMine = (items, mutation, identity, dialect) => {
+    const at = items.findIndex((item) => item[dialect.actorField] === identity.actorId && item[dialect.slotField] === mutation.slot);
+    const existing = items[at];
+    if (mutation.value === null) {
+        if (!existing)
+            return { items, itemId: identity.newItemId, changed: false };
+        return { items: items.filter((_, index) => index !== at), itemId: existing.id, changed: true };
+    }
+    const row = {
+        ...mutation.value,
+        id: existing?.id ?? identity.newItemId,
+        [dialect.actorField]: identity.actorId,
+        [dialect.slotField]: mutation.slot,
+    };
+    return existing ? { items: items.with(at, row), itemId: row.id, changed: true } : add(items, row);
+};
+const update = (items, mutation, dialect) => {
+    const at = items.findIndex((item) => item.id === mutation.id);
+    const current = items[at];
+    if (!current)
+        return error("missing", "That item no longer exists.");
+    if (current[dialect.actorField] !== undefined)
+        return error("owned", "Change your own items with setMine.");
+    const next = { ...current };
+    for (const [key, value] of Object.entries(mutation.patch)) {
+        const by = incrementOf(value, dialect.incrementKey);
+        const base = typeof current[key] === "number" ? current[key] : 0;
+        next[key] = by === null ? value : base + by;
+    }
+    return { items: items.with(at, next), itemId: mutation.id, changed: true };
+};
+const mutate = (items, mutation, identity, dialect) => {
+    switch (mutation.op) {
+        case "add":
+            return add(items, { ...mutation.value, id: identity.newItemId });
+        case "setMine":
+            return setMine(items, mutation, identity, dialect);
+        case "update":
+            return update(items, mutation, dialect);
+    }
+    return error("invalid", "Unknown collection mutation.");
+};
+const snapshot = (items, version, actorId, dialect) => {
+    const own = [];
+    const visible = items?.map((row) => {
+        const { [dialect.actorField]: actor, [dialect.slotField]: slot, ...item } = row;
+        if (actorId && actor === actorId && typeof slot === "string")
+            own.push([slot, row.id]);
+        return { ...item, id: row.id };
+    });
+    // fromEntries keeps __proto__ and constructor slots as ordinary own properties.
+    return { items: visible ?? null, version, mine: Object.fromEntries(own) };
+};
+/** Shared collection behavior, with host-owned persisted field names. No stored ids or ownership fields need rewriting. */
+export const createCollectionRules = (profile) => {
+    const dialect = { ...profile };
+    const ownership = [dialect.actorField, dialect.slotField];
+    const forbidden = new Set(["id", "__proto__", "constructor", "prototype"]);
+    if (ownership[0] === ownership[1] ||
+        ownership.some((field) => !validId(field) || forbidden.has(field)))
+        throw new Error("Collection ownership fields must be distinct private field names.");
+    const reserved = new Set([
+        "id",
+        dialect.actorField,
+        dialect.slotField,
+        "__proto__",
+        "constructor",
+        "prototype",
+    ]);
+    return {
+        read: (value, options) => readRows(value, options, dialect, reserved),
+        apply: (items, mutation, actorId, newItemId) => {
+            const key = Object.keys(fieldsOf(mutation)).find((field) => reserved.has(field));
+            if (key)
+                return error("reserved", `The field "${key}" is reserved.`);
+            const outcome = mutate(items, mutation, { actorId, newItemId }, dialect);
+            if ("error" in outcome)
+                return outcome;
+            if (new TextEncoder().encode(JSON.stringify(outcome.items)).byteLength > STATE_LIMITS.bytes)
+                return error("bytes", "This collection is too large.");
+            return outcome;
+        },
+        withinInteract: (mutation) => mutation.op !== "update" ||
+            (Object.keys(mutation.patch).length > 0 &&
+                Object.values(mutation.patch).every((value) => Math.abs(incrementOf(value, dialect.incrementKey) ?? 0) === 1)),
+        snapshot: (items, version, actorId) => snapshot(items, version, actorId, dialect),
+    };
+};
+//# sourceMappingURL=collection.js.map

package/dist/protocol/collection.js.map

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

package/dist/protocol/define.d.ts

@@ -0,0 +1,9 @@
+import type * as z from "zod/mini";
+/** A JSON-RPC notification in the artifact extension. */
+export interface NotificationSpec<P extends z.ZodMiniType> {
+    readonly kind: "notification";
+    readonly method: `artifact/notifications/${string}`;
+    readonly params: P;
+}
+export declare const defineNotification: <P extends z.ZodMiniType>(method: `artifact/notifications/${string}`, params: P) => NotificationSpec<P>;
+//# sourceMappingURL=define.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/protocol/define.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,CAAC,MAAM,UAAU,CAAA;AAElC,yDAAyD;AACzD,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW;IACvD,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,0BAA0B,MAAM,EAAE,CAAA;IACnD,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;CACnB;AAED,eAAO,MAAM,kBAAkB,GAAI,CAAC,SAAS,CAAC,CAAC,WAAW,UAChD,0BAA0B,MAAM,EAAE,UAClC,CAAC,KACR,gBAAgB,CAAC,CAAC,CAA+C,CAAA"}

package/dist/protocol/define.js

@@ -0,0 +1,2 @@
+export const defineNotification = (method, params) => ({ kind: "notification", method, params });
+//# sourceMappingURL=define.js.map

package/dist/protocol/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/protocol/define.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,MAA0C,EAC1C,MAAS,EACY,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA"}

package/dist/protocol/errors.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Every refusal the kit can return, with its HTTP status and its cause. A response body is
+ * `{ error, code }`: `error` is a sentence for a person, `code` is one of these keys for code.
+ * `docs/errors.md` is generated from this table (`pnpm lint:errors` checks it is current).
+ */
+export declare const ERRORS: {
+    readonly INVALID_INPUT: {
+        readonly status: 400;
+        readonly cause: "The request did not match its schema, or named a value the kit cannot use.";
+    };
+    readonly SIGN_IN_REQUIRED: {
+        readonly status: 401;
+        readonly cause: "Everything beyond viewing needs a signed-in actor; this request had none.";
+    };
+    readonly FORBIDDEN: {
+        readonly status: 403;
+        readonly cause: "The host's answer for this principal does not reach the verb the action needs.";
+    };
+    readonly NOT_FOUND: {
+        readonly status: 404;
+        readonly cause: "The artifact, version, thread or tool does not exist, or the caller may not view it. The two are the same answer so that existence never leaks.";
+    };
+    readonly VERSION_MOVED: {
+        readonly status: 409;
+        readonly cause: "Someone published after the version the caller read. Read again and retry.";
+    };
+    readonly STATE_RACE: {
+        readonly status: 409;
+        readonly cause: "Shared state changed between the read and the write too many times in a row.";
+    };
+    readonly TOO_LARGE: {
+        readonly status: 413;
+        readonly cause: "The body or an uploaded asset is larger than the kit's limit.";
+    };
+    readonly REFUSED: {
+        readonly status: 422;
+        readonly cause: "A plugin's `before` hook refused the action (moderation, a page check, a policy).";
+    };
+    readonly RATE_LIMITED: {
+        readonly status: 429;
+        readonly cause: "The actor made too many requests of this kind in the rate limiter's window.";
+    };
+    readonly ROLE_TOO_HIGH: {
+        readonly status: 403;
+        readonly cause: "A share may grant at most the role the sharer holds, and only an owner grants owner.";
+    };
+    readonly STORED_DATA_INVALID: {
+        readonly status: 500;
+        readonly cause: "A stored row did not parse. The store holds data this version of the kit cannot read.";
+    };
+};
+export type ErrorCode = keyof typeof ERRORS;
+export declare const ERROR_CODES: ErrorCode[];
+export declare const isErrorCode: (value: unknown) => value is ErrorCode;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/protocol/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,MAAM;;iBAEf,MAAM,EAAE,GAAG;iBACX,KAAK,EAAE,4EAA4E;;;iBAGnF,MAAM,EAAE,GAAG;iBACX,KAAK,EAAE,2EAA2E;;;iBAGlF,MAAM,EAAE,GAAG;iBACX,KAAK,EAAE,gFAAgF;;;iBAGvF,MAAM,EAAE,GAAG;iBACX,KAAK,EACH,iJAAiJ;;;iBAGnJ,MAAM,EAAE,GAAG;iBACX,KAAK,EAAE,4EAA4E;;;iBAGnF,MAAM,EAAE,GAAG;iBACX,KAAK,EAAE,8EAA8E;;;iBAGrF,MAAM,EAAE,GAAG;iBACX,KAAK,EAAE,+DAA+D;;;iBAGtE,MAAM,EAAE,GAAG;iBACX,KAAK,EAAE,mFAAmF;;;iBAG1F,MAAM,EAAE,GAAG;iBACX,KAAK,EAAE,6EAA6E;;;iBAGpF,MAAM,EAAE,GAAG;iBACX,KAAK,EAAE,sFAAsF;;;iBAG7F,MAAM,EAAE,GAAG;iBACX,KAAK,EAAE,uFAAuF;;CAE5B,CAAA;AAEtE,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,MAAM,CAAA;AAE3C,eAAO,MAAM,WAAW,EAA0B,SAAS,EAAE,CAAA;AAE7D,eAAO,MAAM,WAAW,UAAW,OAAO,KAAG,KAAK,IAAI,SACK,CAAA"}

package/dist/protocol/errors.js

@@ -0,0 +1,54 @@
+/**
+ * Every refusal the kit can return, with its HTTP status and its cause. A response body is
+ * `{ error, code }`: `error` is a sentence for a person, `code` is one of these keys for code.
+ * `docs/errors.md` is generated from this table (`pnpm lint:errors` checks it is current).
+ */
+export const ERRORS = {
+    INVALID_INPUT: {
+        status: 400,
+        cause: "The request did not match its schema, or named a value the kit cannot use.",
+    },
+    SIGN_IN_REQUIRED: {
+        status: 401,
+        cause: "Everything beyond viewing needs a signed-in actor; this request had none.",
+    },
+    FORBIDDEN: {
+        status: 403,
+        cause: "The host's answer for this principal does not reach the verb the action needs.",
+    },
+    NOT_FOUND: {
+        status: 404,
+        cause: "The artifact, version, thread or tool does not exist, or the caller may not view it. The two are the same answer so that existence never leaks.",
+    },
+    VERSION_MOVED: {
+        status: 409,
+        cause: "Someone published after the version the caller read. Read again and retry.",
+    },
+    STATE_RACE: {
+        status: 409,
+        cause: "Shared state changed between the read and the write too many times in a row.",
+    },
+    TOO_LARGE: {
+        status: 413,
+        cause: "The body or an uploaded asset is larger than the kit's limit.",
+    },
+    REFUSED: {
+        status: 422,
+        cause: "A plugin's `before` hook refused the action (moderation, a page check, a policy).",
+    },
+    RATE_LIMITED: {
+        status: 429,
+        cause: "The actor made too many requests of this kind in the rate limiter's window.",
+    },
+    ROLE_TOO_HIGH: {
+        status: 403,
+        cause: "A share may grant at most the role the sharer holds, and only an owner grants owner.",
+    },
+    STORED_DATA_INVALID: {
+        status: 500,
+        cause: "A stored row did not parse. The store holds data this version of the kit cannot read.",
+    },
+};
+export const ERROR_CODES = Object.keys(ERRORS);
+export const isErrorCode = (value) => typeof value === "string" && Object.hasOwn(ERRORS, value);
+//# sourceMappingURL=errors.js.map

package/dist/protocol/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/protocol/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,aAAa,EAAE;QACb,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,4EAA4E;KACpF;IACD,gBAAgB,EAAE;QAChB,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,2EAA2E;KACnF;IACD,SAAS,EAAE;QACT,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,gFAAgF;KACxF;IACD,SAAS,EAAE;QACT,MAAM,EAAE,GAAG;QACX,KAAK,EACH,iJAAiJ;KACpJ;IACD,aAAa,EAAE;QACb,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,4EAA4E;KACpF;IACD,UAAU,EAAE;QACV,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,8EAA8E;KACtF;IACD,SAAS,EAAE;QACT,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,+DAA+D;KACvE;IACD,OAAO,EAAE;QACP,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,mFAAmF;KAC3F;IACD,YAAY,EAAE;QACZ,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,6EAA6E;KACrF;IACD,aAAa,EAAE;QACb,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,sFAAsF;KAC9F;IACD,mBAAmB,EAAE;QACnB,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,uFAAuF;KAC/F;CACmE,CAAA;AAItE,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAgB,CAAA;AAE7D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAc,EAAsB,EAAE,CAChE,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA"}

package/dist/protocol/extension.d.ts

@@ -0,0 +1,44 @@
+import * as z from "zod/mini";
+/** The extension id, negotiated through MCP Apps `experimental` capabilities in
+ *  `ui/initialize`. Reverse-DNS like `io.modelcontextprotocol/ui`. */
+export declare const EXTENSION_ID = "to.derive/artifact";
+export declare const EXTENSION_VERSION = "0.2";
+/** What a host offers. The kit's own are "state", "anchors", and "presence"; plugins add
+ *  their own names, and each side ignores names it does not know. */
+export declare const featureSchema: z.ZodMiniString<string>;
+export type ArtifactFeature = "live" | "state" | "anchors" | "presence" | (string & {});
+export declare const actorSchema: z.ZodMiniObject<{
+    id: z.ZodMiniString<string>;
+    name: z.ZodMiniString<string>;
+    avatarUrl: z.ZodMiniOptional<z.ZodMiniURL>;
+}, z.core.$strip>;
+export type Actor = z.infer<typeof actorSchema>;
+/** What a host advertises in `hostCapabilities.experimental[EXTENSION_ID]`. */
+export declare const hostExtensionSchema: z.ZodMiniObject<{
+    version: z.ZodMiniString<string>;
+    features: z.ZodMiniArray<z.ZodMiniString<string>>;
+    actor: z.ZodMiniNullable<z.ZodMiniObject<{
+        id: z.ZodMiniString<string>;
+        name: z.ZodMiniString<string>;
+        avatarUrl: z.ZodMiniOptional<z.ZodMiniURL>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type HostExtension = z.infer<typeof hostExtensionSchema>;
+/** What an artifact advertises in `appCapabilities.experimental[EXTENSION_ID]`. */
+export declare const viewExtensionSchema: z.ZodMiniObject<{
+    version: z.ZodMiniString<string>;
+}, z.core.$strip>;
+export type ViewExtension = z.infer<typeof viewExtensionSchema>;
+type Experimental = {
+    experimental?: Record<string, object>;
+} | undefined;
+/** The host's extension block, or null when the host is a plain MCP Apps host. */
+export declare const readHostExtension: (capabilities: Experimental) => HostExtension | null;
+/** The view's extension block, or null when the view does not speak the extension. */
+export declare const readViewExtension: (capabilities: Experimental) => ViewExtension | null;
+/** The `experimental` entry to merge into a host's or view's MCP Apps capabilities. */
+export declare const extensionCapability: <T extends HostExtension | ViewExtension>(block: T) => {
+    "to.derive/artifact": T;
+};
+export {};
+//# sourceMappingURL=extension.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../src/protocol/extension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAE7B;sEACsE;AACtE,eAAO,MAAM,YAAY,uBAAuB,CAAA;AAChD,eAAO,MAAM,iBAAiB,QAAQ,CAAA;AAEtC;qEACqE;AACrE,eAAO,MAAM,aAAa,yBAAoD,CAAA;AAC9E,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAIvF,eAAO,MAAM,WAAW;;;;iBAItB,CAAA;AACF,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AAE/C,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB;;;;;;;;iBAI9B,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE/D,mFAAmF;AACnF,eAAO,MAAM,mBAAmB;;iBAAoC,CAAA;AACpE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE/D,KAAK,YAAY,GAAG;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,SAAS,CAAA;AAEzE,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,iBAAkB,YAAY,KAAG,aAAa,GAAG,IAG9E,CAAA;AAED,sFAAsF;AACtF,eAAO,MAAM,iBAAiB,iBAAkB,YAAY,KAAG,aAAa,GAAG,IAG9E,CAAA;AAED,uFAAuF;AACvF,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,aAAa,GAAG,aAAa,SAAS,CAAC;;CAEnF,CAAA"}

package/dist/protocol/extension.js

@@ -0,0 +1,37 @@
+import * as z from "zod/mini";
+/** The extension id, negotiated through MCP Apps `experimental` capabilities in
+ *  `ui/initialize`. Reverse-DNS like `io.modelcontextprotocol/ui`. */
+export const EXTENSION_ID = "to.derive/artifact";
+export const EXTENSION_VERSION = "0.2";
+/** What a host offers. The kit's own are "state", "anchors", and "presence"; plugins add
+ *  their own names, and each side ignores names it does not know. */
+export const featureSchema = z.string().check(z.minLength(1), z.maxLength(64));
+const name = z.string().check(z.minLength(1), z.maxLength(200));
+export const actorSchema = z.object({
+    id: name,
+    name,
+    avatarUrl: z.optional(z.url()),
+});
+/** What a host advertises in `hostCapabilities.experimental[EXTENSION_ID]`. */
+export const hostExtensionSchema = z.object({
+    version: z.string(),
+    features: z.array(featureSchema),
+    actor: z.nullable(actorSchema),
+});
+/** What an artifact advertises in `appCapabilities.experimental[EXTENSION_ID]`. */
+export const viewExtensionSchema = z.object({ version: z.string() });
+/** The host's extension block, or null when the host is a plain MCP Apps host. */
+export const readHostExtension = (capabilities) => {
+    const parsed = hostExtensionSchema.safeParse(capabilities?.experimental?.[EXTENSION_ID]);
+    return parsed.success ? parsed.data : null;
+};
+/** The view's extension block, or null when the view does not speak the extension. */
+export const readViewExtension = (capabilities) => {
+    const parsed = viewExtensionSchema.safeParse(capabilities?.experimental?.[EXTENSION_ID]);
+    return parsed.success ? parsed.data : null;
+};
+/** The `experimental` entry to merge into a host's or view's MCP Apps capabilities. */
+export const extensionCapability = (block) => ({
+    [EXTENSION_ID]: block,
+});
+//# sourceMappingURL=extension.js.map

package/dist/protocol/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../../src/protocol/extension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAE7B;sEACsE;AACtE,MAAM,CAAC,MAAM,YAAY,GAAG,oBAAoB,CAAA;AAChD,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,CAAA;AAEtC;qEACqE;AACrE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAA;AAG9E,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAA;AAE/D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,EAAE,EAAE,IAAI;IACR,IAAI;IACJ,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;CAC/B,CAAC,CAAA;AAGF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;CAC/B,CAAC,CAAA;AAGF,mFAAmF;AACnF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AAKpE,kFAAkF;AAClF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,YAA0B,EAAwB,EAAE;IACpF,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,YAAY,EAAE,YAAY,EAAE,CAAC,YAAY,CAAC,CAAC,CAAA;IACxF,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;AAC5C,CAAC,CAAA;AAED,sFAAsF;AACtF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,YAA0B,EAAwB,EAAE;IACpF,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,YAAY,EAAE,YAAY,EAAE,CAAC,YAAY,CAAC,CAAC,CAAA;IACxF,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;AAC5C,CAAC,CAAA;AAED,uFAAuF;AACvF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAA0C,KAAQ,EAAE,EAAE,CAAC,CAAC;IACzF,CAAC,YAAY,CAAC,EAAE,KAAK;CACtB,CAAC,CAAA"}

package/dist/protocol/http.d.ts

@@ -0,0 +1,195 @@
+import * as z from "zod/mini";
+export declare const cspSchema: 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>;
+export type Csp = z.infer<typeof cspSchema>;
+export declare const versionSchema: z.ZodMiniObject<{
+    n: z.ZodMiniInt;
+    createdAt: z.ZodMiniISODateTime;
+    createdBy: z.ZodMiniObject<{
+        id: z.ZodMiniString<string>;
+        name: z.ZodMiniString<string>;
+        avatarUrl: z.ZodMiniOptional<z.ZodMiniURL>;
+    }, z.core.$strip>;
+    csp: 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 type Version = z.infer<typeof versionSchema>;
+/** "page" scrolls; "slides" shows each top-level <section> as a 16:9 slide and can present. */
+export declare const ARTIFACT_KINDS: readonly ["page", "slides"];
+export declare const artifactKindSchema: z.ZodMiniEnum<{
+    page: "page";
+    slides: "slides";
+}>;
+export type ArtifactKind = z.infer<typeof artifactKindSchema>;
+export declare const artifactSchema: z.ZodMiniObject<{
+    id: z.ZodMiniString<string>;
+    title: z.ZodMiniString<string>;
+    currentVersion: z.ZodMiniInt;
+    createdAt: z.ZodMiniISODateTime;
+    updatedAt: z.ZodMiniISODateTime;
+    createdBy: z.ZodMiniObject<{
+        id: z.ZodMiniString<string>;
+        name: z.ZodMiniString<string>;
+        avatarUrl: z.ZodMiniOptional<z.ZodMiniURL>;
+    }, z.core.$strip>;
+    updatedBy: z.ZodMiniObject<{
+        id: z.ZodMiniString<string>;
+        name: z.ZodMiniString<string>;
+        avatarUrl: z.ZodMiniOptional<z.ZodMiniURL>;
+    }, z.core.$strip>;
+    summary: z.ZodMiniString<string>;
+    kind: z.ZodMiniEnum<{
+        page: "page";
+        slides: "slides";
+    }>;
+    activity: z.ZodMiniObject<{
+        openThreads: z.ZodMiniInt;
+        threads: z.ZodMiniInt;
+        people: z.ZodMiniArray<z.ZodMiniObject<{
+            id: z.ZodMiniString<string>;
+            name: z.ZodMiniString<string>;
+            avatarUrl: z.ZodMiniOptional<z.ZodMiniURL>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    can: z.ZodMiniArray<z.ZodMiniEnum<{
+        comment: "comment";
+        edit: "edit";
+        interact: "interact";
+        manage: "manage";
+        view: "view";
+    }>>;
+    features: z.ZodMiniArray<z.ZodMiniString<string>>;
+}, z.core.$strip>;
+export type Artifact = z.infer<typeof artifactSchema>;
+export declare const commentSchema: z.ZodMiniObject<{
+    id: z.ZodMiniString<string>;
+    threadId: z.ZodMiniString<string>;
+    version: z.ZodMiniInt;
+    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>>;
+    body: z.ZodMiniString<string>;
+    author: z.ZodMiniObject<{
+        id: z.ZodMiniString<string>;
+        name: z.ZodMiniString<string>;
+        avatarUrl: z.ZodMiniOptional<z.ZodMiniURL>;
+    }, z.core.$strip>;
+    createdAt: z.ZodMiniISODateTime;
+}, z.core.$strip>;
+export type Comment = z.infer<typeof commentSchema>;
+export declare const threadStateSchema: z.ZodMiniEnum<{
+    open: "open";
+    outdated: "outdated";
+    resolved: "resolved";
+}>;
+export type ThreadState = z.infer<typeof threadStateSchema>;
+export declare const threadSchema: z.ZodMiniObject<{
+    id: z.ZodMiniString<string>;
+    state: z.ZodMiniEnum<{
+        open: "open";
+        outdated: "outdated";
+        resolved: "resolved";
+    }>;
+    comments: z.ZodMiniArray<z.ZodMiniObject<{
+        id: z.ZodMiniString<string>;
+        threadId: z.ZodMiniString<string>;
+        version: z.ZodMiniInt;
+        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>>;
+        body: z.ZodMiniString<string>;
+        author: z.ZodMiniObject<{
+            id: z.ZodMiniString<string>;
+            name: z.ZodMiniString<string>;
+            avatarUrl: z.ZodMiniOptional<z.ZodMiniURL>;
+        }, z.core.$strip>;
+        createdAt: z.ZodMiniISODateTime;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Thread = z.infer<typeof threadSchema>;
+/** Server-sent events on `GET /artifacts/:id/events`. */
+export declare const eventSchema: z.ZodMiniDiscriminatedUnion<[z.ZodMiniObject<{
+    type: z.ZodMiniLiteral<"version.published">;
+    version: z.ZodMiniObject<{
+        n: z.ZodMiniInt;
+        createdAt: z.ZodMiniISODateTime;
+        createdBy: z.ZodMiniObject<{
+            id: z.ZodMiniString<string>;
+            name: z.ZodMiniString<string>;
+            avatarUrl: z.ZodMiniOptional<z.ZodMiniURL>;
+        }, z.core.$strip>;
+        csp: 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>;
+}, z.core.$strip>, z.ZodMiniObject<{
+    type: z.ZodMiniLiteral<"thread.changed">;
+    thread: z.ZodMiniObject<{
+        id: z.ZodMiniString<string>;
+        state: z.ZodMiniEnum<{
+            open: "open";
+            outdated: "outdated";
+            resolved: "resolved";
+        }>;
+        comments: z.ZodMiniArray<z.ZodMiniObject<{
+            id: z.ZodMiniString<string>;
+            threadId: z.ZodMiniString<string>;
+            version: z.ZodMiniInt;
+            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>>;
+            body: z.ZodMiniString<string>;
+            author: z.ZodMiniObject<{
+                id: z.ZodMiniString<string>;
+                name: z.ZodMiniString<string>;
+                avatarUrl: z.ZodMiniOptional<z.ZodMiniURL>;
+            }, z.core.$strip>;
+            createdAt: z.ZodMiniISODateTime;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodMiniObject<{
+    type: z.ZodMiniLiteral<"state.changed">;
+    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>, z.ZodMiniObject<{
+    type: z.ZodMiniLiteral<"presence">;
+    actor: z.ZodMiniObject<{
+        id: z.ZodMiniString<string>;
+        name: z.ZodMiniString<string>;
+        avatarUrl: z.ZodMiniOptional<z.ZodMiniURL>;
+    }, z.core.$strip>;
+    cursor: z.ZodMiniNullable<z.ZodMiniObject<{
+        x: z.ZodMiniNumber<number>;
+        y: z.ZodMiniNumber<number>;
+    }, z.core.$strip>>;
+}, z.core.$strip>], "type">;
+export type ArtifactEvent = z.infer<typeof eventSchema>;
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/protocol/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAS7B,eAAO,MAAM,SAAS;;;;;iBAKpB,CAAA;AACF,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAA;AAK3C,eAAO,MAAM,aAAa;;;;;;;;;;;;;;iBAKxB,CAAA;AACF,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEnD,+FAA+F;AAC/F,eAAO,MAAM,cAAc,YAAI,MAAM,EAAE,QAAQ,CAAU,CAAA;AACzD,eAAO,MAAM,kBAAkB;;;EAAyB,CAAA;AACxD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE7D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuBzB,CAAA;AACF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAErD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;iBAQxB,CAAA;AACF,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEnD,eAAO,MAAM,iBAAiB;;;;EAA2C,CAAA;AACzE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE3D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIvB,CAAA;AACF,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAEjD,yDAAyD;AACzD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAKtB,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA"}