@kici-dev/compiler 0.4.0 → 0.6.0

package/dist/llm-context/llms-sdk-runtime.txt

@@ -109,7 +109,7 @@ An orchestrator enforces a few limits, each surfaced as a clear step error when
 - A **per-org storage quota** (20 GiB by default) across all non-expired artifacts.
 - An **expiry** (30 days by default) after which an artifact is no longer downloadable or listed.
 
-Operators can raise or lower the quota and expiry per organization; see the [orchestrator storage layout](https://docs.kici.dev/operator/orchestrator/storage-layout/#artifacts) for the operator-facing knobs.
+Each of the four is a cluster-wide default an operator can raise or lower per organization; see the [orchestrator storage layout](https://docs.kici.dev/operator/orchestrator/storage-layout/#artifacts) for the operator-facing knobs.
 
 When an upload or download fails for a reason that is **not** one of these limits — the orchestrator has no artifact storage configured, or it could not service the request — the step error says exactly that, instead of reporting a quota rejection or a missing artifact. So an error that names a limit really is a limit you can act on, and an error that names an orchestrator problem is one to take to whoever runs it.
 
@@ -266,7 +266,7 @@ Source: https://docs.kici.dev/user/sdk/event-payloads/
 
 ## The envelope
 
-The normalized event envelope is the single event contract in KiCI. Rules receive it as `ctx.event`, and every dynamic function — `environment:`, `env:`, and `concurrencyGroup:` resolvers, generated jobs, and a workflow's `concurrency.group` — receives the same envelope as its argument.
+The normalized event envelope is the single event contract in KiCI. Rules receive it as `ctx.event`, and every dynamic function — `context:`, `env:`, and `concurrencyGroup:` resolvers, generated jobs, and a workflow's `concurrency.group` — receives the same envelope as its argument.
 
 Narrow on the `type` field to branch per trigger kind (`if (event.type === 'push')`). The raw provider webhook body is nested at `payload`; the typed variants below describe its shape per event type.
 
@@ -712,7 +712,7 @@ export const setup = job('setup', {
 
 ## `checkStep(name, options)`
 
-The check-mode-aware sibling of `idempotentStep()`. It takes the **same option shape**, but behaves differently when a run is started in check mode (`kici run --check`):
+The check-mode-aware sibling of `idempotentStep()`. It takes a closely related option shape, but behaves differently when a run is started in check mode (`kici run --check`):
 
 | Factory          | Behavior under `kici run --check`         |
 | ---------------- | ----------------------------------------- |
@@ -730,10 +730,16 @@ Use `checkStep()` for deploy-style steps where you want a dry-run preview of pen
 | `apply`           | `(ctx, drift: TDrift) => Promise<TApplied>` | Yes      | Brings the system to the desired state. Runs only in apply mode (skipped under `kici run --check`). |
 | `summarize`       | `(drift: TDrift) => string`                 | Yes      | Human-readable summary of what `apply()` would do; shown in check-mode drift output.                |
 | `whenInSync`      | `(ctx) => Promise<TInSync>`                 | No       | Runs when `check()` returned `null` (already in sync).                                              |
+| `outputs`         | `OutputSchema`                              | No       | Zod schema validating the step's outputs at runtime.                                                |
 | `continueOnError` | `boolean`                                   | No       | When true, the job proceeds even if this step fails.                                                |
 | `timeout`         | `number`                                    | No       | Step-level timeout in milliseconds.                                                                 |
+| `retry`           | `number \| RetryConfig`                     | No       | Retry policy for the step; `retry: N` is shorthand for `{ maxAttempts: N }`.                        |
+| `cache`           | `CacheInput`                                | No       | Declarative cache restored before the step and saved after it succeeds.                             |
+| `rules`           | `Rule[]`                                    | No       | Step-level conditional rules, evaluated agent-side.                                                 |
 
-The one signature difference from `idempotentStep`: `apply` and `whenInSync` receive `ctx` as their first argument, so the apply logic has access to `ctx.$`, `ctx.log`, and `ctx.secrets`.
+Everything from `outputs` down is a plain [`step()` option](https://docs.kici.dev/user/sdk/core/) forwarded to the underlying step. The three step options `checkStep` does **not** accept are `onCancel`, `cleanup`, and `approval`.
+
+There are two signature differences from `idempotentStep`. First, `apply` and `whenInSync` receive `ctx` as their first argument, so the apply logic has access to `ctx.$`, `ctx.log`, and `ctx.secrets`. Second, `summarize` is **required** here, because it is what check mode prints; `idempotentStep` defaults it to a JSON dump of the drift. `idempotentStep` also takes none of the step-option passthroughs above.
 
 ### Result
 
@@ -841,6 +847,21 @@ const patch = job('patch', {
 });
 ```
 
+### Which hosts are targets
+
+`runsOnAll` targets the hosts you declare as members of your fleet. A host becomes
+a target when it registers with the orchestrator under a stable agent identity, or
+when an operator declares it with `kici-admin host declare`.
+
+Agents that an auto-scaler starts are **not** targets, even when their labels match
+the predicate. An auto-scaler starts an agent at the fixed shape of its pool, so a
+pinned child would run at that shape and not at its own. Auto-scaler agents stay
+available to `runsOn` and to the queue, and `ctx.kici.inventory` continues to list
+them.
+
+The fleet preview and the host detail page in the web UI apply the same rule, so
+they show the hosts a run targets.
+
 ### Input forms
 
 `runsOnAll` accepts three shapes:
@@ -1130,7 +1151,7 @@ When `--target` narrows a `runsOnAll` job to zero hosts, the run **fails** by de
 (a mistyped selector should be loud, not silently no-op). Pass `--target-allow-empty`
 to **skip** the zeroed job instead — it records a `skipped` status, and downstream jobs
 gated with `when: 'on-skip'` (or `when: 'always'`) still run, exactly as for an
-`onUnreachable: 'skip'` zero-host fan-out. See the [CLI reference](https://docs.kici.dev/user/cli-reference/#host-narrowing-with---target)
+`onUnreachable: 'skip'` zero-host fan-out. See the [CLI reference](https://docs.kici.dev/user/cli/runs-and-approvals/#host-narrowing-with---target)
 for the full flag behavior and the [`needs` gating model](https://docs.kici.dev/user/sdk/core/#job-dependencies-needs)
 for how a skipped upstream propagates.
 
@@ -1174,41 +1195,42 @@ All types are exported from `@kici-dev/sdk` as type-only imports.
 
 ### Trigger types
 
-| Type                            | Description                                                           |
-| ------------------------------- | --------------------------------------------------------------------- |
-| `Trigger`                       | Trigger definition (trigger config + source location)                 |
-| `TriggerConfig`                 | Union of all 23 trigger config types                                  |
-| `PrTriggerConfig`               | PR trigger configuration (from `pr()`)                                |
-| `PushTriggerConfig`             | Push trigger configuration (from `push()`)                            |
-| `TagTriggerConfig`              | Tag trigger configuration (from `tag()`)                              |
-| `CommentTriggerConfig`          | Comment trigger configuration (from `comment()`)                      |
-| `ReviewTriggerConfig`           | Review trigger configuration (from `review()`)                        |
-| `ReviewCommentTriggerConfig`    | Review comment trigger configuration (from `reviewComment()`)         |
-| `ReleaseTriggerConfig`          | Release trigger configuration (from `release()`)                      |
-| `DispatchTriggerConfig`         | Repository dispatch trigger configuration (from `dispatch()`)         |
-| `CreateTriggerConfig`           | Ref creation trigger configuration (from `create()`)                  |
-| `DeleteTriggerConfig`           | Ref deletion trigger configuration (from `delete()`)                  |
-| `StatusTriggerConfig`           | Commit status trigger configuration (from `status()`)                 |
-| `WorkflowRunTriggerConfig`      | Workflow run trigger configuration (from `workflowRun()`)             |
-| `ForkTriggerConfig`             | Fork trigger configuration (from `fork()`)                            |
-| `StarTriggerConfig`             | Star trigger configuration (from `star()`)                            |
-| `WatchTriggerConfig`            | Watch trigger configuration (from `watch()`)                          |
-| `WebhookTriggerConfig`          | Catch-all webhook trigger configuration (from `webhook()`)            |
-| `KiciEventTriggerConfig`        | Custom event trigger configuration (from `kiciEvent()`)               |
-| `WorkflowCompleteTriggerConfig` | Workflow completion trigger configuration (from `workflowComplete()`) |
-| `JobCompleteTriggerConfig`      | Job completion trigger configuration (from `jobComplete()`)           |
-| `GenericWebhookTriggerConfig`   | Generic webhook trigger configuration (from `genericWebhook()`)       |
-| `ScheduleTriggerConfig`         | Schedule trigger configuration (from `schedule()`)                    |
-| `LifecycleTriggerConfig`        | Lifecycle trigger configuration (from `lifecycle()`)                  |
-| `PrConfigInput`                 | Config object for `pr()` factory                                      |
-| `PushConfigInput`               | Config object for `push()` factory                                    |
-| `BranchPattern`                 | `{ type: 'glob', pattern } \| { type: 'regex', pattern, flags? }`     |
-| `PrEvent`                       | PR event string literal union (17 event types)                        |
-| `GenericWebhookConfigInput`     | Config object for `genericWebhook()` factory                          |
-| `GenericWebhookAuth`            | Union of generic webhook auth types (HMAC or API key)                 |
-| `GenericWebhookHmacAuth`        | HMAC-SHA256 auth configuration for generic webhooks                   |
-| `GenericWebhookApiKeyAuth`      | API key auth configuration for generic webhooks                       |
-| `GenericWebhookAuthMethod`      | Auth method string literal (`'hmac-sha256' \| 'api-key'`)             |
+| Type                                | Description                                                                    |
+| ----------------------------------- | ------------------------------------------------------------------------------ |
+| `Trigger`                           | Trigger definition (trigger config + source location)                          |
+| `TriggerConfig`                     | Union of all 23 trigger config types                                           |
+| `PrTriggerConfig`                   | PR trigger configuration (from `pr()`)                                         |
+| `PushTriggerConfig`                 | Push trigger configuration (from `push()`)                                     |
+| `TagTriggerConfig`                  | Tag trigger configuration (from `tag()`)                                       |
+| `CommentTriggerConfig`              | Comment trigger configuration (from `comment()`)                               |
+| `ReviewTriggerConfig`               | Review trigger configuration (from `review()`)                                 |
+| `ReviewCommentTriggerConfig`        | Review comment trigger configuration (from `reviewComment()`)                  |
+| `ReleaseTriggerConfig`              | Release trigger configuration (from `release()`)                               |
+| `DispatchTriggerConfig`             | Repository dispatch trigger configuration (from `dispatch()`)                  |
+| `CreateTriggerConfig`               | Ref creation trigger configuration (from `create()`)                           |
+| `DeleteTriggerConfig`               | Ref deletion trigger configuration (from `delete()`)                           |
+| `StatusTriggerConfig`               | Commit status trigger configuration (from `status()`)                          |
+| `WorkflowRunTriggerConfig`          | Workflow run trigger configuration (from `workflowRun()`)                      |
+| `ForkTriggerConfig`                 | Fork trigger configuration (from `fork()`)                                     |
+| `StarTriggerConfig`                 | Star trigger configuration (from `star()`)                                     |
+| `WatchTriggerConfig`                | Watch trigger configuration (from `watch()`)                                   |
+| `WebhookTriggerConfig`              | Catch-all webhook trigger configuration (from `webhook()`)                     |
+| `KiciEventTriggerConfig`            | Custom event trigger configuration (from `kiciEvent()`)                        |
+| `WorkflowCompleteTriggerConfig`     | Workflow completion trigger configuration (from `workflowComplete()`)          |
+| `WorkflowsFailedBatchTriggerConfig` | Batched workflow-failure trigger configuration (from `workflowsFailedBatch()`) |
+| `JobCompleteTriggerConfig`          | Job completion trigger configuration (from `jobComplete()`)                    |
+| `GenericWebhookTriggerConfig`       | Generic webhook trigger configuration (from `genericWebhook()`)                |
+| `ScheduleTriggerConfig`             | Schedule trigger configuration (from `schedule()`)                             |
+| `LifecycleTriggerConfig`            | Lifecycle trigger configuration (from `lifecycle()`)                           |
+| `PrConfigInput`                     | Config object for `pr()` factory                                               |
+| `PushConfigInput`                   | Config object for `push()` factory                                             |
+| `BranchPattern`                     | `{ type: 'glob', pattern } \| { type: 'regex', pattern, flags? }`              |
+| `PrEvent`                           | PR event string literal union (17 event types)                                 |
+| `GenericWebhookConfigInput`         | Config object for `genericWebhook()` factory                                   |
+| `GenericWebhookAuth`                | Union of generic webhook auth types (HMAC or API key)                          |
+| `GenericWebhookHmacAuth`            | HMAC-SHA256 auth configuration for generic webhooks                            |
+| `GenericWebhookApiKeyAuth`          | API key auth configuration for generic webhooks                                |
+| `GenericWebhookAuthMethod`          | Auth method string literal (`'hmac-sha256' \| 'api-key'`)                      |
 
 ### Rule types