@jungjaehoon/mama-os 0.53.0 → 0.57.0

package/dist/api/source-actions.js

@@ -0,0 +1,274 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sourceActionRegistrations = sourceActionRegistrations;
+function replayReadAllowance(allowance) {
+    if (allowance?.maxSourceMs === undefined || allowance.maxSourceMs === null)
+        return undefined;
+    return { maxSourceMs: allowance.maxSourceMs };
+}
+function sourceName(input, action) {
+    const source = input.source;
+    if (typeof source !== 'string' || source.trim() === '') {
+        const error = new Error(`${action} requires a nonblank source`);
+        error.name = 'invalid_input';
+        throw error;
+    }
+    return source.trim();
+}
+function readWindow(body) {
+    return {
+        ...(body.content_offset === undefined ? {} : { content_offset: body.content_offset }),
+        ...(body.content_limit === undefined ? {} : { content_limit: body.content_limit }),
+    };
+}
+function displaySourceTime(value, timeZone) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return value;
+    const result = value;
+    if (Array.isArray(result.results)) {
+        return {
+            ...result,
+            results: result.results.map((entry) => {
+                if (!entry || typeof entry !== 'object' || Array.isArray(entry))
+                    return entry;
+                const item = entry;
+                return item.status === 'completed'
+                    ? { ...item, data: displaySourceTime(item.data, timeZone) }
+                    : entry;
+            }),
+        };
+    }
+    const sourceAt = result.sourceAt;
+    const ms = typeof sourceAt === 'number'
+        ? sourceAt
+        : typeof sourceAt === 'string'
+            ? Date.parse(sourceAt)
+            : Number.NaN;
+    return Number.isFinite(ms)
+        ? {
+            ...result,
+            sourceTime: `${new Date(ms).toLocaleString('ko-KR', { timeZone })} (${timeZone})`,
+        }
+        : value;
+}
+function storedReader(ports) {
+    if (!ports.stored) {
+        const error = new Error('Stored source reader is not configured');
+        error.name = 'source_unavailable';
+        throw error;
+    }
+    return ports.stored;
+}
+function assertGrantedSource(source, access) {
+    if (access.connectors?.includes(source))
+        return;
+    const error = new Error(`principal ${access.principalId} may not read ${source}; readable connectors: ${(access.connectors ?? []).join(', ') || '(none)'}`);
+    error.name = 'denied';
+    throw error;
+}
+const timeValue = {
+    description: 'Epoch milliseconds or timezone-aware ISO time, e.g. 1760000000000.',
+    oneOf: [
+        { type: 'integer', minimum: 0 },
+        {
+            type: 'string',
+            pattern: '^\\d{4}-\\d{2}-\\d{2}T.*(?:Z|[+-]\\d{2}:\\d{2})$',
+        },
+    ],
+};
+const sourceSchema = {
+    type: 'object',
+    required: ['source'],
+    additionalProperties: false,
+    properties: {
+        source: {
+            type: 'string',
+            pattern: '\\S',
+            description: 'Connector name, e.g. "slack"; do not put the message id here.',
+        },
+        view: { type: 'string', enum: ['stored'], description: 'Read view, e.g. "stored".' },
+        detail: {
+            type: 'string',
+            enum: ['compact', 'full'],
+            description: 'Search result detail, e.g. "full".',
+        },
+        channel: {
+            type: 'string',
+            description: 'Connector channel filter, e.g. "channel_123".',
+        },
+        from: timeValue,
+        to: timeValue,
+        query: {
+            type: 'string',
+            description: 'Text to find in preserved observations, e.g. "review".',
+        },
+        limit: {
+            type: 'integer',
+            minimum: 1,
+            maximum: 100,
+            description: 'Maximum search hits, e.g. 20.',
+        },
+        cursor: {
+            type: 'string',
+            description: 'Opaque search page cursor, e.g. "cursor_20".',
+        },
+        observationRef: {
+            type: 'string',
+            pattern: '\\S',
+            description: 'Exact stored observation handle returned by search/delta, e.g. "obs_123".',
+        },
+        content_offset: {
+            type: 'integer',
+            minimum: 0,
+            description: 'Character offset for a bounded read, e.g. 0.',
+        },
+        content_limit: {
+            type: 'integer',
+            minimum: 1,
+            maximum: 4_000,
+            description: 'Maximum characters returned by a read; at most 4000.',
+        },
+    },
+};
+const observationRefsSchema = {
+    type: 'array',
+    minItems: 1,
+    maxItems: 500,
+    description: 'Several exact observation handles from one source delta, up to 500 refs.',
+    items: {
+        type: 'string',
+        pattern: '\\S',
+        description: 'Exact stored observation handle from the source delta, e.g. "obs_123".',
+    },
+};
+const sourceReadSchema = {
+    ...sourceSchema,
+    required: [],
+    properties: {
+        ...sourceSchema.properties,
+        observationRefs: observationRefsSchema,
+    },
+    oneOf: [
+        { type: 'object', required: ['observationRef'] },
+        { type: 'object', required: ['observationRefs'] },
+    ],
+};
+function sourceActionRegistrations(ports) {
+    return [
+        {
+            contract: {
+                name: 'source.search',
+                readsConnector: { fromInput: 'source' },
+                summary: 'Search or page preserved source observations. Search results are bounded navigation hits; read the cited observation explicitly for the original content.',
+                inputSchema: sourceSchema,
+                examples: [
+                    {
+                        title: 'Find preserved source evidence',
+                        input: { source: 'connector', query: 'term', detail: 'compact' },
+                    },
+                ],
+            },
+            exec: (input, context) => {
+                const source = sourceName(input, 'source.search');
+                assertGrantedSource(source, context.access);
+                const allowance = replayReadAllowance(context.readAllowance);
+                const result = allowance === undefined
+                    ? storedReader(ports).search(source, input, context.access)
+                    : storedReader(ports).search(source, input, context.access, allowance);
+                const data = result;
+                return {
+                    ...result,
+                    ...(Array.isArray(data.hits)
+                        ? {
+                            hits: data.hits.map((hit) => {
+                                const sourceAt = hit.source_at;
+                                const timestamp = typeof sourceAt === 'string' ? Date.parse(sourceAt) : Number.NaN;
+                                const content = typeof hit.content_preview === 'string' ? hit.content_preview : '';
+                                const metadata = hit.metadata && typeof hit.metadata === 'object' && !Array.isArray(hit.metadata)
+                                    ? hit.metadata
+                                    : {};
+                                return {
+                                    author: hit.author_label ?? null,
+                                    channel: hit.channel_name ??
+                                        hit.channelName ??
+                                        metadata.channelName ??
+                                        hit.channel ??
+                                        hit.channel_id ??
+                                        null,
+                                    time: Number.isFinite(timestamp)
+                                        ? `${new Date(timestamp).toLocaleString('ko-KR', { timeZone: ports.timeZone.get() })} (${ports.timeZone.get()})`
+                                        : null,
+                                    text: content.replace(/\s+/g, ' ').trim().slice(0, 200),
+                                    observationRef: hit.raw_id ?? null,
+                                };
+                            }),
+                        }
+                        : {}),
+                };
+            },
+        },
+        {
+            contract: {
+                name: 'source.read',
+                summary: 'Read a bounded slice using one observationRef, or read up to 500 observationRefs from one source delta in one call. Batch results contain one per-ref result or error; continue with each nextRead until complete.',
+                inputSchema: sourceReadSchema,
+                examples: [
+                    {
+                        title: 'Read cited source evidence',
+                        input: { source: 'connector', observationRef: 'observation-reference' },
+                    },
+                    {
+                        title: 'Read source-delta evidence in one batch',
+                        input: {
+                            source: 'connector',
+                            observationRefs: ['observation-reference-1', 'observation-reference-2'],
+                        },
+                    },
+                ],
+            },
+            exec: (input, context) => {
+                const body = input;
+                const allowance = replayReadAllowance(context.readAllowance);
+                const timeZone = ports.timeZone.get();
+                if (body.source === undefined && Array.isArray(body.observationRefs)) {
+                    // Observation refs are unique, so each ref names its own source.
+                    const reader = storedReader(ports);
+                    return {
+                        results: body.observationRefs.map((ref) => {
+                            try {
+                                const data = allowance === undefined
+                                    ? reader.readObservation(String(ref), context.access, undefined, readWindow(body))
+                                    : reader.readObservation(String(ref), context.access, allowance, readWindow(body));
+                                return {
+                                    observationRef: ref,
+                                    status: 'completed',
+                                    data: displaySourceTime(data, timeZone),
+                                };
+                            }
+                            catch (error) {
+                                return {
+                                    observationRef: ref,
+                                    status: 'failed',
+                                    error: error instanceof Error ? error.message : String(error),
+                                };
+                            }
+                        }),
+                    };
+                }
+                if (body.source === undefined && typeof body.observationRef === 'string') {
+                    const data = allowance === undefined
+                        ? storedReader(ports).readObservation(body.observationRef, context.access, undefined, readWindow(body))
+                        : storedReader(ports).readObservation(body.observationRef, context.access, allowance, readWindow(body));
+                    return displaySourceTime(data, timeZone);
+                }
+                const source = sourceName(input, 'source.read');
+                assertGrantedSource(source, context.access);
+                const data = allowance === undefined
+                    ? storedReader(ports).read(source, body, context.access)
+                    : storedReader(ports).read(source, body, context.access, allowance);
+                return displaySourceTime(data, timeZone);
+            },
+        },
+    ];
+}
+//# sourceMappingURL=source-actions.js.map

