@stigmer/plugin-package 3.15.3-dev.20260916211208

package/dialects/cursor.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The Cursor manifest (`.cursor-plugin/plugin.json`).
+ *
+ * Cursor publishes a draft-07 schema for this file (`additionalProperties:
+ * false`, only `name` required); the known-field set below is that schema's
+ * key list, and `author` there carries `name` and `email` only. Component
+ * fields `skills`, `agents`, `rules`, `commands` are a path or an array of
+ * paths (the schema says "glob pattern(s) or path(s)"; every published
+ * plugin uses a `./`-prefixed directory, and a glob is refused rather than
+ * expanded). `mcpServers` is a path, an inline object, or an array of
+ * either. `variables` is a JSON Schema object whose `properties` are the
+ * variables a user is prompted for and whose `required` list marks the
+ * mandatory ones; Cursor has no sensitivity flag, so Stigmer treats every
+ * Cursor variable as a secret. `rules`, `commands`, `hooks`, `logo` and
+ * `minClientVersions` are recorded as ignored; `displayName`, `publisher`,
+ * `category` and `tags` are marketplace metadata Stigmer neither carries
+ * nor warns about.
+ */
+import type { JsonObject } from "../documents.js";
+import type { Findings } from "../messages.js";
+import { type DialectManifest } from "./manifest.js";
+export declare function readCursorManifest(object: JsonObject, path: string, findings: Findings): DialectManifest;
+//# sourceMappingURL=cursor.d.ts.map

package/dialects/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/dialects/cursor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EACL,KAAK,eAAe,EAMrB,MAAM,eAAe,CAAC;AA0BvB,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,eAAe,CAkBxG"}

package/dialects/cursor.js

@@ -0,0 +1,63 @@
+/**
+ * The Cursor manifest (`.cursor-plugin/plugin.json`).
+ *
+ * Cursor publishes a draft-07 schema for this file (`additionalProperties:
+ * false`, only `name` required); the known-field set below is that schema's
+ * key list, and `author` there carries `name` and `email` only. Component
+ * fields `skills`, `agents`, `rules`, `commands` are a path or an array of
+ * paths (the schema says "glob pattern(s) or path(s)"; every published
+ * plugin uses a `./`-prefixed directory, and a glob is refused rather than
+ * expanded). `mcpServers` is a path, an inline object, or an array of
+ * either. `variables` is a JSON Schema object whose `properties` are the
+ * variables a user is prompted for and whose `required` list marks the
+ * mandatory ones; Cursor has no sensitivity flag, so Stigmer treats every
+ * Cursor variable as a secret. `rules`, `commands`, `hooks`, `logo` and
+ * `minClientVersions` are recorded as ignored; `displayName`, `publisher`,
+ * `category` and `tags` are marketplace metadata Stigmer neither carries
+ * nor warns about.
+ */
+import { ignoredFieldComponents, readDeclaredPaths, readIdentity, readMcpSources, warnUnknownFields, } from "./manifest.js";
+const KNOWN_FIELDS = new Set([
+    "name",
+    "displayName",
+    "description",
+    "version",
+    "minClientVersions",
+    "author",
+    "publisher",
+    "homepage",
+    "repository",
+    "license",
+    "logo",
+    "keywords",
+    "category",
+    "tags",
+    "commands",
+    "agents",
+    "skills",
+    "rules",
+    "hooks",
+    "variables",
+    "mcpServers",
+]);
+export function readCursorManifest(object, path, findings) {
+    warnUnknownFields(object, KNOWN_FIELDS, path, findings);
+    const identity = readIdentity(object, path, findings);
+    const skillPaths = readDeclaredPaths(object, "skills", path, findings) ?? [];
+    const agentPaths = readDeclaredPaths(object, "agents", path, findings);
+    const manifest = {
+        dialect: "cursor",
+        path,
+        identity,
+        skillPaths,
+        mcpConfigs: readMcpSources(object, "mcpServers", path, "cursor", findings),
+        ignored: ignoredFieldComponents(object, path),
+    };
+    if (agentPaths !== undefined)
+        manifest.agentPaths = agentPaths;
+    if (object["variables"] !== undefined) {
+        manifest.variables = { dialect: "cursor", value: object["variables"], manifest: path };
+    }
+    return manifest;
+}
+//# sourceMappingURL=cursor.js.map

