@microsoft/agents-hosting-dialogs 0.1.49

package/dist/src/prompts/promptCultureModels.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptCultureModels = void 0;
+const recognizers_text_suite_1 = require("@microsoft/recognizers-text-suite");
+/**
+ * Class container for currently-supported Culture Models in Confirm and Choice Prompt.
+ */
+class PromptCultureModels {
+    /**
+       * @private
+       */
+    static getSupportedCultureCodes() {
+        return this.getSupportedCultures().map((c) => c.locale);
+    }
+    /**
+       * Use Recognizers-Text to normalize various potential Locale strings to a standard.
+       *
+       * @remarks This is mostly a copy/paste from https://github.com/microsoft/Recognizers-Text/blob/master/JavaScript/packages/recognizers-text/src/culture.ts#L39
+       *          This doesn't directly use Recognizers-Text's MapToNearestLanguage because if they add language support before we do, it will break our prompts.
+       * @param cultureCode Represents locale. Examples: "en-US, en-us, EN".
+       * @returns Normalized locale.
+       */
+    static mapToNearestLanguage(cultureCode) {
+        if (cultureCode) {
+            cultureCode = cultureCode.toLowerCase();
+            const supportedCultureCodes = this.getSupportedCultureCodes();
+            if (supportedCultureCodes.indexOf(cultureCode) < 0) {
+                const culturePrefix = cultureCode.split('-')[0].trim();
+                supportedCultureCodes.forEach(function (supportedCultureCode) {
+                    if (supportedCultureCode.startsWith(culturePrefix)) {
+                        cultureCode = supportedCultureCode;
+                    }
+                });
+            }
+        }
+        return cultureCode;
+    }
+}
+exports.PromptCultureModels = PromptCultureModels;
+PromptCultureModels.Chinese = {
+    locale: recognizers_text_suite_1.Culture.Chinese,
+    separator: ', ',
+    inlineOr: ' 要么 ',
+    inlineOrMore: '， 要么 ',
+    yesInLanguage: '是的',
+    noInLanguage: '不',
+};
+PromptCultureModels.Dutch = {
+    locale: recognizers_text_suite_1.Culture.Dutch,
+    separator: ', ',
+    inlineOr: ' of ',
+    inlineOrMore: ', of ',
+    yesInLanguage: 'Ja',
+    noInLanguage: 'Nee',
+};
+PromptCultureModels.English = {
+    locale: recognizers_text_suite_1.Culture.English,
+    separator: ', ',
+    inlineOr: ' or ',
+    inlineOrMore: ', or ',
+    yesInLanguage: 'Yes',
+    noInLanguage: 'No',
+};
+PromptCultureModels.French = {
+    locale: recognizers_text_suite_1.Culture.French,
+    separator: ', ',
+    inlineOr: ' ou ',
+    inlineOrMore: ', ou ',
+    yesInLanguage: 'Oui',
+    noInLanguage: 'Non',
+};
+PromptCultureModels.German = {
+    locale: recognizers_text_suite_1.Culture.German,
+    separator: ', ',
+    inlineOr: ' oder ',
+    inlineOrMore: ', oder ',
+    yesInLanguage: 'Ja',
+    noInLanguage: 'Nein',
+};
+PromptCultureModels.Italian = {
+    locale: recognizers_text_suite_1.Culture.Italian,
+    separator: ', ',
+    inlineOr: ' o ',
+    inlineOrMore: ' o ',
+    yesInLanguage: 'Si',
+    noInLanguage: 'No',
+};
+PromptCultureModels.Japanese = {
+    locale: recognizers_text_suite_1.Culture.Japanese,
+    separator: '、 ',
+    inlineOr: ' または ',
+    inlineOrMore: '、 または ',
+    yesInLanguage: 'はい',
+    noInLanguage: 'いいえ',
+};
+PromptCultureModels.Portuguese = {
+    locale: recognizers_text_suite_1.Culture.Portuguese,
+    separator: ', ',
+    inlineOr: ' ou ',
+    inlineOrMore: ', ou ',
+    yesInLanguage: 'Sim',
+    noInLanguage: 'Não',
+};
+PromptCultureModels.Spanish = {
+    locale: recognizers_text_suite_1.Culture.Spanish,
+    separator: ', ',
+    inlineOr: ' o ',
+    inlineOrMore: ', o ',
+    yesInLanguage: 'Sí',
+    noInLanguage: 'No',
+};
+PromptCultureModels.getSupportedCultures = () => [
+    PromptCultureModels.Chinese,
+    PromptCultureModels.Dutch,
+    PromptCultureModels.English,
+    PromptCultureModels.French,
+    PromptCultureModels.German,
+    PromptCultureModels.Italian,
+    PromptCultureModels.Japanese,
+    PromptCultureModels.Portuguese,
+    PromptCultureModels.Spanish,
+];
+//# sourceMappingURL=promptCultureModels.js.map

