@niscorp/tide 0.1.6 → 0.1.7

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.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,19 @@
1
1
  # @niscorp/tide
2
2
 
3
+ ## 0.1.7
4
+
5
+ ### Patch Changes
6
+
7
+ - 9b7ccbe: DOCS.md states nine facts about the API that were written only in source comments.
8
+
9
+ They are: what `maxFanOut` counts and that a run over it is skipped; what a fact's `depth`, `deliveredAt` and `root` hold; what a task's `unit` and `claimedUntil` hold; what `appendIfAbsent` returns, that the store mints a missing `id`, and when a `UNIQUE_BY` key with `when` applies; and what `onePer` limits in a claim.
10
+
11
+ One statement is corrected. DESIGN.md said a run's cause can be a run id or `manual:<who>`. A run's `cause` is `occurrence:<key>` or `fact:<id>`; who fired a reflex by hand is the manual fact's `by`. DOCS.md now lists the forms of a run's and a fact's `cause`.
12
+
13
+ No behaviour changed.
14
+
15
+ **What to change:** nothing.
16
+
3
17
  ## 0.1.6
4
18
 
5
19
  ### Patch Changes
package/DESIGN.md CHANGED
@@ -248,8 +248,8 @@ Three kinds (and two more fact flavours). Structured on purpose — a reflex is
248
248
 
249
249
  Any reflex — whatever its trigger — may additionally be fired by hand through
250
250
  `fire(reflexId, { now, input?, by? })`, **including a disarmed one**: arming gates *triggers*, not
251
- people, and testing before arming is half of what `fire` is for; the ledger records
252
- `manual:<who>` either way. A `manual` trigger just means *only* by hand. And `fire`
251
+ people, and testing before arming is half of what `fire` is for; the manual fact
252
+ records who fired in its `by` either way. A `manual` trigger just means *only* by hand. And `fire`
253
253
  is sugar over `ingest`: it mints a `manual` fact aimed at one reflex — `at` supplied
254
254
  by the caller, like every fact — so even the human verb enters through the one intake
255
255
  and reads no clock.
@@ -393,8 +393,8 @@ a guarantee nothing else can:
393
393
 
394
394
  - **`fact`** — everything that arrived: kind, payload, `dedupeKey`, depth, delivery,
395
395
  any park. The intake log *is* the audit trail of change.
396
- - **`run`** — one activation of one reflex: the cause (occurrence key, fact id, run id,
397
- or `manual:<who>`), the version hash, the identity it ran `as`, what the selection
396
+ - **`run`** — one activation of one reflex: the cause (`occurrence:<key>` or
397
+ `fact:<id>`), the version hash, the identity it ran `as`, what the selection
398
398
  returned, the counts, the outcome.
399
399
  - **`task`** — one unit of effect work: unit key, pinned `env`, state, attempt count,
400
400
  last error, and the handler's returned **output** — stored, which is what makes
package/DOCS.md CHANGED
@@ -45,7 +45,7 @@ type TideConfig = {
45
45
  maxChainDepth?: number; // default 24 — a fact deeper than this is parked
46
46
  maxChainFacts?: number; // default 10 000 — facts one chain may mint beneath its root; the rest are parked
47
47
  storeUnwatchedWrites?: boolean; // default true — false drops a write fact no loaded reflex could watch
48
- maxFanOut?: number; // default 10 000
48
+ maxFanOut?: number; // default 10 000 — rows one selection may return; a run whose selection returns more is skipped
49
49
  leaseMs?: number; // default 300 000 — how long a claim is good for
50
50
  onEvent?: (event: TideEvent) => void;
51
51
  };
@@ -457,10 +457,21 @@ tide.ledger.releaseParked(factId) // let a parked fact through, once; false if
457
457
  - **fact** — everything that arrived: the `FactInput` plus `id`, the `as` it
458
458
  was minted under, `depth`, `deliveredAt`, any `parked` reason and `released`
459
459
  override, the `root` of its chain and (on a root) its `descendants` count.
460
+ `depth` counts the hops from the start of a chain: a fact a handler emits or
461
+ a settled run mints is one deeper than the task or run it came from, and
462
+ `ingest` stores the `depth` it is handed. `deliveredAt` is the `now` of the
463
+ `advance` that offered the fact to every loaded reflex, set whether or not
464
+ one matched. `root` is the id of the fact that started the chain, and that
465
+ fact itself has none.
460
466
  - **run** — one activation: cause, version hash, the identity it ran `as`, what
461
- the selection returned, the counts, the outcome.
467
+ the selection returned, the counts, the outcome. A run's `cause` is
468
+ `occurrence:<key>` or `fact:<id>`; a fact's is `task:<id>` when a handler
469
+ emitted it and `run:<id>` when a run's settlement minted it.
462
470
  - **task** — one unit of effect work: unit key, pinned `env`, attempt count,
463
- lease, last error, `output`.
471
+ lease, last error, `output`. `unit` is the row's `unitKey` value as a string
472
+ in `each` mode, and `''` for a `batch` run and for a run with no selection.
473
+ `claimedUntil` is when the lease lapses, and `0` while the task is not
474
+ `claimed`.
464
475
 
465
476
  States: a task moves `pending → claimed → done | retrying | failed`; a run moves
