@indigoai-us/hq-cloud 5.19.0 → 5.20.0

package/dist/schemas/signal-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-types.d.ts","sourceRoot":"","sources":["../../src/schemas/signal-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,YAAY,oFAOd,CAAC;AAEZ,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,SAAkB,IAAI,4BAA4B;gBAEtC,KAAK,EAAE,OAAO;CAK3B;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAI5E"}

package/dist/schemas/signal-types.js

@@ -0,0 +1,30 @@
+/**
+ * Signal type schema — single source of truth.
+ *
+ * Closed enum: the six canonical signal types.
+ * assertSignalType is the agent-mitigation lever — prevents LLMs
+ * from fabricating signal types.
+ */
+export const SIGNAL_TYPES = Object.freeze([
+    "action_item",
+    "commitment",
+    "decision",
+    "key_point",
+    "risk",
+    "summary",
+]);
+export class InvalidSignalTypeError extends Error {
+    name = "InvalidSignalTypeError";
+    constructor(value) {
+        super(`Invalid signal type: '${String(value)}'. Valid types: ${SIGNAL_TYPES.join(", ")}`);
+    }
+}
+export function isSignalType(value) {
+    return typeof value === "string" && SIGNAL_TYPES.includes(value);
+}
+export function assertSignalType(value) {
+    if (!isSignalType(value)) {
+        throw new InvalidSignalTypeError(value);
+    }
+}
+//# sourceMappingURL=signal-types.js.map

package/dist/schemas/signal-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-types.js","sourceRoot":"","sources":["../../src/schemas/signal-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;IACxC,aAAa;IACb,YAAY;IACZ,UAAU;IACV,WAAW;IACX,MAAM;IACN,SAAS;CACD,CAAC,CAAC;AAIZ,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC7B,IAAI,GAAG,wBAAwB,CAAC;IAElD,YAAY,KAAc;QACxB,KAAK,CACH,yBAAyB,MAAM,CAAC,KAAK,CAAC,mBAAmB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACnF,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,YAAkC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC"}

package/dist/schemas/signal-types.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=signal-types.test.d.ts.map

package/dist/schemas/signal-types.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-types.test.d.ts","sourceRoot":"","sources":["../../src/schemas/signal-types.test.ts"],"names":[],"mappings":""}

package/dist/schemas/signal-types.test.js

@@ -0,0 +1,65 @@
+import { describe, it, expect } from "vitest";
+import { SIGNAL_TYPES, isSignalType, assertSignalType, InvalidSignalTypeError, } from "./signal-types.js";
+describe("SIGNAL_TYPES", () => {
+    it("contains the six canonical types", () => {
+        expect([...SIGNAL_TYPES]).toEqual([
+            "action_item",
+            "commitment",
+            "decision",
+            "key_point",
+            "risk",
+            "summary",
+        ]);
+    });
+    it("is frozen (readonly at runtime)", () => {
+        expect(Object.isFrozen(SIGNAL_TYPES)).toBe(true);
+    });
+});
+describe("isSignalType", () => {
+    it.each(SIGNAL_TYPES)("returns true for '%s'", (type) => {
+        expect(isSignalType(type)).toBe(true);
+    });
+    it("returns false for an invalid string", () => {
+        expect(isSignalType("ramble")).toBe(false);
+    });
+    it("returns false for non-string values", () => {
+        expect(isSignalType(42)).toBe(false);
+        expect(isSignalType(null)).toBe(false);
+        expect(isSignalType(undefined)).toBe(false);
+    });
+});
+describe("assertSignalType", () => {
+    it.each(SIGNAL_TYPES)("does not throw for '%s'", (type) => {
+        expect(() => assertSignalType(type)).not.toThrow();
+    });
+    it("throws InvalidSignalTypeError for invalid value", () => {
+        expect(() => assertSignalType("ramble")).toThrow(InvalidSignalTypeError);
+    });
+    it("error message contains the offending value", () => {
+        expect(() => assertSignalType("ramble")).toThrow("'ramble'");
+    });
+    it("error message lists all valid types", () => {
+        try {
+            assertSignalType("ramble");
+        }
+        catch (err) {
+            const msg = err.message;
+            for (const type of SIGNAL_TYPES) {
+                expect(msg).toContain(type);
+            }
+        }
+    });
+    it("error message matches snapshot", () => {
+        expect(() => assertSignalType("ramble")).toThrowErrorMatchingInlineSnapshot(`[InvalidSignalTypeError: Invalid signal type: 'ramble'. Valid types: action_item, commitment, decision, key_point, risk, summary]`);
+    });
+});
+describe("SignalType type", () => {
+    it("narrows correctly via type guard", () => {
+        const value = "action_item";
+        if (isSignalType(value)) {
+            const _type = value;
+            expect(_type).toBe("action_item");
+        }
+    });
+});
+//# sourceMappingURL=signal-types.test.js.map

