@k8slens/ai-tools-contracts 1.0.0

package/dist/src/ai-tool-configuration.d.ts

@@ -0,0 +1,51 @@
+import type { IComputedValue } from "mobx";
+import type { AiToolKind } from "./ai-tool";
+/**
+ * The menu a tool's own configuration is offered in, opened from the tool's row in
+ * the AI tool button's menu. One kind for every tool: the row says which tool it
+ * opened the menu for, and the item renders that tool's `Settings`.
+ */
+export declare const aiToolConfigurationMenuKind: import("@k8slens/injectable").TypedSpecifier<"ai-tool-configuration-menu", {
+    dropDownMenuData: {
+        readonly kind: AiToolKind;
+    };
+}>;
+/** Resolves whether the tool has the configuration it needs to run. */
+export type AiToolIsConfigured = () => Promise<IComputedValue<boolean>>;
+/**
+ * Whether a tool has the configuration it needs to run — the Custom kind's
+ * free-text command, for instance, is nothing until the user writes one.
+ *
+ * Registered only by the tools that need configuring; a tool with no registration
+ * needs none and is always ready. Registering one is also what makes a surface
+ * offer the tool's own `Settings`, so a tool can be configured where it is picked
+ * rather than in one place alone.
+ */
+export declare const aiToolIsConfiguredForKindInjectionToken: import("@k8slens/injectable").InjectionToken2Base<AiToolIsConfigured, () => Promise<IComputedValue<boolean>> | undefined, "zero-or-one", () => import("@k8slens/injectable").InjectionInstanceWithMeta<Promise<IComputedValue<boolean>>>, () => import("@k8slens/injectable").InjectionInstanceWithMeta<Promise<IComputedValue<boolean>>> | undefined> & {
+    readonly __abstract: true;
+    for: (kind: AiToolKind) => import("@k8slens/injectable").InjectionToken2Base<AiToolIsConfigured, () => Promise<IComputedValue<boolean>> | undefined, "zero-or-one", () => import("@k8slens/injectable").InjectionInstanceWithMeta<Promise<IComputedValue<boolean>>>, () => import("@k8slens/injectable").InjectionInstanceWithMeta<Promise<IComputedValue<boolean>>> | undefined> & {
+        readonly __abstract?: never;
+    } & {
+        speciality: any;
+    };
+};
+/** What one tool says about configuration of its own, as the surfaces that gate on it need it. */
+export interface AiToolConfigurationState {
+    /** Whether the tool has configuration to fill in at all. */
+    readonly isConfigurable: IComputedValue<boolean>;
+    /** Whether that configuration is there yet. */
+    readonly isConfigured: IComputedValue<boolean>;
+    /** Whether the tool may be picked: it either needs no configuration, or has it. */
+    readonly isReadyToSelect: IComputedValue<boolean>;
+}
+/** Resolves one tool's configuration state. */
+export type AiToolConfigurationStateFor = () => (kind: AiToolKind) => AiToolConfigurationState;
+/**
+ * Reads {@link aiToolIsConfiguredForKindInjectionToken} on behalf of every surface
+ * that gates on it — the AI tool button's menu and the preferences selector — so
+ * one rule is not enforced in one place and missed in another.
+ */
+export declare const aiToolConfigurationStateInjectionToken: import("@k8slens/injectable").InjectionToken2Base<AiToolConfigurationStateFor, () => ((kind: AiToolKind) => AiToolConfigurationState)[], "one", () => import("@k8slens/injectable").InjectionInstanceWithMeta<(kind: AiToolKind) => AiToolConfigurationState>, () => import("@k8slens/injectable").InjectionInstanceWithMeta<(kind: AiToolKind) => AiToolConfigurationState>[]> & {
+    readonly __abstract?: never;
+};
+//# sourceMappingURL=ai-tool-configuration.d.ts.map

package/dist/src/ai-tool-configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-tool-configuration.d.ts","sourceRoot":"","sources":["../../src/ai-tool-configuration.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,2BAA2B;;uBAAwC,UAAU;;EAEzF,CAAC;AAEF,uEAAuE;AACvE,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;AAExE;;;;;;;;GAQG;AACH,eAAO,MAAM,uCAAuC;;gBAG1C,UAAU;;;;;CAMnB,CAAC;AAEF,kGAAkG;AAClG,MAAM,WAAW,wBAAwB;IACvC,4DAA4D;IAC5D,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IACjD,+CAA+C;IAC/C,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAC/C,mFAAmF;IACnF,QAAQ,CAAC,eAAe,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;CACnD;AAED,+CAA+C;AAC/C,MAAM,MAAM,2BAA2B,GAAG,MAAM,CAAC,IAAI,EAAE,UAAU,KAAK,wBAAwB,CAAC;AAE/F;;;;GAIG;AACH,eAAO,MAAM,sCAAsC,+FAPI,UAAU,KAAK,wBAAwB;;CAY1F,CAAC"}

package/dist/src/ai-tool-description.d.ts

