@crewhaus/errors 0.1.1 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewhaus/errors",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "type": "module",
   "description": "Typed error hierarchy shared across factory layers",
   "main": "src/index.ts",
@@ -14,8 +14,8 @@
   "license": "Apache-2.0",
   "author": {
     "name": "Max Meier",
-    "email": "max@studiomax.io",
-    "url": "https://studiomax.io"
+    "email": "max@crewhaus.ai",
+    "url": "https://crewhaus.ai"
   },
   "repository": {
     "type": "git",
@@ -27,12 +27,7 @@
     "url": "https://github.com/crewhaus/factory/issues"
   },
   "publishConfig": {
-    "access": "restricted"
+    "access": "public"
   },
-  "files": [
-    "src",
-    "README.md",
-    "LICENSE",
-    "NOTICE"
-  ]
+  "files": ["src", "README.md", "LICENSE", "NOTICE"]
 }

package/src/index.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Typed error hierarchy for factory.
+ * Catalog F-foundations (`error-types`) — every later layer imports this
+ * for structured error reporting instead of throwing raw `Error`s.
+ *
+ * Each error carries a stable `code` for programmatic dispatch and serializes
+ * its full cause chain via `toJSON()` for the logging layer.
+ */
+export type ErrorCode = "spec_parse" | "compiler" | "runtime" | "config" | "tool" | "mcp" | "adapter" | "channel";
+export type SerializedError = {
+    name: string;
+    code: ErrorCode;
+    message: string;
+    cause?: SerializedError | {
+        name?: string;
+        message: string;
+    };
+};
+export declare class CrewhausError extends Error {
+    readonly name: string;
+    readonly code: ErrorCode;
+    constructor(code: ErrorCode, message: string, cause?: unknown);
+    toJSON(): SerializedError;
+}
+export declare class SpecParseError extends CrewhausError {
+    readonly name = "SpecParseError";
+    constructor(message: string, cause?: unknown);
+}
+export declare class CompilerError extends CrewhausError {
+    readonly name = "CompilerError";
+    constructor(message: string, cause?: unknown);
+}
+export declare class RuntimeError extends CrewhausError {
+    readonly name = "RuntimeError";
+    constructor(message: string, cause?: unknown);
+}
+export declare class ConfigError extends CrewhausError {
+    readonly name = "ConfigError";
+    constructor(message: string, cause?: unknown);
+}
+export declare class McpError extends CrewhausError {
+    readonly name: string;
+    constructor(message: string, cause?: unknown);
+}
+export declare class McpConnectionError extends McpError {
+    readonly name = "McpConnectionError";
+    constructor(message: string, cause?: unknown);
+}
+export declare class McpProtocolError extends McpError {
+    readonly name = "McpProtocolError";
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * Section 17 — base for all model-provider adapter failures (auth, request
+ * marshalling, stream parsing, network). Carries `providerId` so callers can
+ * branch on which adapter raised; `cause` keeps the underlying SDK error
+ * accessible via `toJSON()` for the trace/log layer.
+ */
+export declare class AdapterError extends CrewhausError {
+    readonly name: string;
+    readonly providerId: string;
+    constructor(providerId: string, message: string, cause?: unknown);
+}
+/**
+ * Section 17 — missing or invalid credentials for a model provider. Surfaces
+ * with a setup hint pointing at the relevant env var.
+ */
+export declare class ProviderAuthError extends AdapterError {
+    readonly name = "ProviderAuthError";
+    constructor(providerId: string, message: string, cause?: unknown);
+}
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,SAAS,GACjB,YAAY,GACZ,UAAU,GACV,SAAS,GACT,QAAQ,GACR,MAAM,GACN,KAAK,GACL,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,eAAe,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9D,CAAC;AAEF,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAkB,IAAI,EAAE,MAAM,CAAmB;IACjD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;gBAEb,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;IAK7D,MAAM,IAAI,eAAe;CAQ1B;AASD,qBAAa,cAAe,SAAQ,aAAa;IAC/C,SAAkB,IAAI,oBAAoB;gBAC9B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAG7C;AAED,qBAAa,aAAc,SAAQ,aAAa;IAC9C,SAAkB,IAAI,mBAAmB;gBAC7B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAG7C;AAED,qBAAa,YAAa,SAAQ,aAAa;IAC7C,SAAkB,IAAI,kBAAkB;gBAC5B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAG7C;AAED,qBAAa,WAAY,SAAQ,aAAa;IAC5C,SAAkB,IAAI,iBAAiB;gBAC3B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAG7C;AAED,qBAAa,QAAS,SAAQ,aAAa;IACzC,SAAkB,IAAI,EAAE,MAAM,CAAc;gBAChC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAG7C;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,SAAkB,IAAI,wBAAwB;gBAElC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAG7C;AAED,qBAAa,gBAAiB,SAAQ,QAAQ;IAC5C,SAAkB,IAAI,sBAAsB;gBAEhC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAG7C;AAED;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,aAAa;IAC7C,SAAkB,IAAI,EAAE,MAAM,CAAkB;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAChB,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAIjE;AAED;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,SAAkB,IAAI,uBAAuB;gBAEjC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAGjE"}

package/src/index.js

@@ -0,0 +1,103 @@
+/**
+ * Typed error hierarchy for factory.
+ * Catalog F-foundations (`error-types`) — every later layer imports this
+ * for structured error reporting instead of throwing raw `Error`s.
+ *
+ * Each error carries a stable `code` for programmatic dispatch and serializes
+ * its full cause chain via `toJSON()` for the logging layer.
+ */
+export class CrewhausError extends Error {
+    name = "CrewhausError";
+    code;
+    constructor(code, message, cause) {
+        super(message, cause === undefined ? undefined : { cause });
+        this.code = code;
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            cause: serializeCause(this.cause),
+        };
+    }
+}
+function serializeCause(cause) {
+    if (cause === undefined)
+        return undefined;
+    if (cause instanceof CrewhausError)
+        return cause.toJSON();
+    if (cause instanceof Error)
+        return { name: cause.name, message: cause.message };
+    return { message: String(cause) };
+}
+export class SpecParseError extends CrewhausError {
+    name = "SpecParseError";
+    constructor(message, cause) {
+        super("spec_parse", message, cause);
+    }
+}
+export class CompilerError extends CrewhausError {
+    name = "CompilerError";
+    constructor(message, cause) {
+        super("compiler", message, cause);
+    }
+}
+export class RuntimeError extends CrewhausError {
+    name = "RuntimeError";
+    constructor(message, cause) {
+        super("runtime", message, cause);
+    }
+}
+export class ConfigError extends CrewhausError {
+    name = "ConfigError";
+    constructor(message, cause) {
+        super("config", message, cause);
+    }
+}
+export class McpError extends CrewhausError {
+    name = "McpError";
+    constructor(message, cause) {
+        super("mcp", message, cause);
+    }
+}
+export class McpConnectionError extends McpError {
+    name = "McpConnectionError";
+    // biome-ignore lint/complexity/noUselessConstructor: explicit constructor so Bun --coverage counts it as a covered function (field-initializer-only classes can't hit 100% function coverage otherwise)
+    constructor(message, cause) {
+        super(message, cause);
+    }
+}
+export class McpProtocolError extends McpError {
+    name = "McpProtocolError";
+    // biome-ignore lint/complexity/noUselessConstructor: explicit constructor so Bun --coverage counts it as a covered function (field-initializer-only classes can't hit 100% function coverage otherwise)
+    constructor(message, cause) {
+        super(message, cause);
+    }
+}
+/**
+ * Section 17 — base for all model-provider adapter failures (auth, request
+ * marshalling, stream parsing, network). Carries `providerId` so callers can
+ * branch on which adapter raised; `cause` keeps the underlying SDK error
+ * accessible via `toJSON()` for the trace/log layer.
+ */
+export class AdapterError extends CrewhausError {
+    name = "AdapterError";
+    providerId;
+    constructor(providerId, message, cause) {
+        super("adapter", message, cause);
+        this.providerId = providerId;
+    }
+}
+/**
+ * Section 17 — missing or invalid credentials for a model provider. Surfaces
+ * with a setup hint pointing at the relevant env var.
+ */
+export class ProviderAuthError extends AdapterError {
+    name = "ProviderAuthError";
+    // biome-ignore lint/complexity/noUselessConstructor: explicit constructor so Bun --coverage counts it as a covered function (field-initializer-only classes can't hit 100% function coverage otherwise)
+    constructor(providerId, message, cause) {
+        super(providerId, message, cause);
+    }
+}
+//# sourceMappingURL=index.js.map

