@hualinge/relay-api-server-contracts 0.1.3

package/dist/scheduler.d.ts

@@ -0,0 +1,162 @@
+export type RunOutcome = 'SKIP_NO_SIGNAL' | 'SKIP_DISABLED' | 'SKIP_OVERLAP' | 'SKIP_GLOBAL_PAUSE' | 'SKIP_TASK_OVERRIDE' | 'SKIP_SELF_ECHO' | 'SKIP_MISSED_WINDOW' | 'RUN_DELIVERED' | 'RUN_FAILED';
+export interface RunLedgerRow {
+    task_id: string;
+    subject_key: string;
+    outcome: RunOutcome;
+    signal_summary: string | null;
+    duration_ms: number;
+    started_at: string;
+    assigned_agent_id: string | null;
+    error_summary: string | null;
+    task_snapshot_json?: string | null;
+}
+export interface RunLedgerRecord extends RunLedgerRow {
+    id: number;
+    task_snapshot_json: string | null;
+}
+export interface RunLedgerQuery {
+    limit: number;
+    cursor?: number;
+    taskId?: string;
+    threadId?: string;
+    outcome?: RunOutcome;
+    since?: string;
+    until?: string;
+}
+export interface RunStats {
+    total: number;
+    delivered: number;
+    failed: number;
+    skipped: number;
+}
+export interface RunLedgerPort {
+    record(row: RunLedgerRow): void;
+    query(taskId: string, limit: number): RunLedgerRow[];
+    queryBySubject(taskId: string, subjectKey: string, limit: number): RunLedgerRow[];
+    queryAll(query: RunLedgerQuery): RunLedgerRecord[];
+    getById(id: number): RunLedgerRecord | null;
+    deleteById(id: number): boolean;
+    stats(taskId: string): RunStats;
+}
+export interface GlobalControl {
+    enabled: boolean;
+    reason: string | null;
+    updatedBy: string;
+    updatedAt: string;
+}
+export interface TaskOverride {
+    taskId: string;
+    enabled: boolean;
+    updatedBy: string;
+    updatedAt: string;
+}
+export interface GlobalControlPort {
+    getGlobalEnabled(): boolean;
+    getGlobalState(): GlobalControl;
+    setGlobalEnabled(enabled: boolean, reason: string | null, updatedBy: string): void;
+    getTaskOverride(taskId: string): TaskOverride | null;
+    setTaskOverride(taskId: string, enabled: boolean, updatedBy: string): void;
+    removeTaskOverride(taskId: string): boolean;
+    listOverrides(): TaskOverride[];
+}
+export interface EmissionRecord {
+    originTaskId: string;
+    threadId: string;
+    messageId: string;
+    suppressionMs: number;
+}
+export interface EmissionRow {
+    emissionId: string;
+    originTaskId: string;
+    threadId: string;
+    messageId: string;
+    suppressionUntil: string;
+    createdAt: string;
+}
+export interface EmissionPort {
+    record(emission: EmissionRecord): void;
+    isSuppressed(taskId: string, threadId: string): boolean;
+    cleanup(): number;
+    listActive(): EmissionRow[];
+}
+export type DisplayCategory = 'pr' | 'repo' | 'thread' | 'system' | 'external';
+export type SubjectKind = 'pr' | 'repo' | 'thread' | 'external' | 'none';
+export type TriggerSpec = {
+    type: 'interval';
+    ms: number;
+} | {
+    type: 'cron';
+    expression: string;
+    timezone?: string;
+} | {
+    type: 'once';
+    fireAt: number;
+};
+export interface PackTemplateDef {
+    templateId: string;
+    packId: string;
+    label: string;
+    description: string;
+    category: DisplayCategory;
+    subjectKind: SubjectKind;
+    defaultTrigger: TriggerSpec;
+    paramSchema: Record<string, {
+        type: string;
+        required: boolean;
+        description: string;
+    }>;
+    builtinTemplateRef: string;
+    createdAt?: string;
+}
+export interface PackTemplatePort {
+    install(def: PackTemplateDef): void;
+    get(templateId: string): PackTemplateDef | null;
+    uninstall(templateId: string): boolean;
+    listByPack(packId: string): PackTemplateDef[];
+    listAll(): PackTemplateDef[];
+}
+export interface TaskDisplayMeta {
+    label: string;
+    category: DisplayCategory;
+    description?: string;
+    subjectKind?: SubjectKind;
+}
+export interface DynamicTaskDef {
+    id: string;
+    templateId: string;
+    trigger: TriggerSpec;
+    params: Record<string, unknown>;
+    display: TaskDisplayMeta;
+    deliveryThreadId: string | null;
+    enabled: boolean;
+    createdBy: string;
+    createdAt: string;
+}
+export interface DynamicTaskPort {
+    insert(def: DynamicTaskDef): void;
+    getAll(): DynamicTaskDef[];
+    getById(id: string): DynamicTaskDef | null;
+    remove(id: string): boolean;
+    setEnabled(id: string, enabled: boolean): boolean;
+    update(id: string, def: Pick<DynamicTaskDef, 'trigger' | 'params' | 'display' | 'deliveryThreadId' | 'enabled'>): boolean;
+    removeByThreadId(threadId: string): DynamicTaskDef[];
+}
+export interface SchedulerPersistence {
+    ledger: RunLedgerPort;
+    globalControlStore: GlobalControlPort;
+    emissionStore: EmissionPort;
+    packTemplateStore: PackTemplatePort;
+    dynamicTaskStore: DynamicTaskPort;
+    close?(): void | Promise<void>;
+}
+export interface SchedulerProviderInput {
+    sqlitePath?: string;
+}
+export interface SchedulerProvider {
+    readonly id: string;
+    readonly displayName?: string;
+    createSchedulerPersistence(input: SchedulerProviderInput): SchedulerPersistence | Promise<SchedulerPersistence>;
+    bootstrap?(): Promise<void>;
+    shutdown?(): Promise<void>;
+}
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/scheduler.d.ts.map

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

