@agentxm/client-core 0.1.6

package/dist/src/unstable/cli-runtime/runtime-envelope.js.map

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

package/dist/src/unstable/cli-runtime/telemetry-layer.d.ts

@@ -0,0 +1,9 @@
+import type * as Layer from "effect/Layer";
+import type * as HttpClient from "effect/unstable/http/HttpClient";
+import { TelemetryClient, type TelemetryClientOptions } from "../telemetry/index.js";
+export interface CliTelemetryConfigService {
+    readonly mode: TelemetryClientOptions["mode"];
+    readonly client: TelemetryClientOptions["client"];
+}
+export declare const makeCliTelemetryLayer: (command: string, config: CliTelemetryConfigService) => Layer.Layer<TelemetryClient, never, HttpClient.HttpClient>;
+//# sourceMappingURL=telemetry-layer.d.ts.map

package/dist/src/unstable/cli-runtime/telemetry-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-layer.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/telemetry-layer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,KAAK,UAAU,MAAM,iCAAiC,CAAC;AAEnE,OAAO,EACL,eAAe,EAEf,KAAK,sBAAsB,EAC5B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;CACnD;AAED,eAAO,MAAM,qBAAqB,GAChC,SAAS,MAAM,EACf,QAAQ,yBAAyB,KAChC,KAAK,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAKvB,CAAC"}

package/dist/src/unstable/cli-runtime/telemetry-layer.js

@@ -0,0 +1,7 @@
+import { TelemetryClient, TelemetryClientLive, } from "../telemetry/index.js";
+export const makeCliTelemetryLayer = (command, config) => TelemetryClientLive({
+    mode: config.mode,
+    command,
+    client: config.client,
+});
+//# sourceMappingURL=telemetry-layer.js.map

package/dist/src/unstable/cli-runtime/telemetry-layer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-layer.js","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/telemetry-layer.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,eAAe,EACf,mBAAmB,GAEpB,MAAM,uBAAuB,CAAC;AAO/B,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,OAAe,EACf,MAAiC,EAC2B,EAAE,CAC9D,mBAAmB,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,IAAI;IACjB,OAAO;IACP,MAAM,EAAE,MAAM,CAAC,MAAM;CACW,CAAC,CAAC"}

package/dist/src/unstable/cli-runtime/telemetry.d.ts

