jfl 0.1.1 → 0.2.0

package/dist/lib/agent-generator.js

@@ -5,7 +5,7 @@
  *
  * @purpose Generate service agent definitions for GTM integration
  */
-import { writeFileSync, mkdirSync, existsSync } from "fs";
+import { writeFileSync, mkdirSync, existsSync, readFileSync } from "fs";
 import { join } from "path";
 /**
  * Map service type to agent color
@@ -71,6 +71,97 @@ function generateSafetyGates(metadata) {
     }
     return gates;
 }
+/**
+ * Generate peer services section for service CLAUDE.md
+ */
+function generatePeerServicesSection(currentServiceName, gtmPath) {
+    // Try to load registered services from GTM config
+    const gtmConfigPath = join(gtmPath, ".jfl/config.json");
+    if (!existsSync(gtmConfigPath)) {
+        return `## Peer Services Available
+
+You can collaborate with other services in this GTM workspace.
+Run \`jfl services sync-agents\` to discover peer services.`;
+    }
+    try {
+        const gtmConfig = JSON.parse(readFileSync(gtmConfigPath, "utf-8"));
+        const registeredServices = gtmConfig.registered_services || [];
+        // Filter out current service
+        const peers = registeredServices.filter((s) => s.name !== currentServiceName && s.status === "active");
+        if (peers.length === 0) {
+            return `## Peer Services Available
+
+No other services registered yet. When services are onboarded, you'll be able to @ mention them.`;
+        }
+        // Generate peer services table
+        const peerTable = peers
+            .map((p) => {
+            const whenToUse = getWhenToUseForType(p.type);
+            return `| @peer-service-${p.name} | ${p.type} | ${whenToUse} |`;
+        })
+            .join("\n");
+        return `## Peer Services Available
+
+You can collaborate with other services in this GTM workspace:
+
+| Peer Service | Type | When to Use |
+|--------------|------|-------------|
+${peerTable}
+
+### How to Collaborate
+
+**Direct @-mention (preferred):**
+\`\`\`
+@peer-service-formation can you generate a landing page?
+@peer-service-context-hub what changed system-wide in last 24h?
+\`\`\`
+
+**MCP fallback (if agent spawning unavailable):**
+\`\`\`
+service_peer_call("peer-service-formation", "generate", {...})
+service_peer_list()  # List all peers
+service_peer_status("peer-service-formation")  # Check status
+\`\`\`
+
+### When to Collaborate vs Handle Alone
+
+**Collaborate when:**
+- Task outside your service's core responsibility
+- Need data/context from another service
+- Coordinating multi-service operation
+
+**Handle alone when:**
+- Task within your service's domain
+- Operation is service-local
+- You have all needed context`;
+    }
+    catch {
+        return `## Peer Services Available
+
+Run \`jfl services sync-agents\` to discover peer services.`;
+    }
+}
+/**
+ * Get "When to Use" guidance for a service type
+ */
+function getWhenToUseForType(type) {
+    switch (type) {
+        case "api":
+            return "API data/endpoints";
+        case "web":
+            return "Frontend/UI tasks";
+        case "worker":
+            return "Background jobs";
+        case "infrastructure":
+            return "System health/metrics";
+        case "container":
+            return "Container ops";
+        case "cli":
+            return "CLI automation";
+        default:
+            return "Service tasks";
+    }
+}
 /**
  * Generate agent definition content
  */
@@ -192,6 +283,8 @@ You can be invoked via:
 
 When spawned, the GTM agent may provide context from GTM knowledge docs. Use this to align with overall strategy.
 
+${generatePeerServicesSection(agentDef.name.replace("service-", ""), gtmPath)}
+
 ## Example Requests
 
 **"What's your current status?"**

