pi-harness-runtime 1.1.18 → 1.1.26

package/packages/skill-mcp-client/src/client.ts

@@ -0,0 +1,171 @@
+/**
+ * Skill MCP Client Implementation (RFC-0106)
+ */
+
+import { fetch } from "undici";
+import type {
+  ListSkillsParams,
+  ListSkillsResult,
+  GetSkillParams,
+  GetSkillResult,
+  SyncSkillsParams,
+  SyncSkillsResult,
+  SkillVersionsResult,
+  HealthResult,
+  MCPRequest,
+  MCPResponse,
+} from "./types.js";
+import { SkillAPIError } from "./errors.js";
+import { ErrorCodes } from "./types.js";
+
+const DEFAULT_TIMEOUT_MS = 10000;
+const DEFAULT_MAX_RESULTS = 20;
+
+export interface SkillMCPClientConfig {
+  /** Server URL (e.g., https://api.skills.example.com) */
+  serverUrl: string;
+  /** API key for authentication */
+  apiKey?: string;
+  /** Default max results per request */
+  maxResults?: number;
+  /** Request timeout in ms */
+  timeoutMs?: number;
+}
+
+/**
+ * MCP Client for Skills SaaS backend
+ */
+export class SkillMCPClient {
+  private config: Required<SkillMCPClientConfig>;
+
+  constructor(config: SkillMCPClientConfig) {
+    this.config = {
+      serverUrl: config.serverUrl.replace(/\/$/, ""),
+      apiKey: config.apiKey ?? "",
+      maxResults: config.maxResults ?? DEFAULT_MAX_RESULTS,
+      timeoutMs: config.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+    };
+  }
+
+  /**
+   * Make MCP request to server
+   */
+  private async request<T>(
+    method: string,
+    params: Record<string, unknown> = {},
+  ): Promise<T> {
+    const headers: Record<string, string> = {
+      "Content-Type": "application/json",
+    };
+
+    if (this.config.apiKey) {
+      headers["Authorization"] = `Bearer ${this.config.apiKey}`;
+    }
+
+    const response = await fetch(`${this.config.serverUrl}/mcp`, {
+      method: "POST",
+      headers,
+      body: JSON.stringify({
+        jsonrpc: "2.0",
+        id: crypto.randomUUID(),
+        method,
+        params,
+      } satisfies MCPRequest),
+      signal: AbortSignal.timeout(this.config.timeoutMs),
+    });
+
+    if (!response.ok) {
+      throw new SkillAPIError(
+        `HTTP ${response.status}: ${response.statusText}`,
+        response.status,
+        method,
+      );
+    }
+
+    const data = (await response.json()) as MCPResponse<T>;
+
+    if (data.error) {
+      throw new SkillAPIError(data.error.message, data.error.code, method);
+    }
+
+    if (!data.result) {
+      throw new SkillAPIError(
+        "No result in response",
+        ErrorCodes.INVALID_REQUEST,
+        method,
+      );
+    }
+
+    return data.result;
+  }
+
+  /**
+   * List available skills
+   */
+  async listSkills(params?: ListSkillsParams): Promise<ListSkillsResult> {
+    return this.request<ListSkillsResult>("skills.list", {
+      ...params,
+      limit: params?.limit ?? this.config.maxResults,
+    });
+  }
+
+  /**
+   * Get a skill's full prompt
+   */
+  async getSkill(params: GetSkillParams): Promise<GetSkillResult> {
+    if (!params.id && !params.slug) {
+      throw new SkillAPIError(
+        "Either 'id' or 'slug' is required",
+        ErrorCodes.INVALID_PARAMS,
+        "skills.get",
+      );
+    }
+    return this.request<GetSkillResult>(
+      "skills.get",
+      params as Record<string, unknown>,
+    );
+  }
+
+  /**
+   * Sync all skills for the user's tier (bulk download)
+   */
+  async syncSkills(params?: SyncSkillsParams): Promise<SyncSkillsResult> {
+    return this.request<SyncSkillsResult>(
+      "skills.sync",
+      (params ?? {}) as Record<string, unknown>,
+    );
+  }
+
+  /**
+   * Get version history for a skill
+   */
+  async getSkillVersions(
+    skillId: string,
+    limit = 10,
+  ): Promise<SkillVersionsResult> {
+    return this.request<SkillVersionsResult>("skills.versions", {
+      id: skillId,
+      limit,
+    });
+  }
+
+  /**
+   * List all categories
+   */
+  async listCategories(): Promise<{
+    categories: Array<{
+      slug: string;
+      displayName: string;
+      skillCount: number;
+    }>;
+  }> {
+    return this.request("categories.list");
+  }
+
+  /**
+   * Health check
+   */
+  async healthCheck(): Promise<HealthResult> {
+    return this.request<HealthResult>("health.check");
+  }
+}

