@supen-ai/cli 0.1.6

package/daemon/dist/tools/index.js

@@ -0,0 +1,86 @@
+/**
+ * Supen System Tools - MCP Definitions.
+ */
+import { automationTools } from './automations.js';
+import { systemTools } from './system.js';
+import { shellTools } from './shell.js';
+export const BUILTIN_TOOLS_DEFINITION = [
+    {
+        name: 'create_automation',
+        description: 'Create an automation. The agent_id is automatically linked to your identity.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Short automation name' },
+                prompt: { type: 'string', description: 'What the agent should do when triggered' },
+                rrule: { type: 'string', description: 'RRULE schedule expression (e.g. "FREQ=MINUTELY;INTERVAL=1")' },
+                timezone: { type: 'string', description: 'IANA timezone (e.g. "Asia/Shanghai")' },
+            },
+            required: ['name', 'prompt', 'rrule', 'timezone']
+        },
+        handler: automationTools.create_automation
+    },
+    {
+        name: 'list_my_automations',
+        description: 'Check all your automations (active and paused).',
+        inputSchema: { type: 'object', properties: {} },
+        handler: automationTools.list_my_automations
+    },
+    {
+        name: 'delete_automation',
+        description: 'Delete one of your automations.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Automation identifier' }
+            },
+            required: ['id']
+        },
+        handler: automationTools.delete_automation
+    },
+    {
+        name: 'update_automation',
+        description: 'Update an existing automation (including pausing/resuming by status).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Automation identifier' },
+                name: { type: 'string', description: 'Updated automation name' },
+                prompt: { type: 'string', description: 'Updated task prompt' },
+                rrule: { type: 'string', description: 'Updated RRULE schedule expression' },
+                timezone: { type: 'string', description: 'Updated IANA timezone' },
+                status: {
+                    type: 'string',
+                    enum: ['ACTIVE', 'PAUSED'],
+                    description: 'Set ACTIVE to resume, PAUSED to pause',
+                }
+            },
+            required: ['id']
+        },
+        handler: automationTools.update_automation
+    },
+    {
+        name: 'get_current_time',
+        description: 'Get current system date, time and day of week.',
+        inputSchema: { type: 'object', properties: {} },
+        handler: systemTools.get_current_time
+    },
+    {
+        name: 'run_system_command',
+        description: 'Run a shell command in your workspace. Use for system inspection.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                command: { type: 'string', description: 'Shell command to execute' }
+            },
+            required: ['command']
+        },
+        handler: shellTools.run_command
+    }
+];
+export const builtInTools = {
+    ...automationTools,
+    ...systemTools,
+    ...shellTools
+};
+//# sourceMappingURL=index.js.map

package/daemon/dist/tools/index.js.map

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

package/daemon/dist/tools/shell.d.ts

@@ -0,0 +1,15 @@
+import { ToolContext } from './types.js';
+export declare const shellTools: {
+    /**
+     * Run a simple shell command in the agent's assigned workspace.
+     * This is a "First-class" skill that doesn't need external setup.
+     */
+    run_command(ctx: ToolContext, args: {
+        command: string;
+    }): Promise<{
+        stdout: any;
+        stderr: any;
+        code: any;
+    }>;
+};
+//# sourceMappingURL=shell.d.ts.map

package/daemon/dist/tools/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/tools/shell.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAMzC,eAAO,MAAM,UAAU;IACrB;;;OAGG;qBACoB,WAAW,QAAQ;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;;;;;CAgC9D,CAAC"}

package/daemon/dist/tools/shell.js

@@ -0,0 +1,46 @@
+/**
+ * Controlled Built-in Shell Executor.
+ * Directly using Host Exec but with Agent-specific restrictions.
+ */
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { logger } from '../core/logger.js';
+import { withRuntimeSpaceEnv } from '../core/space-env.js';
+const execAsync = promisify(exec);
+export const shellTools = {
+    /**
+     * Run a simple shell command in the agent's assigned workspace.
+     * This is a "First-class" skill that doesn't need external setup.
+     */
+    async run_command(ctx, args) {
+        if (!ctx.workspace) {
+            throw new Error('Workspace is not properly initialized for this agent');
+        }
+        try {
+            logger.info({ agent_id: ctx.agent_id, command: args.command }, 'Executing built-in shell command');
+            const { stdout, stderr } = await execAsync(args.command, {
+                cwd: ctx.workspace,
+                timeout: 15_000, // 15s limit for safety
+                env: {
+                    ...withRuntimeSpaceEnv(process.env),
+                    AGENT_ID: ctx.agent_id,
+                    SESSION_ID: ctx.session_id,
+                    WORKSPACE_PATH: ctx.workspace
+                }
+            });
+            return {
+                stdout: stdout.trim(),
+                stderr: stderr.trim(),
+                code: 0
+            };
+        }
+        catch (err) {
+            return {
+                stdout: err.stdout || '',
+                stderr: err.stderr || err.message,
+                code: err.code || 1
+            };
+        }
+    }
+};
+//# sourceMappingURL=shell.js.map

