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

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

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @plan:PLAN-20250218-STATELESSPROVIDER.P03
+ * @requirement:REQ-SP-002.1
+ * Derived from pseudocode/provider-invocation.md:2 and pseudocode/cli-runtime.md:5.
+ */
+import { SettingsService } from '../settings/SettingsService.js';
+import type { Config } from '../config/config.js';
+export interface ProviderRuntimeContext {
+    settingsService: SettingsService;
+    config?: Config;
+    runtimeId?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ProviderRuntimeContextInit {
+    settingsService?: SettingsService;
+    config?: Config;
+    runtimeId?: string;
+    metadata?: Record<string, unknown>;
+}
+export declare function createProviderRuntimeContext(init?: ProviderRuntimeContextInit): ProviderRuntimeContext;
+export declare function setActiveProviderRuntimeContext(context: ProviderRuntimeContext | null): void;
+export declare function clearActiveProviderRuntimeContext(): void;
+export declare function peekActiveProviderRuntimeContext(): ProviderRuntimeContext | null;
+export declare function getActiveProviderRuntimeContext(): ProviderRuntimeContext;
+export declare function setProviderRuntimeContextFallback(factory: (() => ProviderRuntimeContext) | null): void;

package/dist/src/runtime/providerRuntimeContext.js

@@ -0,0 +1,70 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @plan:PLAN-20250218-STATELESSPROVIDER.P03
+ * @requirement:REQ-SP-002.1
+ * Derived from pseudocode/provider-invocation.md:2 and pseudocode/cli-runtime.md:5.
+ */
+import { SettingsService } from '../settings/SettingsService.js';
+import { MissingProviderRuntimeError } from '../providers/errors.js';
+let activeContext = null;
+let fallbackFactory = null;
+export function createProviderRuntimeContext(init = {}) {
+    return {
+        settingsService: init.settingsService ?? new SettingsService(),
+        config: init.config,
+        runtimeId: init.runtimeId,
+        metadata: init.metadata,
+    };
+}
+export function setActiveProviderRuntimeContext(context) {
+    activeContext = context;
+}
+export function clearActiveProviderRuntimeContext() {
+    activeContext = null;
+}
+export function peekActiveProviderRuntimeContext() {
+    return activeContext;
+}
+export function getActiveProviderRuntimeContext() {
+    if (activeContext) {
+        return activeContext;
+    }
+    if (fallbackFactory) {
+        const fallbackContext = fallbackFactory();
+        if (!fallbackContext?.settingsService) {
+            throw new MissingProviderRuntimeError({
+                providerKey: 'provider-runtime',
+                missingFields: ['settings'],
+                requirement: 'REQ-SP4-004',
+                stage: 'fallbackFactory',
+                metadata: {
+                    hint: 'Fallback context must supply SettingsService.',
+                },
+                message: 'MissingProviderRuntimeError(provider-runtime): fallback context is missing SettingsService (REQ-SP4-004).',
+            });
+        }
+        activeContext = fallbackContext;
+        return fallbackContext;
+    }
+    throw new MissingProviderRuntimeError({
+        providerKey: 'provider-runtime',
+        missingFields: ['runtime registration'],
+        requirement: 'REQ-SP4-004',
+        stage: 'getActiveProviderRuntimeContext',
+        metadata: {
+            hint: 'Call activateIsolatedRuntimeContext() + registerCliProviderInfrastructure() before invoking providers or CLI helpers.',
+        },
+        message: 'MissingProviderRuntimeError(provider-runtime): runtime registration missing. Run activateIsolatedRuntimeContext() before invoking providers (REQ-SP4-004).',
+    });
+}
+export function setProviderRuntimeContextFallback(factory) {
+    fallbackFactory = factory;
+    if (!activeContext && fallbackFactory) {
+        activeContext = fallbackFactory();
+    }
+}
+//# sourceMappingURL=providerRuntimeContext.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"providerRuntimeContext.js","sourceRoot":"","sources":["../../../src/runtime/providerRuntimeContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AASrE,IAAI,aAAa,GAAkC,IAAI,CAAC;AACxD,IAAI,eAAe,GAA0C,IAAI,CAAC;AASlE,MAAM,UAAU,4BAA4B,CAC1C,OAAmC,EAAE;IAErC,OAAO;QACL,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,IAAI,eAAe,EAAE;QAC9D,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,OAAsC;IAEtC,aAAa,GAAG,OAAO,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,iCAAiC;IAC/C,aAAa,GAAG,IAAI,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,gCAAgC;IAC9C,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,+BAA+B;IAC7C,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,eAAe,GAAG,eAAe,EAAE,CAAC;QAC1C,IAAI,CAAC,eAAe,EAAE,eAAe,EAAE,CAAC;YACtC,MAAM,IAAI,2BAA2B,CAAC;gBACpC,WAAW,EAAE,kBAAkB;gBAC/B,aAAa,EAAE,CAAC,UAAU,CAAC;gBAC3B,WAAW,EAAE,aAAa;gBAC1B,KAAK,EAAE,iBAAiB;gBACxB,QAAQ,EAAE;oBACR,IAAI,EAAE,+CAA+C;iBACtD;gBACD,OAAO,EACL,2GAA2G;aAC9G,CAAC,CAAC;QACL,CAAC;QACD,aAAa,GAAG,eAAe,CAAC;QAChC,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,MAAM,IAAI,2BAA2B,CAAC;QACpC,WAAW,EAAE,kBAAkB;QAC/B,aAAa,EAAE,CAAC,sBAAsB,CAAC;QACvC,WAAW,EAAE,aAAa;QAC1B,KAAK,EAAE,iCAAiC;QACxC,QAAQ,EAAE;YACR,IAAI,EAAE,uHAAuH;SAC9H;QACD,OAAO,EACL,4JAA4J;KAC/J,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,OAA8C;IAE9C,eAAe,GAAG,OAAO,CAAC;IAC1B,IAAI,CAAC,aAAa,IAAI,eAAe,EAAE,CAAC;QACtC,aAAa,GAAG,eAAe,EAAE,CAAC;IACpC,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ProviderManager } from '../providers/ProviderManager.js';
+import type { IProviderManager } from '../providers/IProviderManager.js';
+import type { Config } from '../config/config.js';
+import type { ToolRegistry } from '../tools/tool-registry.js';
+import type { AgentRuntimeProviderAdapter, AgentRuntimeTelemetryAdapter, ToolRegistryView } from './AgentRuntimeContext.js';
+/**
+ * Creates a mutable provider adapter backed by a ProviderManager instance.
+ */
+export declare function createProviderAdapterFromManager(manager?: ProviderManager | IProviderManager): AgentRuntimeProviderAdapter;
+/**
+ * Creates a telemetry adapter that bridges to legacy Config-backed loggers.
+ */
+export declare function createTelemetryAdapterFromConfig(config: Config): AgentRuntimeTelemetryAdapter;
+/**
+ * Creates a ToolRegistryView from an optional ToolRegistry.
+ */
+export declare function createToolRegistryViewFromRegistry(registry?: ToolRegistry): ToolRegistryView;

package/dist/src/runtime/runtimeAdapters.js

@@ -0,0 +1,81 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { logApiRequest, logApiResponse, logApiError, } from '../telemetry/loggers.js';
+import { ApiRequestEvent as LegacyApiRequestEvent, ApiResponseEvent as LegacyApiResponseEvent, ApiErrorEvent as LegacyApiErrorEvent, } from '../telemetry/types.js';
+/**
+ * Creates a mutable provider adapter backed by a ProviderManager instance.
+ */
+export function createProviderAdapterFromManager(manager) {
+    if (!manager) {
+        return {
+            getActiveProvider: () => {
+                throw new Error('AgentRuntimeContext provider adapter requires a ProviderManager instance.');
+            },
+            setActiveProvider: () => {
+                throw new Error('AgentRuntimeContext provider adapter requires a ProviderManager instance.');
+            },
+        };
+    }
+    return {
+        getActiveProvider: () => manager.getActiveProvider(),
+        setActiveProvider: (name) => manager.setActiveProvider(name),
+    };
+}
+/**
+ * Creates a telemetry adapter that bridges to legacy Config-backed loggers.
+ */
+export function createTelemetryAdapterFromConfig(config) {
+    return {
+        logApiRequest: (event) => {
+            const legacy = new LegacyApiRequestEvent(event.model, event.promptId ?? event.runtimeId ?? 'runtime', event.requestText);
+            logApiRequest(config, legacy);
+        },
+        logApiResponse: (event) => {
+            const legacy = new LegacyApiResponseEvent(event.model, event.durationMs, event.promptId ?? event.runtimeId ?? 'runtime', event.authType, event.usageMetadata, event.responseText, event.error);
+            logApiResponse(config, legacy);
+        },
+        logApiError: (event) => {
+            const legacy = new LegacyApiErrorEvent(event.model, event.error, event.durationMs, event.promptId ?? event.runtimeId ?? 'runtime', event.authType, event.errorType, event.statusCode);
+            logApiError(config, legacy);
+        },
+    };
+}
+/**
+ * Creates a ToolRegistryView from an optional ToolRegistry.
+ */
+export function createToolRegistryViewFromRegistry(registry) {
+    if (!registry) {
+        return {
+            listToolNames: () => [],
+            getToolMetadata: () => undefined,
+        };
+    }
+    return {
+        listToolNames: () => registry.getAllToolNames(),
+        getToolMetadata: (name) => {
+            const tool = registry.getTool(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,
+            };
+        },
+    };
+}
+//# sourceMappingURL=runtimeAdapters.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AgentRuntimeState, RuntimeStateParams } from './AgentRuntimeState.js';
+import type { Config } from '../config/config.js';
+/**
+ * Options when deriving runtime state from Config.
+ */
+export interface RuntimeStateFromConfigOptions {
+    runtimeId?: string;
+    overrides?: Partial<Omit<RuntimeStateParams, 'runtimeId'>>;
+}
+/**
+ * Creates an AgentRuntimeState using the current Config snapshot.
+ *
+ * This is a migration helper: it reads legacy Config data once, converts it to
+ * runtime state, and returns an immutable snapshot for stateless operation.
+ */
+export declare function createAgentRuntimeStateFromConfig(config: Config, options?: RuntimeStateFromConfigOptions): AgentRuntimeState;

package/dist/src/runtime/runtimeStateFactory.js

@@ -0,0 +1,104 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @plan PLAN-20251027-STATELESS5.P05
+ * @requirement REQ-STAT5-002.3
+ * @pseudocode runtime-state.md lines 114-138
+ *
+ * Helper functions for constructing AgentRuntimeState instances from legacy
+ * Config objects during the Phase 5 migration period.
+ */
+import { createAgentRuntimeState } from './AgentRuntimeState.js';
+import { DEFAULT_GEMINI_MODEL } from '../config/models.js';
+import { AuthType, } from '../core/contentGenerator.js';
+function buildAuthPayload(authType, contentConfig) {
+    if (!contentConfig) {
+        return undefined;
+    }
+    if (authType === AuthType.API_KEY || authType === AuthType.USE_GEMINI) {
+        if (contentConfig.apiKey) {
+            return { apiKey: contentConfig.apiKey };
+        }
+    }
+    // OAuth tokens are managed elsewhere; Phase 5 runtime state stores the type.
+    return undefined;
+}
+function isValidUrl(candidate) {
+    if (typeof candidate !== 'string') {
+        return false;
+    }
+    try {
+        new URL(candidate);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function resolveRuntimeId(config, explicitId) {
+    if (explicitId) {
+        return explicitId;
+    }
+    if (typeof config.getSessionId === 'function') {
+        const sessionId = config.getSessionId();
+        if (sessionId) {
+            return sessionId;
+        }
+    }
+    return `runtime-${Date.now().toString(36)}-${Math.random()
+        .toString(36)
+        .slice(2, 8)}`;
+}
+/**
+ * Creates an AgentRuntimeState using the current Config snapshot.
+ *
+ * This is a migration helper: it reads legacy Config data once, converts it to
+ * runtime state, and returns an immutable snapshot for stateless operation.
+ */
+export function createAgentRuntimeStateFromConfig(config, options = {}) {
+    const contentConfig = typeof config.getContentGeneratorConfig === 'function'
+        ? config.getContentGeneratorConfig()
+        : undefined;
+    const overrides = options.overrides ?? {};
+    const provider = overrides.provider ??
+        (typeof config.getProvider === 'function'
+            ? (config.getProvider() ?? undefined)
+            : undefined) ??
+        'gemini';
+    const model = overrides.model ??
+        contentConfig?.model ??
+        (typeof config.getModel === 'function'
+            ? (config.getModel() ?? undefined)
+            : undefined) ??
+        DEFAULT_GEMINI_MODEL;
+    const authType = overrides.authType ?? contentConfig?.authType ?? AuthType.USE_NONE;
+    const authPayload = overrides.authPayload ?? buildAuthPayload(authType, contentConfig);
+    const baseUrlCandidate = overrides.baseUrl ??
+        (typeof config.getEphemeralSetting === 'function'
+            ? config.getEphemeralSetting('base-url')
+            : undefined);
+    const baseUrl = isValidUrl(baseUrlCandidate) ? baseUrlCandidate : undefined;
+    const proxyUrl = overrides.proxyUrl ??
+        (typeof config.getProxy === 'function' ? config.getProxy() : undefined);
+    const modelParams = overrides.modelParams;
+    const sessionId = overrides.sessionId ??
+        (typeof config.getSessionId === 'function'
+            ? config.getSessionId()
+            : undefined);
+    const runtimeId = resolveRuntimeId(config, options.runtimeId);
+    return createAgentRuntimeState({
+        runtimeId,
+        provider,
+        model,
+        authType,
+        authPayload,
+        baseUrl,
+        proxyUrl,
+        modelParams,
+        sessionId,
+    });
+}
+//# sourceMappingURL=runtimeStateFactory.js.map

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

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

package/dist/src/services/todo-context-tracker.d.ts

@@ -3,29 +3,31 @@
  * Copyright 2025 Vybestack LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-/**
- * Service to track which todo item is currently active in a session.
- * This allows associating tool calls with the active todo.
- */
 export declare class TodoContextTracker {
     private readonly _sessionId;
+    private readonly _agentId;
     private static instances;
     private activeTodoId;
     private constructor();
     /**
-     * Get or create a tracker instance for a session
+     * Get or create a tracker instance for a session/agent combination.
+     */
+    static forAgent(sessionId: string, agentId?: string): TodoContextTracker;
+    /**
+     * Get or create a tracker instance for a session in the default agent scope.
+     * This preserves backward compatibility with existing callers.
      */
     static forSession(sessionId: string): TodoContextTracker;
     /**
-     * Set the active todo for this session
+     * Set the active todo for this session/agent scope.
      */
     setActiveTodo(todoId: string | null): void;
     /**
-     * Get the active todo ID for this session
+     * Get the active todo ID for this session/agent scope.
      */
     getActiveTodoId(): string | null;
     /**
-     * Clear the active todo for this session
+     * Clear the active todo for this session/agent scope.
      */
     clearActiveTodo(): void;
 }

package/dist/src/services/todo-context-tracker.js

@@ -4,41 +4,57 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 /**
- * Service to track which todo item is currently active in a session.
+ * Service to track which todo item is currently active in a session and agent scope.
  * This allows associating tool calls with the active todo.
  */
+import { DEFAULT_AGENT_ID } from '../core/turn.js';
 export class TodoContextTracker {
     _sessionId;
+    _agentId;
     static instances = new Map();
     activeTodoId = null;
-    constructor(_sessionId) {
+    constructor(_sessionId, _agentId) {
         this._sessionId = _sessionId;
-        // Session ID reserved for future session-specific functionality
+        this._agentId = _agentId;
+        // Session and agent IDs reserved for future scope-specific functionality
         void this._sessionId;
+        void this._agentId;
     }
     /**
-     * Get or create a tracker instance for a session
+     * Get or create a tracker instance for a session/agent combination.
      */
-    static forSession(sessionId) {
+    static forAgent(sessionId, agentId) {
+        const scopedAgentId = agentId ?? DEFAULT_AGENT_ID;
         if (!this.instances.has(sessionId)) {
-            this.instances.set(sessionId, new TodoContextTracker(sessionId));
+            this.instances.set(sessionId, new Map());
+        }
+        const agentMap = this.instances.get(sessionId);
+        if (!agentMap.has(scopedAgentId)) {
+            agentMap.set(scopedAgentId, new TodoContextTracker(sessionId, scopedAgentId));
         }
-        return this.instances.get(sessionId);
+        return agentMap.get(scopedAgentId);
+    }
+    /**
+     * Get or create a tracker instance for a session in the default agent scope.
+     * This preserves backward compatibility with existing callers.
+     */
+    static forSession(sessionId) {
+        return this.forAgent(sessionId, DEFAULT_AGENT_ID);
     }
     /**
-     * Set the active todo for this session
+     * Set the active todo for this session/agent scope.
      */
     setActiveTodo(todoId) {
         this.activeTodoId = todoId;
     }
     /**
-     * Get the active todo ID for this session
+     * Get the active todo ID for this session/agent scope.
      */
     getActiveTodoId() {
         return this.activeTodoId;
     }
     /**
-     * Clear the active todo for this session
+     * Clear the active todo for this session/agent scope.
      */
     clearActiveTodo() {
         this.activeTodoId = null;

package/dist/src/services/todo-context-tracker.js.map

@@ -1 +1 @@
-{"version":3,"file":"todo-context-tracker.js","sourceRoot":"","sources":["../../../src/services/todo-context-tracker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAKQ;IAJ7B,MAAM,CAAC,SAAS,GAAG,IAAI,GAAG,EAA8B,CAAC;IAEzD,YAAY,GAAkB,IAAI,CAAC;IAE3C,YAAqC,UAAkB;QAAlB,eAAU,GAAV,UAAU,CAAQ;QACrD,gEAAgE;QAChE,KAAK,IAAI,CAAC,UAAU,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,SAAiB;QACjC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,MAAqB;QACjC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,eAAe;QACb,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC"}
+{"version":3,"file":"todo-context-tracker.js","sourceRoot":"","sources":["../../../src/services/todo-context-tracker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,OAAO,kBAAkB;IAMV;IACA;IANX,MAAM,CAAC,SAAS,GAAG,IAAI,GAAG,EAA2C,CAAC;IAEtE,YAAY,GAAkB,IAAI,CAAC;IAE3C,YACmB,UAAkB,EAClB,QAAgB;QADhB,eAAU,GAAV,UAAU,CAAQ;QAClB,aAAQ,GAAR,QAAQ,CAAQ;QAEjC,yEAAyE;QACzE,KAAK,IAAI,CAAC,UAAU,CAAC;QACrB,KAAK,IAAI,CAAC,QAAQ,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,SAAiB,EAAE,OAAgB;QACjD,MAAM,aAAa,GAAG,OAAO,IAAI,gBAAgB,CAAC;QAElD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;QAEhD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;YACjC,QAAQ,CAAC,GAAG,CACV,aAAa,EACb,IAAI,kBAAkB,CAAC,SAAS,EAAE,aAAa,CAAC,CACjD,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAE,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,SAAiB;QACjC,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,MAAqB;QACjC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,eAAe;QACb,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC"}

package/dist/src/services/tool-call-tracker-service.d.ts

@@ -15,31 +15,31 @@ export declare class ToolCallTrackerService {
     /**
      * Starts tracking an executing tool call
      */
-    static startTrackingToolCall(sessionId: string, toolName: string, parameters: Record<string, unknown>): string | null;
+    static startTrackingToolCall(sessionId: string, toolName: string, parameters: Record<string, unknown>, agentId?: string): string | null;
     /**
      * Marks a tool call as completed and moves it to the completed array
      */
-    static completeToolCallTracking(sessionId: string, toolCallId: string): Promise<void>;
+    static completeToolCallTracking(sessionId: string, toolCallId: string, agentId?: string): Promise<void>;
     /**
      * Marks a tool call as failed
      */
-    static failToolCallTracking(sessionId: string, toolCallId: string): void;
+    static failToolCallTracking(sessionId: string, toolCallId: string, agentId?: string): void;
     /**
      * Gets all tool calls (executing and completed) for a specific todo
      */
-    static getAllToolCalls(sessionId: string, todoId: string): TodoToolCall[];
+    static getAllToolCalls(sessionId: string, todoId: string, agentId?: string): TodoToolCall[];
     /**
      * Subscribes to tool call updates
      */
-    static subscribeToUpdates(sessionId: string, callback: () => void): () => void;
+    static subscribeToUpdates(sessionId: string, callback: () => void, agentId?: string): () => void;
     /**
      * Gets all tool calls for testing and debugging purposes
      */
-    static getAllToolCallsForSession(sessionId: string): Map<string, TodoToolCalls>;
+    static getAllToolCallsForSession(sessionId: string, agentId?: string): Map<string, TodoToolCalls>;
     /**
      * Clears all tool calls for a session (for testing purposes)
      */
-    static clearToolCallsForSession(sessionId: string): void;
+    static clearToolCallsForSession(sessionId: string, agentId?: string): void;
     /**
      * Generates a unique ID for tool calls
      */
@@ -48,5 +48,9 @@ export declare class ToolCallTrackerService {
      * Notifies all subscribers of updates
      */
     private static notifySubscribers;
+    /**
+     * Resolve an agent identifier, defaulting when missing.
+     */
+    private static getScopedAgentId;
 }
 export {};