package/dist/schemas/signal-types.test.js.map

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

package/dist/schemas/source-channels.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Source channel schema — single source of truth.
+ *
+ * Closed enum: extension requires a code change (PR).
+ * Matches the sources-pipeline SourceChannel type.
+ */
+export declare const SOURCE_CHANNELS: readonly ["meeting", "email", "slack", "linear", "notion"];
+export type SourceChannel = (typeof SOURCE_CHANNELS)[number];
+export declare class InvalidSourceChannelError extends Error {
+    readonly name = "InvalidSourceChannelError";
+    constructor(value: unknown);
+}
+export declare function isSourceChannel(value: unknown): value is SourceChannel;
+export declare function assertSourceChannel(value: unknown): asserts value is SourceChannel;
+//# sourceMappingURL=source-channels.d.ts.map

package/dist/schemas/source-channels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-channels.d.ts","sourceRoot":"","sources":["../../src/schemas/source-channels.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,eAAe,4DAMjB,CAAC;AAEZ,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,SAAkB,IAAI,+BAA+B;gBAEzC,KAAK,EAAE,OAAO;CAK3B;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAIlF"}

package/dist/schemas/source-channels.js

@@ -0,0 +1,28 @@
+/**
+ * Source channel schema — single source of truth.
+ *
+ * Closed enum: extension requires a code change (PR).
+ * Matches the sources-pipeline SourceChannel type.
+ */
+export const SOURCE_CHANNELS = Object.freeze([
+    "meeting",
+    "email",
+    "slack",
+    "linear",
+    "notion",
+]);
+export class InvalidSourceChannelError extends Error {
+    name = "InvalidSourceChannelError";
+    constructor(value) {
+        super(`Invalid source channel: '${String(value)}'. Valid channels: ${SOURCE_CHANNELS.join(", ")}`);
+    }
+}
+export function isSourceChannel(value) {
+    return typeof value === "string" && SOURCE_CHANNELS.includes(value);
+}
+export function assertSourceChannel(value) {
+    if (!isSourceChannel(value)) {
+        throw new InvalidSourceChannelError(value);
+    }
+}
+//# sourceMappingURL=source-channels.js.map

package/dist/schemas/source-channels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-channels.js","sourceRoot":"","sources":["../../src/schemas/source-channels.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3C,SAAS;IACT,OAAO;IACP,OAAO;IACP,QAAQ;IACR,QAAQ;CACA,CAAC,CAAC;AAIZ,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAChC,IAAI,GAAG,2BAA2B,CAAC;IAErD,YAAY,KAAc;QACxB,KAAK,CACH,4BAA4B,MAAM,CAAC,KAAK,CAAC,sBAAsB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5F,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,eAAqC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,yBAAyB,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC"}

package/dist/schemas/source-channels.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=source-channels.test.d.ts.map

package/dist/schemas/source-channels.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-channels.test.d.ts","sourceRoot":"","sources":["../../src/schemas/source-channels.test.ts"],"names":[],"mappings":""}

package/dist/schemas/source-channels.test.js

