@fideliosai/shared 2026.331.0-canary.0

package/dist/types/plugin.d.ts

@@ -0,0 +1,419 @@
+import type { PluginStatus, PluginCategory, PluginCapability, PluginUiSlotType, PluginUiSlotEntityType, PluginStateScopeKind, PluginLauncherPlacementZone, PluginLauncherAction, PluginLauncherBounds, PluginLauncherRenderEnvironment } from "../constants.js";
+/**
+ * A JSON Schema object used for plugin config schemas and tool parameter schemas.
+ * Plugins provide these as plain JSON Schema compatible objects.
+ */
+export type JsonSchema = Record<string, unknown>;
+/**
+ * Declares a scheduled job a plugin can run.
+ *
+ * @see PLUGIN_SPEC.md §17 — Scheduled Jobs
+ */
+export interface PluginJobDeclaration {
+    /** Stable identifier for this job, unique within the plugin. */
+    jobKey: string;
+    /** Human-readable name shown in the operator UI. */
+    displayName: string;
+    /** Optional description of what the job does. */
+    description?: string;
+    /** Cron expression for the schedule (e.g. "star/15 star star star star" or "0 * * * *"). */
+    schedule?: string;
+}
+/**
+ * Declares a webhook endpoint the plugin can receive.
+ * Route: `POST /api/plugins/:pluginId/webhooks/:endpointKey`
+ *
+ * @see PLUGIN_SPEC.md §18 — Webhooks
+ */
+export interface PluginWebhookDeclaration {
+    /** Stable identifier for this endpoint, unique within the plugin. */
+    endpointKey: string;
+    /** Human-readable name shown in the operator UI. */
+    displayName: string;
+    /** Optional description of what this webhook handles. */
+    description?: string;
+}
+/**
+ * Declares an agent tool contributed by the plugin. Tools are namespaced
+ * by plugin ID at runtime (e.g. `linear:search-issues`).
+ *
+ * Requires the `agent.tools.register` capability.
+ *
+ * @see PLUGIN_SPEC.md §11 — Agent Tools
+ */
+export interface PluginToolDeclaration {
+    /** Tool name, unique within the plugin. Namespaced by plugin ID at runtime. */
+    name: string;
+    /** Human-readable name shown to agents and in the UI. */
+    displayName: string;
+    /** Description provided to the agent so it knows when to use this tool. */
+    description: string;
+    /** JSON Schema describing the tool's input parameters. */
+    parametersSchema: JsonSchema;
+}
+/**
+ * Declares a UI extension slot the plugin fills with a React component.
+ *
+ * @see PLUGIN_SPEC.md §19 — UI Extension Model
+ */
+export interface PluginUiSlotDeclaration {
+    /** The type of UI mount point (page, detailTab, taskDetailView, toolbarButton, etc.). */
+    type: PluginUiSlotType;
+    /** Unique slot identifier within the plugin. */
+    id: string;
+    /** Human-readable name shown in navigation or tab labels. */
+    displayName: string;
+    /** Which export name in the UI bundle provides this component. */
+    exportName: string;
+    /**
+     * Entity targets for context-sensitive slots.
+     * Required for `detailTab`, `taskDetailView`, and `contextMenuItem`.
+     */
+    entityTypes?: PluginUiSlotEntityType[];
+    /**
+     * Optional company-scoped route segment for page slots.
+     * Example: `kitchensink` becomes `/:companyPrefix/kitchensink`.
+     */
+    routePath?: string;
+    /**
+     * Optional ordering hint within a slot surface. Lower numbers appear first.
+     * Defaults to host-defined ordering if omitted.
+     */
+    order?: number;
+}
+/**
+ * Describes the action triggered by a plugin launcher surface.
+ */
+export interface PluginLauncherActionDeclaration {
+    /** What kind of launch behavior the host should perform. */
+    type: PluginLauncherAction;
+    /**
+     * Stable target identifier or URL. The meaning depends on `type`
+     * (for example a route, tab key, action key, or external URL).
+     */
+    target: string;
+    /** Optional arbitrary parameters passed along to the target. */
+    params?: Record<string, unknown>;
+}
+/**
+ * Optional render metadata for the destination opened by a launcher.
+ */
+export interface PluginLauncherRenderDeclaration {
+    /** High-level container the launcher expects the host to use. */
+    environment: PluginLauncherRenderEnvironment;
+    /** Optional size hint for the destination surface. */
+    bounds?: PluginLauncherBounds;
+}
+/**
+ * Serializable runtime snapshot of the host launcher/container environment.
+ */
+export interface PluginLauncherRenderContextSnapshot {
+    /** The current launcher/container environment selected by the host. */
+    environment: PluginLauncherRenderEnvironment | null;
+    /** Launcher id that opened this surface, if any. */
+    launcherId: string | null;
+    /** Current host-applied bounds hint for the environment, if any. */
+    bounds: PluginLauncherBounds | null;
+}
+/**
+ * Declares a plugin launcher surface independent of the low-level slot
+ * implementation that mounts it.
+ */
+export interface PluginLauncherDeclaration {
+    /** Stable identifier for this launcher, unique within the plugin. */
+    id: string;
+    /** Human-readable label shown for the launcher. */
+    displayName: string;
+    /** Optional description for operator-facing docs or future UI affordances. */
+    description?: string;
+    /** Where in the host UI this launcher should be placed. */
+    placementZone: PluginLauncherPlacementZone;
+    /** Optional export name in the UI bundle when the launcher has custom UI. */
+    exportName?: string;
+    /**
+     * Optional entity targeting for context-sensitive launcher zones.
+     * Reuses the same entity union as UI slots for consistency.
+     */
+    entityTypes?: PluginUiSlotEntityType[];
+    /** Optional ordering hint within the placement zone. */
+    order?: number;
+    /** What should happen when the launcher is activated. */
+    action: PluginLauncherActionDeclaration;
+    /** Optional render/container hints for the launched destination. */
+    render?: PluginLauncherRenderDeclaration;
+}
+/**
+ * Lower-bound semver requirement for the FideliOS host.
+ *
+ * The host should reject installation when its running version is lower than
+ * the declared minimum.
+ */
+export type PluginMinimumHostVersion = string;
+/**
+ * Groups plugin UI declarations that are served from the shared UI bundle
+ * root declared in `entrypoints.ui`.
+ */
+export interface PluginUiDeclaration {
+    /** UI extension slots this plugin fills. */
+    slots?: PluginUiSlotDeclaration[];
+    /** Declarative launcher metadata for host-mounted plugin entry points. */
+    launchers?: PluginLauncherDeclaration[];
+}
+/**
+ * The manifest shape every plugin package must export.
+ * See PLUGIN_SPEC.md §10.1 for the normative definition.
+ */
+export interface FideliOSPluginManifestV1 {
+    /** Globally unique plugin identifier (e.g. `"acme.linear-sync"`). Must be lowercase alphanumeric with dots, hyphens, or underscores. */
+    id: string;
+    /** Plugin API version. Must be `1` for the current spec. */
+    apiVersion: 1;
+    /** Semver version of the plugin package (e.g. `"1.2.0"`). */
+    version: string;
+    /** Human-readable name (max 100 chars). */
+    displayName: string;
+    /** Short description (max 500 chars). */
+    description: string;
+    /** Author name (max 200 chars). May include email in angle brackets, e.g. `"Jane Doe <jane@example.com>"`. */
+    author: string;
+    /** One or more categories classifying this plugin. */
+    categories: PluginCategory[];
+    /**
+     * Minimum host version required (semver lower bound).
+     * Preferred generic field for new manifests.
+     */
+    minimumHostVersion?: PluginMinimumHostVersion;
+    /**
+     * Legacy alias for `minimumHostVersion`.
+     * Kept for backwards compatibility with existing manifests and docs.
+     */
+    minimumFideliOSVersion?: PluginMinimumHostVersion;
+    /** Capabilities this plugin requires from the host. Enforced at runtime. */
+    capabilities: PluginCapability[];
+    /** Entrypoint paths relative to the package root. */
+    entrypoints: {
+        /** Path to the worker entrypoint (required). */
+        worker: string;
+        /** Path to the UI bundle directory (required when `ui.slots` is declared). */
+        ui?: string;
+    };
+    /** JSON Schema for operator-editable instance configuration. */
+    instanceConfigSchema?: JsonSchema;
+    /** Scheduled jobs this plugin declares. Requires `jobs.schedule` capability. */
+    jobs?: PluginJobDeclaration[];
+    /** Webhook endpoints this plugin declares. Requires `webhooks.receive` capability. */
+    webhooks?: PluginWebhookDeclaration[];
+    /** Agent tools this plugin contributes. Requires `agent.tools.register` capability. */
+    tools?: PluginToolDeclaration[];
+    /**
+     * Legacy top-level launcher declarations.
+     * Prefer `ui.launchers` for new manifests.
+     */
+    launchers?: PluginLauncherDeclaration[];
+    /** UI bundle declarations. Requires `entrypoints.ui` when populated. */
+    ui?: PluginUiDeclaration;
+}
+/**
+ * Domain type for an installed plugin as persisted in the `plugins` table.
+ * See PLUGIN_SPEC.md §21.3 for the schema definition.
+ */
+export interface PluginRecord {
+    /** UUID primary key. */
+    id: string;
+    /** Unique key derived from `manifest.id`. Used for lookups. */
+    pluginKey: string;
+    /** npm package name (e.g. `"@acme/plugin-linear"`). */
+    packageName: string;
+    /** Installed semver version. */
+    version: string;
+    /** Plugin API version from the manifest. */
+    apiVersion: number;
+    /** Plugin categories from the manifest. */
+    categories: PluginCategory[];
+    /** Full manifest snapshot persisted at install/upgrade time. */
+    manifestJson: FideliOSPluginManifestV1;
+    /** Current lifecycle status. */
+    status: PluginStatus;
+    /** Deterministic load order (null if not yet assigned). */
+    installOrder: number | null;
+    /** Resolved package path for local-path installs; used to find worker entrypoint. */
+    packagePath: string | null;
+    /** Most recent error message, or operator-provided disable reason. */
+    lastError: string | null;
+    /** Timestamp when the plugin was first installed. */
+    installedAt: Date;
+    /** Timestamp of the most recent status or metadata change. */
+    updatedAt: Date;
+}
+/**
+ * Domain type for a single scoped key-value entry in the `plugin_state` table.
+ * Plugins read and write these entries through `ctx.state` in the SDK.
+ *
+ * The five-part composite key `(pluginId, scopeKind, scopeId, namespace, stateKey)`
+ * uniquely identifies a state entry.
+ *
+ * @see PLUGIN_SPEC.md §21.3 — `plugin_state`
+ */
+export interface PluginStateRecord {
+    /** UUID primary key. */
+    id: string;
+    /** FK to `plugins.id`. */
+    pluginId: string;
+    /** Granularity of the scope. */
+    scopeKind: PluginStateScopeKind;
+    /**
+     * UUID or text identifier for the scoped object.
+     * `null` for `instance` scope (no associated entity).
+     */
+    scopeId: string | null;
+    /**
+     * Sub-namespace within the scope to avoid key collisions.
+     * Defaults to `"default"` if not explicitly set by the plugin.
+     */
+    namespace: string;
+    /** The key for this state entry within the namespace. */
+    stateKey: string;
+    /** Stored JSON value. May be any JSON-serializable type. */
+    valueJson: unknown;
+    /** Timestamp of the most recent write. */
+    updatedAt: Date;
+}
+/**
+ * Domain type for a plugin's instance configuration as persisted in the
+ * `plugin_config` table.
+ * See PLUGIN_SPEC.md §21.3 for the schema definition.
+ */
+export interface PluginConfig {
+    /** UUID primary key. */
+    id: string;
+    /** FK to `plugins.id`. Unique — each plugin has at most one config row. */
+    pluginId: string;
+    /** Operator-provided configuration values (validated against `instanceConfigSchema`). */
+    configJson: Record<string, unknown>;
+    /** Most recent config validation error, if any. */
+    lastError: string | null;
+    /** Timestamp when the config row was created. */
+    createdAt: Date;
+    /** Timestamp of the most recent config update. */
+    updatedAt: Date;
+}
+/**
+ * Query filter for `ctx.entities.list`.
+ */
+export interface PluginEntityQuery {
+    /** Optional filter by entity type (e.g. 'project', 'issue'). */
+    entityType?: string;
+    /** Optional filter by external system identifier. */
+    externalId?: string;
+    /** Maximum number of records to return. Defaults to 100. */
+    limit?: number;
+    /** Number of records to skip. Defaults to 0. */
+    offset?: number;
+}
+/**
+ * Domain type for an external entity mapping as persisted in the `plugin_entities` table.
+ */
+export interface PluginEntityRecord {
+    /** UUID primary key. */
+    id: string;
+    /** FK to `plugins.id`. */
+    pluginId: string;
+    /** Plugin-defined entity type. */
+    entityType: string;
+    /** Scope where this entity lives. */
+    scopeKind: PluginStateScopeKind;
+    /** UUID or text identifier for the scoped object. */
+    scopeId: string | null;
+    /** External identifier in the remote system. */
+    externalId: string | null;
+    /** Human-readable title. */
+    title: string | null;
+    /** Optional status string. */
+    status: string | null;
+    /** Full entity data blob. */
+    data: Record<string, unknown>;
+    /** ISO 8601 creation timestamp. */
+    createdAt: Date;
+    /** ISO 8601 last-updated timestamp. */
+    updatedAt: Date;
+}
+/**
+ * Domain type for a registered plugin job as persisted in the `plugin_jobs` table.
+ */
+export interface PluginJobRecord {
+    /** UUID primary key. */
+    id: string;
+    /** FK to `plugins.id`. */
+    pluginId: string;
+    /** Job key matching the manifest declaration. */
+    jobKey: string;
+    /** Cron expression for the schedule. */
+    schedule: string;
+    /** Current job status. */
+    status: "active" | "paused" | "failed";
+    /** Last time the job was executed. */
+    lastRunAt: Date | null;
+    /** Next scheduled execution time. */
+    nextRunAt: Date | null;
+    /** ISO 8601 creation timestamp. */
+    createdAt: Date;
+    /** ISO 8601 last-updated timestamp. */
+    updatedAt: Date;
+}
+/**
+ * Domain type for a job execution history record.
+ */
+export interface PluginJobRunRecord {
+    /** UUID primary key. */
+    id: string;
+    /** FK to `plugin_jobs.id`. */
+    jobId: string;
+    /** FK to `plugins.id`. */
+    pluginId: string;
+    /** What triggered this run. */
+    trigger: "schedule" | "manual" | "retry";
+    /** Current run status. */
+    status: "pending" | "queued" | "running" | "succeeded" | "failed" | "cancelled";
+    /** Run duration in milliseconds. */
+    durationMs: number | null;
+    /** Error message if the run failed. */
+    error: string | null;
+    /** Run logs. */
+    logs: string[];
+    /** ISO 8601 start timestamp. */
+    startedAt: Date | null;
+    /** ISO 8601 finish timestamp. */
+    finishedAt: Date | null;
+    /** ISO 8601 creation timestamp. */
+    createdAt: Date;
+}
+/**
+ * Domain type for an inbound webhook delivery record.
+ */
+export interface PluginWebhookDeliveryRecord {
+    /** UUID primary key. */
+    id: string;
+    /** FK to `plugins.id`. */
+    pluginId: string;
+    /** Webhook endpoint key matching the manifest. */
+    webhookKey: string;
+    /** External identifier from the remote system. */
+    externalId: string | null;
+    /** Delivery status. */
+    status: "pending" | "success" | "failed";
+    /** Processing duration in milliseconds. */
+    durationMs: number | null;
+    /** Error message if processing failed. */
+    error: string | null;
+    /** Webhook payload. */
+    payload: Record<string, unknown>;
+    /** Webhook headers. */
+    headers: Record<string, string>;
+    /** ISO 8601 start timestamp. */
+    startedAt: Date | null;
+    /** ISO 8601 finish timestamp. */
+    finishedAt: Date | null;
+    /** ISO 8601 creation timestamp. */
+    createdAt: Date;
+}
+//# sourceMappingURL=plugin.d.ts.map

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

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

