@spottoai/types-package 1.0.2-beta.43 → 1.0.2-beta.430

package/dist/accounts/writePermissions.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Write Permission Bitmask Enum
+ * Each permission gets a unique bit position for efficient storage
+ */
+export declare enum WritePermission {
+    /** Permission to dismiss Azure Advisor recommendations */
+    DismissRecommendations = 1,// 1
+    /** Permission to enable storage inventory reports on storage accounts */
+    StorageInventory = 2,// 2
+    /** Permission to create scoped Azure Policy exemptions */
+    PolicyExemptions = 4,// 4
+    /** Permission to run approved resource scheduling capabilities */
+    ResourceScheduling = 8
+}
+/**
+ * Metadata for a write permission
+ * Contains display information, required roles, and documentation links
+ */
+export interface WritePermissionMetadata {
+    /** Unique identifier matching the WritePermission enum */
+    id: WritePermission;
+    /** Human-readable display name */
+    displayName: string;
+    /** Description of what this permission allows */
+    description: string;
+    /** Required Azure RBAC role(s) for this permission */
+    requiredRoles: string[];
+    /** URL to documentation about this permission */
+    documentationUrl?: string;
+    /** URL to script generator for creating custom roles */
+    scriptGeneratorUrl?: string;
+    /** Identifies permissions whose provider grants come from an immutable multi-group manifest. */
+    permissionManifestKind?: 'resource-scheduling';
+}
+/**
+ * Permission metadata array
+ * Define all available write permissions with their metadata
+ */
+export declare const WRITE_PERMISSIONS_METADATA: WritePermissionMetadata[];
+//# sourceMappingURL=writePermissions.d.ts.map

package/dist/accounts/writePermissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writePermissions.d.ts","sourceRoot":"","sources":["../../src/accounts/writePermissions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,eAAe;IACzB,0DAA0D;IAC1D,sBAAsB,IAAS,CAAE,IAAI;IACrC,yEAAyE;IACzE,gBAAgB,IAAS,CAAE,IAAI;IAC/B,0DAA0D;IAC1D,gBAAgB,IAAS,CAAE,IAAI;IAC/B,kEAAkE;IAClE,kBAAkB,IAAS;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,0DAA0D;IAC1D,EAAE,EAAE,eAAe,CAAC;IACpB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gGAAgG;IAChG,sBAAsB,CAAC,EAAE,qBAAqB,CAAC;CAChD;AAED;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,uBAAuB,EAgC/D,CAAC"}