package/dialects/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/dialects/cursor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,EAEL,sBAAsB,EACtB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,MAAM,YAAY,GAAwB,IAAI,GAAG,CAAC;IAChD,MAAM;IACN,aAAa;IACb,aAAa;IACb,SAAS;IACT,mBAAmB;IACnB,QAAQ;IACR,WAAW;IACX,UAAU;IACV,YAAY;IACZ,SAAS;IACT,MAAM;IACN,UAAU;IACV,UAAU;IACV,MAAM;IACN,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,OAAO;IACP,WAAW;IACX,YAAY;CACb,CAAC,CAAC;AAEH,MAAM,UAAU,kBAAkB,CAAC,MAAkB,EAAE,IAAY,EAAE,QAAkB;IACrF,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC7E,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAmE;QAC/E,OAAO,EAAE,QAAQ;QACjB,IAAI;QACJ,QAAQ;QACR,UAAU;QACV,UAAU,EAAE,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC;QAC1E,OAAO,EAAE,sBAAsB,CAAC,MAAM,EAAE,IAAI,CAAC;KAC9C,CAAC;IACF,IAAI,UAAU,KAAK,SAAS;QAAE,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/D,IAAI,MAAM,CAAC,WAAW,CAAC,KAAK,SAAS,EAAE,CAAC;QACtC,QAAQ,CAAC,SAAS,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACzF,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dialects/manifest.d.ts

