@tonycasey/lisa 0.5.13

package/dist/templates/agents/skills/prompt/scripts/prompt.js

@@ -0,0 +1,184 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Prompt Capture Skill
+ *
+ * Stores user prompts as episodes in Graphiti MCP.
+ * Graphiti's LLM automatically classifies entities as:
+ * - KeyDecision: Major decisions about approach/strategy
+ * - DirectionChange: Changes in strategy or pivots
+ * - ArchitecturalChoice: Technical/architectural decisions
+ * - Preference: User preferences and style choices
+ * - Requirement: Specific needs that must be fulfilled
+ *
+ * The classification happens server-side based on entity_types in config.yaml
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const crypto = require('crypto');
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+// ============================================================================
+// Group ID Utilities (inline to avoid import complexity in deployed skills)
+// ============================================================================
+const MAX_GROUP_ID_LENGTH = 128;
+function normalizePathToGroupId(absolutePath) {
+    let normalized = absolutePath
+        .toLowerCase()
+        .replace(/^\//, '')
+        .replace(/\//g, '-')
+        .replace(/\./g, '_'); // Graphiti requires alphanumeric, dashes, underscores only
+    if (normalized.length > MAX_GROUP_ID_LENGTH) {
+        normalized = normalized.slice(-MAX_GROUP_ID_LENGTH);
+    }
+    return normalized;
+}
+function getCurrentGroupId(cwd = process.cwd()) {
+    return normalizePathToGroupId(cwd);
+}
+const args = process.argv.slice(2);
+function popFlag(name, fallback) {
+    const idx = args.indexOf(name);
+    if (idx === -1)
+        return fallback;
+    const val = args[idx + 1];
+    args.splice(idx, 2);
+    if (typeof fallback === 'boolean')
+        return true;
+    return val ?? fallback;
+}
+function hasFlag(name) {
+    const idx = args.indexOf(name);
+    if (idx === -1)
+        return false;
+    args.splice(idx, 1);
+    return true;
+}
+// Read from .agents/skills/.env (2 levels up from prompt/scripts/)
+const envPath = path.join(__dirname, '..', '..', '.env');
+const env = {};
+try {
+    const raw = fs.readFileSync(envPath, 'utf8');
+    raw.split(/\r?\n/).forEach((line) => {
+        if (!line || line.startsWith('#'))
+            return;
+        const idx = line.indexOf('=');
+        if (idx === -1)
+            return;
+        env[line.slice(0, idx).trim()] = line.slice(idx + 1).trim();
+    });
+}
+catch (_) {
+    /* optional */
+}
+const endpoint = popFlag('--endpoint', env.GRAPHITI_ENDPOINT || process.env.GRAPHITI_ENDPOINT || 'http://localhost:8010/mcp/');
+// Group ID: explicit --group > env > folder-based (current directory)
+const explicitGroup = popFlag('--group', false);
+const groupId = explicitGroup || env.GRAPHITI_GROUP_ID || process.env.GRAPHITI_GROUP_ID || getCurrentGroupId();
+const force = hasFlag('--force') || popFlag('--force', false);
+function parseArgs() {
+    const out = { role: 'user', source: 'user-prompt' };
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--text' || args[i] === '-t')
+            out.text = args[++i];
+        if (args[i] === '--role' || args[i] === '-r')
+            out.role = args[++i];
+        if (args[i] === '--source' || args[i] === '-s')
+            out.source = args[++i];
+        // Legacy support for --kind (now ignored - Graphiti classifies automatically)
+        if (args[i] === '--kind' || args[i] === '-k')
+            i++; // skip value
+    }
+    return out;
+}
+function fingerprint(text) {
+    return crypto.createHash('sha1').update(text.trim()).digest('hex').slice(0, 16);
+}
+async function initialize() {
+    const body = {
+        jsonrpc: '2.0',
+        id: 'init',
+        method: 'initialize',
+        params: {
+            protocolVersion: '2024-11-05',
+            capabilities: { experimental: {}, prompts: { listChanged: false }, resources: { subscribe: false, listChanged: false }, tools: { listChanged: false } },
+            clientInfo: { name: 'prompt-skill', version: '0.1.0' },
+        },
+    };
+    const resp = await fetch(endpoint, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', Accept: 'application/json, text/event-stream' },
+        body: JSON.stringify(body),
+    });
+    if (!resp.ok)
+        throw new Error(`initialize failed: ${resp.status}`);
+    const sid = resp.headers.get('mcp-session-id');
+    if (!sid)
+        throw new Error('missing mcp-session-id');
+    return sid;
+}
+async function rpcCall(method, params, sessionId) {
+    const payload = method === 'initialize' || method === 'ping' || method.startsWith('tools/')
+        ? { jsonrpc: '2.0', id: '1', method, params }
+        : { jsonrpc: '2.0', id: '1', method: 'tools/call', params: { name: method, arguments: params } };
+    const resp = await fetch(endpoint, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', 'MCP-SESSION-ID': sessionId, Accept: 'application/json, text/event-stream' },
+        body: JSON.stringify(payload),
+    });
+    let text = await resp.text();
+    if (text.startsWith('event:')) {
+        const dataLine = text.split('\n').find((l) => l.startsWith('data:'));
+        if (dataLine)
+            text = dataLine.slice(5).trim();
+    }
+    const data = JSON.parse(text);
+    if (!resp.ok || data.error)
+        throw new Error(data?.error?.message || `HTTP ${resp.status}`);
+    return data.result?.structuredContent?.result || data.result || data;
+}
+async function addPrompt() {
+    const { text, role = 'user', source = 'user-prompt' } = parseArgs();
+    if (!text)
+        throw new Error('prompt requires --text');
+    const fp = fingerprint(text);
+    const fpTag = `fingerprint:${fp}`;
+    const sid = await initialize();
+    if (!force) {
+        try {
+            const searchParams = { query: fp, tags: [fpTag], max_nodes: 1, group_ids: [groupId] };
+            const existing = await rpcCall('search_nodes', searchParams, sid);
+            const nodes = existing?.result?.nodes || existing?.nodes || [];
+            if (nodes.length) {
+                console.log('Duplicate prompt; skipping (use --force to override).');
+                return { status: 'skipped', reason: 'duplicate' };
+            }
+        }
+        catch (_) {
+            // ignore dedupe errors
+        }
+    }
+    // Let Graphiti's LLM classify the content automatically based on entity_types config
+    // We just provide the raw text - classification happens server-side
+    const params = {
+        name: text.substring(0, 100),
+        episode_body: text, // Pass raw text for better LLM classification
+        source: source, // Track where this came from
+        group_id: groupId,
+        tags: [fpTag, `role:${role}`, `source:${source}`],
+    };
+    await rpcCall('add_memory', params, sid);
+    return { status: 'ok', action: 'add', group: groupId, role, source };
+}
+async function main() {
+    try {
+        const result = await addPrompt();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(message);
+        process.exit(1);
+    }
+}
+main();

