@agentxm/client-core 0.1.6

package/dist/src/unstable/agents/coding-agent.d.ts

@@ -0,0 +1,250 @@
+/**
+ * Coding agent service contracts for extension managers.
+ *
+ * Defines the CodingAgent type and CodingAgentRepository service interface
+ * that extension managers depend on. The concrete implementation
+ * (DefaultCodingAgentRepository) lives in the CLI package.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type * as Effect from "effect/Effect";
+import type * as FileSystem from "effect/FileSystem";
+import type * as Option from "effect/Option";
+import type * as Path from "effect/Path";
+import * as ServiceMap from "effect/ServiceMap";
+import type { AppError } from "../app-error/index.js";
+import type { CommandFrontmatter } from "../commands/command-content.js";
+import type { CommandManifest } from "../commands/manifest-schema.js";
+import type { Handle } from "../extensions/handle.js";
+import type { RenderedFilePath } from "../extensions/rendered-files.js";
+import type { SubagentRenderInput } from "../subagents/rendering/types.js";
+import type { WorkspaceScope } from "../workspace/scope.js";
+import type { Workspace } from "../workspace/service-interface.js";
+import type { AgentId } from "./types.js";
+/**
+ * Inputs for resolving an agent's effective skills directory.
+ */
+export interface ResolveSkillsDirArgs {
+    readonly workspaceRoot: string;
+}
+/**
+ * Tagged outcome for skills-directory resolution.
+ */
+export type ResolveSkillsDirOutcome = {
+    readonly _tag: "supported";
+    readonly dir: string;
+} | {
+    readonly _tag: "unsupported";
+    readonly reason: string;
+} | {
+    readonly _tag: "disabled";
+    readonly reason: string;
+} | {
+    readonly _tag: "misconfigured";
+    readonly reason: string;
+};
+/**
+ * Inputs for adding an MCP server to an agent's configuration.
+ */
+export interface AddMcpServerArgs {
+    readonly workspaceRoot: string;
+    readonly serverName: string;
+    readonly canonicalPath: string;
+    readonly owner: Handle;
+    readonly resolvedVersion: string;
+}
+/**
+ * Inputs for removing an MCP server from an agent's configuration.
+ */
+export interface RemoveMcpServerArgs {
+    readonly workspaceRoot: string;
+    readonly serverName: string;
+}
+/**
+ * Inputs for resolving an agent's effective commands directory.
+ */
+export interface ResolveCommandsDirArgs {
+    readonly workspaceRoot: string;
+    readonly scope: WorkspaceScope;
+}
+/**
+ * Tagged outcome for commands-directory resolution.
+ */
+export type ResolveCommandsDirOutcome = {
+    readonly _tag: "supported";
+    readonly dir: string;
+    readonly warnings: ReadonlyArray<string>;
+} | {
+    readonly _tag: "unsupported";
+    readonly reason: string;
+} | {
+    readonly _tag: "disabled";
+    readonly reason: string;
+} | {
+    readonly _tag: "misconfigured";
+    readonly reason: string;
+};
+/**
+ * Inputs for adding a command to an agent's commands directory.
+ */
+export interface AddCommandArgs {
+    readonly workspaceRoot: string;
+    readonly scope: WorkspaceScope;
+    readonly commandName: string;
+    readonly frontmatter: Option.Option<CommandFrontmatter>;
+    readonly body: string;
+    readonly manifest: CommandManifest;
+    readonly agentOverrides: Option.Option<Readonly<Record<string, unknown>>>;
+    readonly force: boolean;
+}
+/**
+ * Inputs for removing a command from an agent's commands directory.
+ */
+export interface RemoveCommandArgs {
+    readonly workspaceRoot: string;
+    readonly scope: WorkspaceScope;
+    readonly commandName: string;
+}
+/**
+ * Outcome of a command sync operation (add or remove).
+ */
+export type CommandSyncOutcome = {
+    readonly _tag: "success";
+    readonly renderedFilePath: string;
+    readonly warnings: ReadonlyArray<string>;
+} | {
+    readonly _tag: "skipped";
+    readonly reason: string;
+} | {
+    readonly _tag: "unsupported";
+    readonly reason: string;
+} | {
+    readonly _tag: "conflict";
+    readonly reason: string;
+};
+/**
+ * Inputs for resolving an agent's effective subagents directory.
+ */
+export interface ResolveSubagentsDirArgs {
+    readonly workspaceRoot: string;
+    readonly scope: WorkspaceScope;
+}
+/**
+ * Tagged outcome for subagents-directory resolution.
+ */
+export type ResolveSubagentsDirOutcome = {
+    readonly _tag: "supported";
+    readonly dir: string;
+    readonly warnings: ReadonlyArray<string>;
+} | {
+    readonly _tag: "unsupported";
+    readonly reason: string;
+} | {
+    readonly _tag: "disabled";
+    readonly reason: string;
+} | {
+    readonly _tag: "misconfigured";
+    readonly reason: string;
+};
+/**
+ * Inputs for adding a subagent to an agent's subagents directory.
+ */
+export interface AddSubagentArgs {
+    readonly workspaceRoot: string;
+    readonly scope: WorkspaceScope;
+    readonly input: SubagentRenderInput;
+    readonly force: boolean;
+}
+/**
+ * Inputs for removing a subagent from an agent's subagents directory.
+ */
+export interface RemoveSubagentArgs {
+    readonly workspaceRoot: string;
+    readonly scope: WorkspaceScope;
+    readonly subagentName: string;
+    /** Rendered file paths from the lockfile, used to know which files to delete. */
+    readonly renderedFilePaths: ReadonlyArray<RenderedFilePath>;
+}
+/**
+ * Outcome of a subagent sync operation (add or remove).
+ */
+export type SubagentSyncOutcome = {
+    readonly _tag: "success";
+    readonly renderedFilePaths: ReadonlyArray<string>;
+    readonly warnings: ReadonlyArray<string>;
+} | {
+    readonly _tag: "skipped";
+    readonly reason: string;
+} | {
+    readonly _tag: "unsupported";
+    readonly reason: string;
+} | {
+    readonly _tag: "conflict";
+    readonly reason: string;
+};
+export type McpServerSyncFallbackSource = "unsupported" | "disabled";
+export type McpServerSyncOutcome = {
+    readonly _tag: "success";
+} | {
+    readonly _tag: "fallback";
+    readonly fallbackFrom: McpServerSyncFallbackSource;
+    readonly reason: string;
+} | {
+    readonly _tag: "unsupported";
+    readonly reason: string;
+} | {
+    readonly _tag: "disabled";
+    readonly reason: string;
+} | {
+    readonly _tag: "misconfigured";
+    readonly reason: string;
+} | {
+    readonly _tag: "failed";
+    readonly reason: string;
+};
+/**
+ * Agent-specific extension installation behavior.
+ *
+ * Each coding agent knows how to resolve its skills directory,
+ * manage MCP server configuration entries, and manage command files.
+ */
+export interface CodingAgent {
+    readonly id: AgentId;
+    readonly resolveEffectiveSkillsDir: (args: ResolveSkillsDirArgs) => Effect.Effect<ResolveSkillsDirOutcome, AppError, Path.Path>;
+    readonly addMcpServer: (args: AddMcpServerArgs) => Effect.Effect<McpServerSyncOutcome, AppError, FileSystem.FileSystem | Path.Path>;
+    readonly removeMcpServer: (args: RemoveMcpServerArgs) => Effect.Effect<McpServerSyncOutcome, AppError, FileSystem.FileSystem | Path.Path>;
+    readonly resolveEffectiveCommandsDir: (args: ResolveCommandsDirArgs) => Effect.Effect<ResolveCommandsDirOutcome, AppError, FileSystem.FileSystem | Path.Path>;
+    readonly addCommand: (args: AddCommandArgs) => Effect.Effect<CommandSyncOutcome, AppError, FileSystem.FileSystem | Path.Path>;
+    readonly removeCommand: (args: RemoveCommandArgs) => Effect.Effect<CommandSyncOutcome, AppError, FileSystem.FileSystem | Path.Path>;
+    readonly resolveEffectiveSubagentsDir: (args: ResolveSubagentsDirArgs) => Effect.Effect<ResolveSubagentsDirOutcome, AppError, FileSystem.FileSystem | Path.Path>;
+    readonly addSubagent: (args: AddSubagentArgs) => Effect.Effect<SubagentSyncOutcome, AppError, FileSystem.FileSystem | Path.Path>;
+    readonly removeSubagent: (args: RemoveSubagentArgs) => Effect.Effect<SubagentSyncOutcome, AppError, FileSystem.FileSystem | Path.Path>;
+}
+/**
+ * Repository for coding-agent implementations.
+ *
+ * Generic over `W` — the workspace service requirement. The CLI package
+ * instantiates this with its concrete `Workspace` type; core keeps it
+ * abstract to avoid a circular dependency.
+ *
+ * @typeParam W - Workspace service requirement for methods that need workspace context
+ */
+export interface CodingAgentRepositoryShape<W = never> {
+    readonly get: (id: AgentId) => Effect.Effect<CodingAgent, AppError>;
+    readonly all: Effect.Effect<ReadonlyArray<CodingAgent>, AppError>;
+    readonly getConfiguredAgents: () => Effect.Effect<ReadonlyArray<CodingAgent>, AppError, W>;
+    readonly getUnknownConfiguredAgentIds: () => Effect.Effect<ReadonlyArray<string>, AppError, W>;
+}
+/**
+ * Repository for coding-agent implementations.
+ *
+ * Instantiates the generic CodingAgentRepositoryShape with the core Workspace
+ * service for methods that need workspace context.
+ */
+export type CodingAgentRepositoryService = CodingAgentRepositoryShape<Workspace>;
+declare const CodingAgentRepository_base: ServiceMap.ServiceClass<CodingAgentRepository, "CodingAgentRepository", CodingAgentRepositoryService>;
+export declare class CodingAgentRepository extends CodingAgentRepository_base {
+}
+export {};
+//# sourceMappingURL=coding-agent.d.ts.map

