@sixb/core 0.1.20 → 0.1.22

package/dist/shares/internal.js.map

@@ -4,7 +4,7 @@
   "sourcesContent": [
     "import { createHash, randomBytes, randomUUID, timingSafeEqual } from \"node:crypto\"\nimport { formatSessionCookieValue, parseSessionCookieValue } from \"../auth/sessions\"\nimport type { SixbHostView } from \"../runtime\"\nimport type { ShareGrantRecord, ShareSessionRecord, Storage } from \"../storage\"\nimport { ShareSessionStorageError } from \"../storage\"\nimport { type ShareAccessPlan, snapshotShareAccessPlan } from \"./access-plan\"\nimport { compileShareAccessPlan } from \"./compiler\"\nimport { intersectShareAccessPlans } from \"./intersection\"\n\nexport const DEFAULT_SHARED_SESSION_INACTIVITY_TTL_MS = 15 * 60_000\n\nconst MAX_CREATE_ATTEMPTS = 5\nconst SECRET_PATTERN = /^[A-Za-z0-9_-]{43}$/\n\nexport interface SharedSessionContext {\n  readonly grantId: string\n  readonly sessionId: string\n  readonly destinationPath: string\n  readonly access: ShareAccessPlan\n  readonly expiresAt: Date\n  readonly absoluteExpiresAt: Date\n}\n\nexport interface SharedSessionCredential {\n  readonly context: SharedSessionContext\n  /** Opaque value for the HttpOnly shared-session cookie. */\n  readonly cookieValue: string\n}\n\nexport interface SharedSessionProtocolOptions {\n  readonly host: SixbHostView\n  readonly inactivityTtlMs?: number\n  readonly now?: () => Date\n}\n\n/**\n * Framework-owned shared-session lifecycle.\n *\n * Link and session secrets are verified here. Callers receive only an effective access plan built\n * from the issued snapshot intersected with the Share definition registered now.\n */\nexport class SharedSessionProtocol {\n  private readonly host: SixbHostView\n  private readonly inactivityTtlMs: number\n  private readonly now: () => Date\n\n  constructor(options: SharedSessionProtocolOptions) {\n    if (!options.host.storage.shareGrants || !options.host.storage.shareSessions) {\n      throw new Error(\"[Sixb] Shared sessions require share grant and session storage.\")\n    }\n    const inactivityTtlMs = options.inactivityTtlMs ?? DEFAULT_SHARED_SESSION_INACTIVITY_TTL_MS\n    if (!Number.isSafeInteger(inactivityTtlMs) || inactivityTtlMs <= 0) {\n      throw new Error(\"[Sixb] Shared session inactivity TTL must be a positive integer.\")\n    }\n    this.host = options.host\n    this.inactivityTtlMs = inactivityTtlMs\n    this.now = options.now ?? (() => new Date())\n  }\n\n  async exchange(grantId: string, secret: string): Promise<SharedSessionCredential | null> {\n    if (!validIdentifier(grantId) || !validSecret(secret)) return null\n    const now = this.currentTime()\n\n    for (let attempt = 0; attempt < MAX_CREATE_ATTEMPTS; attempt += 1) {\n      const sessionSecret = randomBytes(32).toString(\"base64url\")\n      const sessionId = `shs_${randomUUID()}`\n      try {\n        const result = await this.host.storage.transaction(async (tx) => {\n          const grant = await activeGrant(tx, this.host.projectId, grantId, now)\n          const secretMatches = secretMatchesHash(secret, grant?.tokenHash ?? \"\")\n          if (!grant || !secretMatches) return null\n          const sessions = requireSessions(tx)\n          const absoluteExpiresAt = new Date(grant.expiresAt)\n          const session = await sessions.create({\n            id: sessionId,\n            projectId: this.host.projectId,\n            grantId: grant.id,\n            tokenHash: sha256(sessionSecret),\n            createdAt: now,\n            expiresAt: inactivityDeadline(now, absoluteExpiresAt, this.inactivityTtlMs),\n            absoluteExpiresAt,\n          })\n          return { grant, session }\n        })\n        if (!result) return null\n        return {\n          context: this.context(result.grant, result.session),\n          cookieValue: formatSessionCookieValue(sessionId, sessionSecret),\n        }\n      } catch (error) {\n        if (\n          error instanceof ShareSessionStorageError &&\n          error.code === \"duplicate\" &&\n          attempt < MAX_CREATE_ATTEMPTS - 1\n        ) {\n          continue\n        }\n        throw error\n      }\n    }\n\n    return null\n  }\n\n  async resolve(\n    grantId: string,\n    cookieValue: string | undefined,\n    options: { readonly activity?: \"background\" | \"foreground\" } = {}\n  ): Promise<SharedSessionContext | null> {\n    if (!validIdentifier(grantId) || !validCookieValue(cookieValue)) return null\n    const credential = parseSessionCookieValue(cookieValue)\n    if (\n      !credential ||\n      !validIdentifier(credential.sessionId) ||\n      !validSecret(credential.sessionSecret)\n    ) {\n      return null\n    }\n    const now = this.currentTime()\n    const tokenHash = sha256(credential.sessionSecret)\n\n    const result = await this.host.storage.transaction(async (tx) => {\n      const sessions = requireSessions(tx)\n      const current = await sessions.getById({\n        projectId: this.host.projectId,\n        id: credential.sessionId,\n      })\n      const secretMatches = secretMatchesHash(credential.sessionSecret, current?.tokenHash ?? \"\")\n      if (\n        !current ||\n        current.grantId !== grantId ||\n        current.revokedAt !== undefined ||\n        current.expiresAt.getTime() <= now.getTime() ||\n        current.absoluteExpiresAt.getTime() <= now.getTime() ||\n        !secretMatches\n      ) {\n        return null\n      }\n\n      const grant = await activeGrant(tx, this.host.projectId, grantId, now)\n      if (!grant || current.absoluteExpiresAt.getTime() !== grant.expiresAt.getTime()) {\n        return null\n      }\n\n      if (options.activity !== \"foreground\") return { grant, session: current }\n\n      const renewed = await sessions.renewIfValid({\n        projectId: this.host.projectId,\n        id: current.id,\n        grantId,\n        tokenHash,\n        now,\n        expiresAt: inactivityDeadline(now, current.absoluteExpiresAt, this.inactivityTtlMs),\n      })\n      return renewed ? { grant, session: renewed } : null\n    })\n\n    return result ? this.context(result.grant, result.session) : null\n  }\n\n  async revoke(context: Pick<SharedSessionContext, \"grantId\" | \"sessionId\">): Promise<void> {\n    const revokedAt = this.currentTime()\n    await this.host.storage.transaction(async (tx) => {\n      const session = await requireSessions(tx).getById({\n        projectId: this.host.projectId,\n        id: context.sessionId,\n      })\n      if (!session || session.grantId !== context.grantId) return\n      await requireSessions(tx).revoke({\n        projectId: this.host.projectId,\n        id: context.sessionId,\n        revokedAt,\n      })\n    })\n  }\n\n  private context(grant: ShareGrantRecord, session: ShareSessionRecord): SharedSessionContext {\n    return {\n      grantId: grant.id,\n      sessionId: session.id,\n      destinationPath: grant.destinationPath,\n      access: effectiveAccess(this.host, grant),\n      expiresAt: new Date(session.expiresAt),\n      absoluteExpiresAt: new Date(session.absoluteExpiresAt),\n    }\n  }\n\n  private currentTime(): Date {\n    const now = this.now()\n    if (!(now instanceof Date) || !Number.isFinite(now.getTime())) {\n      throw new Error(\"[Sixb] Shared session clock returned an invalid date.\")\n    }\n    return new Date(now)\n  }\n}\n\nfunction effectiveAccess(host: SixbHostView, grant: ShareGrantRecord): ShareAccessPlan {\n  const definition = host.definitions.shares.getById(grant.definitionId)\n  if (!definition || definition.target.objectTypeId !== grant.target.objectTypeId) {\n    return snapshotShareAccessPlan({ grants: [] })\n  }\n  const current = compileShareAccessPlan({\n    share: definition,\n    target: grant.target,\n    ontology: host.definitions.ontology,\n    actions: host.definitions.actions,\n  })\n  return intersectShareAccessPlans(grant.authoritySnapshot.access, current)\n}\n\nasync function activeGrant(\n  storage: Storage,\n  projectId: string,\n  grantId: string,\n  now: Date\n): Promise<ShareGrantRecord | null> {\n  const grant = await storage.shareGrants?.getById({ projectId, id: grantId })\n  return !grant || grant.revokedAt !== undefined || grant.expiresAt.getTime() <= now.getTime()\n    ? null\n    : grant\n}\n\nfunction requireSessions(storage: Storage): NonNullable<Storage[\"shareSessions\"]> {\n  if (!storage.shareSessions) {\n    throw new Error(\"[Sixb] Shared session storage is not configured.\")\n  }\n  return storage.shareSessions\n}\n\nfunction inactivityDeadline(now: Date, absolute: Date, ttlMs: number): Date {\n  return new Date(Math.min(absolute.getTime(), now.getTime() + ttlMs))\n}\n\nfunction secretMatchesHash(secret: string, expectedHash: string): boolean {\n  const actual = createHash(\"sha256\").update(secret).digest()\n  const expected = /^[0-9a-f]{64}$/.test(expectedHash)\n    ? Buffer.from(expectedHash, \"hex\")\n    : Buffer.alloc(actual.length)\n  return timingSafeEqual(actual, expected)\n}\n\nfunction sha256(value: string): string {\n  return createHash(\"sha256\").update(value).digest(\"hex\")\n}\n\nfunction validIdentifier(value: unknown): value is string {\n  return (\n    typeof value === \"string\" && value.length > 0 && value.length <= 128 && value.trim() === value\n  )\n}\n\nfunction validSecret(value: unknown): value is string {\n  return typeof value === \"string\" && SECRET_PATTERN.test(value)\n}\n\nfunction validCookieValue(value: unknown): value is string {\n  return typeof value === \"string\" && value.length <= 256\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "34911D02E010DC8E64756E2164756E21",
+  "mappings": "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",
+  "debugId": "83372A30799F0CDF64756E2164756E21",
   "names": []
 }

