@agent-native/core 0.49.18 → 0.49.20

package/dist/local-artifacts/index.d.ts

@@ -85,6 +85,29 @@ export interface WriteLocalArtifactFileOptions extends LocalArtifactOptions {
     expectedHash?: string | null;
     ifNotExists?: boolean;
 }
+export interface LocalWorkspaceResourceMeta {
+    id: string;
+    path: string;
+    absolutePath: string;
+    mimeType: string;
+    sizeBytes: number;
+    hash: string;
+    createdAt: string;
+    updatedAt: string;
+    mtimeMs: number;
+}
+export interface LocalWorkspaceResourceFile extends LocalWorkspaceResourceMeta {
+    content: string;
+}
+export interface LocalWorkspaceResourceOptions extends LoadAgentNativeManifestOptions {
+}
+export interface WriteLocalWorkspaceResourceOptions extends LocalWorkspaceResourceOptions {
+    path: string;
+    content: string;
+    expectedHash?: string | null;
+    ifNotExists?: boolean;
+}
+export declare const LOCAL_WORKSPACE_RESOURCE_ID_PREFIX = "local-workspace-resource:";
 export declare function findAgentNativeManifest(startDir?: string): string | null;
 export declare function loadAgentNativeManifest(options?: LoadAgentNativeManifestOptions): Promise<LoadedAgentNativeManifest | null>;
 export declare function resolveAgentNativeDataMode(options?: ResolveAgentNativeModeOptions): Promise<AgentNativeDataMode>;
@@ -102,4 +125,18 @@ export declare function deleteLocalArtifactFile(options: LocalArtifactOptions &
 }): Promise<boolean>;
 export declare function ensureLocalArtifactRoot(options: LocalArtifactOptions): Promise<LoadedLocalArtifactRoot>;
 export declare function createTempWorkspaceDir(prefix?: string): string;
+export declare function isLocalWorkspaceResourcesEnabled(options?: LocalWorkspaceResourceOptions): Promise<boolean>;
+export declare function localWorkspaceResourceId(resourcePath: string): string;
+export declare function isLocalWorkspaceResourceId(id: string): boolean;
+export declare function localWorkspaceResourcePathFromId(id: string): string | null;
+export declare function normalizeLocalWorkspaceResourcePath(resourcePath: string): string;
+export declare function canUseLocalWorkspaceResourcePath(resourcePath: string): boolean;
+export declare function listLocalWorkspaceResources(options?: LocalWorkspaceResourceOptions): Promise<LocalWorkspaceResourceMeta[]>;
+export declare function readLocalWorkspaceResource(options: LocalWorkspaceResourceOptions & {
+    path: string;
+}): Promise<LocalWorkspaceResourceFile | null>;
+export declare function writeLocalWorkspaceResource(options: WriteLocalWorkspaceResourceOptions): Promise<LocalWorkspaceResourceMeta>;
+export declare function deleteLocalWorkspaceResource(options: LocalWorkspaceResourceOptions & {
+    path: string;
+}): Promise<boolean>;
 //# sourceMappingURL=index.d.ts.map

package/dist/local-artifacts/index.d.ts.map

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

package/dist/local-artifacts/index.js

@@ -20,6 +20,35 @@ const DEFAULT_HIDE_PATTERNS = [
     "**/dist/**",
     "**/build/**",
 ];
+export const LOCAL_WORKSPACE_RESOURCE_ID_PREFIX = "local-workspace-resource:";
+const LOCAL_WORKSPACE_RESOURCE_MAX_BYTES = 2 * 1024 * 1024;
+const LOCAL_WORKSPACE_CONTROL_FILES = new Set([
+    "AGENTS.md",
+    "agent-native.json",
+    "mcp.config.json",
+    ".mcp.json",
+]);
+const LOCAL_WORKSPACE_SKILL_ROOTS = [".agents/skills", ".agent/skills"];
+const LOCAL_WORKSPACE_TEXT_EXTENSIONS = new Set([
+    ".css",
+    ".csv",
+    ".html",
+    ".js",
+    ".json",
+    ".jsx",
+    ".md",
+    ".mdx",
+    ".py",
+    ".sh",
+    ".sql",
+    ".toml",
+    ".ts",
+    ".tsx",
+    ".txt",
+    ".xml",
+    ".yaml",
+    ".yml",
+]);
 function isRecord(value) {
     return !!value && typeof value === "object" && !Array.isArray(value);
 }