package/dist/src/prompts/promptCultureModels.js.map

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

package/dist/src/prompts/textPrompt.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { TurnContext } from '@microsoft/agents-hosting';
+import { Prompt, PromptOptions, PromptRecognizerResult, PromptValidator } from './prompt';
+import { DialogContext } from '../dialogContext';
+import { DialogEvent } from '../dialogEvent';
+/**
+ * Prompts a user to enter some text.
+ *
+ * @remarks
+ * By default the prompt will return to the calling dialog a `string` representing the users reply.
+ */
+export declare class TextPrompt extends Prompt<string> {
+    constructor(dialogId?: string, validator?: PromptValidator<string>);
+    /**
+       * Prompts the user for input.
+       *
+       * @param context TurnContext, context for the current
+       * turn of conversation with the user.
+       * @param state Contains state for the current instance of the prompt on the dialog stack.
+       * @param options A PromptOptions object constructed
+       * from the options initially provided in the call to Prompt.
+       * @param isRetry `true` if this is the first time this prompt dialog instance
+       * on the stack is prompting the user for input; otherwise, false.
+       * @returns A `Promise` representing the asynchronous operation.
+       */
+    protected onPrompt(context: TurnContext, state: any, options: PromptOptions, isRetry: boolean): Promise<void>;
+    /**
+       * Attempts to recognize the user's input.
+       *
+       * @param context TurnContext, context for the current
+       * turn of conversation with the user.
+       * @param _state Contains state for the current instance of the prompt on the dialog stack.
+       * @param _options A PromptOptions object constructed
+       * from the options initially provided in the call to Prompt.
+       * @returns A `Promise` representing the asynchronous operation.
+       */
+    protected onRecognize(context: TurnContext, _state: any, _options: PromptOptions): Promise<PromptRecognizerResult<string>>;
+    /**
+       * Called before an event is bubbled to its parent.
+       *
+       * @param _dc The DialogContext for the current
+       * turn of conversation.
+       * @param _event DialogEvent, the event being raised.
+       * @returns Whether the event is handled by the current dialog and further processing should stop.
+       * @remarks
+       * This is a good place to perform interception of an event as returning `true` will prevent
+       * any further bubbling of the event to the dialogs parents and will also prevent any child
+       * dialogs from performing their default processing.
+       */
+    protected onPreBubbleEvent(_dc: DialogContext, _event: DialogEvent): Promise<boolean>;
+}

