@kindgi/runtime 0.0.0-bootstrap.0 → 0.1.1

package/dist/runs.d.ts

@@ -0,0 +1,73 @@
+import type { Cursor, NodeId, OrgId, ProjectId, RunId, TenantId, Timestamp } from '@kindgi/types';
+import type { RunStatus } from './types.js';
+/**
+ * Public run shape exposed by `RunBinding.getRun` / `.listRuns`.
+ * Matches the fields @kindgi/api's `/v1/runs` routes serialize to
+ * the wire.
+ */
+export interface KernelRunRecord {
+    readonly runId: RunId;
+    readonly tenantId: TenantId;
+    readonly projectId: ProjectId;
+    readonly flowId: string;
+    readonly flowVersion: string;
+    readonly status: RunStatus;
+    readonly input: unknown;
+    /** The run's output once it completed — the value itself, not a storage envelope. */
+    readonly output?: unknown;
+    readonly failureMessage?: string | null;
+    readonly dryRun: boolean;
+    readonly createdAt: Timestamp;
+    readonly updatedAt: Timestamp;
+    readonly completedAt?: Timestamp | null;
+    /** Set on a child run: the parent run and the node that started it (`ParentRunRef`). */
+    readonly parentRunId?: RunId | null;
+    readonly parentNodeId?: NodeId | null;
+    readonly parentScope?: string | null;
+}
+/**
+ * Content-scope filter for `RunBinding.listRuns`. Present-with-value
+ * narrows to a specific project or org; absent = tenant-wide (admin
+ * default). An org scope includes the runs of every project in that
+ * org.
+ */
+export type RunListScope = {
+    readonly kind: 'project';
+    readonly projectId: ProjectId;
+} | {
+    readonly kind: 'org';
+    readonly orgId: OrgId;
+};
+/**
+ * Cursor position for `RunBinding.listRuns`. Sort key is
+ * `(createdAt desc, id desc)` — same discipline as every other
+ * kernel-facing list. Callers pass the opaque `Cursor` string
+ * decoded from the wire; the impl decodes it back to
+ * `{ createdAt, id }` internally.
+ */
+export interface RunListCursor {
+    readonly createdAt: Timestamp;
+    readonly id: RunId;
+}
+export interface ListRunsInput {
+    readonly tenantId: TenantId;
+    readonly scope?: RunListScope;
+    readonly limit?: number;
+    readonly cursor?: RunListCursor;
+    /**
+     * Only the children of this run — optionally only those a given node
+     * (and loop scope) started.
+     */
+    readonly parent?: {
+        readonly runId: RunId;
+        readonly nodeId?: NodeId;
+        readonly scope?: string;
+    };
+    /** Only runs that are not a child of another run. */
+    readonly topLevelOnly?: boolean;
+}
+export interface ListRunsPage {
+    readonly data: readonly KernelRunRecord[];
+    readonly nextCursor?: Cursor;
+}
+//# sourceMappingURL=runs.d.ts.map

package/dist/runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../src/runs.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAElG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,qFAAqF;IACrF,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACxC,wFAAwF;IACxF,QAAQ,CAAC,WAAW,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;CAAE,GAC3D;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE;QAChB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;QACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,qDAAqD;IACrD,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAC;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B"}

package/dist/runs.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+export {};
+//# sourceMappingURL=runs.js.map

package/dist/runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.js","sourceRoot":"","sources":["../src/runs.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC"}

package/dist/schedulers/registry.d.ts

