@agentxm/client-core 0.1.6

package/dist/src/unstable/settings/ignored-patterns.js

@@ -0,0 +1,46 @@
+/**
+ * Normalization and validation for ignored extension patterns.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Array from "effect/Array";
+import * as Effect from "effect/Effect";
+import { makeAppError } from "../app-error/index.js";
+import { expandGlob } from "../utils/glob.js";
+/**
+ * Normalize ignored patterns: trim whitespace, reject empty patterns, deduplicate.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const normalizeIgnoredPatterns = (patterns) => Effect.gen(function* () {
+    const trimmed = Array.map(patterns, (p) => p.trim());
+    const invalid = Array.filter(trimmed, (p) => p.length === 0);
+    if (invalid.length > 0) {
+        return yield* makeAppError({
+            code: "SETTINGS_IGNORED_PATTERN_INVALID",
+            what: "Ignored pattern is empty after trimming whitespace",
+            howToFix: "Remove empty ignored patterns from settings",
+        });
+    }
+    return Array.dedupe(trimmed);
+});
+/**
+ * Validate that no configured extension names conflict with ignored patterns.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const validateIgnoredConfigConflicts = (configuredNames, ignoredPatterns) => Effect.gen(function* () {
+    if (configuredNames.length === 0 || ignoredPatterns.length === 0)
+        return;
+    const conflicts = Array.filter(configuredNames, (name) => Array.some(ignoredPatterns, (pattern) => expandGlob(pattern, [name]).length > 0));
+    if (conflicts.length > 0) {
+        return yield* makeAppError({
+            code: "SETTINGS_IGNORED_CONFIG_CONFLICT",
+            what: `Configured extensions conflict with ignored patterns: ${conflicts.join(", ")}`,
+            details: conflicts,
+            howToFix: "Remove conflicting entries from either the configured extensions or the ignored patterns in settings",
+        });
+    }
+});
+//# sourceMappingURL=ignored-patterns.js.map

package/dist/src/unstable/settings/ignored-patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignored-patterns.js","sourceRoot":"","sources":["../../../../src/unstable/settings/ignored-patterns.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,QAA+B,EAAE,EAAE,CAC1E,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;IAC7D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC,CAAC,YAAY,CAAC;YACzB,IAAI,EAAE,kCAAkC;YACxC,IAAI,EAAE,oDAAoD;YAC1D,QAAQ,EAAE,6CAA6C;SACxD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC,CAAC,CAAC;AAEL;;;;GAIG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAC5C,eAAsC,EACtC,eAAsC,EACtC,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACzE,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,CACvD,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CACjF,CAAC;IACF,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,CAAC,YAAY,CAAC;YACzB,IAAI,EAAE,kCAAkC;YACxC,IAAI,EAAE,yDAAyD,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACrF,OAAO,EAAE,SAAS;YAClB,QAAQ,EACN,sGAAsG;SACzG,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * Settings feature module.
+ *
+ * Provides settings schema definitions and I/O functions for managing
+ * the `.axm/settings.json` configuration file.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export type { AzureReposSourceHostConfig, BitbucketSourceHostConfig, CommandEntry, CommandsMap, GitHubSourceHostConfig, GitLabSourceHostConfig, IgnoredSettings, McpServerEntry, McpServersMap, ExtensionPackEntry, ExtensionPacksMap, RegistrySourceHostConfig, Settings, SkillEntry, SkillsMap, SubagentEntry, SubagentsMap, SourceHostConfig, } from "./schema.js";
+export { CommandEntryObjectSchema, CommandEntrySchema, CommandsMapSchema, IgnoredSettingsSchema, McpServerEntryObjectSchema, McpServerEntrySchema, McpServersMapSchema, ExtensionPackEntryObjectSchema, ExtensionPackEntrySchema, ExtensionPacksMapSchema, SETTINGS_KEY_ORDER, SettingsSchema, SkillEntryObjectSchema, SkillEntrySchema, SkillsMapSchema, SubagentEntryObjectSchema, SubagentEntrySchema, SubagentsMapSchema, SourceHostConfigSchema, } from "./schema.js";
+export { normalizeIgnoredPatterns, validateIgnoredConfigConflicts } from "./ignored-patterns.js";
+export { createDefaultSettings, DEFAULT_PROFILE, orderSettingsKeys, readSettings, readSettingsOrDefault, SETTINGS_FILENAME, writeSettings, } from "./settings.js";
+export type { JsonModification } from "./format-preserving-json.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/unstable/settings/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,YAAY,EACZ,WAAW,EACX,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,QAAQ,EACR,UAAU,EACV,SAAS,EACT,aAAa,EACb,YAAY,EACZ,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,EACnB,8BAA8B,EAC9B,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAGjG,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,GACd,MAAM,eAAe,CAAC;AAGvB,YAAY,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * Settings feature module.
+ *
+ * Provides settings schema definitions and I/O functions for managing
+ * the `.axm/settings.json` configuration file.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { CommandEntryObjectSchema, CommandEntrySchema, CommandsMapSchema, IgnoredSettingsSchema, McpServerEntryObjectSchema, McpServerEntrySchema, McpServersMapSchema, ExtensionPackEntryObjectSchema, ExtensionPackEntrySchema, ExtensionPacksMapSchema, SETTINGS_KEY_ORDER, SettingsSchema, SkillEntryObjectSchema, SkillEntrySchema, SkillsMapSchema, SubagentEntryObjectSchema, SubagentEntrySchema, SubagentsMapSchema, SourceHostConfigSchema, } from "./schema.js";
+// Ignored patterns
+export { normalizeIgnoredPatterns, validateIgnoredConfigConflicts } from "./ignored-patterns.js";
+// Settings I/O
+export { createDefaultSettings, DEFAULT_PROFILE, orderSettingsKeys, readSettings, readSettingsOrDefault, SETTINGS_FILENAME, writeSettings, } from "./settings.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/unstable/settings/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAuBH,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,EACnB,8BAA8B,EAC9B,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAErB,mBAAmB;AACnB,OAAO,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAEjG,eAAe;AACf,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,GACd,MAAM,eAAe,CAAC"}

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

@@ -0,0 +1,478 @@
+/**
+ * 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";
+/**
+ * GitHub source host configuration.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+declare const GitHubSourceHostConfigSchema: Schema.Struct<{
+    readonly name: Schema.String;
+    readonly type: Schema.Literal<"github">;
+    readonly url: Schema.URLFromString;
+}>;
+/**
+ * GitLab source host configuration.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+declare const GitLabSourceHostConfigSchema: Schema.Struct<{
+    readonly name: Schema.String;
+    readonly type: Schema.Literal<"gitlab">;
+    readonly url: Schema.URLFromString;
+}>;
+/**
+ * Bitbucket source host configuration.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+declare const BitbucketSourceHostConfigSchema: Schema.Struct<{
+    readonly name: Schema.String;
+    readonly type: Schema.Literal<"bitbucket">;
+    readonly url: Schema.URLFromString;
+}>;
+/**
+ * Azure Repos source host configuration.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+declare const AzureReposSourceHostConfigSchema: Schema.Struct<{
+    readonly name: Schema.String;
+    readonly type: Schema.Literal<"azurerepos">;
+    readonly url: Schema.URLFromString;
+}>;
+/**
+ * Registry source host configuration.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+declare const RegistrySourceHostConfigSchema: Schema.Struct<{
+    readonly name: Schema.String;
+    readonly type: Schema.Literal<"registry">;
+    readonly location: Schema.URLFromString;
+}>;
+/**
+ * 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 declare const SourceHostConfigSchema: Schema.Union<readonly [Schema.Struct<{
+    readonly name: Schema.String;
+    readonly type: Schema.Literal<"github">;
+    readonly url: Schema.URLFromString;
+}>, Schema.Struct<{
+    readonly name: Schema.String;
+    readonly type: Schema.Literal<"gitlab">;
+    readonly url: Schema.URLFromString;
+}>, Schema.Struct<{
+    readonly name: Schema.String;
+    readonly type: Schema.Literal<"bitbucket">;
+    readonly url: Schema.URLFromString;
+}>, Schema.Struct<{
+    readonly name: Schema.String;
+    readonly type: Schema.Literal<"azurerepos">;
+    readonly url: Schema.URLFromString;
+}>, Schema.Struct<{
+    readonly name: Schema.String;
+    readonly type: Schema.Literal<"registry">;
+    readonly location: Schema.URLFromString;
+}>]>;
+/**
+ * Inferred type for SourceHostConfig schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type SourceHostConfig = Schema.Schema.Type<typeof SourceHostConfigSchema>;
+/** @experimental */
+export type GitHubSourceHostConfig = Schema.Schema.Type<typeof GitHubSourceHostConfigSchema>;
+/** @experimental */
+export type GitLabSourceHostConfig = Schema.Schema.Type<typeof GitLabSourceHostConfigSchema>;
+/** @experimental */
+export type BitbucketSourceHostConfig = Schema.Schema.Type<typeof BitbucketSourceHostConfigSchema>;
+/** @experimental */
+export type AzureReposSourceHostConfig = Schema.Schema.Type<typeof AzureReposSourceHostConfigSchema>;
+/** @experimental */
+export type RegistrySourceHostConfig = Schema.Schema.Type<typeof RegistrySourceHostConfigSchema>;
+/**
+ * Managed skill with source and optional config flags.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const SkillEntryObjectSchema: Schema.Struct<{
+    readonly source: Schema.String;
+    readonly enabled: Schema.optional<Schema.Boolean>;
+}>;
+/**
+ * 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 declare const SkillEntrySchema: Schema.decodeTo<Schema.Struct<{
+    readonly source: Schema.String;
+    readonly enabled: Schema.Boolean;
+}>, Schema.Union<readonly [Schema.String, Schema.Struct<{
+    readonly source: Schema.String;
+    readonly enabled: Schema.optional<Schema.Boolean>;
+}>]>, never, never>;
+/**
+ * Inferred type for SkillEntry schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type SkillEntry = Schema.Schema.Type<typeof SkillEntrySchema>;
+/**
+ * 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 declare const SkillsMapSchema: Schema.$Record<Schema.String, Schema.decodeTo<Schema.Struct<{
+    readonly source: Schema.String;
+    readonly enabled: Schema.Boolean;
+}>, Schema.Union<readonly [Schema.String, Schema.Struct<{
+    readonly source: Schema.String;
+    readonly enabled: Schema.optional<Schema.Boolean>;
+}>]>, never, never>>;
+/**
+ * Inferred type for SkillsMap schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type SkillsMap = Schema.Schema.Type<typeof SkillsMapSchema>;
+/**
+ * Managed command with source and optional config flags.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const CommandEntryObjectSchema: Schema.Struct<{
+    readonly source: Schema.String;
+    readonly enabled: Schema.optional<Schema.Boolean>;
+}>;
+/**
+ * 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 declare const CommandEntrySchema: Schema.decodeTo<Schema.Struct<{
+    readonly source: Schema.String;
+    readonly enabled: Schema.Boolean;
+}>, Schema.Union<readonly [Schema.String, Schema.Struct<{
+    readonly source: Schema.String;
+    readonly enabled: Schema.optional<Schema.Boolean>;
+}>]>, never, never>;
+/**
+ * Inferred type for CommandEntry schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type CommandEntry = Schema.Schema.Type<typeof CommandEntrySchema>;
+/**
+ * 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 declare const CommandsMapSchema: Schema.$Record<Schema.String, Schema.decodeTo<Schema.Struct<{
+    readonly source: Schema.String;
+    readonly enabled: Schema.Boolean;
+}>, Schema.Union<readonly [Schema.String, Schema.Struct<{
+    readonly source: Schema.String;
+    readonly enabled: Schema.optional<Schema.Boolean>;
+}>]>, never, never>>;
+/**
+ * Inferred type for CommandsMap schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type CommandsMap = Schema.Schema.Type<typeof CommandsMapSchema>;
+/**
+ * MCP server entry object with source.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const McpServerEntryObjectSchema: Schema.Struct<{
+    readonly source: Schema.String;
+}>;
+/**
+ * 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 declare const McpServerEntrySchema: Schema.decodeTo<Schema.Struct<{
+    readonly source: Schema.String;
+}>, Schema.Union<readonly [Schema.String, Schema.Struct<{
+    readonly source: Schema.String;
+}>]>, never, never>;
+/**
+ * Inferred type for McpServerEntry schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type McpServerEntry = Schema.Schema.Type<typeof McpServerEntrySchema>;
+/**
+ * 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 declare const McpServersMapSchema: Schema.$Record<Schema.String, Schema.decodeTo<Schema.Struct<{
+    readonly source: Schema.String;
+}>, Schema.Union<readonly [Schema.String, Schema.Struct<{
+    readonly source: Schema.String;
+}>]>, never, never>>;
+/**
+ * Inferred type for McpServersMap schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type McpServersMap = Schema.Schema.Type<typeof McpServersMapSchema>;
+/**
+ * Managed subagent with source and optional config flags.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const SubagentEntryObjectSchema: Schema.Struct<{
+    readonly source: Schema.String;
+    readonly enabled: Schema.optional<Schema.Boolean>;
+}>;
+/**
+ * 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 declare const SubagentEntrySchema: Schema.decodeTo<Schema.Struct<{
+    readonly source: Schema.String;
+    readonly enabled: Schema.Boolean;
+}>, Schema.Union<readonly [Schema.String, Schema.Struct<{
+    readonly source: Schema.String;
+    readonly enabled: Schema.optional<Schema.Boolean>;
+}>]>, never, never>;
+/**
+ * Inferred type for SubagentEntry schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type SubagentEntry = Schema.Schema.Type<typeof SubagentEntrySchema>;
+/**
+ * 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 declare const SubagentsMapSchema: Schema.$Record<Schema.String, Schema.decodeTo<Schema.Struct<{
+    readonly source: Schema.String;
+    readonly enabled: Schema.Boolean;
+}>, Schema.Union<readonly [Schema.String, Schema.Struct<{
+    readonly source: Schema.String;
+    readonly enabled: Schema.optional<Schema.Boolean>;
+}>]>, never, never>>;
+/**
+ * Inferred type for SubagentsMap schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type SubagentsMap = Schema.Schema.Type<typeof SubagentsMapSchema>;
+/**
+ * Pack entry object with source.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const ExtensionPackEntryObjectSchema: Schema.Struct<{
+    readonly source: Schema.String;
+}>;
+/**
+ * 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 declare const ExtensionPackEntrySchema: Schema.decodeTo<Schema.Struct<{
+    readonly source: Schema.String;
+}>, Schema.Union<readonly [Schema.String, Schema.Struct<{
+    readonly source: Schema.String;
+}>]>, never, never>;
+/**
+ * Inferred type for ExtensionPackEntry schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type ExtensionPackEntry = Schema.Schema.Type<typeof ExtensionPackEntrySchema>;
+/**
+ * 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 declare const ExtensionPacksMapSchema: Schema.$Record<Schema.String, Schema.decodeTo<Schema.Struct<{
+    readonly source: Schema.String;
+}>, Schema.Union<readonly [Schema.String, Schema.Struct<{
+    readonly source: Schema.String;
+}>]>, never, never>>;
+/**
+ * Inferred type for ExtensionPacksMap schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type ExtensionPacksMap = Schema.Schema.Type<typeof ExtensionPacksMapSchema>;
+/**
+ * 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 declare const IgnoredSettingsSchema: Schema.Struct<{
+    readonly skills: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly commands: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly subagents: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly mcpServers: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly packs: Schema.optional<Schema.$Array<Schema.String>>;
+}>;
+/**
+ * Inferred type for IgnoredSettings schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type IgnoredSettings = Schema.Schema.Type<typeof IgnoredSettingsSchema>;
+/**
+ * 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 declare const SETTINGS_KEY_ORDER: ReadonlyArray<string>;
+/**
+ * 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 declare const SettingsSchema: Schema.Struct<{
+    readonly telemetry: Schema.optional<Schema.Union<readonly [Schema.Boolean, Schema.Literal<"errors">]>>;
+    readonly profile: Schema.optional<Schema.brand<Schema.String, "Handle">>;
+    readonly agents: Schema.optional<Schema.$Array<Schema.Literals<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"]>>>;
+    readonly sources: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+        readonly name: Schema.String;
+        readonly type: Schema.Literal<"github">;
+        readonly url: Schema.URLFromString;
+    }>, Schema.Struct<{
+        readonly name: Schema.String;
+        readonly type: Schema.Literal<"gitlab">;
+        readonly url: Schema.URLFromString;
+    }>, Schema.Struct<{
+        readonly name: Schema.String;
+        readonly type: Schema.Literal<"bitbucket">;
+        readonly url: Schema.URLFromString;
+    }>, Schema.Struct<{
+        readonly name: Schema.String;
+        readonly type: Schema.Literal<"azurerepos">;
+        readonly url: Schema.URLFromString;
+    }>, Schema.Struct<{
+        readonly name: Schema.String;
+        readonly type: Schema.Literal<"registry">;
+        readonly location: Schema.URLFromString;
+    }>]>>>;
+    readonly commands: Schema.optional<Schema.$Record<Schema.String, Schema.decodeTo<Schema.Struct<{
+        readonly source: Schema.String;
+        readonly enabled: Schema.Boolean;
+    }>, Schema.Union<readonly [Schema.String, Schema.Struct<{
+        readonly source: Schema.String;
+        readonly enabled: Schema.optional<Schema.Boolean>;
+    }>]>, never, never>>>;
+    readonly subagents: Schema.optional<Schema.$Record<Schema.String, Schema.decodeTo<Schema.Struct<{
+        readonly source: Schema.String;
+        readonly enabled: Schema.Boolean;
+    }>, Schema.Union<readonly [Schema.String, Schema.Struct<{
+        readonly source: Schema.String;
+        readonly enabled: Schema.optional<Schema.Boolean>;
+    }>]>, never, never>>>;
+    readonly mcpServers: Schema.optional<Schema.$Record<Schema.String, Schema.decodeTo<Schema.Struct<{
+        readonly source: Schema.String;
+    }>, Schema.Union<readonly [Schema.String, Schema.Struct<{
+        readonly source: Schema.String;
+    }>]>, never, never>>>;
+    readonly packs: Schema.optional<Schema.$Record<Schema.String, Schema.decodeTo<Schema.Struct<{
+        readonly source: Schema.String;
+    }>, Schema.Union<readonly [Schema.String, Schema.Struct<{
+        readonly source: Schema.String;
+    }>]>, never, never>>>;
+    readonly skills: Schema.optional<Schema.$Record<Schema.String, Schema.decodeTo<Schema.Struct<{
+        readonly source: Schema.String;
+        readonly enabled: Schema.Boolean;
+    }>, Schema.Union<readonly [Schema.String, Schema.Struct<{
+        readonly source: Schema.String;
+        readonly enabled: Schema.optional<Schema.Boolean>;
+    }>]>, never, never>>>;
+    readonly ignored: Schema.optional<Schema.Struct<{
+        readonly skills: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly commands: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly subagents: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly mcpServers: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly packs: Schema.optional<Schema.$Array<Schema.String>>;
+    }>>;
+}>;
+/**
+ * Inferred type for Settings schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type Settings = Schema.Schema.Type<typeof SettingsSchema>;
+export {};
+//# sourceMappingURL=schema.d.ts.map

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

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