@better-agent/shared 0.1.0-canary.0

package/README.md

@@ -0,0 +1,3 @@
+# @better-agent/shared
+
+Shared utilities for Better Agent.

package/dist/chunk-CtajNgzt.mjs

@@ -0,0 +1,36 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (!no_symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+
+//#endregion
+export { __reExport as n, __exportAll as t };

package/dist/errors.d.mts

@@ -0,0 +1,96 @@
+//#region src/errors.d.ts
+/** Better Agent error codes. */
+type BetterAgentErrorCode = "BAD_REQUEST" | "VALIDATION_FAILED" | "NOT_FOUND" | "CONFLICT" | "RATE_LIMITED" | "TIMEOUT" | "ABORTED" | "UPSTREAM_FAILED" | "INTERNAL" | (string & {});
+type ErrorCodeMeta = {
+  status: number;
+  title: string;
+  retryable: boolean;
+  slug: string;
+};
+declare const ERROR_DOCS_BASE_URL = "https://better-agent.com/docs/concepts/errors";
+/** Default metadata by error code. */
+declare const ERROR_CODE_META: Readonly<Record<string, ErrorCodeMeta>>;
+/** One error trace frame. */
+type BetterAgentErrorTraceFrame = {
+  at: string;
+  data?: Record<string, unknown>;
+};
+/** Free-form error metadata. */
+type BetterAgentErrorContext = Record<string, unknown>;
+/** RFC 7807-style error payload. */
+type BetterAgentProblemDetails = {
+  type: string;
+  title: string;
+  status: number;
+  detail: string;
+  code: string;
+  retryable?: boolean;
+  issues?: unknown[];
+  context?: BetterAgentErrorContext;
+  traceId?: string;
+  trace?: BetterAgentErrorTraceFrame[];
+};
+type WrapOptions = {
+  code?: BetterAgentErrorCode | undefined;
+  status?: number | undefined;
+  title?: string | undefined;
+  type?: string | undefined;
+  retryable?: boolean | undefined;
+  issues?: unknown[] | undefined;
+  context?: BetterAgentErrorContext | undefined;
+  traceId?: string | undefined;
+  cause?: unknown;
+  trace?: BetterAgentErrorTraceFrame[] | undefined;
+  stackFrom?: Function;
+};
+/** Options for {@link BetterAgentError}. */
+type BetterAgentErrorOptions = {
+  code: BetterAgentErrorCode;
+  status?: number | undefined;
+  title?: string | undefined;
+  type?: string | undefined;
+  retryable?: boolean | undefined;
+  issues?: unknown[] | undefined;
+  context?: BetterAgentErrorContext | undefined;
+  traceId?: string | undefined;
+  cause?: unknown;
+  trace?: BetterAgentErrorTraceFrame[] | undefined;
+  stackFrom?: Function;
+};
+/** Better Agent error type. */
+declare class BetterAgentError extends Error {
+  code: BetterAgentErrorCode;
+  status: number;
+  title: string;
+  type: string;
+  retryable: boolean;
+  issues?: unknown[];
+  context?: BetterAgentErrorContext;
+  traceId?: string;
+  trace: BetterAgentErrorTraceFrame[];
+  constructor(message: string, opts: BetterAgentErrorOptions);
+  /** Adds a trace frame. */
+  at(frame: BetterAgentErrorTraceFrame): this;
+  /** Converts this error to problem details. */
+  toProblem(overrides?: Partial<BetterAgentProblemDetails>): BetterAgentProblemDetails;
+  /** JSON form for `JSON.stringify`. */
+  toJSON(): BetterAgentProblemDetails;
+  /** Debug form with stack and cause. */
+  toDebugJSON(): BetterAgentProblemDetails & {
+    stack?: string;
+    cause?: unknown;
+  };
+  /** Creates an error from a code and message. */
+  static fromCode(code: BetterAgentErrorCode, message: string, opts?: Omit<WrapOptions, "code">): BetterAgentError;
+  /** Rehydrates an error from problem details. */
+  static fromProblem(input: BetterAgentProblemDetails | Record<string, unknown>, opts?: Omit<WrapOptions, "code">): BetterAgentError;
+  /** Wraps unknown errors as {@link BetterAgentError}. */
+  static wrap(args: {
+    err: unknown;
+    message?: string;
+    opts?: WrapOptions;
+  }): BetterAgentError;
+}
+//#endregion
+export { BetterAgentError, BetterAgentErrorCode, BetterAgentErrorContext, BetterAgentErrorOptions, BetterAgentErrorTraceFrame, BetterAgentProblemDetails, ERROR_CODE_META, ERROR_DOCS_BASE_URL };
+//# sourceMappingURL=errors.d.mts.map

package/dist/errors.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.mts","names":[],"sources":["../src/errors.ts"],"mappings":";;KACY,oBAAA;AAAA,KAYP,aAAA;EACD,MAAA;EACA,KAAA;EACA,SAAA;EACA,IAAA;AAAA;AAAA,cAGS,mBAAA;;cAGA,eAAA,EAAiB,QAAA,CAAS,MAAA,SAAe,aAAA;;KAsC1C,0BAAA;EACR,EAAA;EACA,IAAA,GAAO,MAAA;AAAA;AA3CX;AAAA,KA+CY,uBAAA,GAA0B,MAAA;;KAG1B,yBAAA;EACR,IAAA;EACA,KAAA;EACA,MAAA;EACA,MAAA;EACA,IAAA;EACA,SAAA;EACA,MAAA;EACA,OAAA,GAAU,uBAAA;EACV,OAAA;EACA,KAAA,GAAQ,0BAAA;AAAA;AAAA,KAGP,WAAA;EACD,IAAA,GAAO,oBAAA;EACP,MAAA;EACA,KAAA;EACA,IAAA;EACA,SAAA;EACA,MAAA;EACA,OAAA,GAAU,uBAAA;EACV,OAAA;EACA,KAAA;EACA,KAAA,GAAQ,0BAAA;EAER,SAAA,GAAY,QAAA;AAAA;;KAIJ,uBAAA;EACR,IAAA,EAAM,oBAAA;EACN,MAAA;EACA,KAAA;EACA,IAAA;EACA,SAAA;EACA,MAAA;EACA,OAAA,GAAU,uBAAA;EACV,OAAA;EACA,KAAA;EACA,KAAA,GAAQ,0BAAA;EAER,SAAA,GAAY,QAAA;AAAA;;cAkCH,gBAAA,SAAyB,KAAA;EAClC,IAAA,EAAM,oBAAA;EACN,MAAA;EACA,KAAA;EACA,IAAA;EACA,SAAA;EACQ,MAAA;EACA,OAAA,GAAU,uBAAA;EACV,OAAA;EACR,KAAA,EAAO,0BAAA;cAEK,OAAA,UAAiB,IAAA,EAAM,uBAAA;EAlEzB;EAiGV,EAAA,CAAG,KAAA,EAAO,0BAAA;EA5FE;EAkGZ,SAAA,CAAU,SAAA,GAAW,OAAA,CAAQ,yBAAA,IAAkC,yBAAA;EAlG3C;EAiIpB,MAAA,CAAA,GAAM,yBAAA;EA5IC;EAiJP,WAAA,CAAA,GAAW,yBAAA;;;;EA5IX;EAAA,OAyJO,QAAA,CACH,IAAA,EAAM,oBAAA,EACN,OAAA,UACA,IAAA,GAAM,IAAA,CAAK,WAAA,YACZ,gBAAA;EA5JO;EAAA,OAqKH,WAAA,CACH,KAAA,EAAO,yBAAA,GAA4B,MAAA,mBACnC,IAAA,GAAM,IAAA,CAAK,WAAA,YACZ,gBAAA;EAtKH;EAAA,OAkMO,IAAA,CAAK,IAAA;IACR,GAAA;IACA,OAAA;IACA,IAAA,GAAO,WAAA;EAAA,IACP,gBAAA;AAAA"}

package/dist/errors.mjs

@@ -0,0 +1,214 @@
+//#region src/errors.ts
+const ERROR_DOCS_BASE_URL = "https://better-agent.com/docs/concepts/errors";
+/** Default metadata by error code. */
+const ERROR_CODE_META = {
+	BAD_REQUEST: {
+		status: 400,
+		title: "Bad Request",
+		retryable: false,
+		slug: "bad-request"
+	},
+	NOT_FOUND: {
+		status: 404,
+		title: "Not Found",
+		retryable: false,
+		slug: "not-found"
+	},
+	CONFLICT: {
+		status: 409,
+		title: "Conflict",
+		retryable: false,
+		slug: "conflict"
+	},
+	VALIDATION_FAILED: {
+		status: 422,
+		title: "Unprocessable Entity",
+		retryable: false,
+		slug: "validation-failed"
+	},
+	RATE_LIMITED: {
+		status: 429,
+		title: "Too Many Requests",
+		retryable: true,
+		slug: "rate-limited"
+	},
+	TIMEOUT: {
+		status: 504,
+		title: "Gateway Timeout",
+		retryable: true,
+		slug: "timeout"
+	},
+	ABORTED: {
+		status: 499,
+		title: "Client Closed Request",
+		retryable: false,
+		slug: "aborted"
+	},
+	UPSTREAM_FAILED: {
+		status: 502,
+		title: "Upstream Failed",
+		retryable: true,
+		slug: "upstream-failed"
+	},
+	INTERNAL: {
+		status: 500,
+		title: "Internal Server Error",
+		retryable: false,
+		slug: "internal"
+	}
+};
+const isRecord = (value) => typeof value === "object" && value !== null;
+const isProblemDetailsLike = (value) => {
+	if (!isRecord(value)) return false;
+	return typeof value.type === "string" && typeof value.title === "string" && typeof value.status === "number" && typeof value.detail === "string" && typeof value.code === "string";
+};
+const getCodeMeta = (code) => {
+	const found = ERROR_CODE_META[code];
+	if (found) return found;
+	return {
+		status: 500,
+		title: "Internal Server Error",
+		retryable: false,
+		slug: code.toLowerCase().replace(/_/g, "-")
+	};
+};
+const getDocsTypeUrl = (code) => {
+	return `${ERROR_DOCS_BASE_URL}#${getCodeMeta(code).slug}`;
+};
+/** Better Agent error type. */
+var BetterAgentError = class BetterAgentError extends Error {
+	code;
+	status;
+	title;
+	type;
+	retryable;
+	trace;
+	constructor(message, opts) {
+		if (opts.cause !== void 0) super(message, { cause: opts.cause });
+		else super(message);
+		Object.setPrototypeOf(this, new.target.prototype);
+		this.name = "BetterAgentError";
+		const meta = getCodeMeta(opts.code);
+		this.code = opts.code;
+		this.status = opts.status ?? meta.status;
+		this.title = opts.title ?? meta.title;
+		this.type = opts.type ?? getDocsTypeUrl(opts.code);
+		this.retryable = opts.retryable ?? meta.retryable;
+		if (opts.issues !== void 0) this.issues = opts.issues;
+		if (opts.context !== void 0) this.context = opts.context;
+		if (opts.traceId !== void 0) this.traceId = opts.traceId;
+		this.trace = opts.trace ?? [];
+		const ctor = Error;
+		if (ctor.captureStackTrace !== void 0) ctor.captureStackTrace(this, opts.stackFrom ?? BetterAgentError);
+	}
+	/** Adds a trace frame. */
+	at(frame) {
+		this.trace.push(frame);
+		return this;
+	}
+	/** Converts this error to problem details. */
+	toProblem(overrides = {}) {
+		const out = {
+			type: overrides.type ?? this.type,
+			title: overrides.title ?? this.title,
+			status: overrides.status ?? this.status,
+			detail: overrides.detail ?? this.message,
+			code: String(overrides.code ?? this.code)
+		};
+		const retryable = overrides.retryable ?? this.retryable;
+		if (retryable !== void 0) out.retryable = retryable;
+		const issues = overrides.issues ?? this.issues;
+		if (issues !== void 0) out.issues = issues;
+		const traceId = overrides.traceId ?? this.traceId;
+		if (traceId !== void 0) out.traceId = traceId;
+		const context = {
+			...this.context ?? {},
+			...isRecord(overrides.context) ? overrides.context : {}
+		};
+		if (Object.keys(context).length > 0) out.context = context;
+		const trace = overrides.trace ?? this.trace;
+		if (trace.length > 0) out.trace = trace;
+		return out;
+	}
+	/** JSON form for `JSON.stringify`. */
+	toJSON() {
+		return this.toProblem();
+	}
+	/** Debug form with stack and cause. */
+	toDebugJSON() {
+		const debug = this.toProblem();
+		if (this.stack !== void 0) debug.stack = this.stack;
+		if (this.cause !== void 0) debug.cause = this.cause;
+		return debug;
+	}
+	/** Creates an error from a code and message. */
+	static fromCode(code, message, opts = {}) {
+		return new BetterAgentError(message, {
+			code,
+			...opts,
+			stackFrom: opts.stackFrom ?? BetterAgentError.fromCode
+		});
+	}
+	/** Rehydrates an error from problem details. */
+	static fromProblem(input, opts = {}) {
+		if (!isProblemDetailsLike(input)) return BetterAgentError.wrap({
+			err: input,
+			message: "Invalid problem details payload",
+			opts: {
+				...opts,
+				code: "INTERNAL"
+			}
+		});
+		return new BetterAgentError(input.detail, {
+			code: input.code,
+			status: input.status,
+			title: input.title,
+			type: input.type,
+			retryable: input.retryable,
+			issues: input.issues,
+			context: input.context,
+			traceId: input.traceId,
+			trace: input.trace,
+			...opts,
+			stackFrom: opts.stackFrom ?? BetterAgentError.fromProblem
+		});
+	}
+	/** Wraps unknown errors as {@link BetterAgentError}. */
+	static wrap(args) {
+		const code = args.opts?.code ?? "INTERNAL";
+		if (args.err instanceof BetterAgentError) return new BetterAgentError(args.message ? `${args.message}: ${args.err.message}` : args.err.message, {
+			code,
+			status: args.opts?.status ?? args.err.status,
+			title: args.opts?.title ?? args.err.title,
+			type: args.opts?.type ?? args.err.type,
+			retryable: args.opts?.retryable ?? args.err.retryable,
+			context: {
+				...args.err.context ?? {},
+				...args.opts?.context ?? {}
+			},
+			traceId: args.opts?.traceId ?? args.err.traceId,
+			trace: args.opts?.trace ? [...args.err.trace, ...args.opts.trace] : args.err.trace,
+			cause: args.opts?.cause ?? args.err,
+			stackFrom: args.opts?.stackFrom ?? BetterAgentError.wrap
+		});
+		if (isProblemDetailsLike(args.err)) return BetterAgentError.fromProblem(args.err, {
+			...args.opts,
+			stackFrom: args.opts?.stackFrom ?? BetterAgentError.wrap
+		});
+		if (args.err instanceof Error) return new BetterAgentError(args.message || args.err.message, {
+			...args.opts,
+			code,
+			cause: args.opts?.cause ?? args.err,
+			stackFrom: args.opts?.stackFrom ?? BetterAgentError.wrap
+		});
+		return new BetterAgentError(args.message || "Unknown error", {
+			...args.opts,
+			code,
+			stackFrom: args.opts?.stackFrom ?? BetterAgentError.wrap
+		});
+	}
+};
+
+//#endregion
+export { BetterAgentError, ERROR_CODE_META, ERROR_DOCS_BASE_URL };
+//# sourceMappingURL=errors.mjs.map

package/dist/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.mjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Better Agent error codes. */\nexport type BetterAgentErrorCode =\n    | \"BAD_REQUEST\"\n    | \"VALIDATION_FAILED\"\n    | \"NOT_FOUND\"\n    | \"CONFLICT\"\n    | \"RATE_LIMITED\"\n    | \"TIMEOUT\"\n    | \"ABORTED\"\n    | \"UPSTREAM_FAILED\"\n    | \"INTERNAL\"\n    | (string & {});\n\ntype ErrorCodeMeta = {\n    status: number;\n    title: string;\n    retryable: boolean;\n    slug: string;\n};\n\nexport const ERROR_DOCS_BASE_URL = \"https://better-agent.com/docs/concepts/errors\";\n\n/** Default metadata by error code. */\nexport const ERROR_CODE_META: Readonly<Record<string, ErrorCodeMeta>> = {\n    BAD_REQUEST: { status: 400, title: \"Bad Request\", retryable: false, slug: \"bad-request\" },\n    NOT_FOUND: { status: 404, title: \"Not Found\", retryable: false, slug: \"not-found\" },\n    CONFLICT: { status: 409, title: \"Conflict\", retryable: false, slug: \"conflict\" },\n    VALIDATION_FAILED: {\n        status: 422,\n        title: \"Unprocessable Entity\",\n        retryable: false,\n        slug: \"validation-failed\",\n    },\n    RATE_LIMITED: {\n        status: 429,\n        title: \"Too Many Requests\",\n        retryable: true,\n        slug: \"rate-limited\",\n    },\n    TIMEOUT: { status: 504, title: \"Gateway Timeout\", retryable: true, slug: \"timeout\" },\n    ABORTED: {\n        status: 499,\n        title: \"Client Closed Request\",\n        retryable: false,\n        slug: \"aborted\",\n    },\n    UPSTREAM_FAILED: {\n        status: 502,\n        title: \"Upstream Failed\",\n        retryable: true,\n        slug: \"upstream-failed\",\n    },\n    INTERNAL: {\n        status: 500,\n        title: \"Internal Server Error\",\n        retryable: false,\n        slug: \"internal\",\n    },\n};\n\n/** One error trace frame. */\nexport type BetterAgentErrorTraceFrame = {\n    at: string;\n    data?: Record<string, unknown>;\n};\n\n/** Free-form error metadata. */\nexport type BetterAgentErrorContext = Record<string, unknown>;\n\n/** RFC 7807-style error payload. */\nexport type BetterAgentProblemDetails = {\n    type: string;\n    title: string;\n    status: number;\n    detail: string;\n    code: string;\n    retryable?: boolean;\n    issues?: unknown[];\n    context?: BetterAgentErrorContext;\n    traceId?: string;\n    trace?: BetterAgentErrorTraceFrame[];\n};\n\ntype WrapOptions = {\n    code?: BetterAgentErrorCode | undefined;\n    status?: number | undefined;\n    title?: string | undefined;\n    type?: string | undefined;\n    retryable?: boolean | undefined;\n    issues?: unknown[] | undefined;\n    context?: BetterAgentErrorContext | undefined;\n    traceId?: string | undefined;\n    cause?: unknown;\n    trace?: BetterAgentErrorTraceFrame[] | undefined;\n    // biome-ignore lint/complexity/noBannedTypes: Stack capture needs function constructor references.\n    stackFrom?: Function;\n};\n\n/** Options for {@link BetterAgentError}. */\nexport type BetterAgentErrorOptions = {\n    code: BetterAgentErrorCode;\n    status?: number | undefined;\n    title?: string | undefined;\n    type?: string | undefined;\n    retryable?: boolean | undefined;\n    issues?: unknown[] | undefined;\n    context?: BetterAgentErrorContext | undefined;\n    traceId?: string | undefined;\n    cause?: unknown;\n    trace?: BetterAgentErrorTraceFrame[] | undefined;\n    // biome-ignore lint/complexity/noBannedTypes: Stack capture needs function constructor references.\n    stackFrom?: Function;\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n    typeof value === \"object\" && value !== null;\n\nconst isProblemDetailsLike = (value: unknown): value is BetterAgentProblemDetails => {\n    if (!isRecord(value)) return false;\n    return (\n        typeof value.type === \"string\" &&\n        typeof value.title === \"string\" &&\n        typeof value.status === \"number\" &&\n        typeof value.detail === \"string\" &&\n        typeof value.code === \"string\"\n    );\n};\n\nconst getCodeMeta = (code: string): ErrorCodeMeta => {\n    const found = ERROR_CODE_META[code];\n    if (found) return found;\n    return {\n        status: 500,\n        title: \"Internal Server Error\",\n        retryable: false,\n        slug: code.toLowerCase().replace(/_/g, \"-\"),\n    };\n};\n\nconst getDocsTypeUrl = (code: string): string => {\n    const meta = getCodeMeta(code);\n    return `${ERROR_DOCS_BASE_URL}#${meta.slug}`;\n};\n\n/** Better Agent error type. */\nexport class BetterAgentError extends Error {\n    code: BetterAgentErrorCode;\n    status: number;\n    title: string;\n    type: string;\n    retryable: boolean;\n    declare issues?: unknown[];\n    declare context?: BetterAgentErrorContext;\n    declare traceId?: string;\n    trace: BetterAgentErrorTraceFrame[];\n\n    constructor(message: string, opts: BetterAgentErrorOptions) {\n        if (opts.cause !== undefined) {\n            super(message, { cause: opts.cause });\n        } else {\n            super(message);\n        }\n\n        Object.setPrototypeOf(this, new.target.prototype);\n        this.name = \"BetterAgentError\";\n\n        const meta = getCodeMeta(opts.code);\n        this.code = opts.code;\n        this.status = opts.status ?? meta.status;\n        this.title = opts.title ?? meta.title;\n        this.type = opts.type ?? getDocsTypeUrl(opts.code);\n        this.retryable = opts.retryable ?? meta.retryable;\n        if (opts.issues !== undefined) this.issues = opts.issues;\n        if (opts.context !== undefined) this.context = opts.context;\n        if (opts.traceId !== undefined) this.traceId = opts.traceId;\n        this.trace = opts.trace ?? [];\n\n        // captureStackTrace is available in V8/Node.js environments\n        const ctor = Error as unknown as {\n            captureStackTrace?: (target: object, ctor?: unknown) => void;\n        };\n        if (ctor.captureStackTrace !== undefined) {\n            ctor.captureStackTrace(this, opts.stackFrom ?? BetterAgentError);\n        }\n    }\n\n    /** Adds a trace frame. */\n    at(frame: BetterAgentErrorTraceFrame): this {\n        this.trace.push(frame);\n        return this;\n    }\n\n    /** Converts this error to problem details. */\n    toProblem(overrides: Partial<BetterAgentProblemDetails> = {}): BetterAgentProblemDetails {\n        const out: BetterAgentProblemDetails = {\n            type: overrides.type ?? this.type,\n            title: overrides.title ?? this.title,\n            status: overrides.status ?? this.status,\n            detail: overrides.detail ?? this.message,\n            code: String(overrides.code ?? this.code),\n        };\n\n        const retryable = overrides.retryable ?? this.retryable;\n        if (retryable !== undefined) out.retryable = retryable;\n\n        const issues = overrides.issues ?? this.issues;\n        if (issues !== undefined) out.issues = issues;\n\n        const traceId = overrides.traceId ?? this.traceId;\n        if (traceId !== undefined) out.traceId = traceId;\n\n        const context = {\n            ...(this.context ?? {}),\n            ...(isRecord(overrides.context) ? overrides.context : {}),\n        };\n        if (Object.keys(context).length > 0) out.context = context;\n\n        const trace = overrides.trace ?? this.trace;\n        if (trace.length > 0) out.trace = trace;\n\n        return out;\n    }\n\n    /** JSON form for `JSON.stringify`. */\n    toJSON() {\n        return this.toProblem();\n    }\n\n    /** Debug form with stack and cause. */\n    toDebugJSON() {\n        const debug = this.toProblem() as BetterAgentProblemDetails & {\n            stack?: string;\n            cause?: unknown;\n        };\n\n        if (this.stack !== undefined) debug.stack = this.stack;\n        if (this.cause !== undefined) debug.cause = this.cause;\n\n        return debug;\n    }\n\n    /** Creates an error from a code and message. */\n    static fromCode(\n        code: BetterAgentErrorCode,\n        message: string,\n        opts: Omit<WrapOptions, \"code\"> = {},\n    ): BetterAgentError {\n        return new BetterAgentError(message, {\n            code,\n            ...opts,\n            stackFrom: opts.stackFrom ?? BetterAgentError.fromCode,\n        });\n    }\n\n    /** Rehydrates an error from problem details. */\n    static fromProblem(\n        input: BetterAgentProblemDetails | Record<string, unknown>,\n        opts: Omit<WrapOptions, \"code\"> = {},\n    ): BetterAgentError {\n        if (!isProblemDetailsLike(input)) {\n            return BetterAgentError.wrap({\n                err: input,\n                message: \"Invalid problem details payload\",\n                opts: {\n                    ...opts,\n                    code: \"INTERNAL\",\n                },\n            });\n        }\n\n        return new BetterAgentError(input.detail, {\n            code: input.code,\n            status: input.status,\n            title: input.title,\n            type: input.type,\n            retryable: input.retryable,\n            issues: input.issues,\n            context: input.context,\n            traceId: input.traceId,\n            trace: input.trace,\n            ...opts,\n            stackFrom: opts.stackFrom ?? BetterAgentError.fromProblem,\n        });\n    }\n\n    /** Wraps unknown errors as {@link BetterAgentError}. */\n    static wrap(args: {\n        err: unknown;\n        message?: string;\n        opts?: WrapOptions;\n    }): BetterAgentError {\n        const code = args.opts?.code ?? \"INTERNAL\";\n\n        if (args.err instanceof BetterAgentError) {\n            return new BetterAgentError(\n                args.message ? `${args.message}: ${args.err.message}` : args.err.message,\n                {\n                    code,\n                    status: args.opts?.status ?? args.err.status,\n                    title: args.opts?.title ?? args.err.title,\n                    type: args.opts?.type ?? args.err.type,\n                    retryable: args.opts?.retryable ?? args.err.retryable,\n                    context: {\n                        ...(args.err.context ?? {}),\n                        ...(args.opts?.context ?? {}),\n                    },\n                    traceId: args.opts?.traceId ?? args.err.traceId,\n                    trace: args.opts?.trace\n                        ? [...args.err.trace, ...args.opts.trace]\n                        : args.err.trace,\n                    cause: args.opts?.cause ?? args.err,\n                    stackFrom: args.opts?.stackFrom ?? BetterAgentError.wrap,\n                },\n            );\n        }\n\n        if (isProblemDetailsLike(args.err)) {\n            return BetterAgentError.fromProblem(args.err, {\n                ...args.opts,\n                stackFrom: args.opts?.stackFrom ?? BetterAgentError.wrap,\n            });\n        }\n\n        if (args.err instanceof Error) {\n            return new BetterAgentError(args.message || args.err.message, {\n                ...args.opts,\n                code,\n                cause: args.opts?.cause ?? args.err,\n                stackFrom: args.opts?.stackFrom ?? BetterAgentError.wrap,\n            });\n        }\n\n        return new BetterAgentError(args.message || \"Unknown error\", {\n            ...args.opts,\n            code,\n            stackFrom: args.opts?.stackFrom ?? BetterAgentError.wrap,\n        });\n    }\n}\n"],"mappings":"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"}

