@zihanw/pi-forge 0.4.0 → 0.5.0

package/dist/codecs/agent-profile.js

@@ -0,0 +1,176 @@
+import { basename } from "node:path";
+import { isValidResourceId, parseResourceSelector, } from "../resource-identity.js";
+export const AGENT_PROFILE_TYPE = "pi-forge.agent-profile";
+export const AGENT_PROFILE_THINKING_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
+const VALID_THINKING_LEVELS = new Set(AGENT_PROFILE_THINKING_LEVELS);
+const PROFILE_FIELDS = new Set(["schemaVersion", "type", "id", "name", "description", "model", "thinkingLevel", "promptStack", "autoActivate"]);
+const MODEL_FIELDS = new Set(["provider", "id"]);
+/**
+ * Parse, normalize, and validate an agent profile from its serialized source.
+ * This is the single entry point for turning profile JSON text into a
+ * LoadedAgentProfile; loaders only add file-system concerns on top.
+ */
+export function parseAgentProfile(source, filePath, scope) {
+    const diagnostics = [];
+    let raw;
+    try {
+        raw = JSON.parse(source);
+    }
+    catch (error) {
+        return createAgentProfileFault(filePath, scope, `Failed to parse JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const profile = normalizeAgentProfile(raw, filePath, diagnostics);
+    diagnostics.push(...validateAgentProfile(profile));
+    return { filePath, scope, key: { scope, id: profile.id }, profile, diagnostics };
+}
+/** Build a fail-closed LoadedAgentProfile when the source cannot be read or parsed. */
+export function createAgentProfileFault(filePath, scope, message) {
+    return {
+        filePath,
+        scope,
+        key: { scope, id: basename(filePath, ".json") },
+        profile: fallbackProfile(filePath),
+        diagnostics: [{ level: "error", message }],
+    };
+}
+/**
+ * Single canonical serializer for agent profiles. Every writer (profile
+ * service, command, repository) must go through this function so serialized
+ * output stays identical across all write paths.
+ */
+export function serializeAgentProfile(profile) {
+    return `${JSON.stringify(profile, null, 2)}\n`;
+}
+function normalizeAgentProfile(raw, filePath, diagnostics) {
+    if (!isPlainObject(raw)) {
+        diagnostics.push({ level: "error", message: "Agent profile root must be a JSON object." });
+        return fallbackProfile(filePath);
+    }
+    for (const field of Object.keys(raw)) {
+        if (!PROFILE_FIELDS.has(field))
+            diagnostics.push({ level: "error", field, message: `Unsupported profile field: ${field}` });
+    }
+    if (raw.schemaVersion !== 1)
+        diagnostics.push({ level: "error", field: "schemaVersion", message: "schemaVersion must be 1." });
+    if (raw.type !== AGENT_PROFILE_TYPE)
+        diagnostics.push({ level: "error", field: "type", message: `type must be "${AGENT_PROFILE_TYPE}".` });
+    const id = nonEmptyString(raw.id);
+    if (!id)
+        diagnostics.push({ level: "error", field: "id", message: "Profile id must be a non-empty string." });
+    const model = normalizeModelReference(raw.model, diagnostics);
+    const thinkingLevel = normalizeThinkingLevel(raw.thinkingLevel, diagnostics);
+    const promptStack = normalizePromptStackReference(raw, diagnostics);
+    if (raw.name !== undefined && typeof raw.name !== "string")
+        diagnostics.push({ level: "error", field: "name", message: "name must be a string when provided." });
+    if (raw.description !== undefined && typeof raw.description !== "string") {
+        diagnostics.push({ level: "error", field: "description", message: "description must be a string when provided." });
+    }
+    if (raw.autoActivate !== undefined && typeof raw.autoActivate !== "boolean") {
+        diagnostics.push({ level: "error", field: "autoActivate", message: "autoActivate must be a boolean when provided." });
+    }
+    return {
+        schemaVersion: 1,
+        type: AGENT_PROFILE_TYPE,
+        id: id ?? basename(filePath, ".json"),
+        name: typeof raw.name === "string" ? raw.name : undefined,
+        description: typeof raw.description === "string" ? raw.description : undefined,
+        autoActivate: typeof raw.autoActivate === "boolean" ? raw.autoActivate : undefined,
+        model,
+        thinkingLevel,
+        promptStack,
+    };
+}
+function normalizeModelReference(raw, diagnostics) {
+    if (!isPlainObject(raw)) {
+        diagnostics.push({ level: "error", field: "model", message: "model must be an object containing provider and id." });
+        return { provider: "", id: "" };
+    }
+    for (const field of Object.keys(raw)) {
+        if (!MODEL_FIELDS.has(field))
+            diagnostics.push({ level: "error", field: `model.${field}`, message: `Unsupported model field: ${field}` });
+    }
+    const provider = nonEmptyString(raw.provider);
+    const id = nonEmptyString(raw.id);
+    return { provider: provider ?? "", id: id ?? "" };
+}
+function normalizeThinkingLevel(raw, diagnostics) {
+    if (typeof raw === "string" && VALID_THINKING_LEVELS.has(raw))
+        return raw;
+    diagnostics.push({
+        level: "error",
+        field: "thinkingLevel",
+        message: `thinkingLevel must be one of: ${AGENT_PROFILE_THINKING_LEVELS.join(", ")}.`,
+    });
+    return "off";
+}
+function normalizePromptStackReference(raw, diagnostics) {
+    if (!Object.prototype.hasOwnProperty.call(raw, "promptStack")) {
+        diagnostics.push({ level: "error", field: "promptStack", message: "promptStack is required and must be a stack id or null." });
+        return null;
+    }
+    if (raw.promptStack === null)
+        return null;
+    const id = nonEmptyString(raw.promptStack);
+    if (id)
+        return id;
+    diagnostics.push({ level: "error", field: "promptStack", message: "promptStack must be a non-empty stack id or null." });
+    return null;
+}
+function fallbackProfile(filePath) {
+    return {
+        schemaVersion: 1,
+        type: AGENT_PROFILE_TYPE,
+        id: basename(filePath, ".json"),
+        model: { provider: "", id: "" },
+        thinkingLevel: "off",
+        promptStack: null,
+    };
+}
+function nonEmptyString(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+function isPlainObject(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+export function validateAgentProfile(profile) {
+    const diagnostics = [];
+    if (profile.schemaVersion !== 1)
+        diagnostics.push({ level: "error", field: "schemaVersion", message: "schemaVersion must be 1." });
+    if (profile.type !== AGENT_PROFILE_TYPE)
+        diagnostics.push({ level: "error", field: "type", message: `type must be "${AGENT_PROFILE_TYPE}".` });
+    if (!isValidResourceId(profile.id)) {
+        diagnostics.push({
+            level: "error",
+            field: "id",
+            message: "Profile id must start with a letter or number and contain only letters, numbers, dots, underscores, and hyphens.",
+        });
+    }
+    if (!profile.model.provider.trim())
+        diagnostics.push({ level: "error", field: "model.provider", message: "model.provider must not be empty." });
+    if (!profile.model.id.trim())
+        diagnostics.push({ level: "error", field: "model.id", message: "model.id must not be empty." });
+    if (!VALID_THINKING_LEVELS.has(profile.thinkingLevel)) {
+        diagnostics.push({ level: "error", field: "thinkingLevel", message: `Unsupported thinkingLevel: ${String(profile.thinkingLevel)}` });
+    }
+    if (profile.promptStack !== null && !profile.promptStack.trim()) {
+        diagnostics.push({ level: "error", field: "promptStack", message: "promptStack must be a non-empty stack id or null." });
+    }
+    return diagnostics;
+}
+export function validateAgentProfilePromptStackScope(profile, scope) {
+    if (profile.promptStack === null)
+        return [];
+    const parsed = parseResourceSelector(profile.promptStack);
+    if (!parsed.ok) {
+        return [{ level: "error", field: "promptStack", message: parsed.error }];
+    }
+    if (scope === "global" && parsed.selector.scope === "project") {
+        return [{
+                level: "error",
+                field: "promptStack",
+                message: `Global profile ${profile.id} cannot reference project prompt stack ${parsed.selector.id}.`,
+            }];
+    }
+    return [];
+}
+//# sourceMappingURL=agent-profile.js.map

package/dist/codecs/agent-profile.js.map

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

package/dist/codecs/index.d.ts

@@ -0,0 +1,5 @@
+export { createPromptStackFault, parsePromptStack, serializePromptStack, validatePromptStack, } from "./prompt-stack.ts";
+export type { PromptStackScope } from "./prompt-stack.ts";
+export { createAgentProfileFault, parseAgentProfile, serializeAgentProfile, validateAgentProfile, validateAgentProfilePromptStackScope, } from "./agent-profile.ts";
+export type { AgentProfileScope } from "./agent-profile.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/codecs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/codecs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EACN,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,oCAAoC,GACpC,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/codecs/index.js

@@ -0,0 +1,3 @@
+export { createPromptStackFault, parsePromptStack, serializePromptStack, validatePromptStack, } from "./prompt-stack.js";
+export { createAgentProfileFault, parseAgentProfile, serializeAgentProfile, validateAgentProfile, validateAgentProfilePromptStackScope, } from "./agent-profile.js";
+//# sourceMappingURL=index.js.map

package/dist/codecs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/codecs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACN,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,oCAAoC,GACpC,MAAM,oBAAoB,CAAC"}

package/dist/codecs/prompt-stack.d.ts

@@ -0,0 +1,18 @@
+import type { LoadedPromptStack, PromptStack, PromptStackDiagnostic } from "../types.ts";
+export type PromptStackScope = "global" | "project";
+/**
+ * Parse, normalize, and validate a prompt stack from its serialized source.
+ * This is the single entry point for turning stack JSON text into a
+ * LoadedPromptStack; loaders only add file-system concerns on top.
+ */
+export declare function parsePromptStack(source: string, filePath: string, scope: PromptStackScope): LoadedPromptStack;
+/** Build a fail-closed LoadedPromptStack when the source cannot be read or parsed. */
+export declare function createPromptStackFault(filePath: string, scope: PromptStackScope, message: string): LoadedPromptStack;
+/**
+ * Single canonical serializer for prompt stacks. Every writer (web host,
+ * repository, migration tooling) must go through this function so serialized
+ * output stays identical across all write paths.
+ */
+export declare function serializePromptStack(stack: PromptStack): string;
+export declare function validatePromptStack(stack: PromptStack): PromptStackDiagnostic[];
+//# sourceMappingURL=prompt-stack.d.ts.map

package/dist/codecs/prompt-stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-stack.d.ts","sourceRoot":"","sources":["../../src/codecs/prompt-stack.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACX,iBAAiB,EAEjB,WAAW,EACX,qBAAqB,EAIrB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAKpD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,iBAAiB,CAiC7G;AAcD,sFAAsF;AACtF,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,MAAM,GACb,iBAAiB,CAQnB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAE/D;AAuGD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,qBAAqB,EAAE,CA2D/E"}