jfl 0.1.0 → 0.2.0

package/dist/lib/memory-search.js

@@ -0,0 +1,246 @@
+/**
+ * Memory Search Module
+ *
+ * Hybrid search combining TF-IDF (fast, always available) and
+ * embeddings (semantic, optional). Provides relevance scoring
+ * and result ranking.
+ *
+ * @purpose Fast and semantic search across indexed memories
+ */
+import OpenAI from 'openai';
+import { getAllMemories, deserializeEmbedding } from './memory-db.js';
+/**
+ * Tokenize text for TF-IDF
+ * Reused from Context Hub implementation
+ */
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, ' ')
+        .split(/\s+/)
+        .filter(token => token.length > 2);
+}
+/**
+ * Compute TF-IDF scores for text
+ */
+export function computeTFIDF(text, allTexts) {
+    const tokens = tokenize(text);
+    const tokenCounts = {};
+    // Term frequency
+    tokens.forEach(token => {
+        tokenCounts[token] = (tokenCounts[token] || 0) + 1;
+    });
+    const totalTokens = tokens.length;
+    const tf = {};
+    Object.keys(tokenCounts).forEach(token => {
+        tf[token] = tokenCounts[token] / totalTokens;
+    });
+    // Inverse document frequency
+    const idf = {};
+    const totalDocs = allTexts.length;
+    Object.keys(tf).forEach(token => {
+        const docsWithToken = allTexts.filter(doc => tokenize(doc).includes(token)).length;
+        idf[token] = Math.log(totalDocs / (docsWithToken + 1));
+    });
+    // TF-IDF
+    const tfidf = {};
+    Object.keys(tf).forEach(token => {
+        tfidf[token] = tf[token] * idf[token];
+    });
+    return tfidf;
+}
+/**
+ * Search memories using TF-IDF
+ */
+async function searchMemoriesTFIDF(query, memories, limit) {
+    const queryTokens = tokenize(query);
+    const scored = [];
+    for (const memory of memories) {
+        if (!memory.tf_idf_tokens)
+            continue;
+        const tfIdfTokens = JSON.parse(memory.tf_idf_tokens);
+        let score = 0;
+        for (const token of queryTokens) {
+            score += tfIdfTokens[token] || 0;
+        }
+        // Boost recent entries (1.3x if within 7 days)
+        const daysSinceCreated = daysBetween(memory.created_at, new Date().toISOString());
+        if (daysSinceCreated < 7) {
+            score *= 1.3;
+        }
+        // Boost by type
+        if (memory.type === 'decision')
+            score *= 1.4;
+        if (memory.type === 'feature')
+            score *= 1.2;
+        if (score > 0) {
+            scored.push({
+                memory,
+                score,
+                relevance: score > 0.7 ? 'high' : score > 0.4 ? 'medium' : 'low'
+            });
+        }
+    }
+    // Sort by score descending
+    scored.sort((a, b) => b.score - a.score);
+    return scored.slice(0, limit);
+}
+/**
+ * Compute embedding for text using OpenAI
+ */
+async function computeEmbedding(text) {
+    const apiKey = process.env.OPENAI_API_KEY;
+    if (!apiKey) {
+        return null;
+    }
+    try {
+        const openai = new OpenAI({ apiKey });
+        const response = await openai.embeddings.create({
+            model: 'text-embedding-3-small',
+            input: text,
+            encoding_format: 'float'
+        });
+        return {
+            embedding: new Float32Array(response.data[0].embedding),
+            model: 'text-embedding-3-small'
+        };
+    }
+    catch (error) {
+        console.error('Failed to compute embedding:', error);
+        return null;
+    }
+}
+/**
+ * Cosine similarity between two vectors
+ */
+function cosineSimilarity(a, b) {
+    if (a.length !== b.length) {
+        throw new Error('Vectors must have same length');
+    }
+    let dotProduct = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dotProduct += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    return dotProduct / (Math.sqrt(normA) * Math.sqrt(normB));
+}
+/**
+ * Search memories using embeddings
+ */
+async function searchMemoriesEmbedding(query, memories, limit) {
+    // Compute query embedding
+    const queryEmbedding = await computeEmbedding(query);
+    if (!queryEmbedding) {
+        return [];
+    }
+    const scored = [];
+    for (const memory of memories) {
+        if (!memory.embedding)
+            continue;
+        const memoryEmbedding = deserializeEmbedding(memory.embedding);
+        const similarity = cosineSimilarity(queryEmbedding.embedding, memoryEmbedding);
+        if (similarity > 0.5) {
+            scored.push({
+                memory,
+                score: similarity,
+                relevance: similarity > 0.8 ? 'high' : similarity > 0.65 ? 'medium' : 'low'
+            });
+        }
+    }
+    scored.sort((a, b) => b.score - a.score);
+    return scored.slice(0, limit * 2); // Get more for merging
+}
+/**
+ * Normalize scores to 0-1 range
+ */
+function normalizeScores(results) {
+    if (results.length === 0)
+        return [];
+    const maxScore = Math.max(...results.map(r => r.score));
+    const minScore = Math.min(...results.map(r => r.score));
+    const range = maxScore - minScore;
+    if (range === 0)
+        return results;
+    return results.map(r => ({
+        ...r,
+        score: (r.score - minScore) / range
+    }));
+}
+/**
+ * Hybrid search combining TF-IDF and embeddings
+ */
+async function searchMemoriesHybrid(query, memories, limit) {
+    // Run both searches in parallel
+    const [tfIdfResults, embeddingResults] = await Promise.all([
+        searchMemoriesTFIDF(query, memories, limit * 2),
+        searchMemoriesEmbedding(query, memories, limit * 2).catch(() => [])
+    ]);
+    // Normalize scores
+    const tfIdfNormalized = normalizeScores(tfIdfResults);
+    const embeddingNormalized = normalizeScores(embeddingResults);
+    // Merge with weights (TF-IDF: 0.4, Embedding: 0.6)
+    const mergedScores = new Map();
+    for (const result of tfIdfNormalized) {
+        const memId = result.memory.id;
+        mergedScores.set(memId, (mergedScores.get(memId) || 0) + result.score * 0.4);
+    }
+    for (const result of embeddingNormalized) {
+        const memId = result.memory.id;
+        mergedScores.set(memId, (mergedScores.get(memId) || 0) + result.score * 0.6);
+    }
+    // Create final results
+    const memoryMap = new Map();
+    tfIdfResults.forEach(r => memoryMap.set(r.memory.id, r.memory));
+    embeddingResults.forEach(r => memoryMap.set(r.memory.id, r.memory));
+    const finalResults = Array.from(mergedScores.entries())
+        .map(([id, score]) => ({
+        memory: memoryMap.get(id),
+        score,
+        relevance: score > 0.7 ? 'high' : score > 0.4 ? 'medium' : 'low'
+    }))
+        .sort((a, b) => b.score - a.score)
+        .slice(0, limit);
+    return finalResults;
+}
+/**
+ * Main search function
+ */
+export async function searchMemories(query, options = {}) {
+    const { maxItems = 10, type, since, method = 'hybrid' } = options;
+    // Get all memories
+    let memories = await getAllMemories();
+    // Apply filters
+    if (type && type !== 'all') {
+        memories = memories.filter(m => m.type === type);
+    }
+    if (since) {
+        memories = memories.filter(m => m.created_at >= since);
+    }
+    // Search based on method
+    if (method === 'tfidf') {
+        return searchMemoriesTFIDF(query, memories, maxItems);
+    }
+    else if (method === 'embedding') {
+        return searchMemoriesEmbedding(query, memories, maxItems);
+    }
+    else {
+        return searchMemoriesHybrid(query, memories, maxItems);
+    }
+}
+/**
+ * Calculate days between two dates
+ */
+function daysBetween(date1, date2) {
+    const d1 = new Date(date1);
+    const d2 = new Date(date2);
+    const diff = Math.abs(d2.getTime() - d1.getTime());
+    return Math.floor(diff / (1000 * 60 * 60 * 24));
+}
+/**
+ * Export compute embedding for use in indexer
+ */
+export { computeEmbedding };
+//# sourceMappingURL=memory-search.js.map

