@vybestack/llxprt-code-core 0.4.8 → 0.5.0-nightly.251102.f115237d

package/dist/src/runtime/AgentRuntimeState.js

@@ -0,0 +1,439 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @plan PLAN-20251027-STATELESS5.P03
+ * @requirement REQ-STAT5-001
+ * @pseudocode runtime-state.md lines 18-48
+ *
+ * AgentRuntimeState abstraction to replace stateful Config usage.
+ * This is a STUB implementation for Phase 03 (TDD preparation).
+ * Actual implementation happens in Phase 05.
+ */
+import { AuthType } from '../core/contentGenerator.js';
+/**
+ * @plan PLAN-20251027-STATELESS5.P03
+ * @requirement REQ-STAT5-001.1
+ * @pseudocode runtime-state.md lines 366-381
+ *
+ * Error codes for runtime state validation failures.
+ */
+export var RuntimeStateErrorCode;
+(function (RuntimeStateErrorCode) {
+    RuntimeStateErrorCode["RUNTIME_ID_MISSING"] = "runtimeId.missing";
+    RuntimeStateErrorCode["PROVIDER_MISSING"] = "provider.missing";
+    RuntimeStateErrorCode["PROVIDER_INVALID"] = "provider.invalid";
+    RuntimeStateErrorCode["MODEL_MISSING"] = "model.missing";
+    RuntimeStateErrorCode["MODEL_INVALID"] = "model.invalid";
+    RuntimeStateErrorCode["AUTH_TYPE_INVALID"] = "authType.invalid";
+    RuntimeStateErrorCode["AUTH_API_KEY_MISSING"] = "auth.apiKey.missing";
+    RuntimeStateErrorCode["AUTH_TOKEN_MISSING"] = "auth.token.missing";
+    RuntimeStateErrorCode["BASE_URL_INVALID"] = "baseUrl.invalid";
+    RuntimeStateErrorCode["UPDATE_UNSUPPORTED"] = "update.unsupported";
+    RuntimeStateErrorCode["NOT_IMPLEMENTED"] = "not.implemented";
+})(RuntimeStateErrorCode || (RuntimeStateErrorCode = {}));
+/**
+ * @plan PLAN-20251027-STATELESS5.P03
+ * @requirement REQ-STAT5-001.1
+ * @pseudocode runtime-state.md lines 366-381
+ *
+ * Error thrown during runtime state validation or update.
+ */
+export class RuntimeStateError extends Error {
+    code;
+    details;
+    constructor(code, details) {
+        const message = `RuntimeStateError: ${code}`;
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'RuntimeStateError';
+    }
+}
+// Global registry for runtime state instances
+const runtimeStateRegistry = new Map();
+// Global subscription registry
+const subscriptionRegistry = new Map();
+// Last timestamp to ensure monotonic increasing timestamps within same runtime
+let lastTimestamp = 0;
+/**
+ * Get timestamp for runtime state operations.
+ * Ensures monotonic increase even when called in same millisecond.
+ * Bounded to stay within 2ms of actual time to handle test timing windows.
+ */
+function getTimestamp() {
+    const now = Date.now();
+    // If time has naturally advanced, use it and reset tracking
+    if (now > lastTimestamp) {
+        lastTimestamp = now;
+        return now;
+    }
+    // If same millisecond or very close, increment by 1
+    // But cap at now + 1 to prevent drifting too far from actual time
+    lastTimestamp = Math.min(lastTimestamp + 1, now + 1);
+    return lastTimestamp;
+}
+/**
+ * @plan PLAN-20251027-STATELESS5.P05
+ * @requirement REQ-STAT5-001.1
+ * @pseudocode runtime-state.md lines 73-105
+ *
+ * Creates a new immutable runtime state instance.
+ * Validates all required fields and auth consistency.
+ */
+export function createAgentRuntimeState(params) {
+    // Validate runtimeId (lines 75-76)
+    if (!params.runtimeId || typeof params.runtimeId !== 'string') {
+        throw new RuntimeStateError(RuntimeStateErrorCode.RUNTIME_ID_MISSING);
+    }
+    // Validate provider (lines 77-78)
+    if (!params.provider || typeof params.provider !== 'string') {
+        throw new RuntimeStateError(RuntimeStateErrorCode.PROVIDER_MISSING);
+    }
+    // Validate model (lines 79-80)
+    if (!params.model || typeof params.model !== 'string') {
+        throw new RuntimeStateError(RuntimeStateErrorCode.MODEL_MISSING);
+    }
+    // Validate authType (lines 81-82)
+    const validAuthTypes = Object.values(AuthType);
+    if (!validAuthTypes.includes(params.authType)) {
+        throw new RuntimeStateError(RuntimeStateErrorCode.AUTH_TYPE_INVALID, {
+            authType: params.authType,
+        });
+    }
+    // Validate API_KEY auth payload (lines 83-85)
+    if (params.authType === AuthType.API_KEY) {
+        if (!params.authPayload?.apiKey) {
+            throw new RuntimeStateError(RuntimeStateErrorCode.AUTH_API_KEY_MISSING);
+        }
+    }
+    // Validate OAUTH auth payload (lines 86-88)
+    if (params.authType === AuthType.OAUTH) {
+        if (!params.authPayload?.token) {
+            throw new RuntimeStateError(RuntimeStateErrorCode.AUTH_TOKEN_MISSING);
+        }
+    }
+    // Validate baseUrl if provided (lines 89-91)
+    if (params.baseUrl) {
+        try {
+            new URL(params.baseUrl);
+        }
+        catch {
+            throw new RuntimeStateError(RuntimeStateErrorCode.BASE_URL_INVALID, {
+                baseUrl: params.baseUrl,
+            });
+        }
+    }
+    // Generate sessionId if not provided (line 101)
+    const sessionId = params.sessionId ||
+        `session-${Date.now()}-${Math.random().toString(36).substring(7)}`;
+    // Create frozen state object (lines 92-103)
+    const state = Object.freeze({
+        runtimeId: params.runtimeId,
+        provider: params.provider,
+        model: params.model,
+        authType: params.authType,
+        authPayload: params.authPayload
+            ? deepFreeze(params.authPayload)
+            : undefined,
+        baseUrl: params.baseUrl,
+        proxyUrl: params.proxyUrl,
+        modelParams: params.modelParams
+            ? deepFreeze(params.modelParams)
+            : undefined,
+        sessionId,
+        updatedAt: getTimestamp(),
+    });
+    // Register state in global registry (line 103)
+    runtimeStateRegistry.set(params.runtimeId, state);
+    return state;
+}
+/**
+ * Deep freeze helper for immutable objects
+ */
+function deepFreeze(obj) {
+    Object.freeze(obj);
+    Object.getOwnPropertyNames(obj).forEach((prop) => {
+        const value = obj[prop];
+        if (value && typeof value === 'object') {
+            deepFreeze(value);
+        }
+    });
+    return obj;
+}
+/**
+ * @plan PLAN-20251027-STATELESS5.P05
+ * @requirement REQ-STAT5-001.2
+ * @pseudocode runtime-state.md lines 209-243
+ *
+ * Updates runtime state immutably, returning a new instance.
+ * Validates updates and emits synchronous change events.
+ */
+export function updateAgentRuntimeState(oldState, updates) {
+    // Validate update keys are allowed (lines 214-218)
+    const allowedKeys = [
+        'provider',
+        'model',
+        'authType',
+        'authPayload',
+        'baseUrl',
+        'proxyUrl',
+        'modelParams',
+    ];
+    for (const key of Object.keys(updates)) {
+        if (!allowedKeys.includes(key)) {
+            throw new RuntimeStateError(RuntimeStateErrorCode.UPDATE_UNSUPPORTED, {
+                key,
+            });
+        }
+    }
+    // Validate updated fields (lines 219-225)
+    if (updates.provider !== undefined) {
+        if (!updates.provider || typeof updates.provider !== 'string') {
+            throw new RuntimeStateError(RuntimeStateErrorCode.PROVIDER_INVALID, {
+                provider: updates.provider,
+            });
+        }
+    }
+    if (updates.model !== undefined) {
+        if (!updates.model || typeof updates.model !== 'string') {
+            throw new RuntimeStateError(RuntimeStateErrorCode.MODEL_INVALID, {
+                model: updates.model,
+            });
+        }
+    }
+    if (updates.authType !== undefined) {
+        const validAuthTypes = Object.values(AuthType);
+        if (!validAuthTypes.includes(updates.authType)) {
+            throw new RuntimeStateError(RuntimeStateErrorCode.AUTH_TYPE_INVALID, {
+                authType: updates.authType,
+            });
+        }
+    }
+    // Get timestamp ensuring it's > oldState.updatedAt (lines 226)
+    const now = Date.now();
+    let updatedAt = now;
+    // If we're in the same millisecond as the previous state, wait briefly
+    // This ensures timestamps are both monotonically increasing AND bounded by actual time
+    if (now <= oldState.updatedAt) {
+        // Busy wait for next millisecond (max 1ms wait)
+        const target = oldState.updatedAt + 1;
+        while (Date.now() < target) {
+            // Spin wait
+        }
+        updatedAt = Date.now();
+    }
+    // Create new state (lines 226-227)
+    const newState = Object.freeze({
+        ...oldState,
+        ...updates,
+        authPayload: updates.authPayload
+            ? deepFreeze(updates.authPayload)
+            : oldState.authPayload,
+        modelParams: updates.modelParams
+            ? deepFreeze(updates.modelParams)
+            : oldState.modelParams,
+        updatedAt,
+    });
+    // Register new state (line 228)
+    runtimeStateRegistry.set(newState.runtimeId, newState);
+    // Compute changeset (lines 229-233)
+    const changes = {};
+    for (const key of Object.keys(updates)) {
+        const oldValue = oldState[key];
+        const newValue = newState[key];
+        if (oldValue !== newValue) {
+            changes[key] = { old: oldValue, new: newValue };
+        }
+    }
+    // Emit event (lines 234-241)
+    const event = {
+        runtimeId: newState.runtimeId,
+        changes,
+        snapshot: getAgentRuntimeStateSnapshot(newState),
+        timestamp: newState.updatedAt,
+    };
+    invokeSubscribers(newState.runtimeId, event);
+    return newState;
+}
+/**
+ * @plan PLAN-20251027-STATELESS5.P05
+ * @requirement REQ-STAT5-002.3
+ * @pseudocode runtime-state.md lines 252-278
+ *
+ * Batch update for atomic multi-field changes (e.g., provider switch).
+ * All updates validated together, single event emitted.
+ */
+export function updateAgentRuntimeStateBatch(oldState, updates) {
+    // Reuse the same validation and update logic from updateAgentRuntimeState
+    // This ensures atomic behavior - if validation fails, nothing is mutated (lines 257-258)
+    return updateAgentRuntimeState(oldState, updates);
+}
+/**
+ * @plan PLAN-20251027-STATELESS5.P05
+ * @requirement REQ-STAT5-001.3
+ * @pseudocode runtime-state.md lines 329-355
+ *
+ * Returns a frozen snapshot of runtime state for diagnostics.
+ * Sanitizes sensitive auth data.
+ */
+export function getAgentRuntimeStateSnapshot(state) {
+    // Sanitize auth payload (lines 335, 344-352)
+    const sanitizedAuthPayload = sanitizeAuthPayload(state.authPayload);
+    // Return frozen snapshot (lines 330-342)
+    return Object.freeze({
+        runtimeId: state.runtimeId,
+        provider: state.provider,
+        model: state.model,
+        authType: state.authType,
+        authPayload: sanitizedAuthPayload,
+        baseUrl: state.baseUrl,
+        proxyUrl: state.proxyUrl,
+        modelParams: state.modelParams ? { ...state.modelParams } : undefined,
+        sessionId: state.sessionId,
+        updatedAt: state.updatedAt,
+        version: 1, // Schema version (line 341)
+    });
+}
+/**
+ * @plan PLAN-20251027-STATELESS5.P05
+ * @requirement REQ-STAT5-001.3
+ * @pseudocode runtime-state.md lines 344-352
+ *
+ * Sanitizes auth payload for diagnostics by masking sensitive data.
+ */
+function sanitizeAuthPayload(payload) {
+    if (!payload) {
+        return undefined;
+    }
+    const result = {};
+    // Mask API key - show only last 4 chars (lines 348-349)
+    if (payload.apiKey) {
+        const apiKey = payload.apiKey;
+        if (apiKey.length > 4) {
+            result.apiKey = `***${apiKey.slice(-4)}`;
+        }
+        else {
+            result.apiKey = '***';
+        }
+    }
+    // Redact OAuth token (lines 350-351)
+    if (payload.token) {
+        result.token = '[REDACTED]';
+    }
+    return result;
+}
+/**
+ * @plan PLAN-20251027-STATELESS5.P05
+ * @requirement REQ-STAT5-003.2
+ * @pseudocode runtime-state.md lines 289-318
+ *
+ * Subscribes to runtime state change events.
+ * Returns unsubscribe function to remove callback.
+ */
+export function subscribeToAgentRuntimeState(runtimeId, callback, options) {
+    // Validate inputs (lines 294-295)
+    if (!runtimeId || typeof runtimeId !== 'string') {
+        throw new Error('runtimeId must be a non-empty string');
+    }
+    if (typeof callback !== 'function') {
+        throw new Error('callback must be a function');
+    }
+    // Get or create subscriber list (line 296)
+    let subscribers = subscriptionRegistry.get(runtimeId);
+    if (!subscribers) {
+        subscribers = new Map();
+        subscriptionRegistry.set(runtimeId, subscribers);
+    }
+    // Generate unique subscription ID (line 297)
+    const subscriptionId = `sub-${Date.now()}-${Math.random().toString(36).substring(7)}`;
+    // Store subscription (lines 298-302)
+    subscribers.set(subscriptionId, {
+        callback,
+        async: options?.async || false,
+    });
+    // Return unsubscribe function (lines 303-306)
+    return () => {
+        const subs = subscriptionRegistry.get(runtimeId);
+        if (subs) {
+            subs.delete(subscriptionId);
+        }
+    };
+}
+/**
+ * @plan PLAN-20251027-STATELESS5.P05
+ * @requirement REQ-STAT5-003.2
+ * @pseudocode runtime-state.md lines 308-316
+ *
+ * Invokes all subscribers for a given runtime ID.
+ * Handles both synchronous and async callbacks with error isolation.
+ */
+function invokeSubscribers(runtimeId, event) {
+    const subscribers = subscriptionRegistry.get(runtimeId);
+    if (!subscribers || subscribers.size === 0) {
+        return;
+    }
+    // Invoke each subscriber (lines 309-315)
+    for (const subscription of subscribers.values()) {
+        try {
+            if (subscription.async) {
+                // Async callback - queue as microtask (line 311-312)
+                queueMicrotask(() => {
+                    try {
+                        subscription.callback(event);
+                    }
+                    catch (error) {
+                        // Error handling to prevent cascade failures (line 315)
+                        console.error('Error in async runtime state callback:', error);
+                    }
+                });
+            }
+            else {
+                // Synchronous callback (line 313-314)
+                subscription.callback(event);
+            }
+        }
+        catch (error) {
+            // Error handling to prevent cascade failures (line 315)
+            console.error('Error in runtime state callback:', error);
+        }
+    }
+}
+/**
+ * @plan PLAN-20251027-STATELESS5.P03
+ * @requirement REQ-STAT5-003.1
+ * @pseudocode runtime-state.md lines 150-173
+ *
+ * Synchronous accessors for runtime state fields.
+ * STUB: Minimal implementations for type safety.
+ */
+export function getProvider(state) {
+    return state.provider;
+}
+export function getModel(state) {
+    return state.model;
+}
+export function getAuthType(state) {
+    return state.authType;
+}
+export function getAuthPayload(state) {
+    if (!state.authPayload) {
+        return undefined;
+    }
+    return Object.freeze({ ...state.authPayload });
+}
+export function getBaseUrl(state) {
+    return state.baseUrl;
+}
+export function getSessionId(state) {
+    return state.sessionId;
+}
+export function getModelParams(state) {
+    if (!state.modelParams) {
+        return undefined;
+    }
+    return Object.freeze({ ...state.modelParams });
+}
+//# sourceMappingURL=AgentRuntimeState.js.map

