@praxisui/ai 8.0.0-beta.0 → 8.0.0-beta.11

package/index.d.ts

@@ -1,8 +1,9 @@
 import * as i0 from '@angular/core';
-import { OnDestroy, ElementRef, OnInit, ChangeDetectorRef } from '@angular/core';
-import { Schema } from '@google/generative-ai';
+import { InjectionToken, OnDestroy, ElementRef, OnChanges, EventEmitter, SimpleChanges, OnInit, ChangeDetectorRef } from '@angular/core';
+import * as rxjs from 'rxjs';
 import { Observable } from 'rxjs';
-import { CdkOverlayOrigin } from '@angular/cdk/overlay';
+import { Schema } from '@google/generative-ai';
+import { ConnectedPosition, CdkOverlayOrigin } from '@angular/cdk/overlay';
 import * as _praxisui_ai from '@praxisui/ai';
 import { MatDialogRef } from '@angular/material/dialog';
 import { MatSnackBar } from '@angular/material/snack-bar';
@@ -12,6 +13,13 @@ declare class PraxisAi {
     static ɵcmp: i0.ɵɵComponentDeclaration<PraxisAi, "lib-praxis-ai", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * Generated from praxis-config-starter/docs/ai/contracts/praxis-ai-api-contract-v1.1.openapi.yaml.
+ * Do not edit manually. Run praxis-config-starter/tools/contracts/generate-ai-contract-bindings.js.
+ */
+declare const AI_CONTRACT_VERSION: "v1.1";
+declare const AI_CONTRACT_SCHEMA_HASH: "dacaba8fa7ec21ee9ae31bab7057614837d2d1320d784d0ee61fb840efe55a35";
+declare const AI_STREAM_EVENT_SCHEMA_VERSION: "v1";
 declare const AI_STREAM_EVENT_TYPES: readonly ["status", "thought.step", "heartbeat", "result", "error", "cancelled"];
 type AiJsonPrimitive = string | number | boolean | null;
 type AiJsonArray = AiJsonValue[];
@@ -98,6 +106,7 @@ interface AiOrchestratorResponseContract {
     contractVersion?: string | null;
     schemaHash?: string | null;
     patch?: AiJsonObject | null;
+    componentEditPlan?: AiJsonObject | null;
     diff?: AiPatchDiffContract[] | null;
     explanation?: string | null;
     warnings?: string[] | null;
@@ -113,6 +122,180 @@ interface AiOrchestratorResponseContract {
     allowedValues?: string[] | null;
     memory?: AiMemoryInfoContract;
 }
+interface AgenticAuthoringConversationMessageContract {
+    id?: string | null;
+    role: 'user' | 'assistant' | 'system';
+    text?: string | null;
+    createdAt?: string | null;
+}
+interface AgenticAuthoringPendingClarificationContract {
+    sourcePrompt?: string | null;
+    questions?: string[];
+    assistantMessage?: string | null;
+    clientTurnId?: string | null;
+    diagnostics?: AiJsonObject | null;
+}
+interface AgenticAuthoringAttachmentSummaryContract {
+    id: string;
+    name: string;
+    kind: string;
+    mimeType?: string | null;
+    sizeBytes?: number | null;
+    source?: string | null;
+    hasPreview?: boolean;
+}
+interface AgenticAuthoringConversationContextContract {
+    sessionId?: string | null;
+    clientTurnId?: string | null;
+    conversationMessages?: AgenticAuthoringConversationMessageContract[];
+    pendingClarification?: AgenticAuthoringPendingClarificationContract | null;
+    attachmentSummaries?: AgenticAuthoringAttachmentSummaryContract[];
+}
+interface AgenticAuthoringIntentResolutionRequestContract extends AgenticAuthoringConversationContextContract {
+    userPrompt: string;
+    targetApp?: string | null;
+    targetComponentId?: string | null;
+    currentRoute?: string | null;
+    currentPage?: AiJsonObject | null;
+    selectedWidgetKey?: string | null;
+    provider?: string | null;
+    model?: string | null;
+    apiKey?: string | null;
+    contextHints?: AiJsonObject | null;
+}
+interface AgenticAuthoringCandidateContract {
+    resourcePath?: string | null;
+    operation?: string | null;
+    schemaUrl?: string | null;
+    submitUrl?: string | null;
+    submitMethod?: string | null;
+    score?: number | null;
+    reason?: string | null;
+    evidence?: string[] | null;
+    [key: string]: AiJsonValue | undefined;
+}
+interface AgenticAuthoringQuickReplyContract {
+    id: string;
+    kind: string;
+    label: string;
+    prompt: string;
+    description?: string | null;
+    icon?: string | null;
+    tone?: string | null;
+    contextHints?: AiJsonObject | null;
+    [key: string]: AiJsonValue | undefined;
+}
+interface AgenticAuthoringIntentResolutionResultContract {
+    valid?: boolean;
+    operationKind?: string | null;
+    artifactKind?: string | null;
+    changeKind?: string | null;
+    selectedCandidate?: AgenticAuthoringCandidateContract | null;
+    candidates?: AgenticAuthoringCandidateContract[];
+    gate?: AiJsonObject | null;
+    effectivePrompt?: string | null;
+    assistantMessage?: string | null;
+    quickReplies?: AgenticAuthoringQuickReplyContract[];
+    pendingClarification?: AgenticAuthoringPendingClarificationContract | null;
+    clarificationQuestions?: string[];
+    warnings?: string[];
+    failureCodes?: string[];
+    llmDiagnostics?: AiJsonObject | null;
+    [key: string]: AiJsonValue | AgenticAuthoringCandidateContract | AgenticAuthoringCandidateContract[] | AgenticAuthoringQuickReplyContract | AgenticAuthoringQuickReplyContract[] | AgenticAuthoringPendingClarificationContract | undefined;
+}
+interface AgenticAuthoringResourceCandidatesRequestContract {
+    retrievalQuery?: string | null;
+    userPrompt?: string | null;
+    artifactKind?: string | null;
+    limit?: number | null;
+    [key: string]: AiJsonValue | undefined;
+}
+interface AgenticAuthoringResourceCandidatesResultContract {
+    valid?: boolean;
+    tool?: string | null;
+    retrievalQuery?: string | null;
+    artifactKind?: string | null;
+    assistantMessage?: string | null;
+    candidates?: AgenticAuthoringCandidateContract[];
+    quickReplies?: AgenticAuthoringQuickReplyContract[];
+    warnings?: string[];
+    [key: string]: AiJsonValue | AgenticAuthoringCandidateContract[] | AgenticAuthoringQuickReplyContract[] | undefined;
+}
+interface AgenticAuthoringPlanRequestContract extends AgenticAuthoringConversationContextContract {
+    userPrompt: string;
+    provider?: string | null;
+    model?: string | null;
+    apiKey?: string | null;
+    currentPage?: AiJsonObject | null;
+    intentResolution?: AgenticAuthoringIntentResolutionResultContract | null;
+    contextHints?: AiJsonObject | null;
+}
+interface AgenticAuthoringTurnStreamRequestContract extends AgenticAuthoringConversationContextContract {
+    userPrompt: string;
+    targetApp?: string | null;
+    targetComponentId?: string | null;
+    currentRoute?: string | null;
+    currentPage?: AiJsonObject | null;
+    selectedWidgetKey?: string | null;
+    provider?: string | null;
+    model?: string | null;
+    apiKey?: string | null;
+    contextHints?: AiJsonObject | null;
+    componentCapabilities?: AgenticAuthoringComponentCapabilitiesResultContract | null;
+    [key: string]: AiJsonValue | AgenticAuthoringComponentCapabilitiesResultContract | AgenticAuthoringConversationMessageContract[] | AgenticAuthoringPendingClarificationContract | AgenticAuthoringAttachmentSummaryContract[] | undefined;
+}
+interface AgenticAuthoringPreviewResultContract {
+    valid?: boolean;
+    warnings?: string[];
+    minimalFormPlan?: AiJsonObject | null;
+    compiledFormPatch?: AiJsonObject | null;
+    uiCompositionPlan?: AiJsonObject | null;
+    diagnostics?: AiJsonObject | null;
+    [key: string]: AiJsonValue | undefined;
+}
+interface AgenticAuthoringApplyRequestContract {
+    componentType: string;
+    componentId: string;
+    scope?: string | null;
+    payload: AiJsonObject;
+    tags?: AiJsonObject | null;
+    [key: string]: AiJsonValue | undefined;
+}
+interface AgenticAuthoringApplyResultContract {
+    applied?: boolean;
+    etag?: string | null;
+    [key: string]: AiJsonValue | undefined;
+}
+interface AgenticAuthoringComponentFieldAliasContract {
+    field?: string | null;
+    aliases?: string[];
+    [key: string]: AiJsonValue | undefined;
+}
+interface AgenticAuthoringComponentCapabilityExampleContract {
+    prompt?: string | null;
+    intent?: string | null;
+    configHints?: string[];
+    [key: string]: AiJsonValue | undefined;
+}
+interface AgenticAuthoringComponentCapabilityContract {
+    id?: string | null;
+    changeKind?: string | null;
+    triggerTerms?: string[];
+    fieldAliases?: AgenticAuthoringComponentFieldAliasContract[];
+    examples?: AgenticAuthoringComponentCapabilityExampleContract[];
+    [key: string]: AiJsonValue | AgenticAuthoringComponentFieldAliasContract[] | AgenticAuthoringComponentCapabilityExampleContract[] | undefined;
+}
+interface AgenticAuthoringComponentCapabilityCatalogContract {
+    componentId?: string | null;
+    version?: string | null;
+    capabilities?: AgenticAuthoringComponentCapabilityContract[];
+    [key: string]: AiJsonValue | AgenticAuthoringComponentCapabilityContract[] | undefined;
+}
+interface AgenticAuthoringComponentCapabilitiesResultContract {
+    version?: string | null;
+    catalogs?: AgenticAuthoringComponentCapabilityCatalogContract[];
+    [key: string]: AiJsonValue | AgenticAuthoringComponentCapabilityCatalogContract[] | undefined;
+}
 interface AiPatchStreamStartResponseContract {
     streamId: string;
     threadId: string;
@@ -123,6 +306,16 @@ interface AiPatchStreamStartResponseContract {
     expiresAt: string;
     fallbackPatchUrl: string;
 }
+interface AgenticAuthoringTurnStreamStartResponseContract {
+    streamId: string;
+    threadId: string;
+    turnId: string;
+    eventSchemaVersion: string;
+    streamAuthMode?: 'cookie' | 'signed_url_token' | null;
+    streamAccessToken?: string | null;
+    expiresAt: string;
+    fallbackAuthoringUrl: string;
+}
 interface AiPatchStreamCancelResponseContract {
     streamId?: string | null;
     threadId?: string | null;
@@ -141,7 +334,19 @@ interface AiPatchStreamEnvelopeContract<TPayload extends AiJsonObject = AiJsonOb
     type: AiPatchStreamEventType$1;
     payload: TPayload;
 }
+interface AgenticAuthoringTurnStreamEnvelopeContract<TPayload extends AiJsonObject = AiJsonObject> extends AiPatchStreamEnvelopeContract<TPayload> {
+}
+interface ProblemResponseContract {
+    timestamp?: string | null;
+    status?: number | null;
+    error?: string | null;
+    message?: string | null;
+    path?: string | null;
+    detail?: string | null;
+    [key: string]: AiJsonValue | undefined;
+}
 type AiPatchStreamEventType$1 = (typeof AI_STREAM_EVENT_TYPES)[number];
+type AiTurnStreamEventType = (typeof AI_STREAM_EVENT_TYPES)[number];
 
 /**
  * Models for Praxis AI (Centralized)
@@ -282,6 +487,192 @@ interface RulePropertyDefinition {
 }
 type RulePropertySchema = Record<'field' | 'section' | 'action' | 'row' | 'column', RulePropertyDefinition[]>;
 
+type PraxisAssistantShellMessageRole = 'user' | 'assistant' | 'system' | 'status' | 'error';
+type PraxisAssistantShellMode = 'config' | 'agentic-authoring' | 'chat' | 'diagnostic' | 'review' | 'inline-help';
+type PraxisAssistantShellState = 'idle' | 'listening' | 'processing' | 'clarification' | 'review' | 'applying' | 'success' | 'error';
+interface PraxisAssistantShellMessage {
+    id: string;
+    role: PraxisAssistantShellMessageRole;
+    text: string;
+    status?: 'pending' | 'done' | 'error';
+    editable?: boolean;
+    resendable?: boolean;
+    actions?: readonly PraxisAssistantShellMessageAction[];
+}
+interface PraxisAssistantShellQuickReply {
+    id: string;
+    label: string;
+    prompt: string;
+    kind?: string;
+    description?: string | null;
+    icon?: string | null;
+    tone?: string | null;
+    contextHints?: Readonly<Record<string, unknown>> | null;
+}
+interface PraxisAssistantShellMessageAction {
+    id: string;
+    label: string;
+    kind?: 'edit' | 'resend' | 'copy' | 'custom' | string;
+    disabled?: boolean;
+}
+interface PraxisAssistantShellContextItem {
+    id: string;
+    label: string;
+    value?: string;
+    kind?: 'component' | 'schema' | 'selection' | 'route' | 'tenant' | 'mode' | 'custom' | string;
+    icon?: string;
+}
+interface PraxisAssistantShellAttachment {
+    id: string;
+    name: string;
+    kind: 'image' | 'file' | 'json' | 'schema' | 'text' | string;
+    mimeType?: string;
+    sizeBytes?: number;
+    file?: File;
+    previewUrl?: string;
+    source?: 'paste' | 'file-picker' | 'host' | string;
+    status?: 'ready' | 'uploading' | 'error';
+    error?: string;
+}
+interface PraxisAssistantShellLayout {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+interface PraxisAssistantShellLabels {
+    title: string;
+    subtitle?: string;
+    close: string;
+    prompt: string;
+    promptPlaceholder: string;
+    emptyConversation: string;
+    submit: string;
+    apply: string;
+    conversationAria: string;
+    quickRepliesAria: string;
+    dragHandleAria: string;
+    resizeHandleAria: string;
+    contextAria: string;
+    attachmentsAria: string;
+    attach: string;
+    removeAttachment: string;
+    editMessage: string;
+    resendMessage: string;
+    modeConfig: string;
+    modeAgenticAuthoring: string;
+    modeChat: string;
+    modeDiagnostic: string;
+    modeReview: string;
+    modeInlineHelp: string;
+    stateIdle: string;
+    stateListening: string;
+    stateProcessing: string;
+    stateClarification: string;
+    stateReview: string;
+    stateApplying: string;
+    stateSuccess: string;
+    stateError: string;
+}
+
+type PraxisAssistantTurnPhase = 'capture' | 'contextualize' | 'clarify' | 'plan' | 'preview' | 'review' | 'apply' | 'summarize';
+type PraxisAssistantClarificationQuestionType = 'text' | 'single-choice' | 'multi-choice' | 'confirm' | 'resource' | 'field' | 'schema' | 'date-range' | 'number' | 'color' | 'component';
+interface PraxisAssistantClarificationOption {
+    id: string;
+    label: string;
+    value: string;
+    description?: string;
+    contextHints?: Record<string, unknown>;
+}
+interface PraxisAssistantClarificationQuestion {
+    id: string;
+    type: PraxisAssistantClarificationQuestionType;
+    label: string;
+    description?: string;
+    required?: boolean;
+    allowCustom?: boolean;
+    options?: readonly PraxisAssistantClarificationOption[];
+}
+interface PraxisAssistantTurnAction {
+    kind: 'submit' | 'clarify' | 'apply' | 'cancel' | 'retry' | 'edit-message' | 'resend-message' | 'attach' | 'remove-attachment' | string;
+    id?: string;
+    value?: unknown;
+    contextHints?: Record<string, unknown>;
+}
+interface PraxisAssistantPendingClarification {
+    sourcePrompt: string;
+    questions: readonly PraxisAssistantClarificationQuestion[];
+    assistantMessage?: string;
+    clientTurnId?: string;
+    diagnostics?: Record<string, unknown>;
+}
+interface PraxisAssistantTurnRequest {
+    mode: PraxisAssistantShellMode;
+    phase?: PraxisAssistantTurnPhase;
+    prompt?: string;
+    action?: PraxisAssistantTurnAction;
+    sessionId?: string;
+    clientTurnId?: string;
+    componentId?: string;
+    componentType?: string;
+    messages?: readonly PraxisAssistantShellMessage[];
+    contextItems?: readonly PraxisAssistantShellContextItem[];
+    attachments?: readonly PraxisAssistantShellAttachment[];
+    currentState?: unknown;
+    runtimeState?: unknown;
+    schemaFields?: unknown;
+    dataProfile?: unknown;
+    contextHints?: Record<string, unknown>;
+    preview?: unknown;
+    pendingPatch?: unknown;
+    pendingClarification?: PraxisAssistantPendingClarification;
+}
+interface PraxisAssistantTurnResult {
+    state: PraxisAssistantShellState;
+    phase?: PraxisAssistantTurnPhase;
+    assistantMessage?: string;
+    messages?: readonly PraxisAssistantShellMessage[];
+    quickReplies?: readonly PraxisAssistantShellQuickReply[];
+    clarificationQuestions?: readonly PraxisAssistantClarificationQuestion[];
+    contextItems?: readonly PraxisAssistantShellContextItem[];
+    attachments?: readonly PraxisAssistantShellAttachment[];
+    canApply?: boolean;
+    statusText?: string;
+    errorText?: string;
+    preview?: unknown;
+    pendingPatch?: unknown;
+    pendingClarification?: PraxisAssistantPendingClarification | null;
+    sessionId?: string;
+    clientTurnId?: string;
+    diagnostics?: Record<string, unknown>;
+}
+interface PraxisAssistantTurnViewState {
+    mode: PraxisAssistantShellMode;
+    state: PraxisAssistantShellState;
+    phase: PraxisAssistantTurnPhase;
+    sessionId?: string;
+    clientTurnId?: string;
+    messages: PraxisAssistantShellMessage[];
+    quickReplies: PraxisAssistantShellQuickReply[];
+    clarificationQuestions: PraxisAssistantClarificationQuestion[];
+    contextItems: PraxisAssistantShellContextItem[];
+    attachments: PraxisAssistantShellAttachment[];
+    canApply: boolean;
+    statusText: string;
+    errorText: string;
+    preview?: unknown;
+    pendingPatch?: unknown;
+    pendingClarification?: PraxisAssistantPendingClarification;
+    diagnostics?: Record<string, unknown>;
+}
+interface PraxisAssistantTurnFlow {
+    readonly mode: PraxisAssistantShellMode;
+    submit(request: PraxisAssistantTurnRequest): Promise<PraxisAssistantTurnResult> | rxjs.Observable<PraxisAssistantTurnResult>;
+    apply?(request: PraxisAssistantTurnRequest): Promise<PraxisAssistantTurnResult> | rxjs.Observable<PraxisAssistantTurnResult>;
+    cancel?(request: PraxisAssistantTurnRequest): Promise<PraxisAssistantTurnResult> | rxjs.Observable<PraxisAssistantTurnResult>;
+    retry?(request: PraxisAssistantTurnRequest): Promise<PraxisAssistantTurnResult> | rxjs.Observable<PraxisAssistantTurnResult>;
+}
+
 interface PatchResult {
     success: boolean;
     warnings?: string[];
@@ -300,6 +691,13 @@ interface AiSuggestion {
     contextHints?: Record<string, unknown> | null;
     missingContext?: string[];
 }
+interface AiResponseCompileResult {
+    patch?: AiJsonObject;
+    explanation?: string;
+    type?: 'error';
+    message?: string;
+    warnings?: string[];
+}
 /**
  * Contrato fundamental para qualquer componente que suporte configuração via IA.
  * O Agente de IA usa esta interface para Ler (Introspecção) e Escrever (Patching) no componente.
@@ -352,12 +750,24 @@ interface AiConfigAdapter<TConfig = any> {
      * Usado para sugestões heurísticas mais precisas no backend.
      */
     getSchemaFields?(): Record<string, any>[];
+    /**
+     * Retorna contexto declarativo adicional para authoring assistido por IA.
+     * Deve conter contratos validaveis e instrucoes especificas do componente
+     * que o backend pode incluir em contextHints sem conhecer a lib concreta.
+     */
+    getAuthoringContext?(): AiJsonObject | null | undefined;
     /**
      * Retorna um snapshot do estado de tempo de execução (volátil).
      * Ex: { rowCount: 50, isLoading: false, sort: 'name:asc' }.
      * Usado para responder perguntas do usuário ("Por que está vazio?").
-     */
+    */
     getRuntimeState?(): Record<string, any>;
+    /**
+     * Compila respostas declarativas especificas do componente em patch canonico.
+     * Ex.: uma tabela pode transformar "componentEditPlan" em alteracoes validadas de colunas.
+     * Retorne null/undefined quando a resposta ja estiver no contrato comum do assistente.
+     */
+    compileAiResponse?(response: Record<string, unknown>): AiResponseCompileResult | null | undefined;
     /**
      * Cria um snapshot do estado atual para fins de Undo.
      * Retorna um token opaco (pode ser o config JSON completo ou um ID).
@@ -392,6 +802,8 @@ declare abstract class BaseAiAdapter<TConfig = any> implements AiConfigAdapter<T
     getSuggestions(_forceReload?: boolean): Promise<AiSuggestion[]>;
     getSuggestionContext?(): Record<string, any>;
     getRuntimeState?(): Record<string, any>;
+    getAuthoringContext?(): Record<string, any> | null;
+    compileAiResponse?(_response: Record<string, unknown>): AiResponseCompileResult | null;
     /**
      * Helper to validate a patch against the capabilities catalog.
      * Removes keys that are not in the allowed paths.
@@ -453,8 +865,6 @@ declare class PraxisAiService {
     generateContentStream(prompt: string, modelName?: string): Observable<string>;
     generateJson<T>(prompt: string, modelName?: string, schema?: any): Observable<T | null>;
     isMockMode(): boolean;
-    private extractUserIntent;
-    private getMockPatch;
     listModels(apiKey?: string): Observable<AiModel[]>;
     testConnection(apiKey?: string, model?: string): Observable<boolean>;
     private resolveProvider;
@@ -464,7 +874,7 @@ declare class PraxisAiService {
 }
 
 declare const AI_INTENT_CONTRACT_VERSION: "v1.1";
-declare const AI_INTENT_CONTRACT_SCHEMA_HASH: "51b7901f1df633d89fc019a2e41f675cc5b87b135dfc8335aa96e53205034b26";
+declare const AI_INTENT_CONTRACT_SCHEMA_HASH: "dacaba8fa7ec21ee9ae31bab7057614837d2d1320d784d0ee61fb840efe55a35";
 type AiSchemaContext = AiSchemaContextContract;
 interface AiSuggestionsRequest {
     componentId: string;
@@ -583,6 +993,18 @@ interface AiGlobalConfigSnapshot {
     gatewayUrl?: string;
     riskPolicy?: string;
 }
+interface AiBackendConfigStore {
+    getAiConfigSnapshot?: () => AiGlobalConfigSnapshot | null | undefined;
+    aiConfigChanges$?: Observable<AiGlobalConfigSnapshot | null>;
+    saveAiConfig?: (config: AiGlobalConfigSnapshot) => Promise<void>;
+}
+interface AiBackendStorageOptions {
+    headersFactory?: () => Record<string, string | undefined>;
+    defaultHeaders?: Record<string, string>;
+    allowLocalIdentityFallback?: boolean;
+}
+declare const AI_BACKEND_CONFIG_STORE: InjectionToken<AiBackendConfigStore>;
+declare const AI_BACKEND_STORAGE_OPTIONS: InjectionToken<AiBackendStorageOptions>;
 declare class AiBackendApiService {
     private readonly http;
     private readonly globalConfigStore;
@@ -640,6 +1062,61 @@ declare class AiResponseValidatorService {
     static ɵprov: i0.ɵɵInjectableDeclaration<AiResponseValidatorService>;
 }
 
+interface PraxisAssistantTurnControllerOptions {
+    componentId?: string;
+    componentType?: string;
+    sessionId?: string;
+    contextItems?: readonly PraxisAssistantShellContextItem[];
+    attachments?: readonly PraxisAssistantShellAttachment[];
+    currentState?: unknown;
+    runtimeState?: unknown;
+    schemaFields?: unknown;
+    dataProfile?: unknown;
+    contextHints?: Record<string, unknown>;
+}
+declare class PraxisAssistantTurnOrchestratorService {
+    createController(flow: PraxisAssistantTurnFlow, options?: PraxisAssistantTurnControllerOptions): PraxisAssistantTurnController;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisAssistantTurnOrchestratorService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<PraxisAssistantTurnOrchestratorService>;
+}
+declare class PraxisAssistantTurnController {
+    private readonly flow;
+    private readonly options;
+    private readonly stateSubject;
+    readonly state$: Observable<PraxisAssistantTurnViewState>;
+    constructor(flow: PraxisAssistantTurnFlow, options: PraxisAssistantTurnControllerOptions);
+    snapshot(): PraxisAssistantTurnViewState;
+    setContextItems(items: readonly PraxisAssistantShellContextItem[]): void;
+    setMessages(messages: readonly PraxisAssistantShellMessage[]): void;
+    setAttachments(attachments: readonly PraxisAssistantShellAttachment[]): void;
+    addAttachment(attachment: PraxisAssistantShellAttachment): void;
+    removeAttachment(id: string): void;
+    editMessage(messageId: string, text: string): void;
+    resendMessage(messageId: string): Observable<PraxisAssistantTurnViewState>;
+    submitEditedMessage(messageId: string, text: string): Observable<PraxisAssistantTurnViewState>;
+    submitPrompt(prompt: string, action?: PraxisAssistantTurnAction): Observable<PraxisAssistantTurnViewState>;
+    answerClarification(option: PraxisAssistantClarificationOption | string): Observable<PraxisAssistantTurnViewState>;
+    apply(): Observable<PraxisAssistantTurnViewState>;
+    retry(): Observable<PraxisAssistantTurnViewState>;
+    cancel(): Observable<PraxisAssistantTurnViewState>;
+    private runFlow;
+    private buildRequest;
+    private submitExistingUserMessage;
+    private findUserMessageIndex;
+    private resetReplayState;
+    private applyResult;
+    private resolveSubmitAction;
+    private buildPendingClarification;
+    private resolvePendingClarificationSourcePrompt;
+    private resolveMessageRole;
+    private resolvePhase;
+    private buildMessage;
+    private createId;
+    private patchState;
+    private cloneState;
+    private toObservable;
+}
+
 type AssistantMessageRole = 'user' | 'assistant' | 'system';
 interface AssistantHistoryMessage {
     id: string;
@@ -694,6 +1171,7 @@ declare class PraxisAiAssistantComponent implements OnDestroy {
     adapter: AiConfigAdapter;
     riskPolicy: RiskPolicy | null;
     allowManualPatchEdit: boolean;
+    readonly overlayPositions: ConnectedPosition[];
     overlayOrigin: CdkOverlayOrigin;
     triggerButton?: ElementRef<HTMLButtonElement>;
     inputElement: ElementRef<HTMLInputElement>;
@@ -965,6 +1443,7 @@ declare class PraxisAiAssistantComponent implements OnDestroy {
     private closeActiveStreamConnection;
     private resetStreamTracking;
     private shouldFallbackToPatch;
+    private compileAdapterResponse;
     private handlePatchResponse;
     private initHistory;
     private buildHistoryWarnings;
@@ -1066,6 +1545,102 @@ declare class PraxisAiAssistantComponent implements OnDestroy {
     static ɵcmp: i0.ɵɵComponentDeclaration<PraxisAiAssistantComponent, "praxis-ai-assistant", never, { "adapter": { "alias": "adapter"; "required": true; }; "riskPolicy": { "alias": "riskPolicy"; "required": false; }; "allowManualPatchEdit": { "alias": "allowManualPatchEdit"; "required": false; }; }, {}, never, never, true, never>;
 }
 
+declare class PraxisAiAssistantShellComponent implements OnChanges, OnDestroy {
+    labels: Partial<PraxisAssistantShellLabels> | null;
+    mode: PraxisAssistantShellMode;
+    state: PraxisAssistantShellState;
+    contextItems: readonly PraxisAssistantShellContextItem[];
+    attachments: readonly PraxisAssistantShellAttachment[];
+    messages: readonly PraxisAssistantShellMessage[];
+    quickReplies: readonly PraxisAssistantShellQuickReply[];
+    prompt: string;
+    statusText: string;
+    errorText: string;
+    testIdPrefix: string;
+    panelTestId: string;
+    submitTestId: string;
+    applyTestId: string;
+    busy: boolean;
+    canSubmit: boolean;
+    canApply: boolean;
+    submitOnEnter: boolean;
+    enableFileAttachments: boolean;
+    attachmentAccept: string;
+    attachmentMultiple: boolean;
+    draggable: boolean;
+    resizable: boolean;
+    minWidth: number;
+    minHeight: number;
+    margin: number;
+    layout: PraxisAssistantShellLayout;
+    promptChange: EventEmitter<string>;
+    submitPrompt: EventEmitter<string>;
+    apply: EventEmitter<void>;
+    close: EventEmitter<void>;
+    attach: EventEmitter<void>;
+    attachmentsPasted: EventEmitter<PraxisAssistantShellAttachment[]>;
+    attachmentsSelected: EventEmitter<PraxisAssistantShellAttachment[]>;
+    removeAttachment: EventEmitter<PraxisAssistantShellAttachment>;
+    messageAction: EventEmitter<{
+        message: PraxisAssistantShellMessage;
+        action: PraxisAssistantShellMessageAction;
+    }>;
+    editMessage: EventEmitter<PraxisAssistantShellMessage>;
+    resendMessage: EventEmitter<PraxisAssistantShellMessage>;
+    quickReply: EventEmitter<PraxisAssistantShellQuickReply>;
+    layoutChange: EventEmitter<PraxisAssistantShellLayout>;
+    panel?: ElementRef<HTMLElement>;
+    conversation?: ElementRef<HTMLElement>;
+    private readonly cdr;
+    protected currentPrompt: string;
+    protected resolvedLabels: PraxisAssistantShellLabels;
+    protected currentLayout: PraxisAssistantShellLayout;
+    private pointerSession;
+    private readonly ownedPreviewUrls;
+    private readonly onWindowPointerMove;
+    private readonly onWindowPointerUp;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    protected onPromptInput(value: string): void;
+    protected onSubmit(): void;
+    protected onPromptKeydown(event: KeyboardEvent): void;
+    protected onPromptPaste(event: ClipboardEvent): void;
+    protected onAttachClick(fileInput: HTMLInputElement): void;
+    protected onAttachmentFilesSelected(event: Event): void;
+    protected onApply(): void;
+    protected onQuickReply(reply: PraxisAssistantShellQuickReply): void;
+    protected getQuickReplyAriaLabel(reply: PraxisAssistantShellQuickReply): string;
+    protected getQuickReplyTone(reply: PraxisAssistantShellQuickReply): string;
+    protected onRemoveAttachment(attachment: PraxisAssistantShellAttachment): void;
+    protected onMessageAction(message: PraxisAssistantShellMessage, action: PraxisAssistantShellMessageAction): void;
+    protected getModeLabel(): string;
+    protected getStateLabel(): string;
+    protected startDrag(event: PointerEvent): void;
+    protected startResize(event: PointerEvent): void;
+    protected trackMessage(_index: number, message: PraxisAssistantShellMessage): string;
+    protected trackMessageAction(_index: number, action: PraxisAssistantShellMessageAction): string;
+    protected trackQuickReply(_index: number, reply: PraxisAssistantShellQuickReply): string;
+    protected trackContextItem(_index: number, item: PraxisAssistantShellContextItem): string;
+    protected trackAttachment(_index: number, attachment: PraxisAssistantShellAttachment): string;
+    private startPointerSession;
+    private handlePointerMove;
+    private finishPointerSession;
+    private detachPointerListeners;
+    private resolveBounds;
+    private normalizeLayout;
+    private clampLayout;
+    private clamp;
+    private scheduleConversationScroll;
+    private fileAttachment;
+    private createAttachmentId;
+    private attachmentKind;
+    private revokeDetachedPastedPreviewUrls;
+    private revokeAllOwnedPreviewUrls;
+    private revokeOwnedPreviewUrl;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisAiAssistantShellComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisAiAssistantShellComponent, "praxis-ai-assistant-shell", never, { "labels": { "alias": "labels"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; "state": { "alias": "state"; "required": false; }; "contextItems": { "alias": "contextItems"; "required": false; }; "attachments": { "alias": "attachments"; "required": false; }; "messages": { "alias": "messages"; "required": false; }; "quickReplies": { "alias": "quickReplies"; "required": false; }; "prompt": { "alias": "prompt"; "required": false; }; "statusText": { "alias": "statusText"; "required": false; }; "errorText": { "alias": "errorText"; "required": false; }; "testIdPrefix": { "alias": "testIdPrefix"; "required": false; }; "panelTestId": { "alias": "panelTestId"; "required": false; }; "submitTestId": { "alias": "submitTestId"; "required": false; }; "applyTestId": { "alias": "applyTestId"; "required": false; }; "busy": { "alias": "busy"; "required": false; }; "canSubmit": { "alias": "canSubmit"; "required": false; }; "canApply": { "alias": "canApply"; "required": false; }; "submitOnEnter": { "alias": "submitOnEnter"; "required": false; }; "enableFileAttachments": { "alias": "enableFileAttachments"; "required": false; }; "attachmentAccept": { "alias": "attachmentAccept"; "required": false; }; "attachmentMultiple": { "alias": "attachmentMultiple"; "required": false; }; "draggable": { "alias": "draggable"; "required": false; }; "resizable": { "alias": "resizable"; "required": false; }; "minWidth": { "alias": "minWidth"; "required": false; }; "minHeight": { "alias": "minHeight"; "required": false; }; "margin": { "alias": "margin"; "required": false; }; "layout": { "alias": "layout"; "required": false; }; }, { "promptChange": "promptChange"; "submitPrompt": "submitPrompt"; "apply": "apply"; "close": "close"; "attach": "attach"; "attachmentsPasted": "attachmentsPasted"; "attachmentsSelected": "attachmentsSelected"; "removeAttachment": "removeAttachment"; "messageAction": "messageAction"; "editMessage": "editMessage"; "resendMessage": "resendMessage"; "quickReply": "quickReply"; "layoutChange": "layoutChange"; }, never, never, true, never>;
+}
+
 declare class AiContextBuilderService {
     private schemaMinifier;
     constructor(schemaMinifier: SchemaMinifierService);
@@ -1137,5 +1712,5 @@ declare class AiRuleWizardDialogComponent implements OnInit {
     static ɵcmp: i0.ɵɵComponentDeclaration<AiRuleWizardDialogComponent, "praxis-ai-rule-wizard-dialog", never, {}, {}, never, never, true, never>;
 }
 
-export { AI_INTENT_CONTRACT_SCHEMA_HASH, AI_INTENT_CONTRACT_VERSION, AiBackendApiService, AiPatchStreamConnectionError, AiResponseValidatorService, AiRuleWizardDialogComponent, BaseAiAdapter, PraxisAi, PraxisAiAssistantComponent, PraxisAiService, SchemaMinifierService };
-export type { AiChatMessage, AiConfigAdapter, AiContextDTO, AiContextTemplate, AiContextTemplateMeta, AiCurrentStateDigest, AiExamplePair, AiGlobalConfigSnapshot, AiHeaderContext, AiIntegrationConfig, AiModel, AiOrchestratorRequest, AiOrchestratorResponse, AiPatchDiff, AiPatchStreamCancelResponse, AiPatchStreamConnection, AiPatchStreamConnectionErrorKind, AiPatchStreamEnvelope, AiPatchStreamEventType, AiPatchStreamStartResponse, AiProviderCatalogItem, AiProviderCatalogResponse, AiProviderModelsRequest, AiProviderModelsResponse, AiProviderStatusResponse, AiProviderTestRequest, AiProviderTestResponse, AiRuleResponse, AiSchemaContext, AiSuggestion, AiSuggestionsRequest, AiSuggestionsResponse, AiUiContextRef, AiValidationError, AiValidationResult, AiValidationWarning, AiWizardData, Capability, FieldSchemaLike, MinifiedField, PatchResult, PromptContext, RulePropertyDefinition, RulePropertySchema, RulePropertyType, ValidationContext, ValueKind };
+export { AI_BACKEND_CONFIG_STORE, AI_BACKEND_STORAGE_OPTIONS, AI_CONTRACT_SCHEMA_HASH, AI_CONTRACT_VERSION, AI_INTENT_CONTRACT_SCHEMA_HASH, AI_INTENT_CONTRACT_VERSION, AI_STREAM_EVENT_SCHEMA_VERSION, AI_STREAM_EVENT_TYPES, AiBackendApiService, AiPatchStreamConnectionError, AiResponseValidatorService, AiRuleWizardDialogComponent, BaseAiAdapter, PraxisAi, PraxisAiAssistantComponent, PraxisAiAssistantShellComponent, PraxisAiService, PraxisAssistantTurnController, PraxisAssistantTurnOrchestratorService, SchemaMinifierService };
+export type { AgenticAuthoringApplyRequestContract, AgenticAuthoringApplyResultContract, AgenticAuthoringAttachmentSummaryContract, AgenticAuthoringCandidateContract, AgenticAuthoringComponentCapabilitiesResultContract, AgenticAuthoringComponentCapabilityCatalogContract, AgenticAuthoringComponentCapabilityContract, AgenticAuthoringComponentCapabilityExampleContract, AgenticAuthoringComponentFieldAliasContract, AgenticAuthoringConversationContextContract, AgenticAuthoringConversationMessageContract, AgenticAuthoringIntentResolutionRequestContract, AgenticAuthoringIntentResolutionResultContract, AgenticAuthoringPendingClarificationContract, AgenticAuthoringPlanRequestContract, AgenticAuthoringPreviewResultContract, AgenticAuthoringQuickReplyContract, AgenticAuthoringResourceCandidatesRequestContract, AgenticAuthoringResourceCandidatesResultContract, AgenticAuthoringTurnStreamEnvelopeContract, AgenticAuthoringTurnStreamRequestContract, AgenticAuthoringTurnStreamStartResponseContract, AiBackendConfigStore, AiBackendStorageOptions, AiChatMessage, AiChatMessageContract, AiClarificationUiContract, AiConfigAdapter, AiContextDTO, AiContextTemplate, AiContextTemplateMeta, AiCurrentStateDigest, AiCurrentStateDigestContract, AiExamplePair, AiGlobalConfigSnapshot, AiHeaderContext, AiIntegrationConfig, AiJsonArray, AiJsonObject, AiJsonPrimitive, AiJsonValue, AiMemoryInfoContract, AiModel, AiOptionContract, AiOrchestratorRequest, AiOrchestratorRequestContract, AiOrchestratorResponse, AiOrchestratorResponseContract, AiOrchestratorResponseType, AiPatchDiff, AiPatchDiffContract, AiPatchStreamCancelResponse, AiPatchStreamCancelResponseContract, AiPatchStreamConnection, AiPatchStreamConnectionErrorKind, AiPatchStreamEnvelope, AiPatchStreamEnvelopeContract, AiPatchStreamEventType, AiPatchStreamStartResponse, AiPatchStreamStartResponseContract, AiProviderCatalogItem, AiProviderCatalogResponse, AiProviderModelsRequest, AiProviderModelsResponse, AiProviderStatusResponse, AiProviderTestRequest, AiProviderTestResponse, AiResponseCompileResult, AiRuleResponse, AiSchemaContext, AiSchemaContextContract, AiSuggestion, AiSuggestionsRequest, AiSuggestionsResponse, AiTurnStreamEventType, AiUiContextRef, AiUiContextRefContract, AiValidationError, AiValidationResult, AiValidationWarning, AiWizardData, Capability, FieldSchemaLike, MinifiedField, PatchResult, PraxisAssistantClarificationOption, PraxisAssistantClarificationQuestion, PraxisAssistantClarificationQuestionType, PraxisAssistantPendingClarification, PraxisAssistantShellAttachment, PraxisAssistantShellContextItem, PraxisAssistantShellLabels, PraxisAssistantShellLayout, PraxisAssistantShellMessage, PraxisAssistantShellMessageAction, PraxisAssistantShellMessageRole, PraxisAssistantShellMode, PraxisAssistantShellQuickReply, PraxisAssistantShellState, PraxisAssistantTurnAction, PraxisAssistantTurnControllerOptions, PraxisAssistantTurnFlow, PraxisAssistantTurnPhase, PraxisAssistantTurnRequest, PraxisAssistantTurnResult, PraxisAssistantTurnViewState, ProblemResponseContract, PromptContext, RulePropertyDefinition, RulePropertySchema, RulePropertyType, ValidationContext, ValueKind };