psyclaw 0.26.2 → 0.27.0

package/dist/src/telemetry/export.d.ts

@@ -0,0 +1,24 @@
+export interface TraceExportOptions {
+    root?: string;
+    agentDir?: string;
+    output?: string;
+    now?: () => Date;
+}
+export interface TraceExportResult {
+    schemaVersion: "psyclaw/trace-export-receipt/v1";
+    format: "otlp-json";
+    output: string;
+    traces: number;
+    spans: number;
+    sources: {
+        sessions: number;
+        workflowRuns: number;
+    };
+    privacy: {
+        contentIncluded: false;
+        originalIdsIncluded: false;
+        absolutePathsIncluded: false;
+    };
+}
+/** Export metadata-only interaction paths as an OTLP/HTTP JSON payload. */
+export declare function exportTraces(options?: TraceExportOptions): Promise<TraceExportResult>;

package/dist/src/telemetry/export.js

@@ -0,0 +1,264 @@
+import { randomBytes } from "node:crypto";
+import { mkdir, readFile, readdir } from "node:fs/promises";
+import { dirname, relative, resolve } from "node:path";
+import { getAgentDir } from "@earendil-works/pi-coding-agent";
+import { PSYCLAW_VERSION } from "../branding.js";
+import { atomicWriteFile } from "../project/jsonl.js";
+import { projectPaths } from "../project/paths.js";
+import { resolvePsyClawManifest } from "../updates/manifest.js";
+const attr = (key, value) => ({
+    key,
+    value: typeof value === "boolean"
+        ? { boolValue: value }
+        : typeof value === "number"
+            ? { intValue: String(Math.trunc(value)) }
+            : { stringValue: value },
+});
+function id(bytes) {
+    return randomBytes(bytes).toString("hex");
+}
+function timestamp(value, fallback) {
+    if (typeof value !== "string")
+        return fallback;
+    const parsed = new Date(value);
+    return Number.isNaN(parsed.getTime()) ? fallback : parsed;
+}
+function nanos(value) {
+    return (BigInt(value.getTime()) * 1000000n).toString();
+}
+function endAfter(start, candidate) {
+    if (candidate && candidate.getTime() > start.getTime())
+        return candidate;
+    return new Date(start.getTime() + 1);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+async function readJsonl(path) {
+    const text = await readFile(path, "utf8");
+    const rows = [];
+    for (const line of text.split(/\r?\n/)) {
+        if (!line.trim())
+            continue;
+        try {
+            const parsed = JSON.parse(line);
+            if (isRecord(parsed))
+                rows.push(parsed);
+        }
+        catch {
+            // A malformed historical line is omitted instead of leaking its text in
+            // an error message or preventing export of the remaining safe metadata.
+        }
+    }
+    return rows;
+}
+async function regularJsonlFiles(root) {
+    const files = [];
+    async function walk(directory) {
+        let entries;
+        try {
+            entries = await readdir(directory, { withFileTypes: true });
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return;
+            throw error;
+        }
+        for (const entry of entries) {
+            const path = resolve(directory, entry.name);
+            if (entry.isSymbolicLink())
+                continue;
+            if (entry.isDirectory())
+                await walk(path);
+            else if (entry.isFile() && entry.name.endsWith(".jsonl"))
+                files.push(path);
+        }
+    }
+    await walk(root);
+    return files.sort();
+}
+function safeToolCategory(name) {
+    if (typeof name !== "string")
+        return "other";
+    if (name === "psyclaw_workbench")
+        return "research_workbench";
+    if (name === "psyclaw_skill")
+        return "research_skill";
+    if (["read", "grep", "find", "ls"].includes(name))
+        return "file_read";
+    if (["edit", "write"].includes(name))
+        return "file_write";
+    if (["bash", "powershell"].includes(name))
+        return "shell";
+    return "other";
+}
+function toolCategories(message) {
+    const content = message.content;
+    if (!Array.isArray(content))
+        return [];
+    const categories = [];
+    for (const part of content) {
+        if (!isRecord(part))
+            continue;
+        const type = part.type;
+        if (type !== "toolCall" && type !== "tool_call" && type !== "tool_use")
+            continue;
+        categories.push(safeToolCategory(part.name ?? part.toolName));
+    }
+    return categories;
+}
+function makeSpan(options) {
+    return {
+        traceId: options.traceId,
+        spanId: id(8),
+        ...(options.parentSpanId === undefined ? {} : { parentSpanId: options.parentSpanId }),
+        name: options.name,
+        kind: 1,
+        startTimeUnixNano: nanos(options.start),
+        endTimeUnixNano: nanos(endAfter(options.start, options.end)),
+        attributes: options.attributes ?? [],
+        status: { code: options.status === "error" ? 2 : 1 },
+    };
+}
+function sessionSpans(rows, root, fallback) {
+    const header = rows.find((row) => row.type === "session");
+    if (!header || typeof header.cwd !== "string" || resolve(header.cwd) !== root)
+        return [];
+    const dated = rows.map((row) => ({ row, at: timestamp(row.timestamp, fallback) }));
+    const start = dated[0]?.at ?? fallback;
+    const end = dated.at(-1)?.at ?? start;
+    const traceId = id(16);
+    const rootSpan = makeSpan({
+        traceId,
+        name: "psyclaw.session",
+        start,
+        end,
+        attributes: [attr("psyclaw.source", "pi-session"), attr("psyclaw.version", PSYCLAW_VERSION)],
+    });
+    const spans = [rootSpan];
+    for (const { row, at } of dated) {
+        if (row.type !== "message" || !isRecord(row.message))
+            continue;
+        const role = row.message.role;
+        if (role === "user" || role === "assistant") {
+            spans.push(makeSpan({
+                traceId,
+                parentSpanId: rootSpan.spanId,
+                name: role === "user" ? "conversation.user_turn" : "conversation.assistant_turn",
+                start: at,
+                attributes: [attr("psyclaw.content_included", false)],
+                status: role === "assistant" && typeof row.message.errorMessage === "string" ? "error" : "ok",
+            }));
+        }
+        if (role === "assistant") {
+            for (const category of toolCategories(row.message)) {
+                spans.push(makeSpan({
+                    traceId,
+                    parentSpanId: rootSpan.spanId,
+                    name: `tool.${category}`,
+                    start: at,
+                    attributes: [attr("langsmith.span.kind", "tool"), attr("psyclaw.tool.category", category)],
+                }));
+            }
+        }
+    }
+    return spans;
+}
+function workflowSpans(rows, fallback) {
+    const events = rows.filter((row) => row.schemaVersion === "psyclaw/run-event/v1" && typeof row.type === "string");
+    if (events.length === 0)
+        return [];
+    const dated = events.map((row) => ({ row, at: timestamp(row.at, fallback) }));
+    const start = dated[0]?.at ?? fallback;
+    const end = dated.at(-1)?.at ?? start;
+    const traceId = id(16);
+    const blocked = events.some((row) => row.type === "blocked");
+    const rootSpan = makeSpan({
+        traceId,
+        name: "psyclaw.workflow",
+        start,
+        end,
+        status: blocked ? "error" : "ok",
+        attributes: [attr("psyclaw.source", "workflow-run"), attr("psyclaw.version", PSYCLAW_VERSION)],
+    });
+    const spans = [rootSpan];
+    for (const { row, at } of dated) {
+        const eventType = String(row.type);
+        spans.push(makeSpan({
+            traceId,
+            parentSpanId: rootSpan.spanId,
+            name: `workflow.${eventType}`,
+            start: at,
+            status: eventType === "blocked" ? "error" : "ok",
+            attributes: [attr("psyclaw.event.type", eventType)],
+        }));
+    }
+    return spans;
+}
+function safeOutput(root, requested) {
+    const output = resolve(root, requested);
+    const rel = relative(root, output).replaceAll("\\", "/");
+    if (rel === "" || rel === ".." || rel.startsWith("../")) {
+        throw new Error("Trace export output must stay inside the current project");
+    }
+    return output;
+}
+/** Export metadata-only interaction paths as an OTLP/HTTP JSON payload. */
+export async function exportTraces(options = {}) {
+    const root = resolve(options.root ?? process.cwd());
+    const output = safeOutput(root, options.output ?? "psyclaw-traces.otlp.json");
+    const fallback = options.now?.() ?? new Date();
+    const sessionsRoot = resolve(options.agentDir ?? getAgentDir(), "sessions");
+    const runRoot = projectPaths(root).runs;
+    const [sessionFiles, runFiles] = await Promise.all([
+        regularJsonlFiles(sessionsRoot),
+        regularJsonlFiles(runRoot),
+    ]);
+    const traces = [];
+    let includedSessions = 0;
+    for (const file of sessionFiles) {
+        const spans = sessionSpans(await readJsonl(file), root, fallback);
+        if (spans.length > 0) {
+            traces.push(spans);
+            includedSessions += 1;
+        }
+    }
+    let includedRuns = 0;
+    for (const file of runFiles) {
+        const spans = workflowSpans(await readJsonl(file), fallback);
+        if (spans.length > 0) {
+            traces.push(spans);
+            includedRuns += 1;
+        }
+    }
+    const manifest = await resolvePsyClawManifest();
+    const allSpans = traces.flat();
+    const payload = {
+        resourceSpans: [{
+                resource: {
+                    attributes: [
+                        attr("service.name", "psyclaw"),
+                        attr("service.version", PSYCLAW_VERSION),
+                        ...(manifest?.piVersion ? [attr("psyclaw.pi.version", manifest.piVersion)] : []),
+                        attr("psyclaw.export.content_included", false),
+                    ],
+                },
+                scopeSpans: [{
+                        scope: { name: "psyclaw.trace-export", version: PSYCLAW_VERSION },
+                        spans: allSpans,
+                    }],
+            }],
+    };
+    await mkdir(dirname(output), { recursive: true });
+    await atomicWriteFile(output, `${JSON.stringify(payload, null, 2)}\n`);
+    return {
+        schemaVersion: "psyclaw/trace-export-receipt/v1",
+        format: "otlp-json",
+        output,
+        traces: traces.length,
+        spans: allSpans.length,
+        sources: { sessions: includedSessions, workflowRuns: includedRuns },
+        privacy: { contentIncluded: false, originalIdsIncluded: false, absolutePathsIncluded: false },
+    };
+}
+//# sourceMappingURL=export.js.map

package/dist/src/telemetry/export.js.map

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

package/dist/src/tui/skill-manager.d.ts

@@ -0,0 +1,49 @@
+import type { KeybindingsManager, TUI } from "@earendil-works/pi-tui";
+import type { Theme } from "@earendil-works/pi-coding-agent";
+export type SkillManagerStatus = "core" | "enabled" | "disabled" | "missing" | "blocked";
+export interface SkillManagerItem {
+    id: string;
+    name: string;
+    description: string;
+    status: SkillManagerStatus;
+    sourceRef?: string;
+    reason?: string;
+    details?: string[];
+    configuredEnabled?: boolean;
+}
+export interface SkillManagerOptions {
+    title?: string;
+    itemLabel?: string;
+    lockedMessage?: string;
+    missingMessage?: string;
+    footer?: string;
+    enterAction?: "details" | "install";
+    enabledText?: string;
+    disabledText?: string;
+    blockedText?: string;
+}
+export type SkillManagerAction = {
+    type: "close";
+} | {
+    type: "toggle";
+    id: string;
+    enabled: boolean;
+} | {
+    type: "install";
+    id: string;
+};
+export declare class SkillManagerComponent {
+    private readonly items;
+    private readonly tui;
+    private readonly theme;
+    private readonly keybindings;
+    private readonly done;
+    private readonly options;
+    focused: boolean;
+    private selectedIndex;
+    private notice;
+    constructor(items: SkillManagerItem[], tui: TUI, theme: Theme, keybindings: KeybindingsManager, done: (action: SkillManagerAction) => void, options?: SkillManagerOptions);
+    invalidate(): void;
+    render(width: number): string[];
+    handleInput(data: string): void;
+}

package/dist/src/tui/skill-manager.js

@@ -0,0 +1,133 @@
+import { Key, matchesKey, truncateToWidth } from "@earendil-works/pi-tui";
+const MAX_VISIBLE = 10;
+function statusLabel(status) {
+    if (status === "core")
+        return "[◆]";
+    if (status === "enabled")
+        return "[●]";
+    if (status === "disabled")
+        return "[ ]";
+    if (status === "missing")
+        return "[↓]";
+    return "[!]";
+}
+function statusText(status, options) {
+    if (status === "core")
+        return "内置，始终启用";
+    if (status === "enabled")
+        return options.enabledText ?? "已启用，重启后按此配置加载";
+    if (status === "disabled")
+        return options.disabledText ?? "已安装，当前未启用";
+    if (status === "missing")
+        return "尚未安装";
+    return options.blockedText ?? "预检阻断";
+}
+export class SkillManagerComponent {
+    items;
+    tui;
+    theme;
+    keybindings;
+    done;
+    options;
+    focused = false;
+    selectedIndex = 0;
+    notice = "";
+    constructor(items, tui, theme, keybindings, done, options = {}) {
+        this.items = items;
+        this.tui = tui;
+        this.theme = theme;
+        this.keybindings = keybindings;
+        this.done = done;
+        this.options = options;
+    }
+    invalidate() { }
+    render(width) {
+        const contentWidth = Math.max(24, width - 4);
+        const enabled = this.items.filter((item) => item.status === "core" || item.status === "enabled").length;
+        const issues = this.items.filter((item) => item.status === "blocked").length;
+        const selected = this.items[this.selectedIndex];
+        const start = Math.min(Math.max(0, this.selectedIndex - Math.floor(MAX_VISIBLE / 2)), Math.max(0, this.items.length - MAX_VISIBLE));
+        const visible = this.items.slice(start, start + MAX_VISIBLE);
+        const lines = [
+            this.theme.fg("accent", this.theme.bold(this.options.title ?? "Skill 管理")),
+            this.theme.fg("dim", `${enabled} 个启用 · ${this.items.length - enabled - issues} 个可管理 · ${issues} 个需处理`),
+            "",
+        ];
+        for (const [offset, item] of visible.entries()) {
+            const active = start + offset === this.selectedIndex;
+            const prefix = active ? this.theme.fg("accent", ">") : " ";
+            const state = item.status === "blocked"
+                ? this.theme.fg("warning", statusLabel(item.status))
+                : item.status === "enabled" || item.status === "core"
+                    ? this.theme.fg("success", statusLabel(item.status))
+                    : this.theme.fg("muted", statusLabel(item.status));
+            const label = `${prefix} ${state} ${item.name}`;
+            lines.push(active ? this.theme.bold(truncateToWidth(label, contentWidth)) : truncateToWidth(label, contentWidth));
+        }
+        if (selected) {
+            lines.push("", this.theme.fg("borderMuted", "─".repeat(Math.max(1, Math.min(contentWidth, 72)))), this.theme.bold(truncateToWidth(selected.name, contentWidth)), this.theme.fg("muted", truncateToWidth(statusText(selected.status, this.options), contentWidth)), truncateToWidth(selected.description || "暂无说明", contentWidth));
+            if (selected.sourceRef)
+                lines.push(this.theme.fg("dim", truncateToWidth(`来源：${selected.sourceRef}`, contentWidth)));
+            for (const detail of selected.details ?? [])
+                lines.push(this.theme.fg("dim", truncateToWidth(detail, contentWidth)));
+            if (selected.reason)
+                lines.push(this.theme.fg("warning", truncateToWidth(`原因：${selected.reason}`, contentWidth)));
+        }
+        if (this.notice)
+            lines.push("", this.theme.fg("warning", truncateToWidth(this.notice, contentWidth)));
+        lines.push("", this.theme.fg("dim", this.options.footer ?? "↑/↓ 移动 · Space 启用/停用 · Enter 查看/安装 · Esc 关闭"));
+        return lines;
+    }
+    handleInput(data) {
+        if (this.items.length === 0) {
+            if (this.keybindings.matches(data, "tui.select.cancel"))
+                this.done({ type: "close" });
+            return;
+        }
+        if (this.keybindings.matches(data, "tui.select.cancel")) {
+            this.done({ type: "close" });
+            return;
+        }
+        if (this.keybindings.matches(data, "tui.select.up") || matchesKey(data, "k")) {
+            this.selectedIndex = (this.selectedIndex - 1 + this.items.length) % this.items.length;
+            this.notice = "";
+            this.tui.requestRender();
+            return;
+        }
+        if (this.keybindings.matches(data, "tui.select.down") || matchesKey(data, "j")) {
+            this.selectedIndex = (this.selectedIndex + 1) % this.items.length;
+            this.notice = "";
+            this.tui.requestRender();
+            return;
+        }
+        const item = this.items[this.selectedIndex];
+        if (matchesKey(data, Key.space)) {
+            if (item.status === "core")
+                this.notice = this.options.lockedMessage ?? "核心 Skill 始终启用，不能在这里停用。";
+            else if (item.status === "blocked" && item.configuredEnabled === true)
+                this.done({ type: "toggle", id: item.id, enabled: false });
+            else if (item.status === "blocked")
+                this.notice = item.reason ?? `该 ${this.options.itemLabel ?? "Skill"} 未通过来源、许可或依赖预检。`;
+            else if (item.status === "missing")
+                this.notice = this.options.missingMessage ?? "按 Enter 查看固定来源并确认安装。";
+            else
+                this.done({ type: "toggle", id: item.id, enabled: item.status === "disabled" });
+            this.tui.requestRender();
+            return;
+        }
+        if (this.keybindings.matches(data, "tui.select.confirm")) {
+            if (item.status === "missing" || this.options.enterAction === "install") {
+                this.done({ type: "install", id: item.id });
+                return;
+            }
+            if (item.status === "blocked")
+                this.notice = item.reason ?? `该 ${this.options.itemLabel ?? "Skill"} 未通过来源、许可或依赖预检。`;
+            else if (item.status === "core")
+                this.notice = "这是 PsyClaw 核心 Skill，始终加载且不会被同名第三方 Skill 覆盖。";
+            else
+                this.notice = item.sourceRef ? `固定来源：${item.sourceRef}` : "该 Skill 没有可显示的来源信息。";
+            this.tui.requestRender();
+        }
+    }
+}
+//# sourceMappingURL=skill-manager.js.map

package/dist/src/tui/skill-manager.js.map

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

package/dist/src/updates/registry.d.ts

@@ -11,6 +11,7 @@ export interface PiRelease {
 }
 export interface RegistryClient {
     latestNpm(packageName: string): Promise<string | undefined>;
+    npmDependencies(packageName: string, version: string): Promise<Record<string, string> | undefined>;
     latestPypi(packageName: string): Promise<string | undefined>;
     latestPiRelease(): Promise<PiRelease | undefined>;
 }

package/dist/src/updates/registry.js

@@ -19,6 +19,25 @@ export function createHttpRegistry(fetchFn = fetch) {
                 return undefined;
             }
         },