package/dist/lib/memory-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-search.js","sourceRoot":"","sources":["../../src/lib/memory-search.ts"],"names":[],"mappings":"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"}

package/dist/lib/openclaw-registry.d.ts

@@ -0,0 +1,48 @@
+/**
+ * OpenClaw Agent Registry
+ *
+ * Manages the multi-GTM agent registry at ~/.config/jfl/openclaw-agents.json.
+ * Tracks which agents are registered, their GTM workspaces, and active sessions.
+ *
+ * @purpose Multi-GTM agent registry management for OpenClaw protocol
+ * @spec specs/OPENCLAW_SPEC.md#5-multi-gtm-agent-registry
+ */
+export interface GtmRegistration {
+    id: string;
+    name: string;
+    path: string;
+    default: boolean;
+    registered_at: string;
+}
+export interface AgentSession {
+    branch: string;
+    started_at: string;
+    worktree: string | null;
+}
+export interface AgentEntry {
+    id: string;
+    runtime: string;
+    manifest_path: string | null;
+    registered_gtms: GtmRegistration[];
+    active_gtm: string | null;
+    session: AgentSession | null;
+}
+export interface AgentRegistry {
+    version: string;
+    agents: Record<string, AgentEntry>;
+}
+export declare function getAgent(agentId: string): AgentEntry | null;
+export declare function listAgents(): AgentEntry[];
+export declare function ensureAgent(agentId: string, runtime?: string): AgentEntry;
+export declare function setManifestPath(agentId: string, manifestPath: string): void;
+export declare function registerGtm(agentId: string, gtmPath: string, gtmName: string, setDefault?: boolean): GtmRegistration;
+export declare function getActiveGtm(agentId: string): GtmRegistration | null;
+export declare function switchGtm(agentId: string, gtmId: string): GtmRegistration;
+export declare function listGtms(agentId: string): GtmRegistration[];
+export declare function removeGtm(agentId: string, gtmId: string): boolean;
+export declare function updateSession(agentId: string, session: AgentSession | null): void;
+export declare function getActiveSession(agentId: string): AgentSession | null;
+export declare function clearSession(agentId: string): void;
+export declare function removeAgent(agentId: string): boolean;
+export declare function getRegistryPath(): string;
+//# sourceMappingURL=openclaw-registry.d.ts.map