package/dist/accounts/writePermissions.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WRITE_PERMISSIONS_METADATA = exports.WritePermission = void 0;
+/**
+ * Write Permission Bitmask Enum
+ * Each permission gets a unique bit position for efficient storage
+ */
+var WritePermission;
+(function (WritePermission) {
+    /** Permission to dismiss Azure Advisor recommendations */
+    WritePermission[WritePermission["DismissRecommendations"] = 1] = "DismissRecommendations";
+    /** Permission to enable storage inventory reports on storage accounts */
+    WritePermission[WritePermission["StorageInventory"] = 2] = "StorageInventory";
+    /** Permission to create scoped Azure Policy exemptions */
+    WritePermission[WritePermission["PolicyExemptions"] = 4] = "PolicyExemptions";
+    /** Permission to run approved resource scheduling capabilities */
+    WritePermission[WritePermission["ResourceScheduling"] = 8] = "ResourceScheduling";
+})(WritePermission || (exports.WritePermission = WritePermission = {}));
+/**
+ * Permission metadata array
+ * Define all available write permissions with their metadata
+ */
+exports.WRITE_PERMISSIONS_METADATA = [
+    {
+        id: WritePermission.DismissRecommendations,
+        displayName: 'Dismiss Azure Advisor Recommendations',
+        description: 'Allows Spotto to dismiss recommendations in Azure when dismissed here.',
+        requiredRoles: ['Advisor Recommendations Contributor'],
+        documentationUrl: 'https://learn.microsoft.com/en-us/azure/advisor/permissions',
+        scriptGeneratorUrl: '/scripts/advisor-role',
+    },
+    {
+        id: WritePermission.StorageInventory,
+        displayName: 'Enable Storage Inventory Reports',
+        description: 'Allows Spotto to enable blob inventory on storage accounts you select.',
+        requiredRoles: ['Storage Account Contributor'],
+        documentationUrl: 'https://learn.microsoft.com/en-us/azure/storage/blobs/blob-inventory',
+        scriptGeneratorUrl: '/scripts/storage-role',
+    },
+    {
+        id: WritePermission.PolicyExemptions,
+        displayName: 'Create Azure Policy Exemptions',
+        description: 'Allows Spotto to create narrowly scoped exemptions for selected Azure Policy initiative controls.',
+        requiredRoles: ['Custom role with Azure Policy exemption actions at the target and assignment scopes'],
+        documentationUrl: 'https://docs.spotto.ai/docs/portal/write-permissions/policy-exemptions',
+        scriptGeneratorUrl: '/scripts/policy-exemptions-role',
+    },
+    {
+        id: WritePermission.ResourceScheduling,
+        displayName: 'Resource Scheduling',
+        description: 'Allows Spotto to run explicitly approved resource scheduling capabilities at their exact Azure scopes.',
+        requiredRoles: [],
+        permissionManifestKind: 'resource-scheduling',
+    },
+];
+//# sourceMappingURL=writePermissions.js.map

package/dist/accounts/writePermissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writePermissions.js","sourceRoot":"","sources":["../../src/accounts/writePermissions.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,IAAY,eASX;AATD,WAAY,eAAe;IACzB,0DAA0D;IAC1D,yFAA+B,CAAA;IAC/B,yEAAyE;IACzE,6EAAyB,CAAA;IACzB,0DAA0D;IAC1D,6EAAyB,CAAA;IACzB,kEAAkE;IAClE,iFAA2B,CAAA;AAC7B,CAAC,EATW,eAAe,+BAAf,eAAe,QAS1B;AAuBD;;;GAGG;AACU,QAAA,0BAA0B,GAA8B;IACnE;QACE,EAAE,EAAE,eAAe,CAAC,sBAAsB;QAC1C,WAAW,EAAE,uCAAuC;QACpD,WAAW,EAAE,wEAAwE;QACrF,aAAa,EAAE,CAAC,qCAAqC,CAAC;QACtD,gBAAgB,EAAE,6DAA6D;QAC/E,kBAAkB,EAAE,uBAAuB;KAC5C;IACD;QACE,EAAE,EAAE,eAAe,CAAC,gBAAgB;QACpC,WAAW,EAAE,kCAAkC;QAC/C,WAAW,EAAE,wEAAwE;QACrF,aAAa,EAAE,CAAC,6BAA6B,CAAC;QAC9C,gBAAgB,EAAE,sEAAsE;QACxF,kBAAkB,EAAE,uBAAuB;KAC5C;IACD;QACE,EAAE,EAAE,eAAe,CAAC,gBAAgB;QACpC,WAAW,EAAE,gCAAgC;QAC7C,WAAW,EAAE,mGAAmG;QAChH,aAAa,EAAE,CAAC,qFAAqF,CAAC;QACtG,gBAAgB,EAAE,wEAAwE;QAC1F,kBAAkB,EAAE,iCAAiC;KACtD;IACD;QACE,EAAE,EAAE,eAAe,CAAC,kBAAkB;QACtC,WAAW,EAAE,qBAAqB;QAClC,WAAW,EAAE,wGAAwG;QACrH,aAAa,EAAE,EAAE;QACjB,sBAAsB,EAAE,qBAAqB;KAC9C;CACF,CAAC"}

package/dist/ai/conversationHistory.d.ts

