@agentxm/client-core 0.1.6

package/dist/src/unstable/settings/schema.js

@@ -0,0 +1,466 @@
+/**
+ * Schema definitions for AXM settings configuration.
+ *
+ * Settings define workspace configuration including sources, agents, and extensions.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+import * as SchemaTransformation from "effect/SchemaTransformation";
+import { AgentIdSchema, ExtensionNameSchema } from "../extensions/common.js";
+import { HandleSchema } from "../extensions/handle.js";
+// -----------------------------------------------------------------------------
+// Source Host Config (array-based, discriminated on `type` field)
+// -----------------------------------------------------------------------------
+/**
+ * Pattern for source names: lowercase alphanumeric, hyphens, and dots.
+ * Must start with a letter or digit.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const SOURCE_NAME_PATTERN = /^[a-z0-9][a-z0-9.-]*$/;
+const SourceNameSchema = Schema.String.check(Schema.isPattern(SOURCE_NAME_PATTERN, {
+    message: "source name must start with a letter or digit and contain only lowercase alphanumeric characters, hyphens, and dots",
+})).annotate({
+    identifier: "SourceName",
+    title: "Source Name",
+    description: "A source name using lowercase letters, numbers, hyphens, and dots (e.g. github, my-registry.dev).",
+    examples: ["github", "my-registry.dev"],
+});
+/**
+ * GitHub source host configuration.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const GitHubSourceHostConfigSchema = Schema.Struct({
+    name: SourceNameSchema.pipe(Schema.annotateKey({ messageMissingKey: "source name is required" })),
+    type: Schema.Literal("github"),
+    url: Schema.URLFromString.pipe(Schema.annotateKey({ messageMissingKey: "source url is required" })),
+}).annotate({
+    identifier: "GitHubSourceHostConfig",
+    title: "GitHub Source Host",
+    description: "Configuration for a GitHub source.",
+});
+/**
+ * GitLab source host configuration.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const GitLabSourceHostConfigSchema = Schema.Struct({
+    name: SourceNameSchema.pipe(Schema.annotateKey({ messageMissingKey: "source name is required" })),
+    type: Schema.Literal("gitlab"),
+    url: Schema.URLFromString.pipe(Schema.annotateKey({ messageMissingKey: "source url is required" })),
+}).annotate({
+    identifier: "GitLabSourceHostConfig",
+    title: "GitLab Source Host",
+    description: "Configuration for a GitLab source.",
+});
+/**
+ * Bitbucket source host configuration.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const BitbucketSourceHostConfigSchema = Schema.Struct({
+    name: SourceNameSchema.pipe(Schema.annotateKey({ messageMissingKey: "source name is required" })),
+    type: Schema.Literal("bitbucket"),
+    url: Schema.URLFromString.pipe(Schema.annotateKey({ messageMissingKey: "source url is required" })),
+}).annotate({
+    identifier: "BitbucketSourceHostConfig",
+    title: "Bitbucket Source Host",
+    description: "Configuration for a Bitbucket source.",
+});
+/**
+ * Azure Repos source host configuration.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const AzureReposSourceHostConfigSchema = Schema.Struct({
+    name: SourceNameSchema.pipe(Schema.annotateKey({ messageMissingKey: "source name is required" })),
+    type: Schema.Literal("azurerepos"),
+    url: Schema.URLFromString.pipe(Schema.annotateKey({ messageMissingKey: "source url is required" })),
+}).annotate({
+    identifier: "AzureReposSourceHostConfig",
+    title: "Azure Repos Source Host",
+    description: "Configuration for an Azure Repos source.",
+});
+/**
+ * Registry source host configuration.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const RegistrySourceHostConfigSchema = Schema.Struct({
+    name: SourceNameSchema.pipe(Schema.annotateKey({ messageMissingKey: "source name is required" })),
+    type: Schema.Literal("registry"),
+    location: Schema.URLFromString.pipe(Schema.annotateKey({ messageMissingKey: "source location is required" })),
+}).annotate({
+    identifier: "RegistrySourceHostConfig",
+    title: "Registry Source Host",
+    description: "Configuration for a package registry source.",
+});
+/**
+ * Discriminated union of source host configurations on the `type` field.
+ *
+ * Variants: github, gitlab, bitbucket, azurerepos, registry.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const SourceHostConfigSchema = Schema.Union([
+    GitHubSourceHostConfigSchema,
+    GitLabSourceHostConfigSchema,
+    BitbucketSourceHostConfigSchema,
+    AzureReposSourceHostConfigSchema,
+    RegistrySourceHostConfigSchema,
+]).annotate({
+    identifier: "SourceHostConfig",
+    title: "Source Host Config",
+    description: "Where extensions are fetched from — GitHub, GitLab, Bitbucket, Azure Repos, or a package registry.",
+});
+const decodeExtensionNameSync = Schema.decodeUnknownSync(ExtensionNameSchema);
+const validateNamedRecordKeys = (entryLabel, decodeName) => (record) => {
+    const invalidKeys = Object.keys(record).filter((key) => {
+        try {
+            decodeName(key);
+            return false;
+        }
+        catch {
+            return true;
+        }
+    });
+    return invalidKeys.length > 0
+        ? `Invalid ${entryLabel} name(s): ${invalidKeys.join(", ")}. Names must be max 64 chars, lowercase letters/numbers/hyphens, not starting or ending with hyphen.`
+        : undefined;
+};
+/**
+ * Managed skill with source and optional config flags.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const SkillEntryObjectSchema = Schema.Struct({
+    source: Schema.String.pipe(Schema.annotateKey({ messageMissingKey: "skill source is required" })),
+    enabled: Schema.optional(Schema.Boolean),
+}).annotate({
+    identifier: "SkillEntryObject",
+    title: "Skill Entry Object",
+    description: "A skill with its source location and whether it's enabled.",
+});
+/**
+ * Union of skill entry forms: plain source string or object with source + enabled.
+ *
+ * Decodes to canonical `{ source, enabled }` form; encodes back to the most
+ * compact JSON representation (plain string when enabled, object when disabled).
+ *
+ * The legacy unmanaged marker (`{ managed: false }`) is no longer supported.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const SkillEntrySchema = Schema.Union([Schema.String, SkillEntryObjectSchema]).pipe(Schema.decodeTo(Schema.Struct({
+    source: Schema.String,
+    enabled: Schema.Boolean,
+}).annotate({
+    identifier: "SkillEntry",
+    title: "Skill Entry",
+    description: "A skill reference — either a source string like @owner/skills/name or an object with source and enabled.",
+}), SchemaTransformation.transform({
+    decode: (entry) => typeof entry === "string"
+        ? { source: entry, enabled: true }
+        : { source: entry.source, enabled: entry.enabled ?? true },
+    encode: (entry) => entry.enabled ? entry.source : { source: entry.source, enabled: false },
+})));
+/**
+ * Skills map - maps skill names to skill entries.
+ *
+ * Keys must be valid skill names per agentskills.io specification:
+ * - Max 64 characters
+ * - Lowercase letters, numbers, and hyphens only
+ * - Must not start or end with a hyphen
+ *
+ * Values are skill entries: plain source strings or objects with source + enabled.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const SkillsMapSchema = Schema.Record(Schema.String, SkillEntrySchema)
+    .check(Schema.makeFilter(validateNamedRecordKeys("skill", decodeExtensionNameSync)))
+    .annotate({
+    identifier: "SkillsMap",
+    title: "Skills Map",
+    description: "Your installed skills, keyed by name.",
+});
+/**
+ * Managed command with source and optional config flags.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const CommandEntryObjectSchema = Schema.Struct({
+    source: Schema.String.pipe(Schema.annotateKey({ messageMissingKey: "command source is required" })),
+    enabled: Schema.optional(Schema.Boolean),
+}).annotate({
+    identifier: "CommandEntryObject",
+    title: "Command Entry Object",
+    description: "A command with its source location and whether it's enabled.",
+});
+/**
+ * Union of command entry forms: plain source string or object with source + enabled.
+ *
+ * Decodes to canonical `{ source, enabled }` form; encodes back to the most
+ * compact JSON representation (plain string when enabled, object when disabled).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const CommandEntrySchema = Schema.Union([Schema.String, CommandEntryObjectSchema]).pipe(Schema.decodeTo(Schema.Struct({
+    source: Schema.String,
+    enabled: Schema.Boolean,
+}).annotate({
+    identifier: "CommandEntry",
+    title: "Command Entry",
+    description: "A command reference — either a source string like @owner/commands/name or an object with source and enabled.",
+}), SchemaTransformation.transform({
+    decode: (entry) => typeof entry === "string"
+        ? { source: entry, enabled: true }
+        : { source: entry.source, enabled: entry.enabled ?? true },
+    encode: (entry) => entry.enabled ? entry.source : { source: entry.source, enabled: false },
+})));
+/**
+ * Commands map - maps command names to command entries.
+ *
+ * Keys must be valid command names per extension naming conventions:
+ * - Max 64 characters
+ * - Lowercase letters, numbers, and hyphens only
+ * - Must not start or end with a hyphen
+ *
+ * Values are command entries: plain source strings or objects with source + enabled.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const CommandsMapSchema = Schema.Record(Schema.String, CommandEntrySchema)
+    .check(Schema.makeFilter(validateNamedRecordKeys("command", decodeExtensionNameSync)))
+    .annotate({
+    identifier: "CommandsMap",
+    title: "Commands Map",
+    description: "Your installed commands, keyed by name.",
+});
+/**
+ * MCP server entry object with source.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const McpServerEntryObjectSchema = Schema.Struct({
+    source: Schema.String.pipe(Schema.annotateKey({ messageMissingKey: "MCP server source is required" })),
+}).annotate({
+    identifier: "McpServerEntryObject",
+    title: "MCP Server Entry Object",
+    description: "An MCP server with its source location.",
+});
+/**
+ * Union of MCP server entry forms: plain source string or object with source.
+ *
+ * Decodes to canonical `{ source }` form; encodes back to the most compact
+ * JSON representation (plain string).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const McpServerEntrySchema = Schema.Union([Schema.String, McpServerEntryObjectSchema]).pipe(Schema.decodeTo(Schema.Struct({
+    source: Schema.String,
+}).annotate({
+    identifier: "McpServerEntry",
+    title: "MCP Server Entry",
+    description: "An MCP server reference — either a source string or an object with source.",
+}), SchemaTransformation.transform({
+    decode: (entry) => typeof entry === "string" ? { source: entry } : { source: entry.source },
+    encode: (entry) => entry.source,
+})));
+/**
+ * MCP servers map - maps MCP server names to MCP server entries.
+ *
+ * Keys use the canonical MCP server name schema from the shared kernel.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const McpServersMapSchema = Schema.Record(Schema.String, McpServerEntrySchema)
+    .check(Schema.makeFilter(validateNamedRecordKeys("MCP server", decodeExtensionNameSync)))
+    .annotate({
+    identifier: "McpServersMap",
+    title: "MCP Servers Map",
+    description: "Your installed MCP servers, keyed by name.",
+});
+// -----------------------------------------------------------------------------
+// Subagent Entry Schemas
+// -----------------------------------------------------------------------------
+/**
+ * Managed subagent with source and optional config flags.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const SubagentEntryObjectSchema = Schema.Struct({
+    source: Schema.String.pipe(Schema.annotateKey({ messageMissingKey: "subagent source is required" })),
+    enabled: Schema.optional(Schema.Boolean),
+}).annotate({
+    identifier: "SubagentEntryObject",
+    title: "Subagent Entry Object",
+    description: "A subagent with its source location and whether it's enabled.",
+});
+/**
+ * Union of subagent entry forms: plain source string or object with source + enabled.
+ *
+ * Decodes to canonical `{ source, enabled }` form; encodes back to the most
+ * compact JSON representation (plain string when enabled, object when disabled).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const SubagentEntrySchema = Schema.Union([Schema.String, SubagentEntryObjectSchema]).pipe(Schema.decodeTo(Schema.Struct({
+    source: Schema.String,
+    enabled: Schema.Boolean,
+}).annotate({
+    identifier: "SubagentEntry",
+    title: "Subagent Entry",
+    description: "A subagent reference — either a source string like @owner/subagents/name or an object with source and enabled.",
+}), SchemaTransformation.transform({
+    decode: (entry) => typeof entry === "string"
+        ? { source: entry, enabled: true }
+        : { source: entry.source, enabled: entry.enabled ?? true },
+    encode: (entry) => entry.enabled ? entry.source : { source: entry.source, enabled: false },
+})));
+/**
+ * Subagents map - maps subagent names to subagent entries.
+ *
+ * Keys must be valid extension names per agentskills.io specification:
+ * - Max 64 characters
+ * - Lowercase letters, numbers, and hyphens only
+ * - Must not start or end with a hyphen
+ *
+ * Values are subagent entries: plain source strings or objects with source + enabled.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const SubagentsMapSchema = Schema.Record(Schema.String, SubagentEntrySchema)
+    .check(Schema.makeFilter(validateNamedRecordKeys("subagent", decodeExtensionNameSync)))
+    .annotate({
+    identifier: "SubagentsMap",
+    title: "Subagents Map",
+    description: "Your installed subagents, keyed by name.",
+});
+// -----------------------------------------------------------------------------
+// Pack Entry Schemas
+// -----------------------------------------------------------------------------
+/**
+ * Pack entry object with source.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const ExtensionPackEntryObjectSchema = Schema.Struct({
+    source: Schema.String.pipe(Schema.annotateKey({ messageMissingKey: "extension pack source is required" })),
+}).annotate({
+    identifier: "ExtensionPackEntryObject",
+    title: "Extension Pack Entry Object",
+    description: "An extension pack with its source location.",
+});
+/**
+ * Union of pack entry forms: plain source string or object with source.
+ *
+ * Decodes to canonical `{ source }` form; encodes back to the most compact
+ * JSON representation (plain string).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const ExtensionPackEntrySchema = Schema.Union([
+    Schema.String,
+    ExtensionPackEntryObjectSchema,
+]).pipe(Schema.decodeTo(Schema.Struct({
+    source: Schema.String,
+}).annotate({
+    identifier: "ExtensionPackEntry",
+    title: "Extension Pack Entry",
+    description: "An extension pack reference — either a source string or an object with source.",
+}), SchemaTransformation.transform({
+    decode: (entry) => typeof entry === "string" ? { source: entry } : { source: entry.source },
+    encode: (entry) => entry.source,
+})));
+/**
+ * Packs map - maps pack names to pack entries.
+ *
+ * Keys must be valid extension names per agentskills.io specification:
+ * - Max 64 characters
+ * - Lowercase letters, numbers, and hyphens only
+ * - Must not start or end with a hyphen
+ *
+ * Values are pack entries: plain source strings or objects with source.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const ExtensionPacksMapSchema = Schema.Record(Schema.String, ExtensionPackEntrySchema)
+    .check(Schema.makeFilter(validateNamedRecordKeys("extension pack", decodeExtensionNameSync)))
+    .annotate({
+    identifier: "ExtensionPacksMap",
+    title: "Extension Packs Map",
+    description: "Your installed extension packs, keyed by name.",
+});
+// -----------------------------------------------------------------------------
+// Ignored Patterns Schema
+// -----------------------------------------------------------------------------
+/**
+ * Ignored patterns map — per-extension-type arrays of glob patterns
+ * for extensions to exclude from lifecycle classification.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const IgnoredSettingsSchema = Schema.Struct({
+    skills: Schema.optional(Schema.Array(Schema.String)),
+    commands: Schema.optional(Schema.Array(Schema.String)),
+    subagents: Schema.optional(Schema.Array(Schema.String)),
+    mcpServers: Schema.optional(Schema.Array(Schema.String)),
+    packs: Schema.optional(Schema.Array(Schema.String)),
+}).annotate({
+    identifier: "IgnoredSettings",
+    title: "Ignored Settings",
+    description: "Glob patterns for extensions to ignore, grouped by type (e.g. skills, commands).",
+});
+/**
+ * Canonical key order for settings properties.
+ *
+ * Used by `writeSettings` to ensure properties
+ * appear in the same order as defined in `SettingsSchema`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const SETTINGS_KEY_ORDER = [
+    "telemetry",
+    "profile",
+    "sources",
+    "agents",
+    "skills",
+    "commands",
+    "subagents",
+    "packs",
+    "mcpServers",
+    "ignored",
+];
+/**
+ * AXM settings configuration schema.
+ *
+ * Settings define workspace configuration for AXM including:
+ * - profile: Default profile for resolving/publishing extensions
+ * - sources: Source provider configurations
+ * - agents: List of agent IDs to sync extensions to
+ * - skills: Desired skills by name to source string
+ * - commands: Desired commands by name to version specifier
+ * - packs: Desired packs by name to version specifier
+ * - mcp-servers: Desired MCP servers by name to version specifier
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const SettingsSchema = Schema.Struct({
+    telemetry: Schema.optional(Schema.Union([Schema.Boolean, Schema.Literal("errors")])),
+    profile: Schema.optional(HandleSchema),
+    agents: Schema.optional(Schema.Array(AgentIdSchema)),
+    sources: Schema.optional(Schema.Array(SourceHostConfigSchema)),
+    commands: Schema.optional(CommandsMapSchema),
+    subagents: Schema.optional(SubagentsMapSchema),
+    mcpServers: Schema.optional(McpServersMapSchema),
+    packs: Schema.optional(ExtensionPacksMapSchema),
+    skills: Schema.optional(SkillsMapSchema),
+    ignored: Schema.optional(IgnoredSettingsSchema),
+}).annotate({
+    identifier: "Settings",
+    title: "AXM Settings",
+    description: "Your workspace configuration — profile, sources, installed extensions, and ignore patterns.",
+});
+//# sourceMappingURL=schema.js.map

package/dist/src/unstable/settings/schema.js.map

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

package/dist/src/unstable/settings/settings.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Settings management for .axm/settings.json.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+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 { type Settings } from "./schema.js";
+/**
+ * Filename for the settings file.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const SETTINGS_FILENAME = "settings.json";
+/**
+ * Default profile for skill resolution when not specified in settings.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const DEFAULT_PROFILE: string & import("effect/Brand").Brand<"Handle">;
+/**
+ * Create default settings object.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const createDefaultSettings: () => Settings;
+export declare const orderSettingsKeys: (settings: Settings) => Settings;
+/**
+ * Read and parse settings from .axm/settings.json.
+ *
+ * @param axmDir - Path to the .axm directory
+ * @returns Parsed Settings object
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const readSettings: (axmDir: string) => Effect.Effect<Option.Option<{
+    readonly skills?: {
+        readonly [x: string]: {
+            readonly source: string;
+            readonly enabled: boolean;
+        };
+    } | undefined;
+    readonly commands?: {
+        readonly [x: string]: {
+            readonly source: string;
+            readonly enabled: boolean;
+        };
+    } | undefined;
+    readonly subagents?: {
+        readonly [x: string]: {
+            readonly source: string;
+            readonly enabled: boolean;
+        };
+    } | undefined;
+    readonly packs?: {
+        readonly [x: string]: {
+            readonly source: string;
+        };
+    } | undefined;
+    readonly agents?: readonly ("adal" | "amp" | "antigravity" | "augment" | "claude-code" | "cline" | "codebuddy" | "codex" | "command-code" | "continue" | "crush" | "cursor" | "droid" | "gemini-cli" | "github-copilot" | "goose" | "iflow-cli" | "junie" | "kilo" | "kimi-cli" | "kiro-cli" | "kode" | "mcpjam" | "mistral-vibe" | "mux" | "neovate" | "openclaw" | "opencode" | "openhands" | "pi" | "pochi" | "qoder" | "qwen-code" | "replit" | "roo" | "trae" | "trae-cn" | "windsurf" | "zencoder")[] | undefined;
+    readonly mcpServers?: {
+        readonly [x: string]: {
+            readonly source: string;
+        };
+    } | undefined;
+    readonly telemetry?: boolean | "errors" | undefined;
+    readonly profile?: (string & import("effect/Brand").Brand<"Handle">) | undefined;
+    readonly sources?: readonly ({
+        readonly name: string;
+        readonly type: "github";
+        readonly url: URL;
+    } | {
+        readonly name: string;
+        readonly type: "gitlab";
+        readonly url: URL;
+    } | {
+        readonly name: string;
+        readonly type: "bitbucket";
+        readonly url: URL;
+    } | {
+        readonly name: string;
+        readonly type: "azurerepos";
+        readonly url: URL;
+    } | {
+        readonly name: string;
+        readonly type: "registry";
+        readonly location: URL;
+    })[] | undefined;
+    readonly ignored?: {
+        readonly skills?: readonly string[] | undefined;
+        readonly commands?: readonly string[] | undefined;
+        readonly subagents?: readonly string[] | undefined;
+        readonly packs?: readonly string[] | undefined;
+        readonly mcpServers?: readonly string[] | undefined;
+    } | undefined;
+}>, import("../app-error/app-error.ts").AppError, FileSystem.FileSystem | Path.Path>;
+/**
+ * Read settings from .axm/settings.json, falling back to defaults on missing
+ * file or read/parse error.
+ *
+ * @param axmDir - Path to the .axm directory
+ * @returns Settings object (never fails)
+ *
+ * @remarks All errors — including schema validation failures — are silently
+ * swallowed, returning default settings. Only use this in contexts where a
+ * prior check (e.g. workspace-ready) has already validated the settings file.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const readSettingsOrDefault: (axmDir: string) => Effect.Effect<{
+    readonly skills?: {
+        readonly [x: string]: {
+            readonly source: string;
+            readonly enabled: boolean;
+        };
+    } | undefined;
+    readonly commands?: {
+        readonly [x: string]: {
+            readonly source: string;
+            readonly enabled: boolean;
+        };
+    } | undefined;
+    readonly subagents?: {
+        readonly [x: string]: {
+            readonly source: string;
+            readonly enabled: boolean;
+        };
+    } | undefined;
+    readonly packs?: {
+        readonly [x: string]: {
+            readonly source: string;
+        };
+    } | undefined;
+    readonly agents?: readonly ("adal" | "amp" | "antigravity" | "augment" | "claude-code" | "cline" | "codebuddy" | "codex" | "command-code" | "continue" | "crush" | "cursor" | "droid" | "gemini-cli" | "github-copilot" | "goose" | "iflow-cli" | "junie" | "kilo" | "kimi-cli" | "kiro-cli" | "kode" | "mcpjam" | "mistral-vibe" | "mux" | "neovate" | "openclaw" | "opencode" | "openhands" | "pi" | "pochi" | "qoder" | "qwen-code" | "replit" | "roo" | "trae" | "trae-cn" | "windsurf" | "zencoder")[] | undefined;
+    readonly mcpServers?: {
+        readonly [x: string]: {
+            readonly source: string;
+        };
+    } | undefined;
+    readonly telemetry?: boolean | "errors" | undefined;
+    readonly profile?: (string & import("effect/Brand").Brand<"Handle">) | undefined;
+    readonly sources?: readonly ({
+        readonly name: string;
+        readonly type: "github";
+        readonly url: URL;
+    } | {
+        readonly name: string;
+        readonly type: "gitlab";
+        readonly url: URL;
+    } | {
+        readonly name: string;
+        readonly type: "bitbucket";
+        readonly url: URL;
+    } | {
+        readonly name: string;
+        readonly type: "azurerepos";
+        readonly url: URL;
+    } | {
+        readonly name: string;
+        readonly type: "registry";
+        readonly location: URL;
+    })[] | undefined;
+    readonly ignored?: {
+        readonly skills?: readonly string[] | undefined;
+        readonly commands?: readonly string[] | undefined;
+        readonly subagents?: readonly string[] | undefined;
+        readonly packs?: readonly string[] | undefined;
+        readonly mcpServers?: readonly string[] | undefined;
+    } | undefined;
+}, never, FileSystem.FileSystem | Path.Path>;
+/**
+ * Write settings to .axm/settings.json.
+ *
+ * Creates the directory if it doesn't exist. Pretty-prints JSON with 2-space indent.
+ *
+ * @param axmDir - Path to the .axm directory
+ * @param settings - Settings object to write
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const writeSettings: (axmDir: string, settings: Settings) => Effect.Effect<void, import("../app-error/app-error.ts").AppError, FileSystem.FileSystem | Path.Path>;
+//# sourceMappingURL=settings.d.ts.map

package/dist/src/unstable/settings/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../../../src/unstable/settings/settings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAKpC,OAAO,EAAsB,KAAK,QAAQ,EAAkB,MAAM,aAAa,CAAC;AAMhF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,eAAe,iDAAiC,CAAC;AAM9D;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAO,QAAgB,CAAC;AAyB1D,eAAO,MAAM,iBAAiB,GAAI,UAAU,QAAQ,KAAG,QACgB,CAAC;AAMxE;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oFA+BvC,CAAC;AAEL;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4CAIjD,CAAC;AAEJ;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,EAAE,UAAU,QAAQ,yGAyC5D,CAAC"}