466
477
  `pending → fanned → settled`, or lands on `skipped` (overlap, catch-up, a
@@ -566,11 +577,18 @@ of one operation and diverged three ways.
566
577
  - **`appendIfAbsent`** is idempotent on the table's unique key, declared once in
567
578
  the exported `UNIQUE_BY` constant. Those four constraints *are* the engine's
568
579
  exactly-once promises; a store that does not enforce all four is not a tide store.
580
+ It returns the stored row, or `undefined` on a collision: a refusal, not an
581
+ error. The store mints the `id` of a `fact`, `run` or `task` row that carries
582
+ none. A key with a `when` column applies only to rows that have that column
583
+ set, so a fact with no `dedupeKey` is always appended.
569
584
  - **`claim`** selects and mutates in one step. `set` accepts `{ inc: n }` for a
570
585
  counter, because `attempt` has to rise at claim time or a handler that
571
586
  reliably kills the process retries forever. `onePer` is `order: 'serial'`,
572
587
  and it lives inside the claim because a caller that looks first and claims
573
- second loses the race.
588
+ second loses the race. `onePer: { column, held, only }` lets at most one row
589
+ per value of `column` be held at a time, counting rows that match `held`
590
+ from an earlier claim; it applies to the values listed in `only`, and every
591
+ other value claims freely.
574
592
  - **`cas`** is the fence: a timed-out attempt finishing late finds its token
575
593
  superseded and is discarded. Setting a field to `undefined` clears it.
576
594
  - **`transact`** is required. Fan-out committing with its run's transition, and
package/dist/agent.cjs CHANGED
@@ -55,15 +55,11 @@ var RetrySchema = zod.z.object({
55
55
  var PolicySchema = zod.z.object({
56
56
  retry: RetrySchema.optional(),
57
57
  timeoutMs: zod.z.number().int().positive().default(3e4),
58
- // May a firing start while the previous one is unsettled? The long
59
- // billing run still going at the next tick must not double-start.
60
58
  overlap: zod.z.enum(["skip", "allow"]).default("skip"),
61
59
  catchUp: zod.z.enum(["run", "skip", "latest"]).default("run"),
62
- // How late is "missed"? Only `catchUp: 'skip'` reads it — 'run' opens
63
- // everything and 'latest' keeps the newest regardless of age. What
64
- // `catchUp` opens still passes `overlap`: occurrences missed together are
65
- // repeats of one another, so under 'skip' the oldest runs and the rest
66
- // are recorded as overlap skips.
60
+ // Read by `catchUp: 'skip'` only. What `catchUp` opens still passes
61
+ // `overlap`: occurrences missed together are repeats of one another, so
62
+ // under `overlap: 'skip'` the oldest runs and the rest are skipped.
67
63
  lateMs: zod.z.number().int().positive().default(36e5),
68
64
  order: zod.z.enum(["any", "serial"]).default("any")
69
65
  }).strict();
@@ -187,8 +183,6 @@ var createReflexAgent = (config) => cortex.defineAgent({
187
183
  context: [() => describeEffects(config.effects)],
188
184
  output: {
189
185
  schema: answerSchemaOf(config),
190
- // Corrected in the run, tools and context still warm. Only a draft
191
- // names an effect; a question or a refusal has nothing to check here.
192
186
  validate: (envelope) => {
193
187
  if (!isDraft(envelope.data)) return { ok: true };
194
188
  const problem = effectProblem(config.effects, envelope.data);
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/schemas/trigger.schema.ts","../src/schemas/policy.schema.ts","../src/schemas/reflex.schema.ts","../src/agent/reflex-agent.ts"],"names":["z","defineAgent"],"mappings":"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","file":"agent.cjs","sourcesContent":["import { z } from 'zod';\n\n// ═══════════════════════════════════════════════════════════════\n// Triggers — four kinds, closed.\n//\n// Structured on purpose: a reflex is shown to the operator it\n// affects, and `{ every: 'month', on: 1, at: '03:00' }` is\n// reviewable by the person it bills where `0 3 1 * *` is a\n// shibboleth. Cron-string sugar belongs in tooling, never in the\n// stored artifact.\n// ═══════════════════════════════════════════════════════════════\n\nexport const WEEKDAYS = ['mon', 'tue', 'wed', 'thu', 'fri', 'sat', 'sun'] as const;\n\nconst HHMM = /^([01]\\d|2[0-3]):[0-5]\\d$/;\nconst MMDD = /^(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$/;\n// Seconds are optional: a one-shot can name the second it fires on.\nconst LOCAL_DATETIME = /^\\d{4}-\\d{2}-\\d{2}T([01]\\d|2[0-3]):[0-5]\\d(:[0-5]\\d)?$/;\n\nexport const ClockUnitSchema = z.enum(['day', 'week', 'month', 'year']);\n\nexport const ClockRecurringSchema = z\n .object({\n every: ClockUnitSchema.describe('The calendar period it repeats on. A repeating clock fires on every such period until the reflex is removed — only for a request that says it repeats.'),\n on: z\n .union([z.number().int().min(1).max(31), z.enum(WEEKDAYS), z.string().regex(MMDD)])\n .optional()\n .describe('week → a weekday; month → 1..31 (clamped to month end); year → \"MM-DD\". Omitted for day.'),\n at: z.string().regex(HHMM).describe('Local wall-clock time, \"HH:MM\".'),\n tz: z.string().describe('IANA timezone name.'),\n })\n .strict()\n .superRefine((clock, ctx) => {\n const fail = (message: string) => ctx.addIssue({ code: 'custom', message, path: ['on'] });\n if (clock.every === 'day' && clock.on !== undefined) fail('a daily clock takes no `on`');\n if (clock.every === 'week' && !(typeof clock.on === 'string' && WEEKDAYS.some((d) => d === clock.on)))\n fail('a weekly clock needs `on` as a weekday (mon..sun)');\n if (clock.every === 'month' && typeof clock.on !== 'number') fail('a monthly clock needs `on` as a day number');\n if (clock.every === 'year' && !(typeof clock.on === 'string' && MMDD.test(clock.on)))\n fail('a yearly clock needs `on` as \"MM-DD\"');\n })\n .describe('Repeats: fires on every day, week, month or year, at a time of day, until the reflex is removed.');\n\nexport const ClockOnceSchema = z\n .object({\n at: z.string().regex(LOCAL_DATETIME).describe('A fixed local date and time, once: \"YYYY-MM-DDTHH:MM\" or, to the second, \"YYYY-MM-DDTHH:MM:SS\".'),\n tz: z.string().describe('IANA timezone name.'),\n })\n .strict()\n .describe('Once: fires at one date and time, then never again.');\n\nexport const ClockTriggerSchema = z\n .object({ clock: z.union([ClockRecurringSchema, ClockOnceSchema]) })\n .strict()\n .describe('Fires on the calendar: once, at a date and time, or repeating at a time of day.');\n\nexport const OpSchema = z.enum(['insert', 'update', 'delete']);\n\nexport const WriteTriggerSchema = z\n .object({\n fact: z\n .object({\n entity: z.string().describe('The table or entity whose writes wake this reflex.'),\n op: OpSchema.optional().describe('Narrow to one op — \"only on create\" is op: \"insert\".'),\n })\n .strict(),\n })\n .strict()\n .describe('Fires when a row of an entity is written — created, changed or deleted.');\n\nexport const SignalTriggerSchema = z\n .object({ fact: z.object({ signal: z.string().describe('A named external intake.') }).strict() })\n .strict()\n .describe('Fires when an event arrives from outside, on a named intake.');\n\nexport const RunTriggerSchema = z\n .object({\n fact: z\n .object({ run: z.string().describe('A reflex id — fires when THAT reflex\\'s run settles. Fan-in and dependency.') })\n .strict(),\n })\n .strict()\n .describe('Fires when another reflex has run: one automation after another.');\n\n// There is NO poll trigger, and the absence is a decision. Polls existed\n// for hosts with no write choke point — run a selection, diff a cursor,\n// mint write facts for the delta. In this stack the host's DAL IS the\n// choke point: every application write becomes a fact at the vex bridge,\n// so a poll could only ever re-discover what was already pushed, one\n// interval late. An external source with no choke point enters through an\n// importer that ingests write facts at the door — the same shape, without\n// a reflex secretly re-querying.\nexport const ManualTriggerSchema = z\n .object({ manual: z.object({}).strict() })\n .strict()\n .describe('Fires only when somebody fires it by hand.');\n\nexport const TriggerSchema = z.union([\n ClockTriggerSchema,\n WriteTriggerSchema,\n SignalTriggerSchema,\n RunTriggerSchema,\n ManualTriggerSchema,\n]);\n\nexport type ClockRecurring = z.infer<typeof ClockRecurringSchema>;\nexport type ClockOnce = z.infer<typeof ClockOnceSchema>;\nexport type Clock = ClockRecurring | ClockOnce;\nexport type Trigger = z.infer<typeof TriggerSchema>;\nexport type Op = z.infer<typeof OpSchema>;\nexport type Weekday = (typeof WEEKDAYS)[number];\n\n// ── narrowing helpers: the union is structural, so every consumer\n// would otherwise re-derive these three checks ───────────────────\n\nexport const clockOf = (trigger: Trigger): Clock | undefined => ('clock' in trigger ? trigger.clock : undefined);\n\nexport const isRecurring = (clock: Clock): clock is ClockRecurring => 'every' in clock;\n\nexport const factOf = (\n trigger: Trigger,\n): { entity?: string; op?: Op; signal?: string; run?: string } | undefined =>\n 'fact' in trigger ? trigger.fact : undefined;\n\nexport const isManual = (trigger: Trigger): boolean => 'manual' in trigger;\n","import { z } from 'zod';\n\n// ═══════════════════════════════════════════════════════════════\n// Policy — the execution semantics, as authored data.\n//\n// Everything the requirements doc said \"must not be hand-waved\",\n// declared per reflex rather than guessed by the engine.\n// ═══════════════════════════════════════════════════════════════\n\nexport const RetrySchema = z\n .object({\n max: z.number().int().min(0).default(3).describe('Attempts after the first before the task parks `failed`.'),\n backoff: z.enum(['fixed', 'exponential']).default('exponential'),\n baseMs: z.number().int().positive().default(60_000),\n })\n .strict();\n\n// THERE IS NO COALESCE, and its absence is the design.\n//\n// It cost two port methods, a table, an exactly-once promise and a\n// `DELETE … RETURNING` on every tick, and nothing ever set it — its only\n// driver was one test. A digest that genuinely needs batching is a DELAYED\n// RUN: the first fact of a group mints one at `now + window` with\n// `cause: 'coalesce:<key>:<start>'`, the rest collide on\n// UNIQUE(reflexId, cause) and are refused, and when it comes due the reflex\n// selects what changed. Mechanisms that already exist, and no new table.\nexport const PolicySchema = z\n .object({\n retry: RetrySchema.optional(),\n timeoutMs: z.number().int().positive().default(30_000),\n // May a firing start while the previous one is unsettled? The long\n // billing run still going at the next tick must not double-start.\n overlap: z.enum(['skip', 'allow']).default('skip'),\n catchUp: z.enum(['run', 'skip', 'latest']).default('run'),\n // How late is \"missed\"? Only `catchUp: 'skip'` reads it — 'run' opens\n // everything and 'latest' keeps the newest regardless of age. What\n // `catchUp` opens still passes `overlap`: occurrences missed together are\n // repeats of one another, so under 'skip' the oldest runs and the rest\n // are recorded as overlap skips.\n lateMs: z.number().int().positive().default(3_600_000),\n order: z.enum(['any', 'serial']).default('any'),\n })\n .strict();\n\nexport type Retry = z.infer<typeof RetrySchema>;\nexport type Policy = z.infer<typeof PolicySchema>;\n\n// Every field defaults, so the empty policy is a real, complete policy —\n// which is what lets a reflex omit `policy` entirely and still be governed.\nexport const DEFAULT_POLICY: Policy = PolicySchema.parse({});\n","import { z } from 'zod';\nimport { ClockTriggerSchema, ManualTriggerSchema, RunTriggerSchema, SignalTriggerSchema, TriggerSchema, WriteTriggerSchema } from './trigger.schema';\nimport { DEFAULT_POLICY, PolicySchema } from './policy.schema';\n\n// ═══════════════════════════════════════════════════════════════\n// Reflex — the artifact.\n//\n// A trigger, an optional selection, exactly one effect, a policy.\n// A straight arc from stimulus to response with no deliberation\n// between: there is no step language here, and a multi-step flow\n// is a CHAIN of reflexes joined by committed rows.\n//\n// `select.query` and every template are `unknown` ON PURPOSE. The\n// moment tide validates a query it owns a query language; the\n// moment it evaluates an expression it owns an evaluator. Both\n// exist in the stack already, behind seams. Tide stores, diffs and\n// hashes these blobs, and hands them over verbatim.\n// ═══════════════════════════════════════════════════════════════\n\nexport const SelectionSchema = z\n .object({\n query: z.unknown().describe('Handed to the `select` seam verbatim. Under moss: a vex { fingerprint, context } replay.'),\n mode: z\n .enum(['each', 'batch'])\n .default('each')\n .describe('each → one task per row; batch → one task carrying all rows (bounded sets only).'),\n unitKey: z.string().optional().describe('The row field keying a unit task. `each` mode only; duplicates fail the firing.'),\n })\n .strict();\n\nexport const EffectRefSchema = z\n .object({\n name: z.string().describe('A registered effect. The reflex names it; the registry supplies the handler.'),\n input: z.unknown().optional().describe('A template, evaluated per unit by the `transform` seam.'),\n })\n .strict();\n\nconst reflexFields = {\n id: z.string().min(1).describe(\"Unique. A tenant's reflex is the tenant's own row, with its own id.\"),\n intent: z.string().min(1).describe(\"One factual sentence — what this does, in the person's language.\"),\n on: TriggerSchema,\n as: z.string().optional().describe('The identity this runs under. Opaque to tide; the host resolves it.'),\n params: z.record(z.string(), z.unknown()).optional().describe('Authored knobs, visible to templates as $.params.'),\n select: SelectionSchema.optional().describe('Omitted = the trigger itself is the unit.'),\n when: z.unknown().optional().describe('A predicate template. FACT triggers only — a query belongs in `select`.'),\n effect: EffectRefSchema,\n policy: PolicySchema.default(DEFAULT_POLICY),\n enabled: z.boolean().default(true).describe('A switch on the row, not part of the definition — flipping it is not an edit.'),\n};\n\nconst reflexRules = (reflex: { on: object; when?: unknown; select?: { mode: string; unitKey?: string | undefined } | undefined }, ctx: z.RefinementCtx): void => {\n if (reflex.when !== undefined && !('fact' in reflex.on))\n ctx.addIssue({ code: 'custom', message: '`when` is for fact triggers; a clock condition belongs in `select`', path: ['when'] });\n if (reflex.select?.mode === 'each' && reflex.select.unitKey === undefined)\n ctx.addIssue({ code: 'custom', message: \"`each` mode needs a unitKey — it is the task's idempotency grain\", path: ['select', 'unitKey'] });\n};\n\nexport const ReflexSchema = z.object(reflexFields).strict().superRefine(reflexRules);\n\n// ═══════════════════════════════════════════════════════════════\n// Draft — a reflex as it is WRITTEN, before it is saved.\n//\n// What a model writes: a name, an intent, a trigger and an effect — and\n// nothing that is the host's (who it runs as, its policy, whether it is\n// enabled). Which triggers, and whether the extra fields a data-driven\n// automation needs, are the CALLER'S choice (`draftSchemaOf`): a draft may\n// only use what its host can run, the way it may only name the effects its\n// host offers. That schema is what the model is shown, and what it is held\n// to; what is stored is still the full ReflexSchema, completed when the\n// draft is saved (`anchorDraft`).\n//\n// One trigger exists only here: the TIMER — \"this long from now\". A timer\n// is sugar, never stored. `now` is only known when somebody saves the\n// draft, so the host anchors it then, and what is stored and run is an\n// ordinary one-shot clock — which survives a restart, because it names an\n// instant rather than a distance from one.\n// ═══════════════════════════════════════════════════════════════\n\nexport const TimerSchema = z\n .object({\n hours: z.number().int().min(0).optional(),\n minutes: z.number().int().min(0).optional(),\n seconds: z.number().int().min(0).optional(),\n })\n .strict()\n .refine((timer) => (timer.hours ?? 0) + (timer.minutes ?? 0) + (timer.seconds ?? 0) > 0, { message: 'a timer needs a length' });\n\nexport const TimerTriggerSchema = z\n .object({ timer: TimerSchema.describe('A length of time from now, as hours, minutes and seconds (each optional, together more than zero). Fires once, that long after the reflex is saved — not after it is written. A clock is for a time of day or a date.') })\n .strict();\n\n// The trigger kinds a draft can be offered, by name.\nexport const DRAFT_TRIGGERS = {\n clock: ClockTriggerSchema,\n timer: TimerTriggerSchema,\n write: WriteTriggerSchema,\n signal: SignalTriggerSchema,\n run: RunTriggerSchema,\n manual: ManualTriggerSchema,\n} as const;\nexport type DraftTrigger = keyof typeof DRAFT_TRIGGERS;\nconst ALL_DRAFT_TRIGGERS: readonly DraftTrigger[] = ['clock', 'timer', 'write', 'signal', 'run', 'manual'];\n\n// The fields beyond name, intent, trigger and effect a draft can be offered —\n// for automations that select rows or test a fact before they act.\nexport type DraftField = 'params' | 'select' | 'when';\n\n// What the caller offers a draft: its trigger kinds (every kind, if it names\n// none) and its extra fields (none, if it names none).\nexport type DraftChoice = { triggers?: readonly DraftTrigger[]; fields?: readonly DraftField[] };\n\nconst draftCore = {\n id: z.string().min(1).describe('A short name for this automation.'),\n intent: reflexFields.intent,\n effect: EffectRefSchema,\n};\n\n// The widest draft: every trigger, every extra field — the TYPE every\n// narrower draft is, and what `anchorDraft` completes.\nconst WidestDraftSchema = z\n .object({ ...draftCore, on: z.union([TriggerSchema, TimerTriggerSchema]), params: reflexFields.params, select: reflexFields.select, when: reflexFields.when })\n .strict();\nexport type ReflexDraft = z.infer<typeof WidestDraftSchema>;\n\n// The draft schema for what the caller offers — tide's own pieces, each with\n// the description it already has: the widest draft, cut to the chosen fields,\n// its trigger narrowed to the chosen kinds. Nothing is restated here.\nexport const draftSchemaOf = (choice: DraftChoice = {}): z.ZodType<ReflexDraft> => {\n const [first, ...rest] = (choice.triggers ?? ALL_DRAFT_TRIGGERS).map((kind): z.ZodType<ReflexDraft['on']> => DRAFT_TRIGGERS[kind]);\n if (first === undefined) throw new Error('tide: a draft needs at least one trigger kind');\n const on: z.ZodType<ReflexDraft['on']> = rest.length === 0 ? first : z.union([first, ...rest]);\n const has = (field: DraftField): boolean => choice.fields?.includes(field) ?? false;\n const keep: { [key in keyof ReflexDraft]?: true } = {\n id: true,\n intent: true,\n effect: true,\n on: true,\n ...(has('params') ? { params: true as const } : {}),\n ...(has('select') ? { select: true as const } : {}),\n ...(has('when') ? { when: true as const } : {}),\n };\n return WidestDraftSchema.pick(keep).extend({ on }).strict().superRefine(reflexRules);\n};\n\n// The default draft: every trigger kind, no extra fields.\nexport const ReflexDraftSchema = draftSchemaOf();\n\nexport type Selection = z.infer<typeof SelectionSchema>;\nexport type EffectRef = z.infer<typeof EffectRefSchema>;\nexport type Reflex = z.infer<typeof ReflexSchema>;\nexport type ReflexInput = z.input<typeof ReflexSchema>;\nexport type Timer = z.infer<typeof TimerSchema>;\n","// ═══════════════════════════════════════════════════════════\n// @niscorp/tide/agent — the reflex agent\n// ═══════════════════════════════════════════════════════════\n//\n// Given what somebody wants automated — \"every Monday at nine, send the\n// digest\" — and what the host offers (its effects; which triggers and fields\n// a draft may use), the reflex agent answers with ONE of three things: a\n// reflex DRAFT, a QUESTION back when the request can be read more than one\n// way, or a REFUSAL when no offered effect does it. It does not schedule\n// anything, and it does not wait: a question ends the run like any answer.\n//\n// The host shows the person what came back — with the agent's reasoning, so\n// they can see how they were read. When they answer it, or correct a draft\n// they have not saved (\"no, I meant…\"), the host runs the agent again over the\n// CONVERSATION — each request, the agent's answer as it gave it, the latest\n// words — as the turns of a chat (`reflexConversation`), which is what these\n// models read natively. A draft is a document to be read and saved; the host\n// anchors it when it is saved (`anchorDraft` — a timer becomes a clock then)\n// and loads it, and from then on it runs with no model at all. That is the\n// point: the model writes the automation once, instead of being asked, on\n// every tick, whether there is anything to do.\n//\n// The same pattern as @niscorp/prism/agent and @niscorp/vex/agent: the\n// package's own schema is the output, cortex validates it in the loop and\n// feeds failures back. Cortex is an optional peer — the rest of @niscorp/tide\n// does not need it.\n//\n// const agent = createReflexAgent({ effects: [\n// { name: 'digest.send', description: 'Send the weekly digest to the team.', input: z.object({}) },\n// ], triggers: ['clock', 'timer'] });\n// const result = await agent.run({ intent, now, tz }, { llm }).result;\n// if (result.ok && isDraft(result.output.data)) {\n// // …shown to the person; when they save it:\n// await tide.load([{ ...anchorDraft(result.output.data, { at: Date.now(), tz }), as: owner }], { at: Date.now() });\n// }\n//\n// A factory, not a constant, because what is offered is the host's: the\n// draft's shape is built from the triggers and fields the host names\n// (`draftSchemaOf`), and a draft naming an effect the host does not offer — or\n// an input that effect's own schema refuses — is sent back to the model to\n// correct, in the same run. What each part of an answer IS lives in the\n// schemas' .describe() calls, which ride the wire with them. The instructions\n// carry what steers the answer as a whole: what to put first in `reasoning`\n// (the whole request, as the conversation now has it); how people say times\n// (a time of day that could be morning or evening is asked about; nothing\n// repeats unless the person says so; no time that has passed); how a reply\n// joins the request before it; asking about everything undecided at once; and\n// never putting one effect in the place of another. No worked example: the\n// only correct one would use the host's own effects, which tide does not know.\n\nimport { z } from 'zod';\nimport type { ZodType } from 'zod';\nimport { defineAgent, type AgentDefinition, type Message } from '@niscorp/cortex';\nimport { draftSchemaOf, type DraftChoice, type ReflexDraft } from '../schemas';\n\n// An effect the host offers: its registered name, a description — one to\n// three sentences on what it does and what it is for, which is what the model\n// decides by — and the schema its input must satisfy.\nexport type OfferedEffect = { name: string; description: string; input: ZodType };\n\nexport const ReflexAgentInputSchema = z.object({\n intent: z.string().describe(\"The person's words — a request, or, later in the conversation, their reply to your question.\"),\n now: z\n .string()\n .describe('The current local date and time, \"YYYY-MM-DDTHH:MM\", in `tz` — what a date or a time of day in the request is read against.'),\n tz: z.string().describe('The IANA timezone the person is in. Every clock the reflex names uses it.'),\n});\n\nexport type ReflexAgentInput = z.infer<typeof ReflexAgentInputSchema>;\n\nexport const ReflexQuestionSchema = z\n .object({ question: z.string().min(1).describe(\"One short question in the person's language, naming what it chooses between.\") })\n .strict()\n .describe('Ask instead of writing a draft when the request can be read as different automations and nothing in its words or the conversation so far decides which.');\n\nexport const ReflexRefusalSchema = z\n .object({ refused: z.string().min(1).describe('Why none of the offered effects does it, in words for the person who asked.') })\n .strict()\n .describe('Refuse instead of writing a draft when none of the offered effects does what was asked. Only for that: a request that is unclear is a question, not a refusal.');\n\nexport type ReflexQuestion = z.infer<typeof ReflexQuestionSchema>;\nexport type ReflexRefusal = z.infer<typeof ReflexRefusalSchema>;\nexport type ReflexAnswer = ReflexDraft | ReflexQuestion | ReflexRefusal;\n\n// The agent's answer for what the caller offers: a draft of THAT shape\n// (`draftSchemaOf`), a question, or a refusal.\nexport const answerSchemaOf = (choice: DraftChoice = {}): z.ZodType<ReflexAnswer> =>\n z.union([\n draftSchemaOf(choice).describe('Write the draft when the request — with the conversation so far — says what should happen and what sets it off.'),\n ReflexQuestionSchema,\n ReflexRefusalSchema,\n ]);\n\n// The default answer: a draft with every trigger kind and no extra fields.\nexport const ReflexAnswerSchema = answerSchemaOf();\n\nexport const isDraft = (answer: ReflexAnswer): answer is ReflexDraft => 'effect' in answer;\n\n// THE CONVERSATION SO FAR, as the agent's input: each earlier request and the\n// agent's answer to it — a question, a draft the person has not saved, a\n// refusal — as it gave it, reasoning first; then the person's latest words.\n// The turns of a chat, not a field to be read, because a reply or a\n// correction (\"no, I meant…\") is only understood beside what it answers.\n// Pass what this returns to `run` in place of a single input.\nexport const reflexConversation = (conversation: {\n now: string;\n tz: string;\n earlier: readonly { request: string; answer: ReflexAnswer; reasoning?: string | undefined }[];\n latest: string;\n}): Message[] => [\n ...conversation.earlier.flatMap((turn): Message[] => [\n { role: 'user', content: JSON.stringify({ intent: turn.request, now: conversation.now, tz: conversation.tz }) },\n { role: 'assistant', content: JSON.stringify({ ...(turn.reasoning === undefined ? {} : { reasoning: turn.reasoning }), data: turn.answer }) },\n ]),\n { role: 'user', content: JSON.stringify({ intent: conversation.latest, now: conversation.now, tz: conversation.tz }) },\n];\n\nconst INSTRUCTIONS = `You are Tide's reflex agent. Somebody describes an automation; you answer with ONE of three things, as the OUTPUT SCHEMA describes: a reflex draft that does it (a trigger, exactly one of the offered effects, and its input), a question back, or a refusal.\n\nYour envelope's \\`data\\` is that answer. In \\`reasoning\\`, first restate the whole request as the conversation now has it; then decide. The answer must validate against the OUTPUT SCHEMA (its descriptions say what each part is); a draft must name one of the OFFERED EFFECTS and give it an input its schema accepts.\n\nTimes: a time of day that could fall in the morning or the evening, with nothing in the conversation saying which, is two different times — ask which. An automation happens once unless the person says it repeats. Never write a time that has already passed.\n\nA reply answers your last question: together with the request before it, it is one request — keep what the request said, and add what the reply decides.\n\nWhen you ask, ask about everything still undecided in one question, so one reply can settle it.\n\nEffects: when the request names something to be done that no offered effect does — a channel, a device, an action — refuse it; never put a different effect in its place.`;\n\n// The offered effects, as the agent reads them: name, description, and the\n// JSON Schema of its input — converted by the schema's OWN zod, whichever copy\n// made it (a caller's schema may come from another).\nconst describeEffects = (effects: readonly OfferedEffect[]): string =>\n `OFFERED EFFECTS — a draft names exactly one, by \\`name\\`; choose by its \\`description\\`:\\n${JSON.stringify(\n effects.map((effect) => ({ name: effect.name, description: effect.description, input: effect.input['~standard'].jsonSchema.output({ target: 'draft-07' }) })),\n )}`;\n\n// What is wrong with a draft's effect, as a correction the model can act on —\n// or nothing. The effect is the host's vocabulary, so it is checked against the\n// host's own schemas: an effect nobody offered, or an input its schema refuses.\nexport const effectProblem = (effects: readonly OfferedEffect[], reflex: Pick<ReflexDraft, 'effect'>): string | undefined => {\n const effect = effects.find((candidate) => candidate.name === reflex.effect.name);\n if (effect === undefined) return `The effect \"${reflex.effect.name}\" is not offered. Name one of: ${effects.map((candidate) => candidate.name).join(', ')}.`;\n const parsed = effect.input.safeParse(reflex.effect.input);\n if (parsed.success) return undefined;\n const issues = parsed.error.issues.map((issue) => `${issue.path.join('.') || 'input'}: ${issue.message}`).join('; ');\n return `The input for \"${effect.name}\" does not fit its schema — ${issues}.`;\n};\n\n// `triggers` / `fields`: what a draft may use here (`draftSchemaOf`) — every\n// trigger kind and no extra fields, unless the caller says otherwise. The draft\n// may only use what its host can run, as it may only name its host's effects.\nexport const createReflexAgent = (config: { effects: readonly OfferedEffect[] } & DraftChoice): AgentDefinition<ReflexAnswer> =>\n defineAgent<ReflexAnswer>({\n id: 'tide.reflex',\n description: 'Answers what somebody wants automated with one tide reflex draft, a question back, or a refusal.',\n instructions: INSTRUCTIONS,\n context: [() => describeEffects(config.effects)],\n output: {\n schema: answerSchemaOf(config),\n // Corrected in the run, tools and context still warm. Only a draft\n // names an effect; a question or a refusal has nothing to check here.\n validate: (envelope) => {\n if (!isDraft(envelope.data)) return { ok: true };\n const problem = effectProblem(config.effects, envelope.data);\n return problem === undefined ? { ok: true } : { retry: problem };\n },\n },\n });\n"]}
1
+ {"version":3,"sources":["../src/schemas/trigger.schema.ts","../src/schemas/policy.schema.ts","../src/schemas/reflex.schema.ts","../src/agent/reflex-agent.ts"],"names":["z","defineAgent"],"mappings":"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","file":"agent.cjs","sourcesContent":["import { z } from 'zod';\n\nexport const WEEKDAYS = ['mon', 'tue', 'wed', 'thu', 'fri', 'sat', 'sun'] as const;\n\nconst HHMM = /^([01]\\d|2[0-3]):[0-5]\\d$/;\nconst MMDD = /^(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$/;\nconst LOCAL_DATETIME = /^\\d{4}-\\d{2}-\\d{2}T([01]\\d|2[0-3]):[0-5]\\d(:[0-5]\\d)?$/;\n\nexport const ClockUnitSchema = z.enum(['day', 'week', 'month', 'year']);\n\nexport const ClockRecurringSchema = z\n .object({\n every: ClockUnitSchema.describe('The calendar period it repeats on. A repeating clock fires on every such period until the reflex is removed — only for a request that says it repeats.'),\n on: z\n .union([z.number().int().min(1).max(31), z.enum(WEEKDAYS), z.string().regex(MMDD)])\n .optional()\n .describe('week → a weekday; month → 1..31 (clamped to month end); year → \"MM-DD\". Omitted for day.'),\n at: z.string().regex(HHMM).describe('Local wall-clock time, \"HH:MM\".'),\n tz: z.string().describe('IANA timezone name.'),\n })\n .strict()\n .superRefine((clock, ctx) => {\n const fail = (message: string) => ctx.addIssue({ code: 'custom', message, path: ['on'] });\n if (clock.every === 'day' && clock.on !== undefined) fail('a daily clock takes no `on`');\n if (clock.every === 'week' && !(typeof clock.on === 'string' && WEEKDAYS.some((d) => d === clock.on)))\n fail('a weekly clock needs `on` as a weekday (mon..sun)');\n if (clock.every === 'month' && typeof clock.on !== 'number') fail('a monthly clock needs `on` as a day number');\n if (clock.every === 'year' && !(typeof clock.on === 'string' && MMDD.test(clock.on)))\n fail('a yearly clock needs `on` as \"MM-DD\"');\n })\n .describe('Repeats: fires on every day, week, month or year, at a time of day, until the reflex is removed.');\n\nexport const ClockOnceSchema = z\n .object({\n at: z.string().regex(LOCAL_DATETIME).describe('A fixed local date and time, once: \"YYYY-MM-DDTHH:MM\" or, to the second, \"YYYY-MM-DDTHH:MM:SS\".'),\n tz: z.string().describe('IANA timezone name.'),\n })\n .strict()\n .describe('Once: fires at one date and time, then never again.');\n\nexport const ClockTriggerSchema = z\n .object({ clock: z.union([ClockRecurringSchema, ClockOnceSchema]) })\n .strict()\n .describe('Fires on the calendar: once, at a date and time, or repeating at a time of day.');\n\nexport const OpSchema = z.enum(['insert', 'update', 'delete']);\n\nexport const WriteTriggerSchema = z\n .object({\n fact: z\n .object({\n entity: z.string().describe('The table or entity whose writes wake this reflex.'),\n op: OpSchema.optional().describe('Narrow to one op — \"only on create\" is op: \"insert\".'),\n })\n .strict(),\n })\n .strict()\n .describe('Fires when a row of an entity is written — created, changed or deleted.');\n\nexport const SignalTriggerSchema = z\n .object({ fact: z.object({ signal: z.string().describe('A named external intake.') }).strict() })\n .strict()\n .describe('Fires when an event arrives from outside, on a named intake.');\n\nexport const RunTriggerSchema = z\n .object({\n fact: z\n .object({ run: z.string().describe('A reflex id — fires when THAT reflex\\'s run settles. Fan-in and dependency.') })\n .strict(),\n })\n .strict()\n .describe('Fires when another reflex has run: one automation after another.');\n\nexport const ManualTriggerSchema = z\n .object({ manual: z.object({}).strict() })\n .strict()\n .describe('Fires only when somebody fires it by hand.');\n\nexport const TriggerSchema = z.union([\n ClockTriggerSchema,\n WriteTriggerSchema,\n SignalTriggerSchema,\n RunTriggerSchema,\n ManualTriggerSchema,\n]);\n\nexport type ClockRecurring = z.infer<typeof ClockRecurringSchema>;\nexport type ClockOnce = z.infer<typeof ClockOnceSchema>;\nexport type Clock = ClockRecurring | ClockOnce;\nexport type Trigger = z.infer<typeof TriggerSchema>;\nexport type Op = z.infer<typeof OpSchema>;\nexport type Weekday = (typeof WEEKDAYS)[number];\n\nexport const clockOf = (trigger: Trigger): Clock | undefined => ('clock' in trigger ? trigger.clock : undefined);\n\nexport const isRecurring = (clock: Clock): clock is ClockRecurring => 'every' in clock;\n\nexport const factOf = (\n trigger: Trigger,\n): { entity?: string; op?: Op; signal?: string; run?: string } | undefined =>\n 'fact' in trigger ? trigger.fact : undefined;\n\nexport const isManual = (trigger: Trigger): boolean => 'manual' in trigger;\n","import { z } from 'zod';\n\nexport const RetrySchema = z\n .object({\n max: z.number().int().min(0).default(3).describe('Attempts after the first before the task parks `failed`.'),\n backoff: z.enum(['fixed', 'exponential']).default('exponential'),\n baseMs: z.number().int().positive().default(60_000),\n })\n .strict();\n\nexport const PolicySchema = z\n .object({\n retry: RetrySchema.optional(),\n timeoutMs: z.number().int().positive().default(30_000),\n overlap: z.enum(['skip', 'allow']).default('skip'),\n catchUp: z.enum(['run', 'skip', 'latest']).default('run'),\n // Read by `catchUp: 'skip'` only. What `catchUp` opens still passes\n // `overlap`: occurrences missed together are repeats of one another, so\n // under `overlap: 'skip'` the oldest runs and the rest are skipped.\n lateMs: z.number().int().positive().default(3_600_000),\n order: z.enum(['any', 'serial']).default('any'),\n })\n .strict();\n\nexport type Retry = z.infer<typeof RetrySchema>;\nexport type Policy = z.infer<typeof PolicySchema>;\n\nexport const DEFAULT_POLICY: Policy = PolicySchema.parse({});\n","import { z } from 'zod';\nimport { ClockTriggerSchema, ManualTriggerSchema, RunTriggerSchema, SignalTriggerSchema, TriggerSchema, WriteTriggerSchema } from './trigger.schema';\nimport { DEFAULT_POLICY, PolicySchema } from './policy.schema';\n\nexport const SelectionSchema = z\n .object({\n query: z.unknown().describe('Handed to the `select` seam verbatim. Under moss: a vex { fingerprint, context } replay.'),\n mode: z\n .enum(['each', 'batch'])\n .default('each')\n .describe('each → one task per row; batch → one task carrying all rows (bounded sets only).'),\n unitKey: z.string().optional().describe('The row field keying a unit task. `each` mode only; duplicates fail the firing.'),\n })\n .strict();\n\nexport const EffectRefSchema = z\n .object({\n name: z.string().describe('A registered effect. The reflex names it; the registry supplies the handler.'),\n input: z.unknown().optional().describe('A template, evaluated per unit by the `transform` seam.'),\n })\n .strict();\n\nconst reflexFields = {\n id: z.string().min(1).describe(\"Unique. A tenant's reflex is the tenant's own row, with its own id.\"),\n intent: z.string().min(1).describe(\"One factual sentence — what this does, in the person's language.\"),\n on: TriggerSchema,\n as: z.string().optional().describe('The identity this runs under. Opaque to tide; the host resolves it.'),\n params: z.record(z.string(), z.unknown()).optional().describe('Authored knobs, visible to templates as $.params.'),\n select: SelectionSchema.optional().describe('Omitted = the trigger itself is the unit.'),\n when: z.unknown().optional().describe('A predicate template. FACT triggers only — a query belongs in `select`.'),\n effect: EffectRefSchema,\n policy: PolicySchema.default(DEFAULT_POLICY),\n enabled: z.boolean().default(true).describe('A switch on the row, not part of the definition — flipping it is not an edit.'),\n};\n\nconst reflexRules = (reflex: { on: object; when?: unknown; select?: { mode: string; unitKey?: string | undefined } | undefined }, ctx: z.RefinementCtx): void => {\n if (reflex.when !== undefined && !('fact' in reflex.on))\n ctx.addIssue({ code: 'custom', message: '`when` is for fact triggers; a clock condition belongs in `select`', path: ['when'] });\n if (reflex.select?.mode === 'each' && reflex.select.unitKey === undefined)\n ctx.addIssue({ code: 'custom', message: \"`each` mode needs a unitKey — it is the task's idempotency grain\", path: ['select', 'unitKey'] });\n};\n\nexport const ReflexSchema = z.object(reflexFields).strict().superRefine(reflexRules);\n\nexport const TimerSchema = z\n .object({\n hours: z.number().int().min(0).optional(),\n minutes: z.number().int().min(0).optional(),\n seconds: z.number().int().min(0).optional(),\n })\n .strict()\n .refine((timer) => (timer.hours ?? 0) + (timer.minutes ?? 0) + (timer.seconds ?? 0) > 0, { message: 'a timer needs a length' });\n\nexport const TimerTriggerSchema = z\n .object({ timer: TimerSchema.describe('A length of time from now, as hours, minutes and seconds (each optional, together more than zero). Fires once, that long after the reflex is saved — not after it is written. A clock is for a time of day or a date.') })\n .strict();\n\nexport const DRAFT_TRIGGERS = {\n clock: ClockTriggerSchema,\n timer: TimerTriggerSchema,\n write: WriteTriggerSchema,\n signal: SignalTriggerSchema,\n run: RunTriggerSchema,\n manual: ManualTriggerSchema,\n} as const;\nexport type DraftTrigger = keyof typeof DRAFT_TRIGGERS;\nconst ALL_DRAFT_TRIGGERS: readonly DraftTrigger[] = ['clock', 'timer', 'write', 'signal', 'run', 'manual'];\n\nexport type DraftField = 'params' | 'select' | 'when';\n\nexport type DraftChoice = { triggers?: readonly DraftTrigger[]; fields?: readonly DraftField[] };\n\nconst draftCore = {\n id: z.string().min(1).describe('A short name for this automation.'),\n intent: reflexFields.intent,\n effect: EffectRefSchema,\n};\n\nconst WidestDraftSchema = z\n .object({ ...draftCore, on: z.union([TriggerSchema, TimerTriggerSchema]), params: reflexFields.params, select: reflexFields.select, when: reflexFields.when })\n .strict();\nexport type ReflexDraft = z.infer<typeof WidestDraftSchema>;\n\nexport const draftSchemaOf = (choice: DraftChoice = {}): z.ZodType<ReflexDraft> => {\n const [first, ...rest] = (choice.triggers ?? ALL_DRAFT_TRIGGERS).map((kind): z.ZodType<ReflexDraft['on']> => DRAFT_TRIGGERS[kind]);\n if (first === undefined) throw new Error('tide: a draft needs at least one trigger kind');\n const on: z.ZodType<ReflexDraft['on']> = rest.length === 0 ? first : z.union([first, ...rest]);\n const has = (field: DraftField): boolean => choice.fields?.includes(field) ?? false;\n const keep: { [key in keyof ReflexDraft]?: true } = {\n id: true,\n intent: true,\n effect: true,\n on: true,\n ...(has('params') ? { params: true as const } : {}),\n ...(has('select') ? { select: true as const } : {}),\n ...(has('when') ? { when: true as const } : {}),\n };\n return WidestDraftSchema.pick(keep).extend({ on }).strict().superRefine(reflexRules);\n};\n\nexport const ReflexDraftSchema = draftSchemaOf();\n\nexport type Selection = z.infer<typeof SelectionSchema>;\nexport type EffectRef = z.infer<typeof EffectRefSchema>;\nexport type Reflex = z.infer<typeof ReflexSchema>;\nexport type ReflexInput = z.input<typeof ReflexSchema>;\nexport type Timer = z.infer<typeof TimerSchema>;\n","import { z } from 'zod';\nimport type { ZodType } from 'zod';\nimport { defineAgent, type AgentDefinition, type Message } from '@niscorp/cortex';\nimport { draftSchemaOf, type DraftChoice, type ReflexDraft } from '../schemas';\n\nexport type OfferedEffect = { name: string; description: string; input: ZodType };\n\nexport const ReflexAgentInputSchema = z.object({\n intent: z.string().describe(\"The person's words — a request, or, later in the conversation, their reply to your question.\"),\n now: z\n .string()\n .describe('The current local date and time, \"YYYY-MM-DDTHH:MM\", in `tz` — what a date or a time of day in the request is read against.'),\n tz: z.string().describe('The IANA timezone the person is in. Every clock the reflex names uses it.'),\n});\n\nexport type ReflexAgentInput = z.infer<typeof ReflexAgentInputSchema>;\n\nexport const ReflexQuestionSchema = z\n .object({ question: z.string().min(1).describe(\"One short question in the person's language, naming what it chooses between.\") })\n .strict()\n .describe('Ask instead of writing a draft when the request can be read as different automations and nothing in its words or the conversation so far decides which.');\n\nexport const ReflexRefusalSchema = z\n .object({ refused: z.string().min(1).describe('Why none of the offered effects does it, in words for the person who asked.') })\n .strict()\n .describe('Refuse instead of writing a draft when none of the offered effects does what was asked. Only for that: a request that is unclear is a question, not a refusal.');\n\nexport type ReflexQuestion = z.infer<typeof ReflexQuestionSchema>;\nexport type ReflexRefusal = z.infer<typeof ReflexRefusalSchema>;\nexport type ReflexAnswer = ReflexDraft | ReflexQuestion | ReflexRefusal;\n\nexport const answerSchemaOf = (choice: DraftChoice = {}): z.ZodType<ReflexAnswer> =>\n z.union([\n draftSchemaOf(choice).describe('Write the draft when the request — with the conversation so far — says what should happen and what sets it off.'),\n ReflexQuestionSchema,\n ReflexRefusalSchema,\n ]);\n\nexport const ReflexAnswerSchema = answerSchemaOf();\n\nexport const isDraft = (answer: ReflexAnswer): answer is ReflexDraft => 'effect' in answer;\n\nexport const reflexConversation = (conversation: {\n now: string;\n tz: string;\n earlier: readonly { request: string; answer: ReflexAnswer; reasoning?: string | undefined }[];\n latest: string;\n}): Message[] => [\n ...conversation.earlier.flatMap((turn): Message[] => [\n { role: 'user', content: JSON.stringify({ intent: turn.request, now: conversation.now, tz: conversation.tz }) },\n { role: 'assistant', content: JSON.stringify({ ...(turn.reasoning === undefined ? {} : { reasoning: turn.reasoning }), data: turn.answer }) },\n ]),\n { role: 'user', content: JSON.stringify({ intent: conversation.latest, now: conversation.now, tz: conversation.tz }) },\n];\n\nconst INSTRUCTIONS = `You are Tide's reflex agent. Somebody describes an automation; you answer with ONE of three things, as the OUTPUT SCHEMA describes: a reflex draft that does it (a trigger, exactly one of the offered effects, and its input), a question back, or a refusal.\n\nYour envelope's \\`data\\` is that answer. In \\`reasoning\\`, first restate the whole request as the conversation now has it; then decide. The answer must validate against the OUTPUT SCHEMA (its descriptions say what each part is); a draft must name one of the OFFERED EFFECTS and give it an input its schema accepts.\n\nTimes: a time of day that could fall in the morning or the evening, with nothing in the conversation saying which, is two different times — ask which. An automation happens once unless the person says it repeats. Never write a time that has already passed.\n\nA reply answers your last question: together with the request before it, it is one request — keep what the request said, and add what the reply decides.\n\nWhen you ask, ask about everything still undecided in one question, so one reply can settle it.\n\nEffects: when the request names something to be done that no offered effect does — a channel, a device, an action — refuse it; never put a different effect in its place.`;\n\n// Converted by the schema's own zod: a caller's schema may come from another copy.\nconst describeEffects = (effects: readonly OfferedEffect[]): string =>\n `OFFERED EFFECTS — a draft names exactly one, by \\`name\\`; choose by its \\`description\\`:\\n${JSON.stringify(\n effects.map((effect) => ({ name: effect.name, description: effect.description, input: effect.input['~standard'].jsonSchema.output({ target: 'draft-07' }) })),\n )}`;\n\nexport const effectProblem = (effects: readonly OfferedEffect[], reflex: Pick<ReflexDraft, 'effect'>): string | undefined => {\n const effect = effects.find((candidate) => candidate.name === reflex.effect.name);\n if (effect === undefined) return `The effect \"${reflex.effect.name}\" is not offered. Name one of: ${effects.map((candidate) => candidate.name).join(', ')}.`;\n const parsed = effect.input.safeParse(reflex.effect.input);\n if (parsed.success) return undefined;\n const issues = parsed.error.issues.map((issue) => `${issue.path.join('.') || 'input'}: ${issue.message}`).join('; ');\n return `The input for \"${effect.name}\" does not fit its schema — ${issues}.`;\n};\n\nexport const createReflexAgent = (config: { effects: readonly OfferedEffect[] } & DraftChoice): AgentDefinition<ReflexAnswer> =>\n defineAgent<ReflexAnswer>({\n id: 'tide.reflex',\n description: 'Answers what somebody wants automated with one tide reflex draft, a question back, or a refusal.',\n instructions: INSTRUCTIONS,\n context: [() => describeEffects(config.effects)],\n output: {\n schema: answerSchemaOf(config),\n validate: (envelope) => {\n if (!isDraft(envelope.data)) return { ok: true };\n const problem = effectProblem(config.effects, envelope.data);\n return problem === undefined ? { ok: true } : { retry: problem };\n },\n },\n });\n"]}
package/dist/agent.js CHANGED
@@ -1,4 +1,4 @@
1
- import { draftSchemaOf } from './chunk-UEG3UZDG.js';
1
+ import { draftSchemaOf } from './chunk-4TXWZFRE.js';
2
2
  import { z } from 'zod';
3
3
  import { defineAgent } from '@niscorp/cortex';
4
4
 
@@ -53,8 +53,6 @@ var createReflexAgent = (config) => defineAgent({
53
53
  context: [() => describeEffects(config.effects)],
54
54
  output: {
55
55
  schema: answerSchemaOf(config),
56
- // Corrected in the run, tools and context still warm. Only a draft
57
- // names an effect; a question or a refusal has nothing to check here.
58
56
  validate: (envelope) => {
59
57
  if (!isDraft(envelope.data)) return { ok: true };
60
58
  const problem = effectProblem(config.effects, envelope.data);
package/dist/agent.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/agent/reflex-agent.ts"],"names":[],"mappings":"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","file":"agent.js","sourcesContent":["// ═══════════════════════════════════════════════════════════\n// @niscorp/tide/agent — the reflex agent\n// ═══════════════════════════════════════════════════════════\n//\n// Given what somebody wants automated — \"every Monday at nine, send the\n// digest\" — and what the host offers (its effects; which triggers and fields\n// a draft may use), the reflex agent answers with ONE of three things: a\n// reflex DRAFT, a QUESTION back when the request can be read more than one\n// way, or a REFUSAL when no offered effect does it. It does not schedule\n// anything, and it does not wait: a question ends the run like any answer.\n//\n// The host shows the person what came back — with the agent's reasoning, so\n// they can see how they were read. When they answer it, or correct a draft\n// they have not saved (\"no, I meant…\"), the host runs the agent again over the\n// CONVERSATION — each request, the agent's answer as it gave it, the latest\n// words — as the turns of a chat (`reflexConversation`), which is what these\n// models read natively. A draft is a document to be read and saved; the host\n// anchors it when it is saved (`anchorDraft` — a timer becomes a clock then)\n// and loads it, and from then on it runs with no model at all. That is the\n// point: the model writes the automation once, instead of being asked, on\n// every tick, whether there is anything to do.\n//\n// The same pattern as @niscorp/prism/agent and @niscorp/vex/agent: the\n// package's own schema is the output, cortex validates it in the loop and\n// feeds failures back. Cortex is an optional peer — the rest of @niscorp/tide\n// does not need it.\n//\n// const agent = createReflexAgent({ effects: [\n// { name: 'digest.send', description: 'Send the weekly digest to the team.', input: z.object({}) },\n// ], triggers: ['clock', 'timer'] });\n// const result = await agent.run({ intent, now, tz }, { llm }).result;\n// if (result.ok && isDraft(result.output.data)) {\n// // …shown to the person; when they save it:\n// await tide.load([{ ...anchorDraft(result.output.data, { at: Date.now(), tz }), as: owner }], { at: Date.now() });\n// }\n//\n// A factory, not a constant, because what is offered is the host's: the\n// draft's shape is built from the triggers and fields the host names\n// (`draftSchemaOf`), and a draft naming an effect the host does not offer — or\n// an input that effect's own schema refuses — is sent back to the model to\n// correct, in the same run. What each part of an answer IS lives in the\n// schemas' .describe() calls, which ride the wire with them. The instructions\n// carry what steers the answer as a whole: what to put first in `reasoning`\n// (the whole request, as the conversation now has it); how people say times\n// (a time of day that could be morning or evening is asked about; nothing\n// repeats unless the person says so; no time that has passed); how a reply\n// joins the request before it; asking about everything undecided at once; and\n// never putting one effect in the place of another. No worked example: the\n// only correct one would use the host's own effects, which tide does not know.\n\nimport { z } from 'zod';\nimport type { ZodType } from 'zod';\nimport { defineAgent, type AgentDefinition, type Message } from '@niscorp/cortex';\nimport { draftSchemaOf, type DraftChoice, type ReflexDraft } from '../schemas';\n\n// An effect the host offers: its registered name, a description — one to\n// three sentences on what it does and what it is for, which is what the model\n// decides by — and the schema its input must satisfy.\nexport type OfferedEffect = { name: string; description: string; input: ZodType };\n\nexport const ReflexAgentInputSchema = z.object({\n intent: z.string().describe(\"The person's words — a request, or, later in the conversation, their reply to your question.\"),\n now: z\n .string()\n .describe('The current local date and time, \"YYYY-MM-DDTHH:MM\", in `tz` — what a date or a time of day in the request is read against.'),\n tz: z.string().describe('The IANA timezone the person is in. Every clock the reflex names uses it.'),\n});\n\nexport type ReflexAgentInput = z.infer<typeof ReflexAgentInputSchema>;\n\nexport const ReflexQuestionSchema = z\n .object({ question: z.string().min(1).describe(\"One short question in the person's language, naming what it chooses between.\") })\n .strict()\n .describe('Ask instead of writing a draft when the request can be read as different automations and nothing in its words or the conversation so far decides which.');\n\nexport const ReflexRefusalSchema = z\n .object({ refused: z.string().min(1).describe('Why none of the offered effects does it, in words for the person who asked.') })\n .strict()\n .describe('Refuse instead of writing a draft when none of the offered effects does what was asked. Only for that: a request that is unclear is a question, not a refusal.');\n\nexport type ReflexQuestion = z.infer<typeof ReflexQuestionSchema>;\nexport type ReflexRefusal = z.infer<typeof ReflexRefusalSchema>;\nexport type ReflexAnswer = ReflexDraft | ReflexQuestion | ReflexRefusal;\n\n// The agent's answer for what the caller offers: a draft of THAT shape\n// (`draftSchemaOf`), a question, or a refusal.\nexport const answerSchemaOf = (choice: DraftChoice = {}): z.ZodType<ReflexAnswer> =>\n z.union([\n draftSchemaOf(choice).describe('Write the draft when the request — with the conversation so far — says what should happen and what sets it off.'),\n ReflexQuestionSchema,\n ReflexRefusalSchema,\n ]);\n\n// The default answer: a draft with every trigger kind and no extra fields.\nexport const ReflexAnswerSchema = answerSchemaOf();\n\nexport const isDraft = (answer: ReflexAnswer): answer is ReflexDraft => 'effect' in answer;\n\n// THE CONVERSATION SO FAR, as the agent's input: each earlier request and the\n// agent's answer to it — a question, a draft the person has not saved, a\n// refusal — as it gave it, reasoning first; then the person's latest words.\n// The turns of a chat, not a field to be read, because a reply or a\n// correction (\"no, I meant…\") is only understood beside what it answers.\n// Pass what this returns to `run` in place of a single input.\nexport const reflexConversation = (conversation: {\n now: string;\n tz: string;\n earlier: readonly { request: string; answer: ReflexAnswer; reasoning?: string | undefined }[];\n latest: string;\n}): Message[] => [\n ...conversation.earlier.flatMap((turn): Message[] => [\n { role: 'user', content: JSON.stringify({ intent: turn.request, now: conversation.now, tz: conversation.tz }) },\n { role: 'assistant', content: JSON.stringify({ ...(turn.reasoning === undefined ? {} : { reasoning: turn.reasoning }), data: turn.answer }) },\n ]),\n { role: 'user', content: JSON.stringify({ intent: conversation.latest, now: conversation.now, tz: conversation.tz }) },\n];\n\nconst INSTRUCTIONS = `You are Tide's reflex agent. Somebody describes an automation; you answer with ONE of three things, as the OUTPUT SCHEMA describes: a reflex draft that does it (a trigger, exactly one of the offered effects, and its input), a question back, or a refusal.\n\nYour envelope's \\`data\\` is that answer. In \\`reasoning\\`, first restate the whole request as the conversation now has it; then decide. The answer must validate against the OUTPUT SCHEMA (its descriptions say what each part is); a draft must name one of the OFFERED EFFECTS and give it an input its schema accepts.\n\nTimes: a time of day that could fall in the morning or the evening, with nothing in the conversation saying which, is two different times — ask which. An automation happens once unless the person says it repeats. Never write a time that has already passed.\n\nA reply answers your last question: together with the request before it, it is one request — keep what the request said, and add what the reply decides.\n\nWhen you ask, ask about everything still undecided in one question, so one reply can settle it.\n\nEffects: when the request names something to be done that no offered effect does — a channel, a device, an action — refuse it; never put a different effect in its place.`;\n\n// The offered effects, as the agent reads them: name, description, and the\n// JSON Schema of its input — converted by the schema's OWN zod, whichever copy\n// made it (a caller's schema may come from another).\nconst describeEffects = (effects: readonly OfferedEffect[]): string =>\n `OFFERED EFFECTS — a draft names exactly one, by \\`name\\`; choose by its \\`description\\`:\\n${JSON.stringify(\n effects.map((effect) => ({ name: effect.name, description: effect.description, input: effect.input['~standard'].jsonSchema.output({ target: 'draft-07' }) })),\n )}`;\n\n// What is wrong with a draft's effect, as a correction the model can act on —\n// or nothing. The effect is the host's vocabulary, so it is checked against the\n// host's own schemas: an effect nobody offered, or an input its schema refuses.\nexport const effectProblem = (effects: readonly OfferedEffect[], reflex: Pick<ReflexDraft, 'effect'>): string | undefined => {\n const effect = effects.find((candidate) => candidate.name === reflex.effect.name);\n if (effect === undefined) return `The effect \"${reflex.effect.name}\" is not offered. Name one of: ${effects.map((candidate) => candidate.name).join(', ')}.`;\n const parsed = effect.input.safeParse(reflex.effect.input);\n if (parsed.success) return undefined;\n const issues = parsed.error.issues.map((issue) => `${issue.path.join('.') || 'input'}: ${issue.message}`).join('; ');\n return `The input for \"${effect.name}\" does not fit its schema — ${issues}.`;\n};\n\n// `triggers` / `fields`: what a draft may use here (`draftSchemaOf`) — every\n// trigger kind and no extra fields, unless the caller says otherwise. The draft\n// may only use what its host can run, as it may only name its host's effects.\nexport const createReflexAgent = (config: { effects: readonly OfferedEffect[] } & DraftChoice): AgentDefinition<ReflexAnswer> =>\n defineAgent<ReflexAnswer>({\n id: 'tide.reflex',\n description: 'Answers what somebody wants automated with one tide reflex draft, a question back, or a refusal.',\n instructions: INSTRUCTIONS,\n context: [() => describeEffects(config.effects)],\n output: {\n schema: answerSchemaOf(config),\n // Corrected in the run, tools and context still warm. Only a draft\n // names an effect; a question or a refusal has nothing to check here.\n validate: (envelope) => {\n if (!isDraft(envelope.data)) return { ok: true };\n const problem = effectProblem(config.effects, envelope.data);\n return problem === undefined ? { ok: true } : { retry: problem };\n },\n },\n });\n"]}
1
+ {"version":3,"sources":["../src/agent/reflex-agent.ts"],"names":[],"mappings":"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","file":"agent.js","sourcesContent":["import { z } from 'zod';\nimport type { ZodType } from 'zod';\nimport { defineAgent, type AgentDefinition, type Message } from '@niscorp/cortex';\nimport { draftSchemaOf, type DraftChoice, type ReflexDraft } from '../schemas';\n\nexport type OfferedEffect = { name: string; description: string; input: ZodType };\n\nexport const ReflexAgentInputSchema = z.object({\n intent: z.string().describe(\"The person's words — a request, or, later in the conversation, their reply to your question.\"),\n now: z\n .string()\n .describe('The current local date and time, \"YYYY-MM-DDTHH:MM\", in `tz` — what a date or a time of day in the request is read against.'),\n tz: z.string().describe('The IANA timezone the person is in. Every clock the reflex names uses it.'),\n});\n\nexport type ReflexAgentInput = z.infer<typeof ReflexAgentInputSchema>;\n\nexport const ReflexQuestionSchema = z\n .object({ question: z.string().min(1).describe(\"One short question in the person's language, naming what it chooses between.\") })\n .strict()\n .describe('Ask instead of writing a draft when the request can be read as different automations and nothing in its words or the conversation so far decides which.');\n\nexport const ReflexRefusalSchema = z\n .object({ refused: z.string().min(1).describe('Why none of the offered effects does it, in words for the person who asked.') })\n .strict()\n .describe('Refuse instead of writing a draft when none of the offered effects does what was asked. Only for that: a request that is unclear is a question, not a refusal.');\n\nexport type ReflexQuestion = z.infer<typeof ReflexQuestionSchema>;\nexport type ReflexRefusal = z.infer<typeof ReflexRefusalSchema>;\nexport type ReflexAnswer = ReflexDraft | ReflexQuestion | ReflexRefusal;\n\nexport const answerSchemaOf = (choice: DraftChoice = {}): z.ZodType<ReflexAnswer> =>\n z.union([\n draftSchemaOf(choice).describe('Write the draft when the request — with the conversation so far — says what should happen and what sets it off.'),\n ReflexQuestionSchema,\n ReflexRefusalSchema,\n ]);\n\nexport const ReflexAnswerSchema = answerSchemaOf();\n\nexport const isDraft = (answer: ReflexAnswer): answer is ReflexDraft => 'effect' in answer;\n\nexport const reflexConversation = (conversation: {\n now: string;\n tz: string;\n earlier: readonly { request: string; answer: ReflexAnswer; reasoning?: string | undefined }[];\n latest: string;\n}): Message[] => [\n ...conversation.earlier.flatMap((turn): Message[] => [\n { role: 'user', content: JSON.stringify({ intent: turn.request, now: conversation.now, tz: conversation.tz }) },\n { role: 'assistant', content: JSON.stringify({ ...(turn.reasoning === undefined ? {} : { reasoning: turn.reasoning }), data: turn.answer }) },\n ]),\n { role: 'user', content: JSON.stringify({ intent: conversation.latest, now: conversation.now, tz: conversation.tz }) },\n];\n\nconst INSTRUCTIONS = `You are Tide's reflex agent. Somebody describes an automation; you answer with ONE of three things, as the OUTPUT SCHEMA describes: a reflex draft that does it (a trigger, exactly one of the offered effects, and its input), a question back, or a refusal.\n\nYour envelope's \\`data\\` is that answer. In \\`reasoning\\`, first restate the whole request as the conversation now has it; then decide. The answer must validate against the OUTPUT SCHEMA (its descriptions say what each part is); a draft must name one of the OFFERED EFFECTS and give it an input its schema accepts.\n\nTimes: a time of day that could fall in the morning or the evening, with nothing in the conversation saying which, is two different times — ask which. An automation happens once unless the person says it repeats. Never write a time that has already passed.\n\nA reply answers your last question: together with the request before it, it is one request — keep what the request said, and add what the reply decides.\n\nWhen you ask, ask about everything still undecided in one question, so one reply can settle it.\n\nEffects: when the request names something to be done that no offered effect does — a channel, a device, an action — refuse it; never put a different effect in its place.`;\n\n// Converted by the schema's own zod: a caller's schema may come from another copy.\nconst describeEffects = (effects: readonly OfferedEffect[]): string =>\n `OFFERED EFFECTS — a draft names exactly one, by \\`name\\`; choose by its \\`description\\`:\\n${JSON.stringify(\n effects.map((effect) => ({ name: effect.name, description: effect.description, input: effect.input['~standard'].jsonSchema.output({ target: 'draft-07' }) })),\n )}`;\n\nexport const effectProblem = (effects: readonly OfferedEffect[], reflex: Pick<ReflexDraft, 'effect'>): string | undefined => {\n const effect = effects.find((candidate) => candidate.name === reflex.effect.name);\n if (effect === undefined) return `The effect \"${reflex.effect.name}\" is not offered. Name one of: ${effects.map((candidate) => candidate.name).join(', ')}.`;\n const parsed = effect.input.safeParse(reflex.effect.input);\n if (parsed.success) return undefined;\n const issues = parsed.error.issues.map((issue) => `${issue.path.join('.') || 'input'}: ${issue.message}`).join('; ');\n return `The input for \"${effect.name}\" does not fit its schema — ${issues}.`;\n};\n\nexport const createReflexAgent = (config: { effects: readonly OfferedEffect[] } & DraftChoice): AgentDefinition<ReflexAnswer> =>\n defineAgent<ReflexAnswer>({\n id: 'tide.reflex',\n description: 'Answers what somebody wants automated with one tide reflex draft, a question back, or a refusal.',\n instructions: INSTRUCTIONS,\n context: [() => describeEffects(config.effects)],\n output: {\n schema: answerSchemaOf(config),\n validate: (envelope) => {\n if (!isDraft(envelope.data)) return { ok: true };\n const problem = effectProblem(config.effects, envelope.data);\n return problem === undefined ? { ok: true } : { retry: problem };\n },\n },\n });\n"]}
@@ -56,15 +56,11 @@ var RetrySchema = z.object({
56
56
  var PolicySchema = z.object({
57
57
  retry: RetrySchema.optional(),
58
58
  timeoutMs: z.number().int().positive().default(3e4),
59
- // May a firing start while the previous one is unsettled? The long
60
- // billing run still going at the next tick must not double-start.
61
59
  overlap: z.enum(["skip", "allow"]).default("skip"),
62
60
  catchUp: z.enum(["run", "skip", "latest"]).default("run"),
63
- // How late is "missed"? Only `catchUp: 'skip'` reads it — 'run' opens
64
- // everything and 'latest' keeps the newest regardless of age. What
65
- // `catchUp` opens still passes `overlap`: occurrences missed together are
66
- // repeats of one another, so under 'skip' the oldest runs and the rest
67
- // are recorded as overlap skips.
61
+ // Read by `catchUp: 'skip'` only. What `catchUp` opens still passes
62
+ // `overlap`: occurrences missed together are repeats of one another, so
63
+ // under `overlap: 'skip'` the oldest runs and the rest are skipped.
68
64
  lateMs: z.number().int().positive().default(36e5),
69
65
  order: z.enum(["any", "serial"]).default("any")
70
66
  }).strict();
@@ -72,19 +68,15 @@ var DEFAULT_POLICY = PolicySchema.parse({});
72
68
  var FactKindSchema = z.enum(["write", "signal", "manual", "run"]);
73
69
  var FactInputSchema = z.object({
74
70
  kind: FactKindSchema,
75
- // write facts
76
71
  entity: z.string().optional().describe("Which table or entity was written."),
77
72
  op: OpSchema.optional().describe('Ops are distinct stimuli \u2014 "only on create" is op: "insert".'),
78
73
  row: z.record(z.string(), z.unknown()).optional().describe("The row, as the write returned it."),
79
- // signal facts
80
74
  name: z.string().optional().describe("Which named intake this arrived on."),
81
75
  payload: z.unknown().optional().describe("The event body \u2014 validated at the HOST boundary before it gets here."),
82
- // run facts (minted by tide when a run settles — the fan-in mechanism)
83
76
  reflex: z.string().optional(),
84
77
  runId: z.string().optional(),
85
78
  occurrence: z.string().optional().describe("The calendar key, when the clock was the cause."),
86
79
  stats: z.object({ total: z.number().int(), done: z.number().int(), failed: z.number().int() }).strict().optional(),
87
- // manual facts (minted by `fire`)
88
80
  target: z.string().optional().describe("The one reflex a manual fact is aimed at."),
89
81
  by: z.string().optional().describe("Who fired it \u2014 recorded on the firing as manual:<who>."),
90
82
  at: z.number().int().describe("Supplied by the caller. Tide reads no clocks."),
@@ -195,5 +187,5 @@ var draftSchemaOf = (choice = {}) => {
195
187
  var ReflexDraftSchema = draftSchemaOf();
196
188
 
197
189
  export { ClockOnceSchema, ClockRecurringSchema, ClockTriggerSchema, ClockUnitSchema, DRAFT_TRIGGERS, EffectRefSchema, FactInputSchema, FactKindSchema, ManualTriggerSchema, OpSchema, PolicySchema, ReflexDraftSchema, ReflexSchema, RetrySchema, RunTriggerSchema, SelectionSchema, SignalTriggerSchema, TimerSchema, TimerTriggerSchema, TriggerSchema, WEEKDAYS, WriteTriggerSchema, clockOf, draftSchemaOf, factOf, isManual, isRecurring };
198
- //# sourceMappingURL=chunk-UEG3UZDG.js.map
199
- //# sourceMappingURL=chunk-UEG3UZDG.js.map
190
+ //# sourceMappingURL=chunk-4TXWZFRE.js.map
191
+ //# sourceMappingURL=chunk-4TXWZFRE.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/schemas/trigger.schema.ts","../src/schemas/policy.schema.ts","../src/schemas/fact.schema.ts","../src/schemas/reflex.schema.ts"],"names":["z","require"],"mappings":";;;AAEO,IAAM,QAAA,GAAW,CAAC,KAAA,EAAO,KAAA,EAAO,OAAO,KAAA,EAAO,KAAA,EAAO,OAAO,KAAK;AAExE,IAAM,IAAA,GAAO,2BAAA;AACb,IAAM,IAAA,GAAO,yCAAA;AACb,IAAM,cAAA,GAAiB,wDAAA;AAEhB,IAAM,eAAA,GAAkB,EAAE,IAAA,CAAK,CAAC,OAAO,MAAA,EAAQ,OAAA,EAAS,MAAM,CAAC;AAE/D,IAAM,oBAAA,GAAuB,EACjC,MAAA,CAAO;AAAA,EACN,KAAA,EAAO,eAAA,CAAgB,QAAA,CAAS,6JAAwJ,CAAA;AAAA,EACxL,EAAA,EAAI,CAAA,CACD,KAAA,CAAM,CAAC,CAAA,CAAE,MAAA,EAAO,CAAE,GAAA,EAAI,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,IAAI,EAAE,CAAA,EAAG,CAAA,CAAE,IAAA,CAAK,QAAQ,CAAA,EAAG,CAAA,CAAE,MAAA,EAAO,CAAE,KAAA,CAAM,IAAI,CAAC,CAAC,CAAA,CACjF,QAAA,EAAS,CACT,SAAS,yGAA0F,CAAA;AAAA,EACtG,EAAA,EAAI,EAAE,MAAA,EAAO,CAAE,MAAM,IAAI,CAAA,CAAE,SAAS,iCAAiC,CAAA;AAAA,EACrE,EAAA,EAAI,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,qBAAqB;AAC/C,CAAC,EACA,MAAA,EAAO,CACP,WAAA,CAAY,CAAC,OAAO,GAAA,KAAQ;AAC3B,EAAA,MAAM,IAAA,GAAO,CAAC,OAAA,KAAoB,GAAA,CAAI,QAAA,CAAS,EAAE,IAAA,EAAM,QAAA,EAAU,OAAA,EAAS,IAAA,EAAM,CAAC,IAAI,GAAG,CAAA;AACxF,EAAA,IAAI,MAAM,KAAA,KAAU,KAAA,IAAS,MAAM,EAAA,KAAO,MAAA,OAAgB,6BAA6B,CAAA;AACvF,EAAA,IAAI,KAAA,CAAM,KAAA,KAAU,MAAA,IAAU,EAAE,OAAO,KAAA,CAAM,EAAA,KAAO,QAAA,IAAY,QAAA,CAAS,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,KAAM,MAAM,EAAE,CAAA,CAAA;AACjG,IAAA,IAAA,CAAK,mDAAmD,CAAA;AAC1D,EAAA,IAAI,KAAA,CAAM,UAAU,OAAA,IAAW,OAAO,MAAM,EAAA,KAAO,QAAA,OAAe,4CAA4C,CAAA;AAC9G,EAAA,IAAI,KAAA,CAAM,KAAA,KAAU,MAAA,IAAU,EAAE,OAAO,KAAA,CAAM,EAAA,KAAO,QAAA,IAAY,IAAA,CAAK,IAAA,CAAK,KAAA,CAAM,EAAE,CAAA,CAAA;AAChF,IAAA,IAAA,CAAK,sCAAsC,CAAA;AAC/C,CAAC,CAAA,CACA,SAAS,kGAAkG;AAEvG,IAAM,eAAA,GAAkB,EAC5B,MAAA,CAAO;AAAA,EACN,EAAA,EAAI,EAAE,MAAA,EAAO,CAAE,MAAM,cAAc,CAAA,CAAE,SAAS,iGAAiG,CAAA;AAAA,EAC/I,EAAA,EAAI,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,qBAAqB;AAC/C,CAAC,CAAA,CACA,MAAA,EAAO,CACP,QAAA,CAAS,qDAAqD;AAE1D,IAAM,qBAAqB,CAAA,CAC/B,MAAA,CAAO,EAAE,KAAA,EAAO,EAAE,KAAA,CAAM,CAAC,oBAAA,EAAsB,eAAe,CAAC,CAAA,EAAG,EAClE,MAAA,EAAO,CACP,SAAS,iFAAiF;AAEtF,IAAM,WAAW,CAAA,CAAE,IAAA,CAAK,CAAC,QAAA,EAAU,QAAA,EAAU,QAAQ,CAAC;AAEtD,IAAM,kBAAA,GAAqB,EAC/B,MAAA,CAAO;AAAA,EACN,IAAA,EAAM,EACH,MAAA,CAAO;AAAA,IACN,MAAA,EAAQ,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,oDAAoD,CAAA;AAAA,IAChF,EAAA,EAAI,QAAA,CAAS,QAAA,EAAS,CAAE,SAAS,2DAAsD;AAAA,GACxF,EACA,MAAA;AACL,CAAC,CAAA,CACA,MAAA,EAAO,CACP,QAAA,CAAS,8EAAyE;AAE9E,IAAM,mBAAA,GAAsB,CAAA,CAChC,MAAA,CAAO,EAAE,IAAA,EAAM,EAAE,MAAA,CAAO,EAAE,MAAA,EAAQ,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,0BAA0B,CAAA,EAAG,CAAA,CAAE,MAAA,EAAO,EAAG,CAAA,CAC/F,MAAA,EAAO,CACP,QAAA,CAAS,8DAA8D;AAEnE,IAAM,gBAAA,GAAmB,EAC7B,MAAA,CAAO;AAAA,EACN,IAAA,EAAM,CAAA,CACH,MAAA,CAAO,EAAE,GAAA,EAAK,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,CAAS,iFAA6E,CAAA,EAAG,EAClH,MAAA;AACL,CAAC,CAAA,CACA,MAAA,EAAO,CACP,QAAA,CAAS,kEAAkE;AAEvE,IAAM,sBAAsB,CAAA,CAChC,MAAA,CAAO,EAAE,MAAA,EAAQ,EAAE,MAAA,CAAO,EAAE,CAAA,CAAE,QAAO,EAAG,EACxC,MAAA,EAAO,CACP,SAAS,4CAA4C;AAEjD,IAAM,aAAA,GAAgB,EAAE,KAAA,CAAM;AAAA,EACnC,kBAAA;AAAA,EACA,kBAAA;AAAA,EACA,mBAAA;AAAA,EACA,gBAAA;AAAA,EACA;AACF,CAAC;AASM,IAAM,UAAU,CAAC,OAAA,KAAyC,OAAA,IAAW,OAAA,GAAU,QAAQ,KAAA,GAAQ;AAE/F,IAAM,WAAA,GAAc,CAAC,KAAA,KAA0C,OAAA,IAAW;AAE1E,IAAM,SAAS,CACpB,OAAA,KAEA,MAAA,IAAU,OAAA,GAAU,QAAQ,IAAA,GAAO;AAE9B,IAAM,QAAA,GAAW,CAAC,OAAA,KAA8B,QAAA,IAAY;ACpG5D,IAAM,WAAA,GAAcA,EACxB,MAAA,CAAO;AAAA,EACN,GAAA,EAAKA,CAAAA,CAAE,MAAA,EAAO,CAAE,GAAA,EAAI,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAA,CAAE,SAAS,0DAA0D,CAAA;AAAA,EAC3G,OAAA,EAASA,EAAE,IAAA,CAAK,CAAC,SAAS,aAAa,CAAC,CAAA,CAAE,OAAA,CAAQ,aAAa,CAAA;AAAA,EAC/D,MAAA,EAAQA,EAAE,MAAA,EAAO,CAAE,KAAI,CAAE,QAAA,EAAS,CAAE,OAAA,CAAQ,GAAM;AACpD,CAAC,EACA,MAAA;AAEI,IAAM,YAAA,GAAeA,EACzB,MAAA,CAAO;AAAA,EACN,KAAA,EAAO,YAAY,QAAA,EAAS;AAAA,EAC5B,SAAA,EAAWA,EAAE,MAAA,EAAO,CAAE,KAAI,CAAE,QAAA,EAAS,CAAE,OAAA,CAAQ,GAAM,CAAA;AAAA,EACrD,OAAA,EAASA,EAAE,IAAA,CAAK,CAAC,QAAQ,OAAO,CAAC,CAAA,CAAE,OAAA,CAAQ,MAAM,CAAA;AAAA,EACjD,OAAA,EAASA,CAAAA,CAAE,IAAA,CAAK,CAAC,KAAA,EAAO,QAAQ,QAAQ,CAAC,CAAA,CAAE,OAAA,CAAQ,KAAK,CAAA;AAAA;AAAA;AAAA;AAAA,EAIxD,MAAA,EAAQA,EAAE,MAAA,EAAO,CAAE,KAAI,CAAE,QAAA,EAAS,CAAE,OAAA,CAAQ,IAAS,CAAA;AAAA,EACrD,KAAA,EAAOA,EAAE,IAAA,CAAK,CAAC,OAAO,QAAQ,CAAC,CAAA,CAAE,OAAA,CAAQ,KAAK;AAChD,CAAC,EACA,MAAA;AAKI,IAAM,cAAA,GAAyB,YAAA,CAAa,KAAA,CAAM,EAAE,CAAA;ACxBpD,IAAM,cAAA,GAAiBA,EAAE,IAAA,CAAK,CAAC,SAAS,QAAA,EAAU,QAAA,EAAU,KAAK,CAAC;AAElE,IAAM,eAAA,GAAkBA,EAC5B,MAAA,CAAO;AAAA,EACN,IAAA,EAAM,cAAA;AAAA,EAEN,QAAQA,CAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,SAAS,oCAAoC,CAAA;AAAA,EAC3E,EAAA,EAAI,QAAA,CAAS,QAAA,EAAS,CAAE,SAAS,mEAA8D,CAAA;AAAA,EAC/F,GAAA,EAAKA,CAAAA,CAAE,MAAA,CAAOA,CAAAA,CAAE,MAAA,EAAO,EAAGA,CAAAA,CAAE,OAAA,EAAS,CAAA,CAAE,QAAA,EAAS,CAAE,SAAS,oCAAoC,CAAA;AAAA,EAE/F,MAAMA,CAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,SAAS,qCAAqC,CAAA;AAAA,EAC1E,SAASA,CAAAA,CAAE,OAAA,GAAU,QAAA,EAAS,CAAE,SAAS,2EAAsE,CAAA;AAAA,EAE/G,MAAA,EAAQA,CAAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC5B,KAAA,EAAOA,CAAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC3B,YAAYA,CAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,SAAS,iDAAiD,CAAA;AAAA,EAC5F,KAAA,EAAOA,CAAAA,CACJ,MAAA,CAAO,EAAE,KAAA,EAAOA,CAAAA,CAAE,MAAA,EAAO,CAAE,GAAA,EAAI,EAAG,IAAA,EAAMA,CAAAA,CAAE,MAAA,GAAS,GAAA,EAAI,EAAG,MAAA,EAAQA,CAAAA,CAAE,MAAA,EAAO,CAAE,GAAA,EAAI,EAAG,CAAA,CACpF,MAAA,EAAO,CACP,QAAA,EAAS;AAAA,EAEZ,QAAQA,CAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,SAAS,2CAA2C,CAAA;AAAA,EAClF,IAAIA,CAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,SAAS,6DAAwD,CAAA;AAAA,EAE3F,IAAIA,CAAAA,CAAE,MAAA,GAAS,GAAA,EAAI,CAAE,SAAS,+CAA+C,CAAA;AAAA,EAC7E,SAAA,EAAWA,EAAE,MAAA,EAAO,CAAE,KAAI,CAAE,QAAA,EAAS,CAAE,QAAA,CAAS,8DAAyD,CAAA;AAAA,EACzG,WAAWA,CAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,SAAS,4FAA4F,CAAA;AAAA,EACtI,OAAOA,CAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,SAAS,8DAAyD;AACjG,CAAC,EACA,MAAA,EAAO,CACP,WAAA,CAAY,CAAC,MAAM,GAAA,KAAQ;AAC1B,EAAA,MAAMC,QAAAA,GAAU,CAAC,KAAA,EAA0B,GAAA,KAAgB;AACzD,IAAA,IAAI,IAAA,CAAK,KAAK,CAAA,KAAM,MAAA;AAClB,MAAA,GAAA,CAAI,SAAS,EAAE,IAAA,EAAM,UAAU,OAAA,EAAS,CAAA,EAAA,EAAK,KAAK,IAAI,CAAA,cAAA,EAAiB,OAAO,KAAK,CAAC,aAAQ,GAAG,CAAA,CAAA,EAAI,MAAM,CAAC,KAAK,GAAG,CAAA;AAAA,EACtH,CAAA;AACA,EAAA,MAAM,MAAA,GAAS,CAAC,KAAA,KAA6B;AAC3C,IAAA,IAAI,IAAA,CAAK,KAAK,CAAA,KAAM,MAAA;AAClB,MAAA,GAAA,CAAI,SAAS,EAAE,IAAA,EAAM,QAAA,EAAU,OAAA,EAAS,KAAK,MAAA,CAAO,KAAK,CAAC,CAAA,oBAAA,EAAuB,KAAK,IAAI,CAAA,KAAA,CAAA,EAAS,MAAM,CAAC,KAAK,GAAG,CAAA;AAAA,EACtH,CAAA;AAEA,EAAA,IAAI,IAAA,CAAK,SAAS,OAAA,EAAS;AACzB,IAAAA,QAAAA,CAAQ,UAAU,uCAAuC,CAAA;AACzD,IAAA,MAAA,CAAO,MAAM,CAAA;AACb,IAAA,MAAA,CAAO,QAAQ,CAAA;AACf,IAAA,MAAA,CAAO,OAAO,CAAA;AAAA,EAChB;AACA,EAAA,IAAI,IAAA,CAAK,SAAS,QAAA,EAAU;AAC1B,IAAAA,QAAAA,CAAQ,QAAQ,0CAA0C,CAAA;AAC1D,IAAA,MAAA,CAAO,QAAQ,CAAA;AACf,IAAA,MAAA,CAAO,IAAI,CAAA;AACX,IAAA,MAAA,CAAO,QAAQ,CAAA;AACf,IAAA,MAAA,CAAO,OAAO,CAAA;AAAA,EAChB;AACA,EAAA,IAAI,IAAA,CAAK,SAAS,QAAA,EAAU;AAC1B,IAAAA,QAAAA,CAAQ,UAAU,8CAA8C,CAAA;AAChE,IAAA,MAAA,CAAO,QAAQ,CAAA;AACf,IAAA,MAAA,CAAO,MAAM,CAAA;AACb,IAAA,MAAA,CAAO,OAAO,CAAA;AAAA,EAChB;AACA,EAAA,IAAI,IAAA,CAAK,SAAS,KAAA,EAAO;AACvB,IAAAA,QAAAA,CAAQ,UAAU,yBAAyB,CAAA;AAC3C,IAAAA,QAAAA,CAAQ,SAAS,yBAAyB,CAAA;AAC1C,IAAA,MAAA,CAAO,QAAQ,CAAA;AACf,IAAA,MAAA,CAAO,MAAM,CAAA;AACb,IAAA,MAAA,CAAO,QAAQ,CAAA;AAAA,EACjB;AACF,CAAC;ACjEI,IAAM,eAAA,GAAkBD,EAC5B,MAAA,CAAO;AAAA,EACN,KAAA,EAAOA,CAAAA,CAAE,OAAA,EAAQ,CAAE,SAAS,0FAA0F,CAAA;AAAA,EACtH,IAAA,EAAMA,CAAAA,CACH,IAAA,CAAK,CAAC,MAAA,EAAQ,OAAO,CAAC,CAAA,CACtB,OAAA,CAAQ,MAAM,CAAA,CACd,QAAA,CAAS,4FAAkF,CAAA;AAAA,EAC9F,SAASA,CAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,SAAS,iFAAiF;AAC3H,CAAC,EACA,MAAA;AAEI,IAAM,eAAA,GAAkBA,EAC5B,MAAA,CAAO;AAAA,EACN,IAAA,EAAMA,CAAAA,CAAE,MAAA,EAAO,CAAE,SAAS,8EAA8E,CAAA;AAAA,EACxG,OAAOA,CAAAA,CAAE,OAAA,GAAU,QAAA,EAAS,CAAE,SAAS,yDAAyD;AAClG,CAAC,EACA,MAAA;AAEH,IAAM,YAAA,GAAe;AAAA,EACnB,EAAA,EAAIA,EAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,SAAS,qEAAqE,CAAA;AAAA,EACpG,MAAA,EAAQA,EAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,SAAS,uEAAkE,CAAA;AAAA,EACrG,EAAA,EAAI,aAAA;AAAA,EACJ,IAAIA,CAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,SAAS,qEAAqE,CAAA;AAAA,EACxG,MAAA,EAAQA,CAAAA,CAAE,MAAA,CAAOA,CAAAA,CAAE,MAAA,EAAO,EAAGA,CAAAA,CAAE,OAAA,EAAS,CAAA,CAAE,QAAA,EAAS,CAAE,SAAS,mDAAmD,CAAA;AAAA,EACjH,MAAA,EAAQ,eAAA,CAAgB,QAAA,EAAS,CAAE,SAAS,2CAA2C,CAAA;AAAA,EACvF,MAAMA,CAAAA,CAAE,OAAA,GAAU,QAAA,EAAS,CAAE,SAAS,8EAAyE,CAAA;AAAA,EAC/G,MAAA,EAAQ,eAAA;AAAA,EACR,MAAA,EAAQ,YAAA,CAAa,OAAA,CAAQ,cAAc,CAAA;AAAA,EAC3C,OAAA,EAASA,EAAE,OAAA,EAAQ,CAAE,QAAQ,IAAI,CAAA,CAAE,SAAS,oFAA+E;AAC7H,CAAA;AAEA,IAAM,WAAA,GAAc,CAAC,MAAA,EAA6G,GAAA,KAA+B;AAC/J,EAAA,IAAI,MAAA,CAAO,IAAA,KAAS,MAAA,IAAa,EAAE,UAAU,MAAA,CAAO,EAAA,CAAA;AAClD,IAAA,GAAA,CAAI,QAAA,CAAS,EAAE,IAAA,EAAM,QAAA,EAAU,OAAA,EAAS,sEAAsE,IAAA,EAAM,CAAC,MAAM,CAAA,EAAG,CAAA;AAChI,EAAA,IAAI,OAAO,MAAA,EAAQ,IAAA,KAAS,MAAA,IAAU,MAAA,CAAO,OAAO,OAAA,KAAY,MAAA;AAC9D,IAAA,GAAA,CAAI,QAAA,CAAS,EAAE,IAAA,EAAM,QAAA,EAAU,OAAA,EAAS,uEAAA,EAAoE,IAAA,EAAM,CAAC,QAAA,EAAU,SAAS,CAAA,EAAG,CAAA;AAC7I,CAAA;AAEO,IAAM,YAAA,GAAeA,EAAE,MAAA,CAAO,YAAY,EAAE,MAAA,EAAO,CAAE,YAAY,WAAW;AAE5E,IAAM,WAAA,GAAcA,EACxB,MAAA,CAAO;AAAA,EACN,KAAA,EAAOA,EAAE,MAAA,EAAO,CAAE,KAAI,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,QAAA,EAAS;AAAA,EACxC,OAAA,EAASA,EAAE,MAAA,EAAO,CAAE,KAAI,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,QAAA,EAAS;AAAA,EAC1C,OAAA,EAASA,EAAE,MAAA,EAAO,CAAE,KAAI,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,QAAA;AACnC,CAAC,EACA,MAAA,EAAO,CACP,OAAO,CAAC,KAAA,KAAA,CAAW,MAAM,KAAA,IAAS,CAAA,KAAM,MAAM,OAAA,IAAW,CAAA,CAAA,IAAM,MAAM,OAAA,IAAW,CAAA,CAAA,GAAK,GAAG,EAAE,OAAA,EAAS,0BAA0B;AAEzH,IAAM,kBAAA,GAAqBA,CAAAA,CAC/B,MAAA,CAAO,EAAE,KAAA,EAAO,WAAA,CAAY,QAAA,CAAS,4NAAuN,CAAA,EAAG,CAAA,CAC/P,MAAA;AAEI,IAAM,cAAA,GAAiB;AAAA,EAC5B,KAAA,EAAO,kBAAA;AAAA,EACP,KAAA,EAAO,kBAAA;AAAA,EACP,KAAA,EAAO,kBAAA;AAAA,EACP,MAAA,EAAQ,mBAAA;AAAA,EACR,GAAA,EAAK,gBAAA;AAAA,EACL,MAAA,EAAQ;AACV;AAEA,IAAM,qBAA8C,CAAC,OAAA,EAAS,SAAS,OAAA,EAAS,QAAA,EAAU,OAAO,QAAQ,CAAA;AAMzG,IAAM,SAAA,GAAY;AAAA,EAChB,EAAA,EAAIA,EAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,SAAS,mCAAmC,CAAA;AAAA,EAClE,QAAQ,YAAA,CAAa,MAAA;AAAA,EACrB,MAAA,EAAQ;AACV,CAAA;AAEA,IAAM,iBAAA,GAAoBA,CAAAA,CACvB,MAAA,CAAO,EAAE,GAAG,WAAW,EAAA,EAAIA,CAAAA,CAAE,KAAA,CAAM,CAAC,aAAA,EAAe,kBAAkB,CAAC,CAAA,EAAG,MAAA,EAAQ,YAAA,CAAa,MAAA,EAAQ,MAAA,EAAQ,YAAA,CAAa,MAAA,EAAQ,IAAA,EAAM,YAAA,CAAa,IAAA,EAAM,CAAA,CAC5J,MAAA,EAAO;AAGH,IAAM,aAAA,GAAgB,CAAC,MAAA,GAAsB,EAAC,KAA8B;AACjF,EAAA,MAAM,CAAC,KAAA,EAAO,GAAG,IAAI,CAAA,GAAA,CAAK,MAAA,CAAO,QAAA,IAAY,kBAAA,EAAoB,GAAA,CAAI,CAAC,IAAA,KAAuC,cAAA,CAAe,IAAI,CAAC,CAAA;AACjI,EAAA,IAAI,KAAA,KAAU,MAAA,EAAW,MAAM,IAAI,MAAM,+CAA+C,CAAA;AACxF,EAAA,MAAM,EAAA,GAAmC,IAAA,CAAK,MAAA,KAAW,CAAA,GAAI,KAAA,GAAQA,CAAAA,CAAE,KAAA,CAAM,CAAC,KAAA,EAAO,GAAG,IAAI,CAAC,CAAA;AAC7F,EAAA,MAAM,MAAM,CAAC,KAAA,KAA+B,OAAO,MAAA,EAAQ,QAAA,CAAS,KAAK,CAAA,IAAK,KAAA;AAC9E,EAAA,MAAM,IAAA,GAA8C;AAAA,IAClD,EAAA,EAAI,IAAA;AAAA,IACJ,MAAA,EAAQ,IAAA;AAAA,IACR,MAAA,EAAQ,IAAA;AAAA,IACR,EAAA,EAAI,IAAA;AAAA,IACJ,GAAI,IAAI,QAAQ,CAAA,GAAI,EAAE,MAAA,EAAQ,IAAA,KAAkB,EAAC;AAAA,IACjD,GAAI,IAAI,QAAQ,CAAA,GAAI,EAAE,MAAA,EAAQ,IAAA,KAAkB,EAAC;AAAA,IACjD,GAAI,IAAI,MAAM,CAAA,GAAI,EAAE,IAAA,EAAM,IAAA,KAAkB;AAAC,GAC/C;AACA,EAAA,OAAO,iBAAA,CAAkB,IAAA,CAAK,IAAI,CAAA,CAAE,MAAA,CAAO,EAAE,EAAA,EAAI,CAAA,CAAE,MAAA,EAAO,CAAE,WAAA,CAAY,WAAW,CAAA;AACrF;AAEO,IAAM,oBAAoB,aAAA","file":"chunk-4TXWZFRE.js","sourcesContent":["import { z } from 'zod';\n\nexport const WEEKDAYS = ['mon', 'tue', 'wed', 'thu', 'fri', 'sat', 'sun'] as const;\n\nconst HHMM = /^([01]\\d|2[0-3]):[0-5]\\d$/;\nconst MMDD = /^(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$/;\nconst LOCAL_DATETIME = /^\\d{4}-\\d{2}-\\d{2}T([01]\\d|2[0-3]):[0-5]\\d(:[0-5]\\d)?$/;\n\nexport const ClockUnitSchema = z.enum(['day', 'week', 'month', 'year']);\n\nexport const ClockRecurringSchema = z\n .object({\n every: ClockUnitSchema.describe('The calendar period it repeats on. A repeating clock fires on every such period until the reflex is removed — only for a request that says it repeats.'),\n on: z\n .union([z.number().int().min(1).max(31), z.enum(WEEKDAYS), z.string().regex(MMDD)])\n .optional()\n .describe('week → a weekday; month → 1..31 (clamped to month end); year → \"MM-DD\". Omitted for day.'),\n at: z.string().regex(HHMM).describe('Local wall-clock time, \"HH:MM\".'),\n tz: z.string().describe('IANA timezone name.'),\n })\n .strict()\n .superRefine((clock, ctx) => {\n const fail = (message: string) => ctx.addIssue({ code: 'custom', message, path: ['on'] });\n if (clock.every === 'day' && clock.on !== undefined) fail('a daily clock takes no `on`');\n if (clock.every === 'week' && !(typeof clock.on === 'string' && WEEKDAYS.some((d) => d === clock.on)))\n fail('a weekly clock needs `on` as a weekday (mon..sun)');\n if (clock.every === 'month' && typeof clock.on !== 'number') fail('a monthly clock needs `on` as a day number');\n if (clock.every === 'year' && !(typeof clock.on === 'string' && MMDD.test(clock.on)))\n fail('a yearly clock needs `on` as \"MM-DD\"');\n })\n .describe('Repeats: fires on every day, week, month or year, at a time of day, until the reflex is removed.');\n\nexport const ClockOnceSchema = z\n .object({\n at: z.string().regex(LOCAL_DATETIME).describe('A fixed local date and time, once: \"YYYY-MM-DDTHH:MM\" or, to the second, \"YYYY-MM-DDTHH:MM:SS\".'),\n tz: z.string().describe('IANA timezone name.'),\n })\n .strict()\n .describe('Once: fires at one date and time, then never again.');\n\nexport const ClockTriggerSchema = z\n .object({ clock: z.union([ClockRecurringSchema, ClockOnceSchema]) })\n .strict()\n .describe('Fires on the calendar: once, at a date and time, or repeating at a time of day.');\n\nexport const OpSchema = z.enum(['insert', 'update', 'delete']);\n\nexport const WriteTriggerSchema = z\n .object({\n fact: z\n .object({\n entity: z.string().describe('The table or entity whose writes wake this reflex.'),\n op: OpSchema.optional().describe('Narrow to one op — \"only on create\" is op: \"insert\".'),\n })\n .strict(),\n })\n .strict()\n .describe('Fires when a row of an entity is written — created, changed or deleted.');\n\nexport const SignalTriggerSchema = z\n .object({ fact: z.object({ signal: z.string().describe('A named external intake.') }).strict() })\n .strict()\n .describe('Fires when an event arrives from outside, on a named intake.');\n\nexport const RunTriggerSchema = z\n .object({\n fact: z\n .object({ run: z.string().describe('A reflex id — fires when THAT reflex\\'s run settles. Fan-in and dependency.') })\n .strict(),\n })\n .strict()\n .describe('Fires when another reflex has run: one automation after another.');\n\nexport const ManualTriggerSchema = z\n .object({ manual: z.object({}).strict() })\n .strict()\n .describe('Fires only when somebody fires it by hand.');\n\nexport const TriggerSchema = z.union([\n ClockTriggerSchema,\n WriteTriggerSchema,\n SignalTriggerSchema,\n RunTriggerSchema,\n ManualTriggerSchema,\n]);\n\nexport type ClockRecurring = z.infer<typeof ClockRecurringSchema>;\nexport type ClockOnce = z.infer<typeof ClockOnceSchema>;\nexport type Clock = ClockRecurring | ClockOnce;\nexport type Trigger = z.infer<typeof TriggerSchema>;\nexport type Op = z.infer<typeof OpSchema>;\nexport type Weekday = (typeof WEEKDAYS)[number];\n\nexport const clockOf = (trigger: Trigger): Clock | undefined => ('clock' in trigger ? trigger.clock : undefined);\n\nexport const isRecurring = (clock: Clock): clock is ClockRecurring => 'every' in clock;\n\nexport const factOf = (\n trigger: Trigger,\n): { entity?: string; op?: Op; signal?: string; run?: string } | undefined =>\n 'fact' in trigger ? trigger.fact : undefined;\n\nexport const isManual = (trigger: Trigger): boolean => 'manual' in trigger;\n","import { z } from 'zod';\n\nexport const RetrySchema = z\n .object({\n max: z.number().int().min(0).default(3).describe('Attempts after the first before the task parks `failed`.'),\n backoff: z.enum(['fixed', 'exponential']).default('exponential'),\n baseMs: z.number().int().positive().default(60_000),\n })\n .strict();\n\nexport const PolicySchema = z\n .object({\n retry: RetrySchema.optional(),\n timeoutMs: z.number().int().positive().default(30_000),\n overlap: z.enum(['skip', 'allow']).default('skip'),\n catchUp: z.enum(['run', 'skip', 'latest']).default('run'),\n // Read by `catchUp: 'skip'` only. What `catchUp` opens still passes\n // `overlap`: occurrences missed together are repeats of one another, so\n // under `overlap: 'skip'` the oldest runs and the rest are skipped.\n lateMs: z.number().int().positive().default(3_600_000),\n order: z.enum(['any', 'serial']).default('any'),\n })\n .strict();\n\nexport type Retry = z.infer<typeof RetrySchema>;\nexport type Policy = z.infer<typeof PolicySchema>;\n\nexport const DEFAULT_POLICY: Policy = PolicySchema.parse({});\n","import { z } from 'zod';\nimport { OpSchema } from './trigger.schema';\n\nexport const FactKindSchema = z.enum(['write', 'signal', 'manual', 'run']);\n\nexport const FactInputSchema = z\n .object({\n kind: FactKindSchema,\n\n entity: z.string().optional().describe('Which table or entity was written.'),\n op: OpSchema.optional().describe('Ops are distinct stimuli — \"only on create\" is op: \"insert\".'),\n row: z.record(z.string(), z.unknown()).optional().describe('The row, as the write returned it.'),\n\n name: z.string().optional().describe('Which named intake this arrived on.'),\n payload: z.unknown().optional().describe('The event body — validated at the HOST boundary before it gets here.'),\n\n reflex: z.string().optional(),\n runId: z.string().optional(),\n occurrence: z.string().optional().describe('The calendar key, when the clock was the cause.'),\n stats: z\n .object({ total: z.number().int(), done: z.number().int(), failed: z.number().int() })\n .strict()\n .optional(),\n\n target: z.string().optional().describe('The one reflex a manual fact is aimed at.'),\n by: z.string().optional().describe('Who fired it — recorded on the firing as manual:<who>.'),\n\n at: z.number().int().describe('Supplied by the caller. Tide reads no clocks.'),\n notBefore: z.number().int().optional().describe('A delayed fact — timers as data, visible and queryable.'),\n dedupeKey: z.string().optional().describe('Provider event ids. A repeat is refused and announced as fact.deduped; it is not an error.'),\n cause: z.string().optional().describe('Set by tide when an effect emits — the causality chain.'),\n })\n .strict()\n .superRefine((fact, ctx) => {\n const require = (field: keyof typeof fact, why: string) => {\n if (fact[field] === undefined)\n ctx.addIssue({ code: 'custom', message: `a ${fact.kind} fact needs \\`${String(field)}\\` — ${why}`, path: [field] });\n };\n const refuse = (field: keyof typeof fact) => {\n if (fact[field] !== undefined)\n ctx.addIssue({ code: 'custom', message: `\\`${String(field)}\\` is not part of a ${fact.kind} fact`, path: [field] });\n };\n\n if (fact.kind === 'write') {\n require('entity', 'it is what a write trigger matches on');\n refuse('name');\n refuse('target');\n refuse('runId');\n }\n if (fact.kind === 'signal') {\n require('name', 'it is which named intake this arrived on');\n refuse('entity');\n refuse('op');\n refuse('target');\n refuse('runId');\n }\n if (fact.kind === 'manual') {\n require('target', 'a manual fact is aimed at exactly one reflex');\n refuse('entity');\n refuse('name');\n refuse('runId');\n }\n if (fact.kind === 'run') {\n require('reflex', 'it is whose run settled');\n require('runId', 'it is which run settled');\n refuse('entity');\n refuse('name');\n refuse('target');\n }\n });\n\nexport type FactInput = z.infer<typeof FactInputSchema>;\nexport type FactKind = z.infer<typeof FactKindSchema>;\n","import { z } from 'zod';\nimport { ClockTriggerSchema, ManualTriggerSchema, RunTriggerSchema, SignalTriggerSchema, TriggerSchema, WriteTriggerSchema } from './trigger.schema';\nimport { DEFAULT_POLICY, PolicySchema } from './policy.schema';\n\nexport const SelectionSchema = z\n .object({\n query: z.unknown().describe('Handed to the `select` seam verbatim. Under moss: a vex { fingerprint, context } replay.'),\n mode: z\n .enum(['each', 'batch'])\n .default('each')\n .describe('each → one task per row; batch → one task carrying all rows (bounded sets only).'),\n unitKey: z.string().optional().describe('The row field keying a unit task. `each` mode only; duplicates fail the firing.'),\n })\n .strict();\n\nexport const EffectRefSchema = z\n .object({\n name: z.string().describe('A registered effect. The reflex names it; the registry supplies the handler.'),\n input: z.unknown().optional().describe('A template, evaluated per unit by the `transform` seam.'),\n })\n .strict();\n\nconst reflexFields = {\n id: z.string().min(1).describe(\"Unique. A tenant's reflex is the tenant's own row, with its own id.\"),\n intent: z.string().min(1).describe(\"One factual sentence — what this does, in the person's language.\"),\n on: TriggerSchema,\n as: z.string().optional().describe('The identity this runs under. Opaque to tide; the host resolves it.'),\n params: z.record(z.string(), z.unknown()).optional().describe('Authored knobs, visible to templates as $.params.'),\n select: SelectionSchema.optional().describe('Omitted = the trigger itself is the unit.'),\n when: z.unknown().optional().describe('A predicate template. FACT triggers only — a query belongs in `select`.'),\n effect: EffectRefSchema,\n policy: PolicySchema.default(DEFAULT_POLICY),\n enabled: z.boolean().default(true).describe('A switch on the row, not part of the definition — flipping it is not an edit.'),\n};\n\nconst reflexRules = (reflex: { on: object; when?: unknown; select?: { mode: string; unitKey?: string | undefined } | undefined }, ctx: z.RefinementCtx): void => {\n if (reflex.when !== undefined && !('fact' in reflex.on))\n ctx.addIssue({ code: 'custom', message: '`when` is for fact triggers; a clock condition belongs in `select`', path: ['when'] });\n if (reflex.select?.mode === 'each' && reflex.select.unitKey === undefined)\n ctx.addIssue({ code: 'custom', message: \"`each` mode needs a unitKey — it is the task's idempotency grain\", path: ['select', 'unitKey'] });\n};\n\nexport const ReflexSchema = z.object(reflexFields).strict().superRefine(reflexRules);\n\nexport const TimerSchema = z\n .object({\n hours: z.number().int().min(0).optional(),\n minutes: z.number().int().min(0).optional(),\n seconds: z.number().int().min(0).optional(),\n })\n .strict()\n .refine((timer) => (timer.hours ?? 0) + (timer.minutes ?? 0) + (timer.seconds ?? 0) > 0, { message: 'a timer needs a length' });\n\nexport const TimerTriggerSchema = z\n .object({ timer: TimerSchema.describe('A length of time from now, as hours, minutes and seconds (each optional, together more than zero). Fires once, that long after the reflex is saved — not after it is written. A clock is for a time of day or a date.') })\n .strict();\n\nexport const DRAFT_TRIGGERS = {\n clock: ClockTriggerSchema,\n timer: TimerTriggerSchema,\n write: WriteTriggerSchema,\n signal: SignalTriggerSchema,\n run: RunTriggerSchema,\n manual: ManualTriggerSchema,\n} as const;\nexport type DraftTrigger = keyof typeof DRAFT_TRIGGERS;\nconst ALL_DRAFT_TRIGGERS: readonly DraftTrigger[] = ['clock', 'timer', 'write', 'signal', 'run', 'manual'];\n\nexport type DraftField = 'params' | 'select' | 'when';\n\nexport type DraftChoice = { triggers?: readonly DraftTrigger[]; fields?: readonly DraftField[] };\n\nconst draftCore = {\n id: z.string().min(1).describe('A short name for this automation.'),\n intent: reflexFields.intent,\n effect: EffectRefSchema,\n};\n\nconst WidestDraftSchema = z\n .object({ ...draftCore, on: z.union([TriggerSchema, TimerTriggerSchema]), params: reflexFields.params, select: reflexFields.select, when: reflexFields.when })\n .strict();\nexport type ReflexDraft = z.infer<typeof WidestDraftSchema>;\n\nexport const draftSchemaOf = (choice: DraftChoice = {}): z.ZodType<ReflexDraft> => {\n const [first, ...rest] = (choice.triggers ?? ALL_DRAFT_TRIGGERS).map((kind): z.ZodType<ReflexDraft['on']> => DRAFT_TRIGGERS[kind]);\n if (first === undefined) throw new Error('tide: a draft needs at least one trigger kind');\n const on: z.ZodType<ReflexDraft['on']> = rest.length === 0 ? first : z.union([first, ...rest]);\n const has = (field: DraftField): boolean => choice.fields?.includes(field) ?? false;\n const keep: { [key in keyof ReflexDraft]?: true } = {\n id: true,\n intent: true,\n effect: true,\n on: true,\n ...(has('params') ? { params: true as const } : {}),\n ...(has('select') ? { select: true as const } : {}),\n ...(has('when') ? { when: true as const } : {}),\n };\n return WidestDraftSchema.pick(keep).extend({ on }).strict().superRefine(reflexRules);\n};\n\nexport const ReflexDraftSchema = draftSchemaOf();\n\nexport type Selection = z.infer<typeof SelectionSchema>;\nexport type EffectRef = z.infer<typeof EffectRefSchema>;\nexport type Reflex = z.infer<typeof ReflexSchema>;\nexport type ReflexInput = z.input<typeof ReflexSchema>;\nexport type Timer = z.infer<typeof TimerSchema>;\n"]}
@@ -6,8 +6,7 @@ var PRIMARY_KEY = {
6
6
  state: "reflexId"
7
7
  };
8
8
  var UNIQUE_BY = {
9
- // `entity` is part of the key. Without it two polls over different tables
10
- // that happened to agree on a cursor value silently ate each other's rows.
9
+ // `entity` is in the key: two polls over different tables can agree on a cursor value.
11
10
  fact: { by: ["kind", "entity", "name", "dedupeKey"], when: "dedupeKey" },
12
11
  run: { by: ["reflexId", "cause"] },
13
12
  task: { by: ["runId", "unit"] },
@@ -16,5 +15,5 @@ var UNIQUE_BY = {
16
15
  var COMPARISON_OPS = ["eq", "ne", "lt", "lte", "gt", "gte", "in", "notIn", "isNull"];
17
16
 
18
17
  export { COMPARISON_OPS, PRIMARY_KEY, UNIQUE_BY };
19
- //# sourceMappingURL=chunk-4CUQXWVY.js.map
20
- //# sourceMappingURL=chunk-4CUQXWVY.js.map
18
+ //# sourceMappingURL=chunk-7KHOAJNL.js.map
19
+ //# sourceMappingURL=chunk-7KHOAJNL.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/types.ts"],"names":[],"mappings":";AA8LO,IAAM,WAAA,GAAkE;AAAA,EAC7E,IAAA,EAAM,IAAA;AAAA,EACN,GAAA,EAAK,IAAA;AAAA,EACL,IAAA,EAAM,IAAA;AAAA,EACN,KAAA,EAAO;AACT;AASO,IAAM,SAAA,GAAgD;AAAA;AAAA,EAE3D,IAAA,EAAM,EAAE,EAAA,EAAI,CAAC,MAAA,EAAQ,UAAU,MAAA,EAAQ,WAAW,CAAA,EAAG,IAAA,EAAM,WAAA,EAAY;AAAA,EACvE,KAAK,EAAE,EAAA,EAAI,CAAC,UAAA,EAAY,OAAO,CAAA,EAAE;AAAA,EACjC,MAAM,EAAE,EAAA,EAAI,CAAC,OAAA,EAAS,MAAM,CAAA,EAAE;AAAA,EAC9B,KAAA,EAAO,EAAE,EAAA,EAAI,CAAC,UAAU,CAAA;AAC1B;AAcO,IAAM,cAAA,GAAiB,CAAC,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,OAAO,IAAA,EAAM,KAAA,EAAO,IAAA,EAAM,OAAA,EAAS,QAAQ","file":"chunk-7KHOAJNL.js","sourcesContent":["import type { FactInput, Reflex, ReflexInput } from './schemas';\n\nexport type Row = Record<string, unknown>;\n\nexport type Fact = FactInput & {\n id: string;\n as?: string;\n depth: number;\n deliveredAt?: number;\n parked?: string;\n released?: boolean;\n root?: string;\n descendants?: number;\n};\n\nexport type RunState = 'pending' | 'fanned' | 'settled' | 'skipped';\n\nexport type Run = {\n id: string;\n reflexId: string;\n version: string;\n as?: string;\n cause: string;\n occurrence?: string;\n factIds?: readonly string[];\n state: RunState;\n depth: number;\n selected?: number;\n total: number;\n done: number;\n failed: number;\n dueAt: number;\n createdAt: number;\n settledAt?: number;\n // Set when no run fact is owed: the settlement has been emitted as one, or\n // the run was skipped. Apart from `settledAt`: a retried task settles its\n // run again, and that must not emit a second fact.\n drained?: boolean;\n note?: string;\n};\n\nexport type AttemptOutcome = 'ok' | 'error' | 'timeout';\n\nexport type TaskState = 'pending' | 'claimed' | 'retrying' | 'done' | 'failed';\n\nexport type Task = {\n id: string;\n runId: string;\n reflexId: string;\n unit: string;\n cause: string;\n // Frozen at fan-out: a retry evaluates against the data the selection saw.\n env: Row;\n depth: number;\n state: TaskState;\n attempt: number;\n token?: string;\n // Zero, not null, when unclaimed: \"never claimed or lapsed\" is then one\n // comparison, in a query grammar that has no OR.\n claimedUntil: number;\n notBefore: number;\n input?: unknown;\n output?: unknown;\n error?: string;\n createdAt: number;\n settledAt?: number;\n};\n\nexport type ReflexState = {\n reflexId: string;\n armedAt: number;\n materializedThrough?: number;\n};\n\nexport type TideCtx = {\n reflexId: string;\n runId: string;\n taskId: string;\n // The idempotency key a handler passes to an external provider: the same\n // on every attempt of the task.\n taskKey: string;\n attempt: number;\n depth: number;\n now: number;\n actor: unknown;\n emit: (fact: Omit<FactInput, 'cause'>) => void;\n};\n\nexport type EffectHandler = {\n run: (input: unknown, ctx: TideCtx) => Promise<unknown> | unknown;\n writes?: readonly string[];\n preview?: (input: unknown, ctx: PreviewCtx) => unknown;\n};\n\nexport type PreviewCtx = { reflexId: string; unit: string; now: number; actor: unknown };\n\nexport type EffectRegistry = Record<string, EffectHandler>;\n\nexport type TransformFn = (config: unknown, source: Row) => unknown;\n\nexport type SelectFn = (query: unknown, ctx: SelectCtx) => AsyncIterable<Row> | Iterable<Row> | Promise<Iterable<Row>>;\n\nexport type SelectCtx = { reflexId: string; now: number; actor: unknown; env: Row };\n\nexport type ActorFn = (as: string | undefined) => unknown;\n\nexport type Retention = Partial<Record<'facts' | 'runs' | 'tasks', number>>;\n\nexport type TideConfig = {\n store: TideStore;\n transform: TransformFn;\n select?: SelectFn;\n effects?: EffectRegistry | ((as: string | undefined) => EffectRegistry);\n actor?: ActorFn;\n maxChainDepth?: number;\n maxChainFacts?: number;\n storeUnwatchedWrites?: boolean;\n maxFanOut?: number;\n leaseMs?: number;\n onEvent?: (event: TideEvent) => void;\n};\n\nexport type TideEvent =\n | { type: 'run.created'; run: Run }\n | { type: 'run.settled'; run: Run }\n | { type: 'run.skipped'; reflexId: string; reason: string }\n | { type: 'run.deferred'; reflexId: string; runId: string; reason: string }\n | { type: 'task.done'; task: Task }\n | { type: 'task.failed'; task: Task }\n | { type: 'task.retrying'; task: Task; nextAt: number }\n | { type: 'task.reclaimed'; task: Task }\n | { type: 'fact.ingested'; fact: Fact }\n | { type: 'fact.deduped'; fact: NewFact }\n | { type: 'fact.parked'; fact: Fact; reason: string }\n | { type: 'fact.unmatched'; fact: Fact; reflexId: string; reason: string };\n\nexport type AdvanceReport = {\n now: number;\n materialized: number;\n skippedOccurrences: number;\n factsMatched: number;\n runsCreated: number;\n tasksCreated: number;\n executed: number;\n succeeded: number;\n failed: number;\n retrying: number;\n reclaimed: number;\n runsSettled: number;\n parked: number;\n};\n\nexport type LoadReport = {\n loaded: number;\n cycles: readonly { reflexIds: readonly string[]; guarded: boolean }[];\n blind: readonly { reflexId: string; effect: string }[];\n warnings: readonly string[];\n};\n\nexport type PreviewUnit = {\n unit: string;\n env: Row;\n input?: unknown;\n render?: unknown;\n error?: string;\n};\n\nexport type PreviewReport = {\n reflexId: string;\n version: string;\n fired: boolean;\n reason?: string;\n cause?: string;\n occurrence?: string;\n effect: string;\n selected: number;\n units: readonly PreviewUnit[];\n};\n\nexport type NewFact = FactInput & { depth: number; as?: string };\n\nexport type TideTables = {\n fact: Fact;\n run: Run;\n task: Task;\n state: ReflexState;\n};\n\nexport type TableName = keyof TideTables;\n\nexport const PRIMARY_KEY: { [T in TableName]: keyof TideTables[T] & string } = {\n fact: 'id',\n run: 'id',\n task: 'id',\n state: 'reflexId',\n};\n\nexport type UniqueKey<T extends TableName> = {\n by: readonly (keyof TideTables[T] & string)[];\n // The key applies only to rows that have this column set: in Postgres, a\n // partial unique index.\n when?: keyof TideTables[T] & string;\n};\n\nexport const UNIQUE_BY: { [T in TableName]: UniqueKey<T> } = {\n // `entity` is in the key: two polls over different tables can agree on a cursor value.\n fact: { by: ['kind', 'entity', 'name', 'dedupeKey'], when: 'dedupeKey' },\n run: { by: ['reflexId', 'cause'] },\n task: { by: ['runId', 'unit'] },\n state: { by: ['reflexId'] },\n};\n\nexport type Comparison<V> = {\n eq?: V;\n ne?: V;\n lt?: V;\n lte?: V;\n gt?: V;\n gte?: V;\n in?: readonly V[];\n notIn?: readonly V[];\n isNull?: boolean;\n};\n\nexport const COMPARISON_OPS = ['eq', 'ne', 'lt', 'lte', 'gt', 'gte', 'in', 'notIn', 'isNull'] as const;\n\nexport type Where<R> = { [K in keyof R]?: R[K] | Comparison<R[K]> };\n\nexport type Order<R> = readonly { by: keyof R & string; dir?: 'asc' | 'desc' }[];\n\nexport type QuerySpec<T extends TableName = TableName> = {\n table: T;\n where?: Where<TideTables[T]>;\n order?: Order<TideTables[T]>;\n limit?: number;\n};\n\nexport type Mutation<R> = { [K in keyof R]?: R[K] | { inc: number } };\n\nexport type ClaimSpec<T extends TableName = TableName> = {\n table: T;\n where?: Where<TideTables[T]>;\n order?: Order<TideTables[T]>;\n limit: number;\n set: Mutation<TideTables[T]>;\n // At most one row per value of `column` is held at a time, counting rows\n // matching `held` that an earlier claim took. Applies to the values in\n // `only`; every other value claims freely.\n onePer?: { column: keyof TideTables[T] & string; held: Where<TideTables[T]>; only: readonly string[] };\n};\n\nexport type RemoveSpec<T extends TableName = TableName> = {\n table: T;\n where?: Where<TideTables[T]>;\n};\n\nexport type TideStore = {\n transact: <T>(fn: (tx: TideStore) => Promise<T>) => Promise<T>;\n\n appendIfAbsent: <T extends TableName>(\n table: T,\n row: Omit<TideTables[T], 'id'> & { id?: string },\n ) => Promise<TideTables[T] | undefined>;\n\n claim: <T extends TableName>(spec: ClaimSpec<T>) => Promise<readonly TideTables[T][]>;\n\n cas: <T extends TableName>(\n table: T,\n id: string,\n expect: Where<TideTables[T]>,\n set: Mutation<TideTables[T]>,\n ) => Promise<boolean>;\n\n query: <T extends TableName>(spec: QuerySpec<T>) => Promise<readonly TideTables[T][]>;\n\n // Removing a run removes its tasks.\n remove: <T extends TableName>(spec: RemoveSpec<T>) => Promise<number>;\n};\n\nexport type { Reflex, ReflexInput, FactInput };\n"]}