@duckcodeailabs/dql-agent 1.9.5 → 1.10.1

package/dist/analytical-failure-repair.d.ts

@@ -0,0 +1,91 @@
+import { type AnalyticalFailureCode, type AnalyticalFailurePhase, type AnalyticalFailureV1, type AnalyticalRepairChange, type AnalyticalRepairTrustTransition, type AnalyticalTrustState } from '@duckcodeailabs/dql-core';
+/**
+ * Stable diagnostics and immutable repair derivations for RFC 0005.
+ * Acceptance: API-007, SEC-004.
+ */
+export interface AnalyticalFailedBindingInput {
+    qualifiedId?: string;
+    role?: string;
+    reasonCode?: string;
+}
+export interface CreateAnalyticalFailureInput {
+    error?: unknown;
+    code?: AnalyticalFailureCode;
+    phase: AnalyticalFailurePhase;
+    snapshotId: string;
+    runId?: string;
+    planFingerprint?: string;
+    dqlSource?: string;
+    dqlFingerprint?: string;
+    compiledSql?: string;
+    sqlFingerprint?: string;
+    failedBindings?: AnalyticalFailedBindingInput[];
+}
+export type AnalyticalRepairAction = 'retry_same_plan' | 'parameter_rerun' | 'refresh_snapshot' | 'edit_dql' | 'open_sql_notebook' | 'change_authorized_connection' | 'request_access' | 'save_draft_block';
+export interface AnalyticalFailedRunV1 {
+    version: 1;
+    runId: string;
+    snapshotId: string;
+    route: 'certified' | 'semantic' | 'governed_sql' | 'generated_sql';
+    trustState: AnalyticalTrustState;
+    planFingerprint: string;
+    dqlSource?: string;
+    dqlFingerprint?: string;
+    compiledSql?: string;
+    sqlFingerprint?: string;
+    failure: AnalyticalFailureV1;
+}
+export interface AnalyticalRepairRequestV1 {
+    version: 1;
+    action: AnalyticalRepairAction;
+    parameterValues?: Record<string, unknown>;
+    dqlSource?: string;
+    sqlText?: string;
+    refreshedSnapshotId?: string;
+    authorizedConnectionFingerprint?: string;
+    governedValidationPassed?: boolean;
+}
+export interface AnalyticalRepairDerivationV1 {
+    version: 1;
+    derivationId: string;
+    sourceRunId: string;
+    derivedRunId: string;
+    action: AnalyticalRepairAction;
+    change: AnalyticalRepairChange;
+    snapshotId: string;
+    planFingerprint: string;
+    sourceFailureId: string;
+    sourceDqlFingerprint?: string;
+    sourceSqlFingerprint?: string;
+    derivedDqlSource?: string;
+    derivedDqlFingerprint?: string;
+    notebookSqlText?: string;
+    derivedSqlFingerprint?: string;
+    parameterFingerprint?: string;
+    authorizedConnectionFingerprint?: string;
+    trustTransition: AnalyticalRepairTrustTransition;
+    requiresRecompile: boolean;
+    requiresExecution: boolean;
+    routeLocked: true;
+    permissionsExpanded: false;
+}
+export type AnalyticalRepairDerivationResult = {
+    status: 'ready';
+    derivation: AnalyticalRepairDerivationV1;
+} | {
+    status: 'blocked';
+    code: 'ACTION_NOT_ALLOWED' | 'PERMISSION_FAILURE_TERMINAL' | 'REPAIR_INPUT_REQUIRED' | 'SOURCE_FINGERPRINT_MISMATCH';
+    reason: string;
+};
+/** Classify an adapter/compiler error without exposing its raw text. */
+export declare function classifyAnalyticalFailure(error: unknown, fallback?: AnalyticalFailureCode): AnalyticalFailureCode;
+/** Create the one redacted failure envelope returned by every analytical surface. */
+export declare function createAnalyticalFailure(input: CreateAnalyticalFailureInput): AnalyticalFailureV1;
+/**
+ * Derive a repair from an immutable failed run. This function never retrieves,
+ * reroutes, executes, mutates the source run, or expands permissions.
+ */
+export declare function deriveAnalyticalRepair(source: AnalyticalFailedRunV1, request: AnalyticalRepairRequestV1): AnalyticalRepairDerivationResult;
+/** Redact untrusted diagnostics before logs or traces display them. */
+export declare function redactAnalyticalDiagnostic(value: unknown): string;
+//# sourceMappingURL=analytical-failure-repair.d.ts.map

