@graphrefly/ts 0.0.1 → 0.0.3

package/dist/types-BAw2QVVE.d.cts

@@ -0,0 +1,274 @@
+import { DataIssue } from './data/index.cjs';
+import { N as Node } from './types-CTN3XoMl.cjs';
+import { L as LockId } from './messages-CAzUPPJM.cjs';
+
+interface MessageEnvelope<T = unknown> {
+    readonly topic: string;
+    readonly seq: number;
+    readonly payload: T;
+    readonly key?: string;
+    readonly idempotencyKey?: string;
+    readonly timestampMs: number;
+    readonly commandId?: string;
+}
+/** Minimal JSON Schema vocabulary for passive topic payload descriptions (D125/D132). */
+interface JsonSchema {
+    readonly type?: "string" | "number" | "integer" | "boolean" | "object" | "array" | "null" | readonly ("string" | "number" | "integer" | "boolean" | "object" | "array" | "null")[];
+    readonly properties?: Readonly<Record<string, JsonSchema>>;
+    readonly required?: readonly string[];
+    readonly additionalProperties?: boolean | JsonSchema;
+    readonly items?: JsonSchema | readonly JsonSchema[];
+    readonly enum?: readonly unknown[];
+    readonly const?: unknown;
+    readonly $ref?: string;
+    readonly definitions?: Readonly<Record<string, JsonSchema>>;
+    readonly description?: string;
+    readonly title?: string;
+}
+/** Passive envelope for payloads that cross topic, agent, or graph boundaries. */
+interface TopicMessage<T = unknown> {
+    readonly id: string;
+    readonly schema?: JsonSchema;
+    readonly expiresAt?: string;
+    readonly correlationId?: string;
+    readonly payload: T;
+}
+/** Passive domain event vocabulary for messageBus/eventFlow composition (D329). */
+interface EventMessage<T = unknown> {
+    readonly id: string;
+    readonly type: string;
+    readonly payload: T;
+    readonly key?: string;
+    readonly subjectId?: string;
+    readonly correlationId?: string;
+    readonly causationId?: string;
+    readonly occurredAtMs?: number;
+    readonly actor?: string;
+    readonly evidenceRefs?: readonly string[];
+    readonly schema?: JsonSchema;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+interface EventMessageOptions {
+    readonly id: string;
+    readonly key?: string;
+    readonly subjectId?: string;
+    readonly correlationId?: string;
+    readonly causationId?: string;
+    readonly occurredAtMs?: number;
+    readonly actor?: string;
+    readonly evidenceRefs?: readonly string[];
+    readonly schema?: JsonSchema;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+declare const PROMPTS_TOPIC = "prompts";
+declare const RESPONSES_TOPIC = "responses";
+declare const INJECTIONS_TOPIC = "injections";
+declare const DEFERRED_TOPIC = "deferred";
+declare const SPAWNS_TOPIC = "spawns";
+declare const CONTEXT_TOPIC = "context";
+declare const TODOS_TOPIC = "todos";
+declare const STANDARD_TOPICS: readonly ["prompts", "responses", "injections", "deferred", "spawns", "context", "todos"];
+type StandardTopic = (typeof STANDARD_TOPICS)[number];
+type MessageBusTopicPolicy = "strict" | "create-as-fact";
+interface MessageBusRetentionPolicy {
+    /** Count retention. Trimming advances headSeq and never rewrites seq (D284). */
+    readonly maxMessages?: number;
+}
+interface MessageBusDedupePolicy {
+    /** Duplicate commandId emits status and never publishes a second retained message (D284). */
+    readonly commandId?: "status" | "issue";
+}
+interface MessageBusOptions<TTopic extends string = string> {
+    readonly topics?: readonly TTopic[];
+    readonly name?: string;
+    readonly now?: () => number;
+    readonly topicPolicy?: MessageBusTopicPolicy;
+    readonly retention?: MessageBusRetentionPolicy;
+    readonly dedupe?: MessageBusDedupePolicy;
+}
+type MessageBusCommand<T = unknown> = {
+    readonly kind: "ensure-topic";
+    readonly topic: string;
+    readonly commandId?: string;
+} | {
+    readonly kind: "close-topic";
+    readonly topic: string;
+    readonly commandId?: string;
+} | {
+    readonly kind: "publish";
+    readonly topic: string;
+    readonly payload: T;
+    readonly key?: string;
+    readonly commandId?: string;
+    readonly idempotencyKey?: string;
+} | {
+    readonly kind: "topic-policy";
+    readonly topicPolicy: MessageBusTopicPolicy;
+    readonly commandId?: string;
+} | {
+    readonly kind: "ack";
+    readonly topic: string;
+    readonly subscriptionId: string;
+    readonly seq: number;
+    readonly commandId?: string;
+} | {
+    readonly kind: "seek";
+    readonly topic: string;
+    readonly subscriptionId: string;
+    readonly nextSeq: number;
+    readonly commandId?: string;
+} | {
+    readonly kind: "close-subscription";
+    readonly topic: string;
+    readonly subscriptionId: string;
+    readonly commandId?: string;
+};
+type MessageBusMessage<T = unknown> = MessageEnvelope<T>;
+interface MessageBusStatus {
+    readonly kind: "topic-created" | "topic-closed" | "message-published" | "retention-trimmed" | "duplicate-command" | "subscription-acked" | "subscription-sought" | "subscription-closed" | "command-rejected" | "projection-ready" | "projection-partial";
+    readonly topic?: string;
+    readonly seq?: number;
+    readonly headSeq?: number;
+    readonly subscriptionId?: string;
+    readonly nextSeq?: number;
+    readonly commandId?: string;
+    readonly issueCode?: string;
+    readonly timestampMs: number;
+    readonly details?: unknown;
+}
+interface MessageBusCatalogEntry {
+    readonly topic: string;
+    readonly closed: boolean;
+    readonly headSeq: number;
+    readonly nextSeq: number;
+    readonly messageCount: number;
+}
+interface MessageBusCatalogPage {
+    readonly topics: readonly MessageBusCatalogEntry[];
+    readonly nextAfterTopic?: string;
+    readonly hasMore: boolean;
+}
+interface MessageBusDeadLetterEntry<T = unknown> {
+    readonly entrySeq: number;
+    readonly topic?: string;
+    readonly command?: MessageBusCommand<T>;
+    readonly message?: MessageBusMessage<T>;
+    readonly issue: DataIssue;
+    readonly timestampMs: number;
+}
+interface MessageBusDeadLetterPage<T = unknown> {
+    readonly entries: readonly MessageBusDeadLetterEntry<T>[];
+    readonly nextAfterEntrySeq?: number;
+    readonly hasMore: boolean;
+}
+interface MessageBusTopicPage<T = unknown> {
+    readonly topic: string;
+    readonly messages: readonly MessageBusMessage<T>[];
+    readonly fromSeq: number;
+    readonly throughSeq?: number;
+    readonly nextAfterSeq?: number;
+    readonly hasMore: boolean;
+}
+interface MessageBusCursor {
+    readonly topic: string;
+    readonly subscriptionId: string;
+    readonly nextSeq: number;
+    readonly closed: boolean;
+    readonly retentionGap: boolean;
+    readonly headSeq: number;
+}
+interface MessageBusAvailablePage<T = unknown> {
+    readonly topic: string;
+    readonly subscriptionId: string;
+    readonly cursor: MessageBusCursor;
+    readonly messages: readonly MessageBusMessage<T>[];
+    readonly fromSeq: number;
+    readonly throughSeq?: number;
+    readonly nextAfterSeq?: number;
+    readonly hasMore: boolean;
+}
+interface MessageBusPageParams {
+    readonly limit?: number;
+}
+interface MessageBusCatalogParams extends MessageBusPageParams {
+    readonly afterTopic?: string;
+    readonly includeClosed?: boolean;
+}
+interface MessageBusDeadLetterParams extends MessageBusPageParams {
+    readonly afterEntrySeq?: number;
+    readonly topic?: string;
+    readonly code?: string;
+}
+interface MessageBusTopicParams extends MessageBusPageParams {
+    readonly afterSeq?: number;
+}
+interface MessageBusAvailableParams extends MessageBusPageParams {
+    readonly afterSeq?: number;
+}
+interface MessageBusPullProjection<TPage> {
+    readonly snapshot: Node<TPage>;
+    readonly snapshotPullId: LockId;
+    readonly status: Node<MessageBusStatus>;
+    readonly issues: Node<DataIssue>;
+}
+interface MessageBusTopicProjection<T = unknown> extends MessageBusPullProjection<MessageBusTopicPage<T>> {
+}
+interface MessageBusSubscription<T = unknown> {
+    readonly available: Node<MessageBusAvailablePage<T>>;
+    readonly availablePullId: LockId;
+    readonly cursor: Node<MessageBusCursor>;
+    readonly status: Node<MessageBusStatus>;
+    readonly issues: Node<DataIssue>;
+    ack(seq: number, opts?: {
+        commandId?: string;
+    }): MessageBusCommand;
+    seek(nextSeq: number, opts?: {
+        commandId?: string;
+    }): MessageBusCommand;
+    close(opts?: {
+        commandId?: string;
+    }): MessageBusCommand;
+}
+interface MessageBus<TTopic extends string = string> {
+    readonly commands: Node<MessageBusCommand>;
+    readonly messages: Node<MessageBusMessage>;
+    readonly status: Node<MessageBusStatus>;
+    readonly issues: Node<DataIssue>;
+    ensureTopic(topic: TTopic | string, opts?: {
+        commandId?: string;
+    }): MessageBusCommand;
+    closeTopic(topic: TTopic | string, opts?: {
+        commandId?: string;
+    }): MessageBusCommand;
+    publish<T = unknown>(topic: TTopic | string, payload: T, opts?: {
+        key?: string;
+        commandId?: string;
+        idempotencyKey?: string;
+    }): MessageBusCommand<T>;
+    topic<T = unknown>(topic: TTopic | string, opts?: {
+        name?: string;
+    }): MessageBusTopicProjection<T>;
+    catalog(opts?: {
+        name?: string;
+    }): MessageBusPullProjection<MessageBusCatalogPage>;
+    deadLetter<T = unknown>(opts?: {
+        name?: string;
+    }): MessageBusPullProjection<MessageBusDeadLetterPage<T>>;
+    subscription<T = unknown>(opts: {
+        topic: TTopic | string;
+        subscriptionId: string;
+        from?: "earliest" | "latest" | number;
+        name?: string;
+    }): MessageBusSubscription<T>;
+}
+interface ToTopicOptions {
+    readonly name?: string;
+    readonly keyOf?: (value: unknown) => string | undefined;
+    readonly commandIdOf?: (value: unknown) => string | undefined;
+}
+interface ToTopicBundle<T> {
+    readonly commands: Node<MessageBusCommand<T>>;
+    release(): void;
+}
+
+export { type StandardTopic as A, TODOS_TOPIC as B, CONTEXT_TOPIC as C, DEFERRED_TOPIC as D, type EventMessage as E, type TopicMessage as F, INJECTIONS_TOPIC as I, type JsonSchema as J, type MessageBusMessage as M, PROMPTS_TOPIC as P, RESPONSES_TOPIC as R, SPAWNS_TOPIC as S, type ToTopicOptions as T, type MessageBusCommand as a, type MessageBusAvailablePage as b, type MessageEnvelope as c, type MessageBus as d, type EventMessageOptions as e, type MessageBusTopicPage as f, type MessageBusOptions as g, type ToTopicBundle as h, type MessageBusAvailableParams as i, type MessageBusCatalogEntry as j, type MessageBusCatalogPage as k, type MessageBusCatalogParams as l, type MessageBusCursor as m, type MessageBusDeadLetterEntry as n, type MessageBusDeadLetterPage as o, type MessageBusDeadLetterParams as p, type MessageBusDedupePolicy as q, type MessageBusPageParams as r, type MessageBusPullProjection as s, type MessageBusRetentionPolicy as t, type MessageBusStatus as u, type MessageBusSubscription as v, type MessageBusTopicParams as w, type MessageBusTopicPolicy as x, type MessageBusTopicProjection as y, STANDARD_TOPICS as z };

package/dist/types-BUbbbh4f.d.cts

@@ -0,0 +1,34 @@
+import { N as Node } from './types-CTN3XoMl.cjs';
+
+/**
+ * Public policy vocabulary (D80): shared option shapes only.
+ *
+ * Runtime policy mechanics stay structure-owned: each reactive collection still owns
+ * backend mutation, victim application, delta emission, and graph-bound node-as-opt wiring.
+ */
+type ReactiveOpt<T> = T | Node<T>;
+/** Capacity vocabulary shared by structures that bound retained entries. */
+interface CapacityPolicy<Order extends string = never> {
+    readonly maxSize: ReactiveOpt<number>;
+    readonly order?: Order;
+}
+/** Capacity policy variant for structures whose eviction order must be explicit. */
+type OrderedCapacityPolicy<Order extends string> = CapacityPolicy<Order> & {
+    readonly order: Order;
+};
+/** Score-based retention vocabulary; higher scores are retained. */
+interface RetentionPolicy<Entry> {
+    readonly maxSize?: ReactiveOpt<number>;
+    score(entry: Entry): number;
+}
+/**
+ * Static view-cache vocabulary for memoized helper nodes.
+ *
+ * This is intentionally not a release/keepalive API: eviction may drop the structure's
+ * memo reference, but externally held Node views remain valid.
+ */
+interface ViewCachePolicy {
+    readonly maxEntries?: number;
+}
+
+export type { CapacityPolicy as C, OrderedCapacityPolicy as O, ReactiveOpt as R, ViewCachePolicy as V, RetentionPolicy as a };