alibabacloud-agentcore-sdk 0.1.0

package/dist/chunk-A3WMLVJC.cjs

@@ -0,0 +1,141 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+var _chunkEGUKJE3Zcjs = require('./chunk-EGUKJE3Z.cjs');
+
+
+var _chunkLE5P3SJWcjs = require('./chunk-LE5P3SJW.cjs');
+
+
+var _chunkJSP7ZROScjs = require('./chunk-JSP7ZROS.cjs');
+
+// src/skill/tools.ts
+var _child_process = require('child_process');
+var _promises = require('fs/promises');
+var _path = require('path');
+function skillTools(skills, options = {}) {
+  const timeout = _nullishCoalesce(options.commandTimeoutSeconds, () => ( 300));
+  if (!Number.isInteger(timeout) || timeout <= 0) throw new (0, _chunkJSP7ZROScjs.ConfigError)("command timeout must be a positive integer");
+  const selected = new Map(skills.map((skill) => [skill.name, skill]));
+  if (selected.size !== skills.length) throw new (0, _chunkJSP7ZROScjs.ConfigError)("selected Skills must have unique names");
+  const missing = (name) => JSON.stringify({ error: `Skill '${String(name)}' not found. Available skills: ${[...selected.keys()].join(", ") || "none"}` });
+  const tools = [new (0, _chunkEGUKJE3Zcjs.Tool)({
+    name: "load_skills",
+    description: `Load skill instructions for the agent. Call without arguments to list all available skills, or with a skill name to get detailed instructions.
+
+Available skills:
+${skills.map((s) => `- ${s.name}: ${s.description}`).join("\n")}`,
+    parameters: { type: "object", properties: { name: { type: "string", description: "The name of the skill to load. If omitted, returns all available skills." } } },
+    invoke: async ({ name }) => {
+      if (name === void 0 || name === null || name === "") return JSON.stringify({ skills: skills.map(({ name: name2, description }) => ({ name: name2, description })) });
+      const skill = typeof name === "string" ? selected.get(name) : void 0;
+      if (!skill) return missing(name);
+      return JSON.stringify({ name: skill.name, description: skill.description, instruction: skill.instruction, files: await list(skill.root) });
+    }
+  }), new (0, _chunkEGUKJE3Zcjs.Tool)({
+    name: "read_skill_file",
+    description: "Read a file from a skill's directory, or list the directory when the relative path points to a directory.",
+    parameters: { type: "object", properties: { name: { type: "string" }, relative_path: { type: "string" } }, required: ["name", "relative_path"] },
+    invoke: async ({ name, relative_path: resource }) => {
+      const skill = typeof name === "string" ? selected.get(name) : void 0;
+      if (!skill) return missing(name);
+      if (typeof resource !== "string") return JSON.stringify({ error: "relative_path must be a string" });
+      try {
+        if (_path.isAbsolute.call(void 0, resource) || resource.split(/[\\/]/).includes("..")) throw new Error("Path is outside the skill directory. Access denied.");
+        const path = _path.join.call(void 0, skill.root, resource);
+        const target = await _promises.realpath.call(void 0, path);
+        const root = await _promises.realpath.call(void 0, skill.root);
+        const relation = _path.relative.call(void 0, root, target);
+        if (relation === ".." || relation.startsWith(`..${_path.sep}`) || _path.isAbsolute.call(void 0, relation) || (await _promises.lstat.call(void 0, path)).isSymbolicLink()) throw new Error("Path is outside the skill directory. Access denied.");
+        if ((await _promises.stat.call(void 0, path)).isDirectory()) return JSON.stringify({ files: await list(path) });
+        return JSON.stringify({ content: new TextDecoder("utf8", { fatal: true }).decode(await _promises.readFile.call(void 0, path)) });
+      } catch (error) {
+        return JSON.stringify({ error: error instanceof Error ? error.message : "Failed to read skill file" });
+      }
+    }
+  })];
+  if ((_nullishCoalesce(process.env.ALLOW_EXECUTE_COMMAND, () => ( "true"))).toLowerCase() !== "false") tools.push(new (0, _chunkEGUKJE3Zcjs.Tool)({
+    name: "execute_command",
+    description: "Execute a shell command in the Agent container for a selected Skill. Before calling this tool, display the exact command and ask the user for confirmation. Returns stdout, stderr, exit_code, and timeout status.",
+    parameters: { type: "object", properties: { command: { type: "string" }, cwd: { type: "string", description: "Optional working directory." }, timeout: { type: "integer", description: "Optional timeout in seconds." } }, required: ["command"] },
+    invoke: (args) => execute(args, defaultDirectory(skills), timeout, options)
+  }));
+  return tools;
+}
+async function list(root) {
+  return (await _promises.readdir.call(void 0, root, { withFileTypes: true })).filter((e) => !e.name.startsWith(".")).map((e) => e.name + (e.isDirectory() ? "/" : "")).sort();
+}
+function defaultDirectory(skills) {
+  if (skills.length === 1) return skills[0].root;
+  if (skills.length && skills[0].workspaceId && skills.every((s) => s.source === "agentcore" && s.workspaceId === skills[0].workspaceId)) {
+    let common = _path.resolve.call(void 0, skills[0].root);
+    for (const skill of skills.slice(1)) while (_path.relative.call(void 0, common, skill.root).startsWith(`..${_path.sep}`) || _path.relative.call(void 0, common, skill.root) === "..") common = _path.dirname.call(void 0, common);
+    return common;
+  }
+  if (skills.length && skills.every((s) => _path.dirname.call(void 0, s.root) === _path.dirname.call(void 0, skills[0].root))) return _path.dirname.call(void 0, skills[0].root);
+  return process.cwd();
+}
+async function execute(args, defaultCwd, defaultTimeout, options) {
+  const { command, cwd = defaultCwd, timeout = defaultTimeout } = args;
+  if (typeof command !== "string" || !command) return JSON.stringify({ error: "command must be a non-empty string" });
+  if (typeof timeout !== "number" || !Number.isInteger(timeout) || timeout <= 0) return JSON.stringify({ error: "timeout must be a positive integer" });
+  try {
+    if (typeof cwd !== "string" || !(await _promises.stat.call(void 0, cwd)).isDirectory()) throw new Error("Working directory does not exist");
+    if (options.commandApproval && !await options.commandApproval(command, cwd)) return JSON.stringify({ error: "Command execution rejected by user." });
+    const logger = _nullishCoalesce(options.logger, () => ( _chunkLE5P3SJWcjs.nullLogger));
+    logger.info("agentcore.skill.command.started", { cwd, timeout_seconds: timeout });
+    const result = await runCommand(command, cwd, timeout);
+    logger.info("agentcore.skill.command.completed", { cwd, exit_code: result.exit_code, timed_out: result.timed_out });
+    return JSON.stringify(result);
+  } catch (error) {
+    return JSON.stringify({ error: error instanceof Error ? error.message : "Failed to execute command" });
+  }
+}
+function runCommand(command, cwd, timeout) {
+  return new Promise((accept, reject) => {
+    const child = _child_process.spawn.call(void 0, command, { shell: true, cwd, detached: process.platform !== "win32", stdio: ["ignore", "pipe", "pipe"] });
+    const limit = 100 * 1024;
+    const output = [Buffer.alloc(0), Buffer.alloc(0)];
+    const truncated = [false, false];
+    for (const [index, stream] of [child.stdout, child.stderr].entries()) stream.on("data", (chunk) => {
+      const remaining = limit - output[index].length;
+      if (chunk.length > remaining) truncated[index] = true;
+      if (remaining > 0) output[index] = Buffer.concat([output[index], chunk.subarray(0, remaining)]);
+    });
+    let timedOut = false;
+    let killTimer;
+    const signal = (value) => {
+      if (!child.pid) return;
+      try {
+        if (process.platform === "win32") child.kill(value);
+        else process.kill(-child.pid, value);
+      } catch (error) {
+        if (error.code !== "ESRCH") child.kill(value);
+      }
+    };
+    const timer = setTimeout(() => {
+      timedOut = true;
+      signal("SIGTERM");
+      killTimer = setTimeout(() => signal("SIGKILL"), 100);
+    }, timeout * 1e3);
+    child.on("error", (error) => {
+      clearTimeout(timer);
+      clearTimeout(killTimer);
+      reject(error);
+    });
+    child.on("close", (code) => {
+      clearTimeout(timer);
+      if (timedOut) {
+        clearTimeout(killTimer);
+        signal("SIGKILL");
+      }
+      const text = (index) => output[index].toString("utf8") + (truncated[index] ? `
+... [output truncated, exceeded ${limit} bytes]` : "");
+      accept(timedOut ? { stdout: "", stderr: `Command timed out after ${timeout} seconds.`, exit_code: -1, timed_out: true } : { stdout: text(0), stderr: text(1), exit_code: _nullishCoalesce(code, () => ( -1)), timed_out: false });
+    });
+  });
+}
+
+
+
+exports.skillTools = skillTools;
+//# sourceMappingURL=chunk-A3WMLVJC.cjs.map

