@agentxm/client-core 0.1.6

package/dist/src/unstable/date-time.js

@@ -0,0 +1,20 @@
+import * as Schema from "effect/Schema";
+import * as SchemaGetter from "effect/SchemaGetter";
+const isIsoDateTimeString = (value) => value.includes("T") && !Number.isNaN(Date.parse(value));
+export const IsoDateTimeStringSchema = Schema.NonEmptyString.pipe(Schema.check(Schema.makeFilter((value) => isIsoDateTimeString(value) ? undefined : `Expected ISO 8601 date-time string, got: ${value}`))).annotate({
+    identifier: "IsoDateTimeString",
+    title: "ISO Date-Time String",
+    description: "A date and time string (e.g. 2024-01-15T12:00:00.000Z).",
+    format: "date-time",
+    examples: ["2024-01-15T12:00:00.000Z"],
+    message: "Expected an ISO 8601 date-time string (e.g., 2024-01-15T12:00:00.000Z)",
+});
+export const DateFromIsoDateTimeStringSchema = IsoDateTimeStringSchema.pipe(Schema.decodeTo(Schema.DateValid, {
+    decode: SchemaGetter.Date(),
+    encode: SchemaGetter.transform((date) => date.toISOString()),
+}), Schema.annotate({
+    identifier: "DateFromIsoDateTimeString",
+    title: "Date from ISO String",
+    description: "Converts a date-time string into a Date object.",
+}));
+//# sourceMappingURL=date-time.js.map

package/dist/src/unstable/date-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-time.js","sourceRoot":"","sources":["../../../src/unstable/date-time.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,YAAY,MAAM,qBAAqB,CAAC;AAEpD,MAAM,mBAAmB,GAAG,CAAC,KAAa,EAAW,EAAE,CACrD,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,CAC/D,MAAM,CAAC,KAAK,CACV,MAAM,CAAC,UAAU,CAAC,CAAC,KAAa,EAAE,EAAE,CAClC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,4CAA4C,KAAK,EAAE,CAC7F,CACF,CACF,CAAC,QAAQ,CAAC;IACT,UAAU,EAAE,mBAAmB;IAC/B,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EAAE,yDAAyD;IACtE,MAAM,EAAE,WAAW;IACnB,QAAQ,EAAE,CAAC,0BAA0B,CAAC;IACtC,OAAO,EAAE,wEAAwE;CAClF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,+BAA+B,GAAG,uBAAuB,CAAC,IAAI,CACzE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE;IAChC,MAAM,EAAE,YAAY,CAAC,IAAI,EAAU;IACnC,MAAM,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC,IAAU,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;CACnE,CAAC,EACF,MAAM,CAAC,QAAQ,CAAC;IACd,UAAU,EAAE,2BAA2B;IACvC,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EAAE,iDAAiD;CAC/D,CAAC,CACH,CAAC"}

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

@@ -0,0 +1,38 @@
+/**
+ * Discover pipeline: detect packages, read local recommendations,
+ * query registry, and merge results with signal assignment.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import type { RegistryClient } from "../registry/client.js";
+import type { DiscoverExtensionEntry } from "../registry/discover-schema.js";
+import type { PackageUrlParts } from "../packaging/package-url.js";
+export type DiscoverSignal = "compatible" | "recommended";
+export interface DiscoverResultEntry {
+    readonly extension: DiscoverExtensionEntry;
+    readonly signal: DiscoverSignal;
+}
+export interface DiscoverPackageResult {
+    readonly detectedPackage: PackageUrlParts;
+    readonly extensions: ReadonlyArray<DiscoverResultEntry>;
+}
+export interface DiscoverResult {
+    readonly packages: ReadonlyArray<DiscoverPackageResult>;
+    readonly totalDetected: number;
+    readonly registryAvailable: boolean;
+}
+/**
+ * Run the full discover pipeline:
+ * 1. Detect packages from project manifests
+ * 2. Read local recommendation metadata
+ * 3. Query registry for compatible extensions
+ * 4. Merge and assign signals
+ */
+export declare const discover: (projectDir: string, registryClient: RegistryClient) => Effect.Effect<{
+    packages: readonly DiscoverPackageResult[];
+    totalDetected: number;
+    registryAvailable: boolean;
+}, never, import("effect/FileSystem").FileSystem | import("effect/Path").Path>;
+//# sourceMappingURL=discover.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../../../src/unstable/discover/discover.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAWxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EACV,sBAAsB,EAEvB,MAAM,gCAAgC,CAAC;AAIxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAQnE,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,aAAa,CAAC;AAE1D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IACxD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;CACrC;AAQD;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,YAAY,MAAM,EAAE,gBAAgB,cAAc;;;;8EAsDqB,CAAC"}