package/dist/types/plugin.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin.js.map

package/dist/types/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":""}

package/dist/types/project.d.ts

@@ -0,0 +1,67 @@
+import type { PauseReason, ProjectStatus } from "../constants.js";
+import type { ProjectExecutionWorkspacePolicy, WorkspaceRuntimeService } from "./workspace-runtime.js";
+export type ProjectWorkspaceSourceType = "local_path" | "git_repo" | "remote_managed" | "non_git_path";
+export type ProjectWorkspaceVisibility = "default" | "advanced";
+export interface ProjectGoalRef {
+    id: string;
+    title: string;
+}
+export interface ProjectWorkspace {
+    id: string;
+    companyId: string;
+    projectId: string;
+    name: string;
+    sourceType: ProjectWorkspaceSourceType;
+    cwd: string | null;
+    repoUrl: string | null;
+    repoRef: string | null;
+    defaultRef: string | null;
+    visibility: ProjectWorkspaceVisibility;
+    setupCommand: string | null;
+    cleanupCommand: string | null;
+    remoteProvider: string | null;
+    remoteWorkspaceRef: string | null;
+    sharedWorkspaceKey: string | null;
+    metadata: Record<string, unknown> | null;
+    isPrimary: boolean;
+    runtimeServices?: WorkspaceRuntimeService[];
+    createdAt: Date;
+    updatedAt: Date;
+}
+export type ProjectCodebaseOrigin = "local_folder" | "managed_checkout";
+export interface ProjectCodebase {
+    workspaceId: string | null;
+    repoUrl: string | null;
+    repoRef: string | null;
+    defaultRef: string | null;
+    repoName: string | null;
+    localFolder: string | null;
+    managedFolder: string;
+    effectiveLocalFolder: string;
+    origin: ProjectCodebaseOrigin;
+}
+export interface Project {
+    id: string;
+    companyId: string;
+    urlKey: string;
+    /** @deprecated Use goalIds / goals instead */
+    goalId: string | null;
+    goalIds: string[];
+    goals: ProjectGoalRef[];
+    name: string;
+    description: string | null;
+    status: ProjectStatus;
+    leadAgentId: string | null;
+    targetDate: string | null;
+    color: string | null;
+    pauseReason: PauseReason | null;
+    pausedAt: Date | null;
+    executionWorkspacePolicy: ProjectExecutionWorkspacePolicy | null;
+    codebase: ProjectCodebase;
+    workspaces: ProjectWorkspace[];
+    primaryWorkspace: ProjectWorkspace | null;
+    archivedAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=project.d.ts.map

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

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

package/dist/types/project.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=project.js.map

package/dist/types/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/types/project.ts"],"names":[],"mappings":""}

package/dist/types/quota.d.ts

@@ -0,0 +1,26 @@
+/** a single rate-limit or usage window returned by a provider quota API */
+export interface QuotaWindow {
+    /** human label, e.g. "5h", "7d", "Sonnet 7d", "Credits" */
+    label: string;
+    /** percent of the window already consumed (0-100), null when not reported */
+    usedPercent: number | null;
+    /** iso timestamp when this window resets, null when not reported */
+    resetsAt: string | null;
+    /** free-form value label for credit-style windows, e.g. "$4.20 remaining" */
+    valueLabel: string | null;
+    /** optional supporting text, e.g. reset details or provider-specific notes */
+    detail?: string | null;
+}
+/** result for one provider from the quota-windows endpoint */
+export interface ProviderQuotaResult {
+    /** provider slug, e.g. "anthropic", "openai" */
+    provider: string;
+    /** source label when the provider reports where the quota data came from */
+    source?: string | null;
+    /** true when the fetch succeeded and windows is populated */
+    ok: boolean;
+    /** error message when ok is false */
+    error?: string;
+    windows: QuotaWindow[];
+}
+//# sourceMappingURL=quota.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quota.d.ts","sourceRoot":"","sources":["../../src/types/quota.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,oEAAoE;IACpE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,8DAA8D;AAC9D,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,6DAA6D;IAC7D,EAAE,EAAE,OAAO,CAAC;IACZ,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB"}

package/dist/types/quota.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=quota.js.map

package/dist/types/quota.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota.js","sourceRoot":"","sources":["../../src/types/quota.ts"],"names":[],"mappings":""}

package/dist/types/routine.d.ts

@@ -0,0 +1,113 @@
+import type { IssueOriginKind } from "../constants.js";
+export interface RoutineProjectSummary {
+    id: string;
+    name: string;
+    description: string | null;
+    status: string;
+    goalId?: string | null;
+}
+export interface RoutineAgentSummary {
+    id: string;
+    name: string;
+    role: string;
+    title: string | null;
+    urlKey?: string | null;
+}
+export interface RoutineIssueSummary {
+    id: string;
+    identifier: string | null;
+    title: string;
+    status: string;
+    priority: string;
+    updatedAt: Date;
+}
+export interface Routine {
+    id: string;
+    companyId: string;
+    projectId: string;
+    goalId: string | null;
+    parentIssueId: string | null;
+    title: string;
+    description: string | null;
+    assigneeAgentId: string;
+    priority: string;
+    status: string;
+    concurrencyPolicy: string;
+    catchUpPolicy: string;
+    createdByAgentId: string | null;
+    createdByUserId: string | null;
+    updatedByAgentId: string | null;
+    updatedByUserId: string | null;
+    lastTriggeredAt: Date | null;
+    lastEnqueuedAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface RoutineTrigger {
+    id: string;
+    companyId: string;
+    routineId: string;
+    kind: string;
+    label: string | null;
+    enabled: boolean;
+    cronExpression: string | null;
+    timezone: string | null;
+    nextRunAt: Date | null;
+    lastFiredAt: Date | null;
+    publicId: string | null;
+    secretId: string | null;
+    signingMode: string | null;
+    replayWindowSec: number | null;
+    lastRotatedAt: Date | null;
+    lastResult: string | null;
+    createdByAgentId: string | null;
+    createdByUserId: string | null;
+    updatedByAgentId: string | null;
+    updatedByUserId: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface RoutineRun {
+    id: string;
+    companyId: string;
+    routineId: string;
+    triggerId: string | null;
+    source: string;
+    status: string;
+    triggeredAt: Date;
+    idempotencyKey: string | null;
+    triggerPayload: Record<string, unknown> | null;
+    linkedIssueId: string | null;
+    coalescedIntoRunId: string | null;
+    failureReason: string | null;
+    completedAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface RoutineTriggerSecretMaterial {
+    webhookUrl: string;
+    webhookSecret: string;
+}
+export interface RoutineDetail extends Routine {
+    project: RoutineProjectSummary | null;
+    assignee: RoutineAgentSummary | null;
+    parentIssue: RoutineIssueSummary | null;
+    triggers: RoutineTrigger[];
+    recentRuns: RoutineRunSummary[];
+    activeIssue: RoutineIssueSummary | null;
+}
+export interface RoutineRunSummary extends RoutineRun {
+    linkedIssue: RoutineIssueSummary | null;
+    trigger: Pick<RoutineTrigger, "id" | "kind" | "label"> | null;
+}
+export interface RoutineExecutionIssueOrigin {
+    kind: Extract<IssueOriginKind, "routine_execution">;
+    routineId: string;
+    runId: string | null;
+}
+export interface RoutineListItem extends Routine {
+    triggers: Pick<RoutineTrigger, "id" | "kind" | "label" | "enabled" | "nextRunAt" | "lastFiredAt" | "lastResult">[];
+    lastRun: RoutineRunSummary | null;
+    activeIssue: RoutineIssueSummary | null;
+}
+//# sourceMappingURL=routine.d.ts.map