@shipfox/api-workflows 2.0.0

package/.turbo/turbo-build.log

@@ -0,0 +1,2 @@
+$ shipfox-swc
+Successfully compiled: 114 files with swc (161.1ms)

package/.turbo/turbo-type$colon$emit.log

@@ -0,0 +1 @@
+$ shipfox-tsc-emit

package/.turbo/turbo-type.log

@@ -0,0 +1 @@
+$ shipfox-tsc-check

package/CHANGELOG.md

@@ -0,0 +1,311 @@
+# @shipfox/api-workflows
+
+## 2.0.0
+
+### Minor Changes
+
+- 1b0d344: Publishes the complete API runtime closure with packed-consumer-safe internal imports and records its exact package set in application releases.
+
+### Patch Changes
+
+- Updated dependencies [0cd6dd4]
+- Updated dependencies [a68458a]
+- Updated dependencies [6eba800]
+- Updated dependencies [c31a7e0]
+- Updated dependencies [1b0d344]
+- Updated dependencies [521e006]
+  - @shipfox/node-module@0.2.0
+  - @shipfox/api-integration-core@2.0.0
+  - @shipfox/node-temporal@0.2.0
+  - @shipfox/api-auth@2.0.0
+  - @shipfox/annotations@2.0.0
+  - @shipfox/api-agent@2.0.0
+  - @shipfox/api-agent-dto@2.0.0
+  - @shipfox/api-auth-context@2.0.0
+  - @shipfox/api-definitions@2.0.0
+  - @shipfox/api-projects@2.0.0
+  - @shipfox/api-runners@2.0.0
+  - @shipfox/api-runners-dto@2.0.0
+  - @shipfox/api-secrets@2.0.0
+  - @shipfox/api-secrets-dto@2.0.0
+  - @shipfox/api-workflows-dto@2.0.0
+  - @shipfox/runner-labels@0.1.0
+  - @shipfox/expression@1.1.1
+  - @shipfox/node-drizzle@0.2.1
+  - @shipfox/node-error-monitoring@0.1.2
+  - @shipfox/node-fastify@0.2.1
+  - @shipfox/node-opentelemetry@0.5.0
+  - @shipfox/node-outbox@0.2.1
+  - @shipfox/node-postgres@0.4.1
+
+## 0.1.2
+
+### Patch Changes
+
+- Updated dependencies [705dd43]
+  - @shipfox/node-outbox@0.2.0
+  - @shipfox/api-auth@0.1.2
+  - @shipfox/api-definitions@0.1.2
+  - @shipfox/api-integration-core@0.1.2
+  - @shipfox/api-projects@0.1.2
+  - @shipfox/api-runners@0.1.2
+  - @shipfox/api-secrets@0.1.2
+  - @shipfox/node-module@0.1.2
+  - @shipfox/annotations@0.0.3
+  - @shipfox/api-agent@0.1.2
+
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies [ec75cd5]
+- Updated dependencies [6a1fb54]
+  - @shipfox/node-drizzle@0.2.0
+  - @shipfox/node-postgres@0.4.0
+  - @shipfox/api-agent@0.1.1
+  - @shipfox/annotations@0.0.2
+  - @shipfox/api-auth@0.1.1
+  - @shipfox/api-definitions@0.1.1
+  - @shipfox/api-integration-core@0.1.1
+  - @shipfox/api-projects@0.1.1
+  - @shipfox/api-runners@0.1.1
+  - @shipfox/api-secrets@0.1.1
+  - @shipfox/node-module@0.1.1
+  - @shipfox/node-outbox@0.1.1
+
+## 0.1.0
+
+### Minor Changes
+
+- 5c18360: Durable gate restart: a failing gate's `on_failure.restart_from` now records the failed attempt, rewinds the job's step projection from the named earlier step back to pending (opening fresh attempts), and leaves the job running so it re-executes from there — all in one transaction with the report. A per-step attempt cap (default 3) bounds restart loops, exhausting to a `restart_exhausted` failure. Adds the `workflows.step.restart_enqueued` event.
+- a56748d: Adds ingestion-time agent session parsing with a stored canonical SessionView read endpoint and workflow harness lookup.
+- 7a9943d: Adds the backend contract for per-step execution: job claims mint a lease token for the step API, step reports carry attempts and exit codes, and workflow completion can be signalled through the workflows outbox. The runner-side step loop is intentionally owned by the follow-up runner protocol work.
+- 736249b: Expose step attempts in the read API: the run-detail endpoint now returns `current_attempt` on each step plus its per-attempt history (`attempts[]`, with status, exit code, gate result and restart reason), so a restarted step's attempts are visible.
+- 2bc5595: Adds workflow-run cancellation across the API, orchestration queue cleanup, event contract, and run-page cancel action.
+- f9f059e: Cut the runner protocol over to per-step pull/report and remove the job-atomic path.
+
+  The job workflow now terminates on two signals: `job-finished` (raised by
+  `recordStepResult` on step exhaustion) and `job-lease-expired` (raised by the new
+  `runners.job.lease_expired` subscriber). A precedence ladder keeps a genuinely
+  finished job from being failed by a late lease expiry, and the lease-expiry branch
+  re-derives the outcome from the authoritative step projection in a single
+  transaction (server state is the final gate). On finish the workflow releases the
+  lease via `releaseJob` (deleting both the running and any orphaned pending row);
+  release is best-effort so a Scheduling outage never blocks the run DAG.
+
+  Removed the atomic path end to end: the runner `POST /runners/jobs/:jobId/complete`
+  route, the `RUNNER_JOB_COMPLETED` event, `finalizeRunningJob`/`completeJob`, the
+  `applyStepResults*` apply path and its workflow subscriber, and the dead
+  `jobPayload*`/`complete-job` DTO schemas. The runner now parses the step-less claim
+  response, and `claimPendingJob` drops an orphan pending row instead of poison-looping.
+
+  Internal breaking change (deleted exported DTOs/events and a runner route, plus a
+  Temporal signal rename) consumed only within this monorepo; backend and agent ship
+  together.
+
+- f98c2be: [api/workflows] Add the lease-authed `POST /runs/jobs/current/checkout-token` endpoint. The runner exchanges its job lease for short-lived, read-only repository checkout credentials. The job's checkout intent is resolved server-side from the authoritative `jobId` claim (`job -> run -> project` source metadata) and minted on demand via the integration service's `createCheckoutSpec()`; no credential material is ever stored on the job/run or queued. `checkoutTokenResponseSchema.auth` stays optional so credential-free providers can return a public clone URL with no token, and `integrationRouteErrorHandler` is exported from `@shipfox/api-integration-core` so the route reuses the shared provider-error mapping.
+- e9396c9: Give every runner-dispatched job a synthetic "Set up job" step at position 0 (à la GitHub Actions), so failures that happen around the user steps — workspace preparation today, the repository checkout next — are reported through the existing per-step protocol instead of hanging the job until the lease/timeout fires. The runner prepares the per-job workspace inside this step and reports the outcome; a failed setup flows through the existing fail-job cascade, finalizing the job `failed` in seconds with no user step run.
+
+  Extends `stepErrorDtoSchema` with an optional machine-readable `reason` (`workspace_prep_failed`, `git_unavailable`, `checkout_*`, `setup_aborted`) and a `category` (`setup` | `user`). The runner reports `reason`; the server derives `category` from the step type on read (the runner is an untrusted boundary). The restart resolver now skips the synthetic step so a user step named "Set up job" can never rewind setup mid-job.
+
+- 139e3be: Execute step gates at runtime: evaluate `gate.success_if` (CEL) against the step's exit code to decide pass/fail — overriding the raw command status — and record the gate result on the attempt. A failing gate fails the job; a missing exit code or an evaluation error fails closed as a plain command failure; a failing gate with `on_failure.restart_from` fails closed with a structured `restart_unsupported` error until durable restart lands.
+- c652a68: Add a single reliable job-terminal event: `workflows.job.terminated` is now written in the same transaction as every terminal job-status flip (normal completion, DAG cancellation, lease-expiry resolution, and timeout), and the run-level `workflows.workflow_run.terminated` is emitted the same way. All workflows event names are aligned on one `WORKFLOWS_<entity>_<verb>` scheme, so the run and job terminal events read as the same event at two scopes.
+
+  Internal breaking change (`WORKFLOWS_JOB_COMPLETED` → `WORKFLOWS_JOB_STEPS_SETTLED`, `WORKFLOW_RUN_*` → `WORKFLOWS_WORKFLOW_RUN_*`, with matching DTO type renames) consumed only within this monorepo.
+
+- 121b42e: Track per-step execution attempts: add a `step_attempts` history table and a `steps.current_attempt` column, open a running attempt at dispatch and finalize it at report, and make step-result reporting attempt-aware (idempotent duplicate reports, rejected future attempts, no-op stale attempts).
+- c0a883c: Adds the runner-facing per-step endpoints (`POST /runs/jobs/current/steps/next` and `/steps/:stepId/report`) authed by a locally-verified job lease token, with the matching request/response schemas.
+- d69b164: Adds workflow run attempt lineage APIs and a run summary switcher for navigating rerun attempts.
+- b74f635: Adds workflow run interpolation context resolution while preserving authored step configuration for reruns and diagnostics.
+- e699508: Adds first-class skipped workflow jobs with persisted status reasons across API DTOs, orchestration, events, and client run views.
+
+### Patch Changes
+
+- eb40964: Add an inline `agent` workflow step that the runner runs with the pi harness. A step is an agent step when it carries `model` + `prompt` and no `run`; it takes a free-text `model`, a single `prompt`, and an optional `thinking` level (default `high`). The step runs to process-success (the agent ran to completion) and reports through the existing step protocol with no runner/backend protocol change, so change quality is judged by a downstream `run` + `gate` step. v1 does not persist the agent's work (no diff, commit, or PR).
+- 2c156d2: Extracts pure workflow runtime scheduling decisions behind the existing workflows orchestration host.
+- f788565: Unifies workflow step config field resolution and agent default completion across creation and dispatch fill sites.
+- b1f57d1: Moves agent model provider credentials onto the shared secrets store while keeping provider config metadata and runtime resolution behavior intact.
+- 97162dd: Resolves model provider, model, and thinking defaults at workflow run creation using workspace and instance configuration.
+- b694b09: Add the per-step progression domain service (`nextStepForJob`, `recordStepResult`) and its guarded DB primitives over the existing `steps` table. Dormant until the per-step runner protocol is wired into the HTTP and orchestration layers; no runtime behavior changes yet.
+- c47be09: Reshape Scheduling around runner job leases. Jobs are now enqueued with `workflowRunId`, `workflowRunAttemptId`, `jobId`, and `jobExecutionId`; the claim route mints a job lease token and returns the same workflow/job identity tuple. The stuck-job detector emits `runners.job.lease_expired` with that tuple when a lease expires.
+- ae7a63c: Adds daily dispatched outbox row retention with bounded cleanup batches and retention indexes on module outbox tables.
+- e250c4c: Propagates `projectId` end-to-end into the job lease token. Workflows sources the `{workspaceId, projectId, workflowRunId, workflowRunAttemptId, jobId, jobExecutionId}` identity tuple and threads it through the runner pending/running job tables and lease claims. This is lease-shape groundwork for per-project log-ingest authorization; the stream-stamping consumer lands separately.
+- b525dcd: Let an agent workflow step pick its pi provider with an optional free-text `provider` field (default `anthropic`), threaded to the runner's pi model lookup, and split agent-step failures into a user-fixable `agent_config_invalid` reason (unknown provider, missing runner credentials, wrong provider/model pair) versus `agent_invocation_failed` for genuine provider/API errors.
+- a982f20: Stop a permanently-broken trigger subscription from starving its siblings or wedging the outbox. Integration dispatch now attempts every matched subscription and classifies each `runWorkflow` failure: a permanent error (deleted definition or project mismatch) is recorded and skipped, while a transient one re-throws so the outbox replays the event and converges. The event reaches a terminal outcome once no transient error remains (`routed` when any run was created, otherwise the new `errored` outcome), with a guarded write that never records `errored` over an event that already produced a run. The manual-fire path records the same terminal outcome, and `@shipfox/api-workflows` exports an `isPermanentRunWorkflowError` classifier. The trigger-events read API (`triggerEventOutcomeSchema`) accepts the new `errored` outcome for serialization and filtering.
+- 998eba3: Adds phase-aware workflow context metadata, availability predicates, and creation-phase workflow context assembly for runtime materialization.
+- 5327934: Materialize listening job steps per execution instead of during workflow run creation.
+- 314e84e: Adds server-side step condition skipping so rejected or errored step predicates finish as skipped without dispatching runner attempts.
+- 247cbd6: Adds label-aware runner job claiming with shared runner-label validation and required-label orchestration.
+- 795f440: Adds the listener orchestration loop for long-lived listening jobs: durable event draining, one execution per buffered event, resolution on until, listening deadline, or max executions, and a run-timeout backstop that resolves active listeners.
+- 3dcd751: Adds listener filter snapshots to job activation events and persists them on listener subscriptions.
+- 362b3eb: Scope runner log append authorization to the dispatched step attempt carried by the job lease token.
+- 6077301: Adds shared timestamp/id keyset pagination helpers and migrates workflow run and trigger event lists onto them.
+- 9c1c947: Colocates workflow phase context assembly and threads phase-tagged evaluation contexts through runtime fill sites.
+- d635979: Routes workflow materialization and predicate evaluation through persisted planner segments, replacing resolver exports with planned freeze APIs.
+- 3bea87f: Adds a typed `subscriberFactory` that binds each outbox event name to its payload type at construction, so subscriber handlers receive a typed `(payload, event)` and the per-handler `event.payload as X` casts are gone; a private brand makes the factory the only way to build a module subscriber.
+- ef1e917: Adds listening-job authoring fields and trusted execution context validation for listening jobs.
+  Separates workflow identifiers so internal rows use UUID `id`, authored workflow/job/step
+  references use `key`, and UI labels use `name`.
+- c6eb2ee: Adds debounced listener-event batching with DB-backed coalescing, max-size chunking, and batch-size metrics.
+- f9153e8: Persists parsed workflow models on run attempts so later workflow phases can materialize from the frozen template.
+- a8905ed: Splits workflow runtime internals into scheduling and step-config modules without changing behavior.
+- 282e66a: Exposes frozen agent integration tool selections as non-secret MCP server descriptors in materialized step config.
+- 0dd23a7: Warns on agent tool capability mismatches during dispatch without blocking label-matched runners.
+- e1d4972: Evaluate the step gate `success_if` over the `step` self-root (`step.exit_code`, `step.status`) and job `success` over the full typed executions context, both validated against the shared context registry; authored gate expressions move from `exit_code` to `step.exit_code` and job-success now fails closed on a runtime evaluation error.
+- f9bf446: Extract the step-report decision into a pure `decideStepTransition` plus a durable `applyStepTransition`, creating the seam where gate evaluation and durable restart will plug in. No behavior change.
+- 8ecc121: Track queue/run/finish timing for workflow runs and jobs. Adds nullable `started_at`/`finished_at` to workflow runs and `queued_at`/`started_at`/`finished_at` to jobs, exposed on the run and job DTOs. The runners module emits two new authoritative-timestamp events (`runners.job.queued`, `runners.job.started`) in the same transaction as the enqueue/claim; workflows projects them onto the job row with a first-write-wins `coalesce`, so the at-least-once outbox can redeliver out of order safely. Run `started_at`/`finished_at` and job `finished_at` are stamped in-module at the status transitions. All columns are nullable and eventually consistent, so consumers must treat a missing endpoint as "not yet known" and clamp any duration math.
+- d7b9596: Refold the workflows migration baseline and tune its indexes. Drops the redundant `step_attempts(job_execution_id)` index, which was fully covered by the `(job_execution_id, execution_order)` unique index. Adds partial `WHERE status = 'running'` indexes on `workflow_runs` and `job_executions` so the running-depth service gauge counts only active rows instead of sequentially scanning the full history on every scrape. No behavior or API change.
+- Updated dependencies [eb40964]
+- Updated dependencies [0a6318f]
+- Updated dependencies [7bc7498]
+- Updated dependencies [5c18360]
+- Updated dependencies [067a260]
+- Updated dependencies [26fea4b]
+- Updated dependencies [0cf66c4]
+- Updated dependencies [0948b67]
+- Updated dependencies [34ba284]
+- Updated dependencies [8100b48]
+- Updated dependencies [8f51daf]
+- Updated dependencies [3b45d86]
+- Updated dependencies [5707d6d]
+- Updated dependencies [e689abf]
+- Updated dependencies [59ba68b]
+- Updated dependencies [7a9943d]
+- Updated dependencies [ce3e5ca]
+- Updated dependencies [b9c3f32]
+- Updated dependencies [2325d76]
+- Updated dependencies [89026d5]
+- Updated dependencies [d02c5fd]
+- Updated dependencies [c17dd6e]
+- Updated dependencies [a81b68c]
+- Updated dependencies [115655e]
+- Updated dependencies [c0a883c]
+- Updated dependencies [72ce351]
+- Updated dependencies [cdf8989]
+- Updated dependencies [5cdfc69]
+- Updated dependencies [e47f8da]
+- Updated dependencies [736249b]
+- Updated dependencies [a68ed61]
+- Updated dependencies [2bc5595]
+- Updated dependencies [b1f57d1]
+- Updated dependencies [1127ba2]
+- Updated dependencies [36f871d]
+- Updated dependencies [e7b01dd]
+- Updated dependencies [de54da2]
+- Updated dependencies [d546b88]
+- Updated dependencies [58c05ed]
+- Updated dependencies [ce062a9]
+- Updated dependencies [7b175f5]
+- Updated dependencies [7ca4c65]
+- Updated dependencies [5bcdbf4]
+- Updated dependencies [97162dd]
+- Updated dependencies [857879a]
+- Updated dependencies [c47be09]
+- Updated dependencies [f9f059e]
+- Updated dependencies [940696a]
+- Updated dependencies [f3614ae]
+- Updated dependencies [f98c2be]
+- Updated dependencies [e9396c9]
+- Updated dependencies [ae7a63c]
+- Updated dependencies [5729548]
+- Updated dependencies [d245be8]
+- Updated dependencies [f92122b]
+- Updated dependencies [e250c4c]
+- Updated dependencies [b525dcd]
+- Updated dependencies [f8f339a]
+- Updated dependencies [b0a0e1a]
+- Updated dependencies [58f51bd]
+- Updated dependencies [570ac69]
+- Updated dependencies [857fd73]
+- Updated dependencies [aca162b]
+- Updated dependencies [1c1fb3e]
+- Updated dependencies [7fa8f0b]
+- Updated dependencies [998eba3]
+- Updated dependencies [3afb7e3]
+- Updated dependencies [2617db9]
+- Updated dependencies [444ac89]
+- Updated dependencies [1daf39a]
+- Updated dependencies [247cbd6]
+- Updated dependencies [1d98b19]
+- Updated dependencies [5823bac]
+- Updated dependencies [5d53ed4]
+- Updated dependencies [c652a68]
+- Updated dependencies [fb64f13]
+- Updated dependencies [75520ff]
+- Updated dependencies [f47cff8]
+- Updated dependencies [62720ea]
+- Updated dependencies [b855d6f]
+- Updated dependencies [795f440]
+- Updated dependencies [3dcd751]
+- Updated dependencies [f66f606]
+- Updated dependencies [c0a883c]
+- Updated dependencies [362b3eb]
+- Updated dependencies [e51d464]
+- Updated dependencies [b8e49ff]
+- Updated dependencies [5b8ed32]
+- Updated dependencies [417f128]
+- Updated dependencies [d6d4862]
+- Updated dependencies [c0a883c]
+- Updated dependencies [6077301]
+- Updated dependencies [f0afdf8]
+- Updated dependencies [9d3b43a]
+- Updated dependencies [d635979]
+- Updated dependencies [3bea87f]
+- Updated dependencies [82d22e4]
+- Updated dependencies [d69b164]
+- Updated dependencies [69d02e5]
+- Updated dependencies [2fb3e87]
+- Updated dependencies [e0fee57]
+- Updated dependencies [b74f635]
+- Updated dependencies [fa67aa3]
+- Updated dependencies [9a5aac4]
+- Updated dependencies [ef1e917]
+- Updated dependencies [51eb38a]
+- Updated dependencies [61de795]
+- Updated dependencies [88b9793]
+- Updated dependencies [e2fbef8]
+- Updated dependencies [8ecba0f]
+- Updated dependencies [27770eb]
+- Updated dependencies [2933c33]
+- Updated dependencies [2ad300c]
+- Updated dependencies [a314b05]
+- Updated dependencies [43fd0c1]
+- Updated dependencies [950ebef]
+- Updated dependencies [03d9eae]
+- Updated dependencies [a5c7562]
+- Updated dependencies [6181819]
+- Updated dependencies [3ddde91]
+- Updated dependencies [1ea2f6a]
+- Updated dependencies [e699508]
+- Updated dependencies [ad6056b]
+- Updated dependencies [8b9c3e0]
+- Updated dependencies [282e66a]
+- Updated dependencies [0dd23a7]
+- Updated dependencies [9c149d1]
+- Updated dependencies [e1d4972]
+- Updated dependencies [fb64f13]
+- Updated dependencies [a856155]
+- Updated dependencies [8ecc121]
+  - @shipfox/api-definitions@0.1.0
+  - @shipfox/api-workflows-dto@0.1.0
+  - @shipfox/api-agent@0.1.0
+  - @shipfox/expression@1.1.0
+  - @shipfox/api-agent-dto@0.1.0
+  - @shipfox/api-integration-core@0.1.0
+  - @shipfox/node-fastify@0.2.0
+  - @shipfox/api-runners@0.1.0
+  - @shipfox/api-runners-dto@0.1.0
+  - @shipfox/api-secrets@0.1.0
+  - @shipfox/api-secrets-dto@0.1.0
+  - @shipfox/annotations@0.0.1
+  - @shipfox/node-drizzle@0.1.0
+  - @shipfox/api-auth@0.1.0
+  - @shipfox/api-auth-context@0.1.0
+  - @shipfox/api-projects@0.1.0
+  - @shipfox/node-error-monitoring@0.1.1
+  - @shipfox/node-opentelemetry@0.4.2
+  - @shipfox/node-postgres@0.3.2
+  - @shipfox/node-temporal@0.1.1
+  - @shipfox/node-module@0.1.0
+  - @shipfox/node-outbox@0.1.0
+  - @shipfox/runner-labels@0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shipfox
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/core/agent-tool-capability-warning.d.ts

