@vibesdotdev/hq 0.0.0-stage → 1.0.0-rc.2

package/dist/friction/schemas/signal.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Friction Signal Schema
+ *
+ * One typed row per "something could be better" observation, agent- or
+ * user-sourced. Matches the "Data shape" section of
+ * the friction discovery intake.
+ *
+ * Schema style mirrors `surface/schemas/artifact.ts` — Zod v4, with the
+ * inferred TypeScript type exported alongside the schema.
+ */
+import * as z from 'zod/v4';
+export declare const FrictionSourceSchema: z.ZodEnum<{
+    "agent-self-observed": "agent-self-observed";
+    "agent-watched-user": "agent-watched-user";
+    "rum-error": "rum-error";
+    "chat-confusion": "chat-confusion";
+    "incomplete-marker": "incomplete-marker";
+    "user-explicit": "user-explicit";
+    "support-ticket": "support-ticket";
+    "telemetry-signal": "telemetry-signal";
+}>;
+export declare const FrictionAudienceSchema: z.ZodEnum<{
+    user: "user";
+    agent: "agent";
+    both: "both";
+}>;
+export declare const FrictionSeveritySchema: z.ZodEnum<{
+    blocker: "blocker";
+    annoyance: "annoyance";
+    "nice-to-have": "nice-to-have";
+    confusion: "confusion";
+}>;
+export declare const FrictionPersonalDataLevelSchema: z.ZodEnum<{
+    redacted: "redacted";
+    none: "none";
+    identified: "identified";
+}>;
+export declare const FrictionEvidenceLinkKindSchema: z.ZodEnum<{
+    url: "url";
+    other: "other";
+    "session-id": "session-id";
+    "run-id": "run-id";
+    "file-line": "file-line";
+    "ticket-id": "ticket-id";
+    "error-event-id": "error-event-id";
+    "commit-sha": "commit-sha";
+    "friction-signal": "friction-signal";
+}>;
+export declare const FrictionEvidenceLinkSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        url: "url";
+        other: "other";
+        "session-id": "session-id";
+        "run-id": "run-id";
+        "file-line": "file-line";
+        "ticket-id": "ticket-id";
+        "error-event-id": "error-event-id";
+        "commit-sha": "commit-sha";
+        "friction-signal": "friction-signal";
+    }>;
+    ref: z.ZodString;
+}, z.core.$strip>;
+export declare const FrictionSignalSchema: z.ZodObject<{
+    id: z.ZodString;
+    orgId: z.ZodString;
+    source: z.ZodEnum<{
+        "agent-self-observed": "agent-self-observed";
+        "agent-watched-user": "agent-watched-user";
+        "rum-error": "rum-error";
+        "chat-confusion": "chat-confusion";
+        "incomplete-marker": "incomplete-marker";
+        "user-explicit": "user-explicit";
+        "support-ticket": "support-ticket";
+        "telemetry-signal": "telemetry-signal";
+    }>;
+    audience: z.ZodEnum<{
+        user: "user";
+        agent: "agent";
+        both: "both";
+    }>;
+    surface: z.ZodString;
+    severity: z.ZodEnum<{
+        blocker: "blocker";
+        annoyance: "annoyance";
+        "nice-to-have": "nice-to-have";
+        confusion: "confusion";
+    }>;
+    observed: z.ZodString;
+    expected: z.ZodOptional<z.ZodString>;
+    repro: z.ZodOptional<z.ZodString>;
+    workaround: z.ZodOptional<z.ZodString>;
+    evidenceLinks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            url: "url";
+            other: "other";
+            "session-id": "session-id";
+            "run-id": "run-id";
+            "file-line": "file-line";
+            "ticket-id": "ticket-id";
+            "error-event-id": "error-event-id";
+            "commit-sha": "commit-sha";
+            "friction-signal": "friction-signal";
+        }>;
+        ref: z.ZodString;
+    }, z.core.$strip>>>;
+    evidence: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>;
+    context: z.ZodOptional<z.ZodObject<{
+        route: z.ZodString;
+        url: z.ZodString;
+        appVersion: z.ZodOptional<z.ZodString>;
+        viewport: z.ZodOptional<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>>;
+        userAgent: z.ZodOptional<z.ZodString>;
+        locale: z.ZodOptional<z.ZodString>;
+        errors: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            message: z.ZodString;
+            stack: z.ZodOptional<z.ZodString>;
+            at: z.ZodString;
+            source: z.ZodEnum<{
+                request: "request";
+                sveltekit: "sveltekit";
+                "window.onerror": "window.onerror";
+                unhandledrejection: "unhandledrejection";
+            }>;
+        }, z.core.$strict>>>;
+        attachments: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            uploadId: z.ZodString;
+            kind: z.ZodEnum<{
+                file: "file";
+                screenshot: "screenshot";
+            }>;
+        }, z.core.$strict>>>;
+        appClientId: z.ZodOptional<z.ZodString>;
+        tenancy: z.ZodOptional<z.ZodEnum<{
+            caller: "caller";
+            "app-owner": "app-owner";
+            "upstream-fallback": "upstream-fallback";
+            "upstream-copy": "upstream-copy";
+            "dev-loopback": "dev-loopback";
+        }>>;
+        reporterOrgId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    signatureHash: z.ZodString;
+    fingerprintVersion: z.ZodOptional<z.ZodNumber>;
+    fingerprint: z.ZodOptional<z.ZodString>;
+    occurrenceId: z.ZodOptional<z.ZodString>;
+    occurrenceCount: z.ZodOptional<z.ZodNumber>;
+    firstSeenAt: z.ZodOptional<z.ZodString>;
+    lastSeenAt: z.ZodOptional<z.ZodString>;
+    occurrenceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    personalDataLevel: z.ZodEnum<{
+        redacted: "redacted";
+        none: "none";
+        identified: "identified";
+    }>;
+    createdAt: z.ZodString;
+    createdBy: z.ZodString;
+    agentRunId: z.ZodOptional<z.ZodString>;
+    userSessionId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type FrictionSource = z.infer<typeof FrictionSourceSchema>;
+export type FrictionAudience = z.infer<typeof FrictionAudienceSchema>;
+export type FrictionSeverity = z.infer<typeof FrictionSeveritySchema>;
+export type FrictionPersonalDataLevel = z.infer<typeof FrictionPersonalDataLevelSchema>;
+export type FrictionEvidenceLinkKind = z.infer<typeof FrictionEvidenceLinkKindSchema>;
+export type FrictionEvidenceLink = z.infer<typeof FrictionEvidenceLinkSchema>;
+export type FrictionSignal = z.infer<typeof FrictionSignalSchema>;
+//# sourceMappingURL=signal.d.ts.map

