@vybestack/llxprt-code-core 0.4.8 → 0.5.0-nightly.251102.6bb3db7a

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

@@ -0,0 +1,213 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @plan PLAN-20251028-STATELESS6.P06
+ * @requirement REQ-STAT6-001.1, REQ-STAT6-002.2
+ * @pseudocode agent-runtime-context.md lines 5-17
+ *
+ * Immutable snapshot of ephemeral settings for agent runtime.
+ * These settings can change frequently and are not part of core runtime state.
+ */
+export interface ReadonlySettingsSnapshot {
+    /** Compression threshold for history (0.0-1.0), default 0.8 */
+    compressionThreshold?: number;
+    /** Context window limit in tokens (provider default when unspecified) */
+    contextLimit?: number;
+    /** Preserve threshold for compression (0.0-1.0), default 0.2 */
+    preserveThreshold?: number;
+    /** Override for tool format string, optional */
+    toolFormatOverride?: string;
+    /** Telemetry configuration */
+    telemetry?: {
+        enabled: boolean;
+        target: TelemetryTarget | null;
+        redaction?: TelemetryRedactionConfig;
+    };
+    /** Tool governance derived from profile ephemerals */
+    tools?: {
+        allowed?: string[];
+        disabled?: string[];
+    };
+}
+/**
+ * @plan PLAN-20251028-STATELESS6.P06
+ * @requirement REQ-STAT6-002.3
+ *
+ * Redaction configuration for telemetry data.
+ */
+export interface TelemetryRedactionConfig {
+    redactPrompts?: boolean;
+    redactToolParams?: boolean;
+    redactToolResults?: boolean;
+}
+/**
+ * @plan PLAN-20251028-STATELESS6.P06
+ * @requirement REQ-STAT6-002.3
+ *
+ * Telemetry target enumeration.
+ */
+export declare enum TelemetryTarget {
+    GCP = "gcp",
+    LOCAL = "local"
+}
+/**
+ * @plan PLAN-20251028-STATELESS6.P06
+ * @requirement REQ-STAT6-001.1
+ * @pseudocode agent-runtime-context.md lines 20-26
+ *
+ * Read-only view of tool registry.
+ * Provides immutable access to tool metadata without exposing full registry.
+ */
+export interface ToolRegistryView {
+    /** List all registered tool names */
+    listToolNames(): string[];
+    /** Get metadata for a specific tool by name */
+    getToolMetadata(name: string): ToolMetadata | undefined;
+}
+/**
+ * @plan PLAN-20251028-STATELESS6.P06
+ * @requirement REQ-STAT6-001.1
+ *
+ * Tool metadata interface.
+ */
+export interface ToolMetadata {
+    name: string;
+    description: string;
+    parameterSchema?: Record<string, unknown>;
+}
+/**
+ * @plan PLAN-20251028-STATELESS6.P06
+ * @requirement REQ-STAT6-002.3
+ *
+ * API request event metadata for telemetry.
+ */
+export interface ApiRequestEvent {
+    model: string;
+    promptId?: string;
+    requestText?: string;
+    sessionId?: string;
+    runtimeId?: string;
+    provider?: string;
+    authType?: string;
+    timestamp?: number;
+}
+/**
+ * @plan PLAN-20251028-STATELESS6.P06
+ * @requirement REQ-STAT6-002.3
+ *
+ * API response event metadata for telemetry.
+ */
+export interface ApiResponseEvent {
+    model: string;
+    promptId?: string;
+    durationMs: number;
+    authType?: string;
+    sessionId?: string;
+    runtimeId?: string;
+    provider?: string;
+    timestamp?: number;
+    usageMetadata?: GenerateContentResponseUsageMetadata;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+    };
+    responseText?: string;
+    error?: string;
+}
+/**
+ * @plan PLAN-20251028-STATELESS6.P06
+ * @requirement REQ-STAT6-002.3
+ *
+ * API error event metadata for telemetry.
+ */
+export interface ApiErrorEvent {
+    model: string;
+    promptId?: string;
+    durationMs: number;
+    error: string;
+    authType?: string;
+    errorType?: string;
+    statusCode?: number | string;
+    sessionId?: string;
+    runtimeId?: string;
+    provider?: string;
+    timestamp?: number;
+}
+/**
+ * @plan PLAN-20251028-STATELESS6.P06
+ * @requirement REQ-STAT6-001.2, REQ-STAT6-002.2, REQ-STAT6-002.3
+ * @pseudocode agent-runtime-context.md lines 28-49
+ *
+ * Immutable runtime context for agent execution.
+ * Provides all runtime data and adapters without Config dependency.
+ * All nested objects are frozen for deep immutability.
+ */
+export interface AgentRuntimeContext {
+    /** Immutable runtime state (provider, model, auth, session) */
+    readonly state: AgentRuntimeState;
+    /** Isolated history service instance */
+    readonly history: HistoryService;
+    /** Ephemeral settings with fallback defaults */
+    readonly ephemerals: {
+        compressionThreshold(): number;
+        contextLimit(): number;
+        preserveThreshold(): number;
+        toolFormatOverride(): string | undefined;
+    };
+    /** Telemetry logging adapter with metadata enrichment */
+    readonly telemetry: AgentRuntimeTelemetryAdapter;
+    /** Provider adapter (read-only or mutable based on context) */
+    readonly provider: AgentRuntimeProviderAdapter;
+    /** Tool registry read-only view */
+    readonly tools: ToolRegistryView;
+    /** Provider runtime snapshot for downstream provider calls */
+    readonly providerRuntime: ProviderRuntimeContext;
+}
+/**
+ * @plan PLAN-20251028-STATELESS6.P06
+ * @requirement REQ-STAT6-001.1
+ * @pseudocode agent-runtime-context.md lines 52-62
+ *
+ * Factory options for creating agent runtime contexts.
+ * Supports both foreground (Config-backed) and subagent (isolated) modes.
+ */
+export interface AgentRuntimeContextFactoryOptions {
+    /** Required: immutable runtime state */
+    state: AgentRuntimeState;
+    /** Required: snapshot of ephemeral settings */
+    settings: ReadonlySettingsSnapshot;
+    /** Required: provider adapter for active provider access */
+    provider: AgentRuntimeProviderAdapter;
+    /** Required: telemetry adapter */
+    telemetry: AgentRuntimeTelemetryAdapter;
+    /** Required: tools view */
+    tools: ToolRegistryView;
+    /** Optional: history service (creates isolated instance if not provided) */
+    history?: HistoryService;
+    /** Required: provider runtime context */
+    providerRuntime: ProviderRuntimeContext;
+}
+import type { AgentRuntimeState } from './AgentRuntimeState.js';
+import type { HistoryService } from '../services/history/HistoryService.js';
+import type { IProvider } from '../providers/IProvider.js';
+import type { GenerateContentResponseUsageMetadata } from '@google/genai';
+import type { ProviderRuntimeContext } from './providerRuntimeContext.js';
+/**
+ * Provider adapter interface supplied to runtime context.
+ */
+export interface AgentRuntimeProviderAdapter {
+    getActiveProvider(): IProvider;
+    setActiveProvider(name: string): void;
+}
+/**
+ * Telemetry adapter interface supplied to runtime context.
+ */
+export interface AgentRuntimeTelemetryAdapter {
+    logApiRequest(event: ApiRequestEvent): void;
+    logApiResponse(event: ApiResponseEvent): void;
+    logApiError(event: ApiErrorEvent): void;
+}