package/src/index.js.map

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

package/src/index.test.ts

@@ -1,11 +1,13 @@
 import { describe, expect, test } from "bun:test";
 import {
+  AdapterError,
   CompilerError,
   ConfigError,
   CrewhausError,
   McpConnectionError,
   McpError,
   McpProtocolError,
+  ProviderAuthError,
   RuntimeError,
   SpecParseError,
 } from "./index";
@@ -100,3 +102,51 @@ describe("subclasses", () => {
     });
   });
 });
+
+describe("AdapterError", () => {
+  test("tags itself with the adapter code and captures providerId", () => {
+    const err = new AdapterError("openai", "request failed");
+    expect(err).toBeInstanceOf(CrewhausError);
+    expect(err.code).toBe("adapter");
+    expect(err.providerId).toBe("openai");
+    expect(err.message).toBe("request failed");
+    expect(err.name).toBe("AdapterError");
+  });
+
+  test("preserves the underlying SDK error via cause", () => {
+    const sdkErr = new Error("429 rate limited");
+    const err = new AdapterError("anthropic", "upstream error", sdkErr);
+    expect(err.cause).toBe(sdkErr);
+  });
+
+  test("toJSON serializes the cause chain (providerId is not part of the wire shape)", () => {
+    const err = new AdapterError("anthropic", "stream parse failed", new Error("EOF"));
+    expect(err.toJSON()).toEqual({
+      name: "AdapterError",
+      code: "adapter",
+      message: "stream parse failed",
+      cause: { name: "Error", message: "EOF" },
+    });
+  });
+});
+
+describe("ProviderAuthError", () => {
+  test("is an AdapterError with the adapter code and a stable name", () => {
+    const err = new ProviderAuthError("openai", "missing OPENAI_API_KEY");
+    expect(err).toBeInstanceOf(AdapterError);
+    expect(err).toBeInstanceOf(CrewhausError);
+    expect(err.code).toBe("adapter");
+    expect(err.providerId).toBe("openai");
+    expect(err.name).toBe("ProviderAuthError");
+  });
+
+  test("toJSON reports the ProviderAuthError name", () => {
+    const err = new ProviderAuthError("anthropic", "invalid credentials");
+    expect(err.toJSON()).toEqual({
+      name: "ProviderAuthError",
+      code: "adapter",
+      message: "invalid credentials",
+      cause: undefined,
+    });
+  });
+});