package/dist/src/unstable/discover/discover.js

@@ -0,0 +1,179 @@
+/**
+ * Discover pipeline: detect packages, read local recommendations,
+ * query registry, and merge results with signal assignment.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Array from "effect/Array";
+import * as Effect from "effect/Effect";
+import * as HashMap from "effect/HashMap";
+import * as Option from "effect/Option";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import { parseFullyQualifiedRefParts, toExtensionTypePlural, } from "../extensions/common.js";
+import { decodeExactSemverVersionSync } from "../version-constraints/version-constraints.js";
+import { detectPackages } from "../packaging/detect.js";
+import { packageDetectors, packageReaders } from "../packaging/index.js";
+import { PackageUrlSchema } from "../packaging/package-url.js";
+import { readLocalRecommendations } from "../packaging/read.js";
+const encodePurl = Schema.encodeSync(PackageUrlSchema);
+// -----------------------------------------------------------------------------
+// Pipeline
+// -----------------------------------------------------------------------------
+/**
+ * Run the full discover pipeline:
+ * 1. Detect packages from project manifests
+ * 2. Read local recommendation metadata
+ * 3. Query registry for compatible extensions
+ * 4. Merge and assign signals
+ */
+export const discover = (projectDir, registryClient) => Effect.gen(function* () {
+    // Stage 1: Detect packages
+    const detected = yield* detectPackages(projectDir, packageDetectors).pipe(Effect.withSpan("discover.detect"));
+    if (detected.length === 0) {
+        return {
+            packages: [],
+            totalDetected: 0,
+            registryAvailable: true,
+        };
+    }
+    // Stage 2: Read local recommendations
+    const localRecs = yield* readLocalRecommendations(detected, packageReaders).pipe(Effect.withSpan("discover.readLocal"));
+    // Collect all recommendation refs for the registry query
+    const allRecommendedRefs = Array.dedupe(Array.flatten(Array.fromIterable(HashMap.values(localRecs))));
+    // Stage 3: Query registry
+    const purls = detected.map((d) => d.purl);
+    const discoverArgs = allRecommendedRefs.length > 0
+        ? { packages: purls, workspaceRecommendedExtensions: allRecommendedRefs }
+        : { packages: purls };
+    const registryResult = yield* Effect.result(registryClient.discoverExtensions(discoverArgs)).pipe(Effect.withSpan("discover.queryRegistry"));
+    if (Result.isFailure(registryResult)) {
+        yield* Effect.logWarning("Registry is unreachable — showing local recommendations only");
+    }
+    const registryAvailable = Result.isSuccess(registryResult);
+    // Stage 4: Merge and assign signals
+    const merged = mergeResults(detected.map((d) => ({ purlString: encodePurl(d.purl), parts: d.purl })), registryAvailable ? registryResult.success : undefined, localRecs);
+    return {
+        packages: merged,
+        totalDetected: detected.length,
+        registryAvailable,
+    };
+}).pipe(Effect.annotateLogs({ command: "discover", projectDir }), Effect.withSpan("discover"));
+// -----------------------------------------------------------------------------
+// Merge Logic
+// -----------------------------------------------------------------------------
+const makeEntryKey = (entry) => `${entry.owner}/${entry.type}/${entry.name}`;
+const mergeResults = (detected, response, localRecs) => {
+    if (response === undefined) {
+        return buildLocalOnlyResults(detected, localRecs);
+    }
+    // Build a set of recommended extension keys from resolvedRecommendations
+    const recommendedKeys = new Set();
+    for (const rec of response.resolvedRecommendations) {
+        recommendedKeys.add(makeEntryKey(rec));
+    }
+    // Build per-package results from registry response
+    const packageMap = new Map();
+    for (const group of response.results) {
+        const purlParts = group.detectedPackage;
+        const purlKey = encodePurl(purlParts);
+        let entries = packageMap.get(purlKey);
+        if (entries === undefined) {
+            entries = new Map();
+            packageMap.set(purlKey, entries);
+        }
+        const localRefsForPurl = HashMap.get(localRecs, purlKey);
+        for (const ext of group.extensions) {
+            const key = makeEntryKey(ext);
+            const isRecommended = recommendedKeys.has(key) ||
+                (Option.isSome(localRefsForPurl) && hasMatchingRef(localRefsForPurl.value, ext));
+            const signal = isRecommended ? "recommended" : "compatible";
+            const existing = entries.get(key);
+            // recommended overrides compatible
+            if (existing === undefined ||
+                (signal === "recommended" && existing.signal === "compatible")) {
+                entries.set(key, { extension: ext, signal });
+            }
+        }
+    }
+    // Also add resolvedRecommendations that may not appear in results
+    for (const rec of response.resolvedRecommendations) {
+        const key = makeEntryKey(rec);
+        HashMap.forEach(localRecs, (refs, purl) => {
+            if (hasMatchingRef(refs, rec)) {
+                let entries = packageMap.get(purl);
+                if (entries === undefined) {
+                    entries = new Map();
+                    packageMap.set(purl, entries);
+                }
+                const existing = entries.get(key);
+                if (existing === undefined || existing.signal === "compatible") {
+                    entries.set(key, { extension: rec, signal: "recommended" });
+                }
+            }
+        });
+    }
+    // Map detected packages to results, maintaining order
+    const purlToDetected = new Map(detected.map((d) => [d.purlString, d.parts]));
+    const results = [];
+    for (const [purl, entries] of packageMap) {
+        const parts = purlToDetected.get(purl);
+        if (parts === undefined)
+            continue;
+        results.push({
+            detectedPackage: parts,
+            extensions: [...entries.values()],
+        });
+    }
+    return results;
+};
+/**
+ * Build results from local recommendations only (when registry is unavailable).
+ */
+const buildLocalOnlyResults = (detected, localRecs) => {
+    const results = [];
+    const fallbackVersion = decodeExactSemverVersionSync("0.0.0");
+    for (const pkg of detected) {
+        const refsOpt = HashMap.get(localRecs, pkg.purlString);
+        if (Option.isNone(refsOpt) || refsOpt.value.length === 0)
+            continue;
+        const extensions = [];
+        for (const ref of refsOpt.value) {
+            const parsed = parseFullyQualifiedRefParts(ref);
+            if (parsed === undefined)
+                continue;
+            extensions.push({
+                extension: {
+                    type: parsed.type,
+                    name: parsed.name,
+                    owner: parsed.owner,
+                    description: "",
+                    latestVersion: fallbackVersion,
+                },
+                signal: "recommended",
+            });
+        }
+        if (extensions.length > 0) {
+            results.push({ detectedPackage: pkg.parts, extensions });
+        }
+    }
+    return results;
+};
+/**
+ * Check if any ref in the array matches the extension entry's FQN pattern.
+ */
+const hasMatchingRef = (refs, entry) => {
+    const plural = toExtensionTypePlural(entry.type);
+    const fqn = `${entry.owner}/${plural}/${entry.name}`;
+    for (const ref of refs) {
+        const parsed = parseFullyQualifiedRefParts(ref);
+        if (parsed === undefined)
+            continue;
+        const refFqn = `${parsed.owner}/${toExtensionTypePlural(parsed.type)}/${parsed.name}`;
+        if (refFqn === fqn)
+            return true;
+    }
+    return false;
+};
+//# sourceMappingURL=discover.js.map