package/dist/src/runtime/AgentRuntimeContext.js

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @plan PLAN-20251028-STATELESS6.P06
+ * @requirement REQ-STAT6-002.3
+ *
+ * Telemetry target enumeration.
+ */
+export var TelemetryTarget;
+(function (TelemetryTarget) {
+    TelemetryTarget["GCP"] = "gcp";
+    TelemetryTarget["LOCAL"] = "local";
+})(TelemetryTarget || (TelemetryTarget = {}));
+//# sourceMappingURL=AgentRuntimeContext.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRuntimeContext.js","sourceRoot":"","sources":["../../../src/runtime/AgentRuntimeContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4CH;;;;;GAKG;AACH,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,8BAAW,CAAA;IACX,kCAAe,CAAA;AACjB,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B"}

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

@@ -0,0 +1,47 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { HistoryService } from '../services/history/HistoryService.js';
+import type { Config } from '../config/config.js';
+import type { ToolRegistry } from '../tools/tool-registry.js';
+import type { ProviderManager } from '../providers/ProviderManager.js';
+import type { IProviderManager } from '../providers/IProviderManager.js';
+import type { AgentRuntimeContext, AgentRuntimeProviderAdapter, AgentRuntimeTelemetryAdapter, ToolRegistryView, ReadonlySettingsSnapshot } from './AgentRuntimeContext.js';
+import type { AgentRuntimeState } from './AgentRuntimeState.js';
+import type { ProviderRuntimeContext } from './providerRuntimeContext.js';
+import { type ContentGenerator, type ContentGeneratorConfig } from '../core/contentGenerator.js';
+export interface AgentRuntimeProfileSnapshot {
+    config: Config;
+    state: AgentRuntimeState;
+    settings: ReadonlySettingsSnapshot;
+    providerRuntime: ProviderRuntimeContext;
+    contentGeneratorConfig?: ContentGeneratorConfig;
+    toolRegistry?: ToolRegistry;
+    providerManager?: ProviderManager | IProviderManager;
+}
+export interface AgentRuntimeLoaderOverrides {
+    providerAdapter?: AgentRuntimeProviderAdapter;
+    telemetryAdapter?: AgentRuntimeTelemetryAdapter;
+    toolsView?: ToolRegistryView;
+    historyService?: HistoryService;
+    contentGenerator?: ContentGenerator;
+    contentGeneratorFactory?: ContentGeneratorFactory;
+}
+export interface AgentRuntimeLoaderOptions {
+    profile: AgentRuntimeProfileSnapshot;
+    overrides?: AgentRuntimeLoaderOverrides;
+}
+export interface AgentRuntimeLoaderResult {
+    runtimeContext: AgentRuntimeContext;
+    history: HistoryService;
+    providerAdapter: AgentRuntimeProviderAdapter;
+    telemetryAdapter: AgentRuntimeTelemetryAdapter;
+    toolsView: ToolRegistryView;
+    contentGenerator: ContentGenerator;
+    toolRegistry?: ToolRegistry;
+    settingsSnapshot?: ReadonlySettingsSnapshot;
+}
+export type ContentGeneratorFactory = (config: ContentGeneratorConfig, context: Config, sessionId: string) => Promise<ContentGenerator>;
+export declare function loadAgentRuntime(options: AgentRuntimeLoaderOptions): Promise<AgentRuntimeLoaderResult>;

