惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

H
Help Net Security
腾讯CDC
爱范儿
爱范儿
Google DeepMind News
Google DeepMind News
V
V2EX
Blog — PlanetScale
Blog — PlanetScale
Engineering at Meta
Engineering at Meta
GbyAI
GbyAI
量子位
F
Fortinet All Blogs
G
Google Developers Blog
T
The Blog of Author Tim Ferriss
Cyber Security Advisories - MS-ISAC
Cyber Security Advisories - MS-ISAC
Hugging Face - Blog
Hugging Face - Blog
Last Week in AI
Last Week in AI
T
Tailwind CSS Blog
J
Java Code Geeks
S
SegmentFault 最新的问题
D
Docker
博客园 - 司徒正美
The GitHub Blog
The GitHub Blog
Jina AI
Jina AI
M
MIT News - Artificial intelligence
博客园 - 【当耐特】

Recent Commits to openclaw:main

test: merge chat side-result checks · openclaw/openclaw@ddd2c2a test: merge cron history checks · openclaw/openclaw@f7eb746 test: merge responsive navigation shell checks · openclaw/openclaw@c2e4b47 docs(changelog): add codex oauth fixes · openclaw/openclaw@628e6cd test: merge navigation routing cases · openclaw/openclaw@5d8cecb Tests: mock channel registry bundled fallback · openclaw/openclaw@2b08233 Secrets: avoid broad web search discovery for single plugin config · openclaw/openclaw@a464f59 test: merge config view browser checks · openclaw/openclaw@20cf511 fix(status): align oauth health with runtime · openclaw/openclaw@eed7116 feat: add macOS screen snapshots for monitor preview (#67954) thanks … · openclaw/openclaw@f377db1 fix: report shared auth scopes in hello-ok (#67810) thanks @BunsDev · openclaw/openclaw@0b6c39b Auto-reply: avoid eager bundled route fallback · openclaw/openclaw@3ea1bf4 Tests: narrow session binding contract setup · openclaw/openclaw@54e4e16 fix(macOS): enable undo/redo in webchat composer text input (#34962) · openclaw/openclaw@00951dc Tests: speed up channel setup promotion · openclaw/openclaw@82b529a Docs: refresh agent instructions · openclaw/openclaw@5775fe2 fix(auth): serialize OAuth refresh across agents to fix #26322 (#67876) · openclaw/openclaw@8e79080 test: allow ollama public surface boundary test · openclaw/openclaw@7d4f1a6 Docs: add test performance guardrails · openclaw/openclaw@89706d3 Tests: restore context-engine usage proof · openclaw/openclaw@e4c4f95 Tests: slim context engine runtime coverage · openclaw/openclaw@74c198f ci: retry failed custom checkouts · openclaw/openclaw@0ee5baf test: trim duplicate provider auth onboarding cases · openclaw/openclaw@1ffc02e matrix: fix sessions_spawn --thread subagent session spawning (#67643) · openclaw/openclaw@1ce2596 test: reduce auth choice fixture churn · openclaw/openclaw@857b9cd test: mock health status config boundaries · openclaw/openclaw@9d5ab4a test: mock onboard config io boundary · openclaw/openclaw@299694d test: mock legacy state plugin boundaries · openclaw/openclaw@2713089 test: mock channel install boundaries · openclaw/openclaw@b945248 test: mock doctor preview channel boundaries · openclaw/openclaw@b1a3ad4
refactor: share plugin package entry resolution · opencla...
steipete · 2026-04-26 · via Recent Commits to openclaw:main

@@ -1,7 +1,6 @@

11

import fs from "node:fs";

22

import path from "node:path";

3-

import { matchBoundaryFileOpenFailure, openBoundaryFileSync } from "../infra/boundary-file-read.js";

4-

import { resolveBoundaryPathSync } from "../infra/boundary-path.js";

3+

import { openBoundaryFileSync } from "../infra/boundary-file-read.js";

54

import {

65

normalizeLowercaseStringOrEmpty,

76

normalizeOptionalString,

@@ -19,7 +18,10 @@ import {

1918

type OpenClawPackageManifest,

2019

type PackageManifest,

2120

} from "./manifest.js";

22-

import { listBuiltRuntimeEntryCandidates } from "./package-entrypoints.js";

21+

import {

22+

resolvePackageRuntimeExtensionSources,

23+

resolvePackageSetupSource,

24+

} from "./package-entry-resolution.js";

2325

import { formatPosixMode, isPathInside, safeRealpathSync, safeStatSync } from "./path-safety.js";

2426

import type { PluginOrigin } from "./plugin-origin.types.js";

2527

import { resolvePluginCacheInputs, resolvePluginSourceRoots } from "./roots.js";

@@ -555,245 +557,6 @@ function discoverBundleInRoot(params: {

555557

return "added";

556558

}

557559558-

function resolvePackageEntrySource(params: {

559-

packageDir: string;

560-

entryPath: string;

561-

sourceLabel: string;

562-

diagnostics: PluginDiagnostic[];

563-

rejectHardlinks?: boolean;

564-

}): string | null {

565-

const source = path.resolve(params.packageDir, params.entryPath);

566-

const rejectHardlinks = params.rejectHardlinks ?? true;

567-

const candidates = [source];

568-

const openCandidate = (absolutePath: string): string | null => {

569-

const opened = openBoundaryFileSync({

570-

absolutePath,

571-

rootPath: params.packageDir,

572-

boundaryLabel: "plugin package directory",

573-

rejectHardlinks,

574-

});

575-

if (!opened.ok) {

576-

return matchBoundaryFileOpenFailure(opened, {

577-

path: () => null,

578-

io: () => {

579-

params.diagnostics.push({

580-

level: "warn",

581-

message: `extension entry unreadable (I/O error): ${params.entryPath}`,

582-

source: params.sourceLabel,

583-

});

584-

return null;

585-

},

586-

fallback: () => {

587-

params.diagnostics.push({

588-

level: "error",

589-

message: `extension entry escapes package directory: ${params.entryPath}`,

590-

source: params.sourceLabel,

591-

});

592-

return null;

593-

},

594-

});

595-

}

596-

const safeSource = opened.path;

597-

fs.closeSync(opened.fd);

598-

return safeSource;

599-

};

600-

if (!rejectHardlinks) {

601-

const builtCandidate = source.replace(/\.[^.]+$/u, ".js");

602-

if (builtCandidate !== source) {

603-

candidates.push(builtCandidate);

604-

}

605-

}

606-607-

for (const candidate of new Set(candidates)) {

608-

if (!fs.existsSync(candidate)) {

609-

continue;

610-

}

611-

return openCandidate(candidate);

612-

}

613-614-

return openCandidate(source);

615-

}

616-617-

function shouldInferBuiltRuntimeEntry(origin: PluginOrigin): boolean {

618-

return origin === "config" || origin === "global";

619-

}

620-621-

function resolveSafePackageEntry(params: {

622-

packageDir: string;

623-

entryPath: string;

624-

sourceLabel: string;

625-

diagnostics: PluginDiagnostic[];

626-

rejectHardlinks?: boolean;

627-

}): { relativePath: string; existingSource?: string } | null {

628-

const absolutePath = path.resolve(params.packageDir, params.entryPath);

629-

if (fs.existsSync(absolutePath)) {

630-

const existingSource = resolvePackageEntrySource({

631-

packageDir: params.packageDir,

632-

entryPath: params.entryPath,

633-

sourceLabel: params.sourceLabel,

634-

diagnostics: params.diagnostics,

635-

rejectHardlinks: params.rejectHardlinks,

636-

});

637-

if (!existingSource) {

638-

return null;

639-

}

640-

return {

641-

relativePath: path.relative(params.packageDir, absolutePath).replace(/\\/g, "/"),

642-

existingSource,

643-

};

644-

}

645-646-

try {

647-

resolveBoundaryPathSync({

648-

absolutePath,

649-

rootPath: params.packageDir,

650-

boundaryLabel: "plugin package directory",

651-

});

652-

} catch {

653-

params.diagnostics.push({

654-

level: "error",

655-

message: `extension entry escapes package directory: ${params.entryPath}`,

656-

source: params.sourceLabel,

657-

});

658-

return null;

659-

}

660-

return { relativePath: path.relative(params.packageDir, absolutePath).replace(/\\/g, "/") };

661-

}

662-663-

function resolveExistingPackageEntrySource(params: {

664-

packageDir: string;

665-

entryPath: string;

666-

sourceLabel: string;

667-

diagnostics: PluginDiagnostic[];

668-

rejectHardlinks?: boolean;

669-

}): string | null {

670-

const source = path.resolve(params.packageDir, params.entryPath);

671-

if (!fs.existsSync(source)) {

672-

return null;

673-

}

674-

return resolvePackageEntrySource(params);

675-

}

676-677-

function normalizePackageManifestStringList(value: unknown): string[] {

678-

if (!Array.isArray(value)) {

679-

return [];

680-

}

681-

return value.map((entry) => normalizeOptionalString(entry) ?? "").filter(Boolean);

682-

}

683-684-

function resolvePackageRuntimeEntrySource(params: {

685-

packageDir: string;

686-

entryPath: string;

687-

runtimeEntryPath?: string;

688-

origin: PluginOrigin;

689-

sourceLabel: string;

690-

diagnostics: PluginDiagnostic[];

691-

rejectHardlinks?: boolean;

692-

}): string | null {

693-

const safeEntry = resolveSafePackageEntry({

694-

packageDir: params.packageDir,

695-

entryPath: params.entryPath,

696-

sourceLabel: params.sourceLabel,

697-

diagnostics: params.diagnostics,

698-

rejectHardlinks: params.rejectHardlinks,

699-

});

700-

if (!safeEntry) {

701-

return null;

702-

}

703-704-

if (params.runtimeEntryPath) {

705-

const runtimeSource = resolvePackageEntrySource({

706-

packageDir: params.packageDir,

707-

entryPath: params.runtimeEntryPath,

708-

sourceLabel: params.sourceLabel,

709-

diagnostics: params.diagnostics,

710-

rejectHardlinks: params.rejectHardlinks,

711-

});

712-

if (runtimeSource) {

713-

return runtimeSource;

714-

}

715-

}

716-717-

if (shouldInferBuiltRuntimeEntry(params.origin)) {

718-

for (const candidate of listBuiltRuntimeEntryCandidates(safeEntry.relativePath)) {

719-

const runtimeSource = resolveExistingPackageEntrySource({

720-

packageDir: params.packageDir,

721-

entryPath: candidate,

722-

sourceLabel: params.sourceLabel,

723-

diagnostics: params.diagnostics,

724-

rejectHardlinks: params.rejectHardlinks,

725-

});

726-

if (runtimeSource) {

727-

return runtimeSource;

728-

}

729-

}

730-

}

731-732-

if (safeEntry.existingSource) {

733-

return safeEntry.existingSource;

734-

}

735-736-

return resolvePackageEntrySource({

737-

packageDir: params.packageDir,

738-

entryPath: params.entryPath,

739-

sourceLabel: params.sourceLabel,

740-

diagnostics: params.diagnostics,

741-

rejectHardlinks: params.rejectHardlinks,

742-

});

743-

}

744-745-

function resolvePackageSetupSource(params: {

746-

packageDir: string;

747-

manifest: PackageManifest | null;

748-

origin: PluginOrigin;

749-

sourceLabel: string;

750-

diagnostics: PluginDiagnostic[];

751-

rejectHardlinks?: boolean;

752-

}): string | null {

753-

const packageManifest = getPackageManifestMetadata(params.manifest ?? undefined);

754-

const setupEntryPath = normalizeOptionalString(packageManifest?.setupEntry);

755-

if (!setupEntryPath) {

756-

return null;

757-

}

758-

return resolvePackageRuntimeEntrySource({

759-

packageDir: params.packageDir,

760-

entryPath: setupEntryPath,

761-

runtimeEntryPath: normalizeOptionalString(packageManifest?.runtimeSetupEntry),

762-

origin: params.origin,

763-

sourceLabel: params.sourceLabel,

764-

diagnostics: params.diagnostics,

765-

rejectHardlinks: params.rejectHardlinks,

766-

});

767-

}

768-769-

function resolvePackageRuntimeExtensionEntries(params: {

770-

packageDir: string;

771-

manifest: PackageManifest | null;

772-

extensions: readonly string[];

773-

origin: PluginOrigin;

774-

sourceLabel: string;

775-

diagnostics: PluginDiagnostic[];

776-

rejectHardlinks?: boolean;

777-

}): string[] {

778-

const packageManifest = getPackageManifestMetadata(params.manifest ?? undefined);

779-

const runtimeExtensions = normalizePackageManifestStringList(packageManifest?.runtimeExtensions);

780-

return params.extensions.flatMap((entryPath, index) => {

781-

const source = resolvePackageRuntimeEntrySource({

782-

packageDir: params.packageDir,

783-

entryPath,

784-

runtimeEntryPath:

785-

runtimeExtensions.length === params.extensions.length

786-

? runtimeExtensions[index]

787-

: undefined,

788-

origin: params.origin,

789-

sourceLabel: params.sourceLabel,

790-

diagnostics: params.diagnostics,

791-

rejectHardlinks: params.rejectHardlinks,

792-

});

793-

return source ? [source] : [];

794-

});

795-

}

796-797560

function discoverInDirectory(params: {

798561

dir: string;

799562

origin: PluginOrigin;

@@ -871,7 +634,7 @@ function discoverInDirectory(params: {

871634

});

872635873636

if (extensions.length > 0) {

874-

const resolvedRuntimeSources = resolvePackageRuntimeExtensionEntries({

637+

const resolvedRuntimeSources = resolvePackageRuntimeExtensionSources({

875638

packageDir: fullPath,

876639

manifest,

877640

extensions,

@@ -1007,7 +770,7 @@ function discoverFromPath(params: {

1007770

});

10087711009772

if (extensions.length > 0) {

1010-

const resolvedRuntimeSources = resolvePackageRuntimeExtensionEntries({

773+

const resolvedRuntimeSources = resolvePackageRuntimeExtensionSources({

1011774

packageDir: resolved,

1012775

manifest,

1013776

extensions,