package/dist/src/unstable/agents/coding-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coding-agent.d.ts","sourceRoot":"","sources":["../../../../src/unstable/agents/coding-agent.ts"],"names":[],"mappings":"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"}

package/dist/src/unstable/agents/coding-agent.js

@@ -0,0 +1,14 @@
+/**
+ * Coding agent service contracts for extension managers.
+ *
+ * Defines the CodingAgent type and CodingAgentRepository service interface
+ * that extension managers depend on. The concrete implementation
+ * (DefaultCodingAgentRepository) lives in the CLI package.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as ServiceMap from "effect/ServiceMap";
+export class CodingAgentRepository extends ServiceMap.Service()("CodingAgentRepository") {
+}
+//# sourceMappingURL=coding-agent.js.map

package/dist/src/unstable/agents/coding-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coding-agent.js","sourceRoot":"","sources":["../../../../src/unstable/agents/coding-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAuPhD,MAAM,OAAO,qBAAsB,SAAQ,UAAU,CAAC,OAAO,EAG1D,CAAC,uBAAuB,CAAC;CAAG"}

package/dist/src/unstable/agents/command-code/descriptor.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Command Code agent descriptor.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { AgentDescriptor } from "../types.js";
+/**
+ * Command Code agent descriptor.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const descriptor: AgentDescriptor;
+//# sourceMappingURL=descriptor.d.ts.map

package/dist/src/unstable/agents/command-code/descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/agents/command-code/descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,eAMxB,CAAC"}

package/dist/src/unstable/agents/command-code/descriptor.js

@@ -0,0 +1,19 @@
+/**
+ * Command Code agent descriptor.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+/**
+ * Command Code agent descriptor.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const descriptor = {
+    id: "command-code",
+    name: "Command Code",
+    skills: {
+        dir: ".commandcode/skills",
+    },
+};
+//# sourceMappingURL=descriptor.js.map

package/dist/src/unstable/agents/command-code/descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.js","sourceRoot":"","sources":["../../../../../src/unstable/agents/command-code/descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAoB;IACzC,EAAE,EAAE,cAAc;IAClB,IAAI,EAAE,cAAc;IACpB,MAAM,EAAE;QACN,GAAG,EAAE,qBAAqB;KAC3B;CACF,CAAC"}

package/dist/src/unstable/agents/command-code/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Command Code agent module.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { descriptor } from "./descriptor.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/unstable/agents/command-code/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/agents/command-code/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/src/unstable/agents/command-code/index.js

@@ -0,0 +1,8 @@
+/**
+ * Command Code agent module.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { descriptor } from "./descriptor.js";
+//# sourceMappingURL=index.js.map

package/dist/src/unstable/agents/command-code/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/unstable/agents/command-code/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/src/unstable/agents/command-sync.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Shared command sync helpers for coding-agent service implementations.
+ *
+ * Provides common logic for writing and removing command files in agent
+ * commands directories. Each agent adapter delegates to these helpers.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import { type AppError } from "../app-error/index.js";
+import type { AddCommandArgs, CommandSyncOutcome, RemoveCommandArgs, ResolveCommandsDirOutcome } from "./coding-agent.js";
+/**
+ * Configuration for an agent's command sync behavior.
+ */
+export interface CommandSyncConfig {
+    /** The agent ID used to select the appropriate renderer. */
+    readonly agentId: string;
+}
+/**
+ * Write a command file to an agent's commands directory.
+ *
+ * Handles conflict detection, directory creation, and file writing.
+ * Returns a `CommandSyncOutcome` with the rendered file path and any warnings.
+ */
+export declare const writeCommandFile: (commandsDir: string, args: AddCommandArgs, config?: CommandSyncConfig) => Effect.Effect<CommandSyncOutcome, AppError, FileSystem.FileSystem | Path.Path>;
+/**
+ * Resolve the file extension for a given agent ID.
+ */
+export declare const resolveFileExtension: (agentId: string) => string;
+/**
+ * Remove a command file from an agent's commands directory.
+ *
+ * Handles file-not-found gracefully.
+ */
+export declare const removeCommandFile: (commandsDir: string, args: RemoveCommandArgs, config?: CommandSyncConfig) => Effect.Effect<CommandSyncOutcome, AppError, FileSystem.FileSystem | Path.Path>;
+/**
+ * Convert a non-supported ResolveCommandsDirOutcome to a CommandSyncOutcome.
+ *
+ * Intentionally maps "disabled" and "misconfigured" to "unsupported" —
+ * callers of CommandSync don't need to distinguish these cases today.
+ */
+export declare const dirOutcomeToSyncOutcome: (outcome: Exclude<ResolveCommandsDirOutcome, {
+    readonly _tag: "supported";
+}>) => CommandSyncOutcome;
+/**
+ * Add a command using a resolve function and optional config.
+ *
+ * Common pattern used by most agent adapters.
+ */
+export declare const addCommandViaResolve: (resolve: Effect.Effect<ResolveCommandsDirOutcome, AppError, FileSystem.FileSystem | Path.Path>, args: AddCommandArgs, config?: CommandSyncConfig) => Effect.Effect<CommandSyncOutcome, AppError, FileSystem.FileSystem | Path.Path>;
+/**
+ * Remove a command using a resolve function and optional config.
+ *
+ * Common pattern used by most agent adapters.
+ */
+export declare const removeCommandViaResolve: (resolve: Effect.Effect<ResolveCommandsDirOutcome, AppError, FileSystem.FileSystem | Path.Path>, args: RemoveCommandArgs, config?: CommandSyncConfig) => Effect.Effect<CommandSyncOutcome, AppError, FileSystem.FileSystem | Path.Path>;
+//# sourceMappingURL=command-sync.d.ts.map

