@agentxm/client-core 0.5.0 → 0.5.1

package/dist/src/unstable/cli-runtime/json-envelope.d.ts

@@ -1,22 +1,61 @@
 import * as Schema from "effect/Schema";
-import type { AppError } from "../app-error/index.js";
-export declare const JsonSchemaVersion = 1;
-export declare const JsonSchemaVersionSchema: Schema.Literal<1>;
+import { type AppError, type AppErrorCode } from "../app-error/index.js";
+import { type Breadcrumb } from "./breadcrumb.js";
 export declare const JsonErrorEnvelopeSchema: Schema.Struct<{
-    readonly _version: Schema.Literal<1>;
-    readonly type: Schema.Literal<"error">;
-    readonly code: Schema.String;
+    readonly ok: Schema.Literal<false>;
+    readonly code: Schema.Literals<readonly AppErrorCode[]>;
     readonly message: Schema.String;
-    readonly details: Schema.optional<Schema.$Array<Schema.String>>;
-    readonly howToFix: Schema.optional<Schema.String>;
+    readonly breadcrumbs: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly task: Schema.String;
+        readonly description: Schema.String;
+        readonly command: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly cmd: Schema.optional<Schema.String>;
+    }>>>;
     readonly exitCode: Schema.Number;
 }>;
 export type JsonErrorEnvelope = typeof JsonErrorEnvelopeSchema.Type;
+export declare const JsonSuccessEnvelopeSchema: Schema.StructWithRest<Schema.Struct<{
+    readonly ok: Schema.Literal<true>;
+    readonly summary: Schema.optional<Schema.String>;
+    readonly breadcrumbs: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly task: Schema.String;
+        readonly description: Schema.String;
+        readonly command: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly cmd: Schema.optional<Schema.String>;
+    }>>>;
+}>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>;
+export type JsonSuccessEnvelope = typeof JsonSuccessEnvelopeSchema.Type;
+export declare const JsonEnvelopeSchema: Schema.Union<readonly [Schema.StructWithRest<Schema.Struct<{
+    readonly ok: Schema.Literal<true>;
+    readonly summary: Schema.optional<Schema.String>;
+    readonly breadcrumbs: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly task: Schema.String;
+        readonly description: Schema.String;
+        readonly command: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly cmd: Schema.optional<Schema.String>;
+    }>>>;
+}>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>, Schema.Struct<{
+    readonly ok: Schema.Literal<false>;
+    readonly code: Schema.Literals<readonly AppErrorCode[]>;
+    readonly message: Schema.String;
+    readonly breadcrumbs: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly task: Schema.String;
+        readonly description: Schema.String;
+        readonly command: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly cmd: Schema.optional<Schema.String>;
+    }>>>;
+    readonly exitCode: Schema.Number;
+}>]>;
+export type JsonEnvelope = typeof JsonEnvelopeSchema.Type;
+export declare const makeJsonSuccessEnvelope: (args?: {
+    readonly payload?: unknown;
+    readonly summary?: string;
+    readonly breadcrumbs?: ReadonlyArray<Breadcrumb>;
+}) => JsonSuccessEnvelope;
 export declare const makeJsonErrorEnvelope: (args: {
-    readonly code: string;
+    readonly code: AppErrorCode;
     readonly message: string;
-    readonly details?: ReadonlyArray<string>;
-    readonly howToFix?: string;
+    readonly breadcrumbs?: ReadonlyArray<Breadcrumb>;
     readonly exitCode: number;
 }) => JsonErrorEnvelope;
 export declare const makeJsonErrorEnvelopeFromAppError: (error: AppError, exitCode: number) => JsonErrorEnvelope;

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

