groundswell 0.0.2 → 1.0.0

package/dist/utils/harness-config.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Harness configuration cascade utilities (PRD §7.6 / §7.7).
+ *
+ * ## Dual-Cascade Architecture
+ *
+ * This module provides the v1.2 canonical harness-configuration functions that operate
+ * on the `GlobalHarnessConfig` / `HarnessId` / `HarnessOptions` types. It also contains
+ * deprecated legacy aliases (`configureProviders` / `getGlobalProviderConfig` /
+ * `resolveProviderConfig` / `resetGlobalConfig`) that preserve backward compatibility
+ * with existing consumers (`agent.ts`, legacy test files) during the migration.
+ *
+ * ## Dual-Singleton Design (Scope Decision)
+ *
+ * The legacy and harness functions validate **disjoint id sets**:
+ *   - `configureHarnesses` accepts only `'pi' | 'claude-code'`
+ *   - `configureProviders` accepts the full `ProviderId` superset (including `'anthropic'`)
+ *
+ * Existing consumers (agent.ts, 4 integration/override test files) pass `'anthropic'`
+ * through `configureProviders`. Making it delegate to `configureHarnesses` would throw and break
+ * those consumers, which are out of scope for this task (owned by P3.M1 / P4.M1).
+ *
+ * Therefore, **`configureProviders` keeps its own module-private singleton** with permissive
+ * validation, while `resolveProviderConfig` safely delegates to `resolveHarnessConfig` (which
+ * performs NO id validation — it treats ids as opaque string keys).
+ *
+ * Once P3.M1 rewires agent.ts to read the harness path and P4.M1 removes the legacy literals,
+ * the legacy singleton can be deleted and the aliases collapse to true delegation.
+ *
+ * @see {@link GlobalHarnessConfig} in types/harnesses.ts
+ * @see {@link GlobalProviderConfig} in types/providers.ts
+ */
+import type { GlobalHarnessConfig, HarnessId, HarnessOptions } from '../types/harnesses.js';
+import type { GlobalProviderConfig, ProviderId, ProviderOptions } from '../types/providers.js';
+/**
+ * Configure the global harness settings.
+ *
+ * Validates and stores the harness configuration. Should be called once at
+ * application startup. The harness cascade (PRD §7.7) uses this as the lowest
+ * priority layer — agent and prompt overrides take precedence.
+ *
+ * ## Validation
+ *
+ * - `defaultHarness` must be `'pi'` or `'claude-code'`
+ * - `harnessDefaults` keys (if present) must be valid `HarnessId` values
+ * - `defaultModelProvider` is an **open set** (any string) — NOT validated (PRD §7.8)
+ *
+ * @param config - Global harness configuration
+ * @throws {Error} If `defaultHarness` is invalid
+ * @throws {Error} If `harnessDefaults` contains invalid harness IDs
+ *
+ * @example
+ * ```ts
+ * import { configureHarnesses } from 'groundswell';
+ *
+ * configureHarnesses({
+ *   defaultHarness: 'pi',
+ *   defaultModelProvider: 'anthropic',
+ *   harnessDefaults: {
+ *     'claude-code': { apiKey: process.env.ANTHROPIC_API_KEY },
+ *   },
+ * });
+ * ```
+ */
+export declare function configureHarnesses(config: GlobalHarnessConfig): void;
+/**
+ * Get the current global harness configuration.
+ *
+ * Returns the configured value if `configureHarnesses()` was called, otherwise
+ * returns the default configuration. **Never returns null.**
+ *
+ * @returns Current global harness configuration
+ *
+ * @example
+ * ```ts
+ * const config = getGlobalHarnessConfig();
+ * console.log(config.defaultHarness); // 'pi' (default)
+ * ```
+ */
+export declare function getGlobalHarnessConfig(): GlobalHarnessConfig;
+/**
+ * Resolve harness configuration via the PRD §7.7 cascade.
+ *
+ * A **pure function** — takes `globalConfig` as a parameter and does NOT read
+ * the singleton. This purity enables both `resolveHarnessConfig` and the legacy
+ * `resolveProviderConfig` (which delegates to this function) to work correctly.
+ *
+ * ## Provider Resolution (nullish coalescing — prompt wins)
+ *
+ * ```ts
+ * const harness = promptHarness ?? agentHarness ?? globalConfig.defaultHarness;
+ * ```
+ *
+ * ## Options Merge (object spread — last write wins)
+ *
+ * ```ts
+ * const options = {
+ *   ...globalConfig.harnessDefaults?.[harness],  // base
+ *   ...agentOptions,                                // middle
+ *   ...promptOptions,                               // top
+ * };
+ * ```
+ *
+ * @param globalConfig - Global harness configuration
+ * @param agentHarness - Agent-level harness override (optional)
+ * @param agentOptions - Agent-level options override (optional)
+ * @param promptHarness - Prompt-level harness override (optional)
+ * @param promptOptions - Prompt-level options override (optional)
+ * @returns Resolved harness and merged options
+ */
+export declare function resolveHarnessConfig(globalConfig: GlobalHarnessConfig, agentHarness?: HarnessId, agentOptions?: HarnessOptions, promptHarness?: HarnessId, promptOptions?: HarnessOptions): {
+    harness: HarnessId;
+    options: HarnessOptions;
+};
+/**
+ * Reset the global harness configuration to defaults.
+ *
+ * **FOR TESTING PURPOSES ONLY.**
+ *
+ * @internal
+ */
+export declare function resetGlobalHarnessConfig(): void;
+/**
+ * Configure global provider settings.
+ *
+ * @deprecated Since v1.2. Use {@link configureHarnesses}.
+ *
+ * This function keeps its **own module-private singleton** (`globalProviderConfig`)
+ * with permissive `ProviderId` validation. It does NOT delegate to
+ * `configureHarnesses` because the harness validator rejects `'anthropic'`,
+ * which existing consumers still pass.
+ *
+ * @param config - Global provider configuration
+ * @throws {Error} If `defaultProvider` is invalid
+ * @throws {Error} If `providerDefaults` contains invalid provider IDs
+ */
+export declare function configureProviders(config: GlobalProviderConfig): void;
+/**
+ * Get the current global provider configuration.
+ *
+ * @deprecated Since v1.2. Use {@link getGlobalHarnessConfig}.
+ *
+ * Reads the legacy `globalProviderConfig` singleton. Returns the configured value
+ * if `configureProviders()` was called, otherwise the legacy default
+ * (`defaultProvider: 'anthropic'`). **Never returns null.**
+ *
+ * @returns Current global provider configuration
+ */
+export declare function getGlobalProviderConfig(): GlobalProviderConfig;
+/**
+ * Resolve provider configuration via the cascade.
+ *
+ * @deprecated Since v1.2. Use {@link resolveHarnessConfig}.
+ *
+ * **Delegates to {@link resolveHarnessConfig}** — the cascade algorithm is shared.
+ * Translates the `GlobalProviderConfig` shape to `GlobalHarnessConfig` (field renames),
+ * calls `resolveHarnessConfig` (which performs NO id validation — safe for legacy literals),
+ * and maps the result back to `{ provider, options }`.
+ *
+ * @param globalConfig - Global provider configuration from configureProviders()
+ * @param agentProvider - Agent-level provider override (optional)
+ * @param agentOptions - Agent-level options override (optional)
+ * @param promptProvider - Prompt-level provider override (optional)
+ * @param promptOptions - Prompt-level options override (optional)
+ * @returns Resolved provider and merged options
+ */
+export declare function resolveProviderConfig(globalConfig: GlobalProviderConfig, agentProvider?: ProviderId, agentOptions?: ProviderOptions, promptProvider?: ProviderId, promptOptions?: ProviderOptions): {
+    provider: ProviderId;
+    options: ProviderOptions;
+};
+/**
+ * Reset global configuration to defaults.
+ *
+ * @deprecated Since v1.2. Use {@link resetGlobalHarnessConfig}.
+ *
+ * **FOR TESTING PURPOSES ONLY.**
+ *
+ * @internal
+ */
+export declare function resetGlobalConfig(): void;
+//# sourceMappingURL=harness-config.d.ts.map