@@ -0,0 +1,65 @@
+import { describe, it, expect } from "vitest";
+import { SOURCE_CHANNELS, isSourceChannel, assertSourceChannel, InvalidSourceChannelError, } from "./source-channels.js";
+describe("SOURCE_CHANNELS", () => {
+    it("contains the five canonical channels", () => {
+        expect([...SOURCE_CHANNELS]).toEqual([
+            "meeting",
+            "email",
+            "slack",
+            "linear",
+            "notion",
+        ]);
+    });
+    it("is frozen (readonly at runtime)", () => {
+        expect(Object.isFrozen(SOURCE_CHANNELS)).toBe(true);
+    });
+});
+describe("isSourceChannel", () => {
+    it.each(SOURCE_CHANNELS)("returns true for '%s'", (channel) => {
+        expect(isSourceChannel(channel)).toBe(true);
+    });
+    it("returns false for an invalid string", () => {
+        expect(isSourceChannel("pigeon")).toBe(false);
+    });
+    it("returns false for non-string values", () => {
+        expect(isSourceChannel(42)).toBe(false);
+        expect(isSourceChannel(null)).toBe(false);
+        expect(isSourceChannel(undefined)).toBe(false);
+    });
+});
+describe("assertSourceChannel", () => {
+    it.each(SOURCE_CHANNELS)("does not throw for '%s'", (channel) => {
+        expect(() => assertSourceChannel(channel)).not.toThrow();
+    });
+    it("throws InvalidSourceChannelError for invalid value", () => {
+        expect(() => assertSourceChannel("pigeon")).toThrow(InvalidSourceChannelError);
+    });
+    it("error message contains the offending value", () => {
+        expect(() => assertSourceChannel("pigeon")).toThrow("'pigeon'");
+    });
+    it("error message lists all valid channels", () => {
+        try {
+            assertSourceChannel("pigeon");
+        }
+        catch (err) {
+            const msg = err.message;
+            for (const channel of SOURCE_CHANNELS) {
+                expect(msg).toContain(channel);
+            }
+        }
+    });
+    it("error message matches snapshot", () => {
+        expect(() => assertSourceChannel("pigeon")).toThrowErrorMatchingInlineSnapshot(`[InvalidSourceChannelError: Invalid source channel: 'pigeon'. Valid channels: meeting, email, slack, linear, notion]`);
+    });
+});
+describe("SourceChannel type", () => {
+    it("narrows correctly via type guard", () => {
+        const value = "meeting";
+        if (isSourceChannel(value)) {
+            // TypeScript narrows to SourceChannel — compile-time check
+            const _channel = value;
+            expect(_channel).toBe("meeting");
+        }
+    });
+});
+//# sourceMappingURL=source-channels.test.js.map

package/dist/schemas/source-channels.test.js.map

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

package/dist/signals/get.d.ts

@@ -0,0 +1,13 @@
+/**
+ * getSignal — fetch a single signal document from an entity bucket and
+ * return parsed frontmatter + body, with `sourceRef`, `citations`, and
+ * `entityRefs` surfaced as typed fields.
+ */
+import type { GetSignalOptions, SignalDocument } from "./types.js";
+export declare class SignalNotFoundError extends Error {
+    readonly key: string;
+    readonly name = "SignalNotFoundError";
+    constructor(key: string);
+}
+export declare function getSignal(opts: GetSignalOptions): Promise<SignalDocument>;
+//# sourceMappingURL=get.d.ts.map

package/dist/signals/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../src/signals/get.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEnE,qBAAa,mBAAoB,SAAQ,KAAK;aAEhB,GAAG,EAAE,MAAM;IADvC,SAAkB,IAAI,yBAAyB;gBACnB,GAAG,EAAE,MAAM;CAGxC;AAkBD,wBAAsB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CA2C/E"}

package/dist/signals/get.js

