@intutic/shared-types 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Intutic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPORTED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,56 @@
+# @intutic/shared-types
+
+> Zod-validated TypeScript types shared across all Intutic services.
+
+## Overview
+
+`@intutic/shared-types` is the single source of truth for TypeScript interfaces, enums, and Zod schemas used across the Intutic monorepo. Every service, package, and application imports types from here — never duplicated, always validated.
+
+## Scope
+
+27 source modules exporting ~200+ types covering:
+
+| Module | Key Types |
+|--------|-----------|
+| `enums` | `EnforcementAction`, `HarnessType`, `RiskLevel`, `SopLifecycleStage` |
+| `finops` | `TraceEntry`, `Attribution4D`, `BudgetEnvelope`, `CostBreakdown` |
+| `sop` | SOP lifecycle types, rule schemas, hook definitions |
+| `auth` | Session, token, credential types |
+| `identity` | SSO/SCIM integration types, user/team/org models |
+| `sync` | Config sync state, drift detection, harness config types |
+| `policy` | Policy evaluation results, enforcement decisions |
+| `anomaly` | Anomaly detection signals, baseline models |
+| `notifications` | Notification channels, alert templates, delivery status |
+| `billing` | Subscription tiers, usage metering, invoice types |
+| `observability` | Trace spans, metric definitions, log schemas |
+
+## Usage
+
+```typescript
+import { EnforcementAction, HarnessType } from '@intutic/shared-types';
+import { traceEntrySchema } from '@intutic/shared-types/finops';
+
+// Zod validation
+const parsed = traceEntrySchema.parse(rawData);
+```
+
+## Design Principles
+
+- **Single source of truth**: All cross-package types live here. No type duplication.
+- **Zod-first**: Schemas define the shape; TypeScript types are inferred via `z.infer<>`.
+- **Barrel exports**: Each module re-exports from `index.ts` for clean import paths.
+- **No runtime dependencies**: This package has zero runtime dependencies beyond Zod.
+
+## Installation
+
+```bash
+npm install @intutic/shared-types
+```
+
+## Part of Intutic
+
+This package is part of the [Intutic](https://github.com/intutic/intutic) monorepo — an open-core AI governance control plane for developer teams.
+
+## License
+
+MIT — see [LICENSE](../../LICENSE) for details.

package/dist/agentPool.d.ts

@@ -0,0 +1,40 @@
+export interface AgentPool {
+    poolId: string;
+    workspaceId: string;
+    name: string;
+    minSize: number;
+    maxSize: number;
+    idleTimeoutSecs: number;
+    taskTypes: string[];
+    modelBackends: string[];
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PoolAgent {
+    agentId: string;
+    poolId: string;
+    modelBackend: string;
+    status: 'warming' | 'idle' | 'busy' | 'retiring';
+    lastActivityAt: string | null;
+    invocationCount: number;
+    totalTokensProcessed: number;
+    warmedAt: string;
+    retiredAt: string | null;
+}
+export interface PoolInvocation {
+    invocationId: string;
+    poolId: string;
+    agentId: string;
+    workspaceId: string;
+    taskType: string;
+    dctTokenId: string | null;
+    status: 'running' | 'completed' | 'failed' | 'timeout';
+    durationMs: number | null;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    costUsd: string | null;
+    startedAt: string;
+    completedAt: string | null;
+}
+//# sourceMappingURL=agentPool.d.ts.map

package/dist/agentPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentPool.d.ts","sourceRoot":"","sources":["../src/agentPool.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAA;IAChD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,eAAe,EAAE,MAAM,CAAA;IACvB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAA;IACtD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B"}

package/dist/agentPool.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=agentPool.js.map

package/dist/agentPool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentPool.js","sourceRoot":"","sources":["../src/agentPool.ts"],"names":[],"mappings":""}

package/dist/annotation.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Shared types for Annotation-Calibration-Dataset Pipeline (LLD #58)
+ */
+export type QueueSource = 'grade_d_f' | 'hijack_escalation' | 'governance_incident' | 'capability_gap';
+export type QueuePriority = 'critical' | 'standard' | 'low';
+export type QueueStatus = 'pending' | 'in_progress' | 'completed' | 'expired';
+export type AnnotationType = 'correct' | 'incorrect' | 'ambiguous';
+export type DatasetStatus = 'draft' | 'published' | 'archived';
+export type ExportFormat = 'jsonl' | 'csv';
+export interface AnnotationQueueEntry {
+    entryId: string;
+    workspaceId: string;
+    traceId: string;
+    sessionId: string | null;
+    source: QueueSource;
+    sourceRefId: string | null;
+    priority: QueuePriority;
+    status: QueueStatus;
+    assignedTo: string | null;
+    slaDeadline: string;
+    completedAt: string | null;
+    createdAt: string;
+}
+export interface QueueFilters {
+    status?: QueueStatus;
+    priority?: QueuePriority;
+    assignedTo?: string;
+    page?: number;
+    limit?: number;
+}
+export interface PaginatedResult<T> {
+    items: T[];
+    total: number;
+    page: number;
+    limit: number;
+}
+export interface AnnotateInput {
+    workspaceId: string;
+    traceId: string;
+    toolCallIndex: number;
+    annotationType: AnnotationType;
+    notes?: string;
+    confidence?: number;
+    annotatedBy: string;
+    queueEntryId?: string;
+}
+export interface TraceAnnotation {
+    annotationId: string;
+    workspaceId: string;
+    traceId: string;
+    toolCallIndex: number;
+    annotationType: AnnotationType;
+    notes: string | null;
+    confidence: number | null;
+    annotatedBy: string;
+    queueEntryId: string | null;
+    createdAt: string;
+}
+export interface BulkResult {
+    successCount: number;
+    failedCount: number;
+    errors: {
+        index: number;
+        error: string;
+    }[];
+}
+export interface SlaStatus {
+    criticalCount: number;
+    standardCount: number;
+    lowCount: number;
+    overdueCount: number;
+}
+export interface CalibrationMetrics {
+    period: string;
+    totalEvaluations: number;
+    agreementRate: number;
+    scoreDeltaMean: number;
+    falsePositiveRate: number;
+    falseNegativeRate: number;
+}
+export interface CalibrationRecord {
+    calibrationId: string;
+    workspaceId: string;
+    sessionId: string;
+    traceId: string;
+    evaluatorScore: number | null;
+    evaluatorClassification: string | null;
+    evaluatorConfidence: number | null;
+    emAnnotationType: AnnotationType;
+    emAnnotationId: string;
+    agreement: boolean;
+    scoreDelta: number | null;
+    isFalsePositive: boolean;
+    isFalseNegative: boolean;
+    createdAt: string;
+}
+export interface CalibrationTrend {
+    period: string;
+    agreementRate: number;
+    scoreDeltaMean: number;
+    falsePositiveRate: number;
+    falseNegativeRate: number;
+}
+export interface RecordFilters {
+    sessionId?: string;
+    traceId?: string;
+    agreement?: boolean;
+    page?: number;
+    limit?: number;
+}
+export interface CurationConfig {
+    name: string;
+    minConfidence?: number;
+    isBalanced?: boolean;
+    createdBy: string;
+}
+export interface CuratedDataset {
+    datasetId: string;
+    workspaceId: string;
+    name: string;
+    version: number;
+    entryCount: number;
+    minConfidence: number | null;
+    isBalanced: boolean;
+    categoryDistribution: Record<string, number> | null;
+    status: DatasetStatus;
+    publishedAt: string | null;
+    createdBy: string;
+    createdAt: string;
+}
+export interface CuratedDatasetEntry {
+    entryId: string;
+    datasetId: string;
+    traceId: string;
+    toolCallIndex: number;
+    annotationType: AnnotationType;
+    annotationConfidence: number | null;
+    evaluatorScore: number | null;
+    calibrationId: string | null;
+    inputSnapshot: Record<string, unknown>;
+    outputSnapshot: Record<string, unknown> | null;
+    createdAt: string;
+}
+export interface DatasetVersion {
+    datasetId: string;
+    version: number;
+    entryCount: number;
+    createdAt: string;
+}
+//# sourceMappingURL=annotation.d.ts.map

package/dist/annotation.d.ts.map

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

package/dist/annotation.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Shared types for Annotation-Calibration-Dataset Pipeline (LLD #58)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=annotation.js.map

package/dist/annotation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation.js","sourceRoot":"","sources":["../src/annotation.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/anomaly.d.ts

@@ -0,0 +1,227 @@
+/**
+ * Anomaly detection types for the Anomaly Recognition Engine (ARE).
+ *
+ * These types support the 12-category runtime anomaly taxonomy,
+ * corrective prompt card system, trust scoring, and ARE probe battery.
+ *
+ * HLD §3.5 (Anomaly Detection), HLD §7.7 (Drift Detector)
+ * LLD #5 — Anomaly Detection + ARE
+ *
+ * @module
+ */
+import type { AnomalyType } from './enums.js';
+/**
+ * A detected anomaly event emitted by the ARE pipeline.
+ *
+ * Anomaly events are evaluated per-trace and may trigger enforcement
+ * actions, governance incidents, or corrective prompt injection.
+ *
+ * HLD §3.5 — 12-category runtime taxonomy
+ */
+export interface AnomalyEvent {
+    /** Classification from the 12-category anomaly taxonomy. */
+    type: AnomalyType;
+    /** Detection confidence score (0.0–1.0). */
+    confidence: number;
+    /** Optional structured metadata for forensic analysis. */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Full classification result from the anomaly detector.
+ * Includes severity mapping and whether an incident was created.
+ *
+ * LLD #5 §2.2 — classifyAnomaly() return type
+ */
+export interface AnomalyClassification {
+    /** Whether an anomaly was detected. */
+    detected: boolean;
+    /** Classification from the 12-category taxonomy. Null if not detected. */
+    anomalyType: AnomalyType | null;
+    /** Detection confidence score (0.0–1.0). */
+    confidence: number;
+    /** Severity level derived from anomaly type. */
+    severity: AnomalySeverity;
+    /** Generated corrective prompt card, if applicable. */
+    correctiveCard: CorrectivePromptCard | null;
+    /** Probe results that contributed to the classification. */
+    probeResults: ProbeResult[];
+    /** ID of the governance incident created, if severity >= HIGH. */
+    incidentId: string | null;
+}
+/**
+ * Anomaly severity levels, mapped from anomaly type.
+ *
+ * HLD §3.5 — Alert Route column
+ */
+export type AnomalySeverity = 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW' | 'INFORMATIONAL';
+/**
+ * Static mapping from anomaly type to default severity.
+ *
+ * HLD §3.5 — 12-category table, Alert Route column
+ * LLD #5 Appendix B
+ */
+export declare const ANOMALY_SEVERITY_MAP: Record<AnomalyType, AnomalySeverity>;
+/**
+ * A corrective prompt card generated in response to an anomaly.
+ *
+ * Prompt cards contain a remediation prompt, evidence chain, and a
+ * link to the SOP that governs the expected behavior. They are injected
+ * into the agent context to steer it back on track.
+ *
+ * HLD §3.5 — Corrective prompt injection
+ */
+export interface CorrectivePromptCard {
+    /** The corrective prompt text to inject into agent context. */
+    promptText: string;
+    /** Confidence that this prompt will resolve the anomaly (0.0–1.0). */
+    confidence: number;
+    /** Evidence chain supporting the corrective action. */
+    sourceEvidence: string[];
+    /** SOP ID that defines the expected behavior — `newId('sp')`. */
+    sopId: string | null;
+}
+/**
+ * ARE probe tier classification.
+ *
+ * HLD §3.5 — ARE Probe Battery table
+ */
+export type ProbeType = 'PATTERN' | 'SCHEMA' | 'LLM';
+/**
+ * Result from an individual ARE probe execution.
+ *
+ * LLD #5 §2.2 — runProbes() return type
+ */
+export interface ProbeResult {
+    /** Probe tier. */
+    probeType: ProbeType;
+    /** Probe name (e.g., 'WorkspaceHygieneProbe', 'MCPHealthProbe'). */
+    probeName: string;
+    /** Whether the probe detected an issue. */
+    triggered: boolean;
+    /** Confidence score if triggered (0.0–1.0). */
+    confidence: number;
+    /** Whether the probe was skipped (e.g., LLM probe in Phase 1). */
+    skipped: boolean;
+    /** Reason for skip if applicable. */
+    skipReason?: string;
+    /** Execution latency in milliseconds. */
+    latencyMs: number;
+    /** Additional probe-specific details. */
+    details?: Record<string, unknown>;
+}
+/**
+ * Trust score for a user/agent within a workspace.
+ *
+ * LLD #5 §4.4 — Trust Score Algorithm
+ * Decay: score * 0.85 per anomaly
+ * Boost: score * 1.02 per clean session
+ * Clamped to [0, 100]. Initial: 80.
+ */
+export interface TrustScoreResult {
+    /** Trust score ID — `newId('ts')`. */
+    scoreId: string;
+    /** Workspace ID. */
+    workspaceId: string;
+    /** User/agent ID. */
+    userId: string;
+    /** Current trust score (0–100). */
+    currentScore: number;
+    /** Total anomaly count. */
+    anomalyCount: number;
+    /** Total clean sessions. */
+    cleanSessions: number;
+    /** Timestamp of last anomaly. */
+    lastAnomalyAt: string | null;
+    /** Timestamp of last boost. */
+    lastBoostAt: string | null;
+}
+/**
+ * Result of a trust score update operation.
+ *
+ * LLD #5 §2.2 — updateTrustScore() return type
+ */
+export interface TrustScoreUpdate {
+    /** Previous score before update. */
+    previousScore: number;
+    /** New score after update. */
+    newScore: number;
+    /** Delta applied. */
+    delta: number;
+    /** Reason for the update. */
+    reason: string;
+}
+/**
+ * Events that can modify a trust score.
+ *
+ * LLD #5 §4.4
+ */
+export interface TrustEvent {
+    type: 'ANOMALY_DETECTED' | 'CLEAN_SESSION';
+    anomalyType?: AnomalyType;
+    traceId?: string;
+    sessionId?: string;
+}
+import type { IncidentStatus } from './enums.js';
+/**
+ * @deprecated Use {@link IncidentStatus} from enums.ts instead.
+ * Kept as alias for backward compatibility.
+ */
+export type GovernanceIncidentStatus = IncidentStatus;
+/**
+ * CAPABILITY_MISS event — logged when an agent encounters a task
+ * for which no governing SOP exists.
+ *
+ * HLD §3.5 — CAPABILITY_MISS (Non-Anomaly Informational Event)
+ */
+export interface CapabilityMissEvent {
+    /** Miss ID — `newId('cm')`. */
+    missId: string;
+    /** Workspace ID. */
+    workspaceId: string;
+    /** Session ID where the miss occurred. */
+    sessionId: string | null;
+    /** Brief description of the ungoverned task. */
+    taskDescription: string;
+    /** Tools the agent attempted. */
+    toolSequence: string[];
+    /** Closest SOP by embedding similarity, or null. */
+    nearestSopId: string | null;
+    /** How close the nearest SOP was (0.0–1.0). */
+    similarityScore: number | null;
+    /** Recommended action for Dream Cycle. */
+    recommendedAction: 'AUTHOR_NEW_SOP' | 'EXTEND_EXISTING_SOP';
+}
+/**
+ * Input for recording a capability miss.
+ *
+ * LLD #5 §2.2 — recordCapabilityMiss() parameter
+ */
+export interface CapabilityMissInput {
+    workspaceId: string;
+    sessionId?: string;
+    taskDescription: string;
+    toolSequence: string[];
+    nearestSopId?: string;
+    similarityScore?: number;
+    recommendedAction?: 'AUTHOR_NEW_SOP' | 'EXTEND_EXISTING_SOP';
+}
+/**
+ * Drift direction classification.
+ *
+ * HLD §7.7 — Behavioral Drift Detector
+ */
+export type DriftDirection = 'POSITIVE_DRIFT' | 'NEGATIVE_DRIFT' | 'NEUTRAL_DRIFT';
+/**
+ * Drift detection event payload.
+ *
+ * LLD #5 §2.3 — anomaly.drift.detected event
+ */
+export interface DriftEvent {
+    workspaceId: string;
+    sopId: string;
+    driftScore: number;
+    driftDirection: DriftDirection;
+    baselineScore: number;
+    currentScore: number;
+}
+//# sourceMappingURL=anomaly.d.ts.map

package/dist/anomaly.d.ts.map

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

package/dist/anomaly.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * Anomaly detection types for the Anomaly Recognition Engine (ARE).
+ *
+ * These types support the 12-category runtime anomaly taxonomy,
+ * corrective prompt card system, trust scoring, and ARE probe battery.
+ *
+ * HLD §3.5 (Anomaly Detection), HLD §7.7 (Drift Detector)
+ * LLD #5 — Anomaly Detection + ARE
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ANOMALY_SEVERITY_MAP = void 0;
+/**
+ * Static mapping from anomaly type to default severity.
+ *
+ * HLD §3.5 — 12-category table, Alert Route column
+ * LLD #5 Appendix B
+ */
+exports.ANOMALY_SEVERITY_MAP = {
+    TOOL_ABUSE: 'HIGH',
+    TOKEN_WASTE: 'MEDIUM',
+    LOOP_DETECTED: 'HIGH',
+    UNAUTHORIZED_TOOL: 'HIGH',
+    DATA_EXFILTRATION: 'CRITICAL',
+    PROMPT_INJECTION: 'CRITICAL',
+    HALLUCINATION: 'HIGH',
+    SCOPE_VIOLATION: 'MEDIUM',
+    BUDGET_BREACH: 'HIGH',
+    SPAWN_BUDGET_BREACH: 'HIGH',
+    WORKFLOW_BUDGET_BREACH: 'HIGH',
+    WORKFLOW_GOAL_DRIFT: 'MEDIUM',
+};
+//# sourceMappingURL=anomaly.js.map

package/dist/anomaly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anomaly.js","sourceRoot":"","sources":["../src/anomaly.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAiEH;;;;;GAKG;AACU,QAAA,oBAAoB,GAAyC;IACxE,UAAU,EAAE,MAAM;IAClB,WAAW,EAAE,QAAQ;IACrB,aAAa,EAAE,MAAM;IACrB,iBAAiB,EAAE,MAAM;IACzB,iBAAiB,EAAE,UAAU;IAC7B,gBAAgB,EAAE,UAAU;IAC5B,aAAa,EAAE,MAAM;IACrB,eAAe,EAAE,QAAQ;IACzB,aAAa,EAAE,MAAM;IACrB,mBAAmB,EAAE,MAAM;IAC3B,sBAAsB,EAAE,MAAM;IAC9B,mBAAmB,EAAE,QAAQ;CACrB,CAAA"}