@zihanw/pi-forge 0.5.3 → 0.5.5

package/dist/capability-command.js

@@ -0,0 +1,164 @@
+import { formatResourceKey } from "./resource-identity.js";
+import { showText } from "./preview.js";
+const CAPABILITY_USAGE = "/capability add <text> | list | bindings | enable <[scope:]id> | enable-bound <id> | disable <activation-id> | status | reset | help";
+const CAPABILITY_VERBS = ["add", "list", "bindings", "enable", "enable-bound", "disable", "status", "reset", "help"];
+export function registerCapabilityCommand(pi, runtime) {
+    const command = {
+        description: "Manage session capabilities (no inference)",
+        getArgumentCompletions: (prefix) => capabilityArgumentCompletions(runtime, prefix),
+        handler: async (args, ctx) => {
+            await handleCapabilityCommand(runtime, args, ctx);
+        },
+    };
+    pi.registerCommand("capability", command);
+}
+async function handleCapabilityCommand(runtime, args, ctx) {
+    const { operation, value } = parseCapabilityInvocation(args);
+    try {
+        if (operation === "help") {
+            if (value.trim())
+                throw new Error(`Usage: ${CAPABILITY_USAGE}`);
+            return await showText(ctx, "pi-forge capability help", capabilityHelp());
+        }
+        if (operation === "list") {
+            assertNoValue(value);
+            return await showText(ctx, "Capability library", runtime.library(ctx));
+        }
+        if (operation === "status") {
+            assertNoValue(value);
+            return await showText(ctx, "Session capabilities", runtime.status(ctx));
+        }
+        if (operation === "bindings") {
+            assertNoValue(value);
+            const res = runtime.readBindings(ctx);
+            if (!res.ok)
+                throw new Error(res.error);
+            const content = res.bindings.length
+                ? res.bindings
+                    .map((b) => `${b.id}${b.modelCallable ? " [modelCallable]" : " [human-only]"}: ${formatResourceKey(b.ref)}${b.capability.name ? ` — ${b.capability.name}` : ""}`)
+                    .join("\n")
+                : "No capability bindings in active preset.";
+            return await showText(ctx, "Preset capability bindings", content);
+        }
+        if (operation === "enable-bound") {
+            assertSingleValue(value, "enable-bound <id>");
+            const res = runtime.enableBound(ctx, value.trim(), "user");
+            if (!res.ok)
+                throw new Error(res.error);
+            notify(ctx, res.message, "info");
+            return;
+        }
+        if (operation !== "add" && operation !== "enable" && operation !== "disable" && operation !== "reset") {
+            throw new Error(`Usage: ${CAPABILITY_USAGE}`);
+        }
+        if (operation === "reset") {
+            assertNoValue(value);
+        }
+        else if (operation !== "add") {
+            assertSingleValue(value, `${operation} <${operation === "disable" ? "activation-id" : "id"}>`);
+        }
+        else if (!value.trim()) {
+            throw new Error("Usage: /capability add <text>");
+        }
+        const result = runtime.change(ctx, operation, operation === "add" ? value : value.trim());
+        notify(ctx, result, "info");
+    }
+    catch (error) {
+        const message = `pi-forge: ${error instanceof Error ? error.message : "Capability update failed."}`;
+        if (ctx.hasUI)
+            ctx.ui.notify(message, "error");
+        else
+            console.error(message);
+    }
+}
+function capabilityArgumentCompletions(runtime, prefix) {
+    const input = prefix.trimStart();
+    if (!input)
+        return CAPABILITY_VERBS.map((verb) => ({ value: verb, label: verb }));
+    const match = input.match(/^(\S+)([\s\S]*)$/);
+    if (!match)
+        return CAPABILITY_VERBS.map((verb) => ({ value: verb, label: verb }));
+    const operation = match[1];
+    const remainder = match[2] ?? "";
+    if (!remainder && !prefix.endsWith(" ")) {
+        return CAPABILITY_VERBS
+            .filter((verb) => verb.startsWith(operation))
+            .map((verb) => ({ value: verb, label: verb }));
+    }
+    if (operation === "add")
+        return null;
+    if (!["enable", "enable-bound", "disable"].includes(operation))
+        return [];
+    const argument = remainder.trim();
+    if (argument && /\s/.test(argument))
+        return [];
+    // The command API does not pass a context to completion callbacks. The
+    // runtime retains only the current session context, and rejects a disposed
+    // or cross-session view rather than exposing stale resources.
+    const projected = runtime.completionView();
+    if (!projected.ok)
+        return [];
+    if (operation === "enable") {
+        const wantsScope = argument.includes(":");
+        return projected.capabilities
+            .map((candidate) => ({
+            selector: wantsScope || candidate.collides ? candidate.id : candidate.bareId,
+            label: candidate.label,
+        }))
+            .filter((candidate) => candidate.selector.startsWith(argument))
+            .sort((a, b) => a.selector.localeCompare(b.selector))
+            .map((candidate) => ({ value: `enable ${candidate.selector}`, label: candidate.label }));
+    }
+    if (operation === "enable-bound") {
+        return projected.bindings
+            .filter((candidate) => candidate.id.startsWith(argument))
+            .map((candidate) => ({ value: `enable-bound ${candidate.id}`, label: candidate.label }));
+    }
+    return projected.active
+        .filter((candidate) => candidate.id.startsWith(argument))
+        .map((candidate) => ({ value: `disable ${candidate.id}`, label: candidate.label }));
+}
+function parseCapabilityInvocation(args) {
+    const input = args.trimStart();
+    if (!input)
+        return { operation: "status", value: "" };
+    const match = input.match(/^(\S+)([\s\S]*)$/);
+    if (!match)
+        return { operation: "status", value: "" };
+    const operation = match[1];
+    const remainder = match[2] ?? "";
+    // Remove only the first syntax separator for add. The rest is user text,
+    // including internal and trailing whitespace.
+    return { operation, value: operation === "add" && remainder.startsWith(" ") ? remainder.slice(1) : remainder.trim() };
+}
+function assertNoValue(value) {
+    if (value.trim())
+        throw new Error(`Usage: ${CAPABILITY_USAGE}`);
+}
+function assertSingleValue(value, usage) {
+    const trimmed = value.trim();
+    if (!trimmed || /\s/.test(trimmed))
+        throw new Error(`Usage: /capability ${usage}`);
+}
+function notify(ctx, message, level) {
+    if (ctx.hasUI)
+        ctx.ui.notify(message, level);
+    else if (level === "error")
+        console.error(message);
+    else
+        console.log(message);
+}
+function capabilityHelp() {
+    return [
+        "Usage:",
+        `  ${CAPABILITY_USAGE}`,
+        "",
+        "add preserves the free-form text after the command and does not infer a capability ID.",
+        "enable completions offer bare IDs when unique, qualified selectors on collision or when ':' is typed.",
+        "enable-bound completes bindings saved on the current active preset, including human-only bindings.",
+        "disable completes exact active activation IDs; the label identifies the source and actor.",
+        "Completions use the current session and last published workspace snapshot only.",
+        "Run /capability list to explicitly reload the capability library; no watcher or per-keystroke scan is used.",
+    ].join("\n");
+}
+//# sourceMappingURL=capability-command.js.map