package/dist/src/unstable/agents/command-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-sync.d.ts","sourceRoot":"","sources":["../../../../src/unstable/agents/command-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAOpE,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EAC1B,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AA0BD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,aAAa,MAAM,EACnB,MAAM,cAAc,EACpB,SAAQ,iBAA4C,KACnD,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,QAAQ,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CA6C5E,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAS,MAAM,KAAG,MAUtD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,aAAa,MAAM,EACnB,MAAM,iBAAiB,EACvB,SAAQ,iBAA4C,KACnD,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,QAAQ,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAgC5E,CAAC;AAEL;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,OAAO,CAAC,yBAAyB,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC,KAC1E,kBAGD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAS,MAAM,CAAC,MAAM,CAAC,yBAAyB,EAAE,QAAQ,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAC9F,MAAM,cAAc,EACpB,SAAQ,iBAA4C,KACnD,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,QAAQ,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAO5E,CAAC;AAEL;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,MAAM,CAAC,MAAM,CAAC,yBAAyB,EAAE,QAAQ,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAC9F,MAAM,iBAAiB,EACvB,SAAQ,iBAA4C,KACnD,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,QAAQ,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAO5E,CAAC"}

package/dist/src/unstable/agents/command-sync.js

@@ -0,0 +1,152 @@
+/**
+ * Shared command sync helpers for coding-agent service implementations.
+ *
+ * Provides common logic for writing and removing command files in agent
+ * commands directories. Each agent adapter delegates to these helpers.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import { makeAppError } from "../app-error/index.js";
+import { selectRenderer, } from "../commands/renderers/index.js";
+import { detectConflict } from "../extensions/conflict-detection.js";
+const defaultCommandSyncConfig = {
+    agentId: "claude-code",
+};
+const emptyFrontmatter = {};
+/**
+ * Render command content using the format-family renderer for the given agent.
+ */
+const renderCommand = (args, agentId) => {
+    const renderer = selectRenderer(agentId);
+    const frontmatter = Option.getOrElse(args.frontmatter, () => emptyFrontmatter);
+    return renderer({
+        frontmatter,
+        body: args.body,
+        agentId,
+        commandName: args.commandName,
+        ...Option.match(args.agentOverrides, {
+            onNone: () => ({}),
+            onSome: (overrides) => ({ agentOverrides: overrides }),
+        }),
+    });
+};
+/**
+ * Write a command file to an agent's commands directory.
+ *
+ * Handles conflict detection, directory creation, and file writing.
+ * Returns a `CommandSyncOutcome` with the rendered file path and any warnings.
+ */
+export const writeCommandFile = (commandsDir, args, config = defaultCommandSyncConfig) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    // Render content using the format-family renderer for this agent
+    const rendered = renderCommand(args, config.agentId);
+    const filePath = path.join(commandsDir, `${args.commandName}${rendered.fileExtension}`);
+    // Check for conflicts
+    const conflictResult = yield* detectConflict(filePath);
+    if (conflictResult._tag === "Conflict" && !args.force) {
+        return {
+            _tag: "conflict",
+            reason: `File exists without axm marker: ${filePath}. Use --force to overwrite.`,
+        };
+    }
+    // Ensure directory exists
+    yield* fs.makeDirectory(commandsDir, { recursive: true }).pipe(Effect.mapError((error) => makeAppError({
+        code: "COMMAND_SYNC_WRITE_FAILED",
+        what: `Failed to create commands directory: ${commandsDir}`,
+        cause: error,
+    })));
+    // Write the file
+    yield* fs.writeFileString(filePath, rendered.content).pipe(Effect.mapError((error) => makeAppError({
+        code: "COMMAND_SYNC_WRITE_FAILED",
+        what: `Failed to write command file: ${filePath}`,
+        cause: error,
+    })));
+    return {
+        _tag: "success",
+        renderedFilePath: filePath,
+        warnings: [...rendered.warnings.map((w) => `[${w.agent}] ${w.feature}: ${w.message}`)],
+    };
+});
+/**
+ * Resolve the file extension for a given agent ID.
+ */
+export const resolveFileExtension = (agentId) => {
+    const renderer = selectRenderer(agentId);
+    // Call the renderer with minimal input just to get the file extension
+    const output = renderer({
+        frontmatter: emptyFrontmatter,
+        body: "",
+        agentId,
+        commandName: "",
+    });
+    return output.fileExtension;
+};
+/**
+ * Remove a command file from an agent's commands directory.
+ *
+ * Handles file-not-found gracefully.
+ */
+export const removeCommandFile = (commandsDir, args, config = defaultCommandSyncConfig) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const fileExtension = resolveFileExtension(config.agentId);
+    const filePath = path.join(commandsDir, `${args.commandName}${fileExtension}`);
+    const exists = yield* fs.exists(filePath).pipe(Effect.catch(() => Effect.succeed(false)));
+    if (!exists) {
+        return {
+            _tag: "success",
+            renderedFilePath: filePath,
+            warnings: [],
+        };
+    }
+    yield* fs.remove(filePath).pipe(Effect.mapError((error) => makeAppError({
+        code: "COMMAND_SYNC_REMOVE_FAILED",
+        what: `Failed to remove command file: ${filePath}`,
+        cause: error,
+    })));
+    return {
+        _tag: "success",
+        renderedFilePath: filePath,
+        warnings: [],
+    };
+});
+/**
+ * Convert a non-supported ResolveCommandsDirOutcome to a CommandSyncOutcome.
+ *
+ * Intentionally maps "disabled" and "misconfigured" to "unsupported" —
+ * callers of CommandSync don't need to distinguish these cases today.
+ */
+export const dirOutcomeToSyncOutcome = (outcome) => ({
+    _tag: "unsupported",
+    reason: outcome.reason,
+});
+/**
+ * Add a command using a resolve function and optional config.
+ *
+ * Common pattern used by most agent adapters.
+ */
+export const addCommandViaResolve = (resolve, args, config = defaultCommandSyncConfig) => Effect.gen(function* () {
+    const dirOutcome = yield* resolve;
+    if (dirOutcome._tag !== "supported") {
+        return dirOutcomeToSyncOutcome(dirOutcome);
+    }
+    return yield* writeCommandFile(dirOutcome.dir, args, config);
+});
+/**
+ * Remove a command using a resolve function and optional config.
+ *
+ * Common pattern used by most agent adapters.
+ */
+export const removeCommandViaResolve = (resolve, args, config = defaultCommandSyncConfig) => Effect.gen(function* () {
+    const dirOutcome = yield* resolve;
+    if (dirOutcome._tag !== "supported") {
+        return dirOutcomeToSyncOutcome(dirOutcome);
+    }
+    return yield* removeCommandFile(dirOutcome.dir, args, config);
+});
+//# sourceMappingURL=command-sync.js.map