package/packages/skill-mcp-client/src/errors.ts

@@ -0,0 +1,75 @@
+/**
+ * Skill API Error Classes (RFC-0106)
+ */
+
+import { ErrorCodes } from "./types.js";
+
+/**
+ * Error thrown when Skills API request fails
+ */
+export class SkillAPIError extends Error {
+ constructor(
+  message: string,
+  public readonly code: number,
+  public readonly method?: string,
+  public readonly data?: unknown,
+ ) {
+  super(message);
+  this.name = "SkillAPIError";
+ }
+
+ /**
+  * Check if this is an auth error
+  */
+ isAuthError(): boolean {
+  return this.code === ErrorCodes.UNAUTHORIZED;
+ }
+
+ /**
+  * Check if this is a tier restriction error
+  */
+ isTierRestricted(): boolean {
+  return this.code === ErrorCodes.TIER_RESTRICTED;
+ }
+
+ /**
+  * Check if this is a rate limit error
+  */
+ isRateLimited(): boolean {
+  return this.code === ErrorCodes.RATE_LIMITED;
+ }
+
+ /**
+  * Check if this is a not found error
+  */
+ isNotFound(): boolean {
+  return this.code === ErrorCodes.NOT_FOUND;
+ }
+}
+
+/**
+ * Error thrown when cache operations fail
+ */
+export class SkillCacheError extends Error {
+ constructor(
+  message: string,
+  public readonly cause?: Error,
+ ) {
+  super(message);
+  this.name = "SkillCacheError";
+ }
+}
+
+/**
+ * Error thrown when skill validation fails
+ */
+export class SkillValidationError extends Error {
+ constructor(
+  message: string,
+  public readonly skillId?: string,
+  public readonly issues?: string[],
+ ) {
+  super(message);
+  this.name = "SkillValidationError";
+ }
+}

package/packages/skill-mcp-client/src/index.ts

@@ -0,0 +1,13 @@
+/**
+ * Skill MCP Client (RFC-0106)
+ *
+ * Client for connecting pi-harness-runtime to Skills SaaS backend.
+ */
+
+export { SkillMCPClient, type SkillMCPClientConfig } from "./client.js";
+export {
+ SkillAPIError,
+ SkillCacheError,
+ SkillValidationError,
+} from "./errors.js";
+export * from "./types.js";

package/packages/skill-mcp-client/src/types.ts

@@ -0,0 +1,123 @@
+/**
+ * Skill MCP Client Types (RFC-0106)
+ */
+
+export interface SkillInfo {
+  id: string;
+  name: string;
+  slug: string;
+  description: string;
+  version: string;
+  tier: "free" | "pro" | "enterprise";
+  tags: string[];
+  category: string;
+  updatedAt: string;
+}
+
+export interface CategoryInfo {
+  slug: string;
+  displayName: string;
+  skillCount: number;
+}
+
+export interface GetSkillResult {
+  id: string;
+  name: string;
+  slug: string;
+  description: string;
+  version: string;
+  tier: "free" | "pro" | "enterprise";
+  tags: string[];
+  category: CategoryInfo;
+  updatedAt: string;
+  prompt: string;
+  changelog?: string;
+  previousVersions?: string[];
+}
+
+export interface SyncSkillsResult {
+  skills: GetSkillResult[];
+  syncedAt: string;
+  nextSyncDue?: string;
+}
+
+export interface SkillVersion {
+  version: string;
+  changelog: string;
+  releasedAt: string;
+}
+
+export interface SkillVersionsResult {
+  skillId: string;
+  currentVersion: string;
+  versions: SkillVersion[];
+}
+
+export interface HealthResult {
+  status: "ok" | "degraded";
+  version: string;
+  databaseLatencyMs: number;
+}
+
+export interface ListSkillsParams {
+  category?: string;
+  tier?: "free" | "pro" | "enterprise";
+  tags?: string[];
+  search?: string;
+  limit?: number;
+  offset?: number;
+}
+
+export interface ListSkillsResult {
+  skills: SkillInfo[];
+  total: number;
+  categories: CategoryInfo[];
+}
+
+export interface GetSkillParams {
+  id?: string;
+  slug?: string;
+  version?: string;
+}
+
+export interface SyncSkillsParams {
+  categories?: string[];
+  forceRefresh?: boolean;
+}
+
+export interface SkillVersionsParams {
+  id: string;
+  limit?: number;
+}
+
+// MCP JSON-RPC types
+export interface MCPRequest {
+  jsonrpc: "2.0";
+  id: string;
+  method: string;
+  params?: Record<string, unknown>;
+}
+
+export interface MCPResponse<T = unknown> {
+  jsonrpc: "2.0";
+  id: string;
+  result?: T;
+  error?: {
+    code: number;
+    message: string;
+    data?: unknown;
+  };
+}
+
+// Error codes
+export const ErrorCodes = {
+  INVALID_REQUEST: -32600,
+  INVALID_PARAMS: -32602,
+  METHOD_NOT_FOUND: -32601,
+  UNAUTHORIZED: -32001,
+  TIER_RESTRICTED: -32002,
+  NOT_FOUND: -32003,
+  RATE_LIMITED: -32004,
+} as const;
+
+export type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];

