@praveencs/agent 0.1.0

package/dist/src/tools/registry.js

@@ -0,0 +1,118 @@
+/**
+ * Global tool registry — all tools register here
+ */
+export class ToolRegistry {
+    tools = new Map();
+    static instance;
+    static getInstance() {
+        if (!ToolRegistry.instance) {
+            ToolRegistry.instance = new ToolRegistry();
+        }
+        return ToolRegistry.instance;
+    }
+    /**
+     * Register a tool definition
+     */
+    register(tool) {
+        if (this.tools.has(tool.name)) {
+            throw new Error(`Tool "${tool.name}" is already registered`);
+        }
+        this.tools.set(tool.name, tool);
+    }
+    /**
+     * Get a tool by name
+     */
+    get(name) {
+        return this.tools.get(name);
+    }
+    /**
+     * Check if a tool exists
+     */
+    has(name) {
+        return this.tools.has(name);
+    }
+    /**
+     * List all registered tools
+     */
+    list() {
+        return Array.from(this.tools.values()).map((t) => ({
+            name: t.name,
+            category: t.category,
+            description: t.description,
+            permissions: t.permissions,
+        }));
+    }
+    /**
+     * List tools by category
+     */
+    listByCategory(category) {
+        return this.list().filter((t) => t.category === category);
+    }
+    /**
+     * Execute a tool with input validation and permission checks
+     */
+    async execute(name, input, ctx) {
+        const tool = this.tools.get(name);
+        if (!tool) {
+            return {
+                success: false,
+                error: `Tool "${name}" not found`,
+                durationMs: 0,
+            };
+        }
+        // Validate input
+        const parseResult = tool.inputSchema.safeParse(input);
+        if (!parseResult.success) {
+            return {
+                success: false,
+                error: `Invalid input for "${name}": ${parseResult.error.issues.map((i) => i.message).join(', ')}`,
+                durationMs: 0,
+            };
+        }
+        // Check if tool is enabled in config
+        const isEnabled = ctx.config.tools.enabled.some((pattern) => {
+            if (pattern === name)
+                return true;
+            if (pattern.endsWith('.*')) {
+                return name.startsWith(pattern.slice(0, -1));
+            }
+            return false;
+        });
+        if (!isEnabled) {
+            return {
+                success: false,
+                error: `Tool "${name}" is not enabled in configuration`,
+                durationMs: 0,
+            };
+        }
+        // Execute with timeout
+        const timeout = tool.timeout ?? ctx.config.tools.timeoutMs;
+        const start = Date.now();
+        try {
+            const result = await Promise.race([
+                tool.execute(parseResult.data, ctx),
+                new Promise((_, reject) => setTimeout(() => reject(new Error(`Tool "${name}" timed out after ${timeout}ms`)), timeout)),
+            ]);
+            return { ...result, durationMs: Date.now() - start };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+                durationMs: Date.now() - start,
+            };
+        }
+    }
+    /**
+     * Check if a tool name matches a pattern (e.g., "fs.*")
+     */
+    matchesPattern(name, pattern) {
+        if (pattern === name)
+            return true;
+        if (pattern.endsWith('.*')) {
+            return name.startsWith(pattern.slice(0, -1));
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/tools/registry.js.map

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

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

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+export type PermissionCategory = 'filesystem' | 'filesystem.read' | 'filesystem.write' | 'exec' | 'network' | 'ui_automation' | 'secrets';
+export declare const PERMISSION_CATEGORIES: PermissionCategory[];
+export interface ToolResult<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    durationMs: number;
+    metadata?: Record<string, unknown>;
+}
+export interface ExecutionContext {
+    runId: string;
+    stepId?: string;
+    cwd: string;
+    config: import('../config/schema.js').AgentConfig;
+    dryRun?: boolean;
+    autonomous?: boolean;
+    approvedPermissions: Set<string>;
+    onApproval?: (action: ActionDescriptor) => Promise<boolean>;
+    onProgress?: (message: string) => void;
+}
+export interface ActionDescriptor {
+    tool: string;
+    operation: string;
+    description: string;
+    permissions: PermissionCategory[];
+    args?: Record<string, unknown>;
+    riskLevel: 'low' | 'medium' | 'high';
+}
+export interface ToolDefinition<TInput = unknown, TOutput = unknown> {
+    name: string;
+    category: string;
+    description: string;
+    inputSchema: z.ZodType<TInput>;
+    outputSchema: z.ZodType<TOutput>;
+    permissions: PermissionCategory[];
+    timeout?: number;
+    execute(input: TInput, ctx: ExecutionContext): Promise<ToolResult<TOutput>>;
+}
+export interface ToolMetadata {
+    name: string;
+    category: string;
+    description: string;
+    permissions: PermissionCategory[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,MAAM,kBAAkB,GACxB,YAAY,GACZ,iBAAiB,GACjB,kBAAkB,GAClB,MAAM,GACN,SAAS,GACT,eAAe,GACf,SAAS,CAAC;AAEhB,eAAO,MAAM,qBAAqB,EAAE,kBAAkB,EAQrD,CAAC;AAGF,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAGD,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,qBAAqB,EAAE,WAAW,CAAC;IAClD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAGD,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACxC;AAGD,MAAM,WAAW,cAAc,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;CAC/E;AAGD,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACrC"}

package/dist/src/tools/types.js

@@ -0,0 +1,10 @@
+export const PERMISSION_CATEGORIES = [
+    'filesystem',
+    'filesystem.read',
+    'filesystem.write',
+    'exec',
+    'network',
+    'ui_automation',
+    'secrets',
+];
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/types.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,qBAAqB,GAAyB;IACvD,YAAY;IACZ,iBAAiB;IACjB,kBAAkB;IAClB,MAAM;IACN,SAAS;IACT,eAAe;IACf,SAAS;CACZ,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Hash a string using SHA-256
+ */
+export declare function hashString(content: string): string;
+/**
+ * Hash a file's content
+ */
+export declare function hashFile(filePath: string): Promise<string>;
+/**
+ * Generate a short hash (first 8 chars) for display purposes
+ */
+export declare function shortHash(content: string): string;
+//# sourceMappingURL=hash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../src/utils/hash.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGhE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/src/utils/hash.js

@@ -0,0 +1,22 @@
+import { createHash } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+/**
+ * Hash a string using SHA-256
+ */
+export function hashString(content) {
+    return createHash('sha256').update(content).digest('hex');
+}
+/**
+ * Hash a file's content
+ */
+export async function hashFile(filePath) {
+    const content = await readFile(filePath);
+    return createHash('sha256').update(content).digest('hex');
+}
+/**
+ * Generate a short hash (first 8 chars) for display purposes
+ */
+export function shortHash(content) {
+    return hashString(content).substring(0, 8);
+}
+//# sourceMappingURL=hash.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../../src/utils/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACtC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAgB;IAC3C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACrC,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC"}

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

@@ -0,0 +1,45 @@
+/**
+ * Resolve a path relative to the current working directory
+ */
+export declare function resolveProjectPath(...segments: string[]): string;
+/**
+ * Get the .agent directory path for the current project
+ */
+export declare function getAgentDir(): string;
+/**
+ * Get the skills directory
+ */
+export declare function getSkillsDir(): string;
+/**
+ * Get the plans directory
+ */
+export declare function getPlansDir(): string;
+/**
+ * Get the runs directory
+ */
+export declare function getRunsDir(): string;
+/**
+ * Get the plugins directory
+ */
+export declare function getPluginsDir(): string;
+/**
+ * Get the logs directory
+ */
+export declare function getLogsDir(): string;
+/**
+ * Get the global agent config directory
+ */
+export declare function getGlobalAgentDir(): string;
+/**
+ * Get the config file path
+ */
+export declare function getConfigPath(): string;
+/**
+ * Generate a unique run ID with timestamp
+ */
+export declare function generateRunId(): string;
+/**
+ * Normalize a tool or skill name
+ */
+export declare function normalizeName(name: string): string;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +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,IAAI,MAAM,CAEpC;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"}

package/dist/src/utils/paths.js

@@ -0,0 +1,71 @@
+import path from 'node:path';
+import os from 'node:os';
+/**
+ * Resolve a path relative to the current working directory
+ */
+export function resolveProjectPath(...segments) {
+    return path.resolve(process.cwd(), ...segments);
+}
+/**
+ * Get the .agent directory path for the current project
+ */
+export function getAgentDir() {
+    return resolveProjectPath('.agent');
+}
+/**
+ * Get the skills directory
+ */
+export function getSkillsDir() {
+    return path.join(getAgentDir(), 'skills');
+}
+/**
+ * Get the plans directory
+ */
+export function getPlansDir() {
+    return path.join(getAgentDir(), 'plans');
+}
+/**
+ * Get the runs directory
+ */
+export function getRunsDir() {
+    return path.join(getAgentDir(), 'runs');
+}
+/**
+ * Get the plugins directory
+ */
+export function getPluginsDir() {
+    return path.join(getAgentDir(), 'plugins');
+}
+/**
+ * Get the logs directory
+ */
+export function getLogsDir() {
+    return path.join(getAgentDir(), 'logs');
+}
+/**
+ * Get the global agent config directory
+ */
+export function getGlobalAgentDir() {
+    return path.join(os.homedir(), '.agent-runtime');
+}
+/**
+ * Get the config file path
+ */
+export function getConfigPath() {
+    return resolveProjectPath('agent.config.json');
+}
+/**
+ * Generate a unique run ID with timestamp
+ */
+export function generateRunId() {
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const rand = Math.random().toString(36).substring(2, 8);
+    return `run-${timestamp}-${rand}`;
+}
+/**
+ * Normalize a tool or skill name
+ */
+export function normalizeName(name) {
+    return name.toLowerCase().replace(/[^a-z0-9._-]/g, '-');
+}
+//# sourceMappingURL=paths.js.map

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

@@ -0,0 +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;IACvB,OAAO,kBAAkB,CAAC,QAAQ,CAAC,CAAC;AACxC,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"}

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

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+/**
+ * Validate data against a zod schema with friendly error messages
+ */
+export declare function validateSchema<T>(schema: z.ZodType<T>, data: unknown, context?: string): {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    errors: string[];
+};
+/**
+ * Create a JSON Schema-like object from a zod schema (simplified)
+ */
+export declare function zodToJsonSchema(schema: z.ZodType): Record<string, unknown>;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/utils/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC5B,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,MAAM,GACjB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAWnE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0C1E"}

package/dist/src/utils/schema.js

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+/**
+ * Validate data against a zod schema with friendly error messages
+ */
+export function validateSchema(schema, data, context) {
+    const result = schema.safeParse(data);
+    if (result.success) {
+        return { success: true, data: result.data };
+    }
+    const errors = result.error.issues.map((issue) => {
+        const path = issue.path.join('.');
+        const prefix = context ? `${context}: ` : '';
+        return `${prefix}${path ? `${path}: ` : ''}${issue.message}`;
+    });
+    return { success: false, errors };
+}
+/**
+ * Create a JSON Schema-like object from a zod schema (simplified)
+ */
+export function zodToJsonSchema(schema) {
+    if (schema instanceof z.ZodObject) {
+        const shape = schema.shape;
+        const properties = {};
+        const required = [];
+        for (const [key, value] of Object.entries(shape)) {
+            properties[key] = zodToJsonSchema(value);
+            // Default fields are optional in JSON schema
+            if (!(value instanceof z.ZodOptional) && !(value instanceof z.ZodDefault)) {
+                required.push(key);
+            }
+        }
+        return { type: 'object', properties, required };
+    }
+    if (schema instanceof z.ZodString) {
+        const def = schema._def;
+        const result = { type: 'string' };
+        if (def.description)
+            result.description = def.description;
+        return result;
+    }
+    if (schema instanceof z.ZodNumber)
+        return { type: 'number' };
+    if (schema instanceof z.ZodBoolean)
+        return { type: 'boolean' };
+    if (schema instanceof z.ZodArray) {
+        return {
+            type: 'array',
+            items: zodToJsonSchema(schema._def.type),
+        };
+    }
+    if (schema instanceof z.ZodOptional) {
+        return zodToJsonSchema(schema._def.innerType);
+    }
+    if (schema instanceof z.ZodDefault) {
+        return zodToJsonSchema(schema._def.innerType);
+    }
+    if (schema instanceof z.ZodEffects) {
+        return zodToJsonSchema(schema._def.schema);
+    }
+    if (schema instanceof z.ZodEnum) {
+        return { type: 'string', enum: schema._def.values };
+    }
+    // Fallback for unknown types (e.g. ZodAny, ZodUnknown) - use empty schema which matches anything, or string if safest
+    return { type: 'string' };
+}
+//# sourceMappingURL=schema.js.map

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

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

package/package.json

@@ -0,0 +1,77 @@
+{
+    "name": "@praveencs/agent",
+    "version": "0.1.0",
+    "files": [
+        "dist",
+        "bin",
+        "README.md",
+        "src/index.d.ts"
+    ],
+    "description": "CLI agent runtime with Skill Hub, Plan Files, and permissioned tools",
+    "type": "module",
+    "bin": {
+        "agent": "./dist/bin/agent.js"
+    },
+    "main": "./dist/src/index.js",
+    "types": "./dist/src/index.d.ts",
+    "scripts": {
+        "build": "tsc -p tsconfig.build.json",
+        "dev": "tsx watch bin/agent.ts",
+        "start": "node dist/bin/agent.js",
+        "lint": "eslint src/ bin/ --ext .ts",
+        "format": "prettier --write 'src/**/*.ts' 'bin/**/*.ts'",
+        "test": "jest --config jest.config.ts",
+        "test:integration": "jest --config jest.config.ts --testPathPattern=integration",
+        "prepublishOnly": "npm run build"
+    },
+    "keywords": [
+        "agent",
+        "cli",
+        "automation",
+        "skills",
+        "mcp",
+        "llm"
+    ],
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/praveencs87/agent.git"
+    },
+    "homepage": "https://github.com/praveencs87/agent#readme",
+    "bugs": {
+        "url": "https://github.com/praveencs87/agent/issues"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "dependencies": {
+        "@anthropic-ai/sdk": "^0.39.0",
+        "@modelcontextprotocol/sdk": "^1.5.0",
+        "chalk": "^5.4.1",
+        "chokidar": "^4.0.3",
+        "commander": "^13.1.0",
+        "croner": "^9.0.0",
+        "diff": "^7.0.0",
+        "glob": "^11.0.1",
+        "hnswsqlite": "^0.2.0",
+        "inquirer": "^12.4.0",
+        "keytar": "^7.9.0",
+        "openai": "^4.82.0",
+        "ora": "^8.2.0",
+        "pino": "^9.6.0",
+        "pino-pretty": "^13.0.0",
+        "yaml": "^2.7.0",
+        "zod": "^3.24.2"
+    },
+    "devDependencies": {
+        "@types/diff": "^7.0.0",
+        "@types/inquirer": "^9.0.7",
+        "@types/node": "^22.13.0",
+        "eslint": "^9.19.0",
+        "jest": "^29.7.0",
+        "prettier": "^3.4.2",
+        "ts-jest": "^29.2.5",
+        "tsx": "^4.19.2",
+        "typescript": "^5.7.3"
+    }
+}