pi-harness-runtime 1.1.445 → 1.1.447

package/packages/scheduler-adapter/src/systemd.ts

@@ -1,221 +0,0 @@
-/**
- * Scheduler Adapter — systemd Backend
- * RFC-0101 §6
- *
- * Uses systemd user timers as the scheduling backend.
- * Each scheduled task becomes a .timer + .service unit pair.
- * Works on any Linux system with systemd (no root required for user units).
- */
-
-import { execSync } from "node:child_process";
-import { existsSync, mkdirSync, writeFileSync, unlinkSync } from "node:fs";
-import { join } from "node:path";
-import { homedir } from "node:os";
-import type { SchedulerAdapter, ScheduledTask } from "./interface.js";
-
-// ScheduledTask duplicated here — see interface.ts for details.
-
-/**
- * Install systemd user units (runs `systemctl --user`).
- * Must call this once before scheduling.
- */
-export class SystemdAdapter implements SchedulerAdapter {
-	readonly name = "systemd" as const;
-	/** Per-task unit files live in ~/.config/systemd/user/ */
-	private readonly unitDir: string;
-	private installed = false;
-
-	constructor(unitDir?: string) {
-		this.unitDir = unitDir ?? join(homedir(), ".config", "systemd", "user");
-	}
-
-	async install(): Promise<void> {
-		// Verify systemd user mode is available
-		try {
-			execSync("systemctl --user show-environment >/dev/null 2>&1", {
-				stdio: "pipe",
-			});
-		} catch {
-			throw new Error(
-				"[SystemdAdapter] systemd user mode is not available. " +
-					"Ensure systemd is running and $SYSTEMD_RUNTIME_DIRECTORY is set.",
-			);
-		}
-
-		// Ensure unit directory exists
-		if (!existsSync(this.unitDir)) {
-			mkdirSync(this.unitDir, { recursive: true });
-		}
-
-		// Reload systemd to pick up new units
-		try {
-			execSync("systemctl --user daemon-reload", { stdio: "pipe" });
-		} catch {
-			throw new Error("[SystemdAdapter] Failed to reload systemd daemon");
-		}
-
-		this.installed = true;
-	}
-
-	async schedule(task: ScheduledTask): Promise<void> {
-		if (!this.installed) await this.install();
-
-		const id = task.id.replace(/[^a-zA-Z0-9_-]/g, "-");
-		const base = `pi-runtime-${id}`;
-		const servicePath = join(this.unitDir, `${base}.service`);
-		const timerPath = join(this.unitDir, `${base}.timer`);
-		const scriptPath = join(this.unitDir, `${base}.sh`);
-
-		// Build the run script
-		const runScript = [
-			"#!/usr/bin/env bash",
-			`# Generated by pi-harness-runtime — ${new Date().toISOString()}`,
-			"",
-			`PI_HARNESS_TASK_ID="${task.id}" \\`,
-			`PI_HARNESS_WORKER_ID="$(hostname)-$(id -u)" \\`,
-			`PI_HARNESS_RUNTIME_ROOT="${process.env.PI_HARNESS_RUNTIME_ROOT ?? join(homedir(), ".pi", "harness")}" \\`,
-			`exec "${process.env.PI_HARNESS_RUNTIME_ROOT}/bin/run-task.sh" \\`,
-			`  --task-id "${task.id}" \\`,
-			`  --worker-id "$PI_HARNESS_WORKER_ID"`,
-		].join("\n");
-
-		// Write script
-		writeFileSync(scriptPath, runScript, { mode: 0o755 });
-
-		// Service unit: runs the script
-		const service = [
-			"[Unit]",
-			"Description=pi-harness-runtime task: ${task.id}",
-			"[Service]",
-			`ExecStart=${scriptPath}`,
-			"Type=oneshot",
-			"Environment=SYSTEMD_EXEC_PID=$$",
-			"[Install]",
-			"WantedBy=default.target",
-		].join("\n");
-
-		// Timer unit: schedules the service
-		const timerContent = [
-			"[Unit]",
-			`Description=pi-harness-runtime schedule: ${task.id}`,
-			"[Timer]",
-			this._toTimerLine(task.schedule),
-			"Persistent=true",
-			"[Install]",
-			"WantedBy=timers.target",
-		].join("\n");
-
-		writeFileSync(servicePath, service);
-		writeFileSync(timerPath, timerContent);
-
-		// Reload and enable
-		try {
-			execSync("systemctl --user daemon-reload", { stdio: "pipe" });
-			execSync(`systemctl --user enable ${base}.timer`, { stdio: "pipe" });
-			execSync(`systemctl --user start ${base}.timer`, { stdio: "pipe" });
-		} catch (e) {
-			const err = e as { message?: string };
-			throw new Error(
-				`[SystemdAdapter] Failed to enable/start ${base}.timer: ${err?.message ?? String(e)}`,
-			);
-		}
-	}
-
-	async unschedule(taskId: string): Promise<void> {
-		const id = taskId.replace(/[^a-zA-Z0-9_-]/g, "-");
-		const base = `pi-runtime-${id}`;
-		const servicePath = join(this.unitDir, `${base}.service`);
-		const timerPath = join(this.unitDir, `${base}.timer`);
-		const scriptPath = join(this.unitDir, `${base}.sh`);
-
-		// Stop and disable
-		try {
-			execSync(`systemctl --user stop ${base}.timer`, { stdio: "pipe" });
-			execSync(`systemctl --user disable ${base}.timer`, { stdio: "pipe" });
-		} catch {
-			// Ignore if not running
-		}
-
-		// Remove files
-		for (const p of [servicePath, timerPath, scriptPath]) {
-			try {
-				if (existsSync(p)) unlinkSync(p);
-			} catch {
-				// Ignore cleanup errors
-			}
-		}
-
-		try {
-			execSync("systemctl --user daemon-reload", { stdio: "pipe" });
-		} catch {
-			// Ignore
-		}
-	}
-
-	async listScheduled(): Promise<ScheduledTask[]> {
-		try {
-			const out = execSync(
-				"systemctl --user list-timers --all --no-legend --output json 2>/dev/null | grep pi-runtime- || true",
-				{ encoding: "utf8" },
-			);
-
-			if (!out.trim()) return [];
-
-			let timers: Array<{ Unit?: string; Next?: string }> = [];
-			try {
-				timers = JSON.parse(out.trim());
-			} catch {
-				return [];
-			}
-
-			return timers
-				.filter((t) => t.Unit?.startsWith("pi-runtime-"))
-				.map((t) => {
-					const id = (t.Unit ?? "").replace(/^pi-runtime-(.+)\.timer$/, "$1");
-					return {
-						id,
-						taskTemplate: {},
-						schedule: { kind: "interval" as const, intervalMs: 0 },
-						enabled: true,
-					} satisfies ScheduledTask;
-				});
-		} catch {
-			return [];
-		}
-	}
-
-	/** Convert a schedule to a systemd.timer OnCalendar or OnUnitActiveSec line. */
-	private _toTimerLine(schedule: ScheduledTask["schedule"]): string {
-		if (schedule.kind === "cron") {
-			// Convert cron to systemd calendar format
-			const parts = schedule.expression.trim().split(/\s+/);
-			if (parts.length >= 5) {
-				const [min, hour, dom, month] = parts;
-				return `OnCalendar=${dom}.${month}.* ${hour}:${min.padStart(2, "0")}`;
-			}
-			return `OnCalendar=${schedule.expression}`;
-		}
-		if (schedule.kind === "interval") {
-			const sec = Math.round(schedule.intervalMs / 1000);
-			if (sec >= 86400) return `OnUnitActiveSec=${Math.round(sec / 86400)}d`;
-			if (sec >= 3600) return `OnUnitActiveSec=${Math.round(sec / 3600)}h`;
-			if (sec >= 60) return `OnUnitActiveSec=${Math.round(sec / 60)}min`;
-			return `OnUnitActiveSec=${sec}s`;
-		}
-		if (schedule.kind === "once") {
-			return `OnCalendar=${new Date(schedule.at).toISOString().split("T").join(" ")}`;
-		}
-		return "OnUnitActiveSec=1h"; // fallback
-	}
-
-	async healthCheck(): Promise<{ healthy: boolean; error?: string }> {
-		try {
-			execSync("systemctl --user show-environment >/dev/null 2>&1", {
-				stdio: "pipe",
-			});
-			return { healthy: true };
-		} catch {
-			return { healthy: false, error: "systemd user mode not available" };
-		}
-	}
-}