package/dist/logger.d.mts

@@ -0,0 +1,8 @@
+//#region src/logger.d.ts
+type LogLevel = "debug" | "info" | "success" | "warn" | "error";
+type LogMethod = (message?: unknown, ...args: unknown[]) => void;
+type InternalLogger = { [K in LogLevel]: LogMethod };
+declare const logger: InternalLogger;
+//#endregion
+export { InternalLogger, LogLevel, LogMethod, logger };
+//# sourceMappingURL=logger.d.mts.map

package/dist/logger.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.mts","names":[],"sources":["../src/logger.ts"],"mappings":";KAAY,QAAA;AAAA,KAEA,SAAA,IAAa,OAAA,eAAsB,IAAA;AAAA,KAEnC,cAAA,WACF,QAAA,GAAW,SAAA;AAAA,cAyFR,MAAA,EAAQ,cAAA"}

package/dist/logger.mjs

@@ -0,0 +1,71 @@
+//#region src/logger.ts
+const levels = [
+	"debug",
+	"info",
+	"success",
+	"warn",
+	"error"
+];
+const colors = {
+	reset: "\x1B[0m",
+	dim: "\x1B[2m",
+	bright: "\x1B[1m",
+	blue: "\x1B[34m",
+	green: "\x1B[32m",
+	yellow: "\x1B[33m",
+	red: "\x1B[31m",
+	magenta: "\x1B[35m"
+};
+const levelColors = {
+	debug: colors.magenta,
+	info: colors.blue,
+	success: colors.green,
+	warn: colors.yellow,
+	error: colors.red
+};
+function shouldPublishLog(currentLogLevel, logLevel) {
+	const currentIndex = levels.indexOf(currentLogLevel);
+	return levels.indexOf(logLevel) >= currentIndex;
+}
+function canUseColors() {
+	if (typeof process === "undefined") return false;
+	if (process.env?.NO_COLOR) return false;
+	if (process.env?.FORCE_COLOR) return true;
+	return Boolean(process.stdout?.isTTY);
+}
+function serializeMessage(message) {
+	if (message instanceof Error) return message.stack || message.message;
+	if (typeof message === "string") return message;
+	try {
+		return JSON.stringify(message, null, 2);
+	} catch {
+		return String(message);
+	}
+}
+function formatMessage(level, message) {
+	const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+	const text = serializeMessage(message);
+	if (canUseColors()) {
+		const color = levelColors[level];
+		const levelUpper = level.toUpperCase();
+		return `${colors.dim}${timestamp}${colors.reset} ${color}${levelUpper}${colors.reset} ${colors.bright}[Better Agent]:${colors.reset} ${text}`;
+	}
+	return `${timestamp} ${level.toUpperCase()} [Better-Agent]: ${text}`;
+}
+var LoggerImpl = class {
+	logLevel = "info";
+	log(level, message, ...args) {
+		if (!shouldPublishLog(this.logLevel, level)) return;
+		console.log(formatMessage(level, message), ...args);
+	}
+	debug = (message, ...args) => this.log("debug", message, ...args);
+	info = (message, ...args) => this.log("info", message, ...args);
+	success = (message, ...args) => this.log("success", message, ...args);
+	warn = (message, ...args) => this.log("warn", message, ...args);
+	error = (message, ...args) => this.log("error", message, ...args);
+};
+const logger = new LoggerImpl();
+
+//#endregion
+export { logger };
+//# sourceMappingURL=logger.mjs.map

