@praveencs/agent 0.9.29 → 0.10.0

package/dist/src/swarm/types.d.ts

@@ -0,0 +1,58 @@
+export type AgentRole = 'planner' | 'coder' | 'reviewer' | 'researcher' | 'tester' | 'custom';
+export interface SwarmConfig {
+    /** Enable swarm mode */
+    enabled: boolean;
+    /** Max concurrent agents */
+    maxAgents: number;
+    /** Default model for swarm agents */
+    model: string;
+    /** Whether agents can spawn sub-agents */
+    allowDelegation: boolean;
+    /** Max depth of delegation chain */
+    maxDelegationDepth: number;
+    /** Timeout for each agent task (ms) */
+    agentTimeout: number;
+}
+export declare const DEFAULT_SWARM_CONFIG: SwarmConfig;
+export interface SwarmMessage {
+    id: string;
+    from: string;
+    to: string;
+    type: SwarmMessageType;
+    payload: unknown;
+    timestamp: Date;
+}
+export type SwarmMessageType = 'task_assign' | 'task_result' | 'task_error' | 'delegate' | 'status_update' | 'artifact' | 'review_request' | 'review_response' | 'broadcast';
+export interface AgentTask {
+    id: string;
+    description: string;
+    role: AgentRole;
+    assignedTo?: string;
+    status: 'pending' | 'running' | 'completed' | 'failed';
+    result?: string;
+    error?: string;
+    createdAt: Date;
+    completedAt?: Date;
+    parentTaskId?: string;
+    subtasks?: string[];
+}
+export interface SwarmAgent {
+    id: string;
+    role: AgentRole;
+    name: string;
+    status: 'idle' | 'busy' | 'done' | 'error';
+    currentTask?: string;
+    model: string;
+    depth: number;
+    completedTasks: number;
+}
+export interface SwarmState {
+    id: string;
+    status: 'idle' | 'running' | 'completed' | 'failed';
+    agents: SwarmAgent[];
+    tasks: AgentTask[];
+    startedAt?: Date;
+    completedAt?: Date;
+    goalDescription?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/swarm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/swarm/types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,YAAY,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE9F,MAAM,WAAW,WAAW;IACxB,wBAAwB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,eAAe,EAAE,OAAO,CAAC;IACzB,oCAAoC;IACpC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,oBAAoB,EAAE,WAOlC,CAAC;AAEF,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;CACnB;AAED,MAAM,MAAM,gBAAgB,GACtB,aAAa,GACb,aAAa,GACb,YAAY,GACZ,UAAU,GACV,eAAe,GACf,UAAU,GACV,gBAAgB,GAChB,iBAAiB,GACjB,WAAW,CAAC;AAElB,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACpD,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B"}

package/dist/src/swarm/types.js

@@ -0,0 +1,10 @@
+// ─── Swarm Types ───
+export const DEFAULT_SWARM_CONFIG = {
+    enabled: false,
+    maxAgents: 5,
+    model: 'gpt-4o',
+    allowDelegation: true,
+    maxDelegationDepth: 3,
+    agentTimeout: 120000,
+};
+//# sourceMappingURL=types.js.map

package/dist/src/swarm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/swarm/types.ts"],"names":[],"mappings":"AAAA,sBAAsB;AAmBtB,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC7C,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,CAAC;IACZ,KAAK,EAAE,QAAQ;IACf,eAAe,EAAE,IAAI;IACrB,kBAAkB,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM;CACvB,CAAC"}

package/dist/src/tools/core/cmd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cmd.d.ts","sourceRoot":"","sources":["../../../../src/tools/core/cmd.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKlD,eAAO,MAAM,MAAM,EAAE,cAAc,CAC/B;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,EAClG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CA+CvD,CAAC;AAEF,eAAO,MAAM,QAAQ;aAlDN,MAAM;WAAS,MAAM,EAAE;UAAQ,MAAM;cAAY,MAAM;UAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;YACtF,MAAM;YAAU,MAAM;cAAY,MAAM;IAiDtB,CAAC"}
+{"version":3,"file":"cmd.d.ts","sourceRoot":"","sources":["../../../../src/tools/core/cmd.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAMlD,eAAO,MAAM,MAAM,EAAE,cAAc,CAC/B;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,EAClG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CA2EvD,CAAC;AAEF,eAAO,MAAM,QAAQ;aA9EN,MAAM;WAAS,MAAM,EAAE;UAAQ,MAAM;cAAY,MAAM;UAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;YACtF,MAAM;YAAU,MAAM;cAAY,MAAM;IA6EtB,CAAC"}

package/dist/src/tools/core/cmd.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
+import { getSandboxEngine } from '../../sandbox/engine.js';
 const execFileAsync = promisify(execFile);
 // ─── cmd.run ───
 export const cmdRun = {
@@ -22,6 +23,33 @@ export const cmdRun = {
     permissions: ['exec'],
     async execute(input, ctx) {
         const workDir = input.cwd ?? ctx.cwd;
+        // ─── Sandbox Mode ───
+        // If a sandbox engine is active, route the command through the Docker container
+        const sandbox = getSandboxEngine();
+        if (sandbox && sandbox.isActive) {
+            try {
+                const result = await sandbox.exec(input.command, input.args ?? [], {
+                    cwd: workDir,
+                    timeout: input.timeout,
+                    env: input.env,
+                });
+                return {
+                    success: result.exitCode === 0,
+                    data: result,
+                    durationMs: 0,
+                };
+            }
+            catch (err) {
+                const error = err;
+                return {
+                    success: false,
+                    data: { stdout: '', stderr: error.message ?? 'Sandbox execution failed', exitCode: 1 },
+                    error: error.message ?? 'Sandbox execution failed',
+                    durationMs: 0,
+                };
+            }
+        }
+        // ─── Direct Host Execution ───
         try {
             const { stdout, stderr } = await execFileAsync(input.command, input.args ?? [], {
                 cwd: workDir,

package/dist/src/tools/core/cmd.js.map

@@ -1 +1 @@
-{"version":3,"file":"cmd.js","sourceRoot":"","sources":["../../../../src/tools/core/cmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,kBAAkB;AAClB,MAAM,CAAC,MAAM,MAAM,GAGf;IACA,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE,yBAAyB;IACtC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;QACtD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QAChD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;QAC7C,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;KACnD,CAAC;IACF,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;KACvB,CAAC;IACF,WAAW,EAAE,CAAC,MAAM,CAAC;IACrB,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACpB,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC;QACrC,IAAI,CAAC;YACD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE;gBAC5E,GAAG,EAAE,OAAO;gBACZ,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO;gBACpC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,EAAE;gBACrC,KAAK,EAAE,IAAI;aACd,CAAC,CAAC;YACH,OAAO;gBACH,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE;gBAC3E,UAAU,EAAE,CAAC;aAChB,CAAC;QACN,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,KAAK,GAAG,GAA4E,CAAC;YAC3F,OAAO;gBACH,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE;oBACF,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;oBACtC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;oBACtC,QAAQ,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC;iBAC5B;gBACD,KAAK,EAAE,KAAK,CAAC,OAAO,IAAI,0BAA0B;gBAClD,UAAU,EAAE,CAAC;aAChB,CAAC;QACN,CAAC;IACL,CAAC;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"cmd.js","sourceRoot":"","sources":["../../../../src/tools/core/cmd.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/paths.d.ts

@@ -9,19 +9,19 @@ export declare function getAgentDir(cwd?: string): string;
 /**
  * Get the skills directory
  */
-export declare function getSkillsDir(): string;
+export declare function getSkillsDir(cwd?: string): string;
 /**
  * Get the plans directory
  */
-export declare function getPlansDir(): string;
+export declare function getPlansDir(cwd?: string): string;
 /**
  * Get the runs directory
  */
-export declare function getRunsDir(): string;
+export declare function getRunsDir(cwd?: string): string;
 /**
  * Get the plugins directory
  */
-export declare function getPluginsDir(): string;
+export declare function getPluginsDir(cwd?: string): string;
 /**
  * Get the logs directory
  */

package/dist/src/utils/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/utils/paths.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAEhE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAItC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/utils/paths.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAEhE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAItC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/src/utils/paths.js

@@ -15,26 +15,26 @@ export function getAgentDir(cwd = process.cwd()) {
 /**
  * Get the skills directory
  */
-export function getSkillsDir() {
-    return path.join(getAgentDir(), 'skills');
+export function getSkillsDir(cwd) {
+    return path.join(getAgentDir(cwd), 'skills');
 }
 /**
  * Get the plans directory
  */
-export function getPlansDir() {
-    return path.join(getAgentDir(), 'plans');
+export function getPlansDir(cwd) {
+    return path.join(getAgentDir(cwd), 'plans');
 }
 /**
  * Get the runs directory
  */
-export function getRunsDir() {
-    return path.join(getAgentDir(), 'runs');
+export function getRunsDir(cwd) {
+    return path.join(getAgentDir(cwd), 'runs');
 }
 /**
  * Get the plugins directory
  */
-export function getPluginsDir() {
-    return path.join(getAgentDir(), 'plugins');
+export function getPluginsDir(cwd) {
+    return path.join(getAgentDir(cwd), 'plugins');
 }
 /**
  * Get the logs directory

package/dist/src/utils/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAG,QAAkB;IACpD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,QAAQ,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IACnD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IACxB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACvB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACtB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IACzB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACtB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,gBAAgB,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IACzB,OAAO,kBAAkB,CAAC,mBAAmB,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IACzB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxD,OAAO,OAAO,SAAS,IAAI,IAAI,EAAE,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;AAC5D,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAG,QAAkB;IACpD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,QAAQ,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IACnD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY;IACrC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAY;IACpC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,GAAY;IACnC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACtC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACtB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,gBAAgB,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IACzB,OAAO,kBAAkB,CAAC,mBAAmB,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IACzB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxD,OAAO,OAAO,SAAS,IAAI,IAAI,EAAE,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;AAC5D,CAAC"}

package/docs/DOCUMENTATION.md

@@ -464,9 +464,19 @@ my-plugin/
 
 ### Install and Manage
 
+Plugins can be installed locally from a path or remotely from the official **Agent Hub** (`praveencs87/agent-skills` repository).
+
 ```bash
+# Install the official GitHub plugin from the Agent Hub
+agent plugins install github
+
+# Install a local plugin bundle
 agent plugins install ./my-plugin
+
+# List all installed plugins
 agent plugins list
+
+# Remove a plugin
 agent plugins remove my-plugin
 ```
 
@@ -531,6 +541,133 @@ agent studio
 | **Daemon** | Start/stop daemon, view logs, check health |
 | **Costs** | Monitor LLM token usage and spend per model |
 | **Memory** | Search, add, and browse persistent agent memories |
+| **Sandbox** | Monitor Docker sandbox status, start/stop containers |
+| **Swarm** | View multi-agent sessions, agents, tasks, and delegation |
+| **Desktop** | Screen capture, mouse clicks, keyboard input, hotkeys |
+| **Multimodal** | Voice transcription, image analysis, text-to-speech |
+
+---
+
+## Sandboxed Docker Execution
+
+Run all `cmd.run` commands inside isolated Docker containers for safe execution:
+
+```bash
+agent sandbox start              # Spin up an ephemeral container
+agent sandbox status             # Show container info and uptime
+agent sandbox stop               # Destroy the container
+```
+
+### Configuration
+
+```yaml
+# agent.yaml
+sandbox:
+  enabled: true
+  image: node:20-slim
+  timeout: 60000
+  network: bridge              # bridge | host | none
+  mounts:
+    - hostPath: "."
+      containerPath: "/project"
+      readOnly: false
+```
+
+When sandbox is active, all shell commands execute inside the Docker container via `docker exec`.
+
+---
+
+## Multi-Agent Swarm
+
+Coordinate multiple specialized AI agents on complex goals:
+
+```bash
+agent swarm start "Build a REST API with auth and tests"
+agent swarm status               # View agents, tasks, completion
+agent swarm roles                # List available agent roles
+agent swarm stop                 # Stop the session
+```
+
+### Built-in Roles
+
+| Role | Purpose | Tools |
+|------|---------|-------|
+| **Planner** | Decomposes goals into tasks, assigns to specialists | `fs.read`, `project.detect` |
+| **Coder** | Writes production-ready code | `fs.read`, `fs.write`, `cmd.run`, `git.diff` |
+| **Reviewer** | Reviews code for bugs, security, and style | `fs.read`, `fs.search`, `git.diff` |
+| **Researcher** | Gathers information, analyzes patterns | `fs.read`, `fs.search`, `cmd.run` |
+| **Tester** | Writes and runs tests | `fs.read`, `fs.write`, `cmd.run` |
+
+### Configuration
+
+```yaml
+swarm:
+  enabled: true
+  maxAgents: 5
+  model: gpt-4o
+  allowDelegation: true
+  maxDelegationDepth: 3
+```
+
+---
+
+## Desktop Automation
+
+Control the desktop with screenshots, mouse, and keyboard:
+
+```bash
+agent desktop screenshot         # Capture full screen
+agent desktop screenshot -r 0,0,800,600  # Capture region
+agent desktop click 500 300      # Click at coordinates
+agent desktop type "Hello world" --enter
+agent desktop hotkey ctrl+s      # Keyboard shortcut
+```
+
+### Supported Platforms
+
+| Platform | Screenshot Tool | Input Tool |
+|----------|----------------|------------|
+| **Linux** | scrot, gnome-screenshot, ImageMagick | xdotool |
+| **macOS** | screencapture | osascript, cliclick |
+| **Windows** | PowerShell | (planned) |
+
+### Configuration
+
+```yaml
+desktop:
+  enabled: true
+  screenshotFormat: png
+  actionDelay: 100
+  tempDir: /tmp/agent-desktop
+```
+
+---
+
+## Multimodal Interfaces
+
+Voice input, image analysis, and text-to-speech powered by OpenAI:
+
+```bash
+agent multimodal transcribe recording.wav          # Speech → Text (Whisper)
+agent multimodal analyze screenshot.png -p "What UI bugs do you see?"  # Vision
+agent multimodal speak "Deployment complete"       # Text → Speech
+```
+
+### Configuration
+
+```yaml
+multimodal:
+  enabled: true
+  voice:
+    model: whisper-1
+  vision:
+    model: gpt-4o
+    detail: auto
+  tts:
+    model: tts-1
+    voice: alloy           # alloy, echo, fable, onyx, nova, shimmer
+    format: mp3
+```
 
 ---
 

package/package.json

@@ -1,9 +1,11 @@
 {
     "name": "@praveencs/agent",
-    "version": "0.9.29",
+    "version": "0.10.0",
     "files": [
         "dist",
         "bin",
+        "studio",
+        "agent-skills",
         "README.md",
         "ROADMAP.md",
         "docs",
@@ -87,4 +89,4 @@
         "tsx": "^4.19.2",
         "typescript": "^5.7.3"
     }
-}
+}

package/studio/README.md

@@ -0,0 +1,73 @@
+# React + TypeScript + Vite
+
+This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
+
+Currently, two official plugins are available:
+
+- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Babel](https://babeljs.io/) (or [oxc](https://oxc.rs) when used in [rolldown-vite](https://vite.dev/guide/rolldown)) for Fast Refresh
+- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
+
+## React Compiler
+
+The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
+
+## Expanding the ESLint configuration
+
+If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:
+
+```js
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+
+      // Remove tseslint.configs.recommended and replace with this
+      tseslint.configs.recommendedTypeChecked,
+      // Alternatively, use this for stricter rules
+      tseslint.configs.strictTypeChecked,
+      // Optionally, add this for stylistic rules
+      tseslint.configs.stylisticTypeChecked,
+
+      // Other configs...
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+])
+```
+
+You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:
+
+```js
+// eslint.config.js
+import reactX from 'eslint-plugin-react-x'
+import reactDom from 'eslint-plugin-react-dom'
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+      // Enable lint rules for React
+      reactX.configs['recommended-typescript'],
+      // Enable lint rules for React DOM
+      reactDom.configs.recommended,
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+])
+```

package/studio/eslint.config.js

@@ -0,0 +1,23 @@
+import js from '@eslint/js'
+import globals from 'globals'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+import tseslint from 'typescript-eslint'
+import { defineConfig, globalIgnores } from 'eslint/config'
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      js.configs.recommended,
+      tseslint.configs.recommended,
+      reactHooks.configs.flat.recommended,
+      reactRefresh.configs.vite,
+    ],
+    languageOptions: {
+      ecmaVersion: 2020,
+      globals: globals.browser,
+    },
+  },
+])

package/studio/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>studio</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>