package/packages/session/README.md

@@ -1,273 +0,0 @@
-# @pi/session
-
-Session management system for pi-harness-runtime with message history, token accounting, policy enforcement, and session persistence.
-
-## Features
-
-- **Session Lifecycle** - Create, suspend, resume, and close sessions
-- **Message History** - Full conversation history with search capabilities
-- **Token Accounting** - Track input/output tokens and costs per session
-- **Policy Engine** - Rate limiting, budget enforcement, and session policies
-- **Context Window** - Automatic management of context window size
-- **Persistence** - Sessions stored to disk with auto-save
-- **Event System** - Subscribe to session lifecycle events
-- **Auto-Cleanup** - Automatic expiration and idle timeout handling
-
-## Installation
-
-```bash
-npm install @pi/session
-```
-
-## Quick Start
-
-### Basic Usage
-
-```typescript
-import { createSessionManager } from "@pi/session";
-
-const manager = createSessionManager({
-  rootDir: "./sessions",
-  sessionTtlMs: 24 * 60 * 60 * 1000, // 24 hours
-});
-
-// Create a new session
-const session = await manager.create("user-123", {
-  project: "my-project"
-});
-console.log(`Created session: ${session.id}`);
-
-// Add messages
-const userMessage = await manager.addMessage(session.id, {
-  role: "user",
-  content: "Hello, how are you?",
-  timestamp: new Date().toISOString(),
-});
-
-const assistantMessage = await manager.addMessage(session.id, {
-  role: "assistant",
-  content: "I'm doing well! How can I help you?",
-  timestamp: new Date().toISOString(),
-  tokens: 50,
-});
-
-// Get messages
-const messages = await manager.getMessages(session.id);
-console.log(`Session has ${messages.length} messages`);
-```
-
-### Session Lifecycle
-
-```typescript
-// Suspend a session
-await manager.suspend(session.id, "User requested pause");
-
-// Resume later
-const resumed = await manager.resume(session.id);
-console.log(`Session ${resumed?.status}`);
-
-// Close session
-await manager.end(session.id);
-```
-
-### Token Tracking
-
-```typescript
-// Update token usage
-await manager.updateTokenUsage(session.id, {
-  inputTokens: 1000,
-  outputTokens: 500,
-  inputCost: 0.01,
-  outputCost: 0.005,
-  totalCost: 0.015,
-  totalTokens: 1500,
-});
-
-// Get metrics
-const metrics = await manager.getMetrics(session.id);
-console.log(`Total cost: $${metrics?.totalCost}`);
-```
-
-### Policy Enforcement
-
-```typescript
-import { createPolicyEngine } from "@pi/session";
-
-const policy = createPolicyEngine({
-  maxRequestsPerMinute: 60,
-  maxCostPerSession: 10,
-  sessionBudget: 5,
-});
-
-// Check if action is allowed
-if (policy.canProceed(sessionId, "message")) {
-  // Proceed with action
-  policy.recordAction(sessionId, "message");
-} else {
-  const violation = policy.getViolationType(sessionId);
-  console.log(`Policy violation: ${violation}`);
-}
-```
-
-### Event System
-
-```typescript
-manager.on("session:created", (event) => {
-  console.log(`Session created: ${event.sessionId}`);
-});
-
-manager.on("message:added", (event) => {
-  console.log(`Message added to session: ${event.sessionId}`);
-});
-
-manager.on("policy:violation", (event) => {
-  console.log(`Policy violation: ${event.data?.violation}`);
-});
-
-manager.on("budget:exceeded", (event) => {
-  console.log(`Budget exceeded: $${event.data?.cost}`);
-});
-```
-
-### Context Window Management
-
-```typescript
-// Get messages that fit in a token budget
-const contextMessages = await manager.getMessagesForContext(
-  session.id,
-  4000 // Target tokens
-);
-console.log(`Got ${contextMessages.length} messages for 4k tokens`);
-```
-
-### Search Messages
-
-```typescript
-import { MessageSearch } from "@pi/session";
-
-const search = new MessageSearch();
-search.buildIndex(session.id, messages);
-
-const results = search.search({
-  sessionId: session.id,
-  role: "user",
-  contains: "help",
-  limit: 10,
-});
-
-console.log(`Found ${results.length} matching messages`);
-```
-
-## API Reference
-
-### SessionManager
-
-```typescript
-const manager = createSessionManager({
-  rootDir: string;           // Session storage directory
-  sessionTtlMs?: number;     // Session TTL (default: 24h)
-  maxIdleMs?: number;       // Max idle before suspend (default: 30m)
-  autoSaveIntervalMs?: number; // Auto-save interval (default: 5s)
-  maxMessagesPerSession?: number; // Max messages (default: 1000)
-  maxTokenBudget?: number;  // Token budget (default: 128000)
-  enableMetrics?: boolean;   // Enable metrics (default: true)
-  autoCleanup?: boolean;     // Auto-cleanup (default: true)
-  cleanupIntervalMs?: number; // Cleanup interval (default: 1h)
-});
-```
-
-### Methods
-
-```typescript
-// Create session
-await manager.create(userId, metadata?): Promise<Session>;
-
-// Get session summary
-await manager.get(sessionId): Promise<Session | null>;
-
-// Get full session context
-await manager.getContext(sessionId): Promise<SessionContext | null>;
-
-// End session
-await manager.end(sessionId): Promise<void>;
-
-// Suspend session
-await manager.suspend(sessionId, reason): Promise<void>;
-
-// Resume session
-await manager.resume(sessionId): Promise<Session | null>;
-
-// Add message
-await manager.addMessage(sessionId, message): Promise<Message | null>;
-
-// Get messages
-await manager.getMessages(sessionId, options?): Promise<Message[]>;
-
-// Get messages for context
-await manager.getMessagesForContext(sessionId, targetTokens): Promise<Message[]>;
-
-// Update token usage
-await manager.updateTokenUsage(sessionId, usage): Promise<void>;
-
-// Get metrics
-await manager.getMetrics(sessionId): Promise<SessionMetrics | null>;
-
-// List user sessions
-await manager.listByUser(userId): Promise<Session[]>;
-
-// Delete session
-await manager.delete(sessionId): Promise<void>;
-
-// Cleanup expired sessions
-await manager.cleanup(): Promise<number>;
-
-// Event listeners
-manager.on(eventType, listener): void;
-manager.off(eventType, listener): void;
-```
-
-### Event Types
-
-```typescript
-type SessionEventType =
-  | "session:created"
-  | "session:updated"
-  | "session:closed"
-  | "session:expired"
-  | "session:suspended"
-  | "session:resumed"
-  | "message:added"
-  | "policy:violation"
-  | "budget:exceeded";
-```
-
-### Storage Format
-
-Sessions are stored as JSON files:
-
-```
-sessions/
-+-- index.json                    # Session index
-+-- sessions/
-    +-- ab/
-        +-- cdef1234.../
-            +-- session.json      # Full session context
-```
-
-## Architecture
-
-```
-+---------------------------------------------------------+
-|                    SessionManager                        |
-|  +-------------+  +-------------+  +-----------------+  |
-|  |   Manager   |  |   Policy    |  |     Store       |  |
-|  |             |--|   Engine    |--|                 |  |
-|  +-------------+  +-------------+  +-----------------+  |
-|         |                                      |        |
-|         ▼                                      ▼        |
-|  +-----------------+                +-----------------+|
-|  | ContextWindow   |                |    Disk         ||
-|  | Manager         |                |                 ||
-|  +-----------------+                +-----------------+|
-+---------------------------------------------------------+
-```