package/daemon/dist/tools/shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../src/tools/shell.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB;;;OAGG;IACH,KAAK,CAAC,WAAW,CAAC,GAAgB,EAAE,IAAyB;QAC3D,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,kCAAkC,CAAC,CAAC;YAEnG,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE;gBACvD,GAAG,EAAE,GAAG,CAAC,SAAS;gBAClB,OAAO,EAAE,MAAM,EAAE,uBAAuB;gBACxC,GAAG,EAAE;oBACH,GAAG,mBAAmB,CAAC,OAAO,CAAC,GAAG,CAAC;oBACnC,QAAQ,EAAE,GAAG,CAAC,QAAQ;oBACtB,UAAU,EAAE,GAAG,CAAC,UAAU;oBAC1B,cAAc,EAAE,GAAG,CAAC,SAAS;iBAC9B;aACF,CAAC,CAAC;YAEH,OAAO;gBACL,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;gBACrB,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;gBACrB,IAAI,EAAE,CAAC;aACR,CAAC;QACJ,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO;gBACL,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE;gBACxB,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO;gBACjC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC;aACpB,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/daemon/dist/tools/skill-tools.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Reads the agent-level skills filter and converts all enabled Supen skills
+ * into Vercel AI SDK `tool()` objects.
+ *
+ * DEPRECATED: This function creates Vercel AI SDK tool format, which is not
+ * compatible with Claude Code tool calls. Skills should be exposed via
+ * MCP servers or SDK's native tools mechanism instead.
+ *
+ * This function is kept for reference but returns stubs that do not actually
+ * execute skill functionality.
+ *
+ * @param agentId - Agent identifier
+ * @param options - Configuration options
+ * @param options.tier - Tool tier to load: 'core' (high-priority), 'extended' (all), or 'none' (no skills)
+ * @returns Object containing tools and activeTools array for progressive discovery
+ */
+export declare function buildVercelToolsFromSkills(agentId: string, options?: {
+    tier?: 'core' | 'extended' | 'none';
+}): {
+    tools: Record<string, import("ai").Tool<any, any>>;
+    activeTools: string[];
+};
+//# sourceMappingURL=skill-tools.d.ts.map

package/daemon/dist/tools/skill-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-tools.d.ts","sourceRoot":"","sources":["../../src/tools/skill-tools.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAA;CAAO;;;EAiDtD"}

package/daemon/dist/tools/skill-tools.js

@@ -0,0 +1,64 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+import { SkillHub } from '../skills/hub.js';
+import { SKILLS_CONFIG } from '../core/config.js';
+/**
+ * Reads the agent-level skills filter and converts all enabled Supen skills
+ * into Vercel AI SDK `tool()` objects.
+ *
+ * DEPRECATED: This function creates Vercel AI SDK tool format, which is not
+ * compatible with Claude Code tool calls. Skills should be exposed via
+ * MCP servers or SDK's native tools mechanism instead.
+ *
+ * This function is kept for reference but returns stubs that do not actually
+ * execute skill functionality.
+ *
+ * @param agentId - Agent identifier
+ * @param options - Configuration options
+ * @param options.tier - Tool tier to load: 'core' (high-priority), 'extended' (all), or 'none' (no skills)
+ * @returns Object containing tools and activeTools array for progressive discovery
+ */
+export function buildVercelToolsFromSkills(agentId, options = {}) {
+    const { tier = 'extended' } = options;
+    if (tier === 'none') {
+        return { tools: {}, activeTools: [] };
+    }
+    const skillHub = new SkillHub(SKILLS_CONFIG);
+    const available = skillHub.listAvailable();
+    const tools = {};
+    const coreToolNames = [];
+    const extendedToolNames = [];
+    for (const { skill, installed } of available) {
+        if (!installed?.enabled)
+            continue;
+        // For Supen skills, we expose them to Vercel AI SDK. Since Supen skills are 
+        // usually documented in SKILL.md, we expose a simple wrapper.
+        // In the future, this would parse their parameters into proper Zod schemas.
+        const toolName = skill.name.replace(/[^a-zA-Z0-9_-]/g, '_');
+        tools[toolName] = tool({
+            description: skill.description || `Use the ${skill.name} skill`,
+            inputSchema: z.object({
+                input: z.string().describe('Input or arguments for the skill, if any'),
+            }),
+            execute: async (args) => {
+                const { input } = args;
+                return { ok: true, output: `Executed skill ${skill.name} (This is a stub, actual execution goes through Cortex dispatch)` };
+            }
+        });
+        // Categorize tools by priority
+        // Core: Level 1 permissions (read-only, safe operations)
+        // Extended: Level 2+ (requires execution permissions)
+        if (skill.permission.level === 1) {
+            coreToolNames.push(toolName);
+        }
+        else {
+            extendedToolNames.push(toolName);
+        }
+    }
+    // Return tools with activeTools array for progressive discovery
+    const activeTools = tier === 'core'
+        ? coreToolNames
+        : [...coreToolNames, ...extendedToolNames];
+    return { tools, activeTools };
+}
+//# sourceMappingURL=skill-tools.js.map

