pi-harness-runtime 1.1.94 → 1.1.96

package/packages/qdrant-skills/dist/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Qdrant Skills Package
+ *
+ * Vector search integration for Hermes-style skill system.
+ * Uses Qdrant Cloud with built-in sentence-transformers inference.
+ *
+ * @example
+ * ```typescript
+ * import { createQdrantClient, searchSkills, upsertSkills } from '@pi-harness/qdrant-skills';
+ *
+ * const client = createQdrantClient({
+ *   url: process.env.QDRANT_CLUSTER_ENDPOINT!,
+ *   apiKey: process.env.QDRANT_API_KEY!,
+ * });
+ *
+ * // Search for skills
+ * const results = await searchSkills(client, 'my-skills', 'frappe permissions');
+ *
+ * // Upload skills
+ * await upsertSkills(client, 'my-skills', [{ id: 1, name: 'test', description: '...', body: '...', text: '...' }]);
+ * ```
+ */
+export { createQdrantClient, createCollection, deleteCollection, upsertSkills, searchSkills, getAllSkills, type QdrantConfig, type SkillPoint, type SearchResult, } from './client.js';
+export { createEmbedding, embedSkillDocument, embedSkillsBatch, getOpenAIApiKey, type EmbeddingResult, } from './embedder.js';
+//# sourceMappingURL=index.d.ts.map

package/packages/qdrant-skills/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC"}

package/packages/qdrant-skills/dist/index.js

@@ -0,0 +1,25 @@
+/**
+ * Qdrant Skills Package
+ *
+ * Vector search integration for Hermes-style skill system.
+ * Uses Qdrant Cloud with built-in sentence-transformers inference.
+ *
+ * @example
+ * ```typescript
+ * import { createQdrantClient, searchSkills, upsertSkills } from '@pi-harness/qdrant-skills';
+ *
+ * const client = createQdrantClient({
+ *   url: process.env.QDRANT_CLUSTER_ENDPOINT!,
+ *   apiKey: process.env.QDRANT_API_KEY!,
+ * });
+ *
+ * // Search for skills
+ * const results = await searchSkills(client, 'my-skills', 'frappe permissions');
+ *
+ * // Upload skills
+ * await upsertSkills(client, 'my-skills', [{ id: 1, name: 'test', description: '...', body: '...', text: '...' }]);
+ * ```
+ */
+export { createQdrantClient, createCollection, deleteCollection, upsertSkills, searchSkills, getAllSkills, } from './client.js';
+export { createEmbedding, embedSkillDocument, embedSkillsBatch, getOpenAIApiKey, } from './embedder.js';
+//# sourceMappingURL=index.js.map

package/packages/qdrant-skills/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,YAAY,GAIb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,GAEhB,MAAM,eAAe,CAAC"}

package/packages/qdrant-skills/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@pi-harness/qdrant-skills",
+  "version": "1.1.96",
+  "description": "Qdrant vector search integration for Hermes-style skill system",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./client": "./dist/client.js",
+    "./embedder": "./dist/embedder.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "echo \"No tests yet\" && exit 0"
+  },
+  "dependencies": {
+    "@qdrant/js-client-rest": "^1.19.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  }
+}

package/packages/qdrant-skills/src/client.ts