package/dist/storage/action-runs/failure.js

@@ -2,9 +2,9 @@
 import {
   serializeActionRunFailure2,
   parseActionRunFailure2
-} from "../../chunk-b38szspf.js";
-import"../../chunk-8mx7qw3y.js";
-import"../../chunk-z3y5kg1x.js";
+} from "../../chunk-c0vk1djt.js";
+import"../../chunk-zbc929zg.js";
+import"../../chunk-6eqsgvxk.js";
 export {
   parseActionRunFailure2 as parseActionRunFailure,
   serializeActionRunFailure2 as serializeActionRunFailure

package/dist/storage/action-runs/in-memory.d.ts

@@ -16,6 +16,10 @@ export declare class InMemoryActionRunStorage implements ActionRunStorage {
         projectId: string;
         id: string;
     }): Promise<ActionRunRecord | null>;
+    getByExecutionIds(params: {
+        readonly projectId: string;
+        readonly executionIds: readonly string[];
+    }): Promise<readonly ActionRunRecord[]>;
     list(input: ListActionRunsInput): Promise<ListActionRunsResult>;
 }
 export type InMemoryActionRunStorageSnapshot = Map<string, ActionRunRecord>;

package/dist/storage/action-runs/in-memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../../src/storage/action-runs/in-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAKrD,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,SAAS,CAAA;AAEhB,KAAK,gBAAgB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;AAyBpE,qBAAa,wBAAyB,YAAW,gBAAgB;IAK7D,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqC;IAC1D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkB;gBAGhC,UAAU,EAAE,gBAAgB,EAC7C,KAAK,GAAE;QAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;KAAO;IAK9D,QAAQ,IAAI,gCAAgC;IAI5C,OAAO,CAAC,QAAQ,EAAE,gCAAgC,GAAG,IAAI;IAOnD,MAAM,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IA+B7D,aAAa,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,eAAe,CAAC;IAYxE,OAAO,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAOnF,IAAI,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CA6CtE;AAED,MAAM,MAAM,gCAAgC,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA"}
+{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../../src/storage/action-runs/in-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAKrD,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,SAAS,CAAA;AAEhB,KAAK,gBAAgB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;AAyBpE,qBAAa,wBAAyB,YAAW,gBAAgB;IAK7D,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqC;IAC1D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkB;gBAGhC,UAAU,EAAE,gBAAgB,EAC7C,KAAK,GAAE;QAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;KAAO;IAK9D,QAAQ,IAAI,gCAAgC;IAI5C,OAAO,CAAC,QAAQ,EAAE,gCAAgC,GAAG,IAAI;IAOnD,MAAM,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IA+B7D,aAAa,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,eAAe,CAAC;IAYxE,OAAO,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAOnF,iBAAiB,CAAC,MAAM,EAAE;QAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;QAC1B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;KACzC,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC;IAejC,IAAI,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CA6CtE;AAED,MAAM,MAAM,gCAAgC,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA"}

package/dist/storage/action-runs/provider.js

@@ -1,7 +1,7 @@
 // @bun
 import {
   assertActionRunExecution2
-} from "../../chunk-a40ad1ft.js";
+} from "../../chunk-mbsbxarb.js";
 export {
   assertActionRunExecution2 as assertActionRunExecution
 };

