npm - @unbrained/pm-cli - Versions diffs - 2026.7.19 → 2026.7.20 - Mend

@unbrained/pm-cli 2026.7.19 → 2026.7.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (600) hide show

package/dist/sdk/extension/describe.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"describe.js","sources":["sdk/extension/describe.ts"],"sourceRoot":"/","sourcesContent":["/*\n @module sdk/extension/describe\n \n Builds the `pm extension describe` / `pm package describe` payload: a flat,\n * by-name map of every surface each loaded extension registered.\n \n The SDK already ships {@link describeExtensionActivation} -- the `describe`\n * (enumerate-all) verb that complements the `assert` (verify-one) and `run`\n * (invoke-one) testing helpers -- but until now it was reachable only from a test\n * that hand-built an {@link ExtensionActivationResult}. This module is the thin\n * orchestration that lets an agent at the CLI (or over MCP) ask \"what does this\n * installed extension add to my context?\" in one call, instead of stitching\n * together `doctor` (errors), `manage` (update metadata), and a manifest read.\n \n It is intentionally pure: the caller performs the load+activate cycle (exactly\n * as `explore`/`doctor` already do) and hands the results here, so the same\n * builder is trivially unit-testable against synthetic activations.\n /\nimport {\n describeExtensionActivation,\n type ExtensionActivationSummary,\n} from \"../../core/extensions/activation-summary.js\";\nimport { renderExtensionSurfaceMarkdown } from \"../../core/extensions/activation-summary-markdown.js\";\nimport type {\n ExtensionActivationResult,\n ExtensionLayer,\n ExtensionLoadResult,\n} from \"../../core/extensions/loader.js\";\nimport { normalizeExtensionNameForMatch } from \"./shared.js\";\n\n/* Runtime state of a described extension. `ok` loaded and activated cleanly, `failed` loaded but threw during `activate`, and `not_loaded` failed to import at all -- the latter two register nothing, so their `surfaces` are empty and the status explains why (rather than implying the extension contributes nothing). /\nexport type ExtensionDescribeActivationStatus = \"ok\" \| \"failed\" \| \"not_loaded\";\n\n/\n One extension's contribution to the workspace: its identity plus the\n * {@link ExtensionActivationSummary} of every surface it registered.\n \n `surfaces` is matched by extension name (mirroring\n * {@link describeExtensionActivation}'s name filter), so when the same name is\n * loaded in both the project and global layers each entry reflects that name's\n * combined surfaces -- the `layer`/`version` fields still distinguish the\n * physical entries.\n /\nexport interface ExtensionSurfaceDescription {\n /* Value that configures or reports name for this contract. /\n name: string;\n /* Value that configures or reports layer for this contract. /\n layer: ExtensionLayer;\n /* Value that configures or reports version for this contract. /\n version: string;\n /* Lifecycle state reported for activationthe record. /\n activation_status: ExtensionDescribeActivationStatus;\n /* Value that configures or reports surfaces for this contract. /\n surfaces: ExtensionActivationSummary;\n}\n\n/\n Result of {@link buildExtensionDescribeResult}: the per-extension surface maps\n * plus a deduplicated `union` across the described set. `target` echoes the\n * requested name filter (or `null` for the whole workspace) and `total` counts\n * the described entries so callers need not re-measure `extensions`.\n /\nexport interface ExtensionDescribeResult {\n /* Value that configures or reports target for this contract. /\n target: string \| null;\n /* Value that configures or reports total for this contract. /\n total: number;\n /* Value that configures or reports extensions for this contract. /\n extensions: ExtensionSurfaceDescription[];\n /* Value that configures or reports union for this contract. /\n union: ExtensionActivationSummary;\n}\n\n/* Compose a collision-free identity key for an extension from its layer and normalized name. The two parts are joined with a colon; the layer prefix is always a colon-free enum value, so distinct (layer, name) pairs never collide even when a name itself contains a colon. /\nfunction layerNameKey(layer: ExtensionLayer, name: string): string {\n return `${layer}:${normalizeExtensionNameForMatch(name)}`;\n}\n\n/\n Summarize, by name, every registration surface the loaded extensions exercised.\n \n Walks `loadResult.loaded` (annotating each with `failed` when its layer+name is\n * in `activationResult.failed`) and `loadResult.failed` (as `not_loaded`), sorts\n * the entries by name then layer for deterministic output, and attaches each\n * extension's {@link describeExtensionActivation} summary. When `target` is\n * provided only the case-insensitively matching extensions are described and the\n * `union` is scoped to that resolved name set; otherwise every loaded extension contributes.\n * A target may name either the extension itself or its source npm package\n * (`source_package`), so agents can reuse the `package_name` values surfaced by\n * `pm extension list` / install discovery without a second lookup. An unmatched\n * `target` yields an empty `extensions` array -- the caller decides whether that\n * is a not-found error.\n /\nexport function buildExtensionDescribeResult(\n target: string \| undefined,\n loadResult: ExtensionLoadResult,\n activationResult: ExtensionActivationResult,\n): ExtensionDescribeResult {\n const activationFailedKeys = new Set(\n activationResult.failed.map((entry) =>\n layerNameKey(entry.layer, entry.name),\n ),\n );\n const candidates: ExtensionSurfaceDescription[] = [\n ...loadResult.loaded.map((entry) => ({\n name: entry.name,\n layer: entry.layer,\n version: entry.version,\n activation_status: activationFailedKeys.has(\n layerNameKey(entry.layer, entry.name),\n )\n ? (\"failed\" as const)\n : (\"ok\" as const),\n surfaces: describeExtensionActivation(activationResult, {\n extensionName: entry.name,\n }),\n })),\n ...loadResult.failed.map((entry) => ({\n name: entry.name,\n layer: entry.layer,\n version: \"unknown\",\n activation_status: \"not_loaded\" as const,\n surfaces: describeExtensionActivation(activationResult, {\n extensionName: entry.name,\n }),\n })),\n ].sort(\n (left, right) =>\n left.name.localeCompare(right.name) \|\|\n left.layer.localeCompare(right.layer),\n );\n\n const normalizedTarget =\n typeof target === \"string\" ? normalizeExtensionNameForMatch(target) : null;\n const matchedNames =\n normalizedTarget === null\n ? null\n : new Set(\n loadResult.loaded\n .filter(\n (entry) =>\n normalizeExtensionNameForMatch(entry.name) ===\n normalizedTarget \|\|\n (typeof entry.source_package === \"string\" &&\n normalizeExtensionNameForMatch(entry.source_package) ===\n normalizedTarget),\n )\n .map((entry) => normalizeExtensionNameForMatch(entry.name))\n .concat(normalizedTarget),\n );\n const extensions =\n matchedNames === null\n ? candidates\n : candidates.filter((entry) =>\n matchedNames.has(normalizeExtensionNameForMatch(entry.name)),\n );\n const unionOptions =\n matchedNames === null ? {} : { extensionNames: [...matchedNames] };\n\n return {\n target: typeof target === \"string\" ? target.trim() : null,\n total: extensions.length,\n extensions,\n union: describeExtensionActivation(activationResult, unionOptions),\n };\n}\n\n/\n Human-readable label for each {@link ExtensionDescribeActivationStatus}, used\n * in the Markdown per-extension heading so a reader sees why an entry has no\n * surfaces (activation failed / never loaded) rather than assuming it\n * contributes nothing.\n /\nconst ACTIVATION_STATUS_LABELS: Record<\n ExtensionDescribeActivationStatus,\n string\n> = {\n ok: \"loaded\",\n failed: \"activation failed\",\n not_loaded: \"not loaded\",\n};\n\n/\n Render an {@link ExtensionDescribeResult} as a Markdown reference document: a\n * top-level title and scope line, one section per described extension (titled\n * with its identity and activation status), and — only when more than one\n * extension was described — a final union section spanning them all. Each\n * extension and the union are rendered with the shared\n * {@link renderExtensionSurfaceMarkdown} primitive at heading level 2, so the\n * document nests cleanly under the level-1 title.\n \n `noun` is the lifecycle vocabulary (`\"extension\"` or `\"package\"`) so the prose\n * matches the command the agent invoked. When no extensions match (an unmatched\n * target is already a not-found error upstream, so this is the \"nothing loaded\"\n * case) the document is the title plus a single explanatory note.\n */\nexport function renderExtensionDescribeMarkdown(\n result: ExtensionDescribeResult,\n noun: string,\n): string {\n const titleNoun = `${noun[0]!.toUpperCase()}${noun.slice(1)}`;\n const lines = [`# ${titleNoun} surface reference`, \"\"];\n lines.push(\n result.target === null\n ? `Scope: all loaded ${noun}s`\n : `Scope: \\`${result.target}\\``,\n );\n lines.push(\n `Described: ${result.total} ${noun}${result.total === 1 ? \"\" : \"s\"}`,\n \"\",\n );\n\n if (result.extensions.length === 0) {\n lines.push(`_No ${noun}s are loaded._`, \"\");\n return `${lines.join(\"\\n\").trimEnd()}\\n`;\n }\n\n for (const entry of result.extensions) {\n const title = `${entry.name} (${entry.layer} v${entry.version}, ${ACTIVATION_STATUS_LABELS[entry.activation_status]})`;\n // renderExtensionSurfaceMarkdown already ends with a newline; the join adds a\n // single blank line between sections, so no extra \"\" separator is pushed.\n lines.push(\n renderExtensionSurfaceMarkdown(entry.surfaces, {\n title,\n headingLevel: 2,\n }),\n );\n }\n\n if (result.extensions.length > 1) {\n lines.push(\n renderExtensionSurfaceMarkdown(result.union, {\n title: `Union across all described ${noun}s`,\n headingLevel: 2,\n }),\n );\n }\n\n return `${lines.join(\"\\n\").trimEnd()}\\n`;\n}\n"],"names":[],"mappings":"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","debugId":"fecfae4c-ebb9-5dad-abf6-4c4b147da177"}
1	+ {"version":3,"file":"describe.js","sources":["sdk/extension/describe.ts"],"sourceRoot":"/","sourcesContent":["/*\n @module sdk/extension/describe\n \n Builds the `pm extension describe` / `pm package describe` payload: a flat,\n * by-name map of every surface each loaded extension registered.\n \n The SDK already ships {@link describeExtensionActivation} -- the `describe`\n * (enumerate-all) verb that complements the `assert` (verify-one) and `run`\n * (invoke-one) testing helpers -- but until now it was reachable only from a test\n * that hand-built an {@link ExtensionActivationResult}. This module is the thin\n * orchestration that lets an agent at the CLI (or over MCP) ask \"what does this\n * installed extension add to my context?\" in one call, instead of stitching\n * together `doctor` (errors), `manage` (update metadata), and a manifest read.\n \n It is intentionally pure: the caller performs the load+activate cycle (exactly\n * as `explore`/`doctor` already do) and hands the results here, so the same\n * builder is trivially unit-testable against synthetic activations.\n /\nimport {\n describeExtensionActivation,\n type ExtensionActivationSummary,\n} from \"../../core/extensions/activation-summary.js\";\nimport { renderExtensionSurfaceMarkdown } from \"../../core/extensions/activation-summary-markdown.js\";\nimport type {\n ExtensionActivationResult,\n ExtensionLayer,\n ExtensionLoadResult,\n} from \"../../core/extensions/loader.js\";\nimport { normalizeExtensionNameForMatch } from \"./shared.js\";\n\n/* Runtime state of a described extension. `ok` loaded and activated cleanly, `failed` loaded but threw during `activate`, and `not_loaded` failed to import at all -- the latter two register nothing, so their `surfaces` are empty and the status explains why (rather than implying the extension contributes nothing). /\nexport type ExtensionDescribeActivationStatus = \"ok\" \| \"failed\" \| \"not_loaded\";\n\n/\n One extension's contribution to the workspace: its identity plus the\n * {@link ExtensionActivationSummary} of every surface it registered.\n \n `surfaces` is matched by extension name (mirroring\n * {@link describeExtensionActivation}'s name filter), so when the same name is\n * loaded in both the project and global layers each entry reflects that name's\n * combined surfaces -- the `layer`/`version` fields still distinguish the\n * physical entries.\n /\nexport interface ExtensionSurfaceDescription {\n /* Value that configures or reports name for this contract. /\n name: string;\n /* Value that configures or reports layer for this contract. /\n layer: ExtensionLayer;\n /* Value that configures or reports version for this contract. /\n version: string;\n /* Activation outcome reported for this extension. /\n activation_status: ExtensionDescribeActivationStatus;\n /* Value that configures or reports surfaces for this contract. /\n surfaces: ExtensionActivationSummary;\n}\n\n/\n Result of {@link buildExtensionDescribeResult}: the per-extension surface maps\n * plus a deduplicated `union` across the described set. `target` echoes the\n * requested name filter (or `null` for the whole workspace) and `total` counts\n * the described entries so callers need not re-measure `extensions`.\n /\nexport interface ExtensionDescribeResult {\n /* Value that configures or reports target for this contract. /\n target: string \| null;\n /* Value that configures or reports total for this contract. /\n total: number;\n /* Value that configures or reports extensions for this contract. /\n extensions: ExtensionSurfaceDescription[];\n /* Value that configures or reports union for this contract. /\n union: ExtensionActivationSummary;\n}\n\n/* Compose a collision-free identity key for an extension from its layer and normalized name. The two parts are joined with a colon; the layer prefix is always a colon-free enum value, so distinct (layer, name) pairs never collide even when a name itself contains a colon. /\nfunction layerNameKey(layer: ExtensionLayer, name: string): string {\n return `${layer}:${normalizeExtensionNameForMatch(name)}`;\n}\n\n/\n Summarize, by name, every registration surface the loaded extensions exercised.\n \n Walks `loadResult.loaded` (annotating each with `failed` when its layer+name is\n * in `activationResult.failed`) and `loadResult.failed` (as `not_loaded`), sorts\n * the entries by name then layer for deterministic output, and attaches each\n * extension's {@link describeExtensionActivation} summary. When `target` is\n * provided only the case-insensitively matching extensions are described and the\n * `union` is scoped to that resolved name set; otherwise every loaded extension contributes.\n * A target may name either the extension itself or its source npm package\n * (`source_package`), so agents can reuse the `package_name` values surfaced by\n * `pm extension list` / install discovery without a second lookup. An unmatched\n * `target` yields an empty `extensions` array -- the caller decides whether that\n * is a not-found error.\n /\nexport function buildExtensionDescribeResult(\n target: string \| undefined,\n loadResult: ExtensionLoadResult,\n activationResult: ExtensionActivationResult,\n): ExtensionDescribeResult {\n const activationFailedKeys = new Set(\n activationResult.failed.map((entry) =>\n layerNameKey(entry.layer, entry.name),\n ),\n );\n const candidates: ExtensionSurfaceDescription[] = [\n ...loadResult.loaded.map((entry) => ({\n name: entry.name,\n layer: entry.layer,\n version: entry.version,\n activation_status: activationFailedKeys.has(\n layerNameKey(entry.layer, entry.name),\n )\n ? (\"failed\" as const)\n : (\"ok\" as const),\n surfaces: describeExtensionActivation(activationResult, {\n extensionName: entry.name,\n }),\n })),\n ...loadResult.failed.map((entry) => ({\n name: entry.name,\n layer: entry.layer,\n version: \"unknown\",\n activation_status: \"not_loaded\" as const,\n surfaces: describeExtensionActivation(activationResult, {\n extensionName: entry.name,\n }),\n })),\n ].sort(\n (left, right) =>\n left.name.localeCompare(right.name) \|\|\n left.layer.localeCompare(right.layer),\n );\n\n const normalizedTarget =\n typeof target === \"string\" ? normalizeExtensionNameForMatch(target) : null;\n const matchedNames =\n normalizedTarget === null\n ? null\n : new Set(\n loadResult.loaded\n .filter(\n (entry) =>\n normalizeExtensionNameForMatch(entry.name) ===\n normalizedTarget \|\|\n (typeof entry.source_package === \"string\" &&\n normalizeExtensionNameForMatch(entry.source_package) ===\n normalizedTarget),\n )\n .map((entry) => normalizeExtensionNameForMatch(entry.name))\n .concat(normalizedTarget),\n );\n const extensions =\n matchedNames === null\n ? candidates\n : candidates.filter((entry) =>\n matchedNames.has(normalizeExtensionNameForMatch(entry.name)),\n );\n const unionOptions =\n matchedNames === null ? {} : { extensionNames: [...matchedNames] };\n\n return {\n target: typeof target === \"string\" ? target.trim() : null,\n total: extensions.length,\n extensions,\n union: describeExtensionActivation(activationResult, unionOptions),\n };\n}\n\n/\n Human-readable label for each {@link ExtensionDescribeActivationStatus}, used\n * in the Markdown per-extension heading so a reader sees why an entry has no\n * surfaces (activation failed / never loaded) rather than assuming it\n * contributes nothing.\n /\nconst ACTIVATION_STATUS_LABELS: Record<\n ExtensionDescribeActivationStatus,\n string\n> = {\n ok: \"loaded\",\n failed: \"activation failed\",\n not_loaded: \"not loaded\",\n};\n\n/\n Render an {@link ExtensionDescribeResult} as a Markdown reference document: a\n * top-level title and scope line, one section per described extension (titled\n * with its identity and activation status), and — only when more than one\n * extension was described — a final union section spanning them all. Each\n * extension and the union are rendered with the shared\n * {@link renderExtensionSurfaceMarkdown} primitive at heading level 2, so the\n * document nests cleanly under the level-1 title.\n \n `noun` is the lifecycle vocabulary (`\"extension\"` or `\"package\"`) so the prose\n * matches the command the agent invoked. When no extensions match (an unmatched\n * target is already a not-found error upstream, so this is the \"nothing loaded\"\n * case) the document is the title plus a single explanatory note.\n */\nexport function renderExtensionDescribeMarkdown(\n result: ExtensionDescribeResult,\n noun: string,\n): string {\n const titleNoun = `${noun[0]!.toUpperCase()}${noun.slice(1)}`;\n const lines = [`# ${titleNoun} surface reference`, \"\"];\n lines.push(\n result.target === null\n ? `Scope: all loaded ${noun}s`\n : `Scope: \\`${result.target}\\``,\n );\n lines.push(\n `Described: ${result.total} ${noun}${result.total === 1 ? \"\" : \"s\"}`,\n \"\",\n );\n\n if (result.extensions.length === 0) {\n lines.push(`_No ${noun}s are loaded._`, \"\");\n return `${lines.join(\"\\n\").trimEnd()}\\n`;\n }\n\n for (const entry of result.extensions) {\n const title = `${entry.name} (${entry.layer} v${entry.version}, ${ACTIVATION_STATUS_LABELS[entry.activation_status]})`;\n // renderExtensionSurfaceMarkdown already ends with a newline; the join adds a\n // single blank line between sections, so no extra \"\" separator is pushed.\n lines.push(\n renderExtensionSurfaceMarkdown(entry.surfaces, {\n title,\n headingLevel: 2,\n }),\n );\n }\n\n if (result.extensions.length > 1) {\n lines.push(\n renderExtensionSurfaceMarkdown(result.union, {\n title: `Union across all described ${noun}s`,\n headingLevel: 2,\n }),\n );\n }\n\n return `${lines.join(\"\\n\").trimEnd()}\\n`;\n}\n"],"names":[],"mappings":"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","debugId":"127aa7ea-f1a6-57e6-85da-837f09670dc4"}

