apps 0.0.1-beta.36 → 0.0.1-beta.38

package/js/{chunk-KOOJUMLR.js → chunk-3MMG2H6M.js}

@@ -160,7 +160,7 @@ import {
   pipeThroughChannel,
   provide,
   provide2,
-  provideContext2 as provideContext,
+  provideContext,
   provideMerge,
   redact,
   remove,
@@ -211,7 +211,7 @@ import {
   withFiber,
   withParentSpan,
   zero2 as zero
-} from "./chunk-IJQ5LE74.js";
+} from "./chunk-MXDKXAY4.js";
 import {
   __export
 } from "./chunk-CZ7CSFO4.js";

package/js/{chunk-XEXUHXC3.js → chunk-3V575NIW.js}

@@ -1,8 +1,3 @@
-import {
-  DatabaseFieldReserved,
-  DatabaseLimitExceeded,
-  DatabaseSchema
-} from "./chunk-73AV3JVU.js";
 import {
   CacheCommand,
   CacheReply,
@@ -13,17 +8,20 @@ import {
   FailureSource,
   ProviderError,
   UpstreamError
-} from "./chunk-BI6R577B.js";
+} from "./chunk-P7MGDPFD.js";
 import {
   AppSkillName,
   AppSkills
-} from "./chunk-556EWA6P.js";
+} from "./chunk-MLHNVYHT.js";
+import {
+  RecordedMessage
+} from "./chunk-KAQD3DTI.js";
 import {
   AccountId,
   HttpUrl,
   JsonObject as JsonObject2,
   JsonValue
-} from "./chunk-BI45HZWM.js";
+} from "./chunk-YQ35E7KS.js";
 import {
   Any,
   ArraySchema,
@@ -65,7 +63,7 @@ import {
   isBetween,
   isSchema,
   isStream,
-  make4 as make,
+  make2 as make,
   merge,
   optional,
   optionalKey,
@@ -78,7 +76,7 @@ import {
   transformOptional,
   withConstructorDefault,
   withDefault
-} from "./chunk-IJQ5LE74.js";
+} from "./chunk-MXDKXAY4.js";
 
 // src/contracts/api-response-error.ts
 var maxApiErrorInstructionsLength = 4096;
@@ -171,6 +169,13 @@ var WorkflowFailure = class extends Schema_exports.TaggedError()("WorkflowFailur
   ]),
   retryable: Schema_exports.Boolean
 }) {
+  /**
+   * The step name and error detail are the app's. Its run's owner reads them; telemetry records
+   * only the reason, however the failure was built or decoded.
+   */
+  get [RecordedMessage]() {
+    return this.step === void 0 && this.errorName === void 0 && !this.message ? void 0 : `The workflow failed (${this.reason}); the app's error is not recorded`;
+  }
 };
 var NonRetryableError = class extends Error {
   name = "NonRetryableError";
@@ -277,6 +282,177 @@ var WorkflowControlCommand = Schema_exports.Union([
   Schema_exports.Struct({ operation: Schema_exports.Literal("terminate"), run: WorkflowRunId })
 ]);
 
+// ../app-data/src/contracts/database.ts
+var DataName = Schema_exports.String.check(
+  Schema_exports.makeFilter((value) => /^[A-Za-z][A-Za-z0-9_]*$/.test(value) && value.length <= 128)
+);
+var Scalar = Schema_exports.Union([Schema_exports.String, Schema_exports.Finite, Schema_exports.Boolean]);
+var Field = Schema_exports.Struct({
+  kind: Schema_exports.Literals(["string", "number", "boolean", "id", "userId"]),
+  optional: Schema_exports.optional(Schema_exports.Boolean),
+  default: Schema_exports.optional(Scalar),
+  references: Schema_exports.optional(DataName)
+});
+var Index = Schema_exports.Struct({ name: DataName, fields: Schema_exports.NonEmptyArray(DataName) });
+var Table = Schema_exports.Struct({
+  fields: Schema_exports.Record(DataName, Field),
+  indexes: Schema_exports.Array(Index)
+});
+var DatabaseSchema = Schema_exports.Record(DataName, Table);
+var Row = Schema_exports.Record(Schema_exports.String, Scalar);
+var RowMetadata = Schema_exports.Struct({
+  id: Schema_exports.NonEmptyString,
+  createdAt: Schema_exports.String,
+  updatedAt: Schema_exports.String
+});
+var Patch = Schema_exports.Record(DataName, Schema_exports.NullOr(Scalar));
+var RangeClause = Schema_exports.Struct({
+  field: DataName,
+  op: Schema_exports.Literals(["eq", "gt", "gte", "lt", "lte"]),
+  value: Schema_exports.NullOr(Scalar)
+});
+var QueryPlan = Schema_exports.Struct({
+  table: DataName,
+  index: DataName,
+  order: Schema_exports.Literals(["asc", "desc"]),
+  clauses: Schema_exports.Array(RangeClause)
+});
+var QueryTerminal = Schema_exports.Union([
+  Schema_exports.Struct({ kind: Schema_exports.Literal("collect") }),
+  Schema_exports.Struct({ kind: Schema_exports.Literal("count") }),
+  Schema_exports.Struct({ kind: Schema_exports.Literal("first") }),
+  Schema_exports.Struct({
+    kind: Schema_exports.Literal("take"),
+    count: Schema_exports.Int.check(Schema_exports.isGreaterThanOrEqualTo(0))
+  }),
+  Schema_exports.Struct({
+    kind: Schema_exports.Literal("paginate"),
+    cursor: Schema_exports.NullOr(Schema_exports.String),
+    numItems: Schema_exports.Int.check(Schema_exports.isGreaterThan(0))
+  })
+]);
+var DatabaseOperation = Schema_exports.Union([
+  Schema_exports.Struct({ kind: Schema_exports.Literal("get"), table: DataName, id: Schema_exports.NonEmptyString }),
+  Schema_exports.Struct({ kind: Schema_exports.Literal("insert"), table: DataName, value: Patch }),
+  Schema_exports.Struct({
+    kind: Schema_exports.Literal("update"),
+    table: DataName,
+    id: Schema_exports.NonEmptyString,
+    patch: Patch
+  }),
+  Schema_exports.Struct({ kind: Schema_exports.Literal("delete"), table: DataName, id: Schema_exports.NonEmptyString }),
+  Schema_exports.Struct({ kind: Schema_exports.Literal("query"), plan: QueryPlan, terminal: QueryTerminal })
+]);
+var PaginationResult = Schema_exports.Struct({
+  page: Schema_exports.Array(Row),
+  continueCursor: Schema_exports.NullOr(Schema_exports.String),
+  isDone: Schema_exports.Boolean
+});
+var OperationResult = Schema_exports.Union([
+  Row,
+  Schema_exports.Array(Row),
+  PaginationResult,
+  Schema_exports.Boolean,
+  Schema_exports.Finite,
+  Schema_exports.Null
+]);
+var AppDatabaseError = class extends Schema_exports.TaggedError()("AppDatabaseError", {
+  reason: Schema_exports.Literals([
+    "schema",
+    "schema_changed",
+    "table",
+    "index",
+    "range",
+    "value",
+    "readonly",
+    "cursor",
+    "limit",
+    "closed",
+    "storage",
+    "replay"
+  ])
+}) {
+};
+var DatabaseLimits = Schema_exports.Struct({
+  rowsRead: Schema_exports.Int.check(Schema_exports.isGreaterThan(0)),
+  rowsReturned: Schema_exports.Int.check(Schema_exports.isGreaterThan(0)),
+  bytesRead: Schema_exports.Int.check(Schema_exports.isGreaterThan(0)),
+  writes: Schema_exports.Int.check(Schema_exports.isGreaterThan(0)),
+  scanCalls: Schema_exports.Int.check(Schema_exports.isGreaterThan(0)),
+  directGets: Schema_exports.Int.check(Schema_exports.isGreaterThan(0)),
+  valueBytes: Schema_exports.Int.check(Schema_exports.isGreaterThan(0)),
+  indexBytes: Schema_exports.Int.check(Schema_exports.isGreaterThan(0))
+});
+var defaultDatabaseLimits = {
+  rowsRead: 5e3,
+  rowsReturned: 1e3,
+  bytesRead: 4 * 1024 * 1024,
+  writes: 1e3,
+  scanCalls: 100,
+  directGets: 1e3,
+  valueBytes: 64 * 1024,
+  indexBytes: 2048
+};
+var DatabaseLimit = Schema_exports.Literals([
+  "scanCalls",
+  "directGets",
+  "rowsRead",
+  "rowsReturned",
+  "pageSize",
+  "bytesRead",
+  "writes",
+  "valueBytes"
+]);
+var count = (value) => value.toLocaleString("en-US");
+var limitMessages = {
+  scanCalls: (maximum, requested) => `This invocation made ${count(requested)} index queries; the limit is ${count(maximum)}. Each first(), take(), collect(), count() or paginate() call on withIndex(...) counts once. Read related rows with one take() or paginate() over a shared index prefix instead of one first() per item, use get(id) for known IDs, or split the work across workflow steps.`,
+  directGets: (maximum, requested) => `This invocation made ${count(requested)} get(id) calls, including those made by update and delete; the limit is ${count(maximum)}. Split the work across workflow steps or mutations.`,
+  rowsRead: (maximum, requested) => `This invocation read ${count(requested)} rows; the limit is ${count(maximum)}. Read fewer rows per call, through an index or a LIMIT, or split the work across calls or workflow steps.`,
+  rowsReturned: (maximum, requested) => `This invocation returned ${count(requested)} rows; the limit is ${count(maximum)}. collect() fails rather than truncating. Page with paginate() across calls or workflow steps.`,
+  pageSize: (maximum, requested) => `One call asked for ${count(requested)} rows; take(n) and paginate({ numItems }) accept at most ${count(maximum)}. Page with paginate() across calls or workflow steps.`,
+  bytesRead: (maximum, requested) => `This invocation read ${count(requested)} bytes; the limit is ${count(maximum)}. Read fewer or smaller rows per call, or page with paginate() across calls or workflow steps.`,
+  writes: (maximum, requested) => `This invocation wrote ${count(requested)} rows; the limit is ${count(maximum)}. Split large ingests into batches, one batch per mutation or workflow step.`,
+  valueBytes: (maximum, requested) => `A row encodes to ${count(requested)} bytes; each row may use at most ${count(maximum)}. Store large content outside the row or split it across rows.`
+};
+var DatabaseLimitExceeded = class extends Schema_exports.TaggedError()(
+  "DatabaseLimitExceeded",
+  {
+    limit: DatabaseLimit,
+    maximum: Schema_exports.Int,
+    requested: Schema_exports.Int
+  }
+) {
+  get message() {
+    return limitMessages[this.limit](this.maximum, this.requested);
+  }
+};
+var reservedFieldNames = ["id", "createdAt", "updatedAt"];
+var DatabaseFieldReserved = class extends Schema_exports.TaggedError()(
+  "DatabaseFieldReserved",
+  {
+    table: Schema_exports.String,
+    field: Schema_exports.Literals(reservedFieldNames)
+  }
+) {
+  get message() {
+    return `Table "${this.table}" declares "${this.field}", which is reserved: the host adds id, createdAt and updatedAt to every row. Rename the field, or use the row's own ${this.field}.`;
+  }
+};
+var DatabaseRuntimeLimits = Schema_exports.Struct({
+  maxCursorChars: Schema_exports.Int.check(Schema_exports.isGreaterThan(0)),
+  connectionCacheCapacity: Schema_exports.Int.check(Schema_exports.isGreaterThan(0)),
+  connectionCacheTtlMs: Schema_exports.Int.check(Schema_exports.isGreaterThan(0))
+});
+var defaultDatabaseRuntimeLimits = DatabaseRuntimeLimits.make({
+  maxCursorChars: 8192,
+  connectionCacheCapacity: 64,
+  connectionCacheTtlMs: 5 * 60 * 1e3
+});
+
+// src/contracts/sql.ts
+var reservedTablePrefix = "_executor_";
+var migrationsDirectory = "migrations";
+
 // ../../node_modules/.bun/effect@4.0.1/node_modules/effect/dist/rpc/RpcSchema.js
 var StreamSchemaTypeId = "~effect/rpc/RpcSchema/StreamSchema";
 var schema = /* @__PURE__ */ declare(isStream);
@@ -1963,7 +2139,7 @@ var ManyAccounts = class extends Data_exports.TaggedClass("many") {
 };
 
 // src/contracts/protocol-version.ts
-var frameworkProtocol = 9;
+var frameworkProtocol = 10;
 
 // src/contracts/protocols/oauth.ts
 var OAuthClientAuth2 = Schema_exports.Literals([
@@ -2089,12 +2265,12 @@ var OAuth2Config2 = Schema_exports.Union([
 
 // src/contracts/schedules.ts
 var minimumIntervalMilliseconds = 6e4;
-var count = Schema_exports.Int.check(Schema_exports.isGreaterThan(0));
+var count2 = Schema_exports.Int.check(Schema_exports.isGreaterThan(0));
 var absent = Schema_exports.optionalKey(Schema_exports.Never);
 var Interval = Schema_exports.Union([
-  Schema_exports.Struct({ seconds: count, minutes: absent, hours: absent }),
-  Schema_exports.Struct({ seconds: absent, minutes: count, hours: absent }),
-  Schema_exports.Struct({ seconds: absent, minutes: absent, hours: count })
+  Schema_exports.Struct({ seconds: count2, minutes: absent, hours: absent }),
+  Schema_exports.Struct({ seconds: absent, minutes: count2, hours: absent }),
+  Schema_exports.Struct({ seconds: absent, minutes: absent, hours: count2 })
 ]);
 var CalendarSchedule = Schema_exports.Struct({
   expression: Schema_exports.NonEmptyString,
@@ -2996,6 +3172,31 @@ var protocol9 = {
   }
 };
 
+// src/contracts/protocols/10.ts
+var DeclaredRequirements5 = Schema_exports.Struct({
+  ...DeclaredRequirements4.fields,
+  sql: Schema_exports.optionalKey(Schema_exports.Literal(true))
+});
+var MigrateCommand = Schema_exports.Struct({ operation: Schema_exports.Literal("migrate") });
+var MigrateResult = Schema_exports.Array(
+  Schema_exports.Struct({ id: Schema_exports.Int, name: Schema_exports.NonEmptyString })
+);
+var HostRequest4 = Schema_exports.Union([...HostRequest3.members, MigrateCommand]);
+var HostInvocation6 = Schema_exports.Struct({
+  ...HostInvocation5.fields,
+  command: HostRequest4
+});
+var protocol10 = {
+  version: 10,
+  schemas: {
+    ...protocol9.schemas,
+    request: HostRequest4,
+    requirements: DeclaredRequirements5,
+    invocation: HostInvocation6,
+    migrate: MigrateResult
+  }
+};
+
 // src/contracts/host.ts
 var skillsCommand = (sources) => sources ? { operation: "skills", sources: true } : { operation: "skills" };
 var skillCatalog = (response) => Schema_exports.is(SkillSources2)(response) ? response : { skills: response };
@@ -3090,6 +3291,10 @@ export {
   WorkflowRpcCommand,
   WorkflowRpcResult,
   WorkflowControlCommand,
+  DatabaseLimitExceeded,
+  DatabaseFieldReserved,
+  reservedTablePrefix,
+  migrationsDirectory,
   ElicitationLimits,
   defaultElicitationLimits,
   FormElicitation,
@@ -3153,16 +3358,13 @@ export {
   HostKindMismatch,
   protocol4,
   AccountCheckCommand,
-  HostRequest3 as HostRequest,
   protocol5,
   protocol6,
   CredentialHost,
   DeclaredAuthMethod3 as DeclaredAuthMethod,
   DeclaredProvider3 as DeclaredProvider,
-  DeclaredRequirements4 as DeclaredRequirements,
   ResolvedAccount3 as ResolvedAccount,
   ResolvedAccounts3 as ResolvedAccounts,
-  HostInvocation5 as HostInvocation,
   protocol7,
   HostDeclarationInvalid3 as HostDeclarationInvalid,
   HostEvaluationFailed3 as HostEvaluationFailed,
@@ -3177,6 +3379,12 @@ export {
   HostError5 as HostError,
   HostResponse5 as HostResponse,
   protocol9,
+  DeclaredRequirements5 as DeclaredRequirements,
+  MigrateCommand,
+  MigrateResult,
+  HostRequest4 as HostRequest,
+  HostInvocation6 as HostInvocation,
+  protocol10,
   skillsCommand,
   skillCatalog,
   inspectCommand,