@@ -0,0 +1,178 @@
+/**
+ * Qdrant Client - Official @qdrant/js-client-rest wrapper
+ */
+
+import { QdrantClient } from "@qdrant/js-client-rest";
+
+export interface QdrantConfig {
+  /** Qdrant cluster URL (e.g., https://xxx.qdrant.tech) */
+  url: string;
+  /** API key for authentication */
+  apiKey: string;
+  /** Collection name (default: 'pi-harness-skills') */
+  collection?: string;
+}
+
+export interface SkillPoint {
+  id: number;
+  name: string;
+  description: string;
+  body: string;
+  /** Full text to embed */
+  text: string;
+}
+
+export interface SearchResult {
+  id: number;
+  name: string;
+  description: string;
+  score: number;
+}
+
+/**
+ * Parse host:port from URL
+ */
+function parseHostPort(url: string): { host: string; port: number } {
+  const match = url.match(/https?:\/\/([^:]+)(?::(\d+))?/);
+  return {
+    host: match?.[1] || url,
+    port: parseInt(match?.[2] || "6333"),
+  };
+}
+
+/**
+ * Create a Qdrant client
+ */
+export function createQdrantClient(config: QdrantConfig): QdrantClient {
+  const { host, port } = parseHostPort(config.url);
+  return new QdrantClient({ host, port, apiKey: config.apiKey });
+}
+
+/**
+ * Create a collection with dense vectors
+ */
+export async function createCollection(
+  client: QdrantClient,
+  name: string,
+  dimensions: number = 384 // all-MiniLM-L6-v2
+): Promise<void> {
+  try {
+    await client.createCollection(name, {
+      vectors: { size: dimensions, distance: "Cosine" },
+    });
+  } catch (err) {
+    // Ignore "already exists" errors
+    if (err instanceof Error && !err.message.includes("already exists")) {
+      throw err;
+    }
+  }
+}
+
+/**
+ * Delete a collection
+ */
+export async function deleteCollection(
+  client: QdrantClient,
+  name: string
+): Promise<void> {
+  try {
+    await client.deleteCollection(name);
+  } catch {
+    // Ignore if not exists
+  }
+}
+
+/**
+ * Upsert skill points with cloud inference
+ */
+export async function upsertSkills(
+  client: QdrantClient,
+  collectionName: string,
+  skills: SkillPoint[],
+  model: string = "sentence-transformers/all-MiniLM-L6-v2"
+): Promise<void> {
+  const points = skills.map((skill, idx) => ({
+    id: skill.id || idx + 1,
+    payload: {
+      name: skill.name,
+      description: skill.description,
+      body: skill.body.slice(0, 2000),
+    },
+    vector: {
+      text: skill.text,
+      model,
+    },
+  }));
+
+  await client.upsert(collectionName, { wait: true, points });
+}
+
+/**
+ * Search skills with semantic query
+ */
+export async function searchSkills(
+  client: QdrantClient,
+  collectionName: string,
+  query: string,
+  model: string = "sentence-transformers/all-MiniLM-L6-v2",
+  limit: number = 5
+): Promise<SearchResult[]> {
+  const results = await client.query(collectionName, {
+    query: { text: query, model },
+    limit,
+    with_payload: true,
+  } as Parameters<typeof client.query>[1]);
+
+  // Parse response: { result: { points: [...] } }
+  const typedResults = results as {
+    result?: {
+      points?: Array<{
+        id: number;
+        score: number;
+        payload?: Record<string, unknown>;
+      }>;
+    };
+  };
+
+  const points = typedResults?.result?.points || [];
+
+  return points.map((point) => ({
+    id: point.id,
+    name: (point.payload?.name as string) || `skill-${point.id}`,
+    description: (point.payload?.description as string) || "",
+    score: point.score,
+  }));
+}
+
+/**
+ * Get all skills from collection
+ */
+export async function getAllSkills(
+  client: QdrantClient,
+  collectionName: string
+): Promise<SearchResult[]> {
+  const results = await client.query(collectionName, {
+    filter: {}, // Empty filter = all
+    limit: 100,
+    with_payload: true,
+  } as Parameters<typeof client.query>[1]);
+
+  const typedResults = results as {
+    result?: {
+      points?: Array<{
+        id: number;
+        score: number;
+        payload?: Record<string, unknown>;
+      }>;
+    };
+  };
+
+  const points = typedResults?.result?.points || [];
+
+  return points.map((point) => ({
+    id: point.id,
+    name: (point.payload?.name as string) || `skill-${point.id}`,
+    description: (point.payload?.description as string) || "",
+    score: point.score || 0,
+  }));
+}

package/packages/qdrant-skills/src/embedder.ts