package/dist/src/unstable/agents/command-sync.js.map

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

package/dist/src/unstable/agents/constants.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Effectful path helpers for agent configuration directories.
+ *
+ * All path computation uses `@effect/platform` Path service. Consumers
+ * must yield these in an Effect context.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+/**
+ * Resolve the user's home directory.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const getHome: Effect.Effect<string, never, never>;
+/**
+ * Resolve the XDG config home directory.
+ *
+ * Uses `XDG_CONFIG_HOME` environment variable if set, otherwise defaults to `~/.config`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const getConfigHome: Effect.Effect<string, never, Path.Path>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/unstable/agents/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/unstable/agents/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC;;;;GAIG;AACH,eAAO,MAAM,OAAO,qCAAkC,CAAC;AAEvD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,yCAMxB,CAAC"}

package/dist/src/unstable/agents/constants.js

@@ -0,0 +1,38 @@
+/**
+ * Effectful path helpers for agent configuration directories.
+ *
+ * All path computation uses `@effect/platform` Path service. Consumers
+ * must yield these in an Effect context.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+// Intentional escape hatch: node:os homedir() has no @effect/platform equivalent.
+// Wrapped in Effect.sync so execution is deferred — no eager module-level I/O.
+import * as os from "node:os";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+import { envOption } from "../utils/index.js";
+/**
+ * Resolve the user's home directory.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const getHome = Effect.sync(() => os.homedir());
+/**
+ * Resolve the XDG config home directory.
+ *
+ * Uses `XDG_CONFIG_HOME` environment variable if set, otherwise defaults to `~/.config`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const getConfigHome = Effect.gen(function* () {
+    const p = yield* Path.Path;
+    const envOpt = yield* envOption("XDG_CONFIG_HOME");
+    if (Option.isSome(envOpt))
+        return envOpt.value;
+    const home = yield* getHome;
+    return p.join(home, ".config");
+});
+//# sourceMappingURL=constants.js.map

package/dist/src/unstable/agents/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/unstable/agents/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,kFAAkF;AAClF,+EAA+E;AAC/E,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAC/C,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;IACnD,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC;IAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC;IAC5B,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AACjC,CAAC,CAAC,CAAC"}