@1mcp/agent 0.35.0-beta.4 → 0.36.0

package/build/domains/admin/adminInstructionPreviewRuntime.js

@@ -0,0 +1,154 @@
+import { randomUUID } from 'node:crypto';
+import { ConfigManager } from '../../config/configManager.js';
+import { FilteringService } from '../../core/filtering/filteringService.js';
+import { createConnectionResolver } from '../../core/server/connectionResolver.js';
+import { prepareRequestContext } from '../../core/server/requestContextPreparation.js';
+import { ClientStatus } from '../../core/types/index.js';
+import { TagQueryParser } from '../../domains/preset/parsers/tagQueryParser.js';
+import { createRequestContextPreparationDependencies } from '../../transport/http/routes/inspectRequestContext.js';
+import { deriveContextSessionId } from '../../transport/http/utils/contextExtractor.js';
+import { normalizeTag } from '../../utils/validation/sanitization.js';
+export function createAdminInstructionPreviewRuntime(serverManager, presetManager, authorizeContext) {
+    return async (input) => {
+        const aggregator = serverManager.getInstructionAggregator();
+        if (!aggregator) {
+            return {
+                surface: input.surface === 'initialization' ? 'initialize' : 'cli',
+                validation: {
+                    valid: false,
+                    code: 'runtime_instructions_unavailable',
+                    message: 'Runtime instructions are unavailable',
+                },
+                effectiveServers: [],
+                unresolvedTemplates: [],
+            };
+        }
+        let preparedSessionId;
+        try {
+            const filterConfig = toFilterConfig(input, presetManager);
+            if (!filterConfig) {
+                return invalidPreview(input, 'preset_not_found', 'The selected preset does not exist');
+            }
+            const declared = ConfigManager.getInstance().loadDeclaredServerConfigs();
+            if (input.requestContext) {
+                const rawContext = {
+                    ...input.requestContext,
+                    sessionId: `admin-preview-${randomUUID()}`,
+                };
+                const context = authorizeContext?.(rawContext);
+                if (!context) {
+                    return invalidPreview(input, 'request_context_untrusted', 'Request context could not be authorized');
+                }
+                preparedSessionId = deriveContextSessionId(context);
+                await prepareRequestContext({
+                    deps: createRequestContextPreparationDependencies(serverManager),
+                    context,
+                    filterConfig,
+                });
+            }
+            const sessionConnections = createConnectionResolver(serverManager.getClients(), serverManager.getTemplateServerManager()).filterForSession(preparedSessionId);
+            const filtered = FilteringService.getFilteredConnections(sessionConnections, filterConfig);
+            const representedTemplateNames = new Set(Array.from(filtered.entries())
+                .filter(([key, connection]) => key !== connection.name || key.startsWith(`${connection.name}:`))
+                .map(([, connection]) => connection.name));
+            try {
+                const previewConnections = new Map(filtered);
+                for (const [name, config] of Object.entries(declared.staticServers)) {
+                    if (previewConnections.has(name) || !matchesFilter(config.tags, filterConfig))
+                        continue;
+                    previewConnections.set(name, asRenderableConnection(name, config.tags));
+                }
+                return {
+                    surface: input.surface === 'initialization' ? 'initialize' : 'cli',
+                    rendered: aggregator.previewInstructions(input.template, filterConfig, previewConnections),
+                    effectiveServers: Array.from(previewConnections.entries()).map(([key, connection]) => ({
+                        target: {
+                            source: key !== connection.name && key.startsWith(`${connection.name}:`) ? 'mcpTemplates' : 'mcpServers',
+                            name: connection.name,
+                        },
+                        hasInstructions: Boolean(aggregator.getEffectiveServerInstructions(key, connection.name)),
+                    })),
+                    unresolvedTemplates: Object.entries(declared.templateServers)
+                        .filter(([name, config]) => !representedTemplateNames.has(name) && matchesFilter(config.tags, filterConfig))
+                        .map(([name]) => name),
+                };
+            }
+            catch (_error) {
+                return {
+                    surface: input.surface === 'initialization' ? 'initialize' : 'cli',
+                    validation: {
+                        valid: false,
+                        code: 'instruction_template_render_failed',
+                        message: 'Template rendering failed',
+                    },
+                    effectiveServers: [],
+                    unresolvedTemplates: Object.entries(declared.templateServers)
+                        .filter(([, config]) => matchesFilter(config.tags, filterConfig))
+                        .map(([name]) => name),
+                };
+            }
+        }
+        catch {
+            return invalidPreview(input, 'instruction_preview_failed', 'Instruction preview preparation failed');
+        }
+        finally {
+            if (preparedSessionId) {
+                try {
+                    await serverManager
+                        .getTemplateServerManager()
+                        .cleanupTemplateServers(preparedSessionId, serverManager.getClients(), serverManager.getClientTransports());
+                }
+                catch (_error) {
+                    // Do not expose runtime paths or configuration details through cleanup failures.
+                }
+            }
+        }
+    };
+}
+function asRenderableConnection(name, tags) {
+    return {
+        name,
+        status: ClientStatus.Disconnected,
+        transport: { tags: tags ?? [] },
+        client: {},
+    };
+}
+function matchesFilter(tags, filterConfig) {
+    if (!filterConfig.tagFilterMode || filterConfig.tagFilterMode === 'none' || filterConfig.tagFilterMode === 'preset') {
+        return true;
+    }
+    if (filterConfig.tagFilterMode === 'advanced' && filterConfig.tagExpression) {
+        return TagQueryParser.evaluate(filterConfig.tagExpression, tags ?? []);
+    }
+    const requested = (filterConfig.tags ?? []).map(normalizeTag);
+    return requested.length === 0 || (tags ?? []).map(normalizeTag).some((tag) => requested.includes(tag));
+}
+function invalidPreview(input, code, message) {
+    return {
+        surface: input.surface === 'initialization' ? 'initialize' : 'cli',
+        validation: { valid: false, code, message },
+        effectiveServers: [],
+        unresolvedTemplates: [],
+    };
+}
+function toFilterConfig(input, presetManager) {
+    switch (input.selection.mode) {
+        case 'tags':
+            return { tagFilterMode: 'simple-or', tags: input.selection.tags };
+        case 'tag-filter':
+            return { tagFilterMode: 'advanced', tagExpression: TagQueryParser.parseAdvanced(input.selection.expression) };
+        case 'preset': {
+            const expression = presetManager?.resolvePresetToExpression(input.selection.preset);
+            return expression
+                ? {
+                    tagFilterMode: 'advanced',
+                    tagExpression: TagQueryParser.parseAdvanced(expression),
+                    presetName: input.selection.preset,
+                }
+                : undefined;
+        }
+        default:
+            return { tagFilterMode: 'none' };
+    }
+}
+//# sourceMappingURL=adminInstructionPreviewRuntime.js.map