@@ -0,0 +1,142 @@
+import type { Cursor, Result, TenantId, TriggerId } from '@kindgi/types';
+import type { CronTriggerConfig, EventTriggerConfig, WebhookTriggerConfig } from './types.js';
+export interface TriggerRegistryBinding {
+    register(input: RegisterTriggerInput): Promise<Result<TriggerRecord, RegisterTriggerError>>;
+    update(input: UpdateTriggerInput): Promise<Result<TriggerRecord, UpdateTriggerError>>;
+    list(input: ListTriggersInput): Promise<TriggerListPage>;
+    get(input: GetTriggerInput): Promise<TriggerRecord | null>;
+    pause(input: TriggerLifecycleInput): Promise<Result<TriggerRecord, TriggerLifecycleError>>;
+    resume(input: TriggerLifecycleInput): Promise<Result<TriggerRecord, TriggerLifecycleError>>;
+    unregister(input: TriggerLifecycleInput): Promise<{
+        readonly triggerId: TriggerId;
+        readonly unregistered: boolean;
+    }>;
+    /**
+     * Webhook-receiver hot path. The receiver resolves the HMAC secret
+     * named by `hmacSecretName` from the tenant's secrets (`SecretBinding`
+     * in `@kindgi/api`) and verifies the request before spawning. Returns
+     * null when webhookId is unknown, the trigger is tombstoned, or
+     * `status !== 'active'`.
+     */
+    fetchActiveByWebhookId(input: {
+        readonly tenantId: TenantId;
+        readonly webhookId: string;
+    }): Promise<WebhookTriggerRecord | null>;
+}
+export type RegisterTriggerInput = RegisterCronTriggerInput | RegisterEventTriggerInput | RegisterWebhookTriggerInput;
+export interface RegisterCronTriggerInput {
+    readonly kind: 'cron';
+    readonly tenantId: TenantId;
+    readonly flowId: string;
+    readonly flowVersion: string;
+    readonly config: CronTriggerConfig;
+    readonly label?: string;
+}
+export interface RegisterEventTriggerInput {
+    readonly kind: 'event';
+    readonly tenantId: TenantId;
+    readonly flowId: string;
+    readonly flowVersion: string;
+    readonly config: EventTriggerConfig;
+    readonly label?: string;
+}
+export interface RegisterWebhookTriggerInput {
+    readonly kind: 'webhook';
+    readonly tenantId: TenantId;
+    readonly flowId: string;
+    readonly flowVersion: string;
+    readonly config: WebhookTriggerConfig;
+    /** Caller-supplied (uuid). The routable id a webhook receiver looks the trigger up by. */
+    readonly webhookId: string;
+    /**
+     * Name of the HMAC secret in the tenant's secrets store. The caller
+     * writes the secret first (`POST /v1/secrets`); this row never holds it.
+     */
+    readonly hmacSecretName: string;
+    readonly label?: string;
+}
+export type UpdateTriggerInput = UpdateCronTriggerInput | UpdateEventTriggerInput | UpdateWebhookTriggerInput;
+interface UpdateBase {
+    readonly tenantId: TenantId;
+    readonly triggerId: TriggerId;
+    /** `null` clears the label; omitted leaves it unchanged. */
+    readonly label?: string | null;
+    /** Pin the trigger to a different flow version. */
+    readonly flowVersion?: string;
+}
+export interface UpdateCronTriggerInput extends UpdateBase {
+    readonly kind: 'cron';
+    readonly config?: Partial<CronTriggerConfig>;
+}
+export interface UpdateEventTriggerInput extends UpdateBase {
+    readonly kind: 'event';
+    readonly config?: Partial<EventTriggerConfig>;
+}
+export interface UpdateWebhookTriggerInput extends UpdateBase {
+    readonly kind: 'webhook';
+    readonly config?: Partial<WebhookTriggerConfig>;
+}
+interface TriggerRecordBase {
+    readonly triggerId: TriggerId;
+    readonly tenantId: TenantId;
+    readonly flowId: string;
+    readonly flowVersion: string;
+    readonly status: 'active' | 'paused';
+    readonly label: string | null;
+    readonly lastFiredAt: string | null;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+export interface CronTriggerRecord extends TriggerRecordBase {
+    readonly kind: 'cron';
+    readonly config: CronTriggerConfig;
+    readonly nextFireAt: string | null;
+}
+export interface EventTriggerRecord extends TriggerRecordBase {
+    readonly kind: 'event';
+    readonly config: EventTriggerConfig;
+}
+export interface WebhookTriggerRecord extends TriggerRecordBase {
+    readonly kind: 'webhook';
+    readonly config: WebhookTriggerConfig;
+    readonly webhookId: string;
+    readonly hmacSecretName: string;
+}
+export type TriggerRecord = CronTriggerRecord | EventTriggerRecord | WebhookTriggerRecord;
+export interface ListTriggersInput {
+    readonly tenantId: TenantId;
+    readonly kind?: TriggerKind;
+    readonly status?: 'active' | 'paused';
+    readonly limit?: number;
+    readonly cursor?: Cursor;
+}
+export interface TriggerListPage {
+    readonly data: readonly TriggerRecord[];
+    readonly nextCursor?: Cursor;
+}
+export interface GetTriggerInput {
+    readonly tenantId: TenantId;
+    readonly triggerId: TriggerId;
+}
+export interface TriggerLifecycleInput {
+    readonly tenantId: TenantId;
+    readonly triggerId: TriggerId;
+}
+export interface RegisterTriggerError {
+    readonly code: 'trigger-invalid-config' | 'trigger-webhook-id-conflict' | 'trigger-register-failed';
+    readonly message: string;
+}
+export interface UpdateTriggerError {
+    readonly code: 'trigger-not-found' | 'trigger-invalid-config' | 'trigger-update-failed';
+    readonly message: string;
+    readonly triggerId: TriggerId;
+}
+export interface TriggerLifecycleError {
+    readonly code: 'trigger-not-found' | 'trigger-already-in-state' | 'trigger-lifecycle-failed';
+    readonly message: string;
+    readonly triggerId: TriggerId;
+}
+export declare const TRIGGER_KINDS: readonly ["cron", "event", "webhook"];
+export type TriggerKind = (typeof TRIGGER_KINDS)[number];
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/schedulers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/schedulers/registry.ts"],"names":[],"mappings":"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"}

package/dist/schedulers/registry.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+export const TRIGGER_KINDS = ['cron', 'event', 'webhook'];
+//# sourceMappingURL=registry.js.map

package/dist/schedulers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/schedulers/registry.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAkMjC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,CAAU,CAAC"}

package/dist/schedulers/types.d.ts

@@ -0,0 +1,99 @@
+import type { EventId, Result, RunId, TenantId, TriggerId } from '@kindgi/types';
+/**
+ * What the trigger runtime hands to a caller-supplied `RunFlowBinding`.
+ *
+ * The kernel doesn't own a flow registry — resolving `flowId + flowVersion`
+ * to a concrete `Flow + HandlerRegistry` is deployment-specific (packs
+ * register at boot, dev consumers pass in inline maps, etc.). The binding
+ * shape lets any of those wire in without the kernel choosing for them.
+ */
+export interface TriggerFireContext {
+    readonly tenantId: TenantId;
+    readonly flowId: string;
+    readonly flowVersion: string;
+    /**
+     * Input to hand to `runGraph`. Shape is trigger-kind-specific:
+     *   - cron:    `config.input ?? {}` (the caller pre-shapes at register time).
+     *   - event:   the entire `Event` object — handler decides which fields
+     *              it cares about.
+     *   - webhook: parsed request body — the receiver route decides whether
+     *              to JSON.parse or hand raw bytes to the binding.
+     */
+    readonly input: unknown;
+    readonly source: TriggerSource;
+}
+/** Discriminated origin of the run spawn, useful for provenance / audit. */
+export type TriggerSource = {
+    readonly kind: 'cron';
+    readonly triggerId: TriggerId;
+} | {
+    readonly kind: 'event';
+    readonly triggerId: TriggerId;
+    readonly eventId: EventId;
+    readonly eventKind: string;
+} | {
+    readonly kind: 'webhook';
+    readonly triggerId: TriggerId;
+    readonly webhookId: string;
+};
+/**
+ * The caller-supplied hook that turns a trigger fire into a real run. The
+ * kernel calls this for every due tick, every matching event, every valid
+ * webhook receive. Deployments wire it to their own flow+handler lookup
+ * (packs manifest, in-process registry, etc.) and then call `runGraph`.
+ */
+export type RunFlowBinding = (ctx: TriggerFireContext) => Promise<Result<{
+    readonly runId: RunId;
+}, TriggerBindingError>>;
+/** Errors the caller-supplied binding is allowed to surface. */
+export interface TriggerBindingError {
+    readonly code: 'flow-not-found' | 'handler-missing' | 'run-spawn-failed';
+    readonly message: string;
+    readonly cause?: unknown;
+}
+/**
+ * Union of every error the trigger runtime primitives can return. The
+ * kind-specific shapes are declared below.
+ */
+export type TriggerError = WebhookTriggerError | CronTriggerError | EventTriggerError;
+export interface WebhookTriggerError {
+    readonly code: 'webhook-not-found' | 'webhook-signature-invalid' | 'webhook-inactive' | 'webhook-flow-not-found';
+    readonly message: string;
+    readonly webhookId: string;
+}
+export interface CronTriggerError {
+    readonly code: 'cron-config-invalid' | 'cron-flow-not-found';
+    readonly message: string;
+    readonly triggerId: TriggerId;
+}
+export interface EventTriggerError {
+    readonly code: 'event-config-invalid' | 'event-flow-not-found';
+    readonly message: string;
+    readonly triggerId: TriggerId;
+}
+/** Trigger-kind-specific config shapes, stored as each trigger's `config`. */
+export interface CronTriggerConfig {
+    /** 5- or 6-field cron expression (croner-compatible). 6-field enables second precision. */
+    readonly cronExpression: string;
+    /** IANA timezone (e.g. 'UTC', 'America/New_York'). Defaults to 'UTC'. */
+    readonly timezone?: string;
+    /** Static input handed to the flow on every fire. Absent → `{}`. */
+    readonly input?: unknown;
+}
+export interface EventTriggerConfig {
+    /** Event type filter (matched against `event.type`). */
+    readonly eventKind: string;
+    /**
+     * Optional input override. When absent, the entire `Event` object is
+     * passed as the flow input.
+     */
+    readonly input?: unknown;
+}
+export interface WebhookTriggerConfig {
+    /**
+     * Optional input override. When absent, the parsed request body (as
+     * passed to `fireByWebhookId`) is used as the flow input.
+     */
+    readonly input?: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/schedulers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/schedulers/types.ts"],"names":[],"mappings":"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"}

package/dist/schedulers/types.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/schedulers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/schedulers/types.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC"}