@@ -0,0 +1,52 @@
+import type { AIChatGroundingSummary } from './grounding.js';
+import type { AIChatWorkspaceArtifact, AIChatWorkspaceArtifactSummary, AIChatWorkspaceArtifactViewIdentity } from './workspaceArtifacts.js';
+import type { AIChatCitation, AIChatEvidenceCoverage } from './index.js';
+/** Shared payload bounds for conversation-history artifact projection and replay. */
+export declare const AI_CHAT_HISTORY_ARTIFACT_LIMITS_V1: Readonly<{
+    readonly responseArtifactsPerConversation: 100;
+    readonly citationsPerResponse: 50;
+    readonly workspaceArtifactSummariesPerResponse: 5;
+}>;
+/** Capability-bound summary returned with a historical assistant response. */
+export type AIChatHistoryWorkspaceArtifactSummary = AIChatWorkspaceArtifactSummary & {
+    view: AIChatWorkspaceArtifactViewIdentity;
+};
+/** Safe, bounded metadata for one persisted assistant response. */
+export interface AIChatHistoryResponseArtifact {
+    turnId: string;
+    responseId: string;
+    citations: AIChatCitation[];
+    evidenceCoverage: AIChatEvidenceCoverage;
+    grounding?: AIChatGroundingSummary;
+    workspaceArtifacts?: AIChatHistoryWorkspaceArtifactSummary[];
+}
+/**
+ * Compatibility projection for the newest response while API and Portal consumers migrate to
+ * `responseArtifacts`. Unlike historical entries, it may contain complete inline artifacts.
+ */
+export interface AIChatHistoryLatestResponseArtifact {
+    turnId?: string;
+    responseId: string;
+    citations: AIChatCitation[];
+    evidenceCoverage: AIChatEvidenceCoverage;
+    grounding?: AIChatGroundingSummary;
+    workspaceArtifacts?: AIChatWorkspaceArtifact[];
+}
+/** Additive artifact fields carried by the conversation-history response. */
+export interface AIChatConversationHistoryArtifactProjection {
+    /** @deprecated Use `responseArtifacts`; retained during the API/Portal migration. */
+    latestResponseArtifact?: AIChatHistoryLatestResponseArtifact;
+    /**
+     * Oldest-to-newest entries for the retained response window. Entries must have unique turn and
+     * response identifiers and are capped by `responseArtifactsPerConversation`.
+     */
+    responseArtifacts?: AIChatHistoryResponseArtifact[];
+}
+/** Authorized lazy-read response for one complete historical workspace artifact. */
+export interface AIChatHistoryWorkspaceArtifactReadResponse {
+    conversationId: string;
+    turnId: string;
+    responseId: string;
+    artifact: AIChatWorkspaceArtifact;
+}
+//# sourceMappingURL=conversationHistory.d.ts.map

package/dist/ai/conversationHistory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationHistory.d.ts","sourceRoot":"","sources":["../../src/ai/conversationHistory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,mCAAmC,EAAE,MAAM,yBAAyB,CAAC;AAC5I,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzE,qFAAqF;AACrF,eAAO,MAAM,kCAAkC;;;;EAIpC,CAAC;AAEZ,8EAA8E;AAC9E,MAAM,MAAM,qCAAqC,GAAG,8BAA8B,GAAG;IACnF,IAAI,EAAE,mCAAmC,CAAC;CAC3C,CAAC;AAEF,mEAAmE;AACnE,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,SAAS,CAAC,EAAE,sBAAsB,CAAC;IACnC,kBAAkB,CAAC,EAAE,qCAAqC,EAAE,CAAC;CAC9D;AAED;;;GAGG;AACH,MAAM,WAAW,mCAAmC;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,SAAS,CAAC,EAAE,sBAAsB,CAAC;IACnC,kBAAkB,CAAC,EAAE,uBAAuB,EAAE,CAAC;CAChD;AAED,6EAA6E;AAC7E,MAAM,WAAW,2CAA2C;IAC1D,qFAAqF;IACrF,sBAAsB,CAAC,EAAE,mCAAmC,CAAC;IAC7D;;;OAGG;IACH,iBAAiB,CAAC,EAAE,6BAA6B,EAAE,CAAC;CACrD;AAED,oFAAoF;AACpF,MAAM,WAAW,0CAA0C;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,uBAAuB,CAAC;CACnC"}

