@lucern/contracts 0.1.0-alpha.3 → 0.1.1-alpha.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +2003 -29
- package/dist/index.js +5627 -30
- package/package.json +15 -58
- package/src/agents/v1.ts +8 -0
- package/src/api-enums.contract.ts +183 -0
- package/{dist/auth-context.contract.js → src/auth-context.contract.ts} +1 -1
- package/{dist/auth-session.contract.js → src/auth-session.contract.ts} +1 -1
- package/src/auth.contract.ts +162 -0
- package/src/beliefs/v1.ts +8 -0
- package/src/context-pack.contract.ts +704 -0
- package/src/convex-admin.contract.ts +14 -0
- package/{dist/events-types.contract.js → src/events-types.contract.ts} +1 -1
- package/src/events.contract.ts +376 -0
- package/src/evidence/v1.ts +8 -0
- package/src/gateway.contract.ts +151 -0
- package/src/graph/v1.ts +8 -0
- package/src/ids.contract.ts +36 -0
- package/src/index.ts +30 -0
- package/src/lens-filter.contract.ts +183 -0
- package/src/lens-workflow.contract.ts +162 -0
- package/src/mcp-tools.contract.ts +3636 -0
- package/src/ontologies/v1.ts +8 -0
- package/{dist/ontology-matching.contract.js → src/ontology-matching.contract.ts} +1 -1
- package/src/prompt.contract.ts +50 -0
- package/src/questions/v1.ts +8 -0
- package/src/sdk-methods.contract.ts +522 -0
- package/src/sdk-tools.contract.ts +1545 -0
- package/src/text-matching.contract.ts +347 -0
- package/{dist/topic-scope.contract.js → src/topic-scope.contract.ts} +1 -1
- package/src/topics/v1.ts +8 -0
- package/{dist/v1/agents/v1.d.ts → src/v1/agents/v1.ts} +0 -1
- package/{dist/v1/beliefs/v1.d.ts → src/v1/beliefs/v1.ts} +0 -1
- package/{dist/v1/evidence/v1.d.ts → src/v1/evidence/v1.ts} +0 -1
- package/{dist/v1/graph/v1.d.ts → src/v1/graph/v1.ts} +0 -1
- package/src/v1/ontologies/v1.ts +276 -0
- package/{dist/v1/questions/v1.d.ts → src/v1/questions/v1.ts} +0 -1
- package/src/v1/topics/v1.ts +79 -0
- package/{dist/v1/worktrees/v1.d.ts → src/v1/worktrees/v1.ts} +0 -1
- package/src/workflow-runtime.contract.ts +440 -0
- package/src/worktrees/v1.ts +8 -0
- package/tsconfig.json +9 -0
- package/README.md +0 -43
- package/dist/api-enums.contract.d.ts +0 -59
- package/dist/api-enums.contract.d.ts.map +0 -1
- package/dist/api-enums.contract.js +0 -148
- package/dist/api-enums.contract.js.map +0 -1
- package/dist/auth-context.contract.d.ts +0 -9
- package/dist/auth-context.contract.d.ts.map +0 -1
- package/dist/auth-context.contract.js.map +0 -1
- package/dist/auth-session.contract.d.ts +0 -9
- package/dist/auth-session.contract.d.ts.map +0 -1
- package/dist/auth-session.contract.js.map +0 -1
- package/dist/auth.contract.d.ts +0 -89
- package/dist/auth.contract.d.ts.map +0 -1
- package/dist/auth.contract.js +0 -58
- package/dist/auth.contract.js.map +0 -1
- package/dist/context-pack.contract.d.ts +0 -495
- package/dist/context-pack.contract.d.ts.map +0 -1
- package/dist/context-pack.contract.js +0 -170
- package/dist/context-pack.contract.js.map +0 -1
- package/dist/convex-admin.contract.d.ts +0 -6
- package/dist/convex-admin.contract.d.ts.map +0 -1
- package/dist/convex-admin.contract.js +0 -2
- package/dist/convex-admin.contract.js.map +0 -1
- package/dist/events-types.contract.d.ts +0 -9
- package/dist/events-types.contract.d.ts.map +0 -1
- package/dist/events-types.contract.js.map +0 -1
- package/dist/events.contract.d.ts +0 -177
- package/dist/events.contract.d.ts.map +0 -1
- package/dist/events.contract.js +0 -160
- package/dist/events.contract.js.map +0 -1
- package/dist/gateway.contract.d.ts +0 -75
- package/dist/gateway.contract.d.ts.map +0 -1
- package/dist/gateway.contract.js +0 -20
- package/dist/gateway.contract.js.map +0 -1
- package/dist/ids.contract.d.ts +0 -8
- package/dist/ids.contract.d.ts.map +0 -1
- package/dist/ids.contract.js +0 -25
- package/dist/ids.contract.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/lens-filter.contract.d.ts +0 -71
- package/dist/lens-filter.contract.d.ts.map +0 -1
- package/dist/lens-filter.contract.js +0 -96
- package/dist/lens-filter.contract.js.map +0 -1
- package/dist/lens-workflow.contract.d.ts +0 -85
- package/dist/lens-workflow.contract.d.ts.map +0 -1
- package/dist/lens-workflow.contract.js +0 -55
- package/dist/lens-workflow.contract.js.map +0 -1
- package/dist/mcp-tools.contract.d.ts +0 -152
- package/dist/mcp-tools.contract.d.ts.map +0 -1
- package/dist/mcp-tools.contract.js +0 -3282
- package/dist/mcp-tools.contract.js.map +0 -1
- package/dist/ontology-matching.contract.d.ts +0 -9
- package/dist/ontology-matching.contract.d.ts.map +0 -1
- package/dist/ontology-matching.contract.js.map +0 -1
- package/dist/prompt.contract.d.ts +0 -25
- package/dist/prompt.contract.d.ts.map +0 -1
- package/dist/prompt.contract.js +0 -25
- package/dist/prompt.contract.js.map +0 -1
- package/dist/sdk-methods.contract.d.ts +0 -356
- package/dist/sdk-methods.contract.d.ts.map +0 -1
- package/dist/sdk-methods.contract.js +0 -17
- package/dist/sdk-methods.contract.js.map +0 -1
- package/dist/sdk-tools.contract.d.ts +0 -93
- package/dist/sdk-tools.contract.d.ts.map +0 -1
- package/dist/sdk-tools.contract.js +0 -1399
- package/dist/sdk-tools.contract.js.map +0 -1
- package/dist/text-matching.contract.d.ts +0 -54
- package/dist/text-matching.contract.d.ts.map +0 -1
- package/dist/text-matching.contract.js +0 -278
- package/dist/text-matching.contract.js.map +0 -1
- package/dist/topic-scope.contract.d.ts +0 -9
- package/dist/topic-scope.contract.d.ts.map +0 -1
- package/dist/topic-scope.contract.js.map +0 -1
- package/dist/v1/agents/v1.d.ts.map +0 -1
- package/dist/v1/agents/v1.js +0 -2
- package/dist/v1/agents/v1.js.map +0 -1
- package/dist/v1/beliefs/v1.d.ts.map +0 -1
- package/dist/v1/beliefs/v1.js +0 -2
- package/dist/v1/beliefs/v1.js.map +0 -1
- package/dist/v1/evidence/v1.d.ts.map +0 -1
- package/dist/v1/evidence/v1.js +0 -2
- package/dist/v1/evidence/v1.js.map +0 -1
- package/dist/v1/graph/v1.d.ts.map +0 -1
- package/dist/v1/graph/v1.js +0 -2
- package/dist/v1/graph/v1.js.map +0 -1
- package/dist/v1/ontologies/v1.d.ts +0 -77
- package/dist/v1/ontologies/v1.d.ts.map +0 -1
- package/dist/v1/ontologies/v1.js +0 -179
- package/dist/v1/ontologies/v1.js.map +0 -1
- package/dist/v1/questions/v1.d.ts.map +0 -1
- package/dist/v1/questions/v1.js +0 -2
- package/dist/v1/questions/v1.js.map +0 -1
- package/dist/v1/topics/v1.d.ts +0 -20
- package/dist/v1/topics/v1.d.ts.map +0 -1
- package/dist/v1/topics/v1.js +0 -62
- package/dist/v1/topics/v1.js.map +0 -1
- package/dist/v1/worktrees/v1.d.ts.map +0 -1
- package/dist/v1/worktrees/v1.js +0 -2
- package/dist/v1/worktrees/v1.js.map +0 -1
- package/dist/workflow-runtime.contract.d.ts +0 -162
- package/dist/workflow-runtime.contract.d.ts.map +0 -1
- package/dist/workflow-runtime.contract.js +0 -258
- package/dist/workflow-runtime.contract.js.map +0 -1
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"context-pack.contract.js","sourceRoot":"","sources":["../src/context-pack.contract.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,6 +0,0 @@
|
|
|
1
|
-
export interface ConvexAdminClient {
|
|
2
|
-
query<T = unknown>(functionReference: unknown, args: Record<string, unknown>): Promise<T>;
|
|
3
|
-
mutation<T = unknown>(functionReference: unknown, args: Record<string, unknown>): Promise<T>;
|
|
4
|
-
action<T = unknown>(functionReference: unknown, args: Record<string, unknown>): Promise<T>;
|
|
5
|
-
}
|
|
6
|
-
//# sourceMappingURL=convex-admin.contract.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"convex-admin.contract.d.ts","sourceRoot":"","sources":["../src/convex-admin.contract.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,CAAC,GAAG,OAAO,EACf,iBAAiB,EAAE,OAAO,EAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,QAAQ,CAAC,CAAC,GAAG,OAAO,EAClB,iBAAiB,EAAE,OAAO,EAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,MAAM,CAAC,CAAC,GAAG,OAAO,EAChB,iBAAiB,EAAE,OAAO,EAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,CAAC,CAAC,CAAC;CACf"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"convex-admin.contract.js","sourceRoot":"","sources":["../src/convex-admin.contract.ts"],"names":[],"mappings":""}
|
|
@@ -1,9 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @lucern/contracts — events-types compat shim
|
|
3
|
-
*
|
|
4
|
-
* This file consolidated into ./events.contract.ts during EK-16 T1 PR 3b.
|
|
5
|
-
* Retained here until the Lucern 1.0.0 barrel-sunset cut (D12).
|
|
6
|
-
* New code should import from "@lucern/contracts" (barrel) or "./events.contract".
|
|
7
|
-
*/
|
|
8
|
-
export * from "./events.contract";
|
|
9
|
-
//# sourceMappingURL=events-types.contract.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"events-types.contract.d.ts","sourceRoot":"","sources":["../src/events-types.contract.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,mBAAmB,CAAC"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"events-types.contract.js","sourceRoot":"","sources":["../src/events-types.contract.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,mBAAmB,CAAC"}
|
|
@@ -1,177 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @lucern/contracts — events (canonical support contract)
|
|
3
|
-
*
|
|
4
|
-
* Consolidated flat support surface for Lucern's domain event stream:
|
|
5
|
-
* - Event type definitions, constants, and shared enums
|
|
6
|
-
* - Event construction + cursor helpers
|
|
7
|
-
*
|
|
8
|
-
* Consolidated from the former split type-definition module
|
|
9
|
-
* and the prior src/events.contract.ts (helpers) in EK-16 T1 PR 3b.
|
|
10
|
-
* Compat shim remains at the old events-types path until Lucern 1.0.0 (D12).
|
|
11
|
-
*/
|
|
12
|
-
export declare const DOMAIN_EVENT_VERSION: "1.0";
|
|
13
|
-
export declare const EVENT_RETENTION_DEFAULT_DAYS = 30;
|
|
14
|
-
export declare const WEBHOOK_MAX_ATTEMPTS = 5;
|
|
15
|
-
export declare const WEBHOOK_RETRY_DELAYS_MS: readonly [1000, 5000, 30000, 300000];
|
|
16
|
-
export declare const DOMAIN_EVENT_TYPES: readonly ["belief.created", "belief.forked", "belief.confidence_updated", "belief.archived", "belief.refined", "belief.contract_created", "belief.contract_evaluated", "belief.lineage_queried", "evidence.created", "evidence.linked", "evidence.search_executed", "question.created", "question.answered", "question.refined", "question.status_updated", "question.archived", "edge.created", "contradiction.flagged", "worktree.created", "worktree.activated", "worktree.merged", "worktree.targets_updated", "worktree.metadata_updated", "topic.created", "topic.updated", "topic.archived", "task.created", "task.completed", "task.updated", "ontology.bound", "context.compiled", "identity.key_created", "identity.key_rotated", "identity.key_revoked", "webhook.test"];
|
|
17
|
-
export type DomainEventType = (typeof DOMAIN_EVENT_TYPES)[number];
|
|
18
|
-
export type DomainResourceType = "belief" | "evidence" | "question" | "edge" | "contradiction" | "worktree" | "topic" | "task" | "ontology" | "context" | "identity" | "webhook";
|
|
19
|
-
export type DomainActorType = "human" | "agent" | "service";
|
|
20
|
-
export type DomainEventData = Record<string, unknown>;
|
|
21
|
-
export type DomainEvent = {
|
|
22
|
-
eventId: string;
|
|
23
|
-
type: DomainEventType | string;
|
|
24
|
-
version: typeof DOMAIN_EVENT_VERSION;
|
|
25
|
-
timestamp: number;
|
|
26
|
-
tenantId?: string;
|
|
27
|
-
workspaceId?: string;
|
|
28
|
-
topicId: string;
|
|
29
|
-
resourceId: string;
|
|
30
|
-
resourceType: DomainResourceType | string;
|
|
31
|
-
actorId: string;
|
|
32
|
-
actorType: DomainActorType;
|
|
33
|
-
data: DomainEventData;
|
|
34
|
-
correlationId?: string;
|
|
35
|
-
expiresAt: number;
|
|
36
|
-
};
|
|
37
|
-
export type CreateDomainEventInput = {
|
|
38
|
-
eventId?: string;
|
|
39
|
-
timestamp?: number;
|
|
40
|
-
tenantId?: string;
|
|
41
|
-
workspaceId?: string;
|
|
42
|
-
topicId: string;
|
|
43
|
-
type: DomainEventType | string;
|
|
44
|
-
resourceId: string;
|
|
45
|
-
resourceType: DomainResourceType | string;
|
|
46
|
-
actorId: string;
|
|
47
|
-
actorType: DomainActorType;
|
|
48
|
-
data?: DomainEventData;
|
|
49
|
-
correlationId?: string;
|
|
50
|
-
retentionDays?: number;
|
|
51
|
-
};
|
|
52
|
-
export type EventCursor = {
|
|
53
|
-
timestamp: number;
|
|
54
|
-
eventId: string;
|
|
55
|
-
};
|
|
56
|
-
export type EventListQuery = {
|
|
57
|
-
topicId?: string;
|
|
58
|
-
after?: string;
|
|
59
|
-
types?: string[];
|
|
60
|
-
startTime?: number;
|
|
61
|
-
endTime?: number;
|
|
62
|
-
limit?: number;
|
|
63
|
-
};
|
|
64
|
-
export type EventListResult = {
|
|
65
|
-
events: DomainEvent[];
|
|
66
|
-
nextCursor: string | null;
|
|
67
|
-
};
|
|
68
|
-
export type WebhookSecretMode = "configured";
|
|
69
|
-
export type WebhookRecord = {
|
|
70
|
-
id: string;
|
|
71
|
-
webhookId: string;
|
|
72
|
-
tenantId?: string;
|
|
73
|
-
workspaceId?: string;
|
|
74
|
-
topicId?: string;
|
|
75
|
-
url: string;
|
|
76
|
-
events: string[];
|
|
77
|
-
active: boolean;
|
|
78
|
-
secretConfigured: boolean;
|
|
79
|
-
createdAt: number;
|
|
80
|
-
updatedAt: number;
|
|
81
|
-
createdBy: string;
|
|
82
|
-
updatedBy: string;
|
|
83
|
-
lastDeliveryAt?: number;
|
|
84
|
-
lastSuccessfulDeliveryAt?: number;
|
|
85
|
-
};
|
|
86
|
-
export type WebhookCreateInput = {
|
|
87
|
-
url: string;
|
|
88
|
-
events: string[];
|
|
89
|
-
secret: string;
|
|
90
|
-
topicId?: string;
|
|
91
|
-
active?: boolean;
|
|
92
|
-
};
|
|
93
|
-
export type WebhookUpdateInput = {
|
|
94
|
-
url?: string;
|
|
95
|
-
events?: string[];
|
|
96
|
-
secret?: string;
|
|
97
|
-
topicId?: string | null;
|
|
98
|
-
active?: boolean;
|
|
99
|
-
};
|
|
100
|
-
export type WebhookDeliveryStatus = "pending" | "delivering" | "succeeded" | "failed" | "dead_letter";
|
|
101
|
-
export type WebhookDeliveryRecord = {
|
|
102
|
-
id: string;
|
|
103
|
-
deliveryId: string;
|
|
104
|
-
webhookId: string;
|
|
105
|
-
eventId: string;
|
|
106
|
-
eventType: string;
|
|
107
|
-
topicId: string;
|
|
108
|
-
status: WebhookDeliveryStatus;
|
|
109
|
-
attemptCount: number;
|
|
110
|
-
maxAttempts: number;
|
|
111
|
-
nextAttemptAt?: number;
|
|
112
|
-
lastAttemptAt?: number;
|
|
113
|
-
lastStatusCode?: number;
|
|
114
|
-
lastError?: string;
|
|
115
|
-
deliveredAt?: number;
|
|
116
|
-
createdAt: number;
|
|
117
|
-
updatedAt: number;
|
|
118
|
-
};
|
|
119
|
-
export type WebhookDeliveryAttemptRecord = {
|
|
120
|
-
id: string;
|
|
121
|
-
attemptId: string;
|
|
122
|
-
deliveryId: string;
|
|
123
|
-
webhookId: string;
|
|
124
|
-
eventId: string;
|
|
125
|
-
eventType: string;
|
|
126
|
-
attemptNumber: number;
|
|
127
|
-
status: "succeeded" | "failed";
|
|
128
|
-
statusCode?: number;
|
|
129
|
-
error?: string;
|
|
130
|
-
responseBody?: string;
|
|
131
|
-
durationMs?: number;
|
|
132
|
-
createdAt: number;
|
|
133
|
-
};
|
|
134
|
-
export type WebhookDeliveriesResult = {
|
|
135
|
-
deliveries: Array<WebhookDeliveryRecord & {
|
|
136
|
-
attempts?: WebhookDeliveryAttemptRecord[];
|
|
137
|
-
}>;
|
|
138
|
-
};
|
|
139
|
-
export type WebhookHealthResult = {
|
|
140
|
-
webhookId: string;
|
|
141
|
-
totalAttempts: number;
|
|
142
|
-
successfulAttempts: number;
|
|
143
|
-
failedAttempts: number;
|
|
144
|
-
successRate: number;
|
|
145
|
-
pendingDeliveries: number;
|
|
146
|
-
deadLetterDeliveries: number;
|
|
147
|
-
lastDeliveryAt?: number;
|
|
148
|
-
lastSuccessfulDeliveryAt?: number;
|
|
149
|
-
};
|
|
150
|
-
export type WebhookTestResult = {
|
|
151
|
-
webhookId: string;
|
|
152
|
-
deliveryId: string;
|
|
153
|
-
status: WebhookDeliveryStatus;
|
|
154
|
-
attempts: number;
|
|
155
|
-
};
|
|
156
|
-
export type ReplayEventsInput = EventListQuery & {
|
|
157
|
-
webhookId?: string;
|
|
158
|
-
};
|
|
159
|
-
export type ReplayEventsResult = EventListResult & {
|
|
160
|
-
replayedDeliveries?: number;
|
|
161
|
-
replayedWebhookId?: string;
|
|
162
|
-
};
|
|
163
|
-
export declare function createEventId(): string;
|
|
164
|
-
export declare function normalizeRetentionDays(value: number | undefined): number;
|
|
165
|
-
export declare function buildDomainEvent(input: CreateDomainEventInput): DomainEvent;
|
|
166
|
-
export declare function compareEventCursor(left: EventCursor, right: EventCursor): number;
|
|
167
|
-
export declare function encodeEventCursor(cursor: EventCursor): string;
|
|
168
|
-
export declare function decodeEventCursor(cursor: string | undefined): EventCursor | null;
|
|
169
|
-
export declare function isAfterCursor(event: Pick<DomainEvent, "timestamp" | "eventId">, cursor: EventCursor | null): boolean;
|
|
170
|
-
export declare function sortEventsByCursor<T extends Pick<DomainEvent, "timestamp" | "eventId">>(events: readonly T[]): T[];
|
|
171
|
-
export declare function inferActorType(args: {
|
|
172
|
-
sessionType?: "agent" | "user";
|
|
173
|
-
authMode?: string;
|
|
174
|
-
principalType?: string;
|
|
175
|
-
}): DomainActorType;
|
|
176
|
-
export declare function emitDomainEvent(invokeMutation: (reference: any, args: CreateDomainEventInput) => Promise<unknown>, input: CreateDomainEventInput): Promise<unknown>;
|
|
177
|
-
//# sourceMappingURL=events.contract.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"events.contract.d.ts","sourceRoot":"","sources":["../src/events.contract.ts"],"names":[],"mappings":"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"}
|
package/dist/events.contract.js
DELETED
|
@@ -1,160 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @lucern/contracts — events (canonical support contract)
|
|
3
|
-
*
|
|
4
|
-
* Consolidated flat support surface for Lucern's domain event stream:
|
|
5
|
-
* - Event type definitions, constants, and shared enums
|
|
6
|
-
* - Event construction + cursor helpers
|
|
7
|
-
*
|
|
8
|
-
* Consolidated from the former split type-definition module
|
|
9
|
-
* and the prior src/events.contract.ts (helpers) in EK-16 T1 PR 3b.
|
|
10
|
-
* Compat shim remains at the old events-types path until Lucern 1.0.0 (D12).
|
|
11
|
-
*/
|
|
12
|
-
// =============================================================================
|
|
13
|
-
// EVENT TYPE DEFINITIONS & CONSTANTS
|
|
14
|
-
// (Formerly the split events type-definition module)
|
|
15
|
-
// =============================================================================
|
|
16
|
-
export const DOMAIN_EVENT_VERSION = "1.0";
|
|
17
|
-
export const EVENT_RETENTION_DEFAULT_DAYS = 30;
|
|
18
|
-
export const WEBHOOK_MAX_ATTEMPTS = 5;
|
|
19
|
-
export const WEBHOOK_RETRY_DELAYS_MS = [1_000, 5_000, 30_000, 300_000];
|
|
20
|
-
export const DOMAIN_EVENT_TYPES = [
|
|
21
|
-
"belief.created",
|
|
22
|
-
"belief.forked",
|
|
23
|
-
"belief.confidence_updated",
|
|
24
|
-
"belief.archived",
|
|
25
|
-
"belief.refined",
|
|
26
|
-
"belief.contract_created",
|
|
27
|
-
"belief.contract_evaluated",
|
|
28
|
-
"belief.lineage_queried",
|
|
29
|
-
"evidence.created",
|
|
30
|
-
"evidence.linked",
|
|
31
|
-
"evidence.search_executed",
|
|
32
|
-
"question.created",
|
|
33
|
-
"question.answered",
|
|
34
|
-
"question.refined",
|
|
35
|
-
"question.status_updated",
|
|
36
|
-
"question.archived",
|
|
37
|
-
"edge.created",
|
|
38
|
-
"contradiction.flagged",
|
|
39
|
-
"worktree.created",
|
|
40
|
-
"worktree.activated",
|
|
41
|
-
"worktree.merged",
|
|
42
|
-
"worktree.targets_updated",
|
|
43
|
-
"worktree.metadata_updated",
|
|
44
|
-
"topic.created",
|
|
45
|
-
"topic.updated",
|
|
46
|
-
"topic.archived",
|
|
47
|
-
"task.created",
|
|
48
|
-
"task.completed",
|
|
49
|
-
"task.updated",
|
|
50
|
-
"ontology.bound",
|
|
51
|
-
"context.compiled",
|
|
52
|
-
"identity.key_created",
|
|
53
|
-
"identity.key_rotated",
|
|
54
|
-
"identity.key_revoked",
|
|
55
|
-
"webhook.test",
|
|
56
|
-
];
|
|
57
|
-
// =============================================================================
|
|
58
|
-
// EVENT HELPERS
|
|
59
|
-
// (Formerly the body of src/events.contract.ts)
|
|
60
|
-
// =============================================================================
|
|
61
|
-
function toBase64(value) {
|
|
62
|
-
if (typeof Buffer !== "undefined") {
|
|
63
|
-
return Buffer.from(value, "utf8").toString("base64url");
|
|
64
|
-
}
|
|
65
|
-
return btoa(unescape(encodeURIComponent(value)))
|
|
66
|
-
.replace(/\+/g, "-")
|
|
67
|
-
.replace(/\//g, "_")
|
|
68
|
-
.replace(/=+$/g, "");
|
|
69
|
-
}
|
|
70
|
-
function fromBase64(value) {
|
|
71
|
-
if (typeof Buffer !== "undefined") {
|
|
72
|
-
return Buffer.from(value, "base64url").toString("utf8");
|
|
73
|
-
}
|
|
74
|
-
const normalized = value.replace(/-/g, "+").replace(/_/g, "/");
|
|
75
|
-
return decodeURIComponent(escape(atob(normalized)));
|
|
76
|
-
}
|
|
77
|
-
export function createEventId() {
|
|
78
|
-
const random = crypto.randomUUID().replace(/-/g, "");
|
|
79
|
-
return `evt_${random}`;
|
|
80
|
-
}
|
|
81
|
-
export function normalizeRetentionDays(value) {
|
|
82
|
-
if (!Number.isFinite(value) || typeof value !== "number" || value <= 0) {
|
|
83
|
-
return EVENT_RETENTION_DEFAULT_DAYS;
|
|
84
|
-
}
|
|
85
|
-
return Math.max(1, Math.trunc(value));
|
|
86
|
-
}
|
|
87
|
-
export function buildDomainEvent(input) {
|
|
88
|
-
const timestamp = input.timestamp ?? Date.now();
|
|
89
|
-
const retentionDays = normalizeRetentionDays(input.retentionDays);
|
|
90
|
-
return {
|
|
91
|
-
eventId: input.eventId?.trim() || createEventId(),
|
|
92
|
-
type: input.type.trim(),
|
|
93
|
-
version: DOMAIN_EVENT_VERSION,
|
|
94
|
-
timestamp,
|
|
95
|
-
tenantId: input.tenantId?.trim() || undefined,
|
|
96
|
-
workspaceId: input.workspaceId?.trim() || undefined,
|
|
97
|
-
topicId: input.topicId.trim(),
|
|
98
|
-
resourceId: input.resourceId.trim(),
|
|
99
|
-
resourceType: input.resourceType.trim(),
|
|
100
|
-
actorId: input.actorId.trim(),
|
|
101
|
-
actorType: input.actorType,
|
|
102
|
-
data: input.data ?? {},
|
|
103
|
-
correlationId: input.correlationId?.trim() || undefined,
|
|
104
|
-
expiresAt: timestamp + retentionDays * 24 * 60 * 60 * 1000,
|
|
105
|
-
};
|
|
106
|
-
}
|
|
107
|
-
export function compareEventCursor(left, right) {
|
|
108
|
-
if (left.timestamp !== right.timestamp) {
|
|
109
|
-
return left.timestamp - right.timestamp;
|
|
110
|
-
}
|
|
111
|
-
return left.eventId.localeCompare(right.eventId);
|
|
112
|
-
}
|
|
113
|
-
export function encodeEventCursor(cursor) {
|
|
114
|
-
return toBase64(JSON.stringify(cursor));
|
|
115
|
-
}
|
|
116
|
-
export function decodeEventCursor(cursor) {
|
|
117
|
-
if (!cursor || cursor.trim().length === 0) {
|
|
118
|
-
return null;
|
|
119
|
-
}
|
|
120
|
-
try {
|
|
121
|
-
const parsed = JSON.parse(fromBase64(cursor.trim()));
|
|
122
|
-
if (typeof parsed.timestamp !== "number" ||
|
|
123
|
-
!Number.isFinite(parsed.timestamp) ||
|
|
124
|
-
typeof parsed.eventId !== "string" ||
|
|
125
|
-
parsed.eventId.trim().length === 0) {
|
|
126
|
-
return null;
|
|
127
|
-
}
|
|
128
|
-
return {
|
|
129
|
-
timestamp: parsed.timestamp,
|
|
130
|
-
eventId: parsed.eventId.trim(),
|
|
131
|
-
};
|
|
132
|
-
}
|
|
133
|
-
catch {
|
|
134
|
-
return null;
|
|
135
|
-
}
|
|
136
|
-
}
|
|
137
|
-
export function isAfterCursor(event, cursor) {
|
|
138
|
-
if (!cursor) {
|
|
139
|
-
return true;
|
|
140
|
-
}
|
|
141
|
-
return compareEventCursor(event, cursor) > 0;
|
|
142
|
-
}
|
|
143
|
-
export function sortEventsByCursor(events) {
|
|
144
|
-
return [...events].sort((left, right) => compareEventCursor(left, right));
|
|
145
|
-
}
|
|
146
|
-
export function inferActorType(args) {
|
|
147
|
-
if (args.sessionType === "agent") {
|
|
148
|
-
return "agent";
|
|
149
|
-
}
|
|
150
|
-
if (args.authMode === "service_principal" ||
|
|
151
|
-
args.authMode === "tenant_api_key" ||
|
|
152
|
-
args.principalType === "service") {
|
|
153
|
-
return "service";
|
|
154
|
-
}
|
|
155
|
-
return "human";
|
|
156
|
-
}
|
|
157
|
-
export async function emitDomainEvent(invokeMutation, input) {
|
|
158
|
-
return await invokeMutation("events:recordEvent", input);
|
|
159
|
-
}
|
|
160
|
-
//# sourceMappingURL=events.contract.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"events.contract.js","sourceRoot":"","sources":["../src/events.contract.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,75 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Gateway contract types — shared between Stack's gateway middleware and
|
|
3
|
-
* Lucern's server-core / gateway route handlers.
|
|
4
|
-
*
|
|
5
|
-
* These types describe the authenticated request context that flows from
|
|
6
|
-
* the gateway into Lucern route handlers. The gateway (Stack-side) creates
|
|
7
|
-
* the context; Lucern consumes it read-only.
|
|
8
|
-
*
|
|
9
|
-
* @module @lucern/contracts/src/gateway
|
|
10
|
-
*/
|
|
11
|
-
import type { SessionAuthMode, SessionDelegationHop, SessionPrincipalType } from "./auth-session.contract";
|
|
12
|
-
export type PlatformApiErrorCode = "AUTH_REQUIRED" | "AUTHENTICATION_REQUIRED" | "AUTH_TOKEN_MISSING" | "INVALID_REQUEST" | "IDEMPOTENCY_KEY_REQUIRED" | "FORBIDDEN" | "SCOPE_INSUFFICIENT" | "ENVIRONMENT_MISMATCH" | "KEY_EXPIRED" | "KEY_REVOKED" | "RATE_LIMIT_EXCEEDED" | "NOT_FOUND" | "CONFLICT" | "UPSTREAM_ERROR" | "INTERNAL_ERROR";
|
|
13
|
-
export type GatewayScope = {
|
|
14
|
-
tenantId?: string;
|
|
15
|
-
workspaceId?: string;
|
|
16
|
-
};
|
|
17
|
-
export type GatewayEnvironment = "sandbox" | "production";
|
|
18
|
-
export type GatewayAuthMode = "interactive_user" | "service_principal" | "tenant_api_key" | "session_token";
|
|
19
|
-
export type KeyLifecycleStatus = "active" | "rotating" | "rotated" | "expired" | "revoked";
|
|
20
|
-
export type CutoverDomain = "graph" | "schema" | "identity" | "policy" | "audit" | "admin" | "agent" | "tool" | "prompt" | "intelligence";
|
|
21
|
-
export type CutoverFlagState = "legacy" | "cutover" | "disabled";
|
|
22
|
-
/**
|
|
23
|
-
* Authenticated request context created by the gateway middleware.
|
|
24
|
-
* Lucern route handlers receive this as a read-only parameter.
|
|
25
|
-
*
|
|
26
|
-
* The `convex` field is typed as `unknown` in the contract because Lucern
|
|
27
|
-
* consumers should not use the gateway's Convex client directly — they
|
|
28
|
-
* have their own kernel client. The gateway (Stack-side) narrows this to
|
|
29
|
-
* `ConvexHttpClient` at the construction site.
|
|
30
|
-
*/
|
|
31
|
-
export type GatewayAuthContext = {
|
|
32
|
-
userId: string;
|
|
33
|
-
convexToken?: string;
|
|
34
|
-
/** Opaque in contract — narrowed to ConvexHttpClient at the gateway. */
|
|
35
|
-
convex: any;
|
|
36
|
-
authMode: GatewayAuthMode;
|
|
37
|
-
principalId?: string;
|
|
38
|
-
principalType?: SessionPrincipalType;
|
|
39
|
-
tenantId?: string;
|
|
40
|
-
workspaceId?: string;
|
|
41
|
-
roles?: string[];
|
|
42
|
-
sessionId?: string;
|
|
43
|
-
sessionAuthMode?: SessionAuthMode;
|
|
44
|
-
sessionExpiresAt?: number;
|
|
45
|
-
delegationChain?: SessionDelegationHop[];
|
|
46
|
-
servicePrincipalId?: string;
|
|
47
|
-
servicePrincipalKeyId?: string;
|
|
48
|
-
servicePrincipalTenantId?: string;
|
|
49
|
-
servicePrincipalWorkspaceId?: string;
|
|
50
|
-
requestEnvironment: GatewayEnvironment;
|
|
51
|
-
keyEnvironment?: GatewayEnvironment;
|
|
52
|
-
keyStatus: KeyLifecycleStatus | "unknown";
|
|
53
|
-
grantedScopes: Set<string>;
|
|
54
|
-
cutoverDomain: CutoverDomain;
|
|
55
|
-
cutoverState: CutoverFlagState;
|
|
56
|
-
};
|
|
57
|
-
export type GatewayErrorArgs = {
|
|
58
|
-
code: PlatformApiErrorCode;
|
|
59
|
-
message: string;
|
|
60
|
-
status: number;
|
|
61
|
-
correlationId: string;
|
|
62
|
-
policyTraceId?: string;
|
|
63
|
-
invariant?: string;
|
|
64
|
-
suggestion?: string;
|
|
65
|
-
details?: unknown;
|
|
66
|
-
headers?: HeadersInit;
|
|
67
|
-
};
|
|
68
|
-
export type GatewaySuccessArgs = {
|
|
69
|
-
status?: number;
|
|
70
|
-
correlationId: string;
|
|
71
|
-
policyTraceId?: string;
|
|
72
|
-
idempotentReplay?: boolean;
|
|
73
|
-
};
|
|
74
|
-
export declare function requireActorPrincipalId(authContext: GatewayAuthContext): string;
|
|
75
|
-
//# sourceMappingURL=gateway.contract.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"gateway.contract.d.ts","sourceRoot":"","sources":["../src/gateway.contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,yBAAyB,CAAC;AAMjC,MAAM,MAAM,oBAAoB,GAC5B,eAAe,GACf,yBAAyB,GACzB,oBAAoB,GACpB,iBAAiB,GACjB,0BAA0B,GAC1B,WAAW,GACX,oBAAoB,GACpB,sBAAsB,GACtB,aAAa,GACb,aAAa,GACb,qBAAqB,GACrB,WAAW,GACX,UAAU,GACV,gBAAgB,GAChB,gBAAgB,CAAC;AAMrB,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,YAAY,CAAC;AAE1D,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAClB,mBAAmB,GACnB,gBAAgB,GAChB,eAAe,CAAC;AAEpB,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,UAAU,GACV,SAAS,GACT,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,OAAO,GACP,OAAO,GACP,OAAO,GACP,MAAM,GACN,QAAQ,GACR,cAAc,CAAC;AAEnB,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAMjE;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,MAAM,EAAE,GAAG,CAAC;IACZ,QAAQ,EAAE,eAAe,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACzC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC,SAAS,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC1C,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,EAAE,gBAAgB,CAAC;CAChC,CAAC;AAMF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,kBAAkB,GAC9B,MAAM,CASR"}
|
package/dist/gateway.contract.js
DELETED
|
@@ -1,20 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Gateway contract types — shared between Stack's gateway middleware and
|
|
3
|
-
* Lucern's server-core / gateway route handlers.
|
|
4
|
-
*
|
|
5
|
-
* These types describe the authenticated request context that flows from
|
|
6
|
-
* the gateway into Lucern route handlers. The gateway (Stack-side) creates
|
|
7
|
-
* the context; Lucern consumes it read-only.
|
|
8
|
-
*
|
|
9
|
-
* @module @lucern/contracts/src/gateway
|
|
10
|
-
*/
|
|
11
|
-
export function requireActorPrincipalId(authContext) {
|
|
12
|
-
const principalId = typeof authContext.principalId === "string"
|
|
13
|
-
? authContext.principalId.trim()
|
|
14
|
-
: "";
|
|
15
|
-
if (principalId.length > 0) {
|
|
16
|
-
return principalId;
|
|
17
|
-
}
|
|
18
|
-
throw new Error("Access denied: federated principal context required.");
|
|
19
|
-
}
|
|
20
|
-
//# sourceMappingURL=gateway.contract.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"gateway.contract.js","sourceRoot":"","sources":["../src/gateway.contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkIH,MAAM,UAAU,uBAAuB,CACrC,WAA+B;IAE/B,MAAM,WAAW,GACf,OAAO,WAAW,CAAC,WAAW,KAAK,QAAQ;QACzC,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,EAAE;QAChC,CAAC,CAAC,EAAE,CAAC;IACT,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;AAC1E,CAAC"}
|
package/dist/ids.contract.d.ts
DELETED
|
@@ -1,8 +0,0 @@
|
|
|
1
|
-
export type DecodedPrefixedId = {
|
|
2
|
-
prefix: string;
|
|
3
|
-
value: string;
|
|
4
|
-
};
|
|
5
|
-
export declare function encodePrefixedId(prefix: string, value: string): string;
|
|
6
|
-
export declare function decodePrefixedId(id: string): DecodedPrefixedId;
|
|
7
|
-
export declare function hasPrefixedIdPrefix(id: string, prefix: string): boolean;
|
|
8
|
-
//# sourceMappingURL=ids.contract.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"ids.contract.d.ts","sourceRoot":"","sources":["../src/ids.contract.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAIF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAStE;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,CAY9D;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAGvE"}
|
package/dist/ids.contract.js
DELETED
|
@@ -1,25 +0,0 @@
|
|
|
1
|
-
const PREFIXED_ID_PATTERN = /^([a-z][a-z0-9]*)_(.+)$/;
|
|
2
|
-
export function encodePrefixedId(prefix, value) {
|
|
3
|
-
const normalizedPrefix = prefix.trim();
|
|
4
|
-
const normalizedValue = value.trim();
|
|
5
|
-
if (!normalizedPrefix || !normalizedValue) {
|
|
6
|
-
throw new Error("Both prefix and value are required to encode a prefixed ID.");
|
|
7
|
-
}
|
|
8
|
-
return `${normalizedPrefix}_${normalizedValue}`;
|
|
9
|
-
}
|
|
10
|
-
export function decodePrefixedId(id) {
|
|
11
|
-
const normalized = id.trim();
|
|
12
|
-
const match = PREFIXED_ID_PATTERN.exec(normalized);
|
|
13
|
-
if (!match) {
|
|
14
|
-
throw new Error(`Invalid prefixed ID: ${id}`);
|
|
15
|
-
}
|
|
16
|
-
return {
|
|
17
|
-
prefix: match[1],
|
|
18
|
-
value: match[2],
|
|
19
|
-
};
|
|
20
|
-
}
|
|
21
|
-
export function hasPrefixedIdPrefix(id, prefix) {
|
|
22
|
-
const decoded = decodePrefixedId(id);
|
|
23
|
-
return decoded.prefix === prefix.trim();
|
|
24
|
-
}
|
|
25
|
-
//# sourceMappingURL=ids.contract.js.map
|
package/dist/ids.contract.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"ids.contract.js","sourceRoot":"","sources":["../src/ids.contract.ts"],"names":[],"mappings":"AAKA,MAAM,mBAAmB,GAAG,yBAAyB,CAAC;AAEtD,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,KAAa;IAC5D,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IACvC,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAErC,IAAI,CAAC,gBAAgB,IAAI,CAAC,eAAe,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IAED,OAAO,GAAG,gBAAgB,IAAI,eAAe,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAU;IACzC,MAAM,UAAU,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEnD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;QAChB,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;KAChB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,EAAU,EAAE,MAAc;IAC5D,MAAM,OAAO,GAAG,gBAAgB,CAAC,EAAE,CAAC,CAAC;IACrC,OAAO,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;AAC1C,CAAC"}
|
package/dist/index.d.ts.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,KAAK,gBAAgB,MAAM,sBAAsB,CAAC;AACzD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,OAAO,KAAK,gBAAgB,MAAM,sBAAsB,CAAC;AACzD,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC"}
|
package/dist/index.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,KAAK,gBAAgB,MAAM,sBAAsB,CAAC;AACzD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,OAAO,KAAK,gBAAgB,MAAM,sBAAsB,CAAC;AACzD,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC"}
|
|
@@ -1,71 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Lens Filter Criteria Contract
|
|
3
|
-
*
|
|
4
|
-
* Version-discriminated filter DSL for lenses. Each filter criteria document
|
|
5
|
-
* carries a `version` and `kind` discriminator so future shapes can coexist
|
|
6
|
-
* without schema migrations. The Convex `filterCriteria` field remains v.any()
|
|
7
|
-
* — all type enforcement happens here at the TypeScript contract layer.
|
|
8
|
-
*
|
|
9
|
-
* Forward-compatibility guarantees:
|
|
10
|
-
* - `version` field: new versions add fields, never remove or rename existing ones
|
|
11
|
-
* - `kind` field: new filter kinds (temporal, confidence-range) can be added
|
|
12
|
-
* without touching taxonomy code paths
|
|
13
|
-
* - `entityTypeFilters` array items are open to extension in future versions
|
|
14
|
-
* - Resolution logic switches on `version` + `kind` to select the right resolver
|
|
15
|
-
*
|
|
16
|
-
* @module lucern/contracts/src/lens-filter
|
|
17
|
-
*/
|
|
18
|
-
/**
|
|
19
|
-
* A single entity type filter entry. Matches nodes whose `nodeType` equals
|
|
20
|
-
* `entityTypeValue`, optionally further narrowed by subtype membership.
|
|
21
|
-
*
|
|
22
|
-
* V2 will add `propertyMatchers` here for arbitrary JSON Schema facet queries.
|
|
23
|
-
*/
|
|
24
|
-
export type EntityTypeFilterV1 = {
|
|
25
|
-
/** References ontologyVersion.entityTypes[].value, e.g. "company" */
|
|
26
|
-
entityTypeValue: string;
|
|
27
|
-
/** Optional subtype narrowing. If omitted or empty, all subtypes match. */
|
|
28
|
-
subtypeValues?: string[];
|
|
29
|
-
};
|
|
30
|
-
/**
|
|
31
|
-
* Optional scope to restrict which ontology the filter resolves against.
|
|
32
|
-
* If omitted, resolution uses whatever ontology is active in the workspace.
|
|
33
|
-
*/
|
|
34
|
-
export type OntologyScope = {
|
|
35
|
-
/** Restrict to a specific ontology by key, e.g. "vc-investment" */
|
|
36
|
-
ontologyKey?: string;
|
|
37
|
-
};
|
|
38
|
-
/**
|
|
39
|
-
* Taxonomy filter criteria v1: entity type + subtype matching over ontology.
|
|
40
|
-
*/
|
|
41
|
-
export type TaxonomyFilterCriteriaV1 = {
|
|
42
|
-
version: 1;
|
|
43
|
-
kind: "taxonomy";
|
|
44
|
-
entityTypeFilters: EntityTypeFilterV1[];
|
|
45
|
-
ontologyScope?: OntologyScope;
|
|
46
|
-
};
|
|
47
|
-
/**
|
|
48
|
-
* Discriminated union of all supported filter criteria.
|
|
49
|
-
* Resolution logic switches on `version` + `kind`.
|
|
50
|
-
*
|
|
51
|
-
* To add a new filter kind:
|
|
52
|
-
* 1. Define a new type (e.g., TemporalFilterCriteriaV1)
|
|
53
|
-
* 2. Add it to this union
|
|
54
|
-
* 3. Add a resolver in taxonomy-filter.ts
|
|
55
|
-
* 4. No schema migration needed — filterCriteria is v.any()
|
|
56
|
-
*/
|
|
57
|
-
export type LensFilterCriteria = TaxonomyFilterCriteriaV1;
|
|
58
|
-
export declare function isLensFilterCriteria(value: unknown): value is LensFilterCriteria;
|
|
59
|
-
export declare function isTaxonomyFilterCriteriaV1(value: unknown): value is TaxonomyFilterCriteriaV1;
|
|
60
|
-
export type FilterValidationResult = {
|
|
61
|
-
valid: true;
|
|
62
|
-
} | {
|
|
63
|
-
valid: false;
|
|
64
|
-
errors: string[];
|
|
65
|
-
};
|
|
66
|
-
/**
|
|
67
|
-
* Validate a filter criteria document at the contract layer.
|
|
68
|
-
* This runs before persisting to Convex.
|
|
69
|
-
*/
|
|
70
|
-
export declare function validateFilterCriteria(value: unknown): FilterValidationResult;
|
|
71
|
-
//# sourceMappingURL=lens-filter.contract.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"lens-filter.contract.d.ts","sourceRoot":"","sources":["../src/lens-filter.contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,qEAAqE;IACrE,eAAe,EAAE,MAAM,CAAC;IAExB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,iBAAiB,EAAE,kBAAkB,EAAE,CAAC;IACxC,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B,CAAC;AAMF;;;;;;;;;GASG;AACH,MAAM,MAAM,kBAAkB,GAAG,wBAAwB,CAAC;AAO1D,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,kBAAkB,CAI7B;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,wBAAwB,CAGnC;AAMD,MAAM,MAAM,sBAAsB,GAC9B;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GACf;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEvC;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,GACb,sBAAsB,CA2BxB"}
|