@@ -0,0 +1,109 @@
+/**
+ * The intermediate every dialect reader reduces its manifest to, and the
+ * field-reading helpers they share.
+ *
+ * A `DialectManifest` says what one manifest CONTRIBUTES: identity fields,
+ * declared component paths, MCP configuration sources, a variables block,
+ * and the fields it carries that Stigmer records as ignored. It does not
+ * decide anything across manifests: precedence, name conflicts and default
+ * locations are `detect.ts`'s, and turning declarations into skills,
+ * servers and variables is `normalise/`'s. Keeping the readers to "what
+ * does this file say" is what lets a plugin carry a root manifest and a
+ * vendor manifest at once and have both read.
+ *
+ * Unknown fields WARN in every dialect (the open format says report and
+ * ignore; Cursor's own validator would reject them, but a warning serves
+ * the author and the install still works). A known field of the wrong type
+ * is fatal (`manifest-field-type`), the open format's rule for any
+ * violation other than an unknown field.
+ */
+import { type JsonObject } from "../documents.js";
+import type { Findings } from "../messages.js";
+import type { IgnoredComponent, IgnoredComponentKind, PluginAuthor, PluginDialect } from "../types.js";
+export interface PluginIdentity {
+    readonly name?: string;
+    readonly version?: string;
+    readonly description?: string;
+    readonly author?: PluginAuthor;
+    readonly homepage?: string;
+    readonly repository?: string;
+    readonly license?: string;
+    readonly keywords?: readonly string[];
+}
+/** A component path a manifest declared, normalised, with where it was declared. */
+export interface DeclaredPath {
+    /** Plugin-relative, no leading `./`, no trailing slash; the root is `""`. */
+    readonly path: string;
+    /** The manifest that declared it, for messages. */
+    readonly manifest: string;
+}
+/** Where MCP server entries come from: a configuration file, or an object inline in a manifest. */
+export type McpConfigSource = {
+    readonly kind: "file";
+    readonly path: string;
+    readonly dialect: PluginDialect;
+    readonly manifest: string;
+} | {
+    readonly kind: "inline";
+    readonly manifest: string;
+    readonly servers: unknown;
+    readonly dialect: PluginDialect;
+};
+/** A variables block, raw, tagged with the dialect whose shape it takes. */
+export type VariablesDeclaration = {
+    readonly dialect: "cursor";
+    readonly value: unknown;
+    readonly manifest: string;
+} | {
+    readonly dialect: "claude";
+    readonly value: unknown;
+    readonly manifest: string;
+};
+export interface DialectManifest {
+    readonly dialect: PluginDialect;
+    readonly path: string;
+    readonly identity: PluginIdentity;
+    /** Declared skill paths; the default `skills/` is scanned regardless. */
+    readonly skillPaths: readonly DeclaredPath[];
+    /** Declared agent paths; `undefined` leaves the default `agents/` scan in force. */
+    readonly agentPaths?: readonly DeclaredPath[];
+    readonly mcpConfigs: readonly McpConfigSource[];
+    readonly variables?: VariablesDeclaration;
+    readonly ignored: readonly IgnoredComponent[];
+}
+/** Warn once per field the dialect does not define. */
+export declare function warnUnknownFields(object: JsonObject, known: ReadonlySet<string>, path: string, findings: Findings): void;
+/**
+ * The identity fields every dialect shares. `author` is an object in every
+ * dialect (Cursor's schema has no `url`; the extra key is a warning there,
+ * reported by the caller's known-field set for `author`).
+ */
+export declare function readIdentity(object: JsonObject, path: string, findings: Findings): PluginIdentity;
+/**
+ * A path field (`skills`, `agents`, ...) as declared paths. A value that is
+ * not a path (wrong prefix, escape, glob) is reported and dropped; the
+ * rest are kept, so one bad entry does not hide the others.
+ */
+export declare function readDeclaredPaths(object: JsonObject, field: string, path: string, findings: Findings): readonly DeclaredPath[] | undefined;
+/**
+ * A vendor `mcpServers` field: a path, an inline `mcpServers` object, or an
+ * array of either. Each becomes one source under the dialect's rules.
+ */
+export declare function readMcpSources(object: JsonObject, field: string, path: string, dialect: PluginDialect, findings: Findings): readonly McpConfigSource[];
+/**
+ * Manifest fields Stigmer reads past, recorded as ignored components at
+ * `<manifest>#<field>` when present. Shared across dialects; each names the
+ * fields it knows through `known` so the same field is never also an
+ * unknown-field warning.
+ */
+export declare const IGNORED_FIELD_KINDS: Readonly<Record<string, IgnoredComponentKind>>;
+export declare function ignoredFieldComponents(object: JsonObject, path: string): IgnoredComponent[];
+/**
+ * `extensions` in a root manifest: every namespace with content is an
+ * ignored component (a client ignores namespaces it does not implement
+ * without validating them); an empty object, including Stigmer's own
+ * reserved `ai.stigmer`, is silent. A non-object `extensions` is the open
+ * format's one non-fatal type violation: reported and ignored.
+ */
+export declare function extensionComponents(object: JsonObject, path: string, findings: Findings): IgnoredComponent[];
+//# sourceMappingURL=manifest.d.ts.map

package/dialects/manifest.d.ts.map

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

package/dialects/manifest.js

