@jclaw/core 0.1.0

package/dist/network/protocol.d.ts

@@ -0,0 +1,159 @@
+/**
+ * A2A/GEP Protocol
+ *
+ * Protocol definitions for agent-to-agent communication.
+ *
+ * @module @jclaw/core/network/protocol
+ */
+/**
+ * A2A Message types
+ */
+export type A2AMessageType = 'greeting' | 'gene_share' | 'gene_request' | 'gene_response' | 'task_delegate' | 'task_result' | 'heartbeat' | 'goodbye';
+/**
+ * A2A Protocol message
+ */
+export interface A2AMessage {
+    /** Protocol version */
+    version: string;
+    /** Message type */
+    type: A2AMessageType;
+    /** Sender agent ID */
+    from: string;
+    /** Recipient agent ID (or 'broadcast') */
+    to: string;
+    /** Message payload */
+    payload: unknown;
+    /** Message timestamp */
+    timestamp: number;
+    /** Message ID for tracking */
+    messageId: string;
+}
+/**
+ * GEP (Gene Exchange Protocol) packet
+ */
+export interface GEPPacket {
+    /** Protocol version */
+    version: string;
+    /** Gene ID */
+    geneId: string;
+    /** Gene type */
+    geneType: 'behavior' | 'knowledge' | 'skill';
+    /** Gene data (compressed/encoded) */
+    data: string;
+    /** Gene metadata */
+    metadata: {
+        fitness: number;
+        generation: number;
+        parents: string[];
+        checksum: string;
+    };
+    /** Timestamp */
+    timestamp: number;
+}
+/**
+ * Node registration info
+ */
+export interface NodeInfo {
+    /** Node ID */
+    id: string;
+    /** Node name */
+    name: string;
+    /** Node version */
+    version: string;
+    /** Node capabilities */
+    capabilities: string[];
+    /** Endpoint URL */
+    endpoint: string;
+    /** Last heartbeat */
+    lastSeen: number;
+}
+/**
+ * Gene share payload
+ */
+export interface GeneSharePayload {
+    /** Genes to share */
+    genes: GEPPacket[];
+    /** Request acknowledgment */
+    requireAck: boolean;
+}
+/**
+ * Gene request payload
+ */
+export interface GeneRequestPayload {
+    /** Gene types to request */
+    types?: ('behavior' | 'knowledge' | 'skill')[];
+    /** Minimum fitness threshold */
+    minFitness?: number;
+    /** Maximum genes to return */
+    limit?: number;
+    /** Specific gene IDs to request */
+    geneIds?: string[];
+}
+/**
+ * Task delegation payload
+ */
+export interface TaskDelegatePayload {
+    /** Task ID */
+    taskId: string;
+    /** Task description */
+    description: string;
+    /** Required capabilities */
+    requiredCapabilities: string[];
+    /** Task deadline */
+    deadline?: number;
+    /** Priority (1-10) */
+    priority?: number;
+}
+/**
+ * A2A Protocol helper functions
+ */
+export declare class A2AProtocol {
+    private static VERSION;
+    /**
+     * Create a new A2A message.
+     */
+    static createMessage(type: A2AMessageType, from: string, to: string, payload: unknown): A2AMessage;
+    /**
+     * Create a greeting message.
+     */
+    static createGreeting(from: string, to: string, nodeInfo: NodeInfo): A2AMessage;
+    /**
+     * Create a gene share message.
+     */
+    static createGeneShare(from: string, to: string, genes: GEPPacket[], requireAck?: boolean): A2AMessage;
+    /**
+     * Create a gene request message.
+     */
+    static createGeneRequest(from: string, to: string, request: GeneRequestPayload): A2AMessage;
+    /**
+     * Create a task delegation message.
+     */
+    static createTaskDelegate(from: string, to: string, task: TaskDelegatePayload): A2AMessage;
+    /**
+     * Create a heartbeat message.
+     */
+    static createHeartbeat(from: string, to: string): A2AMessage;
+    /**
+     * Validate an A2A message.
+     */
+    static validate(message: A2AMessage): boolean;
+}
+/**
+ * GEP Protocol helper functions
+ */
+export declare class GEPProtocol {
+    private static VERSION;
+    /**
+     * Create a GEP packet from gene data.
+     */
+    static createPacket(geneId: string, geneType: 'behavior' | 'knowledge' | 'skill', data: string, metadata: Omit<GEPPacket['metadata'], 'checksum'>): GEPPacket;
+    /**
+     * Validate a GEP packet.
+     */
+    static validate(packet: GEPPacket): boolean;
+    /**
+     * Calculate checksum for data integrity.
+     */
+    private static calculateChecksum;
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/network/protocol.d.ts.map

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

package/dist/network/protocol.js

@@ -0,0 +1,118 @@
+/**
+ * A2A/GEP Protocol
+ *
+ * Protocol definitions for agent-to-agent communication.
+ *
+ * @module @jclaw/core/network/protocol
+ */
+/**
+ * A2A Protocol helper functions
+ */
+export class A2AProtocol {
+    static VERSION = '1.0.0';
+    /**
+     * Create a new A2A message.
+     */
+    static createMessage(type, from, to, payload) {
+        return {
+            version: A2AProtocol.VERSION,
+            type,
+            from,
+            to,
+            payload,
+            timestamp: Date.now(),
+            messageId: `msg-${Date.now()}-${Math.random().toString(36).slice(2)}`,
+        };
+    }
+    /**
+     * Create a greeting message.
+     */
+    static createGreeting(from, to, nodeInfo) {
+        return A2AProtocol.createMessage('greeting', from, to, nodeInfo);
+    }
+    /**
+     * Create a gene share message.
+     */
+    static createGeneShare(from, to, genes, requireAck = false) {
+        const payload = { genes, requireAck };
+        return A2AProtocol.createMessage('gene_share', from, to, payload);
+    }
+    /**
+     * Create a gene request message.
+     */
+    static createGeneRequest(from, to, request) {
+        return A2AProtocol.createMessage('gene_request', from, to, request);
+    }
+    /**
+     * Create a task delegation message.
+     */
+    static createTaskDelegate(from, to, task) {
+        return A2AProtocol.createMessage('task_delegate', from, to, task);
+    }
+    /**
+     * Create a heartbeat message.
+     */
+    static createHeartbeat(from, to) {
+        return A2AProtocol.createMessage('heartbeat', from, to, { timestamp: Date.now() });
+    }
+    /**
+     * Validate an A2A message.
+     */
+    static validate(message) {
+        if (!message.version || !message.type || !message.from || !message.to) {
+            return false;
+        }
+        if (!message.timestamp || !message.messageId) {
+            return false;
+        }
+        return true;
+    }
+}
+/**
+ * GEP Protocol helper functions
+ */
+export class GEPProtocol {
+    static VERSION = '1.0.0';
+    /**
+     * Create a GEP packet from gene data.
+     */
+    static createPacket(geneId, geneType, data, metadata) {
+        const checksum = GEPProtocol.calculateChecksum(data);
+        return {
+            version: GEPProtocol.VERSION,
+            geneId,
+            geneType,
+            data,
+            metadata: { ...metadata, checksum },
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Validate a GEP packet.
+     */
+    static validate(packet) {
+        if (!packet.version || !packet.geneId || !packet.geneType || !packet.data) {
+            return false;
+        }
+        if (!packet.metadata || !packet.timestamp) {
+            return false;
+        }
+        // Verify checksum
+        const expectedChecksum = GEPProtocol.calculateChecksum(packet.data);
+        return packet.metadata.checksum === expectedChecksum;
+    }
+    /**
+     * Calculate checksum for data integrity.
+     */
+    static calculateChecksum(data) {
+        // Simple hash function for checksum
+        let hash = 0;
+        for (let i = 0; i < data.length; i++) {
+            const char = data.charCodeAt(i);
+            hash = (hash << 5) - hash + char;
+            hash = hash & hash; // Convert to 32-bit integer
+        }
+        return Math.abs(hash).toString(16);
+    }
+}
+//# sourceMappingURL=protocol.js.map

package/dist/network/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/network/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoHH;;GAEG;AACH,MAAM,OAAO,WAAW;IACd,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;IAEjC;;OAEG;IACH,MAAM,CAAC,aAAa,CAClB,IAAoB,EACpB,IAAY,EACZ,EAAU,EACV,OAAgB;QAEhB,OAAO;YACL,OAAO,EAAE,WAAW,CAAC,OAAO;YAC5B,IAAI;YACJ,IAAI;YACJ,EAAE;YACF,OAAO;YACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,SAAS,EAAE,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;SACtE,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,IAAY,EAAE,EAAU,EAAE,QAAkB;QAChE,OAAO,WAAW,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CACpB,IAAY,EACZ,EAAU,EACV,KAAkB,EAClB,UAAU,GAAG,KAAK;QAElB,MAAM,OAAO,GAAqB,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;QACxD,OAAO,WAAW,CAAC,aAAa,CAAC,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB,CACtB,IAAY,EACZ,EAAU,EACV,OAA2B;QAE3B,OAAO,WAAW,CAAC,aAAa,CAAC,cAAc,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB,CACvB,IAAY,EACZ,EAAU,EACV,IAAyB;QAEzB,OAAO,WAAW,CAAC,aAAa,CAAC,eAAe,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,IAAY,EAAE,EAAU;QAC7C,OAAO,WAAW,CAAC,aAAa,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACrF,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAmB;QACjC,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;YACtE,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YAC7C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;;AAGH;;GAEG;AACH,MAAM,OAAO,WAAW;IACd,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;IAEjC;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,MAAc,EACd,QAA4C,EAC5C,IAAY,EACZ,QAAiD;QAEjD,MAAM,QAAQ,GAAG,WAAW,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACrD,OAAO;YACL,OAAO,EAAE,WAAW,CAAC,OAAO;YAC5B,MAAM;YACN,QAAQ;YACR,IAAI;YACJ,QAAQ,EAAE,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE;YACnC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAiB;QAC/B,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC1E,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAC1C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,kBAAkB;QAClB,MAAM,gBAAgB,GAAG,WAAW,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACpE,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,KAAK,gBAAgB,CAAC;IACvD,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,iBAAiB,CAAC,IAAY;QAC3C,oCAAoC;QACpC,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAChC,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;YACjC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,4BAA4B;QAClD,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC"}

package/dist/runtime/agent.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Agent Runtime
+ *
+ * Core implementation of the JClaw agent runtime.
+ * Provides task execution, context management, and lifecycle control.
+ * Now with AutoSkill support for self-evolving capabilities!
+ *
+ * @module @jclaw/core/runtime/agent
+ */
+import type { AgentRuntime, Task, TaskResult, ContextManager } from '../types.js';
+import { type LLMClientConfig } from './llm-client.js';
+import { ExtensionRegistry } from '../extension-system/registry.js';
+import type { AutoSkillConfig, GeneratedExtension } from '../auto-skill/types.js';
+import type { SkillShAdapterConfig } from '../skill-sh/types.js';
+/**
+ * Configuration for the agent runtime
+ */
+export interface AgentConfig {
+    /** Agent name */
+    name?: string;
+    /** Agent version */
+    version?: string;
+    /** Execution mode (default: 'local') */
+    executionMode?: 'local' | 'docker' | 'hybrid';
+    /** LLM client configuration */
+    llm?: LLMClientConfig;
+    /** Context manager instance */
+    contextManager?: ContextManager;
+    /** System prompt for the agent */
+    systemPrompt?: string;
+    /** Enable verbose logging */
+    verbose?: boolean;
+    /** Enable automatic skill generation */
+    enableAutoSkill?: boolean;
+    /** AutoSkill configuration */
+    autoSkillConfig?: Partial<AutoSkillConfig>;
+    /** Skill.sh configuration */
+    skillShConfig?: Partial<SkillShAdapterConfig>;
+    /** Extension registry for managing capabilities */
+    extensionRegistry?: ExtensionRegistry;
+}
+/**
+ * JClaw Agent Runtime
+ *
+ * The main runtime for executing tasks with the JClaw agent.
+ * Implements the AgentRuntime interface and provides:
+ * - Task execution with LLM integration
+ * - Context management through SimpleMemory
+ * - Command execution through local/docker executors
+ * - **NEW: AutoSkill for self-generating capabilities!**
+ *
+ * @example
+ * ```typescript
+ * const agent = new JClawAgent({
+ *   name: 'my-agent',
+ *   enableAutoSkill: true,  // Enable self-evolution!
+ *   llm: {
+ *     apiBase: 'https://api.openai.com/v1',
+ *     apiKey: process.env.OPENAI_API_KEY!,
+ *     model: 'gpt-4'
+ *   }
+ * });
+ *
+ * await agent.start();
+ * const result = await agent.execute({
+ *   id: 'task-1',
+ *   prompt: 'Analyze the project structure'
+ * });
+ * await agent.stop();
+ * ```
+ */
+export declare class JClawAgent implements AgentRuntime {
+    readonly executionMode: 'local' | 'docker' | 'hybrid';
+    private readonly config;
+    private llmClient?;
+    private taskExecutor?;
+    private running;
+    private autoSkillGenerator?;
+    private autoSkillInstaller?;
+    private _skillShAdapter?;
+    private _skillConverter?;
+    private _skillDiscovery?;
+    private _skillRegistry?;
+    private evolutionEngine?;
+    /**
+     * Create a new JClaw agent instance.
+     *
+     * @param config - Configuration options
+     */
+    constructor(config?: AgentConfig);
+    /**
+     * Get the context manager instance.
+     */
+    get context(): ContextManager;
+    /**
+     * Start the agent runtime.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the agent runtime.
+     */
+    stop(): Promise<void>;
+    /**
+     * Execute a task.
+     *
+     * @param task - The task to execute
+     * @returns Task execution result
+     */
+    execute(task: Task): Promise<TaskResult>;
+    /**
+     * Execute a task with AutoSkill self-evolution support.
+     *
+     * This method attempts to execute the task, and if it fails due to missing
+     * capabilities, it will automatically discover, generate, and install new skills.
+     */
+    private executeWithAutoSkill;
+    generateSkillsForTask(task: Task): Promise<GeneratedExtension[]>;
+    isRunning(): boolean;
+    get name(): string;
+    get version(): string;
+    private getDefaultSystemPrompt;
+}
+export declare function createAgent(config?: AgentConfig): JClawAgent;
+//# sourceMappingURL=agent.d.ts.map

package/dist/runtime/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/runtime/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElF,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAQpE,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAOlF,OAAO,KAAK,EAAE,oBAAoB,EAAwB,MAAM,sBAAsB,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,aAAa,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC9C,+BAA+B;IAC/B,GAAG,CAAC,EAAE,eAAe,CAAC;IACtB,+BAA+B;IAC/B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wCAAwC;IACxC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,8BAA8B;IAC9B,eAAe,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAC3C,6BAA6B;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC9C,mDAAmD;IACnD,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,UAAW,YAAW,YAAY;IAC7C,QAAQ,CAAC,aAAa,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAEtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAKrB;IAEF,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,YAAY,CAAC,CAAe;IACpC,OAAO,CAAC,OAAO,CAAS;IAGxB,OAAO,CAAC,kBAAkB,CAAC,CAAqB;IAChD,OAAO,CAAC,kBAAkB,CAAC,CAAqB;IAEhD,OAAO,CAAC,eAAe,CAAC,CAAiB;IACzC,OAAO,CAAC,eAAe,CAAC,CAAiB;IACzC,OAAO,CAAC,eAAe,CAAC,CAAuB;IAC/C,OAAO,CAAC,cAAc,CAAC,CAAgB;IACvC,OAAO,CAAC,eAAe,CAAC,CAAkB;IAE1C;;;;OAIG;gBACS,MAAM,GAAE,WAAgB;IAepC;;OAEG;IACH,IAAI,OAAO,IAAI,cAAc,CAK5B;IAED;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyD5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B;;;;;OAKG;IACG,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;IAiC9C;;;;;OAKG;YACW,oBAAoB;IAmE5B,qBAAqB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAwBtE,SAAS,IAAI,OAAO;IAIpB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,OAAO,CAAC,sBAAsB;CAoB/B;AAED,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,UAAU,CAE5D"}