package/dist/src/prompts/textPrompt.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TextPrompt = void 0;
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+const agents_hosting_1 = require("@microsoft/agents-hosting");
+const prompt_1 = require("./prompt");
+/**
+ * Prompts a user to enter some text.
+ *
+ * @remarks
+ * By default the prompt will return to the calling dialog a `string` representing the users reply.
+ */
+class TextPrompt extends prompt_1.Prompt {
+    // eslint-disable-next-line @typescript-eslint/no-useless-constructor
+    constructor(dialogId, validator) {
+        super(dialogId, validator);
+    }
+    /**
+       * Prompts the user for input.
+       *
+       * @param context TurnContext, context for the current
+       * turn of conversation with the user.
+       * @param state Contains state for the current instance of the prompt on the dialog stack.
+       * @param options A PromptOptions object constructed
+       * from the options initially provided in the call to Prompt.
+       * @param isRetry `true` if this is the first time this prompt dialog instance
+       * on the stack is prompting the user for input; otherwise, false.
+       * @returns A `Promise` representing the asynchronous operation.
+       */
+    async onPrompt(context, state, options, isRetry) {
+        if (isRetry && options.retryPrompt) {
+            await context.sendActivity(options.retryPrompt, undefined, agents_hosting_1.InputHints.ExpectingInput);
+        }
+        else if (options.prompt) {
+            await context.sendActivity(options.prompt, undefined, agents_hosting_1.InputHints.ExpectingInput);
+        }
+    }
+    /**
+       * Attempts to recognize the user's input.
+       *
+       * @param context TurnContext, context for the current
+       * turn of conversation with the user.
+       * @param _state Contains state for the current instance of the prompt on the dialog stack.
+       * @param _options A PromptOptions object constructed
+       * from the options initially provided in the call to Prompt.
+       * @returns A `Promise` representing the asynchronous operation.
+       */
+    async onRecognize(context, _state, _options) {
+        const value = context.activity.text;
+        return typeof value === 'string' && value.length > 0 ? { succeeded: true, value } : { succeeded: false };
+    }
+    /**
+       * Called before an event is bubbled to its parent.
+       *
+       * @param _dc The DialogContext for the current
+       * turn of conversation.
+       * @param _event DialogEvent, the event being raised.
+       * @returns Whether the event is handled by the current dialog and further processing should stop.
+       * @remarks
+       * This is a good place to perform interception of an event as returning `true` will prevent
+       * any further bubbling of the event to the dialogs parents and will also prevent any child
+       * dialogs from performing their default processing.
+       */
+    async onPreBubbleEvent(_dc, _event) {
+        return false;
+    }
+}
+exports.TextPrompt = TextPrompt;
+//# sourceMappingURL=textPrompt.js.map

package/dist/src/prompts/textPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textPrompt.js","sourceRoot":"","sources":["../../../src/prompts/textPrompt.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,8DAAmE;AACnE,qCAAyF;AAIzF;;;;;GAKG;AACH,MAAa,UAAW,SAAQ,eAAc;IAC5C,qEAAqE;IACrE,YAAa,QAAiB,EAAE,SAAmC;QACjE,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;IAC5B,CAAC;IAED;;;;;;;;;;;SAWK;IACK,KAAK,CAAC,QAAQ,CACtB,OAAoB,EACpB,KAAU,EACV,OAAsB,EACtB,OAAgB;QAEhB,IAAI,OAAO,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACnC,MAAM,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,EAAE,2BAAU,CAAC,cAAc,CAAC,CAAA;QACvF,CAAC;aAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,MAAM,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,2BAAU,CAAC,cAAc,CAAC,CAAA;QAClF,CAAC;IACH,CAAC;IAED;;;;;;;;;SASK;IACK,KAAK,CAAC,WAAW,CACzB,OAAoB,EACpB,MAAW,EACX,QAAuB;QAEvB,MAAM,KAAK,GAAW,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAA;QAE3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAA;IAC1G,CAAC;IAED;;;;;;;;;;;SAWK;IACK,KAAK,CAAC,gBAAgB,CAAE,GAAkB,EAAE,MAAmB;QACvE,OAAO,KAAK,CAAA;IACd,CAAC;CACF;AAlED,gCAkEC"}