package/packages/skill-registry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/skill-registry",
-  "version": "1.1.18",
+  "version": "1.1.26",
   "description": "Skill Registry for pi-harness-runtime — dynamic skill discovery and invocation",
   "type": "module",
   "main": "./dist/index.js",

package/packages/sprint-planner/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/sprint-planner",
-  "version": "1.1.18",
+  "version": "1.1.26",
   "type": "module",
   "description": "Sprint planning engine for pi-harness",
   "main": "dist/index.js",

package/packages/subscription-engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/subscription-engine",
-  "version": "1.1.18",
+  "version": "1.1.26",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/task-compiler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/task-compiler",
-  "version": "1.1.18",
+  "version": "1.1.26",
   "description": "Task Compiler for pi-harness-runtime — produces deterministic task DAG from CompiledRequirement",
   "type": "module",
   "main": "./dist/index.js",

package/packages/tencentdb-memory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/tencentdb-memory",
-  "version": "1.1.18",
+  "version": "1.1.26",
   "description": "TencentDB Agent Memory client - sync skills to centralized knowledge base",
   "type": "module",
   "main": "src/index.ts",

package/packages/tencentdb-sync/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/tencentdb-sync",
-  "version": "1.1.18",
+  "version": "1.1.26",
   "description": "Sync SKILL.md skills to TencentDB-Agent-Memory server (RFC-0105/0106)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/test-data-generator/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/test-data-generator",
-  "version": "1.1.18",
+  "version": "1.1.26",
   "description": "Test data generation for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/test-generator/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/test-generator",
-  "version": "1.1.18",
+  "version": "1.1.26",
   "description": "Auto-Test Generator — generate unit and E2E tests from source code (RFC-0013)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/todo-bd-sync/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/todo-bd-sync",
-  "version": "1.1.18",
+  "version": "1.1.26",
   "description": "Two-way sync between rpiv-todo overlay and bd issue tracker",
   "type": "module",
   "main": "src/index.ts",

package/packages/token-estimation/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/token-estimation",
-  "version": "1.1.18",
+  "version": "1.1.26",
   "description": "pi-harness-runtime — token-estimation",
   "type": "module",
   "main": "./dist/index.js",

package/packages/token-optimizer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/token-optimizer",
-  "version": "1.1.18",
+  "version": "1.1.26",
   "description": "Token Budget Optimizer — maximize prompt value within token limits (RFC-0011)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/tui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/tui",
-  "version": "1.1.18",
+  "version": "1.1.26",
   "description": "pi-harness-runtime — tui",
   "type": "module",
   "main": "./dist/index.js",

package/packages/types/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/types",
-  "version": "1.1.18",
+  "version": "1.1.26",
   "description": "Shared TypeScript types for pi-harness-runtime packages",
   "type": "module",
   "main": "./src/index.js",

package/packages/workflow-events/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/workflow-events",
-  "version": "1.1.18",
+  "version": "1.1.26",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/workspace-scanner/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/workspace-scanner",
-  "version": "1.1.18",
+  "version": "1.1.26",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/worktree/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/worktree",
-  "version": "1.1.18",
+  "version": "1.1.26",
   "description": "pi-harness-runtime — worktree",
   "type": "module",
   "main": "./dist/index.js",

package/packages/write-review/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/write-review",
-  "version": "1.1.18",
+  "version": "1.1.26",
   "description": "Two-agent write-review loop with blackboard coordination",
   "type": "module",
   "main": "src/index.ts",