pi-harness-runtime 0.10.17 → 0.10.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-harness-runtime",
-  "version": "0.10.17",
+  "version": "0.10.19",
   "description": "[BETA] Codex-style /usage status + autonomous coding harness for pi. Not production ready — expect breaking changes.",
   "type": "module",
   "scripts": {
@@ -16,16 +16,15 @@
     "auth:minimax:scrape": "bun packages/auth/src/run-minimax-auth.ts scrape",
     "skills:sync": "bun scripts/skills-sync.ts",
     "skills:sync:check": "bun scripts/skills-sync.ts --check-only",
-    "build": "for pkg in packages/*/; do [ -f \"${pkg}tsconfig.json\" ] && [ \"$pkg\" != \"packages/provider-router/\" ] && node_modules/.bin/tsc -p \"${pkg}tsconfig.json\" --skipLibCheck > /dev/null 2>&1 || true; done && node_modules/.bin/tsc -p tsconfig.harness.json --skipLibCheck > /dev/null 2>&1"
+    "build": "for pkg in packages/*/; do [ -f \"${pkg}tsconfig.json\" ] && [ \"$pkg\" != \"packages/provider-router/\" ] && node_modules/.bin/tsc -p \"${pkg}tsconfig.json\" --skipLibCheck > /dev/null 2>&1 || true; done",
+    "prepublishOnly": "bun run build"
   },
   "bin": {
     "harness-auth": "packages/auth/src/run-minimax-auth.ts"
   },
   "files": [
     "*.ts",
-    "*.js",
     "harness/**/*.ts",
-    "harness/**/*.js",
     "packages/**/src/**/*.{ts,js}",
     "packages/**/dist/**/*.{js,d.ts,js.map,d.ts.map}",
     "skills/**/*",

package/prompts/tencentdb-connect.md

@@ -0,0 +1,35 @@
+---
+description: Connect to your own TencentDB-Agent-Memory server
+argument-hint: "<action>"
+---
+# TencentDB-Agent-Memory Connection Setup
+
+## Available Actions
+
+Use `/tencentdb-connect` with one of these actions:
+
+| Action | Description |
+|--------|-------------|
+| `connect` | Connect to an existing server |
+| `deploy` | Deploy a new server |
+| `test` | Test current connection |
+| `status` | Check server health |
+
+## Connect to Existing Server
+
+Run `/tencentdb-connect connect` and provide:
+
+1. **Server URL** - Your TencentDB server address
+   - Example: `https://memory.your-domain.com`
+   
+2. **Service ID** - Usually `default`
+
+3. **User Key** - Provided by server admin
+
+## Deploy New Server
+
+Run `/tencentdb-connect deploy` for guided VPS deployment.
+
+## Test Connection
+
+Run `/tencentdb-connect test` to verify your setup.

package/prompts/tencentdb-setup.md

@@ -0,0 +1,101 @@
+---
+description: Interactively configure TencentDB-Agent-Memory connection
+argument-hint: "<server-url> [service-id] [user-key]"
+---
+# Setup TencentDB-Agent-Memory Connection
+
+${1:---}
+
+## Configuration Options
+
+**Arguments:**
+- `$1` = Server URL (e.g., `https://memory.example.com`)
+- `$2` = Service ID (default: `default`)
+- `$3` = User Key (from server admin)
+
+## Step-by-Step Setup
+
+### Step 1: Enter Server URL
+
+Please provide your TencentDB-Agent-Memory server URL:
+
+```
+https://your-server.com
+```
+
+### Step 2: Enter Service ID
+
+Enter your service ID (or press Enter for `default`):
+
+```
+default
+```
+
+### Step 3: Enter User Key
+
+Enter your user key:
+
+```
+your-user-key-here
+```
+
+## Configuration Methods
+
+### Option A: Environment File (.env)
+
+Create or update `.env` in your project:
+
+```bash
+TENANTDB_URL=${1:-https://your-server.com}
+TENANTDB_SERVICE_ID=${2:-default}
+TENANTDB_USER_KEY=${3}
+```
+
+### Option B: Settings JSON
+
+Add to `.pi/settings.json`:
+
+```json
+{
+  "tencentdb": {
+    "url": "${1:-https://your-server.com}",
+    "serviceId": "${2:-default}",
+    "userKey": "${3}"
+  }
+}
+```
+
+## Verification
+
+Test your connection:
+
+```bash
+curl -X GET "${1:-https://your-server.com}/health" \
+  -H "x-tdai-service-id: ${2:-default}" \
+  -H "x-tdai-user-key: ${3}"
+```
+
+Expected response:
+```json
+{"status": "ok", "version": "1.0.0"}
+```
+
+## Usage Examples
+
+### Search Knowledge
+```bash
+curl -X POST "${1}/api/v1/memory/search" \
+  -H "x-tdai-service-id: ${2}" \
+  -H "x-tdai-user-key: ${3}" \
+  -H "Content-Type: application/json" \
+  -d '{"query": "your search query"}'
+```
+
+### Sync Skills
+```bash
+curl -X POST "${1}/api/v1/skills/sync" \
+  -H "x-tdai-service-id: ${2}" \
+  -H "x-tdai-user-key: ${3}" \
+  -H "Content-Type: application/json" \
+  -d '{"skills": [...]}'
+```

package/prompts/tencentdb.md

@@ -0,0 +1,88 @@
+---
+description: Configure TencentDB-Agent-Memory connection
+argument-hint: "[server-url]"
+---
+# Configure TencentDB-Agent-Memory
+
+This command helps you connect to your own TencentDB-Agent-Memory server for centralized knowledge retrieval.
+
+## Options
+
+### 1. Use Default Server (Recommended for Testing)
+If you don't have your own server, you can use the public demo:
+- **URL**: `https://https://your-memory-server.example.com`
+- **Note**: This is a shared server, data may be visible to others
+
+### 2. Deploy Your Own Server
+Deploy TencentDB-Agent-Memory on your own VPS:
+
+**Minimal Requirements:**
+- 2 vCPU, 4GB RAM, 50GB SSD
+- Ubuntu 22.04 LTS
+- Docker installed
+
+**Quick Deploy:**
+```bash
+# SSH into your VPS
+ssh user@your-vps-ip
+
+# Install Docker if needed
+curl -fsSL https://get.docker.com | sh
+
+# Deploy the server
+docker run -d \
+  --name tencentdb-memory \
+  -p 8080:8080 \
+  -e OPENAI_API_KEY=your-api-key \
+  ghcr.io/tencentcloud/tdai-memory:latest
+```
+
+### 3. Connect via MCP
+After deployment, configure the MCP connection:
+
+**Server URL**: `${1:-https://your-vps-ip:8080}`
+
+**Required Headers**:
+```
+x-tdai-service-id: default
+x-tdai-user-key: YOUR_USER_KEY
+```
+
+**Available Endpoints**:
+- `POST /api/v1/memory/search` - Search knowledge base
+- `POST /api/v1/memory/conversation/search` - Search conversations
+- `GET /api/v1/health` - Health check
+
+## Configuration
+
+### Quick Setup
+
+To connect to a TencentDB-Agent-Memory server, provide:
+
+1. **Server URL** (e.g., `https://memory.example.com`)
+2. **Service ID** (usually `default`)
+3. **User Key** (from your server admin)
+
+### Environment Variables
+
+Add to your `.env` or shell profile:
+
+```bash
+# TencentDB-Agent-Memory Configuration
+TENANTDB_URL=https://your-server.com
+TENANTDB_SERVICE_ID=default
+TENANTDB_USER_KEY=your-user-key
+```
+
+## Next Steps
+
+After configuration, you can:
+
+1. **Search Knowledge**: Use `/search <query>` to find skills and documentation
+2. **Sync Skills**: Upload your local skills to the centralized server
+3. **Query Code**: Search across all indexed codebases
+
+## Need Help?
+
+- **Documentation**: https://github.com/TencentCloud/TencentDB-Agent-Memory
+- **Issues**: Report bugs on the GitHub repository

package/.versionrc.js

@@ -1,32 +0,0 @@
-// standard-version config
-// https://github.com/conventional-changelog/standard-version
-//
-// ESM version (project uses "type": "module")
-
-export default {
-	types: [
-		{ type: "feat", section: "Features" },
-		{ type: "fix", section: "Bug Fixes" },
-		{ type: "perf", section: "Performance" },
-		{ type: "refactor", section: "Refactoring" },
-		{ type: "docs", section: "Documentation" },
-		{ type: "test", section: "Tests" },
-		{ type: "ci", section: "CI/CD" },
-		{ type: "chore", section: "Maintenance", hidden: false },
-	],
-	bumpFiles: [
-		{
-			filename: "package.json",
-			type: "json",
-		},
-	],
-	packageFiles: ["package.json"],
-	bumpInChangelog: "package.json",
-	tagPrefix: "v",
-	commitUrlFormat:
-		"https://github.com/ManotLuijiu/pi-harness-runtime/commit/{{hash}}",
-	compareUrlFormat:
-		"https://github.com/ManotLuijiu/pi-harness-runtime/compare/v{{previousTag}}...v{{currentTag}}",
-	issueUrlFormat:
-		"https://github.com/ManotLuijiu/pi-harness-runtime/issues/{{id}}",
-};

package/cli.js

@@ -1,112 +0,0 @@
-/**
- * Pure helper functions — testable without pi context.
- * Imported by tracker.ts, mirror.ts, windows.ts, renderer.ts.
- */
-import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { homedir } from "node:os";
-/** Resolve the ~/.pi/usage-status/ directory. Override with PI_USAGE_DIR env var (testing). */
-export function getUsageDir() {
-    const override = process.env.PI_USAGE_DIR;
-    if (override)
-        return override;
-    return join(homedir(), ".pi", "usage-status");
-}
-/** Resolve the JSONL usage log path. */
-export function getUsageLogPath() {
-    return join(getUsageDir(), "usage.jsonl");
-}
-/** Resolve the mirror JSON path. */
-export function getMirrorPath() {
-    return join(getUsageDir(), "mirror.json");
-}
-/** Ensure the directory exists. Idempotent. */
-export function ensureUsageDir() {
-    const dir = getUsageDir();
-    if (!existsSync(dir)) {
-        mkdirSync(dir, { recursive: true });
-    }
-}
-/** Read the JSONL usage log as an array of UsageRecord. Returns [] if missing. */
-export function readJsonl(path) {
-    if (!existsSync(path))
-        return [];
-    const text = readFileSync(path, "utf-8");
-    const out = [];
-    for (const line of text.split("\n")) {
-        const trimmed = line.trim();
-        if (!trimmed)
-            continue;
-        try {
-            out.push(JSON.parse(trimmed));
-        }
-        catch {
-            // skip corrupted line
-        }
-    }
-    return out;
-}
-/** Append a single JSON line to a JSONL file. */
-export function appendJsonl(path, record) {
-    ensureUsageDir();
-    const line = JSON.stringify(record) + "\n";
-    appendFileSync(path, line, "utf-8");
-}
-/** Read JSON file safely. Returns null if missing or corrupted. */
-export function readJson(path) {
-    if (!existsSync(path))
-        return null;
-    try {
-        return JSON.parse(readFileSync(path, "utf-8"));
-    }
-    catch {
-        return null;
-    }
-}
-/** Write JSON file (creates parent dir if needed). */
-export function writeJson(path, data) {
-    ensureUsageDir();
-    if (!existsSync(dirname(path))) {
-        mkdirSync(dirname(path), { recursive: true });
-    }
-    writeFileSync(path, JSON.stringify(data, null, 2) + "\n", "utf-8");
-}
-/** Format milliseconds as "Xh Ym" or "Xd Yh" or "Xm" or "Xs". */
-export function formatDuration(ms) {
-    const abs = Math.max(0, Math.floor(ms / 1000));
-    const sec = abs % 60;
-    const min = Math.floor(abs / 60) % 60;
-    const hr = Math.floor(abs / 3600) % 24;
-    const day = Math.floor(abs / 86400);
-    if (day > 0)
-        return `${day}d ${hr}h`;
-    if (hr > 0)
-        return `${hr}h ${min}m`;
-    if (min > 0)
-        return `${min}m`;
-    return `${sec}s`;
-}
-/** Format a timestamp as relative time "X min ago". */
-export function formatRelative(fromIso, nowMs) {
-    const fromMs = Date.parse(fromIso);
-    if (isNaN(fromMs))
-        return "unknown";
-    const deltaMs = nowMs - fromMs;
-    return formatDuration(deltaMs) + " ago";
-}
-/** Format a token count with k/M suffix. */
-export function formatTokens(n) {
-    if (n < 1000)
-        return String(n);
-    if (n < 1_000_000)
-        return `${(n / 1000).toFixed(1)}k`;
-    return `${(n / 1_000_000).toFixed(2)}M`;
-}
-/** Format USD cost with 2-4 decimals depending on size. */
-export function formatUsd(n) {
-    if (n < 0.01)
-        return `$${n.toFixed(4)}`;
-    if (n < 100)
-        return `$${n.toFixed(2)}`;
-    return `$${n.toFixed(0)}`;
-}

package/footer-status.js

@@ -1,155 +0,0 @@
-import { parseContextWindowStatusLine, parseQuotaUsageStatusLine, } from "./status-parsers.ts";
-import { getProviderLabel } from "./packages/types/src/ai-providers.js";
-import { providerHasContinuousScrape, providerHasTUISignal, } from "./packages/providers/src/provider-id.js";
-export function parseFooterStatusValue(value) {
-    const quota = parseQuotaUsageStatusLine(value);
-    if (quota) {
-        return { kind: "quota", value: quota };
-    }
-    const contextWindow = parseContextWindowStatusLine(value);
-    if (contextWindow) {
-        return { kind: "context-window", value: contextWindow };
-    }
-    const todayMatch = value.match(/^today:\s*([\d,.]+)k tok\s*·\s*\$([\d,.]+)/i);
-    if (todayMatch) {
-        const tokens = Number.parseFloat(todayMatch[1].replace(/,/g, "")) * 1000;
-        const cost = Number.parseFloat(todayMatch[2].replace(/,/g, ""));
-        if (Number.isFinite(tokens) && Number.isFinite(cost)) {
-            return {
-                kind: "today",
-                value: { tokens, cost },
-            };
-        }
-    }
-    return { kind: "unknown", value: null };
-}
-/**
- * Get display label for a provider id.
- * Uses the canonical getProviderLabel() from packages/types/src/ai-providers.ts
- * which handles all 9 known providers: minimax, openai, anthropic, glm,
- * openrouter, openai-codex, deepseek, gemini, kimi.
- */
-function providerDisplayName(provider) {
-    if (!provider)
-        return "Provider";
-    return getProviderLabel(provider);
-}
-/**
- * Hint shown when the provider has no usage data yet.
- * Covers all 9 known providers from KNOWN_AI_PROVIDERS.
- */
-function missingDataHint(provider, hasCookieSource) {
-    if (!provider)
-        return "no usage source configured";
-    // MiniMax: needs cookies for continuous scrape
-    if (provider === "minimax") {
-        return hasCookieSource
-            ? "no data yet (updates after first scrape)"
-            : "drop minimax cookies into ~/.pi-harness-runtime/cookies/";
-    }
-    // TUI signal providers: one-shot signal on limit hit
-    if (providerHasTUISignal(provider)) {
-        return "no signal yet (updates on first limit hit)";
-    }
-    // Providers without any tracking implementation yet
-    // deepseek, gemini, kimi, or any unknown provider
-    if (provider === "deepseek") {
-        return "deepseek usage tracking not yet implemented";
-    }
-    if (provider === "gemini") {
-        return "gemini usage tracking not yet implemented";
-    }
-    if (provider === "kimi") {
-        return "kimi usage tracking not yet implemented";
-    }
-    // Generic fallback for any other unknown provider
-    if (!hasCookieSource)
-        return "no usage source configured";
-    return "no data yet";
-}
-/** Normalize an unknown mirror record into a ProviderMirrorRecord view. */
-function toProviderView(mirror) {
-    if (!mirror)
-        return null;
-    const m = mirror;
-    if (typeof m.provider === "string")
-        return m;
-    // Legacy flat-shape: already a single record without a provider wrapper.
-    return {
-        synced_at: m.synced_at ?? new Date().toISOString(),
-        provider: m.provider ?? "",
-        source: "scrape",
-        model: m.model,
-        h5_used_pct: m.h5_used_pct,
-        h5_resets_at: m.h5_resets_at,
-        weekly_used_pct: m.weekly_used_pct,
-        weekly_resets_at: m.weekly_resets_at,
-    };
-}
-export function buildFooterStatusValue(local, mirror, freshness, hasCookieSource = true, activeProvider = null) {
-    const view = toProviderView(mirror);
-    const provider = activeProvider ?? view?.provider ?? null;
-    const label = providerDisplayName(provider);
-    // TUI-signal exhaustion path: fires when limit is hit (one-shot signal).
-    // This takes priority over continuous data to show the most recent state.
-    if (provider &&
-        view &&
-        view.exhausted &&
-        (view.limitType !== undefined ||
-            view.resets_at !== undefined ||
-            view.h5_resets_at !== undefined)) {
-        const reset = view.resets_at ?? view.h5_resets_at ?? "soon";
-        const limitType = view.limitType ?? "tokens";
-        return `${label}: limit hit (${limitType}), reset ${reset}`;
-    }
-    // Continuous data path: providers with continuous scrape (MiniMax has 5h+weekly, OpenAI has weekly-only)
-    if (provider &&
-        providerHasContinuousScrape(provider) &&
-        view &&
-        freshness !== "expired" &&
-        (view.h5_used_pct !== undefined || view.weekly_used_pct !== undefined)) {
-        const weeklyPct = view.weekly_used_pct ?? 0;
-        const weeklyLeft = Math.max(0, 100 - weeklyPct);
-        const weeklyResets = view.weekly_resets_at ?? "soon";
-        let statusLine;
-        if (view.h5_used_pct !== undefined) {
-            // MiniMax: has both 5h and weekly windows
-            const h5Pct = view.h5_used_pct;
-            const h5Left = Math.max(0, 100 - h5Pct);
-            statusLine = `5h: ${h5Left.toFixed(0)}% left · week: ${weeklyLeft.toFixed(0)}% left`;
-        }
-        else {
-            // OpenAI: weekly-only (no 5h window)
-            statusLine = `week: ${weeklyLeft.toFixed(0)}% left (resets ${weeklyResets})`;
-        }
-        const freshnessSuffix = freshness === "fresh" || freshness === "missing" ? "" : ` · ${freshness}`;
-        return `${label}: ${statusLine}${freshnessSuffix}`;
-    }
-    // TUI signal providers (OpenAI, Anthropic, GLM, OpenRouter):
-    // Show monitoring status when we have a record but haven't hit limits.
-    // These providers only emit data when a limit is hit.
-    if (provider &&
-        providerHasTUISignal(provider) &&
-        view &&
-        freshness !== "expired") {
-        // If exhausted is not set, we're monitoring normally
-        if (!view.exhausted) {
-            return `${label}: monitoring (no limits hit)`;
-        }
-    }
-    // Discoverable hint when we have no data yet.
-    if (provider &&
-        (!view || freshness === "expired" || freshness === "missing")) {
-        const hint = missingDataHint(provider, hasCookieSource);
-        // MiniMax-on-fresh-machine still gets the cookie hint; for others
-        // the hint explains the signal-driven design.
-        if (provider === "minimax" && !hasCookieSource) {
-            return `${label}: 5h: -- (${hint})`;
-        }
-        return `${label}: 5h: -- · week: -- (${hint})`;
-    }
-    // Silent fallback: only reached if we genuinely don't know the provider.
-    // No "5h/week: --" line here because we'd be making up data.
-    const todayStr = `${(local.today.tokens / 1000).toFixed(1)}k tok · $${local.today.cost.toFixed(3)}`;
-    return `today: ${todayStr}`;
-}

package/harness/agent-handoff.js

@@ -1,123 +0,0 @@
-/**
- * Agent Handoff Protocol — RFC-0012
- *
- * Clean handoff between agents with context transfer.
- * Ensures continuity when switching agents mid-task.
- */
-import { writeJson, readJson } from "../cli.ts";
-// @ts-expect-error - Bun has built-in Node.js types
-import { join } from "node:path";
-export class AgentHandoffProtocol {
-    rootDir;
-    constructor(rootDir) {
-        this.rootDir = rootDir;
-    }
-    /**
-     * Create a handoff context for switching agents
-     */
-    createHandoff(jobId, taskId, fromAgent, toAgent, currentState) {
-        const events = this.loadHandoffHistory(jobId, taskId);
-        return {
-            jobId,
-            taskId,
-            fromAgent,
-            toAgent,
-            sharedFiles: [],
-            taskHistory: events,
-            summary: this.generateSummary(taskId, currentState),
-        };
-    }
-    /**
-     * Record a handoff event
-     */
-    recordHandoff(context, result) {
-        const path = join(this.rootDir, "jobs", context.jobId, "handoffs", `${context.taskId}.json`);
-        const event = {
-            ts: new Date().toISOString(),
-            agentId: context.toAgent,
-            action: "handoff_received",
-            result,
-        };
-        context.taskHistory.push(event);
-        writeJson(path, context);
-    }
-    /**
-     * Generate handoff prompt for the receiving agent
-     */
-    generateHandoffPrompt(context) {
-        const lines = [
-            `## Agent Handoff`,
-            ``,
-            `**From Agent:** ${context.fromAgent}`,
-            `**To Agent:** ${context.toAgent}`,
-            `**Task:** ${context.taskId}`,
-            ``,
-            `### Task History`,
-        ];
-        for (const event of context.taskHistory) {
-            lines.push(`- [${event.ts}] ${event.agentId}: ${event.action}`);
-            if (event.result) {
-                lines.push(`  Result: ${event.result}`);
-            }
-        }
-        lines.push(``);
-        lines.push(`### Summary`);
-        lines.push(context.summary);
-        if (context.sharedFiles.length > 0) {
-            lines.push(``);
-            lines.push(`### Shared Files`);
-            for (const file of context.sharedFiles) {
-                lines.push(`- ${file}`);
-            }
-        }
-        return lines.join("\n");
-    }
-    /**
-     * Validate handoff readiness
-     */
-    validateHandoff(context) {
-        const issues = [];
-        if (!context.summary) {
-            issues.push("Task summary is empty");
-        }
-        if (context.taskHistory.length === 0) {
-            issues.push("No task history recorded");
-        }
-        // Check for recent handoffs
-        const recentHandoffs = context.taskHistory.filter((h) => {
-            const age = Date.now() - Date.parse(h.ts);
-            return age < 5 * 60 * 1000; // 5 minutes
-        });
-        if (recentHandoffs.length > 3) {
-            issues.push(`Too many recent handoffs (${recentHandoffs.length}). Possible ping-pong.`);
-        }
-        return { valid: issues.length === 0, issues };
-    }
-    /**
-     * Load handoff history for a task
-     */
-    loadHandoffHistory(jobId, taskId) {
-        const path = join(this.rootDir, "jobs", jobId, "handoffs", `${taskId}.json`);
-        const data = readJson(path);
-        return data?.taskHistory ?? [];
-    }
-    /**
-     * Generate a summary of the task state
-     */
-    generateSummary(taskId, currentState) {
-        if (!currentState) {
-            return `Task ${taskId} requires continuation. Check task files for current state.`;
-        }
-        const lines = [`Task ${taskId} is in progress.`];
-        if (currentState.filesModified) {
-            lines.push(`Files modified: ${currentState.filesModified.join(", ")}`);
-        }
-        if (currentState.lastAction) {
-            lines.push(`Last action: ${currentState.lastAction}`);
-        }
-        if (currentState.blockers) {
-            lines.push(`Blockers: ${currentState.blockers}`);
-        }
-        return lines.join("\n");
-    }
-}