Files
sim/package.json
Waleed bc8f09ccb1 feat(workflow-code): workflows and workspace as code (#10129)
* test: type the MCP base address the concealment check compares

* fix(workspace-code): check file path collisions on a segment tree, not a map of every prefix

Keeping every folder prefix of every path still held about a million prefix strings for
20,000 deep paths. A tree of folded segments costs one fold per segment and holds each
segment once, so the depth cap is no longer needed.

* refactor: drop the exports of isSuspiciousCharacter and readFolderWritten, used only in their files

* docs(workflow-code): CI needs a personal key; document workspace-key E_APPLY_FORBIDDEN and --only

workflows.source.apply and create deny workspace API keys, so the CI guidance now asks for a
personal API key or an OAuth login. Workspace as code names the kinds a workspace key cannot
write (workflows, skills, secrets, deployments), the E_APPLY_FORBIDDEN refusal, and narrowing
an apply with --only.

* docs(workflow-code): link the code pages from workflows, CLI, getting started, API and MCP

Adds a For coding agents section to Workflows as code (get, edit, check, status, apply, starting
from .sim/AGENTS.md), a prefer-source note on the API build guide, and an MCP section on editing
a whole workflow with getWorkflowSource and applyWorkflowSource.

* docs(self-hosting): document the WORKFLOW_CODE preview flag

Adds a Preview features section with WORKFLOW_CODE and links it from the in-preview callouts on
the workflows and workspace as code pages.

* feat(workflow-code): Code tab header with Preview label, CLI copy and docs; Download as code

The Code tab gets a title row: a Preview badge, a button copying
sim workflows source get <workflowId> --dir ./<workflow-name-slug>, and a link to the docs.
The workflow menu gains Download as code beside Export workflow, saving the draft as the
single TypeScript file the Code tab shows (function code inline). The download revalidates the
cached source by ETag first, so an edit since the tab last read is never missed.

* chore(rules): load the workflow-code rule for the v2 source routes, contracts and staging cleanup

* feat(llms): list workflows as code in llms.txt

* docs(cli): workflows and workspaces as code in the README, help epilogue and source group descriptions

Adds a README section (get, check, status, diff, apply and the coding-agent loop), a source get
example to the root help, and describes both source groups as read and apply, marked (preview)
while the server flag gates them. Regenerating the CLI docs changes nothing: the pages list each
command, not group descriptions or the root epilogue.

* test(workspace-source): a re-run adopting a stopped MCP replace with stored() headers still needs an admin

A workspace key re-running an interrupted replace is refused with E_APPLY_FORBIDDEN, the
owner's re-run finishes it, and a read-only member's get prints the adopted server's
literal headers as stored().

* feat(workflow-code): roll the workflow-code flag out by organization, workspace or user

Every source use case, the Code tab layout and useFeatureFlag now evaluate
workflow-code against the workspace, its organization and the acting user,
so AppConfig orgIds/workspaceIds/userIds allowlists take effect. Adds the
rollout plan to the workflow-code design doc.

* feat(mothership): grant the workflow-code entitlement where the source commands run

computeEntitlements now sends workflow-code to the worker for a workspace or
organization chat whose rollout has the flag on, ahead of the worker's
ENTITLEMENTS enum (the wire accepts any name). The CLI inventory marks every
workflows source and workspaces source command with entitlement: workflow-code
so the worker can hide them once it reads the field.

* docs(api): say how workspace source blobs are staged, and that dryRun previews

The applyWorkspaceSource description pointed MCP readers at Stage Workspace
Source Blobs, a multipart route MCP does not expose; it now names the CLI and
the blob upload route. The MCP write tool no longer claims no write can be
previewed: the source applies take dryRun.

* feat(analytics): record workflow source reads and dry runs, and workspace source applies

Adds workflow_source_read, workflow_source_dry_run and workspace_source_applied
beside workflow_source_applied: same attribution, kinds and counts only. A
refused dry run is now a dry-run event, never an apply.

* docs(workflows): commit written.json and point workspace CI to its own section

* test: read the MCP server URL as nullable in the stopped-replace check

* test(workflow-code): resolve the workspace before the flag in the HEAD 403 check

The flag now needs the workspace's organization, so the read routes resolve
the workspace first; the test gives them one to resolve.

* test(analytics): one workspace_source_applied per apply, refused, partial or committed

Busy, rejected and partial applies each record exactly one event with their
outcome, the committed retry one more, and a dry run none.

* fix(cli): resend a rate-limited GET even when its response body is lost

Cancelling an errored body rejects, so a 429 whose body was lost threw the raw
stream error instead of resending.

* fix(tests): order the workspace source "nothing was written" snapshots by id

The snapshots compared before and after a refused apply selected rows with no
ORDER BY, so their order was whichever index the planner chose: on the
workflow table the sort, unique-name and workspace_id indexes each return a
workspace's rows in a different order. Once autovacuum analyzed the table
between the two reads the plan could change, and the cross-kind test failed
with equal rows in a different order. Forcing the second read off index scans
reproduced the exact failure; ordering by id makes the comparison
plan-independent.

* refactor(source): one vocabulary for the fingerprint of what the server stores

PlannedChange.serverFingerprint is storedFingerprint and KindAdapter.fingerprintNow is
storedFingerprintNow; the workflow adapter's currentFingerprint() is readStoredFingerprint;
the sf1: helper in print-stored is storedSourceFingerprint, beside the kinds' rf1:
storedFingerprint; the workflow apply's local and EvaluatedSource field are storedFingerprint,
as source-commit already named it. The 409 wire field currentFingerprint is unchanged.

* fix(workflow-sdk): the workspace runtime exports defineSecrets and defineCredentials

secrets.d.ts and credentials.d.ts declare them and the cookbook imports them, but the
runtime entry did not export them, so running such a file failed with 'export not found'
instead of SimSdkNotExecutable. codeFile now re-exports core's stub, as tool.d.ts declares.
A test keeps the runtime's exports equal to every value the declarations declare.

* fix(workspace-source): re-scan deletes for new users under the apply lease

The plan's in-use scan ran before the lease, so an apply that saved a workflow
using a resource another apply was about to delete went unseen: the deleting
apply took the lease and deleted anyway. The apply now scans its deletes again
once it holds the lease and refuses (E_APPLY_STALE, nothing written) a delete
that a workflow the plan did not find now uses; a scan timeout still fails
closed.

* fix(cli): take a stale source-directory lock over safely, never through a link

Two commands that found one lock stale could both remove it: the later one's
removal deleted the live lock the first had taken, admitting two writers. A
takeover now claims the stale lock folder it removes (only one command can) and
checks it is still stale first, so a lock that replaced it is left alone.

The lock path also bypassed the source directory's symlink checks: a .sim or
command.lock that is a link was followed. Both are now refused
(SOURCE_SYMLINK) before the lock is created, read or removed.

* fix(cli): workflow commands in a workspace folder hold the workspace directory lock

A single-workflow apply, create or get inside workflows/<key>/ of a workspace
directory rewrites the workspace's written record and base, but took no lock, so
it could interleave with a workspace command (or another folder's) and lose a
record. These commands now hold the workspace directory's command lock for the
whole command, refused like a workspace command (SOURCE_DIR_BUSY, exit 10)
with nothing read or written.

* fix(cli): status recommends commands in its own scope, with --allow-delete for dropped data

The command workspaces source status recommended dropped the scope it was asked
for: status --only tables suggested an apply of every kind, and a status pointed
at a workspace with --workspace suggested one at the profile's. Every
recommended command now carries --only and, when the target is not the
profile's default, --workspace.

It also asked for --allow-delete only for whole-resource deletes, so an update
that drops a column was suggested without it and refused. It now uses the same
destructive count the apply prints.

* fix(cli): an apply that reprints a tool as stored() removes its old code file

When the server keeps a tool's code as stored() (it holds a credential), the
apply reprints tools/<key>.ts without tools/<key>.js, but saving the answer
left the old .js and its digest behind, so the next apply failed with
E_TOOL_CODE. Saving an apply now removes, from disk and the written record,
every text file the directory sent for a reprinted resource that the reprint no
longer holds (workflow folders keep pruning by lock).

* refactor(table): move cell value rules into @sim/workspace-code/table-cells

The per-type coerce/validate/salvage/equality rules, the row loops (required
cells, coercion policy, batch unique scan) and the pure date, currency, ttl and
select helpers move from apps/sim/lib/table into the workspace-code package
(timezone helpers into @sim/utils/timezone). The column-type registry spreads
CELL_RULES into each definition and validation.ts delegates, so there is one
implementation. The workspace source table adapter refuses declared rows with
refusedTableRows, which the CLI can now run offline.

* feat(sim-cli): workspaces source check validates table rows files offline

Each tables/<key>.rows.jsonl (managed or seed) is read against its declaration
and checked with the write's own rules (refusedTableRows): a malformed line, an
undeclared column, a managed key two lines share, an empty required cell, a
unique value two rows share, a value its column's type or options cannot hold.
Each is an E_TABLE_ROWS error at its line.

* fix(workspace-source): credential adoption never takes a credential from a key bound outside source

* test(workspace-code): assert linear growth, not a wall-clock budget, for hostile inputs

The file-grouping test asserted 20,000 deep paths group within 6 s and took 7.2 s
on a CI runner. It now counts the characters case folding reads at depth 100 and
400 (about 4x linear, 15x for the per-prefix fold it guards against), which no
machine load changes. The two compile tests with a 3 s budget (JWT pattern,
numeric precision) now compare the fastest of three runs at n and 4n: reverting
either fix gives about 15x against a bound of 9.

* fix(table): a seed reshape refuses a table that gained rows since the plan saw it empty

* fix(table): a keyed row write inside a reshape runs at the bulk-write statement timeout

* fix(workspace-source): hold the apply lease from before the plan, not only the writes

An apply planned before taking the lease, so another apply could write between
its plan and its writes: the first then wrote half of itself and failed
(E_NAME_TAKEN, E_APPLY_STALE), or deleted a resource a workflow had just
started using, because its in-use check had run before the other apply's save.
A non-dry-run apply now takes the lease first and plans and writes under it, so
a second apply is refused SOURCE_BUSY before it reads anything. This replaces
the post-lease in-use re-scan, which covered only deletes. Dry runs still take
no lease; the per-write lease confirm and stored-fingerprint re-checks stay for
UI edits, which the lease does not order.

* fix(workspace-code): literal-secret findings carry a span but no code frame

E_MCP_LITERAL_SECRET, E_DEPLOY_SECRET, W_TOOL_LITERAL_SECRET and the workflow
W_LITERAL_SECRET framed the line holding the secret, echoing it over v2 and MCP.
They keep their span; the finding cap and the server locator drop the frame too.

* fix(workspace-source): a secret declared without a description records no base entry, so it is never falsely stale

* test(workflow-code): time hostile inputs with Date.now, repeated past the clock's resolution

The package has no Node or DOM types, so performance is not declared. Each
growth timing now repeats the work until it spans 25 ms, so millisecond steps
do not swing the ratio.

* fix(workspace-code): an env reference or helper call is never read as an object

headers: env.TOKEN parsed with no finding into a header named $env, and
defineTable(column.string()) reported the encoding's $call/args fields. Both
now get one finding that names the value and how to write the object.

* feat(workflow-code): mixed-script block names, workflow inputs, env hint target

- E_LOOKALIKE_NAME also refuses a block name with a word mixing Latin with
  Cyrillic, Greek, Armenian or Cherokee letters (Unicode script property, no
  confusables table), naming the code point; W_ when the block is stored.
- startInputs and INPUT_TRIGGER_TYPES (shared with apps/sim) read a workflow's
  Start trigger inputs; W_CHILD_INPUT_UNKNOWN and W_CHILD_NO_START join the
  vocabulary for the CLI's offline child-call check.
- CompileInput.envDeclaredIn points a W_ENV_UNKNOWN hint at secrets.ts.

* feat(sim-cli): workspaces source check covers skills, child inputs and workspace.d.ts

- skill('<key>') is checked against skills/ like every other kind; a key with
  a non-ASCII letter names its code point and script.
- A child workflow call is checked against the child's Start trigger in the
  same directory (W_CHILD_INPUT_UNKNOWN, raised on new blocks; W_CHILD_NO_START).
- A get keeps the server's resource manifest beside workspace.d.ts, and check
  regenerates workspace.d.ts from it and the directory's declarations, typing
  new keys and each workflow's inputs without a request.
- Did-you-mean hints on E_MAT_UNKNOWN_RESOURCE, W_TABLE_UNKNOWN_COLUMN and
  W_ENV_UNKNOWN (which points at secrets.ts); a warning raised to an error no
  longer says it is kept as written.
- check --help lists every kind it checks.

* fix(workspace-code): check the option cap before a linear duplicate scan; pin a duplicate column to itself

A select's repeated-option scan was quadratic and ran before the maxOptions cap:
80k options took 7 s per parse (now ~0.1 s). E_TABLE_DUPLICATE_COLUMN spanned the
whole defineTable argument instead of the second column.

* perf(workspace-code): group a status's changed files in linear time; key server findings by code

localResourceChanges copied the kind's array per file: 40k files took 3.3 s.
SERVER_FINDINGS is now checked against WorkspaceDiagnosticCode.

* perf(workflow-code): print a fill in linear time by advancing an offset

printFill re-spread the remaining parts for every content/separator pair, so a
number-only array printed in quadratic time (40k numbers took 17.5 s). The rest
of the fill is now queued as the same parts from a later offset.

* fix(workflow-code): refuse a tool param or operation option the builder pins

A tool builder's fixed params and the operation option overwrote the method's
pin silently, so the tool stored an operation the method contradicts and printed
back as raw(). Report E_FIXED_PARAM, as the block path does.

* refactor(workflow-code): look a tool's builder up once

toolBuilderPath found the builder, returned its path, and compileToolCall looked
it up again behind an early return that could not fire.

* fix(workspace-code): cap knowledge document findings apart from knowledge.ts's own

Document findings were uncapped and counted against the field reporter's
100-finding budget, so the declaration's own findings became E_LIMIT_EXCEEDED.
The field reporter now counts only what it appends.

* fix(workspace-source): a workflow delete is fingerprinted only once its live triggers are counted

* fix(workflow-code): exclude a retyped block from rename inference by its own id

A retype matched by lock ident (or against a prev block the canvas renamed)
excluded the prev block under the new key, not the one it retyped, so another
new block of the old type could inherit the old id, its run history and its
webhook. Record the retyped prev id and exclude that.

* fix(workspaces): a key claim that loses a concurrent race refuses with 409 or retries, never a raw 23505

claimResourceKey read the key with select-for-update, but an unheld key has no row to lock, so a
concurrent get (allocation) or claim could insert first and the plain insert failed with a unique
violation on either index, surfacing as a 500. The insert now skips on conflict and the claim
re-reads the committed winner: kept, ResourceKeyTakenError, or a retry that replaces a key the
resource was allocated meanwhile. Rebinding deletes and re-inserts so it shares the same path.

* perf(workflow-code): push identity group keys instead of re-spreading the group

Each push copied the whole group, quadratic when many unmatched blocks share a
type and parent.

* fix(workflow-sdk): new on a runtime export throws SimSdkNotExecutable; one stub for both entries

The Proxy target was an arrow function, which has no [[Construct]], so the
construct trap never ran and new t() threw a TypeError. The workspace runtime
re-declared notExecutable and seven identical functions; both entries now share
the stub in not-executable.ts.

* feat(workflow-code): x.error compiles in the handler of an onError edge

The executor returns { error: <message> } as a failed block's output when an
error edge leaves it (BlockExecutor errorOutput, block-executor.ts:738-740,
returned at :868-877). Compile accepted no such path, so the INDEX promise of
${x.error} failed with W_UNKNOWN_OUTPUT_PATH. Now x.error checks once the edges
are known: accepted with an error edge, refused with a hint to wire onError
without one. Block<O> types error in the SDK, INDEX says how the handler reads
it, and the integrations cookbook shows it.

* fix(workflow-code): compile stored() in a loop or parallel's meta.extra

The printer writes a container param holding a detected credential as stored()
under meta.extra, but compileContainer passed no keep callback, so the print
failed to compile. Keep the stored value as a regular block's extra does.

* fix(workflow-sdk): never embed a dotfile from the cookbook

WORKSPACE_COOKBOOK embedded every file on disk under cookbook/workspace, so a
.DS_Store or editor swap file would be written into every user's example
directory. The listing now lives in embedded-files.ts, shared with the drift test.

* docs(knowledge): say why an upload's processing relay is safe on every surface

* perf(workflow-code): read each node's successors once in the cycle check

stronglyConnected called successors on every step of a frame, and the caller
maps the node's whole outgoing list each time, so a block wired to many targets
cost O(deg^2). Read them once when the frame is pushed.

* perf(workflow-code): test a restored inactive value with withStoredValue

staysInactiveWithPrev rebuilt the block's whole activity inputs (every param,
the modes, the ids deploy reads) for each inactive id on each pass. Build them
once per pass and swap the one value in, tracking the pass's restores.

* fix(workflow-code): keep collapsed on inputFormat fields whose id stays inline

Canonicalize drops the editor's collapsed flag from every field, but materialize
restored it only for fields whose id moved to the lock, so a field with a shared
or missing name lost it whenever the list changed.

* feat(sim-cli): no login exits 13 with AUTH_REQUIRED

Not logged in, an OAuth login that expired and cannot refresh, and a 401 from
the server exited 1 with CLI_ERROR, the same as a source with errors. They now
exit 13 (AUTH_REQUIRED_EXIT_CODE) with the code AUTH_REQUIRED (a 401 keeps the
server's code when it sends one). A status still falls back to the local view
without a login, and its note now reads as sentences.

* fix(workflow-code): write a subflow collection holding a $sim object back unwrapped

Canonicalize and compile wrap an object with its own $sim key as a literal node,
but materialize wrote forEachItems and distribution raw into block.data and the
loops and parallels maps, so after any config change the executor iterated the
wrappers. Unwrap literal nodes there, and say so in jsonField's TSDoc.

* fix(sim-cli): source diff filters resolve against --dir; cancellation and 413 keep their exit

- diff ./, an absolute path or a path from the current directory selected
  nothing and printed "No local changes."; filters now resolve against --dir and
  one that selects no file is refused (SOURCE_PATH_UNMATCHED).
- A cancelled request carries REQUEST_CANCELLED, so status no longer reports it
  as an unreachable server; noAnswer() is the one copy of that predicate.
- workflows/workspaces source status and diff map a 413 to exit 7, as get does.

* fix(workspace-source): holding a change for one credential key keeps another key's unreachable refusal

* fix(sim-cli): an apply drops the written.json entries of the resources it deleted

The record kept every deleted resource's files, so status reported the delete
forever (exit 11) and recreating the key made get refuse with SOURCE_LOCAL_EDITS.
An entry is dropped only when its file is gone and the returned base no longer
holds the resource or blob, so a held or failed delete stays retryable.

* fix(workspace-source): a chat auth type source cannot name leaves the deployment out instead of reading as public

* perf(workflow-code): bucket wiring and order dependencies by scope once per print

Each scope's wiring rescanned the members of every enclosing scope and refiltered
their edges by edgeScope, and each scope's declaration order was handed every
dependency in the workflow: O(scopes x blocks). Bucket edges by the scope they
print in, and dependencies by the scope they order, in one pass.

* fix(workspace-source): file creates of one name check every key they may take, and a lost key claim refuses the create

* perf(workflow-code): memoize buildFieldIndex and group pair members in one pass

The index was rebuilt for every block in print and compile and for every tool,
and each canonical pair rescanned every subBlock for its members: O(pairs x
subBlocks) per call. Group the members once, and memoize the read-only index by
block, trigger mode and pinned ids.

* refactor(workflow-code): sort compiled edges with canonicalize's compareEdges

Compile kept its own copy of the comparator, and the CWM edge order is hashed
(canonicalHash), so two copies could drift.

* chore(workspace-source): unexport WorkspaceSourceChange, used only in its own file

* docs(workflow-code): move compileRegularBlock's TSDoc onto it

It sat above BlockShape's own TSDoc, documenting nothing.

* fix(workspace-source): the staging sweep removes objects before their rows, keeping a row whose object survived

* docs(workflow-code): describe LoopSpec as canonicalize reads it

The TSDoc said the spec is the loops map's config and that canonicalize never
fills defaults; loopSpec reads block.data first, never takes the map's count,
and falls back to a for loop of 5.

* refactor(workflow-code): stop exporting ConfigItem

Nothing imports it; it is only printedConfig's item type.

* refactor(workflow-code): read pinned values and the catalog block once

compileMetaParams rebuilt the map of every stored value once per pinned id, and
needsTodo looked the catalog block up twice though collectParams already holds it.

* fix(table): a reshape resolves each column update to its id, so a by-name swap renames both

* fix(workspace-source): a get leaves out a secret named __proto__ instead of printing an unapplyable secrets.ts

secrets.ts printed every stored secret, but the declaration reader refuses a
__proto__ key, so after a get the whole file stopped applying. The secret is
now listed in skipped.json with the reason; MCP header names the reader refuses
already round-trip-fail into skipped.

* perf(sim-cli): a status past one dry run prunes its whole read instead of walking the directory again

When the workflow folders exceed one dry run, status read the directory a
second time: a second walk, read and hash of every file. It now prunes the
unchanged folders from the read it already made.

* perf(sim-cli): workspaces source apply walks the directory once, inside its lock

assertWorkspaceDir walked every kind folder outside the lock before
readWorkspaceDir walked it again; the apply now checks the read it made and
runs the full check only to refuse. orphanedWorkflowFiles groups the answer's
paths by folder once instead of per lock, assertBaseWorkspace reuses
baseWorkspaceOf, and printPlan no longer shadows counts.

* fix(sim-cli): --only reads past an empty segment instead of refusing an unnamed kind

* refactor(workspace-code): un-export four unused types, name the skill locator apart from a line's offset, fix two TSDocs

* feat(workspace-source): an existing column becomes required in the same apply as the managed rows that fill it

* perf(workspace-source): list MCP servers' tools concurrently while planning tool references

* perf(workflows): a batched source read prints its workflows concurrently

* fix(workflow-types): hold a container's edges to the handle they leave from

A loop or parallel's start handle connects only into the container, and any other
handle never does. The shared scope rule ignored the handle, so the editing engine
kept a start edge to a block extracted from the loop (and an end edge to a block
moved into it): edges the canvas never draws and workflow source refuses
(E_EDGE_SCOPE), so such a workflow could not be applied back from its own source.

* fix(editing): refuse an error edge from a block with no error output

The engine accepted an 'error' handle on any block, so a trigger or a loop or
parallel container could store an error edge the canvas has no port for and
source cannot write (E_ERROR_PORT_UNSUPPORTED). It now follows the source
catalog's errorPort rule.

* fix(editing): normalize row ids only on fields declared as row lists

Row-id normalization keyed on the subblock id alone, so any field that shares an
id with a table field (supabase's JSON code 'params', 'metrics', 'headers',
'variables') was coerced to a row list: a JSON object or code text was replaced
by [] and the value lost. It now applies only where the block declares the id as
a row-list type.

* fix(workflow-code): keep the pair member a trigger-mode pair's mode does not select

Deploy reads every member of a trigger-mode pair, so the inactive-param restore
never brought back the member the mode does not select. An unchanged apply of a
block toggled into trigger mode dropped that member's stored value, and editing
the selected member dropped the other one. The pair's value is now its
mode-selected member's, and the other members keep their stored values, as on
the canvas.

* fix(workflow-code): write only the subflow config fields an edit changes

Canonicalize fills a loop's count (5) and the collection and conditions the
subflow map holds when block.data omits them; a changed config wrote all of them
back, so renaming the block a loop condition reads also stored count, collection
and condition fields nobody edited. Fields equal to the stored config keep their
stored spelling, absence included.

* fix(workflow-source): compile a block renamed in source against the block it continues

Compile matched the stored block by key, while materialize keeps a renamed
block's id through its ident (lock-ident). Renaming a block in source therefore
refused its stored() secret (E_STORED_VALUE_MISSING), turned a stored cycle into
E_EDGE_CYCLE, and reset fields source never writes (a note's color) to their
defaults. compileSource re-keys the stored model to the source's renames and
compiles again.

* refactor(sim-cli): name what source helpers do and fix their docs

- mergedGitattributes merges .gitignore too: withMissingLines.
- isMissing reads the code through errorCode, not a cast.
- workflows source check calls workspaceFolderOf directly.
- Exit codes 5, 6 and 7 document workspaces source as well.
- workflows source resources lists MCP servers; any source get writes it.
- Two TSDocs a reflow mangled.

* perf(workflow-persistence): read only live in-workspace graph rows in a batch load

loadWorkflowsFromNormalizedTablesRaw read every block, edge and subflow row of every requested id,
then dropped the ones outside the workspace, and kept archived workflows the read snapshot
discarded afterwards. Each graph query now filters by the live in-workspace ids as a subquery.
Measured on 100 live + 300 archived workflows of 30 blocks: loadWorkflowReadSnapshots median
579ms -> 151ms.

* perf(workflows): one credential lookup for a batch load's block migrations

loadWorkflowsFromNormalizedTables ran each workflow's block migrations serially inside the
REPEATABLE READ snapshot, and the credential-id migration queried once per workflow holding a
legacy account id. The batch now prefetches the credential ids for every workflow's legacy ids in
one query, and only queries again for an id a migration surfaces that the prefetch did not ask
about, so the result is unchanged: N serial round trips become one.

* fix(api): one ETag revalidation path; tagged v2 bodies are revalidated, and cached per request

- ifNoneMatchSatisfied was copied in the internal and v2 JSON builders; definition.ts now owns
  entityTagMatches and notModifiedResponse.
- The v2 builder answered a tagged 200 and its 304 with private, no-store, which forbids keeping
  the body the ETag exists to revalidate. Both now say private, no-cache, as the internal one did.
- The v2 validated-body LRU was keyed by the tag alone and served across principals and inputs,
  though present() reads the parsed request. It is keyed by tag and parsed request now, and
  entityTag documents that it must be a strong validator of the result for every caller.
- The internal builder's HEAD branch re-checked a missing authorize() that definition-time
  validation already refuses; it captures the authorize phase once instead.

* fix(workflow-sdk): codegen uses its layout helpers; INDEX.md lists legacy builders only when there are some

- generate.ts builds block, models and index paths from layout.ts; blockTypesFile
  leaves the barrel; layout.ts reads TOOL_NAMESPACE.
- @when names both fields of an and clause.
- typecheckSdkDirectory spreads SOURCE_COMPILER_OPTIONS.
- The cookbook declares ORDERS_API_KEY, which its tool reads, and says a new
  query string updates an MCP server in place; column.ttl() says one per table.
- Doc fixes: arrayOf, declaredBlockTypes order, core.d.ts names tsc.

* fix(schedules): a written zero is an invalid schedule field, not a missing one

The reason classifier read fields through getSubBlockValue (value || ''), so a numeric 0 counted
as empty. It now checks undefined, null and '' explicitly.

* docs(environment): state the non-empty invariant both env paths share

* chore(scripts): name the pure package an offender is in, not always workflow-code

* refactor(chat-deployments): one identifier-ownership check, and one live-chat read per replace pre-check

* refactor(workflows): the code tab names its directory with the shared slugify

* refactor: keep types no other module imports private

* refactor(workflows): drop the field-by-field source apply presenter

The response schema already strips the result's internal fields, so both routes present the
result as it is.

* refactor(workspace): the workflow-code flag is required of every flags producer

* refactor(utils): one mapWithConcurrency, with documented failure semantics

apps/sim had its own mapWithConcurrency next to @sim/utils/concurrency's, with different failure
semantics: it rejected through Promise.all as soon as one item failed while its other workers kept
starting items nobody awaited. Every caller now uses the @sim/utils one: after a failure no item
starts, and the first failure is thrown once the running items settle, so nothing the batch began
is still running when the caller handles it. mapSettledWithConcurrency (attempt every item, keep
each outcome) moves alongside it. createConcurrencyLimit, MATERIALIZE_CONCURRENCY and
waitWithAbort stay in apps/sim.

* perf(workspace-source): a knowledge plan never downloads a document named in neither the base nor the directory

* docs(workspace-code): CI commits back what apply rewrote, tsc step, Gmail provider

- The scripting.mdx CI job runs tsc after check (which regenerates
  workspace.d.ts), and on merge commits back the files the apply rewrote, with
  [skip ci] and contents: write; a protected branch opens a pull request instead.
- workspace-code.mdx says what check now covers (skills, child inputs, rows,
  workspace.d.ts).
- The cookbook credentials.ts shows Gmail's provider id, google-email (the id
  apps/sim/lib/oauth/oauth.ts registers for Gmail).
- The docs baseline records the changed CI fence.

* docs(cli): regenerate the CLI reference for the check help and exit 13

* test(api): the source catalog's tagged 200 is private, no-cache

* fix(workspace-source): a renamed or name-taken stored() tool reports only that, not a missing stored tool

* fix(workspace-source): a deleted chat's base no longer records its password variable

* fix(table): reshape audit entries name columns, never their ids

* refactor(workflows): drop the never-filled SourcePlan.notes, share the stale message, and read a rename's folder from the loaded workflow

* refactor(source): one managed-row key, one tool-input field list, and no unreachable fallbacks

* docs(source): gated manifest sections, the required-column 400, carried tags and the manifest limit

* chore(source): regenerate the v2 OpenAPI and MCP operations for the documentation changes

* test(workspace-code): bound the option-cap and status-grouping fixes by n vs 4n growth, not wall clock

The ratio helper is exported from @sim/workflow-code/scaling.test-helpers so
other packages' scaling tests share it.

* fix(workflow-code): x.error is a string in a JSON field

The executor's error output is the failure message, so a reference to it in a
JSON body (response, API body) is stored quoted, as compile and print decide
through refValueKind; bare, a message would break the JSON.

* refactor(workspace-code): rowKeyText reads any cell value, so the table row writer shares it

* chore: drop the apply wire type no module reads, and shrink the non-null baseline the batch load cleared

* test(workspace-source): the cookbook apply test holds the Gmail credential the cookbook declares

* fix(workflow-code): keep a stored field the printer left out as inactive

Compile fills an omitted param with its default, then keeps the stored value only
when the field is inactive, judged with the default in place. A standalone
advanced field runs once non-empty, so a stored '' choice (cloudflare's 'Active
only' certificate filter) read as active under the default and every apply
replaced it with 'all'. Inactivity is now judged with the stored value.

* refactor(utils): point the merged mapWithConcurrency callers at @sim/utils

* test(workflow-source): prove canvas, JSON API and source stay in lockstep

A seeded fuzz applies random sequences of real editing-engine operations (add,
delete, move, edit fields, connect, disconnect, insert into and extract from
loops and parallels, rename, enable, retype, trigger and advanced mode, loop
config, variables) to corpus workflows, then asserts the source of the result
applies back as a no-op and one random source edit changes exactly that field.
Failures shrink to a one-minimal edit list. Every registry block type is added
(or, for legacy and single-instance types, edited) with non-default values in
each subblock kind it has. Each divergence fixed on this branch keeps a minimal
regression. The integration suite runs the full stack on Postgres: JSON write,
editing operations, source get and apply, JSON read, and a canvas-built workflow
against the one created from its source.

* chore: drop exports the cell-rule move left unused; move the timezone baseline entry

* chore(audits): count staging's new integration double-cast in the merged ratchet

* test(workflow-source): satisfy the audits in the fidelity suites

* test(workspaces): wait with the shared sleep helper

* fix(cli): recover a command lock abandoned before its owner was recorded

The takeover claim inside the lock refreshed the lock folder's mtime before
the staleness re-check, so a lock with no owner.json never read as stale and
every command returned SOURCE_DIR_BUSY. Judge an unrecorded lock's age from
the sighting taken before the claim, and guard against a replacement lock by
checking the folder is still the one seen (dev/ino) and still stale.

* chore(helm): bump chart to 1.11.22 for the source-staging cleanup cron

* fix(workspace-source): match managed row keys after their column's coercion

planRows compared declared key cells with stored ones before coercing them,
so a number key written as "007" counted the stored row 7 as removed and the
apply refused without --allow-delete, though the keyed write coerces "007"
to 7 and matches it. Coerce the declared key with the key column's cell rule
(the reject policy a keyed write uses) before matching.

* fix(workflow-code): print a JSON code field in meta.extra as its stored text

An advanced JSON code field the serializer still forwards under an operation that
hides it prints under meta.extra, which compile reads verbatim. It printed as an
object literal, so compile stored a native object and an unchanged apply rewrote
the stored text (minified, or not at all equal when it held references). It now
prints as text there; only a builder param takes the literal form.

* fix(workflow-source): keep a block keyed __proto__ in the lock and hints

buildLockFromState, hintsFromSourceMeta and printStoredSource assigned by bracket,
so a block whose name normalizes to __proto__ set the prototype instead of an
entry: it vanished from the lock, and renaming it in source lost its identity
(compile treated it as new and reset its unwritten fields).

* test(workflow-source): regressions from the long fidelity run

A JSON field forwarded under a hiding operation, a block keyed __proto__, and the
by-design collision-key refusal the fuzz now leaves out.

* fix(cli): workspaces source status and diff refuse a directory holding no workspace source

A mistyped --dir, an empty directory, the wrong working directory (--dir
defaults to .) or a workflow folder read as clean: status exited 0 after a
dry run of no kinds, and diff printed "No local changes.". They now refuse
it with the reason and the get to run, as apply and check do.

* fix(cli): status recommends the get that restores a removed kind folder, not an apply

Removing a managed kind's folder or root file (tables/, secrets.ts) stops
managing the kind: an apply leaves its resources alone. status reported its
recorded files as deleted and recommended apply --yes, which wrote nothing, so
the next status said the same thing again (exit 11 forever) while get refused
to write the files back. When every local change is in such a kind, status now
recommends get --only <folders> --force, which restores them, and says how to
delete the resources instead.

* fix(utils): mapWithConcurrency throws the first failure in time

The shared helper threw the failure of the lowest-numbered slot, so a slow
slot-0 error masked an earlier one from another slot. The apps/sim helper it
replaced (Promise.all) threw the first failure, and the TSDoc still promises
that.

* fix(cli): workspace source commands handle a directory no one may write

Every workspace source command takes the directory's lock by creating
.sim/command.lock, so in a read-only checkout status, diff and apply --dry-run
crashed with a raw EACCES stack trace. Commands that only read (status, diff,
a dry run) now run without the lock there, since nothing can rewrite the
directory; get, check and apply are refused as SOURCE_DIR_UNWRITABLE with the
reason.

* fix(cli): status refuses a broken .sim/written.json instead of calling every file created

A merge conflict that leaves markers in .sim/written.json (two branches that
each applied) made status read every file as created and recommend an apply.
It now refuses with SOURCE_WRITTEN_INVALID and names the get that rewrites the
record. A broken .sim/base.json names its way out too (SOURCE_BASE_INVALID).

* docs(cli): status and diff help name exit 7, and the workflow guide exit 13

status and diff exit 7 when the server refuses the source as too large (413),
as exit-codes.ts documents, but their help listed only 0, 11, 12 and 1. The
workflow directory's .sim/AGENTS.md now names exit 13 (not logged in) as the
workspace guide does. CLI docs regenerated.

* fix(executor): splice already-escaped values into JSON strings as written

Escaping every reference landing inside a JSON string literal fixed values that
broke the JSON (quotes, newlines, stray backslashes), but it also re-escaped
values that were already valid string content. A deployed workflow whose env
var holds a key with literal \n escapes, or that escaped a value in a Function
block to work around the old bug, now sent backslash-n instead of a newline.
Only a value that would break the literal is escaped now; one that is already
valid string content splices raw, exactly as before.

* fix(table): write every row's cancellation when one write fails

cancelWorkflowGroupRuns cancels every row's queued jobs, then writes each row's
cancelled status. The shared mapWithConcurrency starts nothing after a failure,
so one failed write left the later rows of the page 'running' with no job behind
them; the apps/sim helper it replaced still wrote them. The writes now all
settle before the first failure is thrown.

* fix(cli): count a workflow changed only on the server as unchanged in workspace status

The status dry run sends every workflow folder whole to detect drift, so the server plans an
update for a folder edited only in Sim. An apply sends that folder by its base and leaves it
unchanged, so the status plan line said 'Applying would: 1 update' for an apply that changes
nothing.

* fix(cli): an interrupted source command releases the directory lock

Ctrl-C during a workspace source command left .sim/command.lock behind. A
later command takes a lock over only when its owner ran on the same host, so
one left in a folder shared with a dev container or another machine stayed
until removed by hand (exit 10 every time). The lock is now removed on
SIGINT/SIGTERM before the signal ends the process, as a staged write's folder
already is.

* test(workspace-source): a key-claim failure trigger left by a killed run no longer breaks the next one

* fix(e2e): expire the workflow source e2e session in UTC

session.expires_at is a timestamp without a zone that the app reads as UTC. now() writes the
database's local time, so on a Postgres west of UTC the one-hour session was already expired
and the canvas-route check got 401.

* fix(cli): get keeps a directory bound to its workspace when its base does not parse

get decided which workspace a directory belongs to only from a base that
parsed cleanly, so one this CLI refuses (a field a later CLI added, a bad
fingerprint) read as no base: get then used the profile's workspace, and
--workspace naming another one was not refused (SOURCE_OTHER_WORKSPACE). It now
reads workspaceId as leniently as apply and status do.

* fix(cli): print nested source apply results as JSON in text output

`sim workflows source apply --output text` printed the modified blocks as
`modified	[object Object]`.

* test(workflow-code): alternate small and large runs in the growth check so machine load slows both sides

* fix(workspace-source): in-use scan reads the live deployment version

A delete of a resource that a deployed workflow's live version still uses,
while its draft no longer does, now warns W_RESOURCE_IN_USE naming the
live version, unless the same apply publishes the draft or undeploys it.

* fix(workspace-source): class a refused apply by the errors that refuse it

The rejected error counted and classed every error, including those of
changes the plan holds back, which refuse nothing. The plan now returns
the refusing errors (plan-level plus non-held changes) and the error
classes from those.

* fix(workspace-source): a key taken after a committed write reports the write

A key claim that found the key held by another live resource after the
write committed threw, dropping the written resource from applied. write()
now returns it with E_NAME_TAKEN; the apply records it as applied, keeps
the base entry unchanged, and stops so no later write resolves the key to
the other resource.

* test(workspace-source): per-process source slot refuses past its cap with 429

* fix(cli): check table row columns when the row holds a non-string reference

Compiled row data stores a non-string reference bare ("n": <score.value>), which JSON.parse
refuses, so check skipped the whole row: an unknown column or select option in any row writing a
number, boolean or object output went unreported. Parse it as a JSON field instead.

* feat(workflow-code): hint api for http.request and fn for javascript.* builders

An agent guessing the HTTP request block as http.request got E_UNKNOWN_BUILDER with no hint:
no edit distance reaches api.

* docs(workflow-code): correct workspace-key, rows, written.json and create claims; fill agent-guide gaps

- credentials bind with a workspace API key; secrets and deployments do not (guide, CI docs, API description)
- table rows are source when a table opts in; list rows.jsonl and the limits
- .sim/written.json is committed, not gitignored; drop stale tsc sizes; exit 9
- a created-not-yet directory has no base: create --dry-run, not status
- guide: api is the HTTP block, W_* print as error in check, self-hosted apiKey, promote setup

* test(workspace-source): a key-claim failure trigger left by a killed run no longer breaks the next one

* test(workflow-code): alternate small and large runs in the growth check so machine load slows both sides

* test(workflow-code): time the block-cap round trip by thread CPU, so machine load cannot fail it

* fix(workflow-code): never print a credential through the response body form

The response(name, { body, status, headers }) form printed its fields'
stored values verbatim, so a response block holding a detected credential
(an Authorization header, a token in the body) printed the secret into the
file while W_LITERAL_SECRET claimed it printed as stored(). Such a block now
keeps its own params, where the field prints as stored(), and compile warns
W_LITERAL_SECRET when source writes one in the form.

* fix(workflow-code): check agent tool calls the way blocks are checked

compileToolCall accepted any builder as a tool (api.tool, condition.tool,
trigger.gmail.tool.poller), stored any param key unchecked, and never warned
about a literal secret, though print writes these tools as raw(tool) and
warns W_LITERAL_SECRET. A tool call now needs a builder with a tool form
(E_UNKNOWN_BUILDER), each param must be one its tool type declares
(E_UNKNOWN_PARAM with a did-you-mean, W_FIELD_NOT_APPLICABLE for another
operation's), and a literal secret warns as on a block.

SYNTAX.md and core.d.ts no longer document agent.tool() or
runWorkflow.tool(): neither is typed, and print writes such tools as
raw(tool).

* fix(workflow-code): refuse stored() and codeFile() in a loop or parallel config

compileConfig dropped any config value that was not a plain value, so
loop.forEach('L', { collection: stored() }) or a codeFile() condition
compiled silently to a loop with no collection or condition. Both are now
E_UNSUPPORTED_SYNTAX with the form to write instead.

* fix(workflow-code): give every compile finding a hint that names its fix

E_TARGET_TRIGGER, E_ERROR_PORT_UNSUPPORTED (a loop or parallel has none:
wire onError from its children), E_UNKNOWN_BRANCH in meta.branches (lists
the branches), W_VALUE_KIND (the literal form the field takes) and
E_UNKNOWN_IDENTIFIER for undefined, NaN and Infinity had no hint. The test
catalog's loop and parallel now have no error port, like the real catalog.

* fix(table): keep batch rows that keep a unique value in the DB check

batchUpdateRows excluded every batch row from each unique column's DB check and
compared the rest by the values it read before taking the value locks. A row the
batch leaves alone could take the value from a concurrent edit after that read,
so both it and the batch's writer stored the same unique value. Each column's DB
check now skips only the batch rows that rewrite that column.

* docs(tables): say add-column refuses a required column rows leave empty

* fix(cli): Ctrl-C during an apply write names what it may have done

An interrupt while the apply request was in flight exited 130 silently, so
nobody learned the write may have landed. The lock's interrupt handler (which
already releases the lock) now prints the same next step a lost answer gets,
then ends with the signal.

* fix(cli): a status without a login recommends sim login

With no login on the profile, status shows the local view (the server is
treated as unreachable) and its note says to log in, but next was
apply --dry-run, which only exits 13. next is now the login, then status again,
for workflows and workspaces alike.

* fix(cli): check offline with no cached catalog names the get that caches it

A fresh clone checked while the server could not be reached failed with the
raw "Could not reach …" and no next step. It is now CATALOG_NOT_CACHED (exit
1) naming sim workspaces source get, as a check with no credentials already
is; no login keeps its AUTH_REQUIRED refusal (exit 13, naming sim login).

* fix(workflow-code): keep meta.retry within the bounds the loader pins it to

Persistence saves a retry policy verbatim but loads it clamped (2-5 tries,
0-5000 ms, whole numbers), and canonicalize kept a well-formed policy raw.
A file writing maxTries: 10 stored 10, read back as 5, and every re-apply
of the unchanged file showed a retry change. Compile now refuses an
out-of-range policy with a hint naming the bounds, and canonicalize pins
the numbers as the loader does, so a printed policy always compiles back
unchanged.

* Revert "fix(workflow-types): hold a container's edges to the handle they leave from"

This reverts commit 62872bd29b.

* chore: regenerate the OpenAPI spec and MCP operations for the workspace-key description

* docs(cli): document exit 13 (AUTH_REQUIRED), exit 9 and the 429 resend policy

Both exited 1 before this branch. State which requests are resent (every GET and the
all-or-nothing source writes), the 6-retry count and the one-minute wait cap, in the
scripting exit-code section, troubleshooting, the CLI reference preamble, the README and the
source agent guides.

* fix(workspace-source): managed table rows guard a delete and a column renamed on the server

An --allow-delete of an undeclared managed table whose rows were written
since the base deleted those unseen edits; it is now E_APPLY_STALE. A rows
edit on a table whose declaration is unchanged while the server renamed or
removed one of its columns wrote the cells by names the table no longer
has, silently dropping them; it is now E_APPLY_STALE.

* fix(workspace-source): a stored() tool or MCP server deleted on the server stays deleted

An unchanged directory whose tool code or MCP header is stored() was
refused (E_APPLY_STALE / E_TOOL_STORED_MISSING / E_MCP_STORED_MISSING)
once the resource was deleted on the server, blocking every other kind.
It now reads as I_SERVER_DELETED like any other deleted resource.

* docs(workflow-sdk): document a child workflow's output shape

runWorkflow's result is the child's first response block output ({ data, status, headers }),
else its last block's output, so a response body field is result.data.field; a deployed parent
runs the child's deployed version. Stated in INDEX.md's How it runs, the runWorkflow TSDoc, the
agents example and the agent guide.

* fix(workflow-code): round-trip stored container edges source cannot draw

Stored workflows hold container edges the canvas never draws: a loop or
parallel start edge to a block outside it (the editing engine keeps one when it
extracts a block, and the executor runs it as the container's exit), an end edge
into the container's own child, and an error edge from a container. Source
printed the first two through p.to()/x.to() and every one through onError, and
compile refused them (E_EDGE_SCOPE, E_ERROR_PORT_UNSUPPORTED), so such a workflow
could not apply its own source back.

The printer now writes a mismatched container edge as edge() with its stored
handle, compiled with W_SUBFLOW_HANDLE_SCOPE (the warning names the exit form),
and compile keeps an error edge from a block with no error port when the stored
workflow holds it (W_ERROR_PORT_STORED). The corpus gains both edge shapes.

* fix(editing): keep a stored error edge the engine no longer adds

Since the engine refuses new error edges from loops and parallels, an edit that
re-sends a container's connections dropped the error edge it already stored.
Error edges the graph held before the batch are kept; only new ones are
refused.

* test(workflow-source): stored mismatched container edges survive every write path

The extract and move-into-loop regressions now assert the engine keeps the
edge and source round-trips it; a stored container error edge survives an
engine edit that re-sends its connections; and an integration check writes a
loop start edge to an outside block through PUT /state, edits through the
engine, and applies the source back unchanged.

* fix(workspace-source): type the in-use scan rows for the query builder

* fix(tables): accept a required column on a table with rows again outside workspace source

facb1c4f4d made every surface refuse adding a required column that existing rows
leave empty, which turned a call third-party integrations make on the v1 and v2
table APIs into a 400. The refusal is now an addTableColumn option only
workspace-source apply sets, so its plan and apply agree while the table APIs,
Copilot and undo keep staging's behaviour. Restores staging's undo hook,
OpenAPI description and contract comment.

* fix: attempt every independent side effect of a fan-out after one fails

The shared mapWithConcurrency starts nothing after a failure, where the apps/sim
helper it replaced kept starting the rest. For fan-outs of independent side
effects that left Slack targets undispatched, tombstones and cancellation
writes unwritten, stale-dispatch cancel events unsent, project file retirements
and chat image sweeps unrun. mapEachWithConcurrency attempts every item, then
throws the first failure; those callers use it.

* chore(e2e): name the workspace source e2e report variable like its siblings

WORKSPACE_SOURCE_REPORT_PATH becomes WORKSPACE_SOURCE_E2E_REPORT_PATH, matching every other
source e2e's <SUITE>_E2E_* variables; the CI http-e2e script passes the new name.

* feat(workflow-code): warn on a condition or router branch no edge leaves

W_BRANCH_UNWIRED names the branch and the wiring that fixes it. A branch the stored workflow
already leaves unwired is not reported, and check fails on it only for a block the lock does not
bind, so existing workflows keep checking clean.

* fix(workflow-code): read a Start block's untouched blank input row as no fields

Every new workflow's Start block is seeded with one unnamed string field, which execution skips,
so `get` on a fresh workflow printed `inputFormat: { '': 'string' }`. A list holding only that
starter field now canonicalizes as empty and prints `inputFormat: {}`; an unchanged apply keeps
the stored field byte for byte, and a blank field beside named ones still prints as stored.

* fix(workflow-source): fingerprint a stored workflow the same for every reader

The sf1 fingerprint hashed the reader's canonical model, which names a
credential the reader may see by key and one they may not see by id, so a
member applying source a teammate read got a false 409. It now hashes every
credential by its stored id. A credential key the reader cannot resolve,
standing where the stored workflow holds a credential they cannot see, keeps
the stored credential whatever the key (W_APPLY_CREDENTIAL_KEPT), so an
unchanged or edited teammate source applies without confirming any key.

* fix(workflow-source): refuse workflow names and descriptions v2 refuses

Source could set an empty or whitespace name, a name over 255 characters or
a description over 50,000, which v2 create and update refuse. The plan now
refuses the fields a write sets with E_WORKFLOW_META_INVALID at the header,
reading the limits from the v2 workflow contract.

* fix(workspace-source): keep unkeyed managed rows out of source, and check required fills at plan

A row the table grid's "add row" makes has an empty key cell, so a get printed it as a line the
apply refuses (E_TABLE_ROWS): get -> apply of an unchanged directory failed. Such a row has nothing
a line can match it by, so it is no longer managed: a get leaves it out of the rows file with
I_TABLE_ROWS_UNKEYED, neither rows fingerprint counts it, and the keyed write never removes it.

Making a column required trusted the declared rows to fill it even when no rows write was planned,
so a row added in the UI made the apply fail mid-reshape. The declared rows now stand for the
table only when a managed rows write is planned, and the rows that write keeps (unkeyed ones) are
checked too.

* fix(workspace-source): compare managed rows with the base under the key it recorded

Changing a managed table's rows key and editing a row in one apply was a false E_APPLY_STALE: the
server's rows were fingerprinted under the new key and compared with a base fingerprinted under
the old one. The staleness check now reads the server under the key the table is still marked by.

* fix(workspace-source): a reader's concealed MCP get applies back unchanged

A get by a member who may not rewrite headers prints every literal header value as stored(); the
plan resolved each stored() to a keyed hash, while a value that is not a credential prints (and
fingerprints) as its text, so a writer applying that directory unchanged always planned a header
update. stored() now resolves to the value as a get prints it.

* fix(workflow-source): answer a racing source rename with SOURCE_NAME_TAKEN

Two source renames onto one name in one folder both passed the name SELECT;
the second hit the unique index and answered 500. The commit now maps that
unique violation to WorkflowSourceNameTakenError, and the apply route answers
it, like the create route, with 409 SOURCE_NAME_TAKEN.

* fix(workspace-source): an unchanged file the server can no longer hand to source is a no-op

A declared file edited past the blob cap in the Files tab, or one an older file moved beside it
now takes the path of by letter case, refused the whole apply of an unchanged directory
(E_FILE_TOO_LARGE / E_FILE_PATH_COLLISION). Unchanged since the get that read it, the declaration
now leaves the file as the server has it (I_SERVER_CHANGED); a directory that changes it is still
refused.

* fix(workflow-source): report a dry run's needsRedeployment for the draft it would write

A dry run answered needsRedeployment for the draft as stored, so an edit of a
draft in step with its deployment said false and a revert said true. A dry run
that would change the draft now compares the draft it would write with the
active deployment; a no-op or refused dry run still reports the stored draft.

* fix(workflow-source): record no refused apply for a plan-only evaluation

A workspace plan or dry run evaluates each workflow planOnly, so planning a
locked workflow recorded workflow_source_applied ok:false although nothing was
applied. A planOnly run records nothing; the commit that follows records its
own outcome.

* fix(workspace-source): a knowledge document replace that stops partway resumes without losing tags

A replace uploaded the replacement under the document's own name, then carried the old one's tags
and deleted it. Stopped after the upload, the next apply deleted the old document without
carrying its tags; stopped and then edited again, the two same-named documents read as a server
change (E_APPLY_STALE) until deduplicated by hand, since nothing told the replacement from a
document uploaded twice in the UI.

The replacement is now uploaded under a name that names the old document, takes its tags, the old
one is deleted, and the replacement is renamed. The next apply finishes a stopped replace whose
replacement holds the declared bytes (tags carried, old deleted, renamed), or removes the
replacement and replaces again; a replacement left before its rename stands for its name. The
duplicate-by-hash rule this replaces is gone: an unmarked duplicate is ambiguous, as any other.

* test(workflow-code): compare n with 8n in the growth check, so allocation noise on a slow runner stays far from the quadratic bound

* fix(workflow-source): never keep a hidden credential over a key the apply binds

A credential key the enclosing workspace apply binds in the same run is not an
unknown key, so it resolves to that credential rather than keeping the stored
one.

* test(workflow-code): read and write input-format rows through their real shape in the API-built round trip

* fix(workflow-code): keep a hidden credential on a block the source renames

compileSource now returns the stored model it compiled against, re-keyed by the
source's renames, and keptCredentials pairs compiled blocks with it, so a member
who cannot see a credential can rename the block holding it.

* fix(sim-cli): offline check passes stored container error edges, cycles and branches on bound blocks

The offline check compiles without the stored workflow, so it refused an
onError on a loop or parallel and a cycle that a get printed and the server
keeps, and told the agent to delete them. compileWorkflow takes storedUnread:
an edge between two lock-bound blocks may be stored, so it reports
W_ERROR_PORT_STORED / W_EDGE_CYCLE saying an apply keeps it only if the stored
workflow holds it, and the error stays for a new block. E_ERROR_PORT_UNSUPPORTED
hints no longer say to remove the edge. W_BRANCH_UNWIRED never fails the check
on a bound block, --strict included, matching its stored exemption.

* fix(serializer): never evaluate a viewer-scoped default on the server

* fix(sim-cli): keep a downloaded workflow's stored inputs typed in workspace.d.ts

* fix(sim-cli): exit 13 when the server refuses a stored login's refresh token

* fix(workflow-code): offline check binds a block renamed in source through its lock ident

storedUnread now takes the lock, and compile counts a source block whose ident is one vacated
lock entry's as bound (lockIdentRenames, materialize's lock-ident rule, shared with
compileSource), so a renamed block's stored container error edge or stored cycle warns offline
as the server accepts it.

* fix(sim-cli): regenerate workspace.d.ts from local workflow inputs on a workflows check

A per-folder `sim workflows source check` in a workspace directory already
compiled every workflow's Start inputs for its child-call findings but left
workspace.d.ts on the stored inputs, so a parent mapping an input added to the
child since the get failed tsc with an excess-property error. It now refreshes
workspace.d.ts the way `sim workspaces source check` does.

* fix(workflows): refuse new edge cycles in the editing engine as edge_cycle skips

The edit engine (Copilot edits, v2 operations) could create an edge that
closes a cycle, which the canvas and realtime refuse and the executor
cannot run. createValidatedEdge now runs the shared wouldCreateCycle check
and reports a refused edge as an edge_cycle skipped item. Edges the
workflow already stored are exempt, so a stored cycle survives unrelated
edits and restated connections. Publishes edge_cycle in the v2 skipped-item
enum and regenerates the OpenAPI document and CLI types.

* fix(workflow-code): declare lock and base as type aliases so they fit the open generated API types

* feat(mothership): sync the workflow-code entitlement into the generated protocol

* test(workflow-source): stamp updatedAt on direct block writes so a migrate-on-read save cannot undo them
2026-11-19 12:51:01 -08:00

243 lines
13 KiB
JSON

{
"name": "simstudio",
"packageManager": "bun@1.4.4",
"version": "0.0.0",
"private": true,
"license": "Apache-2.0",
"workspaces": [
"apps/*",
"packages/*"
],
"scripts": {
"build": "turbo run build",
"dev": "turbo run dev",
"dev:sockets": "cd apps/realtime && bun run dev",
"dev:full": "bunx concurrently -n \"App,Realtime\" -c \"cyan,magenta\" \"cd apps/sim && bun run dev\" \"cd apps/realtime && bun run dev\"",
"dev:full:capped": "bunx concurrently -n \"App,Realtime\" -c \"cyan,magenta\" \"cd apps/sim && bun run dev:capped\" \"cd apps/realtime && bun run dev\"",
"test": "bun run test:scripts && turbo run test",
"test:setup": "bun run --cwd packages/sim-setup test",
"test:integration": "bun --no-env-file scripts/test-integration.ts",
"test:search-performance": "KNOWLEDGE_SEARCH_PERFORMANCE_TEST=true bun --no-env-file scripts/test-integration.ts search-latency",
"format": "biome format --write scripts && turbo run format",
"format:check": "biome format scripts && turbo run format:check",
"lint": "biome check --write --unsafe scripts && turbo run lint",
"lint:check": "biome check scripts && turbo run lint:check",
"lint:helm": "helm lint helm/sim --strict --values helm/sim/ci/default-values.yaml",
"lint:all": "bun run lint && bun run lint:helm",
"check": "bun run format:check",
"check:egress-boundary": "bun run scripts/check-egress-boundary.ts",
"check:organization-egress": "bun run scripts/check-organization-egress.ts",
"check:boundaries": "bun run scripts/check-monorepo-boundaries.ts",
"check:api-validation": "bun run scripts/check-api-validation-contracts.ts --check",
"check:api-contract-routes": "bun run scripts/check-api-contract-routes.ts",
"check:fork-dependent-coverage": "bun run scripts/check-fork-dependent-coverage.ts",
"generate:openapi": "bun run scripts/generate-openapi.ts",
"check:openapi": "bun run scripts/check-openapi.ts",
"generate:cli-api": "bun run scripts/generate-v2-cli-api.ts",
"check:cli-api": "bun run scripts/generate-v2-cli-api.ts --check",
"generate:mcp-operations": "bun run scripts/generate-v2-mcp-operations.ts",
"check:mcp-operations": "bun run scripts/generate-v2-mcp-operations.ts --check",
"generate:cli-docs": "bun run scripts/generate-cli-docs.ts",
"check:cli-docs": "bun run scripts/generate-cli-docs.ts --check",
"generate:v2-route-table": "bun run scripts/generate-v2-route-table.ts",
"check:v2-route-table": "bun run scripts/generate-v2-route-table.ts --check",
"check:canonical-index": "bun run scripts/check-canonical-index-surface.ts",
"check:cron-parity": "bun run scripts/check-cron-parity.ts",
"check:api-validation:strict": "bun run scripts/check-api-validation-contracts.ts --check --enforce-boundary-baseline",
"check:realtime-prune": "bun run scripts/check-realtime-prune-graph.ts",
"check:tool-request-boundary": "bun run scripts/check-tool-request-boundary.ts",
"check:actorless-executor-operations": "bun run scripts/check-actorless-executor-operations.ts",
"check:permission-group-enforcement": "bun run scripts/check-permission-group-enforcement.ts",
"check:integration-access": "bun run scripts/check-integration-access.ts",
"check:capability-subject": "bun run scripts/check-capability-subject.ts",
"check:principal-kind-parity": "bun run scripts/check-principal-kind-parity.ts",
"check:application-graph": "bun run scripts/check-application-graph.ts",
"generate:block-successors": "bun run scripts/generate-block-successors.ts",
"check:block-successors": "bun run scripts/generate-block-successors.ts --check",
"check:tool-registry-boundary": "bun run scripts/check-tool-registry-boundary.ts --check",
"check:tool-param-reachability": "bun run scripts/check-tool-param-reachability.ts",
"check:trigger-block-cycle": "bun run scripts/check-trigger-block-cycle.ts",
"check:import-specifiers": "bun run scripts/check-import-specifiers.ts",
"check:sql-date-binding": "bun run scripts/check-sql-date-binding.ts",
"check:pending-drop-tables": "bun run scripts/check-pending-drop-tables.ts",
"check:zustand-v5": "bun run scripts/check-zustand-v5-selectors.ts",
"check:react-query": "bun run scripts/check-react-query-patterns.ts",
"check:client-boundary": "bun run scripts/check-client-boundary-imports.ts --check",
"check:utils": "bun run scripts/check-utils-enforcement.ts",
"check:canvas-sentences": "bun run apps/sim/scripts/check-canvas-sentences.ts --require-coverage",
"check:bare-icons": "bun run scripts/check-bare-icons.ts",
"check:byok-providers": "bun run scripts/check-byok-providers.ts",
"check:icon-paths": "bun run scripts/check-icon-paths.ts",
"check:icon-path-precision": "bun run scripts/check-icon-path-precision.ts",
"check:migrations": "bun run scripts/check-migrations-safety.ts",
"check:native-typecheck": "bun run scripts/check-native-typecheck.ts",
"check:workflow-code-golden": "bun run scripts/check-workflow-code-golden.ts",
"check:source-text": "bun run scripts/check-source-text.ts",
"check:comment-hygiene": "bun run scripts/check-comment-hygiene.ts",
"check:site-urls": "bun run scripts/check-site-urls.ts",
"check:library-content": "bun run scripts/check-library-content.ts",
"check:spec-example-ids": "bun run scripts/check-spec-example-ids.ts",
"check:script-tests": "bun run scripts/check-script-test-coverage.ts",
"check:test-patterns": "bun run scripts/check-test-patterns.ts",
"check:sealed-columns": "bun run scripts/check-sealed-columns.ts",
"check:schema-mock": "bun run scripts/generate-schema-mock.ts --check",
"check:audits": "bun run scripts/run-audits.ts",
"check:skills": "bun run scripts/sync-skills.ts --check",
"check:guidance-refs": "bun run scripts/check-guidance-refs.ts",
"check:desktop-bridge": "bun run scripts/check-desktop-bridge-contract.ts --check",
"check:desktop-ipc": "bun run scripts/check-desktop-ipc-contract.ts",
"check:route-verbs": "bun run scripts/check-route-verbs.ts",
"check:unused-exports": "bun run scripts/check-unused-exports.ts",
"check:explicit-any": "bun run scripts/check-explicit-any.ts",
"check:mapper-operation": "bun run scripts/check-mapper-operation.ts",
"check:file-names": "bun run scripts/check-file-names.ts",
"check:source-conventions": "bun run scripts/check-source-conventions.ts",
"check:test-types": "bun run scripts/check-test-types.ts",
"desktop-bridge-contract:update": "bun run scripts/check-desktop-bridge-contract.ts --update",
"mship-contracts:generate": "bun run scripts/sync-mothership-stream-contract.ts",
"mship-contracts:check": "bun run scripts/sync-mothership-stream-contract.ts --check",
"billing-protocol-contract:generate": "bun run scripts/sync-billing-protocol-contract.ts",
"billing-protocol-contract:check": "bun run scripts/sync-billing-protocol-contract.ts --check",
"generate:tool-metadata": "bun run scripts/sync-tool-metadata.ts",
"check:tool-metadata": "bun run scripts/sync-tool-metadata.ts --check",
"generate:sdk-names": "bun run apps/sim/scripts/generate-sdk-names.ts",
"check:sdk-names": "bun run apps/sim/scripts/generate-sdk-names.ts --check",
"check:sdk-names-frozen": "bun run scripts/check-sdk-names-frozen.ts",
"generate:deployment-config": "bun run scripts/generate-deployment-config.ts",
"check:deployment-config": "bun run scripts/generate-deployment-config.ts --check",
"images:generate": "bun run scripts/generate-image-manifest.ts",
"images:check": "bun run scripts/generate-image-manifest.ts --check",
"check:integration-catalog": "bun run scripts/check-integration-catalog.ts",
"check:docs": "bun run scripts/generate-docs.ts --check",
"mship-tools:generate": "bun run scripts/sync-tool-catalog.ts",
"mship-tools:check": "bun run scripts/sync-tool-catalog.ts --check",
"trace-spans-contract:generate": "bun run scripts/sync-trace-spans-contract.ts",
"trace-spans-contract:check": "bun run scripts/sync-trace-spans-contract.ts --check",
"trace-attributes-contract:generate": "bun run scripts/sync-trace-attributes-contract.ts",
"trace-attributes-contract:check": "bun run scripts/sync-trace-attributes-contract.ts --check",
"trace-attribute-values-contract:generate": "bun run scripts/sync-trace-attribute-values-contract.ts",
"trace-attribute-values-contract:check": "bun run scripts/sync-trace-attribute-values-contract.ts --check",
"trace-events-contract:generate": "bun run scripts/sync-trace-events-contract.ts",
"trace-events-contract:check": "bun run scripts/sync-trace-events-contract.ts --check",
"metrics-contract:generate": "bun run scripts/sync-metrics-contract.ts",
"metrics-contract:check": "bun run scripts/sync-metrics-contract.ts --check",
"vfs-snapshot-contract:generate": "bun run scripts/sync-vfs-snapshot-contract.ts",
"vfs-snapshot-contract:check": "bun run scripts/sync-vfs-snapshot-contract.ts --check",
"generate:docs-manifest": "bun run scripts/sync-docs-manifest.ts",
"check:docs-manifest": "bun run scripts/sync-docs-manifest.ts --check",
"mship:generate": "bun run scripts/generate-mship-contracts.ts",
"mship:check": "bun run scripts/generate-mship-contracts.ts --check",
"library:covers": "bun run scripts/generate-library-covers.tsx",
"library:covers:check": "bun run scripts/generate-library-covers.tsx --check",
"skills:sync": "bun run scripts/sync-skills.ts",
"bump:npm-packages": "bun run scripts/bump-npm-package-versions.ts",
"sim": "bun run packages/sim-cli/src/index.ts",
"sim-setup": "bun run packages/sim-setup/src/index.ts",
"generate:agent-stream-docs": "bun run scripts/sync-agent-stream-docs.ts",
"check:agent-stream-docs": "bun run scripts/sync-agent-stream-docs.ts --check",
"prepare": "bun husky",
"test:workflow-sync": "bun --no-env-file scripts/test-integration.ts lib/workspaces/__integration__",
"type-check": "bun run type-check:scripts:esm && turbo run type-check",
"type-check:scripts:esm": "tsc --project scripts/tsconfig.mts.json",
"release": "bun run scripts/create-single-release.ts",
"test:scripts": "vitest run --config scripts/vitest.config.ts",
"check:agent-cli-boundary": "bun run scripts/check-agent-cli-boundary.ts"
},
"overrides": {
"react": "19.2.4",
"react-dom": "19.2.4",
"next": "16.4.5",
"@next/env": "16.4.5",
"postgres": "3.4.9",
"marked": "18.0.11",
"mermaid": "11.16.1",
"zod": "4.3.6",
"e2b": "2.62.1",
"@ai-sdk/provider-utils": "3.0.28",
"@azure/identity": "4.14.1",
"@grpc/grpc-js": "1.14.6",
"@hono/node-server": "2.1.7",
"@xmldom/xmldom": "0.8.15",
"axios": "1.20.0",
"body-parser": "2.4.0",
"deepmerge-ts": "8.0.0",
"dompurify": "3.4.17",
"engine.io": "6.6.11",
"fast-copy": "4.2.0",
"fast-uri": "3.1.9",
"fast-xml-parser": "5.12.0",
"follow-redirects": "1.16.2",
"hono": "4.13.18",
"image-size": "2.0.4",
"ip-address": "10.7.4",
"postcss": "8.5.32",
"prosemirror-model": "1.25.12",
"prosemirror-state": "1.4.4",
"prosemirror-transform": "1.12.4",
"prosemirror-view": "1.42.6",
"protobufjs": "7.6.5",
"proxy-addr": "2.0.8",
"qs": "6.16.1",
"shell-quote": "1.12.0",
"socket.io-parser": "4.2.7",
"source-map-js": "1.2.2",
"systeminformation": "5.33.16",
"ws": "8.22.1"
},
"optionalDependencies": {
"@next/swc-darwin-arm64": "16.4.5",
"@next/swc-darwin-x64": "16.4.5",
"@next/swc-linux-arm64-gnu": "16.4.5",
"@next/swc-linux-x64-gnu": "16.4.5"
},
"devDependencies": {
"@babel/parser": "7.29.9",
"@biomejs/biome": "2.0.6",
"@mdx-js/mdx": "3.1.1",
"@octokit/rest": "^22.0.1",
"@sim/utils": "workspace:*",
"@types/mdast": "4.0.4",
"@types/opentype.js": "1.3.10",
"@typescript/native": "npm:typescript@^7.0.2",
"@typescript/typescript6": "^6.0.2",
"@vercel/og": "0.6.8",
"ajv": "8.20.0",
"commander": "^11.1.0",
"concurrently": "10.0.6",
"glob": "13.0.6",
"gray-matter": "4.0.3",
"husky": "9.1.7",
"json-schema-to-typescript": "15.0.4",
"knip": "6.44.1",
"lint-staged": "16.4.0",
"opentype.js": "1.3.4",
"pdf-lib": "1.17.1",
"react": "19.2.4",
"remark-gfm": "4.0.1",
"remark-parse": "11.0.0",
"sharp": "0.35.5",
"turbo": "2.11.10",
"unified": "11.0.5",
"unist-util-visit": "5.2.0",
"vitest": "^5.1.0",
"zod": "4.3.6"
},
"lint-staged": {
"*.{js,jsx,ts,tsx,json,css,scss}": [
"biome check --write --no-errors-on-unmatched --files-ignore-unknown=true"
]
},
"trustedDependencies": [
"isolated-vm"
],
"patchedDependencies": {
"@better-auth/oauth-provider@1.6.27": "patches/@better-auth%2Foauth-provider@1.6.27.patch",
"drizzle-kit@0.31.11": "patches/drizzle-kit@0.31.11.patch",
"postgres@3.4.9": "patches/postgres@3.4.9.patch",
"oracledb@7.0.1": "patches/oracledb@7.0.1.patch",
"echarts@6.1.0": "patches/echarts@6.1.0.patch",
"next@16.4.5": "patches/next@16.4.5.patch",
"zod@4.3.6": "patches/zod@4.3.6.patch"
}
}