@jungjaehoon/mama-os 0.53.0 → 0.57.0

package/dist/connectors/framework/connector-event-types.d.ts

@@ -0,0 +1,136 @@
+import type { Buffer } from 'node:buffer';
+import type { MemoryScopeRef } from '@jungjaehoon/mama-core/memory/types';
+export interface ConnectorEventIndexRecord {
+    event_index_id: string;
+    source_connector: string;
+    source_type: string;
+    source_id: string;
+    source_locator: string | null;
+    channel: string | null;
+    author: string | null;
+    title: string | null;
+    content: string;
+    event_datetime: number | null;
+    event_date: string | null;
+    source_timestamp_ms: number;
+    source_cursor: string | null;
+    tenant_id: string | null;
+    project_id: string | null;
+    memory_scope_kind: string | null;
+    memory_scope_id: string | null;
+    metadata_json: string | null;
+    artifact_locator: string | null;
+    artifact_title: string | null;
+    content_hash: Buffer;
+    operator_ingest_seq: number;
+    operator_observation_seq: number;
+    indexed_at: string;
+    updated_at: string;
+    expires_at: string | null;
+    current_observation_id: string | null;
+}
+export interface UpsertConnectorEventIndexInput {
+    source_connector: string;
+    source_type: string;
+    source_id: string;
+    /** Stable upstream entity across revisions; enables grant-bounded change-history reads. */
+    source_entity_id?: string | null;
+    source_locator?: string | null;
+    channel?: string | null;
+    author?: string | null;
+    title?: string | null;
+    content: string;
+    /** Immutable observation companion. Direct writers default to inline body. */
+    observation?: {
+        producer_version_id?: string | null;
+        body_location?: {
+            kind: 'raw';
+            connectorName: string;
+            revisionSourceId: string;
+        };
+        observed_at: number;
+        source_at?: number | null;
+    };
+    event_datetime?: number | null;
+    event_date?: string | null;
+    source_timestamp_ms?: number | null;
+    source_cursor?: string | null;
+    tenant_id?: string | null;
+    project_id?: string | null;
+    memory_scope_kind?: string | null;
+    memory_scope_id?: string | null;
+    metadata_json?: string | null;
+    metadata?: unknown;
+    artifact_locator?: string | null;
+    artifact_title?: string | null;
+    content_hash?: Buffer | Uint8Array | null;
+    indexed_at?: string;
+    updated_at?: string;
+    expires_at?: string | null;
+}
+export interface ConnectorEventIndexCursorRecord {
+    connector_name: string;
+    last_seen_timestamp_ms: number;
+    last_seen_source_id: string;
+    last_sweep_at: string | null;
+    last_success_at: string | null;
+    last_error: string | null;
+    last_error_at: string | null;
+    indexed_count: number;
+}
+export interface UpsertConnectorEventIndexCursorInput {
+    connector_name: string;
+    last_seen_timestamp_ms?: number;
+    last_seen_source_id?: string;
+    last_sweep_at?: string | null;
+    last_success_at?: string | null;
+    last_error?: string | null;
+    last_error_at?: string | null;
+    indexed_count?: number;
+}
+export interface ConnectorEventSearchHit extends ConnectorEventIndexRecord {
+    rank: number;
+    score: number;
+}
+export interface RawSearchScopeFilter {
+    kind: MemoryScopeRef['kind'];
+    id: string;
+}
+export interface RawSearchInput {
+    query: string;
+    connectors?: string[];
+    channels?: string[];
+    scopes?: RawSearchScopeFilter[];
+    fromMs?: number;
+    toMs?: number;
+    cursor?: string;
+    limit?: number;
+    /** Inclusive source/event-time ceiling for replay reads. */
+    maxSourceMs?: number | null;
+}
+export interface RawSearchHit {
+    raw_id: string;
+    connector: string;
+    source_id: string;
+    channel_id: string | null;
+    author_label: string | null;
+    created_at: string | null;
+    /** Source/event occurrence time, distinct from host capture time. */
+    source_at: string | null;
+    /** Current immutable observation capture time; null only for a valid legacy row. */
+    observed_at: string | null;
+    content_preview: string;
+    score: number;
+    source_ref: string | null;
+    metadata: Record<string, unknown>;
+}
+/** Explicit detail access includes the complete source; search results remain bounded previews. */
+export interface RawDocument extends RawSearchHit {
+    content: string;
+}
+export interface RawSearchResult {
+    hits: RawSearchHit[];
+    next_cursor: string | null;
+}
+export type ConnectorEventStalenessStatus = 'healthy' | 'stale-but-warming' | 'warn' | 'unhealthy' | 'never_swept';
+//# sourceMappingURL=connector-event-types.d.ts.map

package/dist/connectors/framework/connector-event-types.d.ts.map

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

package/dist/connectors/framework/connector-event-types.js

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

package/dist/connectors/framework/connector-event-types.js.map

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

package/dist/connectors/framework/connector-state.d.ts

@@ -0,0 +1,3 @@
+export declare function readConnectorState<T>(path: string, decode: (value: unknown) => T): T | undefined;
+export declare function writeConnectorState(path: string, value: unknown): void;
+//# sourceMappingURL=connector-state.d.ts.map

package/dist/connectors/framework/connector-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-state.d.ts","sourceRoot":"","sources":["../../../src/connectors/framework/connector-state.ts"],"names":[],"mappings":"AAaA,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAgBhG;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAiBtE"}