package/dist/api/source-actions.js.map

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

package/dist/api/stored-source-reader.d.ts

@@ -0,0 +1,21 @@
+import type { ActionContext } from '@jungjaehoon/mama-core';
+import type { MemoryReadAllowance } from '@jungjaehoon/mama-core/api/catalog';
+import type { DatabaseAdapter } from '@jungjaehoon/mama-core/db-manager';
+import type { RawStore } from '../storage/source-archive.js';
+type Access = ActionContext['access'];
+export interface StoredSourceReaderOptions {
+    adapter: DatabaseAdapter;
+    ownerPrincipalId: () => string;
+    rawStore?: () => Pick<RawStore, 'readVersion'> | null;
+}
+export interface StoredSourceReader {
+    isOwner(principalId: string): boolean;
+    has(source: string): boolean;
+    overview(source: string, access: Access, allowance?: Pick<MemoryReadAllowance, 'maxSourceMs'>): Record<string, unknown>;
+    search(source: string, input: Record<string, unknown>, access: Access, allowance?: Pick<MemoryReadAllowance, 'maxSourceMs'>): Record<string, unknown>;
+    read(source: string, input: Record<string, unknown>, access: Access, allowance?: Pick<MemoryReadAllowance, 'maxSourceMs'>): Record<string, unknown>;
+    readObservation(observationRef: string, access: Access, allowance?: Pick<MemoryReadAllowance, 'maxSourceMs'>, window?: Partial<Pick<Record<string, unknown>, 'content_offset' | 'content_limit'>>): Record<string, unknown>;
+}
+export declare function createStoredSourceReader(options: StoredSourceReaderOptions): StoredSourceReader;
+export {};
+//# sourceMappingURL=stored-source-reader.d.ts.map