package/dist/logger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.mjs","names":[],"sources":["../src/logger.ts"],"sourcesContent":["export type LogLevel = \"debug\" | \"info\" | \"success\" | \"warn\" | \"error\";\n\nexport type LogMethod = (message?: unknown, ...args: unknown[]) => void;\n\nexport type InternalLogger = {\n    [K in LogLevel]: LogMethod;\n};\n\ndeclare const process:\n    | {\n          env?: Record<string, string | undefined>;\n          stdout?: { isTTY?: boolean };\n      }\n    | undefined;\n\nconst levels: readonly LogLevel[] = [\"debug\", \"info\", \"success\", \"warn\", \"error\"];\n\nconst colors = {\n    reset: \"\\x1b[0m\",\n    dim: \"\\x1b[2m\",\n    bright: \"\\x1b[1m\",\n    blue: \"\\x1b[34m\",\n    green: \"\\x1b[32m\",\n    yellow: \"\\x1b[33m\",\n    red: \"\\x1b[31m\",\n    magenta: \"\\x1b[35m\",\n};\n\nconst levelColors: Record<LogLevel, string> = {\n    debug: colors.magenta,\n    info: colors.blue,\n    success: colors.green,\n    warn: colors.yellow,\n    error: colors.red,\n};\n\nfunction shouldPublishLog(currentLogLevel: LogLevel, logLevel: LogLevel): boolean {\n    const currentIndex = levels.indexOf(currentLogLevel);\n    const incomingIndex = levels.indexOf(logLevel);\n    return incomingIndex >= currentIndex;\n}\n\nfunction canUseColors(): boolean {\n    if (typeof process === \"undefined\") return false;\n    if (process.env?.NO_COLOR) return false;\n    if (process.env?.FORCE_COLOR) return true;\n    return Boolean(process.stdout?.isTTY);\n}\n\nfunction serializeMessage(message: unknown): string {\n    if (message instanceof Error) {\n        return message.stack || message.message;\n    }\n    if (typeof message === \"string\") {\n        return message;\n    }\n    try {\n        return JSON.stringify(message, null, 2);\n    } catch {\n        return String(message);\n    }\n}\n\nfunction formatMessage(level: LogLevel, message: unknown): string {\n    const timestamp = new Date().toISOString();\n    const text = serializeMessage(message);\n\n    if (canUseColors()) {\n        const color = levelColors[level];\n        const levelUpper = level.toUpperCase();\n        return `${colors.dim}${timestamp}${colors.reset} ${color}${levelUpper}${colors.reset} ${colors.bright}[Better Agent]:${colors.reset} ${text}`;\n    }\n\n    return `${timestamp} ${level.toUpperCase()} [Better-Agent]: ${text}`;\n}\n\nclass LoggerImpl implements InternalLogger {\n    private readonly logLevel: LogLevel = \"info\";\n\n    private log(level: LogLevel, message?: unknown, ...args: unknown[]) {\n        if (!shouldPublishLog(this.logLevel, level)) {\n            return;\n        }\n\n        console.log(formatMessage(level, message), ...args);\n    }\n\n    debug: LogMethod = (message, ...args) => this.log(\"debug\", message, ...args);\n    info: LogMethod = (message, ...args) => this.log(\"info\", message, ...args);\n    success: LogMethod = (message, ...args) => this.log(\"success\", message, ...args);\n    warn: LogMethod = (message, ...args) => this.log(\"warn\", message, ...args);\n    error: LogMethod = (message, ...args) => this.log(\"error\", message, ...args);\n}\n\nexport const logger: InternalLogger = new LoggerImpl();\n"],"mappings":";AAeA,MAAM,SAA8B;CAAC;CAAS;CAAQ;CAAW;CAAQ;CAAQ;AAEjF,MAAM,SAAS;CACX,OAAO;CACP,KAAK;CACL,QAAQ;CACR,MAAM;CACN,OAAO;CACP,QAAQ;CACR,KAAK;CACL,SAAS;CACZ;AAED,MAAM,cAAwC;CAC1C,OAAO,OAAO;CACd,MAAM,OAAO;CACb,SAAS,OAAO;CAChB,MAAM,OAAO;CACb,OAAO,OAAO;CACjB;AAED,SAAS,iBAAiB,iBAA2B,UAA6B;CAC9E,MAAM,eAAe,OAAO,QAAQ,gBAAgB;AAEpD,QADsB,OAAO,QAAQ,SAAS,IACtB;;AAG5B,SAAS,eAAwB;AAC7B,KAAI,OAAO,YAAY,YAAa,QAAO;AAC3C,KAAI,QAAQ,KAAK,SAAU,QAAO;AAClC,KAAI,QAAQ,KAAK,YAAa,QAAO;AACrC,QAAO,QAAQ,QAAQ,QAAQ,MAAM;;AAGzC,SAAS,iBAAiB,SAA0B;AAChD,KAAI,mBAAmB,MACnB,QAAO,QAAQ,SAAS,QAAQ;AAEpC,KAAI,OAAO,YAAY,SACnB,QAAO;AAEX,KAAI;AACA,SAAO,KAAK,UAAU,SAAS,MAAM,EAAE;SACnC;AACJ,SAAO,OAAO,QAAQ;;;AAI9B,SAAS,cAAc,OAAiB,SAA0B;CAC9D,MAAM,6BAAY,IAAI,MAAM,EAAC,aAAa;CAC1C,MAAM,OAAO,iBAAiB,QAAQ;AAEtC,KAAI,cAAc,EAAE;EAChB,MAAM,QAAQ,YAAY;EAC1B,MAAM,aAAa,MAAM,aAAa;AACtC,SAAO,GAAG,OAAO,MAAM,YAAY,OAAO,MAAM,GAAG,QAAQ,aAAa,OAAO,MAAM,GAAG,OAAO,OAAO,iBAAiB,OAAO,MAAM,GAAG;;AAG3I,QAAO,GAAG,UAAU,GAAG,MAAM,aAAa,CAAC,mBAAmB;;AAGlE,IAAM,aAAN,MAA2C;CACvC,AAAiB,WAAqB;CAEtC,AAAQ,IAAI,OAAiB,SAAmB,GAAG,MAAiB;AAChE,MAAI,CAAC,iBAAiB,KAAK,UAAU,MAAM,CACvC;AAGJ,UAAQ,IAAI,cAAc,OAAO,QAAQ,EAAE,GAAG,KAAK;;CAGvD,SAAoB,SAAS,GAAG,SAAS,KAAK,IAAI,SAAS,SAAS,GAAG,KAAK;CAC5E,QAAmB,SAAS,GAAG,SAAS,KAAK,IAAI,QAAQ,SAAS,GAAG,KAAK;CAC1E,WAAsB,SAAS,GAAG,SAAS,KAAK,IAAI,WAAW,SAAS,GAAG,KAAK;CAChF,QAAmB,SAAS,GAAG,SAAS,KAAK,IAAI,QAAQ,SAAS,GAAG,KAAK;CAC1E,SAAoB,SAAS,GAAG,SAAS,KAAK,IAAI,SAAS,SAAS,GAAG,KAAK;;AAGhF,MAAa,SAAyB,IAAI,YAAY"}