@@ -0,0 +1,194 @@
+/**
+ * The intermediate every dialect reader reduces its manifest to, and the
+ * field-reading helpers they share.
+ *
+ * A `DialectManifest` says what one manifest CONTRIBUTES: identity fields,
+ * declared component paths, MCP configuration sources, a variables block,
+ * and the fields it carries that Stigmer records as ignored. It does not
+ * decide anything across manifests: precedence, name conflicts and default
+ * locations are `detect.ts`'s, and turning declarations into skills,
+ * servers and variables is `normalise/`'s. Keeping the readers to "what
+ * does this file say" is what lets a plugin carry a root manifest and a
+ * vendor manifest at once and have both read.
+ *
+ * Unknown fields WARN in every dialect (the open format says report and
+ * ignore; Cursor's own validator would reject them, but a warning serves
+ * the author and the install still works). A known field of the wrong type
+ * is fatal (`manifest-field-type`), the open format's rule for any
+ * violation other than an unknown field.
+ */
+import { fields, isJsonObject, optionalString, optionalStringArray, stringOrStringArray } from "../documents.js";
+import { resolveDeclaredPath } from "../files.js";
+/** Warn once per field the dialect does not define. */
+export function warnUnknownFields(object, known, path, findings) {
+    for (const [name] of fields(object)) {
+        if (!known.has(name))
+            findings.warn("manifest-field-unknown", { path, subject: name });
+    }
+}
+/**
+ * The identity fields every dialect shares. `author` is an object in every
+ * dialect (Cursor's schema has no `url`; the extra key is a warning there,
+ * reported by the caller's known-field set for `author`).
+ */
+export function readIdentity(object, path, findings) {
+    const identity = {};
+    const name = optionalString(object, "name", path, findings);
+    if (name !== undefined)
+        identity.name = name;
+    const version = optionalString(object, "version", path, findings);
+    if (version !== undefined)
+        identity.version = version;
+    const description = optionalString(object, "description", path, findings);
+    if (description !== undefined)
+        identity.description = description;
+    const homepage = optionalString(object, "homepage", path, findings);
+    if (homepage !== undefined)
+        identity.homepage = homepage;
+    const repository = optionalString(object, "repository", path, findings);
+    if (repository !== undefined)
+        identity.repository = repository;
+    const license = optionalString(object, "license", path, findings);
+    if (license !== undefined)
+        identity.license = license;
+    const keywords = optionalStringArray(object, "keywords", path, findings);
+    if (keywords !== undefined)
+        identity.keywords = keywords;
+    const author = readAuthor(object, path, findings);
+    if (author !== undefined)
+        identity.author = author;
+    return identity;
+}
+function readAuthor(object, path, findings) {
+    const value = object["author"];
+    if (value === undefined)
+        return undefined;
+    if (!isJsonObject(value)) {
+        findings.error("manifest-field-type", { path, subject: "author", detail: "an object" });
+        return undefined;
+    }
+    const author = {};
+    const name = optionalString(value, "name", path, findings);
+    if (name !== undefined)
+        author.name = name;
+    const email = optionalString(value, "email", path, findings);
+    if (email !== undefined)
+        author.email = email;
+    const url = optionalString(value, "url", path, findings);
+    if (url !== undefined)
+        author.url = url;
+    return author;
+}
+/**
+ * A path field (`skills`, `agents`, ...) as declared paths. A value that is
+ * not a path (wrong prefix, escape, glob) is reported and dropped; the
+ * rest are kept, so one bad entry does not hide the others.
+ */
+export function readDeclaredPaths(object, field, path, findings) {
+    const values = stringOrStringArray(object, field, path, findings);
+    if (values === undefined)
+        return undefined;
+    const declared = [];
+    for (const value of values) {
+        const resolved = resolveDeclaredPath(value);
+        if (!resolved.ok) {
+            findings.error(resolved.kind, { path, subject: value });
+            continue;
+        }
+        declared.push({ path: resolved.path, manifest: path });
+    }
+    return declared;
+}
+/**
+ * A vendor `mcpServers` field: a path, an inline `mcpServers` object, or an
+ * array of either. Each becomes one source under the dialect's rules.
+ */
+export function readMcpSources(object, field, path, dialect, findings) {
+    const value = object[field];
+    if (value === undefined)
+        return [];
+    const items = Array.isArray(value) ? value : [value];
+    const sources = [];
+    for (const item of items) {
+        if (typeof item === "string") {
+            const resolved = resolveDeclaredPath(item);
+            if (!resolved.ok) {
+                findings.error(resolved.kind, { path, subject: item });
+                continue;
+            }
+            sources.push({ kind: "file", path: resolved.path, dialect, manifest: path });
+        }
+        else if (isJsonObject(item)) {
+            sources.push({ kind: "inline", manifest: path, servers: item, dialect });
+        }
+        else {
+            findings.error("manifest-field-type", { path, subject: field, detail: "a path, an object, or an array of either" });
+        }
+    }
+    return sources;
+}
+/**
+ * Manifest fields Stigmer reads past, recorded as ignored components at
+ * `<manifest>#<field>` when present. Shared across dialects; each names the
+ * fields it knows through `known` so the same field is never also an
+ * unknown-field warning.
+ */
+export const IGNORED_FIELD_KINDS = {
+    hooks: "hooks",
+    rules: "rules",
+    commands: "commands",
+    workflows: "workflows",
+    outputStyles: "output-styles",
+    lspServers: "lsp-servers",
+    channels: "channels",
+    dependencies: "dependencies",
+    defaultEnabled: "default-enabled",
+    minClientVersions: "min-client-versions",
+    logo: "logo",
+    apps: "apps",
+};
+export function ignoredFieldComponents(object, path) {
+    const ignored = [];
+    for (const [name, value] of fields(object)) {
+        const kind = IGNORED_FIELD_KINDS[name];
+        if (kind !== undefined)
+            ignored.push({ kind, path: `${path}#${name}` });
+        if (name === "experimental" && isJsonObject(value)) {
+            for (const [sub] of fields(value)) {
+                const subKind = EXPERIMENTAL_KINDS[sub];
+                if (subKind !== undefined)
+                    ignored.push({ kind: subKind, path: `${path}#experimental.${sub}` });
+            }
+        }
+    }
+    return ignored;
+}
+const EXPERIMENTAL_KINDS = {
+    themes: "themes",
+    monitors: "monitors",
+    evals: "evals",
+};
+/**
+ * `extensions` in a root manifest: every namespace with content is an
+ * ignored component (a client ignores namespaces it does not implement
+ * without validating them); an empty object, including Stigmer's own
+ * reserved `ai.stigmer`, is silent. A non-object `extensions` is the open
+ * format's one non-fatal type violation: reported and ignored.
+ */
+export function extensionComponents(object, path, findings) {
+    const value = object["extensions"];
+    if (value === undefined)
+        return [];
+    if (!isJsonObject(value)) {
+        findings.warn("manifest-extensions-invalid", { path });
+        return [];
+    }
+    const ignored = [];
+    for (const [namespace, content] of fields(value)) {
+        if (isJsonObject(content) && fields(content).length === 0)
+            continue;
+        ignored.push({ kind: "extension", path: `${path}#extensions.${namespace}` });
+    }
+    return ignored;
+}
+//# sourceMappingURL=manifest.js.map