package/dist/sdk/extension/install-runtime.js CHANGED Viewed

@@ -4,7 +4,7 @@
  * Provides cross-platform extension copy safety and owner-bound install locks.
  */
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="ef5442ae-3385-544e-889f-d4d78ee473c1")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1ced281f-c8b0-5424-a9d7-68c3512b835e")}catch(e){}}();
 import { randomUUID } from "node:crypto";
 import fs from "node:fs/promises";
 import os from "node:os";
@@ -84,7 +84,9 @@ export const copyExtensionDirectoryWithoutSelfNesting = async (sourceDirectory,
         });
         return;
     }
-    const systemTempDirectory = path.resolve(temporaryDirectory);
+    const systemTempDirectory = await fs
+        .realpath(path.resolve(temporaryDirectory))
+        .catch(() => resolveCanonicalExtensionInstallDestination(temporaryDirectory));
     const stagingBase = isPathWithinDirectory(canonicalSource, systemTempDirectory)
         ? path.dirname(canonicalSource)
         : systemTempDirectory;
@@ -266,4 +268,4 @@ export const withExtensionInstallLock = async (settingsRoot, destinationDirector
     }
 };
 //# sourceMappingURL=install-runtime.js.map
-//# debugId=ef5442ae-3385-544e-889f-d4d78ee473c1
+//# debugId=1ced281f-c8b0-5424-a9d7-68c3512b835e