package/packages/session/dist/history.d.ts

@@ -1,124 +0,0 @@
-/**
- * Session Manager - History
- *
- * Message history management and search.
- */
-import type { Message, MessageSearchFilter, MessageSearchResult } from "./types.js";
-export declare class MessageHistory {
-    private messages;
-    private readonly maxMessages;
-    constructor(maxMessages?: number);
-    /**
-     * Initialize from existing messages
-     */
-    initialize(messages: Message[]): void;
-    /**
-     * Get all messages
-     */
-    getAll(): Message[];
-    /**
-     * Get messages by role
-     */
-    getByRole(role: Message["role"]): Message[];
-    /**
-     * Get recent messages
-     */
-    getRecent(count: number): Message[];
-    /**
-     * Get messages in a range
-     */
-    getRange(start: number, end: number): Message[];
-    /**
-     * Add a message
-     */
-    add(message: Omit<Message, "id">): Message;
-    /**
-     * Update a message
-     */
-    update(messageId: string, updates: Partial<Message>): Message | null;
-    /**
-     * Delete a message
-     */
-    delete(messageId: string): boolean;
-    /**
-     * Clear all messages
-     */
-    clear(): void;
-    /**
-     * Get message count
-     */
-    count(): number;
-    /**
-     * Trim oldest messages
-     */
-    private trimOldest;
-    /**
-     * Generate unique message ID
-     */
-    private generateId;
-    /**
-     * Export messages as array
-     */
-    toArray(): Message[];
-    /**
-     * Get token count estimate
-     */
-    getEstimatedTokenCount(): number;
-}
-export declare class MessageSearch {
-    private index;
-    /**
-     * Build index from session
-     */
-    buildIndex(sessionId: string, messages: Message[]): void;
-    /**
-     * Search messages
-     */
-    search(filter: MessageSearchFilter): MessageSearchResult[];
-    /**
-     * Calculate relevance score
-     */
-    private calculateScore;
-    /**
-     * Clear index
-     */
-    clear(): void;
-    /**
-     * Remove session from index
-     */
-    removeSession(sessionId: string): void;
-}
-export declare class ContextWindowManager {
-    private readonly maxTokens;
-    private history;
-    constructor(maxTokens?: number);
-    /**
-     * Initialize with messages
-     */
-    initialize(messages: Message[]): void;
-    /**
-     * Get messages that fit within token budget
-     */
-    getMessagesForContext(targetTokens: number): Message[];
-    /**
-     * Estimate tokens for a message
-     */
-    private estimateTokens;
-    /**
-     * Check if context would exceed window
-     */
-    wouldExceed(newMessageTokens: number): boolean;
-    /**
-     * Get remaining tokens
-     */
-    getRemainingTokens(): number;
-    /**
-     * Get all messages
-     */
-    getAll(): Message[];
-    /**
-     * Add message
-     */
-    add(message: Omit<Message, "id">): Message;
-}
-//# sourceMappingURL=history.d.ts.map