package/dist/src/runtime/AgentRuntimeState.js.map

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

package/dist/src/runtime/RuntimeInvocationContext.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * RuntimeInvocationContext captures immutable, per-call metadata that providers
+ * need to construct stateless requests without reading from Config directly.
+ *
+ * @plan PLAN-20251029-STATELESS8.P01
+ * @requirement REQ-STAT8-001
+ */
+import type { RedactionConfig } from '../config/config.js';
+import type { SettingsService } from '../settings/SettingsService.js';
+import type { ProviderTelemetryContext } from '../providers/types/providerRuntime.js';
+import type { ProviderRuntimeContext } from './providerRuntimeContext.js';
+export interface RuntimeInvocationContext {
+    /** Stable identifier for the invocation/runtime */
+    readonly runtimeId: string;
+    /** Immutable metadata merged from caller + provider manager layers */
+    readonly metadata: Readonly<Record<string, unknown>>;
+    /** Per-call settings service (stateless view) */
+    readonly settings: SettingsService;
+    /** Snapshot of global ephemeral overrides for this invocation */
+    readonly ephemerals: Readonly<Record<string, unknown>>;
+    /** Optional telemetry context derived during normalization */
+    readonly telemetry?: ProviderTelemetryContext;
+    /** Optional user memory snapshot for providers that need it */
+    readonly userMemory?: string;
+    /** Optional redaction configuration for logging/telemetry surfaces */
+    readonly redaction?: Readonly<RedactionConfig>;
+    /** Helper to read a strongly-typed ephemeral override */
+    getEphemeral<T = unknown>(key: string): T | undefined;
+    /** Helper to read nested provider-specific overrides (e.g. "openai") */
+    getProviderOverrides<T = Record<string, unknown>>(providerName: string): T | undefined;
+}
+export interface RuntimeInvocationContextInit {
+    runtime: ProviderRuntimeContext;
+    settings: SettingsService;
+    providerName: string;
+    telemetry?: ProviderTelemetryContext;
+    metadata?: Record<string, unknown>;
+    ephemeralsSnapshot?: Record<string, unknown>;
+    /** Optional snapshot of user memory for downstream prompt resolution */
+    userMemory?: string;
+    /** Optional redaction configuration override */
+    redaction?: RedactionConfig;
+    /** Optional fallback runtime id when runtime.runtimeId is missing */
+    fallbackRuntimeId?: string;
+}
+export declare function createRuntimeInvocationContext(init: RuntimeInvocationContextInit): RuntimeInvocationContext;