package/dist/sdk/extension/install-runtime.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"install-runtime.js","sources":["sdk/extension/install-runtime.ts"],"sourceRoot":"/","sourcesContent":["/*\n @module sdk/extension/install-runtime\n \n Provides cross-platform extension copy safety and owner-bound install locks.\n /\nimport { randomUUID } from \"node:crypto\";\nimport fs from \"node:fs/promises\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { isPathWithinDirectory } from \"../../core/fs/path-utils.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\n\nconst EXTENSION_INSTALL_COPY_ATTEMPTS = 3;\nconst EXTENSION_INSTALL_LOCK_ATTEMPTS = 120;\nconst EXTENSION_INSTALL_LOCK_DELAY_MS = 250;\nconst EXTENSION_INSTALL_LOCK_STALE_MS = 120_000;\nconst RETRIABLE_EXTENSION_INSTALL_COPY_CODES = new Set([\n \"EEXIST\",\n \"ENOTEMPTY\",\n \"ENOENT\",\n]);\n\ninterface ExtensionInstallLockOwner {\n pid: number;\n token: string;\n created_at: string;\n destination: string;\n}\n\n/* Retry and lease timing overrides for one extension install lock. /\nexport interface ExtensionInstallLockOptions {\n /* Maximum lock-acquisition attempts. /\n attempts?: number;\n /* Delay between contended acquisition attempts. /\n delay_ms?: number;\n /* Age after which an unchanged owner lease can be reclaimed. /\n stale_ms?: number;\n /* Lease heartbeat interval while the operation runs. /\n heartbeat_ms?: number;\n}\n\n/* Return an errno-style code from an unknown failure when one is present. /\nconst errnoCode = (error: unknown): unknown =>\n typeof error === \"object\" && error !== null && \"code\" in error\n ? (error as { code?: unknown }).code\n : undefined;\n\n/* Identify transient copy races that are safe to retry during extension installation. /\nexport const isRetriableExtensionInstallCopyError = (error: unknown): boolean =>\n RETRIABLE_EXTENSION_INSTALL_COPY_CODES.has(String(errnoCode(error)));\n\n/* Test an unknown failure against one expected errno-style code. /\nexport const isErrnoCode = (error: unknown, code: string): boolean =>\n errnoCode(error) === code;\n\n/* Delay an extension filesystem retry without blocking the event loop. /\nconst sleep = (ms: number): Promise<void> =>\n new Promise((resolve) => {\n setTimeout(resolve, ms);\n });\n\n/* Ensure an installed extension carries an ESM package boundary marker. /\nexport const ensureExtensionModuleTypeMarker = async (\n destinationDirectory: string,\n): Promise<void> => {\n const markerPath = path.join(destinationDirectory, \"package.json\");\n if (await pathExists(markerPath)) {\n return;\n }\n await fs.writeFile(\n markerPath,\n `${JSON.stringify({ type: \"module\" }, null, 2)}\\n`,\n \"utf8\",\n );\n};\n\n/* Resolve a possibly partial extension destination through every existing symlink segment. /\nexport const resolveCanonicalExtensionInstallDestination = async (\n destinationDirectory: string,\n): Promise<string> => {\n const resolvedDestination = path.resolve(destinationDirectory);\n const destinationParent = path.dirname(resolvedDestination);\n const destinationRoot = path.parse(destinationParent).root;\n let canonicalDestinationParent = await fs\n .realpath(destinationRoot)\n .catch(() => destinationRoot);\n const relativeDestinationParent = path.relative(\n destinationRoot,\n destinationParent,\n );\n const destinationSegments =\n relativeDestinationParent === \"\"\n ? []\n : relativeDestinationParent.split(path.sep);\n for (const [index, segment] of destinationSegments.entries()) {\n const candidate = path.join(canonicalDestinationParent, segment);\n try {\n canonicalDestinationParent = await fs.realpath(candidate);\n } catch {\n canonicalDestinationParent = path.join(\n canonicalDestinationParent,\n ...destinationSegments.slice(index),\n );\n break;\n }\n }\n return path.join(\n canonicalDestinationParent,\n path.basename(resolvedDestination),\n );\n};\n\n/* Copy an extension without recursively copying a destination nested below its source. /\nexport const copyExtensionDirectoryWithoutSelfNesting = async (\n sourceDirectory: string,\n destinationDirectory: string,\n copyDirectory: typeof fs.cp,\n temporaryDirectory = os.tmpdir(),\n): Promise<void> => {\n const resolvedSource = path.resolve(sourceDirectory);\n const canonicalSource = await fs\n .realpath(resolvedSource)\n .catch(() => resolvedSource);\n const canonicalDestination =\n await resolveCanonicalExtensionInstallDestination(destinationDirectory);\n if (canonicalSource === canonicalDestination) {\n return;\n }\n if (!isPathWithinDirectory(canonicalSource, canonicalDestination)) {\n await copyDirectory(sourceDirectory, destinationDirectory, {\n recursive: true,\n force: true,\n });\n return;\n }\n\n const systemTempDirectory = path.resolve(temporaryDirectory);\n const stagingBase = isPathWithinDirectory(\n canonicalSource,\n systemTempDirectory,\n )\n ? path.dirname(canonicalSource)\n : systemTempDirectory;\n if (isPathWithinDirectory(canonicalSource, stagingBase)) {\n throw new PmCliError(\n `Extension source \"${sourceDirectory}\" contains its install destination and no external staging directory is available. Install a narrower package directory instead.`,\n EXIT_CODE.USAGE,\n { code: \"extension_install_source_contains_destination\" },\n );\n }\n const stagingRoot = await fs.mkdtemp(\n path.join(stagingBase, \"pm-extension-copy-\"),\n );\n const stagedDirectory = path.join(stagingRoot, \"extension\");\n try {\n await copyDirectory(sourceDirectory, stagedDirectory, {\n recursive: true,\n force: true,\n });\n await copyDirectory(stagedDirectory, destinationDirectory, {\n recursive: true,\n force: true,\n });\n } finally {\n await fs.rm(stagingRoot, { recursive: true, force: true });\n }\n};\n\n/* Copy one extension directory with bounded transient-race retries. /\nexport const copyExtensionDirectoryForInstall = async (\n sourceDirectory: string,\n destinationDirectory: string,\n copyDirectory: typeof fs.cp = fs.cp,\n): Promise<void> => {\n for (\n let attempt = 1;\n attempt <= EXTENSION_INSTALL_COPY_ATTEMPTS;\n attempt += 1\n ) {\n try {\n await fs.rm(destinationDirectory, { recursive: true, force: true });\n await copyExtensionDirectoryWithoutSelfNesting(\n sourceDirectory,\n destinationDirectory,\n copyDirectory,\n );\n return;\n } catch (error: unknown) {\n if (\n !isRetriableExtensionInstallCopyError(error) \|\|\n attempt === EXTENSION_INSTALL_COPY_ATTEMPTS\n ) {\n throw error;\n }\n await sleep(EXTENSION_INSTALL_LOCK_DELAY_MS);\n }\n }\n};\n\n/* Read the unique owner token recorded for one extension scope lock. /\nconst readExtensionInstallLockOwnerToken = async (\n lockPath: string,\n): Promise<string \| null> => {\n let ownerContents: string;\n try {\n ownerContents = await fs.readFile(\n path.join(lockPath, \"owner.json\"),\n \"utf8\",\n );\n } catch (error: unknown) {\n if (!isErrnoCode(error, \"ENOENT\")) throw error;\n return null;\n }\n let parsed: unknown;\n try {\n parsed = JSON.parse(ownerContents);\n } catch {\n return null;\n }\n if (typeof parsed !== \"object\" \|\| parsed === null \|\| !(\"token\" in parsed)) {\n return null;\n }\n const token = (parsed as { token?: unknown }).token;\n return typeof token === \"string\" && token.length > 0 ? token : null;\n};\n\n/* Remove an extension scope lock only while its persisted owner token still matches. /\nconst removeExtensionInstallLockIfOwned = async (\n lockPath: string,\n ownerToken: string,\n): Promise<boolean> => {\n const currentOwnerToken = await readExtensionInstallLockOwnerToken(lockPath);\n if (currentOwnerToken !== ownerToken) {\n return false;\n }\n await fs.rm(lockPath, { recursive: true, force: true });\n return true;\n};\n\n/* Reclaim an expired extension scope lock when its persisted owner remains unchanged. /\nconst reclaimStaleExtensionInstallLock = async (\n lockPath: string,\n staleMs: number,\n): Promise<boolean> => {\n let stat: Awaited<ReturnType<typeof fs.stat>>;\n try {\n stat = await fs.stat(lockPath);\n } catch {\n return false;\n }\n if (Date.now() - stat.mtimeMs <= staleMs) {\n return false;\n }\n const staleOwnerToken = await readExtensionInstallLockOwnerToken(lockPath);\n if (staleOwnerToken === null) {\n await fs.rm(lockPath, { recursive: true, force: true });\n return true;\n }\n return removeExtensionInstallLockIfOwned(lockPath, staleOwnerToken);\n};\n\n/* Start an owner-bound lease heartbeat and return an async stop barrier. /\nconst startExtensionInstallLockHeartbeat = (\n lockPath: string,\n ownerToken: string,\n intervalMs: number,\n): (() => Promise<void>) => {\n let heartbeat = Promise.resolve();\n const timer = setInterval(() => {\n heartbeat = heartbeat\n .then(async () => {\n if (\n (await readExtensionInstallLockOwnerToken(lockPath)) !== ownerToken\n ) {\n return;\n }\n const heartbeatAt = new Date();\n await fs.utimes(lockPath, heartbeatAt, heartbeatAt);\n })\n .catch(() => undefined);\n }, intervalMs);\n timer.unref();\n return async () => {\n clearInterval(timer);\n await heartbeat;\n };\n};\n\n/* Create one owner-bound extension install lock, removing partial state on failure. /\nconst createExtensionInstallLock = async (\n lockPath: string,\n owner: ExtensionInstallLockOwner,\n): Promise<void> => {\n await fs.mkdir(lockPath);\n try {\n await fs.writeFile(\n path.join(lockPath, \"owner.json\"),\n `${JSON.stringify(owner, null, 2)}\\n`,\n \"utf8\",\n );\n } catch (error: unknown) {\n await fs.rm(lockPath, { recursive: true, force: true }).catch(() => {});\n throw error;\n }\n};\n\n/* Retry owner-bound extension lock acquisition while reclaiming stale owners. /\nconst acquireExtensionInstallLock = async (\n lockPath: string,\n owner: ExtensionInstallLockOwner,\n attempts: number,\n delayMs: number,\n staleMs: number,\n): Promise<boolean> => {\n for (let attempt = 1; attempt <= attempts; attempt += 1) {\n try {\n await createExtensionInstallLock(lockPath, owner);\n return true;\n } catch (error: unknown) {\n if (!isErrnoCode(error, \"EEXIST\")) {\n throw error;\n }\n if (await reclaimStaleExtensionInstallLock(lockPath, staleMs)) {\n attempt -= 1;\n } else {\n await sleep(delayMs);\n }\n }\n }\n return false;\n};\n\n/* Run one operation under an owner-bound extension install lock and heartbeat lease. */\nexport const withExtensionInstallLock = async <T>(\n settingsRoot: string,\n destinationDirectoryName: string,\n run: () => Promise<T>,\n options?: ExtensionInstallLockOptions,\n): Promise<T> => {\n const lockRoot = path.join(\n settingsRoot,\n \"runtime\",\n \"extension-install-locks\",\n );\n const lockPath = path.join(lockRoot, \"scope.lock\");\n await fs.mkdir(lockRoot, { recursive: true });\n const {\n attempts: rawAttempts = EXTENSION_INSTALL_LOCK_ATTEMPTS,\n delay_ms: rawDelayMs = EXTENSION_INSTALL_LOCK_DELAY_MS,\n stale_ms: rawStaleMs = EXTENSION_INSTALL_LOCK_STALE_MS,\n heartbeat_ms: rawHeartbeatMs,\n } = options ?? {};\n if (\n ![rawAttempts, rawDelayMs, rawStaleMs, rawHeartbeatMs]\n .filter((value): value is number => value !== undefined)\n .every(Number.isFinite)\n ) {\n throw new PmCliError(\n \"Extension install lock timings must be finite numbers.\",\n EXIT_CODE.USAGE,\n );\n }\n const attempts = Math.max(1, Math.floor(rawAttempts));\n const delayMs = Math.max(0, Math.floor(rawDelayMs));\n const staleMs = Math.floor(rawStaleMs);\n const heartbeatMs = Math.floor(rawHeartbeatMs ?? staleMs / 3);\n if (staleMs <= 0 \|\| heartbeatMs <= 0 \|\| heartbeatMs >= staleMs) {\n throw new PmCliError(\n \"Extension install lock timings require stale_ms > 0 and 0 < heartbeat_ms < stale_ms.\",\n EXIT_CODE.USAGE,\n );\n }\n const owner: ExtensionInstallLockOwner = {\n pid: process.pid,\n token: randomUUID(),\n created_at: nowIso(),\n destination: destinationDirectoryName,\n };\n const acquired = await acquireExtensionInstallLock(\n lockPath,\n owner,\n attempts,\n delayMs,\n staleMs,\n );\n if (!acquired) {\n throw new PmCliError(\n `Timed out waiting for extension install lock for \"${destinationDirectoryName}\".`,\n EXIT_CODE.CONFLICT,\n );\n }\n\n const stopHeartbeat = startExtensionInstallLockHeartbeat(\n lockPath,\n owner.token,\n heartbeatMs,\n );\n try {\n return await run();\n } finally {\n await stopHeartbeat();\n await removeExtensionInstallLockIfOwned(lockPath, owner.token).catch(\n () => false,\n );\n }\n};\n"],"names":[],"mappings":"AAAA;;;;GAIG;;;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAEnD,MAAM,+BAA+B,GAAG,CAAC,CAAC;AAC1C,MAAM,+BAA+B,GAAG,GAAG,CAAC;AAC5C,MAAM,+BAA+B,GAAG,GAAG,CAAC;AAC5C,MAAM,+BAA+B,GAAG,OAAO,CAAC;AAChD,MAAM,sCAAsC,GAAG,IAAI,GAAG,CAAC;IACrD,QAAQ;IACR,WAAW;IACX,QAAQ;CACT,CAAC,CAAC;AAqBH,8EAA8E;AAC9E,MAAM,SAAS,GAAG,CAAC,KAAc,EAAW,EAAE,CAC5C,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK;IAC5D,CAAC,CAAE,KAA4B,CAAC,IAAI;IACpC,CAAC,CAAC,SAAS,CAAC;AAEhB,0FAA0F;AAC1F,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,KAAc,EAAW,EAAE,CAC9E,sCAAsC,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEvE,qEAAqE;AACrE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAc,EAAE,IAAY,EAAW,EAAE,CACnE,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;AAE5B,2EAA2E;AAC3E,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CAC1C,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC1B,CAAC,CAAC,CAAC;AAEL,4EAA4E;AAC5E,MAAM,CAAC,MAAM,+BAA+B,GAAG,KAAK,EAClD,oBAA4B,EACb,EAAE;IACjB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,cAAc,CAAC,CAAC;IACnE,IAAI,MAAM,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,OAAO;IACT,CAAC;IACD,MAAM,EAAE,CAAC,SAAS,CAChB,UAAU,EACV,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAClD,MAAM,CACP,CAAC;AACJ,CAAC,CAAC;AAEF,+FAA+F;AAC/F,MAAM,CAAC,MAAM,2CAA2C,GAAG,KAAK,EAC9D,oBAA4B,EACX,EAAE;IACnB,MAAM,mBAAmB,GAAG,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC/D,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5D,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC;IAC3D,IAAI,0BAA0B,GAAG,MAAM,EAAE;SACtC,QAAQ,CAAC,eAAe,CAAC;SACzB,KAAK,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC;IAChC,MAAM,yBAAyB,GAAG,IAAI,CAAC,QAAQ,CAC7C,eAAe,EACf,iBAAiB,CAClB,CAAC;IACF,MAAM,mBAAmB,GACvB,yBAAyB,KAAK,EAAE;QAC9B,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,yBAAyB,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChD,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,mBAAmB,CAAC,OAAO,EAAE,EAAE,CAAC;QAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,0BAA0B,EAAE,OAAO,CAAC,CAAC;QACjE,IAAI,CAAC;YACH,0BAA0B,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC5D,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B,GAAG,IAAI,CAAC,IAAI,CACpC,0BAA0B,EAC1B,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CACpC,CAAC;YACF,MAAM;QACR,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CACd,0BAA0B,EAC1B,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CACnC,CAAC;AACJ,CAAC,CAAC;AAEF,2FAA2F;AAC3F,MAAM,CAAC,MAAM,wCAAwC,GAAG,KAAK,EAC3D,eAAuB,EACvB,oBAA4B,EAC5B,aAA2B,EAC3B,kBAAkB,GAAG,EAAE,CAAC,MAAM,EAAE,EACjB,EAAE;IACjB,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACrD,MAAM,eAAe,GAAG,MAAM,EAAE;SAC7B,QAAQ,CAAC,cAAc,CAAC;SACxB,KAAK,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,CAAC;IAC/B,MAAM,oBAAoB,GACxB,MAAM,2CAA2C,CAAC,oBAAoB,CAAC,CAAC;IAC1E,IAAI,eAAe,KAAK,oBAAoB,EAAE,CAAC;QAC7C,OAAO;IACT,CAAC;IACD,IAAI,CAAC,qBAAqB,CAAC,eAAe,EAAE,oBAAoB,CAAC,EAAE,CAAC;QAClE,MAAM,aAAa,CAAC,eAAe,EAAE,oBAAoB,EAAE;YACzD,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,MAAM,mBAAmB,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC7D,MAAM,WAAW,GAAG,qBAAqB,CACvC,eAAe,EACf,mBAAmB,CACpB;QACC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC;QAC/B,CAAC,CAAC,mBAAmB,CAAC;IACxB,IAAI,qBAAqB,CAAC,eAAe,EAAE,WAAW,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,UAAU,CAClB,qBAAqB,eAAe,kIAAkI,EACtK,SAAS,CAAC,KAAK,EACf,EAAE,IAAI,EAAE,+CAA+C,EAAE,CAC1D,CAAC;IACJ,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,OAAO,CAClC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAC7C,CAAC;IACF,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAC5D,IAAI,CAAC;QACH,MAAM,aAAa,CAAC,eAAe,EAAE,eAAe,EAAE;YACpD,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;QACH,MAAM,aAAa,CAAC,eAAe,EAAE,oBAAoB,EAAE;YACzD,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,EAAE,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC,CAAC;AAEF,wEAAwE;AACxE,MAAM,CAAC,MAAM,gCAAgC,GAAG,KAAK,EACnD,eAAuB,EACvB,oBAA4B,EAC5B,gBAA8B,EAAE,CAAC,EAAE,EACpB,EAAE;IACjB,KACE,IAAI,OAAO,GAAG,CAAC,EACf,OAAO,IAAI,+BAA+B,EAC1C,OAAO,IAAI,CAAC,EACZ,CAAC;QACD,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,EAAE,CAAC,oBAAoB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACpE,MAAM,wCAAwC,CAC5C,eAAe,EACf,oBAAoB,EACpB,aAAa,CACd,CAAC;YACF,OAAO;QACT,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IACE,CAAC,oCAAoC,CAAC,KAAK,CAAC;gBAC5C,OAAO,KAAK,+BAA+B,EAC3C,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAEF,yEAAyE;AACzE,MAAM,kCAAkC,GAAG,KAAK,EAC9C,QAAgB,EACQ,EAAE;IAC1B,IAAI,aAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,aAAa,GAAG,MAAM,EAAE,CAAC,QAAQ,CAC/B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,EACjC,MAAM,CACP,CAAC;IACJ,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,MAAM,KAAK,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,EAAE,CAAC;QAC1E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAI,MAA8B,CAAC,KAAK,CAAC;IACpD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACtE,CAAC,CAAC;AAEF,yFAAyF;AACzF,MAAM,iCAAiC,GAAG,KAAK,EAC7C,QAAgB,EAChB,UAAkB,EACA,EAAE;IACpB,MAAM,iBAAiB,GAAG,MAAM,kCAAkC,CAAC,QAAQ,CAAC,CAAC;IAC7E,IAAI,iBAAiB,KAAK,UAAU,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,0FAA0F;AAC1F,MAAM,gCAAgC,GAAG,KAAK,EAC5C,QAAgB,EAChB,OAAe,EACG,EAAE;IACpB,IAAI,IAAyC,CAAC;IAC9C,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,eAAe,GAAG,MAAM,kCAAkC,CAAC,QAAQ,CAAC,CAAC;IAC3E,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;QAC7B,MAAM,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,iCAAiC,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;AACtE,CAAC,CAAC;AAEF,6EAA6E;AAC7E,MAAM,kCAAkC,GAAG,CACzC,QAAgB,EAChB,UAAkB,EAClB,UAAkB,EACK,EAAE;IACzB,IAAI,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,SAAS,GAAG,SAAS;aAClB,IAAI,CAAC,KAAK,IAAI,EAAE;YACf,IACE,CAAC,MAAM,kCAAkC,CAAC,QAAQ,CAAC,CAAC,KAAK,UAAU,EACnE,CAAC;gBACD,OAAO;YACT,CAAC;YACD,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;YAC/B,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;QACtD,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC,EAAE,UAAU,CAAC,CAAC;IACf,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,OAAO,KAAK,IAAI,EAAE;QAChB,aAAa,CAAC,KAAK,CAAC,CAAC;QACrB,MAAM,SAAS,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF,wFAAwF;AACxF,MAAM,0BAA0B,GAAG,KAAK,EACtC,QAAgB,EAChB,KAAgC,EACjB,EAAE;IACjB,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACzB,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,EACjC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EACrC,MAAM,CACP,CAAC;IACJ,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACxE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,kFAAkF;AAClF,MAAM,2BAA2B,GAAG,KAAK,EACvC,QAAgB,EAChB,KAAgC,EAChC,QAAgB,EAChB,OAAe,EACf,OAAe,EACG,EAAE;IACpB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,QAAQ,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,MAAM,0BAA0B,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAClD,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;gBAClC,MAAM,KAAK,CAAC;YACd,CAAC;YACD,IAAI,MAAM,gCAAgC,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;gBAC9D,OAAO,IAAI,CAAC,CAAC;YACf,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,yFAAyF;AACzF,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,EAC3C,YAAoB,EACpB,wBAAgC,EAChC,GAAqB,EACrB,OAAqC,EACzB,EAAE;IACd,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CACxB,YAAY,EACZ,SAAS,EACT,yBAAyB,CAC1B,CAAC;IACF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACnD,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,EACJ,QAAQ,EAAE,WAAW,GAAG,+BAA+B,EACvD,QAAQ,EAAE,UAAU,GAAG,+BAA+B,EACtD,QAAQ,EAAE,UAAU,GAAG,+BAA+B,EACtD,YAAY,EAAE,cAAc,GAC7B,GAAG,OAAO,IAAI,EAAE,CAAC;IAClB,IACE,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,CAAC;SACnD,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;SACvD,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,EACzB,CAAC;QACD,MAAM,IAAI,UAAU,CAClB,wDAAwD,EACxD,SAAS,CAAC,KAAK,CAChB,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACvC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC;IAC9D,IAAI,OAAO,IAAI,CAAC,IAAI,WAAW,IAAI,CAAC,IAAI,WAAW,IAAI,OAAO,EAAE,CAAC;QAC/D,MAAM,IAAI,UAAU,CAClB,sFAAsF,EACtF,SAAS,CAAC,KAAK,CAChB,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAA8B;QACvC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,UAAU,EAAE;QACnB,UAAU,EAAE,MAAM,EAAE;QACpB,WAAW,EAAE,wBAAwB;KACtC,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,2BAA2B,CAChD,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,OAAO,EACP,OAAO,CACR,CAAC;IACF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,UAAU,CAClB,qDAAqD,wBAAwB,IAAI,EACjF,SAAS,CAAC,QAAQ,CACnB,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,kCAAkC,CACtD,QAAQ,EACR,KAAK,CAAC,KAAK,EACX,WAAW,CACZ,CAAC;IACF,IAAI,CAAC;QACH,OAAO,MAAM,GAAG,EAAE,CAAC;IACrB,CAAC;YAAS,CAAC;QACT,MAAM,aAAa,EAAE,CAAC;QACtB,MAAM,iCAAiC,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAClE,GAAG,EAAE,CAAC,KAAK,CACZ,CAAC;IACJ,CAAC;AACH,CAAC,CAAC","debugId":"ef5442ae-3385-544e-889f-d4d78ee473c1"}
1	+ {"version":3,"file":"install-runtime.js","sources":["sdk/extension/install-runtime.ts"],"sourceRoot":"/","sourcesContent":["/*\n @module sdk/extension/install-runtime\n \n Provides cross-platform extension copy safety and owner-bound install locks.\n /\nimport { randomUUID } from \"node:crypto\";\nimport fs from \"node:fs/promises\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { isPathWithinDirectory } from \"../../core/fs/path-utils.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\n\nconst EXTENSION_INSTALL_COPY_ATTEMPTS = 3;\nconst EXTENSION_INSTALL_LOCK_ATTEMPTS = 120;\nconst EXTENSION_INSTALL_LOCK_DELAY_MS = 250;\nconst EXTENSION_INSTALL_LOCK_STALE_MS = 120_000;\nconst RETRIABLE_EXTENSION_INSTALL_COPY_CODES = new Set([\n \"EEXIST\",\n \"ENOTEMPTY\",\n \"ENOENT\",\n]);\n\ninterface ExtensionInstallLockOwner {\n pid: number;\n token: string;\n created_at: string;\n destination: string;\n}\n\n/* Retry and lease timing overrides for one extension install lock. /\nexport interface ExtensionInstallLockOptions {\n /* Maximum lock-acquisition attempts. /\n attempts?: number;\n /* Delay between contended acquisition attempts. /\n delay_ms?: number;\n /* Age after which an unchanged owner lease can be reclaimed. /\n stale_ms?: number;\n /* Lease heartbeat interval while the operation runs. /\n heartbeat_ms?: number;\n}\n\n/* Return an errno-style code from an unknown failure when one is present. /\nconst errnoCode = (error: unknown): unknown =>\n typeof error === \"object\" && error !== null && \"code\" in error\n ? (error as { code?: unknown }).code\n : undefined;\n\n/* Identify transient copy races that are safe to retry during extension installation. /\nexport const isRetriableExtensionInstallCopyError = (error: unknown): boolean =>\n RETRIABLE_EXTENSION_INSTALL_COPY_CODES.has(String(errnoCode(error)));\n\n/* Test an unknown failure against one expected errno-style code. /\nexport const isErrnoCode = (error: unknown, code: string): boolean =>\n errnoCode(error) === code;\n\n/* Delay an extension filesystem retry without blocking the event loop. /\nconst sleep = (ms: number): Promise<void> =>\n new Promise((resolve) => {\n setTimeout(resolve, ms);\n });\n\n/* Ensure an installed extension carries an ESM package boundary marker. /\nexport const ensureExtensionModuleTypeMarker = async (\n destinationDirectory: string,\n): Promise<void> => {\n const markerPath = path.join(destinationDirectory, \"package.json\");\n if (await pathExists(markerPath)) {\n return;\n }\n await fs.writeFile(\n markerPath,\n `${JSON.stringify({ type: \"module\" }, null, 2)}\\n`,\n \"utf8\",\n );\n};\n\n/* Resolve a possibly partial extension destination through every existing symlink segment. /\nexport const resolveCanonicalExtensionInstallDestination = async (\n destinationDirectory: string,\n): Promise<string> => {\n const resolvedDestination = path.resolve(destinationDirectory);\n const destinationParent = path.dirname(resolvedDestination);\n const destinationRoot = path.parse(destinationParent).root;\n let canonicalDestinationParent = await fs\n .realpath(destinationRoot)\n .catch(() => destinationRoot);\n const relativeDestinationParent = path.relative(\n destinationRoot,\n destinationParent,\n );\n const destinationSegments =\n relativeDestinationParent === \"\"\n ? []\n : relativeDestinationParent.split(path.sep);\n for (const [index, segment] of destinationSegments.entries()) {\n const candidate = path.join(canonicalDestinationParent, segment);\n try {\n canonicalDestinationParent = await fs.realpath(candidate);\n } catch {\n canonicalDestinationParent = path.join(\n canonicalDestinationParent,\n ...destinationSegments.slice(index),\n );\n break;\n }\n }\n return path.join(\n canonicalDestinationParent,\n path.basename(resolvedDestination),\n );\n};\n\n/* Copy an extension without recursively copying a destination nested below its source. /\nexport const copyExtensionDirectoryWithoutSelfNesting = async (\n sourceDirectory: string,\n destinationDirectory: string,\n copyDirectory: typeof fs.cp,\n temporaryDirectory = os.tmpdir(),\n): Promise<void> => {\n const resolvedSource = path.resolve(sourceDirectory);\n const canonicalSource = await fs\n .realpath(resolvedSource)\n .catch(() => resolvedSource);\n const canonicalDestination =\n await resolveCanonicalExtensionInstallDestination(destinationDirectory);\n if (canonicalSource === canonicalDestination) {\n return;\n }\n if (!isPathWithinDirectory(canonicalSource, canonicalDestination)) {\n await copyDirectory(sourceDirectory, destinationDirectory, {\n recursive: true,\n force: true,\n });\n return;\n }\n\n const systemTempDirectory = await fs\n .realpath(path.resolve(temporaryDirectory))\n .catch(() => resolveCanonicalExtensionInstallDestination(temporaryDirectory));\n const stagingBase = isPathWithinDirectory(\n canonicalSource,\n systemTempDirectory,\n )\n ? path.dirname(canonicalSource)\n : systemTempDirectory;\n if (isPathWithinDirectory(canonicalSource, stagingBase)) {\n throw new PmCliError(\n `Extension source \"${sourceDirectory}\" contains its install destination and no external staging directory is available. Install a narrower package directory instead.`,\n EXIT_CODE.USAGE,\n { code: \"extension_install_source_contains_destination\" },\n );\n }\n const stagingRoot = await fs.mkdtemp(\n path.join(stagingBase, \"pm-extension-copy-\"),\n );\n const stagedDirectory = path.join(stagingRoot, \"extension\");\n try {\n await copyDirectory(sourceDirectory, stagedDirectory, {\n recursive: true,\n force: true,\n });\n await copyDirectory(stagedDirectory, destinationDirectory, {\n recursive: true,\n force: true,\n });\n } finally {\n await fs.rm(stagingRoot, { recursive: true, force: true });\n }\n};\n\n/* Copy one extension directory with bounded transient-race retries. /\nexport const copyExtensionDirectoryForInstall = async (\n sourceDirectory: string,\n destinationDirectory: string,\n copyDirectory: typeof fs.cp = fs.cp,\n): Promise<void> => {\n for (\n let attempt = 1;\n attempt <= EXTENSION_INSTALL_COPY_ATTEMPTS;\n attempt += 1\n ) {\n try {\n await fs.rm(destinationDirectory, { recursive: true, force: true });\n await copyExtensionDirectoryWithoutSelfNesting(\n sourceDirectory,\n destinationDirectory,\n copyDirectory,\n );\n return;\n } catch (error: unknown) {\n if (\n !isRetriableExtensionInstallCopyError(error) \|\|\n attempt === EXTENSION_INSTALL_COPY_ATTEMPTS\n ) {\n throw error;\n }\n await sleep(EXTENSION_INSTALL_LOCK_DELAY_MS);\n }\n }\n};\n\n/* Read the unique owner token recorded for one extension scope lock. /\nconst readExtensionInstallLockOwnerToken = async (\n lockPath: string,\n): Promise<string \| null> => {\n let ownerContents: string;\n try {\n ownerContents = await fs.readFile(\n path.join(lockPath, \"owner.json\"),\n \"utf8\",\n );\n } catch (error: unknown) {\n if (!isErrnoCode(error, \"ENOENT\")) throw error;\n return null;\n }\n let parsed: unknown;\n try {\n parsed = JSON.parse(ownerContents);\n } catch {\n return null;\n }\n if (typeof parsed !== \"object\" \|\| parsed === null \|\| !(\"token\" in parsed)) {\n return null;\n }\n const token = (parsed as { token?: unknown }).token;\n return typeof token === \"string\" && token.length > 0 ? token : null;\n};\n\n/* Remove an extension scope lock only while its persisted owner token still matches. /\nconst removeExtensionInstallLockIfOwned = async (\n lockPath: string,\n ownerToken: string,\n): Promise<boolean> => {\n const currentOwnerToken = await readExtensionInstallLockOwnerToken(lockPath);\n if (currentOwnerToken !== ownerToken) {\n return false;\n }\n await fs.rm(lockPath, { recursive: true, force: true });\n return true;\n};\n\n/* Reclaim an expired extension scope lock when its persisted owner remains unchanged. /\nconst reclaimStaleExtensionInstallLock = async (\n lockPath: string,\n staleMs: number,\n): Promise<boolean> => {\n let stat: Awaited<ReturnType<typeof fs.stat>>;\n try {\n stat = await fs.stat(lockPath);\n } catch {\n return false;\n }\n if (Date.now() - stat.mtimeMs <= staleMs) {\n return false;\n }\n const staleOwnerToken = await readExtensionInstallLockOwnerToken(lockPath);\n if (staleOwnerToken === null) {\n await fs.rm(lockPath, { recursive: true, force: true });\n return true;\n }\n return removeExtensionInstallLockIfOwned(lockPath, staleOwnerToken);\n};\n\n/* Start an owner-bound lease heartbeat and return an async stop barrier. /\nconst startExtensionInstallLockHeartbeat = (\n lockPath: string,\n ownerToken: string,\n intervalMs: number,\n): (() => Promise<void>) => {\n let heartbeat = Promise.resolve();\n const timer = setInterval(() => {\n heartbeat = heartbeat\n .then(async () => {\n if (\n (await readExtensionInstallLockOwnerToken(lockPath)) !== ownerToken\n ) {\n return;\n }\n const heartbeatAt = new Date();\n await fs.utimes(lockPath, heartbeatAt, heartbeatAt);\n })\n .catch(() => undefined);\n }, intervalMs);\n timer.unref();\n return async () => {\n clearInterval(timer);\n await heartbeat;\n };\n};\n\n/* Create one owner-bound extension install lock, removing partial state on failure. /\nconst createExtensionInstallLock = async (\n lockPath: string,\n owner: ExtensionInstallLockOwner,\n): Promise<void> => {\n await fs.mkdir(lockPath);\n try {\n await fs.writeFile(\n path.join(lockPath, \"owner.json\"),\n `${JSON.stringify(owner, null, 2)}\\n`,\n \"utf8\",\n );\n } catch (error: unknown) {\n await fs.rm(lockPath, { recursive: true, force: true }).catch(() => {});\n throw error;\n }\n};\n\n/* Retry owner-bound extension lock acquisition while reclaiming stale owners. /\nconst acquireExtensionInstallLock = async (\n lockPath: string,\n owner: ExtensionInstallLockOwner,\n attempts: number,\n delayMs: number,\n staleMs: number,\n): Promise<boolean> => {\n for (let attempt = 1; attempt <= attempts; attempt += 1) {\n try {\n await createExtensionInstallLock(lockPath, owner);\n return true;\n } catch (error: unknown) {\n if (!isErrnoCode(error, \"EEXIST\")) {\n throw error;\n }\n if (await reclaimStaleExtensionInstallLock(lockPath, staleMs)) {\n attempt -= 1;\n } else {\n await sleep(delayMs);\n }\n }\n }\n return false;\n};\n\n/* Run one operation under an owner-bound extension install lock and heartbeat lease. */\nexport const withExtensionInstallLock = async <T>(\n settingsRoot: string,\n destinationDirectoryName: string,\n run: () => Promise<T>,\n options?: ExtensionInstallLockOptions,\n): Promise<T> => {\n const lockRoot = path.join(\n settingsRoot,\n \"runtime\",\n \"extension-install-locks\",\n );\n const lockPath = path.join(lockRoot, \"scope.lock\");\n await fs.mkdir(lockRoot, { recursive: true });\n const {\n attempts: rawAttempts = EXTENSION_INSTALL_LOCK_ATTEMPTS,\n delay_ms: rawDelayMs = EXTENSION_INSTALL_LOCK_DELAY_MS,\n stale_ms: rawStaleMs = EXTENSION_INSTALL_LOCK_STALE_MS,\n heartbeat_ms: rawHeartbeatMs,\n } = options ?? {};\n if (\n ![rawAttempts, rawDelayMs, rawStaleMs, rawHeartbeatMs]\n .filter((value): value is number => value !== undefined)\n .every(Number.isFinite)\n ) {\n throw new PmCliError(\n \"Extension install lock timings must be finite numbers.\",\n EXIT_CODE.USAGE,\n );\n }\n const attempts = Math.max(1, Math.floor(rawAttempts));\n const delayMs = Math.max(0, Math.floor(rawDelayMs));\n const staleMs = Math.floor(rawStaleMs);\n const heartbeatMs = Math.floor(rawHeartbeatMs ?? staleMs / 3);\n if (staleMs <= 0 \|\| heartbeatMs <= 0 \|\| heartbeatMs >= staleMs) {\n throw new PmCliError(\n \"Extension install lock timings require stale_ms > 0 and 0 < heartbeat_ms < stale_ms.\",\n EXIT_CODE.USAGE,\n );\n }\n const owner: ExtensionInstallLockOwner = {\n pid: process.pid,\n token: randomUUID(),\n created_at: nowIso(),\n destination: destinationDirectoryName,\n };\n const acquired = await acquireExtensionInstallLock(\n lockPath,\n owner,\n attempts,\n delayMs,\n staleMs,\n );\n if (!acquired) {\n throw new PmCliError(\n `Timed out waiting for extension install lock for \"${destinationDirectoryName}\".`,\n EXIT_CODE.CONFLICT,\n );\n }\n\n const stopHeartbeat = startExtensionInstallLockHeartbeat(\n lockPath,\n owner.token,\n heartbeatMs,\n );\n try {\n return await run();\n } finally {\n await stopHeartbeat();\n await removeExtensionInstallLockIfOwned(lockPath, owner.token).catch(\n () => false,\n );\n }\n};\n"],"names":[],"mappings":"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","debugId":"1ced281f-c8b0-5424-a9d7-68c3512b835e"}