package/dist/src/recognizer.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { Activity } from '@microsoft/agents-hosting';
+import { Configurable } from './configurable';
+import { DialogContext } from './dialogContext';
+import { RecognizerResult } from './recognizerResult';
+export interface RecognizerConfiguration {
+    id?: string;
+}
+/**
+ * Recognizer base class.
+ */
+export declare class Recognizer extends Configurable implements RecognizerConfiguration {
+    id?: string;
+    /**
+       * To recognize intents and entities in a users utterance.
+       *
+       * @param {DialogContext} _dialogContext Dialog Context.
+       * @param {Partial<Activity>} _activity Activity.
+       * @param {Record<string, string>} _telemetryProperties Additional properties to be logged to telemetry with event.
+       * @param {Record<string, number>} _telemetryMetrics Additional metrics to be logged to telemetry with event.
+       */
+    recognize(_dialogContext: DialogContext, _activity: Partial<Activity>, _telemetryProperties?: Record<string, string>, _telemetryMetrics?: Record<string, number>): Promise<RecognizerResult>;
+    /**
+       * Creates choose intent result in the case that there are conflicting or ambiguous signals from the recognizers.
+       *
+       * @param {Record<string, RecognizerResult>} recognizerResults A group of recognizer results.
+       * @returns {RecognizerResult} Recognizer result which is ChooseIntent.
+       */
+    protected createChooseIntentResult(recognizerResults: Record<string, RecognizerResult>): RecognizerResult;
+    /**
+       * Uses the RecognizerResult to create a list of properties to be included when tracking the result in telemetry.
+       *
+       * @param {RecognizerResult} recognizerResult Recognizer Result.
+       * @param {Record<string, string>} telemetryProperties A list of properties to append or override the properties created using the RecognizerResult.
+       * @param {DialogContext} _dialogContext Dialog Context.
+       * @returns {Record<string, string>} A collection of properties that can be included when calling the TrackEvent method on the TelemetryClient.
+       */
+    protected fillRecognizerResultTelemetryProperties(recognizerResult: RecognizerResult, telemetryProperties: Record<string, string>, _dialogContext?: DialogContext): Record<string, string>;
+    protected stringifyAdditionalPropertiesOfRecognizerResult(recognizerResult: RecognizerResult): string;
+}

package/dist/src/recognizer.js

@@ -0,0 +1,104 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Recognizer = void 0;
+const configurable_1 = require("./configurable");
+const omit_1 = __importDefault(require("lodash/omit"));
+const recognizerResult_1 = require("./recognizerResult");
+/**
+ * Recognizer base class.
+ */
+class Recognizer extends configurable_1.Configurable {
+    /**
+       * To recognize intents and entities in a users utterance.
+       *
+       * @param {DialogContext} _dialogContext Dialog Context.
+       * @param {Partial<Activity>} _activity Activity.
+       * @param {Record<string, string>} _telemetryProperties Additional properties to be logged to telemetry with event.
+       * @param {Record<string, number>} _telemetryMetrics Additional metrics to be logged to telemetry with event.
+       */
+    recognize(_dialogContext, _activity, _telemetryProperties, _telemetryMetrics) {
+        throw new Error('Please implement recognize function.');
+    }
+    /**
+       * Creates choose intent result in the case that there are conflicting or ambiguous signals from the recognizers.
+       *
+       * @param {Record<string, RecognizerResult>} recognizerResults A group of recognizer results.
+       * @returns {RecognizerResult} Recognizer result which is ChooseIntent.
+       */
+    createChooseIntentResult(recognizerResults) {
+        let text = '';
+        let sentiment = {};
+        const candidates = Object.entries(recognizerResults).reduce((candidates, [key, result]) => {
+            text = result.text;
+            sentiment = result.sentiment;
+            const { intent, score } = (0, recognizerResult_1.getTopScoringIntent)(result);
+            if (intent !== 'None') {
+                candidates.push({
+                    id: key,
+                    intent,
+                    score,
+                    result,
+                });
+            }
+            return candidates;
+        }, []);
+        if (candidates.length) {
+            const recognizerResult = {
+                text,
+                intents: { ChooseIntent: { score: 1.0 } },
+                candidates,
+                entities: {},
+            };
+            return recognizerResult;
+        }
+        // just return a `None` intent.
+        const recognizerResult = {
+            text,
+            intents: { None: { score: 1.0 } },
+            entities: {},
+            sentiment,
+        };
+        return recognizerResult;
+    }
+    /**
+       * Uses the RecognizerResult to create a list of properties to be included when tracking the result in telemetry.
+       *
+       * @param {RecognizerResult} recognizerResult Recognizer Result.
+       * @param {Record<string, string>} telemetryProperties A list of properties to append or override the properties created using the RecognizerResult.
+       * @param {DialogContext} _dialogContext Dialog Context.
+       * @returns {Record<string, string>} A collection of properties that can be included when calling the TrackEvent method on the TelemetryClient.
+       */
+    fillRecognizerResultTelemetryProperties(recognizerResult, telemetryProperties, _dialogContext) {
+        var _a;
+        const { intent, score } = (0, recognizerResult_1.getTopScoringIntent)(recognizerResult);
+        const intents = Object.entries(recognizerResult.intents);
+        const properties = {
+            Text: recognizerResult.text,
+            AlteredText: (_a = recognizerResult.alteredText) !== null && _a !== void 0 ? _a : '',
+            TopIntent: intents.length > 0 ? intent : '',
+            TopIntentScore: intents.length > 0 ? score.toString() : '',
+            Intents: intents.length > 0 ? JSON.stringify(recognizerResult.intents) : '',
+            Entities: recognizerResult.entities ? JSON.stringify(recognizerResult.entities) : '',
+            AdditionalProperties: JSON.stringify((0, omit_1.default)(recognizerResult, ['text', 'alteredText', 'intents', 'entities'])),
+        };
+        if (telemetryProperties) {
+            return Object.assign({}, properties, telemetryProperties);
+        }
+        return properties;
+    }
+    stringifyAdditionalPropertiesOfRecognizerResult(recognizerResult) {
+        const generalProperties = new Set(['text', 'alteredText', 'intents', 'entities']);
+        const additionalProperties = {};
+        for (const key in recognizerResult) {
+            if (!generalProperties.has(key)) {
+                additionalProperties[key] = recognizerResult[key];
+            }
+        }
+        return Object.keys(additionalProperties).length > 0 ? JSON.stringify(additionalProperties) : '';
+    }
+}
+exports.Recognizer = Recognizer;
+//# sourceMappingURL=recognizer.js.map