package/dist/neverthrow.d.mts

@@ -0,0 +1,8 @@
+export * from "neverthrow";
+
+//#region src/neverthrow.d.ts
+
+import * as import_neverthrow from "neverthrow";
+//#endregion
+export { import_neverthrow as t };
+//# sourceMappingURL=neverthrow.d.mts.map

package/dist/neverthrow.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"neverthrow.d.mts","names":[],"sources":["../src/neverthrow.ts"],"mappings":""}

package/dist/neverthrow.mjs

@@ -0,0 +1,12 @@
+import { n as __reExport, t as __exportAll } from "./chunk-CtajNgzt.mjs";
+
+export * from "neverthrow"
+
+//#region src/neverthrow.ts
+var neverthrow_exports = /* @__PURE__ */ __exportAll({});
+import * as import_neverthrow from "neverthrow";
+__reExport(neverthrow_exports, import_neverthrow);
+
+//#endregion
+export { neverthrow_exports as t };
+//# sourceMappingURL=neverthrow.mjs.map

package/dist/neverthrow.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"neverthrow.mjs","names":[],"sources":["../src/neverthrow.ts"],"sourcesContent":["export * from \"neverthrow\";\n"],"mappings":""}

package/dist/utils.d.mts

@@ -0,0 +1,8 @@
+import { t as neverthrow_d_exports } from "./neverthrow.mjs";
+
+//#region src/utils.d.ts
+declare const safeJsonParse: (text: string) => neverthrow_d_exports.Result<unknown, Error>;
+declare const isPlainRecord: (value: unknown) => value is Record<string, unknown>;
+//#endregion
+export { isPlainRecord, safeJsonParse };
+//# sourceMappingURL=utils.d.mts.map