package/dist/sdk/extension.d.ts CHANGED Viewed

@@ -111,7 +111,7 @@ export interface ManagedExtensionSummary {
     enabled: boolean;
     /** Value that configures or reports runtime active for this contract. */
     runtime_active: boolean | null;
-    /** Lifecycle state reported for activationthe record. */
+    /** Activation outcome reported for this extension. */
     activation_status: ExtensionActivationStatus;
     /** Value that configures or reports command paths for this contract. */
     command_paths?: string[];
@@ -129,7 +129,7 @@ export interface ManagedExtensionSummary {
     last_update_remote_commit?: string;
     /** Value that configures or reports update error for this contract. */
     update_error?: string;
-    /** Lifecycle state reported for update checkthe record. */
+    /** Outcome of the registry update check for this extension. */
     update_check_status: ExtensionUpdateCheckStatus;
     /** Value that configures or reports update check reason for this contract. */
     update_check_reason: string;

package/dist/sdk/extension.js CHANGED Viewed

@@ -4,7 +4,7 @@
  * Implements the pm extension command surface and its agent-facing runtime behavior.
  */
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="fe21d8bd-795f-5bed-b4fc-e6efe6ee6120")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="dbfbb3c7-f6d7-573b-a90e-808e78a68c28")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { activateExtensions, createSerialQueue, loadExtensions, nextExtensionReloadToken, } from "../core/extensions/index.js";
@@ -2171,4 +2171,4 @@ export const _testOnly = {
     withExtensionInstallLock,
 };
 //# sourceMappingURL=extension.js.map
-//# debugId=fe21d8bd-795f-5bed-b4fc-e6efe6ee6120
+//# debugId=dbfbb3c7-f6d7-573b-a90e-808e78a68c28