package/dist/friction/schemas/signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../../src/friction/schemas/signal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B,eAAO,MAAM,oBAAoB;;;;;;;;;EAS/B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;EAAoC,CAAC;AAExE,eAAO,MAAM,sBAAsB;;;;;EAAgE,CAAC;AAEpG,eAAO,MAAM,+BAA+B;;;;EAA6C,CAAC;AAE1F,eAAO,MAAM,8BAA8B;;;;;;;;;;EAWzC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;iBAGrC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiC/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACxF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AACtF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/friction/schemas/signal.js

@@ -0,0 +1,77 @@
+/**
+ * Friction Signal Schema
+ *
+ * One typed row per "something could be better" observation, agent- or
+ * user-sourced. Matches the "Data shape" section of
+ * the friction discovery intake.
+ *
+ * Schema style mirrors `surface/schemas/artifact.ts` — Zod v4, with the
+ * inferred TypeScript type exported alongside the schema.
+ */
+import * as z from 'zod/v4';
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import { FrictionReportContextSchema } from "./report.js";
+export const FrictionSourceSchema = z.enum([
+    'agent-self-observed',
+    'agent-watched-user',
+    'rum-error',
+    'chat-confusion',
+    'incomplete-marker',
+    'user-explicit',
+    'support-ticket',
+    'telemetry-signal'
+]);
+export const FrictionAudienceSchema = z.enum(['agent', 'user', 'both']);
+export const FrictionSeveritySchema = z.enum(['blocker', 'annoyance', 'nice-to-have', 'confusion']);
+export const FrictionPersonalDataLevelSchema = z.enum(['none', 'redacted', 'identified']);
+export const FrictionEvidenceLinkKindSchema = z.enum([
+    'session-id',
+    'run-id',
+    'file-line',
+    'ticket-id',
+    'error-event-id',
+    'url',
+    'commit-sha',
+    /** Another friction signal, e.g. an upstream copy's original. The ref is `<orgId>/<signalId>`. */
+    'friction-signal',
+    'other'
+]);
+export const FrictionEvidenceLinkSchema = z.object({
+    kind: FrictionEvidenceLinkKindSchema,
+    ref: z.string().min(1)
+});
+export const FrictionSignalSchema = z.object({
+    id: z.string().min(1),
+    orgId: z.string().min(1),
+    source: FrictionSourceSchema,
+    audience: FrictionAudienceSchema,
+    surface: z.string().min(1),
+    severity: FrictionSeveritySchema,
+    observed: z.string().min(1),
+    expected: z.string().optional(),
+    repro: z.string().optional(),
+    workaround: z.string().optional(),
+    evidenceLinks: z.array(FrictionEvidenceLinkSchema).default([]),
+    evidence: JsonValueSchema.optional(),
+    /** Typed page context of a reported problem (record v2). Absent on v1 rows and non-report emits. */
+    context: FrictionReportContextSchema.optional(),
+    signatureHash: z.string().min(1),
+    /** Version of the causal fingerprint algorithm used for signatureHash. */
+    fingerprintVersion: z.number().int().positive().optional(),
+    /** Canonical versioned fingerprint. Kept separate from signatureHash for migration compatibility. */
+    fingerprint: z.string().min(1).optional(),
+    /** Stable tenant-scoped identity for one observation/replayable emit. */
+    occurrenceId: z.string().min(1).optional(),
+    /** Aggregate projection fields populated by the storage merge. */
+    occurrenceCount: z.number().int().positive().optional(),
+    firstSeenAt: z.string().optional(),
+    lastSeenAt: z.string().optional(),
+    /** Consumer-local fallback ledger when no occurrence record adapter is available. */
+    occurrenceIds: z.array(z.string().min(1)).optional(),
+    personalDataLevel: FrictionPersonalDataLevelSchema,
+    createdAt: z.string(),
+    createdBy: z.string().min(1),
+    agentRunId: z.string().optional(),
+    userSessionId: z.string().optional()
+});
+//# sourceMappingURL=signal.js.map