package/build/domains/admin/adminInstructionPreviewRuntime.js.map

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

package/build/domains/admin/adminInstructionTemplateService.d.ts

@@ -0,0 +1,169 @@
+import type { InstructionSurface } from '../../core/instructions/instructionAggregator.js';
+import type { InstructionTemplateConfig } from '../../core/types/transport.js';
+import type { ConfiguredServerTargetSource } from '../../domains/config-change/configChange.js';
+import type { InstructionTemplateCollectionReadModel, InstructionTemplateManager, InstructionTemplateMutationResult, InstructionTemplateReadModel, InstructionTemplateValidation } from '../../domains/instruction-template/instructionTemplateManager.js';
+import type { ContextData } from '../../types/context.js';
+import type { AdminOperationContext, AdminOperationResult, AdminOperationService } from './adminOperationService.js';
+export type InstructionPreviewSelection = {
+    mode: 'all';
+} | {
+    mode: 'preset';
+    preset: string;
+} | {
+    mode: 'tags';
+    tags: string[];
+} | {
+    mode: 'tag-filter';
+    expression: string;
+};
+export type InstructionPreviewSurface = 'initialize' | 'cli';
+export interface AdminInstructionPreviewInput {
+    identity: string;
+    surface: InstructionSurface;
+    template: string;
+    selection: InstructionPreviewSelection;
+    requestContext?: ContextData;
+}
+export interface AdminInstructionPreviewServerFact {
+    target: {
+        source: ConfiguredServerTargetSource;
+        name: string;
+    };
+    hasInstructions: boolean;
+}
+export interface AdminInstructionPreviewResult {
+    surface: InstructionPreviewSurface;
+    rendered?: string;
+    validation?: {
+        valid: false;
+        code: string;
+        message: string;
+    };
+    effectiveServers: AdminInstructionPreviewServerFact[];
+    unresolvedTemplates: string[];
+}
+export interface SanitizedInstructionRenderFailure {
+    code: 'managed_template_render_failed';
+    surface: InstructionPreviewSurface;
+    templateIdentity: string;
+    occurredAt: string;
+}
+export interface RuntimeInstructionRenderFailure {
+    surface: InstructionSurface;
+    templateIdentity: string;
+    error: string;
+    occurredAt: Date;
+}
+export interface AdminInstructionTemplateOperations {
+    listTemplates(input: {
+        context: AdminOperationContext;
+    }): Promise<AdminOperationResult<InstructionTemplateAdminState>>;
+    getTemplate(input: {
+        context: AdminOperationContext;
+        identity: string;
+    }): Promise<AdminOperationResult<InstructionTemplateDetail>>;
+    createTemplate(input: TemplateSaveOperationInput): Promise<AdminOperationResult<InstructionTemplateMutationResult>>;
+    updateTemplate(input: TemplateSaveOperationInput): Promise<AdminOperationResult<InstructionTemplateMutationResult>>;
+    cloneTemplate(input: TemplateCloneOperationInput): Promise<AdminOperationResult<InstructionTemplateMutationResult>>;
+    validateTemplate(input: TemplateIdentityOperationInput): Promise<AdminOperationResult<TemplateValidationPreview>>;
+    previewTemplate(input: TemplatePreviewOperationInput): Promise<AdminOperationResult<AdminInstructionPreviewResult>>;
+    activateTemplate(input: TemplateIdentityOperationInput): Promise<AdminOperationResult<InstructionTemplateMutationResult>>;
+    importLegacyTemplate(input: TemplateIdentityOperationInput): Promise<AdminOperationResult<InstructionTemplateMutationResult | {
+        status: 'legacy_unavailable';
+    }>>;
+    previewDeleteTemplate(input: TemplateIdentityOperationInput): Promise<AdminOperationResult<TemplateDeletePreview>>;
+    deleteTemplate(input: TemplateIdentityOperationInput): Promise<AdminOperationResult<InstructionTemplateMutationResult>>;
+}
+export interface InstructionTemplateAdminState extends InstructionTemplateCollectionReadModel {
+    renderFailures: Partial<Record<InstructionPreviewSurface, SanitizedInstructionRenderFailure>>;
+    legacyImportAvailable: boolean;
+}
+export interface InstructionTemplateDetail {
+    template: InstructionTemplateReadModel;
+    configFingerprint: string;
+    renderFailures: Partial<Record<InstructionPreviewSurface, SanitizedInstructionRenderFailure>>;
+}
+export interface TemplateDeletePreview {
+    identity: string;
+    allowed: boolean;
+    reason?: 'protected' | 'active_conflict' | 'not_found';
+    expectedConfigFingerprint: string;
+    previewFingerprint: string;
+}
+export interface TemplateValidationPreview {
+    identity: string;
+    validation?: InstructionTemplateValidation;
+    expectedConfigFingerprint: string;
+    previewFingerprint: string;
+}
+interface TemplateIdentityOperationInput {
+    context: AdminOperationContext;
+    identity: string;
+    expectedConfigFingerprint: string;
+    previewFingerprint?: string;
+}
+interface TemplateSaveOperationInput extends TemplateIdentityOperationInput {
+    variants: InstructionTemplateConfig;
+}
+interface TemplateCloneOperationInput extends TemplateIdentityOperationInput {
+    sourceIdentity: string;
+}
+interface TemplatePreviewOperationInput {
+    context: AdminOperationContext;
+    identity: string;
+    surface: InstructionPreviewSurface;
+    selection: InstructionPreviewSelection;
+    requestContext?: ContextData;
+}
+interface AdminInstructionTemplateServiceOptions {
+    operationService: AdminOperationService;
+    manager: InstructionTemplateManager;
+    preview: (input: AdminInstructionPreviewInput) => Promise<AdminInstructionPreviewResult>;
+    getLegacyInitialization: () => string | undefined;
+    getRenderFailures: () => Partial<Record<InstructionSurface, RuntimeInstructionRenderFailure>>;
+}
+export declare class AdminInstructionTemplateNotFoundError extends Error {
+    readonly identity: string;
+    readonly code = "instruction_template_not_found";
+    constructor(identity: string);
+}
+export declare class AdminInstructionTemplateService implements AdminInstructionTemplateOperations {
+    private readonly options;
+    constructor(options: AdminInstructionTemplateServiceOptions);
+    listTemplates(input: {
+        context: AdminOperationContext;
+    }): Promise<AdminOperationResult<InstructionTemplateAdminState>>;
+    getTemplate(input: {
+        context: AdminOperationContext;
+        identity: string;
+    }): Promise<AdminOperationResult<{
+        template: InstructionTemplateReadModel;
+        configFingerprint: string;
+        renderFailures: Partial<Record<InstructionPreviewSurface, SanitizedInstructionRenderFailure>>;
+    }>>;
+    createTemplate(input: TemplateSaveOperationInput): Promise<AdminOperationResult<InstructionTemplateMutationResult>>;
+    updateTemplate(input: TemplateSaveOperationInput): Promise<AdminOperationResult<InstructionTemplateMutationResult>>;
+    cloneTemplate(input: TemplateCloneOperationInput): Promise<AdminOperationResult<InstructionTemplateMutationResult>>;
+    validateTemplate(input: TemplateIdentityOperationInput): Promise<AdminOperationResult<{
+        identity: string;
+        validation: InstructionTemplateValidation | undefined;
+        expectedConfigFingerprint: string;
+        previewFingerprint: string;
+    }>>;
+    previewTemplate(input: TemplatePreviewOperationInput): Promise<AdminOperationResult<AdminInstructionPreviewResult>>;
+    activateTemplate(input: TemplateIdentityOperationInput): Promise<AdminOperationResult<InstructionTemplateMutationResult>>;
+    importLegacyTemplate(input: TemplateIdentityOperationInput): Promise<AdminOperationResult<import("../../domains/config-change/configChange.js").ConfigChangeResult | {
+        status: "protected" | "active_conflict" | "identity_conflict" | "not_found" | "conflict";
+    } | {
+        status: "invalid";
+        validation: InstructionTemplateValidation;
+    } | {
+        status: "legacy_unavailable";
+    }>>;
+    previewDeleteTemplate(input: TemplateIdentityOperationInput): Promise<AdminOperationResult<TemplateDeletePreview>>;
+    deleteTemplate(input: TemplateIdentityOperationInput): Promise<AdminOperationResult<InstructionTemplateMutationResult>>;
+    private mutate;
+    private readAdminState;
+}
+export {};
+//# sourceMappingURL=adminInstructionTemplateService.d.ts.map