package/dist/src/runtime/RuntimeInvocationContext.js

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function cloneAndFreeze(value) {
+    if (!value) {
+        return undefined;
+    }
+    const clone = Object.assign({}, value);
+    return Object.freeze(clone);
+}
+export function createRuntimeInvocationContext(init) {
+    const runtimeId = typeof init.runtime.runtimeId === 'string' &&
+        init.runtime.runtimeId.trim() !== ''
+        ? init.runtime.runtimeId
+        : (init.fallbackRuntimeId ?? '');
+    if (!runtimeId) {
+        throw new Error('RuntimeInvocationContext requires a non-empty runtimeId.');
+    }
+    const mergedMetadata = Object.freeze({
+        ...(init.runtime.metadata ?? {}),
+        ...(init.metadata ?? {}),
+    });
+    if (init.ephemeralsSnapshot === undefined) {
+        throw new Error(`RuntimeInvocationContext requires provider ephemerals for provider "${init.providerName}".`);
+    }
+    const ephemerals = Object.freeze({ ...init.ephemeralsSnapshot });
+    const redaction = cloneAndFreeze(init.redaction) ?? undefined;
+    const userMemory = init.userMemory;
+    const context = {
+        runtimeId,
+        metadata: mergedMetadata,
+        settings: init.settings,
+        ephemerals,
+        telemetry: init.telemetry,
+        userMemory,
+        redaction,
+        getEphemeral(key) {
+            return ephemerals[key];
+        },
+        getProviderOverrides(providerName) {
+            const raw = ephemerals[providerName];
+            if (!raw || typeof raw !== 'object') {
+                return undefined;
+            }
+            return raw;
+        },
+    };
+    return Object.freeze(context);
+}
+//# sourceMappingURL=RuntimeInvocationContext.js.map