package/dist/utils/harness-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-config.d.ts","sourceRoot":"","sources":["../../src/utils/harness-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,KAAK,EACV,mBAAmB,EACnB,SAAS,EACT,cAAc,EACf,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EACV,oBAAoB,EACpB,UAAU,EACV,eAAe,EAChB,MAAM,uBAAuB,CAAC;AA4C/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAuBpE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,IAAI,mBAAmB,CAE5D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,mBAAmB,EACjC,YAAY,CAAC,EAAE,SAAS,EACxB,YAAY,CAAC,EAAE,cAAc,EAC7B,aAAa,CAAC,EAAE,SAAS,EACzB,aAAa,CAAC,EAAE,cAAc,GAC7B;IAAE,OAAO,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,CAejD;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAiDD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAuBrE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,IAAI,oBAAoB,CAE9D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,oBAAoB,EAClC,aAAa,CAAC,EAAE,UAAU,EAC1B,YAAY,CAAC,EAAE,eAAe,EAC9B,cAAc,CAAC,EAAE,UAAU,EAC3B,aAAa,CAAC,EAAE,eAAe,GAC9B;IAAE,QAAQ,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,CAmBpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/utils/harness-config.js

@@ -0,0 +1,311 @@
+/**
+ * Harness configuration cascade utilities (PRD §7.6 / §7.7).
+ *
+ * ## Dual-Cascade Architecture
+ *
+ * This module provides the v1.2 canonical harness-configuration functions that operate
+ * on the `GlobalHarnessConfig` / `HarnessId` / `HarnessOptions` types. It also contains
+ * deprecated legacy aliases (`configureProviders` / `getGlobalProviderConfig` /
+ * `resolveProviderConfig` / `resetGlobalConfig`) that preserve backward compatibility
+ * with existing consumers (`agent.ts`, legacy test files) during the migration.
+ *
+ * ## Dual-Singleton Design (Scope Decision)
+ *
+ * The legacy and harness functions validate **disjoint id sets**:
+ *   - `configureHarnesses` accepts only `'pi' | 'claude-code'`
+ *   - `configureProviders` accepts the full `ProviderId` superset (including `'anthropic'`)
+ *
+ * Existing consumers (agent.ts, 4 integration/override test files) pass `'anthropic'`
+ * through `configureProviders`. Making it delegate to `configureHarnesses` would throw and break
+ * those consumers, which are out of scope for this task (owned by P3.M1 / P4.M1).
+ *
+ * Therefore, **`configureProviders` keeps its own module-private singleton** with permissive
+ * validation, while `resolveProviderConfig` safely delegates to `resolveHarnessConfig` (which
+ * performs NO id validation — it treats ids as opaque string keys).
+ *
+ * Once P3.M1 rewires agent.ts to read the harness path and P4.M1 removes the legacy literals,
+ * the legacy singleton can be deleted and the aliases collapse to true delegation.
+ *
+ * @see {@link GlobalHarnessConfig} in types/harnesses.ts
+ * @see {@link GlobalProviderConfig} in types/providers.ts
+ */
+// ============================================================================
+// Harness Cascade — Module-Private Storage
+// ============================================================================
+/**
+ * Module-private harness configuration singleton.
+ *
+ * Not exported — access via `getGlobalHarnessConfig()` / `configureHarnesses()`.
+ * @internal
+ */
+let globalHarnessConfig = null;
+/**
+ * Default harness configuration (PRD §7.1 — `pi` is the vendor-neutral default).
+ * @internal
+ */
+const DEFAULT_HARNESS_CONFIG = {
+    defaultHarness: 'pi',
+};
+// ============================================================================
+// Harness Cascade — Validation Helpers
+// ============================================================================
+/**
+ * Type guard: checks if a string is a valid `HarnessId` ('pi' | 'claude-code').
+ */
+function isValidHarnessId(value) {
+    return value === 'pi' || value === 'claude-code';
+}
+/**
+ * Formatted list of supported harnesses for error messages.
+ */
+function getSupportedHarnessesList() {
+    return '"pi", "claude-code"';
+}
+// ============================================================================
+// Harness Cascade — Public API
+// ============================================================================
+/**
+ * Configure the global harness settings.
+ *
+ * Validates and stores the harness configuration. Should be called once at
+ * application startup. The harness cascade (PRD §7.7) uses this as the lowest
+ * priority layer — agent and prompt overrides take precedence.
+ *
+ * ## Validation
+ *
+ * - `defaultHarness` must be `'pi'` or `'claude-code'`
+ * - `harnessDefaults` keys (if present) must be valid `HarnessId` values
+ * - `defaultModelProvider` is an **open set** (any string) — NOT validated (PRD §7.8)
+ *
+ * @param config - Global harness configuration
+ * @throws {Error} If `defaultHarness` is invalid
+ * @throws {Error} If `harnessDefaults` contains invalid harness IDs
+ *
+ * @example
+ * ```ts
+ * import { configureHarnesses } from 'groundswell';
+ *
+ * configureHarnesses({
+ *   defaultHarness: 'pi',
+ *   defaultModelProvider: 'anthropic',
+ *   harnessDefaults: {
+ *     'claude-code': { apiKey: process.env.ANTHROPIC_API_KEY },
+ *   },
+ * });
+ * ```
+ */
+export function configureHarnesses(config) {
+    // Validate defaultHarness
+    if (!isValidHarnessId(config.defaultHarness)) {
+        throw new Error(`Invalid default harness: "${config.defaultHarness}". ` +
+            `Supported harnesses: ${getSupportedHarnessesList()}`);
+    }
+    // Validate harnessDefaults keys (if present)
+    if (config.harnessDefaults) {
+        for (const id of Object.keys(config.harnessDefaults)) {
+            if (!isValidHarnessId(id)) {
+                throw new Error(`Invalid harness in harnessDefaults: "${id}". ` +
+                    `Supported harnesses: ${getSupportedHarnessesList()}`);
+            }
+        }
+    }
+    // Store configuration (defaultModelProvider is open set — no validation)
+    globalHarnessConfig = config;
+}
+/**
+ * Get the current global harness configuration.
+ *
+ * Returns the configured value if `configureHarnesses()` was called, otherwise
+ * returns the default configuration. **Never returns null.**
+ *
+ * @returns Current global harness configuration
+ *
+ * @example
+ * ```ts
+ * const config = getGlobalHarnessConfig();
+ * console.log(config.defaultHarness); // 'pi' (default)
+ * ```
+ */
+export function getGlobalHarnessConfig() {
+    return globalHarnessConfig ?? DEFAULT_HARNESS_CONFIG;
+}
+/**
+ * Resolve harness configuration via the PRD §7.7 cascade.
+ *
+ * A **pure function** — takes `globalConfig` as a parameter and does NOT read
+ * the singleton. This purity enables both `resolveHarnessConfig` and the legacy
+ * `resolveProviderConfig` (which delegates to this function) to work correctly.
+ *
+ * ## Provider Resolution (nullish coalescing — prompt wins)
+ *
+ * ```ts
+ * const harness = promptHarness ?? agentHarness ?? globalConfig.defaultHarness;
+ * ```
+ *
+ * ## Options Merge (object spread — last write wins)
+ *
+ * ```ts
+ * const options = {
+ *   ...globalConfig.harnessDefaults?.[harness],  // base
+ *   ...agentOptions,                                // middle
+ *   ...promptOptions,                               // top
+ * };
+ * ```
+ *
+ * @param globalConfig - Global harness configuration
+ * @param agentHarness - Agent-level harness override (optional)
+ * @param agentOptions - Agent-level options override (optional)
+ * @param promptHarness - Prompt-level harness override (optional)
+ * @param promptOptions - Prompt-level options override (optional)
+ * @returns Resolved harness and merged options
+ */
+export function resolveHarnessConfig(globalConfig, agentHarness, agentOptions, promptHarness, promptOptions) {
+    // Step 1: Resolve harness — prompt wins (first-defined-wins via ??)
+    const harness = promptHarness ?? agentHarness ?? globalConfig.defaultHarness;
+    // Step 2: Get global defaults for the resolved harness
+    const globalDefaults = globalConfig.harnessDefaults?.[harness];
+    // Step 3: Merge options — last write wins
+    const options = {
+        ...(globalDefaults ?? {}),
+        ...(agentOptions ?? {}),
+        ...(promptOptions ?? {}),
+    };
+    return { harness, options };
+}
+/**
+ * Reset the global harness configuration to defaults.
+ *
+ * **FOR TESTING PURPOSES ONLY.**
+ *
+ * @internal
+ */
+export function resetGlobalHarnessConfig() {
+    globalHarnessConfig = null;
+}
+// ============================================================================
+// Deprecated Legacy Aliases — Module-Private Storage (Separate Singleton)
+// ============================================================================
+/**
+ * Module-private LEGACY provider configuration singleton.
+ *
+ * **Separate from `globalHarnessConfig`** — the two validate disjoint id sets
+ * (see module-level Scope Decision). This singleton is owned by the deprecated
+ * `configureProviders` / `getGlobalProviderConfig` / `resetGlobalConfig` functions.
+ * @internal
+ */
+let globalProviderConfig = null;
+/**
+ * Default LEGACY provider configuration.
+ * @internal
+ */
+const DEFAULT_PROVIDER_CONFIG = {
+    defaultProvider: 'anthropic',
+    providerDefaults: undefined,
+};
+// ============================================================================
+// Deprecated Legacy Aliases — Validation Helpers
+// ============================================================================
+/**
+ * Type guard: checks if a string is a valid `ProviderId`.
+ *
+ * Accepts 'anthropic' (legacy), 'pi', and 'claude-code'.
+ */
+function isValidProviderId(value) {
+    return value === 'anthropic' || value === 'pi' || value === 'claude-code';
+}
+/**
+ * Formatted list of supported providers for LEGACY error messages.
+ */
+function getSupportedProvidersList() {
+    return '"anthropic", "pi", "claude-code"';
+}
+// ============================================================================
+// Deprecated Legacy Aliases — Public API
+// ============================================================================
+/**
+ * Configure global provider settings.
+ *
+ * @deprecated Since v1.2. Use {@link configureHarnesses}.
+ *
+ * This function keeps its **own module-private singleton** (`globalProviderConfig`)
+ * with permissive `ProviderId` validation. It does NOT delegate to
+ * `configureHarnesses` because the harness validator rejects `'anthropic'`,
+ * which existing consumers still pass.
+ *
+ * @param config - Global provider configuration
+ * @throws {Error} If `defaultProvider` is invalid
+ * @throws {Error} If `providerDefaults` contains invalid provider IDs
+ */
+export function configureProviders(config) {
+    // Step 1: Validate defaultProvider
+    if (!isValidProviderId(config.defaultProvider)) {
+        throw new Error(`Invalid default provider: "${config.defaultProvider}". ` +
+            `Supported providers: ${getSupportedProvidersList()}`);
+    }
+    // Step 2: Validate providerDefaults keys (if present)
+    if (config.providerDefaults) {
+        for (const providerId of Object.keys(config.providerDefaults)) {
+            if (!isValidProviderId(providerId)) {
+                throw new Error(`Invalid provider in providerDefaults: "${providerId}". ` +
+                    `Supported providers: ${getSupportedProvidersList()}`);
+            }
+        }
+    }
+    // Step 3: Store configuration in the LEGACY singleton (NOT configureHarnesses)
+    globalProviderConfig = config;
+}
+/**
+ * Get the current global provider configuration.
+ *
+ * @deprecated Since v1.2. Use {@link getGlobalHarnessConfig}.
+ *
+ * Reads the legacy `globalProviderConfig` singleton. Returns the configured value
+ * if `configureProviders()` was called, otherwise the legacy default
+ * (`defaultProvider: 'anthropic'`). **Never returns null.**
+ *
+ * @returns Current global provider configuration
+ */
+export function getGlobalProviderConfig() {
+    return globalProviderConfig ?? DEFAULT_PROVIDER_CONFIG;
+}
+/**
+ * Resolve provider configuration via the cascade.
+ *
+ * @deprecated Since v1.2. Use {@link resolveHarnessConfig}.
+ *
+ * **Delegates to {@link resolveHarnessConfig}** — the cascade algorithm is shared.
+ * Translates the `GlobalProviderConfig` shape to `GlobalHarnessConfig` (field renames),
+ * calls `resolveHarnessConfig` (which performs NO id validation — safe for legacy literals),
+ * and maps the result back to `{ provider, options }`.
+ *
+ * @param globalConfig - Global provider configuration from configureProviders()
+ * @param agentProvider - Agent-level provider override (optional)
+ * @param agentOptions - Agent-level options override (optional)
+ * @param promptProvider - Prompt-level provider override (optional)
+ * @param promptOptions - Prompt-level options override (optional)
+ * @returns Resolved provider and merged options
+ */
+export function resolveProviderConfig(globalConfig, agentProvider, agentOptions, promptProvider, promptOptions) {
+    // Translate GlobalProviderConfig → GlobalHarnessConfig shape (unsound but runtime-safe casts)
+    const harnessGlobal = {
+        defaultHarness: globalConfig.defaultProvider,
+        harnessDefaults: globalConfig.providerDefaults,
+    };
+    // Delegate to resolveHarnessConfig (pure function — no singleton coupling)
+    const { harness, options } = resolveHarnessConfig(harnessGlobal, agentProvider, agentOptions, promptProvider, promptOptions);
+    // Map back to legacy shape
+    return { provider: harness, options: options };
+}
+/**
+ * Reset global configuration to defaults.
+ *
+ * @deprecated Since v1.2. Use {@link resetGlobalHarnessConfig}.
+ *
+ * **FOR TESTING PURPOSES ONLY.**
+ *
+ * @internal
+ */
+export function resetGlobalConfig() {
+    globalProviderConfig = null;
+}
+//# sourceMappingURL=harness-config.js.map

