@lesliechan721/aw 0.1.0-beta.4 → 0.1.0-beta.6

package/dist/src/tui/controller.d.ts

@@ -1,12 +1,12 @@
 import type { CatalogSource, PlatformName, Scope } from '../types.js';
 import type { PortableReview } from '../portable/commands.js';
 import type { CatalogSourceUpdate } from '../utils/catalog-sources.js';
-import type { StatusV4Payload, StatusV4PluginSummary } from '../commands/status-v4.js';
+import type { StatusV4Payload, StatusV4PluginSummary, StatusTargetRevision } from '../commands/status-v4.js';
 import type { ProjectConfigStoreLayer } from '../utils/plugin-config.js';
 import type { DependencyOperationPlan } from '../commands/dependency-operation-plan.js';
 import type { RebuildProgressFeed, RebuildProgressSnapshot } from '../output/rebuild-progress.js';
 import { type ConfigPageViewModel, type ConfigGroupViewModel, type PluginListItemViewModel, type PluginDependencyOverviewViewModel, type PortableSkillSelectionViewModel, type SourceHealthViewModel, type SourceDetailViewModel, type TuiViewModel, type UserIssueCategory, type UserIssueViewModel } from './model.js';
-import { type PortableBlockerCode, type TuiPageContext, type TuiRoute, type TuiRouterSnapshot } from './router.js';
+import { type PluginInstallFilter, type PortableBlockerCode, type TuiPageContext, type TuiRoute, type TuiRouterSnapshot } from './router.js';
 export type PluginWriteOperation = 'install' | 'upgrade' | 'reinstall' | 'uninstall' | 'cleanup';
 export type OperationKind = OperationIntent['kind'];
 export interface IssueOrigin {
@@ -134,6 +134,21 @@ export interface OperationReviewModel {
     primaryLabel: string;
     destructive?: boolean;
 }
+export type ReviewPreparationStageId = 'validate' | 'status' | 'catalog' | 'inventory' | 'dependencyPlan' | 'config' | 'portable' | 'evidence';
+export interface ReviewPreparationStage {
+    id: ReviewPreparationStageId;
+    label: string;
+    state: 'pending' | 'running' | 'completed' | 'failed';
+}
+export interface ReviewPreparationSnapshot {
+    id: string;
+    intent: OperationIntent;
+    state: 'running' | 'failed';
+    stages: ReviewPreparationStage[];
+    currentLabel: string;
+    code?: 'reviewPreparationFailed';
+    message?: string;
+}
 export type OperationExecuteResult = {
     state: 'succeeded';
     operationId: string;
@@ -179,6 +194,7 @@ export type OperationExecuteResult = {
     originIssue?: IssueOrigin;
     writeMayHaveCompleted?: boolean;
     verification?: 'issueStillPresent' | 'verificationFailed';
+    summary?: OperationResultSummary;
 };
 export interface OperationResultSummary {
     code: 'operationSucceeded' | 'operationPartial' | 'operationFailed';
@@ -193,6 +209,7 @@ export interface OperationResultSummary {
         requestedAgents: string[];
         scope: Scope;
         materializationDigest: string;
+        skillsCliVersion: string;
         missing: Array<{
             skill: string;
             agent?: string;
@@ -208,6 +225,7 @@ export interface OperationResultSummary {
         state: 'completed' | 'kept' | 'failed' | 'skipped';
         relation?: 'requested' | 'direct' | 'transitive';
         requiredBy?: string[];
+        errorCode?: 'dependencyStillRequired';
     }>;
 }
 export interface PluginOperationProgressLine {
@@ -221,10 +239,16 @@ export interface PluginOperationProgressLine {
 export interface TuiStatusLoadResult {
     payload: StatusV4Payload;
     pluginSummaries: StatusV4PluginSummary[];
+    targetRevisions?: StatusTargetRevision[];
     sourceDetails?: SourceDetailViewModel[];
     dependencyOverviews?: PluginDependencyOverviewViewModel[];
     portablePluginIds?: string[];
 }
+export interface InstallTargetOption {
+    platform: PlatformName;
+    compatible: boolean;
+    disabled?: string;
+}
 export interface SourceReferenceSummaryViewModel {
     blocked: boolean;
     inventoryComplete: boolean;
@@ -249,6 +273,7 @@ export interface TuiControllerDependencies {
     inspectSourceRemoval?: (sourceId: string, signal: AbortSignal) => Promise<SourceReferenceSummaryViewModel>;
     captureEvidence: (intent: OperationIntent, signal?: AbortSignal) => Promise<OperationEvidence>;
     validateIntent?: (intent: OperationIntent, signal: AbortSignal) => Promise<void>;
+    prepareReviewEvidence?: (intent: OperationIntent, signal: AbortSignal, onStage: (stage: ReviewPreparationStageId) => void | Promise<void>) => Promise<OperationEvidence>;
     executeIntent: (intent: OperationIntent, expectedEvidence: OperationEvidence) => Promise<unknown>;
     getConfigGroups?: (pluginId: string, layer: {
         scope: Scope;
@@ -284,6 +309,7 @@ export interface TuiControllerSnapshot {
     progress: RebuildProgressSnapshot;
     progressTargets: PluginOperationProgressLine[];
     activeReview?: OperationReviewModel;
+    reviewPreparation?: ReviewPreparationSnapshot;
     result?: OperationExecuteResult;
     loadError?: {
         code: string;
@@ -322,8 +348,11 @@ export declare class TuiController {
     setPortableAgentMode(mode: 'automatic' | 'explicit', requestedAgents?: string[]): void;
     setPortableScope(scope: Scope): void;
     buildPortableInstallReview(): Promise<OperationReviewModel>;
+    startPortableInstallReviewPreparation(): ReviewPreparationSnapshot;
     discardPortableDraft(): void;
     replace(route: TuiRoute, context?: TuiPageContext): void;
+    beginConfigFlow(pluginId: string): void;
+    configOrigin(pluginId: string): TuiRoute | undefined;
     updatePageContext(context: Partial<TuiPageContext>): void;
     back(): void;
     discardSourceDraft(owner: string, returnRoute: Extract<TuiRoute, {
@@ -335,11 +364,13 @@ export declare class TuiController {
         mode: 'browse' | 'installed';
         sourceId?: string;
         query?: string;
+        installFilter?: PluginInstallFilter;
     }): PluginListItemViewModel[];
     getPluginOverview(pluginId: string): PluginListItemViewModel | undefined;
     getPluginDependencyOverview(pluginId: string): PluginDependencyOverviewViewModel | undefined;
     getBlockingDependents(pluginId: string, platform: PlatformName, scope: Scope): PluginDependencyOverviewViewModel['dependents'];
     getPlatformPlacement(pluginId: string, platform: PlatformName): PluginListItemViewModel['installedPlacements'][number] | undefined;
+    listInstallTargets(pluginId: string, scope: Scope): InstallTargetOption[];
     getTargetState(pluginId: string, platform: PlatformName, scope: Scope): StatusV4Payload['targets'][number]['state'] | undefined;
     listSources(): TuiViewModel['sourceTabs'];
     getSourceOverview(sourceId: string): {
@@ -362,6 +393,8 @@ export declare class TuiController {
     }): Promise<ConfigResetAvailability>;
     listUserIssues(): UserIssueViewModel[];
     buildOperationReview(intent: OperationIntent, returnRoute?: TuiRoute): Promise<OperationReviewModel>;
+    startReviewPreparation(intent: OperationIntent, returnRoute?: TuiRoute): ReviewPreparationSnapshot;
+    retryReviewPreparation(): ReviewPreparationSnapshot | undefined;
     executeOperation(reviewToken: string): Promise<OperationExecuteResult>;
     dispose(): void;
 }