package/dist/ai/conversationHistory.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AI_CHAT_HISTORY_ARTIFACT_LIMITS_V1 = void 0;
+/** Shared payload bounds for conversation-history artifact projection and replay. */
+exports.AI_CHAT_HISTORY_ARTIFACT_LIMITS_V1 = Object.freeze({
+    responseArtifactsPerConversation: 100,
+    citationsPerResponse: 50,
+    workspaceArtifactSummariesPerResponse: 5,
+});
+//# sourceMappingURL=conversationHistory.js.map

package/dist/ai/conversationHistory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationHistory.js","sourceRoot":"","sources":["../../src/ai/conversationHistory.ts"],"names":[],"mappings":";;;AAIA,qFAAqF;AACxE,QAAA,kCAAkC,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9D,gCAAgC,EAAE,GAAG;IACrC,oBAAoB,EAAE,EAAE;IACxB,qCAAqC,EAAE,CAAC;CAChC,CAAC,CAAC"}

package/dist/ai/grounding.d.ts

@@ -0,0 +1,41 @@
+import type { EnvironmentArtifactKindV1, EnvironmentCoverageStateV1 } from '../environment/contracts.js';
+export declare const AI_CHAT_GROUNDING_LIMITS_V1: Readonly<{
+    readonly claims: 128;
+    readonly citationsPerClaim: 32;
+    readonly identifierScalars: 128;
+}>;
+export declare const AI_CHAT_GROUNDING_REASON_CODES_V1: readonly ["grounding.not-required", "grounding.claim-extraction-failed", "grounding.missing-citation", "grounding.source-unavailable", "grounding.source-stale", "grounding.generation-mismatch", "grounding.value-mismatch", "grounding.unsupported-claim"];
+export type AIChatGroundingReasonCodeV1 = (typeof AI_CHAT_GROUNDING_REASON_CODES_V1)[number];
+export type AIChatGroundingStatusV1 = 'verified' | 'unverified' | 'not-required';
+export type AIChatClaimVerificationStatusV1 = 'verified' | 'unverified';
+export type AIEnvironmentEvidenceCoverageStatusV1 = EnvironmentCoverageStateV1['status'];
+/** Client-safe environment evidence metadata with no scope, generation, storage, or runtime-handle identity. */
+export interface AIEnvironmentEvidenceMatch {
+    safeLabel: string;
+    portalRoute: string;
+    artifactKind: EnvironmentArtifactKindV1;
+    sourceCompletedAt: string;
+    coverageStatus: AIEnvironmentEvidenceCoverageStatusV1;
+    truncated: boolean;
+    citationIds: string[];
+}
+export interface AIChatClaimVerificationV1 {
+    claimId: string;
+    status: AIChatClaimVerificationStatusV1;
+    citationIds: string[];
+    reasonCode?: Exclude<AIChatGroundingReasonCodeV1, 'grounding.not-required'>;
+}
+/** Deterministic grounding result. This is evidence verification, never model confidence. */
+export interface AIChatGroundingSummary {
+    status: AIChatGroundingStatusV1;
+    method: 'deterministic-citation-and-value';
+    totalClaimCount: number;
+    verifiedClaimCount: number;
+    claims: AIChatClaimVerificationV1[];
+    reasonCode?: AIChatGroundingReasonCodeV1;
+}
+/** Strictly validates client-safe environment evidence metadata. */
+export declare const isAIEnvironmentEvidenceMatch: (value: unknown) => value is AIEnvironmentEvidenceMatch;
+/** Strictly validates deterministic summary and claim-level citation invariants. */
+export declare const isAIChatGroundingSummary: (value: unknown) => value is AIChatGroundingSummary;
+//# sourceMappingURL=grounding.d.ts.map