@@ -0,0 +1,137 @@
+/**
+ * Skill Embedder
+ * 
+ * Creates embeddings for skill content using OpenAI.
+ * Used to store skills in Qdrant for semantic search.
+ */
+
+import type { SkillPoint } from "./client.js";
+
+/**
+ * Embedding result
+ */
+export interface EmbeddingResult {
+  embedding: number[];
+  tokens: number;
+}
+
+/**
+ * Get OpenAI API key for embeddings
+ */
+export function getOpenAIApiKey(): string | null {
+  // Check env vars (same as Jev)
+  if (process.env.OPENAI_API_KEY) {
+    return process.env.OPENAI_API_KEY;
+  }
+  if (process.env.TYPESAFE_API_KEY) {
+    return process.env.TYPESAFE_API_KEY;
+  }
+  if (process.env.OPENROUTER_API_KEY) {
+    return process.env.OPENROUTER_API_KEY;
+  }
+  
+  // Check keys file
+  try {
+    const { existsSync, readFileSync } = require("node:fs");
+    const homedir = process.env.HOME || process.env.USERPROFILE || "/home/frappe";
+    const keyPath = `${homedir}/.pi-harness-runtime/keys/openai-api-key.txt`;
+    if (existsSync(keyPath)) {
+      return readFileSync(keyPath, "utf-8").trim();
+    }
+  } catch {
+    // ignore
+  }
+  
+  return null;
+}
+
+/**
+ * Create embedding for text using OpenAI
+ */
+export async function createEmbedding(
+  text: string,
+  apiKey?: string
+): Promise<EmbeddingResult> {
+  const key = apiKey || getOpenAIApiKey();
+  if (!key) {
+    throw new Error("No OpenAI API key available for embeddings");
+  }
+  
+  const response = await fetch("https://api.openai.com/v1/embeddings", {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "Authorization": `Bearer ${key}`,
+    },
+    body: JSON.stringify({
+      model: "text-embedding-3-small",
+      input: text.slice(0, 8000), // Limit to avoid token limits
+    }),
+  });
+  
+  if (!response.ok) {
+    const error = await response.text();
+    throw new Error(`OpenAI embedding failed: ${error}`);
+  }
+  
+  const data = await response.json() as {
+    data: Array<{ embedding: number[] }>;
+    usage: { total_tokens: number };
+  };
+  
+  return {
+    embedding: data.data[0]?.embedding || [],
+    tokens: data.usage?.total_tokens || 0,
+  };
+}
+
+/**
+ * Create embedding for a skill document
+ */
+export async function embedSkillDocument(
+  skill: SkillPoint,
+  apiKey?: string
+): Promise<{ id: number; embedding: number[]; payload: SkillPoint }> {
+  // Combine name and description for embedding
+  const textToEmbed = [skill.name, skill.description].join(". ");
+  
+  const { embedding } = await createEmbedding(textToEmbed, apiKey);
+  
+  return {
+    id: skill.id,
+    embedding,
+    payload: skill,
+  };
+}
+
+/**
+ * Batch embed multiple skills
+ */
+export async function embedSkillsBatch(
+  skills: SkillPoint[],
+  apiKey?: string,
+  onProgress?: (index: number, total: number) => void
+): Promise<Array<{ id: number; embedding: number[]; payload: SkillPoint }>> {
+  const results: Array<{ id: number; embedding: number[]; payload: SkillPoint }> = [];
+  
+  for (let i = 0; i < skills.length; i++) {
+    const skill = skills[i];
+    try {
+      const result = await embedSkillDocument(skill, apiKey);
+      results.push(result);
+    } catch (err) {
+      console.error(`[QdrantSkills] Failed to embed skill ${skill.name}:`, err);
+    }
+    
+    if (onProgress) {
+      onProgress(i + 1, skills.length);
+    }
+    
+    // Small delay to avoid rate limiting
+    if (i < skills.length - 1) {
+      await new Promise(resolve => setTimeout(resolve, 100));
+    }
+  }
+  
+  return results;
+}

package/packages/qdrant-skills/src/index.ts

@@ -0,0 +1,42 @@
+/**
+ * Qdrant Skills Package
+ * 
+ * Vector search integration for Hermes-style skill system.
+ * Uses Qdrant Cloud with built-in sentence-transformers inference.
+ * 
+ * @example
+ * ```typescript
+ * import { createQdrantClient, searchSkills, upsertSkills } from '@pi-harness/qdrant-skills';
+ * 
+ * const client = createQdrantClient({
+ *   url: process.env.QDRANT_CLUSTER_ENDPOINT!,
+ *   apiKey: process.env.QDRANT_API_KEY!,
+ * });
+ * 
+ * // Search for skills
+ * const results = await searchSkills(client, 'my-skills', 'frappe permissions');
+ * 
+ * // Upload skills
+ * await upsertSkills(client, 'my-skills', [{ id: 1, name: 'test', description: '...', body: '...', text: '...' }]);
+ * ```
+ */
+
+export {
+  createQdrantClient,
+  createCollection,
+  deleteCollection,
+  upsertSkills,
+  searchSkills,
+  getAllSkills,
+  type QdrantConfig,
+  type SkillPoint,
+  type SearchResult,
+} from './client.js';
+
+export {
+  createEmbedding,
+  embedSkillDocument,
+  embedSkillsBatch,
+  getOpenAIApiKey,
+  type EmbeddingResult,
+} from './embedder.js';