package/dist/scheduler.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scheduler.js.map

package/dist/scheduler.js.map

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

package/dist/storage/authorization-types.d.ts

@@ -0,0 +1,86 @@
+import type { AgentId, AuthorizationAuditEntry, AuthorizationRule, RespondScope } from '@openjiuwen/relay-shared';
+export type { AuthorizationAuditEntry, AuthorizationRule };
+export interface CreateAuditInput {
+    readonly requestId: string;
+    readonly invocationId: string;
+    readonly agentId: AgentId;
+    readonly threadId: string;
+    readonly action: string;
+    readonly reason: string;
+    readonly decision: 'allow' | 'deny' | 'pending';
+    readonly scope?: RespondScope;
+    readonly decidedBy?: string;
+    readonly matchedRuleId?: string;
+}
+export interface IAuthorizationAuditStore {
+    append(input: CreateAuditInput): AuthorizationAuditEntry | Promise<AuthorizationAuditEntry>;
+    list(filter?: {
+        agentId?: AgentId;
+        threadId?: string;
+        limit?: number;
+    }): AuthorizationAuditEntry[] | Promise<AuthorizationAuditEntry[]>;
+}
+export interface IAuthorizationRuleStore {
+    add(rule: Omit<AuthorizationRule, 'id' | 'createdAt'>): AuthorizationRule | Promise<AuthorizationRule>;
+    remove(ruleId: string): boolean | Promise<boolean>;
+    match(agentId: AgentId, action: string, threadId: string): AuthorizationRule | null | Promise<AuthorizationRule | null>;
+    list(filter?: {
+        agentId?: AgentId;
+        threadId?: string;
+    }): AuthorizationRule[] | Promise<AuthorizationRule[]>;
+}
+export type ApprovalDecision = 'allow' | 'deny' | 'pending';
+export type ApprovalScope = 'once' | 'thread' | 'global';
+export type ApprovalSource = 'user' | 'rule';
+export interface ApprovalRecordInput {
+    requestId: string;
+    invocationId: string;
+    agentId: AgentId;
+    threadId: string;
+    threadTitle?: string | null;
+    action: string;
+    operationSummary?: string | null;
+    decision: ApprovalDecision;
+    approvalSource: ApprovalSource;
+    requestedAt: number;
+    decidedAt?: number | null;
+    scope?: ApprovalScope | null;
+    decidedBy?: string | null;
+    matchedRuleId?: string | null;
+}
+export interface SecurityApprovalRecord extends ApprovalRecordInput {
+    id: string;
+    approvalLabel: string;
+}
+export interface SecurityApprovalRecordSettings {
+    autoCleanupEnabled: boolean;
+    retentionDays: number;
+}
+export interface ListApprovalRecordsQuery {
+    limit?: number;
+    offset?: number;
+    threadQuery?: string;
+    includeRuleMatched?: boolean;
+}
+export interface SecurityApprovalRecordsResponse {
+    records: SecurityApprovalRecord[];
+    pageInfo: {
+        hasMore: boolean;
+        nextOffset?: number;
+    };
+    totalCount: number;
+    retention: {
+        autoCleanupEnabled: boolean;
+        retentionDays: number | null;
+    };
+}
+export interface IApprovalRecordStore {
+    record(input: ApprovalRecordInput): SecurityApprovalRecord | Promise<SecurityApprovalRecord>;
+    list(query?: ListApprovalRecordsQuery): SecurityApprovalRecordsResponse | Promise<SecurityApprovalRecordsResponse>;
+    getSettings(): SecurityApprovalRecordSettings | Promise<SecurityApprovalRecordSettings>;
+    updateSettings(input: {
+        autoCleanupEnabled: boolean;
+    }): SecurityApprovalRecordSettings | Promise<SecurityApprovalRecordSettings>;
+    close(): void;
+}
+//# sourceMappingURL=authorization-types.d.ts.map