package/dist/storage/action-runs/types.d.ts

@@ -11,7 +11,7 @@ export declare const ACTION_RUN_PHASES: readonly ["validation", "writeback", "ed
 export type ActionRunPhase = (typeof ACTION_RUN_PHASES)[number];
 export type ActionRunParams = Readonly<Record<string, JsonValue>>;
 /** Error codes an action run or phase record can persist and expose. */
-export declare const ACTION_RUN_FAILURE_CODES: readonly ["internal.unexpected", "runtime.cancelled", "action.phase_failed", "action.read_conflict", "action.timeout"];
+export declare const ACTION_RUN_FAILURE_CODES: readonly ["internal.unexpected", "runtime.cancelled", "action.phase_failed", "action.read_conflict", "action.rejected", "action.timeout", "object.unique_violation"];
 export type ActionRunFailureCode = (typeof ACTION_RUN_FAILURE_CODES)[number];
 export interface ActionRunFailureDetails<TPhase extends ActionRunPhase = ActionRunPhase> {
     readonly actionId: string;
@@ -121,6 +121,14 @@ export interface ActionRunStorage {
         projectId: string;
         id: string;
     }): Promise<ActionRunRecord | null>;
+    /**
+     * The runs these executions recorded, in first-occurrence input order. An execution whose run
+     * is in flight, or was interrupted, has none.
+     */
+    getByExecutionIds(params: {
+        readonly projectId: string;
+        readonly executionIds: readonly string[];
+    }): Promise<readonly ActionRunRecord[]>;
     /** Runs ordered by `startedAt`, then id. */
     list(input: ListActionRunsInput): Promise<ListActionRunsResult>;
 }