@@ -0,0 +1,52 @@
+import * as Cause from "effect/Cause";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Ref from "effect/Ref";
+import * as ServiceMap from "effect/ServiceMap";
+import type { AppError } from "../app-error/index.js";
+import type { PromptCancelled } from "../cli-prompt/prompt-cancelled.js";
+import { TelemetryClient } from "../telemetry/index.js";
+import type { TelemetryProperties } from "../telemetry/client.js";
+export interface CliCommandTelemetryOptions {
+    readonly command: string;
+    readonly event?: string;
+    readonly properties?: TelemetryProperties;
+}
+export declare const trackCliCommand: ({ command, event, properties, }: CliCommandTelemetryOptions) => Effect.Effect<void, never, TelemetryClient>;
+export interface CliCommandCompletedOptions {
+    readonly command: string;
+    readonly result: "success" | "error" | "cancelled" | "defect";
+    readonly durationMs: number;
+    readonly errorCode?: string;
+    readonly semanticProperties?: TelemetryProperties;
+}
+export declare const trackCliCommandCompleted: (options: CliCommandCompletedOptions) => Effect.Effect<void, never, TelemetryClient>;
+export declare const readGlobalFlagProperties: Effect.Effect<{
+    "cli.global.non_interactive": string;
+    "cli.global.json": string;
+    "cli.global.verbose": string;
+    "cli.global.debug": string;
+    "cli.global.quiet": string;
+}, never, "effect/unstable/cli/GlobalFlag/axm-non-interactive" | "effect/unstable/cli/GlobalFlag/axm-json" | "effect/unstable/cli/GlobalFlag/axm-quiet" | "effect/unstable/cli/GlobalFlag/axm-verbose" | "effect/unstable/cli/GlobalFlag/axm-debug">;
+export declare const reportCliError: (error: AppError | PromptCancelled, command: string) => Effect.Effect<void, never, TelemetryClient>;
+export interface CommandSemanticPropertiesService {
+    readonly ref: Ref.Ref<TelemetryProperties>;
+}
+declare const CommandSemanticProperties_base: ServiceMap.ServiceClass<CommandSemanticProperties, "@agentxm/client-core/CommandSemanticProperties", CommandSemanticPropertiesService>;
+export declare class CommandSemanticProperties extends CommandSemanticProperties_base {
+}
+/**
+ * Set semantic telemetry properties from within a command handler.
+ * These properties are read by the runtime envelope and merged into
+ * the `command_completed` event. Safe to call when the service is
+ * absent (e.g., in tests that bypass the runtime envelope).
+ */
+export declare const setCommandSemanticProperties: (properties: TelemetryProperties) => Effect.Effect<void>;
+export declare const getCommandSemanticProperties: Effect.Effect<TelemetryProperties>;
+/**
+ * Create a Layer that provides CommandSemanticProperties backed by a fresh Ref.
+ */
+export declare const CommandSemanticPropertiesLive: Layer.Layer<CommandSemanticProperties>;
+export declare const reportCliDefect: (cause: Cause.Cause<unknown>, command: string) => Effect.Effect<void, never, TelemetryClient>;
+export {};
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/src/unstable/cli-runtime/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAClC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAalE,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED,eAAO,MAAM,eAAe,GAAI,iCAI7B,0BAA0B,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,eAAe,CAItE,CAAC;AAML,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC9D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;CACnD;AAED,eAAO,MAAM,wBAAwB,GACnC,SAAS,0BAA0B,KAClC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,eAAe,CAUE,CAAC;AAMhD,eAAO,MAAM,wBAAwB;;;;;;oPAcnC,CAAC;AAMH,eAAO,MAAM,cAAc,GACzB,OAAO,QAAQ,GAAG,eAAe,EACjC,SAAS,MAAM,KACd,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,eAAe,CAc5B,CAAC;AAMlB,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;CAC5C;;AAED,qBAAa,yBAA0B,SAAQ,8BAGM;CAAG;AAExD;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,GACvC,YAAY,mBAAmB,KAC9B,MAAM,CAAC,MAAM,CAAC,IAAI,CAOjB,CAAC;AAQL,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAQ3E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,6BAA6B,EAAE,KAAK,CAAC,KAAK,CAAC,yBAAyB,CAGhF,CAAC;AAWF,eAAO,MAAM,eAAe,GAC1B,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAC3B,SAAS,MAAM,KACd,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,eAAe,CAYM,CAAC"}

package/dist/src/unstable/cli-runtime/telemetry.js