package/dialects/manifest.js.map

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

package/dialects/open.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The Agent Plugins 1.0.0 root manifest (`plugin.json`).
+ *
+ * The open format's manifest is closed and versioned: `$schema` is required
+ * and must be the canonical 1.0.0 identifier, the ten permitted fields are
+ * fixed, an unknown field is reported and ignored, and any other violation
+ * is fatal. Components live at fixed locations only (`skills/`, `mcp.json`),
+ * so this manifest declares no paths and no inline servers; `mcp.json` is
+ * read under the open format's rules by `detect.ts` when it exists.
+ * Client-specific data belongs under `extensions`, which Stigmer records as
+ * ignored per namespace (its own `ai.stigmer` namespace is reserved and
+ * empty today).
+ */
+import { type JsonObject } from "../documents.js";
+import { type Findings } from "../messages.js";
+import { type DialectManifest } from "./manifest.js";
+export declare function readOpenManifest(object: JsonObject, path: string, findings: Findings): DialectManifest;
+//# sourceMappingURL=open.d.ts.map

package/dialects/open.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../src/dialects/open.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAiC,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,KAAK,eAAe,EAAwD,MAAM,eAAe,CAAC;AAe3G,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,eAAe,CAgBtG"}

package/dialects/open.js

@@ -0,0 +1,47 @@
+/**
+ * The Agent Plugins 1.0.0 root manifest (`plugin.json`).
+ *
+ * The open format's manifest is closed and versioned: `$schema` is required
+ * and must be the canonical 1.0.0 identifier, the ten permitted fields are
+ * fixed, an unknown field is reported and ignored, and any other violation
+ * is fatal. Components live at fixed locations only (`skills/`, `mcp.json`),
+ * so this manifest declares no paths and no inline servers; `mcp.json` is
+ * read under the open format's rules by `detect.ts` when it exists.
+ * Client-specific data belongs under `extensions`, which Stigmer records as
+ * ignored per namespace (its own `ai.stigmer` namespace is reserved and
+ * empty today).
+ */
+import { describeValue } from "../documents.js";
+import { AGENT_PLUGINS_MANIFEST_SCHEMA } from "../messages.js";
+import { extensionComponents, readIdentity, warnUnknownFields } from "./manifest.js";
+const KNOWN_FIELDS = new Set([
+    "$schema",
+    "name",
+    "version",
+    "description",
+    "author",
+    "homepage",
+    "repository",
+    "license",
+    "keywords",
+    "extensions",
+]);
+export function readOpenManifest(object, path, findings) {
+    const schema = object["$schema"];
+    if (schema === undefined) {
+        findings.error("manifest-schema-missing", { path });
+    }
+    else if (schema !== AGENT_PLUGINS_MANIFEST_SCHEMA) {
+        findings.error("manifest-schema-unsupported", { path, detail: describeValue(schema) });
+    }
+    warnUnknownFields(object, KNOWN_FIELDS, path, findings);
+    return {
+        dialect: "agent-plugins",
+        path,
+        identity: readIdentity(object, path, findings),
+        skillPaths: [],
+        mcpConfigs: [],
+        ignored: extensionComponents(object, path, findings),
+    };
+}
+//# sourceMappingURL=open.js.map

