titan-agent 2026.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/.env.example +21 -0
  2. package/LICENSE +29 -0
  3. package/README.md +305 -0
  4. package/assets/titan-logo.png +0 -0
  5. package/dist/agent/agent.js +1458 -0
  6. package/dist/agent/agent.js.map +1 -0
  7. package/dist/agent/generator.js +1078 -0
  8. package/dist/agent/generator.js.map +1 -0
  9. package/dist/cli/index.js +5064 -0
  10. package/dist/cli/index.js.map +1 -0
  11. package/dist/gateway/server.js +4462 -0
  12. package/dist/gateway/server.js.map +1 -0
  13. package/dist/skills/builtin/apply_patch.js +368 -0
  14. package/dist/skills/builtin/apply_patch.js.map +1 -0
  15. package/dist/skills/builtin/auto_generate.js +1129 -0
  16. package/dist/skills/builtin/auto_generate.js.map +1 -0
  17. package/dist/skills/builtin/browser.js +357 -0
  18. package/dist/skills/builtin/browser.js.map +1 -0
  19. package/dist/skills/builtin/cron.js +410 -0
  20. package/dist/skills/builtin/cron.js.map +1 -0
  21. package/dist/skills/builtin/filesystem.js +386 -0
  22. package/dist/skills/builtin/filesystem.js.map +1 -0
  23. package/dist/skills/builtin/memory_skill.js +430 -0
  24. package/dist/skills/builtin/memory_skill.js.map +1 -0
  25. package/dist/skills/builtin/process.js +421 -0
  26. package/dist/skills/builtin/process.js.map +1 -0
  27. package/dist/skills/builtin/sessions.js +1729 -0
  28. package/dist/skills/builtin/sessions.js.map +1 -0
  29. package/dist/skills/builtin/shell.js +327 -0
  30. package/dist/skills/builtin/shell.js.map +1 -0
  31. package/dist/skills/builtin/vision.js +491 -0
  32. package/dist/skills/builtin/vision.js.map +1 -0
  33. package/dist/skills/builtin/voice.js +468 -0
  34. package/dist/skills/builtin/voice.js.map +1 -0
  35. package/dist/skills/builtin/web_fetch.js +331 -0
  36. package/dist/skills/builtin/web_fetch.js.map +1 -0
  37. package/dist/skills/builtin/web_search.js +317 -0
  38. package/dist/skills/builtin/web_search.js.map +1 -0
  39. package/dist/skills/builtin/webhook.js +323 -0
  40. package/dist/skills/builtin/webhook.js.map +1 -0
  41. package/dist/skills/registry.js +3369 -0
  42. package/dist/skills/registry.js.map +1 -0
  43. package/package.json +118 -0