package/build/domains/admin/adminInstructionTemplateService.d.ts.map

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

package/build/domains/admin/adminInstructionTemplateService.js

@@ -0,0 +1,181 @@
+import { createHash } from 'node:crypto';
+export class AdminInstructionTemplateNotFoundError extends Error {
+    identity;
+    code = 'instruction_template_not_found';
+    constructor(identity) {
+        super(`Instruction template '${identity}' was not found`);
+        this.identity = identity;
+        this.name = 'AdminInstructionTemplateNotFoundError';
+    }
+}
+export class AdminInstructionTemplateService {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    listTemplates(input) {
+        return this.options.operationService.executeReadOnly({
+            context: input.context,
+            operationName: 'listInstructionTemplates',
+            run: async () => this.readAdminState(),
+        });
+    }
+    getTemplate(input) {
+        return this.options.operationService.executeReadOnly({
+            context: withTemplateTarget(input.context, input.identity),
+            operationName: 'getInstructionTemplate',
+            run: async () => {
+                const state = await this.readAdminState();
+                const template = state.templates.find((candidate) => candidate.identity === input.identity);
+                if (!template)
+                    throw new AdminInstructionTemplateNotFoundError(input.identity);
+                return { template, configFingerprint: state.configFingerprint, renderFailures: state.renderFailures };
+            },
+        });
+    }
+    createTemplate(input) {
+        return this.mutate('createInstructionTemplate', input, () => this.options.manager.create({
+            identity: input.identity,
+            template: input.variants,
+            expectedConfigFingerprint: input.expectedConfigFingerprint,
+        }));
+    }
+    updateTemplate(input) {
+        return this.mutate('updateInstructionTemplate', input, () => this.options.manager.update({
+            identity: input.identity,
+            template: input.variants,
+            expectedConfigFingerprint: input.expectedConfigFingerprint,
+        }));
+    }
+    cloneTemplate(input) {
+        return this.mutate('cloneInstructionTemplate', input, () => this.options.manager.clone({
+            sourceIdentity: input.sourceIdentity,
+            identity: input.identity,
+            expectedConfigFingerprint: input.expectedConfigFingerprint,
+        }));
+    }
+    validateTemplate(input) {
+        return this.options.operationService.executeReadOnly({
+            context: withTemplateTarget(input.context, input.identity),
+            operationName: 'validateInstructionTemplate',
+            run: async () => {
+                const state = await this.options.manager.list();
+                return {
+                    identity: input.identity,
+                    validation: await this.options.manager.validate(input.identity),
+                    expectedConfigFingerprint: state.configFingerprint,
+                    previewFingerprint: previewFingerprint('activate', input.identity, state.configFingerprint),
+                };
+            },
+        });
+    }
+    previewTemplate(input) {
+        return this.options.operationService.executeDryRun({
+            context: withTemplateTarget(input.context, input.identity),
+            operationName: 'previewInstructionTemplate',
+            run: async () => {
+                const state = await this.options.manager.list();
+                const template = state.templates.find((candidate) => candidate.identity === input.identity);
+                if (!template)
+                    throw new AdminInstructionTemplateNotFoundError(input.identity);
+                return this.options.preview({
+                    identity: input.identity,
+                    surface: input.surface === 'initialize' ? 'initialization' : 'cli',
+                    template: template.variants[input.surface === 'initialize' ? 'initialization' : 'cli'],
+                    selection: input.selection,
+                    requestContext: input.requestContext,
+                });
+            },
+        });
+    }
+    activateTemplate(input) {
+        return this.mutate('activateInstructionTemplate', input, () => input.previewFingerprint !== previewFingerprint('activate', input.identity, input.expectedConfigFingerprint)
+            ? Promise.resolve({ status: 'conflict' })
+            : this.options.manager.activate({
+                identity: input.identity,
+                expectedConfigFingerprint: input.expectedConfigFingerprint,
+            }));
+    }
+    importLegacyTemplate(input) {
+        return this.mutate('importLegacyInstructionTemplate', input, async () => {
+            const initialization = this.options.getLegacyInitialization();
+            return initialization === undefined
+                ? { status: 'legacy_unavailable' }
+                : this.options.manager.importLegacy({
+                    identity: input.identity,
+                    initialization,
+                    expectedConfigFingerprint: input.expectedConfigFingerprint,
+                });
+        });
+    }
+    previewDeleteTemplate(input) {
+        return this.options.operationService.executeDryRun({
+            context: withTemplateTarget(input.context, input.identity),
+            operationName: 'previewDeleteInstructionTemplate',
+            run: async () => {
+                const state = await this.options.manager.list();
+                const template = state.templates.find((candidate) => candidate.identity === input.identity);
+                return {
+                    identity: input.identity,
+                    allowed: Boolean(template && !template.protected && !template.active),
+                    reason: !template
+                        ? 'not_found'
+                        : template.protected
+                            ? 'protected'
+                            : template.active
+                                ? 'active_conflict'
+                                : undefined,
+                    expectedConfigFingerprint: state.configFingerprint,
+                    previewFingerprint: previewFingerprint('delete', input.identity, state.configFingerprint),
+                };
+            },
+        });
+    }
+    deleteTemplate(input) {
+        return this.mutate('deleteInstructionTemplate', input, () => input.previewFingerprint !== previewFingerprint('delete', input.identity, input.expectedConfigFingerprint)
+            ? Promise.resolve({ status: 'conflict' })
+            : this.options.manager.delete({
+                identity: input.identity,
+                expectedConfigFingerprint: input.expectedConfigFingerprint,
+            }));
+    }
+    mutate(operationName, input, run) {
+        return this.options.operationService.executeMutation({
+            context: withTemplateTarget(input.context, input.identity),
+            operationName,
+            run,
+        });
+    }
+    async readAdminState() {
+        const state = await this.options.manager.list();
+        return {
+            ...state,
+            legacyImportAvailable: this.options.getLegacyInitialization() !== undefined,
+            renderFailures: sanitizeRenderFailures(this.options.getRenderFailures()),
+        };
+    }
+}
+function previewFingerprint(action, identity, configFingerprint) {
+    return `instruction_template_preview_${createHash('sha256')
+        .update(action)
+        .update('\0')
+        .update(identity)
+        .update('\0')
+        .update(configFingerprint)
+        .digest('hex')}`;
+}
+function withTemplateTarget(context, identity) {
+    return { ...context, target: { type: 'instruction_template', id: identity } };
+}
+function sanitizeRenderFailures(failures) {
+    return Object.fromEntries(Object.entries(failures).map(([surface, failure]) => [
+        surface === 'initialization' ? 'initialize' : 'cli',
+        {
+            code: 'managed_template_render_failed',
+            surface: failure.surface === 'initialization' ? 'initialize' : 'cli',
+            templateIdentity: failure.templateIdentity,
+            occurredAt: failure.occurredAt.toISOString(),
+        },
+    ]));
+}
+//# sourceMappingURL=adminInstructionTemplateService.js.map

