@agentxm/workspace-state 0.28.4-bootstrap.0

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

@@ -0,0 +1,687 @@
+/**
+ * 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 { ReleaseAgeExcludePatternSchema } from "@agentxm/extension-model/unstable/extensions/fqn-pattern";
+/**
+ * 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>;
+type SourceEntryObject = {
+    readonly source: string;
+};
+type EnabledEntryObject = SourceEntryObject & {
+    readonly enabled?: boolean | undefined;
+};
+export declare const MinimumReleaseAgeSchema: Schema.String;
+/** @experimental */
+export type MinimumReleaseAge = Schema.Schema.Type<typeof MinimumReleaseAgeSchema>;
+/** @experimental */
+export type MinimumReleaseAgeExclude = ReadonlyArray<typeof ReleaseAgeExcludePatternSchema.Type>;
+/**
+ * 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.NonEmptyString;
+    readonly enabled: Schema.optionalKey<Schema.Boolean>;
+    readonly origin: Schema.optionalKey<Schema.Literal<"bundled">>;
+}>;
+/**
+ * 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.
+ *
+ * @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;
+    readonly origin: Schema.optionalKey<Schema.Literal<"bundled">>;
+}>, Schema.Union<readonly [Schema.String, Schema.Struct<{
+    readonly source: Schema.NonEmptyString;
+    readonly enabled: Schema.optionalKey<Schema.Boolean>;
+    readonly origin: Schema.optionalKey<Schema.Literal<"bundled">>;
+}>]>, 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;
+    readonly origin: Schema.optionalKey<Schema.Literal<"bundled">>;
+}>, Schema.Union<readonly [Schema.String, Schema.Struct<{
+    readonly source: Schema.NonEmptyString;
+    readonly enabled: Schema.optionalKey<Schema.Boolean>;
+    readonly origin: Schema.optionalKey<Schema.Literal<"bundled">>;
+}>]>, 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 rule with source and optional config flags.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const RuleEntryObjectSchema: Schema.Struct<{
+    readonly source: Schema.NonEmptyString;
+    readonly enabled: Schema.optionalKey<Schema.Boolean>;
+}>;
+/**
+ * Union of rule entry forms: plain source string or object with source + enabled.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const RuleEntrySchema: Schema.decodeTo<Schema.Struct<{
+    readonly source: Schema.String;
+    readonly enabled: Schema.Boolean;
+}>, Schema.Union<readonly [Schema.String, Schema.Codec<EnabledEntryObject, EnabledEntryObject, never, never>]>, never, never>;
+/** @experimental */
+export type RuleEntry = Schema.Schema.Type<typeof RuleEntrySchema>;
+/**
+ * Rules map - maps rule names to rule entries.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const RulesMapSchema: Schema.$Record<Schema.String, Schema.decodeTo<Schema.Struct<{
+    readonly source: Schema.String;
+    readonly enabled: Schema.Boolean;
+}>, Schema.Union<readonly [Schema.String, Schema.Codec<EnabledEntryObject, EnabledEntryObject, never, never>]>, never, never>>;
+/** @experimental */
+export type RulesMap = Schema.Schema.Type<typeof RulesMapSchema>;
+/**
+ * Managed hook with source and optional config flags.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const HookEntryObjectSchema: Schema.Struct<{
+    readonly source: Schema.NonEmptyString;
+    readonly enabled: Schema.optionalKey<Schema.Boolean>;
+}>;
+/**
+ * Union of hook entry forms: plain source string or object with source + enabled.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const HookEntrySchema: Schema.decodeTo<Schema.Struct<{
+    readonly source: Schema.String;
+    readonly enabled: Schema.Boolean;
+}>, Schema.Union<readonly [Schema.String, Schema.Codec<EnabledEntryObject, EnabledEntryObject, never, never>]>, never, never>;
+/** @experimental */
+export type HookEntry = Schema.Schema.Type<typeof HookEntrySchema>;
+/**
+ * Hooks map - maps hook names to hook entries.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const HooksMapSchema: Schema.$Record<Schema.String, Schema.decodeTo<Schema.Struct<{
+    readonly source: Schema.String;
+    readonly enabled: Schema.Boolean;
+}>, Schema.Union<readonly [Schema.String, Schema.Codec<EnabledEntryObject, EnabledEntryObject, never, never>]>, never, never>>;
+/** @experimental */
+export type HooksMap = Schema.Schema.Type<typeof HooksMapSchema>;
+export declare const KnowledgeEntryObjectSchema: Schema.Struct<{
+    readonly source: Schema.NonEmptyString;
+    readonly enabled: Schema.optionalKey<Schema.Boolean>;
+    readonly instructionEntry: Schema.optionalKey<Schema.Boolean>;
+}>;
+export declare const KnowledgeEntrySchema: Schema.decodeTo<Schema.Struct<{
+    readonly source: Schema.String;
+    readonly enabled: Schema.Boolean;
+    readonly instructionEntry: Schema.optionalKey<Schema.Boolean>;
+}>, Schema.Union<readonly [Schema.String, Schema.Struct<{
+    readonly source: Schema.NonEmptyString;
+    readonly enabled: Schema.optionalKey<Schema.Boolean>;
+    readonly instructionEntry: Schema.optionalKey<Schema.Boolean>;
+}>]>, never, never>;
+export type KnowledgeEntry = Schema.Schema.Type<typeof KnowledgeEntrySchema>;
+export declare const KnowledgeMapSchema: Schema.$Record<Schema.String, Schema.decodeTo<Schema.Struct<{
+    readonly source: Schema.String;
+    readonly enabled: Schema.Boolean;
+    readonly instructionEntry: Schema.optionalKey<Schema.Boolean>;
+}>, Schema.Union<readonly [Schema.String, Schema.Struct<{
+    readonly source: Schema.NonEmptyString;
+    readonly enabled: Schema.optionalKey<Schema.Boolean>;
+    readonly instructionEntry: Schema.optionalKey<Schema.Boolean>;
+}>]>, never, never>>;
+export type KnowledgeMap = Schema.Schema.Type<typeof KnowledgeMapSchema>;
+/**
+ * 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.NonEmptyString;
+    readonly enabled: Schema.optionalKey<Schema.Boolean>;
+    readonly env: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.String>, Schema.$Array<Schema.String>]>>;
+    readonly agents: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["adal", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow"]>>>;
+}>;
+/**
+ * Union of MCP server entry forms: plain source string or object with source + enabled + env.
+ *
+ * Decodes to canonical `{ source, enabled, env }` form; encodes back to the most
+ * compact JSON representation.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const McpServerEntrySchema: Schema.decodeTo<Schema.Union<readonly [Schema.Struct<{
+    readonly kind: Schema.optional<Schema.Literal<"sourced">>;
+    readonly source: Schema.String;
+    readonly command: Schema.optional<Schema.String>;
+    readonly args: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly url: Schema.optional<Schema.String>;
+    readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+    readonly enabled: Schema.Boolean;
+    readonly env: Schema.$Record<Schema.String, Schema.String>;
+    readonly agents: Schema.optional<Schema.$Array<Schema.Literals<readonly ["adal", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow"]>>>;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"inline">;
+    readonly source: Schema.optional<Schema.Never>;
+    readonly command: Schema.optional<Schema.String>;
+    readonly args: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly url: Schema.optional<Schema.String>;
+    readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+    readonly enabled: Schema.Boolean;
+    readonly env: Schema.$Record<Schema.String, Schema.String>;
+    readonly agents: Schema.optional<Schema.$Array<Schema.Literals<readonly ["adal", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow"]>>>;
+}>]>, Schema.Union<readonly [Schema.String, Schema.Struct<{
+    readonly source: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly command: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly args: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    readonly url: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly headers: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+    readonly enabled: Schema.optionalKey<Schema.Boolean>;
+    readonly env: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.String>, Schema.$Array<Schema.String>]>>;
+    readonly agents: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["adal", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow"]>>>;
+}>]>, 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>;
+export declare const isSourcedMcpServerEntry: (entry: McpServerEntry) => entry is McpServerEntry & {
+    readonly source: string;
+};
+export declare const isInlineMcpServerEntry: (entry: McpServerEntry) => entry is Extract<McpServerEntry, {
+    readonly kind: "inline";
+}>;
+/**
+ * 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.Union<readonly [Schema.Struct<{
+    readonly kind: Schema.optional<Schema.Literal<"sourced">>;
+    readonly source: Schema.String;
+    readonly command: Schema.optional<Schema.String>;
+    readonly args: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly url: Schema.optional<Schema.String>;
+    readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+    readonly enabled: Schema.Boolean;
+    readonly env: Schema.$Record<Schema.String, Schema.String>;
+    readonly agents: Schema.optional<Schema.$Array<Schema.Literals<readonly ["adal", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow"]>>>;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"inline">;
+    readonly source: Schema.optional<Schema.Never>;
+    readonly command: Schema.optional<Schema.String>;
+    readonly args: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly url: Schema.optional<Schema.String>;
+    readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+    readonly enabled: Schema.Boolean;
+    readonly env: Schema.$Record<Schema.String, Schema.String>;
+    readonly agents: Schema.optional<Schema.$Array<Schema.Literals<readonly ["adal", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow"]>>>;
+}>]>, Schema.Union<readonly [Schema.String, Schema.Struct<{
+    readonly source: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly command: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly args: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    readonly url: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly headers: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+    readonly enabled: Schema.optionalKey<Schema.Boolean>;
+    readonly env: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.String>, Schema.$Array<Schema.String>]>>;
+    readonly agents: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["adal", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow"]>>>;
+}>]>, 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.NonEmptyString;
+    readonly enabled: Schema.optionalKey<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.
+ *
+ * @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.Codec<EnabledEntryObject, EnabledEntryObject, never, never>]>, 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.Codec<EnabledEntryObject, EnabledEntryObject, never, never>]>, 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 PackEntryObjectSchema: Schema.Struct<{
+    readonly source: Schema.NonEmptyString;
+    readonly enabled: Schema.optionalKey<Schema.Boolean>;
+}>;
+/**
+ * Union of pack entry forms: plain source string or object with source.
+ *
+ * Decodes to canonical `{ source }` form and encodes back to a source string.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const PackEntrySchema: Schema.decodeTo<Schema.Struct<{
+    readonly source: Schema.String;
+    readonly enabled: Schema.Boolean;
+}>, Schema.Union<readonly [Schema.String, Schema.Codec<EnabledEntryObject, EnabledEntryObject, never, never>]>, never, never>;
+/**
+ * Inferred type for PackEntry schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type PackEntry = Schema.Schema.Type<typeof PackEntrySchema>;
+/**
+ * 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 + enabled.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const PacksMapSchema: Schema.$Record<Schema.String, Schema.decodeTo<Schema.Struct<{
+    readonly source: Schema.String;
+    readonly enabled: Schema.Boolean;
+}>, Schema.Union<readonly [Schema.String, Schema.Codec<EnabledEntryObject, EnabledEntryObject, never, never>]>, never, never>>;
+/**
+ * Inferred type for PacksMap schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type PacksMap = Schema.Schema.Type<typeof PacksMapSchema>;
+/**
+ * Workspace instruction-file propagation settings.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const InstructionsConfigSchema: Schema.Struct<{
+    readonly fileName: Schema.optionalKey<Schema.String>;
+    readonly gitignoreAliases: Schema.optionalKey<Schema.Boolean>;
+}>;
+/** @experimental */
+export type InstructionsConfig = Schema.Schema.Type<typeof InstructionsConfigSchema>;
+/** @experimental */
+export type InstructionsConfigValue = false | InstructionsConfig;
+export declare const SkillsConfigSchema: Schema.Struct<{
+    readonly dir: Schema.optionalKey<Schema.NonEmptyString>;
+}>;
+export declare const RulesConfigSchema: Schema.Struct<{
+    readonly dir: Schema.optionalKey<Schema.NonEmptyString>;
+}>;
+export declare const HooksConfigSchema: Schema.Struct<{
+    readonly dir: Schema.optionalKey<Schema.NonEmptyString>;
+}>;
+export declare const SubagentsConfigSchema: Schema.Struct<{
+    readonly dir: Schema.optionalKey<Schema.NonEmptyString>;
+}>;
+export declare const McpServersConfigSchema: Schema.Struct<{
+    readonly dir: Schema.optionalKey<Schema.NonEmptyString>;
+}>;
+export declare const PacksConfigSchema: Schema.Struct<{
+    readonly dir: Schema.optionalKey<Schema.NonEmptyString>;
+}>;
+export declare const KnowledgeConfigSchema: Schema.Struct<{
+    readonly dir: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly instructions: Schema.optionalKey<Schema.Boolean>;
+}>;
+/** @experimental */
+export type KnowledgeConfig = Schema.Schema.Type<typeof KnowledgeConfigSchema>;
+/** Workspace-level publication defaults. */
+export declare const WorkspacePublishOptionsSchema: Schema.Struct<{
+    readonly defaultVisibility: Schema.optional<Schema.Literals<readonly ["public", "private"]>>;
+}>;
+/** @experimental This API is unstable and may change without notice. */
+export type WorkspacePublishOptions = Schema.Schema.Type<typeof WorkspacePublishOptionsSchema>;
+/**
+ * Each catalog extension type's feature-level config schema, or `null` where
+ * none exists yet.
+ *
+ * Total by construction: a new extension type fails compile here until its
+ * settings coverage is decided. The parity conformance suite reads this map,
+ * and every `null` must be matched by a ledger row.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const SETTINGS_CONFIG_SCHEMA_BY_TYPE: {
+    readonly skill: Schema.Struct<{
+        readonly dir: Schema.optionalKey<Schema.NonEmptyString>;
+    }>;
+    readonly "mcp-server": Schema.Struct<{
+        readonly dir: Schema.optionalKey<Schema.NonEmptyString>;
+    }>;
+    readonly subagent: Schema.Struct<{
+        readonly dir: Schema.optionalKey<Schema.NonEmptyString>;
+    }>;
+    readonly rule: Schema.Struct<{
+        readonly dir: Schema.optionalKey<Schema.NonEmptyString>;
+    }>;
+    readonly hook: Schema.Struct<{
+        readonly dir: Schema.optionalKey<Schema.NonEmptyString>;
+    }>;
+    readonly knowledge: Schema.Struct<{
+        readonly dir: Schema.optionalKey<Schema.NonEmptyString>;
+        readonly instructions: Schema.optionalKey<Schema.Boolean>;
+    }>;
+};
+/**
+ * Canonical key order for settings properties.
+ *
+ * Used by `writeSettingsAtPath` for new files and to place new top-level keys in
+ * existing files whose recognized keys already follow this order.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const SETTINGS_KEY_ORDER: ReadonlyArray<string>;
+export declare const SettingsSchema: Schema.StructWithRest<Schema.Struct<{
+    readonly $schema: Schema.optionalKey<Schema.String>;
+    readonly owner: Schema.optionalKey<Schema.Union<readonly [Schema.brand<Schema.String, "Handle">]>>;
+    readonly publish: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+        readonly defaultVisibility: Schema.optional<Schema.Literals<readonly ["public", "private"]>>;
+    }>]>>;
+    readonly minimumReleaseAge: Schema.optionalKey<Schema.Union<readonly [Schema.String]>>;
+    readonly minimumReleaseAgeExclude: Schema.optionalKey<Schema.$Array<Schema.decodeTo<Schema.toType<Schema.Struct<{
+        readonly owner: Schema.brand<Schema.String, "Handle">;
+        readonly type: Schema.Union<readonly [Schema.Literals<readonly ("skill" | "mcp-server" | "subagent" | "rule" | "hook" | "knowledge" | "pack")[]>, Schema.Literal<"*">]>;
+        readonly name: Schema.Union<readonly [Schema.brand<Schema.NonEmptyString, "ExtensionName">, Schema.Literal<"*">]>;
+    }>>, Schema.String, never, never>>>;
+    readonly agents: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["adal", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow"]>>>;
+    readonly instructionFiles: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<false>, Schema.Struct<{
+        readonly fileName: Schema.optionalKey<Schema.String>;
+        readonly gitignoreAliases: Schema.optionalKey<Schema.Boolean>;
+    }>]>>;
+    readonly sources: Schema.optionalKey<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 skills: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.decodeTo<Schema.Struct<{
+        readonly source: Schema.String;
+        readonly enabled: Schema.Boolean;
+        readonly origin: Schema.optionalKey<Schema.Literal<"bundled">>;
+    }>, Schema.Union<readonly [Schema.String, Schema.Struct<{
+        readonly source: Schema.NonEmptyString;
+        readonly enabled: Schema.optionalKey<Schema.Boolean>;
+        readonly origin: Schema.optionalKey<Schema.Literal<"bundled">>;
+    }>]>, never, never>>]>>;
+    readonly skillsConfig: Schema.optionalKey<Schema.Struct<{
+        readonly dir: Schema.optionalKey<Schema.NonEmptyString>;
+    }>>;
+    readonly rules: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.decodeTo<Schema.Struct<{
+        readonly source: Schema.String;
+        readonly enabled: Schema.Boolean;
+    }>, Schema.Union<readonly [Schema.String, Schema.Codec<EnabledEntryObject, EnabledEntryObject, never, never>]>, never, never>>]>>;
+    readonly rulesConfig: Schema.optionalKey<Schema.Struct<{
+        readonly dir: Schema.optionalKey<Schema.NonEmptyString>;
+    }>>;
+    readonly hooks: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.decodeTo<Schema.Struct<{
+        readonly source: Schema.String;
+        readonly enabled: Schema.Boolean;
+    }>, Schema.Union<readonly [Schema.String, Schema.Codec<EnabledEntryObject, EnabledEntryObject, never, never>]>, never, never>>]>>;
+    readonly hooksConfig: Schema.optionalKey<Schema.Struct<{
+        readonly dir: Schema.optionalKey<Schema.NonEmptyString>;
+    }>>;
+    readonly knowledge: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.decodeTo<Schema.Struct<{
+        readonly source: Schema.String;
+        readonly enabled: Schema.Boolean;
+        readonly instructionEntry: Schema.optionalKey<Schema.Boolean>;
+    }>, Schema.Union<readonly [Schema.String, Schema.Struct<{
+        readonly source: Schema.NonEmptyString;
+        readonly enabled: Schema.optionalKey<Schema.Boolean>;
+        readonly instructionEntry: Schema.optionalKey<Schema.Boolean>;
+    }>]>, never, never>>]>>;
+    readonly knowledgeConfig: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+        readonly dir: Schema.optionalKey<Schema.NonEmptyString>;
+        readonly instructions: Schema.optionalKey<Schema.Boolean>;
+    }>]>>;
+    readonly subagents: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.decodeTo<Schema.Struct<{
+        readonly source: Schema.String;
+        readonly enabled: Schema.Boolean;
+    }>, Schema.Union<readonly [Schema.String, Schema.Codec<EnabledEntryObject, EnabledEntryObject, never, never>]>, never, never>>]>>;
+    readonly subagentsConfig: Schema.optionalKey<Schema.Struct<{
+        readonly dir: Schema.optionalKey<Schema.NonEmptyString>;
+    }>>;
+    readonly packs: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.decodeTo<Schema.Struct<{
+        readonly source: Schema.String;
+        readonly enabled: Schema.Boolean;
+    }>, Schema.Union<readonly [Schema.String, Schema.Codec<EnabledEntryObject, EnabledEntryObject, never, never>]>, never, never>>]>>;
+    readonly packsConfig: Schema.optionalKey<Schema.Struct<{
+        readonly dir: Schema.optionalKey<Schema.NonEmptyString>;
+    }>>;
+    readonly mcpServers: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.decodeTo<Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.optional<Schema.Literal<"sourced">>;
+        readonly source: Schema.String;
+        readonly command: Schema.optional<Schema.String>;
+        readonly args: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly url: Schema.optional<Schema.String>;
+        readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+        readonly enabled: Schema.Boolean;
+        readonly env: Schema.$Record<Schema.String, Schema.String>;
+        readonly agents: Schema.optional<Schema.$Array<Schema.Literals<readonly ["adal", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow"]>>>;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"inline">;
+        readonly source: Schema.optional<Schema.Never>;
+        readonly command: Schema.optional<Schema.String>;
+        readonly args: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly url: Schema.optional<Schema.String>;
+        readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+        readonly enabled: Schema.Boolean;
+        readonly env: Schema.$Record<Schema.String, Schema.String>;
+        readonly agents: Schema.optional<Schema.$Array<Schema.Literals<readonly ["adal", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow"]>>>;
+    }>]>, Schema.Union<readonly [Schema.String, Schema.Struct<{
+        readonly source: Schema.optionalKey<Schema.NonEmptyString>;
+        readonly command: Schema.optionalKey<Schema.NonEmptyString>;
+        readonly args: Schema.optionalKey<Schema.$Array<Schema.String>>;
+        readonly url: Schema.optionalKey<Schema.NonEmptyString>;
+        readonly headers: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+        readonly enabled: Schema.optionalKey<Schema.Boolean>;
+        readonly env: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.String>, Schema.$Array<Schema.String>]>>;
+        readonly agents: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["adal", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow"]>>>;
+    }>]>, never, never>>]>>;
+    readonly mcpServersConfig: Schema.optionalKey<Schema.Struct<{
+        readonly dir: Schema.optionalKey<Schema.NonEmptyString>;
+    }>>;
+    readonly lint: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+        readonly rules: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Literals<readonly ["off", "info", "warn", "error"]>>>;
+    }>]>>;
+}>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>;
+/**
+ * Inferred type for Settings schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type Settings = Schema.Schema.Type<typeof SettingsSchema>;
+/**
+ * The recognized top-level settings keys, derived from the schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const SETTINGS_KNOWN_KEYS: ReadonlySet<string>;
+export {};
+//# sourceMappingURL=schema.d.ts.map