package/packages/session/dist/history.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACX,OAAO,EACP,mBAAmB,EACnB,mBAAmB,EAEnB,MAAM,YAAY,CAAC;AAIpB,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC,YAAY,WAAW,GAAE,MAAa,EAErC;IAED;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAEpC;IAED;;OAEG;IACH,MAAM,IAAI,OAAO,EAAE,CAElB;IAED;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,EAAE,CAE1C;IAED;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,CAElC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,EAAE,CAE9C;IAED;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,OAAO,CAczC;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,IAAI,CAWnE;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAMjC;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAEZ;IAED;;OAEG;IACH,KAAK,IAAI,MAAM,CAEd;IAED;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,OAAO,CAAC,UAAU;IAOlB;;OAEG;IACH,OAAO,IAAI,OAAO,EAAE,CAEnB;IAED;;OAEG;IACH,sBAAsB,IAAI,MAAM,CAK/B;CACD;AAID,qBAAa,aAAa;IACzB,OAAO,CAAC,KAAK,CAAqC;IAElD;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAEvD;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,EAAE,CA4DzD;IAED;;OAEG;IACH,OAAO,CAAC,cAAc;IAsBtB;;OAEG;IACH,KAAK,IAAI,IAAI,CAEZ;IAED;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAErC;CACD;AAID,qBAAa,oBAAoB;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,OAAO,CAAiB;IAEhC,YAAY,SAAS,GAAE,MAAe,EAGrC;IAED;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAEpC;IAED;;OAEG;IACH,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,EAAE,CAmBrD;IAED;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,WAAW,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAG7C;IAED;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAG3B;IAED;;OAEG;IACH,MAAM,IAAI,OAAO,EAAE,CAElB;IAED;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,OAAO,CAEzC;CACD"}