package/dist/analytical-failure-repair.d.ts.map

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

package/dist/analytical-failure-repair.js

@@ -0,0 +1,325 @@
+import { createHash } from 'node:crypto';
+import { analyticalRepairTrustTransition, } from '@duckcodeailabs/dql-core';
+const ERROR_CODE_ALIASES = {
+    '42P01': 'RELATION_NOT_FOUND',
+    '42P10': 'AMBIGUOUS_COLUMN',
+    '42702': 'AMBIGUOUS_COLUMN',
+    '42703': 'COLUMN_NOT_FOUND',
+    '42501': 'PERMISSION_DENIED',
+    EACCES: 'PERMISSION_DENIED',
+    ER_ACCESS_DENIED_ERROR: 'PERMISSION_DENIED',
+    COLUMN_NOT_FOUND: 'COLUMN_NOT_FOUND',
+    RELATION_NOT_FOUND: 'RELATION_NOT_FOUND',
+    TABLE_NOT_FOUND: 'RELATION_NOT_FOUND',
+    PERMISSION_DENIED: 'PERMISSION_DENIED',
+    ACCESS_DENIED: 'PERMISSION_DENIED',
+    AMBIGUOUS_COLUMN: 'AMBIGUOUS_COLUMN',
+    DIALECT_ERROR: 'DIALECT_ERROR',
+    SYNTAX_ERROR: 'DIALECT_ERROR',
+    SNAPSHOT_DRIFT: 'SNAPSHOT_DRIFT',
+    SOURCE_CHANGED: 'SNAPSHOT_DRIFT',
+    TIMEOUT: 'TIMEOUT',
+    ETIMEDOUT: 'TIMEOUT',
+    RESULT_CONTRACT_MISMATCH: 'RESULT_CONTRACT_MISMATCH',
+    COMPILATION_FAILED: 'COMPILATION_FAILED',
+    POLICY_DENIED: 'POLICY_DENIED',
+};
+const SAFE_FAILURES = {
+    COLUMN_NOT_FOUND: {
+        message: 'A governed column required by the selected plan is unavailable.',
+        recoverability: 'refresh_snapshot',
+        safeActions: ['refresh_snapshot', 'edit_dql', 'open_sql_notebook'],
+    },
+    RELATION_NOT_FOUND: {
+        message: 'A governed relation required by the selected plan is unavailable.',
+        recoverability: 'refresh_snapshot',
+        safeActions: ['refresh_snapshot', 'edit_dql', 'open_sql_notebook'],
+    },
+    PERMISSION_DENIED: {
+        message: 'The selected governed route was denied by the active warehouse permissions.',
+        recoverability: 'request_access',
+        safeActions: ['request_access', 'change_authorized_connection'],
+    },
+    AMBIGUOUS_COLUMN: {
+        message: 'The compiled statement contains a column reference the warehouse cannot resolve uniquely.',
+        recoverability: 'edit_dql',
+        safeActions: ['edit_dql', 'open_sql_notebook'],
+    },
+    DIALECT_ERROR: {
+        message: 'The selected route could not compile or execute in the configured warehouse dialect.',
+        recoverability: 'edit_dql',
+        safeActions: ['edit_dql', 'open_sql_notebook'],
+    },
+    SNAPSHOT_DRIFT: {
+        message: 'The executable plan no longer matches the active project snapshot.',
+        recoverability: 'refresh_snapshot',
+        safeActions: ['refresh_snapshot'],
+    },
+    TIMEOUT: {
+        message: 'The selected route exceeded its bounded execution time.',
+        recoverability: 'retry_same',
+        safeActions: ['retry_same_plan'],
+    },
+    RESULT_CONTRACT_MISMATCH: {
+        message: 'The result did not satisfy the selected plan output contract.',
+        recoverability: 'edit_dql',
+        safeActions: ['edit_dql', 'open_sql_notebook'],
+    },
+    COMPILATION_FAILED: {
+        message: 'The selected route could not compile its immutable analytical plan.',
+        recoverability: 'edit_dql',
+        safeActions: ['edit_dql', 'open_sql_notebook'],
+    },
+    POLICY_DENIED: {
+        message: 'Workspace policy does not authorize this analytical operation.',
+        recoverability: 'none',
+        safeActions: [],
+    },
+};
+const ACTION_TO_CHANGE = {
+    retry_same_plan: 'parameter_only',
+    parameter_rerun: 'parameter_only',
+    refresh_snapshot: 'snapshot_refresh',
+    edit_dql: 'dql_source',
+    open_sql_notebook: 'sql_text',
+    change_authorized_connection: 'connection_change',
+    request_access: 'connection_change',
+    save_draft_block: 'reviewed_draft_promotion',
+};
+/** Classify an adapter/compiler error without exposing its raw text. */
+export function classifyAnalyticalFailure(error, fallback = 'COMPILATION_FAILED') {
+    const record = objectRecord(error);
+    const structured = [record?.code, record?.sqlState, record?.sqlstate, record?.name]
+        .find((candidate) => typeof candidate === 'string');
+    if (structured) {
+        const code = ERROR_CODE_ALIASES[structured.trim().toUpperCase()];
+        if (code)
+            return code;
+    }
+    const text = errorText(error).toLowerCase();
+    if (/permission denied|access denied|not authorized|insufficient privilege|forbidden/.test(text))
+        return 'PERMISSION_DENIED';
+    if (/ambiguous (column|field)|column reference .* ambiguous/.test(text))
+        return 'AMBIGUOUS_COLUMN';
+    if (/column .* (does not exist|not found|unknown)|unknown column|invalid identifier/.test(text))
+        return 'COLUMN_NOT_FOUND';
+    if (/(relation|table|view) .* (does not exist|not found|unknown)|unknown table/.test(text))
+        return 'RELATION_NOT_FOUND';
+    if (/snapshot .* (changed|stale|mismatch)|source changed|schema drift/.test(text))
+        return 'SNAPSHOT_DRIFT';
+    if (/timed? ?out|deadline exceeded|query timeout/.test(text))
+        return 'TIMEOUT';
+    if (/result contract|missing output|unexpected output|row bound|decimal value required/.test(text))
+        return 'RESULT_CONTRACT_MISMATCH';
+    if (/syntax error|parse error|parser error|unsupported dialect|dialect/.test(text))
+        return 'DIALECT_ERROR';
+    if (/policy denied|policy violation|blocked by policy/.test(text))
+        return 'POLICY_DENIED';
+    return fallback;
+}
+/** Create the one redacted failure envelope returned by every analytical surface. */
+export function createAnalyticalFailure(input) {
+    const code = input.code ?? classifyAnalyticalFailure(input.error, fallbackCodeForPhase(input.phase));
+    const safe = SAFE_FAILURES[code];
+    const planFingerprint = cleanFingerprint(input.planFingerprint);
+    const dqlFingerprint = cleanFingerprint(input.dqlFingerprint) ?? fingerprintText(input.dqlSource);
+    const sqlFingerprint = cleanFingerprint(input.sqlFingerprint) ?? fingerprintText(input.compiledSql);
+    const snapshotId = input.snapshotId.trim() || 'snapshot-unavailable';
+    const failedBindings = normalizeFailedBindings(input.failedBindings, code);
+    const runId = input.runId?.trim() || stableId('analytical-run', {
+        snapshotId,
+        planFingerprint,
+        dqlFingerprint,
+        sqlFingerprint,
+    });
+    const failureId = stableId('analytical-failure', {
+        runId,
+        code,
+        phase: input.phase,
+        failedBindings,
+        planFingerprint,
+        dqlFingerprint,
+        sqlFingerprint,
+    });
+    return {
+        version: 1,
+        runId,
+        failureId,
+        code,
+        phase: input.phase,
+        message: safe.message,
+        recoverability: safe.recoverability,
+        failedBindings,
+        snapshotId,
+        ...(planFingerprint ? { planFingerprint } : {}),
+        ...(dqlFingerprint ? { dqlFingerprint } : {}),
+        ...(sqlFingerprint ? { sqlFingerprint } : {}),
+        safeActions: [...safe.safeActions],
+    };
+}
+/**
+ * Derive a repair from an immutable failed run. This function never retrieves,
+ * reroutes, executes, mutates the source run, or expands permissions.
+ */
+export function deriveAnalyticalRepair(source, request) {
+    if (request.version !== 1 || source.version !== 1) {
+        return { status: 'blocked', code: 'REPAIR_INPUT_REQUIRED', reason: 'Only v1 analytical repair inputs are supported.' };
+    }
+    const actionAllowed = source.failure.safeActions.includes(request.action)
+        || (request.action === 'parameter_rerun'
+            && source.route === 'certified'
+            && source.failure.safeActions.includes('retry_same_plan'));
+    if (!actionAllowed) {
+        return { status: 'blocked', code: 'ACTION_NOT_ALLOWED', reason: 'The requested action is not allowed for this stable failure.' };
+    }
+    if (source.failure.code === 'PERMISSION_DENIED'
+        && request.action !== 'request_access'
+        && request.action !== 'change_authorized_connection') {
+        return {
+            status: 'blocked',
+            code: 'PERMISSION_FAILURE_TERMINAL',
+            reason: 'Permission denial is terminal for the selected route.',
+        };
+    }
+    const change = ACTION_TO_CHANGE[request.action];
+    const inputGap = validateRepairInput(source, request);
+    if (inputGap)
+        return { status: 'blocked', code: 'REPAIR_INPUT_REQUIRED', reason: inputGap };
+    if (source.dqlSource && source.dqlFingerprint && fingerprintText(source.dqlSource) !== source.dqlFingerprint) {
+        return { status: 'blocked', code: 'SOURCE_FINGERPRINT_MISMATCH', reason: 'The immutable source DQL fingerprint does not match its retained text.' };
+    }
+    if (source.compiledSql && source.sqlFingerprint && fingerprintText(source.compiledSql) !== source.sqlFingerprint) {
+        return { status: 'blocked', code: 'SOURCE_FINGERPRINT_MISMATCH', reason: 'The immutable source SQL fingerprint does not match its retained text.' };
+    }
+    const snapshotId = request.refreshedSnapshotId?.trim() || source.snapshotId;
+    const derivedDqlSource = request.action === 'edit_dql' ? request.dqlSource.trim() : source.dqlSource;
+    const notebookSqlText = request.action === 'open_sql_notebook'
+        ? (request.sqlText ?? source.compiledSql).trim()
+        : undefined;
+    const derivedDqlFingerprint = fingerprintText(derivedDqlSource);
+    const derivedSqlFingerprint = fingerprintText(notebookSqlText);
+    const parameterFingerprint = request.parameterValues ? fingerprintValue(request.parameterValues) : undefined;
+    const authorizedConnectionFingerprint = cleanFingerprint(request.authorizedConnectionFingerprint);
+    const trustTransition = analyticalRepairTrustTransition({
+        previous: source.trustState,
+        change,
+        governedValidationPassed: request.governedValidationPassed,
+    });
+    const derivationIdentity = {
+        sourceRunId: source.runId,
+        sourceFailureId: source.failure.failureId,
+        action: request.action,
+        snapshotId,
+        planFingerprint: source.planFingerprint,
+        derivedDqlFingerprint,
+        derivedSqlFingerprint,
+        parameterFingerprint,
+        authorizedConnectionFingerprint,
+        trustTransition,
+    };
+    const derivationId = stableId('analytical-derivation', derivationIdentity);
+    return {
+        status: 'ready',
+        derivation: {
+            version: 1,
+            derivationId,
+            sourceRunId: source.runId,
+            derivedRunId: stableId('analytical-run', derivationIdentity),
+            action: request.action,
+            change,
+            snapshotId,
+            planFingerprint: source.planFingerprint,
+            sourceFailureId: source.failure.failureId,
+            ...(source.dqlFingerprint ? { sourceDqlFingerprint: source.dqlFingerprint } : {}),
+            ...(source.sqlFingerprint ? { sourceSqlFingerprint: source.sqlFingerprint } : {}),
+            ...(derivedDqlSource ? { derivedDqlSource } : {}),
+            ...(derivedDqlFingerprint ? { derivedDqlFingerprint } : {}),
+            ...(notebookSqlText ? { notebookSqlText } : {}),
+            ...(derivedSqlFingerprint ? { derivedSqlFingerprint } : {}),
+            ...(parameterFingerprint ? { parameterFingerprint } : {}),
+            ...(authorizedConnectionFingerprint ? { authorizedConnectionFingerprint } : {}),
+            trustTransition,
+            requiresRecompile: request.action === 'edit_dql' || request.action === 'refresh_snapshot',
+            requiresExecution: request.action !== 'request_access' && request.action !== 'open_sql_notebook' && request.action !== 'save_draft_block',
+            routeLocked: true,
+            permissionsExpanded: false,
+        },
+    };
+}
+/** Redact untrusted diagnostics before logs or traces display them. */
+export function redactAnalyticalDiagnostic(value) {
+    return errorText(value)
+        .replace(/\b(?:postgres(?:ql)?|mysql|mariadb|sqlserver):\/\/[^\s]+/gi, '[REDACTED_CONNECTION]')
+        .replace(/\b(?:bearer\s+)?[A-Za-z0-9_-]{24,}\.[A-Za-z0-9_-]{12,}(?:\.[A-Za-z0-9_-]{12,})?/gi, '[REDACTED_TOKEN]')
+        .replace(/\b(password|passwd|pwd|token|api[_-]?key|secret)\s*[:=]\s*([^\s,;]+)/gi, '$1=[REDACTED]')
+        .replace(/'(?:''|[^'])*'/g, "'[REDACTED_VALUE]'")
+        .slice(0, 512);
+}
+function validateRepairInput(source, request) {
+    if (request.action === 'parameter_rerun' && !request.parameterValues)
+        return 'A parameter rerun requires explicit parameter values.';
+    if (request.action === 'edit_dql' && !request.dqlSource?.trim())
+        return 'A DQL repair requires derived DQL source.';
+    if (request.action === 'open_sql_notebook' && !request.sqlText?.trim() && !source.compiledSql?.trim()) {
+        return 'Opening SQL in Notebook requires retained or explicit SQL text.';
+    }
+    if (request.action === 'refresh_snapshot' && !request.refreshedSnapshotId?.trim())
+        return 'Snapshot repair requires the refreshed snapshot identity.';
+    if (request.action === 'change_authorized_connection' && !cleanFingerprint(request.authorizedConnectionFingerprint)) {
+        return 'Connection repair requires a redacted authorized connection fingerprint.';
+    }
+    return undefined;
+}
+function normalizeFailedBindings(bindings, code) {
+    const normalized = (bindings ?? []).map((binding) => ({
+        ...(binding.qualifiedId?.trim() ? { qualifiedId: binding.qualifiedId.trim() } : {}),
+        ...(binding.role?.trim() ? { role: binding.role.trim() } : {}),
+        reasonCode: binding.reasonCode?.trim() || code,
+    }));
+    return normalized.sort((left, right) => stableSerialize(left).localeCompare(stableSerialize(right)));
+}
+function fallbackCodeForPhase(phase) {
+    if (phase === 'result_validation')
+        return 'RESULT_CONTRACT_MISMATCH';
+    return 'COMPILATION_FAILED';
+}
+function errorText(error) {
+    if (error instanceof Error)
+        return `${error.name}: ${error.message}`;
+    if (typeof error === 'string')
+        return error;
+    const record = objectRecord(error);
+    if (typeof record?.message === 'string')
+        return record.message;
+    return 'Analytical operation failed.';
+}
+function objectRecord(value) {
+    return value !== null && typeof value === 'object' ? value : undefined;
+}
+function cleanFingerprint(value) {
+    const clean = value?.trim().toLowerCase();
+    return clean && /^[a-f0-9]{64}$/.test(clean) ? clean : undefined;
+}
+function fingerprintText(value) {
+    const clean = value?.trim();
+    return clean ? createHash('sha256').update(clean).digest('hex') : undefined;
+}
+function fingerprintValue(value) {
+    return createHash('sha256').update(stableSerialize(value)).digest('hex');
+}
+function stableId(prefix, value) {
+    return `${prefix}-${fingerprintValue(value).slice(0, 24)}`;
+}
+function stableSerialize(value) {
+    if (value === undefined || value === null)
+        return 'null';
+    if (typeof value === 'bigint')
+        return JSON.stringify(value.toString());
+    if (typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return `[${value.map(stableSerialize).join(',')}]`;
+    const record = value;
+    return `{${Object.keys(record).sort().map((key) => `${JSON.stringify(key)}:${stableSerialize(record[key])}`).join(',')}}`;
+}
+//# sourceMappingURL=analytical-failure-repair.js.map

package/dist/analytical-failure-repair.js.map

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

package/dist/analytical-frame.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Zero-provider construction of an RFC 0005 analytical frame from an already
+ * resolved metric, parsed request hints, retrieved semantic members, and an
+ * explicit normalized capability contract.
+ *
+ * This is intentionally conservative: unresolved roles become ambiguity or no
+ * frame instead of name-based execution authority.
+ *
+ * Acceptance: AGT-017, AGT-018.
+ */
+import { type AnalyticalQuestionFrameV2 } from '@duckcodeailabs/dql-core';
+import { type AgentEvidenceCandidate, type AgentRetrievalEvidence } from './meaning-resolution.js';
+export declare function buildDeterministicAnalyticalFrame(input: {
+    question: string;
+    evidence: AgentRetrievalEvidence;
+    metricCandidate: AgentEvidenceCandidate;
+    candidates: AgentEvidenceCandidate[];
+}): AnalyticalQuestionFrameV2 | undefined;
+//# sourceMappingURL=analytical-frame.d.ts.map

package/dist/analytical-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytical-frame.d.ts","sourceRoot":"","sources":["../src/analytical-frame.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAwE,KAAK,yBAAyB,EAAiC,MAAM,0BAA0B,CAAC;AAC/K,OAAO,EAAwB,KAAK,sBAAsB,EAAE,KAAK,sBAAsB,EAA2B,MAAM,yBAAyB,CAAC;AAElJ,wBAAgB,iCAAiC,CAAC,KAAK,EAAE;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,sBAAsB,CAAC;IACjC,eAAe,EAAE,sBAAsB,CAAC;IACxC,UAAU,EAAE,sBAAsB,EAAE,CAAC;CACtC,GAAG,yBAAyB,GAAG,SAAS,CAyNxC"}