package/dist/ai/grounding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grounding.d.ts","sourceRoot":"","sources":["../../src/ai/grounding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAIzG,eAAO,MAAM,2BAA2B;;;;EAI7B,CAAC;AAEZ,eAAO,MAAM,iCAAiC,8PASpC,CAAC;AAEX,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,iCAAiC,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7F,MAAM,MAAM,uBAAuB,GAAG,UAAU,GAAG,YAAY,GAAG,cAAc,CAAC;AACjF,MAAM,MAAM,+BAA+B,GAAG,UAAU,GAAG,YAAY,CAAC;AACxE,MAAM,MAAM,qCAAqC,GAAG,0BAA0B,CAAC,QAAQ,CAAC,CAAC;AAEzF,gHAAgH;AAChH,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,yBAAyB,CAAC;IACxC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,qCAAqC,CAAC;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,+BAA+B,CAAC;IACxC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC,2BAA2B,EAAE,wBAAwB,CAAC,CAAC;CAC7E;AAED,6FAA6F;AAC7F,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,uBAAuB,CAAC;IAChC,MAAM,EAAE,kCAAkC,CAAC;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,yBAAyB,EAAE,CAAC;IACpC,UAAU,CAAC,EAAE,2BAA2B,CAAC;CAC1C;AAgBD,oEAAoE;AACpE,eAAO,MAAM,4BAA4B,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,0BAU/B,CAAC;AAiBzC,oFAAoF;AACpF,eAAO,MAAM,wBAAwB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,sBA+BlE,CAAC"}