package/dialects/open.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.js","sourceRoot":"","sources":["../../src/dialects/open.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,aAAa,EAAmB,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,6BAA6B,EAAiB,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAwB,mBAAmB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE3G,MAAM,YAAY,GAAwB,IAAI,GAAG,CAAC;IAChD,SAAS;IACT,MAAM;IACN,SAAS;IACT,aAAa;IACb,QAAQ;IACR,UAAU;IACV,YAAY;IACZ,SAAS;IACT,UAAU;IACV,YAAY;CACb,CAAC,CAAC;AAEH,MAAM,UAAU,gBAAgB,CAAC,MAAkB,EAAE,IAAY,EAAE,QAAkB;IACnF,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IACjC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,QAAQ,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;SAAM,IAAI,MAAM,KAAK,6BAA6B,EAAE,CAAC;QACpD,QAAQ,CAAC,KAAK,CAAC,6BAA6B,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACxD,OAAO;QACL,OAAO,EAAE,eAAe;QACxB,IAAI;QACJ,QAAQ,EAAE,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC;QAC9C,UAAU,EAAE,EAAE;QACd,UAAU,EAAE,EAAE;QACd,OAAO,EAAE,mBAAmB,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC;KACrD,CAAC;AACJ,CAAC"}

package/documents.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Reading one document through its cap, and the JSON shape checks every
+ * dialect reader repeats.
+ *
+ * `readText` is the only place the library calls `PluginFiles.read`: the
+ * declared size is checked against the document class's cap first, the
+ * returned length second, and an over-cap document becomes a
+ * `document-too-large` finding instead of a read. The JSON helpers turn a
+ * parse failure into a finding of the caller's kind and leave the value
+ * `unknown`, so each reader narrows fields with the `expect*` helpers and
+ * reports a wrong type with the field's name rather than trusting a cast.
+ */
+import { type PluginDocumentClass, type PluginFileIndex } from "./files.js";
+import type { Findings } from "./messages.js";
+import type { PluginErrorKind } from "./outcome.js";
+/** The document's text, or `undefined` after a `document-too-large` finding. */
+export declare function readText(index: PluginFileIndex, path: string, cls: PluginDocumentClass, findings: Findings): string | undefined;
+/** The document's bytes, or `undefined` after a `document-too-large` finding. */
+export declare function readBytes(index: PluginFileIndex, path: string, cls: PluginDocumentClass, findings: Findings): Uint8Array | undefined;
+/** A parsed JSON object (non-null, non-array), or `undefined` after a finding of `kind`. */
+export declare function parseJsonObject(text: string, path: string, kind: Extract<PluginErrorKind, "manifest-unreadable" | "mcp-config-unreadable">, findings: Findings): JsonObject | undefined;
+export type JsonObject = Readonly<Record<string, unknown>>;
+export declare function isJsonObject(value: unknown): value is JsonObject;
+export declare function isStringArray(value: unknown): value is readonly string[];
+export declare function isStringRecord(value: unknown): value is Readonly<Record<string, string>>;
+/** A JSON value as a sentence can quote it: a string as itself, anything else serialised. */
+export declare function describeValue(value: unknown): string;
+/**
+ * The fields of `object`, in the document's own order. `Object.entries`
+ * reads own enumerable properties only, so a `__proto__` key in the JSON is
+ * just another entry here and never reaches a prototype.
+ */
+export declare function fields(object: JsonObject): readonly (readonly [string, unknown])[];
+/** A string field or `undefined`; a present non-string reports `manifest-field-type`. */
+export declare function optionalString(object: JsonObject, field: string, path: string, findings: Findings): string | undefined;
+/** A string-array field or `undefined`; a present non-array-of-strings reports `manifest-field-type`. */
+export declare function optionalStringArray(object: JsonObject, field: string, path: string, findings: Findings): readonly string[] | undefined;
+/**
+ * A field that may be one string or an array of strings (the vendor
+ * dialects' path fields), normalised to an array; `undefined` when absent.
+ */
+export declare function stringOrStringArray(object: JsonObject, field: string, path: string, findings: Findings): readonly string[] | undefined;
+//# sourceMappingURL=documents.d.ts.map

