@serviceme/devtools-core 0.1.6 → 0.1.7

package/dist/index.d.mts

@@ -2,6 +2,36 @@ import * as _serviceme_devtools_protocol from '@serviceme/devtools-protocol';
 import { AgentMarketplaceEntry, AgentMutationRequest, AgentPermissionSummary, CopilotDoctorResult, CopilotPromptOptions, CopilotPromptResult, EnvironmentCheckResult, KnownEnvironmentTool, ToolCheckResult, ServiceMeImageValidationResult, ServiceMeImageInfo, ServiceMeImageCompressOptions, ServiceMeImageCompressResult, JsonSortOptions, JsonValidationResult, AgentToolRiskLevel, AgentToolPermission, ServiceMeProjectExtractTemplateInput, ServiceMeProjectExtractTemplateResult, ServiceMeProjectInstallDepsResult, ServiceMeProjectMakeScriptsExecutableResult, ServiceMeProjectGitInitResult, ServiceMeProjectScaffoldPruneResult, TaskExecutionStatus, ScheduledTaskType, TaskPayload, ScheduledTasksConfig, ScheduledTask, TaskStartedEventParams, TaskOutputEventParams, TaskCompletedEventParams, TaskFailedEventParams, TaskCancelledEventParams, TaskExecutionSnapshot, RunningTaskInfo, TaskExecutionLog, SkillMarketplaceEntry, SkillMutationRequest } from '@serviceme/devtools-protocol';
 import * as fs from 'node:fs/promises';
 