package/dist/utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.mts","names":[],"sources":["../src/utils.ts"],"mappings":";;;cAEa,aAAA,GAAa,IAAA,aAAmB,oBAAA,CAAA,MAAA,UAAgB,KAAA;AAAA,cAQhD,aAAA,GAAa,KAAA,cAAqB,KAAA,IAAS,MAAA"}

package/dist/utils.mjs

@@ -0,0 +1,17 @@
+import { t as neverthrow_exports } from "./neverthrow.mjs";
+
+//#region src/utils.ts
+const safeJsonParse = (text) => {
+	try {
+		return (0, neverthrow_exports.ok)(JSON.parse(text));
+	} catch (error) {
+		return (0, neverthrow_exports.err)(error instanceof Error ? error : new Error(String(error)));
+	}
+};
+const isPlainRecord = (value) => {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+};
+
+//#endregion
+export { isPlainRecord, safeJsonParse };
+//# sourceMappingURL=utils.mjs.map

package/dist/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.mjs","names":[],"sources":["../src/utils.ts"],"sourcesContent":["import { type Result, err, ok } from \"./neverthrow\";\n\nexport const safeJsonParse = (text: string): Result<unknown, Error> => {\n    try {\n        return ok(JSON.parse(text));\n    } catch (error) {\n        return err(error instanceof Error ? error : new Error(String(error)));\n    }\n};\n\nexport const isPlainRecord = (value: unknown): value is Record<string, unknown> => {\n    return typeof value === \"object\" && value !== null && !Array.isArray(value);\n};\n"],"mappings":";;;AAEA,MAAa,iBAAiB,SAAyC;AACnE,KAAI;AACA,oCAAU,KAAK,MAAM,KAAK,CAAC;UACtB,OAAO;AACZ,qCAAW,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC,CAAC;;;AAI7E,MAAa,iBAAiB,UAAqD;AAC/E,QAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,MAAM"}

