@tangle-network/agent-app 0.60.61 → 0.60.63

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (59) hide show
  1. package/dist/app-auth/index.js +53 -4
  2. package/dist/app-auth/index.js.map +1 -1
  3. package/dist/assistant/index.js +7 -7
  4. package/dist/chat-routes/index.js +13 -13
  5. package/dist/chat-store/index.js +3 -3
  6. package/dist/chunk-5UQJ7F3P.js +41 -0
  7. package/dist/chunk-5UQJ7F3P.js.map +1 -0
  8. package/dist/{chunk-YXYQ6MJL.js → chunk-5V6VTO5Q.js} +65 -2
  9. package/dist/chunk-5V6VTO5Q.js.map +1 -0
  10. package/dist/{chunk-TZD35SBQ.js → chunk-7DG6GGRN.js} +14 -7
  11. package/dist/chunk-7DG6GGRN.js.map +1 -0
  12. package/dist/chunk-J2O76TTS.js +458 -0
  13. package/dist/chunk-J2O76TTS.js.map +1 -0
  14. package/dist/{chunk-2YLSWZ5W.js → chunk-JBEFTXDO.js} +4 -4
  15. package/dist/{chunk-JGZ7WEPL.js → chunk-JC7YSRBR.js} +15 -1
  16. package/dist/chunk-JC7YSRBR.js.map +1 -0
  17. package/dist/{chunk-4WJREKXX.js → chunk-O3ZM5QPC.js} +6 -6
  18. package/dist/{chunk-FWLCPAST.js → chunk-SH56N4PV.js} +3 -3
  19. package/dist/{chunk-ZGUXI5SI.js → chunk-XNKLQG26.js} +5 -5
  20. package/dist/chunk-Y6LE5CAW.js +503 -0
  21. package/dist/chunk-Y6LE5CAW.js.map +1 -0
  22. package/dist/design-canvas-react/index.js +4 -4
  23. package/dist/launch-invariants/auth-lookup-cache.d.ts +57 -0
  24. package/dist/launch-invariants/catalog.d.ts +51 -0
  25. package/dist/launch-invariants/cli.d.ts +10 -0
  26. package/dist/launch-invariants/cli.js +88 -0
  27. package/dist/launch-invariants/cli.js.map +1 -0
  28. package/dist/launch-invariants/conformance.d.ts +49 -0
  29. package/dist/launch-invariants/index.d.ts +19 -0
  30. package/dist/launch-invariants/index.js +253 -0
  31. package/dist/launch-invariants/index.js.map +1 -0
  32. package/dist/launch-invariants/limit-alarms.d.ts +66 -0
  33. package/dist/launch-invariants/schedule.d.ts +114 -0
  34. package/dist/launch-invariants/settlement.d.ts +90 -0
  35. package/dist/launch-invariants/sized-reads.d.ts +50 -0
  36. package/dist/launch-invariants/testing.d.ts +175 -0
  37. package/dist/launch-invariants/testing.js +45 -0
  38. package/dist/launch-invariants/testing.js.map +1 -0
  39. package/dist/public-consultation/index.d.ts +1 -1
  40. package/dist/public-consultation/index.js +7 -7
  41. package/dist/sandbox/index.d.ts +4 -0
  42. package/dist/sandbox/index.js +1 -1
  43. package/dist/stream/index.d.ts +1 -0
  44. package/dist/stream/index.js +9 -5
  45. package/dist/stream/orphaned-turns.d.ts +56 -0
  46. package/dist/stream/turn-buffer.d.ts +12 -0
  47. package/dist/teams/invitations-api.js +3 -3
  48. package/dist/turn-health/index.js +6 -17
  49. package/dist/turn-health/index.js.map +1 -1
  50. package/dist/turn-stream/index.js +1 -1
  51. package/dist/web-react/index.js +13 -13
  52. package/package.json +13 -2
  53. package/dist/chunk-JGZ7WEPL.js.map +0 -1
  54. package/dist/chunk-TZD35SBQ.js.map +0 -1
  55. package/dist/chunk-YXYQ6MJL.js.map +0 -1
  56. /package/dist/{chunk-2YLSWZ5W.js.map → chunk-JBEFTXDO.js.map} +0 -0
  57. /package/dist/{chunk-4WJREKXX.js.map → chunk-O3ZM5QPC.js.map} +0 -0
  58. /package/dist/{chunk-FWLCPAST.js.map → chunk-SH56N4PV.js.map} +0 -0
  59. /package/dist/{chunk-ZGUXI5SI.js.map → chunk-XNKLQG26.js.map} +0 -0
@@ -1,11 +1,11 @@
1
- import {
2
- noticeEmail
3
- } from "../chunk-WOTWQ2ST.js";
4
1
  import {
5
2
  createAuthGuard,
6
3
  createBetterAuthSessionCookieMinter,
7
4
  createTangleSsoHandlers
8
5
  } from "../chunk-WN3UK23P.js";
6
+ import {
7
+ noticeEmail
8
+ } from "../chunk-WOTWQ2ST.js";
9
9
  import "../chunk-D6UJEOZQ.js";
10
10
  import "../chunk-UTAIRVOK.js";
11
11
  import "../chunk-RN4WPTBH.js";
@@ -17,6 +17,44 @@ import { betterAuth } from "better-auth";
17
17
  import { drizzleAdapter } from "better-auth/adapters/drizzle";
18
18
  var DEFAULT_STATE_COOKIE = "tangle_sso_state";
19
19
  var DEFAULT_SESSION_COOKIE_CACHE_SECONDS = 5 * 60;
20
+ var SESSION_MEMO_MAX_MS = 3e4;
21
+ var SESSION_MEMO_LIMIT = 500;
22
+ var requestSessions = /* @__PURE__ */ new WeakMap();
23
+ var isolateSessions = /* @__PURE__ */ new Map();
24
+ function memoizedSession(scope, ttlMs, request, read) {
25
+ const known = requestSessions.get(request);
26
+ if (known) return known;
27
+ const cookie = request.headers.get("cookie") ?? "";
28
+ const authorization = request.headers.get("authorization") ?? "";
29
+ if (!cookie && !authorization) return read(request);
30
+ const key = `${scope}\0${authorization}\0${cookie}`;
31
+ const now = Date.now();
32
+ const hit = isolateSessions.get(key);
33
+ if (hit && hit.until > now) {
34
+ requestSessions.set(request, hit.session);
35
+ return hit.session;
36
+ }
37
+ const session = read(request).then((value) => {
38
+ const expiresAt = value ? new Date(value.session.expiresAt).getTime() : 0;
39
+ if (!value || !(expiresAt > Date.now())) isolateSessions.delete(key);
40
+ else {
41
+ const entry = isolateSessions.get(key);
42
+ if (entry) entry.until = Math.min(entry.until, expiresAt);
43
+ }
44
+ return value;
45
+ }, (error) => {
46
+ isolateSessions.delete(key);
47
+ throw error;
48
+ });
49
+ isolateSessions.delete(key);
50
+ isolateSessions.set(key, { until: now + ttlMs, session });
51
+ if (isolateSessions.size > SESSION_MEMO_LIMIT) isolateSessions.delete(isolateSessions.keys().next().value);
52
+ requestSessions.set(request, session);
53
+ return session;
54
+ }
55
+ function forgetSessions(scope) {
56
+ for (const key of isolateSessions.keys()) if (key.startsWith(`${scope}\0`)) isolateSessions.delete(key);
57
+ }
20
58
  function slugify(name) {
21
59
  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
22
60
  }
@@ -155,10 +193,21 @@ function createAppAuth(config) {
155
193
  advanced: { cookiePrefix, ...config.advanced }
156
194
  };
157
195
  const auth = betterAuth(options);