package/dist/storage/authorization-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorization-types.d.ts","sourceRoot":"","sources":["../../src/storage/authorization-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAElH,YAAY,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC5F,IAAI,CAAC,MAAM,CAAC,EAAE;QACZ,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,uBAAuB,EAAE,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,uBAAuB;IACtC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACvG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,KAAK,CACH,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,iBAAiB,EAAE,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;CAC7G;AAED,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAC5D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACzD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC;AAE7C,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,8BAA8B;IAC7C,kBAAkB,EAAE,OAAO,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,QAAQ,EAAE;QACR,OAAO,EAAE,OAAO,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE;QACT,kBAAkB,EAAE,OAAO,CAAC;QAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC7F,IAAI,CAAC,KAAK,CAAC,EAAE,wBAAwB,GAAG,+BAA+B,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAAC;IACnH,WAAW,IAAI,8BAA8B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;IACxF,cAAc,CAAC,KAAK,EAAE;QAAE,kBAAkB,EAAE,OAAO,CAAA;KAAE,GAAG,8BAA8B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;IACjI,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/storage/authorization-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=authorization-types.js.map

package/dist/storage/authorization-types.js.map

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

package/dist/storage/backlog-types.d.ts

@@ -0,0 +1,21 @@
+import type { AcquireBacklogLeaseInput, AtomicDispatchInput, BacklogItem, CreateBacklogItemInput, DecideBacklogClaimInput, DispatchBacklogItemInput, HeartbeatBacklogLeaseInput, MarkDoneInput, ReclaimBacklogLeaseInput, RefreshBacklogItemInput, ReleaseBacklogLeaseInput, SuggestBacklogClaimInput, UpdateBacklogDispatchProgressInput } from '@openjiuwen/relay-shared';
+export type { AcquireBacklogLeaseInput, AtomicDispatchInput, BacklogItem, CreateBacklogItemInput, DecideBacklogClaimInput, DispatchBacklogItemInput, HeartbeatBacklogLeaseInput, MarkDoneInput, ReclaimBacklogLeaseInput, RefreshBacklogItemInput, ReleaseBacklogLeaseInput, SuggestBacklogClaimInput, UpdateBacklogDispatchProgressInput, };
+export interface IBacklogStore {
+    create(input: CreateBacklogItemInput): BacklogItem | Promise<BacklogItem>;
+    refreshMetadata(itemId: string, input: RefreshBacklogItemInput): BacklogItem | null | Promise<BacklogItem | null>;
+    get(itemId: string, userId?: string): BacklogItem | null | Promise<BacklogItem | null>;
+    listByUser(userId: string): BacklogItem[] | Promise<BacklogItem[]>;
+    suggestClaim(itemId: string, input: SuggestBacklogClaimInput): BacklogItem | null | Promise<BacklogItem | null>;
+    decideClaim(itemId: string, input: DecideBacklogClaimInput): BacklogItem | null | Promise<BacklogItem | null>;
+    updateDispatchProgress(itemId: string, input: UpdateBacklogDispatchProgressInput): BacklogItem | null | Promise<BacklogItem | null>;
+    markDispatched(itemId: string, input: DispatchBacklogItemInput): BacklogItem | null | Promise<BacklogItem | null>;
+    markDone(itemId: string, input: MarkDoneInput): BacklogItem | null | Promise<BacklogItem | null>;
+    acquireLease(itemId: string, input: AcquireBacklogLeaseInput): BacklogItem | null | Promise<BacklogItem | null>;
+    heartbeatLease(itemId: string, input: HeartbeatBacklogLeaseInput): BacklogItem | null | Promise<BacklogItem | null>;
+    releaseLease(itemId: string, input: ReleaseBacklogLeaseInput): BacklogItem | null | Promise<BacklogItem | null>;
+    reclaimExpiredLease(itemId: string, input: ReclaimBacklogLeaseInput): BacklogItem | null | Promise<BacklogItem | null>;
+    tryAcquireDispatchLock?(itemId: string, ttlMs?: number): Promise<string | false>;
+    releaseDispatchLock?(itemId: string, token: string): Promise<void>;
+    atomicDispatch?(itemId: string, input: AtomicDispatchInput): BacklogItem | null | Promise<BacklogItem | null>;
+}
+//# sourceMappingURL=backlog-types.d.ts.map