+type AgentInstallScope = "workspace" | "user";
+interface InstalledAgent {
+    id: string;
+    name: string;
+    scope: AgentInstallScope;
+    installedAt: string;
+}
+interface AgentsStateFile {
+    schemaVersion: number;
+    installedAgents: InstalledAgent[];
+}
+interface AgentDownloadFile {
+    path: string;
+    content: string;
+    executable?: boolean;
+}
+interface AgentStoreFileSystem {
+    readdir: typeof fs.readdir;
+    readFile: typeof fs.readFile;
+    writeFile: typeof fs.writeFile;
+    mkdir: typeof fs.mkdir;
+    chmod: typeof fs.chmod;
+}
+interface AgentStoreOptions {
+    workspacePath: string;
+    userAgentsRoot: string;
+    fileSystem?: AgentStoreFileSystem;
+    schemaVersion?: number;
+}
+
 interface AgentCatalog {
     agents: AgentMarketplaceEntry[];
     fetchedAt: string;
@@ -15,6 +45,7 @@ declare class AgentCatalogClient {
     private readonly baseUrl?;
     constructor(options?: AgentCatalogClientOptions);
     getCatalog(): Promise<AgentCatalog>;
+    downloadAgent(remoteId: string): Promise<AgentDownloadFile[]>;
 }
 
 interface AgentStoreLike {
@@ -47,36 +78,6 @@ declare class AgentReconciler {
     private hasHighRiskTool;
 }
 
-type AgentInstallScope = "workspace" | "user";
-interface InstalledAgent {
-    id: string;
-    name: string;
-    scope: AgentInstallScope;
-    installedAt: string;
-}
-interface AgentsStateFile {
-    schemaVersion: number;
-    installedAgents: InstalledAgent[];
-}
-interface AgentDownloadFile {
-    path: string;
-    content: string;
-    executable?: boolean;
-}
-interface AgentStoreFileSystem {
-    readdir: typeof fs.readdir;
-    readFile: typeof fs.readFile;
-    writeFile: typeof fs.writeFile;
-    mkdir: typeof fs.mkdir;
-    chmod: typeof fs.chmod;
-}
-interface AgentStoreOptions {
-    workspacePath: string;
-    userAgentsRoot: string;
-    fileSystem?: AgentStoreFileSystem;
-    schemaVersion?: number;
-}
-
 declare class AgentStore {
     private readonly workspacePath;
     private readonly userAgentsRoot;
@@ -166,6 +167,7 @@ declare class ProjectTools {
     makeScriptsExecutable(workspacePath: string): Promise<ServiceMeProjectMakeScriptsExecutableResult>;
     initializeGit(workspacePath: string): Promise<ServiceMeProjectGitInitResult>;
     runScaffoldPrune(workspacePath: string, preset?: string): Promise<ServiceMeProjectScaffoldPruneResult>;
+    private ensurePresetManifest;
     private findScripts;
     private pathExists;
     private selectExtractedDirectory;
@@ -340,6 +342,24 @@ declare class TaskLogManager {
     clearLogs(taskId?: string): number;
 }
 
+interface SkillDownloadFile {
+    path: string;
+    content: string;
+    executable: boolean;
+}
+interface SkillStoreFileSystem {
+    readdir: typeof fs.readdir;
+    readFile: typeof fs.readFile;
+    writeFile: typeof fs.writeFile;
+    mkdir: typeof fs.mkdir;
+    chmod: typeof fs.chmod;
+}
+interface SkillStoreOptions {
+    workspacePath: string;
+    userSkillsRoot: string;
+    fileSystem?: SkillStoreFileSystem;
+}
+
 interface SkillCatalog {
     skills: SkillMarketplaceEntry[];
     fetchedAt: string;
@@ -353,6 +373,7 @@ declare class SkillCatalogClient {
     private readonly baseUrl?;
     constructor(options?: SkillCatalogClientOptions);
     getCatalog(): Promise<SkillCatalog>;
+    downloadSkill(remoteId: string): Promise<SkillDownloadFile[]>;
 }
 
 interface CatalogSkillLike {
@@ -389,18 +410,6 @@ declare class SkillReconciler {
     mutate(request: SkillMutationRequest): Promise<SkillMutateResult>;
 }
 
-interface SkillStoreFileSystem {
-    readdir: typeof fs.readdir;
-    readFile: typeof fs.readFile;
-    writeFile: typeof fs.writeFile;
-    mkdir: typeof fs.mkdir;
-}
-interface SkillStoreOptions {
-    workspacePath: string;
-    userSkillsRoot: string;
-    fileSystem?: SkillStoreFileSystem;
-}
-
 declare class SkillStore {
     private readonly workspacePath;
     private readonly userSkillsRoot;
@@ -414,9 +423,10 @@ declare class SkillStore {
     listUserSkillIds(): Promise<string[]>;
     writeManagedUserSkillMarker(skillId: string): Promise<void>;
     isManagedUserSkill(skillId: string): Promise<boolean>;
+    writeSkillFiles(skillId: string, scope: "workspace" | "user", files: SkillDownloadFile[]): Promise<void>;
 }
 
 declare const unzipFile: (zipPath: string, dest: string) => Promise<void>;
 declare const moveFiles: (sourceDir: string, destDir: string, overwrite?: boolean) => Promise<void>;
 
-export { type AgentCatalog, AgentCatalogClient, type AgentCatalogClientOptions, type AgentDownloadFile, type AgentInstallScope, type AgentMutateResult, AgentReconciler, type AgentReconcilerDependencies, AgentStore, type AgentStoreFileSystem, type AgentStoreOptions, type AgentsStateFile, type AppendLogInput, type CreateTaskInput, DaemonLogger, type EditTaskInput, EnvironmentInspector, type ExecutorResult, GithubCopilotCliExecutor, HttpRequestExecutor, ImageTools, type InstalledAgent, type JsonTools, type OutputEventCallback, PidManager, ProjectTools, SchedulerDaemon, type ServiceMeLogger, ShellExecutor, type SkillCatalog, SkillCatalogClient, type SkillCatalogClientOptions, type SkillMutateResult, SkillReconciler, type SkillReconcilerDependencies, SkillStore, type SkillStoreFileSystem, type SkillStoreOptions, type StreamingExecutorHandle, type StreamingTaskExecutor, TOOL_RISK_MAP, TaskConfigManager, type TaskEventListener, TaskExecutionEngine, type TaskExecutor, TaskLogManager, copilotDoctor, copilotPrompt, createConsoleLogger, createCopilotAuthRequiredError, createCopilotNotInstalledError, createImageTools, createJsonTools, createProjectTools, getExecutor, isCopilotAuthenticated, isStreamingTaskExecutor, matchesCron, moveFiles, noopLogger, parseAgentToolPermissions, parseIntervalMs, resolveTaskExecutionPayload, unzipFile, validateTaskPayload };
+export { type AgentCatalog, AgentCatalogClient, type AgentCatalogClientOptions, type AgentDownloadFile, type AgentInstallScope, type AgentMutateResult, AgentReconciler, type AgentReconcilerDependencies, AgentStore, type AgentStoreFileSystem, type AgentStoreOptions, type AgentsStateFile, type AppendLogInput, type CreateTaskInput, DaemonLogger, type EditTaskInput, EnvironmentInspector, type ExecutorResult, GithubCopilotCliExecutor, HttpRequestExecutor, ImageTools, type InstalledAgent, type JsonTools, type OutputEventCallback, PidManager, ProjectTools, SchedulerDaemon, type ServiceMeLogger, ShellExecutor, type SkillCatalog, SkillCatalogClient, type SkillCatalogClientOptions, type SkillDownloadFile, type SkillMutateResult, SkillReconciler, type SkillReconcilerDependencies, SkillStore, type SkillStoreFileSystem, type SkillStoreOptions, type StreamingExecutorHandle, type StreamingTaskExecutor, TOOL_RISK_MAP, TaskConfigManager, type TaskEventListener, TaskExecutionEngine, type TaskExecutor, TaskLogManager, copilotDoctor, copilotPrompt, createConsoleLogger, createCopilotAuthRequiredError, createCopilotNotInstalledError, createImageTools, createJsonTools, createProjectTools, getExecutor, isCopilotAuthenticated, isStreamingTaskExecutor, matchesCron, moveFiles, noopLogger, parseAgentToolPermissions, parseIntervalMs, resolveTaskExecutionPayload, unzipFile, validateTaskPayload };

package/dist/index.d.ts

@@ -2,6 +2,36 @@ import * as _serviceme_devtools_protocol from '@serviceme/devtools-protocol';
 import { AgentMarketplaceEntry, AgentMutationRequest, AgentPermissionSummary, CopilotDoctorResult, CopilotPromptOptions, CopilotPromptResult, EnvironmentCheckResult, KnownEnvironmentTool, ToolCheckResult, ServiceMeImageValidationResult, ServiceMeImageInfo, ServiceMeImageCompressOptions, ServiceMeImageCompressResult, JsonSortOptions, JsonValidationResult, AgentToolRiskLevel, AgentToolPermission, ServiceMeProjectExtractTemplateInput, ServiceMeProjectExtractTemplateResult, ServiceMeProjectInstallDepsResult, ServiceMeProjectMakeScriptsExecutableResult, ServiceMeProjectGitInitResult, ServiceMeProjectScaffoldPruneResult, TaskExecutionStatus, ScheduledTaskType, TaskPayload, ScheduledTasksConfig, ScheduledTask, TaskStartedEventParams, TaskOutputEventParams, TaskCompletedEventParams, TaskFailedEventParams, TaskCancelledEventParams, TaskExecutionSnapshot, RunningTaskInfo, TaskExecutionLog, SkillMarketplaceEntry, SkillMutationRequest } from '@serviceme/devtools-protocol';
 import * as fs from 'node:fs/promises';
 
+type AgentInstallScope = "workspace" | "user";
+interface InstalledAgent {
+    id: string;
+    name: string;
+    scope: AgentInstallScope;
+    installedAt: string;
+}
+interface AgentsStateFile {
+    schemaVersion: number;
+    installedAgents: InstalledAgent[];
+}
+interface AgentDownloadFile {
+    path: string;
+    content: string;
+    executable?: boolean;
+}
+interface AgentStoreFileSystem {
+    readdir: typeof fs.readdir;
+    readFile: typeof fs.readFile;
+    writeFile: typeof fs.writeFile;
+    mkdir: typeof fs.mkdir;
+    chmod: typeof fs.chmod;
+}
+interface AgentStoreOptions {
+    workspacePath: string;
+    userAgentsRoot: string;
+    fileSystem?: AgentStoreFileSystem;
+    schemaVersion?: number;
+}
+
 interface AgentCatalog {
     agents: AgentMarketplaceEntry[];
     fetchedAt: string;
@@ -15,6 +45,7 @@ declare class AgentCatalogClient {
     private readonly baseUrl?;
     constructor(options?: AgentCatalogClientOptions);
     getCatalog(): Promise<AgentCatalog>;
+    downloadAgent(remoteId: string): Promise<AgentDownloadFile[]>;
 }
 
 interface AgentStoreLike {
@@ -47,36 +78,6 @@ declare class AgentReconciler {
     private hasHighRiskTool;
 }
 
-type AgentInstallScope = "workspace" | "user";
-interface InstalledAgent {
-    id: string;
-    name: string;
-    scope: AgentInstallScope;
-    installedAt: string;
-}
-interface AgentsStateFile {
-    schemaVersion: number;
-    installedAgents: InstalledAgent[];
-}
-interface AgentDownloadFile {
-    path: string;
-    content: string;
-    executable?: boolean;
-}
-interface AgentStoreFileSystem {
-    readdir: typeof fs.readdir;
-    readFile: typeof fs.readFile;
-    writeFile: typeof fs.writeFile;
-    mkdir: typeof fs.mkdir;
-    chmod: typeof fs.chmod;
-}
-interface AgentStoreOptions {
-    workspacePath: string;
-    userAgentsRoot: string;
-    fileSystem?: AgentStoreFileSystem;
-    schemaVersion?: number;
-}
-
 declare class AgentStore {
     private readonly workspacePath;
     private readonly userAgentsRoot;
@@ -166,6 +167,7 @@ declare class ProjectTools {
     makeScriptsExecutable(workspacePath: string): Promise<ServiceMeProjectMakeScriptsExecutableResult>;
     initializeGit(workspacePath: string): Promise<ServiceMeProjectGitInitResult>;
     runScaffoldPrune(workspacePath: string, preset?: string): Promise<ServiceMeProjectScaffoldPruneResult>;
+    private ensurePresetManifest;
     private findScripts;
     private pathExists;
     private selectExtractedDirectory;
@@ -340,6 +342,24 @@ declare class TaskLogManager {
     clearLogs(taskId?: string): number;
 }
 
+interface SkillDownloadFile {
+    path: string;
+    content: string;
+    executable: boolean;
+}
+interface SkillStoreFileSystem {
+    readdir: typeof fs.readdir;
+    readFile: typeof fs.readFile;
+    writeFile: typeof fs.writeFile;
+    mkdir: typeof fs.mkdir;
+    chmod: typeof fs.chmod;
+}
+interface SkillStoreOptions {
+    workspacePath: string;
+    userSkillsRoot: string;
+    fileSystem?: SkillStoreFileSystem;
+}
+
 interface SkillCatalog {
     skills: SkillMarketplaceEntry[];
     fetchedAt: string;
@@ -353,6 +373,7 @@ declare class SkillCatalogClient {
     private readonly baseUrl?;
     constructor(options?: SkillCatalogClientOptions);
     getCatalog(): Promise<SkillCatalog>;
+    downloadSkill(remoteId: string): Promise<SkillDownloadFile[]>;
 }
 
 interface CatalogSkillLike {
@@ -389,18 +410,6 @@ declare class SkillReconciler {
     mutate(request: SkillMutationRequest): Promise<SkillMutateResult>;
 }
 
-interface SkillStoreFileSystem {
-    readdir: typeof fs.readdir;
-    readFile: typeof fs.readFile;
-    writeFile: typeof fs.writeFile;
-    mkdir: typeof fs.mkdir;
-}
-interface SkillStoreOptions {
-    workspacePath: string;
-    userSkillsRoot: string;
-    fileSystem?: SkillStoreFileSystem;
-}
-
 declare class SkillStore {
     private readonly workspacePath;
     private readonly userSkillsRoot;
@@ -414,9 +423,10 @@ declare class SkillStore {
     listUserSkillIds(): Promise<string[]>;
     writeManagedUserSkillMarker(skillId: string): Promise<void>;
     isManagedUserSkill(skillId: string): Promise<boolean>;
+    writeSkillFiles(skillId: string, scope: "workspace" | "user", files: SkillDownloadFile[]): Promise<void>;
 }
 
 declare const unzipFile: (zipPath: string, dest: string) => Promise<void>;
 declare const moveFiles: (sourceDir: string, destDir: string, overwrite?: boolean) => Promise<void>;
 
-export { type AgentCatalog, AgentCatalogClient, type AgentCatalogClientOptions, type AgentDownloadFile, type AgentInstallScope, type AgentMutateResult, AgentReconciler, type AgentReconcilerDependencies, AgentStore, type AgentStoreFileSystem, type AgentStoreOptions, type AgentsStateFile, type AppendLogInput, type CreateTaskInput, DaemonLogger, type EditTaskInput, EnvironmentInspector, type ExecutorResult, GithubCopilotCliExecutor, HttpRequestExecutor, ImageTools, type InstalledAgent, type JsonTools, type OutputEventCallback, PidManager, ProjectTools, SchedulerDaemon, type ServiceMeLogger, ShellExecutor, type SkillCatalog, SkillCatalogClient, type SkillCatalogClientOptions, type SkillMutateResult, SkillReconciler, type SkillReconcilerDependencies, SkillStore, type SkillStoreFileSystem, type SkillStoreOptions, type StreamingExecutorHandle, type StreamingTaskExecutor, TOOL_RISK_MAP, TaskConfigManager, type TaskEventListener, TaskExecutionEngine, type TaskExecutor, TaskLogManager, copilotDoctor, copilotPrompt, createConsoleLogger, createCopilotAuthRequiredError, createCopilotNotInstalledError, createImageTools, createJsonTools, createProjectTools, getExecutor, isCopilotAuthenticated, isStreamingTaskExecutor, matchesCron, moveFiles, noopLogger, parseAgentToolPermissions, parseIntervalMs, resolveTaskExecutionPayload, unzipFile, validateTaskPayload };
+export { type AgentCatalog, AgentCatalogClient, type AgentCatalogClientOptions, type AgentDownloadFile, type AgentInstallScope, type AgentMutateResult, AgentReconciler, type AgentReconcilerDependencies, AgentStore, type AgentStoreFileSystem, type AgentStoreOptions, type AgentsStateFile, type AppendLogInput, type CreateTaskInput, DaemonLogger, type EditTaskInput, EnvironmentInspector, type ExecutorResult, GithubCopilotCliExecutor, HttpRequestExecutor, ImageTools, type InstalledAgent, type JsonTools, type OutputEventCallback, PidManager, ProjectTools, SchedulerDaemon, type ServiceMeLogger, ShellExecutor, type SkillCatalog, SkillCatalogClient, type SkillCatalogClientOptions, type SkillDownloadFile, type SkillMutateResult, SkillReconciler, type SkillReconcilerDependencies, SkillStore, type SkillStoreFileSystem, type SkillStoreOptions, type StreamingExecutorHandle, type StreamingTaskExecutor, TOOL_RISK_MAP, TaskConfigManager, type TaskEventListener, TaskExecutionEngine, type TaskExecutor, TaskLogManager, copilotDoctor, copilotPrompt, createConsoleLogger, createCopilotAuthRequiredError, createCopilotNotInstalledError, createImageTools, createJsonTools, createProjectTools, getExecutor, isCopilotAuthenticated, isStreamingTaskExecutor, matchesCron, moveFiles, noopLogger, parseAgentToolPermissions, parseIntervalMs, resolveTaskExecutionPayload, unzipFile, validateTaskPayload };

package/dist/index.js

@@ -72,6 +72,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/agents/AgentCatalogClient.ts
+var import_devtools_protocol = require("@serviceme/devtools-protocol");
 var AgentCatalogClient = class {
   constructor(options = {}) {
     this.fetchImpl = options.fetchImpl ?? fetch;
@@ -96,6 +97,30 @@ var AgentCatalogClient = class {
       fetchedAt: (/* @__PURE__ */ new Date()).toISOString()
     };
   }
+  async downloadAgent(remoteId) {
+    if (!this.baseUrl) {
+      throw (0, import_devtools_protocol.createServicemeError)(
+        "workspace_not_found",
+        "Agent catalog baseUrl is not configured."
+      );
+    }
+    const response = await this.fetchImpl(
+      `${this.baseUrl}/api/v1/marketplace/agents/download/${remoteId}`
+    );
+    if (!response.ok) {
+      if (response.status === 404) {
+        throw (0, import_devtools_protocol.createServicemeError)(
+          "not_found",
+          `Agent '${remoteId}' not found`
+        );
+      }
+      throw new Error(
+        `Failed to download agent ${remoteId}: ${response.status}`
+      );
+    }
+    const payload = await response.json();
+    return payload.data?.files ?? [];
+  }
 };
 
 // src/permissions/agent-permissions.ts
@@ -353,7 +378,7 @@ var AgentStore = class {
 };
 
 // src/copilot/doctor.ts
-var import_devtools_protocol = require("@serviceme/devtools-protocol");
+var import_devtools_protocol2 = require("@serviceme/devtools-protocol");
 
 // src/process/runCommand.ts
 var import_node_child_process = require("child_process");
@@ -497,20 +522,20 @@ async function copilotDoctor() {
   return { installed: true, version, authenticated };
 }
 function createCopilotNotInstalledError() {
-  return (0, import_devtools_protocol.createServicemeError)(
-    import_devtools_protocol.COPILOT_ERROR_CODES.NOT_INSTALLED,
+  return (0, import_devtools_protocol2.createServicemeError)(
+    import_devtools_protocol2.COPILOT_ERROR_CODES.NOT_INSTALLED,
     "GitHub Copilot CLI is not installed. Visit https://docs.github.com/en/copilot/using-github-copilot/using-github-copilot-in-the-command-line to install."
   );
 }
 function createCopilotAuthRequiredError() {
-  return (0, import_devtools_protocol.createServicemeError)(
-    import_devtools_protocol.COPILOT_ERROR_CODES.AUTH_REQUIRED,
+  return (0, import_devtools_protocol2.createServicemeError)(
+    import_devtools_protocol2.COPILOT_ERROR_CODES.AUTH_REQUIRED,
     "GitHub Copilot CLI requires authentication. Run `copilot auth login` to sign in."
   );
 }
 
 // src/copilot/prompt.ts
-var import_devtools_protocol2 = require("@serviceme/devtools-protocol");
+var import_devtools_protocol3 = require("@serviceme/devtools-protocol");
 var COPILOT_COMMAND2 = "copilot";
 var DEFAULT_TIMEOUT_MS = 12e4;
 function stripAnsi(text) {
@@ -544,8 +569,8 @@ async function copilotPrompt(options) {
     });
     const output = stripAnsi(result.stdout);
     if (output.includes("I'm sorry, but I cannot assist") && result.stderr?.includes("Stream completed without a response")) {
-      throw (0, import_devtools_protocol2.createServicemeError)(
-        import_devtools_protocol2.COPILOT_ERROR_CODES.AUTH_REQUIRED,
+      throw (0, import_devtools_protocol3.createServicemeError)(
+        import_devtools_protocol3.COPILOT_ERROR_CODES.AUTH_REQUIRED,
         "Copilot CLI returned a refusal response. This typically indicates an expired authentication token. Run `gh auth login` to re-authenticate.",
         { exitCode: 0, output, stderr: result.stderr }
       );
@@ -554,8 +579,8 @@ async function copilotPrompt(options) {
   } catch (error) {
     const err = error;
     if (err.code === "ETIMEDOUT") {
-      throw (0, import_devtools_protocol2.createServicemeError)(
-        import_devtools_protocol2.COPILOT_ERROR_CODES.TIMEOUT,
+      throw (0, import_devtools_protocol3.createServicemeError)(
+        import_devtools_protocol3.COPILOT_ERROR_CODES.TIMEOUT,
         `Copilot prompt timed out after ${String(timeout)}ms.`
       );
     }
@@ -563,8 +588,8 @@ async function copilotPrompt(options) {
     const output = stripAnsi(err.stdout ?? "");
     const stderr = err.stderr ?? err.message ?? "";
     if (output.includes("I'm sorry, but I cannot assist") || stderr.includes("Stream completed without a response")) {
-      throw (0, import_devtools_protocol2.createServicemeError)(
-        import_devtools_protocol2.COPILOT_ERROR_CODES.AUTH_REQUIRED,
+      throw (0, import_devtools_protocol3.createServicemeError)(
+        import_devtools_protocol3.COPILOT_ERROR_CODES.AUTH_REQUIRED,
         "Copilot CLI returned a refusal response. This typically indicates an expired authentication token. Run `gh auth login` to re-authenticate.",
         { exitCode, output, stderr }
       );
@@ -572,8 +597,8 @@ async function copilotPrompt(options) {
     if (exitCode !== 0 && output) {
       return { output, exitCode };
     }
-    throw (0, import_devtools_protocol2.createServicemeError)(
-      import_devtools_protocol2.COPILOT_ERROR_CODES.EXECUTION_FAILED,
+    throw (0, import_devtools_protocol3.createServicemeError)(
+      import_devtools_protocol3.COPILOT_ERROR_CODES.EXECUTION_FAILED,
       stderr || `Copilot exited with code ${String(exitCode)}.`,
       { exitCode, stderr }
     );
@@ -581,7 +606,7 @@ async function copilotPrompt(options) {
 }
 
 // src/env/environmentInspector.ts
-var import_devtools_protocol3 = require("@serviceme/devtools-protocol");
+var import_devtools_protocol4 = require("@serviceme/devtools-protocol");
 var DEFAULT_TOOL_CHECK_TIMEOUT_MS = 5e3;
 var TOOL_CHECK_TIMEOUT_MS = {
   nuget: 12e3,
@@ -599,7 +624,7 @@ var ERROR_CODE_TIMEOUT = "ETIMEDOUT";
 var EnvironmentInspector = class {
   async checkEnvironment() {
     const results = await Promise.all(
-      import_devtools_protocol3.KNOWN_ENVIRONMENT_TOOLS.map(
+      import_devtools_protocol4.KNOWN_ENVIRONMENT_TOOLS.map(
         async (tool) => [tool, await this.checkTool(tool)]
       )
     );
@@ -607,7 +632,7 @@ var EnvironmentInspector = class {
   }
   async checkTool(toolName) {
     if (!/^[a-zA-Z0-9-]+$/.test(toolName)) {
-      throw (0, import_devtools_protocol3.createServicemeError)("invalid_params", "Invalid tool name.");
+      throw (0, import_devtools_protocol4.createServicemeError)("invalid_params", "Invalid tool name.");
     }
     try {
       if (toolName === "nvm") {
@@ -791,7 +816,7 @@ var EnvironmentInspector = class {
     const execError = error;
     const message = execError.message || String(error);
     const code = execError.code;
-    const isNotFound = message.includes("command not found") || message.includes("not recognized") || message.includes("ENOENT") || code === "ENOENT" || code === ERROR_CODE_NOT_FOUND;
+    const isNotFound = message.includes("command not found") || message.includes("not recognized") || message.includes("ENOENT") || message.includes("EACCES") || code === "ENOENT" || code === "EACCES" || code === ERROR_CODE_NOT_FOUND;
     const isTimeout = code === ERROR_CODE_TIMEOUT || message.toLowerCase().includes("timed out");
     return {
       installed: false,
@@ -803,7 +828,7 @@ var EnvironmentInspector = class {
 // src/image/imageTools.ts
 var fs2 = __toESM(require("fs/promises"));
 var path2 = __toESM(require("path"));
-var import_devtools_protocol4 = require("@serviceme/devtools-protocol");
+var import_devtools_protocol5 = require("@serviceme/devtools-protocol");
 var SUPPORTED_FORMATS = [
   ".jpg",
   ".jpeg",
@@ -847,7 +872,7 @@ var ImageTools = class {
   async compress(imagePath, options) {
     const validation = await this.validate(imagePath, options.sharpModulePath);
     if (!validation.valid) {
-      throw (0, import_devtools_protocol4.createServicemeError)(
+      throw (0, import_devtools_protocol5.createServicemeError)(
         "invalid_params",
         `Invalid image file: ${imagePath}`
       );
@@ -921,7 +946,7 @@ var ImageTools = class {
     try {
       return sharpModulePath ? require(sharpModulePath) : require("sharp");
     } catch (error) {
-      throw (0, import_devtools_protocol4.createServicemeError)(
+      throw (0, import_devtools_protocol5.createServicemeError)(
         "internal_error",
         `sharp is required for image operations: ${error instanceof Error ? error.message : String(error)}`
       );
@@ -933,13 +958,13 @@ function createImageTools() {
 }
 
 // src/json/jsonTools.ts
-var import_devtools_protocol5 = require("@serviceme/devtools-protocol");
+var import_devtools_protocol6 = require("@serviceme/devtools-protocol");
 var import_comment_json = require("comment-json");
 var import_json5 = __toESM(require("json5"));
 function createJsonTools() {
   return {
     sort(text, options) {
-      const finalOptions = { ...import_devtools_protocol5.DEFAULT_JSON_SORT_OPTIONS, ...options };
+      const finalOptions = { ...import_devtools_protocol6.DEFAULT_JSON_SORT_OPTIONS, ...options };
       const json = parseJson(text);
       const sorted = sortObject(json, finalOptions);
       return JSON.stringify(sorted, null, detectIndent(text));
@@ -975,7 +1000,7 @@ function parseJson(text) {
     } catch {
     }
   }
-  throw (0, import_devtools_protocol5.createServicemeError)("json_invalid_input", "Invalid JSON format.");
+  throw (0, import_devtools_protocol6.createServicemeError)("json_invalid_input", "Invalid JSON format.");
 }
 function sortObject(obj, options) {
   if (Array.isArray(obj)) {
@@ -1069,7 +1094,7 @@ function createConsoleLogger(prefix = "serviceme") {
 // src/project/projectTools.ts
 var fs3 = __toESM(require("fs/promises"));
 var path3 = __toESM(require("path"));
-var import_devtools_protocol6 = require("@serviceme/devtools-protocol");
+var import_devtools_protocol7 = require("@serviceme/devtools-protocol");
 
 // src/utils/fileUtils.ts
 var import_node_fs = require("fs");
@@ -1225,7 +1250,7 @@ var ProjectTools = class {
   }
   async installDependencies(workspacePath, command) {
     if (!command) {
-      throw (0, import_devtools_protocol6.createServicemeError)("invalid_params", "Expected install command.");
+      throw (0, import_devtools_protocol7.createServicemeError)("invalid_params", "Expected install command.");
     }
     await runCommand(command, {
       cwd: workspacePath,
@@ -1288,13 +1313,16 @@ var ProjectTools = class {
   }
   async runScaffoldPrune(workspacePath, preset) {
     if (!preset) {
-      throw (0, import_devtools_protocol6.createServicemeError)("invalid_params", "Expected scaffold preset.");
+      throw (0, import_devtools_protocol7.createServicemeError)("invalid_params", "Expected scaffold preset.");
     }
-    const commands = [
-      `pnpm run scaffold:prune -- --preset ${preset} --project-root .`,
-      `pnpm run scaffold:init-metadata -- --preset ${preset} --project-root . --force`
-    ];
+    await this.ensurePresetManifest(workspacePath, preset);
+    const pruneCommand = `pnpm run scaffold:prune -- --preset ${preset} --project-root .`;
+    const initMetadataCommand = `pnpm run scaffold:init-metadata -- --preset ${preset} --project-root . --force`;
+    const commands = [pruneCommand, initMetadataCommand];
     for (const command of commands) {
+      if (command === initMetadataCommand) {
+        await this.ensurePresetManifest(workspacePath, preset);
+      }
       await runCommand(command, {
         cwd: workspacePath,
         shell: true
@@ -1306,6 +1334,44 @@ var ProjectTools = class {
       commands
     };
   }
+  async ensurePresetManifest(workspacePath, preset) {
+    const presetManifestPath = path3.join(
+      workspacePath,
+      ".ms-scaffold",
+      "presets",
+      `${preset}.json`
+    );
+    if (await this.pathExists(presetManifestPath)) {
+      return;
+    }
+    const projectModePath = path3.join(
+      workspacePath,
+      ".ms-scaffold",
+      "project-mode.json"
+    );
+    if (!await this.pathExists(projectModePath)) {
+      return;
+    }
+    const projectModeRaw = await fs3.readFile(projectModePath, "utf8");
+    const projectMode = JSON.parse(projectModeRaw);
+    const synthesizedPreset = {
+      preset,
+      selectedModules: Array.isArray(projectMode.selectedModules) ? projectMode.selectedModules : [],
+      prunedModules: Array.isArray(projectMode.prunedModules) ? projectMode.prunedModules : [],
+      exclude: [],
+      recommendedFollowUps: [],
+      managedFiles: [],
+      mergeManagedFiles: [],
+      userOwnedPaths: []
+    };
+    await fs3.mkdir(path3.dirname(presetManifestPath), { recursive: true });
+    await fs3.writeFile(
+      presetManifestPath,
+      `${JSON.stringify(synthesizedPreset, null, 2)}
+`,
+      "utf8"
+    );
+  }
   async findScripts(dir, extensions) {
     const results = [];
     let entries;
@@ -1926,7 +1992,7 @@ function getExecutor(taskType) {
 var import_node_crypto = require("crypto");
 var fs8 = __toESM(require("fs"));
 var path7 = __toESM(require("path"));
-var import_devtools_protocol7 = require("@serviceme/devtools-protocol");
+var import_devtools_protocol8 = require("@serviceme/devtools-protocol");
 var CONFIG_DIR3 = ".serviceme";
 var CONFIG_FILE = "scheduled-tasks.json";
 function emptyConfig() {
@@ -1937,7 +2003,7 @@ function isRecord(value) {
 }
 function requireNonEmptyString(payload, field, taskType) {
   if (!isRecord(payload) || typeof payload[field] !== "string" || !payload[field].trim()) {
-    throw (0, import_devtools_protocol7.createServicemeError)(
+    throw (0, import_devtools_protocol8.createServicemeError)(
       "invalid_payload",
       `${taskType} payload ${field} is required`
     );
@@ -2585,6 +2651,7 @@ function matchCronField(field, value) {
 }
 
 // src/skills/SkillCatalogClient.ts
+var import_devtools_protocol9 = require("@serviceme/devtools-protocol");
 var SkillCatalogClient = class {
   constructor(options = {}) {
     this.fetchImpl = options.fetchImpl ?? fetch;
@@ -2609,6 +2676,30 @@ var SkillCatalogClient = class {
       fetchedAt: (/* @__PURE__ */ new Date()).toISOString()
     };
   }
+  async downloadSkill(remoteId) {
+    if (!this.baseUrl) {
+      throw (0, import_devtools_protocol9.createServicemeError)(
+        "workspace_not_found",
+        "Skill catalog baseUrl is not configured."
+      );
+    }
+    const response = await this.fetchImpl(
+      `${this.baseUrl}/api/v1/marketplace/skills/download/${remoteId}`
+    );
+    if (!response.ok) {
+      if (response.status === 404) {
+        throw (0, import_devtools_protocol9.createServicemeError)(
+          "not_found",
+          `Skill '${remoteId}' not found`
+        );
+      }
+      throw new Error(
+        `Failed to download skill ${remoteId}: ${response.status}`
+      );
+    }
+    const payload = await response.json();
+    return payload.data?.files ?? [];
+  }
 };
 
 // src/skills/SkillReconciler.ts
@@ -2745,6 +2836,22 @@ var SkillStore = class {
       return false;
     }
   }
+  async writeSkillFiles(skillId, scope, files) {
+    const root = scope === "workspace" ? path9.join(this.workspacePath, WORKSPACE_SKILLS_ROOT_RELATIVE) : this.userSkillsRoot;
+    const targetDir = path9.join(root, skillId);
+    await this.fileSystem.mkdir(targetDir, { recursive: true });
+    for (const file of files) {
+      const filePath = path9.join(targetDir, file.path);
+      await this.fileSystem.mkdir(path9.dirname(filePath), { recursive: true });
+      await this.fileSystem.writeFile(filePath, file.content, "utf-8");
+      if (file.executable) {
+        try {
+          await this.fileSystem.chmod(filePath, 493);
+        } catch {
+        }
+      }
+    }
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.mjs

@@ -6,6 +6,7 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 });
 
 // src/agents/AgentCatalogClient.ts
+import { createServicemeError } from "@serviceme/devtools-protocol";
 var AgentCatalogClient = class {
   constructor(options = {}) {
     this.fetchImpl = options.fetchImpl ?? fetch;
@@ -30,6 +31,30 @@ var AgentCatalogClient = class {
       fetchedAt: (/* @__PURE__ */ new Date()).toISOString()
     };
   }
+  async downloadAgent(remoteId) {
+    if (!this.baseUrl) {
+      throw createServicemeError(
+        "workspace_not_found",
+        "Agent catalog baseUrl is not configured."
+      );
+    }
+    const response = await this.fetchImpl(
+      `${this.baseUrl}/api/v1/marketplace/agents/download/${remoteId}`
+    );
+    if (!response.ok) {
+      if (response.status === 404) {
+        throw createServicemeError(
+          "not_found",
+          `Agent '${remoteId}' not found`
+        );
+      }
+      throw new Error(
+        `Failed to download agent ${remoteId}: ${response.status}`
+      );
+    }
+    const payload = await response.json();
+    return payload.data?.files ?? [];
+  }
 };
 
 // src/permissions/agent-permissions.ts
@@ -289,7 +314,7 @@ var AgentStore = class {
 // src/copilot/doctor.ts
 import {
   COPILOT_ERROR_CODES,
-  createServicemeError
+  createServicemeError as createServicemeError2
 } from "@serviceme/devtools-protocol";
 
 // src/process/runCommand.ts
@@ -434,13 +459,13 @@ async function copilotDoctor() {
   return { installed: true, version, authenticated };
 }
 function createCopilotNotInstalledError() {
-  return createServicemeError(
+  return createServicemeError2(
     COPILOT_ERROR_CODES.NOT_INSTALLED,
     "GitHub Copilot CLI is not installed. Visit https://docs.github.com/en/copilot/using-github-copilot/using-github-copilot-in-the-command-line to install."
   );
 }
 function createCopilotAuthRequiredError() {
-  return createServicemeError(
+  return createServicemeError2(
     COPILOT_ERROR_CODES.AUTH_REQUIRED,
     "GitHub Copilot CLI requires authentication. Run `copilot auth login` to sign in."
   );
@@ -449,7 +474,7 @@ function createCopilotAuthRequiredError() {
 // src/copilot/prompt.ts
 import {
   COPILOT_ERROR_CODES as COPILOT_ERROR_CODES2,
-  createServicemeError as createServicemeError2
+  createServicemeError as createServicemeError3
 } from "@serviceme/devtools-protocol";
 var COPILOT_COMMAND2 = "copilot";
 var DEFAULT_TIMEOUT_MS = 12e4;
@@ -484,7 +509,7 @@ async function copilotPrompt(options) {
     });
     const output = stripAnsi(result.stdout);
     if (output.includes("I'm sorry, but I cannot assist") && result.stderr?.includes("Stream completed without a response")) {
-      throw createServicemeError2(
+      throw createServicemeError3(
         COPILOT_ERROR_CODES2.AUTH_REQUIRED,
         "Copilot CLI returned a refusal response. This typically indicates an expired authentication token. Run `gh auth login` to re-authenticate.",
         { exitCode: 0, output, stderr: result.stderr }
@@ -494,7 +519,7 @@ async function copilotPrompt(options) {
   } catch (error) {
     const err = error;
     if (err.code === "ETIMEDOUT") {
-      throw createServicemeError2(
+      throw createServicemeError3(
         COPILOT_ERROR_CODES2.TIMEOUT,
         `Copilot prompt timed out after ${String(timeout)}ms.`
       );
@@ -503,7 +528,7 @@ async function copilotPrompt(options) {
     const output = stripAnsi(err.stdout ?? "");
     const stderr = err.stderr ?? err.message ?? "";
     if (output.includes("I'm sorry, but I cannot assist") || stderr.includes("Stream completed without a response")) {
-      throw createServicemeError2(
+      throw createServicemeError3(
         COPILOT_ERROR_CODES2.AUTH_REQUIRED,
         "Copilot CLI returned a refusal response. This typically indicates an expired authentication token. Run `gh auth login` to re-authenticate.",
         { exitCode, output, stderr }
@@ -512,7 +537,7 @@ async function copilotPrompt(options) {
     if (exitCode !== 0 && output) {
       return { output, exitCode };
     }
-    throw createServicemeError2(
+    throw createServicemeError3(
       COPILOT_ERROR_CODES2.EXECUTION_FAILED,
       stderr || `Copilot exited with code ${String(exitCode)}.`,
       { exitCode, stderr }
@@ -522,7 +547,7 @@ async function copilotPrompt(options) {
 
 // src/env/environmentInspector.ts
 import {
-  createServicemeError as createServicemeError3,
+  createServicemeError as createServicemeError4,
   KNOWN_ENVIRONMENT_TOOLS
 } from "@serviceme/devtools-protocol";
 var DEFAULT_TOOL_CHECK_TIMEOUT_MS = 5e3;
@@ -550,7 +575,7 @@ var EnvironmentInspector = class {
   }
   async checkTool(toolName) {
     if (!/^[a-zA-Z0-9-]+$/.test(toolName)) {
-      throw createServicemeError3("invalid_params", "Invalid tool name.");
+      throw createServicemeError4("invalid_params", "Invalid tool name.");
     }
     try {
       if (toolName === "nvm") {
@@ -734,7 +759,7 @@ var EnvironmentInspector = class {
     const execError = error;
     const message = execError.message || String(error);
     const code = execError.code;
-    const isNotFound = message.includes("command not found") || message.includes("not recognized") || message.includes("ENOENT") || code === "ENOENT" || code === ERROR_CODE_NOT_FOUND;
+    const isNotFound = message.includes("command not found") || message.includes("not recognized") || message.includes("ENOENT") || message.includes("EACCES") || code === "ENOENT" || code === "EACCES" || code === ERROR_CODE_NOT_FOUND;
     const isTimeout = code === ERROR_CODE_TIMEOUT || message.toLowerCase().includes("timed out");
     return {
       installed: false,
@@ -747,7 +772,7 @@ var EnvironmentInspector = class {
 import * as fs2 from "fs/promises";
 import * as path2 from "path";
 import {
-  createServicemeError as createServicemeError4
+  createServicemeError as createServicemeError5
 } from "@serviceme/devtools-protocol";
 var SUPPORTED_FORMATS = [
   ".jpg",
@@ -792,7 +817,7 @@ var ImageTools = class {
   async compress(imagePath, options) {
     const validation = await this.validate(imagePath, options.sharpModulePath);
     if (!validation.valid) {
-      throw createServicemeError4(
+      throw createServicemeError5(
         "invalid_params",
         `Invalid image file: ${imagePath}`
       );
@@ -866,7 +891,7 @@ var ImageTools = class {
     try {
       return sharpModulePath ? __require(sharpModulePath) : __require("sharp");
     } catch (error) {
-      throw createServicemeError4(
+      throw createServicemeError5(
         "internal_error",
         `sharp is required for image operations: ${error instanceof Error ? error.message : String(error)}`
       );
@@ -879,7 +904,7 @@ function createImageTools() {
 
 // src/json/jsonTools.ts
 import {
-  createServicemeError as createServicemeError5,
+  createServicemeError as createServicemeError6,
   DEFAULT_JSON_SORT_OPTIONS
 } from "@serviceme/devtools-protocol";
 import { parse as parseCommentJson } from "comment-json";
@@ -923,7 +948,7 @@ function parseJson(text) {
     } catch {
     }
   }
-  throw createServicemeError5("json_invalid_input", "Invalid JSON format.");
+  throw createServicemeError6("json_invalid_input", "Invalid JSON format.");
 }
 function sortObject(obj, options) {
   if (Array.isArray(obj)) {
@@ -1018,7 +1043,7 @@ function createConsoleLogger(prefix = "serviceme") {
 import * as fs3 from "fs/promises";
 import * as path3 from "path";
 import {
-  createServicemeError as createServicemeError6
+  createServicemeError as createServicemeError7
 } from "@serviceme/devtools-protocol";
 
 // src/utils/fileUtils.ts
@@ -1183,7 +1208,7 @@ var ProjectTools = class {
   }
   async installDependencies(workspacePath, command) {
     if (!command) {
-      throw createServicemeError6("invalid_params", "Expected install command.");
+      throw createServicemeError7("invalid_params", "Expected install command.");
     }
     await runCommand(command, {
       cwd: workspacePath,
@@ -1246,13 +1271,16 @@ var ProjectTools = class {
   }
   async runScaffoldPrune(workspacePath, preset) {
     if (!preset) {
-      throw createServicemeError6("invalid_params", "Expected scaffold preset.");
+      throw createServicemeError7("invalid_params", "Expected scaffold preset.");
     }
-    const commands = [
-      `pnpm run scaffold:prune -- --preset ${preset} --project-root .`,
-      `pnpm run scaffold:init-metadata -- --preset ${preset} --project-root . --force`
-    ];
+    await this.ensurePresetManifest(workspacePath, preset);
+    const pruneCommand = `pnpm run scaffold:prune -- --preset ${preset} --project-root .`;
+    const initMetadataCommand = `pnpm run scaffold:init-metadata -- --preset ${preset} --project-root . --force`;
+    const commands = [pruneCommand, initMetadataCommand];
     for (const command of commands) {
+      if (command === initMetadataCommand) {
+        await this.ensurePresetManifest(workspacePath, preset);
+      }
       await runCommand(command, {
         cwd: workspacePath,
         shell: true
@@ -1264,6 +1292,44 @@ var ProjectTools = class {
       commands
     };
   }
+  async ensurePresetManifest(workspacePath, preset) {
+    const presetManifestPath = path3.join(
+      workspacePath,
+      ".ms-scaffold",
+      "presets",
+      `${preset}.json`
+    );
+    if (await this.pathExists(presetManifestPath)) {
+      return;
+    }
+    const projectModePath = path3.join(
+      workspacePath,
+      ".ms-scaffold",
+      "project-mode.json"
+    );
+    if (!await this.pathExists(projectModePath)) {
+      return;
+    }
+    const projectModeRaw = await fs3.readFile(projectModePath, "utf8");
+    const projectMode = JSON.parse(projectModeRaw);
+    const synthesizedPreset = {
+      preset,
+      selectedModules: Array.isArray(projectMode.selectedModules) ? projectMode.selectedModules : [],
+      prunedModules: Array.isArray(projectMode.prunedModules) ? projectMode.prunedModules : [],
+      exclude: [],
+      recommendedFollowUps: [],
+      managedFiles: [],
+      mergeManagedFiles: [],
+      userOwnedPaths: []
+    };
+    await fs3.mkdir(path3.dirname(presetManifestPath), { recursive: true });
+    await fs3.writeFile(
+      presetManifestPath,
+      `${JSON.stringify(synthesizedPreset, null, 2)}
+`,
+      "utf8"
+    );
+  }
   async findScripts(dir, extensions) {
     const results = [];
     let entries;
@@ -1884,7 +1950,7 @@ function getExecutor(taskType) {
 import { randomUUID } from "crypto";
 import * as fs8 from "fs";
 import * as path7 from "path";
-import { createServicemeError as createServicemeError7 } from "@serviceme/devtools-protocol";
+import { createServicemeError as createServicemeError8 } from "@serviceme/devtools-protocol";
 var CONFIG_DIR3 = ".serviceme";
 var CONFIG_FILE = "scheduled-tasks.json";
 function emptyConfig() {
@@ -1895,7 +1961,7 @@ function isRecord(value) {
 }
 function requireNonEmptyString(payload, field, taskType) {
   if (!isRecord(payload) || typeof payload[field] !== "string" || !payload[field].trim()) {
-    throw createServicemeError7(
+    throw createServicemeError8(
       "invalid_payload",
       `${taskType} payload ${field} is required`
     );
@@ -2543,6 +2609,7 @@ function matchCronField(field, value) {
 }
 
 // src/skills/SkillCatalogClient.ts
+import { createServicemeError as createServicemeError9 } from "@serviceme/devtools-protocol";
 var SkillCatalogClient = class {
   constructor(options = {}) {
     this.fetchImpl = options.fetchImpl ?? fetch;
@@ -2567,6 +2634,30 @@ var SkillCatalogClient = class {
       fetchedAt: (/* @__PURE__ */ new Date()).toISOString()
     };
   }
+  async downloadSkill(remoteId) {
+    if (!this.baseUrl) {
+      throw createServicemeError9(
+        "workspace_not_found",
+        "Skill catalog baseUrl is not configured."
+      );
+    }
+    const response = await this.fetchImpl(
+      `${this.baseUrl}/api/v1/marketplace/skills/download/${remoteId}`
+    );
+    if (!response.ok) {
+      if (response.status === 404) {
+        throw createServicemeError9(
+          "not_found",
+          `Skill '${remoteId}' not found`
+        );
+      }
+      throw new Error(
+        `Failed to download skill ${remoteId}: ${response.status}`
+      );
+    }
+    const payload = await response.json();
+    return payload.data?.files ?? [];
+  }
 };
 
 // src/skills/SkillReconciler.ts
@@ -2703,6 +2794,22 @@ var SkillStore = class {
       return false;
     }
   }
+  async writeSkillFiles(skillId, scope, files) {
+    const root = scope === "workspace" ? path9.join(this.workspacePath, WORKSPACE_SKILLS_ROOT_RELATIVE) : this.userSkillsRoot;
+    const targetDir = path9.join(root, skillId);
+    await this.fileSystem.mkdir(targetDir, { recursive: true });
+    for (const file of files) {
+      const filePath = path9.join(targetDir, file.path);
+      await this.fileSystem.mkdir(path9.dirname(filePath), { recursive: true });
+      await this.fileSystem.writeFile(filePath, file.content, "utf-8");
+      if (file.executable) {
+        try {
+          await this.fileSystem.chmod(filePath, 493);
+        } catch {
+        }
+      }
+    }
+  }
 };
 export {
   AgentCatalogClient,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serviceme/devtools-core",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Reusable Node.js core capabilities powering the SERVICEME CLI and integrations.",
   "license": "SEE LICENSE IN LICENSE.md",
   "repository": {
@@ -36,7 +36,7 @@
     "comment-json": "^4.5.1",
     "json5": "^2.2.3",
     "yauzl": "^3.2.0",
-    "@serviceme/devtools-protocol": "0.1.6"
+    "@serviceme/devtools-protocol": "0.1.7"
   },
   "devDependencies": {
     "@types/node": "^24",
@@ -48,6 +48,7 @@
   "scripts": {
     "watch": "tsup src/index.ts --format cjs,esm --dts --watch",
     "build": "tsup src/index.ts --format cjs,esm --dts",
+    "typecheck": "tsc --noEmit",
     "test": "pnpm run build && node --test test/**/*.test.js && node --import tsx --test src/**/__tests__/**/*.test.ts",
     "release:check": "pnpm run build && npm pack --dry-run",
     "pack": "npm pack",