package/dist/chunk-A3WMLVJC.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/zhuoguang/Documents/Code/collaborate/hiclaw/agentcore-sdk-nodejs/dist/chunk-A3WMLVJC.cjs","../src/skill/tools.ts"],"names":["name"],"mappings":"AAAA;AACE;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACA;ACVA,8CAAsB;AACtB,uCAAyD;AACzD,4BAAkE;AAW3D,SAAS,UAAA,CAAW,MAAA,EAA0B,QAAA,EAA6B,CAAC,CAAA,EAAW;AAC5F,EAAA,MAAM,QAAA,mBAAU,OAAA,CAAQ,qBAAA,UAAyB,KAAA;AACjD,EAAA,GAAA,CAAI,CAAC,MAAA,CAAO,SAAA,CAAU,OAAO,EAAA,GAAK,QAAA,GAAW,CAAA,EAAG,MAAM,IAAI,kCAAA,CAAY,4CAA4C,CAAA;AAClH,EAAA,MAAM,SAAA,EAAW,IAAI,GAAA,CAAI,MAAA,CAAO,GAAA,CAAI,CAAC,KAAA,EAAA,GAAU,CAAC,KAAA,CAAM,IAAA,EAAM,KAAK,CAAC,CAAC,CAAA;AACnE,EAAA,GAAA,CAAI,QAAA,CAAS,KAAA,IAAS,MAAA,CAAO,MAAA,EAAQ,MAAM,IAAI,kCAAA,CAAY,wCAAwC,CAAA;AACnG,EAAA,MAAM,QAAA,EAAU,CAAC,IAAA,EAAA,GAAkB,IAAA,CAAK,SAAA,CAAU,EAAE,KAAA,EAAO,CAAA,OAAA,EAAU,MAAA,CAAO,IAAI,CAAC,CAAA,+BAAA,EAAkC,CAAC,GAAG,QAAA,CAAS,IAAA,CAAK,CAAC,CAAA,CAAE,IAAA,CAAK,IAAI,EAAA,GAAK,MAAM,CAAA,EAAA;AACpI,EAAA;AAChB,IAAA;AAA4B,IAAA;AAAA;AAAA;AAAqO;AACtL,IAAA;AACrD,IAAA;AACuGA,MAAAA;AACnE,MAAA;AAC/B,MAAA;AAC0G,MAAA;AAC3I,IAAA;AACW,EAAA;AACL,IAAA;AAAgC,IAAA;AACyG,IAAA;AAC1F,IAAA;AACW,MAAA;AAC/B,MAAA;AACoE,MAAA;AAC/F,MAAA;AACuI,QAAA;AACnG,QAAA;AAAqC,QAAA;AAAyC,QAAA;AAC9E,QAAA;AACoG,QAAA;AACnD,QAAA;AACiB,QAAA;AAC1F,MAAA;AAAuG,QAAA;AAAG,MAAA;AAC5H,IAAA;AACA,EAAA;AAC+F,EAAA;AACzF,IAAA;AAAgC,IAAA;AACwG,IAAA;AACpE,IAAA;AAC1E,EAAA;AACK,EAAA;AACT;AACqD;AACiG,EAAA;AACtJ;AAC4D;AACf,EAAA;AAC+F,EAAA;AACpG,IAAA;AACsG,IAAA;AACnI,IAAA;AACT,EAAA;AACsH,EAAA;AACnG,EAAA;AACrB;AACqI;AACnE,EAAA;AACkD,EAAA;AACkC,EAAA;AAChJ,EAAA;AACiH,IAAA;AAC+B,IAAA;AACjH,IAAA;AAC+C,IAAA;AAC3B,IAAA;AAC6D,IAAA;AACtF,IAAA;AACd,EAAA;AAAuG,IAAA;AAAG,EAAA;AAC5H;AACuJ;AAC9G,EAAA;AACuF,IAAA;AACxG,IAAA;AAC4B,IAAA;AAAkC,IAAA;AACyB,IAAA;AAChE,MAAA;AACQ,MAAA;AAC8C,MAAA;AAChG,IAAA;AACc,IAAA;AAAW,IAAA;AACgB,IAAA;AACxB,MAAA;AACZ,MAAA;AAAoD,QAAA;AAAsC,QAAA;AAChF,MAAA;AAAyE,QAAA;AAAG,MAAA;AAC5F,IAAA;AAC+B,IAAA;AAAa,MAAA;AAAsB,MAAA;AAAsD,MAAA;AAAoB,IAAA;AAC/G,IAAA;AAAoB,MAAA;AAAyB,MAAA;AAAe,MAAA;AAAI,IAAA;AACjE,IAAA;AACR,MAAA;AAEJ,MAAA;AAAwB,QAAA;AAAmB,QAAA;AAAG,MAAA;AAC0B,MAAA;AAAsD,gCAAA;AAErH,MAAA;AACxB,IAAA;AACF,EAAA;AACH;AD8BsJ;AACA;AACA;AACA","file":"/Users/zhuoguang/Documents/Code/collaborate/hiclaw/agentcore-sdk-nodejs/dist/chunk-A3WMLVJC.cjs","sourcesContent":[null,"import { spawn } from 'node:child_process';\nimport { lstat, readFile, readdir, realpath, stat } from 'node:fs/promises';\nimport { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';\nimport { ConfigError } from '../errors';\nimport { Tool, type ToolArguments } from '../integrations/common';\nimport { nullLogger, type Logger } from '../logging';\nimport type { Skill } from './loader';\n\nexport interface SkillToolsOptions {\n  commandApproval?: (command: string, cwd: string) => boolean | Promise<boolean>;\n  commandTimeoutSeconds?: number;\n  logger?: Logger;\n}\nexport function skillTools(skills: readonly Skill[], options: SkillToolsOptions = {}): Tool[] {\n  const timeout = options.commandTimeoutSeconds ?? 300;\n  if (!Number.isInteger(timeout) || timeout <= 0) throw new ConfigError('command timeout must be a positive integer');\n  const selected = new Map(skills.map((skill) => [skill.name, skill]));\n  if (selected.size !== skills.length) throw new ConfigError('selected Skills must have unique names');\n  const missing = (name: unknown) => JSON.stringify({ error: `Skill '${String(name)}' not found. Available skills: ${[...selected.keys()].join(', ') || 'none'}` });\n  const tools = [new Tool({\n    name: 'load_skills', description: `Load skill instructions for the agent. Call without arguments to list all available skills, or with a skill name to get detailed instructions.\\n\\nAvailable skills:\\n${skills.map((s) => `- ${s.name}: ${s.description}`).join('\\n')}`,\n    parameters: { type: 'object', properties: { name: { type: 'string', description: 'The name of the skill to load. If omitted, returns all available skills.' } } },\n    invoke: async ({ name }) => {\n      if (name === undefined || name === null || name === '') return JSON.stringify({ skills: skills.map(({ name, description }) => ({ name, description })) });\n      const skill = typeof name === 'string' ? selected.get(name) : undefined;\n      if (!skill) return missing(name);\n      return JSON.stringify({ name: skill.name, description: skill.description, instruction: skill.instruction, files: await list(skill.root) });\n    },\n  }), new Tool({\n    name: 'read_skill_file', description: \"Read a file from a skill's directory, or list the directory when the relative path points to a directory.\",\n    parameters: { type: 'object', properties: { name: { type: 'string' }, relative_path: { type: 'string' } }, required: ['name', 'relative_path'] },\n    invoke: async ({ name, relative_path: resource }) => {\n      const skill = typeof name === 'string' ? selected.get(name) : undefined;\n      if (!skill) return missing(name);\n      if (typeof resource !== 'string') return JSON.stringify({ error: 'relative_path must be a string' });\n      try {\n        if (isAbsolute(resource) || resource.split(/[\\\\/]/).includes('..')) throw new Error('Path is outside the skill directory. Access denied.');\n        const path = join(skill.root, resource); const target = await realpath(path); const root = await realpath(skill.root);\n        const relation = relative(root, target);\n        if (relation === '..' || relation.startsWith(`..${sep}`) || isAbsolute(relation) || (await lstat(path)).isSymbolicLink()) throw new Error('Path is outside the skill directory. Access denied.');\n        if ((await stat(path)).isDirectory()) return JSON.stringify({ files: await list(path) });\n        return JSON.stringify({ content: new TextDecoder('utf8', { fatal: true }).decode(await readFile(path)) });\n      } catch (error) { return JSON.stringify({ error: error instanceof Error ? error.message : 'Failed to read skill file' }); }\n    },\n  })];\n  if ((process.env.ALLOW_EXECUTE_COMMAND ?? 'true').toLowerCase() !== 'false') tools.push(new Tool({\n    name: 'execute_command', description: 'Execute a shell command in the Agent container for a selected Skill. Before calling this tool, display the exact command and ask the user for confirmation. Returns stdout, stderr, exit_code, and timeout status.',\n    parameters: { type: 'object', properties: { command: { type: 'string' }, cwd: { type: 'string', description: 'Optional working directory.' }, timeout: { type: 'integer', description: 'Optional timeout in seconds.' } }, required: ['command'] },\n    invoke: (args) => execute(args, defaultDirectory(skills), timeout, options),\n  }));\n  return tools;\n}\nasync function list(root: string): Promise<string[]> {\n  return (await readdir(root, { withFileTypes: true })).filter((e) => !e.name.startsWith('.')).map((e) => e.name + (e.isDirectory() ? '/' : '')).sort();\n}\nfunction defaultDirectory(skills: readonly Skill[]): string {\n  if (skills.length === 1) return skills[0]!.root;\n  if (skills.length && skills[0]!.workspaceId && skills.every((s) => s.source === 'agentcore' && s.workspaceId === skills[0]!.workspaceId)) {\n    let common = resolve(skills[0]!.root);\n    for (const skill of skills.slice(1)) while (relative(common, skill.root).startsWith(`..${sep}`) || relative(common, skill.root) === '..') common = dirname(common);\n    return common;\n  }\n  if (skills.length && skills.every((s) => dirname(s.root) === dirname(skills[0]!.root))) return dirname(skills[0]!.root);\n  return process.cwd();\n}\nasync function execute(args: ToolArguments, defaultCwd: string, defaultTimeout: number, options: SkillToolsOptions): Promise<string> {\n  const { command, cwd = defaultCwd, timeout = defaultTimeout } = args;\n  if (typeof command !== 'string' || !command) return JSON.stringify({ error: 'command must be a non-empty string' });\n  if (typeof timeout !== 'number' || !Number.isInteger(timeout) || timeout <= 0) return JSON.stringify({ error: 'timeout must be a positive integer' });\n  try {\n    if (typeof cwd !== 'string' || !(await stat(cwd)).isDirectory()) throw new Error('Working directory does not exist');\n    if (options.commandApproval && !await options.commandApproval(command, cwd)) return JSON.stringify({ error: 'Command execution rejected by user.' });\n    const logger = options.logger ?? nullLogger;\n    logger.info('agentcore.skill.command.started', { cwd, timeout_seconds: timeout });\n    const result = await runCommand(command, cwd, timeout);\n    logger.info('agentcore.skill.command.completed', { cwd, exit_code: result.exit_code, timed_out: result.timed_out });\n    return JSON.stringify(result);\n  } catch (error) { return JSON.stringify({ error: error instanceof Error ? error.message : 'Failed to execute command' }); }\n}\nfunction runCommand(command: string, cwd: string, timeout: number): Promise<{ stdout: string; stderr: string; exit_code: number; timed_out: boolean }> {\n  return new Promise((accept, reject) => {\n    const child = spawn(command, { shell: true, cwd, detached: process.platform !== 'win32', stdio: ['ignore', 'pipe', 'pipe'] });\n    const limit = 100 * 1024;\n    const output = [Buffer.alloc(0), Buffer.alloc(0)]; const truncated = [false, false];\n    for (const [index, stream] of [child.stdout, child.stderr].entries()) stream.on('data', (chunk: Buffer) => {\n      const remaining = limit - output[index]!.length;\n      if (chunk.length > remaining) truncated[index] = true;\n      if (remaining > 0) output[index] = Buffer.concat([output[index]!, chunk.subarray(0, remaining)]);\n    });\n    let timedOut = false; let killTimer: ReturnType<typeof setTimeout> | undefined;\n    const signal = (value: NodeJS.Signals) => {\n      if (!child.pid) return;\n      try { if (process.platform === 'win32') child.kill(value); else process.kill(-child.pid, value); }\n      catch (error) { if ((error as NodeJS.ErrnoException).code !== 'ESRCH') child.kill(value); }\n    };\n    const timer = setTimeout(() => { timedOut = true; signal('SIGTERM'); killTimer = setTimeout(() => signal('SIGKILL'), 100); }, timeout * 1000);\n    child.on('error', (error) => { clearTimeout(timer); clearTimeout(killTimer); reject(error); });\n    child.on('close', (code) => {\n      clearTimeout(timer);\n      // Even if the shell exits first, kill any remaining children of a timed-out command.\n      if (timedOut) { clearTimeout(killTimer); signal('SIGKILL'); }\n      const text = (index: number) => output[index]!.toString('utf8') + (truncated[index] ? `\\n... [output truncated, exceeded ${limit} bytes]` : '');\n      accept(timedOut ? { stdout: '', stderr: `Command timed out after ${timeout} seconds.`, exit_code: -1, timed_out: true }\n        : { stdout: text(0), stderr: text(1), exit_code: code ?? -1, timed_out: false });\n    });\n  });\n}\n"]}