package/dist/src/runtime/AgentRuntimeLoader.js

@@ -0,0 +1,122 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { HistoryService } from '../services/history/HistoryService.js';
+import { createProviderAdapterFromManager, createTelemetryAdapterFromConfig, } from './runtimeAdapters.js';
+import { createAgentRuntimeContext } from './createAgentRuntimeContext.js';
+import { createContentGenerator, } from '../core/contentGenerator.js';
+const defaultContentGeneratorFactory = (contentConfig, config, sessionId) => createContentGenerator(contentConfig, config, sessionId);
+const normalizeToolName = (name) => name.trim().toLowerCase();
+function buildToolGovernance(profile) {
+    const allowedRaw = Array.isArray(profile.settings.tools?.allowed)
+        ? profile.settings.tools?.allowed
+        : undefined;
+    const disabledRaw = Array.isArray(profile.settings.tools?.disabled)
+        ? profile.settings.tools?.disabled
+        : undefined;
+    const excludedRaw = profile.config.getExcludeTools?.() ?? [];
+    return {
+        allowed: new Set((allowedRaw ?? []).map((tool) => normalizeToolName(tool))),
+        disabled: new Set((disabledRaw ?? []).map((tool) => normalizeToolName(tool))),
+        excluded: new Set(excludedRaw.map((tool) => normalizeToolName(tool))),
+    };
+}
+function isToolPermitted(toolName, governance) {
+    const canonical = normalizeToolName(toolName);
+    if (governance.excluded.has(canonical)) {
+        return false;
+    }
+    if (governance.disabled.has(canonical)) {
+        return false;
+    }
+    if (governance.allowed.size > 0 && !governance.allowed.has(canonical)) {
+        return false;
+    }
+    return true;
+}
+function createFilteredToolRegistryView(registry, governance) {
+    if (!registry) {
+        return {
+            listToolNames: () => [],
+            getToolMetadata: () => undefined,
+        };
+    }
+    const getTools = () => registry.getAllTools();
+    return {
+        listToolNames: () => getTools()
+            .filter((tool) => isToolPermitted(tool.name, governance))
+            .map((tool) => tool.name),
+        getToolMetadata: (name) => {
+            if (!isToolPermitted(name, governance)) {
+                return undefined;
+            }
+            const tool = getTools().find((candidate) => candidate.name === name);
+            if (!tool) {
+                return undefined;
+            }
+            const schema = tool
+                .schema;
+            const description = typeof schema?.description === 'string'
+                ? schema.description
+                : typeof tool.description === 'string'
+                    ? tool.description
+                    : '';
+            const parameterSchema = schema?.parameters ??
+                schema
+                    ?.parametersJsonSchema;
+            return {
+                name: tool.name ?? name,
+                description,
+                parameterSchema,
+            };
+        },
+    };
+}
+export async function loadAgentRuntime(options) {
+    const { profile, overrides = {} } = options;
+    if (!profile) {
+        throw new Error('AgentRuntimeLoader requires a profile option.');
+    }
+    const history = overrides.historyService ?? new HistoryService();
+    const providerAdapter = overrides.providerAdapter ??
+        createProviderAdapterFromManager(profile.providerManager ?? profile.config.getProviderManager?.());
+    const telemetryAdapter = overrides.telemetryAdapter ??
+        createTelemetryAdapterFromConfig(profile.config);
+    const governance = buildToolGovernance(profile);
+    const toolsView = overrides.toolsView ??
+        createFilteredToolRegistryView(profile.toolRegistry ?? profile.config.getToolRegistry?.(), governance);
+    const runtimeContext = createAgentRuntimeContext({
+        state: profile.state,
+        settings: profile.settings,
+        provider: providerAdapter,
+        telemetry: telemetryAdapter,
+        tools: toolsView,
+        history,
+        providerRuntime: profile.providerRuntime,
+    });
+    let contentGenerator;
+    if (overrides.contentGenerator) {
+        contentGenerator = overrides.contentGenerator;
+    }
+    else {
+        const contentConfig = profile.contentGeneratorConfig;
+        if (!contentConfig) {
+            throw new Error('AgentRuntimeLoader requires contentGeneratorConfig when no contentGenerator override is supplied.');
+        }
+        const factory = overrides.contentGeneratorFactory ?? defaultContentGeneratorFactory;
+        contentGenerator = await factory(contentConfig, profile.config, profile.state.sessionId);
+    }
+    return {
+        runtimeContext,
+        history,
+        providerAdapter,
+        telemetryAdapter,
+        toolsView,
+        contentGenerator,
+        toolRegistry: profile.toolRegistry,
+        settingsSnapshot: profile.settings,
+    };
+}
+//# sourceMappingURL=AgentRuntimeLoader.js.map

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

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

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

