relay-dsh-plugin-manager 0.2.5 → 0.3.0

package/lib/index.d.ts

@@ -1,4 +1,4 @@
-import { a as PluginSearchRuntime, c as PluginSource, i as PluginSearchRequest, l as inspectPluginSource, n as PluginSearchMatch, o as FetchOptions, r as PluginSearchProvider, s as PluginInspection, t as PluginSearchCandidate } from "./search-runtime-DsmnI673.js";
+import { a as PluginSearchRuntime, c as PluginSource, i as PluginSearchRequest, l as inspectPluginSource, n as PluginSearchMatch, o as FetchOptions, r as PluginSearchProvider, s as PluginInspection, t as PluginSearchCandidate } from "./search-runtime-gzUZ5Yb3.js";
 import { spawn } from "node:child_process";
 import { Context } from "@deepseek-ai/cordis";
 
@@ -12,6 +12,52 @@ interface TelemetryConfig {
   enabled?: boolean;
   /** Registry telemetry endpoint. Only the canonical service or localhost is accepted. */
   endpoint?: string;
+  /** Marks an operator-controlled acceptance run so analytics can exclude it. */
+  test?: boolean;
+}
+//#endregion
+//#region src/search.d.ts
+interface SearchResultSource {
+  inspection: PluginInspection;
+  providers: string[];
+  evidence: string[];
+}
+interface SearchResult {
+  query: string;
+  candidates: Array<{
+    rank: number;
+    identity: string;
+    packageName: string;
+    description: string | null;
+    repository: string | null;
+    repositoryOwner: string | null;
+    providers: string[];
+    matchReasons: string[];
+    semanticMatches: Array<{
+      directoryVersion: string | null;
+      canonicalPathKey: string | null;
+      canonicalPath: string[];
+      matchedCapabilities: string[];
+      retrievalSources: string[];
+    }>;
+    sources: SearchResultSource[];
+    recommendedSource: string;
+  }>;
+  presentation: {
+    order: 'rank_ascending';
+    returnedCandidates: number;
+    requestedMaximum: number;
+    includeEveryDistinctRelevantSolution: true;
+    excludeClearlyIrrelevant: true;
+    deduplicateEquivalentSources: true;
+    padToRequestedMaximum: false;
+    silentTopNTruncation: false;
+  };
+  providerErrors: Array<{
+    provider: string;
+    error: string;
+  }>;
+  rejectedCandidates: number;
 }
 //#endregion
 //#region src/profile.d.ts
@@ -223,6 +269,88 @@ declare class DshRestarter {
   };
 }
 //#endregion
+//#region src/task-solutions.d.ts
+interface TaskRoleInput {
+  id: string;
+  label: string;
+  query: string;
+  required?: boolean;
+}
+interface TaskRole {
+  id: string;
+  label: string;
+  query: string;
+  required: boolean;
+}
+interface TaskAmbiguityInput {
+  id: string;
+  question: string;
+  options: string[];
+}
+type TaskSolutionCandidate = Omit<SearchResult['candidates'][number], 'sources'>;
+interface TaskRoleSearchGroup extends TaskRole {
+  candidates: TaskSolutionCandidate[];
+  providerErrors: SearchResult['providerErrors'];
+  rejectedCandidates: number;
+}
+interface TaskSolutionDraft {
+  schemaVersion: '1.0.0';
+  solutionId: string;
+  task: string;
+  status: 'needs_review' | 'incomplete' | 'ambiguous';
+  createdAt: number;
+  expiresAt: number;
+  roles: TaskRoleSearchGroup[];
+  ambiguities: TaskAmbiguityInput[];
+}
+interface TaskRoleSelection {
+  roleId: string;
+  candidateIdentities: string[];
+}
+interface AssessedTaskRole extends TaskRole {
+  status: 'covered' | 'missing_required' | 'missing_optional';
+  primaryCandidateIdentity: string | null;
+  alternativeCandidateIdentities: string[];
+}
+interface TaskSolutionAssessment {
+  schemaVersion: '1.0.0';
+  solutionId: string;
+  task: string;
+  status: 'complete' | 'incomplete' | 'ambiguous';
+  roles: AssessedTaskRole[];
+  ambiguities: TaskAmbiguityInput[];
+  solutions: Array<TaskSolutionCandidate & {
+    roleIds: string[];
+  }>;
+  coverage: {
+    requiredRoles: number;
+    coveredRequiredRoles: number;
+    optionalRoles: number;
+    coveredOptionalRoles: number;
+    missingRequiredRoleIds: string[];
+    complete: boolean;
+  };
+}
+interface TaskSolutionStoreOptions {
+  now?: () => number;
+  id?: () => string;
+  ttlMs?: number;
+}
+declare class TaskSolutionStore {
+  private readonly now;
+  private readonly id;
+  private readonly ttlMs;
+  private readonly drafts;
+  constructor(options?: TaskSolutionStoreOptions);
+  create(input: {
+    task: string;
+    roles: TaskRoleInput[];
+    ambiguities?: TaskAmbiguityInput[];
+    searches: Record<string, SearchResult>;
+  }): TaskSolutionDraft;
+  assess(solutionIdValue: string, selectionValues: TaskRoleSelection[]): TaskSolutionAssessment;
+}
+//#endregion
 //#region src/manager.d.ts
 interface LoaderEntryLike {
   id?: string;
@@ -251,13 +379,19 @@ interface PluginManagerDependencies {
   fetchOptions?: Omit<FetchOptions, 'signal'>;
   hmrTimeoutMs?: number;
   telemetry?: Telemetry;
+  taskSolutions?: TaskSolutionStore;
 }
 interface DiscoverRequest {
-  action: 'list' | 'search' | 'inspect' | 'status';
+  action: 'list' | 'search' | 'search_roles' | 'assess_solution' | 'inspect' | 'status';
   query?: string;
   target?: string;
   operationId?: string;
   maxResults?: number;
+  maxResultsPerRole?: number;
+  roles?: TaskRoleInput[];
+  ambiguities?: TaskAmbiguityInput[];
+  solutionId?: string;
+  selections?: TaskRoleSelection[];
 }
 interface PlanRequest {
   operation: PlanAction;
@@ -315,6 +449,7 @@ declare class PluginManager {
   private readonly fetchOptions;
   private readonly hmrTimeoutMs;
   private readonly telemetry;
+  private readonly taskSolutions;
   constructor(dependencies: PluginManagerDependencies);
   private capture;
   private loaderEntries;
@@ -350,5 +485,5 @@ interface Config {
 }
 declare function apply(ctx: Context, config?: Config): void;
 //#endregion
-export { Config, DEFAULT_REGISTRY_ORIGIN, type DiscoverRequest, type InstallManyItemResult, type InstallManyItemStatus, type InstallManyResult, type MutationResult, type PlanRequest, type PluginInspection, PluginManager, type PluginSearchCandidate, type PluginSearchMatch, type PluginSearchProvider, type PluginSearchRequest, type PluginSource, type TelemetryConfig, apply, inject, name };
+export { Config, DEFAULT_REGISTRY_ORIGIN, type DiscoverRequest, type InstallManyItemResult, type InstallManyItemStatus, type InstallManyResult, type MutationResult, type PlanRequest, type PluginInspection, PluginManager, type PluginSearchCandidate, type PluginSearchMatch, type PluginSearchProvider, type PluginSearchRequest, type PluginSource, type TaskAmbiguityInput, type TaskRoleInput, type TaskRoleSelection, type TaskSolutionAssessment, type TaskSolutionDraft, type TelemetryConfig, apply, inject, name };
 //# sourceMappingURL=index.d.ts.map