@praxisui/ai 8.0.0-beta.1 → 8.0.0-beta.101

package/{index.d.ts → types/praxisui-ai.d.ts}

@@ -18,8 +18,9 @@ declare class PraxisAi {
  * 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: "922e6d48637e64b403562d6d7cb833ed4942ffb0b452ec3573255871f4ec8739";
+declare const AI_CONTRACT_SCHEMA_HASH: "41767dafdf6ebea802c083d77187ad6612937d6831188938dc21adce384b57a2";
 declare const AI_STREAM_EVENT_SCHEMA_VERSION: "v1";
+declare const AI_DOMAIN_CATALOG_CONTEXT_HINT_SCHEMA_VERSION: "praxis.ai.context-hints.domain-catalog/v0.2";
 declare const AI_STREAM_EVENT_TYPES: readonly ["status", "thought.step", "heartbeat", "result", "error", "cancelled"];
 type AiJsonPrimitive = string | number | boolean | null;
 type AiJsonArray = AiJsonValue[];
@@ -27,6 +28,41 @@ interface AiJsonObject {
     [key: string]: AiJsonValue;
 }
 type AiJsonValue = AiJsonPrimitive | AiJsonObject | AiJsonArray;
+type AiDomainCatalogContextHintItemType = 'context' | 'node' | 'edge' | 'binding' | 'evidence' | 'governance' | 'vocabulary' | 'relationship';
+type AiDomainCatalogContextHintIntent = 'authoring' | 'explain' | 'validate' | 'ai-access-control';
+type AiDomainCatalogRecommendedAuthoringFlow = 'shared_rule_authoring' | 'component_authoring' | 'ui_composition_authoring';
+type AiDomainCatalogRecommendedRuleType = 'privacy' | 'compliance' | 'validation' | 'selection_eligibility' | 'workflow_action_policy' | 'approval_policy' | string;
+interface AiDomainCatalogRelationshipHintContract {
+    enabled?: boolean;
+    federated?: boolean;
+    serviceKey?: string | null;
+    sourceNodeKey?: string | null;
+    targetNodeKey?: string | null;
+    edgeType?: string | null;
+    query?: string | null;
+    limit?: number;
+}
+interface AiDomainCatalogContextHintContract {
+    schemaVersion?: typeof AI_DOMAIN_CATALOG_CONTEXT_HINT_SCHEMA_VERSION;
+    serviceKey?: string;
+    resourceKey?: string | null;
+    releaseId?: string | null;
+    releaseKey?: string | null;
+    type?: AiDomainCatalogContextHintItemType;
+    itemTypes?: AiDomainCatalogContextHintItemType[];
+    intent?: AiDomainCatalogContextHintIntent | null;
+    query?: string | null;
+    contextKey?: string | null;
+    nodeType?: string | null;
+    recommendedAuthoringFlow?: AiDomainCatalogRecommendedAuthoringFlow | null;
+    recommendedRuleType?: AiDomainCatalogRecommendedRuleType | null;
+    limit?: number;
+    relationships?: AiDomainCatalogRelationshipHintContract | null;
+}
+interface AiContextHintsContract {
+    domainCatalog?: AiDomainCatalogContextHintContract;
+    [key: string]: AiJsonValue | AiDomainCatalogContextHintContract | undefined;
+}
 interface AiSchemaContextContract {
     path?: string | null;
     operation?: string | null;
@@ -64,7 +100,7 @@ interface AiOrchestratorRequestContract {
     schemaFields?: AiJsonObject[] | null;
     runtimeState?: AiJsonObject | null;
     suggestedPatch?: AiJsonObject | null;
-    contextHints?: AiJsonObject | null;
+    contextHints?: AiContextHintsContract | null;
     aiMode?: string;
     requireSchema?: boolean;
     resourcePath?: string;
@@ -75,6 +111,7 @@ interface AiOrchestratorRequestContract {
     apiMethod?: string;
     apiTags?: string;
     apiSearchLimit?: number;
+    observationId?: string;
 }
 type AiOrchestratorResponseType = 'patch' | 'clarification' | 'error' | 'info';
 interface AiPatchDiffContract {
@@ -86,7 +123,7 @@ interface AiOptionContract {
     value?: string | null;
     label?: string | null;
     example?: string | null;
-    contextHints?: AiJsonObject | null;
+    contextHints?: AiContextHintsContract | null;
 }
 interface AiClarificationUiContract {
     responseType?: 'text' | 'choice' | 'confirm' | 'mixed' | 'context';
@@ -121,6 +158,67 @@ interface AiOrchestratorResponseContract {
     providedValue?: AiJsonValue;
     allowedValues?: string[] | null;
     memory?: AiMemoryInfoContract;
+    observationId?: string | null;
+}
+type AiAssistantObservationFeedbackRating = 'positive' | 'negative' | 'inaccurate' | 'unsafe' | 'irrelevant' | 'incomplete';
+interface AiAssistantObservationFeedbackRequestContract {
+    rating?: AiAssistantObservationFeedbackRating;
+    reasonCode?: string | null;
+    comment?: string | null;
+}
+interface AiAssistantObservationFeedbackResponseContract {
+    feedbackId?: string | null;
+    observationId?: string | null;
+    rating?: string | null;
+    reasonCode?: string | null;
+    commentPreview?: string | null;
+    createdAt?: string | null;
+}
+interface AiAssistantObservationResponseContract {
+    observationId?: string | null;
+    requestId?: string | null;
+    tenantId?: string | null;
+    environment?: string | null;
+    userId?: string | null;
+    surface?: string | null;
+    componentId?: string | null;
+    componentType?: string | null;
+    routeKey?: string | null;
+    variantId?: string | null;
+    schemaHash?: string | null;
+    contractVersion?: string | null;
+    sessionId?: string | null;
+    clientTurnId?: string | null;
+    threadId?: string | null;
+    turnId?: string | null;
+    streamId?: string | null;
+    promptHash?: string | null;
+    promptPreview?: string | null;
+    promptLength?: number | null;
+    admissionOutcome?: string | null;
+    terminalOutcome?: string | null;
+    qualityOutcome?: string | null;
+    errorCategory?: string | null;
+    errorCode?: string | null;
+    errorMessagePreview?: string | null;
+    provider?: string | null;
+    model?: string | null;
+    llmCallCount?: number | null;
+    latencyMs?: number | null;
+    createdAt?: string | null;
+    updatedAt?: string | null;
+    feedback?: AiAssistantObservationFeedbackResponseContract[];
+}
+interface AiAssistantObservationSummaryRowContract {
+    admissionOutcome?: string | null;
+    terminalOutcome?: string | null;
+    qualityOutcome?: string | null;
+    componentId?: string | null;
+    componentType?: string | null;
+    total?: number | null;
+}
+interface AiAssistantObservationSummaryResponseContract {
+    rows?: AiAssistantObservationSummaryRowContract[];
 }
 interface AgenticAuthoringConversationMessageContract {
     id?: string | null;
@@ -161,6 +259,7 @@ interface AgenticAuthoringIntentResolutionRequestContract extends AgenticAuthori
     provider?: string | null;
     model?: string | null;
     apiKey?: string | null;
+    contextHints?: AiContextHintsContract | null;
 }
 interface AgenticAuthoringCandidateContract {
     resourcePath?: string | null;
@@ -178,8 +277,83 @@ interface AgenticAuthoringQuickReplyContract {
     kind: string;
     label: string;
     prompt: string;
+    description?: string | null;
+    icon?: string | null;
+    tone?: string | null;
+    contextHints?: AiContextHintsContract | null;
+    [key: string]: AiJsonValue | AiContextHintsContract | undefined;
+}
+interface AgenticAuthoringSemanticSelectedResourceContract {
+    resourcePath?: string | null;
+    operation?: string | null;
+    schemaUrl?: string | null;
+    submitUrl?: string | null;
+    submitMethod?: string | null;
     [key: string]: AiJsonValue | undefined;
 }
+interface AgenticAuthoringSemanticRetrievalEvidenceContract {
+    retrievalSource?: string | null;
+    evidence?: string[];
+    candidateCount?: number;
+    [key: string]: AiJsonValue | undefined;
+}
+interface AgenticAuthoringEvidenceBundleEvidenceContract {
+    source?: string | null;
+    kind?: string | null;
+    ref?: string | null;
+    summary?: string | null;
+    confidence?: number | null;
+    matchedTerms?: string[];
+    tenantId?: string | null;
+    environment?: string | null;
+    releaseId?: string | null;
+    [key: string]: AiJsonValue | undefined;
+}
+interface AgenticAuthoringEvidenceBundleContract {
+    schemaVersion?: string | null;
+    retrievalSource?: string | null;
+    evidence?: AgenticAuthoringEvidenceBundleEvidenceContract[];
+    evidenceCount?: number;
+    [key: string]: AiJsonValue | AgenticAuthoringEvidenceBundleEvidenceContract[] | undefined;
+}
+interface AgenticAuthoringSemanticRefinementContract {
+    schemaVersion?: string | null;
+    refinementKind?: 'visual_projection' | 'data_source' | 'filtering' | 'layout' | 'metric' | 'copy' | 'governance' | string | null;
+    preserve?: string[];
+    replace?: Record<string, string>;
+    add?: Record<string, string[]>;
+    remove?: string[];
+    rationale?: string | null;
+    confidence?: number | null;
+    [key: string]: AiJsonValue | Record<string, string> | Record<string, string[]> | undefined;
+}
+interface AgenticAuthoringSemanticDecisionContract {
+    schemaVersion?: string | null;
+    decisionId?: string | null;
+    operationKind?: string | null;
+    artifactKind?: string | null;
+    changeKind?: string | null;
+    selectedResource?: AgenticAuthoringSemanticSelectedResourceContract | null;
+    visualizationDecision?: AgenticAuthoringVisualizationDecisionContract | null;
+    retrievalEvidence?: AgenticAuthoringSemanticRetrievalEvidenceContract | null;
+    retrievedEvidence?: AgenticAuthoringEvidenceBundleContract | null;
+    reviewRequired?: boolean | null;
+    reviewReason?: string | null;
+    previousDecisionRef?: string | null;
+    refinementOf?: string | null;
+    conversationId?: string | null;
+    turnId?: string | null;
+    userGoal?: string | null;
+    activeObjective?: string | null;
+    artifactIntent?: string | null;
+    visualIntent?: string | null;
+    constraints?: AiJsonObject | null;
+    refinement?: AgenticAuthoringSemanticRefinementContract | null;
+    previousDecisionId?: string | null;
+    rationale?: string | null;
+    confidence?: number | null;
+    [key: string]: AiJsonValue | AgenticAuthoringSemanticSelectedResourceContract | AgenticAuthoringSemanticRetrievalEvidenceContract | AgenticAuthoringEvidenceBundleContract | AgenticAuthoringSemanticRefinementContract | AgenticAuthoringVisualizationDecisionContract | undefined;
+}
 interface AgenticAuthoringIntentResolutionResultContract {
     valid?: boolean;
     operationKind?: string | null;
@@ -190,12 +364,61 @@ interface AgenticAuthoringIntentResolutionResultContract {
     gate?: AiJsonObject | null;
     effectivePrompt?: string | null;
     assistantMessage?: string | null;
+    assistantContent?: AiJsonObject | null;
     quickReplies?: AgenticAuthoringQuickReplyContract[];
     pendingClarification?: AgenticAuthoringPendingClarificationContract | null;
     clarificationQuestions?: string[];
     warnings?: string[];
     failureCodes?: string[];
-    [key: string]: AiJsonValue | AgenticAuthoringCandidateContract | AgenticAuthoringCandidateContract[] | AgenticAuthoringQuickReplyContract | AgenticAuthoringQuickReplyContract[] | AgenticAuthoringPendingClarificationContract | undefined;
+    llmDiagnostics?: AiJsonObject | null;
+    semanticDecision?: AgenticAuthoringSemanticDecisionContract | null;
+    visualizationDecision?: AgenticAuthoringVisualizationDecisionContract | null;
+    [key: string]: AiJsonValue | AgenticAuthoringCandidateContract | AgenticAuthoringCandidateContract[] | AgenticAuthoringQuickReplyContract | AgenticAuthoringQuickReplyContract[] | AgenticAuthoringPendingClarificationContract | AgenticAuthoringSemanticDecisionContract | AgenticAuthoringVisualizationDecisionContract | undefined;
+}
+interface AgenticAuthoringVisualizationAxisDecisionContract {
+    concept?: string | null;
+    field?: string | null;
+    label?: string | null;
+    chartType?: string | null;
+    orientation?: string | null;
+    metricAggregation?: string | null;
+    metricField?: string | null;
+    metricLabel?: string | null;
+    provenance?: string | null;
+    [key: string]: AiJsonValue | undefined;
+}
+interface AgenticAuthoringVisualizationDecisionContract {
+    schemaVersion?: string | null;
+    intent?: string | null;
+    layoutKind?: string | null;
+    primaryComponent?: string | null;
+    axes?: AgenticAuthoringVisualizationAxisDecisionContract[];
+    includeSummary?: boolean | null;
+    includeDetailTable?: boolean | null;
+    excludedComponentIds?: string[];
+    includeFilters?: boolean | null;
+    includeKpis?: boolean | null;
+    provenance?: string | null;
+    [key: string]: AiJsonValue | AgenticAuthoringVisualizationAxisDecisionContract[] | string[] | 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;
+    assistantContent?: AiJsonObject | null;
+    candidates?: AgenticAuthoringCandidateContract[];
+    quickReplies?: AgenticAuthoringQuickReplyContract[];
+    warnings?: string[];
+    [key: string]: AiJsonValue | AgenticAuthoringCandidateContract[] | AgenticAuthoringQuickReplyContract[] | undefined;
 }
 interface AgenticAuthoringPlanRequestContract extends AgenticAuthoringConversationContextContract {
     userPrompt: string;
@@ -204,6 +427,22 @@ interface AgenticAuthoringPlanRequestContract extends AgenticAuthoringConversati
     apiKey?: string | null;
     currentPage?: AiJsonObject | null;
     intentResolution?: AgenticAuthoringIntentResolutionResultContract | null;
+    contextHints?: AiContextHintsContract | 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?: AiContextHintsContract | null;
+    componentCapabilities?: AgenticAuthoringComponentCapabilitiesResultContract | null;
+    activeSemanticDecision?: AgenticAuthoringSemanticDecisionContract | null;
+    [key: string]: AiJsonValue | AiContextHintsContract | AgenticAuthoringComponentCapabilitiesResultContract | AgenticAuthoringSemanticDecisionContract | AgenticAuthoringConversationMessageContract[] | AgenticAuthoringPendingClarificationContract | AgenticAuthoringAttachmentSummaryContract[] | undefined;
 }
 interface AgenticAuthoringPreviewResultContract {
     valid?: boolean;
@@ -218,19 +457,79 @@ interface AgenticAuthoringApplyRequestContract {
     componentType: string;
     componentId: string;
     scope?: string | null;
-    payload: AiJsonObject;
+    compiledFormPatch: AiJsonObject;
     tags?: AiJsonObject | null;
-    [key: string]: AiJsonValue | undefined;
+    semanticDecision: AgenticAuthoringSemanticDecisionContract;
+    [key: string]: AiJsonValue | AgenticAuthoringSemanticDecisionContract | 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?: AiJsonObject[];
-    [key: string]: AiJsonValue | undefined;
+    catalogs?: AgenticAuthoringComponentCapabilityCatalogContract[];
+    [key: string]: AiJsonValue | AgenticAuthoringComponentCapabilityCatalogContract[] | undefined;
+}
+interface AgenticAuthoringManifestEditPlanRequestContract {
+    config?: AiJsonObject | null;
+    plan?: AiJsonObject | null;
+    validationContext?: AiJsonObject | null;
+}
+interface AgenticAuthoringResolveTargetRequestContract {
+    config?: AiJsonObject | null;
+    operationId?: string | null;
+    target?: AiJsonValue;
+    input?: AiJsonValue;
+}
+interface AgenticAuthoringResolvedTargetContract {
+    status?: string | null;
+    componentId?: string | null;
+    operationId?: string | null;
+    kind?: string | null;
+    resolver?: string | null;
+    path?: string | null;
+    value?: AiJsonValue;
+    candidates?: string[];
+    failures?: string[];
+}
+interface AgenticAuthoringManifestValidationResultContract {
+    valid?: boolean;
+    failures?: string[];
+    warnings?: string[];
+    normalizedPlan?: AiJsonObject | null;
+}
+interface AgenticAuthoringManifestCompileResultContract {
+    compiled?: boolean;
+    failures?: string[];
+    warnings?: string[];
+    patch?: AiJsonObject | null;
 }
 interface AiPatchStreamStartResponseContract {
     streamId: string;
@@ -239,9 +538,21 @@ interface AiPatchStreamStartResponseContract {
     eventSchemaVersion: string;
     streamAuthMode?: 'cookie' | 'signed_url_token' | null;
     streamAccessToken?: string | null;
+    observationId?: string | null;
     expiresAt: string;
     fallbackPatchUrl: string;
 }
+interface AgenticAuthoringTurnStreamStartResponseContract {
+    streamId: string;
+    threadId: string;
+    turnId: string;
+    eventSchemaVersion: string;
+    streamAuthMode?: 'cookie' | 'signed_url_token' | null;
+    streamAccessToken?: string | null;
+    observationId?: string | null;
+    expiresAt: string;
+    fallbackAuthoringUrl: string;
+}
 interface AiPatchStreamCancelResponseContract {
     streamId?: string | null;
     threadId?: string | null;
@@ -260,6 +571,8 @@ 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;
@@ -270,6 +583,7 @@ interface ProblemResponseContract {
     [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,7 +596,7 @@ interface AiRuleResponse {
     /** Descriptive name for the rule */
     ruleName: string;
     /** Type of target (scope) */
-    targetType: 'field' | 'section' | 'action' | 'row' | 'column';
+    targetType: 'field' | 'section' | 'action' | 'row' | 'column' | 'visualBlock';
     /** IDs of the target elements */
     targetIds: string[];
     /** Canonical JSON Logic condition payload or null for always applied */
@@ -408,11 +722,125 @@ interface RulePropertyDefinition {
     }>;
     category?: 'content' | 'appearance' | 'behavior' | 'layout' | 'validation';
 }
-type RulePropertySchema = Record<'field' | 'section' | 'action' | 'row' | 'column', RulePropertyDefinition[]>;
+type RulePropertySchema = Record<'field' | 'section' | 'action' | 'row' | 'column' | 'visualBlock', RulePropertyDefinition[]>;
+
+type PraxisAssistantOwnerType = 'page-builder' | 'table' | 'dynamic-form' | 'manual-form' | 'list' | 'tabs' | 'stepper' | 'expansion' | 'app-shell' | 'custom';
+type PraxisAssistantComponentType = 'page-builder' | 'table' | 'form' | 'list' | 'tabs' | 'stepper' | 'expansion' | 'widget' | 'custom';
+type PraxisAssistantContextMode = 'config' | 'agentic-authoring' | 'chat' | 'diagnostic' | 'review' | 'inline-help';
+type PraxisAssistantTargetKind = 'component' | 'field' | 'column' | 'row' | 'section' | 'widget' | 'canvas' | 'compositionLink' | 'action' | 'rule' | 'resource' | 'custom';
+type PraxisAssistantAttachmentKind = 'file' | 'image' | 'json' | 'schema' | 'text' | 'url' | 'custom';
+type PraxisAssistantActionKind = 'local-preview' | 'local-apply' | 'local-undo' | 'manifest-validate' | 'manifest-compile' | 'shared-rule-intake' | 'shared-rule-handoff' | 'governed-simulation-handoff' | 'governed-publication-handoff' | 'materialization-handoff' | 'enforcement-validation-handoff' | 'diagnose' | 'explain' | 'custom';
+type PraxisAssistantRiskLevel = 'low' | 'medium' | 'high' | 'blocked';
+interface PraxisAssistantIdentity {
+    sessionId: string;
+    ownerId: string;
+    ownerType: PraxisAssistantOwnerType | string;
+    componentId?: string;
+    componentType?: PraxisAssistantComponentType | string;
+    routeKey?: string;
+    tenantId?: string;
+    env?: string;
+    userId?: string;
+}
+interface PraxisAssistantTargetRef {
+    kind: PraxisAssistantTargetKind | string;
+    id: string;
+    label?: string;
+    path?: string;
+    schemaPath?: string;
+    metadata?: Readonly<Record<string, string | number | boolean>>;
+}
+interface PraxisAssistantContextItem {
+    id: string;
+    label: string;
+    value: string;
+    kind?: string;
+    tone?: 'neutral' | 'info' | 'success' | 'warning' | 'danger';
+}
+interface PraxisAssistantDigest {
+    label?: string;
+    summary?: string;
+    hash?: string;
+    source?: string;
+    fields?: readonly string[];
+    counts?: Readonly<Record<string, number>>;
+}
+interface PraxisAssistantAuthoringManifestRef {
+    componentId: string;
+    version?: string;
+    source?: string;
+    hash?: string;
+}
+interface PraxisAssistantCapabilityRef {
+    id: string;
+    label?: string;
+    source?: string;
+    risk?: PraxisAssistantRiskLevel;
+}
+interface PraxisAssistantGovernanceHint {
+    kind: string;
+    label?: string;
+    reason?: string;
+    target?: string;
+    risk?: PraxisAssistantRiskLevel;
+}
+interface PraxisAssistantAttachmentSummary {
+    id: string;
+    name: string;
+    kind: PraxisAssistantAttachmentKind | string;
+    mimeType?: string;
+    sizeBytes?: number;
+    source?: string;
+    hasPreview?: boolean;
+}
+interface PraxisAssistantActionContract {
+    id: string;
+    kind: PraxisAssistantActionKind | string;
+    label?: string;
+    target?: PraxisAssistantTargetRef;
+    capabilityRef?: string;
+    risk?: PraxisAssistantRiskLevel;
+    handoffEndpoint?: string;
+    description?: string;
+}
+interface PraxisAssistantContextSnapshot {
+    identity: PraxisAssistantIdentity;
+    target?: PraxisAssistantTargetRef;
+    contextItems: readonly PraxisAssistantContextItem[];
+    mode: PraxisAssistantContextMode;
+    authoringManifestRef?: PraxisAssistantAuthoringManifestRef;
+    resourcePath?: string;
+    schemaFields?: readonly string[];
+    dataProfileDigest?: PraxisAssistantDigest;
+    runtimeStateDigest?: PraxisAssistantDigest;
+    capabilityRefs?: readonly PraxisAssistantCapabilityRef[];
+    governanceHints?: readonly PraxisAssistantGovernanceHint[];
+    riskHints?: readonly PraxisAssistantGovernanceHint[];
+    attachmentSummaries?: readonly PraxisAssistantAttachmentSummary[];
+    actions?: readonly PraxisAssistantActionContract[];
+}
+interface PraxisAssistantOpenRequest {
+    initialPrompt?: string;
+    target?: PraxisAssistantTargetRef;
+    mode?: PraxisAssistantContextMode;
+    visibility?: 'active' | 'minimized';
+    contextHints?: Readonly<Record<string, string | number | boolean>>;
+    preferredAction?: PraxisAssistantActionContract;
+    selection?: PraxisAssistantTargetRef;
+}
+declare const PRAXIS_ASSISTANT_CONTEXT_TEXT_LIMIT = 160;
+declare const PRAXIS_ASSISTANT_CONTEXT_ITEM_LIMIT = 12;
+declare const PRAXIS_ASSISTANT_CONTEXT_SCHEMA_FIELD_LIMIT = 40;
+declare const PRAXIS_ASSISTANT_CONTEXT_ATTACHMENT_LIMIT = 8;
+declare function sanitizePraxisAssistantText(value: unknown, limit?: number): string;
+declare function normalizePraxisAssistantAttachmentSummary(attachment: unknown): PraxisAssistantAttachmentSummary | null;
+declare function normalizePraxisAssistantContextSnapshot(value: unknown): PraxisAssistantContextSnapshot;
 
 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';
+type PraxisAssistantVoiceInputMode = 'disabled' | 'browser-speech';
+type PraxisAssistantVoiceCaptureState = 'unsupported' | 'idle' | 'listening' | 'stopping' | 'error';
 interface PraxisAssistantShellMessage {
     id: string;
     role: PraxisAssistantShellMessageRole;
@@ -420,20 +848,172 @@ interface PraxisAssistantShellMessage {
     status?: 'pending' | 'done' | 'error';
     editable?: boolean;
     resendable?: boolean;
+    observationId?: string | null;
     actions?: readonly PraxisAssistantShellMessageAction[];
 }
 interface PraxisAssistantShellQuickReply {
     id: string;
     label: string;
     prompt: string;
+    value?: unknown;
     kind?: string;
+    description?: string | null;
+    icon?: string | null;
+    tone?: string | null;
+    presentation?: PraxisAssistantShellQuickReplyPresentation | null;
+    contextHints?: Readonly<Record<string, unknown>> | null;
+    canonicalAction?: Readonly<Record<string, unknown>> | null;
+    semanticDecision?: Readonly<Record<string, unknown>> | null;
+}
+type PraxisAssistantShellQuickReplyPresentationKind = 'resource-candidate' | 'contextual-action' | 'governance-confirmation' | 'guided-option' | string;
+interface PraxisAssistantShellQuickReplyPresentation {
+    kind?: PraxisAssistantShellQuickReplyPresentationKind | null;
+    categoryLabel?: string | null;
+    description?: string | null;
+    ctaLabel?: string | null;
+    icon?: string | null;
+    tone?: string | null;
+    technicalDetails?: string | null;
+    evidence?: readonly PraxisAssistantShellQuickReplyEvidence[];
+    items?: readonly PraxisAssistantShellQuickReplyPresentationItem[];
+}
+interface PraxisAssistantShellQuickReplyEvidence {
+    icon?: string | null;
+    value: string;
+    ariaLabel?: string | null;
+}
+interface PraxisAssistantShellQuickReplyPresentationItem {
+    key?: 'bestFor' | 'returns' | 'nextStep' | string;
+    label: string;
+    value: string;
+    icon?: string | null;
+}
+type PraxisAssistantOpportunityCandidateStatus = 'available' | 'missing-context' | 'already-enabled' | 'blocked' | 'not-recommended' | string;
+type PraxisAssistantRecommendedIntentTone = 'neutral' | 'analytics' | 'resource' | 'success' | 'warning' | 'danger' | string;
+interface PraxisAssistantOpportunityGroup {
+    id: string;
+    label: string;
+    description?: string | null;
+    rank?: number | null;
+}
+interface PraxisAssistantRecommendedIntentPresentation {
+    kind?: 'guided-card' | 'compact-chip' | 'spotlight' | string;
+    description?: string | null;
+    ctaLabel?: string | null;
+    icon?: string | null;
+    tone?: PraxisAssistantRecommendedIntentTone | null;
+    evidence?: readonly PraxisAssistantShellQuickReplyEvidence[];
+    items?: readonly PraxisAssistantShellQuickReplyPresentationItem[];
+}
+type PraxisAssistantRecommendedIntentAction = {
+    kind: 'submit-prompt';
+    prompt: string;
+    contextHints?: Readonly<Record<string, unknown>> | null;
+} | {
+    kind: 'start-review';
+    operationKind: 'author' | 'execute' | string;
+    componentEditPlan?: Readonly<Record<string, unknown>> | null;
+    runtimeOperation?: Readonly<Record<string, unknown>> | null;
+    contextHints?: Readonly<Record<string, unknown>> | null;
+} | {
+    kind: 'open-guidance';
+    topicId: string;
+    contextHints?: Readonly<Record<string, unknown>> | null;
+} | {
+    kind: string;
+    [key: string]: unknown;
+};
+interface PraxisAssistantRecommendedIntent {
+    kind?: 'praxis.assistant.recommended-intent' | string;
+    id: string;
+    label: string;
+    description?: string | null;
+    group?: PraxisAssistantOpportunityGroup | null;
+    icon?: string | null;
+    tone?: PraxisAssistantRecommendedIntentTone | null;
+    presentation?: PraxisAssistantRecommendedIntentPresentation | null;
+    action: PraxisAssistantRecommendedIntentAction;
+    prompt?: string | null;
+    contextHints?: Readonly<Record<string, unknown>> | null;
+    sourceCandidateIds?: readonly string[];
+    rank?: number | null;
+    confidence?: number | null;
+    requiresConfirmation?: boolean;
+    disabledReason?: string | null;
+}
+interface PraxisAssistantOpportunityEvidence {
+    kind: 'component-state' | 'metadata' | 'selection' | 'capability' | 'usage' | 'host' | string;
+    label?: string | null;
+    value?: string | number | boolean | null;
+    details?: Readonly<Record<string, unknown>> | null;
+}
+interface PraxisAssistantOpportunityTarget {
+    kind: 'component' | 'field' | 'record-surface' | 'action' | 'navigation' | 'export' | string;
+    id: string;
+    label?: string | null;
+    componentId?: string | null;
+    field?: string | null;
+    surfaceId?: string | null;
+    capabilityId?: string | null;
+    metadata?: Readonly<Record<string, unknown>> | null;
+}
+interface PraxisAssistantOpportunityMissingContext {
+    id: string;
+    label: string;
+    reason?: string | null;
+    required?: boolean;
+}
+interface PraxisAssistantOpportunitySafety {
+    requiresConfirmation?: boolean;
+    destructive?: boolean;
+    reason?: string | null;
+}
+interface PraxisAssistantOpportunityCandidate {
+    id: string;
+    label: string;
+    description?: string | null;
+    group?: PraxisAssistantOpportunityGroup | null;
+    target: PraxisAssistantOpportunityTarget;
+    status?: PraxisAssistantOpportunityCandidateStatus;
+    rank?: number | null;
+    confidence?: number | null;
+    evidence?: readonly PraxisAssistantOpportunityEvidence[];
+    missingContext?: readonly PraxisAssistantOpportunityMissingContext[];
+    safety?: PraxisAssistantOpportunitySafety | null;
+    recommendedIntent?: PraxisAssistantRecommendedIntent | null;
+    metadata?: Readonly<Record<string, unknown>> | null;
+}
+interface PraxisAssistantOpportunityCatalog {
+    componentId: string;
+    componentKind?: string | null;
+    generatedAt?: string | null;
+    stateHash?: string | null;
+    candidates: readonly PraxisAssistantOpportunityCandidate[];
+    groups?: readonly PraxisAssistantOpportunityGroup[];
+    metadata?: Readonly<Record<string, unknown>> | null;
 }
 interface PraxisAssistantShellMessageAction {
     id: string;
     label: string;
     kind?: 'edit' | 'resend' | 'copy' | 'custom' | string;
+    icon?: string | null;
+    ariaLabel?: string | null;
+    iconOnly?: boolean;
     disabled?: boolean;
 }
+type PraxisAssistantShellActionTone = 'primary' | 'secondary' | 'governance' | 'success' | 'warning' | 'danger' | 'neutral' | string;
+interface PraxisAssistantShellAction {
+    id: string;
+    label: string;
+    kind?: 'submit-prompt' | 'apply' | 'retry' | 'cancel' | 'simulate' | 'review' | 'publish' | 'materialize' | 'correct' | 'custom' | string;
+    icon?: string | null;
+    tone?: PraxisAssistantShellActionTone | null;
+    disabled?: boolean;
+    requiresPrompt?: boolean;
+    testId?: string | null;
+    ariaLabel?: string | null;
+    iconOnly?: boolean;
+}
 interface PraxisAssistantShellContextItem {
     id: string;
     label: string;
@@ -459,6 +1039,13 @@ interface PraxisAssistantShellLayout {
     width: number;
     height: number;
 }
+interface PraxisAssistantViewportLayoutOptions {
+    width?: number;
+    height?: number;
+    top?: number;
+    margin?: number;
+}
+declare function createPraxisAssistantViewportLayout(options?: PraxisAssistantViewportLayoutOptions): PraxisAssistantShellLayout;
 interface PraxisAssistantShellLabels {
     title: string;
     subtitle?: string;
@@ -470,14 +1057,30 @@ interface PraxisAssistantShellLabels {
     apply: string;
     conversationAria: string;
     quickRepliesAria: string;
+    quickReplyDetails?: string;
+    recommendedIntentsAria: string;
+    recommendedIntentsTitle: string;
+    recommendedIntentCta: string;
+    recommendedIntentGuidanceCta: string;
+    recommendedIntentRequiresConfirmation: string;
     dragHandleAria: string;
     resizeHandleAria: string;
+    resetLayout?: string;
     contextAria: string;
     attachmentsAria: string;
     attach: string;
     removeAttachment: string;
     editMessage: string;
     resendMessage: string;
+    feedbackPositive: string;
+    feedbackNegative: string;
+    feedbackSubmitted: string;
+    voiceStart?: string;
+    voiceStop?: string;
+    voiceListening?: string;
+    voiceUnsupported?: string;
+    voicePermissionDenied?: string;
+    voiceNoSpeech?: string;
     modeConfig: string;
     modeAgenticAuthoring: string;
     modeChat: string;
@@ -501,7 +1104,11 @@ interface PraxisAssistantClarificationOption {
     label: string;
     value: string;
     description?: string;
+    displayPrompt?: string;
+    example?: string;
     contextHints?: Record<string, unknown>;
+    canonicalAction?: Record<string, unknown>;
+    semanticDecision?: Record<string, unknown>;
 }
 interface PraxisAssistantClarificationQuestion {
     id: string;
@@ -516,6 +1123,7 @@ interface PraxisAssistantTurnAction {
     kind: 'submit' | 'clarify' | 'apply' | 'cancel' | 'retry' | 'edit-message' | 'resend-message' | 'attach' | 'remove-attachment' | string;
     id?: string;
     value?: unknown;
+    displayPrompt?: string;
     contextHints?: Record<string, unknown>;
 }
 interface PraxisAssistantPendingClarification {
@@ -524,7 +1132,15 @@ interface PraxisAssistantPendingClarification {
     assistantMessage?: string;
     clientTurnId?: string;
     diagnostics?: Record<string, unknown>;
+    observationId?: string | null;
 }
+type PraxisAssistantConversationMessageRole = 'user' | 'assistant' | 'system';
+interface PraxisAssistantConversationMessage {
+    id: string;
+    role: PraxisAssistantConversationMessageRole;
+    text: string;
+}
+declare function toPraxisAssistantConversationMessages(messages: readonly PraxisAssistantShellMessage[], limit?: number): PraxisAssistantConversationMessage[];
 interface PraxisAssistantTurnRequest {
     mode: PraxisAssistantShellMode;
     phase?: PraxisAssistantTurnPhase;
@@ -545,6 +1161,8 @@ interface PraxisAssistantTurnRequest {
     preview?: unknown;
     pendingPatch?: unknown;
     pendingClarification?: PraxisAssistantPendingClarification;
+    diagnostics?: Record<string, unknown>;
+    observationId?: string | null;
 }
 interface PraxisAssistantTurnResult {
     state: PraxisAssistantShellState;
@@ -564,6 +1182,7 @@ interface PraxisAssistantTurnResult {
     sessionId?: string;
     clientTurnId?: string;
     diagnostics?: Record<string, unknown>;
+    observationId?: string | null;
 }
 interface PraxisAssistantTurnViewState {
     mode: PraxisAssistantShellMode;
@@ -583,6 +1202,7 @@ interface PraxisAssistantTurnViewState {
     pendingPatch?: unknown;
     pendingClarification?: PraxisAssistantPendingClarification;
     diagnostics?: Record<string, unknown>;
+    observationId?: string | null;
 }
 interface PraxisAssistantTurnFlow {
     readonly mode: PraxisAssistantShellMode;
@@ -617,6 +1237,31 @@ interface AiResponseCompileResult {
     message?: string;
     warnings?: string[];
 }
+type AiAuthoringResponseModeKind = 'consult' | 'edit' | string;
+interface AiAuthoringResponseMode {
+    kind: AiAuthoringResponseModeKind;
+    operationKind?: 'consult' | 'author' | 'edit' | string;
+    changeKind?: 'answer' | string;
+    preferredResponse?: string;
+    useWhen?: string[];
+    rules?: string[];
+}
+interface AiConsultativeAuthoringContext {
+    [key: string]: unknown;
+    resourcePath?: string | null;
+    answerableQuestionKinds?: string[];
+}
+interface AiComponentAuthoringContract {
+    [key: string]: unknown;
+    kind: 'praxis.component-authoring-context' | string;
+    componentId?: string;
+    componentType?: string;
+    preferredResponse?: string;
+    responseModes?: AiAuthoringResponseMode[];
+    consultativeContext?: AiConsultativeAuthoringContext;
+}
+declare function createComponentAuthoringContext(authoringContract: AiComponentAuthoringContract): AiJsonObject;
+declare function toAiJsonObject(value: unknown, path?: string): AiJsonObject;
 /**
  * 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.
@@ -669,6 +1314,12 @@ interface AiConfigAdapter<TConfig = any> {
      * Usado para sugestões heurísticas mais precisas no backend.
      */
     getSchemaFields?(): Record<string, any>[];
+    /**
+     * Prepara contexto assíncrono necessário antes de montar snapshots para IA.
+     * Ex.: uma tabela pode carregar o schema canônico de filtros antes de expor
+     * o contrato de authoring ao backend.
+     */
+    prepareAuthoringContext?(): Promise<void> | void;
     /**
      * Retorna contexto declarativo adicional para authoring assistido por IA.
      * Deve conter contratos validaveis e instrucoes especificas do componente
@@ -734,6 +1385,17 @@ declare abstract class BaseAiAdapter<TConfig = any> implements AiConfigAdapter<T
     protected getCriticalWarnings(patch: any): string[];
 }
 
+interface AiGovernedDecisionRoutingOptions {
+    localCompositionTerms?: readonly string[];
+}
+/**
+ * @deprecated Component assistants must not infer governed authoring from user
+ * wording. Route through the backend semantic resolver and use this only for
+ * explicit, structured context provided by a canonical backend source.
+ */
+declare function shouldRoutePromptToGovernedDecision(prompt: string, contextHints?: AiJsonObject, options?: AiGovernedDecisionRoutingOptions): boolean;
+declare function normalizeAuthoringPrompt(prompt: string): string;
+
 interface FieldSchemaLike {
     label: string;
     type: string;
@@ -784,8 +1446,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;
@@ -795,7 +1455,7 @@ declare class PraxisAiService {
 }
 
 declare const AI_INTENT_CONTRACT_VERSION: "v1.1";
-declare const AI_INTENT_CONTRACT_SCHEMA_HASH: "922e6d48637e64b403562d6d7cb833ed4942ffb0b452ec3573255871f4ec8739";
+declare const AI_INTENT_CONTRACT_SCHEMA_HASH: "41767dafdf6ebea802c083d77187ad6612937d6831188938dc21adce384b57a2";
 type AiSchemaContext = AiSchemaContextContract;
 interface AiSuggestionsRequest {
     componentId: string;
@@ -828,10 +1488,38 @@ type AiPatchStreamEventType = AiPatchStreamEventType$1;
 type AiPatchStreamStartResponse = AiPatchStreamStartResponseContract;
 type AiPatchStreamCancelResponse = AiPatchStreamCancelResponseContract;
 type AiPatchStreamEnvelope<TPayload extends AiJsonObject = AiJsonObject> = AiPatchStreamEnvelopeContract<TPayload>;
+type AgenticAuthoringManifestEditPlanRequest = AgenticAuthoringManifestEditPlanRequestContract;
+type AgenticAuthoringResolveTargetRequest = AgenticAuthoringResolveTargetRequestContract;
+type AgenticAuthoringResolvedTarget = AgenticAuthoringResolvedTargetContract;
+type AgenticAuthoringManifestValidationResult = AgenticAuthoringManifestValidationResultContract;
+type AgenticAuthoringManifestCompileResult = AgenticAuthoringManifestCompileResultContract;
+type AgenticAuthoringTurnStreamRequest = AgenticAuthoringTurnStreamRequestContract;
+type AgenticAuthoringTurnStreamStartResponse = AgenticAuthoringTurnStreamStartResponseContract;
+type AgenticAuthoringTurnStreamEnvelope<TPayload extends AiJsonObject = AiJsonObject> = AgenticAuthoringTurnStreamEnvelopeContract<TPayload>;
 interface AiPatchStreamConnection {
     events$: Observable<AiPatchStreamEnvelope>;
     close: () => void;
 }
+interface AgenticAuthoringTurnStreamConnection {
+    events$: Observable<AgenticAuthoringTurnStreamEnvelope>;
+    close: () => void;
+}
+interface AgenticAuthoringTurnStreamLifecycle {
+    phase: string;
+    transport?: 'event-source' | 'fetch' | string;
+    connectElapsedMs?: number;
+    probeStatus?: number | null;
+    firstEventSeq?: number | null;
+    firstEventType?: string | null;
+}
+interface AgenticAuthoringTurnStreamConnectionOptions {
+    baseUrl?: string;
+    onLifecycle?: (event: AgenticAuthoringTurnStreamLifecycle) => void;
+}
+interface AgenticAuthoringTurnStreamStartOptions {
+    baseUrl?: string;
+    headers?: Record<string, string | undefined>;
+}
 type AiPatchStreamConnectionErrorKind = 'unsupported' | 'http_status' | 'transport' | 'parse' | 'schema';
 declare class AiPatchStreamConnectionError extends Error {
     readonly kind: AiPatchStreamConnectionErrorKind;
@@ -882,6 +1570,9 @@ interface AiProviderStatusResponse {
     success?: boolean;
     message?: string;
 }
+type AiAssistantObservationFeedbackRatingValue = AiAssistantObservationFeedbackRating;
+type AiAssistantObservationFeedbackRequest = AiAssistantObservationFeedbackRequestContract;
+type AiAssistantObservationFeedbackResponse = AiAssistantObservationFeedbackResponseContract;
 interface AiContextTemplateMeta {
     variants?: Array<{
         id?: string;
@@ -924,39 +1615,132 @@ interface AiBackendStorageOptions {
     defaultHeaders?: Record<string, string>;
     allowLocalIdentityFallback?: boolean;
 }
+interface AiBackendEndpoints {
+    /**
+     * Explicit base URL for `/praxis/config/ai/**`.
+     * Hosts should normally prefer the shared `API_URL.default.baseUrl`; use this
+     * only when AI orchestration is served by a distinct gateway.
+     */
+    aiBaseUrl?: string;
+    /**
+     * Explicit base URL for `/praxis/config/ai-context/**`.
+     * When omitted, the service derives it from `API_URL.default.baseUrl`.
+     */
+    aiContextBaseUrl?: string;
+}
 declare const AI_BACKEND_CONFIG_STORE: InjectionToken<AiBackendConfigStore>;
 declare const AI_BACKEND_STORAGE_OPTIONS: InjectionToken<AiBackendStorageOptions>;
+declare const AI_BACKEND_ENDPOINTS: InjectionToken<AiBackendEndpoints>;
 declare class AiBackendApiService {
     private readonly http;
     private readonly globalConfigStore;
     private readonly storageOpts;
-    private readonly baseUrl;
-    private readonly contextUrl;
+    private readonly endpointOpts;
+    private readonly apiUrlConfig;
+    private readonly fallbackAiBaseUrl;
+    private readonly fallbackAiContextBaseUrl;
     getSuggestions(request: AiSuggestionsRequest): Observable<AiSuggestionsResponse>;
     getPatch(request: AiOrchestratorRequest): Observable<AiOrchestratorResponse>;
     startPatchStream(request: AiOrchestratorRequest): Observable<AiPatchStreamStartResponse>;
     connectPatchStream(streamId: string, lastEventId?: string, accessToken?: string): AiPatchStreamConnection;
     cancelPatchStream(streamId: string, accessToken?: string): Observable<AiPatchStreamCancelResponse>;
+    startAgenticAuthoringTurnStream(request: AgenticAuthoringTurnStreamRequest, options?: AgenticAuthoringTurnStreamStartOptions): Observable<AgenticAuthoringTurnStreamStartResponse>;
+    connectAgenticAuthoringTurnStream(streamId: string, lastEventId?: string, accessToken?: string, options?: AgenticAuthoringTurnStreamConnectionOptions): AgenticAuthoringTurnStreamConnection;
+    cancelAgenticAuthoringTurnStream(streamId: string, accessToken?: string): Observable<AiPatchStreamCancelResponse>;
+    sendAssistantObservationFeedback(observationId: string, request: AiAssistantObservationFeedbackRequest): Observable<AiAssistantObservationFeedbackResponse>;
     listModels(request: AiProviderModelsRequest): Observable<AiProviderModelsResponse>;
     listProviderCatalog(): Observable<AiProviderCatalogResponse>;
     testProvider(request: AiProviderTestRequest): Observable<AiProviderTestResponse>;
     getAiStatus(): Observable<AiProviderStatusResponse>;
     getAiContext(componentId: string, componentType: string): Observable<AiContextDTO>;
+    getAgenticAuthoringManifest(componentId: string): Observable<AiJsonObject>;
+    listAgenticAuthoringManifestTargets(componentId: string): Observable<AiJsonObject[]>;
+    listAgenticAuthoringManifestOperations(componentId: string): Observable<AiJsonObject[]>;
+    resolveAgenticAuthoringManifestTarget(componentId: string, request: AgenticAuthoringResolveTargetRequest): Observable<AgenticAuthoringResolvedTarget>;
+    validateAgenticAuthoringManifestPlan(componentId: string, request: AgenticAuthoringManifestEditPlanRequest): Observable<AgenticAuthoringManifestValidationResult>;
+    compileAgenticAuthoringManifestPatch(componentId: string, request: AgenticAuthoringManifestEditPlanRequest): Observable<AgenticAuthoringManifestCompileResult>;
     loadGlobalAiConfig(): Observable<AiGlobalConfigSnapshot | null>;
     saveGlobalAiConfig(aiConfig: AiGlobalConfigSnapshot): Observable<void>;
     getHeaderContext(): AiHeaderContext;
     private buildHeaders;
     private normalizeContractVersion;
     private normalizeContractSchemaHash;
+    private normalizeLegacyPatchConversationIds;
+    private normalizeConversationUuid;
+    private isUuid;
+    private authoringManifestUrl;
+    private aiBaseUrl;
+    private aiContextBaseUrl;
+    private resolveBaseUrl;
+    private resolveApiBaseUrl;
+    private joinUrl;
+    private normalizeBaseUrl;
+    private buildApiUrl;
     private resolveHeaderMap;
     private parsePatchStreamEnvelope;
     private isPatchStreamEnvelope;
     private isJsonObject;
+    private registerNamedStreamEventListeners;
+    private isTerminalStreamEventType;
+    private agenticAuthoringBaseUrl;
+    private consumeFetchAgenticTurnStream;
+    private consumeBufferedSseFrames;
+    private findSseFrameBoundary;
     private probePatchStreamEndpoint;
     static ɵfac: i0.ɵɵFactoryDeclaration<AiBackendApiService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AiBackendApiService>;
 }
 
+interface AgenticAuthoringTurnClientOptions {
+    readonly baseUrl?: string;
+    readonly headers?: Record<string, string | undefined>;
+    readonly initialStatusText?: string;
+    readonly silenceStatusMs?: number;
+    readonly resultTimeoutMs?: number;
+    readonly streamTimeoutMs?: number;
+}
+interface AgenticAuthoringTurnStreamStartedEvent {
+    readonly kind: 'stream-started';
+    readonly start: AgenticAuthoringTurnStreamStartResponseContract;
+}
+interface AgenticAuthoringTurnStreamEnvelopeEvent {
+    readonly kind: 'stream-event';
+    readonly event: AgenticAuthoringTurnStreamEnvelopeContract;
+}
+interface AgenticAuthoringTurnLifecycleEvent {
+    readonly kind: 'stream-lifecycle';
+    readonly start: AgenticAuthoringTurnStreamStartResponseContract;
+    readonly phase: string;
+    readonly statusText: string;
+    readonly diagnostics?: AiJsonObject;
+}
+type AgenticAuthoringTurnClientEvent = AgenticAuthoringTurnStreamStartedEvent | AgenticAuthoringTurnLifecycleEvent | AgenticAuthoringTurnStreamEnvelopeEvent;
+declare class AgenticAuthoringTurnClientService {
+    private readonly aiApi;
+    streamEvents(request: AgenticAuthoringTurnStreamRequestContract, options?: AgenticAuthoringTurnClientOptions): Observable<AgenticAuthoringTurnClientEvent>;
+    streamTurn(request: AgenticAuthoringTurnStreamRequestContract, options?: AgenticAuthoringTurnClientOptions): Observable<PraxisAssistantTurnResult>;
+    toTurnResult(event: AgenticAuthoringTurnStreamEnvelopeContract): PraxisAssistantTurnResult;
+    private toResultTurn;
+    private toShellQuickReplies;
+    private toPendingClarification;
+    private phaseForPayload;
+    private statusForPayload;
+    private resultDiagnostics;
+    private toLifecycleEvent;
+    private silenceStatusEvent;
+    private resultTimeoutEvent;
+    private streamTimeoutEvent;
+    private isTerminalEventType;
+    private toQuickReplies;
+    private isQuickReply;
+    private toPendingClarificationContract;
+    private readString;
+    private toJsonObject;
+    private isRecord;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AgenticAuthoringTurnClientService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AgenticAuthoringTurnClientService>;
+}
+
 interface ValidationContext {
     fieldSchemas: Record<string, FieldSchemaLike>;
     targetSchemas?: any;
@@ -973,6 +1757,7 @@ declare class AiResponseValidatorService {
     private validateJsonLogicExpression;
     private walkJsonLogicNode;
     private isSupportedJsonLogicOperator;
+    private validateJsonLogicOperatorArity;
     private collectVarPaths;
     private isValidTargetId;
     private findSimilarTargetId;
@@ -1005,8 +1790,10 @@ declare class PraxisAssistantTurnController {
     private readonly options;
     private readonly stateSubject;
     readonly state$: Observable<PraxisAssistantTurnViewState>;
+    private activeFlowClientTurnId;
     constructor(flow: PraxisAssistantTurnFlow, options: PraxisAssistantTurnControllerOptions);
     snapshot(): PraxisAssistantTurnViewState;
+    setContextHints(hints: Record<string, unknown> | undefined): void;
     setContextItems(items: readonly PraxisAssistantShellContextItem[]): void;
     setMessages(messages: readonly PraxisAssistantShellMessage[]): void;
     setAttachments(attachments: readonly PraxisAssistantShellAttachment[]): void;
@@ -1017,6 +1804,7 @@ declare class PraxisAssistantTurnController {
     submitEditedMessage(messageId: string, text: string): Observable<PraxisAssistantTurnViewState>;
     submitPrompt(prompt: string, action?: PraxisAssistantTurnAction): Observable<PraxisAssistantTurnViewState>;
     answerClarification(option: PraxisAssistantClarificationOption | string): Observable<PraxisAssistantTurnViewState>;
+    private semanticClarificationContextHints;
     apply(): Observable<PraxisAssistantTurnViewState>;
     retry(): Observable<PraxisAssistantTurnViewState>;
     cancel(): Observable<PraxisAssistantTurnViewState>;
@@ -1025,6 +1813,10 @@ declare class PraxisAssistantTurnController {
     private submitExistingUserMessage;
     private findUserMessageIndex;
     private resetReplayState;
+    private resetActiveTurnState;
+    private shouldApplyFlowResult;
+    private resetConversationState;
+    private resetConversationAfterCancel;
     private applyResult;
     private resolveSubmitAction;
     private buildPendingClarification;
@@ -1032,10 +1824,85 @@ declare class PraxisAssistantTurnController {
     private resolveMessageRole;
     private resolvePhase;
     private buildMessage;
+    private shouldAttachObservationId;
     private createId;
     private patchState;
     private cloneState;
     private toObservable;
+    private buildFlowErrorResult;
+    private describeFlowError;
+    private serializeFlowError;
+    private toRecord;
+    private toString;
+    private toNumber;
+}
+
+declare function toPraxisAssistantClarificationOption(reply: PraxisAssistantShellQuickReply): PraxisAssistantClarificationOption;
+declare function submitPraxisAssistantQuickReply(controller: PraxisAssistantTurnController, reply: PraxisAssistantShellQuickReply): Observable<PraxisAssistantTurnViewState>;
+
+type PraxisAssistantSessionVisibility = 'active' | 'minimized';
+type PraxisAssistantSessionPresence = 'global-dock' | 'origin-anchor';
+interface PraxisAssistantSessionDescriptor {
+    id: string;
+    ownerId: string;
+    ownerType: string;
+    title: string;
+    summary?: string | null;
+    mode?: PraxisAssistantShellMode | null;
+    state?: PraxisAssistantShellState | null;
+    visibility?: PraxisAssistantSessionVisibility | null;
+    contextItems?: readonly PraxisAssistantShellContextItem[] | null;
+    contextSnapshot?: PraxisAssistantContextSnapshot | null;
+    badge?: string | null;
+    icon?: string | null;
+    presence?: PraxisAssistantSessionPresence | null;
+    updatedAt?: string | null;
+}
+interface PraxisAssistantSessionSnapshot {
+    id: string;
+    ownerId: string;
+    ownerType: string;
+    title: string;
+    summary: string;
+    mode: PraxisAssistantShellMode;
+    state: PraxisAssistantShellState;
+    visibility: PraxisAssistantSessionVisibility;
+    contextItems: readonly PraxisAssistantShellContextItem[];
+    contextSnapshot: PraxisAssistantContextSnapshot | null;
+    badge: string;
+    icon: string;
+    presence: PraxisAssistantSessionPresence;
+    createdAt: string;
+    updatedAt: string;
+}
+type PraxisAssistantSessionIdentityRef = string | PraxisAssistantIdentity | PraxisAssistantContextSnapshot;
+type PraxisAssistantContextSessionDescriptor = Omit<PraxisAssistantSessionDescriptor, 'id' | 'ownerId' | 'ownerType' | 'title' | 'contextSnapshot'> & {
+    title?: string;
+};
+declare class PraxisAssistantSessionRegistryService {
+    private readonly sessionsState;
+    readonly sessions: i0.Signal<PraxisAssistantSessionSnapshot[]>;
+    readonly activeSession: i0.Signal<PraxisAssistantSessionSnapshot | null>;
+    readonly minimizedSessions: i0.Signal<PraxisAssistantSessionSnapshot[]>;
+    upsertSession(descriptor: PraxisAssistantSessionDescriptor): PraxisAssistantSessionSnapshot;
+    upsertContextSession(contextSnapshot: PraxisAssistantContextSnapshot, descriptor?: PraxisAssistantContextSessionDescriptor): PraxisAssistantSessionSnapshot;
+    openSession(sessionId: string): PraxisAssistantSessionSnapshot | null;
+    openContextSession(identity: PraxisAssistantSessionIdentityRef): PraxisAssistantSessionSnapshot | null;
+    minimizeSession(sessionId: string): PraxisAssistantSessionSnapshot | null;
+    minimizeContextSession(identity: PraxisAssistantSessionIdentityRef): PraxisAssistantSessionSnapshot | null;
+    removeSession(sessionId: string): void;
+    removeContextSession(identity: PraxisAssistantSessionIdentityRef): void;
+    getSession(sessionId: string): PraxisAssistantSessionSnapshot | null;
+    getContextSession(identity: PraxisAssistantSessionIdentityRef): PraxisAssistantSessionSnapshot | null;
+    clear(): void;
+    private setVisibility;
+    private resolveSessionId;
+    private normalizeDescriptor;
+    private assertContextIdentity;
+    private toShellContextItems;
+    private sortSessions;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisAssistantSessionRegistryService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<PraxisAssistantSessionRegistryService>;
 }
 
 type AssistantMessageRole = 'user' | 'assistant' | 'system';
@@ -1077,7 +1944,7 @@ interface ClarificationOption {
     value: string;
     example?: string;
 }
-type ClarificationContextHints = AiJsonObject;
+type ClarificationContextHints = AiContextHintsContract;
 interface ClarificationRichOption extends ClarificationOption {
     contextHints?: ClarificationContextHints;
 }
@@ -1092,6 +1959,7 @@ declare class PraxisAiAssistantComponent implements OnDestroy {
     adapter: AiConfigAdapter;
     riskPolicy: RiskPolicy | null;
     allowManualPatchEdit: boolean;
+    hasBackdrop: boolean;
     readonly overlayPositions: ConnectedPosition[];
     overlayOrigin: CdkOverlayOrigin;
     triggerButton?: ElementRef<HTMLButtonElement>;
@@ -1411,6 +2279,7 @@ declare class PraxisAiAssistantComponent implements OnDestroy {
     private hasBadgeColors;
     private hasBadgeField;
     private mergeContextHints;
+    private enrichDomainCatalogAuthoringHints;
     private setResourcePathHint;
     private clearResourcePathHint;
     private matchClarificationOptionPath;
@@ -1463,9 +2332,19 @@ declare class PraxisAiAssistantComponent implements OnDestroy {
     private restoreFocusToTrigger;
     private normalizeError;
     static ɵfac: i0.ɵɵFactoryDeclaration<PraxisAiAssistantComponent, never>;
-    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>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisAiAssistantComponent, "praxis-ai-assistant", never, { "adapter": { "alias": "adapter"; "required": true; }; "riskPolicy": { "alias": "riskPolicy"; "required": false; }; "allowManualPatchEdit": { "alias": "allowManualPatchEdit"; "required": false; }; "hasBackdrop": { "alias": "hasBackdrop"; "required": false; }; }, {}, never, never, true, never>;
 }
 
+type ResizeDirection = 'n' | 's' | 'e' | 'w' | 'ne' | 'nw' | 'se' | 'sw';
+type QuickReplyPresentationItem = PraxisAssistantShellQuickReplyPresentationItem & {
+    key: 'bestFor' | 'returns' | 'nextStep' | string;
+    icon: string;
+};
+interface QuickReplyContextChip {
+    icon: string;
+    value: string;
+    ariaLabel: string;
+}
 declare class PraxisAiAssistantShellComponent implements OnChanges, OnDestroy {
     labels: Partial<PraxisAssistantShellLabels> | null;
     mode: PraxisAssistantShellMode;
@@ -1474,6 +2353,7 @@ declare class PraxisAiAssistantShellComponent implements OnChanges, OnDestroy {
     attachments: readonly PraxisAssistantShellAttachment[];
     messages: readonly PraxisAssistantShellMessage[];
     quickReplies: readonly PraxisAssistantShellQuickReply[];
+    recommendedIntents: readonly PraxisAssistantRecommendedIntent[];
     prompt: string;
     statusText: string;
     errorText: string;
@@ -1481,13 +2361,22 @@ declare class PraxisAiAssistantShellComponent implements OnChanges, OnDestroy {
     panelTestId: string;
     submitTestId: string;
     applyTestId: string;
+    primaryAction: PraxisAssistantShellAction | null;
+    secondaryActions: readonly PraxisAssistantShellAction[];
+    governanceActions: readonly PraxisAssistantShellAction[];
     busy: boolean;
     canSubmit: boolean;
     canApply: boolean;
     submitOnEnter: boolean;
+    showAttachAction: boolean;
+    enablePastedAttachments: boolean;
     enableFileAttachments: boolean;
     attachmentAccept: string;
     attachmentMultiple: boolean;
+    private readonly defaultVoiceInputMode;
+    private readonly defaultVoiceLanguage;
+    voiceInputMode: PraxisAssistantVoiceInputMode;
+    voiceLanguage: string;
     draggable: boolean;
     resizable: boolean;
     minWidth: number;
@@ -1497,6 +2386,9 @@ declare class PraxisAiAssistantShellComponent implements OnChanges, OnDestroy {
     promptChange: EventEmitter<string>;
     submitPrompt: EventEmitter<string>;
     apply: EventEmitter<void>;
+    retryTurn: EventEmitter<void>;
+    cancelTurn: EventEmitter<void>;
+    shellAction: EventEmitter<PraxisAssistantShellAction>;
     close: EventEmitter<void>;
     attach: EventEmitter<void>;
     attachmentsPasted: EventEmitter<PraxisAssistantShellAttachment[]>;
@@ -1509,15 +2401,27 @@ declare class PraxisAiAssistantShellComponent implements OnChanges, OnDestroy {
     editMessage: EventEmitter<PraxisAssistantShellMessage>;
     resendMessage: EventEmitter<PraxisAssistantShellMessage>;
     quickReply: EventEmitter<PraxisAssistantShellQuickReply>;
+    recommendedIntent: EventEmitter<PraxisAssistantRecommendedIntent>;
     layoutChange: EventEmitter<PraxisAssistantShellLayout>;
     panel?: ElementRef<HTMLElement>;
     conversation?: ElementRef<HTMLElement>;
     private readonly cdr;
+    private readonly injector;
+    private readonly browserSpeech;
     protected currentPrompt: string;
     protected resolvedLabels: PraxisAssistantShellLabels;
+    protected voiceCaptureState: PraxisAssistantVoiceCaptureState;
+    protected voiceFeedbackText: string;
     protected currentLayout: PraxisAssistantShellLayout;
+    protected readonly resizeHandles: readonly ResizeDirection[];
     private pointerSession;
     private readonly ownedPreviewUrls;
+    private readonly submittedFeedbackObservationIds;
+    private voiceCaptureSequence;
+    private destroyed;
+    private processingStartedAt;
+    private processingElapsedSeconds;
+    private processingTimer;
     private readonly onWindowPointerMove;
     private readonly onWindowPointerUp;
     ngOnChanges(changes: SimpleChanges): void;
@@ -1526,26 +2430,107 @@ declare class PraxisAiAssistantShellComponent implements OnChanges, OnDestroy {
     protected onSubmit(): void;
     protected onPromptKeydown(event: KeyboardEvent): void;
     protected onPromptPaste(event: ClipboardEvent): void;
+    protected onVoiceInputClick(): void;
+    protected shouldShowVoiceInput(): boolean;
+    protected isVoiceInputDisabled(): boolean;
+    protected isVoiceInputBusy(): boolean;
+    protected getVoiceActionLabel(): string;
+    protected shouldShowVoiceFeedback(): boolean;
+    private canUseBrowserSpeech;
+    private cancelVoiceCapture;
+    private isCurrentVoiceCapture;
+    private applyVoiceTranscript;
+    private resolveVoiceErrorText;
+    private getVoiceLabel;
     protected onAttachClick(fileInput: HTMLInputElement): void;
     protected onAttachmentFilesSelected(event: Event): void;
     protected onApply(): void;
+    protected renderMessageText(text: string | null | undefined): string;
+    private renderInlineMarkdown;
+    private escapeHtml;
+    protected shouldShowStatusText(): boolean;
+    protected shouldShowErrorText(): boolean;
+    protected getAuxiliaryStatusText(): string;
+    protected onShellAction(action: PraxisAssistantShellAction): void;
+    protected getPrimaryAction(): PraxisAssistantShellAction;
+    protected getSecondaryActions(): readonly PraxisAssistantShellAction[];
+    protected getPrimaryActionTooltip(action: PraxisAssistantShellAction): string;
+    protected isShellActionDisabled(action: PraxisAssistantShellAction): boolean;
+    protected getShellActionTone(action: PraxisAssistantShellAction): string;
+    protected trackShellAction(_index: number, action: PraxisAssistantShellAction): string;
+    private hasRecoverableTurn;
+    private updateProcessingTimer;
+    private stopProcessingTimer;
+    private getProcessingStatusText;
+    private shouldShowAuxiliaryText;
+    private normalizeMessageText;
+    private getDefaultPrimaryAction;
     protected onQuickReply(reply: PraxisAssistantShellQuickReply): void;
+    protected shouldShowRecommendedIntents(): boolean;
+    protected onRecommendedIntent(intent: PraxisAssistantRecommendedIntent): void;
+    protected isRecommendedIntentDisabled(intent: PraxisAssistantRecommendedIntent): boolean;
+    protected getRecommendedIntentAriaLabel(intent: PraxisAssistantRecommendedIntent): string;
+    protected getRecommendedIntentDescription(intent: PraxisAssistantRecommendedIntent): string;
+    protected getRecommendedIntentCtaLabel(intent: PraxisAssistantRecommendedIntent): string;
+    protected getRecommendedIntentIcon(intent: PraxisAssistantRecommendedIntent): string;
+    protected getRecommendedIntentTone(intent: PraxisAssistantRecommendedIntent): string;
+    protected getRecommendedIntentGroupLabel(intent: PraxisAssistantRecommendedIntent): string;
+    protected getQuickReplyAriaLabel(reply: PraxisAssistantShellQuickReply): string;
+    protected getQuickReplyTechnicalDetails(reply: PraxisAssistantShellQuickReply): string;
+    protected isRichQuickReply(reply: PraxisAssistantShellQuickReply): boolean;
+    protected shouldUseInlineQuickReplies(): boolean;
+    protected getQuickReplyDescription(reply: PraxisAssistantShellQuickReply): string;
+    protected getQuickReplyContextChips(reply: PraxisAssistantShellQuickReply): readonly QuickReplyContextChip[];
+    protected getQuickReplyPresentationItems(reply: PraxisAssistantShellQuickReply): readonly QuickReplyPresentationItem[];
+    private defaultQuickReplyPresentation;
+    protected getQuickReplyCategoryLabel(reply: PraxisAssistantShellQuickReply): string;
+    protected getQuickReplyIcon(reply: PraxisAssistantShellQuickReply): string;
+    protected getQuickReplyCtaLabel(reply: PraxisAssistantShellQuickReply): string;
+    protected getQuickReplyTone(reply: PraxisAssistantShellQuickReply): string;
+    private normalizeQuickReplyTone;
+    private asRecord;
+    private stringHint;
+    private quickReplyHint;
+    private hasQuickReplyResourceContext;
+    private isFieldDiscoveryQuickReply;
+    protected isContextualPreviewActionQuickReply(reply: PraxisAssistantShellQuickReply): boolean;
+    protected isGuidedActionQuickReply(reply: PraxisAssistantShellQuickReply): boolean;
+    private quickReplyPresentation;
+    private quickReplyPresentationKind;
+    private presentationEvidenceToChip;
+    private getContextualActionChips;
+    private isGenericContextualActionDescription;
+    private trimSentencePunctuation;
+    private shortPathLabel;
+    private shortTechnicalLabel;
+    protected getCloseIcon(): string;
+    private normalizeShellAction;
     protected onRemoveAttachment(attachment: PraxisAssistantShellAttachment): void;
     protected onMessageAction(message: PraxisAssistantShellMessage, action: PraxisAssistantShellMessageAction): void;
+    protected canSendMessageFeedback(message: PraxisAssistantShellMessage): boolean;
+    protected isMessageFeedbackSubmitted(message: PraxisAssistantShellMessage): boolean;
+    protected sendMessageFeedback(message: PraxisAssistantShellMessage, rating: AiAssistantObservationFeedbackRatingValue): void;
+    private resolveAiApi;
+    protected getMessageActionIcon(action: PraxisAssistantShellMessageAction): string;
+    protected getMessageActionLabel(action: PraxisAssistantShellMessageAction): string;
+    protected isMessageActionIconOnly(action: PraxisAssistantShellMessageAction): boolean;
     protected getModeLabel(): string;
     protected getStateLabel(): string;
     protected startDrag(event: PointerEvent): void;
-    protected startResize(event: PointerEvent): void;
+    protected startResize(direction: ResizeDirection, event: PointerEvent): void;
+    protected trackResizeHandle(_index: number, direction: ResizeDirection): ResizeDirection;
     protected trackMessage(_index: number, message: PraxisAssistantShellMessage): string;
     protected trackMessageAction(_index: number, action: PraxisAssistantShellMessageAction): string;
     protected trackQuickReply(_index: number, reply: PraxisAssistantShellQuickReply): string;
+    protected trackRecommendedIntent(_index: number, intent: PraxisAssistantRecommendedIntent): string;
     protected trackContextItem(_index: number, item: PraxisAssistantShellContextItem): string;
     protected trackAttachment(_index: number, attachment: PraxisAssistantShellAttachment): string;
     private startPointerSession;
     private handlePointerMove;
+    private resizeLayout;
     private finishPointerSession;
     private detachPointerListeners;
-    private resolveBounds;
+    private resolveViewportBounds;
     private normalizeLayout;
     private clampLayout;
     private clamp;
@@ -1557,7 +2542,55 @@ declare class PraxisAiAssistantShellComponent implements OnChanges, OnDestroy {
     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>;
+    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; }; "recommendedIntents": { "alias": "recommendedIntents"; "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; }; "primaryAction": { "alias": "primaryAction"; "required": false; }; "secondaryActions": { "alias": "secondaryActions"; "required": false; }; "governanceActions": { "alias": "governanceActions"; "required": false; }; "busy": { "alias": "busy"; "required": false; }; "canSubmit": { "alias": "canSubmit"; "required": false; }; "canApply": { "alias": "canApply"; "required": false; }; "submitOnEnter": { "alias": "submitOnEnter"; "required": false; }; "showAttachAction": { "alias": "showAttachAction"; "required": false; }; "enablePastedAttachments": { "alias": "enablePastedAttachments"; "required": false; }; "enableFileAttachments": { "alias": "enableFileAttachments"; "required": false; }; "attachmentAccept": { "alias": "attachmentAccept"; "required": false; }; "attachmentMultiple": { "alias": "attachmentMultiple"; "required": false; }; "voiceInputMode": { "alias": "voiceInputMode"; "required": false; }; "voiceLanguage": { "alias": "voiceLanguage"; "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"; "retryTurn": "retryTurn"; "cancelTurn": "cancelTurn"; "shellAction": "shellAction"; "close": "close"; "attach": "attach"; "attachmentsPasted": "attachmentsPasted"; "attachmentsSelected": "attachmentsSelected"; "removeAttachment": "removeAttachment"; "messageAction": "messageAction"; "editMessage": "editMessage"; "resendMessage": "resendMessage"; "quickReply": "quickReply"; "recommendedIntent": "recommendedIntent"; "layoutChange": "layoutChange"; }, never, never, true, never>;
+}
+
+declare const PRAXIS_ASSISTANT_VOICE_INPUT_MODE: InjectionToken<PraxisAssistantVoiceInputMode>;
+declare const PRAXIS_ASSISTANT_VOICE_LANGUAGE: InjectionToken<string>;
+
+type PraxisAssistantDockTone = 'ready' | 'working' | 'review' | 'governed' | 'error';
+declare class PraxisAiAssistantDockComponent {
+    title: string;
+    summary: string;
+    badge: string;
+    icon: string;
+    state: PraxisAssistantShellState | null;
+    tone: PraxisAssistantDockTone | null;
+    ariaLabel: string;
+    openAriaLabel: string;
+    openTooltip: string;
+    testId: string;
+    openTestId: string;
+    open: EventEmitter<void>;
+    resolvedTone(): PraxisAssistantDockTone;
+    resolvedIcon(): string;
+    resolvedBadge(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisAiAssistantDockComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisAiAssistantDockComponent, "praxis-ai-assistant-dock", never, { "title": { "alias": "title"; "required": false; }; "summary": { "alias": "summary"; "required": false; }; "badge": { "alias": "badge"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "state": { "alias": "state"; "required": false; }; "tone": { "alias": "tone"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "openAriaLabel": { "alias": "openAriaLabel"; "required": false; }; "openTooltip": { "alias": "openTooltip"; "required": false; }; "testId": { "alias": "testId"; "required": false; }; "openTestId": { "alias": "openTestId"; "required": false; }; }, { "open": "open"; }, never, never, true, never>;
+}
+
+declare class PraxisAiAssistantSessionHostComponent {
+    private readonly registry;
+    testId: string;
+    dockTestIdPrefix: string;
+    ariaLabel: string;
+    openAriaLabel: string;
+    openTooltip: string;
+    ownerType: string | null;
+    ownerId: string | null;
+    visibility: PraxisAssistantSessionVisibility | 'all';
+    includeOriginAnchored: boolean;
+    sessionOpen: EventEmitter<PraxisAssistantSessionSnapshot>;
+    visibleSessions(): readonly PraxisAssistantSessionSnapshot[];
+    openSession(sessionId: string): void;
+    sessionAriaLabel(session: PraxisAssistantSessionSnapshot): string;
+    dockTestId(session: PraxisAssistantSessionSnapshot, first: boolean): string;
+    dockOpenTestId(session: PraxisAssistantSessionSnapshot, first: boolean): string;
+    trackSession(_index: number, session: PraxisAssistantSessionSnapshot): string;
+    private safeId;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisAiAssistantSessionHostComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisAiAssistantSessionHostComponent, "praxis-ai-assistant-session-host", never, { "testId": { "alias": "testId"; "required": false; }; "dockTestIdPrefix": { "alias": "dockTestIdPrefix"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "openAriaLabel": { "alias": "openAriaLabel"; "required": false; }; "openTooltip": { "alias": "openTooltip"; "required": false; }; "ownerType": { "alias": "ownerType"; "required": false; }; "ownerId": { "alias": "ownerId"; "required": false; }; "visibility": { "alias": "visibility"; "required": false; }; "includeOriginAnchored": { "alias": "includeOriginAnchored"; "required": false; }; }, { "sessionOpen": "sessionOpen"; }, never, never, true, never>;
+    static ngAcceptInputType_includeOriginAnchored: unknown;
 }
 
 declare class AiContextBuilderService {
@@ -1566,7 +2599,7 @@ declare class AiContextBuilderService {
     /**
      * Builds the complete context for the AI prompt
      */
-    buildPromptContext(fieldSchemas: Record<string, FieldSchemaLike>, targetType: 'field' | 'section' | 'action' | 'row' | 'column', propertySchema: RulePropertySchema): PromptContext;
+    buildPromptContext(fieldSchemas: Record<string, FieldSchemaLike>, targetType: 'field' | 'section' | 'action' | 'row' | 'column' | 'visualBlock', propertySchema: RulePropertySchema): PromptContext;
     buildRulePrompt(userPrompt: string, context: PromptContext): string;
     buildSuggestionPrompt(context: PromptContext): string;
     /**
@@ -1595,7 +2628,7 @@ declare class AiRuleWizardDialogComponent implements OnInit {
     private snackBar;
     private contextBuilder;
     private cdr;
-    selectedTargetType: 'field' | 'section' | 'action' | 'row' | 'column';
+    selectedTargetType: 'field' | 'section' | 'action' | 'row' | 'column' | 'visualBlock';
     userPrompt: string;
     isGenerating: boolean;
     validationError: string | null;
@@ -1631,5 +2664,5 @@ declare class AiRuleWizardDialogComponent implements OnInit {
     static ɵcmp: i0.ɵɵComponentDeclaration<AiRuleWizardDialogComponent, "praxis-ai-rule-wizard-dialog", never, {}, {}, never, never, true, never>;
 }
 
-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, AgenticAuthoringConversationContextContract, AgenticAuthoringConversationMessageContract, AgenticAuthoringIntentResolutionRequestContract, AgenticAuthoringIntentResolutionResultContract, AgenticAuthoringPendingClarificationContract, AgenticAuthoringPlanRequestContract, AgenticAuthoringPreviewResultContract, AgenticAuthoringQuickReplyContract, 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, 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 };
+export { AI_BACKEND_CONFIG_STORE, AI_BACKEND_ENDPOINTS, 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, AgenticAuthoringTurnClientService, AiBackendApiService, AiPatchStreamConnectionError, AiResponseValidatorService, AiRuleWizardDialogComponent, BaseAiAdapter, PRAXIS_ASSISTANT_CONTEXT_ATTACHMENT_LIMIT, PRAXIS_ASSISTANT_CONTEXT_ITEM_LIMIT, PRAXIS_ASSISTANT_CONTEXT_SCHEMA_FIELD_LIMIT, PRAXIS_ASSISTANT_CONTEXT_TEXT_LIMIT, PRAXIS_ASSISTANT_VOICE_INPUT_MODE, PRAXIS_ASSISTANT_VOICE_LANGUAGE, PraxisAi, PraxisAiAssistantComponent, PraxisAiAssistantDockComponent, PraxisAiAssistantSessionHostComponent, PraxisAiAssistantShellComponent, PraxisAiService, PraxisAssistantSessionRegistryService, PraxisAssistantTurnController, PraxisAssistantTurnOrchestratorService, SchemaMinifierService, createComponentAuthoringContext, createPraxisAssistantViewportLayout, normalizeAuthoringPrompt, normalizePraxisAssistantAttachmentSummary, normalizePraxisAssistantContextSnapshot, sanitizePraxisAssistantText, shouldRoutePromptToGovernedDecision, submitPraxisAssistantQuickReply, toAiJsonObject, toPraxisAssistantClarificationOption, toPraxisAssistantConversationMessages };
+export type { AgenticAuthoringApplyRequestContract, AgenticAuthoringApplyResultContract, AgenticAuthoringAttachmentSummaryContract, AgenticAuthoringCandidateContract, AgenticAuthoringComponentCapabilitiesResultContract, AgenticAuthoringComponentCapabilityCatalogContract, AgenticAuthoringComponentCapabilityContract, AgenticAuthoringComponentCapabilityExampleContract, AgenticAuthoringComponentFieldAliasContract, AgenticAuthoringConversationContextContract, AgenticAuthoringConversationMessageContract, AgenticAuthoringIntentResolutionRequestContract, AgenticAuthoringIntentResolutionResultContract, AgenticAuthoringManifestCompileResult, AgenticAuthoringManifestCompileResultContract, AgenticAuthoringManifestEditPlanRequest, AgenticAuthoringManifestEditPlanRequestContract, AgenticAuthoringManifestValidationResult, AgenticAuthoringManifestValidationResultContract, AgenticAuthoringPendingClarificationContract, AgenticAuthoringPlanRequestContract, AgenticAuthoringPreviewResultContract, AgenticAuthoringQuickReplyContract, AgenticAuthoringResolveTargetRequest, AgenticAuthoringResolveTargetRequestContract, AgenticAuthoringResolvedTarget, AgenticAuthoringResolvedTargetContract, AgenticAuthoringResourceCandidatesRequestContract, AgenticAuthoringResourceCandidatesResultContract, AgenticAuthoringSemanticDecisionContract, AgenticAuthoringTurnClientEvent, AgenticAuthoringTurnClientOptions, AgenticAuthoringTurnLifecycleEvent, AgenticAuthoringTurnStreamConnection, AgenticAuthoringTurnStreamConnectionOptions, AgenticAuthoringTurnStreamEnvelope, AgenticAuthoringTurnStreamEnvelopeContract, AgenticAuthoringTurnStreamEnvelopeEvent, AgenticAuthoringTurnStreamLifecycle, AgenticAuthoringTurnStreamRequest, AgenticAuthoringTurnStreamRequestContract, AgenticAuthoringTurnStreamStartOptions, AgenticAuthoringTurnStreamStartResponse, AgenticAuthoringTurnStreamStartResponseContract, AgenticAuthoringTurnStreamStartedEvent, AiAssistantObservationFeedbackRating, AiAssistantObservationFeedbackRatingValue, AiAssistantObservationFeedbackRequest, AiAssistantObservationFeedbackRequestContract, AiAssistantObservationFeedbackResponse, AiAssistantObservationFeedbackResponseContract, AiAssistantObservationResponseContract, AiAssistantObservationSummaryResponseContract, AiAssistantObservationSummaryRowContract, AiAuthoringResponseMode, AiAuthoringResponseModeKind, AiBackendConfigStore, AiBackendEndpoints, AiBackendStorageOptions, AiChatMessage, AiChatMessageContract, AiClarificationUiContract, AiComponentAuthoringContract, AiConfigAdapter, AiConsultativeAuthoringContext, AiContextDTO, AiContextHintsContract, AiContextTemplate, AiContextTemplateMeta, AiCurrentStateDigest, AiCurrentStateDigestContract, AiDomainCatalogContextHintContract, AiDomainCatalogContextHintIntent, AiDomainCatalogContextHintItemType, AiDomainCatalogRelationshipHintContract, AiExamplePair, AiGlobalConfigSnapshot, AiGovernedDecisionRoutingOptions, 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, PraxisAssistantActionContract, PraxisAssistantActionKind, PraxisAssistantAttachmentKind, PraxisAssistantAttachmentSummary, PraxisAssistantAuthoringManifestRef, PraxisAssistantCapabilityRef, PraxisAssistantClarificationOption, PraxisAssistantClarificationQuestion, PraxisAssistantClarificationQuestionType, PraxisAssistantComponentType, PraxisAssistantContextItem, PraxisAssistantContextMode, PraxisAssistantContextSessionDescriptor, PraxisAssistantContextSnapshot, PraxisAssistantConversationMessage, PraxisAssistantConversationMessageRole, PraxisAssistantDigest, PraxisAssistantDockTone, PraxisAssistantGovernanceHint, PraxisAssistantIdentity, PraxisAssistantOpenRequest, PraxisAssistantOpportunityCandidate, PraxisAssistantOpportunityCandidateStatus, PraxisAssistantOpportunityCatalog, PraxisAssistantOpportunityEvidence, PraxisAssistantOpportunityGroup, PraxisAssistantOpportunityMissingContext, PraxisAssistantOpportunitySafety, PraxisAssistantOpportunityTarget, PraxisAssistantOwnerType, PraxisAssistantPendingClarification, PraxisAssistantRecommendedIntent, PraxisAssistantRecommendedIntentAction, PraxisAssistantRecommendedIntentPresentation, PraxisAssistantRecommendedIntentTone, PraxisAssistantRiskLevel, PraxisAssistantSessionDescriptor, PraxisAssistantSessionIdentityRef, PraxisAssistantSessionPresence, PraxisAssistantSessionSnapshot, PraxisAssistantSessionVisibility, PraxisAssistantShellAction, PraxisAssistantShellActionTone, PraxisAssistantShellAttachment, PraxisAssistantShellContextItem, PraxisAssistantShellLabels, PraxisAssistantShellLayout, PraxisAssistantShellMessage, PraxisAssistantShellMessageAction, PraxisAssistantShellMessageRole, PraxisAssistantShellMode, PraxisAssistantShellQuickReply, PraxisAssistantShellQuickReplyEvidence, PraxisAssistantShellQuickReplyPresentation, PraxisAssistantShellQuickReplyPresentationItem, PraxisAssistantShellQuickReplyPresentationKind, PraxisAssistantShellState, PraxisAssistantTargetKind, PraxisAssistantTargetRef, PraxisAssistantTurnAction, PraxisAssistantTurnControllerOptions, PraxisAssistantTurnFlow, PraxisAssistantTurnPhase, PraxisAssistantTurnRequest, PraxisAssistantTurnResult, PraxisAssistantTurnViewState, PraxisAssistantViewportLayoutOptions, PraxisAssistantVoiceCaptureState, PraxisAssistantVoiceInputMode, ProblemResponseContract, PromptContext, RulePropertyDefinition, RulePropertySchema, RulePropertyType, ValidationContext, ValueKind };