@@ -1 +1 @@
-{"version":3,"file":"json-envelope.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/json-envelope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,eAAO,MAAM,uBAAuB,mBAAoC,CAAC;AAEzE,eAAO,MAAM,uBAAuB;;;;;;;;EAYlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,uBAAuB,CAAC,IAAI,CAAC;AAEpE,eAAO,MAAM,qBAAqB,GAAI,MAAM;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,KAAG,iBAQF,CAAC;AAEH,eAAO,MAAM,iCAAiC,GAC5C,OAAO,QAAQ,EACf,UAAU,MAAM,KACf,iBAOC,CAAC"}
+{"version":3,"file":"json-envelope.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/json-envelope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAiB,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAIpE,eAAO,MAAM,uBAAuB;;;;;;;;;;;EAUlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,uBAAuB,CAAC,IAAI,CAAC;AAEpE,eAAO,MAAM,yBAAyB;;;;;;;;;6DAWpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,yBAAyB,CAAC,IAAI,CAAC;AAExE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;IAO7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAC;AAoB1D,eAAO,MAAM,uBAAuB,GAAI,OAAO;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CAClD,KAAG,mBAWF,CAAC;AAEH,eAAO,MAAM,qBAAqB,GAAI,MAAM;IAC1C,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,KAAG,iBAQF,CAAC;AAEH,eAAO,MAAM,iCAAiC,GAC5C,OAAO,QAAQ,EACf,UAAU,MAAM,KACf,iBAMC,CAAC"}

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

@@ -1,34 +1,76 @@
-import * as Option from "effect/Option";
 import * as Schema from "effect/Schema";
-export const JsonSchemaVersion = 1;
-export const JsonSchemaVersionSchema = Schema.Literal(JsonSchemaVersion);
+import { AppErrorCodes } from "../app-error/index.js";
+import { BreadcrumbSchema } from "./breadcrumb.js";
+const ReservedSuccessEnvelopeKeys = new Set(["ok", "summary", "breadcrumbs"]);
 export const JsonErrorEnvelopeSchema = Schema.Struct({
-    _version: JsonSchemaVersionSchema,
-    type: Schema.Literal("error"),
-    code: Schema.String,
+    ok: Schema.Literal(false),
+    code: Schema.Literals(AppErrorCodes),
     message: Schema.String,
-    details: Schema.optional(Schema.Array(Schema.String)),
-    howToFix: Schema.optional(Schema.String),
+    breadcrumbs: Schema.optional(Schema.Array(BreadcrumbSchema)),
     exitCode: Schema.Number,
 }).annotate({
     identifier: "JsonErrorEnvelope",
     title: "JSON Error Envelope",
     description: "Structured JSON error envelope for machine-readable CLI error output.",
 });
+export const JsonSuccessEnvelopeSchema = Schema.StructWithRest(Schema.Struct({
+    ok: Schema.Literal(true),
+    summary: Schema.optional(Schema.String),
+    breadcrumbs: Schema.optional(Schema.Array(BreadcrumbSchema)),
+}), [Schema.Record(Schema.String, Schema.Unknown)]).annotate({
+    identifier: "JsonSuccessEnvelope",
+    title: "JSON Success Envelope",
+    description: "Structured JSON success envelope for machine-readable CLI output.",
+});
+export const JsonEnvelopeSchema = Schema.Union([
+    JsonSuccessEnvelopeSchema,
+    JsonErrorEnvelopeSchema,
+]).annotate({
+    identifier: "JsonEnvelope",
+    title: "JSON Envelope",
+    description: "Structured JSON success or error envelope for machine-readable CLI output.",
+});
+const ensurePayloadObject = (payload) => {
+    if (payload === undefined) {
+        return {};
+    }
+    if (typeof payload !== "object" || payload === null || Array.isArray(payload)) {
+        return { value: payload };
+    }
+    return Object.fromEntries(Object.entries(payload));
+};
+const ensureNoReservedPayloadKeys = (payload) => {
+    for (const key of Object.keys(payload)) {
+        if (ReservedSuccessEnvelopeKeys.has(key)) {
+            throw new Error(`JSON success payload cannot include reserved key: ${key}`);
+        }
+    }
+};
+export const makeJsonSuccessEnvelope = (args) => ({
+    ok: true,
+    ...(() => {
+        const payload = ensurePayloadObject(args?.payload);
+        ensureNoReservedPayloadKeys(payload);
+        return payload;
+    })(),
+    ...(args?.summary !== undefined ? { summary: args.summary } : {}),
+    ...(args?.breadcrumbs !== undefined && args.breadcrumbs.length > 0
+        ? { breadcrumbs: [...args.breadcrumbs] }
+        : {}),
+});
 export const makeJsonErrorEnvelope = (args) => ({
-    _version: JsonSchemaVersion,
-    type: "error",
+    ok: false,
     code: args.code,
     message: args.message,
-    ...(args.details !== undefined && args.details.length > 0 ? { details: [...args.details] } : {}),
-    ...(args.howToFix !== undefined ? { howToFix: args.howToFix } : {}),
+    ...(args.breadcrumbs !== undefined && args.breadcrumbs.length > 0
+        ? { breadcrumbs: [...args.breadcrumbs] }
+        : {}),
     exitCode: args.exitCode,
 });
 export const makeJsonErrorEnvelopeFromAppError = (error, exitCode) => makeJsonErrorEnvelope({
     code: error.code,
-    message: error.what,
-    details: error.details,
-    ...(Option.isSome(error.howToFix) ? { howToFix: error.howToFix.value } : {}),
+    message: error.message,
+    breadcrumbs: error.breadcrumbs ?? [],
     exitCode,
 });
 //# sourceMappingURL=json-envelope.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"json-envelope.js","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/json-envelope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAEnC,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEzE,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC;IACnD,QAAQ,EAAE,uBAAuB;IACjC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrD,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC,MAAM;CACxB,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,mBAAmB;IAC/B,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EAAE,uEAAuE;CACrF,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,IAMrC,EAAqB,EAAE,CAAC,CAAC;IACxB,QAAQ,EAAE,iBAAiB;IAC3B,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,IAAI,CAAC,IAAI;IACf,OAAO,EAAE,IAAI,CAAC,OAAO;IACrB,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAChG,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,QAAQ,EAAE,IAAI,CAAC,QAAQ;CACxB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAC/C,KAAe,EACf,QAAgB,EACG,EAAE,CACrB,qBAAqB,CAAC;IACpB,IAAI,EAAE,KAAK,CAAC,IAAI;IAChB,OAAO,EAAE,KAAK,CAAC,IAAI;IACnB,OAAO,EAAE,KAAK,CAAC,OAAO;IACtB,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,QAAQ;CACT,CAAC,CAAC"}