package/src/index.ts

@@ -87,10 +87,18 @@ export class McpError extends CrewhausError {
 
 export class McpConnectionError extends McpError {
   override readonly name = "McpConnectionError";
+  // biome-ignore lint/complexity/noUselessConstructor: explicit constructor so Bun --coverage counts it as a covered function (field-initializer-only classes can't hit 100% function coverage otherwise)
+  constructor(message: string, cause?: unknown) {
+    super(message, cause);
+  }
 }
 
 export class McpProtocolError extends McpError {
   override readonly name = "McpProtocolError";
+  // biome-ignore lint/complexity/noUselessConstructor: explicit constructor so Bun --coverage counts it as a covered function (field-initializer-only classes can't hit 100% function coverage otherwise)
+  constructor(message: string, cause?: unknown) {
+    super(message, cause);
+  }
 }
 
 /**
@@ -114,4 +122,8 @@ export class AdapterError extends CrewhausError {
  */
 export class ProviderAuthError extends AdapterError {
   override readonly name = "ProviderAuthError";
+  // biome-ignore lint/complexity/noUselessConstructor: explicit constructor so Bun --coverage counts it as a covered function (field-initializer-only classes can't hit 100% function coverage otherwise)
+  constructor(providerId: string, message: string, cause?: unknown) {
+    super(providerId, message, cause);
+  }
 }