package/dist/storage/backlog-types.d.ts.map

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

package/dist/storage/backlog-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=backlog-types.js.map

package/dist/storage/backlog-types.js.map

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

package/dist/storage/draft-types.d.ts

@@ -0,0 +1,22 @@
+import type { AgentId, TaskRunPersistExtra } from '@openjiuwen/relay-shared';
+export interface DraftRecord {
+    userId: string;
+    threadId: string;
+    invocationId: string;
+    agentId: AgentId;
+    content: string;
+    toolEvents?: unknown[];
+    thinking?: string;
+    taskRuns?: TaskRunPersistExtra;
+    /** 用户手动停止 — 持久化到 Redis，刷新后仍显示停止态 */
+    userStopped?: boolean;
+    updatedAt: number;
+}
+export interface IDraftStore {
+    upsert(draft: DraftRecord): void | Promise<void>;
+    touch(userId: string, threadId: string, invocationId: string): void | Promise<void>;
+    getByThread(userId: string, threadId: string): DraftRecord[] | Promise<DraftRecord[]>;
+    delete(userId: string, threadId: string, invocationId: string): void | Promise<void>;
+    deleteByThread(userId: string, threadId: string): void | Promise<void>;
+}
+//# sourceMappingURL=draft-types.d.ts.map

package/dist/storage/draft-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-types.d.ts","sourceRoot":"","sources":["../../src/storage/draft-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE7E,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,oCAAoC;IACpC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpF,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACtF,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrF,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE"}

package/dist/storage/draft-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=draft-types.js.map

package/dist/storage/draft-types.js.map

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