package/dist/storage/action-runs/types.d.ts.map

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

package/dist/storage/activity/in-memory.d.ts

@@ -0,0 +1,55 @@
+import { type ActivitySourceState, type PlannedActivityPageView } from "./policy";
+import type { ActivityActor, ActivityAttribution, ActivityCalendarInput, ActivityDay, ActivityInteraction, ActivityPeriodInput, ActivitySessionVisits, ActivityStorage, ActivitySummary, ActivityUsersPage, ActivityVisitsPage, AppendActivityInput, AppendActivityResult, ListActivitySessionVisitsInput, ListActivityUsersInput, ListActivityVisitsInput, ReadActivityVisitInput, StoredActivityVisitPage } from "./types";
+interface StoredVisit {
+    readonly projectId: string;
+    readonly id: string;
+    readonly actor: ActivityActor;
+    readonly sessionId: string;
+    readonly attribution: ActivityAttribution | null;
+    readonly startedAt: Date;
+    lastSeenAt: Date;
+    pageViews: number;
+    interactions: number;
+}
+interface StoredPageView extends PlannedActivityPageView {
+    readonly projectId: string;
+}
+interface StoredInteraction extends ActivityInteraction {
+    readonly projectId: string;
+}
+/** A source as stored: the start of its visit is read from the visit, which may be gone. */
+type StoredSource = Omit<ActivitySourceState, "visitStartedAt">;
+interface InMemoryActivitySnapshot {
+    readonly sources: Map<string, StoredSource>;
+    readonly visits: Map<string, StoredVisit>;
+    readonly pageViews: StoredPageView[];
+    readonly interactions: StoredInteraction[];
+}
+/** Activity for tests and local development. Each append runs without yielding, so it is atomic. */
+export declare class InMemoryActivityStorage implements ActivityStorage {
+    private sources;
+    private visits;
+    private pageViews;
+    private interactions;
+    append(input: AppendActivityInput): Promise<AppendActivityResult>;
+    list(input: ListActivityVisitsInput): Promise<ActivityVisitsPage>;
+    users(input: ListActivityUsersInput): Promise<ActivityUsersPage>;
+    summarize(input: ActivityPeriodInput): Promise<ActivitySummary>;
+    calendar(input: ActivityCalendarInput): Promise<readonly ActivityDay[]>;
+    read(input: ReadActivityVisitInput): Promise<StoredActivityVisitPage | null>;
+    sessionVisits(input: ListActivitySessionVisitsInput): Promise<readonly ActivitySessionVisits[]>;
+    snapshot(): InMemoryActivitySnapshot;
+    restore(snapshot: InMemoryActivitySnapshot): void;
+    private source;
+    /**
+     * Visits active at some point of `[from, to)`, optionally one account's. A visit lasts less than
+     * a day, so one active in the period started at most a day before it.
+     */
+    private overlapping;
+    private pageViewsOf;
+    private pageViewsInPeriod;
+    private isFromSession;
+    private requireVisit;
+}
+export {};
+//# sourceMappingURL=in-memory.d.ts.map