@@ -0,0 +1,7 @@
+import type { LeasedJobContext } from '@shipfox/api-auth-context';
+import type { Step } from './entities/step.js';
+export declare function warnAgentToolCapabilityMismatchOnDispatch(params: {
+    leaseIdentity: LeasedJobContext;
+    step: Step;
+}): Promise<void>;
+//# sourceMappingURL=agent-tool-capability-warning.d.ts.map

package/dist/core/agent-tool-capability-warning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tool-capability-warning.d.ts","sourceRoot":"","sources":["../../src/core/agent-tool-capability-warning.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,2BAA2B,CAAC;AAIhE,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,oBAAoB,CAAC;AAO7C,wBAAsB,yCAAyC,CAAC,MAAM,EAAE;IACtE,aAAa,EAAE,gBAAgB,CAAC;IAChC,IAAI,EAAE,IAAI,CAAC;CACZ,GAAG,OAAO,CAAC,IAAI,CAAC,CAqFhB"}

package/dist/core/agent-tool-capability-warning.js

@@ -0,0 +1,149 @@
+import { AnnotationBodyTooLargeError, AnnotationCountLimitExceededError, AnnotationTotalBytesLimitExceededError, writeAnnotations } from '@shipfox/annotations';
+import { harnessSchema, materializedAgentStepConfigSchema } from '@shipfox/api-agent-dto';
+import { getEffectiveRunnerToolCapabilities, unadvertisedRunnerTools } from '@shipfox/api-runners';
+import { logger } from '@shipfox/node-opentelemetry';
+import { recordWorkflowAgentToolWarningFailed } from '#metrics/instance.js';
+const TOOL_LIST_LIMIT = 10;
+export async function warnAgentToolCapabilityMismatchOnDispatch(params) {
+    const config = parseAgentConfig(params.step);
+    if (!config) return;
+    const requestedTools = config.tools ?? [];
+    if (requestedTools.length === 0) return;
+    const harness = harnessSchema.safeParse(config.harness);
+    if (!harness.success) return;
+    let effective;
+    try {
+        effective = await getEffectiveRunnerToolCapabilities({
+            runnerSessionId: params.leaseIdentity.runnerSessionId
+        });
+    } catch (error) {
+        recordWarningWriteFailure('lookup');
+        logger().warn({
+            error,
+            jobExecutionId: params.leaseIdentity.jobExecutionId,
+            stepId: params.step.id
+        }, 'Failed to read runner tool capabilities for agent tool warning');
+        return;
+    }
+    const missing = unadvertisedRunnerTools({
+        harness: harness.data,
+        requestedTools,
+        capabilities: effective.capabilities
+    });
+    const context = `agent-tool-capability:${params.step.id}`;
+    const operation = missing.length === 0 ? {
+        context,
+        style: 'warning',
+        op: 'remove'
+    } : {
+        context,
+        style: 'warning',
+        op: 'replace',
+        body: warningBody({
+            harness: harness.data,
+            missing,
+            reason: warningReason({
+                reportFresh: effective.reportFresh,
+                harnessKnown: effective.harnessKnown(harness.data)
+            })
+        })
+    };
+    try {
+        await writeAnnotations({
+            ...writeParamsFromLease(params.leaseIdentity),
+            originStepId: params.step.id,
+            originStepAttempt: params.step.currentAttempt,
+            operations: [
+                operation
+            ]
+        });
+    } catch (error) {
+        const reason = isAnnotationBudgetError(error) ? 'budget' : 'write';
+        recordWarningWriteFailure(reason);
+        logger().warn({
+            error,
+            reason,
+            jobExecutionId: params.leaseIdentity.jobExecutionId,
+            stepId: params.step.id
+        }, 'Failed to write agent tool capability warning annotation');
+        return;
+    }
+    if (missing.length > 0) {
+        logger().warn({
+            jobExecutionId: params.leaseIdentity.jobExecutionId,
+            stepId: params.step.id,
+            harness: harness.data,
+            missing,
+            reason: warningReason({
+                reportFresh: effective.reportFresh,
+                harnessKnown: effective.harnessKnown(harness.data)
+            })
+        }, 'Runner missing requested agent tools; dispatch is continuing');
+    }
+}
+function parseAgentConfig(step) {
+    if (step.type !== 'agent') return null;
+    const parsed = materializedAgentStepConfigSchema.safeParse(step.config);
+    return parsed.success ? parsed.data : null;
+}
+function warningBody(params) {
+    const tools = formatToolList(params.missing);
+    const harness = markdownInlineCode(params.harness);
+    if (params.reason === 'known-absence') {
+        return [
+            '**Runner missing requested agent tools**',
+            '',
+            `The matched runner advertised a ${harness} tool set without: ${tools}.`,
+            'Execution is continuing on this runner because labels matched; the step may fail if the harness cannot provide these tools.'
+        ].join('\n');
+    }
+    if (params.reason === 'harness-not-advertised') {
+        return [
+            '**Runner missing requested agent harness tools**',
+            '',
+            `The matched runner advertised fresh tool capabilities, but did not advertise a ${harness} tool set. Support for ${tools} could not be confirmed.`,
+            'Execution is continuing on this runner because labels matched; the step may fail if the harness cannot provide these tools.'
+        ].join('\n');
+    }
+    return [
+        '**Could not confirm runner agent tools**',
+        '',
+        `The matched runner reported no or stale tool capabilities, so support for ${tools} could not be confirmed.`,
+        'Execution is continuing on this runner because labels matched.'
+    ].join('\n');
+}
+function formatToolList(tools) {
+    const visible = tools.slice(0, TOOL_LIST_LIMIT).map(markdownInlineCode);
+    const remaining = tools.length - visible.length;
+    return remaining > 0 ? `${visible.join(', ')} ...and ${remaining} more` : visible.join(', ');
+}
+function markdownInlineCode(value) {
+    const maxBacktickRun = Math.max(0, ...Array.from(value.matchAll(/`+/g), (match)=>match[0].length));
+    const delimiter = '`'.repeat(maxBacktickRun + 1);
+    const needsPadding = value.startsWith('`') || value.endsWith('`');
+    const content = needsPadding ? ` ${value} ` : value;
+    return `${delimiter}${content}${delimiter}`;
+}
+function warningReason(params) {
+    if (params.harnessKnown) return 'known-absence';
+    return params.reportFresh ? 'harness-not-advertised' : 'unknown-or-stale';
+}
+function writeParamsFromLease(lease) {
+    return {
+        workspaceId: lease.workspaceId,
+        projectId: lease.projectId,
+        workflowRunId: lease.workflowRunId,
+        workflowRunAttempt: lease.workflowRunAttempt ?? 1,
+        workflowRunAttemptId: lease.workflowRunAttemptId,
+        jobId: lease.jobId,
+        jobExecutionId: lease.jobExecutionId
+    };
+}
+function isAnnotationBudgetError(error) {
+    return error instanceof AnnotationBodyTooLargeError || error instanceof AnnotationCountLimitExceededError || error instanceof AnnotationTotalBytesLimitExceededError;
+}
+function recordWarningWriteFailure(reason) {
+    recordWorkflowAgentToolWarningFailed(reason);
+}
+
+//# sourceMappingURL=agent-tool-capability-warning.js.map

package/dist/core/agent-tool-capability-warning.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/agent-tool-capability-warning.ts"],"sourcesContent":["import {\n  AnnotationBodyTooLargeError,\n  AnnotationCountLimitExceededError,\n  AnnotationTotalBytesLimitExceededError,\n  type WriteAnnotationsParams,\n  writeAnnotations,\n} from '@shipfox/annotations';\nimport {\n  harnessSchema,\n  type MaterializedAgentStepConfigDto,\n  materializedAgentStepConfigSchema,\n} from '@shipfox/api-agent-dto';\nimport type {LeasedJobContext} from '@shipfox/api-auth-context';\nimport {getEffectiveRunnerToolCapabilities, unadvertisedRunnerTools} from '@shipfox/api-runners';\nimport {logger} from '@shipfox/node-opentelemetry';\nimport {recordWorkflowAgentToolWarningFailed} from '#metrics/instance.js';\nimport type {Step} from './entities/step.js';\n\nconst TOOL_LIST_LIMIT = 10;\n\ntype WarningFailureReason = 'budget' | 'lookup' | 'write';\ntype WarningReason = 'known-absence' | 'harness-not-advertised' | 'unknown-or-stale';\n\nexport async function warnAgentToolCapabilityMismatchOnDispatch(params: {\n  leaseIdentity: LeasedJobContext;\n  step: Step;\n}): Promise<void> {\n  const config = parseAgentConfig(params.step);\n  if (!config) return;\n\n  const requestedTools = config.tools ?? [];\n  if (requestedTools.length === 0) return;\n\n  const harness = harnessSchema.safeParse(config.harness);\n  if (!harness.success) return;\n\n  let effective: Awaited<ReturnType<typeof getEffectiveRunnerToolCapabilities>>;\n  try {\n    effective = await getEffectiveRunnerToolCapabilities({\n      runnerSessionId: params.leaseIdentity.runnerSessionId,\n    });\n  } catch (error) {\n    recordWarningWriteFailure('lookup');\n    logger().warn(\n      {error, jobExecutionId: params.leaseIdentity.jobExecutionId, stepId: params.step.id},\n      'Failed to read runner tool capabilities for agent tool warning',\n    );\n    return;\n  }\n\n  const missing = unadvertisedRunnerTools({\n    harness: harness.data,\n    requestedTools,\n    capabilities: effective.capabilities,\n  });\n  const context = `agent-tool-capability:${params.step.id}`;\n\n  const operation =\n    missing.length === 0\n      ? {context, style: 'warning' as const, op: 'remove' as const}\n      : {\n          context,\n          style: 'warning' as const,\n          op: 'replace' as const,\n          body: warningBody({\n            harness: harness.data,\n            missing,\n            reason: warningReason({\n              reportFresh: effective.reportFresh,\n              harnessKnown: effective.harnessKnown(harness.data),\n            }),\n          }),\n        };\n\n  try {\n    await writeAnnotations({\n      ...writeParamsFromLease(params.leaseIdentity),\n      originStepId: params.step.id,\n      originStepAttempt: params.step.currentAttempt,\n      operations: [operation],\n    });\n  } catch (error) {\n    const reason = isAnnotationBudgetError(error) ? 'budget' : 'write';\n    recordWarningWriteFailure(reason);\n    logger().warn(\n      {\n        error,\n        reason,\n        jobExecutionId: params.leaseIdentity.jobExecutionId,\n        stepId: params.step.id,\n      },\n      'Failed to write agent tool capability warning annotation',\n    );\n    return;\n  }\n\n  if (missing.length > 0) {\n    logger().warn(\n      {\n        jobExecutionId: params.leaseIdentity.jobExecutionId,\n        stepId: params.step.id,\n        harness: harness.data,\n        missing,\n        reason: warningReason({\n          reportFresh: effective.reportFresh,\n          harnessKnown: effective.harnessKnown(harness.data),\n        }),\n      },\n      'Runner missing requested agent tools; dispatch is continuing',\n    );\n  }\n}\n\nfunction parseAgentConfig(step: Step): MaterializedAgentStepConfigDto | null {\n  if (step.type !== 'agent') return null;\n\n  const parsed = materializedAgentStepConfigSchema.safeParse(step.config);\n  return parsed.success ? parsed.data : null;\n}\n\nfunction warningBody(params: {\n  harness: string;\n  missing: readonly string[];\n  reason: WarningReason;\n}): string {\n  const tools = formatToolList(params.missing);\n  const harness = markdownInlineCode(params.harness);\n  if (params.reason === 'known-absence') {\n    return [\n      '**Runner missing requested agent tools**',\n      '',\n      `The matched runner advertised a ${harness} tool set without: ${tools}.`,\n      'Execution is continuing on this runner because labels matched; the step may fail if the harness cannot provide these tools.',\n    ].join('\\n');\n  }\n\n  if (params.reason === 'harness-not-advertised') {\n    return [\n      '**Runner missing requested agent harness tools**',\n      '',\n      `The matched runner advertised fresh tool capabilities, but did not advertise a ${harness} tool set. Support for ${tools} could not be confirmed.`,\n      'Execution is continuing on this runner because labels matched; the step may fail if the harness cannot provide these tools.',\n    ].join('\\n');\n  }\n\n  return [\n    '**Could not confirm runner agent tools**',\n    '',\n    `The matched runner reported no or stale tool capabilities, so support for ${tools} could not be confirmed.`,\n    'Execution is continuing on this runner because labels matched.',\n  ].join('\\n');\n}\n\nfunction formatToolList(tools: readonly string[]): string {\n  const visible = tools.slice(0, TOOL_LIST_LIMIT).map(markdownInlineCode);\n  const remaining = tools.length - visible.length;\n  return remaining > 0 ? `${visible.join(', ')} ...and ${remaining} more` : visible.join(', ');\n}\n\nfunction markdownInlineCode(value: string): string {\n  const maxBacktickRun = Math.max(\n    0,\n    ...Array.from(value.matchAll(/`+/g), (match) => match[0].length),\n  );\n  const delimiter = '`'.repeat(maxBacktickRun + 1);\n  const needsPadding = value.startsWith('`') || value.endsWith('`');\n  const content = needsPadding ? ` ${value} ` : value;\n  return `${delimiter}${content}${delimiter}`;\n}\n\nfunction warningReason(params: {reportFresh: boolean; harnessKnown: boolean}): WarningReason {\n  if (params.harnessKnown) return 'known-absence';\n  return params.reportFresh ? 'harness-not-advertised' : 'unknown-or-stale';\n}\n\nfunction writeParamsFromLease(\n  lease: LeasedJobContext,\n): Omit<WriteAnnotationsParams, 'originStepId' | 'originStepAttempt' | 'operations'> {\n  return {\n    workspaceId: lease.workspaceId,\n    projectId: lease.projectId,\n    workflowRunId: lease.workflowRunId,\n    workflowRunAttempt: lease.workflowRunAttempt ?? 1,\n    workflowRunAttemptId: lease.workflowRunAttemptId,\n    jobId: lease.jobId,\n    jobExecutionId: lease.jobExecutionId,\n  };\n}\n\nfunction isAnnotationBudgetError(error: unknown): boolean {\n  return (\n    error instanceof AnnotationBodyTooLargeError ||\n    error instanceof AnnotationCountLimitExceededError ||\n    error instanceof AnnotationTotalBytesLimitExceededError\n  );\n}\n\nfunction recordWarningWriteFailure(reason: WarningFailureReason): void {\n  recordWorkflowAgentToolWarningFailed(reason);\n}\n"],"names":["AnnotationBodyTooLargeError","AnnotationCountLimitExceededError","AnnotationTotalBytesLimitExceededError","writeAnnotations","harnessSchema","materializedAgentStepConfigSchema","getEffectiveRunnerToolCapabilities","unadvertisedRunnerTools","logger","recordWorkflowAgentToolWarningFailed","TOOL_LIST_LIMIT","warnAgentToolCapabilityMismatchOnDispatch","params","config","parseAgentConfig","step","requestedTools","tools","length","harness","safeParse","success","effective","runnerSessionId","leaseIdentity","error","recordWarningWriteFailure","warn","jobExecutionId","stepId","id","missing","data","capabilities","context","operation","style","op","body","warningBody","reason","warningReason","reportFresh","harnessKnown","writeParamsFromLease","originStepId","originStepAttempt","currentAttempt","operations","isAnnotationBudgetError","type","parsed","formatToolList","markdownInlineCode","join","visible","slice","map","remaining","value","maxBacktickRun","Math","max","Array","from","matchAll","match","delimiter","repeat","needsPadding","startsWith","endsWith","content","lease","workspaceId","projectId","workflowRunId","workflowRunAttempt","workflowRunAttemptId","jobId"],"mappings":"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"}

package/dist/core/agent-tools.d.ts

@@ -0,0 +1,51 @@
+import type { MaterializedAgentIntegrationConfigDto } from '@shipfox/api-agent-dto';
+import type { WorkflowModel } from '@shipfox/api-definitions';
+import type { AgentToolCatalogs, GetIntegrationConnectionByIdFn, IntegrationProviderKind, LoadWorkspaceConnectionSnapshot, WorkspaceConnectionSnapshot } from '@shipfox/api-integration-core';
+type WorkflowModelJob = WorkflowModel['jobs'][number];
+type WorkflowModelAgentStep = Extract<WorkflowModelJob['steps'][number], {
+    kind: 'agent';
+}>;
+type WorkflowModelStepIntegration = NonNullable<WorkflowModelAgentStep['integrations']>[number];
+interface AgentToolMaterializationServices {
+    readonly catalogs: AgentToolCatalogs;
+    readonly loadWorkspaceConnectionSnapshot: LoadWorkspaceConnectionSnapshot;
+    readonly getIntegrationConnectionById: GetIntegrationConnectionByIdFn;
+}
+export interface AgentToolMaterializationContext {
+    readonly catalogs: AgentToolCatalogs;
+    readonly workspaceConnectionSnapshot: WorkspaceConnectionSnapshot;
+    readonly defaultConnection: {
+        readonly id: string;
+        readonly slug: string;
+        readonly provider: IntegrationProviderKind;
+    };
+}
+export interface AgentToolMaterializationSnapshot {
+    readonly steps: readonly AgentToolMaterializationSnapshotStep[];
+}
+export interface AgentToolMaterializationSnapshotStep {
+    readonly jobKey: string;
+    readonly stepId: string;
+    readonly integrations: readonly MaterializedAgentIntegrationConfigDto[];
+}
+export declare function setAgentToolMaterializationServices(nextServices: AgentToolMaterializationServices): void;
+export declare function clearAgentToolMaterializationServices(): void;
+export declare function loadAgentToolMaterializationContext(params: {
+    readonly model: WorkflowModel | null;
+    readonly workspaceId: string;
+    readonly projectId: string;
+    readonly jobs?: readonly WorkflowModelJob[] | undefined;
+}): Promise<AgentToolMaterializationContext | undefined>;
+export declare function materializeAgentIntegrations(params: {
+    readonly jobKey: string;
+    readonly stepId: string;
+    readonly integrations: readonly WorkflowModelStepIntegration[] | undefined;
+    readonly context: AgentToolMaterializationContext | undefined;
+    readonly snapshot?: AgentToolMaterializationSnapshot | null | undefined;
+}): MaterializedAgentIntegrationConfigDto[] | undefined;
+export declare function createAgentToolMaterializationSnapshot(params: {
+    readonly model: WorkflowModel;
+    readonly context: AgentToolMaterializationContext | undefined;
+}): AgentToolMaterializationSnapshot | null;
+export {};
+//# sourceMappingURL=agent-tools.d.ts.map

package/dist/core/agent-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tools.d.ts","sourceRoot":"","sources":["../../src/core/agent-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qCAAqC,EAEtC,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAGV,iBAAiB,EACjB,8BAA8B,EAC9B,uBAAuB,EACvB,+BAA+B,EAC/B,2BAA2B,EAC5B,MAAM,+BAA+B,CAAC;AAIvC,KAAK,gBAAgB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AACtD,KAAK,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE;IAAC,IAAI,EAAE,OAAO,CAAA;CAAC,CAAC,CAAC;AAC1F,KAAK,4BAA4B,GAAG,WAAW,CAAC,sBAAsB,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhG,UAAU,gCAAgC;IACxC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,+BAA+B,EAAE,+BAA+B,CAAC;IAC1E,QAAQ,CAAC,4BAA4B,EAAE,8BAA8B,CAAC;CACvE;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,2BAA2B,EAAE,2BAA2B,CAAC;IAClE,QAAQ,CAAC,iBAAiB,EAAE;QAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;KAC5C,CAAC;CACH;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,oCAAoC,EAAE,CAAC;CACjE;AAED,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,SAAS,qCAAqC,EAAE,CAAC;CACzE;AAUD,wBAAgB,mCAAmC,CACjD,YAAY,EAAE,gCAAgC,GAC7C,IAAI,CAEN;AAED,wBAAgB,qCAAqC,IAAI,IAAI,CAE5D;AAED,wBAAsB,mCAAmC,CAAC,MAAM,EAAE;IAChE,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,gBAAgB,EAAE,GAAG,SAAS,CAAC;CACzD,GAAG,OAAO,CAAC,+BAA+B,GAAG,SAAS,CAAC,CAgCvD;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,SAAS,4BAA4B,EAAE,GAAG,SAAS,CAAC;IAC3E,QAAQ,CAAC,OAAO,EAAE,+BAA+B,GAAG,SAAS,CAAC;IAC9D,QAAQ,CAAC,QAAQ,CAAC,EAAE,gCAAgC,GAAG,IAAI,GAAG,SAAS,CAAC;CACzE,GAAG,qCAAqC,EAAE,GAAG,SAAS,CActD;AAED,wBAAgB,sCAAsC,CAAC,MAAM,EAAE;IAC7D,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,+BAA+B,GAAG,SAAS,CAAC;CAC/D,GAAG,gCAAgC,GAAG,IAAI,CAwB1C"}