package/dist/capability-command.js.map

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

package/dist/capability-events.d.ts

@@ -0,0 +1,79 @@
+import { MAX_CAPABILITY_NAME_LENGTH, type CapabilityToolPatch } from "./codecs/capability.ts";
+import { type ResourceKey } from "./resource-identity.ts";
+export declare const CAPABILITY_SNAPSHOT_TYPE: "pi-forge.capability-snapshot";
+export declare const FINGERPRINT_PATTERN: RegExp;
+export declare const MAX_ID_LENGTH = 128;
+export { MAX_CAPABILITY_NAME_LENGTH };
+export declare const MAX_NAME_LENGTH = 1000;
+export type CapabilitySource = {
+    kind: "manual";
+} | {
+    kind: "capability";
+    key: ResourceKey;
+    binding?: {
+        preset: ResourceKey;
+        id: string;
+    };
+};
+export interface CapabilitySnapshot {
+    activationId: string;
+    source: CapabilitySource;
+    name?: string;
+    content: string;
+    tools: CapabilityToolPatch;
+    fingerprint: string;
+}
+export interface CapabilityActivateEvent {
+    schemaVersion: 1;
+    eventId: string;
+    op: "activate";
+    actor: "user" | "agent";
+    createdAt: number;
+    snapshot: CapabilitySnapshot;
+}
+export interface CapabilityDeactivateEvent {
+    schemaVersion: 1;
+    eventId: string;
+    op: "deactivate";
+    actor: "user" | "agent" | "lifecycle";
+    createdAt: number;
+    activationId: string;
+}
+export interface CapabilityResetEvent {
+    schemaVersion: 1;
+    eventId: string;
+    op: "reset";
+    actor: "user";
+    createdAt: number;
+}
+export type CapabilityEvent = CapabilityActivateEvent | CapabilityDeactivateEvent | CapabilityResetEvent;
+export interface ActiveCapability {
+    snapshot: CapabilitySnapshot;
+    actor: "user" | "agent";
+    eventId: string;
+    createdAt: number;
+}
+export declare function createCapabilitySnapshot(input: Omit<CapabilitySnapshot, "fingerprint">): CapabilitySnapshot;
+export declare function decodeCapabilityEvent(raw: unknown): {
+    ok: true;
+    event: CapabilityEvent;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Reduce an ordered event stream into active capability states.
+ * Note: Current reducer only validates event shape and historical actor ownership.
+ * It does not validate current Preset.modelCallable, registered tools, or top-level policy;
+ * these are deferred to downstream services, and complete authorization checking is not claimed here.
+ */
+export declare function reduceCapabilityEvents(events: readonly unknown[]): {
+    ok: true;
+    active: readonly ActiveCapability[];
+    lastEventId?: string;
+} | {
+    ok: false;
+    index: number;
+    error: string;
+};
+//# sourceMappingURL=capability-events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capability-events.d.ts","sourceRoot":"","sources":["../src/capability-events.ts"],"names":[],"mappings":"AACA,OAAO,EAGN,0BAA0B,EAE1B,KAAK,mBAAmB,EACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAGN,KAAK,WAAW,EAChB,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,wBAAwB,EAAG,8BAAuC,CAAC;AAChF,eAAO,MAAM,mBAAmB,QAA6B,CAAC;AAC9D,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC,OAAO,EAAE,0BAA0B,EAAE,CAAC;AACtC,eAAO,MAAM,eAAe,OAA6B,CAAC;AAE1D,MAAM,MAAM,gBAAgB,GACzB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IACA,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,EAAE,WAAW,CAAC;IACjB,OAAO,CAAC,EAAE;QACT,MAAM,EAAE,WAAW,CAAC;QACpB,EAAE,EAAE,MAAM,CAAC;KACX,CAAC;CACD,CAAC;AAEL,MAAM,WAAW,kBAAkB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACvC,aAAa,EAAE,CAAC,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,UAAU,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,kBAAkB,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACzC,aAAa,EAAE,CAAC,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,YAAY,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,WAAW,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACpC,aAAa,EAAE,CAAC,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,eAAe,GACxB,uBAAuB,GACvB,yBAAyB,GACzB,oBAAoB,CAAC;AAExB,MAAM,WAAW,gBAAgB;IAChC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CAClB;AAiLD,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,aAAa,CAAC,GAC5C,kBAAkB,CA0DpB;AAED,wBAAgB,qBAAqB,CACpC,GAAG,EAAE,OAAO,GACV;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA+KrE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,SAAS,OAAO,EAAE,GAExB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA+G7C"}