portable-agent-layer 0.23.1 → 0.24.1

package/src/hooks/handlers/relationship.ts

@@ -1,116 +0,0 @@
-/**
- * Stop handler: extracts relationship observations via Haiku inference.
- * Only runs on substantial sessions (≥10 messages).
- * Dedup: skips if this session already has notes in today's file.
- */
-
-import { inference } from "../lib/inference";
-import { logDebug, logError } from "../lib/log";
-import { appendNotes, hasSessionNotes, type RelationshipNote } from "../lib/relationship";
-import { logTokenUsage } from "../lib/token-usage";
-import { extractContent, parseMessages } from "../lib/transcript";
-
-const OBSERVATION_SCHEMA = {
-  type: "object",
-  properties: {
-    observations: {
-      type: "array",
-      items: {
-        type: "object",
-        properties: {
-          type: {
-            type: "string",
-            enum: ["O", "W", "B"],
-            description:
-              "O=opinion/preference, W=factual observation, B=biographical (what the AI did this session)",
-          },
-          text: { type: "string" },
-          confidence: { type: "number" },
-        },
-        required: ["type", "text", "confidence"],
-        additionalProperties: false,
-      },
-    },
-  },
-  required: ["observations"],
-  additionalProperties: false,
-} as const;
-
-export async function captureRelationship(
-  transcript: string,
-  sessionId?: string
-): Promise<void> {
-  if (sessionId && hasSessionNotes(sessionId)) {
-    logDebug("relationship", "Skipped: session already has notes");
-    return;
-  }
-
-  const messages = parseMessages(transcript);
-  logDebug("relationship", `Messages: ${messages.length}`);
-  if (messages.length < 10) {
-    logDebug("relationship", "Skipped: < 10 messages");
-    return;
-  }
-
-  if (!process.env.PAL_ANTHROPIC_API_KEY) {
-    logDebug("relationship", "Skipped: no PAL_ANTHROPIC_API_KEY");
-    return;
-  }
-
-  // Collect user messages for analysis
-  const userMessages = messages
-    .filter((m) => m.role === "user")
-    .map((m) => extractContent(m))
-    .filter((t) => t.length > 0)
-    .slice(-15)
-    .map((t) => t.slice(0, 200));
-
-  logDebug("relationship", `User messages: ${userMessages.length}`);
-  if (userMessages.length < 3) {
-    logDebug("relationship", "Skipped: < 3 user messages");
-    return;
-  }
-
-  logDebug("relationship", "Calling inference...");
-  const result = await inference({
-    system:
-      "You analyze messages from an AI assistant session to extract relationship observations. " +
-      "Types: O=opinions/preferences (how the user likes to work, what they want), " +
-      "B=biographical (what the AI accomplished this session, written in first-person), " +
-      "W=world facts (user's situation, projects, tools they use). " +
-      "Focus on: preferences, corrections, frustrations, positive reactions, communication style, and session accomplishments. " +
-      "Return 0-3 observations. If nothing notable, return empty observations array. Be concise.",
-    user: `User messages from this session:\n${userMessages.map((m, i) => `${i + 1}. ${m}`).join("\n")}`,
-    maxTokens: 300,
-    timeout: 8000,
-    jsonSchema: OBSERVATION_SCHEMA,
-  });
-
-  if (result.usage) logTokenUsage("relationship", result.usage);
-
-  logDebug("relationship", `Inference result: success=${result.success}`);
-  if (!result.success || !result.output) {
-    logDebug("relationship", "Skipped: inference failed or empty output");
-    return;
-  }
-
-  try {
-    const parsed = JSON.parse(result.output) as {
-      observations: Array<{ type: "O" | "W" | "B"; text: string; confidence: number }>;
-    };
-
-    logDebug("relationship", `Parsed ${parsed.observations?.length ?? 0} observations`);
-    if (!parsed.observations || parsed.observations.length === 0) return;
-
-    const notes: RelationshipNote[] = parsed.observations.map((o) => ({
-      type: o.type,
-      text: o.text,
-      confidence: o.confidence,
-    }));
-
-    appendNotes(notes, sessionId);
-    logDebug("relationship", `Captured ${notes.length} observations via inference`);
-  } catch (err) {
-    logError("relationship", err);
-  }
-}