@@ -0,0 +1,107 @@
+import * as Cause from "effect/Cause";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Ref from "effect/Ref";
+import * as ServiceMap from "effect/ServiceMap";
+import { TelemetryClient } from "../telemetry/index.js";
+import { nonInteractiveFlag, jsonFlag, verboseFlag, debugFlag, quietFlag, } from "../cli-flags/index.js";
+export const trackCliCommand = ({ command, event = "command_invoked", properties, }) => Effect.gen(function* () {
+    const telemetry = yield* TelemetryClient;
+    yield* telemetry.trackEvent(event, { "cli.command": command, ...(properties ?? {}) });
+});
+export const trackCliCommandCompleted = (options) => Effect.gen(function* () {
+    const telemetry = yield* TelemetryClient;
+    yield* telemetry.trackEvent("command_completed", {
+        "cli.command": options.command,
+        "cli.result": options.result,
+        "cli.duration_ms": options.durationMs,
+        ...(options.errorCode !== undefined && { "cli.error_code": options.errorCode }),
+        ...(options.semanticProperties ?? {}),
+    });
+}).pipe(Effect.catchCause(() => Effect.void));
+// ---------------------------------------------------------------------------
+// Global flag capture
+// ---------------------------------------------------------------------------
+export const readGlobalFlagProperties = Effect.gen(function* () {
+    const nonInteractive = yield* nonInteractiveFlag;
+    const json = yield* jsonFlag;
+    const verbose = yield* verboseFlag;
+    const debug = yield* debugFlag;
+    const quiet = yield* quietFlag;
+    return {
+        "cli.global.non_interactive": String(Option.getOrElse(nonInteractive, () => false)),
+        "cli.global.json": String(Option.getOrElse(json, () => false)),
+        "cli.global.verbose": String(verbose),
+        "cli.global.debug": String(debug),
+        "cli.global.quiet": String(quiet),
+    };
+});
+// ---------------------------------------------------------------------------
+// Error reporting (unchanged)
+// ---------------------------------------------------------------------------
+export const reportCliError = (error, command) => error._tag === "AppError"
+    ? Effect.gen(function* () {
+        const telemetry = yield* TelemetryClient;
+        yield* telemetry.reportError({
+            name: error.code,
+            message: error.what,
+            details: error.details,
+            ...(Option.isSome(error.howToFix) && { howToFix: error.howToFix.value }),
+            level: "error",
+            handled: true,
+            command,
+        });
+    }).pipe(Effect.catchCause(() => Effect.void))
+    : Effect.void;
+export class CommandSemanticProperties extends ServiceMap.Service()("@agentxm/client-core/CommandSemanticProperties") {
+}
+/**
+ * Set semantic telemetry properties from within a command handler.
+ * These properties are read by the runtime envelope and merged into
+ * the `command_completed` event. Safe to call when the service is
+ * absent (e.g., in tests that bypass the runtime envelope).
+ */
+export const setCommandSemanticProperties = (properties) => Effect.gen(function* () {
+    const option = yield* Effect.serviceOption(CommandSemanticProperties);
+    yield* Option.match(option, {
+        onNone: () => Effect.void,
+        onSome: (svc) => Ref.set(svc.ref, properties),
+    });
+});
+/**
+ * Read the current semantic telemetry properties.
+ * Returns an empty record if the service is not available.
+ */
+const emptyProperties = {};
+export const getCommandSemanticProperties = Effect.gen(function* () {
+    const option = yield* Effect.serviceOption(CommandSemanticProperties);
+    return yield* Option.match(option, {
+        onNone: () => Effect.succeed(emptyProperties),
+        onSome: (svc) => Ref.get(svc.ref),
+    });
+});
+/**
+ * Create a Layer that provides CommandSemanticProperties backed by a fresh Ref.
+ */
+export const CommandSemanticPropertiesLive = Layer.effect(CommandSemanticProperties, Ref.make(emptyProperties).pipe(Effect.map((ref) => ({ ref }))));
+// ---------------------------------------------------------------------------
+// Defect reporting
+// ---------------------------------------------------------------------------
+const defectMessage = (cause) => {
+    const squashed = Cause.squash(cause);
+    return squashed instanceof Error ? squashed.message : String(squashed);
+};
+export const reportCliDefect = (cause, command) => Cause.hasInterruptsOnly(cause)
+    ? Effect.void
+    : Effect.gen(function* () {
+        const telemetry = yield* TelemetryClient;
+        yield* telemetry.reportError({
+            name: "Defect",
+            message: defectMessage(cause),
+            level: "fatal",
+            handled: false,
+            command,
+        });
+    }).pipe(Effect.catchCause(() => Effect.void));
+//# sourceMappingURL=telemetry.js.map