package/dist/connectors/framework/connector-state.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readConnectorState = readConnectorState;
+exports.writeConnectorState = writeConnectorState;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+function readConnectorState(path, decode) {
+    let source;
+    try {
+        source = (0, node_fs_1.readFileSync)(path, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return undefined;
+        throw new Error(`Unable to read connector state ${(0, node_path_1.basename)(path)}`, { cause: error });
+    }
+    let value;
+    try {
+        value = JSON.parse(source);
+    }
+    catch (error) {
+        throw new Error(`Connector state ${(0, node_path_1.basename)(path)} contains malformed JSON`, { cause: error });
+    }
+    return decode(value);
+}
+function writeConnectorState(path, value) {
+    const directory = (0, node_path_1.dirname)(path);
+    (0, node_fs_1.mkdirSync)(directory, { recursive: true, mode: 0o700 });
+    const temporaryPath = `${path}.${process.pid}.${(0, node_crypto_1.randomUUID)()}.tmp`;
+    let descriptor;
+    try {
+        descriptor = (0, node_fs_1.openSync)(temporaryPath, 'wx', 0o600);
+        (0, node_fs_1.writeFileSync)(descriptor, `${JSON.stringify(value)}\n`, 'utf8');
+        (0, node_fs_1.fsyncSync)(descriptor);
+        (0, node_fs_1.closeSync)(descriptor);
+        descriptor = undefined;
+        (0, node_fs_1.renameSync)(temporaryPath, path);
+    }
+    catch (error) {
+        if (descriptor !== undefined)
+            (0, node_fs_1.closeSync)(descriptor);
+        (0, node_fs_1.rmSync)(temporaryPath, { force: true });
+        throw error;
+    }
+}
+//# sourceMappingURL=connector-state.js.map

package/dist/connectors/framework/connector-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-state.js","sourceRoot":"","sources":["../../../src/connectors/framework/connector-state.ts"],"names":[],"mappings":";;AAaA,gDAgBC;AAED,kDAiBC;AAhDD,6CAAyC;AACzC,qCASiB;AACjB,yCAA8C;AAE9C,SAAgB,kBAAkB,CAAI,IAAY,EAAE,MAA6B;IAC/E,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAA,sBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAA,oBAAQ,EAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACxF,CAAC;IAED,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAY,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAA,oBAAQ,EAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,SAAgB,mBAAmB,CAAC,IAAY,EAAE,KAAc;IAC9D,MAAM,SAAS,GAAG,IAAA,mBAAO,EAAC,IAAI,CAAC,CAAC;IAChC,IAAA,mBAAS,EAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACvD,MAAM,aAAa,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,IAAA,wBAAU,GAAE,MAAM,CAAC;IACnE,IAAI,UAA8B,CAAC;IACnC,IAAI,CAAC;QACH,UAAU,GAAG,IAAA,kBAAQ,EAAC,aAAa,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QAClD,IAAA,uBAAa,EAAC,UAAU,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAChE,IAAA,mBAAS,EAAC,UAAU,CAAC,CAAC;QACtB,IAAA,mBAAS,EAAC,UAAU,CAAC,CAAC;QACtB,UAAU,GAAG,SAAS,CAAC;QACvB,IAAA,oBAAU,EAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,UAAU,KAAK,SAAS;YAAE,IAAA,mBAAS,EAAC,UAAU,CAAC,CAAC;QACpD,IAAA,gBAAM,EAAC,aAAa,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/connectors/framework/event-index.d.ts

@@ -0,0 +1,28 @@
+import type { DatabaseAdapter } from '@jungjaehoon/mama-core/db-manager';
+import type { ConnectorEventIndexCursorRecord, ConnectorEventIndexRecord, UpsertConnectorEventIndexInput } from './connector-event-types.js';
+type ConnectorEventIndexAdapter = Pick<DatabaseAdapter, 'prepare' | 'transaction'>;
+interface DeleteExpiredConnectorEventsInput {
+    nowMs: number;
+    retentionMs: number;
+    connectorName?: string;
+}
+export declare function mapConnectorEventIndexRecord(row: Record<string, unknown>): ConnectorEventIndexRecord;
+export declare function connectorEventIndexId(sourceConnector: string, sourceId: string): string;
+export declare function connectorEventContentHash(input: {
+    source_connector: string;
+    source_id: string;
+    content: string;
+    event_datetime?: number | null;
+}): Buffer;
+export declare function upsertConnectorEventIndex(adapter: ConnectorEventIndexAdapter, input: UpsertConnectorEventIndexInput): ConnectorEventIndexRecord;
+export declare function getConnectorEventIndexRecord(adapter: ConnectorEventIndexAdapter, sourceConnector: string, sourceId: string): ConnectorEventIndexRecord | null;
+export declare function readConnectorCursor(adapter: ConnectorEventIndexAdapter, connectorName: string): ConnectorEventIndexCursorRecord | null;
+export declare function recordConnectorPollOutcome(adapter: ConnectorEventIndexAdapter, connectorName: string, outcome: {
+    at: number;
+    error?: string;
+}): void;
+export declare function deleteExpiredConnectorEvents(adapter: ConnectorEventIndexAdapter, input: DeleteExpiredConnectorEventsInput): {
+    rows_deleted: number;
+};
+export type { ConnectorEventIndexCursorRecord, ConnectorEventIndexRecord, ConnectorEventSearchHit, ConnectorEventStalenessStatus, UpsertConnectorEventIndexCursorInput, UpsertConnectorEventIndexInput, } from './connector-event-types.js';
+//# sourceMappingURL=event-index.d.ts.map

package/dist/connectors/framework/event-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-index.d.ts","sourceRoot":"","sources":["../../../src/connectors/framework/event-index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EACV,+BAA+B,EAC/B,yBAAyB,EACzB,8BAA8B,EAC/B,MAAM,4BAA4B,CAAC;AAGpC,KAAK,0BAA0B,GAAG,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,aAAa,CAAC,CAAC;AAEnF,UAAU,iCAAiC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA+FD,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,yBAAyB,CAE3B;AAeD,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGvF;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,GAAG,MAAM,CAYT;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,0BAA0B,EACnC,KAAK,EAAE,8BAA8B,GACpC,yBAAyB,CA8L3B;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,0BAA0B,EACnC,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,GACf,yBAAyB,GAAG,IAAI,CA0BlC;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,0BAA0B,EACnC,aAAa,EAAE,MAAM,GACpB,+BAA+B,GAAG,IAAI,CAaxC;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,0BAA0B,EACnC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACtC,IAAI,CA6BN;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,0BAA0B,EACnC,KAAK,EAAE,iCAAiC,GACvC;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,CAmC1B;AAED,YAAY,EACV,+BAA+B,EAC/B,yBAAyB,EACzB,uBAAuB,EACvB,6BAA6B,EAC7B,oCAAoC,EACpC,8BAA8B,GAC/B,MAAM,4BAA4B,CAAC"}

package/dist/connectors/framework/event-index.js

@@ -0,0 +1,354 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapConnectorEventIndexRecord = mapConnectorEventIndexRecord;
+exports.connectorEventIndexId = connectorEventIndexId;
+exports.connectorEventContentHash = connectorEventContentHash;
+exports.upsertConnectorEventIndex = upsertConnectorEventIndex;
+exports.getConnectorEventIndexRecord = getConnectorEventIndexRecord;
+exports.readConnectorCursor = readConnectorCursor;
+exports.recordConnectorPollOutcome = recordConnectorPollOutcome;
+exports.deleteExpiredConnectorEvents = deleteExpiredConnectorEvents;
+const node_crypto_1 = require("node:crypto");
+const canonicalize_1 = require("@jungjaehoon/mama-core/canonicalize");
+const knowledge_1 = require("@jungjaehoon/mama-core/knowledge");
+function nowIso() {
+    return new Date().toISOString();
+}
+function eventDateFromMs(ms) {
+    if (ms === null || !Number.isFinite(ms)) {
+        return null;
+    }
+    return new Date(ms).toISOString().slice(0, 10);
+}
+function normalizeTimestampMs(input) {
+    const timestamp = input.source_timestamp_ms ?? input.event_datetime;
+    if (typeof timestamp !== 'number' || !Number.isFinite(timestamp)) {
+        throw new Error('connector_event_index.source_timestamp_ms must be a finite number.');
+    }
+    return Math.floor(timestamp);
+}
+function normalizeEventDatetime(input) {
+    if (input.event_datetime === null || input.event_datetime === undefined) {
+        return normalizeTimestampMs(input);
+    }
+    if (!Number.isFinite(input.event_datetime)) {
+        throw new Error('connector_event_index.event_datetime must be a finite number when provided.');
+    }
+    return Math.floor(input.event_datetime);
+}
+function normalizeMetadataJson(input) {
+    if (input.metadata_json !== undefined) {
+        return input.metadata_json;
+    }
+    if (input.metadata === undefined || input.metadata === null) {
+        return null;
+    }
+    return (0, canonicalize_1.canonicalizeJSON)(input.metadata);
+}
+function toBuffer(value) {
+    if (Buffer.isBuffer(value)) {
+        return value;
+    }
+    if (value instanceof Uint8Array) {
+        return Buffer.from(value);
+    }
+    throw new Error('connector_event_index.content_hash must be a 32-byte Buffer.');
+}
+function mapConnectorEventIndexRow(row) {
+    if (!Object.prototype.hasOwnProperty.call(row, 'current_observation_id')) {
+        throw new Error('connector_event_index.current_observation_id schema is required');
+    }
+    if (row.current_observation_id !== null &&
+        (typeof row.current_observation_id !== 'string' || row.current_observation_id.trim() === '')) {
+        throw new Error('connector_event_index.current_observation_id must be nonblank text or null');
+    }
+    return {
+        event_index_id: String(row.event_index_id),
+        source_connector: String(row.source_connector),
+        source_type: String(row.source_type),
+        source_id: String(row.source_id),
+        source_locator: row.source_locator === null ? null : String(row.source_locator),
+        channel: row.channel === null ? null : String(row.channel),
+        author: row.author === null ? null : String(row.author),
+        title: row.title === null ? null : String(row.title),
+        content: String(row.content),
+        event_datetime: typeof row.event_datetime === 'number' && Number.isFinite(row.event_datetime)
+            ? row.event_datetime
+            : null,
+        event_date: row.event_date === null ? null : String(row.event_date),
+        source_timestamp_ms: Number(row.source_timestamp_ms),
+        source_cursor: row.source_cursor === null ? null : String(row.source_cursor),
+        tenant_id: row.tenant_id === null ? null : String(row.tenant_id),
+        project_id: row.project_id === null ? null : String(row.project_id),
+        memory_scope_kind: row.memory_scope_kind === null ? null : String(row.memory_scope_kind),
+        memory_scope_id: row.memory_scope_id === null ? null : String(row.memory_scope_id),
+        metadata_json: row.metadata_json === null ? null : String(row.metadata_json),
+        artifact_locator: row.artifact_locator === null ? null : String(row.artifact_locator),
+        artifact_title: row.artifact_title === null ? null : String(row.artifact_title),
+        content_hash: toBuffer(row.content_hash),
+        operator_ingest_seq: Number(row.operator_ingest_seq),
+        operator_observation_seq: Number(row.operator_observation_seq),
+        indexed_at: String(row.indexed_at),
+        updated_at: String(row.updated_at),
+        expires_at: row.expires_at === null ? null : String(row.expires_at),
+        current_observation_id: row.current_observation_id,
+    };
+}
+function mapConnectorEventIndexRecord(row) {
+    return mapConnectorEventIndexRow(row);
+}
+function mapConnectorCursorRow(row) {
+    return {
+        connector_name: String(row.connector_name),
+        last_seen_timestamp_ms: Number(row.last_seen_timestamp_ms),
+        last_seen_source_id: String(row.last_seen_source_id),
+        last_sweep_at: row.last_sweep_at === null ? null : String(row.last_sweep_at),
+        last_success_at: row.last_success_at === null ? null : String(row.last_success_at),
+        last_error: row.last_error === null ? null : String(row.last_error),
+        last_error_at: row.last_error_at === null ? null : String(row.last_error_at),
+        indexed_count: Number(row.indexed_count),
+    };
+}
+function connectorEventIndexId(sourceConnector, sourceId) {
+    const digest = (0, node_crypto_1.createHash)('sha1').update(`${sourceConnector}\0${sourceId}`, 'utf8').digest('hex');
+    return `evt_${digest.slice(0, 16)}`;
+}
+function connectorEventContentHash(input) {
+    return (0, node_crypto_1.createHash)('sha256')
+        .update((0, canonicalize_1.canonicalizeJSON)({
+        source_connector: input.source_connector,
+        source_id: input.source_id,
+        content: input.content,
+        event_datetime: input.event_datetime ?? null,
+    }), 'utf8')
+        .digest();
+}
+function upsertConnectorEventIndex(adapter, input) {
+    const sourceTimestampMs = normalizeTimestampMs(input);
+    const eventDatetime = normalizeEventDatetime(input);
+    const eventDate = input.event_date ?? eventDateFromMs(eventDatetime);
+    const timestamp = input.updated_at ?? nowIso();
+    let capturedAt = input.observation?.observed_at ?? Date.now();
+    const eventIndexId = connectorEventIndexId(input.source_connector, input.source_id);
+    const contentHash = input.content_hash
+        ? Buffer.from(input.content_hash)
+        : connectorEventContentHash({
+            source_connector: input.source_connector,
+            source_id: input.source_id,
+            content: input.content,
+            event_datetime: eventDatetime,
+        });
+    if (contentHash.byteLength !== 32) {
+        throw new Error('connector_event_index.content_hash must be exactly 32 bytes.');
+    }
+    const metadataJson = normalizeMetadataJson(input);
+    return adapter.transaction(() => {
+        let producerVersionId = input.observation?.producer_version_id ?? null;
+        if (producerVersionId === null) {
+            const current = adapter
+                .prepare(`SELECT o.producer_version_id, o.content_hash, o.author, o.source_at, o.observed_at,
+                  o.metadata_json, o.scope_json
+             FROM connector_event_index e
+             JOIN observation_versions o ON o.observation_id = e.current_observation_id
+            WHERE e.source_connector = ? AND e.source_id = ? LIMIT 1`)
+                .get(input.source_connector, input.source_id);
+            const incomingScope = (0, canonicalize_1.canonicalizeJSON)({
+                channel: input.channel ?? null,
+                tenantId: input.tenant_id ?? null,
+                projectId: input.project_id ?? null,
+                memoryScopeKind: input.memory_scope_kind ?? null,
+                memoryScopeId: input.memory_scope_id ?? null,
+            });
+            const incomingSourceAt = input.observation && input.observation.source_at !== undefined
+                ? input.observation.source_at
+                : eventDatetime;
+            const sameCurrent = current?.content_hash === contentHash.toString('hex') &&
+                current.author === (input.author ?? null) &&
+                current.source_at === incomingSourceAt &&
+                current.metadata_json ===
+                    (0, canonicalize_1.canonicalizeJSON)(input.metadata ?? (metadataJson ? JSON.parse(metadataJson) : {})) &&
+                current.scope_json === incomingScope;
+            if (sameCurrent && current.producer_version_id) {
+                producerVersionId = current.producer_version_id;
+                if (input.observation === undefined) {
+                    capturedAt = current.observed_at;
+                }
+            }
+            else {
+                const count = adapter
+                    .prepare('SELECT COUNT(*) AS count FROM observation_versions WHERE source = ? AND source_id = ?')
+                    .get(input.source_connector, input.source_id);
+                producerVersionId = `capture:${eventIndexId}:${count.count + 1}`;
+            }
+        }
+        const observation = (0, knowledge_1.appendObservationVersion)(adapter, {
+            source: input.source_connector,
+            sourceId: input.source_id,
+            producerVersionId,
+            ...(input.observation?.body_location
+                ? { bodyLocation: input.observation.body_location }
+                : { body: input.content }),
+            author: input.author ?? null,
+            sourceAt: input.observation && input.observation.source_at !== undefined
+                ? input.observation.source_at
+                : eventDatetime,
+            observedAt: capturedAt,
+            contentHash: contentHash.toString('hex'),
+            metadata: input.metadata ?? (metadataJson ? JSON.parse(metadataJson) : {}),
+            scope: {
+                channel: input.channel ?? null,
+                tenantId: input.tenant_id ?? null,
+                projectId: input.project_id ?? null,
+                memoryScopeKind: input.memory_scope_kind ?? null,
+                memoryScopeId: input.memory_scope_id ?? null,
+            },
+        });
+        adapter
+            .prepare(`
+          INSERT INTO connector_event_index (
+            event_index_id, source_connector, source_type, source_id, source_entity_id,
+            source_locator, channel, author, title, content, event_datetime, event_date,
+            source_timestamp_ms, source_cursor, tenant_id, project_id, memory_scope_kind,
+            memory_scope_id, metadata_json, artifact_locator, artifact_title, content_hash,
+            indexed_at, updated_at, expires_at, current_observation_id
+          )
+          VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+          ON CONFLICT(source_connector, source_id) DO UPDATE SET
+            source_type = excluded.source_type,
+            source_entity_id = excluded.source_entity_id,
+            source_locator = excluded.source_locator,
+            channel = excluded.channel,
+            author = excluded.author,
+            title = excluded.title,
+            content = excluded.content,
+            event_datetime = excluded.event_datetime,
+            event_date = excluded.event_date,
+            source_timestamp_ms = excluded.source_timestamp_ms,
+            source_cursor = excluded.source_cursor,
+            tenant_id = excluded.tenant_id,
+            project_id = excluded.project_id,
+            memory_scope_kind = excluded.memory_scope_kind,
+            memory_scope_id = excluded.memory_scope_id,
+            metadata_json = excluded.metadata_json,
+            artifact_locator = excluded.artifact_locator,
+            artifact_title = excluded.artifact_title,
+            content_hash = excluded.content_hash,
+            updated_at = excluded.updated_at,
+            expires_at = excluded.expires_at,
+            current_observation_id = excluded.current_observation_id,
+            operator_ingest_seq = CASE
+              WHEN connector_event_index.content_hash IS NOT excluded.content_hash
+                OR connector_event_index.metadata_json IS NOT excluded.metadata_json
+                OR connector_event_index.source_timestamp_ms IS NOT excluded.source_timestamp_ms
+                OR connector_event_index.source_type IS NOT excluded.source_type
+                OR connector_event_index.channel IS NOT excluded.channel
+              THEN NULL
+              ELSE connector_event_index.operator_ingest_seq
+            END,
+            operator_observation_seq = CASE
+              WHEN connector_event_index.content_hash IS NOT excluded.content_hash
+                OR connector_event_index.metadata_json IS NOT excluded.metadata_json
+                OR connector_event_index.source_timestamp_ms IS NOT excluded.source_timestamp_ms
+                OR connector_event_index.source_type IS NOT excluded.source_type
+                OR connector_event_index.channel IS NOT excluded.channel
+              THEN NULL
+              ELSE connector_event_index.operator_observation_seq
+            END
+        `)
+            .run(eventIndexId, input.source_connector, input.source_type, input.source_id, input.source_entity_id ?? input.source_id, input.source_locator ?? null, input.channel ?? null, input.author ?? null, input.title ?? null, input.content, eventDatetime, eventDate, sourceTimestampMs, input.source_cursor ?? null, input.tenant_id ?? null, input.project_id ?? null, input.memory_scope_kind ?? null, input.memory_scope_id ?? null, metadataJson, input.artifact_locator ?? null, input.artifact_title ?? null, contentHash, input.indexed_at ?? timestamp, timestamp, input.expires_at ?? null, observation.observationId);
+        const saved = getConnectorEventIndexRecord(adapter, input.source_connector, input.source_id);
+        if (!saved) {
+            throw new Error(`Failed to read connector_event_index row after upsert: ${input.source_connector}/${input.source_id}`);
+        }
+        return saved;
+    });
+}
+function getConnectorEventIndexRecord(adapter, sourceConnector, sourceId) {
+    const row = adapter
+        .prepare(`
+        SELECT *
+        FROM connector_event_index
+        WHERE source_connector = ?
+          AND source_id = ?
+        LIMIT 1
+      `)
+        .get(sourceConnector, sourceId);
+    if (!row) {
+        return null;
+    }
+    const record = mapConnectorEventIndexRow(row);
+    if (record.current_observation_id !== null &&
+        !adapter
+            .prepare('SELECT 1 FROM observation_versions WHERE observation_id = ?')
+            .get(record.current_observation_id)) {
+        throw new Error('connector_event_index contains an inconsistent current observation ref');
+    }
+    return record;
+}
+function readConnectorCursor(adapter, connectorName) {
+    const row = adapter
+        .prepare(`
+        SELECT *
+        FROM connector_event_index_cursors
+        WHERE connector_name = ?
+        LIMIT 1
+      `)
+        .get(connectorName);
+    return row ? mapConnectorCursorRow(row) : null;
+}
+function recordConnectorPollOutcome(adapter, connectorName, outcome) {
+    if (!Number.isSafeInteger(outcome.at) || outcome.at < 0) {
+        throw new Error('Connector poll outcome time must be a non-negative epoch-millisecond integer');
+    }
+    const at = new Date(outcome.at).toISOString();
+    adapter.transaction(() => {
+        if (outcome.error === undefined) {
+            adapter
+                .prepare(`INSERT INTO connector_event_index_cursors (connector_name, last_success_at, last_error, last_error_at)
+         VALUES (?, ?, NULL, NULL)
+         ON CONFLICT(connector_name) DO UPDATE SET
+           last_success_at = excluded.last_success_at,
+           last_error = NULL,
+           last_error_at = NULL`)
+                .run(connectorName, at);
+        }
+        else {
+            adapter
+                .prepare(`INSERT INTO connector_event_index_cursors (connector_name, last_error, last_error_at)
+         VALUES (?, ?, ?)
+         ON CONFLICT(connector_name) DO UPDATE SET
+           last_error = excluded.last_error,
+           last_error_at = excluded.last_error_at`)
+                .run(connectorName, outcome.error, at);
+        }
+    });
+}
+function deleteExpiredConnectorEvents(adapter, input) {
+    if (!Number.isFinite(input.nowMs)) {
+        throw new Error('deleteExpiredConnectorEvents.nowMs must be a finite number.');
+    }
+    if (!Number.isFinite(input.retentionMs) || input.retentionMs < 0) {
+        throw new Error('deleteExpiredConnectorEvents.retentionMs must be a non-negative finite number.');
+    }
+    const cutoffMs = input.nowMs - input.retentionMs;
+    const result = input.connectorName
+        ? adapter
+            .prepare(`
+            DELETE FROM connector_event_index
+            WHERE source_connector = ?
+              AND event_datetime IS NOT NULL
+              AND event_datetime < ?
+              AND artifact_locator IS NULL
+          `)
+            .run(input.connectorName, cutoffMs)
+        : adapter
+            .prepare(`
+            DELETE FROM connector_event_index
+            WHERE event_datetime IS NOT NULL
+              AND event_datetime < ?
+              AND artifact_locator IS NULL
+          `)
+            .run(cutoffMs);
+    return { rows_deleted: result.changes };
+}
+//# sourceMappingURL=event-index.js.map

package/dist/connectors/framework/event-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-index.js","sourceRoot":"","sources":["../../../src/connectors/framework/event-index.ts"],"names":[],"mappings":";;AAgHA,oEAIC;AAeD,sDAGC;AAED,8DAiBC;AAED,8DAiMC;AAED,oEA8BC;AAED,kDAgBC;AAED,gEAiCC;AAED,oEAsCC;AAzdD,6CAAyC;AAEzC,sEAAuE;AAOvE,gEAA4E;AAU5E,SAAS,MAAM;IACb,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,eAAe,CAAC,EAAiB;IACxC,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAqC;IACjE,MAAM,SAAS,GAAG,KAAK,CAAC,mBAAmB,IAAI,KAAK,CAAC,cAAc,CAAC;IACpE,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAqC;IACnE,IAAI,KAAK,CAAC,cAAc,KAAK,IAAI,IAAI,KAAK,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACxE,OAAO,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAqC;IAClE,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC,aAAa,CAAC;IAC7B,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAA,+BAAgB,EAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;AAClF,CAAC;AAED,SAAS,yBAAyB,CAAC,GAA4B;IAC7D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,wBAAwB,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IACD,IACE,GAAG,CAAC,sBAAsB,KAAK,IAAI;QACnC,CAAC,OAAO,GAAG,CAAC,sBAAsB,KAAK,QAAQ,IAAI,GAAG,CAAC,sBAAsB,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAC5F,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;IAChG,CAAC;IACD,OAAO;QACL,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC;QAC1C,gBAAgB,EAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC;QAC9C,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC;QACpC,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC;QAChC,cAAc,EAAE,GAAG,CAAC,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC;QAC/E,OAAO,EAAE,GAAG,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;QAC1D,MAAM,EAAE,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;QACvD,KAAK,EAAE,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;QACpD,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;QAC5B,cAAc,EACZ,OAAO,GAAG,CAAC,cAAc,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC;YAC3E,CAAC,CAAC,GAAG,CAAC,cAAc;YACpB,CAAC,CAAC,IAAI;QACV,UAAU,EAAE,GAAG,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;QACnE,mBAAmB,EAAE,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC;QACpD,aAAa,EAAE,GAAG,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;QAC5E,SAAS,EAAE,GAAG,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC;QAChE,UAAU,EAAE,GAAG,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;QACnE,iBAAiB,EAAE,GAAG,CAAC,iBAAiB,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC;QACxF,eAAe,EAAE,GAAG,CAAC,eAAe,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC;QAClF,aAAa,EAAE,GAAG,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;QAC5E,gBAAgB,EAAE,GAAG,CAAC,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC;QACrF,cAAc,EAAE,GAAG,CAAC,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC;QAC/E,YAAY,EAAE,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC;QACxC,mBAAmB,EAAE,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC;QACpD,wBAAwB,EAAE,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC;QAC9D,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;QAClC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;QAClC,UAAU,EAAE,GAAG,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;QACnE,sBAAsB,EAAE,GAAG,CAAC,sBAAsB;KACnD,CAAC;AACJ,CAAC;AAED,SAAgB,4BAA4B,CAC1C,GAA4B;IAE5B,OAAO,yBAAyB,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,qBAAqB,CAAC,GAA4B;IACzD,OAAO;QACL,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC;QAC1C,sBAAsB,EAAE,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC;QAC1D,mBAAmB,EAAE,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC;QACpD,aAAa,EAAE,GAAG,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;QAC5E,eAAe,EAAE,GAAG,CAAC,eAAe,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC;QAClF,UAAU,EAAE,GAAG,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;QACnE,aAAa,EAAE,GAAG,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;QAC5E,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;KACzC,CAAC;AACJ,CAAC;AAED,SAAgB,qBAAqB,CAAC,eAAuB,EAAE,QAAgB;IAC7E,MAAM,MAAM,GAAG,IAAA,wBAAU,EAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,eAAe,KAAK,QAAQ,EAAE,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClG,OAAO,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACtC,CAAC;AAED,SAAgB,yBAAyB,CAAC,KAKzC;IACC,OAAO,IAAA,wBAAU,EAAC,QAAQ,CAAC;SACxB,MAAM,CACL,IAAA,+BAAgB,EAAC;QACf,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;QACxC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,IAAI;KAC7C,CAAC,EACF,MAAM,CACP;SACA,MAAM,EAAE,CAAC;AACd,CAAC;AAED,SAAgB,yBAAyB,CACvC,OAAmC,EACnC,KAAqC;IAErC,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,aAAa,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,IAAI,eAAe,CAAC,aAAa,CAAC,CAAC;IACrE,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,IAAI,MAAM,EAAE,CAAC;IAC/C,IAAI,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,WAAW,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IAC9D,MAAM,YAAY,GAAG,qBAAqB,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACpF,MAAM,WAAW,GAAG,KAAK,CAAC,YAAY;QACpC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC;QACjC,CAAC,CAAC,yBAAyB,CAAC;YACxB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,cAAc,EAAE,aAAa;SAC9B,CAAC,CAAC;IAEP,IAAI,WAAW,CAAC,UAAU,KAAK,EAAE,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,YAAY,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAElD,OAAO,OAAO,CAAC,WAAW,CAAC,GAAG,EAAE;QAC9B,IAAI,iBAAiB,GAAG,KAAK,CAAC,WAAW,EAAE,mBAAmB,IAAI,IAAI,CAAC;QACvE,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,OAAO;iBACpB,OAAO,CACN;;;;qEAI2D,CAC5D;iBACA,GAAG,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,SAAS,CAUjC,CAAC;YACd,MAAM,aAAa,GAAG,IAAA,+BAAgB,EAAC;gBACrC,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;gBAC9B,QAAQ,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;gBACjC,SAAS,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI;gBACnC,eAAe,EAAE,KAAK,CAAC,iBAAiB,IAAI,IAAI;gBAChD,aAAa,EAAE,KAAK,CAAC,eAAe,IAAI,IAAI;aAC7C,CAAC,CAAC;YACH,MAAM,gBAAgB,GACpB,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,CAAC,SAAS,KAAK,SAAS;gBAC5D,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS;gBAC7B,CAAC,CAAC,aAAa,CAAC;YACpB,MAAM,WAAW,GACf,OAAO,EAAE,YAAY,KAAK,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC;gBACrD,OAAO,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC;gBACzC,OAAO,CAAC,SAAS,KAAK,gBAAgB;gBACtC,OAAO,CAAC,aAAa;oBACnB,IAAA,+BAAgB,EAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACpF,OAAO,CAAC,UAAU,KAAK,aAAa,CAAC;YACvC,IAAI,WAAW,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;gBAC/C,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;gBAChD,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;oBACpC,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;gBACnC,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,GAAG,OAAO;qBAClB,OAAO,CACN,uFAAuF,CACxF;qBACA,GAAG,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,SAAS,CAAsB,CAAC;gBACrE,iBAAiB,GAAG,WAAW,YAAY,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YACnE,CAAC;QACH,CAAC;QACD,MAAM,WAAW,GAAG,IAAA,oCAAwB,EAAC,OAAO,EAAE;YACpD,MAAM,EAAE,KAAK,CAAC,gBAAgB;YAC9B,QAAQ,EAAE,KAAK,CAAC,SAAS;YACzB,iBAAiB;YACjB,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,aAAa;gBAClC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,WAAW,CAAC,aAAa,EAAE;gBACnD,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;YAC5B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;YAC5B,QAAQ,EACN,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,CAAC,SAAS,KAAK,SAAS;gBAC5D,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS;gBAC7B,CAAC,CAAC,aAAa;YACnB,UAAU,EAAE,UAAU;YACtB,WAAW,EAAE,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC;YACxC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1E,KAAK,EAAE;gBACL,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;gBAC9B,QAAQ,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;gBACjC,SAAS,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI;gBACnC,eAAe,EAAE,KAAK,CAAC,iBAAiB,IAAI,IAAI;gBAChD,aAAa,EAAE,KAAK,CAAC,eAAe,IAAI,IAAI;aAC7C;SACF,CAAC,CAAC;QACH,OAAO;aACJ,OAAO,CACN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SAkDC,CACF;aACA,GAAG,CACF,YAAY,EACZ,KAAK,CAAC,gBAAgB,EACtB,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,gBAAgB,IAAI,KAAK,CAAC,SAAS,EACzC,KAAK,CAAC,cAAc,IAAI,IAAI,EAC5B,KAAK,CAAC,OAAO,IAAI,IAAI,EACrB,KAAK,CAAC,MAAM,IAAI,IAAI,EACpB,KAAK,CAAC,KAAK,IAAI,IAAI,EACnB,KAAK,CAAC,OAAO,EACb,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,KAAK,CAAC,aAAa,IAAI,IAAI,EAC3B,KAAK,CAAC,SAAS,IAAI,IAAI,EACvB,KAAK,CAAC,UAAU,IAAI,IAAI,EACxB,KAAK,CAAC,iBAAiB,IAAI,IAAI,EAC/B,KAAK,CAAC,eAAe,IAAI,IAAI,EAC7B,YAAY,EACZ,KAAK,CAAC,gBAAgB,IAAI,IAAI,EAC9B,KAAK,CAAC,cAAc,IAAI,IAAI,EAC5B,WAAW,EACX,KAAK,CAAC,UAAU,IAAI,SAAS,EAC7B,SAAS,EACT,KAAK,CAAC,UAAU,IAAI,IAAI,EACxB,WAAW,CAAC,aAAa,CAC1B,CAAC;QAEJ,MAAM,KAAK,GAAG,4BAA4B,CAAC,OAAO,EAAE,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAC7F,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,0DAA0D,KAAK,CAAC,gBAAgB,IAAI,KAAK,CAAC,SAAS,EAAE,CACtG,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,4BAA4B,CAC1C,OAAmC,EACnC,eAAuB,EACvB,QAAgB;IAEhB,MAAM,GAAG,GAAG,OAAO;SAChB,OAAO,CACN;;;;;;OAMC,CACF;SACA,GAAG,CAAC,eAAe,EAAE,QAAQ,CAAwC,CAAC;IAEzE,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,yBAAyB,CAAC,GAAG,CAAC,CAAC;IAC9C,IACE,MAAM,CAAC,sBAAsB,KAAK,IAAI;QACtC,CAAC,OAAO;aACL,OAAO,CAAC,6DAA6D,CAAC;aACtE,GAAG,CAAC,MAAM,CAAC,sBAAsB,CAAC,EACrC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,mBAAmB,CACjC,OAAmC,EACnC,aAAqB;IAErB,MAAM,GAAG,GAAG,OAAO;SAChB,OAAO,CACN;;;;;OAKC,CACF;SACA,GAAG,CAAC,aAAa,CAAwC,CAAC;IAE7D,OAAO,GAAG,CAAC,CAAC,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC;AAED,SAAgB,0BAA0B,CACxC,OAAmC,EACnC,aAAqB,EACrB,OAAuC;IAEvC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAClG,CAAC;IACD,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAO,CAAC,WAAW,CAAC,GAAG,EAAE;QACvB,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO;iBACJ,OAAO,CACN;;;;;gCAKsB,CACvB;iBACA,GAAG,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,OAAO;iBACJ,OAAO,CACN;;;;kDAIwC,CACzC;iBACA,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,4BAA4B,CAC1C,OAAmC,EACnC,KAAwC;IAExC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CACb,gFAAgF,CACjF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC;IACjD,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa;QAChC,CAAC,CAAC,OAAO;aACJ,OAAO,CACN;;;;;;WAMC,CACF;aACA,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,QAAQ,CAAC;QACvC,CAAC,CAAC,OAAO;aACJ,OAAO,CACN;;;;;WAKC,CACF;aACA,GAAG,CAAC,QAAQ,CAAC,CAAC;IAErB,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;AAC1C,CAAC"}

package/dist/connectors/framework/gws-utils.d.ts

@@ -1,12 +1,7 @@
 export declare function parseGwsOutput(raw: string): unknown;
-/**
- * Execute a gws CLI command and parse the JSON output.
- * Note: args are constructed internally by connectors using JSON.stringify
- * for parameter values — no user-supplied input is interpolated directly.
- */
-export declare function execGws(args: string, options?: {
-    maxBuffer?: number;
-}): unknown;
+/** Run non-JSON gws commands with argv and without blocking the daemon. */
+export declare function execGwsTextAsync(args: string[]): Promise<string>;
+/** Keep upstream page tokens in argv, never in a shell command; do not block the daemon. */
 export declare function execGwsAsync(args: string[], options?: {
     maxBuffer?: number;
 }): Promise<unknown>;

package/dist/connectors/framework/gws-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gws-utils.d.ts","sourceRoot":"","sources":["../../../src/connectors/framework/gws-utils.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CASnD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAQ/E;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,OAAO,CAAC,OAAO,CAAC,CAoBlB"}
+{"version":3,"file":"gws-utils.d.ts","sourceRoot":"","sources":["../../../src/connectors/framework/gws-utils.ts"],"names":[],"mappings":"AAsBA,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAWnD;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAEhE;AAED,4FAA4F;AAC5F,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,OAAO,CAAC,OAAO,CAAC,CAGlB"}