package/dist/utils/harness-config.js.map

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

package/dist/utils/id.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generate a unique identifier
+ * Uses crypto.randomUUID if available, falls back to timestamp + random
+ */
+export declare function generateId(): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/utils/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAMnC"}

package/dist/utils/id.js

@@ -0,0 +1,12 @@
+/**
+ * Generate a unique identifier
+ * Uses crypto.randomUUID if available, falls back to timestamp + random
+ */
+export function generateId() {
+    if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+        return crypto.randomUUID();
+    }
+    // Fallback for environments without crypto.randomUUID
+    return `${Date.now().toString(36)}-${Math.random().toString(36).substring(2, 11)}`;
+}
+//# sourceMappingURL=id.js.map

package/dist/utils/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACvD,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;IACD,sDAAsD;IACtD,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACrF,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,13 @@
+export { analyzeErrorForRestart, TRANSIENT_ERROR_CODES, TRANSIENT_ERROR_SET } from './restart-analysis.js';
+export { validateAgentResponse } from './agent-validation.js';
+export { configureProviders } from './provider-config.js';
+export { configureHarnesses, getGlobalHarnessConfig, resolveHarnessConfig, resetGlobalHarnessConfig } from './harness-config.js';
+export { delay } from './delay.js';
+export { generateId } from './id.js';
+export { mergeWorkflowErrors } from './workflow-error-utils.js';
+export { parseModelSpec, formatModelForProvider } from './model-spec.js';
+export { Observable } from './observable.js';
+export type { Subscription, Observer } from './observable.js';
+export type { ValidationResult } from './agent-validation.js';
+export { serializeSession, deserializeSession, SessionSerializationError } from './session-serialization.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC3G,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACjI,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC9D,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,11 @@
+export { analyzeErrorForRestart, TRANSIENT_ERROR_CODES, TRANSIENT_ERROR_SET } from './restart-analysis.js';
+export { validateAgentResponse } from './agent-validation.js';
+export { configureProviders } from './provider-config.js';
+export { configureHarnesses, getGlobalHarnessConfig, resolveHarnessConfig, resetGlobalHarnessConfig } from './harness-config.js';
+export { delay } from './delay.js';
+export { generateId } from './id.js';
+export { mergeWorkflowErrors } from './workflow-error-utils.js';
+export { parseModelSpec, formatModelForProvider } from './model-spec.js';
+export { Observable } from './observable.js';
+export { serializeSession, deserializeSession, SessionSerializationError } from './session-serialization.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC3G,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACjI,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC"}