@praxisui/ai 8.0.0-beta.3 → 8.0.0-beta.30

package/index.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: "33c545b58f49404695bf845d2094a5b2858538a54200745f1ecb3ca2d0628f01";
 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;
@@ -86,7 +122,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';
@@ -161,6 +197,7 @@ interface AgenticAuthoringIntentResolutionRequestContract extends AgenticAuthori
     provider?: string | null;
     model?: string | null;
     apiKey?: string | null;
+    contextHints?: AiContextHintsContract | null;
 }
 interface AgenticAuthoringCandidateContract {
     resourcePath?: string | null;
@@ -178,8 +215,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 +302,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 +365,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 +395,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;
@@ -242,6 +479,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;
@@ -260,6 +507,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 +519,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 +532,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,7 +658,119 @@ 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';
@@ -427,13 +789,57 @@ interface PraxisAssistantShellQuickReply {
     label: string;
     prompt: string;
     kind?: string;
+    description?: string | null;
+    icon?: string | null;
+    tone?: string | null;
+    presentation?: PraxisAssistantShellQuickReplyPresentation | null;
+    contextHints?: 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;
 }
 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 +865,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,8 +883,10 @@ interface PraxisAssistantShellLabels {
     apply: string;
     conversationAria: string;
     quickRepliesAria: string;
+    quickReplyDetails?: string;
     dragHandleAria: string;
     resizeHandleAria: string;
+    resetLayout?: string;
     contextAria: string;
     attachmentsAria: string;
     attach: string;
@@ -516,6 +931,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 {
@@ -525,6 +941,13 @@ interface PraxisAssistantPendingClarification {
     clientTurnId?: string;
     diagnostics?: Record<string, unknown>;
 }
+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;
@@ -734,6 +1157,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 +1218,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 +1227,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: "33c545b58f49404695bf845d2094a5b2858538a54200745f1ecb3ca2d0628f01";
 type AiSchemaContext = AiSchemaContextContract;
 interface AiSuggestionsRequest {
     componentId: string;
@@ -828,15 +1260,27 @@ 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;
+}
 type AiPatchStreamConnectionErrorKind = 'unsupported' | 'http_status' | 'transport' | 'parse' | 'schema';
 declare class AiPatchStreamConnectionError extends Error {
     readonly kind: AiPatchStreamConnectionErrorKind;
-    readonly status?: number | undefined;
-    constructor(kind: AiPatchStreamConnectionErrorKind, message: string, status?: number | undefined);
+    readonly status?: number;
+    constructor(kind: AiPatchStreamConnectionErrorKind, message: string, status?: number);
 }
 interface AiProviderModelsRequest {
     provider?: string;
@@ -924,30 +1368,65 @@ 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): Observable<AgenticAuthoringTurnStreamStartResponse>;
+    connectAgenticAuthoringTurnStream(streamId: string, lastEventId?: string, accessToken?: string): AgenticAuthoringTurnStreamConnection;
+    cancelAgenticAuthoringTurnStream(streamId: string, accessToken?: string): Observable<AiPatchStreamCancelResponse>;
     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 isUuid;
+    private authoringManifestUrl;
+    private aiBaseUrl;
+    private aiContextBaseUrl;
+    private resolveBaseUrl;
+    private resolveApiBaseUrl;
+    private joinUrl;
+    private normalizeBaseUrl;
+    private buildApiUrl;
     private resolveHeaderMap;
     private parsePatchStreamEnvelope;
     private isPatchStreamEnvelope;
@@ -973,6 +1452,7 @@ declare class AiResponseValidatorService {
     private validateJsonLogicExpression;
     private walkJsonLogicNode;
     private isSupportedJsonLogicOperator;
+    private validateJsonLogicOperatorArity;
     private collectVarPaths;
     private isValidTargetId;
     private findSimilarTargetId;
@@ -1036,6 +1516,74 @@ declare class PraxisAssistantTurnController {
     private patchState;
     private cloneState;
     private toObservable;
+    private buildFlowErrorResult;
+    private describeFlowError;
+    private serializeFlowError;
+    private toRecord;
+    private toString;
+    private toNumber;
+}
+
+type PraxisAssistantSessionVisibility = 'active' | 'minimized';
+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;
+    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;
+    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>;
+    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 +1625,7 @@ interface ClarificationOption {
     value: string;
     example?: string;
 }
-type ClarificationContextHints = AiJsonObject;
+type ClarificationContextHints = AiContextHintsContract;
 interface ClarificationRichOption extends ClarificationOption {
     contextHints?: ClarificationContextHints;
 }
@@ -1411,6 +1959,7 @@ declare class PraxisAiAssistantComponent implements OnDestroy {
     private hasBadgeColors;
     private hasBadgeField;
     private mergeContextHints;
+    private enrichDomainCatalogAuthoringHints;
     private setResourcePathHint;
     private clearResourcePathHint;
     private matchClarificationOptionPath;
@@ -1466,6 +2015,16 @@ 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>;
 }
 
+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;
@@ -1481,10 +2040,15 @@ 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;
@@ -1497,6 +2061,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[]>;
@@ -1516,6 +2083,7 @@ declare class PraxisAiAssistantShellComponent implements OnChanges, OnDestroy {
     protected currentPrompt: string;
     protected resolvedLabels: PraxisAssistantShellLabels;
     protected currentLayout: PraxisAssistantShellLayout;
+    protected readonly resizeHandles: readonly ResizeDirection[];
     private pointerSession;
     private readonly ownedPreviewUrls;
     private readonly onWindowPointerMove;
@@ -1529,13 +2097,62 @@ declare class PraxisAiAssistantShellComponent implements OnChanges, OnDestroy {
     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 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 shouldShowAuxiliaryText;
+    private normalizeMessageText;
+    private getDefaultPrimaryAction;
     protected onQuickReply(reply: PraxisAssistantShellQuickReply): void;
+    protected getQuickReplyAriaLabel(reply: PraxisAssistantShellQuickReply): string;
+    protected getQuickReplyTechnicalDetails(reply: PraxisAssistantShellQuickReply): string;
+    protected isRichQuickReply(reply: PraxisAssistantShellQuickReply): 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 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;
@@ -1543,9 +2160,10 @@ declare class PraxisAiAssistantShellComponent implements OnChanges, OnDestroy {
     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 +2175,50 @@ 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; }; "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; }; "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"; "layoutChange": "layoutChange"; }, never, never, true, never>;
+}
+
+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';
+    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; }; }, { "sessionOpen": "sessionOpen"; }, never, never, true, never>;
 }
 
 declare class AiContextBuilderService {
@@ -1566,7 +2227,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 +2256,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 +2292,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, 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, PraxisAi, PraxisAiAssistantComponent, PraxisAiAssistantDockComponent, PraxisAiAssistantSessionHostComponent, PraxisAiAssistantShellComponent, PraxisAiService, PraxisAssistantSessionRegistryService, PraxisAssistantTurnController, PraxisAssistantTurnOrchestratorService, SchemaMinifierService, createPraxisAssistantViewportLayout, normalizeAuthoringPrompt, normalizePraxisAssistantAttachmentSummary, normalizePraxisAssistantContextSnapshot, sanitizePraxisAssistantText, shouldRoutePromptToGovernedDecision, 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, AgenticAuthoringTurnStreamConnection, AgenticAuthoringTurnStreamEnvelope, AgenticAuthoringTurnStreamEnvelopeContract, AgenticAuthoringTurnStreamRequest, AgenticAuthoringTurnStreamRequestContract, AgenticAuthoringTurnStreamStartResponse, AgenticAuthoringTurnStreamStartResponseContract, AiBackendConfigStore, AiBackendEndpoints, AiBackendStorageOptions, AiChatMessage, AiChatMessageContract, AiClarificationUiContract, AiConfigAdapter, 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, PraxisAssistantOwnerType, PraxisAssistantPendingClarification, PraxisAssistantRiskLevel, PraxisAssistantSessionDescriptor, PraxisAssistantSessionIdentityRef, 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, ProblemResponseContract, PromptContext, RulePropertyDefinition, RulePropertySchema, RulePropertyType, ValidationContext, ValueKind };