@@ -0,0 +1,74 @@
+/**
+ * getSignal — fetch a single signal document from an entity bucket and
+ * return parsed frontmatter + body, with `sourceRef`, `citations`, and
+ * `entityRefs` surfaced as typed fields.
+ */
+import { GetObjectCommand } from "@aws-sdk/client-s3";
+import { assertSignalType } from "../schemas/signal-types.js";
+import { getS3Client, streamToString } from "./internals.js";
+import { parseMarkdown } from "./parse.js";
+export class SignalNotFoundError extends Error {
+    key;
+    name = "SignalNotFoundError";
+    constructor(key) {
+        super(`Signal not found: ${key}`);
+        this.key = key;
+    }
+}
+function isNoSuchKey(err) {
+    if (!err || typeof err !== "object")
+        return false;
+    const name = err.name;
+    // AWS SDK v3 throws either a `NoSuchKey` exception or a `NotFound` head error.
+    return name === "NoSuchKey" || name === "NoSuchKeyException";
+}
+function asStringArray(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const out = [];
+    for (const item of value) {
+        if (typeof item === "string")
+            out.push(item);
+    }
+    return out.length > 0 ? out : undefined;
+}
+export async function getSignal(opts) {
+    // Validate signalType BEFORE any S3 call (acceptance criterion + agent-mitigation).
+    assertSignalType(opts.signalType);
+    const client = getS3Client(opts.entity);
+    const key = `signals/${opts.signalType}/${opts.signalId}.md`;
+    let body;
+    try {
+        const response = await client.send(new GetObjectCommand({
+            Bucket: opts.entity.bucketName,
+            Key: key,
+        }));
+        body = await streamToString(response.Body);
+    }
+    catch (err) {
+        if (isNoSuchKey(err)) {
+            throw new SignalNotFoundError(key);
+        }
+        throw err;
+    }
+    const parsed = parseMarkdown(body);
+    const document = {
+        key,
+        frontmatter: parsed.frontmatter,
+        body: parsed.body,
+    };
+    if (parsed.frontmatter) {
+        const sourceRef = parsed.frontmatter.source_ref;
+        if (typeof sourceRef === "string") {
+            document.sourceRef = sourceRef;
+        }
+        const citations = asStringArray(parsed.frontmatter.citations);
+        if (citations)
+            document.citations = citations;
+        const entityRefs = asStringArray(parsed.frontmatter.entity_refs);
+        if (entityRefs)
+            document.entityRefs = entityRefs;
+    }
+    return document;
+}
+//# sourceMappingURL=get.js.map

package/dist/signals/get.js.map

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

package/dist/signals/get.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for signals/get.ts.
+ */
+export {};
+//# sourceMappingURL=get.test.d.ts.map

package/dist/signals/get.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.test.d.ts","sourceRoot":"","sources":["../../src/signals/get.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/signals/get.test.js

