@lssm/lib.companyos-spec 3.0.2

package/dist/types/company-intelligence/grounding.d.ts

@@ -0,0 +1,330 @@
+import { z } from 'zod';
+export declare const CompanyIntelligenceAnswerStatusSchema: z.ZodEnum<{
+    abstained: "abstained";
+    answered: "answered";
+    conflicted: "conflicted";
+    degraded: "degraded";
+    refused: "refused";
+}>;
+export declare const CompanyIntelligenceQueryRecordSchema: z.ZodObject<{
+    contractVersion: z.ZodLiteral<"1.0.0">;
+    id: z.ZodString;
+    tenantId: z.ZodString;
+    ownerRef: z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    recordedAt: z.ZodISODateTime;
+    validTime: z.ZodObject<{
+        from: z.ZodISODateTime;
+        to: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strict>;
+    recordRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    evidenceRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    supersedesRefId: z.ZodOptional<z.ZodString>;
+    tombstone: z.ZodOptional<z.ZodObject<{
+        reason: z.ZodEnum<{
+            acl_revoked: "acl_revoked";
+            privacy_request: "privacy_request";
+            retention_expired: "retention_expired";
+            source_deleted: "source_deleted";
+            superseded: "superseded";
+        }>;
+        tombstonedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+    fingerprint: z.ZodObject<{
+        version: z.ZodLiteral<"company-intelligence-sha256:v1">;
+        canonicalization: z.ZodLiteral<"canonical-json:v1">;
+        value: z.ZodString;
+    }, z.core.$strict>;
+    kind: z.ZodLiteral<"query">;
+    authorityClass: z.ZodLiteral<"proposal">;
+    payload: z.ZodObject<{
+        actorRef: z.ZodString;
+        questionDigest: z.ZodString;
+        authorizationDecisionRef: z.ZodString;
+        retrievalConfigRef: z.ZodString;
+        requestedAt: z.ZodISODateTime;
+        maxEvidenceRecords: z.ZodNumber;
+        filters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const CompanyIntelligenceAnswerRecordSchema: z.ZodObject<{
+    contractVersion: z.ZodLiteral<"1.0.0">;
+    id: z.ZodString;
+    tenantId: z.ZodString;
+    ownerRef: z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    recordedAt: z.ZodISODateTime;
+    validTime: z.ZodObject<{
+        from: z.ZodISODateTime;
+        to: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strict>;
+    recordRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    evidenceRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    supersedesRefId: z.ZodOptional<z.ZodString>;
+    tombstone: z.ZodOptional<z.ZodObject<{
+        reason: z.ZodEnum<{
+            acl_revoked: "acl_revoked";
+            privacy_request: "privacy_request";
+            retention_expired: "retention_expired";
+            source_deleted: "source_deleted";
+            superseded: "superseded";
+        }>;
+        tombstonedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+    fingerprint: z.ZodObject<{
+        version: z.ZodLiteral<"company-intelligence-sha256:v1">;
+        canonicalization: z.ZodLiteral<"canonical-json:v1">;
+        value: z.ZodString;
+    }, z.core.$strict>;
+    kind: z.ZodLiteral<"answer">;
+    authorityClass: z.ZodLiteral<"truth">;
+    payload: z.ZodObject<{
+        queryRefId: z.ZodString;
+        status: z.ZodEnum<{
+            abstained: "abstained";
+            answered: "answered";
+            conflicted: "conflicted";
+            degraded: "degraded";
+            refused: "refused";
+        }>;
+        text: z.ZodOptional<z.ZodString>;
+        claimRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        citationEvidenceRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        conflictRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        retrievalRunRef: z.ZodString;
+        verificationRefId: z.ZodOptional<z.ZodString>;
+        policyDecisionRef: z.ZodOptional<z.ZodString>;
+        graphSnapshotRefId: z.ZodOptional<z.ZodString>;
+        editionRefId: z.ZodOptional<z.ZodString>;
+        replayRefId: z.ZodString;
+        reasons: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        usage: z.ZodObject<{
+            modelRef: z.ZodString;
+            promptFingerprint: z.ZodString;
+            latencyMs: z.ZodNumber;
+            costMicros: z.ZodNumber;
+        }, z.core.$strict>;
+        knowledgeAuthorizesAction: z.ZodLiteral<false>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const CompanyIntelligenceVerificationRecordSchema: z.ZodObject<{
+    contractVersion: z.ZodLiteral<"1.0.0">;
+    id: z.ZodString;
+    tenantId: z.ZodString;
+    ownerRef: z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    recordedAt: z.ZodISODateTime;
+    validTime: z.ZodObject<{
+        from: z.ZodISODateTime;
+        to: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strict>;
+    recordRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    evidenceRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    supersedesRefId: z.ZodOptional<z.ZodString>;
+    tombstone: z.ZodOptional<z.ZodObject<{
+        reason: z.ZodEnum<{
+            acl_revoked: "acl_revoked";
+            privacy_request: "privacy_request";
+            retention_expired: "retention_expired";
+            source_deleted: "source_deleted";
+            superseded: "superseded";
+        }>;
+        tombstonedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+    fingerprint: z.ZodObject<{
+        version: z.ZodLiteral<"company-intelligence-sha256:v1">;
+        canonicalization: z.ZodLiteral<"canonical-json:v1">;
+        value: z.ZodString;
+    }, z.core.$strict>;
+    kind: z.ZodLiteral<"verification">;
+    authorityClass: z.ZodLiteral<"truth">;
+    payload: z.ZodObject<{
+        answerRefId: z.ZodString;
+        verdict: z.ZodEnum<{
+            blocked: "blocked";
+            supported: "supported";
+            unsupported: "unsupported";
+        }>;
+        claimSupport: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            claimRefId: z.ZodString;
+            evidenceRefIds: z.ZodArray<z.ZodString>;
+            verdict: z.ZodEnum<{
+                supported: "supported";
+                unsupported: "unsupported";
+            }>;
+            confidence: z.ZodNumber;
+        }, z.core.$strict>>>;
+        deterministicRefsValidated: z.ZodBoolean;
+        independentVerifierRef: z.ZodString;
+        verifiedAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const CompanyIntelligenceGroundingRecordSchemas: readonly [z.ZodObject<{
+    contractVersion: z.ZodLiteral<"1.0.0">;
+    id: z.ZodString;
+    tenantId: z.ZodString;
+    ownerRef: z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    recordedAt: z.ZodISODateTime;
+    validTime: z.ZodObject<{
+        from: z.ZodISODateTime;
+        to: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strict>;
+    recordRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    evidenceRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    supersedesRefId: z.ZodOptional<z.ZodString>;
+    tombstone: z.ZodOptional<z.ZodObject<{
+        reason: z.ZodEnum<{
+            acl_revoked: "acl_revoked";
+            privacy_request: "privacy_request";
+            retention_expired: "retention_expired";
+            source_deleted: "source_deleted";
+            superseded: "superseded";
+        }>;
+        tombstonedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+    fingerprint: z.ZodObject<{
+        version: z.ZodLiteral<"company-intelligence-sha256:v1">;
+        canonicalization: z.ZodLiteral<"canonical-json:v1">;
+        value: z.ZodString;
+    }, z.core.$strict>;
+    kind: z.ZodLiteral<"query">;
+    authorityClass: z.ZodLiteral<"proposal">;
+    payload: z.ZodObject<{
+        actorRef: z.ZodString;
+        questionDigest: z.ZodString;
+        authorizationDecisionRef: z.ZodString;
+        retrievalConfigRef: z.ZodString;
+        requestedAt: z.ZodISODateTime;
+        maxEvidenceRecords: z.ZodNumber;
+        filters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    contractVersion: z.ZodLiteral<"1.0.0">;
+    id: z.ZodString;
+    tenantId: z.ZodString;
+    ownerRef: z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    recordedAt: z.ZodISODateTime;
+    validTime: z.ZodObject<{
+        from: z.ZodISODateTime;
+        to: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strict>;
+    recordRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    evidenceRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    supersedesRefId: z.ZodOptional<z.ZodString>;
+    tombstone: z.ZodOptional<z.ZodObject<{
+        reason: z.ZodEnum<{
+            acl_revoked: "acl_revoked";
+            privacy_request: "privacy_request";
+            retention_expired: "retention_expired";
+            source_deleted: "source_deleted";
+            superseded: "superseded";
+        }>;
+        tombstonedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+    fingerprint: z.ZodObject<{
+        version: z.ZodLiteral<"company-intelligence-sha256:v1">;
+        canonicalization: z.ZodLiteral<"canonical-json:v1">;
+        value: z.ZodString;
+    }, z.core.$strict>;
+    kind: z.ZodLiteral<"answer">;
+    authorityClass: z.ZodLiteral<"truth">;
+    payload: z.ZodObject<{
+        queryRefId: z.ZodString;
+        status: z.ZodEnum<{
+            abstained: "abstained";
+            answered: "answered";
+            conflicted: "conflicted";
+            degraded: "degraded";
+            refused: "refused";
+        }>;
+        text: z.ZodOptional<z.ZodString>;
+        claimRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        citationEvidenceRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        conflictRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        retrievalRunRef: z.ZodString;
+        verificationRefId: z.ZodOptional<z.ZodString>;
+        policyDecisionRef: z.ZodOptional<z.ZodString>;
+        graphSnapshotRefId: z.ZodOptional<z.ZodString>;
+        editionRefId: z.ZodOptional<z.ZodString>;
+        replayRefId: z.ZodString;
+        reasons: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        usage: z.ZodObject<{
+            modelRef: z.ZodString;
+            promptFingerprint: z.ZodString;
+            latencyMs: z.ZodNumber;
+            costMicros: z.ZodNumber;
+        }, z.core.$strict>;
+        knowledgeAuthorizesAction: z.ZodLiteral<false>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    contractVersion: z.ZodLiteral<"1.0.0">;
+    id: z.ZodString;
+    tenantId: z.ZodString;
+    ownerRef: z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    recordedAt: z.ZodISODateTime;
+    validTime: z.ZodObject<{
+        from: z.ZodISODateTime;
+        to: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strict>;
+    recordRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    evidenceRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    supersedesRefId: z.ZodOptional<z.ZodString>;
+    tombstone: z.ZodOptional<z.ZodObject<{
+        reason: z.ZodEnum<{
+            acl_revoked: "acl_revoked";
+            privacy_request: "privacy_request";
+            retention_expired: "retention_expired";
+            source_deleted: "source_deleted";
+            superseded: "superseded";
+        }>;
+        tombstonedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+    fingerprint: z.ZodObject<{
+        version: z.ZodLiteral<"company-intelligence-sha256:v1">;
+        canonicalization: z.ZodLiteral<"canonical-json:v1">;
+        value: z.ZodString;
+    }, z.core.$strict>;
+    kind: z.ZodLiteral<"verification">;
+    authorityClass: z.ZodLiteral<"truth">;
+    payload: z.ZodObject<{
+        answerRefId: z.ZodString;
+        verdict: z.ZodEnum<{
+            blocked: "blocked";
+            supported: "supported";
+            unsupported: "unsupported";
+        }>;
+        claimSupport: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            claimRefId: z.ZodString;
+            evidenceRefIds: z.ZodArray<z.ZodString>;
+            verdict: z.ZodEnum<{
+                supported: "supported";
+                unsupported: "unsupported";
+            }>;
+            confidence: z.ZodNumber;
+        }, z.core.$strict>>>;
+        deterministicRefsValidated: z.ZodBoolean;
+        independentVerifierRef: z.ZodString;
+        verifiedAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+}, z.core.$strict>];

package/dist/types/company-intelligence/grounding.js

@@ -0,0 +1,2 @@
+// @bun
+import{z as e}from"zod";import{z as t}from"zod";import{z as n}from"zod";var c=n.record(n.string(),n.unknown()),x=n.object({id:n.string().min(1),connectorCapability:n.string().min(1),providerKey:n.string().min(1).optional(),externalId:n.string().min(1).optional(),url:n.string().url().optional(),observedAt:n.string().min(1),metadata:c.default({})}),S=n.object({default:n.string().min(1),translations:n.record(n.string(),n.string()).default({})}),r=n.object({id:n.string().min(1),type:n.string().min(1),label:n.string().min(1).optional()});var l="1.0.0",m="company-intelligence-sha256:v1",p="canonical-json:v1",A=t.enum(["truth","policy","proposal","approval","execution","outcome"]),N=t.enum(["source","source_version","asset","part","fragment","evidence","claim","policy","entity","relation","conflict","gap","graph","edition","query","answer","verification","feedback","experiment","evaluation","promotion","rollback","replay"]),d=t.string().regex(/^sha256:[a-f0-9]{64}$/),f=t.object({version:t.literal(m),canonicalization:t.literal(p),value:d}).strict(),g=t.object({from:t.iso.datetime({offset:!0}),to:t.iso.datetime({offset:!0}).optional()}).strict(),u=t.object({reason:t.enum(["source_deleted","acl_revoked","superseded","retention_expired","privacy_request"]),tombstonedAt:t.iso.datetime({offset:!0})}).strict(),E=t.object({page:t.number().int().positive().optional(),section:t.string().min(1).optional(),lineStart:t.number().int().positive().optional(),lineEnd:t.number().int().positive().optional(),cell:t.string().min(1).optional(),messageId:t.string().min(1).optional(),timeStartMs:t.number().int().nonnegative().optional(),timeEndMs:t.number().int().nonnegative().optional()}).strict().refine((i)=>Object.values(i).some((s)=>s!==void 0),{message:"At least one stable evidence locator is required."}),a=t.array(t.string().min(1)).refine((i)=>new Set(i).size===i.length,{message:"Reference ids must be unique."}),o=t.object({contractVersion:t.literal(l),id:t.string().min(1),tenantId:t.string().min(1),ownerRef:r.strict(),recordedAt:t.iso.datetime({offset:!0}),validTime:g,recordRefIds:a.default([]),evidenceRefIds:a.default([]),supersedesRefId:t.string().min(1).optional(),tombstone:u.optional(),fingerprint:f}).strict();var y=e.enum(["answered","abstained","refused","conflicted","degraded"]),I=o.extend({kind:e.literal("query"),authorityClass:e.literal("proposal"),payload:e.object({actorRef:e.string().min(1),questionDigest:e.string().regex(/^sha256:[a-f0-9]{64}$/),authorizationDecisionRef:e.string().min(1),retrievalConfigRef:e.string().min(1),requestedAt:e.iso.datetime({offset:!0}),maxEvidenceRecords:e.number().int().positive(),filters:e.record(e.string(),e.string()).default({})}).strict()}).strict(),R=o.extend({kind:e.literal("answer"),authorityClass:e.literal("truth"),payload:e.object({queryRefId:e.string().min(1),status:y,text:e.string().min(1).optional(),claimRefIds:e.array(e.string().min(1)).default([]),citationEvidenceRefIds:e.array(e.string().min(1)).default([]),conflictRefIds:e.array(e.string().min(1)).default([]),retrievalRunRef:e.string().min(1),verificationRefId:e.string().min(1).optional(),policyDecisionRef:e.string().min(1).optional(),graphSnapshotRefId:e.string().min(1).optional(),editionRefId:e.string().min(1).optional(),replayRefId:e.string().min(1),reasons:e.array(e.string().min(1)).default([]),usage:e.object({modelRef:e.string().min(1),promptFingerprint:e.string().regex(/^sha256:[a-f0-9]{64}$/),latencyMs:e.number().int().nonnegative(),costMicros:e.number().int().nonnegative()}).strict(),knowledgeAuthorizesAction:e.literal(!1)}).strict()}).strict(),C=o.extend({kind:e.literal("verification"),authorityClass:e.literal("truth"),payload:e.object({answerRefId:e.string().min(1),verdict:e.enum(["supported","unsupported","blocked"]),claimSupport:e.array(e.object({claimRefId:e.string().min(1),evidenceRefIds:e.array(e.string().min(1)).min(1),verdict:e.enum(["supported","unsupported"]),confidence:e.number().min(0).max(1)}).strict()).default([]),deterministicRefsValidated:e.boolean(),independentVerifierRef:e.string().min(1),verifiedAt:e.iso.datetime({offset:!0})}).strict()}).strict(),T=[I,R,C];export{R as CompanyIntelligenceAnswerRecordSchema,y as CompanyIntelligenceAnswerStatusSchema,T as CompanyIntelligenceGroundingRecordSchemas,I as CompanyIntelligenceQueryRecordSchema,C as CompanyIntelligenceVerificationRecordSchema};