package/dist/src/runtime/RuntimeInvocationContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimeInvocationContext.js","sourceRoot":"","sources":["../../../src/runtime/RuntimeInvocationContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqDH,SAAS,cAAc,CACrB,KAAoB;IAEpB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAM,CAAC;IAC5C,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAgB,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,IAAkC;IAElC,MAAM,SAAS,GACb,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,KAAK,QAAQ;QAC1C,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE;QAClC,CAAC,CAAE,IAAI,CAAC,OAAO,CAAC,SAAoB;QACpC,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IAErC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;QACnC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;QAChC,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;KACzB,CAAC,CAAC;IAEH,IAAI,IAAI,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,uEAAuE,IAAI,CAAC,YAAY,IAAI,CAC7F,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAEjE,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC;IAE9D,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IAEnC,MAAM,OAAO,GAA6B;QACxC,SAAS;QACT,QAAQ,EAAE,cAAc;QACxB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,UAAU;QACV,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,UAAU;QACV,SAAS;QACT,YAAY,CAAc,GAAW;YACnC,OAAO,UAAU,CAAC,GAAG,CAAkB,CAAC;QAC1C,CAAC;QACD,oBAAoB,CAClB,YAAoB;YAEpB,MAAM,GAAG,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;YACrC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;gBACpC,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,OAAO,GAAQ,CAAC;QAClB,CAAC;KACF,CAAC;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC"}