@@ -0,0 +1,25 @@
+import type React from "react";
+import type { AiToolKind } from "./ai-tool";
+/** Props a tool's description component receives, so it can adapt to detection state. */
+export interface AiToolDescriptionProps {
+    /** Whether the tool was detected as installed; lets a description swap in a "Not found in PATH" message. */
+    readonly isInstalled: boolean;
+}
+/** Resolves a kind's description component. */
+export type AiToolDescription = () => React.ComponentType<AiToolDescriptionProps>;
+/**
+ * Per-kind description for an AI tool — a short blurb introducing the tool (e.g.
+ * "The coding assistant by Anthropic"), shown as the selector's secondary line.
+ * A React component (not a string) receiving the tool's detection state, so it
+ * may include markup/links and opt to show a "Not found in PATH" message (or any
+ * other guidance) when the tool is not installed. Contribute one per tool kind.
+ */
+export declare const aiToolDescriptionInjectionToken: import("@k8slens/injectable").InjectionToken2Base<AiToolDescription, () => React.ComponentType<AiToolDescriptionProps>[], "zero-or-many", () => import("@k8slens/injectable").InjectionInstanceWithMeta<React.ComponentType<AiToolDescriptionProps>>, () => import("@k8slens/injectable").InjectionInstanceWithMeta<React.ComponentType<AiToolDescriptionProps>>[]> & {
+    readonly __abstract: true;
+    for: (kind: AiToolKind) => import("@k8slens/injectable").InjectionToken2Base<AiToolDescription, () => React.ComponentType<AiToolDescriptionProps>[], "one", () => import("@k8slens/injectable").InjectionInstanceWithMeta<React.ComponentType<AiToolDescriptionProps>>, () => import("@k8slens/injectable").InjectionInstanceWithMeta<React.ComponentType<AiToolDescriptionProps>>[]> & {
+        readonly __abstract?: never;
+    } & {
+        speciality: any;
+    };
+};
+//# sourceMappingURL=ai-tool-description.d.ts.map

package/dist/src/ai-tool-description.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-tool-description.d.ts","sourceRoot":"","sources":["../../src/ai-tool-description.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,yFAAyF;AACzF,MAAM,WAAW,sBAAsB;IACrC,4GAA4G;IAC5G,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED,+CAA+C;AAC/C,MAAM,MAAM,iBAAiB,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC,sBAAsB,CAAC,CAAC;AAElF;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B;;gBAGlC,UAAU;;;;;CAMnB,CAAC"}

package/dist/src/ai-tool-detection.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Re-scans AI tool installation state and updates {@link aiToolsInjectionToken}.
+ * Awaitable, so callers can act once detection settles.
+ */
+export type RefreshAiToolDetection = () => Promise<void>;
+/**
+ * Resolves the explicit "re-scan installed AI tools" action. Detection is never
+ * a side effect of injection: the preferences UI calls this on mount and from a
+ * "Refresh" control, and the launch path awaits it before resolving the
+ * effective tool — so tools installed/removed while Lens is running are picked
+ * up without a restart.
+ *
+ * Shaped as a factory returning the action (like `aiToolNameInjectionToken`) so
+ * it is consumable via `useInject` / `di.inject` — which return the action — and
+ * never needs `inject2` (absent from the React-context DI container).
+ */
+export declare const refreshAiToolDetectionInjectionToken: import("@k8slens/injectable").InjectionToken2Base<() => RefreshAiToolDetection, () => RefreshAiToolDetection[], "one", () => import("@k8slens/injectable").InjectionInstanceWithMeta<RefreshAiToolDetection>, () => import("@k8slens/injectable").InjectionInstanceWithMeta<RefreshAiToolDetection>[]> & {
+    readonly __abstract?: never;
+};
+//# sourceMappingURL=ai-tool-detection.d.ts.map

package/dist/src/ai-tool-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-tool-detection.d.ts","sourceRoot":"","sources":["../../src/ai-tool-detection.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAEzD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oCAAoC,0DAA6C,sBAAsB;;CAKjH,CAAC"}

package/dist/src/ai-tool-display-name.d.ts

@@ -0,0 +1,18 @@
+import type { AiToolKind } from "./ai-tool";
+/** Resolves the plain-text display name for a given AI tool kind. */
+export type AiToolDisplayName = () => string;
+/**
+ * Per-kind plain-text display name (e.g. "Claude Code"). Used by string-only
+ * slots that cannot render the React `aiToolNameInjectionToken` component — for
+ * example the command-palette entry title. The React name component derives
+ * from this same value, so the two stay in sync.
+ */
+export declare const aiToolDisplayNameInjectionToken: import("@k8slens/injectable").InjectionToken2Base<AiToolDisplayName, () => string[], "zero-or-many", () => import("@k8slens/injectable").InjectionInstanceWithMeta<string>, () => import("@k8slens/injectable").InjectionInstanceWithMeta<string>[]> & {
+    readonly __abstract: true;
+    for: (kind: AiToolKind) => import("@k8slens/injectable").InjectionToken2Base<AiToolDisplayName, () => string[], "one", () => import("@k8slens/injectable").InjectionInstanceWithMeta<string>, () => import("@k8slens/injectable").InjectionInstanceWithMeta<string>[]> & {
+        readonly __abstract?: never;
+    } & {
+        speciality: any;
+    };
+};
+//# sourceMappingURL=ai-tool-display-name.d.ts.map

package/dist/src/ai-tool-display-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-tool-display-name.d.ts","sourceRoot":"","sources":["../../src/ai-tool-display-name.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,qEAAqE;AACrE,MAAM,MAAM,iBAAiB,GAAG,MAAM,MAAM,CAAC;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B;;gBAGlC,UAAU;;;;;CAMnB,CAAC"}