package/dist/src/unstable/cli-runtime/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAClC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EACL,kBAAkB,EAClB,QAAQ,EACR,WAAW,EACX,SAAS,EACT,SAAS,GACV,MAAM,uBAAuB,CAAC;AAY/B,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAC9B,OAAO,EACP,KAAK,GAAG,iBAAiB,EACzB,UAAU,GACiB,EAA+C,EAAE,CAC5E,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC;IACzC,KAAK,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;AACxF,CAAC,CAAC,CAAC;AAcL,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,OAAmC,EACU,EAAE,CAC/C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC;IACzC,KAAK,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,mBAAmB,EAAE;QAC/C,aAAa,EAAE,OAAO,CAAC,OAAO;QAC9B,YAAY,EAAE,OAAO,CAAC,MAAM;QAC5B,iBAAiB,EAAE,OAAO,CAAC,UAAU;QACrC,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;QAC/E,GAAG,CAAC,OAAO,CAAC,kBAAkB,IAAI,EAAE,CAAC;KACtC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AAEhD,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAC1D,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,kBAAkB,CAAC;IACjD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC;IAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,WAAW,CAAC;IACnC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC;IAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC;IAE/B,OAAO;QACL,4BAA4B,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QACnF,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QAC9D,oBAAoB,EAAE,MAAM,CAAC,OAAO,CAAC;QACrC,kBAAkB,EAAE,MAAM,CAAC,KAAK,CAAC;QACjC,kBAAkB,EAAE,MAAM,CAAC,KAAK,CAAC;KAClC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,KAAiC,EACjC,OAAe,EAC8B,EAAE,CAC/C,KAAK,CAAC,IAAI,KAAK,UAAU;IACvB,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC;QACzC,KAAK,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC;YAC3B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,IAAI;YACnB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACxE,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,IAAI;YACb,OAAO;SACR,CAAC,CAAC;IACL,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;AAUlB,MAAM,OAAO,yBAA0B,SAAQ,UAAU,CAAC,OAAO,EAG9D,CAAC,gDAAgD,CAAC;CAAG;AAExD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAC1C,UAA+B,EACV,EAAE,CACvB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtE,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE;QAC1B,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI;QACzB,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC;KAC9C,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL;;;GAGG;AACH,MAAM,eAAe,GAAwB,EAAE,CAAC;AAEhD,MAAM,CAAC,MAAM,4BAA4B,GAAuC,MAAM,CAAC,GAAG,CACxF,QAAQ,CAAC;IACP,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtE,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE;QACjC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC;QAC7C,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;KAClC,CAAC,CAAC;AACL,CAAC,CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAA2C,KAAK,CAAC,MAAM,CAC/F,yBAAyB,EACzB,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAC/D,CAAC;AAEF,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,MAAM,aAAa,GAAG,CAAC,KAA2B,EAAU,EAAE;IAC5D,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrC,OAAO,QAAQ,YAAY,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACzE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,KAA2B,EAC3B,OAAe,EAC8B,EAAE,CAC/C,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC;IAC5B,CAAC,CAAC,MAAM,CAAC,IAAI;IACb,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC;QACzC,KAAK,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC;YAC3B,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC;YAC7B,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,KAAK;YACd,OAAO;SACR,CAAC,CAAC;IACL,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC"}