package/dist/src/runtime/createAgentRuntimeContext.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AgentRuntimeContext, AgentRuntimeContextFactoryOptions } from './AgentRuntimeContext.js';
+export declare function createAgentRuntimeContext(options: AgentRuntimeContextFactoryOptions): AgentRuntimeContext;

package/dist/src/runtime/createAgentRuntimeContext.js

@@ -0,0 +1,58 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @plan PLAN-20251028-STATELESS6.P06
+ * @requirement REQ-STAT6-001.1, REQ-STAT6-001.3, REQ-STAT6-002.2, REQ-STAT6-002.3
+ * @pseudocode agent-runtime-context.md lines 64-81
+ *
+ * Factory for creating immutable agent runtime contexts.
+ */
+import { HistoryService } from '../services/history/HistoryService.js';
+const EPHEMERAL_DEFAULTS = {
+    compressionThreshold: 0.8,
+    contextLimit: 60_000,
+    preserveThreshold: 0.2,
+};
+export function createAgentRuntimeContext(options) {
+    if (!options.provider) {
+        throw new Error('AgentRuntimeContext requires a provider adapter. Supply options.provider.');
+    }
+    if (!options.telemetry) {
+        throw new Error('AgentRuntimeContext requires a telemetry adapter. Supply options.telemetry.');
+    }
+    if (!options.tools) {
+        throw new Error('AgentRuntimeContext requires a tools view. Supply options.tools.');
+    }
+    if (!options.providerRuntime) {
+        throw new Error('AgentRuntimeContext requires a provider runtime context. Supply options.providerRuntime.');
+    }
+    const history = options.history ?? new HistoryService();
+    const ephemerals = {
+        compressionThreshold: () => options.settings.compressionThreshold ??
+            EPHEMERAL_DEFAULTS.compressionThreshold,
+        contextLimit: () => options.settings.contextLimit ?? EPHEMERAL_DEFAULTS.contextLimit,
+        preserveThreshold: () => options.settings.preserveThreshold ??
+            EPHEMERAL_DEFAULTS.preserveThreshold,
+        toolFormatOverride: () => options.settings.toolFormatOverride,
+    };
+    const providerRuntime = Object.freeze({
+        ...options.providerRuntime,
+        metadata: options.providerRuntime.metadata
+            ? Object.freeze({ ...options.providerRuntime.metadata })
+            : undefined,
+    });
+    const context = {
+        state: options.state,
+        history,
+        ephemerals,
+        telemetry: options.telemetry,
+        provider: options.provider,
+        tools: options.tools,
+        providerRuntime,
+    };
+    return Object.freeze(context);
+}
+//# sourceMappingURL=createAgentRuntimeContext.js.map