@@ -529,4 +558,355 @@ export async function ensureLocalArtifactRoot(options) {
 export function createTempWorkspaceDir(prefix = "agent-native-local-") {
     return fsSync.mkdtempSync(path.join(os.tmpdir(), prefix));
 }
+function localWorkspaceResourcesEnabled(loaded) {
+    const explicitMode = envMode();
+    if (explicitMode) {
+        assertLocalFilesRuntimeAllowed(explicitMode);
+        return explicitMode === "local-files";
+    }
+    const manifest = loaded?.manifest;
+    const mode = manifest?.mode;
+    if (mode) {
+        assertLocalFilesRuntimeAllowed(mode);
+        if (mode === "local-files")
+            return true;
+    }
+    return false;
+}
+async function resolveLocalWorkspaceRoot(options = {}) {
+    const loaded = await loadAgentNativeManifest({ ...options, optional: true });
+    if (localWorkspaceResourcesEnabled(loaded)) {
+        return loaded?.rootDir ?? path.resolve(options.cwd ?? process.cwd());
+    }
+    return null;
+}
+export async function isLocalWorkspaceResourcesEnabled(options = {}) {
+    return !!(await resolveLocalWorkspaceRoot(options));
+}
+export function localWorkspaceResourceId(resourcePath) {
+    const normalized = normalizeSlash(resourcePath).replace(/^\/+/, "");
+    return `${LOCAL_WORKSPACE_RESOURCE_ID_PREFIX}${Buffer.from(normalized, "utf8").toString("base64url")}`;
+}
+export function isLocalWorkspaceResourceId(id) {
+    return id.startsWith(LOCAL_WORKSPACE_RESOURCE_ID_PREFIX);
+}
+export function localWorkspaceResourcePathFromId(id) {
+    if (!isLocalWorkspaceResourceId(id))
+        return null;
+    const encoded = id.slice(LOCAL_WORKSPACE_RESOURCE_ID_PREFIX.length);
+    try {
+        const decoded = Buffer.from(encoded, "base64url").toString("utf8");
+        return normalizeLocalWorkspaceResourcePath(decoded);
+    }
+    catch {
+        return null;
+    }
+}
+function mimeTypeForLocalWorkspaceResource(resourcePath) {
+    const extension = extensionOf(resourcePath);
+    if (extension === ".md")
+        return "text/markdown";
+    if (extension === ".mdx")
+        return "text/mdx";
+    if (extension === ".json")
+        return "application/json";
+    if (extension === ".yaml" || extension === ".yml")
+        return "application/yaml";
+    if (extension === ".toml")
+        return "text/toml";
+    if (extension === ".ts" || extension === ".tsx")
+        return "text/typescript";
+    if (extension === ".js" || extension === ".jsx")
+        return "text/javascript";
+    if (extension === ".html")
+        return "text/html";
+    if (extension === ".css")
+        return "text/css";
+    if (extension === ".xml")
+        return "application/xml";
+    if (extension === ".csv")
+        return "text/csv";
+    if (extension === ".sql")
+        return "text/sql";
+    if (extension === ".sh")
+        return "text/x-shellscript";
+    if (extension === ".py")
+        return "text/x-python";
+    return "text/plain";
+}
+function isSupportedLocalWorkspaceTextFile(resourcePath) {
+    return LOCAL_WORKSPACE_TEXT_EXTENSIONS.has(extensionOf(resourcePath));
+}
+export function normalizeLocalWorkspaceResourcePath(resourcePath) {
+    const safePath = normalizeRelativePath(normalizeSlash(resourcePath).replace(/^\/+/, ""), "resource path");
+    if (LOCAL_WORKSPACE_CONTROL_FILES.has(safePath))
+        return safePath;
+    if (safePath.startsWith(".agents/skills/")) {
+        const relativeSkillPath = normalizeRelativePath(safePath.slice(".agents/skills/".length), "resource path");
+        return normalizeSlash(path.posix.join("skills", relativeSkillPath));
+    }
+    if (safePath.startsWith(".agent/skills/")) {
+        const relativeSkillPath = normalizeRelativePath(safePath.slice(".agent/skills/".length), "resource path");
+        return normalizeSlash(path.posix.join("skills", relativeSkillPath));
+    }
+    if (safePath.startsWith("skills/"))
+        return safePath;
+    throw new Error(`Local workspace resource "${resourcePath}" must be AGENTS.md, agent-native.json, mcp.config.json, .mcp.json, or under skills/.`);
+}
+export function canUseLocalWorkspaceResourcePath(resourcePath) {
+    try {
+        normalizeLocalWorkspaceResourcePath(resourcePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function localWorkspaceResourceAbsolutePath(workspaceRoot, resourcePath, options = {}) {
+    const normalized = normalizeLocalWorkspaceResourcePath(resourcePath);
+    const safePath = normalizeRelativePath(normalizeSlash(resourcePath).replace(/^\/+/, ""), "resource path");
+    let relativePath = normalized;
+    if (safePath.startsWith(".agents/skills/") ||
+        safePath.startsWith(".agent/skills/")) {
+        relativePath = safePath;
+    }
+    else if (normalized.startsWith("skills/")) {
+        const skillPath = normalized.slice("skills/".length);
+        const candidates = LOCAL_WORKSPACE_SKILL_ROOTS.map((root) => normalizeSlash(path.posix.join(root, skillPath)));
+        relativePath = candidates[0];
+        if (options.preferExisting) {
+            relativePath =
+                candidates.find((candidate) => fsSync.existsSync(path.resolve(workspaceRoot, candidate))) ?? relativePath;
+        }
+    }
+    const { absolutePath } = resolveInsideWorkspace(workspaceRoot, relativePath);
+    return { resourcePath: normalized, absolutePath };
+}
+function localWorkspaceResourceDeletePaths(workspaceRoot, resourcePath) {
+    const normalized = normalizeLocalWorkspaceResourcePath(resourcePath);
+    const safePath = normalizeRelativePath(normalizeSlash(resourcePath).replace(/^\/+/, ""), "resource path");
+    if (safePath.startsWith(".agents/skills/") ||
+        safePath.startsWith(".agent/skills/") ||
+        !normalized.startsWith("skills/")) {
+        const { absolutePath } = localWorkspaceResourceAbsolutePath(workspaceRoot, resourcePath);
+        return [absolutePath];
+    }
+    const skillPath = normalized.slice("skills/".length);
+    return LOCAL_WORKSPACE_SKILL_ROOTS.map((root) => {
+        const relativePath = normalizeSlash(path.posix.join(root, skillPath));
+        return resolveInsideWorkspace(workspaceRoot, relativePath).absolutePath;
+    });
+}
+function assertNoSymlinkAbsolutePathSync(workspaceRoot, absolutePath, options = {}) {
+    const relative = path.relative(workspaceRoot, absolutePath);
+    const segments = relative.split(path.sep).filter(Boolean);
+    let current = workspaceRoot;
+    const pathsToCheck = [
+        current,
+        ...segments.map((segment) => {
+            current = path.join(current, segment);
+            return current;
+        }),
+    ];
+    for (let index = 0; index < pathsToCheck.length; index += 1) {
+        const candidate = pathsToCheck[index];
+        try {
+            const stat = fsSync.lstatSync(candidate);
+            if (stat.isSymbolicLink()) {
+                throw new Error(`Path "${candidate}" must not traverse a symlink`);
+            }
+            if (index < pathsToCheck.length - 1 && !stat.isDirectory()) {
+                throw new Error(`Path "${candidate}" is not a directory`);
+            }
+        }
+        catch (error) {
+            if (errorCode(error) === "ENOENT" && options.allowMissingLeaf)
+                return;
+            throw error;
+        }
+    }
+}
+function readLocalWorkspaceTextFile(workspaceRoot, absolutePath) {
+    assertNoSymlinkAbsolutePathSync(workspaceRoot, absolutePath);
+    const fd = fsSync.openSync(absolutePath, noFollowOpenFlags());
+    try {
+        const stat = fsSync.fstatSync(fd);
+        if (!stat.isFile()) {
+            throw new Error(`Path "${absolutePath}" is not a file`);
+        }
+        if (stat.size > LOCAL_WORKSPACE_RESOURCE_MAX_BYTES) {
+            throw new Error(`Local workspace resource "${absolutePath}" is too large to load`);
+        }
+        return {
+            content: fsSync.readFileSync(fd, "utf8"),
+            stat,
+        };
+    }
+    finally {
+        fsSync.closeSync(fd);
+    }
+}
+function localWorkspaceResourceMeta(resourcePath, absolutePath, content, stat) {
+    return {
+        id: localWorkspaceResourceId(resourcePath),
+        path: resourcePath,
+        absolutePath,
+        mimeType: mimeTypeForLocalWorkspaceResource(resourcePath),
+        sizeBytes: Buffer.byteLength(content, "utf8"),
+        hash: hashContent(content),
+        createdAt: stat.birthtime.toISOString(),
+        updatedAt: stat.mtime.toISOString(),
+        mtimeMs: stat.mtimeMs,
+    };
+}
+async function maybeLocalWorkspaceResourceMeta(workspaceRoot, resourcePath, absolutePath) {
+    if (!isSupportedLocalWorkspaceTextFile(resourcePath))
+        return null;
+    try {
+        const { content, stat } = readLocalWorkspaceTextFile(workspaceRoot, absolutePath);
+        return localWorkspaceResourceMeta(resourcePath, absolutePath, content, stat);
+    }
+    catch (error) {
+        if (errorCode(error) === "ENOENT")
+            return null;
+        throw error;
+    }
+}
+async function walkLocalWorkspaceSkillRoot(workspaceRoot, skillRoot, seenPaths) {
+    const absoluteRoot = path.join(workspaceRoot, skillRoot);
+    try {
+        assertNoSymlinkAbsolutePathSync(workspaceRoot, absoluteRoot);
+    }
+    catch (error) {
+        if (errorCode(error) === "ENOENT")
+            return [];
+        throw error;
+    }
+    const files = [];
+    async function walk(directory) {
+        let entries;
+        try {
+            entries = await fs.readdir(directory, { withFileTypes: true });
+        }
+        catch (error) {
+            if (errorCode(error) === "ENOENT")
+                return;
+            throw error;
+        }
+        for (const entry of entries) {
+            if (entry.name === ".DS_Store")
+                continue;
+            const absolutePath = path.join(directory, entry.name);
+            const relativeToSkillRoot = normalizeSlash(path.relative(absoluteRoot, absolutePath));
+            const resourcePath = normalizeSlash(path.posix.join("skills", relativeToSkillRoot));
+            if (seenPaths.has(resourcePath))
+                continue;
+            if (entry.isDirectory()) {
+                await walk(absolutePath);
+                continue;
+            }
+            if (!entry.isFile())
+                continue;
+            const meta = await maybeLocalWorkspaceResourceMeta(workspaceRoot, resourcePath, absolutePath);
+            if (!meta)
+                continue;
+            seenPaths.add(resourcePath);
+            files.push(meta);
+        }
+    }
+    await walk(absoluteRoot);
+    return files;
+}
+export async function listLocalWorkspaceResources(options = {}) {
+    const workspaceRoot = await resolveLocalWorkspaceRoot(options);
+    if (!workspaceRoot)
+        return [];
+    const seenPaths = new Set();
+    const resources = [];
+    for (const resourcePath of LOCAL_WORKSPACE_CONTROL_FILES) {
+        const { absolutePath } = localWorkspaceResourceAbsolutePath(workspaceRoot, resourcePath);
+        const meta = await maybeLocalWorkspaceResourceMeta(workspaceRoot, resourcePath, absolutePath);
+        if (!meta)
+            continue;
+        seenPaths.add(resourcePath);
+        resources.push(meta);
+    }
+    for (const skillRoot of LOCAL_WORKSPACE_SKILL_ROOTS) {
+        resources.push(...(await walkLocalWorkspaceSkillRoot(workspaceRoot, skillRoot, seenPaths)));
+    }
+    return resources.sort((a, b) => a.path.localeCompare(b.path));
+}
+export async function readLocalWorkspaceResource(options) {
+    const workspaceRoot = await resolveLocalWorkspaceRoot(options);
+    if (!workspaceRoot)
+        return null;
+    const { resourcePath, absolutePath } = localWorkspaceResourceAbsolutePath(workspaceRoot, options.path, { preferExisting: true });
+    if (!isSupportedLocalWorkspaceTextFile(resourcePath))
+        return null;
+    try {
+        const { content, stat } = readLocalWorkspaceTextFile(workspaceRoot, absolutePath);
+        return {
+            ...localWorkspaceResourceMeta(resourcePath, absolutePath, content, stat),
+            content,
+        };
+    }
+    catch (error) {
+        if (errorCode(error) === "ENOENT")
+            return null;
+        throw error;
+    }
+}
+export async function writeLocalWorkspaceResource(options) {
+    const workspaceRoot = await resolveLocalWorkspaceRoot(options);
+    if (!workspaceRoot) {
+        throw new Error("Local file mode is not enabled");
+    }
+    const { resourcePath, absolutePath } = localWorkspaceResourceAbsolutePath(workspaceRoot, options.path, { preferExisting: true });
+    if (!isSupportedLocalWorkspaceTextFile(resourcePath)) {
+        throw new Error(`Local workspace resource "${resourcePath}" is not text`);
+    }
+    return withWriteLock(absolutePath, async () => {
+        const existing = await readLocalWorkspaceResource({
+            ...options,
+            path: resourcePath,
+        });
+        if (options.ifNotExists && existing) {
+            throw new Error(`File "${resourcePath}" already exists`);
+        }
+        if (options.expectedHash &&
+            (!existing || existing.hash !== options.expectedHash)) {
+            throw new Error(`File "${resourcePath}" changed on disk. Reload before saving again.`);
+        }
+        assertNoSymlinkAbsolutePathSync(workspaceRoot, absolutePath, {
+            allowMissingLeaf: true,
+        });
+        await fs.mkdir(path.dirname(absolutePath), { recursive: true });
+        const tempPath = path.join(path.dirname(absolutePath), `.${path.basename(absolutePath)}.${process.pid}.${crypto.randomUUID()}.tmp`);
+        await fs.writeFile(tempPath, options.content, "utf8");
+        await fs.rename(tempPath, absolutePath);
+        const stat = await fs.stat(absolutePath);
+        return localWorkspaceResourceMeta(resourcePath, absolutePath, options.content, stat);
+    });
+}
+export async function deleteLocalWorkspaceResource(options) {
+    const workspaceRoot = await resolveLocalWorkspaceRoot(options);
+    if (!workspaceRoot) {
+        throw new Error("Local file mode is not enabled");
+    }
+    const absolutePaths = localWorkspaceResourceDeletePaths(workspaceRoot, options.path);
+    let deleted = false;
+    for (const absolutePath of absolutePaths) {
+        try {
+            assertNoSymlinkAbsolutePathSync(workspaceRoot, absolutePath);
+            await fs.unlink(absolutePath);
+            deleted = true;
+        }
+        catch (error) {
+            if (errorCode(error) === "ENOENT")
+                continue;
+            throw error;
+        }
+    }
+    return deleted;
+}
 //# sourceMappingURL=index.js.map