package/dist/lib/openclaw-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-registry.d.ts","sourceRoot":"","sources":["../../src/lib/openclaw-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,eAAe,EAAE,eAAe,EAAE,CAAA;IAClC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,OAAO,EAAE,YAAY,GAAG,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CACnC;AA8BD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAG3D;AAED,wBAAgB,UAAU,IAAI,UAAU,EAAE,CAGzC;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAiB,GAAG,UAAU,CAgBnF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAM3E;AAMD,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,OAAe,GAC1B,eAAe,CA2CjB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAKpE;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAezE;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAI3D;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAgBjE;AAMD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,GAAG,IAAI,GAC3B,IAAI,CASN;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAGrE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAElD;AAMD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAMpD;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC"}

package/dist/lib/openclaw-registry.js

@@ -0,0 +1,181 @@
+/**
+ * OpenClaw Agent Registry
+ *
+ * Manages the multi-GTM agent registry at ~/.config/jfl/openclaw-agents.json.
+ * Tracks which agents are registered, their GTM workspaces, and active sessions.
+ *
+ * @purpose Multi-GTM agent registry management for OpenClaw protocol
+ * @spec specs/OPENCLAW_SPEC.md#5-multi-gtm-agent-registry
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import { join, dirname, basename } from "path";
+import { JFL_PATHS } from "../utils/jfl-paths.js";
+const REGISTRY_FILE = join(JFL_PATHS.config, "openclaw-agents.json");
+// ============================================================================
+// Registry I/O
+// ============================================================================
+function loadRegistry() {
+    if (!existsSync(REGISTRY_FILE)) {
+        return { version: "1.0", agents: {} };
+    }
+    try {
+        return JSON.parse(readFileSync(REGISTRY_FILE, "utf-8"));
+    }
+    catch {
+        return { version: "1.0", agents: {} };
+    }
+}
+function saveRegistry(registry) {
+    const dir = dirname(REGISTRY_FILE);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(REGISTRY_FILE, JSON.stringify(registry, null, 2) + "\n");
+}
+// ============================================================================
+// Agent Operations
+// ============================================================================
+export function getAgent(agentId) {
+    const registry = loadRegistry();
+    return registry.agents[agentId] || null;
+}
+export function listAgents() {
+    const registry = loadRegistry();
+    return Object.values(registry.agents);
+}
+export function ensureAgent(agentId, runtime = "custom") {
+    const registry = loadRegistry();
+    if (!registry.agents[agentId]) {
+        registry.agents[agentId] = {
+            id: agentId,
+            runtime,
+            manifest_path: null,
+            registered_gtms: [],
+            active_gtm: null,
+            session: null,
+        };
+        saveRegistry(registry);
+    }
+    return registry.agents[agentId];
+}
+export function setManifestPath(agentId, manifestPath) {
+    const registry = loadRegistry();
+    if (registry.agents[agentId]) {
+        registry.agents[agentId].manifest_path = manifestPath;
+        saveRegistry(registry);
+    }
+}
+// ============================================================================
+// GTM Operations
+// ============================================================================
+export function registerGtm(agentId, gtmPath, gtmName, setDefault = false) {
+    const registry = loadRegistry();
+    const agent = registry.agents[agentId];
+    if (!agent) {
+        throw new Error(`Agent "${agentId}" not found in registry. Call ensureAgent() first.`);
+    }
+    const gtmId = basename(gtmPath).toLowerCase().replace(/[^a-z0-9-]/g, "-");
+    // Check if already registered
+    const existing = agent.registered_gtms.find((g) => g.path === gtmPath);
+    if (existing) {
+        if (setDefault) {
+            agent.registered_gtms.forEach((g) => (g.default = false));
+            existing.default = true;
+        }
+        saveRegistry(registry);
+        return existing;
+    }
+    // If first GTM or explicit default, mark as default
+    const isDefault = setDefault || agent.registered_gtms.length === 0;
+    if (isDefault) {
+        agent.registered_gtms.forEach((g) => (g.default = false));
+    }
+    const registration = {
+        id: gtmId,
+        name: gtmName,
+        path: gtmPath,
+        default: isDefault,
+        registered_at: new Date().toISOString(),
+    };
+    agent.registered_gtms.push(registration);
+    if (isDefault) {
+        agent.active_gtm = gtmId;
+    }
+    saveRegistry(registry);
+    return registration;
+}
+export function getActiveGtm(agentId) {
+    const agent = getAgent(agentId);
+    if (!agent || !agent.active_gtm)
+        return null;
+    return agent.registered_gtms.find((g) => g.id === agent.active_gtm) || null;
+}
+export function switchGtm(agentId, gtmId) {
+    const registry = loadRegistry();
+    const agent = registry.agents[agentId];
+    if (!agent) {
+        throw new Error(`Agent "${agentId}" not found in registry`);
+    }
+    const gtm = agent.registered_gtms.find((g) => g.id === gtmId);
+    if (!gtm) {
+        throw new Error(`GTM "${gtmId}" not registered for agent "${agentId}"`);
+    }
+    agent.active_gtm = gtmId;
+    saveRegistry(registry);
+    return gtm;
+}
+export function listGtms(agentId) {
+    const agent = getAgent(agentId);
+    if (!agent)
+        return [];
+    return agent.registered_gtms;
+}
+export function removeGtm(agentId, gtmId) {
+    const registry = loadRegistry();
+    const agent = registry.agents[agentId];
+    if (!agent)
+        return false;
+    const idx = agent.registered_gtms.findIndex((g) => g.id === gtmId);
+    if (idx === -1)
+        return false;
+    agent.registered_gtms.splice(idx, 1);
+    if (agent.active_gtm === gtmId) {
+        agent.active_gtm = agent.registered_gtms[0]?.id || null;
+    }
+    saveRegistry(registry);
+    return true;
+}
+// ============================================================================
+// Session Operations
+// ============================================================================
+export function updateSession(agentId, session) {
+    const registry = loadRegistry();
+    const agent = registry.agents[agentId];
+    if (!agent) {
+        throw new Error(`Agent "${agentId}" not found in registry`);
+    }
+    agent.session = session;
+    saveRegistry(registry);
+}
+export function getActiveSession(agentId) {
+    const agent = getAgent(agentId);
+    return agent?.session || null;
+}
+export function clearSession(agentId) {
+    updateSession(agentId, null);
+}
+// ============================================================================
+// Utility
+// ============================================================================
+export function removeAgent(agentId) {
+    const registry = loadRegistry();
+    if (!registry.agents[agentId])
+        return false;
+    delete registry.agents[agentId];
+    saveRegistry(registry);
+    return true;
+}
+export function getRegistryPath() {
+    return REGISTRY_FILE;
+}
+//# sourceMappingURL=openclaw-registry.js.map

package/dist/lib/openclaw-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-registry.js","sourceRoot":"","sources":["../../src/lib/openclaw-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAA;AACvE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAEjD,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAA;AAkCpE,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,SAAS,YAAY;IACnB,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;IACvC,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAA;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;IACvC,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,QAAuB;IAC3C,MAAM,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;IAClC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACrC,CAAC;IACD,aAAa,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;AACxE,CAAC;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAA;IAC/B,OAAO,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAA;IAC/B,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;AACvC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,UAAkB,QAAQ;IACrE,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAA;IAE/B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG;YACzB,EAAE,EAAE,OAAO;YACX,OAAO;YACP,aAAa,EAAE,IAAI;YACnB,eAAe,EAAE,EAAE;YACnB,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,IAAI;SACd,CAAA;QACD,YAAY,CAAC,QAAQ,CAAC,CAAA;IACxB,CAAC;IAED,OAAO,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,YAAoB;IACnE,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAA;IAC/B,IAAI,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,aAAa,GAAG,YAAY,CAAA;QACrD,YAAY,CAAC,QAAQ,CAAC,CAAA;IACxB,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,MAAM,UAAU,WAAW,CACzB,OAAe,EACf,OAAe,EACf,OAAe,EACf,aAAsB,KAAK;IAE3B,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAA;IAC/B,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,oDAAoD,CAAC,CAAA;IACxF,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAA;IAEzE,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAA;IACtE,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,UAAU,EAAE,CAAC;YACf,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAA;YACzD,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAA;QACzB,CAAC;QACD,YAAY,CAAC,QAAQ,CAAC,CAAA;QACtB,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,oDAAoD;IACpD,MAAM,SAAS,GAAG,UAAU,IAAI,KAAK,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,CAAA;IAElE,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAA;IAC3D,CAAC;IAED,MAAM,YAAY,GAAoB;QACpC,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,SAAS;QAClB,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACxC,CAAA;IAED,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IAExC,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,CAAC,UAAU,GAAG,KAAK,CAAA;IAC1B,CAAC;IAED,YAAY,CAAC,QAAQ,CAAC,CAAA;IACtB,OAAO,YAAY,CAAA;AACrB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC/B,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,UAAU;QAAE,OAAO,IAAI,CAAA;IAE5C,OAAO,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,UAAU,CAAC,IAAI,IAAI,CAAA;AAC7E,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,KAAa;IACtD,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAA;IAC/B,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,yBAAyB,CAAC,CAAA;IAC7D,CAAC;IAED,MAAM,GAAG,GAAG,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,CAAA;IAC7D,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,+BAA+B,OAAO,GAAG,CAAC,CAAA;IACzE,CAAC;IAED,KAAK,CAAC,UAAU,GAAG,KAAK,CAAA;IACxB,YAAY,CAAC,QAAQ,CAAC,CAAA;IACtB,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC/B,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAA;IACrB,OAAO,KAAK,CAAC,eAAe,CAAA;AAC9B,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,KAAa;IACtD,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAA;IAC/B,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACtC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IAExB,MAAM,GAAG,GAAG,KAAK,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,CAAA;IAClE,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA;IAE5B,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;IAEpC,IAAI,KAAK,CAAC,UAAU,KAAK,KAAK,EAAE,CAAC;QAC/B,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,IAAI,CAAA;IACzD,CAAC;IAED,YAAY,CAAC,QAAQ,CAAC,CAAA;IACtB,OAAO,IAAI,CAAA;AACb,CAAC;AAED,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,MAAM,UAAU,aAAa,CAC3B,OAAe,EACf,OAA4B;IAE5B,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAA;IAC/B,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,yBAAyB,CAAC,CAAA;IAC7D,CAAC;IAED,KAAK,CAAC,OAAO,GAAG,OAAO,CAAA;IACvB,YAAY,CAAC,QAAQ,CAAC,CAAA;AACxB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC/B,OAAO,KAAK,EAAE,OAAO,IAAI,IAAI,CAAA;AAC/B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;AAC9B,CAAC;AAED,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAA;IAC/B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAA;IAC3C,OAAO,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAC/B,YAAY,CAAC,QAAQ,CAAC,CAAA;IACtB,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,aAAa,CAAA;AACtB,CAAC"}

package/dist/lib/openclaw-sdk.d.ts

@@ -0,0 +1,107 @@
+/**
+ * OpenClaw TypeScript SDK
+ *
+ * Thin wrapper around Context Hub HTTP API and direct file I/O.
+ * For Node.js agent runtimes (Clawdbot, custom) that prefer imports over shell-outs.
+ *
+ * Primary path: HTTP to Context Hub (fast, no process spawn).
+ * Fallback: Shell out to `jfl openclaw` commands.
+ *
+ * @purpose Runtime-agnostic SDK for OpenClaw agent protocol
+ * @spec specs/OPENCLAW_SPEC.md
+ */
+export interface OpenClawConfig {
+    agentId: string;
+    hubUrl?: string;
+    gtmPath?: string;
+}
+export interface SessionInfo {
+    session_id: string;
+    branch: string;
+    gtm_path: string;
+    gtm_name: string;
+    context_hub: {
+        url: string;
+        healthy: boolean;
+    };
+    auto_commit: {
+        running: boolean;
+        interval: number;
+    };
+}
+export interface HealthStatus {
+    healthy: boolean;
+    context_hub: boolean;
+    uncommitted_changes: boolean;
+    last_commit: string | null;
+    session_duration_seconds: number;
+}
+export interface ContextItem {
+    source: string;
+    type: string;
+    title: string;
+    content: string;
+    path?: string;
+    relevance?: number;
+}
+export interface MemoryResult {
+    id: string;
+    title: string;
+    summary: string;
+    type: string;
+    ts: string;
+    relevance: string;
+    score: number;
+}
+export interface JournalEntry {
+    v: number;
+    ts: string;
+    session: string;
+    type: "feature" | "fix" | "decision" | "milestone" | "spec" | "discovery";
+    status?: "complete" | "incomplete" | "blocked";
+    title: string;
+    summary: string;
+    detail?: string;
+    files?: string[];
+    decision?: string;
+    incomplete?: string[];
+    next?: string;
+    learned?: string[];
+}
+export interface GtmInfo {
+    id: string;
+    name: string;
+    path: string;
+    default: boolean;
+    registered_at: string;
+}
+export interface ServiceInfo {
+    name: string;
+    path: string;
+    type: string;
+    status: string;
+}
+export declare class OpenClawClient {
+    private agentId;
+    private hubUrl;
+    private gtmPath;
+    private http;
+    private sessionId;
+    constructor(config: OpenClawConfig);
+    sessionStart(gtmPath?: string): Promise<SessionInfo>;
+    sessionEnd(sync?: boolean): Promise<void>;
+    heartbeat(): Promise<HealthStatus>;
+    getContext(query?: string, taskType?: string): Promise<ContextItem[]>;
+    searchMemory(query: string, type?: string): Promise<MemoryResult[]>;
+    writeJournal(entry: Partial<JournalEntry>): Promise<void>;
+    listGtms(): Promise<GtmInfo[]>;
+    switchGtm(gtmId: string): Promise<void>;
+    createGtm(name: string, path?: string): Promise<string>;
+    tagService(name: string, message: string): Promise<void>;
+    listServices(): Promise<ServiceInfo[]>;
+    private cli;
+    private getAuthHeaders;
+    private resolveGtmPath;
+    private getCurrentSessionBranch;
+}
+//# sourceMappingURL=openclaw-sdk.d.ts.map

package/dist/lib/openclaw-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-sdk.d.ts","sourceRoot":"","sources":["../../src/lib/openclaw-sdk.ts"],"names":[],"mappings":"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"}