package/dist/lib/agent-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-generator.js","sourceRoot":"","sources":["../../src/lib/agent-generator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,IAAI,CAAA;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAa3B;;GAEG;AACH,SAAS,aAAa,CAAC,IAA6B;IAClD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,KAAK,CAAC;QACX,KAAK,KAAK,CAAC;QACX,KAAK,QAAQ;YACX,OAAO,OAAO,CAAA,CAAC,wBAAwB;QACzC,KAAK,gBAAgB;YACnB,OAAO,QAAQ,CAAA,CAAC,sBAAsB;QACxC,KAAK,WAAW;YACd,OAAO,MAAM,CAAA,CAAC,wBAAwB;QACxC,KAAK,KAAK;YACR,OAAO,OAAO,CAAA,CAAC,iBAAiB;QAClC;YACE,OAAO,OAAO,CAAA;IAClB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAC3B,QAAyB,EACzB,WAAmB;IAEnB,MAAM,IAAI,GAAa,EAAE,CAAA;IAEzB,sBAAsB;IACtB,IAAI,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAA;IAC1E,IAAI,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAA;IACtD,IAAI,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAA;IACzC,IAAI,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAA;IAE7D,6BAA6B;IAC7B,IAAI,QAAQ,CAAC,IAAI,KAAK,KAAK,IAAI,QAAQ,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACvD,IAAI,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAA;QAC7C,IAAI,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAA;QAC1C,IAAI,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAA;QACzC,IAAI,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;IAC7C,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAA;QAC/D,IAAI,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAA;QACxD,IAAI,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;IAC7C,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAA;QAC9C,IAAI,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAA;QAClD,IAAI,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAA;IACzD,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,QAAyB;IACpD,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,iDAAiD;IACjD,KAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAA;IAC3D,KAAK,CAAC,IAAI,CAAC,yFAAyF,CAAC,CAAA;IAErG,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAA;IAC7E,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAA;IAClE,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAyB,EACzB,WAAmB,EACnB,OAAe;IAEf,MAAM,IAAI,GAAG,WAAW,QAAQ,CAAC,IAAI,EAAE,CAAA;IACvC,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC1C,MAAM,YAAY,GAAG,oBAAoB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;IAChE,MAAM,WAAW,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAA;IAEjD,MAAM,aAAa,GAAG;QACpB,0CAA0C;QAC1C,kCAAkC;QAClC,uCAAuC;QACvC,gCAAgC;KACjC,CAAA;IAED,OAAO;QACL,IAAI;QACJ,KAAK;QACL,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,YAAY;QACZ,WAAW;QACX,gBAAgB,EAAE,WAAW;QAC7B,aAAa;KACd,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAyB,EACzB,OAAe;IAEf,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAA;IAEjD,0BAA0B;IAC1B,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC3C,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,IAAI,KAAK,CAAC,CAAA;IAExD,MAAM,OAAO,GAAG;QACV,QAAQ,CAAC,IAAI;;SAEZ,QAAQ,CAAC,KAAK;eACR,QAAQ,CAAC,WAAW;;;mBAGhB,QAAQ,CAAC,IAAI;;2BAEL,QAAQ,CAAC,gBAAgB;;;;kCAIlB,QAAQ,CAAC,IAAI;;;;;;EAM7C,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;0BAEtC,QAAQ,CAAC,gBAAgB;;;;;;EAMjD,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;EAIzD,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;gBAoB5C,QAAQ,CAAC,IAAI;;;;;;;;;;;;;SAapB,QAAQ,CAAC,gBAAgB;wDACsB,QAAQ,CAAC,IAAI;;;;;;;;;SAS5D,QAAQ,CAAC,gBAAgB;;;;;;;;gCAQF,QAAQ,CAAC,IAAI;6BAChB,QAAQ,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2CzC,CAAA;IAEC,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IAEjC,OAAO,SAAS,CAAA;AAClB,CAAC"}
+{"version":3,"file":"agent-generator.js","sourceRoot":"","sources":["../../src/lib/agent-generator.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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"}