158
- const getSession = async (request) => {
196
+ const readSession = async (request) => {
159
197
  const session = await auth.api.getSession({ headers: request.headers });
160
198
  return session ?? null;
161
199
  };
200
+ const memoMs = config.sessionCookieCacheSeconds === false ? 0 : Math.min(SESSION_MEMO_MAX_MS, (config.sessionCookieCacheSeconds ?? DEFAULT_SESSION_COOKIE_CACHE_SECONDS) * 1e3);
201
+ const memoScope = `${config.baseURL}\0${cookiePrefix}`;
202
+ const getSession = (request) => memoMs > 0 ? memoizedSession(memoScope, memoMs, request, readSession) : readSession(request);
203
+ const handler = auth.handler;
204
+ auth.handler = async (request) => {
205
+ try {
206
+ return await handler(request);
207
+ } finally {
208
+ if (request.method !== "GET") forgetSessions(memoScope);
209
+ }
210
+ };
162
211
  const loginPath = config.loginPath ?? "/login";
163
212
  const guard = createAuthGuard({ getSession, loginPath });
164
213
  let sso = null;
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/app-auth/index.ts"],"sourcesContent":["/**\n * better-auth config factory for agent products (#188 Phase 1). Every product\n * hand-rolls the same ~70–150 line setup — drizzle adapter over the standard\n * users/sessions/accounts/verifications tables, email+password with branded\n * reset/verification mail (`./email`), env-gated GitHub/Google social providers, session\n * cookie cache, and a per-app cookie prefix — and tax additionally\n * re-implemented better-auth's cookie signing for its Tangle SSO callback.\n * `createAppAuth` owns that mechanism once and returns the configured\n * better-auth instance plus the request guards products actually use.\n *\n * Domain stays a parameter: the drizzle db + schema, email client, provider\n * credentials, and SSO store/client all come from the product. No product\n * import, no engine re-implementation — the SSO path composes the existing\n * `platform/sso` cookie minter (`createBetterAuthSessionCookieMinter`), which\n * is byte-compatible with better-auth's own `makeSignature` contract.\n *\n * better-auth is an OPTIONAL peer: only this subpath imports it, so it is\n * deliberately NOT re-exported from the root barrel.\n */\n\nimport { betterAuth, type Auth, type BetterAuthOptions, type Session, type User } from 'better-auth'\nimport { drizzleAdapter } from 'better-auth/adapters/drizzle'\nimport { noticeEmail, type EmailAttachment, type EmailMessage, type EmailProduct } from '../email'\nimport { createAuthGuard, type AuthGuard } from '../platform/guards'\nimport {\n createBetterAuthSessionCookieMinter,\n createTangleSsoHandlers,\n type TangleSsoAccountStore,\n type TangleSsoAuthClient,\n type TangleSsoHandlers,\n type TangleIdentitySsoAccountStore,\n type TangleIdentitySsoAuthClient,\n type TangleOidcSsoAccountStore,\n type TangleOidcSsoAuthClient,\n} from '../platform/sso'\n\nconst DEFAULT_STATE_COOKIE = 'tangle_sso_state'\nconst DEFAULT_SESSION_COOKIE_CACHE_SECONDS = 5 * 60\n\n/** Structural slice of a Resend-style client — no `resend` import. */\nexport interface AppAuthEmailClient {\n emails: {\n send(message: {\n from: string\n to: string\n subject: string\n html: string\n text?: string\n /** Inline images the HTML references by `cid:`, such as the Tangle mark. */\n attachments?: EmailAttachment[]\n }): Promise<unknown>\n }\n}\n\n/** Define email configuration for app authentication including client, sender, verification, and warning options */\nexport interface AppAuthEmailConfig {\n /** A Resend-style client, or a lazy getter returning null when the API key\n * is absent (the products' dev default — mail is skipped with a warning,\n * sign-up itself must not crash). */\n resend: AppAuthEmailClient | (() => AppAuthEmailClient | null)\n /** RFC 5322 From; build it with `emailSender` from `./email`, e.g. `Legal Agent · Tangle <noreply@tangle.tools>`. */\n from: string\n /** Send a verification email on sign-up and auto-sign-in after verifying\n * (the tax/gtm behavior). Default false (the legal behavior). */\n verifyOnSignUp?: boolean\n /** Receives the \"email client unavailable\" warning. Default console.warn. */\n warn?: (message: string) => void\n}\n\n/** Env-shaped: pass the env vars straight through; the provider is registered\n * only when BOTH values are non-empty, so unset env disables it. */\nexport interface AppAuthSocialProviderConfig {\n clientId?: string\n clientSecret?: string\n}\n\n/** Define social authentication configuration options for GitHub and Google providers */\nexport interface AppAuthSocialConfig {\n github?: AppAuthSocialProviderConfig\n google?: AppAuthSocialProviderConfig\n}\n\n/** Cross-site Tangle SSO wiring. The factory supplies the better-auth side —\n * `setSessionCookie` via `createBetterAuthSessionCookieMinter(auth)` (signed\n * `__Secure-`/prefixed cookie that `auth.api.getSession` accepts) — so the\n * product no longer touches `better-auth/crypto` itself. */\nexport interface AppAuthSsoConfig {\n protocol?: 'legacy'\n /** Platform wire client (authorizeUrl + exchange). */\n client: TangleSsoAuthClient\n /** Product persistence: user upsert, session row, platform link. */\n store: TangleSsoAccountStore\n /** Absolute callback URL registered with the platform. */\n callbackUrl: string\n /** Default 'tangle_sso_state'. */\n stateCookieName?: string\n /** HMAC secret for the CSRF state cookie. Default: the auth `secret`. */\n stateSecret?: string\n /** Default: `baseURL` is https. Must match better-auth's own\n * secure-cookie decision or the cookie name lookup diverges. */\n secureCookies?: boolean\n sessionTtlSeconds?: number\n stateTtlSeconds?: number\n /** Post-login redirect fallback. Default '/app'. */\n defaultRedirectPath?: string\n /** Default: the top-level `loginPath`. */\n loginPath?: string\n /** Failure log hook (e.g. console.error). Default no-op. */\n log?: (message: string, error?: unknown) => void\n}\n\n/** Registered OIDC client configuration. The caller supplies Runtime PKCE; login does not mint an API key. */\nexport interface AppAuthOidcSsoConfig extends Omit<AppAuthSsoConfig, 'protocol' | 'client' | 'store'> {\n protocol: 'oidc'\n client: TangleOidcSsoAuthClient\n store: TangleOidcSsoAccountStore\n /** Pass the Runtime's `createPkcePair` helper from the OIDC-only caller. */\n createPkcePair: () => Promise<{ verifier: string; challenge: string }>\n}\n\n/** First-party identity login; no Platform API key is issued or stored. */\nexport interface AppAuthIdentitySsoConfig extends Omit<AppAuthSsoConfig, 'protocol' | 'client' | 'store'> {\n protocol: 'identity'\n client: TangleIdentitySsoAuthClient\n store: TangleIdentitySsoAccountStore\n}\n\n/** Define the structure for application authentication data including users, sessions, accounts, and verifications */\nexport interface AppAuthSchema {\n users: unknown\n sessions: unknown\n accounts: unknown\n verifications: unknown\n}\n\n/** Define configuration settings for app authentication including app name, base URL, secrets, and trusted origins */\nexport interface AppAuthConfig {\n /** Product name — used in email subjects and as the cookie-prefix default. */\n appName: string\n /** Absolute origin better-auth serves from (`BETTER_AUTH_URL`). */\n baseURL: string\n /** better-auth HMAC secret. Optional only because better-auth falls back to\n * the BETTER_AUTH_SECRET env var; `sso` needs it explicitly (or\n * `sso.stateSecret`). */\n secret?: string\n trustedOrigins?: string[]\n /**\n * Session-cookie prefix. Default: slugified `appName`. A per-app prefix is\n * load-bearing, not cosmetic: the platform (id.tangle.tools) mints its own\n * better-auth cookie `Domain=.tangle.tools`-wide under the DEFAULT name, and\n * the platform's (older) cookie wins the Cookie-header order — an app on the\n * default prefix reads the platform's token, fails its own signature check,\n * and every fresh login lands back on /login.\n */\n cookiePrefix?: string\n /** Drizzle database instance; wired through better-auth's drizzle adapter\n * together with `schema`. */\n db?: unknown\n /** The product's users/sessions/accounts/verifications tables (mapped to\n * better-auth's user/session/account/verification models). */\n schema?: AppAuthSchema\n /** Drizzle dialect. Default 'sqlite' (D1). */\n provider?: 'sqlite' | 'pg' | 'mysql'\n /** Escape hatch: a pre-built better-auth database adapter (e.g.\n * `memoryAdapter` in tests). Wins over `db`/`schema`. */\n database?: BetterAuthOptions['database']\n /** Email+password sign-in. Default true (all current products enable it). */\n emailAndPassword?: boolean\n /** Reset/verification mail. Omit to disable password reset entirely. */\n email?: AppAuthEmailConfig\n social?: AppAuthSocialConfig\n /** Session cookie-cache TTL in seconds; `false` disables the cache.\n * Default 300. */\n sessionCookieCacheSeconds?: number | false\n /** Tangle cross-site SSO (start/callback handlers). */\n sso?: AppAuthSsoConfig | AppAuthOidcSsoConfig | AppAuthIdentitySsoConfig\n /** Where guards redirect unauthenticated page requests. Default '/login'. */\n loginPath?: string\n /** Merged over the factory's `advanced` block (cookiePrefix stays unless\n * overridden here). */\n advanced?: BetterAuthOptions['advanced']\n}\n\n/** The configured better-auth instance, typed at better-auth's base surface\n * (`handler`, `api`, `$context`, `$Infer`). */\nexport type AppAuthInstance = Auth\n\n/** What `getSession`/guards resolve: better-auth's base session + user rows. */\nexport interface AppAuthSession {\n session: Session\n user: User\n}\n\n/** Define authentication guard with session retrieval and optional SSO handlers for app requests */\nexport interface AppAuth extends AuthGuard<AppAuthSession> {\n auth: AppAuthInstance\n /** `auth.api.getSession` over a `Request` — the seam the guards consume. */\n getSession(request: Request): Promise<AppAuthSession | null>\n /** Tangle SSO start/callback handlers; null unless `sso` was configured. */\n sso: TangleSsoHandlers | null\n}\n\n/** Lowercased, non-alphanumerics collapsed to '-': `'Legal Agent'` → `'legal-agent'`. */\nfunction slugify(name: string): string {\n return name\n .toLowerCase()\n .replace(/[^a-z0-9]+/g, '-')\n .replace(/^-+|-+$/g, '')\n}\n\nfunction emailProduct(config: AppAuthConfig): EmailProduct {\n return { name: config.appName, url: config.baseURL }\n}\n\nfunction resolveEmailClient(email: AppAuthEmailConfig): AppAuthEmailClient | null {\n return typeof email.resend === 'function' ? email.resend() : email.resend\n}\n\ntype DrizzleAuthAdapter = ReturnType<ReturnType<typeof drizzleAdapter>>\n\n/** Better Auth reads adapter identity during startup, before Workers inject D1.\n * Build the Drizzle adapter on its first database operation. */\nfunction deferDrizzleAdapter(\n db: Record<string, unknown>,\n config: Parameters<typeof drizzleAdapter>[1],\n): ReturnType<typeof drizzleAdapter> {\n return (options) => {\n let adapter: DrizzleAuthAdapter | undefined\n const resolve = () => (adapter ??= drizzleAdapter(db, config)(options))\n\n return {\n id: 'drizzle',\n create: (data) => resolve().create(data),\n findOne: (data) => resolve().findOne(data),\n findMany: (data) => resolve().findMany(data),\n count: (data) => resolve().count(data),\n update: (data) => resolve().update(data),\n updateMany: (data) => resolve().updateMany(data),\n delete: (data) => resolve().delete(data),\n deleteMany: (data) => resolve().deleteMany(data),\n consumeOne: (data) => resolve().consumeOne(data),\n incrementOne: (data) => resolve().incrementOne(data),\n transaction: (callback) => resolve().transaction(callback),\n }\n }\n}\n\n/** Resend reports failures in the resolved value, not by rejecting — surface\n * them loud so better-auth's flow (and the caller's logs) see the failure. */\nasync function sendEmail(client: AppAuthEmailClient, from: string, to: string, message: EmailMessage): Promise<void> {\n const { subject, html, text, attachments } = message\n const result = (await client.emails.send({ from, to, subject, html, text, attachments })) as\n | { error?: { message?: string } | null }\n | null\n | undefined\n if (result && typeof result === 'object' && result.error) {\n throw new Error(`[app-auth] email send failed: ${result.error.message ?? 'unknown error'}`)\n }\n}\n\nfunction resolveDatabase(config: AppAuthConfig): NonNullable<BetterAuthOptions['database']> {\n if (config.database) return config.database\n if (config.db && config.schema) {\n return deferDrizzleAdapter(config.db as Record<string, unknown>, {\n provider: config.provider ?? 'sqlite',\n schema: {\n user: config.schema.users,\n session: config.schema.sessions,\n account: config.schema.accounts,\n verification: config.schema.verifications,\n } as Record<string, unknown>,\n })\n }\n throw new Error(\n 'createAppAuth requires a database: pass `db` + `schema` (drizzle) or `database` (a better-auth adapter)',\n )\n}\n\nfunction resolveSocialProviders(social: AppAuthSocialConfig | undefined): BetterAuthOptions['socialProviders'] {\n const providers: NonNullable<BetterAuthOptions['socialProviders']> = {}\n if (social?.github?.clientId && social.github.clientSecret) {\n providers.github = { clientId: social.github.clientId, clientSecret: social.github.clientSecret }\n }\n if (social?.google?.clientId && social.google.clientSecret) {\n providers.google = { clientId: social.google.clientId, clientSecret: social.google.clientSecret }\n }\n return Object.keys(providers).length > 0 ? providers : undefined\n}\n\nfunction emailAndPasswordOptions(config: AppAuthConfig): BetterAuthOptions['emailAndPassword'] {\n const email = config.email\n if (!email) return { enabled: true }\n const warn = email.warn ?? ((message: string) => console.warn(message))\n return {\n enabled: true,\n sendResetPassword: async ({ user, url }) => {\n const client = resolveEmailClient(email)\n if (!client) {\n warn('[app-auth] email client unavailable — password reset email not sent')\n return\n }\n await sendEmail(client, email.from, user.email, noticeEmail(emailProduct(config), {\n subject: 'Reset your password',\n title: 'Reset your password',\n body: `Someone asked to reset the password for ${user.email}. If it was not you, ignore this email.`,\n action: { label: 'Reset password', url },\n showLink: true,\n note: 'This link expires in 1 hour.',\n footer: { reason: 'You received this because a password reset was requested for this address.' },\n }))\n },\n }\n}\n\nfunction emailVerificationOptions(config: AppAuthConfig): BetterAuthOptions['emailVerification'] {\n const email = config.email\n if (!email?.verifyOnSignUp) return undefined\n const warn = email.warn ?? ((message: string) => console.warn(message))\n return {\n sendOnSignUp: true,\n autoSignInAfterVerification: true,\n sendVerificationEmail: async ({ user, url }) => {\n const client = resolveEmailClient(email)\n if (!client) {\n warn('[app-auth] email client unavailable — verification email not sent')\n return\n }\n await sendEmail(client, email.from, user.email, noticeEmail(emailProduct(config), {\n subject: 'Verify your email',\n title: 'Verify your email',\n body: `Confirm ${user.email} to finish signing in to ${config.appName}.`,\n action: { label: 'Verify email', url },\n showLink: true,\n note: 'This link expires in 1 hour.',\n footer: { reason: `You received this because this address was used to sign in to ${config.appName}.` },\n }))\n },\n }\n}\n\n/**\n * Build the product's better-auth instance plus the request-boundary helpers:\n * `getSession` (Request → session|null), the `createAuthGuard` quartet\n * (`requireUser` 302, `requireApiUser` JSON 401, `requireSession`,\n * `getOptionalSession`), and — when `sso` is configured — the Tangle SSO\n * start/callback handlers with the session cookie minted through better-auth's\n * own name/attributes/signing (no `better-auth/crypto` in product code).\n */\nexport function createAppAuth(config: AppAuthConfig): AppAuth {\n if (!config.appName) throw new Error('createAppAuth: appName is required')\n if (!config.baseURL) throw new Error('createAppAuth: baseURL is required')\n\n const cookiePrefix = config.cookiePrefix ?? slugify(config.appName)\n if (!cookiePrefix) throw new Error('createAppAuth: cookiePrefix (or a slugifiable appName) is required')\n\n const socialProviders = resolveSocialProviders(config.social)\n const options: BetterAuthOptions = {\n appName: config.appName,\n baseURL: config.baseURL,\n ...(config.secret ? { secret: config.secret } : {}),\n ...(config.trustedOrigins ? { trustedOrigins: config.trustedOrigins } : {}),\n database: resolveDatabase(config),\n ...(config.emailAndPassword === false ? {} : { emailAndPassword: emailAndPasswordOptions(config) }),\n ...(config.email?.verifyOnSignUp ? { emailVerification: emailVerificationOptions(config) } : {}),\n ...(socialProviders ? { socialProviders } : {}),\n ...(config.sessionCookieCacheSeconds === false\n ? {}\n : {\n session: {\n cookieCache: {\n enabled: true,\n maxAge: config.sessionCookieCacheSeconds ?? DEFAULT_SESSION_COOKIE_CACHE_SECONDS,\n },\n },\n }),\n advanced: { cookiePrefix, ...config.advanced },\n }\n\n const auth: AppAuthInstance = betterAuth(options)\n\n const getSession = async (request: Request): Promise<AppAuthSession | null> => {\n const session = await auth.api.getSession({ headers: request.headers })\n return (session as AppAuthSession | null) ?? null\n }\n\n const loginPath = config.loginPath ?? '/login'\n const guard = createAuthGuard<AppAuthSession>({ getSession, loginPath })\n\n let sso: TangleSsoHandlers | null = null\n if (config.sso) {\n const stateSecret = config.sso.stateSecret ?? config.secret\n if (!stateSecret) {\n throw new Error(\n 'createAppAuth: sso requires `secret` (or sso.stateSecret) — the signed-state CSRF cookie needs an HMAC secret',\n )\n }\n const transport = config.sso.protocol === 'oidc'\n ? { protocol: 'oidc' as const, auth: config.sso.client, store: config.sso.store, createPkcePair: config.sso.createPkcePair }\n : config.sso.protocol === 'identity'\n ? { protocol: 'identity' as const, auth: config.sso.client, store: config.sso.store }\n : { protocol: 'legacy' as const, auth: config.sso.client, store: config.sso.store }\n sso = createTangleSsoHandlers({\n ...transport,\n stateSecret,\n callbackUrl: config.sso.callbackUrl,\n stateCookieName: config.sso.stateCookieName ?? DEFAULT_STATE_COOKIE,\n setSessionCookie: createBetterAuthSessionCookieMinter(auth),\n secureCookies: config.sso.secureCookies ?? config.baseURL.startsWith('https:'),\n ...(config.sso.sessionTtlSeconds !== undefined ? { sessionTtlSeconds: config.sso.sessionTtlSeconds } : {}),\n ...(config.sso.stateTtlSeconds !== undefined ? { stateTtlSeconds: config.sso.stateTtlSeconds } : {}),\n ...(config.sso.defaultRedirectPath ? { defaultRedirectPath: config.sso.defaultRedirectPath } : {}),\n loginPath: config.sso.loginPath ?? loginPath,\n ...(config.sso.log ? { log: config.sso.log } : {}),\n })\n }\n\n return { auth, getSession, ...guard, sso }\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../../src/app-auth/index.ts"],"sourcesContent":["/**\n * better-auth config factory for agent products (#188 Phase 1). Every product\n * hand-rolls the same ~70–150 line setup — drizzle adapter over the standard\n * users/sessions/accounts/verifications tables, email+password with branded\n * reset/verification mail (`./email`), env-gated GitHub/Google social providers, session\n * cookie cache, and a per-app cookie prefix — and tax additionally\n * re-implemented better-auth's cookie signing for its Tangle SSO callback.\n * `createAppAuth` owns that mechanism once and returns the configured\n * better-auth instance plus the request guards products actually use.\n *\n * Domain stays a parameter: the drizzle db + schema, email client, provider\n * credentials, and SSO store/client all come from the product. No product\n * import, no engine re-implementation — the SSO path composes the existing\n * `platform/sso` cookie minter (`createBetterAuthSessionCookieMinter`), which\n * is byte-compatible with better-auth's own `makeSignature` contract.\n *\n * better-auth is an OPTIONAL peer: only this subpath imports it, so it is\n * deliberately NOT re-exported from the root barrel.\n */\n\nimport { betterAuth, type Auth, type BetterAuthOptions, type Session, type User } from 'better-auth'\nimport { drizzleAdapter } from 'better-auth/adapters/drizzle'\nimport { noticeEmail, type EmailAttachment, type EmailMessage, type EmailProduct } from '../email'\nimport { createAuthGuard, type AuthGuard } from '../platform/guards'\nimport {\n createBetterAuthSessionCookieMinter,\n createTangleSsoHandlers,\n type TangleSsoAccountStore,\n type TangleSsoAuthClient,\n type TangleSsoHandlers,\n type TangleIdentitySsoAccountStore,\n type TangleIdentitySsoAuthClient,\n type TangleOidcSsoAccountStore,\n type TangleOidcSsoAuthClient,\n} from '../platform/sso'\n\nconst DEFAULT_STATE_COOKIE = 'tangle_sso_state'\nconst DEFAULT_SESSION_COOKIE_CACHE_SECONDS = 5 * 60\n\n/**\n * A session read costs two serial database round trips (session, then user),\n * and a request often resolves it more than once. Resolved sessions are reused\n * within a request and, for at most SESSION_MEMO_MAX_MS, across requests in one\n * isolate, keyed by the exact credentials sent. That stays inside the staleness\n * the session cookie cache already accepts, and any non-GET auth call (sign-out,\n * revocation) clears the app's entries in this isolate.\n */\nconst SESSION_MEMO_MAX_MS = 30_000\nconst SESSION_MEMO_LIMIT = 500\nconst requestSessions = new WeakMap<Request, Promise<AppAuthSession | null>>()\nconst isolateSessions = new Map<string, { until: number; session: Promise<AppAuthSession | null> }>()\n\nfunction memoizedSession(scope: string, ttlMs: number, request: Request,\n read: (request: Request) => Promise<AppAuthSession | null>): Promise<AppAuthSession | null> {\n const known = requestSessions.get(request)\n if (known) return known\n const cookie = request.headers.get('cookie') ?? ''\n const authorization = request.headers.get('authorization') ?? ''\n if (!cookie && !authorization) return read(request)\n const key = `${scope}\\u0000${authorization}\\u0000${cookie}`\n const now = Date.now()\n const hit = isolateSessions.get(key)\n if (hit && hit.until > now) {\n requestSessions.set(request, hit.session)\n return hit.session\n }\n const session = read(request).then((value) => {\n // Only a live session is reused; a miss or an expired session is read again next time.\n const expiresAt = value ? new Date(value.session.expiresAt).getTime() : 0\n if (!value || !(expiresAt > Date.now())) isolateSessions.delete(key)\n else {\n const entry = isolateSessions.get(key)\n if (entry) entry.until = Math.min(entry.until, expiresAt)\n }\n return value\n }, (error) => { isolateSessions.delete(key); throw error })\n isolateSessions.delete(key)\n isolateSessions.set(key, { until: now + ttlMs, session })\n if (isolateSessions.size > SESSION_MEMO_LIMIT) isolateSessions.delete(isolateSessions.keys().next().value!)\n requestSessions.set(request, session)\n return session\n}\n\nfunction forgetSessions(scope: string): void {\n for (const key of isolateSessions.keys()) if (key.startsWith(`${scope}\\u0000`)) isolateSessions.delete(key)\n}\n\n/** Structural slice of a Resend-style client — no `resend` import. */\nexport interface AppAuthEmailClient {\n emails: {\n send(message: {\n from: string\n to: string\n subject: string\n html: string\n text?: string\n /** Inline images the HTML references by `cid:`, such as the Tangle mark. */\n attachments?: EmailAttachment[]\n }): Promise<unknown>\n }\n}\n\n/** Define email configuration for app authentication including client, sender, verification, and warning options */\nexport interface AppAuthEmailConfig {\n /** A Resend-style client, or a lazy getter returning null when the API key\n * is absent (the products' dev default — mail is skipped with a warning,\n * sign-up itself must not crash). */\n resend: AppAuthEmailClient | (() => AppAuthEmailClient | null)\n /** RFC 5322 From; build it with `emailSender` from `./email`, e.g. `Legal Agent · Tangle <noreply@tangle.tools>`. */\n from: string\n /** Send a verification email on sign-up and auto-sign-in after verifying\n * (the tax/gtm behavior). Default false (the legal behavior). */\n verifyOnSignUp?: boolean\n /** Receives the \"email client unavailable\" warning. Default console.warn. */\n warn?: (message: string) => void\n}\n\n/** Env-shaped: pass the env vars straight through; the provider is registered\n * only when BOTH values are non-empty, so unset env disables it. */\nexport interface AppAuthSocialProviderConfig {\n clientId?: string\n clientSecret?: string\n}\n\n/** Define social authentication configuration options for GitHub and Google providers */\nexport interface AppAuthSocialConfig {\n github?: AppAuthSocialProviderConfig\n google?: AppAuthSocialProviderConfig\n}\n\n/** Cross-site Tangle SSO wiring. The factory supplies the better-auth side —\n * `setSessionCookie` via `createBetterAuthSessionCookieMinter(auth)` (signed\n * `__Secure-`/prefixed cookie that `auth.api.getSession` accepts) — so the\n * product no longer touches `better-auth/crypto` itself. */\nexport interface AppAuthSsoConfig {\n protocol?: 'legacy'\n /** Platform wire client (authorizeUrl + exchange). */\n client: TangleSsoAuthClient\n /** Product persistence: user upsert, session row, platform link. */\n store: TangleSsoAccountStore\n /** Absolute callback URL registered with the platform. */\n callbackUrl: string\n /** Default 'tangle_sso_state'. */\n stateCookieName?: string\n /** HMAC secret for the CSRF state cookie. Default: the auth `secret`. */\n stateSecret?: string\n /** Default: `baseURL` is https. Must match better-auth's own\n * secure-cookie decision or the cookie name lookup diverges. */\n secureCookies?: boolean\n sessionTtlSeconds?: number\n stateTtlSeconds?: number\n /** Post-login redirect fallback. Default '/app'. */\n defaultRedirectPath?: string\n /** Default: the top-level `loginPath`. */\n loginPath?: string\n /** Failure log hook (e.g. console.error). Default no-op. */\n log?: (message: string, error?: unknown) => void\n}\n\n/** Registered OIDC client configuration. The caller supplies Runtime PKCE; login does not mint an API key. */\nexport interface AppAuthOidcSsoConfig extends Omit<AppAuthSsoConfig, 'protocol' | 'client' | 'store'> {\n protocol: 'oidc'\n client: TangleOidcSsoAuthClient\n store: TangleOidcSsoAccountStore\n /** Pass the Runtime's `createPkcePair` helper from the OIDC-only caller. */\n createPkcePair: () => Promise<{ verifier: string; challenge: string }>\n}\n\n/** First-party identity login; no Platform API key is issued or stored. */\nexport interface AppAuthIdentitySsoConfig extends Omit<AppAuthSsoConfig, 'protocol' | 'client' | 'store'> {\n protocol: 'identity'\n client: TangleIdentitySsoAuthClient\n store: TangleIdentitySsoAccountStore\n}\n\n/** Define the structure for application authentication data including users, sessions, accounts, and verifications */\nexport interface AppAuthSchema {\n users: unknown\n sessions: unknown\n accounts: unknown\n verifications: unknown\n}\n\n/** Define configuration settings for app authentication including app name, base URL, secrets, and trusted origins */\nexport interface AppAuthConfig {\n /** Product name — used in email subjects and as the cookie-prefix default. */\n appName: string\n /** Absolute origin better-auth serves from (`BETTER_AUTH_URL`). */\n baseURL: string\n /** better-auth HMAC secret. Optional only because better-auth falls back to\n * the BETTER_AUTH_SECRET env var; `sso` needs it explicitly (or\n * `sso.stateSecret`). */\n secret?: string\n trustedOrigins?: string[]\n /**\n * Session-cookie prefix. Default: slugified `appName`. A per-app prefix is\n * load-bearing, not cosmetic: the platform (id.tangle.tools) mints its own\n * better-auth cookie `Domain=.tangle.tools`-wide under the DEFAULT name, and\n * the platform's (older) cookie wins the Cookie-header order — an app on the\n * default prefix reads the platform's token, fails its own signature check,\n * and every fresh login lands back on /login.\n */\n cookiePrefix?: string\n /** Drizzle database instance; wired through better-auth's drizzle adapter\n * together with `schema`. */\n db?: unknown\n /** The product's users/sessions/accounts/verifications tables (mapped to\n * better-auth's user/session/account/verification models). */\n schema?: AppAuthSchema\n /** Drizzle dialect. Default 'sqlite' (D1). */\n provider?: 'sqlite' | 'pg' | 'mysql'\n /** Escape hatch: a pre-built better-auth database adapter (e.g.\n * `memoryAdapter` in tests). Wins over `db`/`schema`. */\n database?: BetterAuthOptions['database']\n /** Email+password sign-in. Default true (all current products enable it). */\n emailAndPassword?: boolean\n /** Reset/verification mail. Omit to disable password reset entirely. */\n email?: AppAuthEmailConfig\n social?: AppAuthSocialConfig\n /** Session cookie-cache TTL in seconds; `false` disables the cache.\n * Default 300. */\n sessionCookieCacheSeconds?: number | false\n /** Tangle cross-site SSO (start/callback handlers). */\n sso?: AppAuthSsoConfig | AppAuthOidcSsoConfig | AppAuthIdentitySsoConfig\n /** Where guards redirect unauthenticated page requests. Default '/login'. */\n loginPath?: string\n /** Merged over the factory's `advanced` block (cookiePrefix stays unless\n * overridden here). */\n advanced?: BetterAuthOptions['advanced']\n}\n\n/** The configured better-auth instance, typed at better-auth's base surface\n * (`handler`, `api`, `$context`, `$Infer`). */\nexport type AppAuthInstance = Auth\n\n/** What `getSession`/guards resolve: better-auth's base session + user rows. */\nexport interface AppAuthSession {\n session: Session\n user: User\n}\n\n/** Define authentication guard with session retrieval and optional SSO handlers for app requests */\nexport interface AppAuth extends AuthGuard<AppAuthSession> {\n auth: AppAuthInstance\n /** `auth.api.getSession` over a `Request` — the seam the guards consume. */\n getSession(request: Request): Promise<AppAuthSession | null>\n /** Tangle SSO start/callback handlers; null unless `sso` was configured. */\n sso: TangleSsoHandlers | null\n}\n\n/** Lowercased, non-alphanumerics collapsed to '-': `'Legal Agent'` → `'legal-agent'`. */\nfunction slugify(name: string): string {\n return name\n .toLowerCase()\n .replace(/[^a-z0-9]+/g, '-')\n .replace(/^-+|-+$/g, '')\n}\n\nfunction emailProduct(config: AppAuthConfig): EmailProduct {\n return { name: config.appName, url: config.baseURL }\n}\n\nfunction resolveEmailClient(email: AppAuthEmailConfig): AppAuthEmailClient | null {\n return typeof email.resend === 'function' ? email.resend() : email.resend\n}\n\ntype DrizzleAuthAdapter = ReturnType<ReturnType<typeof drizzleAdapter>>\n\n/** Better Auth reads adapter identity during startup, before Workers inject D1.\n * Build the Drizzle adapter on its first database operation. */\nfunction deferDrizzleAdapter(\n db: Record<string, unknown>,\n config: Parameters<typeof drizzleAdapter>[1],\n): ReturnType<typeof drizzleAdapter> {\n return (options) => {\n let adapter: DrizzleAuthAdapter | undefined\n const resolve = () => (adapter ??= drizzleAdapter(db, config)(options))\n\n return {\n id: 'drizzle',\n create: (data) => resolve().create(data),\n findOne: (data) => resolve().findOne(data),\n findMany: (data) => resolve().findMany(data),\n count: (data) => resolve().count(data),\n update: (data) => resolve().update(data),\n updateMany: (data) => resolve().updateMany(data),\n delete: (data) => resolve().delete(data),\n deleteMany: (data) => resolve().deleteMany(data),\n consumeOne: (data) => resolve().consumeOne(data),\n incrementOne: (data) => resolve().incrementOne(data),\n transaction: (callback) => resolve().transaction(callback),\n }\n }\n}\n\n/** Resend reports failures in the resolved value, not by rejecting — surface\n * them loud so better-auth's flow (and the caller's logs) see the failure. */\nasync function sendEmail(client: AppAuthEmailClient, from: string, to: string, message: EmailMessage): Promise<void> {\n const { subject, html, text, attachments } = message\n const result = (await client.emails.send({ from, to, subject, html, text, attachments })) as\n | { error?: { message?: string } | null }\n | null\n | undefined\n if (result && typeof result === 'object' && result.error) {\n throw new Error(`[app-auth] email send failed: ${result.error.message ?? 'unknown error'}`)\n }\n}\n\nfunction resolveDatabase(config: AppAuthConfig): NonNullable<BetterAuthOptions['database']> {\n if (config.database) return config.database\n if (config.db && config.schema) {\n return deferDrizzleAdapter(config.db as Record<string, unknown>, {\n provider: config.provider ?? 'sqlite',\n schema: {\n user: config.schema.users,\n session: config.schema.sessions,\n account: config.schema.accounts,\n verification: config.schema.verifications,\n } as Record<string, unknown>,\n })\n }\n throw new Error(\n 'createAppAuth requires a database: pass `db` + `schema` (drizzle) or `database` (a better-auth adapter)',\n )\n}\n\nfunction resolveSocialProviders(social: AppAuthSocialConfig | undefined): BetterAuthOptions['socialProviders'] {\n const providers: NonNullable<BetterAuthOptions['socialProviders']> = {}\n if (social?.github?.clientId && social.github.clientSecret) {\n providers.github = { clientId: social.github.clientId, clientSecret: social.github.clientSecret }\n }\n if (social?.google?.clientId && social.google.clientSecret) {\n providers.google = { clientId: social.google.clientId, clientSecret: social.google.clientSecret }\n }\n return Object.keys(providers).length > 0 ? providers : undefined\n}\n\nfunction emailAndPasswordOptions(config: AppAuthConfig): BetterAuthOptions['emailAndPassword'] {\n const email = config.email\n if (!email) return { enabled: true }\n const warn = email.warn ?? ((message: string) => console.warn(message))\n return {\n enabled: true,\n sendResetPassword: async ({ user, url }) => {\n const client = resolveEmailClient(email)\n if (!client) {\n warn('[app-auth] email client unavailable — password reset email not sent')\n return\n }\n await sendEmail(client, email.from, user.email, noticeEmail(emailProduct(config), {\n subject: 'Reset your password',\n title: 'Reset your password',\n body: `Someone asked to reset the password for ${user.email}. If it was not you, ignore this email.`,\n action: { label: 'Reset password', url },\n showLink: true,\n note: 'This link expires in 1 hour.',\n footer: { reason: 'You received this because a password reset was requested for this address.' },\n }))\n },\n }\n}\n\nfunction emailVerificationOptions(config: AppAuthConfig): BetterAuthOptions['emailVerification'] {\n const email = config.email\n if (!email?.verifyOnSignUp) return undefined\n const warn = email.warn ?? ((message: string) => console.warn(message))\n return {\n sendOnSignUp: true,\n autoSignInAfterVerification: true,\n sendVerificationEmail: async ({ user, url }) => {\n const client = resolveEmailClient(email)\n if (!client) {\n warn('[app-auth] email client unavailable — verification email not sent')\n return\n }\n await sendEmail(client, email.from, user.email, noticeEmail(emailProduct(config), {\n subject: 'Verify your email',\n title: 'Verify your email',\n body: `Confirm ${user.email} to finish signing in to ${config.appName}.`,\n action: { label: 'Verify email', url },\n showLink: true,\n note: 'This link expires in 1 hour.',\n footer: { reason: `You received this because this address was used to sign in to ${config.appName}.` },\n }))\n },\n }\n}\n\n/**\n * Build the product's better-auth instance plus the request-boundary helpers:\n * `getSession` (Request → session|null), the `createAuthGuard` quartet\n * (`requireUser` 302, `requireApiUser` JSON 401, `requireSession`,\n * `getOptionalSession`), and — when `sso` is configured — the Tangle SSO\n * start/callback handlers with the session cookie minted through better-auth's\n * own name/attributes/signing (no `better-auth/crypto` in product code).\n */\nexport function createAppAuth(config: AppAuthConfig): AppAuth {\n if (!config.appName) throw new Error('createAppAuth: appName is required')\n if (!config.baseURL) throw new Error('createAppAuth: baseURL is required')\n\n const cookiePrefix = config.cookiePrefix ?? slugify(config.appName)\n if (!cookiePrefix) throw new Error('createAppAuth: cookiePrefix (or a slugifiable appName) is required')\n\n const socialProviders = resolveSocialProviders(config.social)\n const options: BetterAuthOptions = {\n appName: config.appName,\n baseURL: config.baseURL,\n ...(config.secret ? { secret: config.secret } : {}),\n ...(config.trustedOrigins ? { trustedOrigins: config.trustedOrigins } : {}),\n database: resolveDatabase(config),\n ...(config.emailAndPassword === false ? {} : { emailAndPassword: emailAndPasswordOptions(config) }),\n ...(config.email?.verifyOnSignUp ? { emailVerification: emailVerificationOptions(config) } : {}),\n ...(socialProviders ? { socialProviders } : {}),\n ...(config.sessionCookieCacheSeconds === false\n ? {}\n : {\n session: {\n cookieCache: {\n enabled: true,\n maxAge: config.sessionCookieCacheSeconds ?? DEFAULT_SESSION_COOKIE_CACHE_SECONDS,\n },\n },\n }),\n advanced: { cookiePrefix, ...config.advanced },\n }\n\n const auth: AppAuthInstance = betterAuth(options)\n\n const readSession = async (request: Request): Promise<AppAuthSession | null> => {\n const session = await auth.api.getSession({ headers: request.headers })\n return (session as AppAuthSession | null) ?? null\n }\n const memoMs = config.sessionCookieCacheSeconds === false ? 0\n : Math.min(SESSION_MEMO_MAX_MS, (config.sessionCookieCacheSeconds ?? DEFAULT_SESSION_COOKIE_CACHE_SECONDS) * 1000)\n const memoScope = `${config.baseURL}\\u0000${cookiePrefix}`\n const getSession = (request: Request): Promise<AppAuthSession | null> =>\n memoMs > 0 ? memoizedSession(memoScope, memoMs, request, readSession) : readSession(request)\n // Sign-out and session revocation drop this isolate's remembered sessions for the app.\n const handler = auth.handler\n auth.handler = async (request: Request) => {\n // In finally: a sign-out that fails after deleting the session must not leave it remembered.\n try { return await handler(request) }\n finally { if (request.method !== 'GET') forgetSessions(memoScope) }\n }\n\n const loginPath = config.loginPath ?? '/login'\n const guard = createAuthGuard<AppAuthSession>({ getSession, loginPath })\n\n let sso: TangleSsoHandlers | null = null\n if (config.sso) {\n const stateSecret = config.sso.stateSecret ?? config.secret\n if (!stateSecret) {\n throw new Error(\n 'createAppAuth: sso requires `secret` (or sso.stateSecret) — the signed-state CSRF cookie needs an HMAC secret',\n )\n }\n const transport = config.sso.protocol === 'oidc'\n ? { protocol: 'oidc' as const, auth: config.sso.client, store: config.sso.store, createPkcePair: config.sso.createPkcePair }\n : config.sso.protocol === 'identity'\n ? { protocol: 'identity' as const, auth: config.sso.client, store: config.sso.store }\n : { protocol: 'legacy' as const, auth: config.sso.client, store: config.sso.store }\n sso = createTangleSsoHandlers({\n ...transport,\n stateSecret,\n callbackUrl: config.sso.callbackUrl,\n stateCookieName: config.sso.stateCookieName ?? DEFAULT_STATE_COOKIE,\n setSessionCookie: createBetterAuthSessionCookieMinter(auth),\n secureCookies: config.sso.secureCookies ?? config.baseURL.startsWith('https:'),\n ...(config.sso.sessionTtlSeconds !== undefined ? { sessionTtlSeconds: config.sso.sessionTtlSeconds } : {}),\n ...(config.sso.stateTtlSeconds !== undefined ? { stateTtlSeconds: config.sso.stateTtlSeconds } : {}),\n ...(config.sso.defaultRedirectPath ? { defaultRedirectPath: config.sso.defaultRedirectPath } : {}),\n loginPath: config.sso.loginPath ?? loginPath,\n ...(config.sso.log ? { log: config.sso.log } : {}),\n })\n }\n\n return { auth, getSession, ...guard, sso }\n}\n"],"mappings":"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","names":[]}
@@ -1,8 +1,11 @@
1
1
  import {
2
2
  chatToolCallPart
3
- } from "../chunk-4WJREKXX.js";
3
+ } from "../chunk-O3ZM5QPC.js";
4
4
  import "../chunk-FAU5FIFD.js";
5
5
  import "../chunk-3HUFJ5LO.js";
6
+ import "../chunk-KHCJKVQN.js";
7
+ import "../chunk-XEURJVS5.js";
8
+ import "../chunk-E4AY62T2.js";
6
9
  import "../chunk-FBVLEGEG.js";
7
10
  import "../chunk-Y6PRDUFJ.js";
8
11
  import "../chunk-GEYACSFW.js";
@@ -10,13 +13,10 @@ import {
10
13
  ChatComposer
11
14
  } from "../chunk-GNA5I5NM.js";
12
15
  import "../chunk-L7MB2LLM.js";
13
- import "../chunk-KHCJKVQN.js";
14
- import "../chunk-XEURJVS5.js";
15
16
  import "../chunk-NJDQ2JCP.js";
16
17
  import {
17
18
  ModelPicker
18
19
  } from "../chunk-HG4OONJA.js";
19
- import "../chunk-E4AY62T2.js";
20
20
  import "../chunk-SJWIZT7B.js";
21
21
  import "../chunk-MLG6XKPV.js";
22
22
  import {
@@ -28,13 +28,13 @@ import "../chunk-MCYJON3F.js";
28
28
  import "../chunk-B7CL7ENS.js";
29
29
  import "../chunk-PV33JZKV.js";
30
30
  import "../chunk-7YA4QNTU.js";
31
- import "../chunk-2YLSWZ5W.js";
31
+ import "../chunk-JBEFTXDO.js";
32
32
  import "../chunk-ZVEEWGDK.js";
33
33
  import "../chunk-6E7LKHYV.js";
34
34
  import "../chunk-TXD5HXLE.js";
35
- import "../chunk-ZGUXI5SI.js";
36
- import "../chunk-6VQCFJWP.js";
35
+ import "../chunk-XNKLQG26.js";
37
36
  import "../chunk-LQYIBL3G.js";
37
+ import "../chunk-6VQCFJWP.js";
38
38
 
39
39
  // src/assistant/sse.ts
40
40
  var SSEChunkParser = class {
@@ -42,7 +42,7 @@ import {
42
42
  flattenHistory,
43
43
  readSandboxBinaryBytes,
44
44
  statSandboxFileSize
45
- } from "../chunk-TZD35SBQ.js";
45
+ } from "../chunk-7DG6GGRN.js";
46
46
  import "../chunk-4LBCTFBP.js";
47
47
  import "../chunk-MCYJON3F.js";
48
48
  import "../chunk-LWSJK546.js";
@@ -65,16 +65,16 @@ import {
65
65
  rowIdOf,
66
66
  storeSupportsDraftPersistence,
67
67
  streamChatRouteAsSandboxEvents
68
- } from "../chunk-FWLCPAST.js";
69
- import "../chunk-Q7WEEN7P.js";
68
+ } from "../chunk-SH56N4PV.js";
70
69
  import "../chunk-UTAIRVOK.js";
71
70
  import "../chunk-RN4WPTBH.js";
71
+ import "../chunk-Q7WEEN7P.js";
72
72
  import "../chunk-3NCPXNBZ.js";
73
73
  import {
74
74
  attachmentInputToPart,
75
75
  attachmentKindForMime,
76
76
  toChatMessageParts
77
- } from "../chunk-2YLSWZ5W.js";
77
+ } from "../chunk-JBEFTXDO.js";
78
78
  import "../chunk-ZVEEWGDK.js";
79
79
  import {
80
80
  ChatTurnInputError,
@@ -110,7 +110,7 @@ import {
110
110
  import {
111
111
  isWorkspaceFileExportable
112
112
  } from "../chunk-TXD5HXLE.js";
113
- import "../chunk-YXYQ6MJL.js";
113
+ import "../chunk-5V6VTO5Q.js";
114
114
  import "../chunk-YG66IHDU.js";
115
115
  import {
116
116
  asRecord,
@@ -124,7 +124,13 @@ import {
124
124
  normalizePersistedPart,
125
125
  normalizeToolEvent,
126
126
  terminalizeDanglingAssistantToolUpdates
127
- } from "../chunk-ZGUXI5SI.js";
127
+ } from "../chunk-XNKLQG26.js";
128
+ import {
129
+ parsePlanSubmittedEvent,
130
+ persistedPartToPlan,
131
+ planFollowUpTurnId,
132
+ planToPersistedPart
133
+ } from "../chunk-LQYIBL3G.js";
128
134
  import {
129
135
  cancelStatusFor,
130
136
  interactionPartKey,
@@ -135,16 +141,10 @@ import {
135
141
  parseInteractionCancel,
136
142
  parseInteractionRequest
137
143
  } from "../chunk-6VQCFJWP.js";
138
- import {
139
- parsePlanSubmittedEvent,
140
- persistedPartToPlan,
141
- planFollowUpTurnId,
142
- planToPersistedPart
143
- } from "../chunk-LQYIBL3G.js";
144
144
  import {
145
145
  coalesceDeltas,
146
146
  createBufferedTurnTap
147
- } from "../chunk-JGZ7WEPL.js";
147
+ } from "../chunk-JC7YSRBR.js";
148
148
 
149
149
  // src/chat-routes/model-failover-stream.ts
150
150
  var TERMINAL_FAILURE_TYPES = /* @__PURE__ */ new Set(["error", "session.run.failed"]);
@@ -14,15 +14,15 @@ import {
14
14
  mentionInputToPart,
15
15
  mentionPartsFromMessageParts,
16
16
  toChatMessageParts
17
- } from "../chunk-2YLSWZ5W.js";
17
+ } from "../chunk-JBEFTXDO.js";
18
18
  import "../chunk-ZVEEWGDK.js";
19
19
  import "../chunk-6E7LKHYV.js";
20
20
  import "../chunk-TXD5HXLE.js";
21
21
  import {
22
22
  attachmentPartKey
23
- } from "../chunk-ZGUXI5SI.js";
24
- import "../chunk-6VQCFJWP.js";
23
+ } from "../chunk-XNKLQG26.js";
25
24
  import "../chunk-LQYIBL3G.js";
25
+ import "../chunk-6VQCFJWP.js";
26
26
 
27
27
  // src/chat-store/core.ts
28
28
  var BULK_DELETE_MAX_THREADS = 200;
@@ -0,0 +1,41 @@
1
+ // src/launch-invariants/sized-reads.ts
2
+ var SIZED_READ_BYTES = 4 * 1024 * 1024;
3
+ var D1_MAX_BOUND_PARAMETERS = 100;
4
+ var SIZED_READ_ROWS = 50;
5
+ var SIZED_READ_COMPOSITE_ROWS = 40;
6
+ function sizedBatches(rows, options = {}) {
7
+ const bytes = options.bytes ?? SIZED_READ_BYTES;
8
+ const maxRows = options.rows ?? SIZED_READ_ROWS;
9
+ if (!(bytes > 0)) throw new RangeError("sized batches need a positive byte budget");
10
+ if (!(maxRows >= 1)) throw new RangeError("sized batches need at least one row per batch");
11
+ const batches = [];
12
+ let batch = [];
13
+ let size = 0;
14
+ for (const row of rows) {
15
+ const rowSize = Math.max(0, Number(row.size ?? 0) || 0);
16
+ if (batch.length > 0 && (size + rowSize > bytes || batch.length >= maxRows)) {
17
+ batches.push(batch);
18
+ batch = [];
19
+ size = 0;
20
+ }
21
+ batch.push(row.key);
22
+ size += rowSize;
23
+ }
24
+ if (batch.length > 0) batches.push(batch);
25
+ return batches;
26
+ }
27
+ async function* readInSizedBatches(rows, read, options = {}) {
28
+ for (const keys of sizedBatches(rows, options)) {
29
+ yield { keys, value: await read(keys) };
30
+ }
31
+ }
32
+
33
+ export {
34
+ SIZED_READ_BYTES,
35
+ D1_MAX_BOUND_PARAMETERS,
36
+ SIZED_READ_ROWS,
37
+ SIZED_READ_COMPOSITE_ROWS,
38
+ sizedBatches,
39
+ readInSizedBatches
40
+ };
41
+ //# sourceMappingURL=chunk-5UQJ7F3P.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/launch-invariants/sized-reads.ts"],"sourcesContent":["/**\n * Reads of a large column a bounded batch at a time.\n *\n * On 2026-10-10 GTM's scheduled jobs exceeded the Worker's 128 MB by reading a\n * day of stored turns at once: the outcome sweep held about 93 MB of turn\n * events, the reliability report read 1.63 M events, and turn health read\n * 121.8 MB of message parts in one query. D1 refuses the same read on its side\n * with `D1_ERROR: Memory limit exceeded before EOF`.\n *\n * A caller lists each row's key with the stored size of its large column\n * (SQLite `length(column)`), then reads and handles one batch before it reads\n * the next, keeping only what it concluded (counts, verdicts) rather than the\n * rows. Memory then holds one batch, not the day.\n *\n * Keep what you conclude, not what you read: a value sliced or matched out of a\n * large string can pin the whole parent string in V8 (a regex match kept in a\n * Map held every tool output it came from). Copy a kept substring out, e.g.\n * `new URL(match).href` or `(' ' + text).slice(1)`, before the row goes.\n */\n\n/** Most bytes of a large column one read returns; a single larger row is read alone. */\nexport const SIZED_READ_BYTES = 4 * 1024 * 1024\n\n/** D1 binds at most 100 parameters to one query. */\nexport const D1_MAX_BOUND_PARAMETERS = 100\n\n/** Most single-column keys one read binds, leaving room for the query's own parameters. */\nexport const SIZED_READ_ROWS = 50\n\n/** Most two-column keys, such as (turnId, seq), one read binds: two parameters each. */\nexport const SIZED_READ_COMPOSITE_ROWS = 40\n\n/** A row's key and the stored size of its large column. */\nexport interface SizedRow<K> {\n key: K\n /** `length()` of the large column; null when it is NULL. */\n size: number | null | undefined\n}\n\nexport interface SizedBatchOptions {\n /** Most bytes per batch. Default {@link SIZED_READ_BYTES}. */\n bytes?: number\n /** Most keys per batch. Default {@link SIZED_READ_ROWS}; `Infinity` for a range read (`seq BETWEEN`). */\n rows?: number\n}\n\n/** Consecutive keys whose stored sizes fit one read, in their listed order. */\nexport function sizedBatches<K>(rows: Iterable<SizedRow<K>>, options: SizedBatchOptions = {}): K[][] {\n const bytes = options.bytes ?? SIZED_READ_BYTES\n const maxRows = options.rows ?? SIZED_READ_ROWS\n if (!(bytes > 0)) throw new RangeError('sized batches need a positive byte budget')\n if (!(maxRows >= 1)) throw new RangeError('sized batches need at least one row per batch')\n const batches: K[][] = []\n let batch: K[] = []\n let size = 0\n for (const row of rows) {\n const rowSize = Math.max(0, Number(row.size ?? 0) || 0)\n if (batch.length > 0 && (size + rowSize > bytes || batch.length >= maxRows)) {\n batches.push(batch)\n batch = []\n size = 0\n }\n batch.push(row.key)\n size += rowSize\n }\n if (batch.length > 0) batches.push(batch)\n return batches\n}\n\n/**\n * Read listed rows one sized batch at a time. Each batch is read only after the\n * caller has handled the previous one, so a `for await` loop that keeps its\n * conclusions and drops the rows holds one batch at most.\n */\nexport async function* readInSizedBatches<K, R>(\n rows: Iterable<SizedRow<K>>,\n read: (keys: K[]) => Promise<R>,\n options: SizedBatchOptions = {},\n): AsyncGenerator<{ keys: K[]; value: R }> {\n for (const keys of sizedBatches(rows, options)) {\n yield { keys, value: await read(keys) }\n }\n}\n"],"mappings":";AAqBO,IAAM,mBAAmB,IAAI,OAAO;AAGpC,IAAM,0BAA0B;AAGhC,IAAM,kBAAkB;AAGxB,IAAM,4BAA4B;AAiBlC,SAAS,aAAgB,MAA6B,UAA6B,CAAC,GAAU;AACnG,QAAM,QAAQ,QAAQ,SAAS;AAC/B,QAAM,UAAU,QAAQ,QAAQ;AAChC,MAAI,EAAE,QAAQ,GAAI,OAAM,IAAI,WAAW,2CAA2C;AAClF,MAAI,EAAE,WAAW,GAAI,OAAM,IAAI,WAAW,+CAA+C;AACzF,QAAM,UAAiB,CAAC;AACxB,MAAI,QAAa,CAAC;AAClB,MAAI,OAAO;AACX,aAAW,OAAO,MAAM;AACtB,UAAM,UAAU,KAAK,IAAI,GAAG,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC;AACtD,QAAI,MAAM,SAAS,MAAM,OAAO,UAAU,SAAS,MAAM,UAAU,UAAU;AAC3E,cAAQ,KAAK,KAAK;AAClB,cAAQ,CAAC;AACT,aAAO;AAAA,IACT;AACA,UAAM,KAAK,IAAI,GAAG;AAClB,YAAQ;AAAA,EACV;AACA,MAAI,MAAM,SAAS,EAAG,SAAQ,KAAK,KAAK;AACxC,SAAO;AACT;AAOA,gBAAuB,mBACrB,MACA,MACA,UAA6B,CAAC,GACW;AACzC,aAAW,QAAQ,aAAa,MAAM,OAAO,GAAG;AAC9C,UAAM,EAAE,MAAM,OAAO,MAAM,KAAK,IAAI,EAAE;AAAA,EACxC;AACF;","names":[]}
@@ -1,3 +1,7 @@
1
+ import {
2
+ DEFAULT_RUNNING_TURN_LEASE_MS
3
+ } from "./chunk-JC7YSRBR.js";
4
+
1
5
  // src/stream/turn-observation.ts
2
6
  function parseTurnObservation(value) {
3
7
  if (value === void 0) return {
@@ -88,9 +92,68 @@ async function consumeTurnStream(body, options) {
88
92
  return state;
89
93
  }
90
94
 
95
+ // src/stream/orphaned-turns.ts
96
+ var ORPHANED_TURN_CODE = "turn.orphaned";
97
+ var TAIL_EVENTS = 50;
98
+ var DEFAULT_LIMIT = 50;
99
+ async function settleOrphanedTurns(options) {
100
+ const { store } = options;
101
+ if (!store.listStaleRunning) throw new Error("settleOrphanedTurns needs a TurnEventStore with listStaleRunning (the D1 and memory stores have it)");
102
+ const now = options.now ?? Date.now();
103
+ const staleAfterMs = options.staleAfterMs ?? DEFAULT_RUNNING_TURN_LEASE_MS;
104
+ const cutoff = now - staleAfterMs;
105
+ const stale = await store.listStaleRunning(cutoff, options.limit ?? DEFAULT_LIMIT);
106
+ const settled = [];
107
+ const owned = [];
108
+ for (const turn of stale) {
109
+ if (options.isOwned && await options.isOwned(turn)) {
110
+ owned.push(turn.turnId);
111
+ continue;
112
+ }
113
+ const tail = await store.readTail?.(turn.turnId, TAIL_EVENTS) ?? [];
114
+ const { seq, at, phase } = describeTail(tail);
115
+ await store.append(turn.turnId, [{
116
+ seq: seq + 1,
117
+ event: JSON.stringify({
118
+ type: "error",
119
+ data: { message: `The turn stopped without finishing during ${phase ?? "the turn"}. Retry to send it again.`, code: ORPHANED_TURN_CODE, orphaned: true, retryable: true },
120
+ _t: at
121
+ })
122
+ }]);
123
+ await store.setStatus(turn.turnId, "error", void 0, { preserveUpdatedAt: true, onlyIfRunningBefore: cutoff });
124
+ settled.push({
125
+ turnId: turn.turnId,
126
+ scopeId: turn.scopeId,
127
+ lastRenewedAt: turn.updatedAt,
128
+ detectionLagMs: Math.max(0, now - (turn.updatedAt + DEFAULT_RUNNING_TURN_LEASE_MS)),
129
+ phase
130
+ });
131
+ }
132
+ return { settled, owned, maxDetectionLagMs: settled.reduce((max, turn) => Math.max(max, turn.detectionLagMs), 0) };
133
+ }
134
+ function describeTail(tail) {
135
+ let seq = 0;
136
+ let at = 0;
137
+ let phase = null;
138
+ for (const row of tail) {
139
+ seq = Math.max(seq, row.seq);
140
+ let event;
141
+ try {
142
+ event = JSON.parse(row.event);
143
+ } catch {
144
+ continue;
145
+ }
146
+ if (typeof event?._t === "number") at = Math.max(at, event._t);
147
+ if (phase === null && event?.type === "session.run.phase" && typeof event.data?.phase === "string") phase = event.data.phase;
148
+ }
149
+ return { seq, at, phase };
150
+ }
151
+
91
152
  export {
92
153
  parseTurnObservation,
93
154
  observeTurnEvent,
94
- consumeTurnStream
155
+ consumeTurnStream,
156
+ ORPHANED_TURN_CODE,
157
+ settleOrphanedTurns
95
158
  };
96
- //# sourceMappingURL=chunk-YXYQ6MJL.js.map
159
+ //# sourceMappingURL=chunk-5V6VTO5Q.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/stream/turn-observation.ts","../src/stream/orphaned-turns.ts"],"sourcesContent":["/** Read-side checkpoints for native chat NDJSON. This never submits or cancels work. */\nexport interface TurnObservation {\n schema: 'turn-observation-v1'\n streamId: string | null\n /** Replay ordinals only. Unsequenced live frames cannot advance this cursor. */\n lastSeq: number\n outcome: 'completed' | 'failed' | null\n replayStatus: string | null\n eventCount: number\n}\n\nexport function parseTurnObservation(value?: unknown): TurnObservation {\n if (value === undefined) return {\n schema: 'turn-observation-v1', streamId: null, lastSeq: 0,\n outcome: null, replayStatus: null, eventCount: 0,\n }\n if (!value || typeof value !== 'object' || Array.isArray(value)) throw new TypeError('Invalid turn observation')\n const v = value as Record<string, unknown>\n if (v.schema !== 'turn-observation-v1'\n || !(v.streamId === null || (typeof v.streamId === 'string' && /^[A-Za-z0-9_-]+$/.test(v.streamId)))\n || !Number.isSafeInteger(v.lastSeq) || Number(v.lastSeq) < 0\n || !Number.isSafeInteger(v.eventCount) || Number(v.eventCount) < 0\n || !(v.outcome === null || v.outcome === 'completed' || v.outcome === 'failed')\n || !(v.replayStatus === null || typeof v.replayStatus === 'string')\n || (v.streamId === null && Number(v.lastSeq) > 0)) throw new TypeError('Invalid turn observation')\n return {\n schema: 'turn-observation-v1', streamId: v.streamId as string | null,\n lastSeq: Number(v.lastSeq), outcome: v.outcome as TurnObservation['outcome'],\n replayStatus: v.replayStatus as string | null, eventCount: Number(v.eventCount),\n }\n}\n\nexport interface TurnObservationUpdate {\n checkpoint: TurnObservation\n /** False only for an already-checkpointed replay ordinal. */\n accepted: boolean\n event: Record<string, unknown>\n}\n\n/** Reduce an observed frame. Ordered replay gaps are errors, not silent lost work. */\nexport function observeTurnEvent(previous: TurnObservation, raw: unknown): TurnObservationUpdate {\n const checkpoint = parseTurnObservation(previous)\n if (!raw || typeof raw !== 'object' || Array.isArray(raw)) throw new TypeError('Turn frame must be an object')\n const outer = raw as Record<string, unknown>\n const inner = outer.kind === 'event' ? outer.event : outer\n if (!inner || typeof inner !== 'object' || Array.isArray(inner)) throw new TypeError('Invalid turn event envelope')\n const event = inner as Record<string, unknown>\n if (typeof event.type !== 'string' || !event.type) throw new TypeError('Turn frame requires a type')\n\n // Even a duplicate marker must not switch which execution we are observing.\n if (event.type === 'turn') {\n if (typeof event.turnId !== 'string' || !/^[A-Za-z0-9_-]+$/.test(event.turnId)) throw new TypeError('Invalid stream identity')\n if (checkpoint.streamId !== null && checkpoint.streamId !== event.turnId) throw new Error('Replay stream identity changed')\n checkpoint.streamId = event.turnId\n }\n const seq = outer.seq\n if (seq !== undefined && seq !== -1) {\n if (!Number.isSafeInteger(seq) || Number(seq) < 1) throw new TypeError('Invalid replay ordinal')\n if (checkpoint.streamId === null) throw new Error('Replay ordinal arrived before stream identity')\n if (Number(seq) <= checkpoint.lastSeq) return { checkpoint, accepted: false, event }\n if (Number(seq) !== checkpoint.lastSeq + 1) throw new Error('Replay has a gap; retain the checkpoint and inspect durable history')\n checkpoint.lastSeq = Number(seq)\n } else if (seq === -1 && event.type !== 'turn_status') {\n throw new TypeError('Only a turn-status sentinel may have ordinal -1')\n }\n\n if (event.type === 'error' || event.type === 'session.run.failed') checkpoint.outcome = 'failed'\n if (event.type === 'session.run.completed' && checkpoint.outcome !== 'failed') checkpoint.outcome = 'completed'\n if (event.type === 'turn_status') {\n if (typeof event.status !== 'string') throw new TypeError('Turn status requires a value')\n checkpoint.replayStatus = event.status\n if (['error', 'failed', 'aborted', 'cancelled'].includes(event.status)) checkpoint.outcome = 'failed'\n if (['complete', 'completed'].includes(event.status) && checkpoint.outcome !== 'failed') checkpoint.outcome = 'completed'\n }\n checkpoint.eventCount += 1\n return { checkpoint, accepted: true, event }\n}\n\nexport interface ConsumeTurnStreamOptions {\n checkpoint?: TurnObservation\n /** Commit evidence and its checkpoint durably before acknowledging this frame. */\n commit(update: TurnObservationUpdate): Promise<void>\n /** Bound untrusted frame memory, not total run duration or total transcript size. */\n maxFrameBytes?: number\n}\n\n/**\n * Consume one viewing connection. EOF without a terminal event stays incomplete.\n * A disconnect/abort propagates; the last committed checkpoint remains resumable.\n * The caller owns network observation windows separately from execution deadlines.\n */\nexport async function consumeTurnStream(\n body: AsyncIterable<Uint8Array>,\n options: ConsumeTurnStreamOptions,\n): Promise<TurnObservation> {\n const maxFrameBytes = options.maxFrameBytes ?? 4 * 1024 * 1024\n if (!Number.isSafeInteger(maxFrameBytes) || maxFrameBytes < 1) throw new RangeError('Frame byte limit must be positive')\n let state = parseTurnObservation(options.checkpoint)\n const decoder = new TextDecoder('utf-8', { fatal: true })\n let pending = ''\n let frameBytes = 0\n async function accept(line: string): Promise<void> {\n if (!line.trim()) return\n const update = observeTurnEvent(state, JSON.parse(line))\n if (update.accepted) await options.commit(update)\n state = update.checkpoint\n }\n for await (const chunk of body) {\n // Count bytes before decoding: a malicious unterminated frame cannot grow\n // without bound, and splitting UTF-8 characters across chunks stays valid.\n let start = 0\n for (let end = 0; end < chunk.length; end += 1) {\n if (chunk[end] !== 10) continue\n frameBytes += end - start\n if (frameBytes > maxFrameBytes) throw new RangeError('Turn frame exceeds byte limit')\n pending += decoder.decode(chunk.subarray(start, end + 1), { stream: true })\n await accept(pending)\n pending = ''; frameBytes = 0; start = end + 1\n }\n frameBytes += chunk.length - start\n if (frameBytes > maxFrameBytes) throw new RangeError('Turn frame exceeds byte limit')\n pending += decoder.decode(chunk.subarray(start), { stream: true })\n }\n pending += decoder.decode()\n await accept(pending)\n return state\n}\n","/**\n * Settle turn streams whose owner is gone.\n *\n * A running turn row is a lease: the buffer renews it every 30 s while a\n * producer lives, and a durable observer renews it on each pass. A row nothing\n * renewed past its lease has no producer left; the Worker that streamed it\n * died. Left alone it stays `running` forever: a reconnecting client waits on\n * it, discovery offers it, and reports count it as in flight. On 2026-10-10\n * GTM held 51 such rows, some for hours, and its failure notices arrived 8–11 h\n * after the turns had stopped.\n *\n * {@link settleOrphanedTurns} ends each one the way the buffer ends a failed\n * turn: a terminal `error` event naming the phase it stopped in, then status\n * `error`, written only while the row is still running and still stale, and\n * without moving its update time (reports place a stream by it). It returns\n * each turn's detection lag, the time from its lease expiring to this\n * settlement, so a product can report how late it noticed. Run it from its own\n * scheduled invocation at least every 15 minutes.\n */\nimport { DEFAULT_RUNNING_TURN_LEASE_MS, type BufferedTurnEvent, type StaleRunningTurn, type TurnEventStore } from './turn-buffer'\n\n/** The failure code carried by the terminal event of a settled orphan. */\nexport const ORPHANED_TURN_CODE = 'turn.orphaned'\n\n/** How many tail events are read to name the phase a turn stopped in. */\nconst TAIL_EVENTS = 50\nconst DEFAULT_LIMIT = 50\n\nexport interface SettleOrphanedTurnsOptions {\n store: TurnEventStore\n now?: number\n /** A row older than this since its last renewal is orphaned. Default the running lease, 5 minutes. */\n staleAfterMs?: number\n /** Most rows settled per run; the next run takes the rest. Default 50. */\n limit?: number\n /**\n * Whether something still owns this turn although it stopped renewing the\n * row, such as an open completion admission with a live lease. An owned turn\n * is skipped. A product whose durable owner does not renew the row must\n * answer this, or its live turns are settled as orphans.\n */\n isOwned?: (turn: StaleRunningTurn) => Promise<boolean>\n}\n\nexport interface SettledOrphanedTurn {\n turnId: string\n scopeId: string | null\n /** Unix ms the row was last renewed. */\n lastRenewedAt: number\n /** From its lease expiring to this settlement. */\n detectionLagMs: number\n /** The run phase the stream last reported, when it reported one. */\n phase: string | null\n}\n\nexport interface SettleOrphanedTurnsResult {\n settled: SettledOrphanedTurn[]\n /** Stale rows an owner still held. */\n owned: string[]\n /** Most detection lag among the settled turns, in ms. */\n maxDetectionLagMs: number\n}\n\n/** End every running turn stream nothing has renewed past its lease. */\nexport async function settleOrphanedTurns(options: SettleOrphanedTurnsOptions): Promise<SettleOrphanedTurnsResult> {\n const { store } = options\n if (!store.listStaleRunning) throw new Error('settleOrphanedTurns needs a TurnEventStore with listStaleRunning (the D1 and memory stores have it)')\n const now = options.now ?? Date.now()\n const staleAfterMs = options.staleAfterMs ?? DEFAULT_RUNNING_TURN_LEASE_MS\n const cutoff = now - staleAfterMs\n const stale = await store.listStaleRunning(cutoff, options.limit ?? DEFAULT_LIMIT)\n const settled: SettledOrphanedTurn[] = []\n const owned: string[] = []\n for (const turn of stale) {\n if (options.isOwned && await options.isOwned(turn)) {\n owned.push(turn.turnId)\n continue\n }\n const tail = (await store.readTail?.(turn.turnId, TAIL_EVENTS)) ?? []\n const { seq, at, phase } = describeTail(tail)\n await store.append(turn.turnId, [{\n seq: seq + 1,\n event: JSON.stringify({\n type: 'error',\n data: { message: `The turn stopped without finishing during ${phase ?? 'the turn'}. Retry to send it again.`, code: ORPHANED_TURN_CODE, orphaned: true, retryable: true },\n _t: at,\n }),\n }])\n // Only a row still running and still stale: a producer that came back keeps its stream.\n await store.setStatus(turn.turnId, 'error', undefined, { preserveUpdatedAt: true, onlyIfRunningBefore: cutoff })\n settled.push({\n turnId: turn.turnId,\n scopeId: turn.scopeId,\n lastRenewedAt: turn.updatedAt,\n detectionLagMs: Math.max(0, now - (turn.updatedAt + DEFAULT_RUNNING_TURN_LEASE_MS)),\n phase,\n })\n }\n return { settled, owned, maxDetectionLagMs: settled.reduce((max, turn) => Math.max(max, turn.detectionLagMs), 0) }\n}\n\ninterface TailEvent {\n type?: unknown\n _t?: unknown\n data?: { phase?: unknown }\n}\n\nfunction describeTail(tail: readonly BufferedTurnEvent[]): { seq: number; at: number; phase: string | null } {\n let seq = 0\n let at = 0\n let phase: string | null = null\n for (const row of tail) {\n seq = Math.max(seq, row.seq)\n let event: TailEvent | null\n try {\n event = JSON.parse(row.event) as TailEvent | null\n } catch {\n continue\n }\n if (typeof event?._t === 'number') at = Math.max(at, event._t)\n if (phase === null && event?.type === 'session.run.phase' && typeof event.data?.phase === 'string') phase = event.data.phase\n }\n return { seq, at, phase }\n}\n"],"mappings":"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","names":[]}
@@ -1733,14 +1733,15 @@ async function provisionWorkspaceSandbox(shell, options) {
1733
1733
  throw new Error("livenessProbe.execTimeoutMs must be an integer between 100 and 600000");
1734
1734
  }
1735
1735
  const { workspaceId, userId, harness, forceNew, onProgress, billingOwnerId } = options;
1736
- const resolved = await resolveWorkspaceSandboxClient(shell, workspaceId, userId);
1736
+ const measure = (stage, operation) => options.measure ? options.measure(`sandbox.ensure.${stage}`, operation) : operation();
1737
+ const resolved = await measure("credentials", () => resolveWorkspaceSandboxClient(shell, workspaceId, userId));
1737
1738
  const { scope, client } = resolved;
1738
1739
  let name = resolved.name;
1739
1740
  let recoveryRestore;
1740
1741
  let replacementRequested = false;
1741
1742
  const resources = shell.resources ?? DEFAULT_SANDBOX_RESOURCES;
1742
1743
  const resumeTimeout = shell.provisionTimeoutMs ?? DEFAULT_PROVISION_TIMEOUT_MS;
1743
- let existing = await listRunning(client, name);
1744
+ let existing = await measure("list_running", () => listRunning(client, name));
1744
1745
  if (forceNew && existing.succeeded && !existing.value) {
1745
1746
  existing = await listStopped(client, name);
1746
1747
  }
@@ -1753,11 +1754,17 @@ async function provisionWorkspaceSandbox(shell, options) {
1753
1754
  throw new Error(`forceNew: sandbox ${name} could not be deleted`, { cause: dropped.error });
1754
1755
  }
1755
1756
  } else if (found.metadata?.harness === harness) {
1756
- const runtimeEnv2 = await resolveWorkspaceRuntimeEnv(shell, scope);
1757
+ const [envResult, readyResult] = await Promise.allSettled([
1758
+ measure("runtime_env", () => resolveWorkspaceRuntimeEnv(shell, scope)),
1759
+ measure("refresh", () => refreshRuntimeConnection(client, found))
1760
+ ]);
1761
+ if (envResult.status === "rejected") throw envResult.reason;
1762
+ const runtimeEnv2 = envResult.value;
1757
1763
  try {
1758
- const ready = await refreshRuntimeConnection(client, found);
1759
- if ((await isReusableBox(ready, shell.livenessProbe)).succeeded) {
1760
- return await finalizeExistingBox(shell, client, ready, "reused", name, workspaceId, userId, harness, scope, runtimeEnv2);
1764
+ if (readyResult.status === "rejected") throw readyResult.reason;
1765
+ const ready = readyResult.value;
1766
+ if ((await measure("liveness", () => isReusableBox(ready, shell.livenessProbe))).succeeded) {
1767
+ return await measure("finalize", () => finalizeExistingBox(shell, client, ready, "reused", name, workspaceId, userId, harness, scope, runtimeEnv2));
1761
1768
  }
1762
1769
  const recovered = await recoverUnresponsiveBox(
1763
1770
  client,
@@ -2594,4 +2601,4 @@ export {
2594
2601
  isTerminalPromptEvent,
2595
2602
  detectInteractiveQuestion
2596
2603
  };
2597
- //# sourceMappingURL=chunk-TZD35SBQ.js.map
2604
+ //# sourceMappingURL=chunk-7DG6GGRN.js.map