package/packages/quota-manager/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/quota-manager",
-  "version": "1.1.94",
+  "version": "1.1.96",
   "description": "pi-harness-runtime — quota-manager",
   "type": "module",
   "main": "./dist/index.js",

package/packages/rate-limiter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/rate-limiter",
-  "version": "1.1.94",
+  "version": "1.1.96",
   "type": "module",
   "description": "Rate limiting with token bucket algorithm (RFC-0023)",
   "main": "dist/index.js",

package/packages/react-vite-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/react-vite-plugin",
-  "version": "1.1.94",
+  "version": "1.1.96",
   "description": "React/Vite framework analysis — components, config, TypeScript setup",
   "type": "module",
   "main": "./dist/index.js",

package/packages/release-manager/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/release-manager",
-  "version": "1.1.94",
+  "version": "1.1.96",
   "type": "module",
   "description": "Release management for pi-harness",
   "main": "dist/index.js",

package/packages/requirement-compiler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/requirement-compiler",
-  "version": "1.1.94",
+  "version": "1.1.96",
   "description": "Compiles raw requirements into validated CompiledRequirement with ambiguity detection and risk tagging",
   "type": "module",
   "main": "./dist/index.js",

package/packages/runtime/package.json

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

package/packages/scheduler/package.json

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

package/packages/scheduler-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/scheduler-adapter",
-  "version": "1.1.94",
+  "version": "1.1.96",
   "description": "Scheduler Adapter — cron, systemd, launchd, internal adapters for autonomous runtime (RFC-0101 §6)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/session/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/session",
-  "version": "1.1.94",
+  "version": "1.1.96",
   "description": "Session management system for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/session-api/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/session-api",
-  "version": "1.1.94",
+  "version": "1.1.96",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/session-export/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/session-export",
-  "version": "1.1.94",
+  "version": "1.1.96",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/shared-context/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/shared-context",
-  "version": "1.1.94",
+  "version": "1.1.96",
   "description": "pi-harness-runtime — shared-context",
   "type": "module",
   "main": "./dist/index.js",

package/packages/skill-mcp-client/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/skill-mcp-client",
-  "version": "1.1.94",
+  "version": "1.1.96",
   "description": "MCP client for Skills SaaS backend",
   "type": "module",
   "main": "./dist/index.js",

package/packages/skill-registry/package.json

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

package/packages/skills/dist/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Skills Package - File-based skill system with pi.dev compatibility
+ *
+ * Implements Hermes-style self-improving skills with:
+ * - pi.dev Agent Skills specification compatibility
+ * - Progressive disclosure (lazy loading)
+ * - Background review and auto-improvement
+ * - Hermes-style linter for quality checks
+ */
+export * from "./types.js";
+export * from "./parser.js";
+export * from "./scanner.js";
+export * from "./loader.js";
+export * from "./skill-commands.js";
+export * from "./skill-tool.js";
+export * from "./skill-versioning.js";
+export * from "./linter.js";
+import type { SkillsConfig, ScanResult } from "./types.js";
+/**
+ * Initialize skills system
+ */
+export declare function initSkills(config?: Partial<SkillsConfig & {
+    maxDepth?: number;
+    includeHidden?: boolean;
+}>): ScanResult;
+/**
+ * Get skills summary
+ */
+export declare function getSkillsSummary(): {
+    total: number;
+    loaded: number;
+    byAuthor: {
+        agent: number;
+        user: number;
+        curator: number;
+        unknown: number;
+    };
+};
+export declare const DEFAULT_SKILL_CONFIG: SkillsConfig;
+//# sourceMappingURL=index.d.ts.map

package/packages/skills/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAE5B,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAe,MAAM,YAAY,CAAC;AAIxE;;GAEG;AACH,wBAAgB,UAAU,CACxB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,GAC9E,UAAU,CAkBZ;AAED;;GAEG;AACH,wBAAgB,gBAAgB;;;;;;;;;EAyB/B;AAGD,eAAO,MAAM,oBAAoB,EAAE,YAYlC,CAAC"}