@10et/cli 1.0.0

package/dist/lib/openclaw-sdk.js

@@ -0,0 +1,220 @@
+/**
+ * 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
+ */
+import { execSync } from "child_process";
+import { existsSync, readFileSync, appendFileSync, mkdirSync } from "fs";
+import { join } from "path";
+import axios from "axios";
+import { getProjectHubUrl } from "../utils/context-hub-port.js";
+// ============================================================================
+// Client
+// ============================================================================
+export class OpenClawClient {
+    agentId;
+    hubUrl;
+    gtmPath;
+    http;
+    sessionId = null;
+    constructor(config) {
+        this.agentId = config.agentId;
+        this.hubUrl = config.hubUrl || getProjectHubUrl();
+        this.gtmPath = config.gtmPath || null;
+        this.http = axios.create({
+            baseURL: this.hubUrl,
+            timeout: 10000,
+            headers: this.getAuthHeaders(),
+        });
+    }
+    // ==========================================================================
+    // Session Lifecycle
+    // ==========================================================================
+    async sessionStart(gtmPath) {
+        const result = this.cli(`session-start --agent ${this.agentId}${gtmPath ? ` --gtm "${gtmPath}"` : ""} --json`);
+        const info = JSON.parse(result);
+        this.sessionId = info.session_id;
+        this.gtmPath = info.gtm_path;
+        return info;
+    }
+    async sessionEnd(sync = false) {
+        this.cli(`session-end${sync ? " --sync" : ""} --json`);
+        this.sessionId = null;
+    }
+    async heartbeat() {
+        const result = this.cli("heartbeat --json");
+        return JSON.parse(result);
+    }
+    async pivot(summary) {
+        try {
+            const resp = await this.http.post("/api/session/pivot", { summary });
+            return resp.data;
+        }
+        catch {
+            const args = summary ? `--summary "${summary}" --json` : "--json";
+            const result = this.cli(`pivot ${args}`);
+            return JSON.parse(result);
+        }
+    }
+    // ==========================================================================
+    // Context (via HTTP API)
+    // ==========================================================================
+    async getContext(query, taskType) {
+        try {
+            const resp = await this.http.post("/api/context", {
+                query,
+                taskType,
+                maxItems: 30,
+            });
+            return resp.data.items || resp.data || [];
+        }
+        catch {
+            // Fallback to CLI
+            const args = [
+                query ? `--query "${query}"` : "",
+                taskType ? `--task-type ${taskType}` : "",
+            ]
+                .filter(Boolean)
+                .join(" ");
+            const result = this.cli(`context ${args} --json`);
+            return JSON.parse(result);
+        }
+    }
+    async searchMemory(query, type) {
+        try {
+            const resp = await this.http.post("/api/memory/search", {
+                query,
+                type,
+                maxItems: 10,
+            });
+            return resp.data.results || resp.data || [];
+        }
+        catch {
+            // Fallback not available for memory search via CLI
+            return [];
+        }
+    }
+    // ==========================================================================
+    // Journal (direct JSONL append)
+    // ==========================================================================
+    async writeJournal(entry) {
+        const session = this.sessionId || this.getCurrentSessionBranch();
+        if (!session) {
+            throw new Error("No active session. Call sessionStart() first.");
+        }
+        const gtmPath = this.resolveGtmPath();
+        if (!gtmPath) {
+            throw new Error("No GTM path resolved. Register with a GTM first.");
+        }
+        const journalDir = join(gtmPath, ".jfl", "journal");
+        if (!existsSync(journalDir)) {
+            mkdirSync(journalDir, { recursive: true });
+        }
+        const fullEntry = {
+            v: 1,
+            ts: new Date().toISOString(),
+            session,
+            type: entry.type || "feature",
+            title: entry.title || "Untitled",
+            summary: entry.summary || "",
+            ...entry,
+        };
+        const journalFile = join(journalDir, `${session}.jsonl`);
+        appendFileSync(journalFile, JSON.stringify(fullEntry) + "\n");
+    }
+    // ==========================================================================
+    // GTM Management
+    // ==========================================================================
+    async listGtms() {
+        const result = this.cli("gtm-list --json");
+        return JSON.parse(result);
+    }
+    async switchGtm(gtmId) {
+        this.cli(`gtm-switch "${gtmId}" --json`);
+    }
+    async createGtm(name, path) {
+        const args = path ? `"${name}" --path "${path}"` : `"${name}"`;
+        const result = this.cli(`gtm-create ${args} --json`);
+        const parsed = JSON.parse(result);
+        return parsed.path || parsed.gtm_path;
+    }
+    // ==========================================================================
+    // Service Coordination
+    // ==========================================================================
+    async tagService(name, message) {
+        this.cli(`tag "${name}" "${message}"`);
+    }
+    async listServices() {
+        const gtmPath = this.resolveGtmPath();
+        if (!gtmPath)
+            return [];
+        const configPath = join(gtmPath, ".jfl", "config.json");
+        if (!existsSync(configPath))
+            return [];
+        try {
+            const config = JSON.parse(readFileSync(configPath, "utf-8"));
+            return config.registered_services || [];
+        }
+        catch {
+            return [];
+        }
+    }
+    // ==========================================================================
+    // Private Helpers
+    // ==========================================================================
+    cli(subcommand) {
+        try {
+            return execSync(`jfl openclaw ${subcommand}`, {
+                encoding: "utf-8",
+                timeout: 30000,
+                stdio: ["pipe", "pipe", "pipe"],
+            }).trim();
+        }
+        catch (err) {
+            throw new Error(`jfl openclaw ${subcommand} failed: ${err.stderr || err.message}`);
+        }
+    }
+    getAuthHeaders() {
+        const gtmPath = this.resolveGtmPath();
+        if (!gtmPath)
+            return {};
+        const tokenPath = join(gtmPath, ".jfl", "context-hub.token");
+        if (!existsSync(tokenPath))
+            return {};
+        const token = readFileSync(tokenPath, "utf-8").trim();
+        return { Authorization: `Bearer ${token}` };
+    }
+    resolveGtmPath() {
+        if (this.gtmPath)
+            return this.gtmPath;
+        // Try to get from registry via CLI
+        try {
+            const result = this.cli("status --json");
+            const status = JSON.parse(result);
+            return status.gtm_path || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    getCurrentSessionBranch() {
+        try {
+            return execSync("git branch --show-current", {
+                encoding: "utf-8",
+                timeout: 5000,
+                stdio: ["pipe", "pipe", "pipe"],
+            }).trim();
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=openclaw-sdk.js.map

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

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

package/dist/lib/peer-agent-generator.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Peer Agent Generator
+ *
+ * Generates peer service agent references in service .claude/agents/ directory.
+ * Enables service-to-service @-mentions while maintaining security boundaries.
+ *
+ * @purpose Generate peer service agent references for cross-service collaboration
+ */
+export interface PeerAgentDefinition {
+    name: string;
+    serviceName: string;
+    serviceType: string;
+    servicePath: string;
+    capabilities: string[];
+    description: string;
+}
+export interface ServiceRegistration {
+    name: string;
+    path: string;
+    type: string;
+    registered_at: string;
+    status: string;
+}
+/**
+ * Get registered services from GTM config
+ */
+export declare function getRegisteredServices(gtmPath: string): ServiceRegistration[];
+/**
+ * Generate peer agent definition from service metadata
+ */
+export declare function generatePeerAgentDefinition(peerService: ServiceRegistration, currentServicePath: string, gtmPath: string): PeerAgentDefinition;
+/**
+ * Write peer agent definition to service's .claude/agents/ directory
+ */
+export declare function writePeerAgentDefinition(agentDef: PeerAgentDefinition, servicePath: string): string;
+/**
+ * Sync peer agents for a service - add/update/remove peer agent files
+ */
+export declare function syncPeerAgents(servicePath: string, gtmPath: string): {
+    added: number;
+    updated: number;
+    removed: number;
+};
+//# sourceMappingURL=peer-agent-generator.d.ts.map

package/dist/lib/peer-agent-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-agent-generator.d.ts","sourceRoot":"","sources":["../../src/lib/peer-agent-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAa5E;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,mBAAmB,EAChC,kBAAkB,EAAE,MAAM,EAC1B,OAAO,EAAE,MAAM,GACd,mBAAmB,CAarB;AAsDD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,mBAAmB,EAC7B,WAAW,EAAE,MAAM,GAClB,MAAM,CAyFR;AAyED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA6ErD"}

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

@@ -0,0 +1,310 @@
+/**
+ * Peer Agent Generator
+ *
+ * Generates peer service agent references in service .claude/agents/ directory.
+ * Enables service-to-service @-mentions while maintaining security boundaries.
+ *
+ * @purpose Generate peer service agent references for cross-service collaboration
+ */
+import { writeFileSync, mkdirSync, existsSync, readdirSync, unlinkSync, readFileSync } from "fs";
+import { join } from "path";
+const ACRONYMS = new Set(["api", "ui", "cli", "db", "ml", "ai", "ci", "cd", "io", "id", "url", "uri", "sdk", "rl", "mcp", "gtm", "crm", "cms", "cdn", "dns", "tcp", "udp", "ssh", "tls", "ssl", "jwt", "aws", "gcp"]);
+function titleCase(str) {
+    return str
+        .split("-")
+        .map(w => ACRONYMS.has(w.toLowerCase()) ? w.toUpperCase() : w.charAt(0).toUpperCase() + w.slice(1))
+        .join(" ");
+}
+/**
+ * Get registered services from GTM config
+ */
+export function getRegisteredServices(gtmPath) {
+    const configPath = join(gtmPath, ".jfl/config.json");
+    if (!existsSync(configPath)) {
+        return [];
+    }
+    try {
+        const config = JSON.parse(readFileSync(configPath, "utf-8"));
+        return config.registered_services || [];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Generate peer agent definition from service metadata
+ */
+export function generatePeerAgentDefinition(peerService, currentServicePath, gtmPath) {
+    const name = peerService.name;
+    const capabilities = generatePeerCapabilities(peerService.type);
+    return {
+        name,
+        serviceName: peerService.name,
+        serviceType: peerService.type,
+        servicePath: peerService.path,
+        capabilities,
+        description: `Peer service for ${peerService.name} (${peerService.type})`,
+    };
+}
+/**
+ * Generate capabilities based on service type
+ */
+function generatePeerCapabilities(serviceType) {
+    const caps = [];
+    switch (serviceType) {
+        case "web":
+        case "api":
+            caps.push("Handle API requests and serve data");
+            caps.push("Manage database operations");
+            caps.push("Process user input and validation");
+            break;
+        case "worker":
+            caps.push("Process background jobs and queues");
+            caps.push("Handle scheduled tasks");
+            caps.push("Perform async operations");
+            break;
+        case "cli":
+            caps.push("Execute command-line operations");
+            caps.push("Automate workflows");
+            caps.push("Provide interactive tools");
+            break;
+        case "library":
+            caps.push("Provide reusable functionality");
+            caps.push("Support code development and testing");
+            caps.push("Maintain documentation and examples");
+            caps.push("Build and publish artifacts");
+            break;
+        case "infrastructure":
+            caps.push("Monitor system health");
+            caps.push("Aggregate metrics and logs");
+            caps.push("Coordinate service operations");
+            break;
+        case "container":
+            caps.push("Manage containerized services");
+            caps.push("Handle Docker operations");
+            caps.push("Control service lifecycle");
+            break;
+        default:
+            caps.push("Provide service-specific functionality");
+    }
+    return caps;
+}
+/**
+ * Write peer agent definition to service's .claude/agents/ directory
+ */
+export function writePeerAgentDefinition(agentDef, servicePath) {
+    const agentsDir = join(servicePath, ".claude/agents");
+    // Ensure directory exists
+    if (!existsSync(agentsDir)) {
+        mkdirSync(agentsDir, { recursive: true });
+    }
+    const agentFile = join(agentsDir, `${agentDef.name}.md`);
+    const label = titleCase(agentDef.serviceName);
+    const whenToUse = generateWhenToUse(agentDef.serviceType, agentDef.serviceName);
+    const content = `---
+name: ${agentDef.name}
+label: ${label}
+version: 1.0.0
+color: blue
+description: ${agentDef.description}
+type: peer-service
+---
+
+# ${label}
+
+**Service Type:** ${agentDef.serviceType}
+**Service Path:** \`${agentDef.servicePath}\`
+
+## When to Collaborate
+
+${whenToUse}
+
+## Capabilities
+
+${agentDef.capabilities.map((cap) => `- ${cap}`).join("\n")}
+
+## How to Invoke
+
+Use @-mention to collaborate with this peer service:
+
+\`\`\`
+@${agentDef.name} what's your current status?
+@${agentDef.name} can you help with [specific task]?
+@${agentDef.name} what changed recently?
+\`\`\`
+
+## Security
+
+- This is a **peer service** - you can see its status but cannot modify its files
+- All operations route through Service Manager with security checks
+- You cannot call yourself as a peer (self-calls are blocked)
+- Destructive operations require explicit approval
+
+## Communication Pattern
+
+When you @-mention this peer:
+1. Service Manager validates the request
+2. Peer agent spawns in its own working directory
+3. Peer agent processes the request with its own context
+4. Result returns to you
+5. You can continue collaborating or work independently
+
+## Examples
+
+**Status check:**
+\`\`\`
+@${agentDef.name} what's your current status?
+\`\`\`
+
+**Request collaboration:**
+\`\`\`
+@${agentDef.name} I need help with [specific task]. Can you handle [specific part]?
+\`\`\`
+
+**Context sharing:**
+\`\`\`
+@${agentDef.name} what changed in your service in the last 24 hours?
+\`\`\`
+
+## Remember
+
+- **Collaborate when:** Task outside your service's core responsibility, need data from another service, coordinating multi-service operation
+- **Handle alone when:** Task within your service's domain, operation is service-local
+- **Always provide context:** When asking for help, explain what you need and why
+`;
+    writeFileSync(agentFile, content);
+    return agentFile;
+}
+/**
+ * Generate "When to Use" guidance based on service type
+ */
+function generateWhenToUse(serviceType, serviceName) {
+    switch (serviceType) {
+        case "api":
+            return `Use \`@${serviceName}\` when you need to:
+- Check API endpoint status or health
+- Understand API routes and handlers
+- Coordinate API changes that affect your service
+- Get data from API endpoints
+- Verify API schema or contracts`;
+        case "web":
+            return `Use \`@${serviceName}\` when you need to:
+- Check frontend deployment status
+- Understand UI components or flows
+- Coordinate UI changes with backend
+- Get user-facing content or copy
+- Verify frontend build status`;
+        case "worker":
+            return `Use \`@${serviceName}\` when you need to:
+- Check background job status
+- Understand job queue state
+- Coordinate async operations
+- Trigger or schedule jobs
+- Verify job processing results`;
+        case "library":
+            return `Use \`@${serviceName}\` when you need to:
+- Understand library APIs and interfaces
+- Work on plugin or package features
+- Run library tests and builds
+- Update documentation
+- Debug integration issues`;
+        case "infrastructure":
+            return `Use \`@${serviceName}\` when you need to:
+- Check system health across services
+- Get aggregated metrics or logs
+- Coordinate service deployments
+- Understand infrastructure state
+- Verify connectivity or resources`;
+        case "container":
+            return `Use \`@${serviceName}\` when you need to:
+- Check container status
+- Understand Docker configuration
+- Coordinate container operations
+- Verify container health
+- Get container logs or metrics`;
+        case "cli":
+            return `Use \`@${serviceName}\` when you need to:
+- Execute CLI commands
+- Automate workflows
+- Run scripts or tools
+- Get CLI output or results
+- Verify CLI functionality`;
+        default:
+            return `Use \`@${serviceName}\` when you need to:
+- Check service status
+- Understand service capabilities
+- Coordinate with this service
+- Get service-specific data
+- Verify service operations`;
+    }
+}
+/**
+ * Sync peer agents for a service - add/update/remove peer agent files
+ */
+export function syncPeerAgents(servicePath, gtmPath) {
+    const stats = { added: 0, updated: 0, removed: 0 };
+    // Get service name from its config
+    const serviceConfigPath = join(servicePath, ".jfl/config.json");
+    if (!existsSync(serviceConfigPath)) {
+        throw new Error(`Service config not found: ${serviceConfigPath}`);
+    }
+    const serviceConfig = JSON.parse(readFileSync(serviceConfigPath, "utf-8"));
+    const currentServiceName = serviceConfig.name;
+    // Get registered services from GTM
+    const registeredServices = getRegisteredServices(gtmPath);
+    // Filter out current service (can't be peer with self)
+    const peerServices = registeredServices.filter((s) => s.name !== currentServiceName);
+    // Ensure .claude/agents directory exists
+    const agentsDir = join(servicePath, ".claude/agents");
+    if (!existsSync(agentsDir)) {
+        mkdirSync(agentsDir, { recursive: true });
+    }
+    // Get existing peer agent files (check both old and new naming conventions)
+    const existingPeerFiles = existsSync(agentsDir)
+        ? readdirSync(agentsDir).filter((f) => f.endsWith(".md") && !f.startsWith("_") && f !== "README.md")
+        : [];
+    // Read frontmatter to identify peer agent files (works with old and new naming)
+    const peerFileSet = new Set();
+    for (const f of existingPeerFiles) {
+        try {
+            const content = readFileSync(join(agentsDir, f), "utf-8");
+            if (content.includes("type: peer-service") || f.startsWith("peer-service-")) {
+                peerFileSet.add(f);
+            }
+        }
+        catch { }
+    }
+    // Generate/update peer agent files for all registered services
+    const currentPeerFiles = new Set();
+    for (const peerService of peerServices) {
+        const agentDef = generatePeerAgentDefinition(peerService, servicePath, gtmPath);
+        const fileName = `${agentDef.name}.md`;
+        currentPeerFiles.add(fileName);
+        // Remove old-style file if it exists (migration)
+        const oldFileName = `peer-service-${agentDef.name}.md`;
+        const oldFilePath = join(agentsDir, oldFileName);
+        if (existsSync(oldFilePath)) {
+            unlinkSync(oldFilePath);
+            peerFileSet.delete(oldFileName);
+        }
+        const filePath = join(agentsDir, fileName);
+        if (existsSync(filePath)) {
+            writePeerAgentDefinition(agentDef, servicePath);
+            stats.updated++;
+        }
+        else {
+            writePeerAgentDefinition(agentDef, servicePath);
+            stats.added++;
+        }
+    }
+    // Remove stale peer agent files (services that were unregistered)
+    for (const existingFile of peerFileSet) {
+        const nameWithoutExt = existingFile.replace(/\.md$/, "").replace(/^peer-service-/, "");
+        if (!currentPeerFiles.has(existingFile) && !currentPeerFiles.has(`${nameWithoutExt}.md`)) {
+            unlinkSync(join(agentsDir, existingFile));
+            stats.removed++;
+        }
+    }
+    return stats;
+}
+//# sourceMappingURL=peer-agent-generator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"peer-agent-generator.js","sourceRoot":"","sources":["../../src/lib/peer-agent-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAA;AAChG,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAE3B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAA;AAErN,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,GAAG;SACP,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAClG,IAAI,CAAC,GAAG,CAAC,CAAA;AACd,CAAC;AAmBD;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAA;IAEpD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAA;IACX,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAA;QAC5D,OAAO,MAAM,CAAC,mBAAmB,IAAI,EAAE,CAAA;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,WAAgC,EAChC,kBAA0B,EAC1B,OAAe;IAEf,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAA;IAE7B,MAAM,YAAY,GAAG,wBAAwB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;IAE/D,OAAO;QACL,IAAI;QACJ,WAAW,EAAE,WAAW,CAAC,IAAI;QAC7B,WAAW,EAAE,WAAW,CAAC,IAAI;QAC7B,WAAW,EAAE,WAAW,CAAC,IAAI;QAC7B,YAAY;QACZ,WAAW,EAAE,oBAAoB,WAAW,CAAC,IAAI,KAAK,WAAW,CAAC,IAAI,GAAG;KAC1E,CAAA;AACH,CAAC;AAED;;GAEG;AACH,SAAS,wBAAwB,CAAC,WAAmB;IACnD,MAAM,IAAI,GAAa,EAAE,CAAA;IAEzB,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,KAAK,CAAC;QACX,KAAK,KAAK;YACR,IAAI,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAA;YAC/C,IAAI,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAA;YACvC,IAAI,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAA;YAC9C,MAAK;QAEP,KAAK,QAAQ;YACX,IAAI,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAA;YAC/C,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAA;YACnC,IAAI,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;YACrC,MAAK;QAEP,KAAK,KAAK;YACR,IAAI,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAA;YAC5C,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;YAC/B,IAAI,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAA;YACtC,MAAK;QAEP,KAAK,SAAS;YACZ,IAAI,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;YAC3C,IAAI,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAA;YACjD,IAAI,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAA;YAChD,IAAI,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAA;YACxC,MAAK;QAEP,KAAK,gBAAgB;YACnB,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;YAClC,IAAI,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAA;YACvC,IAAI,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAA;YAC1C,MAAK;QAEP,KAAK,WAAW;YACd,IAAI,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAA;YAC1C,IAAI,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;YACrC,IAAI,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAA;YACtC,MAAK;QAEP;YACE,IAAI,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAA;IACvD,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAA6B,EAC7B,WAAmB;IAEnB,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAA;IAErD,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,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;IAE7C,MAAM,SAAS,GAAG,iBAAiB,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAA;IAE/E,MAAM,OAAO,GAAG;QACV,QAAQ,CAAC,IAAI;SACZ,KAAK;;;eAGC,QAAQ,CAAC,WAAW;;;;IAI/B,KAAK;;oBAEW,QAAQ,CAAC,WAAW;sBAClB,QAAQ,CAAC,WAAW;;;;EAIxC,SAAS;;;;EAIT,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;GAOxD,QAAQ,CAAC,IAAI;GACb,QAAQ,CAAC,IAAI;GACb,QAAQ,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;GAuBb,QAAQ,CAAC,IAAI;;;;;GAKb,QAAQ,CAAC,IAAI;;;;;GAKb,QAAQ,CAAC,IAAI;;;;;;;;CAQf,CAAA;IAEC,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IAEjC,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,WAAmB,EAAE,WAAmB;IACjE,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,KAAK;YACR,OAAO,UAAU,WAAW;;;;;iCAKD,CAAA;QAE7B,KAAK,KAAK;YACR,OAAO,UAAU,WAAW;;;;;+BAKH,CAAA;QAE3B,KAAK,QAAQ;YACX,OAAO,UAAU,WAAW;;;;;gCAKF,CAAA;QAE5B,KAAK,SAAS;YACZ,OAAO,UAAU,WAAW;;;;;2BAKP,CAAA;QAEvB,KAAK,gBAAgB;YACnB,OAAO,UAAU,WAAW;;;;;mCAKC,CAAA;QAE/B,KAAK,WAAW;YACd,OAAO,UAAU,WAAW;;;;;gCAKF,CAAA;QAE5B,KAAK,KAAK;YACR,OAAO,UAAU,WAAW;;;;;2BAKP,CAAA;QAEvB;YACE,OAAO,UAAU,WAAW;;;;;4BAKN,CAAA;IAC1B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,WAAmB,EACnB,OAAe;IAEf,MAAM,KAAK,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAA;IAElD,mCAAmC;IACnC,MAAM,iBAAiB,GAAG,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAA;IAC/D,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,6BAA6B,iBAAiB,EAAE,CAAC,CAAA;IACnE,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,CAAA;IAC1E,MAAM,kBAAkB,GAAG,aAAa,CAAC,IAAI,CAAA;IAE7C,mCAAmC;IACnC,MAAM,kBAAkB,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAA;IAEzD,uDAAuD;IACvD,MAAM,YAAY,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,kBAAkB,CAAC,CAAA;IAEpF,yCAAyC;IACzC,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAA;IACrD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC3C,CAAC;IAED,4EAA4E;IAC5E,MAAM,iBAAiB,GAAG,UAAU,CAAC,SAAS,CAAC;QAC7C,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,WAAW,CAAC;QACpG,CAAC,CAAC,EAAE,CAAA;IAEN,gFAAgF;IAChF,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAA;IACrC,KAAK,MAAM,CAAC,IAAI,iBAAiB,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;YACzD,IAAI,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;gBAC5E,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;YACpB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IAED,+DAA+D;IAC/D,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAA;IAE1C,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,MAAM,QAAQ,GAAG,2BAA2B,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,CAAA;QAC/E,MAAM,QAAQ,GAAG,GAAG,QAAQ,CAAC,IAAI,KAAK,CAAA;QACtC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAE9B,iDAAiD;QACjD,MAAM,WAAW,GAAG,gBAAgB,QAAQ,CAAC,IAAI,KAAK,CAAA;QACtD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAA;QAChD,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,UAAU,CAAC,WAAW,CAAC,CAAA;YACvB,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;QACjC,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QAE1C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,wBAAwB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;YAC/C,KAAK,CAAC,OAAO,EAAE,CAAA;QACjB,CAAC;aAAM,CAAC;YACN,wBAAwB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;YAC/C,KAAK,CAAC,KAAK,EAAE,CAAA;QACf,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,KAAK,MAAM,YAAY,IAAI,WAAW,EAAE,CAAC;QACvC,MAAM,cAAc,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAA;QACtF,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,cAAc,KAAK,CAAC,EAAE,CAAC;YACzF,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAA;YACzC,KAAK,CAAC,OAAO,EAAE,CAAA;QACjB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/lib/peter-parker-bridge.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Peter Parker Event Bridge
+ *
+ * Connects ralph-tui's WebSocket (port 7890 via --listen) to the MAP event bus.
+ * Maps ralph events into MAP's unified event stream via Context Hub HTTP API.
+ * Now integrated with World Model for state capture and invariant checking.
+ *
+ * @purpose Bridge ralph-tui WebSocket events to MAP event bus via Context Hub with world model integration
+ */
+import { WorldModelStore } from "./world-model-store.js";
+interface BridgeOptions {
+    ralphPort?: number;
+    contextHubUrl: string;
+    authToken: string;
+    projectRoot?: string;
+    enableWorldModel?: boolean;
+    onEvent?: (event: {
+        type: string;
+        data: Record<string, unknown>;
+    }) => void;
+    onInvariantViolation?: (summary: string) => void;
+}
+export declare class PeterParkerBridge {
+    private ws;
+    private reconnectTimer;
+    private reconnectDelay;
+    private maxReconnectDelay;
+    private stopped;
+    private options;
+    private worldModelStore;
+    private lastTaskState;
+    private currentAgent;
+    constructor(options: BridgeOptions);
+    start(): void;
+    stop(): void;
+    private connect;
+    private scheduleReconnect;
+    private trackAgentCost;
+    private publishToContextHub;
+    /**
+     * Handle world model events: capture state, record transitions, check invariants
+     */
+    private handleWorldModelEvent;
+    /**
+     * Engine started - capture initial state and check invariants
+     */
+    private onEngineStarted;
+    /**
+     * Task selected - capture state before action
+     */
+    private onTaskSelected;
+    /**
+     * Task completed - record transition and check invariants
+     */
+    private onTaskCompleted;
+    /**
+     * All tasks complete - final snapshot
+     */
+    private onAllComplete;
+    /**
+     * Task failed - record failure transition
+     */
+    private onTaskFailed;
+    /**
+     * Get world model statistics
+     */
+    getWorldModelStats(): ReturnType<WorldModelStore["getStats"]> | null;
+}
+export {};
+//# sourceMappingURL=peter-parker-bridge.d.ts.map

package/dist/lib/peter-parker-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peter-parker-bridge.d.ts","sourceRoot":"","sources":["../../src/lib/peter-parker-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAYxD,UAAU,aAAa;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,KAAK,IAAI,CAAA;IAC1E,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACjD;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,cAAc,CAAO;IAC7B,OAAO,CAAC,iBAAiB,CAAQ;IACjC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAe;IAG9B,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,YAAY,CAAsB;gBAE9B,OAAO,EAAE,aAAa;IASlC,KAAK,IAAI,IAAI;IAKb,IAAI,IAAI,IAAI;IAcZ,OAAO,CAAC,OAAO;IAwDf,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,cAAc;YA6BR,mBAAmB;IA0BjC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA0B7B;;OAEG;IACH,OAAO,CAAC,eAAe;IAyBvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAoBtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAsDvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAsBrB;;OAEG;IACH,OAAO,CAAC,YAAY;IA2CpB;;OAEG;IACH,kBAAkB,IAAI,UAAU,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI;CAGrE"}