poe-code 3.0.237 → 3.0.238

package/dist/sdk/prompt-document.d.ts

@@ -0,0 +1,23 @@
+export interface PromptDocumentFileSystem {
+    readFile(filePath: string, encoding: BufferEncoding): Promise<string>;
+    realpath(filePath: string): Promise<string>;
+}
+export interface ResolvePromptDocumentInput {
+    cwd: string;
+    filePath: string;
+    content?: string;
+    optional?: boolean;
+    basePaths?: readonly string[];
+    variables?: Record<string, unknown>;
+    validate?: boolean;
+    fs?: PromptDocumentFileSystem;
+}
+export interface ResolvedPromptDocument {
+    template: string;
+    prompt: string;
+    metadata: Record<string, unknown>;
+    sources: Record<string, string>;
+    source: string;
+    chain: string[];
+}
+export declare function resolvePromptDocument(input: ResolvePromptDocumentInput): Promise<ResolvedPromptDocument>;

package/dist/sdk/prompt-document.js

@@ -0,0 +1,86 @@
+import { readFile, realpath } from "node:fs/promises";
+import path from "node:path";
+import { resolve as resolveConfigDocument } from "@poe-code/config-extends";
+const nativeFs = { readFile, realpath };
+export async function resolvePromptDocument(input) {
+    const cwd = path.resolve(input.cwd);
+    const filePath = path.resolve(cwd, input.filePath);
+    assertInsideRoot(filePath, cwd, "Prompt document path must remain inside cwd");
+    const basePaths = (input.basePaths ?? []).map((basePath) => {
+        if (!path.isAbsolute(basePath)) {
+            throw new Error(`Prompt document base paths must be absolute: ${basePath}`);
+        }
+        return path.resolve(basePath);
+    });
+    const fs = createRootedFileSystem(input.fs ?? nativeFs, [cwd, ...basePaths]);
+    const content = input.content ?? (await readDocumentContent(fs, filePath, input.optional));
+    const chain = [
+        { source: "document", filePath, content },
+        ...basePaths.map((basePath, index) => ({ source: `base-${index + 1}`, path: basePath }))
+    ];
+    const composed = await resolveConfigDocument(chain, { fs });
+    const rendered = await resolveConfigDocument(chain, {
+        fs,
+        view: input.variables ?? {},
+        validate: input.validate ?? true
+    });
+    const template = requirePrompt(composed.data.prompt, filePath);
+    const prompt = requirePrompt(rendered.data.prompt, filePath);
+    const { prompt: _ignored, ...metadata } = rendered.data;
+    void _ignored;
+    return {
+        template,
+        prompt,
+        metadata,
+        sources: rendered.sources,
+        source: filePath,
+        chain: rendered.chain
+    };
+}
+async function readDocumentContent(fs, filePath, optional) {
+    try {
+        return await fs.readFile(filePath, "utf8");
+    }
+    catch (error) {
+        if (optional && hasCode(error, "ENOENT")) {
+            return "---\nextends: true\n---\n";
+        }
+        throw error;
+    }
+}
+function createRootedFileSystem(fs, roots) {
+    return {
+        async readFile(filePath, encoding) {
+            await assertRealPathInsideOriginalRoot(fs, filePath, roots);
+            return fs.readFile(filePath, encoding);
+        },
+        realpath: (filePath) => fs.realpath(filePath)
+    };
+}
+async function assertRealPathInsideOriginalRoot(fs, filePath, roots) {
+    const resolvedPath = path.resolve(await fs.realpath(filePath));
+    const originalRoot = roots.find((root) => isInsideRoot(filePath, root));
+    if (!originalRoot || !isInsideRoot(resolvedPath, originalRoot)) {
+        throw new Error(`Prompt document path escapes configured root: ${filePath}`);
+    }
+}
+function assertInsideRoot(filePath, root, message) {
+    if (!isInsideRoot(filePath, root)) {
+        throw new Error(`${message}: ${filePath}`);
+    }
+}
+function isInsideRoot(filePath, root) {
+    const relativePath = path.relative(path.resolve(root), path.resolve(filePath));
+    return (relativePath === "" ||
+        (relativePath !== ".." && !relativePath.startsWith(`..${path.sep}`) && !path.isAbsolute(relativePath)));
+}
+function requirePrompt(value, filePath) {
+    if (typeof value !== "string") {
+        throw new Error(`Prompt document does not resolve to a Markdown prompt: ${filePath}`);
+    }
+    return value;
+}
+function hasCode(error, code) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === code;
+}
+//# sourceMappingURL=prompt-document.js.map

package/dist/sdk/prompt-document.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poe-code",
-  "version": "3.0.237",
+  "version": "3.0.238",
   "description": "CLI tool to configure Poe API for developer workflows.",
   "type": "module",
   "main": "./dist/index.js",