package/dist/storage/index.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Storage Plugin API — the contract that third-party storage providers implement.
+ *
+ * Parallel to auth.ts: external packages implement OfficeClawStorageProvider,
+ * export it, and the runtime loads + registers it via env var.
+ *
+ * Design constraints:
+ *   - Provider ID is a runtime string, never an enum/union.
+ *   - Provider creates store instances; the platform passes options (TTL, callbacks).
+ *   - No silent fallback: if a provider fails to create a store, the platform fails fast.
+ */
+import type { IAuthorizationAuditStore, IAuthorizationRuleStore } from './authorization-types.js';
+import type { IApprovalRecordStore } from './authorization-types.js';
+import type { IBacklogStore } from './backlog-types.js';
+import type { IDraftStore } from './draft-types.js';
+import type { IInvocationRecordStore } from './invocation-record-types.js';
+import type { IMemoryStore } from './memory-kv-types.js';
+import type { IMessageStore, StoredMessage } from './message-types.js';
+import type { IPendingRequestStore } from './pending-request-types.js';
+import type { IPushSubscriptionStore } from './push-subscription-types.js';
+import type { IThreadReadStateStore } from './read-state-types.js';
+import type { ISessionChainStore } from './session-chain-types.js';
+import type { ISummaryStore } from './summary-types.js';
+import type { ITaskStore } from './task-types.js';
+import type { IThreadStore } from './thread-types.js';
+import type { IWorkflowSopStore } from './workflow-sop-types.js';
+export interface CreateMessageStoreOptions {
+    onAppend?: (msg: Pick<StoredMessage, 'id' | 'threadId' | 'timestamp' | 'content'>) => void;
+    ttlSeconds?: number;
+}
+export interface CreateThreadStoreOptions {
+    ttlSeconds?: number;
+}
+export interface CreateStoreOptions {
+    ttlSeconds?: number;
+}
+export interface CreateApprovalRecordStoreOptions {
+    storagePath?: string;
+}
+export interface OfficeClawStorageProvider {
+    readonly id: string;
+    readonly displayName?: string;
+    createMessageStore(options?: CreateMessageStoreOptions): IMessageStore | Promise<IMessageStore>;
+    createThreadStore(options?: CreateThreadStoreOptions): IThreadStore | Promise<IThreadStore>;
+    createTaskStore(options?: CreateStoreOptions): ITaskStore | Promise<ITaskStore>;
+    createBacklogStore(options?: CreateStoreOptions): IBacklogStore | Promise<IBacklogStore>;
+    createSummaryStore(options?: CreateStoreOptions): ISummaryStore | Promise<ISummaryStore>;
+    createMemoryStore(options?: CreateStoreOptions): IMemoryStore | Promise<IMemoryStore>;
+    createDraftStore(options?: CreateStoreOptions): IDraftStore | Promise<IDraftStore>;
+    createSessionChainStore(options?: CreateStoreOptions): ISessionChainStore | Promise<ISessionChainStore>;
+    createInvocationRecordStore(options?: CreateStoreOptions): IInvocationRecordStore | Promise<IInvocationRecordStore>;
+    createPendingRequestStore(options?: CreateStoreOptions): IPendingRequestStore | Promise<IPendingRequestStore>;
+    createAuthorizationRuleStore(options?: CreateStoreOptions): IAuthorizationRuleStore | Promise<IAuthorizationRuleStore>;
+    createAuthorizationAuditStore(options?: CreateStoreOptions): IAuthorizationAuditStore | Promise<IAuthorizationAuditStore>;
+    createApprovalRecordStore?(options?: CreateApprovalRecordStoreOptions): IApprovalRecordStore | Promise<IApprovalRecordStore>;
+    createPushSubscriptionStore(options?: CreateStoreOptions): IPushSubscriptionStore | Promise<IPushSubscriptionStore>;
+    createReadStateStore(options?: CreateStoreOptions): IThreadReadStateStore | Promise<IThreadReadStateStore>;
+    createWorkflowSopStore(options?: CreateStoreOptions): IWorkflowSopStore | Promise<IWorkflowSopStore>;
+    bootstrap?(): Promise<void>;
+    shutdown?(): Promise<void>;
+}
+export type { ApprovalDecision, ApprovalRecordInput, ApprovalScope, ApprovalSource, CreateAuditInput, IAuthorizationAuditStore, IAuthorizationRuleStore, IApprovalRecordStore, ListApprovalRecordsQuery, SecurityApprovalRecord, SecurityApprovalRecordSettings, SecurityApprovalRecordsResponse, } from './authorization-types.js';
+export type { IBacklogStore } from './backlog-types.js';
+export type { DraftRecord, IDraftStore } from './draft-types.js';
+export type { CreateInvocationInput, CreateResult, IInvocationRecordStore, InvocationRecord, InvocationStatus, UpdateInvocationInput, } from './invocation-record-types.js';
+export type { IMemoryStore } from './memory-kv-types.js';
+export { MAX_KEYS_PER_THREAD } from './memory-kv-types.js';
+export type { AppendMessageInput, IMessageStore, MessageMetadata, StoredMessage, StoredToolEvent, TokenUsage, } from './message-types.js';
+export type { CreatePendingInput, IPendingRequestStore } from './pending-request-types.js';
+export type { IPushSubscriptionStore, PushSubscriptionRecord } from './push-subscription-types.js';
+export type { IThreadReadStateStore, ThreadReadState, ThreadUnreadSummary } from './read-state-types.js';
+export type { CreateSessionInput, ISessionChainStore, SessionRecordPatch } from './session-chain-types.js';
+export type { ISummaryStore } from './summary-types.js';
+export type { ITaskStore } from './task-types.js';
+export type { BootcampPhase, BootcampStateV1, ConnectorHubStateV1, IThreadStore, MentionActionabilityMode, MentionRoutingSuppressionReason, Thread, ThreadMemoryV1, ThreadMentionRoutingFeedback, ThreadMentionRoutingFeedbackItem, ThreadParticipantActivity, ThreadRoutingPolicyV1, ThreadRoutingRule, ThreadRoutingScope, VotingStateV1, } from './thread-types.js';
+export { DEFAULT_THREAD_ID } from './thread-types.js';
+export type { IWorkflowSopStore } from './workflow-sop-types.js';
+export { VersionConflictError } from './workflow-sop-types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAClG,OAAO,KAAK,EAKV,oBAAoB,EAKrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAMjE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC,KAAK,IAAI,CAAC;IAC3F,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gCAAgC;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,kBAAkB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAChG,iBAAiB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5F,eAAe,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAChF,kBAAkB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACzF,kBAAkB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACzF,iBAAiB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACtF,gBAAgB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACnF,uBAAuB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACxG,2BAA2B,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACpH,yBAAyB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC9G,4BAA4B,CAC1B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC9D,6BAA6B,CAC3B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,wBAAwB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAChE,yBAAyB,CAAC,CACxB,OAAO,CAAC,EAAE,gCAAgC,GACzC,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACxD,2BAA2B,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACpH,oBAAoB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC3G,sBAAsB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAErG,SAAS,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAMD,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,8BAA8B,EAC9B,+BAA+B,GAChC,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACjE,YAAY,EACV,qBAAqB,EACrB,YAAY,EACZ,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,aAAa,EACb,eAAe,EACf,UAAU,GACX,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAC3F,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACnG,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACzG,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC3G,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EACV,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,wBAAwB,EACxB,+BAA+B,EAC/B,MAAM,EACN,cAAc,EACd,4BAA4B,EAC5B,gCAAgC,EAChC,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/storage/index.js