package/dist/src/recognizer.js.map

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

package/dist/src/recognizerResult.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { IntentScore } from './intentScore';
+/**
+ * Value returned from a recognizer.
+ */
+export interface RecognizerResult {
+    text: string;
+    alteredText?: string;
+    intents: Record<string, IntentScore>;
+    entities?: any;
+    [propName: string]: any;
+}
+export declare const getTopScoringIntent: (result: RecognizerResult) => {
+    intent: string;
+    score: number;
+};

package/dist/src/recognizerResult.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTopScoringIntent = void 0;
+const getTopScoringIntent = (result) => {
+    var _a;
+    if (!result || !result.intents) {
+        throw new Error('result is empty');
+    }
+    let topIntent = '';
+    let topScore = -1;
+    for (const [intentName, intent] of Object.entries(result.intents)) {
+        const score = (_a = intent.score) !== null && _a !== void 0 ? _a : -1;
+        if (!topIntent || score > topScore) {
+            topIntent = intentName;
+            topScore = score;
+        }
+    }
+    return {
+        intent: topIntent,
+        score: topScore,
+    };
+};
+exports.getTopScoringIntent = getTopScoringIntent;
+//# sourceMappingURL=recognizerResult.js.map

package/dist/src/recognizerResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recognizerResult.js","sourceRoot":"","sources":["../../src/recognizerResult.ts"],"names":[],"mappings":";;;AAiBO,MAAM,mBAAmB,GAAG,CAAC,MAAwB,EAAqC,EAAE;;IACjG,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;IACpC,CAAC;IAED,IAAI,SAAS,GAAG,EAAE,CAAA;IAClB,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAA;IACjB,KAAK,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAClE,MAAM,KAAK,GAAG,MAAA,MAAM,CAAC,KAAK,mCAAI,CAAC,CAAC,CAAA;QAChC,IAAI,CAAC,SAAS,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;YACnC,SAAS,GAAG,UAAU,CAAA;YACtB,QAAQ,GAAG,KAAK,CAAA;QAClB,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE,QAAQ;KAChB,CAAA;AACH,CAAC,CAAA;AAnBY,QAAA,mBAAmB,uBAmB/B"}

