@jini-ai/agent-plugins 0.4.7 → 0.6.10

package/dist/lifecycle/manifest.js

@@ -54,6 +54,7 @@
  * own "receives a JS value, never a file path or raw bytes" contract. `install.ts` is the only
  * caller that reads the file and hands the parsed value here.
  */
+import { readAgentPluginCompatibilityMetadata } from "./compatibility-metadata.js";
 import { readPluginIdentity, validatePluginIdentity } from "@jini-ai/core/plugin-directory";
 export { validatePluginManifest, validateMcpManifest } from '../manifest.js';
 /**
@@ -104,6 +105,15 @@ function readSpecVersion(value, file) {
  */
 const NAME_PATTERN = /^[a-z0-9]+(?:[-.][a-z0-9]+)*$/;
 const MAX_NAME_LENGTH = 64;
+/**
+ * True when `value` is a valid Agent Plugin id: `plugin.json`'s `name` grammar (§5.5, see
+ * `NAME_PATTERN`), 1-64 characters. The one owner of that grammar: a host checks an id taken from a
+ * URL or a tool input here before it names anything on disk, instead of restating the pattern.
+ * @complexity O(n) in the value's length.
+ */
+export function isAgentPluginName({ value }, _optional = {}) {
+    return typeof value === "string" && value.length <= MAX_NAME_LENGTH && NAME_PATTERN.test(value);
+}
 const KNOWN_MANIFEST_KEYS = new Set(["$schema", "name", "version", "description", "author", "license", "keywords", "extensions"]);
 /**
  * True for a non-null, non-array plain object — the "is this actually a JSON object" gate both
@@ -112,6 +122,17 @@ const KNOWN_MANIFEST_KEYS = new Set(["$schema", "name", "version", "description"
 function isJsonObject(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+/**
+ * `undefined` for an absent optional field, otherwise whatever `parse` makes of it — `null` meaning
+ * present but malformed, which every caller folds into rejecting the whole entry.
+ */
+function parseOptional({ value, parse }) {
+    return value === undefined ? undefined : parse(value);
+}
+/** Drops `undefined` members, so an absent optional field stays absent rather than present-as-undefined. */
+function definedFields(fields) {
+    return Object.fromEntries(Object.entries(fields).filter(([, value]) => value !== undefined));
+}
 /**
  * `value` narrowed to a `string`, or `undefined` — every optional string field below coerces
  * through this one check instead of repeating its own `typeof ... === "string" ? ... : undefined`
@@ -125,11 +146,7 @@ function parseManifestAuthor(value) {
         return value; // Existing installed manifests may carry a string.
     if (!isJsonObject(value))
         return undefined;
-    return {
-        ...(typeof value.name === 'string' ? { name: value.name } : {}),
-        ...(typeof value.email === 'string' ? { email: value.email } : {}),
-        ...(typeof value.url === 'string' ? { url: value.url } : {}),
-    };
+    return definedFields({ name: coerceOptionalString(value.name), email: coerceOptionalString(value.email), url: coerceOptionalString(value.url) });
 }
 /**
  * Validates `plugin.json`'s `name` field per §5.5's grammar (see `NAME_PATTERN`'s own header for
@@ -141,26 +158,15 @@ function resolveManifestName(raw) {
     const name = coerceOptionalString(raw.name);
     if (name === undefined)
         return { error: "plugin.json 'name' is required and must be a string" };
-    if (name.length === 0 || name.length > MAX_NAME_LENGTH || !NAME_PATTERN.test(name)) {
+    if (!isAgentPluginName({ value: name })) {
         return {
             error: `plugin.json 'name' ('${name}') must be 1-${MAX_NAME_LENGTH} lowercase alphanumeric/hyphen/period characters, start and end alphanumeric, with no consecutive delimiters`,
         };
     }
     return { name };
 }
-/**
- * Validates an already-`JSON.parse`d `plugin.json` value against the 1.0.0/1.1.0 grammar.
- * Hosts inject identityNamespace; the default retains the existing plugin extension format.
- *
- * @throws Nothing — every failure is reported via the returned `errors`, matching this codebase's
- * own convention for expected validation outcomes (`plugin-runtime/manifest.ts`,
- * `plugin-runtime/discovery.ts`).
- * @complexity O(k + n) time and space in the input keys and keyword entries.
- */
-export function parseAgentPluginManifest({ value }, { identityNamespace = "tovu" } = {}) {
-    if (!isJsonObject(value))
-        return { ok: false, errors: ["plugin.json must be a JSON object"] };
-    const raw = value;
+/** Every `plugin.json` error and warning, in report order: spec version, extensions, name, unknown keys, identity. */
+function collectManifestProblems({ raw, identityNamespace }, { nameError } = {}) {
     const errors = [];
     const warnings = [];
     const specVersion = readSpecVersion(raw.$schema, "plugin");
@@ -170,19 +176,39 @@ export function parseAgentPluginManifest({ value }, { identityNamespace = "tovu"
         warnings.push(specVersion.warning);
     if (raw.extensions !== undefined && !isJsonObject(raw.extensions))
         errors.push("plugin.json extensions must be an object");
-    const nameResult = resolveManifestName(raw);
-    if (nameResult.error)
-        errors.push(nameResult.error);
+    if (nameError)
+        errors.push(nameError);
     for (const key of Object.keys(raw)) {
         if (!KNOWN_MANIFEST_KEYS.has(key))
             warnings.push(`unrecognized plugin.json field '${key}' (ignored per spec)`);
     }
     errors.push(...validatePluginIdentity({ manifest: raw, namespace: identityNamespace }).errors);
+    return { errors, warnings };
+}
+/**
+ * Validates an already-`JSON.parse`d `plugin.json` value against the 1.0.0/1.1.0 grammar.
+ * Hosts inject identityNamespace; the default retains the existing plugin extension format.
+ *
+ * @throws Nothing — every failure is reported via the returned `errors`, matching this codebase's
+ * own convention for expected validation outcomes (`plugin-runtime/manifest.ts`,
+ * `plugin-runtime/discovery.ts`).
+ * @complexity O(k + n) time and space in the input keys and keyword entries.
+ */
+export function parseAgentPluginManifest({ value }, { identityNamespace = "tovu" } = {}) {
+    if (!isJsonObject(value))
+        return { ok: false, errors: ["plugin.json must be a JSON object"] };
+    const raw = value;
+    const nameResult = resolveManifestName(raw);
+    const { errors, warnings } = collectManifestProblems({ raw, identityNamespace }, { nameError: nameResult.error });
     if (errors.length > 0)
         return { ok: false, errors };
     const identity = readPluginIdentity({ manifest: raw, namespace: identityNamespace });
     warnings.push(...identity.warnings);
+    const extension = isJsonObject(raw.extensions) && isJsonObject(raw.extensions[identityNamespace]) ? raw.extensions[identityNamespace] : {};
+    const { warnings: compatibilityWarnings, ...compatibility } = readAgentPluginCompatibilityMetadata({ extension });
+    warnings.push(...compatibilityWarnings);
     const manifest = {
+        ...compatibility,
         name: nameResult.name,
         id: identity.id,
         provides: identity.provides,
@@ -224,20 +250,12 @@ function isStringRecord(value) {
 function parseStdioServerConfig(raw) {
     if (typeof raw.command !== "string" || raw.command.length === 0)
         return null;
-    const { args, env, cwd } = raw;
-    if (args !== undefined && !(Array.isArray(args) && args.every((entry) => typeof entry === "string")))
-        return null;
-    if (env !== undefined && (!isStringRecord(env) || RESERVED_STDIO_ENV_KEYS.some((key) => Object.hasOwn(env, key))))
+    const args = parseOptional({ value: raw.args, parse: (value) => Array.isArray(value) && value.every((entry) => typeof entry === "string") ? value : null });
+    const env = parseOptional({ value: raw.env, parse: (value) => isStringRecord(value) && !RESERVED_STDIO_ENV_KEYS.some((key) => Object.hasOwn(value, key)) ? value : null });
+    const cwd = parseOptional({ value: raw.cwd, parse: (value) => typeof value === "string" ? value : null });
+    if (args === null || env === null || cwd === null)
         return null;
-    if (cwd !== undefined && typeof cwd !== "string")
-        return null;
-    return {
-        type: "stdio",
-        command: raw.command,
-        ...(args !== undefined ? { args: args } : {}),
-        ...(env !== undefined ? { env } : {}),
-        ...(cwd !== undefined ? { cwd } : {}),
-    };
+    return { type: "stdio", command: raw.command, ...definedFields({ args, env, cwd }) };
 }
 /**
  * Same bound and grammar as `external-mcp-store.ts`'s `MAX_ALLOWED_TOOLS`/`REMOTE_TOOL_NAME_PATTERN`,
@@ -253,6 +271,10 @@ function parseDefaultToolNames(value) {
         return null;
     return value.every((name) => typeof name === "string" && DEFAULT_TOOL_NAME_PATTERN.test(name)) ? value : null;
 }
+/** `read` and `write` default to `[]` when absent. */
+function parseGrantList(value) {
+    return value === undefined ? [] : parseDefaultToolNames(value);
+}
 /**
  * Validates bounded sign-in and read lists. `read` and `write` default to `[]`.
  * A provided `allow` bounds both lists; without it only a read declaration is meaningful,
@@ -264,15 +286,15 @@ function parseDefaultToolNames(value) {
 function parseDefaultTools(value) {
     if (!isJsonObject(value))
         return null;
-    const allow = value.allow === undefined ? undefined : parseDefaultToolNames(value.allow);
-    const write = value.write === undefined ? [] : parseDefaultToolNames(value.write);
-    const read = value.read === undefined ? [] : parseDefaultToolNames(value.read);
+    const allow = parseOptional({ value: value.allow, parse: parseDefaultToolNames });
+    const write = parseGrantList(value.write);
+    const read = parseGrantList(value.read);
     if (allow === null || write === null || read === null)
         return null;
     if (allow === undefined)
         return value.read !== undefined && write.length === 0 ? { write, read } : null;
     const allowed = new Set(allow);
-    return write.every((name) => allowed.has(name)) && read.every((name) => allowed.has(name)) ? { allow, write, read } : null;
+    return [...write, ...read].every((name) => allowed.has(name)) ? { allow, write, read } : null;
 }
 const MAX_TOKEN_AUTH_URL_LENGTH = 2048;
 function isHttpsUrl(value) {
@@ -320,18 +342,11 @@ function parseRenamedTools(value) {
 function parseTokenAuth(value) {
     if (!isJsonObject(value) || !isHttpsUrl(value.helpUrl) || !isHttpsUrl(value.probeUrl))
         return null;
-    const { importFromEnv } = value;
-    if (importFromEnv !== undefined && !isEnvVarName(importFromEnv))
+    const importFromEnv = parseOptional({ value: value.importFromEnv, parse: (name) => isEnvVarName(name) ? name : null });
+    const retiredEnv = parseOptional({ value: value.retiredEnv, parse: parseRetiredEnv });
+    if (importFromEnv === null || retiredEnv === null)
         return null;
-    const retiredEnv = value.retiredEnv === undefined ? undefined : parseRetiredEnv(value.retiredEnv);
-    if (retiredEnv === null)
-        return null;
-    return {
-        helpUrl: value.helpUrl,
-        probeUrl: value.probeUrl,
-        ...(importFromEnv !== undefined ? { importFromEnv } : {}),
-        ...(retiredEnv !== undefined ? { retiredEnv } : {}),
-    };
+    return { helpUrl: value.helpUrl, probeUrl: value.probeUrl, ...definedFields({ importFromEnv, retiredEnv }) };
 }
 /**
  * Validates one `type: "streamable-http"` or `type: "sse"` server entry — the two remote transports
@@ -346,45 +361,64 @@ function parseTokenAuth(value) {
 function parseRemoteServerConfig(type, raw, extension) {
     if (typeof raw.url !== "string" || raw.url.length === 0)
         return null;
-    const { headers } = raw;
-    const authMode = extension?.authMode;
-    if (headers !== undefined && !isStringRecord(headers))
+    const headers = parseOptional({ value: raw.headers, parse: (value) => isStringRecord(value) ? value : null });
+    const metadata = parseServerMetadata(extension ?? {});
+    if (headers === null || metadata === null)
         return null;
-    if (authMode !== undefined && authMode !== "oauth" && authMode !== "none")
-        return null;
-    const defaults = extension?.defaultTools;
-    const defaultTools = defaults === undefined ? undefined : parseDefaultTools(defaults);
-    if (defaultTools === null)
-        return null;
-    const tokenAuth = extension?.tokenAuth === undefined ? undefined : parseTokenAuth(extension?.tokenAuth);
-    if (tokenAuth === null)
-        return null;
-    const renamedTools = extension?.renamedTools === undefined ? undefined : parseRenamedTools(extension?.renamedTools);
-    if (renamedTools === null)
+    return { type, url: raw.url, ...definedFields({ headers }), ...metadata };
+}
+/** A remote entry's extension metadata, or `null` when any declared member is malformed. */
+function parseServerMetadata(extension) {
+    const authMode = parseOptional({ value: extension.authMode, parse: (mode) => mode === "oauth" || mode === "none" ? mode : null });
+    const defaultTools = parseOptional({ value: extension.defaultTools, parse: parseDefaultTools });
+    const tokenAuth = parseOptional({ value: extension.tokenAuth, parse: parseTokenAuth });
+    const renamedTools = parseOptional({ value: extension.renamedTools, parse: parseRenamedTools });
+    if (authMode === null || defaultTools === null || tokenAuth === null || renamedTools === null)
         return null;
-    return {
-        type,
-        url: raw.url,
-        ...(headers !== undefined ? { headers } : {}),
-        ...(authMode !== undefined ? { authMode } : {}),
-        ...(defaultTools !== undefined ? { defaultTools } : {}),
-        ...(tokenAuth !== undefined ? { tokenAuth } : {}),
-        ...(renamedTools !== undefined ? { renamedTools } : {}),
-    };
+    return definedFields({ authMode, defaultTools, tokenAuth, renamedTools });
 }
 /**
- * Dispatches one raw `mcpServers` entry to its transport's validator by `type`, or `null` for a
- *  non-object entry or a `type` outside {@link MCP_SERVER_TRANSPORTS}.
+ * Dispatches one `mcpServers` object entry to its transport's validator by `type`, or `null` for a
+ *  `type` outside {@link MCP_SERVER_TRANSPORTS}.
  */
 function parseMcpServerConfig(value, extension) {
-    if (!isJsonObject(value))
-        return null;
     if (value.type === "stdio")
         return parseStdioServerConfig(value);
     if (value.type === "streamable-http" || value.type === "sse")
         return parseRemoteServerConfig(value.type, value, extension);
     return null;
 }
+/** One declared server, or `null` for a non-object entry, a malformed extension, or an invalid transport shape. */
+function parseDeclaredServer({ serverId, rawServer, extension }, { readServerMetadata } = {}) {
+    // A malformed declared extension excludes the server before the translator can hide it.
+    if (!isJsonObject(rawServer) || (extension !== undefined && !isJsonObject(extension)))
+        return null;
+    const metadata = readServerMetadata?.({ serverId, value: extension ?? {}, server: rawServer }) ?? extension;
+    return parseMcpServerConfig(rawServer, metadata);
+}
+/** `mcp.json`'s top-level errors: its own `$schema`, a version mismatch with `plugin.json` (§10), and `mcpServers`' shape. */
+function collectMcpConfigErrors({ raw }, { pluginManifest } = {}) {
+    const errors = [];
+    // plugin.json already reports an unknown-1.x warning; mcp.json adds none of its own.
+    const mcpSpec = readSpecVersion(raw.$schema, "mcp");
+    const mcpVersion = mcpSpec.version;
+    const pluginVersion = isJsonObject(pluginManifest) ? readSpecVersion(pluginManifest.$schema, "plugin").version : undefined;
+    if (mcpSpec.error)
+        errors.push(mcpSpec.error);
+    else if (pluginVersion !== undefined && pluginVersion !== mcpVersion) {
+        errors.push(`mcp.json targets Agent Plugins ${mcpVersion} but plugin.json targets ${pluginVersion}; the versions must match`);
+    }
+    if (!isJsonObject(raw.mcpServers))
+        errors.push("mcp.json 'mcpServers' is required and must be an object");
+    return errors;
+}
+/** The per-server metadata `plugin.json` declares under `extensionNamespace`, or `{}` when it declares none. */
+function readExtensionServers({ pluginManifest, extensionNamespace }) {
+    const manifest = parseAgentPluginManifest({ value: pluginManifest });
+    if (!manifest.ok)
+        return {};
+    return readAgentPluginExtension({ manifest: manifest.manifest, namespace: extensionNamespace, read: ({ value }) => isJsonObject(value.mcpServers) ? value.mcpServers : {} }) ?? {};
+}
 /**
  * Validates an already-`JSON.parse`d `mcp.json` value against the 1.0.0/1.1.0 top-level shape:
  * `{ "$schema": ..., "mcpServers": { "<server-id>": {...} } }`, then validates each declared
@@ -399,35 +433,15 @@ export function parseAgentPluginMcpConfig({ value, extensionNamespace }, optiona
         throw new Error("An extension namespace is required");
     if (!isJsonObject(value))
         return { ok: false, errors: ["mcp.json must be a JSON object"] };
-    const raw = value;
-    const errors = [];
-    // plugin.json already reports an unknown-1.x warning; mcp.json adds none of its own.
-    const mcpSpec = readSpecVersion(raw.$schema, "mcp");
-    const mcpVersion = mcpSpec.version;
-    const pluginVersion = isJsonObject(optional.pluginManifest) ? readSpecVersion(optional.pluginManifest.$schema, "plugin").version : undefined;
-    if (mcpSpec.error)
-        errors.push(mcpSpec.error);
-    else if (pluginVersion !== undefined && pluginVersion !== mcpVersion) {
-        errors.push(`mcp.json targets Agent Plugins ${mcpVersion} but plugin.json targets ${pluginVersion}; the versions must match`);
-    }
-    const mcpServers = raw.mcpServers;
-    if (typeof mcpServers !== "object" || mcpServers === null || Array.isArray(mcpServers)) {
-        errors.push("mcp.json 'mcpServers' is required and must be an object");
-    }
+    const errors = collectMcpConfigErrors({ raw: value }, { pluginManifest: optional.pluginManifest });
     if (errors.length > 0)
         return { ok: false, errors };
-    const manifest = parseAgentPluginManifest({ value: optional.pluginManifest });
-    const extension = manifest.ok ? readAgentPluginExtension({ manifest: manifest.manifest, namespace: extensionNamespace, read: ({ value }) => isJsonObject(value.mcpServers) ? value.mcpServers : {} }) : undefined;
-    const extensionServers = extension ?? {};
-    const entries = Object.entries(mcpServers);
+    const extensionServers = readExtensionServers({ pluginManifest: optional.pluginManifest, extensionNamespace });
+    const entries = Object.entries(value.mcpServers);
     const servers = Object.create(null);
     for (const [serverId, rawServer] of entries) {
         const extension = Object.hasOwn(extensionServers, serverId) ? extensionServers[serverId] : undefined;
-        // A malformed declared extension excludes the server before the translator can hide it.
-        const metadata = isJsonObject(rawServer) && (extension === undefined || isJsonObject(extension))
-            ? optional.readServerMetadata?.({ serverId, value: extension ?? {}, server: rawServer }) ?? extension
-            : undefined;
-        const parsed = extension !== undefined && !isJsonObject(extension) ? null : parseMcpServerConfig(rawServer, metadata);
+        const parsed = parseDeclaredServer({ serverId, rawServer, extension }, { readServerMetadata: optional.readServerMetadata });
         if (parsed)
             servers[serverId] = parsed;
     }

package/dist/lifecycle/manifest.js.map

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

package/dist/lifecycle/mcp-provisioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-provisioning.d.ts","sourceRoot":"","sources":["../../src/lifecycle/mcp-provisioning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD,gGAAgG;AAChG,wBAAsB,uBAAuB,CAAC,QAAQ,EAAE;IACtD,QAAQ,CAAC,eAAe,EAAE,8BAA8B,CAAC;IACzD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;CAC1C,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhB;AACD,wBAAsB,yBAAyB,CAAC,QAAQ,EAAE;IACxD,QAAQ,CAAC,eAAe,EAAE,8BAA8B,CAAC;IACzD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhB;AACD,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE;IACnD,QAAQ,CAAC,eAAe,EAAE,8BAA8B,CAAC;IACzD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhB"}

package/dist/lifecycle/mcp-provisioning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-provisioning.js","sourceRoot":"","sources":["../../src/lifecycle/mcp-provisioning.ts"],"names":[],"mappings":"AAGA,gGAAgG;AAChG,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,QAI7C;IACC,MAAM,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;IAC/G,MAAM,QAAQ,CAAC,eAAe,CAAC,mBAAmB,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;AAC5F,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,QAK/C;IACC,MAAM,QAAQ,CAAC,eAAe,CAAC,UAAU,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACzI,MAAM,QAAQ,CAAC,eAAe,CAAC,mBAAmB,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;AAC5F,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,QAI1C;IACC,MAAM,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC1G,MAAM,QAAQ,CAAC,eAAe,CAAC,mBAAmB,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;AAC5F,CAAC"}

package/dist/lifecycle/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/lifecycle/node.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEnH,iGAAiG;AACjG,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,QAAQ,GAAE;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAA;CAAO,GAAG;IACvI,UAAU,EAAE,cAAc,CAAC;IAC3B,KAAK,EAAE,oBAAoB,CAAC;IAC5B,GAAG,EAAE,kBAAkB,CAAC;IACxB,OAAO,EAAE,sBAAsB,CAAC;CACjC,CAoBA"}

package/dist/lifecycle/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/lifecycle/node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,gBAAgB,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGlD,iGAAiG;AACjG,MAAM,UAAU,4BAA4B,CAAC,SAAgC,EAAE,WAAqD,EAAE;IAMpI,OAAO;QACL,UAAU,EAAE,QAAQ,CAAC,UAAU,IAAI,gBAAgB;QACnD,KAAK,EAAE;YACL,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;YACvB,WAAW,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YACpC,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;SAClC;QACD,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE;QAC/D,OAAO,EAAE;YACP,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE;YAC7B,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;gBACnB,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;oBAAE,OAAO,KAAK,CAAC;gBACzD,IAAI,CAAC;oBAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;oBAAC,OAAO,IAAI,CAAC;gBAAC,CAAC;gBAC1C,OAAO,KAAK,EAAE,CAAC;oBAAC,OAAO,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;gBAAC,CAAC;YACvH,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/lifecycle/package-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-paths.d.ts","sourceRoot":"","sources":["../../src/lifecycle/package-paths.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5D;sFACsF;AACtF,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,EAAE,OAAO,EAAE,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,QAAQ,GAAE,YAAiB;CACnF;AAgHD,gFAAgF;AAChF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,IAAI,CAAC,yBAAyB,EAAE,YAAY,CAAC;8CA/F1C,MAAM,KAAG,MAAM;yCA2Cd,MAAM,aAAa,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC;EAwD9F"}

package/dist/lifecycle/package-paths.js

@@ -81,10 +81,10 @@ function buildModule(ports) {
     async function assertContainedOnDisk(packageRoot, entryPath) {
         const normalized = normalizePackageEntryPath(entryPath);
         const realRoot = await realpath(packageRoot);
+        // No separate lexical-escape check: normalizePackageEntryPath already refused absolute, drive-
+        // letter and `..`-leading paths, so resolving its relative output always stays under realRoot,
+        // and the filesystem-resolved check below would refuse any escape regardless.
         const lexicalCandidate = path.resolve(realRoot, normalized);
-        if (!isWithin(realRoot, lexicalCandidate)) {
-            throw new PackagePathViolation({ message: `package entry resolves outside the package root: '${entryPath}'` });
-        }
         let realCandidate;
         try {
             realCandidate = await realpath(lexicalCandidate);

package/dist/lifecycle/package-paths.js.map

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

package/dist/lifecycle/persistent-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistent-state.d.ts","sourceRoot":"","sources":["../../src/lifecycle/persistent-state.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5D,6FAA6F;AAC7F,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,yBAAyB,EAAE,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAM;uBAa5F,CAAC,YAAY;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE;qBAE3D,CAAC,YAAY;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE;uBACzE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;gCAClC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;wBACpD;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE;;;;EAQhD"}

package/dist/lifecycle/persistent-state.js.map

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

package/dist/lifecycle/ports.d.ts

@@ -4,7 +4,7 @@ import type { AgentPluginLayoutPort } from './layout.js';
 import type { AgentPluginDeliveryMode, InstalledAgentPlugin } from './types.js';
 /** Native Node filesystem ABI, narrowed to the operations used by lifecycle.
  * Inject instrumented fs/promises effects directly; native handles are never rewrapped. */
-export type FilesystemPort = Pick<typeof import('node:fs/promises'), 'chmod' | 'mkdir' | 'mkdtemp' | 'open' | 'readdir' | 'readFile' | 'rename' | 'rm' | 'rmdir' | 'stat' | 'realpath' | 'unlink'>;
+export type FilesystemPort = Pick<typeof import('node:fs/promises'), 'chmod' | 'mkdir' | 'mkdtemp' | 'open' | 'readdir' | 'readFile' | 'rename' | 'rm' | 'rmdir' | 'stat' | 'lstat' | 'realpath' | 'unlink'>;
 export type AgentPluginFetchPort = (required: {
     readonly url: string;
 }, optional?: RequestInit) => Promise<Response>;

package/dist/lifecycle/ports.d.ts.map

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

package/dist/lifecycle/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../src/lifecycle/ports.ts"],"names":[],"mappings":""}

package/dist/lifecycle/provider-contribution.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @file Plugin-contributed providers for `@jini-ai/core`'s `createProviderRegistry` (FROZEN CONTRACT,
+ * 2026-10-21). Lives here rather than in core because core cannot import agent-plugins (agent-plugins
+ * already depends on core). Defined on the one executable loader (`defineExecutablePluginContribution`)
+ * so a provider module passes the same gates as every other seam that runs plugin code: active
+ * plugin, bundled digest, contained `.mjs` path. No second loader.
+ *
+ * Every failure is a refusal line, never a throw: a broken or duplicate plugin provider must not
+ * crash boot (core/built-in registrations keep the registry's throwing policy).
+ */
+import { type ProviderDefinition, type ProviderRegistry } from '@jini-ai/core/provider-registry';
+import { type PluginContributionDefinition, type PluginContributionResult } from './contribution-loader.js';
+/** The minimum a provider manifest entry declares; a seam's parser may add fields. */
+export interface ProviderContributionDescriptor {
+    readonly id: string;
+    /** Plain-JS module inside the plugin root (`.mjs`); containment is checked on disk at import. */
+    readonly module: string;
+    readonly label?: string;
+}
+export interface LoadedProviderContribution<T> {
+    readonly contract: string;
+    readonly pluginId: string;
+    readonly definition: ProviderDefinition<T>;
+}
+/**
+ * Defines the contribution of providers for one contract (e.g. `mail`) from a host-chosen file.
+ * The id is checked before the module is imported, so a malformed entry never runs code.
+ * @param required.contract - Must equal the target registry's `contract`.
+ * @param required.filename - The file a plugin ships at its package root to contribute providers.
+ * @param required.parse - The seam's manifest parser.
+ * @param required.validate - The module export as a provider of this contract, or why not.
+ * @param optional - The loader's read/import recovery policy. Unlike the bare executable loader, absent
+ *   policies default to refusal lines (`could not be read`, `its module failed to load`) instead of
+ *   propagating the fault, so one unreadable manifest or throwing module never discards the healthy
+ *   contributions loaded alongside it. Pass `onReadError: () => []` to tolerate a missing manifest.
+ * @returns A definition for `loadPluginContributions`; executable, so activation is always required.
+ * @complexity O(1); each load is one contained import per declared provider.
+ */
+export declare function defineProviderContribution<D extends ProviderContributionDescriptor, T>(required: {
+    readonly contract: string;
+    readonly filename: string;
+    readonly parse: PluginContributionDefinition<D, LoadedProviderContribution<T>>['parse'];
+    readonly validate: (required: {
+        readonly exported: unknown;
+    }) => T | string;
+}, optional?: {
+    readonly onReadError?: PluginContributionDefinition<D, LoadedProviderContribution<T>>['onReadError'];
+    readonly importRefusalReason?: string;
+    readonly importErrorReason?: string;
+}): PluginContributionDefinition<D, LoadedProviderContribution<T>>;
+/**
+ * Offer loaded plugin providers to a registry and merge every refusal into one host-facing list:
+ * the loader's (gate, manifest, import, validation) first, then the registry's (contract mismatch,
+ * duplicate, invalid provider) in contribution order.
+ * @returns The ids the registry accepted and every refusal line; never throws.
+ * @complexity O(n) contributions.
+ */
+export declare function contributeProviders<T>(required: {
+    readonly registry: ProviderRegistry<T>;
+    readonly loaded: PluginContributionResult<LoadedProviderContribution<T>>;
+}, _optional?: Record<string, never>): {
+    readonly accepted: readonly string[];
+    readonly refusals: readonly string[];
+};
+//# sourceMappingURL=provider-contribution.d.ts.map

package/dist/lifecycle/provider-contribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-contribution.d.ts","sourceRoot":"","sources":["../../src/lifecycle/provider-contribution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAuB,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACtH,OAAO,EAC+B,KAAK,4BAA4B,EAAE,KAAK,wBAAwB,EACrG,MAAM,0BAA0B,CAAC;AAElC,sFAAsF;AACtF,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,iGAAiG;IACjG,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B,CAAC,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;CAC5C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,8BAA8B,EAAE,CAAC,EACpF,QAAQ,EAAE;IACR,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,4BAA4B,CAAC,CAAC,EAAE,0BAA0B,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACxF,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,KAAK,CAAC,GAAG,MAAM,CAAC;CAC7E,EACD,QAAQ,GAAE;IACR,QAAQ,CAAC,WAAW,CAAC,EAAE,4BAA4B,CAAC,CAAC,EAAE,0BAA0B,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IACrG,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAChC,GACL,4BAA4B,CAAC,CAAC,EAAE,0BAA0B,CAAC,CAAC,CAAC,CAAC,CAgChE;AAaD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,QAAQ,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,CAAA;CAAE,EAC9H,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAM,GACpC;IAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAShF"}

package/dist/lifecycle/provider-contribution.js

@@ -0,0 +1,93 @@
+/**
+ * @file Plugin-contributed providers for `@jini-ai/core`'s `createProviderRegistry` (FROZEN CONTRACT,
+ * 2026-10-21). Lives here rather than in core because core cannot import agent-plugins (agent-plugins
+ * already depends on core). Defined on the one executable loader (`defineExecutablePluginContribution`)
+ * so a provider module passes the same gates as every other seam that runs plugin code: active
+ * plugin, bundled digest, contained `.mjs` path. No second loader.
+ *
+ * Every failure is a refusal line, never a throw: a broken or duplicate plugin provider must not
+ * crash boot (core/built-in registrations keep the registry's throwing policy).
+ */
+import { PROVIDER_ID_PATTERN } from '@jini-ai/core/provider-registry';
+import { defineExecutablePluginContribution, } from './contribution-loader.js';
+/**
+ * Defines the contribution of providers for one contract (e.g. `mail`) from a host-chosen file.
+ * The id is checked before the module is imported, so a malformed entry never runs code.
+ * @param required.contract - Must equal the target registry's `contract`.
+ * @param required.filename - The file a plugin ships at its package root to contribute providers.
+ * @param required.parse - The seam's manifest parser.
+ * @param required.validate - The module export as a provider of this contract, or why not.
+ * @param optional - The loader's read/import recovery policy. Unlike the bare executable loader, absent
+ *   policies default to refusal lines (`could not be read`, `its module failed to load`) instead of
+ *   propagating the fault, so one unreadable manifest or throwing module never discards the healthy
+ *   contributions loaded alongside it. Pass `onReadError: () => []` to tolerate a missing manifest.
+ * @returns A definition for `loadPluginContributions`; executable, so activation is always required.
+ * @complexity O(1); each load is one contained import per declared provider.
+ */
+export function defineProviderContribution(required, optional = {}) {
+    const { contract } = required;
+    const refusal = ({ plugin, descriptor, reason }) => `${contract} provider '${String(descriptor.id)}' from '${plugin.pluginId}' was not loaded: ${reason}`;
+    const { filename } = required;
+    const executable = defineExecutablePluginContribution({
+        filename, contribution: `${contract} providers`, parse: guardedParse({ parse: required.parse }),
+        modulePath: ({ descriptor }) => descriptor.module, validate: required.validate, refusal,
+    }, {
+        onReadError: optional.onReadError ?? (({ plugin }) => [`${contract} providers from '${plugin.pluginId}' were not loaded: ${filename} could not be read`]),
+        importErrorReason: optional.importErrorReason ?? 'its module failed to load',
+        ...(optional.importRefusalReason === undefined ? {} : { importRefusalReason: optional.importRefusalReason }),
+    });
+    const loadOne = async (input) => {
+        const { plugin, descriptor } = input;
+        if (typeof descriptor.id !== 'string' || !PROVIDER_ID_PATTERN.test(descriptor.id)) {
+            return refusal({ plugin, descriptor, reason: `its id must match ${PROVIDER_ID_PATTERN.source}` });
+        }
+        const loaded = await executable.load(input);
+        if (typeof loaded === 'string')
+            return loaded;
+        const { id, label } = descriptor;
+        return { contract, pluginId: loaded.pluginId, definition: { id, provider: loaded.module, ...(label === undefined ? {} : { label }) } };
+    };
+    return {
+        ...executable,
+        // Per-descriptor boundary: a hostile descriptor (e.g. a throwing getter) becomes one refusal and
+        // the loader moves on to the next declaration.
+        load: async (input) => {
+            try {
+                return await loadOne(input);
+            }
+            catch {
+                return `${contract} provider from '${input.plugin.pluginId}' was not loaded: its declaration could not be read`;
+            }
+        },
+    };
+}
+/** A throwing seam parser is a refused manifest, not a boot fault. */
+function guardedParse(required, _optional = {}) {
+    return (input) => {
+        try {
+            return required.parse(input);
+        }
+        catch {
+            return { ok: false, reason: 'its parser failed' };
+        }
+    };
+}
+/**
+ * Offer loaded plugin providers to a registry and merge every refusal into one host-facing list:
+ * the loader's (gate, manifest, import, validation) first, then the registry's (contract mismatch,
+ * duplicate, invalid provider) in contribution order.
+ * @returns The ids the registry accepted and every refusal line; never throws.
+ * @complexity O(n) contributions.
+ */
+export function contributeProviders(required, _optional = {}) {
+    const { registry, loaded } = required;
+    const before = registry.refusals().length;
+    const accepted = [];
+    for (const item of loaded.items) {
+        if (registry.contribute({ definition: item.definition, pluginId: item.pluginId, contract: item.contract }))
+            accepted.push(item.definition.id);
+    }
+    const registryRefusals = registry.refusals().slice(before).map(refusal => refusal.message);
+    return { accepted, refusals: [...loaded.refusals, ...registryRefusals] };
+}
+//# sourceMappingURL=provider-contribution.js.map