@zihanw/pi-forge 0.5.3 → 0.5.5

package/dist/capability-projection.js

@@ -0,0 +1,273 @@
+import { getCurrentSystemPrompt, renderSystemMessageUpdate } from "@earendil-works/pi-ai";
+import { isCapabilityDelivery, } from "./capability-protocol.js";
+import { reduceCapabilityEvents, } from "./capability-events.js";
+const BUILTIN_BASE_KEYS = new Set([
+    "preamble",
+    "tools",
+    "rules",
+    "docs",
+    "addendum",
+    "project_context",
+    "skills",
+    "cwd",
+]);
+/** Rebuild only Pi's owned base; foreign named sections/prose remain separate. */
+export function getPiBasePrompt(messages, fallback) {
+    const systems = messages.filter((message) => message.role === "system");
+    if (!systems.length)
+        return fallback;
+    return getCurrentSystemPrompt(systems.map((message, index) => ({
+        role: "system",
+        content: index === 0 ? message.content : "",
+        sections: Object.fromEntries(Object.entries(message.sections ?? {}).filter(([key]) => BUILTIN_BASE_KEYS.has(key))),
+        timestamp: message.timestamp,
+    })));
+}
+function createProjectedMessage(sections, timestamp, native) {
+    if (native) {
+        return {
+            role: "system",
+            content: "",
+            sections,
+            timestamp,
+        };
+    }
+    const updateText = renderSystemMessageUpdate({
+        role: "system",
+        content: "",
+        sections,
+        timestamp,
+    });
+    return {
+        role: "user",
+        content: `[pi-forge capability update]\n${updateText}`,
+        timestamp,
+    };
+}
+function computeDeltaSections(prev, curr) {
+    const sections = {};
+    let hasChanges = false;
+    for (const [id, content] of curr) {
+        const prevContent = prev.get(id);
+        if (prevContent === undefined || prevContent !== content) {
+            sections[`forge-capability-${id}`] = content;
+            hasChanges = true;
+        }
+    }
+    for (const [id] of prev) {
+        if (!curr.has(id)) {
+            sections[`forge-capability-${id}`] = null;
+            hasChanges = true;
+        }
+    }
+    return hasChanges ? sections : null;
+}
+function capabilityActivationIds(sections) {
+    const prefix = "forge-capability-";
+    return Object.keys(sections)
+        .filter((key) => key.startsWith(prefix))
+        .map((key) => key.slice(prefix.length));
+}
+/**
+ * Pure capability projection bridge. Replaces delivery markers with native
+ * SystemMessage or fallback UserMessage updates based on event prefixes.
+ */
+export function projectCapabilityMessages(messages, history, native, onUpdate) {
+    if (!history || typeof history !== "object" || !Array.isArray(history.events)) {
+        throw new Error("Invalid capability history: events array is required");
+    }
+    const fullReduction = reduceCapabilityEvents(history.events);
+    if (!fullReduction.ok) {
+        throw new Error(`Invalid capability events at index ${fullReduction.index}: ${fullReduction.error}`);
+    }
+    // Identical event replays are semantic no-ops, not new cursor positions.
+    const seenEvents = new Set();
+    history = { ...history, events: history.events.filter((event) => {
+            if (seenEvents.has(event.eventId))
+                return false;
+            seenEvents.add(event.eventId);
+            return true;
+        }) };
+    let checkpointIndex = -1;
+    if (history.checkpointThrough !== undefined) {
+        if (typeof history.checkpointThrough !== "string" || history.checkpointThrough.length === 0) {
+            throw new Error("Invalid checkpointThrough: must be a non-empty string");
+        }
+        checkpointIndex = history.events.findIndex((e) => e.eventId === history.checkpointThrough);
+        if (checkpointIndex === -1) {
+            throw new Error(`checkpointThrough "${history.checkpointThrough}" not found in branch events`);
+        }
+    }
+    const eventIndexMap = new Map();
+    for (let i = 0; i < history.events.length; i++) {
+        eventIndexMap.set(history.events[i].eventId, i);
+    }
+    for (const msg of messages) {
+        if (isCapabilityDelivery(msg)) {
+            const raw = msg;
+            if (!raw.details || typeof raw.details !== "object" || Array.isArray(raw.details)) {
+                throw new Error("Invalid capability delivery marker: details object is required");
+            }
+            const details = raw.details;
+            if (details.schemaVersion !== 1) {
+                throw new Error(`Invalid capability delivery marker: schemaVersion must be 1, got ${details.schemaVersion}`);
+            }
+            if (typeof details.throughEventId !== "string" || details.throughEventId.length === 0) {
+                throw new Error("Invalid capability delivery marker: throughEventId must be a non-empty string");
+            }
+            if (!eventIndexMap.has(details.throughEventId)) {
+                throw new Error(`Delivery marker cursor "${details.throughEventId}" not found in branch events`);
+            }
+        }
+    }
+    const activeCache = new Map();
+    activeCache.set(-1, new Map());
+    function getActiveMap(eventIndex) {
+        const cached = activeCache.get(eventIndex);
+        if (cached)
+            return cached;
+        const subEvents = history.events.slice(0, eventIndex + 1);
+        const res = reduceCapabilityEvents(subEvents);
+        if (!res.ok) {
+            throw new Error(`Failed to reduce event prefix: ${res.error}`);
+        }
+        const map = new Map();
+        for (const item of res.active) {
+            // Tool-only capabilities carry no capability text: never project an empty
+            // section on activation, nor a removal notice when they stop.
+            if (item.snapshot.content.trim().length === 0)
+                continue;
+            map.set(item.snapshot.activationId, item.snapshot.content);
+        }
+        activeCache.set(eventIndex, map);
+        return map;
+    }
+    let currentCursor = -1;
+    let currentState = new Map();
+    let checkpointMessage = undefined;
+    if (history.checkpointThrough !== undefined) {
+        currentCursor = checkpointIndex;
+        currentState = getActiveMap(checkpointIndex);
+        if (currentState.size > 0) {
+            const checkpointSections = {};
+            for (const [id, content] of currentState) {
+                checkpointSections[`forge-capability-${id}`] = content;
+            }
+            const checkpointTimestamp = history.events[checkpointIndex].createdAt;
+            checkpointMessage = createProjectedMessage(checkpointSections, checkpointTimestamp, native);
+            onUpdate?.(checkpointMessage, {
+                activationIds: capabilityActivationIds(checkpointSections),
+                kind: "checkpoint",
+                throughEventId: history.events[checkpointIndex].eventId,
+            });
+        }
+    }
+    const out = [];
+    for (const msg of messages) {
+        if (!isCapabilityDelivery(msg)) {
+            out.push(msg);
+            continue;
+        }
+        const markerDetails = msg.details;
+        const markerCursor = eventIndexMap.get(markerDetails.throughEventId);
+        if (history.checkpointThrough !== undefined && markerCursor <= checkpointIndex) {
+            continue;
+        }
+        if (markerCursor < currentCursor) {
+            throw new Error(`Corrupt marker cursor: marker at "${markerDetails.throughEventId}" (index ${markerCursor}) is earlier than current cursor position ${currentCursor}`);
+        }
+        if (markerCursor === currentCursor) {
+            continue;
+        }
+        const nextState = getActiveMap(markerCursor);
+        const delta = computeDeltaSections(currentState, nextState);
+        currentState = nextState;
+        currentCursor = markerCursor;
+        if (delta !== null) {
+            const timestamp = typeof msg.timestamp === "number" ? msg.timestamp : 0;
+            const projectedMessage = createProjectedMessage(delta, timestamp, native);
+            out.push(projectedMessage);
+            onUpdate?.(projectedMessage, {
+                activationIds: capabilityActivationIds(delta),
+                kind: "anchor",
+                throughEventId: markerDetails.throughEventId,
+            });
+        }
+    }
+    if (checkpointMessage !== undefined) {
+        const insertIdx = out.findIndex((m) => m.role === "system");
+        if (insertIdx !== -1) {
+            out.splice(insertIdx + 1, 0, checkpointMessage);
+        }
+        else {
+            out.unshift(checkpointMessage);
+        }
+    }
+    // Missing carriers may be queued until agent_end, or lost at a crash boundary.
+    // Replay EACH pending event: a rule rendered on the previous request still
+    // needs an instance-specific stop notice, even if the final net state is empty.
+    for (let index = currentCursor + 1; index < history.events.length; index++) {
+        const nextState = getActiveMap(index);
+        const delta = computeDeltaSections(currentState, nextState);
+        currentState = nextState;
+        if (delta !== null) {
+            const projectedMessage = createProjectedMessage(delta, history.events[index].createdAt, native);
+            out.push(projectedMessage);
+            onUpdate?.(projectedMessage, {
+                activationIds: capabilityActivationIds(delta),
+                kind: "pending",
+                throughEventId: history.events[index].eventId,
+            });
+        }
+    }
+    const throughEventId = history.events.length > 0
+        ? history.events[history.events.length - 1].eventId
+        : undefined;
+    return {
+        messages: out,
+        ...(throughEventId !== undefined ? { throughEventId } : {}),
+    };
+}
+/**
+ * Projects a preset-compiled system prompt into messages. Strips Pi builtin base
+ * sections, sets the leading System content, preserves foreign sections and tools.
+ */
+export function projectPresetSystemPrompt(messages, compiled) {
+    let headDone = false;
+    const out = [];
+    for (const m of messages) {
+        if (m.role !== "system") {
+            out.push(m);
+            continue;
+        }
+        const sysMsg = m;
+        let filteredSections = undefined;
+        if (sysMsg.sections) {
+            const remainingEntries = Object.entries(sysMsg.sections).filter(([k]) => !BUILTIN_BASE_KEYS.has(k));
+            if (remainingEntries.length > 0) {
+                filteredSections = Object.fromEntries(remainingEntries);
+            }
+        }
+        const newMsg = {
+            ...sysMsg,
+            content: headDone ? sysMsg.content : compiled,
+        };
+        if (filteredSections !== undefined) {
+            newMsg.sections = filteredSections;
+        }
+        else {
+            delete newMsg.sections;
+        }
+        headDone = true;
+        out.push(newMsg);
+    }
+    if (!headDone) {
+        out.unshift({
+            role: "system",
+            content: compiled,
+            timestamp: 0,
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=capability-projection.js.map

package/dist/capability-projection.js.map

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

package/dist/capability-protocol.d.ts

@@ -0,0 +1,21 @@
+import type { CapabilityEvent } from "./capability-events.ts";
+export declare const CAPABILITY_EVENT_ENTRY = "pi-forge-capability-event";
+export declare const CAPABILITY_TOOLS_ENTRY = "pi-forge-capability-tools";
+export declare const CAPABILITY_DELIVERY_TYPE = "pi-forge-capability-delivery";
+/** Events are authoritative. A delivery marker contains only a branch-local cursor. */
+export interface CapabilityHistory {
+    events: readonly CapabilityEvent[];
+    /** Last semantic event at/before the latest Pi compaction, if any. */
+    checkpointThrough?: string;
+}
+/**
+ * Persisted plain custom entry metadata for a capability anchor.
+ */
+export interface CapabilityAnchorData {
+    readonly schemaVersion: 1;
+    readonly throughEventId: string;
+}
+export declare function isCapabilityDelivery(message: unknown): boolean;
+/** Structural history is not ordinary dialogue for role, regex or budget filters. */
+export declare function isCapabilityControlMessage(message: unknown): boolean;
+//# sourceMappingURL=capability-protocol.d.ts.map

package/dist/capability-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-protocol.d.ts","sourceRoot":"","sources":["../src/capability-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,eAAO,MAAM,sBAAsB,8BAA8B,CAAC;AAClE,eAAO,MAAM,sBAAsB,8BAA8B,CAAC;AAClE,eAAO,MAAM,wBAAwB,iCAAiC,CAAC;AAEvE,uFAAuF;AACvF,MAAM,WAAW,iBAAiB;IACjC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IACnC,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAI9D;AAED,qFAAqF;AACrF,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAGpE"}

package/dist/capability-protocol.js

@@ -0,0 +1,15 @@
+export const CAPABILITY_EVENT_ENTRY = "pi-forge-capability-event";
+export const CAPABILITY_TOOLS_ENTRY = "pi-forge-capability-tools";
+export const CAPABILITY_DELIVERY_TYPE = "pi-forge-capability-delivery";
+export function isCapabilityDelivery(message) {
+    if (!message || typeof message !== "object")
+        return false;
+    const value = message;
+    return value.role === "custom" && value.customType === CAPABILITY_DELIVERY_TYPE;
+}
+/** Structural history is not ordinary dialogue for role, regex or budget filters. */
+export function isCapabilityControlMessage(message) {
+    return !!message && typeof message === "object"
+        && (message.role === "system" || isCapabilityDelivery(message));
+}
+//# sourceMappingURL=capability-protocol.js.map

package/dist/capability-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-protocol.js","sourceRoot":"","sources":["../src/capability-protocol.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAG,2BAA2B,CAAC;AAClE,MAAM,CAAC,MAAM,sBAAsB,GAAG,2BAA2B,CAAC;AAClE,MAAM,CAAC,MAAM,wBAAwB,GAAG,8BAA8B,CAAC;AAiBvE,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACpD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1D,MAAM,KAAK,GAAG,OAAmD,CAAC;IAClE,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,KAAK,wBAAwB,CAAC;AACjF,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,0BAA0B,CAAC,OAAgB;IAC1D,OAAO,CAAC,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;WAC3C,CAAE,OAA8B,CAAC,IAAI,KAAK,QAAQ,IAAI,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;AAC1F,CAAC"}

package/dist/capability-state.d.ts

@@ -0,0 +1,74 @@
+import type { CapabilityToolPatch } from "./codecs/capability.ts";
+import type { SessionCacheUsageView } from "./session-usage.ts";
+/** A derived session view, never a second persisted capability state. */
+export interface CapabilityStateGuard {
+    sessionId: string;
+    leafId: string | null;
+    revision: string;
+}
+export interface CapabilityChoice {
+    kind: "capability" | "binding";
+    id: string;
+    label: string;
+    content: string;
+    tools: CapabilityToolPatch;
+    fingerprint: string;
+    problem?: string;
+}
+export interface CapabilityStateView {
+    guard: CapabilityStateGuard;
+    /** Active loaded Preset fingerprint for inspection freshness, not a write receipt. */
+    presetRevision?: string;
+    trusted: boolean;
+    restoring: boolean;
+    delivery: "none" | "pending" | "prepared";
+    textPresentation: "native" | "user";
+    effectiveTools: string[];
+    /** Read-only provider-reported usage for the current branch; absent when unavailable. */
+    cacheUsage?: SessionCacheUsageView;
+    problem?: string;
+    active: Array<{
+        activationId: string;
+        source: string;
+        name?: string;
+        actor: "user" | "agent";
+        content: string;
+        tools: CapabilityToolPatch;
+    }>;
+}
+export type CapabilityStateMutation = {
+    action: "disable";
+    activationId: string;
+    guard: CapabilityStateGuard;
+} | {
+    action: "reset";
+    guard: CapabilityStateGuard;
+};
+export interface CapabilityEnableRequest {
+    guard: CapabilityStateGuard;
+    kind: "capability" | "binding";
+    id: string;
+    fingerprint: string;
+}
+export type CapabilityAvailableResult = {
+    ok: true;
+    state: CapabilityStateView;
+    choices: CapabilityChoice[];
+} | {
+    ok: false;
+    status: number;
+    error: string;
+};
+export type CapabilityStateResult = {
+    ok: true;
+    state: CapabilityStateView;
+} | {
+    ok: false;
+    status: number;
+    error: string;
+};
+/** Exact input validation is shared by HTTP and direct application callers. */
+export declare function isCapabilityStateMutation(value: unknown): value is CapabilityStateMutation;
+/** Exact validation for the guarded, human-only activation operation. */
+export declare function isCapabilityEnableRequest(value: unknown): value is CapabilityEnableRequest;
+//# sourceMappingURL=capability-state.d.ts.map

package/dist/capability-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-state.d.ts","sourceRoot":"","sources":["../src/capability-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,yEAAyE;AACzE,MAAM,WAAW,oBAAoB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,YAAY,GAAG,SAAS,CAAC;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IACnC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,sFAAsF;IACtF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;IAC1C,gBAAgB,EAAE,QAAQ,GAAG,MAAM,CAAC;IACpC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,yFAAyF;IACzF,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QACxB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,mBAAmB,CAAC;KAC3B,CAAC,CAAC;CACH;AAED,MAAM,MAAM,uBAAuB,GAChC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAA;CAAE,GACxE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAEpD,MAAM,WAAW,uBAAuB;IACvC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,IAAI,EAAE,YAAY,GAAG,SAAS,CAAC;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,yBAAyB,GAClC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAC;IAAC,OAAO,EAAE,gBAAgB,EAAE,CAAA;CAAE,GACrE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhD,MAAM,MAAM,qBAAqB,GAC9B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,GACxC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhD,+EAA+E;AAC/E,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,uBAAuB,CAW1F;AAED,yEAAyE;AACzE,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,uBAAuB,CAM1F"}

package/dist/capability-state.js

@@ -0,0 +1,43 @@
+/** Exact input validation is shared by HTTP and direct application callers. */
+export function isCapabilityStateMutation(value) {
+    if (!plain(value))
+        return false;
+    const keys = value.action === "disable" ? ["action", "activationId", "guard"] : ["action", "guard"];
+    if (value.action !== "disable" && value.action !== "reset")
+        return false;
+    if (Object.keys(value).some((key) => !keys.includes(key)))
+        return false;
+    if (value.action === "disable" && !text(value.activationId, 128))
+        return false;
+    const guard = value.guard;
+    return plain(guard) && Object.keys(guard).length === 3
+        && Object.keys(guard).every((key) => ["sessionId", "leafId", "revision"].includes(key))
+        && text(guard.sessionId, 1024) && (guard.leafId === null || text(guard.leafId, 1024))
+        && text(guard.revision, 256);
+}
+/** Exact validation for the guarded, human-only activation operation. */
+export function isCapabilityEnableRequest(value) {
+    if (!plain(value) || Object.keys(value).length !== 4)
+        return false;
+    if (Object.keys(value).some((key) => !["guard", "kind", "id", "fingerprint"].includes(key)))
+        return false;
+    if (value.kind !== "capability" && value.kind !== "binding")
+        return false;
+    if (!text(value.id, 128) || !text(value.fingerprint, 256))
+        return false;
+    return isGuard(value.guard);
+}
+function isGuard(value) {
+    return plain(value) && Object.keys(value).length === 3
+        && Object.keys(value).every((key) => ["sessionId", "leafId", "revision"].includes(key))
+        && text(value.sessionId, 1024) && (value.leafId === null || text(value.leafId, 1024))
+        && text(value.revision, 256);
+}
+function text(value, max) {
+    return typeof value === "string" && value.length > 0 && value.length <= max && !/[\x00-\x1f\x7f]/.test(value);
+}
+function plain(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value)
+        && (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);
+}
+//# sourceMappingURL=capability-state.js.map

package/dist/capability-state.js.map

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

package/dist/capability-tool.d.ts

@@ -0,0 +1,11 @@
+import { Type, type Static } from "@earendil-works/pi-ai";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { CapabilityRuntime } from "./runtime/capability-runtime.ts";
+export declare const FORGE_CAPABILITY_TOOL_NAME = "forge_capability";
+export declare const ForgeCapabilityParameters: Type.TObject<{
+    action: Type.TUnion<[Type.TLiteral<"list">, Type.TLiteral<"status">, Type.TLiteral<"enable">, Type.TLiteral<"disable">]>;
+    id: Type.TOptional<Type.TString>;
+}>;
+export type ForgeCapabilityParams = Static<typeof ForgeCapabilityParameters>;
+export declare function registerCapabilityTool(pi: ExtensionAPI, runtime: CapabilityRuntime): void;
+//# sourceMappingURL=capability-tool.d.ts.map

package/dist/capability-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-tool.d.ts","sourceRoot":"","sources":["../src/capability-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,eAAO,MAAM,0BAA0B,qBAAqB,CAAC;AAE7D,eAAO,MAAM,yBAAyB;;;EAgBrC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE7E,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAYzF"}

package/dist/capability-tool.js

@@ -0,0 +1,25 @@
+import { Type } from "@earendil-works/pi-ai";
+export const FORGE_CAPABILITY_TOOL_NAME = "forge_capability";
+export const ForgeCapabilityParameters = Type.Object({
+    action: Type.Union([
+        Type.Literal("list"),
+        Type.Literal("status"),
+        Type.Literal("enable"),
+        Type.Literal("disable"),
+    ], { description: "Capability action: list, status, enable, or disable." }),
+    id: Type.Optional(Type.String({ maxLength: 128, description: "Preset-bound capability binding ID to enable or disable." })),
+}, { additionalProperties: false });
+export function registerCapabilityTool(pi, runtime) {
+    pi.registerTool({
+        name: FORGE_CAPABILITY_TOOL_NAME,
+        label: "Capability",
+        description: "Use only capabilities authorized by the active Preset: list, status, enable by binding ID, or disable your own Agent-owned activation. Requires a trusted project and current authorization on every call. Cannot add arbitrary rules, reset, or stop human-owned capabilities.",
+        parameters: ForgeCapabilityParameters,
+        execute: async (toolCallId, params, signal, onUpdate, ctx) => {
+            if (!ctx)
+                throw new Error("forge_capability requires an active extension context.");
+            return await runtime.executeAgentTool(ctx, params);
+        },
+    });
+}
+//# sourceMappingURL=capability-tool.js.map

package/dist/capability-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-tool.js","sourceRoot":"","sources":["../src/capability-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAe,MAAM,uBAAuB,CAAC;AAI1D,MAAM,CAAC,MAAM,0BAA0B,GAAG,kBAAkB,CAAC;AAE7D,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC,MAAM,CACnD;IACC,MAAM,EAAE,IAAI,CAAC,KAAK,CACjB;QACC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QACtB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QACtB,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;KACvB,EACD,EAAE,WAAW,EAAE,sDAAsD,EAAE,CACvE;IACD,EAAE,EAAE,IAAI,CAAC,QAAQ,CAChB,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,0DAA0D,EAAE,CAAC,CACxG;CACD,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAC/B,CAAC;AAIF,MAAM,UAAU,sBAAsB,CAAC,EAAgB,EAAE,OAA0B;IAClF,EAAE,CAAC,YAAY,CAAC;QACf,IAAI,EAAE,0BAA0B;QAChC,KAAK,EAAE,YAAY;QACnB,WAAW,EACV,iRAAiR;QAClR,UAAU,EAAE,yBAAyB;QACrC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE;YAC5D,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;YACpF,OAAO,MAAM,OAAO,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACpD,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/capability-web-host.d.ts

@@ -0,0 +1,11 @@
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { type LoadedCapability } from "./codecs/capability.ts";
+import type { LoadedPromptStack } from "./types.ts";
+import type { WebEditorCapabilityOperation, WebEditorCapabilityResult } from "./web-editor/types.ts";
+export interface CapabilityWebResources {
+    readCapabilities?(): readonly LoadedCapability[];
+    getStacks(): LoadedPromptStack[];
+}
+/** Optional Web adapter; Workspace/repositories and the existing resolver retain ownership. */
+export declare function capabilityOperation(ctx: ExtensionContext, runtime: CapabilityWebResources, action: WebEditorCapabilityOperation, selector?: string, input?: unknown): WebEditorCapabilityResult;
+//# sourceMappingURL=capability-web-host.d.ts.map

package/dist/capability-web-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-web-host.d.ts","sourceRoot":"","sources":["../src/capability-web-host.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAgE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAK7H,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAA4B,4BAA4B,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAE/H,MAAM,WAAW,sBAAsB;IACtC,gBAAgB,CAAC,IAAI,SAAS,gBAAgB,EAAE,CAAC;IACjD,SAAS,IAAI,iBAAiB,EAAE,CAAC;CACjC;AAOD,+FAA+F;AAC/F,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,sBAAsB,EACzF,MAAM,EAAE,4BAA4B,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,yBAAyB,CA0EpG"}

package/dist/capability-web-host.js

@@ -0,0 +1,105 @@
+import { createHash } from "node:crypto";
+import { join } from "node:path";
+import { serializeCapability } from "./codecs/capability.js";
+import { createResourceCatalog } from "./catalog.js";
+import { resolveCapability, resolveCapabilityBindings } from "./capabilities.js";
+import { formatResourceKey, parseResourceSelector, isValidResourceId } from "./resource-identity.js";
+import { deleteCapabilityFile, globalCapabilitiesDir, capabilitiesDir, writeCapabilityFile } from "./repositories/capability.js";
+function objectWithKeys(input, keys) {
+    return !!input && typeof input === "object" && !Array.isArray(input)
+        && Object.keys(input).every(key => keys.includes(key));
+}
+/** Optional Web adapter; Workspace/repositories and the existing resolver retain ownership. */
+export function capabilityOperation(ctx, runtime, action, selector, input) {
+    try {
+        const trusted = ctx.isProjectTrusted();
+        if (!runtime.readCapabilities)
+            return { ok: false, status: 503, error: "Capability resources unavailable." };
+        if (["create", "save", "delete"].includes(action) && !trusted)
+            return { ok: false, status: 403, error: "Project is not trusted; capability writes are disabled." };
+        const capabilities = runtime.readCapabilities().filter(capability => trusted || capability.scope === "global");
+        const catalog = createResourceCatalog([...capabilities]);
+        const entry = (loaded) => {
+            const sourceRevision = loaded.sourceRevision ?? "";
+            return { selector: formatResourceKey(loaded.key), scope: loaded.scope, filePath: loaded.filePath,
+                capability: loaded.capability, diagnostics: loaded.diagnostics, sourceRevision };
+        };
+        if (action === "list")
+            return { ok: true, trusted, capabilities: capabilities.map(entry) };
+        if (action === "effective") {
+            if (!objectWithKeys(input, ["presetSelector", "bindings"]) || typeof input.presetSelector !== "string" || !Array.isArray(input.bindings)) {
+                return { ok: false, status: 400, error: "Expected presetSelector and bindings." };
+            }
+            const preset = runtime.getStacks().filter(stack => formatResourceKey(stack.key) === input.presetSelector && (trusted || stack.scope === "global"));
+            if (preset.length !== 1)
+                return { ok: false, status: 404, error: "Unknown or ambiguous qualified Preset selector." };
+            const resolved = resolveCapabilityBindings(catalog, preset[0].key, input.bindings);
+            if (!resolved.ok)
+                return { ok: false, status: 400, error: resolved.error };
+            return { ok: true, bindings: resolved.bindings.map(binding => {
+                    const source = resolveCapability(catalog, formatResourceKey(binding.ref));
+                    if (!source.ok)
+                        throw new Error(source.error);
+                    return { id: binding.id, ref: formatResourceKey(binding.ref), modelCallable: binding.modelCallable,
+                        source: source.loaded.capability, effective: binding.capability };
+                }) };
+        }
+        if (action === "create") {
+            if (!objectWithKeys(input, ["scope", "capability"]) || (input.scope !== "global" && input.scope !== "project") || !input.capability || typeof input.capability !== "object") {
+                return { ok: false, status: 400, error: "Expected explicit scope and capability." };
+            }
+            const capability = input.capability;
+            if (typeof capability.id !== "string" || !isValidResourceId(capability.id))
+                return { ok: false, status: 400, error: "Invalid capability ID." };
+            if (capabilities.some(item => item.scope === input.scope && item.key.id === capability.id))
+                return { ok: false, status: 409, error: "Capability ID already exists in this scope." };
+            const path = join(input.scope === "global" ? globalCapabilitiesDir() : capabilitiesDir(ctx.cwd), `${capability.id}.json`);
+            const result = writeCapabilityFile(ctx.cwd, input.scope, path, capability, { overwrite: false });
+            if (!result.ok)
+                return mutationFailure(result);
+            runtime.readCapabilities();
+            return {
+                ok: true,
+                changed: formatResourceKey({ scope: input.scope, id: capability.id }),
+                sourceRevision: createHash("sha256").update(serializeCapability(capability)).digest("hex"),
+            };
+        }
+        const parsed = parseResourceSelector(selector ?? "");
+        if (!parsed.ok || !parsed.selector.scope)
+            return { ok: false, status: 400, error: "A qualified capability selector is required." };
+        const matches = capabilities.filter(item => formatResourceKey(item.key) === selector);
+        if (matches.length !== 1)
+            return { ok: false, status: matches.length ? 409 : 404, error: "Unknown or ambiguous capability." };
+        const loaded = matches[0];
+        if (action === "get")
+            return { ok: true, ...entry(loaded) };
+        if (!objectWithKeys(input, action === "delete" ? ["expectedSourceRevision"] : ["capability", "expectedSourceRevision"])
+            || typeof input.expectedSourceRevision !== "string" || !/^[a-f0-9]{64}$/.test(input.expectedSourceRevision)) {
+            return { ok: false, status: 400, error: "A valid expectedSourceRevision is required." };
+        }
+        if (action === "save" && (!input.capability || typeof input.capability !== "object" || input.capability.id !== loaded.capability.id)) {
+            return { ok: false, status: 400, error: "Capability ID is immutable during save." };
+        }
+        const options = { overwrite: true, expectedSourceRevision: input.expectedSourceRevision };
+        const result = action === "delete"
+            ? deleteCapabilityFile(ctx.cwd, loaded.scope, loaded.filePath, options)
+            : writeCapabilityFile(ctx.cwd, loaded.scope, loaded.filePath, input.capability, options);
+        if (!result.ok)
+            return mutationFailure(result);
+        runtime.readCapabilities();
+        return {
+            ok: true,
+            changed: selector,
+            ...(action === "save" ? {
+                sourceRevision: createHash("sha256").update(serializeCapability(input.capability)).digest("hex"),
+            } : {}),
+        };
+    }
+    catch (error) {
+        return { ok: false, status: 503, error: error instanceof Error ? error.message : "Capability resources unavailable." };
+    }
+}
+function mutationFailure(result) {
+    return { ok: false, status: result.reason === "conflict" ? 409 : result.reason === "invalid-path" ? 403 : result.reason === "invalid-capability" ? 400 : 500, error: result.error };
+}
+//# sourceMappingURL=capability-web-host.js.map