package/build/domains/admin/adminInstructionTemplateService.js.map

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

package/build/domains/admin/configuredToolInventory.d.ts

@@ -0,0 +1,64 @@
+import { type MCPServerParams, type OutboundConnection, type OutboundConnections } from '../../core/types/index.js';
+export type ConfiguredToolTargetSource = 'mcpServers' | 'mcpTemplates';
+export type ConfiguredToolInspectionStatus = 'unavailable' | 'in_progress' | 'failed' | 'complete';
+export interface ConfiguredToolInspectionFact {
+    instanceId: string;
+    status: 'unavailable' | 'failed' | 'complete';
+    error?: string;
+}
+export interface ConfiguredToolInspectionOutcome {
+    status: ConfiguredToolInspectionStatus;
+    reason?: string;
+    retryable: boolean;
+    instances: ConfiguredToolInspectionFact[];
+}
+export interface ConfiguredToolInventoryRow {
+    name: string;
+    upstreamDescription?: string;
+    effectiveDescription?: string;
+    descriptionOverride?: string;
+    descriptionOverridden: boolean;
+    enabled: boolean;
+    observed: boolean;
+    stale?: boolean;
+    unresolved: boolean;
+    observedInstanceCount: number;
+    activeInstanceCount: number;
+    observedInSomeInstances: boolean;
+    approximateTokens: number;
+}
+export interface ConfiguredToolInventory {
+    targetName: string;
+    source: ConfiguredToolTargetSource;
+    targetEnabled: boolean;
+    freshness: 'live' | 'unavailable';
+    model: string;
+    generation: string;
+    activeInstanceCount: number;
+    inspection?: ConfiguredToolInspectionOutcome;
+    rows: ConfiguredToolInventoryRow[];
+    counts: {
+        observed: number;
+        enabled: number;
+        disabled: number;
+        unresolved: number;
+    };
+    approximateTokens: {
+        enabled: number;
+        allObserved: number;
+        savings: number;
+    };
+}
+export declare function createConfiguredToolInventory(input: {
+    targetName: string;
+    source: ConfiguredToolTargetSource;
+    config: MCPServerParams;
+    connections: OutboundConnections;
+    model?: string;
+    instances?: Array<{
+        instanceId: string;
+        connection: OutboundConnection;
+    }>;
+    inspection?: ConfiguredToolInspectionOutcome;
+}): Promise<ConfiguredToolInventory>;
+//# sourceMappingURL=configuredToolInventory.d.ts.map

package/build/domains/admin/configuredToolInventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuredToolInventory.d.ts","sourceRoot":"","sources":["../../../src/domains/admin/configuredToolInventory.ts"],"names":[],"mappings":"AAeA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACzB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,MAAM,0BAA0B,GAAG,YAAY,GAAG,cAAc,CAAC;AAEvE,MAAM,MAAM,8BAA8B,GAAG,aAAa,GAAG,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEnG,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,8BAA8B,CAAC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,4BAA4B,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uBAAuB,EAAE,OAAO,CAAC;IACjC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,0BAA0B,CAAC;IACnC,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,+BAA+B,CAAC;IAC7C,IAAI,EAAE,0BAA0B,EAAE,CAAC;IACnC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACpF,iBAAiB,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9E;AAED,wBAAsB,6BAA6B,CAAC,KAAK,EAAE;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,0BAA0B,CAAC;IACnC,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW,EAAE,mBAAmB,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,kBAAkB,CAAA;KAAE,CAAC,CAAC;IAC1E,UAAU,CAAC,EAAE,+BAA+B,CAAC;CAC9C,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAgKnC"}