+{"version":3,"file":"json-envelope.js","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/json-envelope.ts"],"names":[],"mappings":"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"}

package/dist/src/unstable/cli-runtime/output-mode.d.ts

@@ -1,8 +1,6 @@
 import * as Schema from "effect/Schema";
-import { JsonSchemaVersion } from "./json-envelope.js";
 export type OutputFormat = "text" | "json";
 export declare const ProgressEventSchema: Schema.Struct<{
-    readonly _version: Schema.Literal<1>;
     readonly type: Schema.Literal<"progress">;
     readonly phase: Schema.String;
     readonly percent: Schema.Number;
@@ -10,23 +8,26 @@ export declare const ProgressEventSchema: Schema.Struct<{
 }>;
 export type ProgressEvent = typeof ProgressEventSchema.Type;
 export declare const LogEventSchema: Schema.Struct<{
-    readonly _version: Schema.Literal<1>;
     readonly type: Schema.Literal<"log">;
     readonly level: Schema.Literals<readonly ["info", "warn", "error"]>;
     readonly message: Schema.String;
 }>;
 export type LogEvent = typeof LogEventSchema.Type;
 export declare const ErrorEventSchema: Schema.Struct<{
-    readonly _version: Schema.Literal<1>;
     readonly type: Schema.Literal<"error">;
     readonly code: Schema.String;
     readonly message: Schema.String;
-    readonly details: Schema.optional<Schema.$Array<Schema.String>>;
-    readonly howToFix: Schema.optional<Schema.String>;
     readonly exitCode: Schema.optional<Schema.Number>;
 }>;
 export type ErrorEvent = typeof ErrorEventSchema.Type;
-export type StreamEvent = ProgressEvent | LogEvent | ErrorEvent;
+export declare const BreadcrumbEventSchema: Schema.Struct<{
+    readonly type: Schema.Literal<"breadcrumb">;
+    readonly task: Schema.String;
+    readonly description: Schema.String;
+    readonly command: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly cmd: Schema.optional<Schema.String>;
+}>;
+export type BreadcrumbEvent = typeof BreadcrumbEventSchema.Type;
+export type StreamEvent = ProgressEvent | LogEvent | ErrorEvent | BreadcrumbEvent;
 export declare const emitEvent: (event: StreamEvent) => import("effect/Effect").Effect<void, never, never>;
-export { JsonSchemaVersion };
 //# sourceMappingURL=output-mode.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"output-mode.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/output-mode.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,iBAAiB,EAA2B,MAAM,oBAAoB,CAAC;AAMhF,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAe3C,eAAO,MAAM,mBAAmB;;;;;;EAU9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAC;AAE5D,eAAO,MAAM,cAAc;;;;;EAazB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,cAAc,CAAC,IAAI,CAAC;AAElD,eAAO,MAAM,gBAAgB;;;;;;;;EAY3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAC;AAEtD,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;AAMhE,eAAO,MAAM,SAAS,GAAI,OAAO,WAAW,uDAAyC,CAAC;AAEtF,OAAO,EAAE,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"output-mode.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/output-mode.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAMxC,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAe3C,eAAO,MAAM,mBAAmB;;;;;EAS9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAC;AAE5D,eAAO,MAAM,cAAc;;;;EAYzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,cAAc,CAAC,IAAI,CAAC;AAElD,eAAO,MAAM,gBAAgB;;;;;EAS3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAC;AAEtD,eAAO,MAAM,qBAAqB;;;;;;EAUhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,qBAAqB,CAAC,IAAI,CAAC;AAEhE,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,eAAe,CAAC;AAMlF,eAAO,MAAM,SAAS,GAAI,OAAO,WAAW,uDAAyC,CAAC"}

package/dist/src/unstable/cli-runtime/output-mode.js

@@ -1,6 +1,5 @@
 import * as Console from "effect/Console";
 import * as Schema from "effect/Schema";
-import { JsonSchemaVersion, JsonSchemaVersionSchema } from "./json-envelope.js";
 // ---------------------------------------------------------------------------
 // NDJSON event schemas — typed contract for machine-mode stderr events
 //
@@ -14,7 +13,6 @@ import { JsonSchemaVersion, JsonSchemaVersionSchema } from "./json-envelope.js";
 //   result   → final output (emitted last, wraps command-specific data)
 // ---------------------------------------------------------------------------
 export const ProgressEventSchema = Schema.Struct({
-    _version: JsonSchemaVersionSchema,
     type: Schema.Literal("progress"),
     phase: Schema.String,
     percent: Schema.Number,
@@ -25,7 +23,6 @@ export const ProgressEventSchema = Schema.Struct({
     description: "NDJSON progress event for driving progress bars in machine mode.",
 });
 export const LogEventSchema = Schema.Struct({
-    _version: JsonSchemaVersionSchema,
     type: Schema.Literal("log"),
     level: Schema.Literals(["info", "warn", "error"]).annotate({
         identifier: "LogLevel",
@@ -39,21 +36,28 @@ export const LogEventSchema = Schema.Struct({
     description: "NDJSON log event for informational messages at different severity levels.",
 });
 export const ErrorEventSchema = Schema.Struct({
-    _version: JsonSchemaVersionSchema,
     type: Schema.Literal("error"),
     code: Schema.String,
     message: Schema.String,
-    details: Schema.optional(Schema.Array(Schema.String)),
-    howToFix: Schema.optional(Schema.String),
     exitCode: Schema.optional(Schema.Number),
 }).annotate({
     identifier: "ErrorEvent",
     title: "Error Event",
     description: "NDJSON error event with a stable error code for programmatic handling.",
 });
+export const BreadcrumbEventSchema = Schema.Struct({
+    type: Schema.Literal("breadcrumb"),
+    task: Schema.String,
+    description: Schema.String,
+    command: Schema.optional(Schema.Array(Schema.String)),
+    cmd: Schema.optional(Schema.String),
+}).annotate({
+    identifier: "BreadcrumbEvent",
+    title: "Breadcrumb Event",
+    description: "NDJSON breadcrumb event with a suggested follow-up task.",
+});
 // ---------------------------------------------------------------------------
 // Event emitter — writes a single NDJSON line to stderr
 // ---------------------------------------------------------------------------
 export const emitEvent = (event) => Console.error(JSON.stringify(event));
-export { JsonSchemaVersion };
 //# sourceMappingURL=output-mode.js.map

package/dist/src/unstable/cli-runtime/output-mode.js.map

@@ -1 +1 @@
-{"version":3,"file":"output-mode.js","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/output-mode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAQhF,8EAA8E;AAC9E,uEAAuE;AACvE,EAAE;AACF,+EAA+E;AAC/E,yEAAyE;AACzE,4CAA4C;AAC5C,EAAE;AACF,6DAA6D;AAC7D,mEAAmE;AACnE,sEAAsE;AACtE,wEAAwE;AACxE,8EAA8E;AAE9E,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/C,QAAQ,EAAE,uBAAuB;IACjC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,eAAe;IAC3B,KAAK,EAAE,gBAAgB;IACvB,WAAW,EAAE,kEAAkE;CAChF,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1C,QAAQ,EAAE,uBAAuB;IACjC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC,CAAC,QAAQ,CAAC;QAClE,UAAU,EAAE,UAAU;QACtB,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,gCAAgC;KAC9C,CAAC;IACF,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,UAAU;IACtB,KAAK,EAAE,WAAW;IAClB,WAAW,EAAE,2EAA2E;CACzF,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5C,QAAQ,EAAE,uBAAuB;IACjC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrD,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;CACzC,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,YAAY;IACxB,KAAK,EAAE,aAAa;IACpB,WAAW,EAAE,wEAAwE;CACtF,CAAC,CAAC;AAKH,8EAA8E;AAC9E,wDAAwD;AACxD,8EAA8E;AAE9E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAkB,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAEtF,OAAO,EAAE,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"output-mode.js","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/output-mode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAQxC,8EAA8E;AAC9E,uEAAuE;AACvE,EAAE;AACF,+EAA+E;AAC/E,yEAAyE;AACzE,4CAA4C;AAC5C,EAAE;AACF,6DAA6D;AAC7D,mEAAmE;AACnE,sEAAsE;AACtE,wEAAwE;AACxE,8EAA8E;AAE9E,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,eAAe;IAC3B,KAAK,EAAE,gBAAgB;IACvB,WAAW,EAAE,kEAAkE;CAChF,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC,CAAC,QAAQ,CAAC;QAClE,UAAU,EAAE,UAAU;QACtB,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,gCAAgC;KAC9C,CAAC;IACF,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,UAAU;IACtB,KAAK,EAAE,WAAW;IAClB,WAAW,EAAE,2EAA2E;CACzF,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;CACzC,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,YAAY;IACxB,KAAK,EAAE,aAAa;IACpB,WAAW,EAAE,wEAAwE;CACtF,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC,MAAM;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM;IAC1B,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrD,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;CACpC,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,iBAAiB;IAC7B,KAAK,EAAE,kBAAkB;IACzB,WAAW,EAAE,0DAA0D;CACxE,CAAC,CAAC;AAKH,8EAA8E;AAC9E,wDAAwD;AACxD,8EAA8E;AAE9E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAkB,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"runtime-envelope.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/runtime-envelope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAItC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAGzE,OAAO,EAAyB,KAAK,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAY7F,OAAO,EAAwC,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAClG,OAAO,EAAsB,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAO3F,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,eAAe,CAAC;AAC1D,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,SAAS,CAAC;AAuC3D;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,YAAY,EACpB,UAAU;IACR,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;CACtD,wLA+BF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,+EAG3B,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,EAAE,CAAC,EACvC,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,EAC9C,SAAS;IACP,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAC;CACrD,kbA0FF,CAAC;AAMF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAC;CACrD;AAED,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,CAAC,EACjC,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,EAC9C,SAAS,qBAAqB,2fAY5B,CAAC"}
+{"version":3,"file":"runtime-envelope.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/runtime-envelope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAItC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAGzE,OAAO,EAAyB,KAAK,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAY7F,OAAO,EAAwC,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAClG,OAAO,EAAsB,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AA2D3F,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,eAAe,CAAC;AAC1D,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,SAAS,CAAC;AAuC3D;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,YAAY,EACpB,UAAU;IACR,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;CACtD,wLA+BF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,+EAG3B,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,EAAE,CAAC,EACvC,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,EAC9C,SAAS;IACP,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAC;CACrD,kbA6FF,CAAC;AAMF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAC;CACrD;AAED,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,CAAC,EACjC,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,EAC9C,SAAS,qBAAqB,2fAY5B,CAAC"}

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

@@ -3,7 +3,7 @@ import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import * as Option from "effect/Option";
 import { jsonFlag, debugFlag, verboseFlag, quietFlag } from "../cli-flags/index.js";
-import { renderAppError } from "../app-error/index.js";
+import { exitCodeFor, renderAppError } from "../app-error/index.js";
 import { effectCliExit, isEffectCliExit } from "./effect-cli-exit.js";
 import { resolveFormat } from "./resolve-format.js";
 import { makeCliTelemetryLayer } from "./telemetry-layer.js";
@@ -15,7 +15,47 @@ import { makeJsonErrorEnvelopeFromAppError } from "./json-envelope.js";
 const writeStderr = (message) => {
     process.stderr.write(message.endsWith("\n") ? message : `${message}\n`);
 };
-const defaultExitCodeForExpectedError = (error) => error._tag === "PromptCancelled" ? 0 : 1;
+const formatBreadcrumbCommand = (command) => command.join(" ");
+const formatBreadcrumbAction = (crumb) => {
+    if (crumb.command !== undefined) {
+        return ` · ${formatBreadcrumbCommand(crumb.command)}`;
+    }
+    if (crumb.cmd !== undefined) {
+        return ` · ${crumb.cmd}`;
+    }
+    return "";
+};
+const writeTextBreadcrumbs = (breadcrumbs) => {
+    if (breadcrumbs.length === 0) {
+        return;
+    }
+    writeStderr([
+        "Next:",
+        ...breadcrumbs.map((crumb) => {
+            return `  ${crumb.description}${formatBreadcrumbAction(crumb)}`;
+        }),
+    ].join("\n"));
+};
+const writeMachineBreadcrumbs = (breadcrumbs) => {
+    for (const crumb of breadcrumbs) {
+        writeStderr(JSON.stringify({
+            type: "breadcrumb",
+            task: crumb.task,
+            description: crumb.description,
+            ...(crumb.command !== undefined ? { command: [...crumb.command] } : {}),
+            ...(crumb.cmd !== undefined ? { cmd: crumb.cmd } : {}),
+        }));
+    }
+};
+const writeMachineError = (error, exitCode) => {
+    writeStderr(JSON.stringify({
+        type: "error",
+        code: error.code,
+        message: error.message,
+        exitCode,
+    }));
+};
+const defaultExitCodeForExpectedError = (error) => error._tag === "PromptCancelled" ? 0 : exitCodeFor(error.code);
 const writeExpectedCliError = (error, format) => Effect.gen(function* () {
     if (error._tag === "PromptCancelled") {
         return;
@@ -30,10 +70,14 @@ const writeExpectedCliError = (error, format) => Effect.gen(function* () {
     });
     if (format === "text") {
         writeStderr(renderAppError(error, { verbose, debug }));
+        writeTextBreadcrumbs(error.breadcrumbs ?? []);
         return;
     }
-    process.stdout.write(JSON.stringify(makeJsonErrorEnvelopeFromAppError(error, defaultExitCodeForExpectedError(error)), null, 2) + "\n");
-    writeStderr(`\u2717 ${error.what}`);
+    const exitCode = defaultExitCodeForExpectedError(error);
+    writeMachineBreadcrumbs(error.breadcrumbs ?? []);
+    writeMachineError(error, exitCode);
+    process.stdout.write(JSON.stringify(makeJsonErrorEnvelopeFromAppError(error, exitCode), null, 2) + "\n");
+    writeStderr(`\u2717 ${error.message}`);
 });
 // ---------------------------------------------------------------------------
 // Building blocks — composable pieces callers assemble directly
@@ -121,7 +165,10 @@ export const withCliErrorHandling = (program, options) => {
                     command,
                     result,
                     durationMs,
-                    ...(error._tag === "AppError" && { errorCode: error.code }),
+                    ...(error._tag === "AppError" && {
+                        errorCode: error.code,
+                        errorCategory: error.code,
+                    }),
                     semanticProperties,
                 });
             })), Effect.andThen(Effect.die(effectCliExit(exitCode))));

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

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

@@ -18,6 +18,7 @@ export interface CliCommandCompletedOptions {
     readonly result: "success" | "error" | "cancelled" | "defect";
     readonly durationMs: number;
     readonly errorCode?: string;
+    readonly errorCategory?: string;
     readonly semanticProperties?: TelemetryProperties;
 }
 export declare const trackCliCommandCompleted: (options: CliCommandCompletedOptions) => Effect.Effect<void, never, TelemetryClient>;
@@ -32,7 +33,7 @@ export declare const reportCliError: (error: AppError | PromptCancelled, command
 export interface CommandSemanticPropertiesService {
     readonly ref: Ref.Ref<TelemetryProperties>;
 }
-declare const CommandSemanticProperties_base: ServiceMap.ServiceClass<CommandSemanticProperties, "@agentxm/client-core/CommandSemanticProperties", CommandSemanticPropertiesService>;
+declare const CommandSemanticProperties_base: ServiceMap.ServiceClass<CommandSemanticProperties, "@agentxm/client-core/unstable/cli-runtime/telemetry/CommandSemanticProperties", CommandSemanticPropertiesService>;
 export declare class CommandSemanticProperties extends CommandSemanticProperties_base {
 }
 /**

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

@@ -1 +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,gBAAgB,CAAC;AAC7C,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"}
+{"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,gBAAgB,CAAC;AAC7C,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,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,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,CAWE,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,CAa5B,CAAC;AAMlB,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;CAC5C;;AAED,qBAAa,yBAA0B,SAAQ,8BAGqC;CAAG;AAEvF;;;;;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

@@ -17,6 +17,7 @@ export const trackCliCommandCompleted = (options) => Effect.gen(function* () {
         "cli.result": options.result,
         "cli.duration_ms": options.durationMs,
         ...(options.errorCode !== undefined && { "cli.error_code": options.errorCode }),
+        ...(options.errorCategory !== undefined && { "cli.error_category": options.errorCategory }),
         ...(options.semanticProperties ?? {}),
     });
 }).pipe(Effect.catchCause(() => Effect.void));
@@ -45,16 +46,15 @@ export const reportCliError = (error, command) => error._tag === "AppError"
         const telemetry = yield* TelemetryClient;
         yield* telemetry.reportError({
             name: error.code,
-            message: error.what,
-            details: error.details,
-            ...(Option.isSome(error.howToFix) && { howToFix: error.howToFix.value }),
+            message: error.message,
+            category: error.code,
             level: "error",
             handled: true,
             command,
         });
     }).pipe(Effect.catchCause(() => Effect.void))
     : Effect.void;
-export class CommandSemanticProperties extends ServiceMap.Service()("@agentxm/client-core/CommandSemanticProperties") {
+export class CommandSemanticProperties extends ServiceMap.Service()("@agentxm/client-core/unstable/cli-runtime/telemetry/CommandSemanticProperties") {
 }
 /**
  * Set semantic telemetry properties from within a command handler.

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

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

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

@@ -1,8 +1,8 @@
 /**
  * Command argument schema definition.
  *
- * Defines the shape of arguments that a command accepts,
- * used in COMMAND.md frontmatter.
+ * Defines the shape of arguments that a command accepts, used in the command
+ * content file's frontmatter (`${name}.md`).
  *
  * @experimental This API is unstable and may change without notice.
  */

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

@@ -1,8 +1,8 @@
 /**
  * Command argument schema definition.
  *
- * Defines the shape of arguments that a command accepts,
- * used in COMMAND.md frontmatter.
+ * Defines the shape of arguments that a command accepts, used in the command
+ * content file's frontmatter (`${name}.md`).
  *
  * @experimental This API is unstable and may change without notice.
  */

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

@@ -1,9 +1,10 @@
 /**
- * Command content file module for COMMAND.md parsing and frontmatter schemas.
+ * Command content file module — parsing and frontmatter schemas for the
+ * `${name}.md` content file.
  *
- * 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.
+ * Defines the frontmatter schema, 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.
  */
@@ -12,25 +13,11 @@ 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.
+ * Schema for command content file 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>;
-}>;
+export declare const CommandFrontmatterSchema: Schema.$Record<Schema.String, Schema.Unknown>;
 /**
  * Inferred type for CommandFrontmatter schema.
  *
@@ -38,7 +25,7 @@ export declare const CommandFrontmatterSchema: Schema.Struct<{
  */
 export type CommandFrontmatter = Schema.Schema.Type<typeof CommandFrontmatterSchema>;
 /**
- * Result of parsing a COMMAND.md file.
+ * Result of parsing a command content file.
  *
  * @experimental This API is unstable and may change without notice.
  */
@@ -49,7 +36,7 @@ export interface CommandContentResult {
     readonly body: string;
 }
 /**
- * Parse a COMMAND.md file's content into validated frontmatter and body.
+ * Parse a command content file into validated frontmatter and body.
  *
  * Delegates to the shared frontmatter parser, then validates the
  * frontmatter against `CommandFrontmatterSchema`.
@@ -60,8 +47,8 @@ export declare const parseCommandMd: (content: string) => Effect.Effect<CommandC
 /**
  * Schema for manifest fields projected from frontmatter.
  *
- * Used during publish to sync description and model from COMMAND.md
- * frontmatter into the command manifest.
+ * Used during publish to sync description and model from the command content
+ * file's frontmatter into the command manifest.
  *
  * @experimental This API is unstable and may change without notice.
  */