+        async npmDependencies(packageName, version) {
+            try {
+                const response = await fetchFn(`https://registry.npmjs.org/${encodeURIComponent(packageName)}/${encodeURIComponent(version)}`, { signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS) });
+                if (!response.ok)
+                    return undefined;
+                const body = await response.json();
+                if (!body.dependencies || typeof body.dependencies !== "object" || Array.isArray(body.dependencies))
+                    return undefined;
+                const dependencies = {};
+                for (const [name, value] of Object.entries(body.dependencies)) {
+                    if (typeof value === "string" && value.trim())
+                        dependencies[name] = value.trim();
+                }
+                return dependencies;
+            }
+            catch {
+                return undefined;
+            }
+        },
         async latestPypi(packageName) {
             try {
                 const response = await fetchFn(`https://pypi.org/pypi/${encodeURIComponent(packageName)}/json`, { signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS) });

package/dist/src/updates/registry.js.map

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

package/dist/src/updates/update.d.ts

@@ -30,14 +30,42 @@ export interface UpdateBundledPiOptions {
     packageRoot?: string;
     force?: boolean;
     now?: () => string;
-    /** When omitted, the call is a dry run and never mutates the workspace. */
+    /** When omitted, the library call is a dry run and never mutates the workspace. */
     executor?: PiUpdateExecutor;
 }
+export interface ProductVersionUpdate {
+    packageName: string;
+    before?: string;
+    after?: string;
+    latest?: string;
+}
+export interface PsyClawUpdateReceipt {
+    schemaVersion: "psyclaw/product-update/v1";
+    ok: boolean;
+    executed: boolean;
+    reasonCode: PiUpdateReason;
+    reason?: string;
+    psyclaw: ProductVersionUpdate;
+    runtime: ProductVersionUpdate;
+    commands: string[];
+    exitCode?: number;
+    startedAt: string;
+    finishedAt: string;
+}
+export type UpdatePsyClawOptions = UpdateBundledPiOptions;
+/**
+ * Update the installed PsyClaw product together with the exact Pi runtime
+ * declared by that release. Updating the whole product keeps PsyClaw's code,
+ * extensions, banner and tested runtime in one user-facing operation.
+ * Source checkouts are deliberately not overwritten; developers update them
+ * through Git and rebuild explicitly.
+ */
+export declare function updatePsyClaw(options: UpdatePsyClawOptions): Promise<PsyClawUpdateReceipt>;
 /**
  * Update the bundled Pi runtime by re-pinning both `@earendil-works/pi-*`
  * packages to the latest official release. This is the write-side counterpart
- * to `checkUpdates`: it is `--yes`/executor-gated, refuses non-semver versions,
- * and always returns a structured receipt. Without an executor it is a pure
- * plan (no workspace mutation).
+ * to `checkUpdates`: it is executor-gated, refuses non-semver versions, and
+ * always returns a structured receipt. Without an executor it is a pure plan
+ * (no workspace mutation).
  */
 export declare function updateBundledPi(options: UpdateBundledPiOptions): Promise<PiUpdateReceipt>;