package/package.json

@@ -0,0 +1,65 @@
+{
+    "name": "@better-agent/shared",
+    "version": "0.1.0-canary.0",
+    "description": "Shared utilities for Better Agent",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/better-agent/better-agent.git",
+        "directory": "packages/shared"
+    },
+    "homepage": "https://github.com/better-agent/better-agent/tree/main/packages/shared",
+    "bugs": {
+        "url": "https://github.com/better-agent/better-agent/issues"
+    },
+    "type": "module",
+    "types": "./dist/errors.d.mts",
+    "sideEffects": false,
+    "exports": {
+        "./neverthrow": {
+            "types": "./dist/neverthrow.d.mts",
+            "import": "./dist/neverthrow.mjs"
+        },
+        "./errors": {
+            "types": "./dist/errors.d.mts",
+            "import": "./dist/errors.mjs"
+        },
+        "./logger": {
+            "types": "./dist/logger.d.mts",
+            "import": "./dist/logger.mjs"
+        },
+        "./utils": {
+            "types": "./dist/utils.d.mts",
+            "import": "./dist/utils.mjs"
+        }
+    },
+    "typesVersions": {
+        "*": {
+            "neverthrow": ["dist/neverthrow.d.mts"],
+            "errors": ["dist/errors.d.mts"],
+            "logger": ["dist/logger.d.mts"],
+            "utils": ["dist/utils.d.mts"]
+        }
+    },
+    "scripts": {
+        "build": "bunx tsdown",
+        "dev": "bunx tsdown --watch --no-clean",
+        "lint:package": "bunx publint run --strict",
+        "lint:types": "npm_config_cache=../../.npm-cache bunx attw --profile esm-only --pack .",
+        "lint": "bunx biome check .",
+        "typecheck": "bunx tsc -p tsconfig.json --noEmit",
+        "format": "bunx biome format --write .",
+        "clean": "bunx rimraf dist"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "files": ["dist"],
+    "dependencies": {
+        "neverthrow": "^8.2.0"
+    },
+    "devDependencies": {
+        "@types/bun": "^1.2.18",
+        "@types/node": "^22.15.30"
+    }
+}