@indigoai-us/hq-cloud 5.19.1 → 5.20.0

package/dist/entity-resolver.test.js

@@ -0,0 +1,236 @@
+/**
+ * Unit tests for entity-resolver.ts — slug → EntityContext resolution.
+ *
+ * Mocks globalThis.fetch to simulate vault-service responses for:
+ *   GET  /membership/me          → list memberships
+ *   GET  /entity/{uid}           → entity info (slug, bucketName)
+ *   POST /entities/{uid}/sts     → STS credentials
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { resolveEntity, listAvailableEntities, EntityNotFoundError, EntityPermissionError, EntityResolutionError, } from "./entity-resolver.js";
+// ---------------------------------------------------------------------------
+// Test fixtures
+// ---------------------------------------------------------------------------
+const VAULT_CONFIG = {
+    apiUrl: "https://vault.test",
+    authToken: "test-jwt",
+    region: "us-east-1",
+};
+const ENTITIES = {
+    indigo: {
+        uid: "cmp_indigo_001",
+        slug: "indigo",
+        type: "company",
+        name: "Indigo",
+        bucketName: "hq-vault-indigo",
+        status: "active",
+    },
+    personal: {
+        uid: "cmp_personal_001",
+        slug: "personal",
+        type: "person",
+        name: "Stefan",
+        bucketName: "hq-vault-personal",
+        status: "active",
+    },
+};
+const STS_CREDS = {
+    credentials: {
+        accessKeyId: "ASIAMOCK000000000001",
+        secretAccessKey: "mockSecret",
+        sessionToken: "mockSession",
+    },
+    expiresAt: new Date(Date.now() + 3600_000).toISOString(),
+    bucketName: "hq-vault-indigo",
+    region: "us-east-1",
+};
+// ---------------------------------------------------------------------------
+// Mock helpers
+// ---------------------------------------------------------------------------
+function json(body, status = 200) {
+    return new Response(JSON.stringify(body), {
+        status,
+        headers: { "Content-Type": "application/json" },
+    });
+}
+function setupFetchMock(opts = {}) {
+    const memberships = opts.memberships ?? [
+        { companyUid: "cmp_indigo_001", role: "owner" },
+        { companyUid: "cmp_personal_001", role: "owner" },
+    ];
+    const entities = opts.entities ?? {
+        cmp_indigo_001: ENTITIES.indigo,
+        cmp_personal_001: ENTITIES.personal,
+    };
+    const fetchMock = vi.fn(async (input, init) => {
+        const url = typeof input === "string" ? input : input.toString();
+        const method = (init?.method ?? "GET").toUpperCase();
+        // GET /membership/me
+        if (method === "GET" && url.endsWith("/membership/me")) {
+            return json({
+                memberships: memberships.map((m) => ({
+                    membershipKey: `mbr_${m.companyUid}`,
+                    personUid: "prs_test_001",
+                    companyUid: m.companyUid,
+                    role: m.role,
+                    status: "active",
+                    invitedBy: "system",
+                    invitedAt: "2026-01-01T00:00:00Z",
+                    createdAt: "2026-01-01T00:00:00Z",
+                    updatedAt: "2026-01-01T00:00:00Z",
+                })),
+            });
+        }
+        // GET /entity/{uid}
+        const entityGetMatch = /\/entity\/([^/?]+)$/.exec(url);
+        if (method === "GET" && entityGetMatch) {
+            const uid = decodeURIComponent(entityGetMatch[1]);
+            const entity = entities[uid];
+            if (!entity || opts.entityStatus === 404) {
+                return json({ error: "Not found" }, opts.entityStatus ?? 404);
+            }
+            return json({ entity });
+        }
+        // POST /entities/{uid}/sts
+        const stsMatch = /\/entities\/([^/]+)\/sts/.exec(url);
+        if (method === "POST" && stsMatch) {
+            const uid = decodeURIComponent(stsMatch[1]);
+            if (opts.stsStatus && opts.stsStatus >= 400) {
+                const body = opts.stsBody ?? { error: `STS error ${opts.stsStatus}` };
+                return json(body, opts.stsStatus);
+            }
+            const entity = entities[uid];
+            return json(opts.stsBody ?? {
+                ...STS_CREDS,
+                bucketName: entity?.bucketName ?? STS_CREDS.bucketName,
+            });
+        }
+        return json({ error: `Unhandled: ${method} ${url}` }, 500);
+    });
+    vi.stubGlobal("fetch", fetchMock);
+    return fetchMock;
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+beforeEach(() => {
+    vi.restoreAllMocks();
+});
+afterEach(() => {
+    vi.restoreAllMocks();
+});
+describe("resolveEntity", () => {
+    it("resolves entity by slug (happy path)", async () => {
+        setupFetchMock();
+        const ctx = await resolveEntity({ slug: "indigo", vaultConfig: VAULT_CONFIG });
+        expect(ctx.uid).toBe("cmp_indigo_001");
+        expect(ctx.slug).toBe("indigo");
+        expect(ctx.bucketName).toBe("hq-vault-indigo");
+        expect(ctx.region).toBe("us-east-1");
+        expect(ctx.credentials.accessKeyId).toBe("ASIAMOCK000000000001");
+        expect(ctx.credentials.secretAccessKey).toBe("mockSecret");
+        expect(ctx.credentials.sessionToken).toBe("mockSession");
+        expect(ctx.expiresAt).toBeTruthy();
+    });
+    it("resolves 'personal' slug without special-casing", async () => {
+        setupFetchMock();
+        const ctx = await resolveEntity({ slug: "personal", vaultConfig: VAULT_CONFIG });
+        expect(ctx.uid).toBe("cmp_personal_001");
+        expect(ctx.slug).toBe("personal");
+        expect(ctx.bucketName).toBe("hq-vault-personal");
+    });
+    it("throws EntityNotFoundError when slug not found", async () => {
+        setupFetchMock();
+        await expect(resolveEntity({ slug: "unknown", vaultConfig: VAULT_CONFIG })).rejects.toThrow(EntityNotFoundError);
+        try {
+            await resolveEntity({ slug: "unknown", vaultConfig: VAULT_CONFIG });
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(EntityNotFoundError);
+            const e = err;
+            expect(e.message).toContain("unknown");
+            expect(e.message).toContain("indigo");
+            expect(e.message).toContain("personal");
+        }
+    });
+    it("throws EntityNotFoundError with (none) when user has no memberships", async () => {
+        setupFetchMock({ memberships: [] });
+        await expect(resolveEntity({ slug: "indigo", vaultConfig: VAULT_CONFIG })).rejects.toThrow(EntityNotFoundError);
+        try {
+            await resolveEntity({ slug: "indigo", vaultConfig: VAULT_CONFIG });
+        }
+        catch (err) {
+            expect(err.message).toContain("(none)");
+        }
+    });
+    it("throws EntityPermissionError on 403 from STS", async () => {
+        setupFetchMock({ stsStatus: 403, stsBody: { error: "Permission denied" } });
+        await expect(resolveEntity({ slug: "indigo", vaultConfig: VAULT_CONFIG })).rejects.toThrow(EntityPermissionError);
+    });
+    it("throws EntityResolutionError on 500 from STS", async () => {
+        setupFetchMock({ stsStatus: 500, stsBody: { error: "Internal error" } });
+        let caught;
+        try {
+            await resolveEntity({ slug: "indigo", vaultConfig: VAULT_CONFIG });
+        }
+        catch (err) {
+            caught = err;
+        }
+        expect(caught).toBeInstanceOf(EntityResolutionError);
+        expect(caught.statusCode).toBe(500);
+    }, 15_000);
+    it("rejects slug case-mismatch (case-sensitive)", async () => {
+        setupFetchMock();
+        await expect(resolveEntity({ slug: "Indigo", vaultConfig: VAULT_CONFIG })).rejects.toThrow(EntityNotFoundError);
+        try {
+            await resolveEntity({ slug: "Indigo", vaultConfig: VAULT_CONFIG });
+        }
+        catch (err) {
+            expect(err.message).toContain("Indigo");
+            expect(err.message).toContain("indigo");
+        }
+    });
+    it("throws EntityResolutionError when entity has no bucket", async () => {
+        setupFetchMock({
+            entities: {
+                cmp_indigo_001: { ...ENTITIES.indigo, bucketName: undefined },
+                cmp_personal_001: ENTITIES.personal,
+            },
+        });
+        await expect(resolveEntity({ slug: "indigo", vaultConfig: VAULT_CONFIG })).rejects.toThrow(EntityResolutionError);
+        try {
+            await resolveEntity({ slug: "indigo", vaultConfig: VAULT_CONFIG });
+        }
+        catch (err) {
+            expect(err.message).toContain("no bucket provisioned");
+        }
+    });
+});
+describe("listAvailableEntities", () => {
+    it("returns all available entities with slug, uid, and role", async () => {
+        setupFetchMock();
+        const entities = await listAvailableEntities({ vaultConfig: VAULT_CONFIG });
+        expect(entities).toHaveLength(2);
+        expect(entities).toEqual(expect.arrayContaining([
+            { slug: "indigo", uid: "cmp_indigo_001", role: "owner" },
+            { slug: "personal", uid: "cmp_personal_001", role: "owner" },
+        ]));
+    });
+    it("returns empty array when user has no memberships", async () => {
+        setupFetchMock({ memberships: [] });
+        const entities = await listAvailableEntities({ vaultConfig: VAULT_CONFIG });
+        expect(entities).toEqual([]);
+    });
+    it("preserves role from membership", async () => {
+        setupFetchMock({
+            memberships: [
+                { companyUid: "cmp_indigo_001", role: "member" },
+            ],
+            entities: { cmp_indigo_001: ENTITIES.indigo },
+        });
+        const entities = await listAvailableEntities({ vaultConfig: VAULT_CONFIG });
+        expect(entities).toHaveLength(1);
+        expect(entities[0].role).toBe("member");
+    });
+});
+//# sourceMappingURL=entity-resolver.test.js.map

package/dist/entity-resolver.test.js.map

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

package/dist/index.d.ts

@@ -14,7 +14,9 @@ export type { CognitoAuthConfig, CognitoTokens } from "./cognito-auth.js";
 export { PERSONAL_VAULT_EXCLUDED_TOP_LEVEL, computePersonalVaultPaths, } from "./personal-vault.js";
 export { VaultClient, pickCanonicalPersonEntity } from "./vault-client.js";
 export { VaultClientError, VaultAuthError, VaultPermissionDeniedError, VaultNotFoundError, VaultConflictError, } from "./vault-client.js";
-export type { MembershipRole, MembershipStatus, Membership, CreateInviteInput, CreateInviteResult, AcceptInviteResult, UpdateRoleInput, EntityInfo, CreateEntityInput, CreateEntityResult, PendingInviteByEmail, } from "./vault-client.js";
+export type { MembershipRole, MembershipStatus, Membership, CreateInviteInput, CreateInviteResult, AcceptInviteResult, UpdateRoleInput, EntityInfo, CreateEntityInput, CreateEntityResult, PendingInviteByEmail, TelemetryOptInResponse, UsageBatch, UsageIngestResult, } from "./vault-client.js";
+export { collectAndSendTelemetry, sanitizeRow } from "./telemetry.js";
+export type { CollectTelemetryOptions, CollectTelemetryResult, TelemetryClientSurface, } from "./telemetry.js";
 export type { TaskAction, TaskScope, VendChildInput, VendChildResult, StsChildCredentials, } from "./vault-client.js";
 export { share, sync } from "./cli/index.js";
 export type { ShareOptions, ShareResult, SyncOptions, SyncResult, SyncProgressEvent } from "./cli/index.js";
@@ -28,4 +30,19 @@ export { promote } from "./cli/index.js";
 export type { PromoteOptions, PromoteResult } from "./cli/index.js";
 export type { EntityContext, VaultCredentials, VaultServiceConfig, ClientInfo, SyncConfig, Credentials, JournalEntry, SyncJournal, SyncStatus, PushResult, PullResult, DaemonState, } from "./types.js";
 export { buildClientHeaders, clientInfoFromPackage, detectHqCoreVersion, HEADER_CLIENT_NAME, HEADER_CLIENT_VERSION, HEADER_HQ_CORE_VERSION, } from "./client-info.js";
+export { SOURCE_CHANNELS, isSourceChannel, assertSourceChannel, InvalidSourceChannelError, } from "./schemas/source-channels.js";
+export type { SourceChannel } from "./schemas/source-channels.js";
+export { SIGNAL_TYPES, isSignalType, assertSignalType, InvalidSignalTypeError, } from "./schemas/signal-types.js";
+export type { SignalType } from "./schemas/signal-types.js";
+export { resolveEntity, listAvailableEntities, EntityNotFoundError, EntityPermissionError, EntityResolutionError, } from "./entity-resolver.js";
+export type { AvailableEntity } from "./entity-resolver.js";
+export type { EntityStsResult } from "./vault-client.js";
+export { listSources } from "./sources/list.js";
+export { getSource, SourceNotFoundError } from "./sources/get.js";
+export type { SourceSummary, SourceDocument, ListSourcesOptions, ListSourcesResult, GetSourceOptions, } from "./sources/types.js";
+export { _setSourcesS3Factory, _resetSourcesS3Factory, } from "./sources/internals.js";
+export { listSignals } from "./signals/list.js";
+export { getSignal, SignalNotFoundError } from "./signals/get.js";
+export type { SignalSummary, SignalDocument, ListSignalsOptions, ListSignalsResult, GetSignalOptions, } from "./signals/types.js";
+export { _setSignalsS3Factory, _resetSignalsS3Factory, } from "./signals/internals.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,UAAU,EACV,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,cAAc,GACf,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAExD,OAAO,EACL,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,WAAW,EACX,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAG1E,OAAO,EACL,iCAAiC,EACjC,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,WAAW,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,UAAU,EACV,SAAS,EACT,cAAc,EACd,eAAe,EACf,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC5G,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGzF,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1G,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACpD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpE,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,GACZ,MAAM,YAAY,CAAC;AAIpB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -15,6 +15,10 @@ export { PERSONAL_VAULT_EXCLUDED_TOP_LEVEL, computePersonalVaultPaths, } from ".
 // VaultClient SDK (VLT-7)
 export { VaultClient, pickCanonicalPersonEntity } from "./vault-client.js";
 export { VaultClientError, VaultAuthError, VaultPermissionDeniedError, VaultNotFoundError, VaultConflictError, } from "./vault-client.js";
+// Usage telemetry collector (`/v1/usage`). Re-exported so wrappers other than
+// `hq-sync-runner` (mobile, custom CLIs) can run the collector on their own
+// schedule without re-implementing the cursor + sanitizer.
+export { collectAndSendTelemetry, sanitizeRow } from "./telemetry.js";
 // CLI commands
 export { share, sync } from "./cli/index.js";
 export { resolveConflict, showDiff } from "./cli/index.js";
@@ -25,4 +29,21 @@ export { promote } from "./cli/index.js";
 // Client identification — every first-party caller should construct one of
 // these once at startup and pass it in via VaultServiceConfig.clientInfo.
 export { buildClientHeaders, clientInfoFromPackage, detectHqCoreVersion, HEADER_CLIENT_NAME, HEADER_CLIENT_VERSION, HEADER_HQ_CORE_VERSION, } from "./client-info.js";
+// Source-channel + signal-type schemas (SoT)
+export { SOURCE_CHANNELS, isSourceChannel, assertSourceChannel, InvalidSourceChannelError, } from "./schemas/source-channels.js";
+export { SIGNAL_TYPES, isSignalType, assertSignalType, InvalidSignalTypeError, } from "./schemas/signal-types.js";
+// Entity resolver (sources/signals slug → EntityContext)
+export { resolveEntity, listAvailableEntities, EntityNotFoundError, EntityPermissionError, EntityResolutionError, } from "./entity-resolver.js";
+// Sources read surface
+export { listSources } from "./sources/list.js";
+export { getSource, SourceNotFoundError } from "./sources/get.js";
+// Test-only S3 factory hook for sources (consumed by hq-cli tests).
+// Underscore prefix signals "not for production use".
+export { _setSourcesS3Factory, _resetSourcesS3Factory, } from "./sources/internals.js";
+// Signals read surface
+export { listSignals } from "./signals/list.js";
+export { getSignal, SignalNotFoundError } from "./signals/get.js";
+// Test-only S3 factory hook for signals (consumed by hq-cli tests).
+// Underscore prefix signals "not for production use".
+export { _setSignalsS3Factory, _resetSignalsS3Factory, } from "./signals/internals.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,UAAU,EACV,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,cAAc,GACf,MAAM,SAAS,CAAC;AAIjB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,WAAW,EACX,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,gCAAgC;AAChC,OAAO,EACL,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAG3B,6EAA6E;AAC7E,OAAO,EACL,iCAAiC,EACjC,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,0BAA0B;AAC1B,OAAO,EAAE,WAAW,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAwB3B,eAAe;AACf,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG3D,kCAAkC;AAClC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAkBzC,2EAA2E;AAC3E,0EAA0E;AAC1E,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,UAAU,EACV,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,cAAc,GACf,MAAM,SAAS,CAAC;AAIjB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,WAAW,EACX,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,gCAAgC;AAChC,OAAO,EACL,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAG3B,6EAA6E;AAC7E,OAAO,EACL,iCAAiC,EACjC,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,0BAA0B;AAC1B,OAAO,EAAE,WAAW,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAkB3B,8EAA8E;AAC9E,4EAA4E;AAC5E,2DAA2D;AAC3D,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAgBtE,eAAe;AACf,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG3D,kCAAkC;AAClC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAkBzC,2EAA2E;AAC3E,0EAA0E;AAC1E,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,6CAA6C;AAC7C,OAAO,EACL,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,2BAA2B,CAAC;AAGnC,yDAAyD;AACzD,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAM9B,uBAAuB;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AASlE,oEAAoE;AACpE,sDAAsD;AACtD,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAEhC,uBAAuB;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AASlE,oEAAoE;AACpE,sDAAsD;AACtD,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * 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 declare const SIGNAL_TYPES: readonly ["action_item", "commitment", "decision", "key_point", "risk", "summary"];
+export type SignalType = (typeof SIGNAL_TYPES)[number];
+export declare class InvalidSignalTypeError extends Error {
+    readonly name = "InvalidSignalTypeError";
+    constructor(value: unknown);
+}
+export declare function isSignalType(value: unknown): value is SignalType;
+export declare function assertSignalType(value: unknown): asserts value is SignalType;
+//# sourceMappingURL=signal-types.d.ts.map

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"}