@@ -0,0 +1,170 @@
+/**
+ * Unit tests for signals/get.ts.
+ */
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { GetObjectCommand } from "@aws-sdk/client-s3";
+import { getSignal, SignalNotFoundError } from "./get.js";
+import { _setSignalsS3Factory, _resetSignalsS3Factory, } from "./internals.js";
+import { InvalidSignalTypeError } from "../schemas/signal-types.js";
+// ---------------------------------------------------------------------------
+// Fixtures
+// ---------------------------------------------------------------------------
+const ENTITY = {
+    uid: "cmp_test_001",
+    slug: "test",
+    bucketName: "hq-vault-test",
+    region: "us-east-1",
+    credentials: {
+        accessKeyId: "ASIATEST",
+        secretAccessKey: "secret",
+        sessionToken: "session",
+    },
+    expiresAt: new Date(Date.now() + 3600_000).toISOString(),
+};
+const ACTION_ITEM_MD = `---
+signal_id: sig_action_001
+signal_type: action_item
+source_ref: abc-meeting-001
+citations:
+  - "Stefan to review the sources pipeline implementation by end of week"
+  - "Corey to prepare roadmap slides"
+entity_refs:
+  - stefan@indigoai.us
+  - corey@indigoai.us
+---
+
+Stefan will review the sources pipeline implementation.
+
+Corey will prepare updated roadmap slides.
+`;
+function installStub(objects) {
+    async function send(command) {
+        if (command instanceof GetObjectCommand) {
+            const { Key } = command.input;
+            const content = objects[Key];
+            if (content === undefined) {
+                const err = new Error(`NoSuchKey: ${Key}`);
+                err.name = "NoSuchKey";
+                throw err;
+            }
+            async function* stream() {
+                yield Buffer.from(content, "utf-8");
+            }
+            return { Body: stream(), $metadata: {} };
+        }
+        throw new Error(`unhandled command`);
+    }
+    _setSignalsS3Factory(() => ({ send }));
+}
+beforeEach(() => _resetSignalsS3Factory());
+afterEach(() => _resetSignalsS3Factory());
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe("getSignal", () => {
+    it("happy path: parses frontmatter, body, and surfaces typed cross-refs", async () => {
+        installStub({ "signals/action_item/foo.md": ACTION_ITEM_MD });
+        const doc = await getSignal({
+            entity: ENTITY,
+            signalType: "action_item",
+            signalId: "foo",
+        });
+        expect(doc.key).toBe("signals/action_item/foo.md");
+        expect(doc.frontmatter).toMatchObject({
+            signal_id: "sig_action_001",
+            signal_type: "action_item",
+            source_ref: "abc-meeting-001",
+        });
+        expect(doc.body).toContain("Stefan will review");
+        expect(doc.body).toContain("Corey will prepare");
+        // Typed cross-reference fields.
+        expect(doc.sourceRef).toBe("abc-meeting-001");
+        expect(doc.citations).toEqual([
+            "Stefan to review the sources pipeline implementation by end of week",
+            "Corey to prepare roadmap slides",
+        ]);
+        expect(doc.entityRefs).toEqual([
+            "stefan@indigoai.us",
+            "corey@indigoai.us",
+        ]);
+    });
+    it("throws SignalNotFoundError on NoSuchKey", async () => {
+        installStub({});
+        await expect(getSignal({ entity: ENTITY, signalType: "action_item", signalId: "missing" })).rejects.toBeInstanceOf(SignalNotFoundError);
+        await expect(getSignal({ entity: ENTITY, signalType: "action_item", signalId: "missing" })).rejects.toThrow(/signals\/action_item\/missing\.md/);
+    });
+    it("rejects an invalid signalType via assertSignalType BEFORE any S3 call", async () => {
+        let called = 0;
+        _setSignalsS3Factory(() => ({
+            send: async () => {
+                called++;
+                return {};
+            },
+        }));
+        await expect(getSignal({
+            entity: ENTITY,
+            // @ts-expect-error — invalid signal type intentional
+            signalType: "ramble",
+            signalId: "foo",
+        })).rejects.toBeInstanceOf(InvalidSignalTypeError);
+        expect(called).toBe(0);
+    });
+    it("returns frontmatter:null for malformed (no frontmatter block) documents", async () => {
+        installStub({ "signals/action_item/plain.md": "Just a body, no frontmatter." });
+        const doc = await getSignal({
+            entity: ENTITY,
+            signalType: "action_item",
+            signalId: "plain",
+        });
+        expect(doc.frontmatter).toBeNull();
+        expect(doc.body).toBe("Just a body, no frontmatter.");
+        expect(doc.sourceRef).toBeUndefined();
+        expect(doc.citations).toBeUndefined();
+        expect(doc.entityRefs).toBeUndefined();
+    });
+    it("omits cross-ref fields when frontmatter is present but lacks them", async () => {
+        const SPARSE = `---
+signal_id: sig_summary_001
+signal_type: summary
+---
+
+A summary with no source_ref, citations, or entity_refs.
+`;
+        installStub({ "signals/summary/sparse.md": SPARSE });
+        const doc = await getSignal({
+            entity: ENTITY,
+            signalType: "summary",
+            signalId: "sparse",
+        });
+        expect(doc.frontmatter).toMatchObject({ signal_id: "sig_summary_001" });
+        expect(doc.sourceRef).toBeUndefined();
+        expect(doc.citations).toBeUndefined();
+        expect(doc.entityRefs).toBeUndefined();
+        expect(doc.body).toContain("A summary");
+    });
+    it("filters non-string entries out of citations + entity_refs", async () => {
+        const MIXED = `---
+signal_id: sig_test
+signal_type: action_item
+citations:
+  - "string one"
+  - 42
+  - "string two"
+entity_refs:
+  - true
+  - "kept@example.com"
+---
+
+Body.
+`;
+        installStub({ "signals/action_item/mixed.md": MIXED });
+        const doc = await getSignal({
+            entity: ENTITY,
+            signalType: "action_item",
+            signalId: "mixed",
+        });
+        expect(doc.citations).toEqual(["string one", "string two"]);
+        expect(doc.entityRefs).toEqual(["kept@example.com"]);
+    });
+});
+//# sourceMappingURL=get.test.js.map

package/dist/signals/get.test.js.map

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