package/dist/templates/agents/skills/tasks/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: tasks
+description: "Create, load, or summarize tasks via Graphiti MCP; triggers on 'tasks', 'list tasks', 'add task', usable by any model (Claude, Gemini)."
+---
+
+## Purpose
+Model-neutral helper to add/list tasks in Graphiti MCP so any agent can keep a shared task board.
+
+## Triggers
+Use when the user says: "add a task", "list tasks", "load tasks", "task status".
+
+## How to use
+1) List: `scripts/tasks.js list --cache [--group <id>] [--limit 20]`
+2) Add: `scripts/tasks.js add "<task text>" [--status todo|doing|done] [--tag foo] [--group <id>] --cache`
+3) Defaults: reads ${GRAPHITI_ENDPOINT} / ${GRAPHITI_GROUP_ID} from `.agents/.env` (written by init); see root `AGENTS.md` for canonical defaults.
+4) Cache fallback: writes/reads `cache/tasks.log` when `--cache` is passed, returning last cached result on MCP failure.
+5) Keep prompts model-neutral; models only orchestrate script calls and summarize JSON output.
+
+## I/O contract (examples)
+- List: `{ status: "ok", action: "list", tasks: [...] }`
+- Add: `{ status: "ok", action: "add", task: { text, status, group } }`
+- Fallback: `{ status: "fallback", error, fallback: <cached object> }`
+
+## Cross-model checklist
+- Claude: concise instructions; avoid role tokens; keep outputs small.
+- Gemini: explicit commands and minimal formatting.
+
+## Notes
+- Node.js script expects fetch (Node ≥18). Use `node --experimental-fetch` on older runtimes.
+- Tasks are stored via Graphiti MCP `add_task`/`list_tasks` (tool names referenced in script). Adjust if server differs.
+- Folder `.agents/skills/tasks/` keeps this decoupled from model-specific bindings.