@@ -0,0 +1,232 @@
+/**
+ * @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 18-48
+ *
+ * Core runtime state interface representing provider/model/auth configuration.
+ */
+export interface AgentRuntimeState {
+    readonly runtimeId: string;
+    readonly provider: string;
+    readonly model: string;
+    readonly authType: AuthType;
+    readonly authPayload?: AuthPayload;
+    readonly baseUrl?: string;
+    readonly proxyUrl?: string;
+    readonly modelParams?: ModelParams;
+    readonly sessionId: string;
+    readonly updatedAt: number;
+}
+/**
+ * @plan PLAN-20251027-STATELESS5.P03
+ * @requirement REQ-STAT5-001.1
+ *
+ * Auth payload union type for different authentication mechanisms.
+ */
+export interface AuthPayload {
+    apiKey?: string;
+    token?: string;
+    [key: string]: unknown;
+}
+/**
+ * @plan PLAN-20251027-STATELESS5.P03
+ * @requirement REQ-STAT5-001.1
+ *
+ * Model parameters for generation configuration.
+ */
+export interface ModelParams {
+    temperature?: number;
+    topP?: number;
+    maxTokens?: number;
+    [key: string]: unknown;
+}
+/**
+ * @plan PLAN-20251027-STATELESS5.P03
+ * @requirement REQ-STAT5-001.1
+ * @pseudocode runtime-state.md lines 73-105
+ *
+ * Parameters for creating a new runtime state instance.
+ */
+export interface RuntimeStateParams {
+    runtimeId: string;
+    provider: string;
+    model: string;
+    authType: AuthType;
+    authPayload?: AuthPayload;
+    baseUrl?: string;
+    proxyUrl?: string;
+    modelParams?: ModelParams;
+    sessionId?: string;
+}
+/**
+ * @plan PLAN-20251027-STATELESS5.P03
+ * @requirement REQ-STAT5-001.3
+ * @pseudocode runtime-state.md lines 329-355
+ *
+ * Serializable snapshot of runtime state for diagnostics.
+ */
+export interface RuntimeStateSnapshot {
+    runtimeId: string;
+    provider: string;
+    model: string;
+    authType: AuthType;
+    authPayload?: SanitizedAuthPayload;
+    baseUrl?: string;
+    proxyUrl?: string;
+    modelParams?: ModelParams;
+    sessionId: string;
+    updatedAt: number;
+    version: number;
+}
+/**
+ * @plan PLAN-20251027-STATELESS5.P03
+ * @requirement REQ-STAT5-001.3
+ *
+ * Sanitized auth payload with sensitive data redacted.
+ */
+export interface SanitizedAuthPayload {
+    type?: string;
+    apiKey?: string;
+    token?: string;
+    [key: string]: unknown;
+}
+/**
+ * @plan PLAN-20251027-STATELESS5.P03
+ * @requirement REQ-STAT5-001.2
+ * @pseudocode runtime-state.md lines 209-243
+ *
+ * Event payload emitted when runtime state changes.
+ */
+export interface RuntimeStateChangedEvent {
+    runtimeId: string;
+    changes: Record<string, {
+        old: unknown;
+        new: unknown;
+    }>;
+    snapshot: RuntimeStateSnapshot;
+    timestamp: number;
+}
+/**
+ * @plan PLAN-20251027-STATELESS5.P03
+ * @requirement REQ-STAT5-003.2
+ * @pseudocode runtime-state.md lines 289-318
+ *
+ * Callback for runtime state change events.
+ */
+export type RuntimeStateChangeCallback = (event: RuntimeStateChangedEvent) => void;
+/**
+ * @plan PLAN-20251027-STATELESS5.P03
+ * @requirement REQ-STAT5-003.2
+ *
+ * Function to unsubscribe from runtime state changes.
+ */
+export type UnsubscribeFunction = () => void;
+/**
+ * @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 declare enum RuntimeStateErrorCode {
+    RUNTIME_ID_MISSING = "runtimeId.missing",
+    PROVIDER_MISSING = "provider.missing",
+    PROVIDER_INVALID = "provider.invalid",
+    MODEL_MISSING = "model.missing",
+    MODEL_INVALID = "model.invalid",
+    AUTH_TYPE_INVALID = "authType.invalid",
+    AUTH_API_KEY_MISSING = "auth.apiKey.missing",
+    AUTH_TOKEN_MISSING = "auth.token.missing",
+    BASE_URL_INVALID = "baseUrl.invalid",
+    UPDATE_UNSUPPORTED = "update.unsupported",
+    NOT_IMPLEMENTED = "not.implemented"
+}
+/**
+ * @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 declare class RuntimeStateError extends Error {
+    readonly code: RuntimeStateErrorCode;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(code: RuntimeStateErrorCode, details?: Record<string, unknown> | undefined);
+}
+/**
+ * @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 declare function createAgentRuntimeState(params: RuntimeStateParams): AgentRuntimeState;
+/**
+ * @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 declare function updateAgentRuntimeState(oldState: AgentRuntimeState, updates: Partial<RuntimeStateParams>): AgentRuntimeState;
+/**
+ * @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 declare function updateAgentRuntimeStateBatch(oldState: AgentRuntimeState, updates: Partial<RuntimeStateParams>): AgentRuntimeState;
+/**
+ * @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 declare function getAgentRuntimeStateSnapshot(state: AgentRuntimeState): RuntimeStateSnapshot;
+/**
+ * @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 declare function subscribeToAgentRuntimeState(runtimeId: string, callback: RuntimeStateChangeCallback, options?: {
+    async: boolean;
+}): UnsubscribeFunction;
+/**
+ * @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 declare function getProvider(state: AgentRuntimeState): string;
+export declare function getModel(state: AgentRuntimeState): string;
+export declare function getAuthType(state: AgentRuntimeState): AuthType;
+export declare function getAuthPayload(state: AgentRuntimeState): Readonly<AuthPayload> | undefined;
+export declare function getBaseUrl(state: AgentRuntimeState): string | undefined;
+export declare function getSessionId(state: AgentRuntimeState): string;
+export declare function getModelParams(state: AgentRuntimeState): Readonly<ModelParams> | undefined;