package/dist/storage/activity/in-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../../src/storage/activity/in-memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EAGxB,KAAK,uBAAuB,EAG7B,MAAM,UAAU,CAAA;AACjB,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EAErB,WAAW,EACX,mBAAmB,EAEnB,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,iBAAiB,EAEjB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,8BAA8B,EAC9B,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,SAAS,CAAA;AAEhB,UAAU,WAAW;IACnB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,EAAE,mBAAmB,GAAG,IAAI,CAAA;IAChD,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;IACxB,UAAU,EAAE,IAAI,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,UAAU,cAAe,SAAQ,uBAAuB;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,UAAU,iBAAkB,SAAQ,mBAAmB;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,4FAA4F;AAC5F,KAAK,YAAY,GAAG,IAAI,CAAC,mBAAmB,EAAE,gBAAgB,CAAC,CAAA;AAE/D,UAAU,wBAAwB;IAChC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IAC3C,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IACzC,QAAQ,CAAC,SAAS,EAAE,cAAc,EAAE,CAAA;IACpC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,EAAE,CAAA;CAC3C;AAED,oGAAoG;AACpG,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,YAAY,CAA0B;IAExC,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAsDjE,IAAI,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAWjE,KAAK,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgChE,SAAS,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAiB/D,QAAQ,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC;IAcvE,IAAI,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAmC5E,aAAa,CACjB,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,SAAS,qBAAqB,EAAE,CAAC;IA0B5C,QAAQ,IAAI,wBAAwB;IASpC,OAAO,CAAC,QAAQ,EAAE,wBAAwB,GAAG,IAAI;IAQjD,OAAO,CAAC,MAAM;IAUd;;;OAGG;IACH,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,YAAY;CAOrB"}

package/dist/storage/activity/index.d.ts