package/daemon/dist/tools/skill-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-tools.js","sourceRoot":"","sources":["../../src/tools/skill-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAe,EACf,UAAmD,EAAE;IAErD,MAAM,EAAE,IAAI,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;IAEtC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IACxC,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC;IAE3C,MAAM,KAAK,GAAsC,EAAE,CAAC;IACpD,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,MAAM,iBAAiB,GAAa,EAAE,CAAC;IAEvC,KAAK,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,SAAS,EAAE,CAAC;QAC7C,IAAI,CAAC,SAAS,EAAE,OAAO;YAAE,SAAS;QAElC,6EAA6E;QAC7E,8DAA8D;QAC9D,4EAA4E;QAC5E,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;QAC5D,KAAK,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;YACrB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,WAAW,KAAK,CAAC,IAAI,QAAQ;YAC/D,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;aACvE,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACtB,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;gBACvB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,KAAK,CAAC,IAAI,kEAAkE,EAAE,CAAC;YAC9H,CAAC;SACF,CAAC,CAAC;QAEH,+BAA+B;QAC/B,yDAAyD;QACzD,sDAAsD;QACtD,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;YACjC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,MAAM,WAAW,GAAG,IAAI,KAAK,MAAM;QACjC,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,CAAC,GAAG,aAAa,EAAE,GAAG,iBAAiB,CAAC,CAAC;IAE7C,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAChC,CAAC"}

package/daemon/dist/tools/system.d.ts

@@ -0,0 +1,36 @@
+export declare const systemTools: {
+    /**
+     * Get Current system time, date, and day of week.
+     * Essential for scheduling and daily planning.
+     */
+    get_current_time(): Promise<{
+        iso: string;
+        local: string;
+        timezone: string;
+        day_of_week: string;
+        timestamp: number;
+    }>;
+    /**
+     * Get basic system information (OS, uptime, memory occupancy).
+     */
+    get_system_status(): Promise<{
+        platform: NodeJS.Platform;
+        release: string;
+        uptime: number;
+        loadavg: number[];
+        memory: {
+            total_gb: number;
+            used_percent: number;
+        };
+    }>;
+    /**
+     * Get identity of the agent currently running.
+     */
+    whoami(_args: any, context: {
+        agent_id: string;
+    }): Promise<{
+        agent_id: string;
+        description: string;
+    }>;
+};
+//# sourceMappingURL=system.d.ts.map

package/daemon/dist/tools/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/tools/system.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,WAAW;IACtB;;;OAGG;;;;;;;;IAYH;;OAEG;;;;;;;;;;;IAkBH;;OAEG;kBACiB,GAAG,WAAW;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE;;;;CAMvD,CAAC"}

package/daemon/dist/tools/system.js

