@duckcodeailabs/dql-agent 1.14.1 → 1.14.2

package/dist/answer-shape.d.ts

@@ -12,5 +12,36 @@ export interface AnswerShapeValidation {
     topN?: number;
     topNReturned?: number;
 }
-export declare function validateAnswerResultShape(plan: AnalysisQuestionPlan, result: AnswerShapeResultLike): AnswerShapeValidation;
+/**
+ * An artifact-owned mapping from a requested analytical role to the exact
+ * output alias emitted by a frozen execution authority.
+ *
+ * These bindings are intentionally narrow.  They are not retrieval aliases:
+ * callers may only supply them from the selected certified artifact or the
+ * immutable resolved plan that selected it.  In particular, a nearby metric,
+ * block tag, or description can never make a returned column satisfy a
+ * requested output here.
+ */
+export interface AnswerShapeOutputBinding {
+    /** The role/term the frozen plan resolved (for example `customer`). */
+    requested: string;
+    /** The declared output name the selected artifact actually returns. */
+    output: string;
+    /** `measure` remains strict; dimensions and entity labels are role bindings. */
+    role: 'measure' | 'dimension' | 'entity_label';
+    /** Explicit authored aliases for a dimension/entity role, if any. */
+    aliases?: string[];
+}
+export interface AnswerShapeValidationOptions {
+    /** Artifact-local aliases from the frozen execution authority only. */
+    outputBindings?: readonly AnswerShapeOutputBinding[];
+    /**
+     * A frozen certified plan must prove requested measures through its own
+     * binding. This is deliberately off for semantic/generated results, where a
+     * governed projection such as `beverage_revenue` legitimately answers a
+     * plain-English spend request.
+     */
+    requireBoundMeasures?: boolean;
+}
+export declare function validateAnswerResultShape(plan: AnalysisQuestionPlan, result: AnswerShapeResultLike, options?: AnswerShapeValidationOptions): AnswerShapeValidation;
 //# sourceMappingURL=answer-shape.d.ts.map

