ultracode-shared 1.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 UltraCode Team / SIMO GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,30 @@
+# ultracode-shared
+
+> Shared types, contracts, errors and utilities for UltraCode AI.
+
+Part of the [UltraCode AI](https://github.com/AndreasSchwan-SIMO/UltraCode) monorepo.
+This is an internal foundation package consumed by
+[`ultracode-core`](https://www.npmjs.com/package/ultracode-core) and the
+[`ultracode`](https://www.npmjs.com/package/ultracode) CLI.
+
+## Installation
+
+```bash
+npm install ultracode-shared
+```
+
+Requires Node.js `>=22.13.0`. ESM only.
+
+## Usage
+
+```ts
+import { /* types, contracts, error classes, utilities */ } from "ultracode-shared";
+```
+
+Provides the cross-package type definitions, interface contracts, the typed error
+model (e.g. `VersioningError`, `ProviderError`, `SessionError`, `ToolError`) and
+small shared utilities used throughout UltraCode AI.
+
+## License
+
+[MIT](./LICENSE) © UltraCode AI Team / SIMO GmbH

package/dist/constants.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Project-wide constants shared across UltraCode packages.
+ */
+/** Current package/protocol version. */
+export declare const VERSION: "0.1.0";
+/**
+ * Candidate project-level config file names, in resolution order
+ * (first match wins). Paths are relative to the project root.
+ */
+export declare const CONFIG_FILE_NAMES: readonly [".ultracode/config.toml", ".vibe/config.toml", ".ultracode.toml"];
+/** User-level config directory (tilde-prefixed; expanded by the loader). */
+export declare const USER_CONFIG_DIR: "~/.ultracode";
+/** User-level config file path. */
+export declare const USER_CONFIG_FILE: "~/.ultracode/config.toml";
+/** User-level `.env` file path holding API keys. */
+export declare const USER_ENV_FILE: "~/.ultracode/.env";
+/** Prefix for UltraCode-specific environment variables (e.g. `ULTRACODE_DEBUG`). */
+export declare const ENV_PREFIX: "ULTRACODE_";
+/** Default directory for persisted sessions. */
+export declare const DEFAULT_SESSION_DIR: "~/.ultracode/sessions";
+/** Directory holding user-authored system prompts. */
+export declare const PROMPTS_DIR: "~/.ultracode/prompts";
+/** Hard cap on a single tool's output, in characters, before truncation. */
+export declare const MAX_TOOL_OUTPUT_CHARS: 100000;
+/** Default per-request provider timeout, in milliseconds. */
+export declare const DEFAULT_PROVIDER_TIMEOUT_MS: 60000;
+/** Default maximum provider retry attempts. */
+export declare const DEFAULT_MAX_RETRIES: 3;
+/** Default base retry delay, in milliseconds. */
+export declare const DEFAULT_RETRY_DELAY_MS: 1000;
+/** Default changelog file name. */
+export declare const DEFAULT_CHANGELOG_FILE: "CHANGELOG.md";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wCAAwC;AACxC,eAAO,MAAM,OAAO,EAAG,OAAgB,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,iBAAiB,6EAIpB,CAAC;AAEX,4EAA4E;AAC5E,eAAO,MAAM,eAAe,EAAG,cAAuB,CAAC;AAEvD,mCAAmC;AACnC,eAAO,MAAM,gBAAgB,EAAG,0BAAmC,CAAC;AAEpE,oDAAoD;AACpD,eAAO,MAAM,aAAa,EAAG,mBAA4B,CAAC;AAE1D,oFAAoF;AACpF,eAAO,MAAM,UAAU,EAAG,YAAqB,CAAC;AAEhD,gDAAgD;AAChD,eAAO,MAAM,mBAAmB,EAAG,uBAAgC,CAAC;AAEpE,sDAAsD;AACtD,eAAO,MAAM,WAAW,EAAG,sBAA+B,CAAC;AAE3D,4EAA4E;AAC5E,eAAO,MAAM,qBAAqB,EAAG,MAAgB,CAAC;AAEtD,6DAA6D;AAC7D,eAAO,MAAM,2BAA2B,EAAG,KAAe,CAAC;AAE3D,+CAA+C;AAC/C,eAAO,MAAM,mBAAmB,EAAG,CAAU,CAAC;AAE9C,iDAAiD;AACjD,eAAO,MAAM,sBAAsB,EAAG,IAAc,CAAC;AAErD,mCAAmC;AACnC,eAAO,MAAM,sBAAsB,EAAG,cAAuB,CAAC"}

package/dist/constants.js

@@ -0,0 +1,37 @@
+/**
+ * Project-wide constants shared across UltraCode packages.
+ */
+/** Current package/protocol version. */
+export const VERSION = "0.1.0";
+/**
+ * Candidate project-level config file names, in resolution order
+ * (first match wins). Paths are relative to the project root.
+ */
+export const CONFIG_FILE_NAMES = [
+    ".ultracode/config.toml",
+    ".vibe/config.toml",
+    ".ultracode.toml",
+];
+/** User-level config directory (tilde-prefixed; expanded by the loader). */
+export const USER_CONFIG_DIR = "~/.ultracode";
+/** User-level config file path. */
+export const USER_CONFIG_FILE = "~/.ultracode/config.toml";
+/** User-level `.env` file path holding API keys. */
+export const USER_ENV_FILE = "~/.ultracode/.env";
+/** Prefix for UltraCode-specific environment variables (e.g. `ULTRACODE_DEBUG`). */
+export const ENV_PREFIX = "ULTRACODE_";
+/** Default directory for persisted sessions. */
+export const DEFAULT_SESSION_DIR = "~/.ultracode/sessions";
+/** Directory holding user-authored system prompts. */
+export const PROMPTS_DIR = "~/.ultracode/prompts";
+/** Hard cap on a single tool's output, in characters, before truncation. */
+export const MAX_TOOL_OUTPUT_CHARS = 100_000;
+/** Default per-request provider timeout, in milliseconds. */
+export const DEFAULT_PROVIDER_TIMEOUT_MS = 60_000;
+/** Default maximum provider retry attempts. */
+export const DEFAULT_MAX_RETRIES = 3;
+/** Default base retry delay, in milliseconds. */
+export const DEFAULT_RETRY_DELAY_MS = 1_000;
+/** Default changelog file name. */
+export const DEFAULT_CHANGELOG_FILE = "CHANGELOG.md";
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wCAAwC;AACxC,MAAM,CAAC,MAAM,OAAO,GAAG,OAAgB,CAAC;AAExC;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,wBAAwB;IACxB,mBAAmB;IACnB,iBAAiB;CACT,CAAC;AAEX,4EAA4E;AAC5E,MAAM,CAAC,MAAM,eAAe,GAAG,cAAuB,CAAC;AAEvD,mCAAmC;AACnC,MAAM,CAAC,MAAM,gBAAgB,GAAG,0BAAmC,CAAC;AAEpE,oDAAoD;AACpD,MAAM,CAAC,MAAM,aAAa,GAAG,mBAA4B,CAAC;AAE1D,oFAAoF;AACpF,MAAM,CAAC,MAAM,UAAU,GAAG,YAAqB,CAAC;AAEhD,gDAAgD;AAChD,MAAM,CAAC,MAAM,mBAAmB,GAAG,uBAAgC,CAAC;AAEpE,sDAAsD;AACtD,MAAM,CAAC,MAAM,WAAW,GAAG,sBAA+B,CAAC;AAE3D,4EAA4E;AAC5E,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAgB,CAAC;AAEtD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,2BAA2B,GAAG,MAAe,CAAC;AAE3D,+CAA+C;AAC/C,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAU,CAAC;AAE9C,iDAAiD;AACjD,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAc,CAAC;AAErD,mCAAmC;AACnC,MAAM,CAAC,MAAM,sBAAsB,GAAG,cAAuB,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Error hierarchy for UltraCode.
+ *
+ * All runtime errors thrown across UltraCode packages derive from
+ * {@link UltraCodeError}. Each error carries a stable, machine-readable
+ * `code`, an optional underlying `cause`, and arbitrary structured
+ * `details`. Errors are `instanceof`-safe across transpilation targets
+ * (via `Object.setPrototypeOf`) and serialise cleanly via `toJSON()`.
+ */
+/** Structured, JSON-safe representation of an {@link UltraCodeError}. */
+export interface SerializedError {
+    /** Class name of the error (e.g. `"ConfigError"`). */
+    name: string;
+    /** Human-readable message. */
+    message: string;
+    /** Stable machine-readable error code. */
+    code: string;
+    /** Optional stack trace, when available. */
+    stack?: string;
+    /** Structured, JSON-safe detail payload. */
+    details?: Record<string, unknown>;
+    /** Serialised underlying cause, if any. */
+    cause?: unknown;
+}
+/** Options accepted by every {@link UltraCodeError} subclass. */
+export interface UltraCodeErrorOptions {
+    /** Underlying error or value that triggered this error. */
+    cause?: unknown;
+    /** Structured, JSON-safe detail payload. */
+    details?: Record<string, unknown>;
+}
+/**
+ * Abstract base class for all UltraCode errors.
+ *
+ * Subclasses MUST provide a stable {@link UltraCodeError.code}. The base
+ * class normalises `name`, fixes the prototype chain for reliable
+ * `instanceof` checks, and captures a stack trace where supported.
+ */
+export declare abstract class UltraCodeError extends Error {
+    /** Stable, machine-readable error code (e.g. `"CONFIG_ERROR"`). */
+    readonly code: string;
+    /** Structured, JSON-safe detail payload. */
+    readonly details?: Record<string, unknown>;
+    protected constructor(code: string, message: string, options?: UltraCodeErrorOptions);
+    /** JSON-safe representation, suitable for transport and event buses. */
+    toJSON(): SerializedError;
+}
+/** Configuration loading, parsing or validation failed. */
+export declare class ConfigError extends UltraCodeError {
+    constructor(message: string, options?: UltraCodeErrorOptions);
+}
+/** Options specific to {@link ProviderError}. */
+export interface ProviderErrorOptions extends UltraCodeErrorOptions {
+    /** Provider name that produced the error (e.g. `"mistral"`). */
+    provider: string;
+    /** HTTP status code, when the error originated from an HTTP response. */
+    statusCode?: number;
+    /** Whether the operation may succeed if retried. Defaults to `false`. */
+    retryable?: boolean;
+}
+/** An LLM provider request failed. */
+export declare class ProviderError extends UltraCodeError {
+    /** Provider name that produced the error. */
+    readonly provider: string;
+    /** HTTP status code, when applicable. */
+    readonly statusCode?: number;
+    /** Whether the operation may succeed if retried. */
+    readonly retryable: boolean;
+    constructor(message: string, options: ProviderErrorOptions);
+    toJSON(): SerializedError;
+}
+/** Options specific to {@link ToolError} and its subclasses. */
+export interface ToolErrorOptions extends UltraCodeErrorOptions {
+    /** Name of the tool that failed. */
+    toolName: string;
+}
+/** A tool encountered an error during execution. */
+export declare class ToolError extends UltraCodeError {
+    /** Name of the tool that failed. */
+    readonly toolName: string;
+    constructor(message: string, options: ToolErrorOptions);
+    constructor(code: string, message: string, options: ToolErrorOptions);
+    toJSON(): SerializedError;
+}
+/** A tool was invoked but the user/permission system denied it. */
+export declare class ToolPermissionDeniedError extends ToolError {
+    constructor(message: string, options: ToolErrorOptions);
+}
+/** A tool exceeded its configured execution timeout. */
+export declare class ToolTimeoutError extends ToolError {
+    constructor(message: string, options: ToolErrorOptions);
+}
+/** A tool was requested that is not registered. */
+export declare class ToolNotFoundError extends ToolError {
+    constructor(message: string, options: ToolErrorOptions);
+}
+/** An agent failed during its run lifecycle. */
+export declare class AgentError extends UltraCodeError {
+    constructor(message: string, options?: UltraCodeErrorOptions);
+}
+/** A session operation (create, load, append, prune) failed. */
+export declare class SessionError extends UltraCodeError {
+    constructor(message: string, options?: UltraCodeErrorOptions);
+}
+/** A versioning / release-planning operation failed. */
+export declare class VersioningError extends UltraCodeError {
+    constructor(message: string, options?: UltraCodeErrorOptions);
+}
+/** Input validation failed (e.g. tool argument schema mismatch). */
+export declare class ValidationError extends UltraCodeError {
+    constructor(message: string, options?: UltraCodeErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

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

package/dist/errors.js

@@ -0,0 +1,155 @@
+/**
+ * Error hierarchy for UltraCode.
+ *
+ * All runtime errors thrown across UltraCode packages derive from
+ * {@link UltraCodeError}. Each error carries a stable, machine-readable
+ * `code`, an optional underlying `cause`, and arbitrary structured
+ * `details`. Errors are `instanceof`-safe across transpilation targets
+ * (via `Object.setPrototypeOf`) and serialise cleanly via `toJSON()`.
+ */
+/**
+ * Abstract base class for all UltraCode errors.
+ *
+ * Subclasses MUST provide a stable {@link UltraCodeError.code}. The base
+ * class normalises `name`, fixes the prototype chain for reliable
+ * `instanceof` checks, and captures a stack trace where supported.
+ */
+export class UltraCodeError extends Error {
+    /** Stable, machine-readable error code (e.g. `"CONFIG_ERROR"`). */
+    code;
+    /** Structured, JSON-safe detail payload. */
+    details;
+    constructor(code, message, options = {}) {
+        // `cause` is part of the standard ErrorOptions in ES2022.
+        super(message, options.cause !== undefined ? { cause: options.cause } : undefined);
+        this.code = code;
+        this.details = options.details;
+        this.name = new.target.name;
+        // Restore prototype chain so `instanceof` works after transpilation/bundling.
+        Object.setPrototypeOf(this, new.target.prototype);
+        // Capture a clean stack trace where the V8 API is available.
+        if (typeof Error.captureStackTrace === "function") {
+            Error.captureStackTrace(this, new.target);
+        }
+    }
+    /** JSON-safe representation, suitable for transport and event buses. */
+    toJSON() {
+        const out = {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+        };
+        if (this.stack !== undefined)
+            out.stack = this.stack;
+        if (this.details !== undefined)
+            out.details = this.details;
+        if (this.cause !== undefined)
+            out.cause = serializeCause(this.cause);
+        return out;
+    }
+}
+/** Reduce an arbitrary `cause` to a JSON-safe form without throwing. */
+function serializeCause(cause) {
+    if (cause instanceof UltraCodeError)
+        return cause.toJSON();
+    if (cause instanceof Error) {
+        const out = { name: cause.name, message: cause.message, code: "ERROR" };
+        if (cause.stack !== undefined)
+            out.stack = cause.stack;
+        return out;
+    }
+    return cause;
+}
+/** Configuration loading, parsing or validation failed. */
+export class ConfigError extends UltraCodeError {
+    constructor(message, options = {}) {
+        super("CONFIG_ERROR", message, options);
+    }
+}
+/** An LLM provider request failed. */
+export class ProviderError extends UltraCodeError {
+    /** Provider name that produced the error. */
+    provider;
+    /** HTTP status code, when applicable. */
+    statusCode;
+    /** Whether the operation may succeed if retried. */
+    retryable;
+    constructor(message, options) {
+        super("PROVIDER_ERROR", message, options);
+        this.provider = options.provider;
+        this.statusCode = options.statusCode;
+        this.retryable = options.retryable ?? false;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            details: {
+                ...this.details,
+                provider: this.provider,
+                statusCode: this.statusCode,
+                retryable: this.retryable,
+            },
+        };
+    }
+}
+/** A tool encountered an error during execution. */
+export class ToolError extends UltraCodeError {
+    /** Name of the tool that failed. */
+    toolName;
+    constructor(a, b, c) {
+        const code = typeof c === "undefined" ? "TOOL_ERROR" : a;
+        const message = typeof c === "undefined" ? a : b;
+        const options = (typeof c === "undefined" ? b : c);
+        super(code, message, options);
+        this.toolName = options.toolName;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            details: { ...this.details, toolName: this.toolName },
+        };
+    }
+}
+/** A tool was invoked but the user/permission system denied it. */
+export class ToolPermissionDeniedError extends ToolError {
+    constructor(message, options) {
+        super("TOOL_PERMISSION_DENIED", message, options);
+    }
+}
+/** A tool exceeded its configured execution timeout. */
+export class ToolTimeoutError extends ToolError {
+    constructor(message, options) {
+        super("TOOL_TIMEOUT", message, options);
+    }
+}
+/** A tool was requested that is not registered. */
+export class ToolNotFoundError extends ToolError {
+    constructor(message, options) {
+        super("TOOL_NOT_FOUND", message, options);
+    }
+}
+/** An agent failed during its run lifecycle. */
+export class AgentError extends UltraCodeError {
+    constructor(message, options = {}) {
+        super("AGENT_ERROR", message, options);
+    }
+}
+/** A session operation (create, load, append, prune) failed. */
+export class SessionError extends UltraCodeError {
+    constructor(message, options = {}) {
+        super("SESSION_ERROR", message, options);
+    }
+}
+/** A versioning / release-planning operation failed. */
+export class VersioningError extends UltraCodeError {
+    constructor(message, options = {}) {
+        super("VERSIONING_ERROR", message, options);
+    }
+}
+/** Input validation failed (e.g. tool argument schema mismatch). */
+export class ValidationError extends UltraCodeError {
+    constructor(message, options = {}) {
+        super("VALIDATION_ERROR", message, options);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/events/EventBus.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Concrete {@link IEventBus} implementation.
+ *
+ * Design notes:
+ * - **Handler isolation:** a throwing handler is caught so it cannot prevent
+ *   sibling handlers from running. Caught errors are reported via an optional
+ *   `onHandlerError` callback (defaulting to `console.error`).
+ * - **Safe mutation during emit:** `emit` iterates over a snapshot of the
+ *   handler set, so subscribing/unsubscribing from within a handler does not
+ *   disturb the in-flight dispatch and never throws.
+ */
+import type { EventHandler, IEventBus, UltraCodeEvent, UltraCodeEventType } from "../types/events.js";
+/** Options for {@link EventBus}. */
+export interface EventBusOptions {
+    /**
+     * Invoked when a handler throws. Receives the thrown value and the event that
+     * was being dispatched. Defaults to logging via `console.error`. This callback
+     * is itself wrapped so that a throwing reporter cannot break dispatch.
+     */
+    onHandlerError?: (error: unknown, event: UltraCodeEvent) => void;
+}
+export declare class EventBus implements IEventBus {
+    /** Per-type subscriber sets. A `Set` gives O(1) add/remove and dedupes. */
+    private readonly handlers;
+    private readonly onHandlerError;
+    constructor(options?: EventBusOptions);
+    on<T extends UltraCodeEventType>(type: T, handler: EventHandler<T>): () => void;
+    emit(event: UltraCodeEvent): void;
+    /** Number of subscribers for a given event type (useful for tests/diagnostics). */
+    listenerCount(type: UltraCodeEventType): number;
+    /** Remove all subscribers, optionally for a single event type. */
+    removeAll(type?: UltraCodeEventType): void;
+    /** Invoke the error reporter without ever letting it throw. */
+    private reportSafely;
+}
+//# sourceMappingURL=EventBus.d.ts.map

package/dist/events/EventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.d.ts","sourceRoot":"","sources":["../../src/events/EventBus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,cAAc,EACd,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAE5B,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAClE;AAKD,qBAAa,QAAS,YAAW,SAAS;IACxC,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkD;IAC3E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkD;gBAErE,OAAO,GAAE,eAAoB;IASzC,EAAE,CAAC,CAAC,SAAS,kBAAkB,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAsB/E,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAcjC,mFAAmF;IACnF,aAAa,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM;IAI/C,kEAAkE;IAClE,SAAS,CAAC,IAAI,CAAC,EAAE,kBAAkB,GAAG,IAAI;IAK1C,+DAA+D;IAC/D,OAAO,CAAC,YAAY;CAOrB"}

package/dist/events/EventBus.js

@@ -0,0 +1,83 @@
+/**
+ * Concrete {@link IEventBus} implementation.
+ *
+ * Design notes:
+ * - **Handler isolation:** a throwing handler is caught so it cannot prevent
+ *   sibling handlers from running. Caught errors are reported via an optional
+ *   `onHandlerError` callback (defaulting to `console.error`).
+ * - **Safe mutation during emit:** `emit` iterates over a snapshot of the
+ *   handler set, so subscribing/unsubscribing from within a handler does not
+ *   disturb the in-flight dispatch and never throws.
+ */
+export class EventBus {
+    /** Per-type subscriber sets. A `Set` gives O(1) add/remove and dedupes. */
+    handlers = new Map();
+    onHandlerError;
+    constructor(options = {}) {
+        this.onHandlerError =
+            options.onHandlerError ??
+                ((error, event) => {
+                    // Default reporter; never throws.
+                    console.error(`[EventBus] handler for "${event.type}" threw:`, error);
+                });
+    }
+    on(type, handler) {
+        let set = this.handlers.get(type);
+        if (set === undefined) {
+            set = new Set();
+            this.handlers.set(type, set);
+        }
+        // Safe: EventHandler<T> is invoked only with EventOfType<T> values, which
+        // `emit` guarantees by routing on the event's own discriminator.
+        const erased = handler;
+        set.add(erased);
+        let active = true;
+        return () => {
+            if (!active)
+                return; // idempotent unsubscribe
+            active = false;
+            const current = this.handlers.get(type);
+            if (current === undefined)
+                return;
+            current.delete(erased);
+            if (current.size === 0)
+                this.handlers.delete(type);
+        };
+    }
+    emit(event) {
+        const set = this.handlers.get(event.type);
+        if (set === undefined || set.size === 0)
+            return;
+        // Snapshot so unsubscribe/subscribe during dispatch is safe and predictable.
+        const snapshot = Array.from(set);
+        for (const handler of snapshot) {
+            try {
+                handler(event);
+            }
+            catch (error) {
+                this.reportSafely(error, event);
+            }
+        }
+    }
+    /** Number of subscribers for a given event type (useful for tests/diagnostics). */
+    listenerCount(type) {
+        return this.handlers.get(type)?.size ?? 0;
+    }
+    /** Remove all subscribers, optionally for a single event type. */
+    removeAll(type) {
+        if (type === undefined)
+            this.handlers.clear();
+        else
+            this.handlers.delete(type);
+    }
+    /** Invoke the error reporter without ever letting it throw. */
+    reportSafely(error, event) {
+        try {
+            this.onHandlerError(error, event);
+        }
+        catch {
+            /* a throwing reporter must not break dispatch */
+        }
+    }
+}
+//# sourceMappingURL=EventBus.js.map

package/dist/events/EventBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.js","sourceRoot":"","sources":["../../src/events/EventBus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAsBH,MAAM,OAAO,QAAQ;IACnB,2EAA2E;IAC1D,QAAQ,GAAG,IAAI,GAAG,EAAuC,CAAC;IAC1D,cAAc,CAAkD;IAEjF,YAAY,UAA2B,EAAE;QACvC,IAAI,CAAC,cAAc;YACjB,OAAO,CAAC,cAAc;gBACtB,CAAC,CAAC,KAAK,EAAE,KAAK,EAAQ,EAAE;oBACtB,kCAAkC;oBAClC,OAAO,CAAC,KAAK,CAAC,2BAA2B,KAAK,CAAC,IAAI,UAAU,EAAE,KAAK,CAAC,CAAC;gBACxE,CAAC,CAAC,CAAC;IACP,CAAC;IAED,EAAE,CAA+B,IAAO,EAAE,OAAwB;QAChE,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,GAAG,GAAG,IAAI,GAAG,EAAc,CAAC;YAC5B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC/B,CAAC;QACD,0EAA0E;QAC1E,iEAAiE;QACjE,MAAM,MAAM,GAAG,OAAqB,CAAC;QACrC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAEhB,IAAI,MAAM,GAAG,IAAI,CAAC;QAClB,OAAO,GAAS,EAAE;YAChB,IAAI,CAAC,MAAM;gBAAE,OAAO,CAAC,yBAAyB;YAC9C,MAAM,GAAG,KAAK,CAAC;YACf,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO;YAClC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACvB,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;gBAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrD,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAqB;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QAChD,6EAA6E;QAC7E,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IAED,mFAAmF;IACnF,aAAa,CAAC,IAAwB;QACpC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,kEAAkE;IAClE,SAAS,CAAC,IAAyB;QACjC,IAAI,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;;YACzC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,+DAA+D;IACvD,YAAY,CAAC,KAAc,EAAE,KAAqB;QACxD,IAAI,CAAC;YACH,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,iDAAiD;QACnD,CAAC;IACH,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `ultracode-shared` — the contract layer.
+ *
+ * This package defines the types, interfaces, errors, events and utilities that
+ * the `core` and `cli` packages build against. It contains no business logic
+ * beyond small, pure runtime helpers (errors, EventBus, logger, utils).
+ *
+ * Import everything from the package root:
+ * ```ts
+ * import { UltraCodeError, EventBus, deepMerge, type ToolDefinition } from "ultracode-shared";
+ * ```
+ */
+export { UltraCodeError, ConfigError, ProviderError, ToolError, ToolPermissionDeniedError, ToolTimeoutError, ToolNotFoundError, AgentError, SessionError, VersioningError, ValidationError, } from "./errors.js";
+export type { SerializedError, UltraCodeErrorOptions, ProviderErrorOptions, ToolErrorOptions, } from "./errors.js";
+export { ConsoleLogger, NoopLogger } from "./logger.js";
+export type { Logger, LogLevel, LogMeta, LogSink, ConsoleLoggerOptions, } from "./logger.js";
+export type { ToolPermission, ToolCategory, ToolParameterSchema, ToolDefinition, ToolContext, ToolResult, ITool, } from "./types/tool.js";
+export type { ProviderName, ProviderId, ChatRole, ChatMessage, ToolCallRequest, CompletionRequest, CompletionChunk, CompletionResult, FinishReason, TokenUsage, ILLMProvider, ProviderOptions, } from "./types/provider.js";
+export type { AgentType, AgentDefinition, AgentRunInput, AgentRunResult, IAgent, } from "./types/agent.js";
+export { DEFAULT_CONFIG } from "./types/config.js";
+export type { DeepPartial, CoreConfig, ProxyConfig, LocalProviderConfig, ProvidersConfig, PerToolConfig, ToolsConfig, AgentConfigEntry, AgentsConfig, UiColors, UiConfig, SessionCompactionConfig, SessionsConfig, GitCommitConfig, GitProtectionConfig, GitConfig, VersioningSemanticConfig, VersioningChannelsConfig, VersioningQualityConfig, VersioningChangelogConfig, VersioningConfig, McpTransport, McpServerConfig, UltraCodeConfig, } from "./types/config.js";
+export type { SessionMeta, SessionRecord, ISessionStore, } from "./types/memory.js";
+export type { BumpType, FileChange, CommitInfo, BreakingChange, SecurityFinding, ChangeAnalysis, VersionSuggestion, Milestone, Risk, ReleasePlan, QualityGateResult, QualityReport, } from "./types/versioning.js";
+export type { ToolExecutedEvent, AgentSwitchedEvent, SessionStartedEvent, SessionEndedEvent, ErrorEvent, VersionSuggestedEvent, UltraCodeEvent, UltraCodeEventType, EventOfType, EventHandler, IEventBus, } from "./types/events.js";
+export { EventBus } from "./events/EventBus.js";
+export type { EventBusOptions } from "./events/EventBus.js";
+export { serializeError, truncate, DEFAULT_TRUNCATE_SUFFIX, isPlainObject, deepMerge, sleep, clamp, generateId, } from "./utils/index.js";
+export type { TruncateOptions } from "./utils/index.js";
+export { VERSION, CONFIG_FILE_NAMES, USER_CONFIG_DIR, USER_CONFIG_FILE, USER_ENV_FILE, ENV_PREFIX, DEFAULT_SESSION_DIR, PROMPTS_DIR, MAX_TOOL_OUTPUT_CHARS, DEFAULT_PROVIDER_TIMEOUT_MS, DEFAULT_MAX_RETRIES, DEFAULT_RETRY_DELAY_MS, DEFAULT_CHANGELOG_FILE, } from "./constants.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EACL,cAAc,EACd,WAAW,EACX,aAAa,EACb,SAAS,EACT,yBAAyB,EACzB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAKrB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EACV,MAAM,EACN,QAAQ,EACR,OAAO,EACP,OAAO,EACP,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAKrB,YAAY,EACV,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,UAAU,EACV,KAAK,GACN,MAAM,iBAAiB,CAAC;AAKzB,YAAY,EACV,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAK7B,YAAY,EACV,SAAS,EACT,eAAe,EACf,aAAa,EACb,cAAc,EACd,MAAM,GACP,MAAM,kBAAkB,CAAC;AAK1B,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,uBAAuB,EACvB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,SAAS,EACT,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,EACzB,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAK3B,YAAY,EACV,WAAW,EACX,aAAa,EACb,aAAa,GACd,MAAM,mBAAmB,CAAC;AAK3B,YAAY,EACV,QAAQ,EACR,UAAU,EACV,UAAU,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,SAAS,EACT,IAAI,EACJ,WAAW,EACX,iBAAiB,EACjB,aAAa,GACd,MAAM,uBAAuB,CAAC;AAK/B,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EACV,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,SAAS,GACV,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAK5D,OAAO,EACL,cAAc,EACd,QAAQ,EACR,uBAAuB,EACvB,aAAa,EACb,SAAS,EACT,KAAK,EACL,KAAK,EACL,UAAU,GACX,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAKxD,OAAO,EACL,OAAO,EACP,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,mBAAmB,EACnB,WAAW,EACX,qBAAqB,EACrB,2BAA2B,EAC3B,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,34 @@
+/**
+ * `ultracode-shared` — the contract layer.
+ *
+ * This package defines the types, interfaces, errors, events and utilities that
+ * the `core` and `cli` packages build against. It contains no business logic
+ * beyond small, pure runtime helpers (errors, EventBus, logger, utils).
+ *
+ * Import everything from the package root:
+ * ```ts
+ * import { UltraCodeError, EventBus, deepMerge, type ToolDefinition } from "ultracode-shared";
+ * ```
+ */
+/* ----------------------------------------------------------------------------
+ * Errors (runtime classes + types)
+ * ------------------------------------------------------------------------- */
+export { UltraCodeError, ConfigError, ProviderError, ToolError, ToolPermissionDeniedError, ToolTimeoutError, ToolNotFoundError, AgentError, SessionError, VersioningError, ValidationError, } from "./errors.js";
+/* ----------------------------------------------------------------------------
+ * Logging (runtime classes + types)
+ * ------------------------------------------------------------------------- */
+export { ConsoleLogger, NoopLogger } from "./logger.js";
+/* ----------------------------------------------------------------------------
+ * Configuration (types + DEFAULT_CONFIG value)
+ * ------------------------------------------------------------------------- */
+export { DEFAULT_CONFIG } from "./types/config.js";
+export { EventBus } from "./events/EventBus.js";
+/* ----------------------------------------------------------------------------
+ * Utilities (runtime functions)
+ * ------------------------------------------------------------------------- */
+export { serializeError, truncate, DEFAULT_TRUNCATE_SUFFIX, isPlainObject, deepMerge, sleep, clamp, generateId, } from "./utils/index.js";
+/* ----------------------------------------------------------------------------
+ * Constants
+ * ------------------------------------------------------------------------- */
+export { VERSION, CONFIG_FILE_NAMES, USER_CONFIG_DIR, USER_CONFIG_FILE, USER_ENV_FILE, ENV_PREFIX, DEFAULT_SESSION_DIR, PROMPTS_DIR, MAX_TOOL_OUTPUT_CHARS, DEFAULT_PROVIDER_TIMEOUT_MS, DEFAULT_MAX_RETRIES, DEFAULT_RETRY_DELAY_MS, DEFAULT_CHANGELOG_FILE, } from "./constants.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;+EAE+E;AAC/E,OAAO,EACL,cAAc,EACd,WAAW,EACX,aAAa,EACb,SAAS,EACT,yBAAyB,EACzB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAC;AAQrB;;+EAE+E;AAC/E,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAmDxD;;+EAE+E;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAuEnD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD;;+EAE+E;AAC/E,OAAO,EACL,cAAc,EACd,QAAQ,EACR,uBAAuB,EACvB,aAAa,EACb,SAAS,EACT,KAAK,EACL,KAAK,EACL,UAAU,GACX,MAAM,kBAAkB,CAAC;AAG1B;;+EAE+E;AAC/E,OAAO,EACL,OAAO,EACP,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,mBAAmB,EACnB,WAAW,EACX,qBAAqB,EACrB,2BAA2B,EAC3B,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC"}