package/dist/friction/schemas/signal.js.map

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

package/dist/friction/signal-recorded.event.descriptor.d.ts

@@ -0,0 +1,53 @@
+/**
+ * `hq.friction.signal-recorded`: the package intake wrote a friction signal
+ * (a new aggregate or a merged occurrence). Promotion (P3) and code sessions
+ * (P4) subscribe here. The payload names the row; it carries no report text.
+ */
+import * as z from 'zod/v4';
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+export declare const FRICTION_SIGNAL_RECORDED_SOURCE = "hq.friction";
+export declare const FRICTION_SIGNAL_RECORDED_EVENT_NAME = "signal-recorded";
+export declare const FRICTION_SIGNAL_RECORDED_EVENT_ID = "hq.friction.signal-recorded";
+export declare const FrictionSignalRecordedEventSchema: z.ZodObject<{
+    signalId: z.ZodString;
+    orgId: z.ZodString;
+    source: z.ZodEnum<{
+        "agent-self-observed": "agent-self-observed";
+        "agent-watched-user": "agent-watched-user";
+        "rum-error": "rum-error";
+        "chat-confusion": "chat-confusion";
+        "incomplete-marker": "incomplete-marker";
+        "user-explicit": "user-explicit";
+        "support-ticket": "support-ticket";
+        "telemetry-signal": "telemetry-signal";
+    }>;
+    severity: z.ZodEnum<{
+        blocker: "blocker";
+        annoyance: "annoyance";
+        "nice-to-have": "nice-to-have";
+        confusion: "confusion";
+    }>;
+    fingerprint: z.ZodString;
+    occurrenceCount: z.ZodNumber;
+    tenancy: z.ZodOptional<z.ZodEnum<{
+        caller: "caller";
+        "app-owner": "app-owner";
+        "upstream-fallback": "upstream-fallback";
+        "upstream-copy": "upstream-copy";
+        "dev-loopback": "dev-loopback";
+    }>>;
+    upstreamOf: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type FrictionSignalRecordedEvent = z.infer<typeof FrictionSignalRecordedEventSchema>;
+declare const _default: {
+    kind: "runtime/event";
+    id: string;
+    source: string;
+    name: string;
+    description: string;
+    trigger: string;
+};
+export default _default;
+/** Publish on the runtime hook bus after a durable write. */
+export declare function emitFrictionSignalRecorded(runtime: RuntimeRef, event: FrictionSignalRecordedEvent): Promise<void>;
+//# sourceMappingURL=signal-recorded.event.descriptor.d.ts.map

package/dist/friction/signal-recorded.event.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-recorded.event.descriptor.d.ts","sourceRoot":"","sources":["../../src/friction/signal-recorded.event.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAI1E,eAAO,MAAM,+BAA+B,gBAAgB,CAAC;AAC7D,eAAO,MAAM,mCAAmC,oBAAoB,CAAC;AACrE,eAAO,MAAM,iCAAiC,gCAAgC,CAAC;AAE/E,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAU5C,CAAC;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;;;;;;;;;AAE5F,wBAQG;AAEH,6DAA6D;AAC7D,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvH"}

package/dist/friction/signal-recorded.event.descriptor.js

@@ -0,0 +1,38 @@
+/**
+ * `hq.friction.signal-recorded`: the package intake wrote a friction signal
+ * (a new aggregate or a merged occurrence). Promotion (P3) and code sessions
+ * (P4) subscribe here. The payload names the row; it carries no report text.
+ */
+import * as z from 'zod/v4';
+import { createRuntimeAsset } from '@vibesdotdev/kernel';
+import { FrictionSeveritySchema, FrictionSourceSchema } from "./schemas/signal.js";
+import { FrictionReportTenancySchema } from "./schemas/report.js";
+export const FRICTION_SIGNAL_RECORDED_SOURCE = 'hq.friction';
+export const FRICTION_SIGNAL_RECORDED_EVENT_NAME = 'signal-recorded';
+export const FRICTION_SIGNAL_RECORDED_EVENT_ID = 'hq.friction.signal-recorded';
+export const FrictionSignalRecordedEventSchema = z.strictObject({
+    signalId: z.string().min(1),
+    orgId: z.string().min(1),
+    source: FrictionSourceSchema,
+    severity: FrictionSeveritySchema,
+    fingerprint: z.string().min(1),
+    occurrenceCount: z.number().int().positive(),
+    tenancy: FrictionReportTenancySchema.optional(),
+    /** For an upstream copy, the original report as `<orgId>/<signalId>`. */
+    upstreamOf: z.string().min(1).optional()
+});
+export default createRuntimeAsset({
+    kind: 'runtime/event',
+    id: FRICTION_SIGNAL_RECORDED_EVENT_ID,
+    source: FRICTION_SIGNAL_RECORDED_SOURCE,
+    name: 'Friction signal recorded',
+    description: 'The HQ friction intake recorded a signal or a merged occurrence. Payload: signalId, orgId, source, severity, fingerprint, occurrenceCount, tenancy, upstreamOf.',
+    trigger: 'custom'
+});
+/** Publish on the runtime hook bus after a durable write. */
+export async function emitFrictionSignalRecorded(runtime, event) {
+    await runtime
+        .hooks(FRICTION_SIGNAL_RECORDED_SOURCE)
+        .emit(FRICTION_SIGNAL_RECORDED_EVENT_NAME, FrictionSignalRecordedEventSchema.parse(event));
+}
+//# sourceMappingURL=signal-recorded.event.descriptor.js.map

package/dist/friction/signal-recorded.event.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-recorded.event.descriptor.js","sourceRoot":"","sources":["../../src/friction/signal-recorded.event.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAmB,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,CAAC,MAAM,+BAA+B,GAAG,aAAa,CAAC;AAC7D,MAAM,CAAC,MAAM,mCAAmC,GAAG,iBAAiB,CAAC;AACrE,MAAM,CAAC,MAAM,iCAAiC,GAAG,6BAA6B,CAAC;AAE/E,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,YAAY,CAAC;IAC/D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,MAAM,EAAE,oBAAoB;IAC5B,QAAQ,EAAE,sBAAsB;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC5C,OAAO,EAAE,2BAA2B,CAAC,QAAQ,EAAE;IAC/C,yEAAyE;IACzE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAGH,eAAe,kBAAkB,CAAC;IACjC,IAAI,EAAE,eAAe;IACrB,EAAE,EAAE,iCAAiC;IACrC,MAAM,EAAE,+BAA+B;IACvC,IAAI,EAAE,0BAA0B;IAChC,WAAW,EACV,iKAAiK;IAClK,OAAO,EAAE,QAAQ;CACjB,CAAC,CAAC;AAEH,6DAA6D;AAC7D,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,OAAmB,EAAE,KAAkC;IACvG,MAAM,OAAO;SACX,KAAK,CAAyE,+BAA+B,CAAC;SAC9G,IAAI,CAAC,mCAAmC,EAAE,iCAAiC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7F,CAAC"}

package/dist/friction/store.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Friction Signal Store
+ *
+ * Persists friction aggregates via the `os.friction-signals` storage/record
+ * descriptor. When no record is registered (early tests, pre-bootstrap
+ * callers), falls back to a filesystem layout under
+ * `<activeHome>/agent/friction/` via `filesystem/adapter`. Mirrors the layering
+ * used by `surface/store.ts`. Each causal fingerprint has one aggregate, and
+ * its occurrence ledger makes replayed emits idempotent.
+ *
+ * Reads return [] / undefined when no backend is available; writes throw a
+ * clear error so callers don't silently lose signals.
+ */
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { StorageRecordInterface } from '@vibesdotdev/storage/interfaces/record';
+import { type FrictionSignal } from './schemas/signal.ts';
+import { type FrictionDisposition } from './schemas/disposition.ts';
+/**
+ * The on-disk friction store directory: `<activeHome>/agent/friction`, from the
+ * runtime's path roots and joined by its path service (resolved per call, never
+ * cached). A runtime without path roots, a path service, or a local checkout
+ * (such as a cloud/controller runtime) fails with its owner's error.
+ */
+/** The runtime the friction store reads and writes through. */
+export type FrictionRuntime = RuntimeRef;
+export declare function getFrictionDir(runtime: FrictionRuntime): Promise<string>;
+export type FrictionRecord = StorageRecordInterface<FrictionSignal> & {
+    initialize?(): Promise<void>;
+};
+export type FrictionDispositionRecord = StorageRecordInterface<FrictionDisposition> & {
+    initialize?(): Promise<void>;
+};
+export type FrictionBackend = 'record' | 'spool';
+export type FrictionSignalWithBackend = FrictionSignal & {
+    backend: FrictionBackend;
+};
+export type FrictionAggregate = FrictionSignal & {
+    fingerprint: string;
+    fingerprintVersion: number;
+    occurrenceCount: number;
+    firstSeenAt: string;
+    lastSeenAt: string;
+    occurrenceIds: string[];
+};
+export interface FrictionBackendInfo {
+    record: {
+        live: boolean;
+        rowCount: number;
+    };
+    spool: {
+        live: boolean;
+        rowCount: number;
+    };
+}
+/**
+ * The enabled `os.friction-signals` record on `runtime`, or null when the host composes
+ * none (the one confirmed absence). A record that fails to load propagates.
+ */
+export declare function resolveFrictionRecord(runtime: FrictionRuntime): Promise<FrictionRecord | null>;
+/**
+ * The enabled `os.friction-dispositions` record on `runtime`, or null when the host composes
+ * none (the one confirmed absence). A record that fails to load propagates.
+ */
+export declare function resolveFrictionDispositionRecord(runtime: FrictionRuntime): Promise<FrictionDispositionRecord | null>;
+/** Normalize all legacy callers into the versioned aggregate input contract. */
+export declare function canonicalizeFrictionSignal(signal: FrictionSignal): Promise<FrictionAggregate>;
+/**
+ * Legacy signature hash for compatibility with pre-fingerprint callers and
+ * cluster projections. New writes overwrite it with the versioned causal
+ * fingerprint hash.
+ */
+export declare function computeSignatureHash(input: {
+    source: string;
+    surface: string;
+    observed: string;
+}): string;
+/**
+ * Tiny URL-safe id suffix. Avoids a new nanoid dependency on os.
+ * 12 base32 chars ≈ 60 bits — plenty for collision-free ids in this scope.
+ */
+export declare function generateFrictionId(): string;
+export declare function generateFrictionDispositionId(): string;
+/** Merge an aggregate into the record row sharing its org and fingerprint, or create it. */
+export declare function mergeRecordFrictionSignal(record: FrictionRecord, input: FrictionAggregate): Promise<FrictionAggregate>;
+export declare function writeFrictionSignal(runtime: FrictionRuntime, signal: FrictionSignal): Promise<FrictionSignalWithBackend>;
+export declare function appendDisposition(runtime: FrictionRuntime, input: Omit<FrictionDisposition, 'id' | 'createdAt'> & {
+    id?: string;
+    createdAt?: string;
+}): Promise<FrictionDisposition>;
+export declare function latestDispositionsBySignal(runtime: FrictionRuntime, signalIds: readonly string[]): Promise<Map<string, FrictionDisposition>>;
+export interface ListFrictionSignalsFilter {
+    orgId?: string;
+    source?: FrictionSignal['source'];
+    audience?: FrictionSignal['audience'];
+    surface?: string;
+    since?: string;
+    limit?: number;
+}
+export declare function listFrictionSignalsWithBackend(runtime: FrictionRuntime, filter?: ListFrictionSignalsFilter): Promise<FrictionSignalWithBackend[]>;
+export declare function listFrictionSignals(runtime: FrictionRuntime, filter?: ListFrictionSignalsFilter): Promise<FrictionSignal[]>;
+export declare function getFrictionSignal(runtime: FrictionRuntime, id: string, filter?: Pick<ListFrictionSignalsFilter, 'orgId'>): Promise<FrictionSignal | undefined>;
+export declare function frictionBackendInfo(runtime: FrictionRuntime): Promise<FrictionBackendInfo>;
+export declare function drainFrictionSpool(runtime: FrictionRuntime): Promise<{
+    moved: number;
+    skipped: number;
+    recordAvailable: boolean;
+}>;
+export declare function findFrictionSignalsBySignature(runtime: FrictionRuntime, signatureHash: string): Promise<FrictionSignal[]>;
+//# sourceMappingURL=store.d.ts.map

package/dist/friction/store.d.ts.map

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