package/dist/signals/internals.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Internal helpers shared between signals/list.ts and signals/get.ts.
+ *
+ * Independent S3 client factory hook (separate from sources/internals.ts)
+ * so signals tests can swap their stub without disturbing sources tests.
+ * Production code never calls the setter.
+ */
+import { S3Client } from "@aws-sdk/client-s3";
+import type { EntityContext } from "../types.js";
+export declare function getS3Client(ctx: EntityContext): S3Client;
+/** Test hook: replace the S3 client factory. */
+export declare function _setSignalsS3Factory(f: (ctx: EntityContext) => S3Client): void;
+/** Test hook: restore the default S3 client factory. */
+export declare function _resetSignalsS3Factory(): void;
+export declare function streamToString(body: unknown): Promise<string>;
+//# sourceMappingURL=internals.d.ts.map

package/dist/signals/internals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internals.d.ts","sourceRoot":"","sources":["../../src/signals/internals.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAejD,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,QAAQ,CAExD;AAED,gDAAgD;AAChD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,QAAQ,GAAG,IAAI,CAE9E;AAED,wDAAwD;AACxD,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAOnE"}

package/dist/signals/internals.js

@@ -0,0 +1,39 @@
+/**
+ * Internal helpers shared between signals/list.ts and signals/get.ts.
+ *
+ * Independent S3 client factory hook (separate from sources/internals.ts)
+ * so signals tests can swap their stub without disturbing sources tests.
+ * Production code never calls the setter.
+ */
+import { S3Client } from "@aws-sdk/client-s3";
+function defaultFactory(ctx) {
+    return new S3Client({
+        region: ctx.region,
+        credentials: {
+            accessKeyId: ctx.credentials.accessKeyId,
+            secretAccessKey: ctx.credentials.secretAccessKey,
+            sessionToken: ctx.credentials.sessionToken,
+        },
+    });
+}
+let factory = defaultFactory;
+export function getS3Client(ctx) {
+    return factory(ctx);
+}
+/** Test hook: replace the S3 client factory. */
+export function _setSignalsS3Factory(f) {
+    factory = f;
+}
+/** Test hook: restore the default S3 client factory. */
+export function _resetSignalsS3Factory() {
+    factory = defaultFactory;
+}
+export async function streamToString(body) {
+    const stream = body;
+    const chunks = [];
+    for await (const chunk of stream) {
+        chunks.push(Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks).toString("utf-8");
+}
+//# sourceMappingURL=internals.js.map

package/dist/signals/internals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internals.js","sourceRoot":"","sources":["../../src/signals/internals.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,SAAS,cAAc,CAAC,GAAkB;IACxC,OAAO,IAAI,QAAQ,CAAC;QAClB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,WAAW,EAAE;YACX,WAAW,EAAE,GAAG,CAAC,WAAW,CAAC,WAAW;YACxC,eAAe,EAAE,GAAG,CAAC,WAAW,CAAC,eAAe;YAChD,YAAY,EAAE,GAAG,CAAC,WAAW,CAAC,YAAY;SAC3C;KACF,CAAC,CAAC;AACL,CAAC;AAED,IAAI,OAAO,GAAqC,cAAc,CAAC;AAE/D,MAAM,UAAU,WAAW,CAAC,GAAkB;IAC5C,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;AACtB,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,oBAAoB,CAAC,CAAmC;IACtE,OAAO,GAAG,CAAC,CAAC;AACd,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,sBAAsB;IACpC,OAAO,GAAG,cAAc,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAa;IAChD,MAAM,MAAM,GAAG,IAAiC,CAAC;IACjD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACjD,CAAC"}

package/dist/signals/list.d.ts

@@ -0,0 +1,10 @@
+/**
+ * listSignals — page through `signals/{signalType}/` keys in an entity bucket
+ * and return typed summaries.
+ *
+ * `sourceRef` is surfaced on each summary when the caller passes
+ * `includeFrontmatter: true` (otherwise the field is undefined).
+ */
+import type { ListSignalsOptions, ListSignalsResult } from "./types.js";
+export declare function listSignals(opts: ListSignalsOptions): Promise<ListSignalsResult>;
+//# sourceMappingURL=list.d.ts.map

package/dist/signals/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/signals/list.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAapB,wBAAsB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA2DtF"}