@@ -0,0 +1,327 @@
1
+ #!/usr/bin/env node
2
+ var __getOwnPropNames = Object.getOwnPropertyNames;
3
+ var __esm = (fn, res) => function __init() {
4
+ return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
5
+ };
6
+
7
+ // src/utils/constants.ts
8
+ import { homedir } from "os";
9
+ import { join } from "path";
10
+ var TITAN_VERSION, TITAN_ASCII_LOGO, TITAN_HOME, TITAN_CONFIG_PATH, TITAN_DB_PATH, TITAN_WORKSPACE, TITAN_SKILLS_DIR, TITAN_LOGS_DIR, TITAN_MEMORY_DIR, AGENTS_MD, SOUL_MD, TOOLS_MD, DEFAULT_GATEWAY_HOST, DEFAULT_GATEWAY_PORT, DEFAULT_WEB_PORT, DEFAULT_MODEL, DEFAULT_MAX_TOKENS, DEFAULT_TEMPERATURE, SESSION_TIMEOUT_MS, DEFAULT_SANDBOX_MODE, ALLOWED_TOOLS_DEFAULT;
11
+ var init_constants = __esm({
12
+ "src/utils/constants.ts"() {
13
+ "use strict";
14
+ TITAN_VERSION = "2026.4.0";
15
+ TITAN_ASCII_LOGO = `
16
+ \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
17
+ \u2551 \u2551
18
+ \u2551 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2557 \u2588\u2588\u2557 \u2551
19
+ \u2551 \u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D\u2588\u2588\u2551\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2551 \u2551
20
+ \u2551 \u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551 \u2551
21
+ \u2551 \u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2551\u255A\u2588\u2588\u2557\u2588\u2588\u2551 \u2551
22
+ \u2551 \u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2551\u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2551 \u2551
23
+ \u2551 \u255A\u2550\u255D \u255A\u2550\u255D \u255A\u2550\u255D \u255A\u2550\u255D \u255A\u2550\u255D\u255A\u2550\u255D \u255A\u2550\u2550\u2550\u255D \u2551
24
+ \u2551 \u2551
25
+ \u2551 The Intelligent Task Automation Network \u2551
26
+ \u2551 v${TITAN_VERSION} \u2551
27
+ \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D`;
28
+ TITAN_HOME = join(homedir(), ".titan");
29
+ TITAN_CONFIG_PATH = join(TITAN_HOME, "titan.json");
30
+ TITAN_DB_PATH = join(TITAN_HOME, "titan.db");
31
+ TITAN_WORKSPACE = join(TITAN_HOME, "workspace");
32
+ TITAN_SKILLS_DIR = join(TITAN_WORKSPACE, "skills");
33
+ TITAN_LOGS_DIR = join(TITAN_HOME, "logs");
34
+ TITAN_MEMORY_DIR = join(TITAN_HOME, "memory");
35
+ AGENTS_MD = join(TITAN_WORKSPACE, "AGENTS.md");
36
+ SOUL_MD = join(TITAN_WORKSPACE, "SOUL.md");
37
+ TOOLS_MD = join(TITAN_WORKSPACE, "TOOLS.md");
38
+ DEFAULT_GATEWAY_HOST = "127.0.0.1";
39
+ DEFAULT_GATEWAY_PORT = 18789;
40
+ DEFAULT_WEB_PORT = 18790;
41
+ DEFAULT_MODEL = "anthropic/claude-sonnet-4-20250514";
42
+ DEFAULT_MAX_TOKENS = 8192;
43
+ DEFAULT_TEMPERATURE = 0.7;
44
+ SESSION_TIMEOUT_MS = 30 * 60 * 1e3;
45
+ DEFAULT_SANDBOX_MODE = "host";
46
+ ALLOWED_TOOLS_DEFAULT = [
47
+ "shell",
48
+ "read_file",
49
+ "write_file",
50
+ "edit_file",
51
+ "list_dir",
52
+ "web_search",
53
+ "browser",
54
+ "cron",
55
+ "webhook",
56
+ "email",
57
+ "memory"
58
+ ];
59
+ }
60
+ });
61
+
62
+ // src/utils/logger.ts
63
+ import chalk from "chalk";
64
+ function formatTimestamp() {
65
+ return chalk.gray((/* @__PURE__ */ new Date()).toISOString().replace("T", " ").slice(0, 19));
66
+ }
67
+ function log(level, component, message, ...args) {
68
+ if (level < currentLevel) return;
69
+ const prefix = `${formatTimestamp()} ${LEVEL_LABELS[level]} ${chalk.blue(`[${component}]`)}`;
70
+ console.log(`${prefix} ${message}`, ...args);
71
+ }
72
+ var LEVEL_LABELS, currentLevel, logger, logger_default;
73
+ var init_logger = __esm({
74
+ "src/utils/logger.ts"() {
75
+ "use strict";
76
+ LEVEL_LABELS = {
77
+ [0 /* DEBUG */]: chalk.gray("DEBUG"),
78
+ [1 /* INFO */]: chalk.cyan("INFO "),
79
+ [2 /* WARN */]: chalk.yellow("WARN "),
80
+ [3 /* ERROR */]: chalk.red("ERROR"),
81
+ [4 /* SILENT */]: ""
82
+ };
83
+ currentLevel = 1 /* INFO */;
84
+ logger = {
85
+ debug: (component, msg, ...args) => log(0 /* DEBUG */, component, msg, ...args),
86
+ info: (component, msg, ...args) => log(1 /* INFO */, component, msg, ...args),
87
+ warn: (component, msg, ...args) => log(2 /* WARN */, component, msg, ...args),
88
+ error: (component, msg, ...args) => log(3 /* ERROR */, component, msg, ...args)
89
+ };
90
+ logger_default = logger;
91
+ }
92
+ });
93
+
94
+ // src/utils/helpers.ts
95
+ var init_helpers = __esm({
96
+ "src/utils/helpers.ts"() {
97
+ "use strict";
98
+ }
99
+ });
100
+
101
+ // src/config/schema.ts
102
+ import { z } from "zod";
103
+ var ProviderConfigSchema, ChannelConfigSchema, SecurityConfigSchema, GatewayConfigSchema, AgentConfigSchema, TitanConfigSchema;
104
+ var init_schema = __esm({
105
+ "src/config/schema.ts"() {
106
+ "use strict";
107
+ init_constants();
108
+ ProviderConfigSchema = z.object({
109
+ apiKey: z.string().optional(),
110
+ baseUrl: z.string().optional(),
111
+ model: z.string().optional(),
112
+ maxTokens: z.number().optional(),
113
+ temperature: z.number().min(0).max(2).optional()
114
+ });
115
+ ChannelConfigSchema = z.object({
116
+ enabled: z.boolean().default(false),
117
+ token: z.string().optional(),
118
+ apiKey: z.string().optional(),
119
+ allowFrom: z.array(z.string()).default([]),
120
+ dmPolicy: z.enum(["pairing", "open", "closed"]).default("pairing")
121
+ });
122
+ SecurityConfigSchema = z.object({
123
+ sandboxMode: z.enum(["host", "docker", "none"]).default(DEFAULT_SANDBOX_MODE),
124
+ allowedTools: z.array(z.string()).default(ALLOWED_TOOLS_DEFAULT),
125
+ deniedTools: z.array(z.string()).default([]),
126
+ maxConcurrentTasks: z.number().default(5),
127
+ commandTimeout: z.number().default(3e4),
128
+ fileSystemAllowlist: z.array(z.string()).default([]),
129
+ networkAllowlist: z.array(z.string()).default(["*"]),
130
+ shield: z.object({
131
+ enabled: z.boolean().default(true),
132
+ mode: z.enum(["standard", "strict"]).default("strict")
133
+ }).default({})
134
+ });
135
+ GatewayConfigSchema = z.object({
136
+ host: z.string().default(DEFAULT_GATEWAY_HOST),
137
+ port: z.number().default(DEFAULT_GATEWAY_PORT),
138
+ webPort: z.number().default(DEFAULT_WEB_PORT),
139
+ auth: z.object({
140
+ mode: z.enum(["none", "token", "password"]).default("token"),
141
+ token: z.string().optional(),
142
+ password: z.string().optional()
143
+ }).default({})
144
+ });
145
+ AgentConfigSchema = z.object({
146
+ model: z.string().default(DEFAULT_MODEL),
147
+ maxTokens: z.number().default(DEFAULT_MAX_TOKENS),
148
+ temperature: z.number().default(DEFAULT_TEMPERATURE),
149
+ systemPrompt: z.string().optional(),
150
+ workspace: z.string().optional(),
151
+ thinkingMode: z.enum(["off", "low", "medium", "high"]).default("medium")
152
+ });
153
+ TitanConfigSchema = z.object({
154
+ agent: AgentConfigSchema.default({}),
155
+ providers: z.object({
156
+ anthropic: ProviderConfigSchema.default({}),
157
+ openai: ProviderConfigSchema.default({}),
158
+ google: ProviderConfigSchema.default({}),
159
+ ollama: ProviderConfigSchema.default({})
160
+ }).default({}),
161
+ channels: z.object({
162
+ discord: ChannelConfigSchema.default({}),
163
+ telegram: ChannelConfigSchema.default({}),
164
+ slack: ChannelConfigSchema.default({}),
165
+ whatsapp: ChannelConfigSchema.default({}),
166
+ webchat: ChannelConfigSchema.default({}),
167
+ googlechat: ChannelConfigSchema.default({}),
168
+ matrix: ChannelConfigSchema.default({}),
169
+ signal: ChannelConfigSchema.default({}),
170
+ msteams: ChannelConfigSchema.default({}),
171
+ bluebubbles: ChannelConfigSchema.default({})
172
+ }).default({}),
173
+ gateway: GatewayConfigSchema.default({}),
174
+ security: SecurityConfigSchema.default({}),
175
+ memory: z.object({
176
+ enabled: z.boolean().default(true),
177
+ maxHistoryMessages: z.number().default(50),
178
+ vectorSearchEnabled: z.boolean().default(false)
179
+ }).default({}),
180
+ skills: z.object({
181
+ enabled: z.boolean().default(true),
182
+ autoDiscover: z.boolean().default(true),
183
+ marketplace: z.boolean().default(false)
184
+ }).default({}),
185
+ logging: z.object({
186
+ level: z.enum(["debug", "info", "warn", "error", "silent"]).default("info"),
187
+ file: z.boolean().default(true)
188
+ }).default({}),
189
+ autonomy: z.object({
190
+ /** autonomous = full auto, supervised = asks for dangerous ops, locked = asks for everything */
191
+ mode: z.enum(["autonomous", "supervised", "locked"]).default("supervised"),
192
+ /** Auto-approve moderate-risk tools in main session (cli/webchat) */
193
+ autoApproveMainSession: z.boolean().default(true),
194
+ /** Timeout for HITL approval requests (ms). Auto-deny after timeout. */
195
+ approvalTimeoutMs: z.number().default(6e4),
196
+ /** Notify user of auto-approved actions */
197
+ notifyOnAutoApprove: z.boolean().default(true)
198
+ }).default({})
199
+ });
200
+ }
201
+ });
202
+
203
+ // src/config/config.ts
204
+ var init_config = __esm({
205
+ "src/config/config.ts"() {
206
+ "use strict";
207
+ init_constants();
208
+ init_helpers();
209
+ init_schema();
210
+ init_logger();
211
+ }
212
+ });
213
+
214
+ // src/agent/toolRunner.ts
215
+ function registerTool(handler) {
216
+ toolRegistry.set(handler.name, handler);
217
+ logger_default.debug(COMPONENT, `Registered tool: ${handler.name}`);
218
+ }
219
+ var COMPONENT, toolRegistry;
220
+ var init_toolRunner = __esm({
221
+ "src/agent/toolRunner.ts"() {
222
+ "use strict";
223
+ init_logger();
224
+ init_config();
225
+ COMPONENT = "ToolRunner";
226
+ toolRegistry = /* @__PURE__ */ new Map();
227
+ }
228
+ });
229
+
230
+ // src/skills/registry.ts
231
+ function registerSkill(meta, handler) {
232
+ registeredSkills.set(meta.name, meta);
233
+ registerTool(handler);
234
+ logger_default.debug(COMPONENT2, `Registered skill: ${meta.name} (${meta.source})`);
235
+ }
236
+ var COMPONENT2, registeredSkills;
237
+ var init_registry = __esm({
238
+ "src/skills/registry.ts"() {
239
+ "use strict";
240
+ init_constants();
241
+ init_toolRunner();
242
+ init_helpers();
243
+ init_logger();
244
+ COMPONENT2 = "Skills";
245
+ registeredSkills = /* @__PURE__ */ new Map();
246
+ }
247
+ });
248
+
249
+ // src/skills/builtin/shell.ts
250
+ import { exec } from "child_process";
251
+ function executeCommand(command, cwd, timeout = 3e4) {
252
+ return new Promise((resolve, reject) => {
253
+ const proc = exec(command, {
254
+ cwd: cwd || process.cwd(),
255
+ timeout,
256
+ maxBuffer: 1024 * 1024 * 10,
257
+ // 10MB
258
+ shell: "/bin/bash"
259
+ }, (error, stdout, stderr) => {
260
+ if (error && error.killed) {
261
+ reject(new Error(`Command timed out after ${timeout}ms`));
262
+ return;
263
+ }
264
+ let output = "";
265
+ if (stdout) output += stdout;
266
+ if (stderr) output += (output ? "\n" : "") + `[stderr] ${stderr}`;
267
+ if (error) output += (output ? "\n" : "") + `[exit code: ${error.code}]`;
268
+ if (output.length > 5e4) {
269
+ output = output.slice(0, 25e3) + "\n\n... [output truncated] ...\n\n" + output.slice(-25e3);
270
+ }
271
+ resolve(output || "(no output)");
272
+ });
273
+ });
274
+ }
275
+ function registerShellSkill() {
276
+ registerSkill(
277
+ {
278
+ name: "shell",
279
+ description: "Execute shell commands on the system",
280
+ version: "1.0.0",
281
+ source: "bundled",
282
+ enabled: true
283
+ },
284
+ {
285
+ name: "shell",
286
+ description: "Execute a shell command on the user's system. Use this for running scripts, installing packages, checking system status, compiling code, git operations, and any other command-line task.",
287
+ parameters: {
288
+ type: "object",
289
+ properties: {
290
+ command: {
291
+ type: "string",
292
+ description: "The shell command to execute"
293
+ },
294
+ cwd: {
295
+ type: "string",
296
+ description: "Working directory for the command (optional)"
297
+ },
298
+ timeout: {
299
+ type: "number",
300
+ description: "Timeout in milliseconds (default: 30000)"
301
+ }
302
+ },
303
+ required: ["command"]
304
+ },
305
+ execute: async (args) => {
306
+ const command = args.command;
307
+ const cwd = args.cwd;
308
+ const timeout = args.timeout || 3e4;
309
+ logger_default.info(COMPONENT3, `Executing: ${command}`);
310
+ return await executeCommand(command, cwd, timeout);
311
+ }
312
+ }
313
+ );
314
+ }
315
+ var COMPONENT3;
316
+ var init_shell = __esm({
317
+ "src/skills/builtin/shell.ts"() {
318
+ init_registry();
319
+ init_logger();
320
+ COMPONENT3 = "Shell";
321
+ }
322
+ });
323
+ init_shell();
324
+ export {
325
+ registerShellSkill
326
+ };
327
+ //# sourceMappingURL=shell.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../src/utils/constants.ts","../../../src/utils/logger.ts","../../../src/utils/helpers.ts","../../../src/config/schema.ts","../../../src/config/config.ts","../../../src/agent/toolRunner.ts","../../../src/skills/registry.ts","../../../src/skills/builtin/shell.ts"],"sourcesContent":["/**\n * TITAN Constants\n */\nimport { homedir } from 'os';\nimport { join } from 'path';\n\nexport const TITAN_VERSION = '2026.4.0';\nexport const TITAN_NAME = 'TITAN';\nexport const TITAN_FULL_NAME = 'The Intelligent Task Automation Network';\nexport const TITAN_ASCII_LOGO = `\n╔════════════════════════════════════════════════════╗\n║ ║\n║ ████████╗██╗████████╗ █████╗ ███╗ ██╗ ║\n║ ╚══██╔══╝██║╚══██╔══╝██╔══██╗████╗ ██║ ║\n║ ██║ ██║ ██║ ███████║██╔██╗ ██║ ║\n║ ██║ ██║ ██║ ██╔══██║██║╚██╗██║ ║\n║ ██║ ██║ ██║ ██║ ██║██║ ╚████║ ║\n║ ╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝╚═╝ ╚═══╝ ║\n║ ║\n║ The Intelligent Task Automation Network ║\n║ v${TITAN_VERSION} ║\n╚════════════════════════════════════════════════════╝`;\n\n// Paths\nexport const TITAN_HOME = join(homedir(), '.titan');\nexport const TITAN_CONFIG_PATH = join(TITAN_HOME, 'titan.json');\nexport const TITAN_DB_PATH = join(TITAN_HOME, 'titan.db');\nexport const TITAN_WORKSPACE = join(TITAN_HOME, 'workspace');\nexport const TITAN_SKILLS_DIR = join(TITAN_WORKSPACE, 'skills');\nexport const TITAN_LOGS_DIR = join(TITAN_HOME, 'logs');\nexport const TITAN_MEMORY_DIR = join(TITAN_HOME, 'memory');\n\n// Workspace prompt files (injected into agent context)\nexport const AGENTS_MD = join(TITAN_WORKSPACE, 'AGENTS.md');\nexport const SOUL_MD = join(TITAN_WORKSPACE, 'SOUL.md');\nexport const TOOLS_MD = join(TITAN_WORKSPACE, 'TOOLS.md');\n\n// Gateway defaults\nexport const DEFAULT_GATEWAY_HOST = '127.0.0.1';\nexport const DEFAULT_GATEWAY_PORT = 18789;\nexport const DEFAULT_WEB_PORT = 18790;\n\n// Agent defaults\nexport const DEFAULT_MODEL = 'anthropic/claude-sonnet-4-20250514';\nexport const DEFAULT_MAX_TOKENS = 8192;\nexport const DEFAULT_TEMPERATURE = 0.7;\nexport const MAX_CONTEXT_MESSAGES = 50;\nexport const SESSION_TIMEOUT_MS = 30 * 60 * 1000; // 30 minutes\n\n// Security\nexport const DEFAULT_SANDBOX_MODE = 'host';\nexport const ALLOWED_TOOLS_DEFAULT = [\n 'shell', 'read_file', 'write_file', 'edit_file', 'list_dir',\n 'web_search', 'browser', 'cron', 'webhook', 'email', 'memory',\n];\nexport const DENIED_TOOLS_DEFAULT: string[] = [];\n","/**\n * TITAN Logger — Structured logging with levels and colors\n */\nimport chalk from 'chalk';\n\nexport enum LogLevel {\n DEBUG = 0,\n INFO = 1,\n WARN = 2,\n ERROR = 3,\n SILENT = 4,\n}\n\nconst LEVEL_LABELS: Record<LogLevel, string> = {\n [LogLevel.DEBUG]: chalk.gray('DEBUG'),\n [LogLevel.INFO]: chalk.cyan('INFO '),\n [LogLevel.WARN]: chalk.yellow('WARN '),\n [LogLevel.ERROR]: chalk.red('ERROR'),\n [LogLevel.SILENT]: '',\n};\n\nlet currentLevel: LogLevel = LogLevel.INFO;\n\nexport function setLogLevel(level: LogLevel): void {\n currentLevel = level;\n}\n\nexport function getLogLevel(): LogLevel {\n return currentLevel;\n}\n\nfunction formatTimestamp(): string {\n return chalk.gray(new Date().toISOString().replace('T', ' ').slice(0, 19));\n}\n\nfunction log(level: LogLevel, component: string, message: string, ...args: unknown[]): void {\n if (level < currentLevel) return;\n const prefix = `${formatTimestamp()} ${LEVEL_LABELS[level]} ${chalk.blue(`[${component}]`)}`;\n console.log(`${prefix} ${message}`, ...args);\n}\n\nexport const logger = {\n debug: (component: string, msg: string, ...args: unknown[]) => log(LogLevel.DEBUG, component, msg, ...args),\n info: (component: string, msg: string, ...args: unknown[]) => log(LogLevel.INFO, component, msg, ...args),\n warn: (component: string, msg: string, ...args: unknown[]) => log(LogLevel.WARN, component, msg, ...args),\n error: (component: string, msg: string, ...args: unknown[]) => log(LogLevel.ERROR, component, msg, ...args),\n};\n\nexport default logger;\n","/**\n * TITAN Helper Utilities\n */\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';\nimport { dirname } from 'path';\n\n/** Ensure a directory exists, creating it recursively if needed */\nexport function ensureDir(dirPath: string): void {\n if (!existsSync(dirPath)) {\n mkdirSync(dirPath, { recursive: true });\n }\n}\n\n/** Safely read a JSON file, returning null on failure */\nexport function readJsonFile<T = unknown>(filePath: string): T | null {\n try {\n if (!existsSync(filePath)) return null;\n const content = readFileSync(filePath, 'utf-8');\n return JSON.parse(content) as T;\n } catch {\n return null;\n }\n}\n\n/** Safely write a JSON file, creating parent dirs if needed */\nexport function writeJsonFile(filePath: string, data: unknown): void {\n ensureDir(dirname(filePath));\n writeFileSync(filePath, JSON.stringify(data, null, 2), 'utf-8');\n}\n\n/** Safe string truncation */\nexport function truncate(str: string, maxLength: number): string {\n if (str.length <= maxLength) return str;\n return str.slice(0, maxLength - 3) + '...';\n}\n\n/** Sleep for a given number of milliseconds */\nexport function sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/** Generate a short ID */\nexport function shortId(): string {\n return Math.random().toString(36).slice(2, 10);\n}\n\n/** Format bytes into human-readable string */\nexport function formatBytes(bytes: number): string {\n if (bytes === 0) return '0 B';\n const k = 1024;\n const sizes = ['B', 'KB', 'MB', 'GB'];\n const i = Math.floor(Math.log(bytes) / Math.log(k));\n return `${parseFloat((bytes / Math.pow(k, i)).toFixed(1))} ${sizes[i]}`;\n}\n\n/** Format a duration in ms to human-readable */\nexport function formatDuration(ms: number): string {\n if (ms < 1000) return `${ms}ms`;\n if (ms < 60000) return `${(ms / 1000).toFixed(1)}s`;\n if (ms < 3600000) return `${Math.floor(ms / 60000)}m ${Math.floor((ms % 60000) / 1000)}s`;\n return `${Math.floor(ms / 3600000)}h ${Math.floor((ms % 3600000) / 60000)}m`;\n}\n\n/** Deep merge two objects */\nexport function deepMerge<T extends Record<string, unknown>>(target: T, source: Partial<T>): T {\n const result = { ...target };\n for (const key of Object.keys(source) as Array<keyof T>) {\n const sourceVal = source[key];\n const targetVal = result[key];\n if (\n sourceVal &&\n typeof sourceVal === 'object' &&\n !Array.isArray(sourceVal) &&\n targetVal &&\n typeof targetVal === 'object' &&\n !Array.isArray(targetVal)\n ) {\n result[key] = deepMerge(\n targetVal as Record<string, unknown>,\n sourceVal as Record<string, unknown>,\n ) as T[keyof T];\n } else if (sourceVal !== undefined) {\n result[key] = sourceVal as T[keyof T];\n }\n }\n return result;\n}\n","/**\n * TITAN Configuration Schema — Zod-based validation with full type inference\n */\nimport { z } from 'zod';\nimport {\n DEFAULT_GATEWAY_HOST,\n DEFAULT_GATEWAY_PORT,\n DEFAULT_WEB_PORT,\n DEFAULT_MODEL,\n DEFAULT_MAX_TOKENS,\n DEFAULT_TEMPERATURE,\n DEFAULT_SANDBOX_MODE,\n ALLOWED_TOOLS_DEFAULT,\n} from '../utils/constants.js';\n\nexport const ProviderConfigSchema = z.object({\n apiKey: z.string().optional(),\n baseUrl: z.string().optional(),\n model: z.string().optional(),\n maxTokens: z.number().optional(),\n temperature: z.number().min(0).max(2).optional(),\n});\n\nexport const ChannelConfigSchema = z.object({\n enabled: z.boolean().default(false),\n token: z.string().optional(),\n apiKey: z.string().optional(),\n allowFrom: z.array(z.string()).default([]),\n dmPolicy: z.enum(['pairing', 'open', 'closed']).default('pairing'),\n});\n\nexport const SecurityConfigSchema = z.object({\n sandboxMode: z.enum(['host', 'docker', 'none']).default(DEFAULT_SANDBOX_MODE as 'host'),\n allowedTools: z.array(z.string()).default(ALLOWED_TOOLS_DEFAULT),\n deniedTools: z.array(z.string()).default([]),\n maxConcurrentTasks: z.number().default(5),\n commandTimeout: z.number().default(30000),\n fileSystemAllowlist: z.array(z.string()).default([]),\n networkAllowlist: z.array(z.string()).default(['*']),\n shield: z.object({\n enabled: z.boolean().default(true),\n mode: z.enum(['standard', 'strict']).default('strict'),\n }).default({}),\n});\n\nexport const GatewayConfigSchema = z.object({\n host: z.string().default(DEFAULT_GATEWAY_HOST),\n port: z.number().default(DEFAULT_GATEWAY_PORT),\n webPort: z.number().default(DEFAULT_WEB_PORT),\n auth: z.object({\n mode: z.enum(['none', 'token', 'password']).default('token'),\n token: z.string().optional(),\n password: z.string().optional(),\n }).default({}),\n});\n\nexport const AgentConfigSchema = z.object({\n model: z.string().default(DEFAULT_MODEL),\n maxTokens: z.number().default(DEFAULT_MAX_TOKENS),\n temperature: z.number().default(DEFAULT_TEMPERATURE),\n systemPrompt: z.string().optional(),\n workspace: z.string().optional(),\n thinkingMode: z.enum(['off', 'low', 'medium', 'high']).default('medium'),\n});\n\nexport const TitanConfigSchema = z.object({\n agent: AgentConfigSchema.default({}),\n providers: z.object({\n anthropic: ProviderConfigSchema.default({}),\n openai: ProviderConfigSchema.default({}),\n google: ProviderConfigSchema.default({}),\n ollama: ProviderConfigSchema.default({}),\n }).default({}),\n channels: z.object({\n discord: ChannelConfigSchema.default({}),\n telegram: ChannelConfigSchema.default({}),\n slack: ChannelConfigSchema.default({}),\n whatsapp: ChannelConfigSchema.default({}),\n webchat: ChannelConfigSchema.default({}),\n googlechat: ChannelConfigSchema.default({}),\n matrix: ChannelConfigSchema.default({}),\n signal: ChannelConfigSchema.default({}),\n msteams: ChannelConfigSchema.default({}),\n bluebubbles: ChannelConfigSchema.default({}),\n }).default({}),\n gateway: GatewayConfigSchema.default({}),\n security: SecurityConfigSchema.default({}),\n memory: z.object({\n enabled: z.boolean().default(true),\n maxHistoryMessages: z.number().default(50),\n vectorSearchEnabled: z.boolean().default(false),\n }).default({}),\n skills: z.object({\n enabled: z.boolean().default(true),\n autoDiscover: z.boolean().default(true),\n marketplace: z.boolean().default(false),\n }).default({}),\n logging: z.object({\n level: z.enum(['debug', 'info', 'warn', 'error', 'silent']).default('info'),\n file: z.boolean().default(true),\n }).default({}),\n autonomy: z.object({\n /** autonomous = full auto, supervised = asks for dangerous ops, locked = asks for everything */\n mode: z.enum(['autonomous', 'supervised', 'locked']).default('supervised'),\n /** Auto-approve moderate-risk tools in main session (cli/webchat) */\n autoApproveMainSession: z.boolean().default(true),\n /** Timeout for HITL approval requests (ms). Auto-deny after timeout. */\n approvalTimeoutMs: z.number().default(60000),\n /** Notify user of auto-approved actions */\n notifyOnAutoApprove: z.boolean().default(true),\n }).default({}),\n});\n\nexport type TitanConfig = z.infer<typeof TitanConfigSchema>;\nexport type ProviderConfig = z.infer<typeof ProviderConfigSchema>;\nexport type ChannelConfig = z.infer<typeof ChannelConfigSchema>;\nexport type SecurityConfig = z.infer<typeof SecurityConfigSchema>;\nexport type GatewayConfig = z.infer<typeof GatewayConfigSchema>;\nexport type AgentConfig = z.infer<typeof AgentConfigSchema>;\n","/**\n * TITAN Configuration Manager\n * Loads, validates, and persists configuration from ~/.titan/titan.json\n */\nimport { existsSync } from 'fs';\nimport { TITAN_CONFIG_PATH, TITAN_HOME } from '../utils/constants.js';\nimport { readJsonFile, writeJsonFile, ensureDir, deepMerge } from '../utils/helpers.js';\nimport { TitanConfigSchema, type TitanConfig } from './schema.js';\nimport logger from '../utils/logger.js';\n\nconst COMPONENT = 'Config';\n\nlet cachedConfig: TitanConfig | null = null;\n\n/** Get the default configuration */\nexport function getDefaultConfig(): TitanConfig {\n return TitanConfigSchema.parse({});\n}\n\n/** Load configuration from disk, merging with defaults */\nexport function loadConfig(): TitanConfig {\n if (cachedConfig) return cachedConfig;\n\n ensureDir(TITAN_HOME);\n\n let rawConfig: Record<string, unknown> = {};\n\n if (existsSync(TITAN_CONFIG_PATH)) {\n const loaded = readJsonFile<Record<string, unknown>>(TITAN_CONFIG_PATH);\n if (loaded) {\n rawConfig = loaded;\n logger.debug(COMPONENT, `Loaded config from ${TITAN_CONFIG_PATH}`);\n } else {\n logger.warn(COMPONENT, `Failed to parse config at ${TITAN_CONFIG_PATH}, using defaults`);\n }\n } else {\n logger.info(COMPONENT, 'No config file found, using defaults');\n }\n\n // Apply environment variables\n applyEnvOverrides(rawConfig);\n\n // Validate and merge with defaults via Zod\n const result = TitanConfigSchema.safeParse(rawConfig);\n if (!result.success) {\n logger.warn(COMPONENT, 'Config validation issues, using defaults for invalid fields');\n logger.debug(COMPONENT, result.error.message);\n cachedConfig = getDefaultConfig();\n } else {\n cachedConfig = result.data;\n }\n\n return cachedConfig;\n}\n\n/** Save current configuration to disk */\nexport function saveConfig(config: TitanConfig): void {\n ensureDir(TITAN_HOME);\n writeJsonFile(TITAN_CONFIG_PATH, config);\n cachedConfig = config;\n logger.info(COMPONENT, `Config saved to ${TITAN_CONFIG_PATH}`);\n}\n\n/** Update specific fields in the config */\nexport function updateConfig(partial: Partial<TitanConfig>): TitanConfig {\n const current = loadConfig();\n const updated = deepMerge(current as Record<string, unknown>, partial as Record<string, unknown>) as TitanConfig;\n const validated = TitanConfigSchema.parse(updated);\n saveConfig(validated);\n return validated;\n}\n\n/** Reset config cache (useful for testing) */\nexport function resetConfigCache(): void {\n cachedConfig = null;\n}\n\n/** Check if the configuration file exists */\nexport function configExists(): boolean {\n return existsSync(TITAN_CONFIG_PATH);\n}\n\n/** Apply environment variable overrides to raw config */\nfunction applyEnvOverrides(config: Record<string, unknown>): void {\n const envMap: Record<string, (val: string) => void> = {\n TITAN_MODEL: (val) => setNested(config, 'agent.model', val),\n TITAN_GATEWAY_PORT: (val) => setNested(config, 'gateway.port', parseInt(val, 10)),\n TITAN_GATEWAY_HOST: (val) => setNested(config, 'gateway.host', val),\n TITAN_LOG_LEVEL: (val) => setNested(config, 'logging.level', val),\n ANTHROPIC_API_KEY: (val) => setNested(config, 'providers.anthropic.apiKey', val),\n OPENAI_API_KEY: (val) => setNested(config, 'providers.openai.apiKey', val),\n GOOGLE_API_KEY: (val) => setNested(config, 'providers.google.apiKey', val),\n OLLAMA_BASE_URL: (val) => setNested(config, 'providers.ollama.baseUrl', val),\n DISCORD_TOKEN: (val) => setNested(config, 'channels.discord.token', val),\n TELEGRAM_TOKEN: (val) => setNested(config, 'channels.telegram.token', val),\n SLACK_TOKEN: (val) => setNested(config, 'channels.slack.token', val),\n };\n\n for (const [envKey, setter] of Object.entries(envMap)) {\n const val = process.env[envKey];\n if (val) {\n setter(val);\n logger.debug(COMPONENT, `Applied env override: ${envKey}`);\n }\n }\n}\n\n/** Set a nested property by dot-notation path */\nfunction setNested(obj: Record<string, unknown>, path: string, value: unknown): void {\n const parts = path.split('.');\n let current: Record<string, unknown> = obj;\n for (let i = 0; i < parts.length - 1; i++) {\n if (!current[parts[i]] || typeof current[parts[i]] !== 'object') {\n current[parts[i]] = {};\n }\n current = current[parts[i]] as Record<string, unknown>;\n }\n current[parts[parts.length - 1]] = value;\n}\n","/**\n * TITAN — Tool Runner\n * Executes tool calls from the LLM with sandboxing, timeouts, and result formatting.\n */\nimport type { ToolCall, ToolDefinition } from '../providers/base.js';\nimport logger from '../utils/logger.js';\nimport { loadConfig } from '../config/config.js';\n\nconst COMPONENT = 'ToolRunner';\n\n/** Tool execution result */\nexport interface ToolResult {\n toolCallId: string;\n name: string;\n content: string;\n success: boolean;\n durationMs: number;\n}\n\n/** A registered tool handler */\nexport interface ToolHandler {\n name: string;\n description: string;\n parameters: Record<string, unknown>;\n execute: (args: Record<string, unknown>) => Promise<string>;\n}\n\n/** Global tool registry */\nconst toolRegistry: Map<string, ToolHandler> = new Map();\n\n/** Register a tool */\nexport function registerTool(handler: ToolHandler): void {\n toolRegistry.set(handler.name, handler);\n logger.debug(COMPONENT, `Registered tool: ${handler.name}`);\n}\n\n/** Unregister a tool */\nexport function unregisterTool(name: string): void {\n toolRegistry.delete(name);\n}\n\n/** Get all registered tools */\nexport function getRegisteredTools(): ToolHandler[] {\n return Array.from(toolRegistry.values());\n}\n\n/** Convert registered tools to LLM tool definitions */\nexport function getToolDefinitions(): ToolDefinition[] {\n const config = loadConfig();\n const allowed = new Set(config.security.allowedTools);\n const denied = new Set(config.security.deniedTools);\n\n return Array.from(toolRegistry.values())\n .filter((tool) => {\n if (denied.has(tool.name)) return false;\n if (allowed.size > 0 && !allowed.has(tool.name)) return false;\n return true;\n })\n .map((tool) => ({\n type: 'function' as const,\n function: {\n name: tool.name,\n description: tool.description,\n parameters: tool.parameters,\n },\n }));\n}\n\n/** Execute a single tool call */\nexport async function executeTool(toolCall: ToolCall): Promise<ToolResult> {\n const config = loadConfig();\n const startTime = Date.now();\n const handler = toolRegistry.get(toolCall.function.name);\n\n if (!handler) {\n return {\n toolCallId: toolCall.id,\n name: toolCall.function.name,\n content: `Error: Unknown tool \"${toolCall.function.name}\"`,\n success: false,\n durationMs: Date.now() - startTime,\n };\n }\n\n // Check permissions\n if (config.security.deniedTools.includes(handler.name)) {\n return {\n toolCallId: toolCall.id,\n name: handler.name,\n content: `Error: Tool \"${handler.name}\" is denied by security policy`,\n success: false,\n durationMs: Date.now() - startTime,\n };\n }\n\n try {\n // Parse arguments\n let args: Record<string, unknown> = {};\n try {\n args = JSON.parse(toolCall.function.arguments);\n } catch {\n args = {};\n }\n\n logger.info(COMPONENT, `Executing tool: ${handler.name}`);\n\n // Execute with timeout\n const timeout = config.security.commandTimeout || 30000;\n const result = await Promise.race([\n handler.execute(args),\n new Promise<string>((_, reject) =>\n setTimeout(() => reject(new Error(`Tool \"${handler.name}\" timed out after ${timeout}ms`)), timeout)\n ),\n ]);\n\n const durationMs = Date.now() - startTime;\n logger.info(COMPONENT, `Tool ${handler.name} completed in ${durationMs}ms`);\n\n return {\n toolCallId: toolCall.id,\n name: handler.name,\n content: result,\n success: true,\n durationMs,\n };\n } catch (error) {\n const durationMs = Date.now() - startTime;\n const errorMsg = (error as Error).message;\n logger.error(COMPONENT, `Tool ${handler.name} failed: ${errorMsg}`);\n\n return {\n toolCallId: toolCall.id,\n name: handler.name,\n content: `Error: ${errorMsg}`,\n success: false,\n durationMs,\n };\n }\n}\n\n/** Execute multiple tool calls (in parallel where possible) */\nexport async function executeTools(toolCalls: ToolCall[]): Promise<ToolResult[]> {\n const config = loadConfig();\n const maxConcurrent = config.security.maxConcurrentTasks || 5;\n\n // Execute in batches\n const results: ToolResult[] = [];\n for (let i = 0; i < toolCalls.length; i += maxConcurrent) {\n const batch = toolCalls.slice(i, i + maxConcurrent);\n const batchResults = await Promise.all(batch.map(executeTool));\n results.push(...batchResults);\n }\n\n return results;\n}\n","/**\n * TITAN — Skills Registry\n * Discovers, loads, and manages skills from bundled, workspace, and marketplace sources.\n */\nimport { existsSync, readdirSync, readFileSync } from 'fs';\nimport { join } from 'path';\nimport { TITAN_HOME, TITAN_SKILLS_DIR } from '../utils/constants.js';\nimport { registerTool, type ToolHandler } from '../agent/toolRunner.js';\nimport { ensureDir } from '../utils/helpers.js';\nimport logger from '../utils/logger.js';\n\nconst COMPONENT = 'Skills';\n\nexport interface SkillMeta {\n name: string;\n description: string;\n version: string;\n author?: string;\n source: 'bundled' | 'workspace' | 'marketplace';\n enabled: boolean;\n}\n\nconst registeredSkills: Map<string, SkillMeta> = new Map();\n\n/** Register a built-in skill (tool handler + metadata) */\nexport function registerSkill(meta: SkillMeta, handler: ToolHandler): void {\n registeredSkills.set(meta.name, meta);\n registerTool(handler);\n logger.debug(COMPONENT, `Registered skill: ${meta.name} (${meta.source})`);\n}\n\n/** Get all registered skills */\nexport function getSkills(): SkillMeta[] {\n return Array.from(registeredSkills.values());\n}\n\n/** Get a skill by name */\nexport function getSkill(name: string): SkillMeta | undefined {\n return registeredSkills.get(name);\n}\n\n/** Discover workspace skills from ~/.titan/workspace/skills/ */\nexport function discoverWorkspaceSkills(): SkillMeta[] {\n ensureDir(TITAN_SKILLS_DIR);\n const discovered: SkillMeta[] = [];\n\n if (!existsSync(TITAN_SKILLS_DIR)) return discovered;\n\n const entries = readdirSync(TITAN_SKILLS_DIR, { withFileTypes: true });\n for (const entry of entries) {\n if (!entry.isDirectory()) continue;\n\n const skillDir = join(TITAN_SKILLS_DIR, entry.name);\n const skillMdPath = join(skillDir, 'SKILL.md');\n\n if (!existsSync(skillMdPath)) continue;\n\n try {\n const content = readFileSync(skillMdPath, 'utf-8');\n const meta = parseSkillMd(content, entry.name);\n if (meta) {\n discovered.push({ ...meta, source: 'workspace', enabled: true });\n }\n } catch (error) {\n logger.warn(COMPONENT, `Failed to load skill ${entry.name}: ${(error as Error).message}`);\n }\n }\n\n logger.info(COMPONENT, `Discovered ${discovered.length} workspace skills`);\n return discovered;\n}\n\n/** Parse SKILL.md frontmatter to extract metadata */\nfunction parseSkillMd(content: string, fallbackName: string): Omit<SkillMeta, 'source' | 'enabled'> | null {\n const frontmatterMatch = content.match(/^---\\n([\\s\\S]*?)\\n---/);\n if (!frontmatterMatch) {\n return {\n name: fallbackName,\n description: content.split('\\n')[0] || 'No description',\n version: '1.0.0',\n };\n }\n\n const frontmatter = frontmatterMatch[1];\n const name = frontmatter.match(/name:\\s*(.+)/)?.[1]?.trim() || fallbackName;\n const description = frontmatter.match(/description:\\s*(.+)/)?.[1]?.trim() || 'No description';\n const version = frontmatter.match(/version:\\s*(.+)/)?.[1]?.trim() || '1.0.0';\n const author = frontmatter.match(/author:\\s*(.+)/)?.[1]?.trim();\n\n return { name, description, version, author };\n}\n\n/** Initialize all built-in skills */\nexport async function initBuiltinSkills(): Promise<void> {\n logger.info(COMPONENT, 'Loading built-in skills...');\n\n // Import and register built-in skills\n const { registerShellSkill } = await import('./builtin/shell.js');\n const { registerFilesystemSkill } = await import('./builtin/filesystem.js');\n const { registerWebSearchSkill } = await import('./builtin/web_search.js');\n const { registerCronSkill } = await import('./builtin/cron.js');\n const { registerWebhookSkill } = await import('./builtin/webhook.js');\n const { registerMemorySkill } = await import('./builtin/memory_skill.js');\n const { registerBrowserSkill } = await import('./builtin/browser.js');\n const { registerSessionsSkill } = await import('./builtin/sessions.js');\n const { registerProcessSkill } = await import('./builtin/process.js');\n const { registerWebFetchSkill } = await import('./builtin/web_fetch.js');\n const { registerApplyPatchSkill } = await import('./builtin/apply_patch.js');\n const { registerAutoGenerateSkill } = await import('./builtin/auto_generate.js');\n const { registerVisionSkill } = await import('./builtin/vision.js');\n const { registerVoiceSkills } = await import('./builtin/voice.js');\n\n registerShellSkill();\n registerFilesystemSkill();\n registerWebSearchSkill();\n registerCronSkill();\n registerWebhookSkill();\n registerMemorySkill();\n registerBrowserSkill();\n registerSessionsSkill();\n registerProcessSkill();\n registerWebFetchSkill();\n registerApplyPatchSkill();\n registerAutoGenerateSkill();\n registerVisionSkill();\n registerVoiceSkills();\n\n logger.info(COMPONENT, `Loaded ${registeredSkills.size} built-in skills`);\n}\n\n/** \n * Discover and load auto-generated skills from ~/.titan/skills/auto/\n */\nexport async function loadAutoSkills(): Promise<void> {\n const autoDir = join(TITAN_HOME, 'skills', 'auto');\n if (!existsSync(autoDir)) return;\n\n logger.info(COMPONENT, 'Checking for auto-generated skills...');\n const files = readdirSync(autoDir).filter(f => f.endsWith('.js'));\n\n let loadedCount = 0;\n for (const file of files) {\n try {\n const skillPath = join(autoDir, file);\n // Append cache buster to force hot-reload of ES modules\n const modulePath = `file://${skillPath}?t=${Date.now()}`;\n const mod = await import(modulePath);\n\n if (mod.default && mod.default.name && mod.default.execute) {\n const handler = mod.default as ToolHandler;\n\n // Add to our registry metadata\n const meta: SkillMeta = {\n name: handler.name,\n description: handler.description || 'Auto-generated skill',\n version: '1.0.0',\n source: 'workspace', // Consider it part of user workspace\n enabled: true,\n };\n\n registerSkill(meta, handler);\n loadedCount++;\n }\n } catch (e: any) {\n logger.error(COMPONENT, `Failed to load auto skill ${file}: ${e.message}`);\n }\n }\n\n if (loadedCount > 0) {\n logger.info(COMPONENT, `Successfully loaded ${loadedCount} auto-generated skills`);\n }\n}\n","/**\n * TITAN — Shell Skill (Built-in)\n * Execute shell commands with sandboxing and output capture.\n */\nimport { exec } from 'child_process';\nimport { registerSkill } from '../registry.js';\nimport logger from '../../utils/logger.js';\n\nconst COMPONENT = 'Shell';\n\n/** Execute a shell command and return output */\nfunction executeCommand(command: string, cwd?: string, timeout: number = 30000): Promise<string> {\n return new Promise((resolve, reject) => {\n const proc = exec(command, {\n cwd: cwd || process.cwd(),\n timeout,\n maxBuffer: 1024 * 1024 * 10, // 10MB\n shell: '/bin/bash',\n }, (error, stdout, stderr) => {\n if (error && error.killed) {\n reject(new Error(`Command timed out after ${timeout}ms`));\n return;\n }\n\n let output = '';\n if (stdout) output += stdout;\n if (stderr) output += (output ? '\\n' : '') + `[stderr] ${stderr}`;\n if (error) output += (output ? '\\n' : '') + `[exit code: ${error.code}]`;\n\n // Truncate very long output\n if (output.length > 50000) {\n output = output.slice(0, 25000) + '\\n\\n... [output truncated] ...\\n\\n' + output.slice(-25000);\n }\n\n resolve(output || '(no output)');\n });\n });\n}\n\nexport function registerShellSkill(): void {\n registerSkill(\n {\n name: 'shell',\n description: 'Execute shell commands on the system',\n version: '1.0.0',\n source: 'bundled',\n enabled: true,\n },\n {\n name: 'shell',\n description: 'Execute a shell command on the user\\'s system. Use this for running scripts, installing packages, checking system status, compiling code, git operations, and any other command-line task.',\n parameters: {\n type: 'object',\n properties: {\n command: {\n type: 'string',\n description: 'The shell command to execute',\n },\n cwd: {\n type: 'string',\n description: 'Working directory for the command (optional)',\n },\n timeout: {\n type: 'number',\n description: 'Timeout in milliseconds (default: 30000)',\n },\n },\n required: ['command'],\n },\n execute: async (args) => {\n const command = args.command as string;\n const cwd = args.cwd as string | undefined;\n const timeout = (args.timeout as number) || 30000;\n\n logger.info(COMPONENT, `Executing: ${command}`);\n return await executeCommand(command, cwd, timeout);\n },\n },\n );\n}\n"],"mappings":"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","names":["COMPONENT","COMPONENT"]}