@@ -0,0 +1,15 @@
+/**
+ * Storage Plugin API — the contract that third-party storage providers implement.
+ *
+ * Parallel to auth.ts: external packages implement OfficeClawStorageProvider,
+ * export it, and the runtime loads + registers it via env var.
+ *
+ * Design constraints:
+ *   - Provider ID is a runtime string, never an enum/union.
+ *   - Provider creates store instances; the platform passes options (TTL, callbacks).
+ *   - No silent fallback: if a provider fails to create a store, the platform fails fast.
+ */
+export { MAX_KEYS_PER_THREAD } from './memory-kv-types.js';
+export { DEFAULT_THREAD_ID } from './thread-types.js';
+export { VersionConflictError } from './workflow-sop-types.js';
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiHH,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAgC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/storage/invocation-record-types.d.ts

@@ -0,0 +1,44 @@
+import type { AgentId } from '@openjiuwen/relay-shared';
+import type { TokenUsage } from './message-types.js';
+export type InvocationStatus = 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled';
+export interface InvocationRecord {
+    id: string;
+    threadId: string;
+    userId: string;
+    userMessageId: string | null;
+    targetAgents: AgentId[];
+    intent: 'execute' | 'ideate';
+    status: InvocationStatus;
+    idempotencyKey: string;
+    error?: string;
+    usageByCat?: Record<string, TokenUsage>;
+    usageRecordedAt?: number;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface CreateInvocationInput {
+    threadId: string;
+    userId: string;
+    targetAgents: AgentId[];
+    intent: 'execute' | 'ideate';
+    idempotencyKey: string;
+}
+export interface CreateResult {
+    outcome: 'created' | 'duplicate';
+    invocationId: string;
+}
+export interface UpdateInvocationInput {
+    status?: InvocationStatus;
+    userMessageId?: string | null;
+    error?: string;
+    expectedStatus?: InvocationStatus;
+    usageByCat?: Record<string, TokenUsage>;
+}
+export interface IInvocationRecordStore {
+    create(input: CreateInvocationInput): CreateResult | Promise<CreateResult>;
+    get(id: string): InvocationRecord | null | Promise<InvocationRecord | null>;
+    update(id: string, input: UpdateInvocationInput): InvocationRecord | null | Promise<InvocationRecord | null>;
+    getByIdempotencyKey(threadId: string, userId: string, key: string): InvocationRecord | null | Promise<InvocationRecord | null>;
+    scanAll?(): Promise<InvocationRecord[]>;
+}
+//# sourceMappingURL=invocation-record-types.d.ts.map

package/dist/storage/invocation-record-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation-record-types.d.ts","sourceRoot":"","sources":["../../src/storage/invocation-record-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE1F,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,OAAO,EAAE,CAAC;IACxB,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,MAAM,EAAE,gBAAgB,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,OAAO,EAAE,CAAC;IACxB,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,SAAS,GAAG,WAAW,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,KAAK,EAAE,qBAAqB,GAAG,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3E,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC5E,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC7G,mBAAmB,CACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC9D,OAAO,CAAC,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;CACzC"}

package/dist/storage/invocation-record-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=invocation-record-types.js.map

package/dist/storage/invocation-record-types.js.map

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

package/dist/storage/memory-kv-types.d.ts

@@ -0,0 +1,11 @@
+import type { MemoryEntry, MemoryInput } from '@openjiuwen/relay-shared';
+export type { MemoryEntry, MemoryInput };
+export declare const MAX_KEYS_PER_THREAD = 50;
+export interface IMemoryStore {
+    set(input: MemoryInput): MemoryEntry | Promise<MemoryEntry>;
+    get(threadId: string, key: string): MemoryEntry | null | Promise<MemoryEntry | null>;
+    list(threadId: string): MemoryEntry[] | Promise<MemoryEntry[]>;
+    delete(threadId: string, key: string): boolean | Promise<boolean>;
+    deleteThread(threadId: string): number | Promise<number>;
+}
+//# sourceMappingURL=memory-kv-types.d.ts.map

package/dist/storage/memory-kv-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-kv-types.d.ts","sourceRoot":"","sources":["../../src/storage/memory-kv-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEzE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AAEzC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5D,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACrF,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/D,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1D"}

package/dist/storage/memory-kv-types.js

@@ -0,0 +1,2 @@
+export const MAX_KEYS_PER_THREAD = 50;
+//# sourceMappingURL=memory-kv-types.js.map

package/dist/storage/memory-kv-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-kv-types.js","sourceRoot":"","sources":["../../src/storage/memory-kv-types.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC"}