package/dist/src/unstable/commands/command-argument.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Command argument schema definition.
+ *
+ * Defines the shape of arguments that a command accepts,
+ * used in COMMAND.md frontmatter.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+/**
+ * Schema for a single command argument.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const CommandArgumentSchema: Schema.Struct<{
+    readonly name: Schema.String;
+    readonly description: Schema.optional<Schema.String>;
+    readonly required: Schema.optional<Schema.Boolean>;
+    readonly default: Schema.optional<Schema.String>;
+}>;
+/**
+ * Inferred type for CommandArgument schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type CommandArgument = Schema.Schema.Type<typeof CommandArgumentSchema>;
+//# sourceMappingURL=command-argument.d.ts.map

package/dist/src/unstable/commands/command-argument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-argument.d.ts","sourceRoot":"","sources":["../../../../src/unstable/commands/command-argument.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;;EAShC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/src/unstable/commands/command-argument.js

@@ -0,0 +1,25 @@
+/**
+ * Command argument schema definition.
+ *
+ * Defines the shape of arguments that a command accepts,
+ * used in COMMAND.md frontmatter.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+/**
+ * Schema for a single command argument.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const CommandArgumentSchema = Schema.Struct({
+    name: Schema.String.pipe(Schema.annotateKey({ messageMissingKey: "argument name is required" })),
+    description: Schema.optional(Schema.String),
+    required: Schema.optional(Schema.Boolean),
+    default: Schema.optional(Schema.String),
+}).annotate({
+    identifier: "CommandArgument",
+    title: "Command Argument",
+    description: "A single argument that a command accepts.",
+});
+//# sourceMappingURL=command-argument.js.map

package/dist/src/unstable/commands/command-argument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-argument.js","sourceRoot":"","sources":["../../../../src/unstable/commands/command-argument.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,CAAC,CAAC;IAChG,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IAC3C,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC;IACzC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;CACxC,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,iBAAiB;IAC7B,KAAK,EAAE,kBAAkB;IACzB,WAAW,EAAE,2CAA2C;CACzD,CAAC,CAAC"}

package/dist/src/unstable/commands/command-content.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Command content file module for COMMAND.md parsing and frontmatter schemas.
+ *
+ * Defines the frontmatter schema for COMMAND.md files, a parser that
+ * combines the shared frontmatter utility with command-specific validation,
+ * and a transformation for syncing frontmatter fields to manifest fields.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+import { type AppError } from "../app-error/index.js";
+/**
+ * Schema for COMMAND.md frontmatter fields.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const CommandFrontmatterSchema: Schema.Struct<{
+    readonly description: Schema.optional<Schema.String>;
+    readonly model: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly allowedTools: Schema.optional<Schema.NullOr<Schema.$Array<Schema.String>>>;
+    readonly isolatedContext: Schema.optional<Schema.Boolean>;
+    readonly arguments: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly name: Schema.String;
+        readonly description: Schema.optional<Schema.String>;
+        readonly required: Schema.optional<Schema.Boolean>;
+        readonly default: Schema.optional<Schema.String>;
+    }>>>;
+    readonly argumentHint: Schema.optional<Schema.String>;
+    readonly autoInvocable: Schema.optional<Schema.Boolean>;
+    readonly userInvocable: Schema.optional<Schema.Boolean>;
+}>;
+/**
+ * Inferred type for CommandFrontmatter schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type CommandFrontmatter = Schema.Schema.Type<typeof CommandFrontmatterSchema>;
+/**
+ * Result of parsing a COMMAND.md file.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface CommandContentResult {
+    /** Parsed and validated frontmatter, or Option.none() if no frontmatter block was found. */
+    readonly frontmatter: Option.Option<CommandFrontmatter>;
+    /** Content body after the frontmatter block, or full content if no frontmatter. */
+    readonly body: string;
+}
+/**
+ * Parse a COMMAND.md file's content into validated frontmatter and body.
+ *
+ * Delegates to the shared frontmatter parser, then validates the
+ * frontmatter against `CommandFrontmatterSchema`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const parseCommandMd: (content: string) => Effect.Effect<CommandContentResult, AppError>;
+/**
+ * Schema for manifest fields projected from frontmatter.
+ *
+ * Used during publish to sync description and model from COMMAND.md
+ * frontmatter into the command manifest.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const ManifestFieldsFromFrontmatterSchema: Schema.Struct<{
+    readonly description: Schema.optional<Schema.String>;
+    readonly model: Schema.optional<Schema.NullOr<Schema.String>>;
+}>;
+/**
+ * Inferred type for ManifestFieldsFromFrontmatter.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type ManifestFieldsFromFrontmatter = Schema.Schema.Type<typeof ManifestFieldsFromFrontmatterSchema>;
+/**
+ * Project frontmatter fields to manifest fields.
+ *
+ * Extracts `description` and `model` from a parsed `CommandFrontmatter`
+ * for use in manifest updates.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const projectFrontmatterToManifest: (frontmatter: CommandFrontmatter) => ManifestFieldsFromFrontmatter;
+//# sourceMappingURL=command-content.d.ts.map

package/dist/src/unstable/commands/command-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-content.d.ts","sourceRoot":"","sources":["../../../../src/unstable/commands/command-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEpE;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;EAanC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAErF;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,4FAA4F;IAC5F,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;IACxD,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,oBAAoB,EAAE,QAAQ,CAqBzF,CAAC;AAEL;;;;;;;GAOG;AACH,eAAO,MAAM,mCAAmC;;;EAO9C,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,6BAA6B,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAC5D,OAAO,mCAAmC,CAC3C,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,GACvC,aAAa,kBAAkB,KAC9B,6BAGD,CAAC"}

package/dist/src/unstable/commands/command-content.js

@@ -0,0 +1,88 @@
+/**
+ * Command content file module for COMMAND.md parsing and frontmatter schemas.
+ *
+ * Defines the frontmatter schema for COMMAND.md files, a parser that
+ * combines the shared frontmatter utility with command-specific validation,
+ * and a transformation for syncing frontmatter fields to manifest fields.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+import { CommandArgumentSchema } from "./command-argument.js";
+import { parseFrontmatterEffect } from "../extensions/frontmatter.js";
+import { makeAppError } from "../app-error/index.js";
+/**
+ * Schema for COMMAND.md frontmatter fields.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const CommandFrontmatterSchema = Schema.Struct({
+    description: Schema.optional(Schema.String),
+    model: Schema.optional(Schema.NullOr(Schema.String)),
+    allowedTools: Schema.optional(Schema.NullOr(Schema.Array(Schema.String))),
+    isolatedContext: Schema.optional(Schema.Boolean),
+    arguments: Schema.optional(Schema.Array(CommandArgumentSchema)),
+    argumentHint: Schema.optional(Schema.String),
+    autoInvocable: Schema.optional(Schema.Boolean),
+    userInvocable: Schema.optional(Schema.Boolean),
+}).annotate({
+    identifier: "CommandFrontmatter",
+    title: "Command Frontmatter",
+    description: "YAML frontmatter fields for COMMAND.md files.",
+});
+/**
+ * Parse a COMMAND.md file's content into validated frontmatter and body.
+ *
+ * Delegates to the shared frontmatter parser, then validates the
+ * frontmatter against `CommandFrontmatterSchema`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const parseCommandMd = (content) => Effect.gen(function* () {
+    const parsed = yield* parseFrontmatterEffect(content);
+    if (parsed.frontmatter === undefined) {
+        return { frontmatter: Option.none(), body: parsed.body };
+    }
+    const frontmatter = yield* Effect.try({
+        try: () => Schema.decodeUnknownSync(CommandFrontmatterSchema)(parsed.frontmatter),
+        catch: (error) => makeAppError({
+            code: "COMMAND_FRONTMATTER_INVALID",
+            what: "Invalid COMMAND.md frontmatter",
+            details: [error instanceof Error ? error.message : String(error)],
+            howToFix: "Check the frontmatter fields in your COMMAND.md file.",
+            cause: error,
+        }),
+    });
+    return { frontmatter: Option.some(frontmatter), body: parsed.body };
+});
+/**
+ * Schema for manifest fields projected from frontmatter.
+ *
+ * Used during publish to sync description and model from COMMAND.md
+ * frontmatter into the command manifest.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const ManifestFieldsFromFrontmatterSchema = Schema.Struct({
+    description: Schema.optional(Schema.String),
+    model: Schema.optional(Schema.NullOr(Schema.String)),
+}).annotate({
+    identifier: "ManifestFieldsFromFrontmatter",
+    title: "Manifest Fields from Frontmatter",
+    description: "Fields projected from COMMAND.md frontmatter to command manifest.",
+});
+/**
+ * Project frontmatter fields to manifest fields.
+ *
+ * Extracts `description` and `model` from a parsed `CommandFrontmatter`
+ * for use in manifest updates.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const projectFrontmatterToManifest = (frontmatter) => ({
+    description: frontmatter.description,
+    model: frontmatter.model,
+});
+//# sourceMappingURL=command-content.js.map

package/dist/src/unstable/commands/command-content.js.map

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

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

@@ -0,0 +1,24 @@
+export { COMMAND_MANIFEST_FILENAME, CommandManifestSchema, type CommandManifest, } from "./manifest-schema.js";
+export { CommandArgumentSchema, type CommandArgument } from "./command-argument.js";
+export { CommandFrontmatterSchema, ManifestFieldsFromFrontmatterSchema, parseCommandMd, projectFrontmatterToManifest, type CommandFrontmatter, type CommandContentResult, type ManifestFieldsFromFrontmatter, } from "./command-content.js";
+export type { GitHostedCommandRef, RegistryCommandRef, LocalCommandRef, CommandExtensionRef, } from "./refs.js";
+export { CommandManager, CommandManagerLive, buildLockEntryFromRef } from "./manager.js";
+export { commandReconciliationAdapter } from "./reconciliation-adapter.js";
+export { buildRegistryCommandRef } from "./registry-ref-builder.js";
+export type { PublishCommandOperationArgs, PublishCommandOperation } from "./operations/publish.js";
+export { publishCommand } from "./operations/publish.js";
+export type { InstallCommandOperationArgs, InstallCommandOperation } from "./operations/install.js";
+export { installCommand } from "./operations/install.js";
+export type { UninstallCommandOperationArgs, UninstallCommandOperation, } from "./operations/uninstall.js";
+export { uninstallCommand } from "./operations/uninstall.js";
+export type { EnableCommandOperation } from "./operations/enable.js";
+export { enableCommand } from "./operations/enable.js";
+export type { DisableCommandOperation } from "./operations/disable.js";
+export { disableCommand } from "./operations/disable.js";
+export type { NewCommandOperationArgs, NewCommandOperation } from "./operations/new-command.js";
+export { newCommand } from "./operations/new-command.js";
+export { createWarningCollector, type LossyRenderingWarning, type WarningCollector, } from "./rendering-warnings.js";
+export { substituteVariables, resolveAgentFamily, agentFamilyMap, type PortableVariable, type AllArgumentsVariable, type PositionalVariable, type NamedVariable, type AgentFamily, type SubstitutionResult, } from "./variable-substitution.js";
+export { renderMarkdownWithFrontmatter, renderMarkdownOnly, renderPromptMd, renderToml, renderPlainText, selectRenderer, } from "./renderers/index.js";
+export type { AgentOverrides, RenderInput, RenderOutput, Renderer, RendererCommandFrontmatter, RendererCommandArgument, } from "./renderers/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/unstable/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEpF,OAAO,EACL,wBAAwB,EACxB,mCAAmC,EACnC,cAAc,EACd,4BAA4B,EAC5B,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,6BAA6B,GACnC,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAEzF,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAE3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,YAAY,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,YAAY,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,YAAY,EACV,6BAA6B,EAC7B,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,YAAY,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,YAAY,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAGzD,OAAO,EACL,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,6BAA6B,EAC7B,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,eAAe,EACf,cAAc,GACf,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,cAAc,EACd,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,sBAAsB,CAAC"}

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

@@ -0,0 +1,19 @@
+export { COMMAND_MANIFEST_FILENAME, CommandManifestSchema, } from "./manifest-schema.js";
+export { CommandArgumentSchema } from "./command-argument.js";
+export { CommandFrontmatterSchema, ManifestFieldsFromFrontmatterSchema, parseCommandMd, projectFrontmatterToManifest, } from "./command-content.js";
+export { CommandManager, CommandManagerLive, buildLockEntryFromRef } from "./manager.js";
+export { commandReconciliationAdapter } from "./reconciliation-adapter.js";
+export { buildRegistryCommandRef } from "./registry-ref-builder.js";
+export { publishCommand } from "./operations/publish.js";
+export { installCommand } from "./operations/install.js";
+export { uninstallCommand } from "./operations/uninstall.js";
+export { enableCommand } from "./operations/enable.js";
+export { disableCommand } from "./operations/disable.js";
+export { newCommand } from "./operations/new-command.js";
+// Rendering warnings
+export { createWarningCollector, } from "./rendering-warnings.js";
+// Variable substitution
+export { substituteVariables, resolveAgentFamily, agentFamilyMap, } from "./variable-substitution.js";
+// Renderers
+export { renderMarkdownWithFrontmatter, renderMarkdownOnly, renderPromptMd, renderToml, renderPlainText, selectRenderer, } from "./renderers/index.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/unstable/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,qBAAqB,GAEtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,qBAAqB,EAAwB,MAAM,uBAAuB,CAAC;AAEpF,OAAO,EACL,wBAAwB,EACxB,mCAAmC,EACnC,cAAc,EACd,4BAA4B,GAI7B,MAAM,sBAAsB,CAAC;AAS9B,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAEzF,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAE3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAKzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD,qBAAqB;AACrB,OAAO,EACL,sBAAsB,GAGvB,MAAM,yBAAyB,CAAC;AAEjC,wBAAwB;AACxB,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,GAOf,MAAM,4BAA4B,CAAC;AAEpC,YAAY;AACZ,OAAO,EACL,6BAA6B,EAC7B,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,eAAe,EACf,cAAc,GACf,MAAM,sBAAsB,CAAC"}

package/dist/src/unstable/commands/manager.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Command extension manager service.
+ *
+ * Implements ExtensionManager<CommandExtensionRef> with support for all ref
+ * types (registry, git-hosted, local). Delegates to existing command
+ * materialization functions and workspace service methods.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as ServiceMap from "effect/ServiceMap";
+import * as Layer from "effect/Layer";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import type { CommandExtensionRef } from "./refs.js";
+import type { CommandLockEntry } from "../lockfile/index.js";
+import type { ExtensionManager } from "../workspace/service-interface.js";
+import { Workspace } from "../workspace/service-interface.js";
+declare const CommandManager_base: ServiceMap.ServiceClass<CommandManager, "axm.sh/CommandManager", ExtensionManager<CommandExtensionRef>>;
+export declare class CommandManager extends CommandManager_base {
+}
+/**
+ * Build a CommandLockEntry from any ref type.
+ */
+export declare const buildLockEntryFromRef: (ref: CommandExtensionRef, now: Date) => CommandLockEntry;
+export declare const CommandManagerLive: Layer.Layer<CommandManager, never, FileSystem.FileSystem | Path.Path | Workspace>;
+export {};
+//# sourceMappingURL=manager.d.ts.map

package/dist/src/unstable/commands/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../src/unstable/commands/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAGpC,OAAO,KAAK,EACV,mBAAmB,EAIpB,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAA0B,MAAM,mCAAmC,CAAC;AAClG,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;;AAY9D,qBAAa,cAAe,SAAQ,mBAGR;CAAG;AA0F/B;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,KAAK,mBAAmB,EAAE,KAAK,IAAI,KAAG,gBAS3E,CAAC;AAWF,eAAO,MAAM,kBAAkB,mFAsS9B,CAAC"}