package/src/hooks/handlers/work-learning.ts

@@ -1,196 +0,0 @@
-/**
- * Stop handler: writes a structured learning file for significant sessions.
- * Dedup: only writes once per session ID (tracks in a marker file).
- * Threshold: >2000 chars transcript + at least 6 messages.
- * Output: memory/learning/session/YYYY-MM/{datetime}_work_{slug}.md
- */
-
-import { existsSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
-import { resolve } from "node:path";
-import { stringify } from "../lib/frontmatter";
-import { inference } from "../lib/inference";
-import { categorizeLearning } from "../lib/learning-category";
-import { ensureDir, paths } from "../lib/paths";
-import { fileTimestamp, monthPath } from "../lib/time";
-import { logTokenUsage } from "../lib/token-usage";
-import {
-  extractContent,
-  extractLastAssistant,
-  extractLastUser,
-  parseMessages,
-} from "../lib/transcript";
-import { appendProjectHistory } from "../lib/work-tracking";
-
-function slugify(text: string): string {
-  return text
-    .toLowerCase()
-    .replace(/[^a-z0-9\s]/g, "")
-    .trim()
-    .split(/\s+/)
-    .slice(0, 4)
-    .join("-");
-}
-
-const MIN_NEW_MESSAGES = 10;
-
-interface CaptureEntry {
-  filepath: string;
-  messageCount: number;
-}
-
-/** Get the previously captured entry for a session, if any */
-function getPreviousCapture(sessionId: string): CaptureEntry | null {
-  const markerPath = resolve(paths.state(), "captured-learnings.json");
-  if (!existsSync(markerPath)) return null;
-  try {
-    const raw = JSON.parse(readFileSync(markerPath, "utf-8"));
-    if (Array.isArray(raw)) return null;
-    const entry = raw[sessionId];
-    if (!entry) return null;
-    // Migrate old string format
-    if (typeof entry === "string") return { filepath: entry, messageCount: 0 };
-    return entry as CaptureEntry;
-  } catch {
-    return null;
-  }
-}
-
-function markCaptured(sessionId: string, filepath: string, messageCount: number): void {
-  const markerPath = resolve(paths.state(), "captured-learnings.json");
-  let data: Record<string, CaptureEntry> = {};
-  try {
-    if (existsSync(markerPath)) {
-      const raw = JSON.parse(readFileSync(markerPath, "utf-8"));
-      if (!Array.isArray(raw) && typeof raw === "object") {
-        for (const [k, v] of Object.entries(raw)) {
-          if (typeof v === "string") {
-            data[k] = { filepath: v, messageCount: 0 };
-          } else {
-            data[k] = v as CaptureEntry;
-          }
-        }
-      }
-    }
-  } catch {
-    /* start fresh */
-  }
-  data[sessionId] = { filepath, messageCount };
-  // Keep last 50
-  const entries = Object.entries(data);
-  if (entries.length > 50) {
-    data = Object.fromEntries(entries.slice(-50));
-  }
-  writeFileSync(markerPath, JSON.stringify(data, null, 2), "utf-8");
-}
-
-export async function captureWorkLearning(
-  transcript: string,
-  sessionId?: string
-): Promise<void> {
-  if (transcript.length < 2000) return;
-
-  const messages = parseMessages(transcript);
-  if (messages.length < 6) return;
-
-  // Skip if not enough new messages since last capture
-  if (sessionId) {
-    const prev = getPreviousCapture(sessionId);
-    if (prev && messages.length - prev.messageCount < MIN_NEW_MESSAGES) return;
-  }
-
-  const lastUser = extractLastUser(messages);
-  const lastAssistant = extractLastAssistant(messages);
-
-  const rawTitle = extractContent(lastUser).slice(0, 80) || "session";
-  const rawSummary = extractContent(lastAssistant).slice(0, 600);
-
-  // Generate title, summary, and insights in a single inference call
-  let title = rawTitle;
-  let summary = rawSummary;
-  let insights = "";
-  try {
-    const userMessages = messages
-      .filter((m) => m.role === "user")
-      .map((m) => extractContent(m).slice(0, 100))
-      .slice(-8)
-      .join("\n");
-    const result = await inference({
-      system:
-        "You summarize sessions between a human user and an AI assistant. Sessions may involve coding, research, writing, planning, analysis, or any other task. The 'Human messages' are what the user said. The 'AI response' is what the assistant said. Produce: 1) a short title (5-10 words) describing what was accomplished, 2) a summary of what the AI assistant did for the user (2-4 sentences, write from the AI's perspective using 'we'), 3) insights — what worked well, what was surprising, or what should be done differently next time (2-3 bullet points, no markdown).",
-      user: `Human messages:\n${userMessages}\n\nAI response:\n${rawSummary.slice(0, 400)}`,
-      maxTokens: 300,
-      timeout: 15000,
-      jsonSchema: {
-        type: "object" as const,
-        additionalProperties: false,
-        properties: {
-          title: { type: "string" as const },
-          summary: { type: "string" as const },
-          insights: { type: "string" as const },
-        },
-        required: ["title", "summary", "insights"],
-      },
-    });
-    if (result.usage) logTokenUsage("work-learning", result.usage);
-    if (result.success && result.output) {
-      const parsed = JSON.parse(result.output) as {
-        title?: string;
-        summary?: string;
-        insights?: string;
-      };
-      if (parsed.title) title = parsed.title.slice(0, 100);
-      if (parsed.summary) summary = parsed.summary;
-      if (parsed.insights) insights = parsed.insights;
-    }
-  } catch {
-    // Fallback to raw values
-  }
-  const category = categorizeLearning(title, summary);
-
-  const slug = slugify(title);
-  const dir = ensureDir(resolve(paths.sessionLearning(), monthPath()));
-  const filename = `${fileTimestamp()}_${category}_${slug}.md`;
-
-  const meta: Record<string, unknown> = {
-    title,
-    category,
-    date: new Date().toISOString().slice(0, 10),
-    cwd: process.cwd(),
-  };
-  if (sessionId) meta.session = sessionId;
-
-  const body = [
-    "## What Was Done",
-    summary,
-    "",
-    "## Insights",
-    insights || "*No insights captured.*",
-  ].join("\n");
-
-  const content = stringify(meta, body);
-
-  // Remove previous capture for this session (overwrite on continued conversations)
-  if (sessionId) {
-    const prev = getPreviousCapture(sessionId);
-    if (prev?.filepath && existsSync(prev.filepath)) {
-      try {
-        unlinkSync(prev.filepath);
-      } catch {
-        /* ignore */
-      }
-    }
-  }
-
-  const filepath = resolve(dir, filename);
-  writeFileSync(filepath, content, "utf-8");
-
-  // Append to per-project history (agent-agnostic recall)
-  appendProjectHistory(process.cwd(), {
-    date: new Date().toISOString().slice(0, 10),
-    title,
-    summary,
-    insights,
-  });
-
-  if (sessionId) markCaptured(sessionId, filepath, messages.length);
-}

package/src/hooks/setup-check.ts

@@ -1,42 +0,0 @@
-/**
- * CLI helper: check setup state and output results.
- *
- * Usage:
- *   bun run hooks/setup-check.ts status     → "complete" or "incomplete"
- *   bun run hooks/setup-check.ts init        → create setup.json if missing
- *   bun run hooks/setup-check.ts prompt      → output setup prompt (if incomplete)
- *
- * Used by shell scripts to avoid duplicating setup logic.
- */
-
-import {
-  buildSetupPrompt,
-  ensureSetupState,
-  isSetupComplete,
-  readSetupState,
-} from "./lib/setup";
-
-const command = process.argv[2] ?? "status";
-
-switch (command) {
-  case "status": {
-    const state = readSetupState();
-    console.log(state && isSetupComplete(state) ? "complete" : "incomplete");
-    break;
-  }
-  case "init": {
-    ensureSetupState();
-    break;
-  }
-  case "prompt": {
-    const state = readSetupState();
-    if (state) {
-      const prompt = buildSetupPrompt(state);
-      if (prompt) console.log(prompt);
-    }
-    break;
-  }
-  default:
-    console.error(`Unknown command: ${command}`);
-    process.exit(1);
-}