package/dist/src/serviceCollection.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Factory describes a generic factory function signature. The type is generic over a few parameters:
+ *
+ * @template Type type the factory produces
+ * @template Initial true if the `initialValue` passed to the factory must be defined
+ */
+export type Factory<Type, Initial extends boolean> = (initialValue: Initial extends true ? Type : Type | undefined) => Type;
+/**
+ * DependencyFactory is a function signature that produces an instance that depends on a set of
+ * other services. The type is generic over a few parameters:
+ *
+ * @template Type type the factory produces
+ * @template Dependencies the services this factory function depends on
+ * @template Initial true if the `initialValue` passed to the factory must be defined
+ */
+export type DependencyFactory<Type, Dependencies, Initial extends boolean> = (dependencies: Dependencies, initialValue: Initial extends true ? Type : Type | undefined) => Type;
+/**
+ * ServiceCollection is an interface that describes a set of methods to register services. This, in a lighter way,
+ * mimics the .NET dependency injection service collection functionality, except for instances rather than types.
+ */
+export declare class ServiceCollection {
+    private readonly dependencies;
+    /**
+       * `DepGraph` is a dependency graph data structure. In our case, the services we support are encoded as a
+       * dependency graph where nodes are named with a key and store a list of factory methods.
+       */
+    private readonly graph;
+    /**
+       * Cache constructed instances for reuse
+       */
+    private cache;
+    /**
+       * Construct a Providers instance
+       *
+       * @template S services interface
+       * @param defaultServices default set of services
+       */
+    constructor(defaultServices?: Record<string, unknown>);
+    /**
+       * Register an instance by key. This will overwrite existing instances.
+       *
+       * @param key key of the instance being provided
+       * @param instance instance to provide
+       * @returns this for chaining
+       */
+    addInstance<InstanceType>(key: string, instance: InstanceType): this;
+    /**
+       * Register a factory for a key.
+       *
+       * @param key key that factory will provide
+       * @param factory function that creates an instance to provide
+       * @returns this for chaining
+       */
+    addFactory<InstanceType>(key: string, factory: Factory<InstanceType, false>): this;
+    /**
+       * Register a factory for a key with a set of dependencies.
+       *
+       * @param key key that factory will provide
+       * @param dependencies set of things this instance depends on. Will be provided to factory function via `services`.
+       * @param factory function that creates an instance to provide
+       * @returns this for chaining
+       */
+    addFactory<InstanceType, Dependencies>(key: string, dependencies: string[], factory: DependencyFactory<InstanceType, Dependencies, false>): this;
+    /**
+       * Register a factory (that expects the initial value that is not undefined) for a key.
+       *
+       * @param key key of the instance being provided
+       * @param instance instance to provide
+       * @returns this for chaining
+       */
+    composeFactory<InstanceType>(key: string, factory: Factory<InstanceType, true>): this;
+    /**
+       * Register a factory (that expects an initial value that is not undefined) for a key
+       * with a set of dependencies.
+       *
+       * @param key key that factory will provide
+       * @param dependencies set of things this instance depends on. Will be provided to factory function via `services`.
+       * @param factory function that creates an instance to provide
+       * @returns this for chaining
+       */
+    composeFactory<InstanceType, Dependencies>(key: string, dependencies: string[], factory: DependencyFactory<InstanceType, Dependencies, true>): this;
+    private buildNodes;
+    /**
+       * Build a single service.
+       *
+       * @param key service to build
+       * @param deep reconstruct all dependencies
+       * @returns the service instance, or undefined
+       */
+    makeInstance<InstanceType = unknown>(key: string, deep?: boolean): InstanceType | undefined;
+    /**
+       * Build a single service and assert that it is not undefined.
+       *
+       * @param key service to build
+       * @param deep reconstruct all dependencies
+       * @returns the service instance
+       */
+    mustMakeInstance<InstanceType = unknown>(key: string, deep?: boolean): InstanceType;
+    /**
+       * Build the full set of services.
+       *
+       * @returns all resolved services
+       */
+    makeInstances<InstancesType>(): InstancesType;
+    /**
+       * Build the full set of services, asserting that the specified keys are not undefined.
+       *
+       * @param keys instances that must be not undefined
+       * @returns all resolve services
+       */
+    mustMakeInstances<InstancesType extends Record<string, unknown> = Record<string, unknown>>(...keys: string[]): InstancesType;
+}