@@ -0,0 +1,3 @@
+export { InMemoryActivityStorage } from "./in-memory";
+export type { ActivityActor, ActivityAttribution, ActivityCalendarInput, ActivityCursor, ActivityDay, ActivityEventInput, ActivityEventType, ActivityInteraction, ActivityPageView, ActivityPeriodInput, ActivitySessionVisits, ActivityStorage, ActivitySummary, ActivityUser, ActivityUsersPage, ActivityVisit, ActivityVisitsPage, AppendActivityInput, AppendActivityResult, ListActivitySessionVisitsInput, ListActivityUsersInput, ListActivityVisitsInput, ReadActivityVisitInput, StoredActivityVisitPage, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/activity/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/activity/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AACrD,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,8BAA8B,EAC9B,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,SAAS,CAAA"}

package/dist/storage/activity/policy.d.ts

@@ -0,0 +1,96 @@
+/**
+ * The activity rules every provider shares: validation, retries, quota, visit assignment and
+ * sequence. Providers own atomicity and their queries; see `src/activity/README.md`.
+ */
+import type { ActivityActor, ActivityAttribution, ActivityDay, ActivityEventInput, ActivityInteraction, ActivityPageView, AppendActivityInput } from "./types";
+export declare const ACTIVITY_BATCH_LIMIT = 20;
+export declare const ACTIVITY_EVENT_ID_PATTERN: RegExp;
+export declare const ACTIVITY_VISIT_ID_PATTERN: RegExp;
+export declare const ACTIVITY_HOSTNAME_PATTERN: RegExp;
+/** A UTM label: any text without control characters. */
+export declare const ACTIVITY_LABEL_PATTERN: RegExp;
+export declare const ACTIVITY_LABEL_MAX_LENGTH = 100;
+export declare const ACTIVITY_REFERRER_MAX_LENGTH = 253;
+export declare const ACTIVITY_ROUTE_MAX_LENGTH = 512;
+export declare const ACTIVITY_ID_MAX_LENGTH = 256;
+/**
+ * An interaction name: lowercase dotted segments, each starting with a letter and at most 40
+ * characters, such as `invoices.row.open`, without a run of four digits. A segment that starts
+ * with a digit, or holds a long number, is usually a value, which names never carry. No pattern
+ * catches every value: names are meant to be constants.
+ */
+export declare const ACTIVITY_INTERACTION_NAME_PATTERN: RegExp;
+export declare const ACTIVITY_INTERACTION_NAME_MAX_LENGTH = 100;
+export declare const ACTIVITY_MAX_PERIOD_MS: number;
+export declare const ACTIVITY_MAX_PAGE_SIZE = 100;
+export declare const ACTIVITY_SOURCE_LIMIT_PER_MINUTE = 120;
+export declare const ACTIVITY_MIN_IDLE_TIMEOUT_MS = 60000;
+/** A visit ends at its next event once this old, so a period query bounds `started_at`. */
+export declare const ACTIVITY_MAX_VISIT_MS: number;
+/** What a provider keeps per session between batches, read and written under its lock. */
+export interface ActivitySourceState {
+    readonly visitId: string;
+    /** When the current visit started; `null` once that visit was deleted. Epoch milliseconds. */
+    readonly visitStartedAt: number | null;
+    /** Epoch milliseconds. Never moves backwards. */
+    readonly lastSeenAt: number;
+    /** Sequence of the visit's last stored event, page view or interaction. */
+    readonly sequence: number;
+    readonly windowStart: number;
+    readonly windowCount: number;
+}
+/** A page view or an interaction already stored for the session, compared with a retry of it. */
+export interface StoredActivityEvent {
+    readonly id: string;
+    readonly route: string;
+    /** Set for an interaction only. */
+    readonly name?: string;
+    readonly attribution?: ActivityAttribution;
+}
+/** A page view to insert. Its own attribution is kept only to recognize a retry. */
+export interface PlannedActivityPageView extends ActivityPageView {
+    readonly attribution?: ActivityAttribution;
+}
+export type ActivityAppendPlan = {
+    readonly status: "duplicate";
+} | {
+    readonly status: "throttled";
+} | {
+    readonly status: "append";
+    /** Set when the batch starts a visit, with the arrival that visit keeps. */
+    readonly newVisit: {
+        readonly attribution: ActivityAttribution | null;
+    } | null;
+    readonly pageViews: readonly PlannedActivityPageView[];
+    readonly interactions: readonly ActivityInteraction[];
+    /** Events counted against the quota: page views, activity and interactions alike. */
+    readonly accepted: number;
+    readonly state: ActivitySourceState;
+};
+export declare function validateActivityEvents(events: readonly ActivityEventInput[]): void;
+export declare function validateActivityAppend(input: AppendActivityInput): void;
+/**
+ * Plans one batch for one session. `current` is the session's state, absent before its first
+ * batch; `stored` holds its page views and interactions whose ids appear in the batch.
+ */
+export declare function planActivityAppend(input: AppendActivityInput, current: ActivitySourceState | undefined, stored: readonly StoredActivityEvent[]): ActivityAppendPlan;
+/**
+ * Each UTC day of `[from, to)` that a visit overlaps, with its page views. A visit across midnight
+ * counts on both days.
+ */
+export declare function activityCalendarDays(period: {
+    readonly from: Date;
+    readonly to: Date;
+}, visits: readonly {
+    readonly startedAt: Date;
+    readonly lastSeenAt: Date;
+}[], pageViewsByDay: ReadonlyMap<string, number>): ActivityDay[];
+/** The UTC calendar day of an instant, as `YYYY-MM-DD`. */
+export declare function activityDay(at: Date | number): string;
+export declare function activityActor(type: string, userId: string | null, grantId: string | null): ActivityActor;
+/** Canonical JSON, so a retry matches whatever order its keys come in. `undefined` stays null. */
+export declare function serializeActivityAttribution(value: unknown): string | null;
+export declare function parseActivityAttribution(value: string | null): ActivityAttribution | null;
+/** A file-router pattern: rooted, normalized, without a query, fragment or escape. */
+export declare function isActivityRoutePattern(value: unknown): value is string;
+//# sourceMappingURL=policy.d.ts.map

package/dist/storage/activity/policy.d.ts.map

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

package/dist/storage/activity/types.d.ts

@@ -0,0 +1,191 @@
+/** Who a visit belongs to: the verified account, or the share grant a link opened. */
+export type ActivityActor = {
+    readonly type: "user";
+    readonly userId: string;
+} | {
+    readonly type: "share";
+    readonly grantId: string;
+};
+/** Arrival metadata. An empty object means direct; `null` means it was not collected. */
+export interface ActivityAttribution {
+    readonly source?: string;
+    readonly medium?: string;
+    readonly campaign?: string;
+    /** External hostname only, without path, query, credentials or fragment. */
+    readonly referrer?: string;
+}
+/**
+ * `page.view` is a load or a navigation, and is kept. `visit.activity` is foreground activity: it
+ * keeps the visit alive and is not stored. `ui.interaction` is something the app marked, such as a
+ * button: it is kept, and keeps the visit alive.
+ */
+export type ActivityEventType = "page.view" | "visit.activity" | "ui.interaction";
+export type ActivityEventInput = {
+    /** Chosen by the browser, so a retried event is recognized. */
+    readonly id: string;
+    readonly type: "page.view" | "visit.activity";
+    /** File-router pattern, never a concrete URL, search string, title, or DOM content. */
+    readonly route: string;
+    readonly attribution?: ActivityAttribution;
+} | {
+    readonly id: string;
+    readonly type: "ui.interaction";
+    /** Chosen by the app's developer, such as `invoices.export`; never a value. */
+    readonly name: string;
+    /** The route pattern shown when it happened. */
+    readonly route: string;
+};
+export interface ActivityVisit {
+    readonly id: string;
+    readonly actor: ActivityActor;
+    /** Fixed by the first accepted event of the visit. */
+    readonly attribution: ActivityAttribution | null;
+    readonly startedAt: Date;
+    readonly lastSeenAt: Date;
+    /** Every page view of the visit, including those outside the period that listed it. */
+    readonly pageViews: number;
+    /** Every interaction of the visit, likewise. */
+    readonly interactions: number;
+}
+export interface ActivityPageView {
+    readonly id: string;
+    readonly visitId: string;
+    /** Position in the visit, from 1. Interactions take positions in the same order. */
+    readonly sequence: number;
+    readonly route: string;
+    /** Server receipt time. Browser delivery is best effort, not an audit trail. */
+    readonly receivedAt: Date;
+}
+/** An interaction the app marked: its name, and the page it happened on. */
+export interface ActivityInteraction {
+    readonly id: string;
+    readonly visitId: string;
+    /** Position in the visit, from 1, in the same order as its page views. */
+    readonly sequence: number;
+    readonly name: string;
+    readonly route: string;
+    /** Server receipt time. */
+    readonly receivedAt: Date;
+}
+export interface AppendActivityInput {
+    readonly projectId: string;
+    readonly actor: ActivityActor;
+    /**
+     * The verified session the events came through: the `SessionRecord` id for a user, the shared
+     * session's id for a share. Stored on the visit and never returned by reads.
+     */
+    readonly sessionId: string;
+    readonly events: readonly ActivityEventInput[];
+    readonly now: Date;
+    readonly idleTimeoutMs: number;
+    /** Used only when this batch starts a visit. */
+    readonly newVisitId: string;
+}
+export interface AppendActivityResult {
+    readonly status: "accepted" | "throttled";
+    /** Events taken into account; a retried page view or interaction counts zero. */
+    readonly accepted: number;
+}
+/** Visits overlapping `[from, to)`, and page views received in it. */
+export interface ActivityPeriodInput {
+    readonly projectId: string;
+    readonly from: Date;
+    readonly to: Date;
+    /** Only this account's visits; a share is never counted as a user. */
+    readonly userId?: string;
+}
+/** Continue after this row of a list ordered by last activity, newest first. */
+export interface ActivityCursor {
+    readonly at: Date;
+    readonly id: string;
+}
+export interface ListActivityVisitsInput extends ActivityPeriodInput {
+    readonly limit: number;
+    readonly before?: ActivityCursor;
+}
+export interface ActivityVisitsPage {
+    readonly visits: readonly ActivityVisit[];
+    readonly hasMore: boolean;
+}
+export interface ListActivityUsersInput extends ActivityPeriodInput {
+    readonly limit: number;
+    /** `id` is the user id of the last row. */
+    readonly before?: ActivityCursor;
+}
+export interface ActivityUser {
+    readonly userId: string;
+    readonly lastSeenAt: Date;
+    readonly visits: number;
+    /** Page views received in the period. */
+    readonly pageViews: number;
+}
+export interface ActivityUsersPage {
+    readonly users: readonly ActivityUser[];
+    readonly hasMore: boolean;
+}
+export interface ActivitySummary {
+    /** Distinct accounts; shares are not identities, so they never count here. */
+    readonly users: number;
+    readonly visits: number;
+    readonly sharedVisits: number;
+    /** Page views received in the period. */
+    readonly pageViews: number;
+}
+export interface ActivityCalendarInput {
+    readonly projectId: string;
+    readonly userId: string;
+    readonly from: Date;
+    readonly to: Date;
+}
+/** One UTC day with activity. A visit across midnight counts on both days. */
+export interface ActivityDay {
+    /** `YYYY-MM-DD`, in UTC. */
+    readonly day: string;
+    readonly visits: number;
+    readonly pageViews: number;
+}
+export interface ReadActivityVisitInput {
+    readonly projectId: string;
+    readonly id: string;
+    /** Page views and interactions kept together, from the first. */
+    readonly limit: number;
+}
+/** A visit as core reads it, with the session it belongs to. `sixb.activity` never returns it. */
+export interface StoredActivityVisitPage {
+    readonly visit: ActivityVisit;
+    readonly sessionId: string;
+    /** Its first page views and interactions, by their shared sequence. */
+    readonly pageViews: readonly ActivityPageView[];
+    readonly interactions: readonly ActivityInteraction[];
+    readonly hasMore: boolean;
+}
+export interface ListActivitySessionVisitsInput {
+    readonly projectId: string;
+    readonly userId: string;
+    /** The account's `SessionRecord` ids. */
+    readonly sessionIds: readonly string[];
+    /** Latest visits kept per session. */
+    readonly limit: number;
+}
+export interface ActivitySessionVisits {
+    readonly sessionId: string;
+    /** Every visit the session opened. */
+    readonly visits: number;
+    /** Its latest visits by start, newest first, at most `limit`. */
+    readonly latest: readonly ActivityVisit[];
+}
+export interface ActivityStorage {
+    /**
+     * Assigns the visit, deduplicates and counts the session's quota atomically, including across API
+     * replicas. Participates in the storage transaction it runs in.
+     */
+    append(input: AppendActivityInput): Promise<AppendActivityResult>;
+    list(input: ListActivityVisitsInput): Promise<ActivityVisitsPage>;
+    users(input: ListActivityUsersInput): Promise<ActivityUsersPage>;
+    summarize(input: ActivityPeriodInput): Promise<ActivitySummary>;
+    calendar(input: ActivityCalendarInput): Promise<readonly ActivityDay[]>;
+    read(input: ReadActivityVisitInput): Promise<StoredActivityVisitPage | null>;
+    /** The visits of these sessions of one account. A session without any is omitted. */
+    sessionVisits(input: ListActivitySessionVisitsInput): Promise<readonly ActivitySessionVisits[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/storage/activity/types.d.ts.map

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

package/dist/storage/agents/errors.d.ts

@@ -1,4 +1,6 @@
-export type AgentStorageErrorCode = "thread_not_found" | "active_run_exists" | "active_child_limit" | "run_not_found" | "invalid_input" | "invalid_state" | "execution_lost" | "duplicate_id";
+export type AgentStorageErrorCode = "thread_not_found"
+/** A conversation's operation on a sub-agent's thread: a turn, a fork, a participant. */
+ | "thread_not_conversation" | "active_run_exists" | "active_child_limit" | "run_not_found" | "invalid_input" | "invalid_state" | "execution_lost" | "duplicate_id" | "participant_limit";
 /**
  * Error for agent-storage invariants and invalid state transitions (single-flight, execution
  * ownership, run lifecycle, message append). Callers branch on `code` rather than message text.

package/dist/storage/agents/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/storage/agents/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAC7B,kBAAkB,GAClB,mBAAmB,GACnB,oBAAoB,GACpB,eAAe,GACf,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,cAAc,CAAA;AAElB;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAIxC,QAAQ,CAAC,IAAI,EAAE,qBAAqB;IAHtC,QAAQ,CAAC,IAAI,uBAAsB;gBAGxB,IAAI,EAAE,qBAAqB,EACpC,OAAO,EAAE,MAAM;CAIlB"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/storage/agents/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAC7B,kBAAkB;AACpB,yFAAyF;GACvF,yBAAyB,GACzB,mBAAmB,GACnB,oBAAoB,GACpB,eAAe,GACf,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,cAAc,GACd,mBAAmB,CAAA;AAEvB;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAIxC,QAAQ,CAAC,IAAI,EAAE,qBAAqB;IAHtC,QAAQ,CAAC,IAAI,uBAAsB;gBAGxB,IAAI,EAAE,qBAAqB,EACpC,OAAO,EAAE,MAAM;CAIlB"}