@@ -0,0 +1,54 @@
+/**
+ * Built-in Tools for System Metadata Access.
+ * Always available to every agent.
+ */
+import os from 'os';
+import { TIMEZONE } from '../core/config.js';
+/** Product brand name, set by the product wrapper (e.g. @supen/node sets NODE_PRODUCT=supen). */
+const NODE_PRODUCT = process.env.NODE_PRODUCT
+    ? process.env.NODE_PRODUCT.charAt(0).toUpperCase() + process.env.NODE_PRODUCT.slice(1)
+    : 'Supen';
+export const systemTools = {
+    /**
+     * Get Current system time, date, and day of week.
+     * Essential for scheduling and daily planning.
+     */
+    async get_current_time() {
+        const now = new Date();
+        return {
+            iso: now.toISOString(),
+            local: now.toLocaleString('en-US', { timeZone: TIMEZONE }),
+            timezone: TIMEZONE,
+            day_of_week: now.toLocaleDateString('en-US', { weekday: 'long' }),
+            timestamp: Date.now()
+        };
+    },
+    /**
+     * Get basic system information (OS, uptime, memory occupancy).
+     */
+    async get_system_status() {
+        const totalMem = os.totalmem();
+        const freeMem = os.freemem();
+        const usedPercent = Math.round(((totalMem - freeMem) / totalMem) * 100);
+        return {
+            platform: os.platform(),
+            release: os.release(),
+            uptime: Math.round(os.uptime()),
+            loadavg: os.loadavg(),
+            memory: {
+                total_gb: Math.round(totalMem / 1024 / 1024 / 1024),
+                used_percent: usedPercent
+            }
+        };
+    },
+    /**
+     * Get identity of the agent currently running.
+     */
+    async whoami(_args, context) {
+        return {
+            agent_id: context.agent_id,
+            description: `You are agent '${context.agent_id}' running as a ${NODE_PRODUCT} Node.`
+        };
+    }
+};
+//# sourceMappingURL=system.js.map

package/daemon/dist/tools/system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../src/tools/system.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,iGAAiG;AACjG,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY;IAC3C,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IACtF,CAAC,CAAC,OAAO,CAAC;AAEZ,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB;;;OAGG;IACH,KAAK,CAAC,gBAAgB;QACpB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO;YACL,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE;YACtB,KAAK,EAAE,GAAG,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;YAC1D,QAAQ,EAAE,QAAQ;YAClB,WAAW,EAAE,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;YACjE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB;QACrB,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC;QAExE,OAAO;YACL,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE;YACvB,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE;YACrB,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC;YAC/B,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE;YACrB,MAAM,EAAE;gBACN,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;gBACnD,YAAY,EAAE,WAAW;aAC1B;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,KAAU,EAAE,OAA6B;QACpD,OAAO;YACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,WAAW,EAAE,kBAAkB,OAAO,CAAC,QAAQ,kBAAkB,YAAY,QAAQ;SACtF,CAAC;IACJ,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * Injected Context for Built-in Tools.
+ * Guaranteed by the framework, cannot be spoofed by the Agent.
+ */
+export interface ToolContext {
+    agent_id: string;
+    session_id: string;
+    workspace: string;
+}
+export type BuiltInToolHandler = (ctx: ToolContext, args: any) => Promise<any> | any;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC"}

package/daemon/dist/tools/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":""}

package/daemon/scripts/browser-smoke.mjs