package/dist/src/unstable/discover/discover.js.map

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

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

@@ -0,0 +1,8 @@
+/**
+ * Extension discovery module.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { discover, type DiscoverResult, type DiscoverPackageResult, type DiscoverResultEntry, type DiscoverSignal, } from "./discover.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/unstable/discover/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,QAAQ,EACR,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/unstable/discover/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,QAAQ,GAKT,MAAM,eAAe,CAAC"}

package/dist/src/unstable/extensions/common.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Common schema definitions shared across AXM configuration files.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+import * as Option from "effect/Option";
+/**
+ * Author information for a manifest.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const AuthorSchema: Schema.Struct<{
+    readonly name: Schema.String;
+    readonly email: Schema.optional<Schema.String>;
+    readonly url: Schema.optional<Schema.String>;
+}>;
+/**
+ * Author information in runtime/domain models.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface Author {
+    readonly name: string;
+    readonly email: Option.Option<string>;
+    readonly url: Option.Option<string>;
+}
+/** Convert schema-decoded author shape into runtime/domain Author. */
+export declare const toAuthor: (author: Schema.Schema.Type<typeof AuthorSchema>) => Author;
+export declare const extensionTypes: readonly ["skill", "command", "mcp-server", "subagent", "file", "rule", "pack"];
+export type ExtensionType = (typeof extensionTypes)[number];
+export declare const isExtensionType: (value: string | undefined) => value is ExtensionType;
+export declare const extensionTypePluralSegments: readonly ["skills", "commands", "mcp-servers", "subagents", "files", "rules", "packs"];
+export type ExtensionTypePlural = (typeof extensionTypePluralSegments)[number];
+export declare const isExtensionTypePlural: (value: string | undefined) => value is ExtensionTypePlural;
+export declare const extensionTypeFromPlural: Record<ExtensionTypePlural, ExtensionType>;
+export declare const extensionTypeToPlural: Record<ExtensionType, ExtensionTypePlural>;
+export declare const toExtensionType: (segment: ExtensionTypePlural) => ExtensionType;
+export declare const toExtensionTypePlural: (type: ExtensionType) => ExtensionTypePlural;
+export declare const extensionTypeLabels: Record<ExtensionType, string>;
+export declare const extensionTypePluralLabels: Record<ExtensionTypePlural, string>;
+export declare const extensionTypeSentenceLabels: Record<ExtensionType, string>;
+export declare const extensionTypePluralSentenceLabels: Record<ExtensionTypePlural, string>;
+/**
+ * Fully qualified name regex: `@<handle>/<type>/<name>` where handle and name
+ * use the canonical handle, plural extension type, and extension name grammar.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const FQN_PATTERN: RegExp;
+/**
+ * Canonical extension short name regex.
+ */
+export declare const EXTENSION_NAME_PATTERN: RegExp;
+/**
+ * Canonical extension short name schema shared by generic extension surfaces.
+ */
+export declare const ExtensionNameSchema: Schema.brand<Schema.String, "ExtensionName">;
+export type ExtensionName = Schema.Schema.Type<typeof ExtensionNameSchema>;
+export declare const decodeExtensionNameSync: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"ExtensionName">;
+/**
+ * Extension type enumeration.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const ExtensionTypeSchema: Schema.Literals<readonly ["skill", "command", "mcp-server", "subagent", "file", "rule", "pack"]>;
+/**
+ * Plural extension-type segment enumeration used by route/FQN surfaces.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const ExtensionTypePluralSchema: Schema.Literals<readonly ["skills", "commands", "mcp-servers", "subagents", "files", "rules", "packs"]>;
+/**
+ * Structured FQN parts schema composed from the canonical handle, type, and name schemas.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const FullyQualifiedNamePartsSchema: Schema.Struct<{
+    readonly owner: Schema.brand<Schema.String, "Handle">;
+    readonly type: Schema.Literals<readonly ["skill", "command", "mcp-server", "subagent", "file", "rule", "pack"]>;
+    readonly name: Schema.brand<Schema.String, "ExtensionName">;
+}>;
+/**
+ * Inferred type for parsed FQN parts.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type FullyQualifiedNameParts = Schema.Schema.Type<typeof FullyQualifiedNamePartsSchema>;
+/**
+ * Parse a fully qualified name string into validated structured parts.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const parseFullyQualifiedNameParts: (input: string) => FullyQualifiedNameParts | undefined;
+/**
+ * Parse a fully qualified ref string (with optional version constraint) into parts.
+ * Strips the version constraint suffix and returns the validated FQN parts.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const parseFullyQualifiedRefParts: (input: string) => FullyQualifiedNameParts | undefined;
+/**
+ * Fully qualified name string schema validated through the composed parts schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const FullyQualifiedNameSchema: Schema.String;
+/**
+ * Inferred type for FullyQualifiedName schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type FullyQualifiedName = Schema.Schema.Type<typeof FullyQualifiedNameSchema>;
+/**
+ * Fully qualified extension reference with optional version constraint.
+ *
+ * Accepts `@owner/type/name` or `@owner/type/name@constraint` where
+ * the FQN portion validates through FullyQualifiedNameSchema and the
+ * optional constraint validates as a semver VersionConstraint.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const FullyQualifiedRefSchema: Schema.brand<Schema.String, "FullyQualifiedRef">;
+/**
+ * Inferred type for FullyQualifiedRef schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type FullyQualifiedRef = Schema.Schema.Type<typeof FullyQualifiedRefSchema>;
+/**
+ * Map of fully-qualified extension names to semver constraints.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const ExtensionDependencyConstraintMapSchema: Schema.$Record<Schema.String, Schema.brand<Schema.String, "VersionConstraint">>;
+/**
+ * Inferred type for extension dependency constraint maps.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type ExtensionDependencyConstraintMap = Schema.Schema.Type<typeof ExtensionDependencyConstraintMapSchema>;
+/**
+ * Common base fields shared across manifest types.
+ * Type-specific manifests provide their own `type` and `name` fields explicitly.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const CommonManifestBaseFields: {
+    owner: Schema.brand<Schema.String, "Handle">;
+    version: Schema.brand<Schema.String, "ExactSemverVersion">;
+    description: Schema.optional<Schema.String>;
+    keywords: Schema.optional<Schema.$Array<Schema.String>>;
+    repository: Schema.optional<Schema.String>;
+    homepage: Schema.optional<Schema.String>;
+    license: Schema.optional<Schema.String>;
+    bugs: Schema.optional<Schema.String>;
+    authors: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly name: Schema.String;
+        readonly email: Schema.optional<Schema.String>;
+        readonly url: Schema.optional<Schema.String>;
+    }>>>;
+    compatiblePackages: Schema.optional<Schema.$Array<Schema.decodeTo<Schema.toType<Schema.Struct<{
+        readonly type: Schema.brand<Schema.String, "PackageType">;
+        readonly namespace: Schema.optional<Schema.String>;
+        readonly name: Schema.String;
+        readonly version: Schema.optional<Schema.String>;
+    }>>, Schema.String, never, never>>>;
+};
+/**
+ * Agent identifier enumeration for supported coding agents.
+ *
+ * Derived from `AGENT_IDS` in agents/types.ts — compile-time enforced,
+ * no manual sync required.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const AgentIdSchema: 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"]>;
+/**
+ * Inferred type for AgentId schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type AgentId = Schema.Schema.Type<typeof AgentIdSchema>;
+//# sourceMappingURL=common.d.ts.map

package/dist/src/unstable/extensions/common.d.ts.map

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