package/documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../src/documents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAsC,KAAK,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAChH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,gFAAgF;AAChF,wBAAgB,QAAQ,CACtB,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,mBAAmB,EACxB,QAAQ,EAAE,QAAQ,GACjB,MAAM,GAAG,SAAS,CAGpB;AAED,iFAAiF;AACjF,wBAAgB,SAAS,CACvB,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,mBAAmB,EACxB,QAAQ,EAAE,QAAQ,GACjB,UAAU,GAAG,SAAS,CAgBxB;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,CAAC,eAAe,EAAE,qBAAqB,GAAG,uBAAuB,CAAC,EAC/E,QAAQ,EAAE,QAAQ,GACjB,UAAU,GAAG,SAAS,CAaxB;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE3D,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,MAAM,EAAE,CAExE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAExF;AAED,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAElF;AAED,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAQtH;AAED,yGAAyG;AACzG,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,GACjB,SAAS,MAAM,EAAE,GAAG,SAAS,CAQ/B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,GACjB,SAAS,MAAM,EAAE,GAAG,SAAS,CAO/B"}

package/documents.js

@@ -0,0 +1,111 @@
+/**
+ * Reading one document through its cap, and the JSON shape checks every
+ * dialect reader repeats.
+ *
+ * `readText` is the only place the library calls `PluginFiles.read`: the
+ * declared size is checked against the document class's cap first, the
+ * returned length second, and an over-cap document becomes a
+ * `document-too-large` finding instead of a read. The JSON helpers turn a
+ * parse failure into a finding of the caller's kind and leave the value
+ * `unknown`, so each reader narrows fields with the `expect*` helpers and
+ * reports a wrong type with the field's name rather than trusting a cast.
+ */
+import { decodeUtf8, PLUGIN_DOCUMENT_LIMITS } from "./files.js";
+/** The document's text, or `undefined` after a `document-too-large` finding. */
+export function readText(index, path, cls, findings) {
+    const bytes = readBytes(index, path, cls, findings);
+    return bytes === undefined ? undefined : decodeUtf8(bytes);
+}
+/** The document's bytes, or `undefined` after a `document-too-large` finding. */
+export function readBytes(index, path, cls, findings) {
+    const limit = PLUGIN_DOCUMENT_LIMITS[cls];
+    const entry = index.entry(path);
+    if (entry === undefined) {
+        throw new Error(`plugin file '${path}' is not listed`);
+    }
+    if (entry.size > limit) {
+        findings.error("document-too-large", { path, subject: String(entry.size), detail: String(limit) });
+        return undefined;
+    }
+    const bytes = index.files.read(path);
+    if (bytes.length > limit) {
+        findings.error("document-too-large", { path, subject: String(bytes.length), detail: String(limit) });
+        return undefined;
+    }
+    return bytes;
+}
+/** A parsed JSON object (non-null, non-array), or `undefined` after a finding of `kind`. */
+export function parseJsonObject(text, path, kind, findings) {
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch (error) {
+        findings.error(kind, { path, detail: error instanceof Error ? error.message : String(error) });
+        return undefined;
+    }
+    if (!isJsonObject(value)) {
+        findings.error(kind, { path, detail: "the document is not a JSON object" });
+        return undefined;
+    }
+    return value;
+}
+export function isJsonObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function isStringArray(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+export function isStringRecord(value) {
+    return isJsonObject(value) && Object.values(value).every((item) => typeof item === "string");
+}
+/** A JSON value as a sentence can quote it: a string as itself, anything else serialised. */
+export function describeValue(value) {
+    return typeof value === "string" ? value : JSON.stringify(value);
+}
+/**
+ * The fields of `object`, in the document's own order. `Object.entries`
+ * reads own enumerable properties only, so a `__proto__` key in the JSON is
+ * just another entry here and never reaches a prototype.
+ */
+export function fields(object) {
+    return Object.entries(object);
+}
+/** A string field or `undefined`; a present non-string reports `manifest-field-type`. */
+export function optionalString(object, field, path, findings) {
+    const value = object[field];
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string") {
+        findings.error("manifest-field-type", { path, subject: field, detail: "a string" });
+        return undefined;
+    }
+    return value;
+}
+/** A string-array field or `undefined`; a present non-array-of-strings reports `manifest-field-type`. */
+export function optionalStringArray(object, field, path, findings) {
+    const value = object[field];
+    if (value === undefined)
+        return undefined;
+    if (!isStringArray(value)) {
+        findings.error("manifest-field-type", { path, subject: field, detail: "an array of strings" });
+        return undefined;
+    }
+    return value;
+}
+/**
+ * A field that may be one string or an array of strings (the vendor
+ * dialects' path fields), normalised to an array; `undefined` when absent.
+ */
+export function stringOrStringArray(object, field, path, findings) {
+    const value = object[field];
+    if (value === undefined)
+        return undefined;
+    if (typeof value === "string")
+        return [value];
+    if (isStringArray(value))
+        return value;
+    findings.error("manifest-field-type", { path, subject: field, detail: "a string or an array of strings" });
+    return undefined;
+}
+//# sourceMappingURL=documents.js.map