package/dist/answer-shape.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"answer-shape.d.ts","sourceRoot":"","sources":["../src/answer-shape.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,oBAAoB,EAC1B,MAAM,EAAE,qBAAqB,GAC5B,qBAAqB,CAyBvB"}
+{"version":3,"file":"answer-shape.d.ts","sourceRoot":"","sources":["../src/answer-shape.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,wBAAwB;IACvC,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,cAAc,CAAC;IAC/C,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,4BAA4B;IAC3C,uEAAuE;IACvE,cAAc,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACrD;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,oBAAoB,EAC1B,MAAM,EAAE,qBAAqB,EAC7B,OAAO,GAAE,4BAAiC,GACzC,qBAAqB,CAgCvB"}

package/dist/answer-shape.js

@@ -1,7 +1,14 @@
-export function validateAnswerResultShape(plan, result) {
+export function validateAnswerResultShape(plan, result, options = {}) {
     const columns = resultColumnsForShape(result);
     const rowCount = resultRowCount(result);
-    const missingOutputs = plan.requestedShape.requiredOutputs.filter((output) => !columns.some((column) => columnCoversRequestedOutput(column, output)));
+    const missingOutputs = plan.requestedShape.requiredOutputs.filter((output) => {
+        const bindingMatches = columns.some((column) => outputBindingCoversRequestedOutput(column, output, options.outputBindings ?? []));
+        if (bindingMatches)
+            return false;
+        if (options.requireBoundMeasures && isRequestedMeasureOutput(plan, output))
+            return true;
+        return !columns.some((column) => columnCoversRequestedOutput(column, output));
+    });
     const warnings = [];
     if (missingOutputs.length > 0) {
         warnings.push(`The answer is missing requested output column(s): ${missingOutputs.join(', ')}.`);
@@ -66,12 +73,51 @@ function columnCoversRequestedOutput(column, requiredOutput) {
     }
     return requiredTokens.every((token) => columnTokens.some((columnToken) => outputTokensEquivalent(token, columnToken)));
 }
+function isRequestedMeasureOutput(plan, output) {
+    const required = canonicalResultColumn(output);
+    return plan.requestedShape.measures.some((measure) => {
+        const candidate = canonicalResultColumn(measure);
+        if (!candidate || !required)
+            return false;
+        if (candidate === required)
+            return true;
+        const candidateTokens = candidate.split('_').filter(Boolean);
+        const requiredTokens = required.split('_').filter(Boolean);
+        return candidateTokens.length === 1
+            && requiredTokens.length === 1
+            && outputTokensEquivalent(candidateTokens[0], requiredTokens[0]);
+    });
+}
+function outputBindingCoversRequestedOutput(column, requiredOutput, bindings) {
+    const required = canonicalResultColumn(requiredOutput);
+    if (!required)
+        return true;
+    return bindings.some((binding) => {
+        if (canonicalResultColumn(binding.output) !== column)
+            return false;
+        const requested = canonicalResultColumn(binding.requested);
+        const aliases = (binding.aliases ?? []).map(canonicalResultColumn);
+        const requestedRoleMatches = requested === required || aliases.includes(required);
+        if (!requestedRoleMatches)
+            return false;
+        // A measure binding must have been created from the frozen plan's strict
+        // declared measure proof.  We therefore require its exact requested role,
+        // rather than applying broad column similarity a second time.
+        return binding.role === 'measure' || binding.role === 'dimension' || binding.role === 'entity_label';
+    });
+}
 // Keep this deliberately small and business-semantic. These are common measure
 // words that users interchange in plain English; matching them prevents a
 // correctly selected certified contract from being rejected merely because its
 // governed output uses `revenue` while the question says `spend`.
 const OUTPUT_TOKEN_EQUIVALENCE = [
-    new Set(['spend', 'spending', 'revenue', 'sales']),
+    // `canonicalResultColumn` singularizes ordinary English plurals before this
+    // comparison. Keep the singular form here as well: otherwise a certified
+    // `revenue` output is incorrectly rejected for "sales by category" after
+    // `sales` becomes `sale`, and a frozen certified plan is misreported as a
+    // generated-route mismatch. This is deliberately limited to the revenue
+    // family; unrelated business measures (for example BCM) remain distinct.
+    new Set(['spend', 'spending', 'revenue', 'sales', 'sale']),
     new Set(['count', 'number', 'num', 'quantity', 'qty']),
 ];
 function outputTokensEquivalent(required, column) {

package/dist/answer-shape.js.map

@@ -1 +1 @@
-{"version":3,"file":"answer-shape.js","sourceRoot":"","sources":["../src/answer-shape.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"answer-shape.js","sourceRoot":"","sources":["../src/answer-shape.ts"],"names":[],"mappings":"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"}

package/dist/conversation/snapshot.d.ts

@@ -7,6 +7,7 @@ import type { ConversationStore, ConversationTurn } from './session-store.js';
 import type { AgentDqlArtifactReference } from '../answer-loop.js';
 import type { CascadeAnswerResult } from '../cascade/cascade.js';
 import type { KnowledgeLens } from '../domain-context.js';
+import type { AnalyticalRequirementSetV1 } from '../analytical-orchestration.js';
 import { type ConversationWorkingState, type TopicRelation } from './working-state.js';
 import { type ConversationSummaryV1 } from './rolling-summary.js';
 export interface ConversationSnapshotTurn {
@@ -58,6 +59,18 @@ export interface ConversationEnvelopeV1 {
         question: string;
         /** The user's original analytical question that triggered it. */
         sourceQuestion?: string;
+        /**
+         * Server-persisted continuation contract. These identifiers and typed
+         * requirements are reject-only on a later request; the router still checks
+         * current snapshot eligibility before allowing a plan to freeze.
+         */
+        selection?: {
+            version: 1;
+            optionIds: string[];
+            ambiguityCandidateIds: string[];
+            requirements?: AnalyticalRequirementSetV1;
+            snapshotId?: string;
+        };
     };
 }
 /** Compatibility name retained for existing API/provider consumers. */
@@ -80,6 +93,13 @@ export declare function isLikelyClarificationReply(value: string): boolean;
 export declare function buildConversationSnapshot(store: ConversationStore, threadId: string, options?: {
     question?: string;
     recent?: number;
+    /**
+     * Host-only structured-choice continuation. The Notebook replays the
+     * original analytical question when an option is clicked, so that complete
+     * wording must not clear the persisted server selection before the router
+     * can validate it.
+     */
+    preservePendingClarification?: boolean;
 }): ConversationSnapshot | null;
 /**
  * Post-run maintenance: fold the appended turn into the thread's working state

package/dist/conversation/snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/conversation/snapshot.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/conversation/snapshot.ts"],"names":[],"mappings":"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"}

package/dist/conversation/snapshot.js

@@ -87,7 +87,7 @@ export function buildConversationSnapshot(store, threadId, options = {}) {
     const latest = recent[recent.length - 1];
     const latestNeedsClarification = Boolean(latest && (latest.route === 'clarify' || latest.runStatus === 'needs_clarification'));
     const carryPendingClarification = latestNeedsClarification
-        && (!options.question || isLikelyClarificationReply(options.question));
+        && (!options.question || isLikelyClarificationReply(options.question) || options.preservePendingClarification === true);
     return {
         version: 1,
         threadId,
@@ -105,10 +105,39 @@ export function buildConversationSnapshot(store, threadId, options = {}) {
                 // analytical question, so a repeated clarify chain still recovers the
                 // request rather than a terse "yes".
                 sourceQuestion: analyticalQuestionBefore(recent, recent.length - 1),
+                ...(pendingClarificationSelection(latest)
+                    ? { selection: pendingClarificationSelection(latest) }
+                    : {}),
             }
             : undefined,
     };
 }
+function pendingClarificationSelection(turn) {
+    const raw = turn.contract?.clarificationSelection;
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return undefined;
+    const record = raw;
+    const ids = (value) => Array.isArray(value)
+        ? [...new Set(value.filter((item) => typeof item === 'string' && Boolean(item.trim())).map((item) => item.trim()))].slice(0, 16)
+        : [];
+    const optionIds = ids(record.optionIds);
+    const ambiguityCandidateIds = ids(record.ambiguityCandidateIds);
+    if (optionIds.length === 0 && ambiguityCandidateIds.length === 0)
+        return undefined;
+    const requirements = record.requirements && typeof record.requirements === 'object' && !Array.isArray(record.requirements)
+        ? record.requirements
+        : undefined;
+    const snapshotId = typeof record.snapshotId === 'string' && record.snapshotId.trim()
+        ? record.snapshotId.trim()
+        : undefined;
+    return {
+        version: 1,
+        optionIds,
+        ambiguityCandidateIds,
+        ...(requirements ? { requirements } : {}),
+        ...(snapshotId ? { snapshotId } : {}),
+    };
+}
 /**
  * Walk back from `index` to the last turn whose question is a real analytical
  * request rather than a clarification reply. A repeated clarify chain

package/dist/conversation/snapshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/conversation/snapshot.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/conversation/snapshot.ts"],"names":[],"mappings":"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"}

package/dist/fixtures/ask-ai-office-shaped.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Sanitized, non-customer regression prompts derived from the Ask AI failure
+ * reports. They intentionally contain only generic business concepts and no
+ * office identifiers, SQL, data values, or provider configuration.
+ *
+ * Gold results stay out of runtime prompt context. The fixture is test-only
+ * guidance for the deterministic requirement/ranking contracts.
+ */
+export declare const OFFICE_ASK_AI_GOLD_CASES: readonly [{
+    readonly id: "office-lost-opportunities-fy26-datadog";
+    readonly question: "Lost opportunities count and lost amount by month for fiscal year FY26 with competitor Datadog";
+    readonly expected: {
+        readonly measures: readonly ["lost opportunities count", "lost amount"];
+        readonly dimension: "competitor";
+        readonly grain: "month";
+        readonly fiscalPeriod: "FY26";
+    };
+}, {
+    readonly id: "office-top-bcm-customers-by-revenue";
+    readonly question: "Who are the top BCM customers who have highest revenue?";
+    readonly expected: {
+        readonly rankingMeasure: "revenue";
+        readonly entity: "customer";
+        readonly defaultTop: 10;
+    };
+}, {
+    readonly id: "office-bcm-run-rate-top-accounts";
+    readonly question: "What is the current BCM run rate across top accounts?";
+    readonly expected: {
+        readonly rankingMeasure: "BCM";
+        readonly entity: "account";
+        readonly defaultTop: 10;
+    };
+}];
+/**
+ * Test-only, sanitized metadata fixture for the three reported journeys. This
+ * deliberately mirrors the kinds of artifacts Ask consumes (semantic objects,
+ * dbt relations, runtime columns, and a declared fiscal calendar) without
+ * containing a customer repository, warehouse data, credentials, or gold SQL.
+ *
+ * Gold result values are intentionally absent: evaluation checks route,
+ * selected roles, trust, and safety rather than leaking answers into runtime
+ * guidance.
+ */
+export declare const OFFICE_ASK_AI_SANITIZED_FIXTURE: {
+    readonly version: 1;
+    readonly snapshotId: "fixture:office-ask-ai:v1";
+    readonly fiscalCalendar: {
+        readonly id: "semantic:calendar:fiscal";
+        readonly fiscalPeriodFieldId: "semantic:dimension:opportunity.fiscal_period";
+        readonly dateRoleId: "semantic:dimension:opportunity.close_date";
+    };
+    readonly semantic: {
+        readonly metrics: readonly [{
+            readonly id: "semantic:metric:lost_opportunities_count";
+            readonly name: "Lost Opportunities Count";
+            readonly roles: readonly ["metric"];
+        }, {
+            readonly id: "semantic:metric:lost_amount";
+            readonly name: "Lost Amount";
+            readonly roles: readonly ["metric"];
+        }, {
+            readonly id: "semantic:metric:revenue";
+            readonly name: "Revenue";
+            readonly roles: readonly ["metric"];
+        }, {
+            readonly id: "semantic:metric:bcm_run_rate";
+            readonly name: "BCM Run Rate";
+            readonly roles: readonly ["metric"];
+        }];
+        readonly dimensions: readonly [{
+            readonly id: "semantic:dimension:opportunity.competitor";
+            readonly name: "Competitor";
+            readonly roles: readonly ["categorical_dimension"];
+        }, {
+            readonly id: "semantic:dimension:opportunity.close_date";
+            readonly name: "Close Date";
+            readonly roles: readonly ["time_dimension"];
+        }, {
+            readonly id: "semantic:dimension:opportunity.fiscal_period";
+            readonly name: "Fiscal Period";
+            readonly roles: readonly ["time_dimension"];
+        }, {
+            readonly id: "semantic:dimension:account.name";
+            readonly name: "Account Name";
+            readonly roles: readonly ["entity_label"];
+        }, {
+            readonly id: "semantic:dimension:customer.name";
+            readonly name: "Customer Name";
+            readonly roles: readonly ["entity_label"];
+        }];
+    };
+    readonly dbtManifest: {
+        readonly models: readonly [{
+            readonly id: "model:analytics.opportunities";
+            readonly relation: "analytics.opportunities";
+            readonly columns: readonly ["close_date", "fiscal_period", "competitor", "lost_amount", "is_lost"];
+        }, {
+            readonly id: "model:analytics.account_revenue";
+            readonly relation: "analytics.account_revenue";
+            readonly columns: readonly ["account_name", "customer_name", "revenue", "bcm_run_rate"];
+        }];
+    };
+    readonly runtimeSchema: {
+        readonly relations: readonly [{
+            readonly relation: "analytics.opportunities";
+            readonly columns: readonly ["close_date", "fiscal_period", "competitor", "lost_amount", "is_lost"];
+        }, {
+            readonly relation: "analytics.account_revenue";
+            readonly columns: readonly ["account_name", "customer_name", "revenue", "bcm_run_rate"];
+        }];
+    };
+    readonly relationships: readonly [{
+        readonly id: "relationship:opportunity_account";
+        readonly from: "analytics.opportunities";
+        readonly to: "analytics.account_revenue";
+        readonly cardinality: "many_to_one";
+        readonly fanoutSafe: true;
+    }];
+    readonly evals: ({
+        goldSqlWithheld: boolean;
+        goldResultWithheld: boolean;
+        id: "office-lost-opportunities-fy26-datadog";
+        question: "Lost opportunities count and lost amount by month for fiscal year FY26 with competitor Datadog";
+        expected: {
+            readonly measures: readonly ["lost opportunities count", "lost amount"];
+            readonly dimension: "competitor";
+            readonly grain: "month";
+            readonly fiscalPeriod: "FY26";
+        };
+    } | {
+        goldSqlWithheld: boolean;
+        goldResultWithheld: boolean;
+        id: "office-top-bcm-customers-by-revenue";
+        question: "Who are the top BCM customers who have highest revenue?";
+        expected: {
+            readonly rankingMeasure: "revenue";
+            readonly entity: "customer";
+            readonly defaultTop: 10;
+        };
+    } | {
+        goldSqlWithheld: boolean;
+        goldResultWithheld: boolean;
+        id: "office-bcm-run-rate-top-accounts";
+        question: "What is the current BCM run rate across top accounts?";
+        expected: {
+            readonly rankingMeasure: "BCM";
+            readonly entity: "account";
+            readonly defaultTop: 10;
+        };
+    })[];
+};
+//# sourceMappingURL=ask-ai-office-shaped.d.ts.map

package/dist/fixtures/ask-ai-office-shaped.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-ai-office-shaped.d.ts","sourceRoot":"","sources":["../../src/fixtures/ask-ai-office-shaped.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;EAgB3B,CAAC;AAEX;;;;;;;;;GASG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDlC,CAAC"}

package/dist/fixtures/ask-ai-office-shaped.js

@@ -0,0 +1,94 @@
+/**
+ * Sanitized, non-customer regression prompts derived from the Ask AI failure
+ * reports. They intentionally contain only generic business concepts and no
+ * office identifiers, SQL, data values, or provider configuration.
+ *
+ * Gold results stay out of runtime prompt context. The fixture is test-only
+ * guidance for the deterministic requirement/ranking contracts.
+ */
+export const OFFICE_ASK_AI_GOLD_CASES = [
+    {
+        id: 'office-lost-opportunities-fy26-datadog',
+        question: 'Lost opportunities count and lost amount by month for fiscal year FY26 with competitor Datadog',
+        expected: { measures: ['lost opportunities count', 'lost amount'], dimension: 'competitor', grain: 'month', fiscalPeriod: 'FY26' },
+    },
+    {
+        id: 'office-top-bcm-customers-by-revenue',
+        question: 'Who are the top BCM customers who have highest revenue?',
+        expected: { rankingMeasure: 'revenue', entity: 'customer', defaultTop: 10 },
+    },
+    {
+        id: 'office-bcm-run-rate-top-accounts',
+        question: 'What is the current BCM run rate across top accounts?',
+        expected: { rankingMeasure: 'BCM', entity: 'account', defaultTop: 10 },
+    },
+];
+/**
+ * Test-only, sanitized metadata fixture for the three reported journeys. This
+ * deliberately mirrors the kinds of artifacts Ask consumes (semantic objects,
+ * dbt relations, runtime columns, and a declared fiscal calendar) without
+ * containing a customer repository, warehouse data, credentials, or gold SQL.
+ *
+ * Gold result values are intentionally absent: evaluation checks route,
+ * selected roles, trust, and safety rather than leaking answers into runtime
+ * guidance.
+ */
+export const OFFICE_ASK_AI_SANITIZED_FIXTURE = {
+    version: 1,
+    snapshotId: 'fixture:office-ask-ai:v1',
+    fiscalCalendar: {
+        id: 'semantic:calendar:fiscal',
+        fiscalPeriodFieldId: 'semantic:dimension:opportunity.fiscal_period',
+        dateRoleId: 'semantic:dimension:opportunity.close_date',
+    },
+    semantic: {
+        metrics: [
+            { id: 'semantic:metric:lost_opportunities_count', name: 'Lost Opportunities Count', roles: ['metric'] },
+            { id: 'semantic:metric:lost_amount', name: 'Lost Amount', roles: ['metric'] },
+            { id: 'semantic:metric:revenue', name: 'Revenue', roles: ['metric'] },
+            { id: 'semantic:metric:bcm_run_rate', name: 'BCM Run Rate', roles: ['metric'] },
+        ],
+        dimensions: [
+            { id: 'semantic:dimension:opportunity.competitor', name: 'Competitor', roles: ['categorical_dimension'] },
+            { id: 'semantic:dimension:opportunity.close_date', name: 'Close Date', roles: ['time_dimension'] },
+            { id: 'semantic:dimension:opportunity.fiscal_period', name: 'Fiscal Period', roles: ['time_dimension'] },
+            { id: 'semantic:dimension:account.name', name: 'Account Name', roles: ['entity_label'] },
+            { id: 'semantic:dimension:customer.name', name: 'Customer Name', roles: ['entity_label'] },
+        ],
+    },
+    dbtManifest: {
+        models: [
+            {
+                id: 'model:analytics.opportunities',
+                relation: 'analytics.opportunities',
+                columns: ['close_date', 'fiscal_period', 'competitor', 'lost_amount', 'is_lost'],
+            },
+            {
+                id: 'model:analytics.account_revenue',
+                relation: 'analytics.account_revenue',
+                columns: ['account_name', 'customer_name', 'revenue', 'bcm_run_rate'],
+            },
+        ],
+    },
+    runtimeSchema: {
+        relations: [
+            { relation: 'analytics.opportunities', columns: ['close_date', 'fiscal_period', 'competitor', 'lost_amount', 'is_lost'] },
+            { relation: 'analytics.account_revenue', columns: ['account_name', 'customer_name', 'revenue', 'bcm_run_rate'] },
+        ],
+    },
+    relationships: [
+        {
+            id: 'relationship:opportunity_account',
+            from: 'analytics.opportunities',
+            to: 'analytics.account_revenue',
+            cardinality: 'many_to_one',
+            fanoutSafe: true,
+        },
+    ],
+    evals: OFFICE_ASK_AI_GOLD_CASES.map((entry) => ({
+        ...entry,
+        goldSqlWithheld: true,
+        goldResultWithheld: true,
+    })),
+};
+//# sourceMappingURL=ask-ai-office-shaped.js.map

package/dist/fixtures/ask-ai-office-shaped.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-ai-office-shaped.js","sourceRoot":"","sources":["../../src/fixtures/ask-ai-office-shaped.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -15,10 +15,10 @@ export { buildKGFromManifest, buildKGFromSemanticLayer } from "./kg/build.js";
 export { activeSkills, buildSkillBlockHints, loadSkills, parseSkill, renderSkill, buildSkillsPrompt, selectRelevantSkills, buildSkillMetricHints, expandQuestionWithSkillVocabulary, writeSkill, previewSkillChange, applySkillChange, hashSkillSource, upsertSkill, deleteSkill, migrateLegacySkills, configuredSkillsPath, skillsDir, legacySkillsDir, skillPath, } from "./skills/loader.js";
 export type { Skill, SkillLoadResult, WriteSkillInput, SkillChangePreview, SkillSourcePatch, SelectRelevantSkillsOptions, } from "./skills/loader.js";
 export { seedDefaultSkills } from "./skills/defaults.js";
-export { ANALYTICAL_ORCHESTRATION_CONTRACT_VERSION, assertCanonicalResult, buildAnalyticalTaskGraph, buildAnalyticalTurnPlan, buildCoverageGap, buildResearchEvidenceLedger, canonicalResultBindingValue, canonicalResultRowFingerprint, canonicalResultRows, capResearchBranches, fuseContextCandidates, inferAnalyticalTurnKind, normalizeCanonicalQueryResult, normalizeAnalyticalExecutionFingerprint, normalizeAnalyticalExecutionReceipt, retrieveContextLanes, resolveTopRankedRegionDependency, splitAnalyticalTasks, summarizeTaskOutcomes, validateSelectedResultBinding, } from './analytical-orchestration.js';
+export { ANALYTICAL_ORCHESTRATION_CONTRACT_VERSION, assertCanonicalResult, buildAnalyticalTaskGraph, buildAnalyticalCascadeDecision, buildAnalyticalRequirementSet, buildAnalyticalTurnPlan, buildCoverageGap, buildResearchEvidenceLedger, buildResearchEvidenceLedgerV2, buildResearchHypothesisPlanV2, canonicalResultBindingValue, canonicalResultRowFingerprint, classifyProviderFailure, evidenceCandidateRoles, canonicalResultRows, capResearchBranches, fuseContextCandidates, inferAnalyticalTurnKind, inferResearchValidatorKind, normalizeCanonicalQueryResult, normalizeAnalyticalExecutionFingerprint, normalizeAnalyticalExecutionReceipt, retrieveContextLanes, resolveTopRankedRegionDependency, researchVerdictFromValidatedObservation, selectRoleBalancedMeaningCandidates, splitAnalyticalTasks, summarizeTaskOutcomes, validateSelectedResultBinding, } from './analytical-orchestration.js';
 export { evaluateAnalyticalRequestPolicy } from './analytical-request-policy.js';
 export type { AnalyticalRequestPolicyDecision } from './analytical-request-policy.js';
-export type { AnalyticalAnswerSectionV1, AnalyticalCoverageGapV1, AgentSelectedResultBindingV1, AgentSelectedResultBindingValidation, AnalyticalTaskKind, AnalyticalTaskDependencyBindingV1, AnalyticalTaskDependencyResolution, AnalyticalTaskDependencyV1, AnalyticalTaskOutputContractV1, AnalyticalTaskStatus, AnalyticalTaskV1, AnalyticalTaskOutcomeV1, AnalyticalTurnAnswerV1, AnalyticalTurnKind, AnalyticalTurnPlanV1, CanonicalQueryResultV1, ContextCandidateCardV1, ContextFusionDiagnosticsV1, ContextFusionResultV1, ResearchEvidenceLedgerV1, ResearchLedgerEntryV1, } from './analytical-orchestration.js';
+export type { AnalyticalAnswerSectionV1, AnalyticalCascadeDecisionV1, AnalyticalCascadeTierOutcomeV1, AnalyticalCascadeTierV1, AnalyticalCoverageGapV1, AnalyticalRequirementSetV1, AgentSelectedResultBindingV1, AgentSelectedResultBindingValidation, AnalyticalTaskKind, AnalyticalTaskDependencyBindingV1, AnalyticalTaskDependencyResolution, AnalyticalTaskDependencyV1, AnalyticalTaskOutputContractV1, AnalyticalTaskStatus, AnalyticalTaskV1, AnalyticalTaskOutcomeV1, AnalyticalTurnAnswerV1, AnalyticalTurnKind, AnalyticalTurnPlanV1, CanonicalQueryResultV1, CascadeTierAttemptV1, ContextSourceCoverageV1, ContextSourceCoverageStatusV1, ContextCandidateCardV1, ContextFusionDiagnosticsV1, ContextFusionResultV1, EvidenceCandidateRoleV1, ExploratoryExecutionFreezeV1, AgentRunDiagnosticReceiptV3, ProviderFailureCauseV1, ProviderFailureDiagnosticV1, ResearchEvidenceLedgerV1, ResearchEvidenceLedgerV2, ResearchLedgerEntryV1, ResearchEvidenceLedgerEntryV2, ResearchEvidenceValidatorKindV2, ResearchEvidenceValidatorV2, ResearchHypothesisPlanEntryV2, ResearchHypothesisPlanV2, } from './analytical-orchestration.js';
 export { APP_SOURCE_REUSABLE_TAG, hasGeneratedAppSourceOrigin, isExplicitlyReusableAppSource, } from './app-source-policy.js';
 export { AppSourceCatalogError, queryAppSourceCatalog, resolveAppSourceCatalogRecords, shortlistAppSources, } from './app-source-catalog.js';
 export { planAppBuildBrief } from './app-builder-orchestrator.js';
@@ -30,7 +30,7 @@ export type { DomainBootstrapCandidate, DomainSkillBootstrapAiDraft, DomainSkill
 export { buildContextAuthoringProposal, contextAuthoringDependencyClosure, contextAuthoringProposalHash, FileContextAuthoringProposalStore, } from './context-authoring.js';
 export type { ContextAuthoringDiagnosticV1, ContextAuthoringOperation, ContextAuthoringOrigin, ContextAuthoringPatchV1, ContextAuthoringProposalInput, ContextAuthoringProposalV1, } from './context-authoring.js';
 export type { SeedDefaultSkillsOptions, SeedDefaultSkillsResult, } from "./skills/defaults.js";
-export { answer, parseProposal, compactSemanticRuntimeFailure, materializeKnowledgeLensSkills, normalizeWarehouseSqlFailure, } from "./answer-loop.js";
+export { answer, parseProposal, compactSemanticRuntimeFailure, materializeKnowledgeLensSkills, normalizeWarehouseSqlFailure, scopeContextPackToExploratoryCandidateClosure, } from "./answer-loop.js";
 export { classifyAnalyticalFailure, createAnalyticalFailure, deriveAnalyticalRepair, redactAnalyticalDiagnostic, } from './analytical-failure-repair.js';
 export { PROVIDER_RESULT_ROW_REDACTION_POLICY_ID, PROVIDER_ZERO_RESULT_ROWS_POLICY_ID, assertProviderPayloadAllowed, boundProviderResultRows, createProviderDispatchEgressReceipt, createProviderEgressReceipt, inspectProviderPayloadRowShape, markProviderMetadata, markProviderMetadataArray, prepareProviderContextForDispatch, prepareServerOwnedProviderSchemaContext, prepareProviderWireEnvelopeForDispatch, providerPayloadFingerprint, redactProviderResultRows, stripProviderResultRows, ASK_NARRATION_RESULT_ROW_POLICY_ID, MAX_ASK_NARRATION_RESULT_ROWS, DEFAULT_ASK_ROW_EGRESS_POLICY, ZERO_ROW_EGRESS_POLICY, RESEARCH_ROW_EGRESS_POLICY, resolveProviderResultRowEgressPolicy, type ProviderPayloadGuardPolicy, type ProviderPayloadRowShape, type BoundedProviderResultRows, type ProviderResultRowEgressPolicy, } from './provider-egress.js';
 export { buildAggregationSafetyProof } from './aggregation-safety-proof.js';
@@ -56,7 +56,7 @@ export { defaultAgentRunGates } from "./agent-run-gates.js";
 export { narrateResult, type NarrateInput, type NarrateItem, type NarrateResult, type NarrateResultData, type NarrateCompletion, type NarrateOptions, } from "./narrate.js";
 export { createLlmAgentRunPlanner, type AgentRunPlannerCompletion, type LlmAgentRunPlannerOptions, } from "./agent-run-planner.js";
 export { createHybridRouter, parseMeaningResolution, type RouterClassification, type RouterCompletion, type HybridRouterOptions, } from "./router.js";
-export { buildMeaningEvidencePackage, findExplicitEvidenceReference, validateMeaningResolution, routeForEvidenceCandidate, questionTypeFromText, defaultQueryIntent, type AgentEvidenceKind, type AgentEvidenceTrustTier, type AgentEvidenceCompatibility, type AgentEvidenceCandidate, type AgentRetrievalEvidence, type MeaningQueryIntent, type MeaningQuestionType, type MeaningExecutionRoute, type MeaningConfidence, type MeaningResolution, type MeaningResolutionInput, type AgentMeaningResolver, } from "./meaning-resolution.js";
+export { buildMeaningEvidencePackage, findExplicitEvidenceReference, validateMeaningResolution, routeForEvidenceCandidate, questionTypeFromText, defaultQueryIntent, type AgentEvidenceKind, type AgentEvidenceTrustTier, type AgentEvidenceCompatibility, type AgentEvidenceCandidate, type AgentRelationshipSafetyEvidence, type AgentRetrievalEvidence, type MeaningQueryIntent, type MeaningQuestionType, type MeaningExecutionRoute, type MeaningConfidence, type MeaningResolution, type MeaningResolutionInput, type AgentMeaningResolver, } from "./meaning-resolution.js";
 export { synthesizeAnswer, inferFormat, computeResultStats, type SynthesizeInput, type SynthesizeOptions, type SynthesizeResult, type SynthesizeCompletion, type SynthesisFormat, type SynthesizeResultPreview, type SynthesizeColumnStat, } from "./synthesize.js";
 export { buildDeterministicDashboardStory, validateDashboardStoryBrief, type DashboardStoryBuildInput, type DashboardStoryBuildResult, type DashboardStoryTileResult, } from "./dashboard-story.js";
 export { planApp, type AppPlan as AgentAppPlan, type AppPlanSection, type AppPlanFilter as AgentAppPlanFilter, type PlanBlock, } from "./app-planner.js";