package/dist/src/runtime/createAgentRuntimeContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAgentRuntimeContext.js","sourceRoot":"","sources":["../../../src/runtime/createAgentRuntimeContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAOvE,MAAM,kBAAkB,GAAG;IACzB,oBAAoB,EAAE,GAAG;IACzB,YAAY,EAAE,MAAM;IACpB,iBAAiB,EAAE,GAAG;CACd,CAAC;AAEX,MAAM,UAAU,yBAAyB,CACvC,OAA0C;IAE1C,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,6EAA6E,CAC9E,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,kEAAkE,CACnE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,0FAA0F,CAC3F,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,cAAc,EAAE,CAAC;IAExD,MAAM,UAAU,GAAG;QACjB,oBAAoB,EAAE,GAAW,EAAE,CACjC,OAAO,CAAC,QAAQ,CAAC,oBAAoB;YACrC,kBAAkB,CAAC,oBAAoB;QACzC,YAAY,EAAE,GAAW,EAAE,CACzB,OAAO,CAAC,QAAQ,CAAC,YAAY,IAAI,kBAAkB,CAAC,YAAY;QAClE,iBAAiB,EAAE,GAAW,EAAE,CAC9B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;YAClC,kBAAkB,CAAC,iBAAiB;QACtC,kBAAkB,EAAE,GAAuB,EAAE,CAC3C,OAAO,CAAC,QAAQ,CAAC,kBAAkB;KACtC,CAAC;IAEF,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;QACpC,GAAG,OAAO,CAAC,eAAe;QAC1B,QAAQ,EAAE,OAAO,CAAC,eAAe,CAAC,QAAQ;YACxC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC;YACxD,CAAC,CAAC,SAAS;KACd,CAA2B,CAAC;IAE7B,MAAM,OAAO,GAAwB;QACnC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO;QACP,UAAU;QACV,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,eAAe;KAChB,CAAC;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC"}

package/dist/src/runtime/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @plan PLAN-20251027-STATELESS5.P03
+ *
+ * Runtime module exports.
+ */
+export * from './providerRuntimeContext.js';
+export * from './AgentRuntimeState.js';
+export * from './AgentRuntimeLoader.js';

package/dist/src/runtime/index.js

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @plan PLAN-20251027-STATELESS5.P03
+ *
+ * Runtime module exports.
+ */
+export * from './providerRuntimeContext.js';
+export * from './AgentRuntimeState.js';
+export * from './AgentRuntimeLoader.js';
+//# sourceMappingURL=index.js.map

package/dist/src/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AAEH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC"}