@@ -0,0 +1,125 @@
+/**
+ * Headless smoke: loads Supen app, checks console, visits key routes.
+ * Run from apps/daemon: node scripts/browser-smoke.mjs
+ *
+ * Uses Chromium for list routes. The session chat route is opened in WebKit
+ * because Chromium’s renderer sometimes crashes on this app (WebGL/Rive/etc.).
+ */
+import { chromium, webkit } from "playwright";
+
+const BASE = process.env.SUPEN_URL || "http://127.0.0.1:2655";
+
+const routes = ["/", "/sessions", "/automations", "/agents"];
+
+async function main() {
+  const browser = await chromium.launch({
+    headless: true,
+    executablePath: '/usr/bin/google-chrome',
+    args: ["--disable-dev-shm-usage", "--disable-gpu"],
+  });
+  const page = await browser.newPage();
+  const errors = [];
+  const warnings = [];
+
+  page.on("pageerror", (e) => errors.push(`pageerror: ${e.message}`));
+  page.on("console", (msg) => {
+    const t = msg.type();
+    const text = msg.text();
+    if (t === "error") errors.push(`console: ${text}`);
+    if (t === "warning") warnings.push(`console: ${text}`);
+  });
+
+  for (const path of routes) {
+    const url = `${BASE.replace(/\/$/, "")}${path}`;
+    process.stdout.write(`\n→ ${url}\n`);
+    const res = await page.goto(url, {
+      waitUntil: "domcontentloaded",
+      timeout: 45_000,
+    });
+    process.stdout.write(`  status: ${res?.status()}\n`);
+    await page.waitForTimeout(1200);
+    const title = await page.title();
+    process.stdout.write(`  title: ${title}\n`);
+    const mainText = await page
+      .locator("main")
+      .first()
+      .innerText()
+      .catch(() => "(no main)");
+    const snippet = mainText.replace(/\s+/g, " ").slice(0, 200);
+    process.stdout.write(
+      `  main (snippet): ${snippet}${mainText.length > 200 ? "…" : ""}\n`,
+    );
+  }
+
+  await browser.close();
+
+  // Chat route in a fresh browser — Chromium renderer sometimes crashes on heavy canvas/WebGL routes.
+  process.stdout.write(`\n→ Chat flow (first session, Chromium)\n`);
+  const wk = await chromium.launch({ headless: true, executablePath: '/usr/bin/google-chrome' });
+  const p2 = await wk.newPage();
+  p2.on("pageerror", (e) => errors.push(`pageerror: ${e.message}`));
+  p2.on("console", (msg) => {
+    if (msg.type() === "error") errors.push(`console: ${msg.text()}`);
+  });
+
+  const sessionsList = `${BASE.replace(/\/$/, "")}/sessions`;
+  await p2.goto(sessionsList, {
+    waitUntil: "domcontentloaded",
+    timeout: 45_000,
+  });
+  await p2.waitForTimeout(1500);
+  const sessionLink = p2.locator(
+    'main a[href^="/sessions/"]:not([href$="/new"])',
+  );
+  const n = await sessionLink.count();
+  if (n > 0) {
+    const href = await sessionLink.first().getAttribute("href");
+    const chatUrl = `${BASE.replace(/\/$/, "")}${href}`;
+    process.stdout.write(`  navigating: ${chatUrl}\n`);
+    await p2.goto(chatUrl, {
+      waitUntil: "domcontentloaded",
+      timeout: 45_000,
+    });
+    await p2.waitForTimeout(2500);
+    process.stdout.write(`  title: ${await p2.title()}\n`);
+    const bodySample = await p2
+      .locator("main")
+      .first()
+      .innerText()
+      .catch(() => "");
+    const hasLoading = /Loading session/i.test(bodySample);
+    const hasComposer =
+      (await p2.locator('textarea, [contenteditable="true"]').count()) > 0;
+    process.stdout.write(
+      `  loading placeholder: ${hasLoading}, composer visible: ${hasComposer}\n`,
+    );
+    const snippet = bodySample.replace(/\s+/g, " ").slice(0, 280);
+    process.stdout.write(`  main (snippet): ${snippet}…\n`);
+    if (hasLoading && !hasComposer) {
+      errors.push(
+        "chat-flow: session view stuck on Loading session or missing composer",
+      );
+    }
+  } else {
+    process.stdout.write("  (no sessions to open — skip)\n");
+  }
+
+  await wk.close();
+
+  if (warnings.length) {
+    process.stdout.write(`\nWarnings (${warnings.length}):\n`);
+    warnings.slice(0, 15).forEach((w) => process.stdout.write(`  ${w}\n`));
+  }
+  if (errors.length) {
+    process.stderr.write(`\nErrors (${errors.length}):\n`);
+    errors.forEach((e) => process.stderr.write(`  ${e}\n`));
+    process.exitCode = 1;
+  } else {
+    process.stdout.write("\nNo page errors or console errors detected.\n");
+  }
+}
+
+main().catch((e) => {
+  console.error(e);
+  process.exit(1);
+});

package/daemon/scripts/supen-daemon.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * @tiwater/supen-daemon - Supen-branded agent daemon runtime.
+ */
+import { startSupenDaemon } from '../dist/start.js';
+import os from 'os';
+import path from 'path';
+
+startSupenDaemon({
+  productName: 'supen',
+  dataDir: path.join(os.homedir(), '.supen'),
+}).catch((err) => {
+  console.error('[supen-daemon] Failed to start:', err);
+  process.exit(1);
+});

package/dist/agent.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `supen agent` — Manage agents.
+ *
+ * Subcommands:
+ *   supen agent list                   List all agents
+ *   supen agent create <name>         Create new agent
+ *   supen agent delete <name>         Delete agent
+ *   supen agent info <name>           Show agent config
+ */
+import { Command } from 'commander';
+export declare function registerAgentCommand(program: Command): void;