package/dist/api/stored-source-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stored-source-reader.d.ts","sourceRoot":"","sources":["../../src/api/stored-source-reader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAQ7D,KAAK,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;AAItC,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,eAAe,CAAC;IACzB,gBAAgB,EAAE,MAAM,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IACtC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,QAAQ,CACN,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,aAAa,CAAC,GACnD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3B,MAAM,CACJ,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,aAAa,CAAC,GACnD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3B,IAAI,CACF,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,aAAa,CAAC,GACnD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3B,eAAe,CACb,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,aAAa,CAAC,EACpD,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe,CAAC,CAAC,GAClF,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5B;AAoFD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,kBAAkB,CAwM/F"}

package/dist/api/stored-source-reader.js

@@ -0,0 +1,269 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStoredSourceReader = createStoredSourceReader;
+const knowledge_1 = require("@jungjaehoon/mama-core/knowledge");
+const raw_query_js_1 = require("../connectors/framework/raw-query.js");
+const stored_index_read_js_1 = require("../connectors/framework/stored-index-read.js");
+const MAX_BATCH_SOURCE_REFS = 500;
+function denied() {
+    const error = new Error('Stored source requires a granted connector and channel scope');
+    error.name = 'stored_source_out_of_scope';
+    return error;
+}
+function missing() {
+    const error = new Error('No stored observation exists for this source and reference');
+    error.name = 'stored_source_not_found';
+    return error;
+}
+function allowedChannels(source, access, ownerPrincipalId) {
+    if (!access.connectors?.includes(source))
+        throw denied();
+    if (access.principalId === ownerPrincipalId)
+        return null;
+    const channels = access.channels?.[source];
+    if (!channels || channels.length === 0)
+        throw denied();
+    return [...new Set(channels.map((value) => value.trim()).filter(Boolean))];
+}
+function time(value, field) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value === 'number' && Number.isSafeInteger(value) && value >= 0)
+        return value;
+    if (typeof value === 'string' && /^\d{4}-\d{2}-\d{2}T.*(?:Z|[+-]\d{2}:\d{2})$/.test(value)) {
+        const parsed = Date.parse(value);
+        if (Number.isSafeInteger(parsed) && parsed >= 0)
+            return parsed;
+    }
+    throw new Error(`${field} must be an epoch millisecond or ISO timestamp with timezone`);
+}
+function pageChannels(input, granted) {
+    const requested = input.channel;
+    if (requested !== undefined && (typeof requested !== 'string' || requested.trim() === '')) {
+        throw new Error('channel must be nonblank text');
+    }
+    if (typeof requested === 'string') {
+        if (granted && !granted.includes(requested))
+            throw denied();
+        return [requested];
+    }
+    return granted ?? undefined;
+}
+function readRefs(input) {
+    if (input.observationRefs !== undefined) {
+        if (!Array.isArray(input.observationRefs)) {
+            throw new Error('source.read observationRefs must be an array');
+        }
+        if (input.observationRefs.length < 1 || input.observationRefs.length > MAX_BATCH_SOURCE_REFS) {
+            throw new Error(`source.read observationRefs must contain 1 to ${MAX_BATCH_SOURCE_REFS} handles`);
+        }
+        if (input.observationRefs.some((value) => typeof value !== 'string' || value.trim() === '')) {
+            throw new Error('source.read observationRefs must contain nonblank handles');
+        }
+        if (input.observationRef !== undefined) {
+            throw new Error('source.read accepts observationRef or observationRefs, not both');
+        }
+        return { refs: input.observationRefs, batched: true };
+    }
+    const ref = input.observationRef;
+    if (typeof ref !== 'string' || ref.trim() === '') {
+        throw new Error('source.read stored view requires observationRef');
+    }
+    return { refs: [ref], batched: false };
+}
+function readError(error) {
+    return {
+        code: error instanceof Error && error.name !== 'Error' ? error.name : 'source_read_failed',
+        message: error instanceof Error ? error.message : String(error),
+    };
+}
+function createStoredSourceReader(options) {
+    const { adapter } = options;
+    return {
+        isOwner: (principalId) => principalId === options.ownerPrincipalId(),
+        has: (source) => (0, stored_index_read_js_1.hasStoredConnector)(adapter, source),
+        overview(source, access, allowance) {
+            const channels = allowedChannels(source, access, options.ownerPrincipalId());
+            const row = (0, stored_index_read_js_1.storedConnectorOverview)(adapter, source, channels, allowance?.maxSourceMs);
+            return {
+                source,
+                mode: 'stored',
+                count: Number(row.count),
+                channelCount: Number(row.channel_count),
+                firstSourceAt: row.first_source_at,
+                lastSourceAt: row.last_source_at,
+                lastObservedAt: row.last_observed_at,
+                coverage: {
+                    complete: false,
+                    reason: 'Stored observations; upstream coverage may be partial',
+                },
+            };
+        },
+        search(source, input, access, allowance) {
+            const granted = allowedChannels(source, access, options.ownerPrincipalId());
+            const query = input.query === undefined ? '' : input.query;
+            if (typeof query !== 'string')
+                throw new Error('query must be text');
+            const channels = pageChannels(input, granted);
+            const fromMs = time(input.from, 'from');
+            const toMs = time(input.to, 'to');
+            if (fromMs !== undefined && toMs !== undefined && fromMs > toMs) {
+                throw new Error('from must not be later than to');
+            }
+            if (input.limit !== undefined &&
+                (!Number.isSafeInteger(input.limit) || Number(input.limit) < 1 || Number(input.limit) > 100)) {
+                throw new Error('limit must be an integer from 1 to 100');
+            }
+            if (input.cursor !== undefined && typeof input.cursor !== 'string') {
+                throw new Error('cursor must be text');
+            }
+            const detail = input.detail ?? 'compact';
+            if (detail !== 'compact' && detail !== 'full') {
+                throw new Error('detail must be compact or full');
+            }
+            const queryInput = {
+                query,
+                connectors: [source],
+                ...(channels === undefined ? {} : { channels }),
+                ...(fromMs === undefined ? {} : { fromMs }),
+                ...(toMs === undefined ? {} : { toMs }),
+                ...(input.limit === undefined ? {} : { limit: Number(input.limit) }),
+                ...(input.cursor === undefined ? {} : { cursor: input.cursor }),
+                ...(allowance?.maxSourceMs === undefined ? {} : { maxSourceMs: allowance.maxSourceMs }),
+            };
+            const result = query.trim() ? (0, raw_query_js_1.searchRaw)(adapter, queryInput) : (0, raw_query_js_1.listRaw)(adapter, queryInput);
+            return {
+                source,
+                mode: 'stored',
+                ...result,
+                hits: result.hits.map((hit) => detail === 'full'
+                    ? {
+                        ...hit,
+                        observationRef: hit.raw_id || null,
+                        nextRead: hit.raw_id
+                            ? { source, view: 'stored', observationRef: hit.raw_id }
+                            : null,
+                    }
+                    : {
+                        raw_id: hit.raw_id,
+                        source_id: hit.source_id,
+                        channel_id: hit.channel_id,
+                        author_label: hit.author_label,
+                        source_at: hit.source_at,
+                        observed_at: hit.observed_at,
+                        content_preview: hit.content_preview,
+                        score: hit.score,
+                        observationRef: hit.raw_id || null,
+                        nextRead: hit.raw_id
+                            ? { source, view: 'stored', observationRef: hit.raw_id }
+                            : null,
+                    }),
+                coverage: {
+                    returned: result.hits.length,
+                    pageComplete: result.next_cursor === null,
+                },
+            };
+        },
+        read(source, input, access, allowance) {
+            const granted = allowedChannels(source, access, options.ownerPrincipalId());
+            const { refs, batched } = readRefs(input);
+            const rawStore = options.rawStore?.();
+            const readOne = (ref) => {
+                const channel = (0, stored_index_read_js_1.storedObservationChannel)(adapter, ref, source, allowance?.maxSourceMs);
+                if (channel === undefined) {
+                    if (access.principalId === options.ownerPrincipalId())
+                        throw missing();
+                    throw denied();
+                }
+                if (granted && (!channel || !granted.includes(channel)))
+                    throw denied();
+                const result = (0, knowledge_1.readObservationVersion)(adapter, ref, rawStore
+                    ? {
+                        readVersion: ({ connectorName, revisionSourceId, expectedContentHash }) => {
+                            const found = rawStore.readVersion(connectorName, revisionSourceId, expectedContentHash);
+                            if (found.status === 'available') {
+                                if (found.body === undefined || found.contentHash === undefined) {
+                                    throw new Error('Raw version reader omitted its available body or hash');
+                                }
+                                return {
+                                    status: 'available',
+                                    body: found.body,
+                                    contentHash: found.contentHash,
+                                };
+                            }
+                            if (found.reason === undefined) {
+                                throw new Error('Raw version reader omitted its unavailable reason');
+                            }
+                            return { status: 'version_unavailable', reason: found.reason };
+                        },
+                    }
+                    : undefined, allowance?.maxSourceMs === undefined ? undefined : { maxSourceMs: allowance.maxSourceMs });
+                if (result.status !== 'available') {
+                    throw new Error(result.status === 'not_found' ? 'observation_not_found' : result.reason);
+                }
+                const offset = input.content_offset === undefined ? 0 : Number(input.content_offset);
+                const limit = input.content_limit === undefined ? 4_000 : Number(input.content_limit);
+                if (!Number.isSafeInteger(offset) ||
+                    offset < 0 ||
+                    !Number.isSafeInteger(limit) ||
+                    limit < 1 ||
+                    limit > 4_000) {
+                    throw new Error('content_offset/content_limit must be bounded integers');
+                }
+                const chars = [...result.body];
+                const content = chars.slice(offset, offset + limit).join('');
+                const observation = result.observation;
+                return {
+                    source,
+                    mode: 'stored',
+                    observationRef: observation.observationId,
+                    sourceId: observation.sourceId,
+                    sourceAt: observation.sourceAt,
+                    observedAt: observation.observedAt,
+                    channel: observation.channel,
+                    author: observation.author,
+                    metadata: observation.metadata,
+                    content,
+                    contentHash: observation.contentHash,
+                    complete: offset + limit >= chars.length,
+                    nextRead: offset + limit < chars.length
+                        ? {
+                            source,
+                            view: 'stored',
+                            observationRef: ref,
+                            content_offset: offset + limit,
+                            content_limit: limit,
+                        }
+                        : null,
+                };
+            };
+            if (!batched)
+                return readOne(refs[0]);
+            return {
+                source,
+                mode: 'stored',
+                results: refs.map((ref) => {
+                    try {
+                        return { observationRef: ref, status: 'completed', data: readOne(ref) };
+                    }
+                    catch (error) {
+                        return { observationRef: ref, status: 'failed', error: readError(error) };
+                    }
+                }),
+            };
+        },
+        readObservation(observationRef, access, allowance, window) {
+            if (typeof observationRef !== 'string' || observationRef.trim() === '') {
+                throw new Error('observationRef must be nonblank text');
+            }
+            const stored = (0, knowledge_1.getObservationVersion)(adapter, observationRef);
+            if (stored === null) {
+                if (access.principalId === options.ownerPrincipalId())
+                    throw missing();
+                throw denied();
+            }
+            return this.read(stored.source, { observationRef, ...window }, access, allowance);
+        },
+    };
+}
+//# sourceMappingURL=stored-source-reader.js.map

package/dist/api/stored-source-reader.js.map

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