stitchkit 0.59.3 → 0.60.0

package/dist/application/kernel.d.ts

@@ -1,10 +1,56 @@
-import type { ShutdownOptions } from '../server/shutdown';
+import type { z } from 'zod';
 import type { ManagedResource } from './resource';
-import { type ApplicationShutdownResult, type ApplicationSnapshot } from './schemas';
+import { type ApplicationResourceShutdown, type ApplicationShutdownResult, type ApplicationSnapshot } from './schemas';
+/** The phase a managed resource failed in — the vocabulary of `failures`. */
+export type ApplicationResourcePhase = ApplicationResourceShutdown['failures'][number];
+/** One resource failure with the cause the phase label cannot carry. */
+export interface ApplicationResourceFailure {
+    readonly resourceId: string;
+    readonly phase: ApplicationResourcePhase;
+    /** The value the resource actually threw or rejected with. */
+    readonly error: unknown;
+}
+/**
+ * The budgets an application shutdown accepts.
+ *
+ * The same two names the server and the agent runtime use, and only those:
+ * `retryAfterSeconds` is an HTTP response concern that belongs to the managed
+ * server resource, and accepting it here typed and validated an option nothing
+ * in the kernel ever read.
+ */
+export declare const ApplicationShutdownOptionsSchema: z.ZodObject<{
+    gracePeriodMs: z.ZodDefault<z.ZodNumber>;
+    forceTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    signal: z.ZodOptional<z.ZodCustom<AbortSignal, AbortSignal>>;
+}, z.core.$strip>;
+export type ApplicationShutdownOptions = z.input<typeof ApplicationShutdownOptionsSchema>;
 export interface ApplicationConfig {
     readonly id: string;
     readonly resources?: readonly ManagedResource[];
     readonly onSnapshot?: (snapshot: ApplicationSnapshot) => void | Promise<void>;
+    /**
+     * Observe why a phase failed.
+     *
+     * `ApplicationResourceShutdown.failures` names the phase and nothing else, so
+     * an operator reading it learns that `drain` failed and has no way to learn
+     * why. The published response stays a verdict — this is the internal half of
+     * the same rule: outward a generic answer, inward everything.
+     *
+     * Called for every failure of a resource's OWN code, in every phase:
+     * `start`, `ready`, `completion`, `admission`, `drain`, `close` — including
+     * the `close` that runs while rolling a failed startup back — and `force`.
+     * It is NOT called for the kernel's own interruption of a startup that a
+     * shutdown overtook: nothing failed there, and reporting it would bury the
+     * one failure that did.
+     *
+     * A throwing observer cannot break the lifecycle it observes, and neither can
+     * a REJECTING one: an `async` observer type-checks against a `void` return,
+     * and its rejected promise is invisible to a synchronous `try/catch` around
+     * the call. Returning a promise is therefore part of the signature, and the
+     * kernel isolates it — it does not await it, so an observer cannot slow a
+     * shutdown down either.
+     */
+    readonly onResourceFailure?: (failure: ApplicationResourceFailure) => void | Promise<void>;
 }
 export interface ApplicationOperationLease {
     readonly released: boolean;
@@ -20,7 +66,7 @@ export interface ApplicationHandle {
     start(): Promise<ApplicationSnapshot>;
     getSnapshot(): ApplicationSnapshot;
     subscribe(listener: (snapshot: ApplicationSnapshot) => void): () => void;
-    shutdown(options?: ShutdownOptions): Promise<ApplicationShutdownResult>;
+    shutdown(options?: ApplicationShutdownOptions): Promise<ApplicationShutdownResult>;
 }
 export declare class ApplicationAdmissionError extends Error {
     readonly code = "APPLICATION_NOT_ACCEPTING";

package/dist/application/kernel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../../src/application/kernel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,KAAK,EACV,eAAe,EAGhB,MAAM,YAAY,CAAC;AACpB,OAAO,EAKL,KAAK,yBAAyB,EAE9B,KAAK,mBAAmB,EAGzB,MAAM,WAAW,CAAC;AAyBnB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAChD,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/E;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,IAAI,yBAAyB,GAAG,IAAI,CAAC;IAC5C,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,KAAK,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACtC,WAAW,IAAI,mBAAmB,CAAC;IACnC,SAAS,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;CACzE;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,IAAI,+BAA+B;IAE5C,cAGC;CACF;AA2BD,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,CAwlB9E"}
+{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../../src/application/kernel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,OAAO,KAAK,EACV,eAAe,EAGhB,MAAM,YAAY,CAAC;AACpB,OAAO,EAIL,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,EAE9B,KAAK,mBAAmB,EAGzB,MAAM,WAAW,CAAC;AAEnB,6EAA6E;AAC7E,MAAM,MAAM,wBAAwB,GAAG,2BAA2B,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAsCvF,wEAAwE;AACxE,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC;IACzC,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,gCAAgC;;;;iBAI3C,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAChD,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,0BAA0B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5F;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,IAAI,yBAAyB,GAAG,IAAI,CAAC;IAC5C,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,KAAK,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACtC,WAAW,IAAI,mBAAmB,CAAC;IACnC,SAAS,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;CACpF;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,IAAI,+BAA+B;IAE5C,cAGC;CACF;AA2BD,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,CAuqB9E"}

package/dist/application/opentelemetry.d.ts

@@ -0,0 +1,25 @@
+import type { Attributes, MetricOptions, ObservableGauge } from '@opentelemetry/api';
+import type { ActivityProjection } from './activity';
+import type { ApplicationHandle } from './kernel';
+import type { ManagedSchedule } from './schedule';
+export interface ApplicationTelemetryMeter {
+    createObservableGauge(name: string, options?: MetricOptions): ObservableGauge<Attributes>;
+}
+export interface ApplicationOpenTelemetryCollectionError {
+    readonly instrument: string;
+    readonly error: unknown;
+}
+export interface ApplicationOpenTelemetryConfig {
+    readonly meter: ApplicationTelemetryMeter;
+    readonly application: Pick<ApplicationHandle, 'getSnapshot'>;
+    readonly activities?: readonly Pick<ActivityProjection<string>, 'getSnapshot'>[];
+    readonly schedules?: readonly Pick<ManagedSchedule, 'status'>[];
+    onCollectionError?(failure: ApplicationOpenTelemetryCollectionError): void | Promise<void>;
+}
+export interface ApplicationOpenTelemetryBinding {
+    readonly closed: boolean;
+    close(): void;
+}
+/** Register pull-only observable gauges over canonical application snapshots. */
+export declare function createApplicationOpenTelemetry(config: ApplicationOpenTelemetryConfig): ApplicationOpenTelemetryBinding;
+//# sourceMappingURL=opentelemetry.d.ts.map

package/dist/application/opentelemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opentelemetry.d.ts","sourceRoot":"","sources":["../../src/application/opentelemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EAEb,eAAe,EAEhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAYlD,MAAM,WAAW,yBAAyB;IACxC,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;CAC3F;AAED,MAAM,WAAW,uCAAuC;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,KAAK,EAAE,yBAAyB,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC;IAC7D,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,EAAE,CAAC;IACjF,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,EAAE,CAAC;IAChE,iBAAiB,CAAC,CAAC,OAAO,EAAE,uCAAuC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5F;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,KAAK,IAAI,IAAI,CAAC;CACf;AAwOD,iFAAiF;AACjF,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,8BAA8B,GACrC,+BAA+B,CAwJjC"}

package/dist/application/schemas.d.ts

@@ -105,6 +105,48 @@ export declare const ApplicationSnapshotSchema: z.ZodReadonly<z.ZodObject<{
     }, z.core.$strip>>>>;
 }, z.core.$strip>>;
 export type ApplicationSnapshot = z.infer<typeof ApplicationSnapshotSchema>;
+/**
+ * What a probe or a status endpoint may publish.
+ *
+ * The internal snapshot names every resource and its `dependsOn` edges — the
+ * application's dependency graph — plus the process epoch and live traffic
+ * counters. That is the right shape for `getSnapshot()` and for telemetry, and
+ * the wrong shape for a URL: these handlers are meant to be mounted publicly,
+ * and an orchestrator needs a verdict, not our topology.
+ *
+ * `degraded` and `failed` counts keep the verdict actionable without saying
+ * which resource: an operator reading a probe learns that something is wrong
+ * and reaches for `getSnapshot()`, which never left the process.
+ */
+export declare const ApplicationStatusProjectionSchema: z.ZodReadonly<z.ZodObject<{
+    id: z.ZodString;
+    lifecycle: z.ZodEnum<{
+        created: "created";
+        draining: "draining";
+        failed: "failed";
+        ready: "ready";
+        starting: "starting";
+        stopped: "stopped";
+        stopping: "stopping";
+    }>;
+    health: z.ZodEnum<{
+        degraded: "degraded";
+        healthy: "healthy";
+        unhealthy: "unhealthy";
+        unknown: "unknown";
+    }>;
+    ready: z.ZodBoolean;
+    capturedAt: z.ZodString;
+    resources: z.ZodReadonly<z.ZodObject<{
+        total: z.ZodNumber;
+        ready: z.ZodNumber;
+        degraded: z.ZodNumber;
+        failed: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+export type ApplicationStatusProjection = z.infer<typeof ApplicationStatusProjectionSchema>;
+/** Project the internal snapshot onto what an endpoint may publish. */
+export declare function projectApplicationStatus(snapshot: ApplicationSnapshot): ApplicationStatusProjection;
 export declare const ApplicationResourceShutdownSchema: z.ZodReadonly<z.ZodObject<{
     id: z.ZodString;
     state: z.ZodEnum<{

package/dist/application/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/application/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB,aAIS,CAAC;AAC1C,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,0BAA0B;;;;;;;;EAQrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,uBAAuB;;;;;EAA0D,CAAC;AAC/F,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,0BAA0B;;;;;;;EAOrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAI9E,eAAO,MAAM,kCAAkC;;;;;kBAOlC,CAAC;AACd,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;kBAS7B,CAAC;AACd,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAazB,CAAC;AACd,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;kBAQjC,CAAC;AACd,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAY/B,CAAC;AACd,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/application/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB,aAIS,CAAC;AAC1C,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,0BAA0B;;;;;;;;EAQrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,uBAAuB;;;;;EAA0D,CAAC;AAC/F,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,0BAA0B;;;;;;;EAOrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAI9E,eAAO,MAAM,kCAAkC;;;;;kBAOlC,CAAC;AACd,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;kBAS7B,CAAC;AACd,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAazB,CAAC;AACd,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;kBAgBjC,CAAC;AACd,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F,uEAAuE;AACvE,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,mBAAmB,GAC5B,2BAA2B,CAoB7B;AAED,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;kBAQjC,CAAC;AACd,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAY/B,CAAC;AACd,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC"}

package/dist/application-opentelemetry.d.ts

@@ -0,0 +1,2 @@
+export { type ApplicationOpenTelemetryBinding, type ApplicationOpenTelemetryCollectionError, type ApplicationOpenTelemetryConfig, type ApplicationTelemetryMeter, createApplicationOpenTelemetry, } from './application/opentelemetry';
+//# sourceMappingURL=application-opentelemetry.d.ts.map

package/dist/application-opentelemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-opentelemetry.d.ts","sourceRoot":"","sources":["../src/application-opentelemetry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,+BAA+B,EACpC,KAAK,uCAAuC,EAC5C,KAAK,8BAA8B,EACnC,KAAK,yBAAyB,EAC9B,8BAA8B,GAC/B,MAAM,6BAA6B,CAAC"}

package/dist/application-opentelemetry.js

@@ -0,0 +1,248 @@
+import {
+  ActivitySnapshotSchema,
+  ManagedScheduleStatusSchema
+} from "./index-x8v8b7rc.js";
+import {
+  ApplicationSnapshotSchema
+} from "./index-8eywc9zv.js";
+
+// src/application/opentelemetry.ts
+var MAX_ACTIVITY_SOURCES = 64;
+var MAX_SCHEDULE_SOURCES = 64;
+var MAX_RESOURCE_SERIES = 128;
+var applicationAttributes = (snapshot) => ({
+  "application.id": snapshot.id
+});
+var resourceAttributes = (snapshot, resource) => ({
+  "application.id": snapshot.id,
+  "resource.id": resource.id,
+  "resource.required": resource.required,
+  "resource.state": resource.state,
+  "resource.health": resource.health
+});
+var scheduleAttributes = (application, schedule) => ({
+  "application.id": application.id,
+  "schedule.id": schedule.descriptor.id,
+  "schedule.state": schedule.state
+});
+var activityAttributes = (application, activity, stage) => ({
+  "application.id": application.id,
+  "activity.id": activity.id,
+  "activity.stage": stage.id
+});
+var applicationMetrics = [
+  {
+    name: "stitchkit.application.lifecycle",
+    description: "Current application lifecycle and health state.",
+    unit: "1",
+    observe(result, snapshot) {
+      result.observe(1, {
+        ...applicationAttributes(snapshot),
+        "application.lifecycle": snapshot.lifecycle,
+        "application.health": snapshot.health
+      });
+    }
+  },
+  {
+    name: "stitchkit.application.ready",
+    description: "Whether the application currently accepts readiness traffic.",
+    unit: "1",
+    observe: (result, snapshot) => result.observe(snapshot.ready ? 1 : 0, applicationAttributes(snapshot))
+  },
+  {
+    name: "stitchkit.application.admission.accepting",
+    description: "Whether application admission is currently open.",
+    unit: "1",
+    observe: (result, snapshot) => result.observe(snapshot.admission.accepting ? 1 : 0, applicationAttributes(snapshot))
+  },
+  {
+    name: "stitchkit.application.admission.accepted",
+    description: "Absolute number of operations accepted in this application lifetime.",
+    unit: "1",
+    observe: (result, snapshot) => result.observe(snapshot.admission.accepted, applicationAttributes(snapshot))
+  },
+  {
+    name: "stitchkit.application.admission.completed",
+    description: "Absolute number of operations completed in this application lifetime.",
+    unit: "1",
+    observe: (result, snapshot) => result.observe(snapshot.admission.completed, applicationAttributes(snapshot))
+  },
+  {
+    name: "stitchkit.application.admission.pending",
+    description: "Current number of admitted operations still pending.",
+    unit: "1",
+    observe: (result, snapshot) => result.observe(snapshot.admission.pending, applicationAttributes(snapshot))
+  },
+  {
+    name: "stitchkit.application.resource.ready",
+    description: "Whether each declared managed resource is currently ready.",
+    unit: "1",
+    observe(result, snapshot) {
+      for (const resource of snapshot.resources) {
+        result.observe(resource.ready ? 1 : 0, resourceAttributes(snapshot, resource));
+      }
+    }
+  }
+];
+var scheduleMetric = (name, description, value) => ({
+  name,
+  description,
+  unit: "1",
+  observe(result, snapshot) {
+    for (const schedule of snapshot.schedules) {
+      result.observe(value(schedule), scheduleAttributes(snapshot.application, schedule));
+    }
+  }
+});
+var scheduleMetrics = [
+  scheduleMetric("stitchkit.application.schedule.accepting", "Whether a schedule accepts new ticks.", (value) => value.accepting ? 1 : 0),
+  scheduleMetric("stitchkit.application.schedule.active", "Current active runs for a schedule.", (value) => value.active),
+  scheduleMetric("stitchkit.application.schedule.queued", "Whether a schedule has one queued run.", (value) => value.queued ? 1 : 0),
+  scheduleMetric("stitchkit.application.schedule.runs_started", "Absolute schedule runs started.", (value) => value.runsStarted),
+  scheduleMetric("stitchkit.application.schedule.runs_completed", "Absolute schedule runs completed.", (value) => value.runsCompleted),
+  scheduleMetric("stitchkit.application.schedule.runs_failed", "Absolute schedule runs failed.", (value) => value.runsFailed),
+  scheduleMetric("stitchkit.application.schedule.ticks_skipped", "Absolute schedule ticks skipped.", (value) => value.ticksSkipped)
+];
+var activityMetric = (name, description, value) => ({
+  name,
+  description,
+  unit: "1",
+  observe(result, snapshot) {
+    for (const activity of snapshot.activities) {
+      for (const stage of activity.stages) {
+        result.observe(value(stage), activityAttributes(snapshot.application, activity, stage));
+      }
+    }
+  }
+});
+var activityMetrics = [
+  activityMetric("stitchkit.application.activity.active", "Current active activities by stage.", (value) => value.active),
+  activityMetric("stitchkit.application.activity.queued", "Current queued activities by stage.", (value) => value.queued),
+  activityMetric("stitchkit.application.activity.completed", "Absolute completed activities by stage.", (value) => value.completed),
+  activityMetric("stitchkit.application.activity.failed", "Absolute failed activities by stage.", (value) => value.failed)
+];
+function requireUniqueIds(ids, label) {
+  if (new Set(ids).size !== ids.length) {
+    throw new Error(`[stitchkit] application OpenTelemetry ${label} ids must be unique`);
+  }
+}
+function requireStableIds(actual, expected, label) {
+  if (actual.length !== expected.length || actual.some((id, index) => id !== expected[index])) {
+    throw new Error(`[stitchkit] application OpenTelemetry ${label} ids changed after binding`);
+  }
+}
+function createApplicationOpenTelemetry(config) {
+  const activities = [...config.activities ?? []];
+  const schedules = [...config.schedules ?? []];
+  if (activities.length > MAX_ACTIVITY_SOURCES) {
+    throw new Error(`[stitchkit] application OpenTelemetry supports at most ${MAX_ACTIVITY_SOURCES} activity sources`);
+  }
+  if (schedules.length > MAX_SCHEDULE_SOURCES) {
+    throw new Error(`[stitchkit] application OpenTelemetry supports at most ${MAX_SCHEDULE_SOURCES} schedule sources`);
+  }
+  const initialApplication = ApplicationSnapshotSchema.parse(config.application.getSnapshot());
+  if (initialApplication.resources.length > MAX_RESOURCE_SERIES) {
+    throw new Error(`[stitchkit] application OpenTelemetry supports at most ${MAX_RESOURCE_SERIES} resource series`);
+  }
+  const applicationId = initialApplication.id;
+  const resourceIds = initialApplication.resources.map((resource) => resource.id);
+  const initialActivities = activities.map((source) => ActivitySnapshotSchema.parse(source.getSnapshot()));
+  const activityIds = initialActivities.map((snapshot) => snapshot.id);
+  const activityStageIds = initialActivities.map((snapshot) => snapshot.stages.map((stage) => stage.id));
+  const initialSchedules = schedules.map((source) => ManagedScheduleStatusSchema.parse(source.status));
+  const scheduleIds = initialSchedules.map((snapshot) => snapshot.descriptor.id);
+  requireUniqueIds(activityIds, "activity");
+  requireUniqueIds(scheduleIds, "schedule");
+  const registrations = [];
+  let closed = false;
+  const reportCollectionError = (instrument, error) => {
+    if (!config.onCollectionError)
+      return;
+    Promise.resolve().then(() => config.onCollectionError?.({ instrument, error })).catch(() => {});
+  };
+  const removeRegistrations = (reportErrors) => {
+    for (const registration of registrations) {
+      try {
+        registration.gauge.removeCallback(registration.callback);
+      } catch (error) {
+        if (reportErrors)
+          reportCollectionError(registration.name, error);
+      }
+    }
+  };
+  const pullApplication = () => {
+    const snapshot = ApplicationSnapshotSchema.parse(config.application.getSnapshot());
+    if (snapshot.id !== applicationId) {
+      throw new Error("[stitchkit] application OpenTelemetry application id changed after binding");
+    }
+    requireStableIds(snapshot.resources.map((resource) => resource.id), resourceIds, "resource");
+    return snapshot;
+  };
+  const pullSchedules = () => schedules.map((source, index) => {
+    const snapshot = ManagedScheduleStatusSchema.parse(source.status);
+    if (snapshot.descriptor.id !== scheduleIds[index]) {
+      throw new Error("[stitchkit] application OpenTelemetry schedule id changed after binding");
+    }
+    return snapshot;
+  });
+  const pullActivities = () => activities.map((source, index) => {
+    const snapshot = ActivitySnapshotSchema.parse(source.getSnapshot());
+    if (snapshot.id !== activityIds[index]) {
+      throw new Error("[stitchkit] application OpenTelemetry activity id changed after binding");
+    }
+    requireStableIds(snapshot.stages.map((stage) => stage.id), activityStageIds[index] ?? [], "activity stage");
+    return snapshot;
+  });
+  const register = (definition, pull) => {
+    const gauge = config.meter.createObservableGauge(definition.name, {
+      description: definition.description,
+      unit: definition.unit
+    });
+    const callback = (result) => {
+      if (closed)
+        return;
+      try {
+        definition.observe(result, pull());
+      } catch (error) {
+        reportCollectionError(definition.name, error);
+      }
+    };
+    registrations.push({ name: definition.name, gauge, callback });
+    gauge.addCallback(callback);
+  };
+  try {
+    for (const definition of applicationMetrics) {
+      register(definition, pullApplication);
+    }
+    for (const definition of scheduleMetrics) {
+      register(definition, () => ({
+        application: pullApplication(),
+        schedules: pullSchedules()
+      }));
+    }
+    for (const definition of activityMetrics) {
+      register(definition, () => ({
+        application: pullApplication(),
+        activities: pullActivities()
+      }));
+    }
+  } catch (error) {
+    closed = true;
+    removeRegistrations(false);
+    throw error;
+  }
+  return {
+    get closed() {
+      return closed;
+    },
+    close() {
+      if (closed)
+        return;
+      closed = true;
+      removeRegistrations(true);
+    }
+  };
+}
+export {
+  createApplicationOpenTelemetry
+};

package/dist/application.d.ts

@@ -1,10 +1,10 @@
-export { type ActivityId, ActivityIdSchema, type ActivityLiveState, ActivityLiveStateSchema, type ActivityProjection, type ActivityProjectionConfig, type ActivityProjectionSubscriberError, type ActivitySnapshot, ActivitySnapshotSchema, type ActivityStageId, ActivityStageIdSchema, type ActivityStageSnapshot, ActivityStageSnapshotSchema, type ActivityToken, type ActivityTransition, createActivityProjection, } from './application/activity';
+export { type ActivityId, ActivityIdSchema, type ActivityLiveState, ActivityLiveStateSchema, type ActivityProjection, type ActivityProjectionConfig, type ActivityProjectionSubscriberError, type ActivitySnapshot, ActivitySnapshotSchema, type ActivityStageId, ActivityStageIdSchema, type ActivityStageSnapshot, ActivityStageSnapshotSchema, type ActivityToken, ActivityTokenBrand, type ActivityTransition, createActivityProjection, } from './application/activity';
 export { type ApplicationEventSink, type ApplicationEventSinkConfig, type ApplicationLifecycleEvent, ApplicationLifecycleEventSchema, applicationLifecycleEvent, createApplicationEventSink, } from './application/events';
-export { type ApplicationHealthHandlerOptions, ApplicationHealthHandlerOptionsSchema, createApplicationHealthHandler, } from './application/health';
-export { type ApplicationAdmission, ApplicationAdmissionError, type ApplicationConfig, type ApplicationHandle, type ApplicationOperationLease, createApplication, } from './application/kernel';
+export { type ApplicationHealthHandlerOptions, ApplicationHealthHandlerOptionsSchema, type ApplicationOperationalHandlers, type ApplicationOperationalHandlersOptions, ApplicationOperationalHandlersOptionsSchema, createApplicationHealthHandler, createApplicationOperationalHandlers, } from './application/health';
+export { type ApplicationAdmission, ApplicationAdmissionError, type ApplicationConfig, type ApplicationHandle, type ApplicationOperationLease, type ApplicationResourceFailure, type ApplicationResourcePhase, type ApplicationShutdownOptions, ApplicationShutdownOptionsSchema, createApplication, } from './application/kernel';
 export { type ApplicationSnapshotSink, type ApplicationSnapshotSinkConfig, type ApplicationSnapshotSinkError, type ApplicationSnapshotSinkStatus, ApplicationSnapshotSinkStatusSchema, createApplicationSnapshotSink, type RevisionedApplicationSnapshot, } from './application/latest-sink';
 export { defineManagedResource, type ManagedResource, type ManagedResourceContext, type ManagedResourceStartResult, } from './application/resource';
 export { createManagedSchedule, type ManagedSchedule, type ManagedScheduleClock, type ManagedScheduleConfig, type ManagedScheduleDescriptor, ManagedScheduleDescriptorSchema, type ManagedScheduleErrorPolicy, ManagedScheduleErrorPolicySchema, type ManagedScheduleOverlap, ManagedScheduleOverlapSchema, type ManagedScheduleRunContext, type ManagedScheduleStatus, ManagedScheduleStatusSchema, type ManagedScheduleTimer, } from './application/schedule';
-export { type ApplicationAdmissionSnapshot, ApplicationAdmissionSnapshotSchema, type ApplicationHealth, ApplicationHealthSchema, type ApplicationId, ApplicationIdSchema, type ApplicationLifecycle, ApplicationLifecycleSchema, type ApplicationResourceShutdown, ApplicationResourceShutdownSchema, type ApplicationShutdownResult, ApplicationShutdownResultSchema, type ApplicationSnapshot, ApplicationSnapshotSchema, type ManagedResourceSnapshot, ManagedResourceSnapshotSchema, type ManagedResourceState, ManagedResourceStateSchema, } from './application/schemas';
+export { type ApplicationAdmissionSnapshot, ApplicationAdmissionSnapshotSchema, type ApplicationHealth, ApplicationHealthSchema, type ApplicationId, ApplicationIdSchema, type ApplicationLifecycle, ApplicationLifecycleSchema, type ApplicationResourceShutdown, ApplicationResourceShutdownSchema, type ApplicationShutdownResult, ApplicationShutdownResultSchema, type ApplicationSnapshot, ApplicationSnapshotSchema, type ApplicationStatusProjection, ApplicationStatusProjectionSchema, type ManagedResourceSnapshot, ManagedResourceSnapshotSchema, type ManagedResourceState, ManagedResourceStateSchema, projectApplicationStatus, } from './application/schemas';
 export { type ManagedServerResourceConfig, managedServerResource, } from './application/server-resource';
 //# sourceMappingURL=application.d.ts.map

package/dist/application.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../src/application.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EACf,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,iCAAiC,EACtC,KAAK,gBAAgB,EACrB,sBAAsB,EACtB,KAAK,eAAe,EACpB,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,2BAA2B,EAC3B,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,+BAA+B,EAC/B,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,+BAA+B,EACpC,qCAAqC,EACrC,8BAA8B,GAC/B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,oBAAoB,EACzB,yBAAyB,EACzB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,EAClC,mCAAmC,EACnC,6BAA6B,EAC7B,KAAK,6BAA6B,GACnC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,GAChC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,+BAA+B,EAC/B,KAAK,0BAA0B,EAC/B,gCAAgC,EAChC,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,2BAA2B,EAC3B,KAAK,oBAAoB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,4BAA4B,EACjC,kCAAkC,EAClC,KAAK,iBAAiB,EACtB,uBAAuB,EACvB,KAAK,aAAa,EAClB,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,0BAA0B,EAC1B,KAAK,2BAA2B,EAChC,iCAAiC,EACjC,KAAK,yBAAyB,EAC9B,+BAA+B,EAC/B,KAAK,mBAAmB,EACxB,yBAAyB,EACzB,KAAK,uBAAuB,EAC5B,6BAA6B,EAC7B,KAAK,oBAAoB,EACzB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,KAAK,2BAA2B,EAChC,qBAAqB,GACtB,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../src/application.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EACf,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,iCAAiC,EACtC,KAAK,gBAAgB,EACrB,sBAAsB,EACtB,KAAK,eAAe,EACpB,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,2BAA2B,EAC3B,KAAK,aAAa,EAClB,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,+BAA+B,EAC/B,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,+BAA+B,EACpC,qCAAqC,EACrC,KAAK,8BAA8B,EACnC,KAAK,qCAAqC,EAC1C,2CAA2C,EAC3C,8BAA8B,EAC9B,oCAAoC,GACrC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,oBAAoB,EACzB,yBAAyB,EACzB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,gCAAgC,EAChC,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,EAClC,mCAAmC,EACnC,6BAA6B,EAC7B,KAAK,6BAA6B,GACnC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,GAChC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,+BAA+B,EAC/B,KAAK,0BAA0B,EAC/B,gCAAgC,EAChC,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,2BAA2B,EAC3B,KAAK,oBAAoB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,4BAA4B,EACjC,kCAAkC,EAClC,KAAK,iBAAiB,EACtB,uBAAuB,EACvB,KAAK,aAAa,EAClB,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,0BAA0B,EAC1B,KAAK,2BAA2B,EAChC,iCAAiC,EACjC,KAAK,yBAAyB,EAC9B,+BAA+B,EAC/B,KAAK,mBAAmB,EACxB,yBAAyB,EACzB,KAAK,2BAA2B,EAChC,iCAAiC,EACjC,KAAK,uBAAuB,EAC5B,6BAA6B,EAC7B,KAAK,oBAAoB,EACzB,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,KAAK,2BAA2B,EAChC,qBAAqB,GACtB,MAAM,+BAA+B,CAAC"}