package/dist/ai/grounding.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAIChatGroundingSummary = exports.isAIEnvironmentEvidenceMatch = exports.AI_CHAT_GROUNDING_REASON_CODES_V1 = exports.AI_CHAT_GROUNDING_LIMITS_V1 = void 0;
+const internal_js_1 = require("../environment/internal.js");
+const validation_js_1 = require("../environment/validation.js");
+exports.AI_CHAT_GROUNDING_LIMITS_V1 = Object.freeze({
+    claims: 128,
+    citationsPerClaim: 32,
+    identifierScalars: 128,
+});
+exports.AI_CHAT_GROUNDING_REASON_CODES_V1 = [
+    'grounding.not-required',
+    'grounding.claim-extraction-failed',
+    'grounding.missing-citation',
+    'grounding.source-unavailable',
+    'grounding.source-stale',
+    'grounding.generation-mismatch',
+    'grounding.value-mismatch',
+    'grounding.unsupported-claim',
+];
+const COVERAGE_STATUSES = new Set(['complete', 'partial', 'unavailable', 'stale', 'not-collected']);
+const GROUNDING_REASON_CODES = new Set(exports.AI_CHAT_GROUNDING_REASON_CODES_V1);
+const FAILURE_REASON_CODES = new Set(exports.AI_CHAT_GROUNDING_REASON_CODES_V1.filter(code => code !== 'grounding.not-required'));
+const isIdentifier = (value) => (0, internal_js_1.isBoundedString)(value, exports.AI_CHAT_GROUNDING_LIMITS_V1.identifierScalars, { trimmed: true, controls: true });
+const isCitationIds = (value, requireOne) => Array.isArray(value) &&
+    value.length <= exports.AI_CHAT_GROUNDING_LIMITS_V1.citationsPerClaim &&
+    (!requireOne || value.length > 0) &&
+    value.every(isIdentifier) &&
+    new Set(value).size === value.length;
+/** Strictly validates client-safe environment evidence metadata. */
+const isAIEnvironmentEvidenceMatch = (value) => (0, internal_js_1.isRecord)(value) &&
+    (0, internal_js_1.hasExactKeys)(value, ['safeLabel', 'portalRoute', 'artifactKind', 'sourceCompletedAt', 'coverageStatus', 'truncated', 'citationIds']) &&
+    (0, validation_js_1.isEnvironmentSafeLabelV1)(value.safeLabel) &&
+    (0, validation_js_1.isEnvironmentPortalRouteV1)(value.portalRoute) &&
+    (0, validation_js_1.isEnvironmentArtifactKindV1)(value.artifactKind) &&
+    (0, internal_js_1.isCanonicalUtcTimestamp)(value.sourceCompletedAt) &&
+    typeof value.coverageStatus === 'string' &&
+    COVERAGE_STATUSES.has(value.coverageStatus) &&
+    typeof value.truncated === 'boolean' &&
+    isCitationIds(value.citationIds, true);
+exports.isAIEnvironmentEvidenceMatch = isAIEnvironmentEvidenceMatch;
+const isAIChatClaimVerificationV1 = (value) => {
+    if (!(0, internal_js_1.isRecord)(value) ||
+        !(0, internal_js_1.hasExactKeys)(value, ['claimId', 'status', 'citationIds'], ['reasonCode']) ||
+        !isIdentifier(value.claimId) ||
+        (value.status !== 'verified' && value.status !== 'unverified')) {
+        return false;
+    }
+    if (value.status === 'verified') {
+        return value.reasonCode === undefined && isCitationIds(value.citationIds, true);
+    }
+    return typeof value.reasonCode === 'string' && FAILURE_REASON_CODES.has(value.reasonCode) && isCitationIds(value.citationIds, false);
+};
+/** Strictly validates deterministic summary and claim-level citation invariants. */
+const isAIChatGroundingSummary = (value) => {
+    if (!(0, internal_js_1.isRecord)(value) ||
+        !(0, internal_js_1.hasExactKeys)(value, ['status', 'method', 'totalClaimCount', 'verifiedClaimCount', 'claims'], ['reasonCode']) ||
+        value.method !== 'deterministic-citation-and-value' ||
+        (value.status !== 'verified' && value.status !== 'unverified' && value.status !== 'not-required') ||
+        !(0, internal_js_1.isNonNegativeInteger)(value.totalClaimCount) ||
+        !(0, internal_js_1.isNonNegativeInteger)(value.verifiedClaimCount) ||
+        !Array.isArray(value.claims) ||
+        value.claims.length > exports.AI_CHAT_GROUNDING_LIMITS_V1.claims ||
+        !value.claims.every(isAIChatClaimVerificationV1) ||
+        new Set(value.claims.map(claim => claim.claimId)).size !== value.claims.length ||
+        value.totalClaimCount !== value.claims.length) {
+        return false;
+    }
+    const verifiedClaimCount = value.claims.filter(claim => claim.status === 'verified').length;
+    if (value.verifiedClaimCount !== verifiedClaimCount)
+        return false;
+    if (value.status === 'verified') {
+        return value.totalClaimCount > 0 && value.verifiedClaimCount === value.totalClaimCount && value.reasonCode === undefined;
+    }
+    if (value.status === 'not-required') {
+        return value.totalClaimCount === 0 && value.verifiedClaimCount === 0 && value.reasonCode === 'grounding.not-required';
+    }
+    if (typeof value.reasonCode !== 'string' || !GROUNDING_REASON_CODES.has(value.reasonCode) || value.reasonCode === 'grounding.not-required') {
+        return false;
+    }
+    if (value.totalClaimCount === 0)
+        return value.reasonCode === 'grounding.claim-extraction-failed';
+    return value.verifiedClaimCount < value.totalClaimCount;
+};
+exports.isAIChatGroundingSummary = isAIChatGroundingSummary;
+//# sourceMappingURL=grounding.js.map

package/dist/ai/grounding.js.map

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