@hexclave/js 1.0.70 → 1.0.71

package/dist/lib/hexclave-app/index.d.ts

@@ -3,9 +3,10 @@ import { S as AdminSentEmail, b as AdminEmailOutboxStatus, d as AdminEmailOutbox
 import { a as InternalApiKeyFirstView, i as InternalApiKeyCreateOptions, n as InternalApiKeyBase, r as InternalApiKeyBaseCrudRead, t as InternalApiKey } from "../../index-TUtJOdMm.js";
 import { a as AdminTeamPermission, c as AdminTeamPermissionDefinitionUpdateOptions, i as AdminProjectPermissionDefinitionUpdateOptions, n as AdminProjectPermissionDefinition, o as AdminTeamPermissionDefinition, r as AdminProjectPermissionDefinitionCreateOptions, s as AdminTeamPermissionDefinitionCreateOptions, t as AdminProjectPermission } from "../../index-DSzMf-rS.js";
 import { a as PlanUsageRow, i as PlanUsagePlanId, n as PlanUsageKind, r as PlanUsageNextPlanId, t as PlanUsage } from "../../index-B594jg4e.js";
+import { a as AdminWorkflowRunState, c as AdminWorkflowStepAttempt, d as AdminWorkflowUpgradeResult, f as AdminWorkflowVersion, i as AdminWorkflowRunDetails, l as AdminWorkflowSyncResult, n as AdminWorkflowDivergenceDiagnostic, o as AdminWorkflowRunsFilter, r as AdminWorkflowRun, s as AdminWorkflowStep, t as AdminWorkflow, u as AdminWorkflowTrigger } from "../../workflows-DEb7pIuQ.js";
 import { r as OAuthConnection, t as Connection } from "../../index-ClBTM-St.js";
 import { i as ServerContactChannel, t as ContactChannel } from "../../index-DN04TjLM.js";
-import { $ as TeamCreateOptions, B as StackServerAppConstructor, D as HexclaveAdminApp, E as EmailOutboxUpdateOptions, F as StackAdminAppConstructorOptions, H as EditableTeamMemberProfile, I as HexclaveServerApp, J as ServerTeamCreateOptions, K as ServerListUsersOptions, L as HexclaveServerAppConstructor, N as StackAdminApp, O as HexclaveAdminAppConstructor, Ot as User, P as StackAdminAppConstructor, Q as Team, R as HexclaveServerAppConstructorOptions, St as ServerUser, T as EmailOutboxListResult, U as ReceivedTeamInvitation, V as StackServerAppConstructorOptions, W as SentTeamInvitation, X as ServerTeamUpdateOptions, Y as ServerTeamMemberProfile, Z as ServerTeamUser, _ as AdminProjectCreateOptions, _t as OAuthProvider, a as StackClientApp, c as StackClientAppJson, d as AdminDeploymentEnvVarOptions, et as TeamInvitation, f as AdminDeploymentRunJson, ft as CurrentInternalServerUser, g as AdminProject, h as AdminOwnedProject, ht as CurrentUser, i as HexclaveClientAppJson, it as TeamUser, k as HexclaveAdminAppConstructorOptions, l as AdminDeploymentDomainJson, m as AdminDeploymentServiceJson, mt as CurrentServerUser, n as HexclaveClientAppConstructor, o as StackClientAppConstructor, p as AdminDeploymentServiceBuildOptions, pt as CurrentInternalUser, q as ServerTeam, r as HexclaveClientAppConstructorOptions, rt as TeamUpdateOptions, s as StackClientAppConstructorOptions, t as HexclaveClientApp, tt as TeamMemberProfile, u as AdminDeploymentEnvVarJson, ut as Auth, v as AdminProjectUpdateOptions, w as EmailOutboxListOptions, x as PushedConfigSource, xt as ServerOAuthProvider, y as Project, z as StackServerApp } from "../../client-app-DBcv6rRn.js";
+import { $ as TeamCreateOptions, B as StackServerAppConstructor, D as HexclaveAdminApp, E as EmailOutboxUpdateOptions, F as StackAdminAppConstructorOptions, H as EditableTeamMemberProfile, I as HexclaveServerApp, J as ServerTeamCreateOptions, K as ServerListUsersOptions, L as HexclaveServerAppConstructor, N as StackAdminApp, O as HexclaveAdminAppConstructor, Ot as User, P as StackAdminAppConstructor, Q as Team, R as HexclaveServerAppConstructorOptions, St as ServerUser, T as EmailOutboxListResult, U as ReceivedTeamInvitation, V as StackServerAppConstructorOptions, W as SentTeamInvitation, X as ServerTeamUpdateOptions, Y as ServerTeamMemberProfile, Z as ServerTeamUser, _ as AdminProjectCreateOptions, _t as OAuthProvider, a as StackClientApp, c as StackClientAppJson, d as AdminDeploymentEnvVarOptions, et as TeamInvitation, f as AdminDeploymentRunJson, ft as CurrentInternalServerUser, g as AdminProject, h as AdminOwnedProject, ht as CurrentUser, i as HexclaveClientAppJson, it as TeamUser, k as HexclaveAdminAppConstructorOptions, l as AdminDeploymentDomainJson, m as AdminDeploymentServiceJson, mt as CurrentServerUser, n as HexclaveClientAppConstructor, o as StackClientAppConstructor, p as AdminDeploymentServiceBuildOptions, pt as CurrentInternalUser, q as ServerTeam, r as HexclaveClientAppConstructorOptions, rt as TeamUpdateOptions, s as StackClientAppConstructorOptions, t as HexclaveClientApp, tt as TeamMemberProfile, u as AdminDeploymentEnvVarJson, ut as Auth, v as AdminProjectUpdateOptions, w as EmailOutboxListOptions, x as PushedConfigSource, xt as ServerOAuthProvider, y as Project, z as StackServerApp } from "../../client-app-C42iaDoZ.js";
 import { a as AdminProjectConfigUpdateOptions, i as AdminProjectConfig, n as AdminEmailConfig, o as OAuthProviderConfig, r as AdminOAuthProviderConfig, s as ProjectConfig, t as AdminDomainConfig } from "../../index-Dq4xsW7_.js";
 import { r as getPagePrompt } from "../../url-targets-BJgkwPGW.js";
-export { type AdminDeploymentDomainJson, type AdminDeploymentEnvVarJson, type AdminDeploymentEnvVarOptions, type AdminDeploymentRunJson, type AdminDeploymentServiceBuildOptions, type AdminDeploymentServiceJson, type AdminDomainConfig, type AdminEmailConfig, type AdminEmailOutbox, type AdminEmailOutboxRecipient, type AdminEmailOutboxSimpleStatus, type AdminEmailOutboxStatus, type AdminOAuthProviderConfig, type AdminOwnedProject, type AdminProject, type AdminProjectConfig, type AdminProjectConfigUpdateOptions, type AdminProjectCreateOptions, type AdminProjectPermission, type AdminProjectPermissionDefinition, type AdminProjectPermissionDefinitionCreateOptions, type AdminProjectPermissionDefinitionUpdateOptions, type AdminProjectUpdateOptions, type AdminSendAttemptError, type AdminSentEmail, type AdminTeamPermission, type AdminTeamPermissionDefinition, type AdminTeamPermissionDefinitionCreateOptions, type AdminTeamPermissionDefinitionUpdateOptions, type Auth, type Connection, type ContactChannel, type CurrentInternalServerUser, type CurrentInternalUser, type CurrentServerUser, type CurrentUser, type EditableTeamMemberProfile, type EmailOutboxListOptions, type EmailOutboxListResult, type EmailOutboxUpdateOptions, type GetCurrentUserOptions, type GetCurrentUserOptions as GetUserOptions, type HandlerUrlOptions, type HandlerUrls, HexclaveAdminApp, type HexclaveAdminAppConstructor, type HexclaveAdminAppConstructorOptions, HexclaveClientApp, type HexclaveClientAppConstructor, type HexclaveClientAppConstructorOptions, type HexclaveClientAppJson, HexclaveServerApp, type HexclaveServerAppConstructor, type HexclaveServerAppConstructorOptions, type InternalApiKey, type InternalApiKeyBase, type InternalApiKeyBaseCrudRead, type InternalApiKeyCreateOptions, type InternalApiKeyFirstView, type OAuthConnection, type OAuthProvider, type OAuthProviderConfig, type OAuthScopesOnSignIn, type PlanUsage, type PlanUsageKind, type PlanUsageNextPlanId, type PlanUsagePlanId, type PlanUsageRow, type Project, type ProjectConfig, type PushedConfigSource, type ReceivedTeamInvitation, type ResolvedHandlerUrls, type SentTeamInvitation, type ServerContactChannel, type ServerListUsersOptions, type ServerOAuthProvider, type ServerTeam, type ServerTeamCreateOptions, type ServerTeamMemberProfile, type ServerTeamUpdateOptions, type ServerTeamUser, type ServerUser, StackAdminApp, type StackAdminAppConstructor, type StackAdminAppConstructorOptions, StackClientApp, type StackClientAppConstructor, type StackClientAppConstructorOptions, type StackClientAppJson, StackServerApp, type StackServerAppConstructor, type StackServerAppConstructorOptions, type Team, type TeamCreateOptions, type TeamInvitation, type TeamMemberProfile, type TeamUpdateOptions, type TeamUser, type User, getPagePrompt, hexclaveAppInternalsSymbol };
+export { type AdminDeploymentDomainJson, type AdminDeploymentEnvVarJson, type AdminDeploymentEnvVarOptions, type AdminDeploymentRunJson, type AdminDeploymentServiceBuildOptions, type AdminDeploymentServiceJson, type AdminDomainConfig, type AdminEmailConfig, type AdminEmailOutbox, type AdminEmailOutboxRecipient, type AdminEmailOutboxSimpleStatus, type AdminEmailOutboxStatus, type AdminOAuthProviderConfig, type AdminOwnedProject, type AdminProject, type AdminProjectConfig, type AdminProjectConfigUpdateOptions, type AdminProjectCreateOptions, type AdminProjectPermission, type AdminProjectPermissionDefinition, type AdminProjectPermissionDefinitionCreateOptions, type AdminProjectPermissionDefinitionUpdateOptions, type AdminProjectUpdateOptions, type AdminSendAttemptError, type AdminSentEmail, type AdminTeamPermission, type AdminTeamPermissionDefinition, type AdminTeamPermissionDefinitionCreateOptions, type AdminTeamPermissionDefinitionUpdateOptions, type AdminWorkflow, type AdminWorkflowDivergenceDiagnostic, type AdminWorkflowRun, type AdminWorkflowRunDetails, type AdminWorkflowRunState, type AdminWorkflowRunsFilter, type AdminWorkflowStep, type AdminWorkflowStepAttempt, type AdminWorkflowSyncResult, type AdminWorkflowTrigger, type AdminWorkflowUpgradeResult, type AdminWorkflowVersion, type Auth, type Connection, type ContactChannel, type CurrentInternalServerUser, type CurrentInternalUser, type CurrentServerUser, type CurrentUser, type EditableTeamMemberProfile, type EmailOutboxListOptions, type EmailOutboxListResult, type EmailOutboxUpdateOptions, type GetCurrentUserOptions, type GetCurrentUserOptions as GetUserOptions, type HandlerUrlOptions, type HandlerUrls, HexclaveAdminApp, type HexclaveAdminAppConstructor, type HexclaveAdminAppConstructorOptions, HexclaveClientApp, type HexclaveClientAppConstructor, type HexclaveClientAppConstructorOptions, type HexclaveClientAppJson, HexclaveServerApp, type HexclaveServerAppConstructor, type HexclaveServerAppConstructorOptions, type InternalApiKey, type InternalApiKeyBase, type InternalApiKeyBaseCrudRead, type InternalApiKeyCreateOptions, type InternalApiKeyFirstView, type OAuthConnection, type OAuthProvider, type OAuthProviderConfig, type OAuthScopesOnSignIn, type PlanUsage, type PlanUsageKind, type PlanUsageNextPlanId, type PlanUsagePlanId, type PlanUsageRow, type Project, type ProjectConfig, type PushedConfigSource, type ReceivedTeamInvitation, type ResolvedHandlerUrls, type SentTeamInvitation, type ServerContactChannel, type ServerListUsersOptions, type ServerOAuthProvider, type ServerTeam, type ServerTeamCreateOptions, type ServerTeamMemberProfile, type ServerTeamUpdateOptions, type ServerTeamUser, type ServerUser, StackAdminApp, type StackAdminAppConstructor, type StackAdminAppConstructorOptions, StackClientApp, type StackClientAppConstructor, type StackClientAppConstructorOptions, type StackClientAppJson, StackServerApp, type StackServerAppConstructor, type StackServerAppConstructorOptions, type Team, type TeamCreateOptions, type TeamInvitation, type TeamMemberProfile, type TeamUpdateOptions, type TeamUser, type User, getPagePrompt, hexclaveAppInternalsSymbol };

package/dist/lib/hexclave-app/projects/index.d.ts

@@ -1,2 +1,2 @@
-import { C as adminProjectUpdateOptionsToCrud, S as adminProjectCreateOptionsToCrud, _ as AdminProjectCreateOptions, b as PushConfigOptions, d as AdminDeploymentEnvVarOptions, f as AdminDeploymentRunJson, g as AdminProject, h as AdminOwnedProject, l as AdminDeploymentDomainJson, m as AdminDeploymentServiceJson, p as AdminDeploymentServiceBuildOptions, u as AdminDeploymentEnvVarJson, v as AdminProjectUpdateOptions, x as PushedConfigSource, y as Project } from "../../../client-app-DBcv6rRn.js";
+import { C as adminProjectUpdateOptionsToCrud, S as adminProjectCreateOptionsToCrud, _ as AdminProjectCreateOptions, b as PushConfigOptions, d as AdminDeploymentEnvVarOptions, f as AdminDeploymentRunJson, g as AdminProject, h as AdminOwnedProject, l as AdminDeploymentDomainJson, m as AdminDeploymentServiceJson, p as AdminDeploymentServiceBuildOptions, u as AdminDeploymentEnvVarJson, v as AdminProjectUpdateOptions, x as PushedConfigSource, y as Project } from "../../../client-app-C42iaDoZ.js";
 export { type AdminDeploymentDomainJson, type AdminDeploymentEnvVarJson, type AdminDeploymentEnvVarOptions, type AdminDeploymentRunJson, type AdminDeploymentServiceBuildOptions, type AdminDeploymentServiceJson, AdminOwnedProject, AdminProject, AdminProjectCreateOptions, AdminProjectUpdateOptions, Project, PushConfigOptions, PushedConfigSource, adminProjectCreateOptionsToCrud, adminProjectUpdateOptionsToCrud };

package/dist/lib/hexclave-app/teams/index.d.ts

@@ -1,2 +1,2 @@
-import { $ as TeamCreateOptions, G as ServerListTeamsOptions, H as EditableTeamMemberProfile, J as ServerTeamCreateOptions, K as ServerListUsersOptions, Q as Team, U as ReceivedTeamInvitation, W as SentTeamInvitation, X as ServerTeamUpdateOptions, Y as ServerTeamMemberProfile, Z as ServerTeamUser, at as serverTeamCreateOptionsToCrud, ct as teamUpdateOptionsToCrud, et as TeamInvitation, it as TeamUser, nt as TeamMemberProfileUpdateOptions, ot as serverTeamUpdateOptionsToCrud, q as ServerTeam, rt as TeamUpdateOptions, st as teamCreateOptionsToCrud, tt as TeamMemberProfile } from "../../../client-app-DBcv6rRn.js";
+import { $ as TeamCreateOptions, G as ServerListTeamsOptions, H as EditableTeamMemberProfile, J as ServerTeamCreateOptions, K as ServerListUsersOptions, Q as Team, U as ReceivedTeamInvitation, W as SentTeamInvitation, X as ServerTeamUpdateOptions, Y as ServerTeamMemberProfile, Z as ServerTeamUser, at as serverTeamCreateOptionsToCrud, ct as teamUpdateOptionsToCrud, et as TeamInvitation, it as TeamUser, nt as TeamMemberProfileUpdateOptions, ot as serverTeamUpdateOptionsToCrud, q as ServerTeam, rt as TeamUpdateOptions, st as teamCreateOptionsToCrud, tt as TeamMemberProfile } from "../../../client-app-C42iaDoZ.js";
 export { EditableTeamMemberProfile, ReceivedTeamInvitation, SentTeamInvitation, ServerListTeamsOptions, ServerListUsersOptions, ServerTeam, ServerTeamCreateOptions, ServerTeamMemberProfile, ServerTeamUpdateOptions, ServerTeamUser, Team, TeamCreateOptions, TeamInvitation, TeamMemberProfile, TeamMemberProfileUpdateOptions, TeamUpdateOptions, TeamUser, serverTeamCreateOptionsToCrud, serverTeamUpdateOptionsToCrud, teamCreateOptionsToCrud, teamUpdateOptionsToCrud };

package/dist/lib/hexclave-app/users/index.d.ts

@@ -1,2 +1,2 @@
-import { At as UserUpdateOptions, Ct as ServerUserCreateOptions, Dt as TokenPartialUser, Et as SyncedPartialUser, Mt as serverUserUpdateOptionsToCrud, Nt as userUpdateOptionsToCrud, Ot as User, Pt as withUserDestructureGuard, St as ServerUser, Tt as SyncedPartialServerUser, _t as OAuthProvider, bt as ServerBaseUser, dt as BaseUser, ft as CurrentInternalServerUser, gt as InternalUserExtra, ht as CurrentUser, jt as serverUserCreateOptionsToCrud, kt as UserExtra, lt as ActiveSession, mt as CurrentServerUser, pt as CurrentInternalUser, ut as Auth, vt as ProjectCurrentServerUser, wt as ServerUserUpdateOptions, xt as ServerOAuthProvider, yt as ProjectCurrentUser } from "../../../client-app-DBcv6rRn.js";
+import { At as UserUpdateOptions, Ct as ServerUserCreateOptions, Dt as TokenPartialUser, Et as SyncedPartialUser, Mt as serverUserUpdateOptionsToCrud, Nt as userUpdateOptionsToCrud, Ot as User, Pt as withUserDestructureGuard, St as ServerUser, Tt as SyncedPartialServerUser, _t as OAuthProvider, bt as ServerBaseUser, dt as BaseUser, ft as CurrentInternalServerUser, gt as InternalUserExtra, ht as CurrentUser, jt as serverUserCreateOptionsToCrud, kt as UserExtra, lt as ActiveSession, mt as CurrentServerUser, pt as CurrentInternalUser, ut as Auth, vt as ProjectCurrentServerUser, wt as ServerUserUpdateOptions, xt as ServerOAuthProvider, yt as ProjectCurrentUser } from "../../../client-app-C42iaDoZ.js";
 export { ActiveSession, Auth, BaseUser, CurrentInternalServerUser, CurrentInternalUser, CurrentServerUser, CurrentUser, InternalUserExtra, OAuthProvider, ProjectCurrentServerUser, ProjectCurrentUser, ServerBaseUser, ServerOAuthProvider, ServerUser, ServerUserCreateOptions, ServerUserUpdateOptions, SyncedPartialServerUser, SyncedPartialUser, TokenPartialUser, User, UserExtra, UserUpdateOptions, serverUserCreateOptionsToCrud, serverUserUpdateOptionsToCrud, userUpdateOptionsToCrud, withUserDestructureGuard };

package/dist/lib/hexclave-app/workflows.d.ts

@@ -0,0 +1,2 @@
+import { _ as adminWorkflowVersionFromCrud, a as AdminWorkflowRunState, c as AdminWorkflowStepAttempt, d as AdminWorkflowUpgradeResult, f as AdminWorkflowVersion, g as adminWorkflowSyncResultFromCrud, h as adminWorkflowRunFromCrud, i as AdminWorkflowRunDetails, l as AdminWorkflowSyncResult, m as adminWorkflowRunDetailsFromCrud, n as AdminWorkflowDivergenceDiagnostic, o as AdminWorkflowRunsFilter, p as adminWorkflowFromCrud, r as AdminWorkflowRun, s as AdminWorkflowStep, t as AdminWorkflow, u as AdminWorkflowTrigger, v as isWorkflowRunDetailsJson } from "../../workflows-DEb7pIuQ.js";
+export { AdminWorkflow, AdminWorkflowDivergenceDiagnostic, AdminWorkflowRun, AdminWorkflowRunDetails, AdminWorkflowRunState, AdminWorkflowRunsFilter, AdminWorkflowStep, AdminWorkflowStepAttempt, AdminWorkflowSyncResult, AdminWorkflowTrigger, AdminWorkflowUpgradeResult, AdminWorkflowVersion, adminWorkflowFromCrud, adminWorkflowRunDetailsFromCrud, adminWorkflowRunFromCrud, adminWorkflowSyncResultFromCrud, adminWorkflowVersionFromCrud, isWorkflowRunDetailsJson };

package/dist/lib/hexclave-app/workflows.js

@@ -0,0 +1,116 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/lib/hexclave-app/workflows.ts
+function adminWorkflowFromCrud(crud) {
+	return {
+		id: crud.id,
+		displayName: crud.display_name,
+		latestVersion: crud.latest_version,
+		triggers: crud.triggers.map((trigger) => trigger.type === "event" ? {
+			type: "event",
+			eventType: trigger.event_type
+		} : {
+			type: "schedule",
+			cron: trigger.cron,
+			timezone: trigger.timezone
+		}),
+		stats: {
+			activeRuns: crud.stats.active_runs,
+			sleepingRuns: crud.stats.sleeping_runs,
+			failed7d: crud.stats.failed_7d,
+			runVolume14d: crud.stats.run_volume_14d
+		},
+		createdAtMillis: crud.created_at_millis,
+		lastDeployedAtMillis: crud.last_deployed_at_millis
+	};
+}
+function adminDivergenceFromCrud(crud) {
+	if (crud == null) return null;
+	return {
+		reason: crud.reason,
+		suspendedStepKey: crud.suspended_step_key,
+		foundStepKey: crud.found_step_key,
+		consumedStepKeys: crud.consumed_step_keys,
+		unconsumedStepKeys: crud.unconsumed_step_keys,
+		details: crud.details
+	};
+}
+function adminWorkflowRunFromCrud(crud) {
+	return {
+		id: crud.id,
+		workflowId: crud.workflow_id,
+		runKey: crud.run_key,
+		state: crud.state,
+		version: crud.version,
+		triggerType: crud.trigger_type,
+		triggerSummary: crud.trigger_summary,
+		currentStepId: crud.current_step_id,
+		stepsRecorded: crud.steps_recorded,
+		errorSummary: crud.error_summary,
+		failureKind: crud.failure_kind,
+		lastUpgradeDivergence: adminDivergenceFromCrud(crud.last_upgrade_divergence),
+		createdAtMillis: crud.created_at_millis,
+		completedAtMillis: crud.completed_at_millis,
+		nextWakeAtMillis: crud.next_wake_at_millis
+	};
+}
+function isWorkflowRunDetailsJson(crud) {
+	return "trigger_payload" in crud && "steps" in crud && Array.isArray(crud.steps) && "step_attempts" in crud && Array.isArray(crud.step_attempts);
+}
+function adminWorkflowRunDetailsFromCrud(crud) {
+	return {
+		...adminWorkflowRunFromCrud(crud),
+		triggerPayload: crud.trigger_payload,
+		steps: crud.steps.map((step) => ({
+			stepKey: step.step_key,
+			stepId: step.step_id,
+			kind: step.kind,
+			result: step.result,
+			resultSizeBytes: step.result_size_bytes,
+			attempts: step.attempts,
+			executedAtVersion: step.executed_at_version,
+			elapsedMs: step.elapsed_ms,
+			createdAtMillis: step.created_at_millis
+		})),
+		stepAttempts: crud.step_attempts.map((attempt) => ({
+			stepKey: attempt.step_key,
+			stepId: attempt.step_id,
+			retryEpoch: attempt.retry_epoch,
+			attempt: attempt.attempt,
+			outcome: attempt.outcome,
+			error: attempt.error,
+			failureKind: attempt.failure_kind,
+			logs: attempt.logs,
+			startedAtMillis: attempt.started_at_millis,
+			finishedAtMillis: attempt.finished_at_millis
+		}))
+	};
+}
+function adminWorkflowVersionFromCrud(crud) {
+	return {
+		workflowId: crud.workflow_id,
+		version: crud.version,
+		sourceHash: crud.source_hash,
+		source: crud.source,
+		runtimeEnvVersion: crud.runtime_env_version,
+		isLatest: crud.is_latest,
+		inFlightRuns: crud.in_flight_runs,
+		createdAtMillis: crud.created_at_millis
+	};
+}
+function adminWorkflowSyncResultFromCrud(crud) {
+	return {
+		workflowId: crud.workflow_id,
+		version: crud.version,
+		created: crud.created,
+		inFlightRunsOnOlderVersions: crud.in_flight_runs_on_older_versions
+	};
+}
+//#endregion
+exports.adminWorkflowFromCrud = adminWorkflowFromCrud;
+exports.adminWorkflowRunDetailsFromCrud = adminWorkflowRunDetailsFromCrud;
+exports.adminWorkflowRunFromCrud = adminWorkflowRunFromCrud;
+exports.adminWorkflowSyncResultFromCrud = adminWorkflowSyncResultFromCrud;
+exports.adminWorkflowVersionFromCrud = adminWorkflowVersionFromCrud;
+exports.isWorkflowRunDetailsJson = isWorkflowRunDetailsJson;
+
+//# sourceMappingURL=workflows.js.map

package/dist/lib/hexclave-app/workflows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.js","names":[],"sources":["../../../src/lib/hexclave-app/workflows.ts"],"sourcesContent":["\n//===========================================\n// THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY UNLESS YOU ALSO EDIT THE CORRESPONDING FILE IN packages/template\n//===========================================\nimport type {\n  WorkflowDivergenceDiagnosticJson,\n  WorkflowRunDetailsJson,\n  WorkflowRunJson,\n  WorkflowSummaryJson,\n  WorkflowSyncResultJson,\n  WorkflowVersionJson,\n} from \"@hexclave/shared/dist/interface/workflows\";\n\n// SDK-side (camelCase) types + converters for the workflows admin surface.\n// The wire types live in @hexclave/shared/dist/interface/workflows; these\n// mirror them 1:1 so the dashboard never touches snake_case.\n\nexport type AdminWorkflowTrigger =\n  | { type: \"event\", eventType: string }\n  | { type: \"schedule\", cron: string, timezone: string };\n\nexport type AdminWorkflow = {\n  id: string,\n  displayName: string,\n  latestVersion: number,\n  triggers: AdminWorkflowTrigger[],\n  stats: {\n    activeRuns: number,\n    sleepingRuns: number,\n    failed7d: number,\n    runVolume14d: number[],\n  },\n  createdAtMillis: number,\n  lastDeployedAtMillis: number,\n};\n\nexport type AdminWorkflowRunState = \"queued\" | \"running\" | \"sleeping\" | \"completed\" | \"failed\" | \"canceled\";\n\nexport type AdminWorkflowDivergenceDiagnostic = {\n  reason: WorkflowDivergenceDiagnosticJson[\"reason\"],\n  suspendedStepKey: string | null,\n  foundStepKey: string | null,\n  consumedStepKeys: string[],\n  unconsumedStepKeys: string[],\n  details: string,\n};\n\nexport type AdminWorkflowRun = {\n  id: string,\n  workflowId: string,\n  runKey: string | null,\n  state: AdminWorkflowRunState,\n  version: number,\n  triggerType: string,\n  triggerSummary: string,\n  currentStepId: string | null,\n  stepsRecorded: number,\n  errorSummary: string | null,\n  failureKind: \"user\" | \"platform\" | null,\n  lastUpgradeDivergence: AdminWorkflowDivergenceDiagnostic | null,\n  createdAtMillis: number,\n  completedAtMillis: number | null,\n  nextWakeAtMillis: number | null,\n};\n\nexport type AdminWorkflowStep = {\n  stepKey: string,\n  stepId: string,\n  kind: \"run\" | \"sleep\",\n  result: unknown,\n  resultSizeBytes: number,\n  attempts: number,\n  executedAtVersion: number,\n  elapsedMs: number | null,\n  createdAtMillis: number,\n};\n\nexport type AdminWorkflowStepAttempt = {\n  stepKey: string,\n  stepId: string,\n  /** 0 for the original execution; incremented by each manual retry of the run. */\n  retryEpoch: number,\n  attempt: number,\n  outcome: \"succeeded\" | \"failed\",\n  error: { name: string, message: string, stack?: string } | null,\n  failureKind: \"user\" | \"platform\" | null,\n  logs: string | null,\n  startedAtMillis: number,\n  finishedAtMillis: number,\n};\n\nexport type AdminWorkflowRunDetails = AdminWorkflowRun & {\n  triggerPayload: unknown,\n  steps: AdminWorkflowStep[],\n  stepAttempts: AdminWorkflowStepAttempt[],\n};\n\nexport type AdminWorkflowVersion = {\n  workflowId: string,\n  version: number,\n  sourceHash: string,\n  source: string,\n  runtimeEnvVersion: string,\n  isLatest: boolean,\n  inFlightRuns: number,\n  createdAtMillis: number,\n};\n\nexport type AdminWorkflowSyncResult = {\n  workflowId: string,\n  version: number,\n  created: boolean,\n  inFlightRunsOnOlderVersions: number,\n};\n\nexport type AdminWorkflowUpgradeResult = {\n  upgradedCount: number,\n  skipped: {\n    runId: string,\n    runKey: string | null,\n    fromVersion: number,\n    diagnostic: AdminWorkflowDivergenceDiagnostic,\n  }[],\n};\n\nexport type AdminWorkflowRunsFilter = {\n  state?: AdminWorkflowRunState,\n  version?: number,\n  runKey?: string,\n  cursor?: string,\n  limit?: number,\n  /** Include each run's memoized steps and attempt history. */\n  includeState?: boolean,\n};\n\nexport function adminWorkflowFromCrud(crud: WorkflowSummaryJson): AdminWorkflow {\n  return {\n    id: crud.id,\n    displayName: crud.display_name,\n    latestVersion: crud.latest_version,\n    triggers: crud.triggers.map((trigger) => trigger.type === \"event\"\n      ? { type: \"event\", eventType: trigger.event_type }\n      : { type: \"schedule\", cron: trigger.cron, timezone: trigger.timezone }),\n    stats: {\n      activeRuns: crud.stats.active_runs,\n      sleepingRuns: crud.stats.sleeping_runs,\n      failed7d: crud.stats.failed_7d,\n      runVolume14d: crud.stats.run_volume_14d,\n    },\n    createdAtMillis: crud.created_at_millis,\n    lastDeployedAtMillis: crud.last_deployed_at_millis,\n  };\n}\n\nfunction adminDivergenceFromCrud(crud: WorkflowDivergenceDiagnosticJson | null): AdminWorkflowDivergenceDiagnostic | null {\n  if (crud == null) return null;\n  return {\n    reason: crud.reason,\n    suspendedStepKey: crud.suspended_step_key,\n    foundStepKey: crud.found_step_key,\n    consumedStepKeys: crud.consumed_step_keys,\n    unconsumedStepKeys: crud.unconsumed_step_keys,\n    details: crud.details,\n  };\n}\n\nexport function adminWorkflowRunFromCrud(crud: WorkflowRunJson): AdminWorkflowRun {\n  return {\n    id: crud.id,\n    workflowId: crud.workflow_id,\n    runKey: crud.run_key,\n    state: crud.state,\n    version: crud.version,\n    triggerType: crud.trigger_type,\n    triggerSummary: crud.trigger_summary,\n    currentStepId: crud.current_step_id,\n    stepsRecorded: crud.steps_recorded,\n    errorSummary: crud.error_summary,\n    failureKind: crud.failure_kind,\n    lastUpgradeDivergence: adminDivergenceFromCrud(crud.last_upgrade_divergence),\n    createdAtMillis: crud.created_at_millis,\n    completedAtMillis: crud.completed_at_millis,\n    nextWakeAtMillis: crud.next_wake_at_millis,\n  };\n}\n\nexport function isWorkflowRunDetailsJson(crud: WorkflowRunJson): crud is WorkflowRunDetailsJson {\n  return \"trigger_payload\" in crud\n    && \"steps\" in crud\n    && Array.isArray(crud.steps)\n    && \"step_attempts\" in crud\n    && Array.isArray(crud.step_attempts);\n}\n\nexport function adminWorkflowRunDetailsFromCrud(crud: WorkflowRunDetailsJson): AdminWorkflowRunDetails {\n  return {\n    ...adminWorkflowRunFromCrud(crud),\n    triggerPayload: crud.trigger_payload,\n    steps: crud.steps.map((step) => ({\n      stepKey: step.step_key,\n      stepId: step.step_id,\n      kind: step.kind,\n      result: step.result,\n      resultSizeBytes: step.result_size_bytes,\n      attempts: step.attempts,\n      executedAtVersion: step.executed_at_version,\n      elapsedMs: step.elapsed_ms,\n      createdAtMillis: step.created_at_millis,\n    })),\n    stepAttempts: crud.step_attempts.map((attempt) => ({\n      stepKey: attempt.step_key,\n      stepId: attempt.step_id,\n      retryEpoch: attempt.retry_epoch,\n      attempt: attempt.attempt,\n      outcome: attempt.outcome,\n      error: attempt.error,\n      failureKind: attempt.failure_kind,\n      logs: attempt.logs,\n      startedAtMillis: attempt.started_at_millis,\n      finishedAtMillis: attempt.finished_at_millis,\n    })),\n  };\n}\n\nexport function adminWorkflowVersionFromCrud(crud: WorkflowVersionJson): AdminWorkflowVersion {\n  return {\n    workflowId: crud.workflow_id,\n    version: crud.version,\n    sourceHash: crud.source_hash,\n    source: crud.source,\n    runtimeEnvVersion: crud.runtime_env_version,\n    isLatest: crud.is_latest,\n    inFlightRuns: crud.in_flight_runs,\n    createdAtMillis: crud.created_at_millis,\n  };\n}\n\nexport function adminWorkflowSyncResultFromCrud(crud: WorkflowSyncResultJson): AdminWorkflowSyncResult {\n  return {\n    workflowId: crud.workflow_id,\n    version: crud.version,\n    created: crud.created,\n    inFlightRunsOnOlderVersions: crud.in_flight_runs_on_older_versions,\n  };\n}\n"],"mappings":";;AAuIA,SAAgB,sBAAsB,MAA0C;CAC9E,OAAO;EACL,IAAI,KAAK;EACT,aAAa,KAAK;EAClB,eAAe,KAAK;EACpB,UAAU,KAAK,SAAS,KAAK,YAAY,QAAQ,SAAS,UACtD;GAAE,MAAM;GAAS,WAAW,QAAQ;EAAW,IAC/C;GAAE,MAAM;GAAY,MAAM,QAAQ;GAAM,UAAU,QAAQ;EAAS,CAAC;EACxE,OAAO;GACL,YAAY,KAAK,MAAM;GACvB,cAAc,KAAK,MAAM;GACzB,UAAU,KAAK,MAAM;GACrB,cAAc,KAAK,MAAM;EAC3B;EACA,iBAAiB,KAAK;EACtB,sBAAsB,KAAK;CAC7B;AACF;AAEA,SAAS,wBAAwB,MAAyF;CACxH,IAAI,QAAQ,MAAM,OAAO;CACzB,OAAO;EACL,QAAQ,KAAK;EACb,kBAAkB,KAAK;EACvB,cAAc,KAAK;EACnB,kBAAkB,KAAK;EACvB,oBAAoB,KAAK;EACzB,SAAS,KAAK;CAChB;AACF;AAEA,SAAgB,yBAAyB,MAAyC;CAChF,OAAO;EACL,IAAI,KAAK;EACT,YAAY,KAAK;EACjB,QAAQ,KAAK;EACb,OAAO,KAAK;EACZ,SAAS,KAAK;EACd,aAAa,KAAK;EAClB,gBAAgB,KAAK;EACrB,eAAe,KAAK;EACpB,eAAe,KAAK;EACpB,cAAc,KAAK;EACnB,aAAa,KAAK;EAClB,uBAAuB,wBAAwB,KAAK,uBAAuB;EAC3E,iBAAiB,KAAK;EACtB,mBAAmB,KAAK;EACxB,kBAAkB,KAAK;CACzB;AACF;AAEA,SAAgB,yBAAyB,MAAuD;CAC9F,OAAO,qBAAqB,QACvB,WAAW,QACX,MAAM,QAAQ,KAAK,KAAK,KACxB,mBAAmB,QACnB,MAAM,QAAQ,KAAK,aAAa;AACvC;AAEA,SAAgB,gCAAgC,MAAuD;CACrG,OAAO;EACL,GAAG,yBAAyB,IAAI;EAChC,gBAAgB,KAAK;EACrB,OAAO,KAAK,MAAM,KAAK,UAAU;GAC/B,SAAS,KAAK;GACd,QAAQ,KAAK;GACb,MAAM,KAAK;GACX,QAAQ,KAAK;GACb,iBAAiB,KAAK;GACtB,UAAU,KAAK;GACf,mBAAmB,KAAK;GACxB,WAAW,KAAK;GAChB,iBAAiB,KAAK;EACxB,EAAE;EACF,cAAc,KAAK,cAAc,KAAK,aAAa;GACjD,SAAS,QAAQ;GACjB,QAAQ,QAAQ;GAChB,YAAY,QAAQ;GACpB,SAAS,QAAQ;GACjB,SAAS,QAAQ;GACjB,OAAO,QAAQ;GACf,aAAa,QAAQ;GACrB,MAAM,QAAQ;GACd,iBAAiB,QAAQ;GACzB,kBAAkB,QAAQ;EAC5B,EAAE;CACJ;AACF;AAEA,SAAgB,6BAA6B,MAAiD;CAC5F,OAAO;EACL,YAAY,KAAK;EACjB,SAAS,KAAK;EACd,YAAY,KAAK;EACjB,QAAQ,KAAK;EACb,mBAAmB,KAAK;EACxB,UAAU,KAAK;EACf,cAAc,KAAK;EACnB,iBAAiB,KAAK;CACxB;AACF;AAEA,SAAgB,gCAAgC,MAAuD;CACrG,OAAO;EACL,YAAY,KAAK;EACjB,SAAS,KAAK;EACd,SAAS,KAAK;EACd,6BAA6B,KAAK;CACpC;AACF"}

package/dist/lib/hexclave-app/workflows.test.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/lib/hexclave-app/workflows.test.js

@@ -0,0 +1,24 @@
+let vitest = require("vitest");
+let __workflows_js = require("./workflows.js");
+//#region src/lib/hexclave-app/workflows.test.ts
+(0, vitest.describe)("adminWorkflowVersionFromCrud", () => {
+	(0, vitest.it)("preserves the deployment source hash", () => {
+		(0, vitest.expect)((0, __workflows_js.adminWorkflowVersionFromCrud)({
+			workflow_id: "daily-report",
+			version: 3,
+			source: "export default 1",
+			source_hash: "0123456789abcdef",
+			runtime_env_version: "v1",
+			is_latest: true,
+			in_flight_runs: 2,
+			created_at_millis: 1234
+		})).toMatchObject({
+			workflowId: "daily-report",
+			version: 3,
+			sourceHash: "0123456789abcdef"
+		});
+	});
+});
+//#endregion
+
+//# sourceMappingURL=workflows.test.js.map

package/dist/lib/hexclave-app/workflows.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.test.js","names":[],"sources":["../../../src/lib/hexclave-app/workflows.test.ts"],"sourcesContent":["\n//===========================================\n// THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY UNLESS YOU ALSO EDIT THE CORRESPONDING FILE IN packages/template\n//===========================================\nimport type { WorkflowVersionJson } from \"@hexclave/shared/dist/interface/workflows\";\nimport { describe, expect, it } from \"vitest\";\nimport { adminWorkflowVersionFromCrud } from \"./workflows\";\n\ndescribe(\"adminWorkflowVersionFromCrud\", () => {\n  it(\"preserves the deployment source hash\", () => {\n    const version: WorkflowVersionJson = {\n      workflow_id: \"daily-report\",\n      version: 3,\n      source: \"export default 1\",\n      source_hash: \"0123456789abcdef\",\n      runtime_env_version: \"v1\",\n      is_latest: true,\n      in_flight_runs: 2,\n      created_at_millis: 1234,\n    };\n\n    expect(adminWorkflowVersionFromCrud(version)).toMatchObject({\n      workflowId: \"daily-report\",\n      version: 3,\n      sourceHash: \"0123456789abcdef\",\n    });\n  });\n});\n"],"mappings":";;;qBAQS,sCAAsC;CAC7C,CAAA,GAAA,OAAA,GAAA,CAAG,8CAA8C;EAY/C,CAAA,GAAA,OAAA,OAAA,EAAA,GAAA,eAAA,6BAAA,CAAoC;GAVlC,aAAa;GACb,SAAS;GACT,QAAQ;GACR,aAAa;GACb,qBAAqB;GACrB,WAAW;GACX,gBAAgB;GAChB,mBAAmB;EAGqB,CAAC,CAAC,CAAC,CAAC,cAAc;GAC1D,YAAY;GACZ,SAAS;GACT,YAAY;EACd,CAAC;CACH,CAAC;AACH,CAAC"}

package/dist/pushed-config-error-overlay/index.d.ts

@@ -1,4 +1,4 @@
-import { a as StackClientApp } from "../client-app-DBcv6rRn.js";
+import { a as StackClientApp } from "../client-app-C42iaDoZ.js";
 //#region src/pushed-config-error-overlay/index.d.ts
 declare function mountPushedConfigErrorOverlay(app: StackClientApp<true>): () => void;
 //#endregion

package/dist/pushed-config-error-overlay/index.js

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let _hexclave_shared_dist_utils_promises = require("@hexclave/shared/dist/utils/promises");
+let _hexclave_shared_dist_utils_urls = require("@hexclave/shared/dist/utils/urls");
 let ___in_page_ui_dom_js = require("../in-page-ui/dom.js");
 let ___in_page_ui_base_styles_js = require("../in-page-ui/base-styles.js");
 let _hexclave_shared_dist_utils_errors = require("@hexclave/shared/dist/utils/errors");
-let _hexclave_shared_dist_utils_urls = require("@hexclave/shared/dist/utils/urls");
 let ___generated_env_js = require("../generated/env.js");
 //#region src/pushed-config-error-overlay/index.ts
 const GLOBAL_INSTANCE_KEY = "__hexclave-pushed-config-error-overlay";

package/dist/workflows-DEb7pIuQ.d.ts

@@ -0,0 +1,125 @@
+import { WorkflowDivergenceDiagnosticJson, WorkflowRunDetailsJson, WorkflowRunJson, WorkflowSummaryJson, WorkflowSyncResultJson, WorkflowVersionJson } from "@hexclave/shared/dist/interface/workflows";
+
+//#region src/lib/hexclave-app/workflows.d.ts
+type AdminWorkflowTrigger = {
+  type: "event";
+  eventType: string;
+} | {
+  type: "schedule";
+  cron: string;
+  timezone: string;
+};
+type AdminWorkflow = {
+  id: string;
+  displayName: string;
+  latestVersion: number;
+  triggers: AdminWorkflowTrigger[];
+  stats: {
+    activeRuns: number;
+    sleepingRuns: number;
+    failed7d: number;
+    runVolume14d: number[];
+  };
+  createdAtMillis: number;
+  lastDeployedAtMillis: number;
+};
+type AdminWorkflowRunState = "queued" | "running" | "sleeping" | "completed" | "failed" | "canceled";
+type AdminWorkflowDivergenceDiagnostic = {
+  reason: WorkflowDivergenceDiagnosticJson["reason"];
+  suspendedStepKey: string | null;
+  foundStepKey: string | null;
+  consumedStepKeys: string[];
+  unconsumedStepKeys: string[];
+  details: string;
+};
+type AdminWorkflowRun = {
+  id: string;
+  workflowId: string;
+  runKey: string | null;
+  state: AdminWorkflowRunState;
+  version: number;
+  triggerType: string;
+  triggerSummary: string;
+  currentStepId: string | null;
+  stepsRecorded: number;
+  errorSummary: string | null;
+  failureKind: "user" | "platform" | null;
+  lastUpgradeDivergence: AdminWorkflowDivergenceDiagnostic | null;
+  createdAtMillis: number;
+  completedAtMillis: number | null;
+  nextWakeAtMillis: number | null;
+};
+type AdminWorkflowStep = {
+  stepKey: string;
+  stepId: string;
+  kind: "run" | "sleep";
+  result: unknown;
+  resultSizeBytes: number;
+  attempts: number;
+  executedAtVersion: number;
+  elapsedMs: number | null;
+  createdAtMillis: number;
+};
+type AdminWorkflowStepAttempt = {
+  stepKey: string;
+  stepId: string; /** 0 for the original execution; incremented by each manual retry of the run. */
+  retryEpoch: number;
+  attempt: number;
+  outcome: "succeeded" | "failed";
+  error: {
+    name: string;
+    message: string;
+    stack?: string;
+  } | null;
+  failureKind: "user" | "platform" | null;
+  logs: string | null;
+  startedAtMillis: number;
+  finishedAtMillis: number;
+};
+type AdminWorkflowRunDetails = AdminWorkflowRun & {
+  triggerPayload: unknown;
+  steps: AdminWorkflowStep[];
+  stepAttempts: AdminWorkflowStepAttempt[];
+};
+type AdminWorkflowVersion = {
+  workflowId: string;
+  version: number;
+  sourceHash: string;
+  source: string;
+  runtimeEnvVersion: string;
+  isLatest: boolean;
+  inFlightRuns: number;
+  createdAtMillis: number;
+};
+type AdminWorkflowSyncResult = {
+  workflowId: string;
+  version: number;
+  created: boolean;
+  inFlightRunsOnOlderVersions: number;
+};
+type AdminWorkflowUpgradeResult = {
+  upgradedCount: number;
+  skipped: {
+    runId: string;
+    runKey: string | null;
+    fromVersion: number;
+    diagnostic: AdminWorkflowDivergenceDiagnostic;
+  }[];
+};
+type AdminWorkflowRunsFilter = {
+  state?: AdminWorkflowRunState;
+  version?: number;
+  runKey?: string;
+  cursor?: string;
+  limit?: number; /** Include each run's memoized steps and attempt history. */
+  includeState?: boolean;
+};
+declare function adminWorkflowFromCrud(crud: WorkflowSummaryJson): AdminWorkflow;
+declare function adminWorkflowRunFromCrud(crud: WorkflowRunJson): AdminWorkflowRun;
+declare function isWorkflowRunDetailsJson(crud: WorkflowRunJson): crud is WorkflowRunDetailsJson;
+declare function adminWorkflowRunDetailsFromCrud(crud: WorkflowRunDetailsJson): AdminWorkflowRunDetails;
+declare function adminWorkflowVersionFromCrud(crud: WorkflowVersionJson): AdminWorkflowVersion;
+declare function adminWorkflowSyncResultFromCrud(crud: WorkflowSyncResultJson): AdminWorkflowSyncResult;
+//#endregion
+export { adminWorkflowVersionFromCrud as _, AdminWorkflowRunState as a, AdminWorkflowStepAttempt as c, AdminWorkflowUpgradeResult as d, AdminWorkflowVersion as f, adminWorkflowSyncResultFromCrud as g, adminWorkflowRunFromCrud as h, AdminWorkflowRunDetails as i, AdminWorkflowSyncResult as l, adminWorkflowRunDetailsFromCrud as m, AdminWorkflowDivergenceDiagnostic as n, AdminWorkflowRunsFilter as o, adminWorkflowFromCrud as p, AdminWorkflowRun as r, AdminWorkflowStep as s, AdminWorkflow as t, AdminWorkflowTrigger as u, isWorkflowRunDetailsJson as v };
+//# sourceMappingURL=workflows-DEb7pIuQ.d.ts.map

package/dist/workflows-DEb7pIuQ.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows-DEb7pIuQ.d.ts","names":[],"sources":["../src/lib/hexclave-app/workflows.ts"],"mappings":";;;KAiBY,oBAAA;EACN,IAAA;EAAe,SAAA;AAAA;EACf,IAAA;EAAkB,IAAA;EAAc,QAAA;AAAA;AAAA,KAE1B,aAAA;EACV,EAAA;EACA,WAAA;EACA,aAAA;EACA,QAAA,EAAU,oBAAoB;EAC9B,KAAA;IACE,UAAA;IACA,YAAA;IACA,QAAA;IACA,YAAA;EAAA;EAEF,eAAA;EACA,oBAAA;AAAA;AAAA,KAGU,qBAAA;AAAA,KAEA,iCAAA;EACV,MAAA,EAAQ,gCAAgC;EACxC,gBAAA;EACA,YAAA;EACA,gBAAA;EACA,kBAAA;EACA,OAAA;AAAA;AAAA,KAGU,gBAAA;EACV,EAAA;EACA,UAAA;EACA,MAAA;EACA,KAAA,EAAO,qBAAA;EACP,OAAA;EACA,WAAA;EACA,cAAA;EACA,aAAA;EACA,aAAA;EACA,YAAA;EACA,WAAA;EACA,qBAAA,EAAuB,iCAAiC;EACxD,eAAA;EACA,iBAAA;EACA,gBAAA;AAAA;AAAA,KAGU,iBAAA;EACV,OAAA;EACA,MAAA;EACA,IAAA;EACA,MAAA;EACA,eAAA;EACA,QAAA;EACA,iBAAA;EACA,SAAA;EACA,eAAA;AAAA;AAAA,KAGU,wBAAA;EACV,OAAA;EACA,MAAA,UAvBA;EAyBA,UAAA;EACA,OAAA;EACA,OAAA;EACA,KAAA;IAAS,IAAA;IAAc,OAAA;IAAiB,KAAA;EAAA;EACxC,WAAA;EACA,IAAA;EACA,eAAA;EACA,gBAAA;AAAA;AAAA,KAGU,uBAAA,GAA0B,gBAAA;EACpC,cAAA;EACA,KAAA,EAAO,iBAAA;EACP,YAAA,EAAc,wBAAA;AAAA;AAAA,KAGJ,oBAAA;EACV,UAAA;EACA,OAAA;EACA,UAAA;EACA,MAAA;EACA,iBAAA;EACA,QAAA;EACA,YAAA;EACA,eAAA;AAAA;AAAA,KAGU,uBAAA;EACV,UAAA;EACA,OAAA;EACA,OAAA;EACA,2BAAA;AAAA;AAAA,KAGU,0BAAA;EACV,aAAA;EACA,OAAA;IACE,KAAA;IACA,MAAA;IACA,WAAA;IACA,UAAA,EAAY,iCAAiC;EAAA;AAAA;AAAA,KAIrC,uBAAA;EACV,KAAA,GAAQ,qBAAqB;EAC7B,OAAA;EACA,MAAA;EACA,MAAA;EACA,KAAA,WApCsC;EAsCtC,YAAA;AAAA;AAAA,iBAGc,qBAAA,CAAsB,IAAA,EAAM,mBAAA,GAAsB,aAAa;AAAA,iBA+B/D,wBAAA,CAAyB,IAAA,EAAM,eAAA,GAAkB,gBAAgB;AAAA,iBAoBjE,wBAAA,CAAyB,IAAA,EAAM,eAAA,GAAkB,IAAA,IAAQ,sBAAsB;AAAA,iBAQ/E,+BAAA,CAAgC,IAAA,EAAM,sBAAA,GAAyB,uBAAuB;AAAA,iBA8BtF,4BAAA,CAA6B,IAAA,EAAM,mBAAA,GAAsB,oBAAoB;AAAA,iBAa7E,+BAAA,CAAgC,IAAA,EAAM,sBAAA,GAAyB,uBAAuB"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "//": "THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY UNLESS YOU ALSO EDIT THE CORRESPONDING FILE IN packages/template (FOR package.json FILES, PLEASE EDIT package-template.json)",
   "name": "@hexclave/js",
-  "version": "1.0.70",
+  "version": "1.0.71",
   "repository": "https://github.com/hexclave/hexclave",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -65,7 +65,7 @@
     "qrcode": "^1.5.4",
     "rrweb": "^1.1.3",
     "yup": "^1.7.1",
-    "@hexclave/shared": "1.0.70"
+    "@hexclave/shared": "1.0.71"
   },
   "devDependencies": {
     "@quetzallabs/i18n": "^0.1.19",

package/src/lib/hexclave-app/apps/implementations/admin-app-impl.ts

@@ -25,6 +25,7 @@ import { AdminProjectPermission, AdminProjectPermissionDefinition, AdminProjectP
 import type { PlanUsage } from "../../plan-usage";
 import { AdminOwnedProject, AdminProject, AdminProjectUpdateOptions, PushConfigOptions, adminProjectUpdateOptionsToCrud } from "../../projects";
 import type { AdminSessionReplay, AdminSessionReplayChunk, ListSessionReplayChunksOptions, ListSessionReplayChunksResult, ListSessionReplaysOptions, ListSessionReplaysResult, SessionReplayAllEventsResult } from "../../session-replays";
+import { AdminWorkflow, AdminWorkflowRun, AdminWorkflowRunDetails, AdminWorkflowRunsFilter, AdminWorkflowSyncResult, AdminWorkflowUpgradeResult, AdminWorkflowVersion, adminWorkflowFromCrud, adminWorkflowRunDetailsFromCrud, adminWorkflowRunFromCrud, adminWorkflowSyncResultFromCrud, adminWorkflowVersionFromCrud, isWorkflowRunDetailsJson } from "../../workflows";
 import { ManagedEmailProviderListItem, ManagedEmailProviderSetupResult, ManagedEmailProviderStatus, EmailOutboxUpdateOptions, StackAdminApp, StackAdminAppConstructorOptions } from "../interfaces/admin-app";
 import { clientVersion, createCache, getDefaultExtraRequestHeaders, getDefaultProjectId, getDefaultPublishableClientKey, getDefaultSecretServerKey, getDefaultSuperSecretAdminKey, resolveApiUrls, resolveConstructorOptions } from "./common";
 import { _HexclaveServerAppImplIncomplete } from "./server-app-impl";
@@ -97,6 +98,9 @@ export class _HexclaveAdminAppImplIncomplete<HasTokenStore extends boolean, Proj
   private readonly _adminEmailDraftsCache = createCache(async () => {
     return await this._interface.listInternalEmailDrafts();
   });
+  private readonly _adminWorkflowsCache = createCache(async () => {
+    return await this._interface.listWorkflows();
+  });
   private readonly _adminTeamPermissionDefinitionsCache = createCache(async () => {
     return await this._interface.listTeamPermissionDefinitions();
   });
@@ -477,6 +481,121 @@ export class _HexclaveAdminAppImplIncomplete<HasTokenStore extends boolean, Proj
     }));
   }
 
+  // ─── Workflows (internal-project gated; see the Workflows v1 spec) ───────
+
+  async listWorkflows(): Promise<AdminWorkflow[]> {
+    const crud = Result.orThrow(await this._adminWorkflowsCache.getOrWait([], "write-only"));
+    return crud.map(adminWorkflowFromCrud);
+  }
+
+  async createWorkflow(options: { id: string, displayName?: string, source: string }): Promise<AdminWorkflowSyncResult> {
+    const result = await this._interface.createWorkflow({
+      id: options.id,
+      display_name: options.displayName,
+      source: options.source,
+    });
+    await this._adminWorkflowsCache.refresh([]);
+    return adminWorkflowSyncResultFromCrud(result);
+  }
+
+  async updateWorkflowSource(workflowId: string, source: string): Promise<AdminWorkflowSyncResult> {
+    const result = await this._interface.updateWorkflowSource(workflowId, source);
+    await this._adminWorkflowsCache.refresh([]);
+    return adminWorkflowSyncResultFromCrud(result);
+  }
+
+  async deleteWorkflow(workflowId: string): Promise<void> {
+    await this._interface.deleteWorkflow(workflowId);
+    await this._adminWorkflowsCache.refresh([]);
+  }
+
+  async listWorkflowVersions(workflowId: string): Promise<AdminWorkflowVersion[]> {
+    return (await this._interface.listWorkflowVersions(workflowId)).map(adminWorkflowVersionFromCrud);
+  }
+
+  async listWorkflowRuns(workflowId: string, filter: AdminWorkflowRunsFilter & { includeState: true }): Promise<{ runs: AdminWorkflowRunDetails[], nextCursor: string | null }>;
+  async listWorkflowRuns(workflowId: string, filter?: AdminWorkflowRunsFilter): Promise<{ runs: AdminWorkflowRun[], nextCursor: string | null }>;
+  async listWorkflowRuns(workflowId: string, filter: AdminWorkflowRunsFilter = {}): Promise<{ runs: AdminWorkflowRun[], nextCursor: string | null }> {
+    if (filter.includeState === true) {
+      const result = await this._interface.listWorkflowRuns(workflowId, {
+        state: filter.state,
+        version: filter.version,
+        run_key: filter.runKey,
+        cursor: filter.cursor,
+        limit: filter.limit,
+        include_state: true,
+      });
+      return {
+        runs: result.runs.map((run) => adminWorkflowRunDetailsFromCrud(
+          isWorkflowRunDetailsJson(run)
+            ? run
+            : throwErr("Workflow runs response omitted state after include_state=true"),
+        )),
+        nextCursor: result.next_cursor,
+      };
+    }
+    const result = await this._interface.listWorkflowRuns(workflowId, {
+      state: filter.state,
+      version: filter.version,
+      run_key: filter.runKey,
+      cursor: filter.cursor,
+      limit: filter.limit,
+    });
+    return {
+      runs: result.runs.map(adminWorkflowRunFromCrud),
+      nextCursor: result.next_cursor,
+    };
+  }
+
+  async getWorkflowRun(runId: string): Promise<AdminWorkflowRunDetails> {
+    return adminWorkflowRunDetailsFromCrud(await this._interface.getWorkflowRun(runId));
+  }
+
+  async cancelWorkflowRuns(workflowId: string, filter: { runKey?: string, runId?: string, state?: "queued" | "running" | "sleeping", version?: number } = {}): Promise<{ canceledCount: number }> {
+    const result = await this._interface.cancelWorkflowRuns(workflowId, {
+      run_key: filter.runKey,
+      run_id: filter.runId,
+      state: filter.state,
+      version: filter.version,
+    });
+    await this._adminWorkflowsCache.refresh([]);
+    return { canceledCount: result.canceled_count };
+  }
+
+  async upgradeWorkflowRuns(workflowId: string, options: { toVersion: number, runKey?: string, fromVersion?: number }): Promise<AdminWorkflowUpgradeResult> {
+    const result = await this._interface.upgradeWorkflowRuns(workflowId, {
+      to_version: options.toVersion,
+      run_key: options.runKey,
+      from_version: options.fromVersion,
+    });
+    return {
+      upgradedCount: result.upgraded_count,
+      skipped: result.skipped.map((skip) => ({
+        runId: skip.run_id,
+        runKey: skip.run_key,
+        fromVersion: skip.from_version,
+        diagnostic: {
+          reason: skip.diagnostic.reason,
+          suspendedStepKey: skip.diagnostic.suspended_step_key,
+          foundStepKey: skip.diagnostic.found_step_key,
+          consumedStepKeys: skip.diagnostic.consumed_step_keys,
+          unconsumedStepKeys: skip.diagnostic.unconsumed_step_keys,
+          details: skip.diagnostic.details,
+        },
+      })),
+    };
+  }
+
+  async retryWorkflowRun(runId: string): Promise<void> {
+    await this._interface.retryWorkflowRun(runId);
+    await this._adminWorkflowsCache.refresh([]);
+  }
+
+  async sendWorkflowEvent(name: string, data?: unknown): Promise<{ eventId: string }> {
+    const result = await this._interface.sendWorkflowEvent(name, data ?? null);
+    return { eventId: result.event_id };
+  }
+
   async listEmailDrafts(): Promise<{ id: string, displayName: string, themeId: string | undefined | false, tsxSource: string, sentAt: Date | null }[]> {
     const crud = Result.orThrow(await this._adminEmailDraftsCache.getOrWait([], "write-only"));
     return crud.map((draft) => ({

package/src/lib/hexclave-app/apps/interfaces/admin-app.ts

@@ -14,6 +14,7 @@ import { InternalApiKey, InternalApiKeyCreateOptions, InternalApiKeyFirstView }
 import { AdminProjectPermission, AdminProjectPermissionDefinition, AdminProjectPermissionDefinitionCreateOptions, AdminProjectPermissionDefinitionUpdateOptions, AdminTeamPermission, AdminTeamPermissionDefinition, AdminTeamPermissionDefinitionCreateOptions, AdminTeamPermissionDefinitionUpdateOptions } from "../../permissions";
 import type { PlanUsage } from "../../plan-usage";
 import { AdminProject } from "../../projects";
+import type { AdminWorkflow, AdminWorkflowRun, AdminWorkflowRunDetails, AdminWorkflowRunsFilter, AdminWorkflowSyncResult, AdminWorkflowUpgradeResult, AdminWorkflowVersion } from "../../workflows";
 import { _HexclaveAdminAppImpl } from "../implementations";
 import { StackServerApp, StackServerAppConstructorOptions } from "./server-app";
 
@@ -60,6 +61,7 @@ export type ManagedEmailProviderListItem = {
 
 import type { AdminSessionReplay, ListSessionReplayChunksOptions, ListSessionReplayChunksResult, ListSessionReplaysOptions, ListSessionReplaysResult, SessionReplayAllEventsResult } from "../../session-replays";
 export type { AdminSessionReplay, AdminSessionReplayChunk, ListSessionReplaysOptions, ListSessionReplaysResult, ListSessionReplayChunksOptions, ListSessionReplayChunksResult, SessionReplayAllEventsResult } from "../../session-replays";
+export type { AdminWorkflow, AdminWorkflowDivergenceDiagnostic, AdminWorkflowRun, AdminWorkflowRunDetails, AdminWorkflowRunsFilter, AdminWorkflowRunState, AdminWorkflowStep, AdminWorkflowStepAttempt, AdminWorkflowSyncResult, AdminWorkflowTrigger, AdminWorkflowUpgradeResult, AdminWorkflowVersion } from "../../workflows";
 
 
 /** @deprecated Use `HexclaveAdminAppConstructorOptions` from the `@hexclave/*` package instead — same symbol, new brand name. See https://docs.hexclave.com/migration. */
@@ -83,6 +85,7 @@ export type StackAdminApp<HasTokenStore extends boolean = boolean, ProjectId ext
   & AsyncStoreProperty<"emailPreview", [{ themeId?: string | null | false, themeTsxSource?: string, templateId?: string, templateTsxSource?: string }], string, false>
   & AsyncStoreProperty<"emailTemplates", [], { id: string, displayName: string, themeId?: string, tsxSource: string }[], true>
   & AsyncStoreProperty<"emailDrafts", [], { id: string, displayName: string, themeId: string | undefined | false, tsxSource: string, sentAt: Date | null }[], true>
+  & AsyncStoreProperty<"workflows", [], AdminWorkflow[], true>
   & AsyncStoreProperty<"stripeAccountInfo", [], { account_id: string, charges_enabled: boolean, details_submitted: boolean, payouts_enabled: boolean } | null, false>
   & AsyncStoreProperty<
     "transactions",
@@ -138,6 +141,22 @@ export type StackAdminApp<HasTokenStore extends boolean = boolean, ProjectId ext
     createEmailTemplate(displayName: string): Promise<{ id: string }>,
     deleteEmailTemplate(id: string): Promise<void>,
 
+    // Workflows (internal-project gated; see the Workflows v1 spec). The
+    // management verbs live on the admin app only in v1.
+    createWorkflow(options: { id: string, displayName?: string, source: string }): Promise<AdminWorkflowSyncResult>,
+    updateWorkflowSource(workflowId: string, source: string): Promise<AdminWorkflowSyncResult>,
+    deleteWorkflow(workflowId: string): Promise<void>,
+    listWorkflowVersions(workflowId: string): Promise<AdminWorkflowVersion[]>,
+    listWorkflowRuns: {
+      (workflowId: string, filter: AdminWorkflowRunsFilter & { includeState: true }): Promise<{ runs: AdminWorkflowRunDetails[], nextCursor: string | null }>,
+      (workflowId: string, filter?: AdminWorkflowRunsFilter): Promise<{ runs: AdminWorkflowRun[], nextCursor: string | null }>,
+    },
+    getWorkflowRun(runId: string): Promise<AdminWorkflowRunDetails>,
+    cancelWorkflowRuns(workflowId: string, filter?: { runKey?: string, runId?: string, state?: "queued" | "running" | "sleeping", version?: number }): Promise<{ canceledCount: number }>,
+    upgradeWorkflowRuns(workflowId: string, options: { toVersion: number, runKey?: string, fromVersion?: number }): Promise<AdminWorkflowUpgradeResult>,
+    retryWorkflowRun(runId: string): Promise<void>,
+    sendWorkflowEvent(name: string, data?: unknown): Promise<{ eventId: string }>,
+
     setupPayments(): Promise<{ url: string }>,
     createStripeWidgetAccountSession(): Promise<{ client_secret: string }>,
     getPaymentMethodConfigs(): Promise<{ configId: string, methods: Array<{ id: string, name: string, enabled: boolean, available: boolean, overridable: boolean }> } | null>,

package/src/lib/hexclave-app/index.ts

@@ -45,6 +45,21 @@ export type {
   EmailOutboxUpdateOptions
 } from "./apps/interfaces/admin-app";
 
+export type {
+  AdminWorkflow,
+  AdminWorkflowDivergenceDiagnostic,
+  AdminWorkflowRun,
+  AdminWorkflowRunDetails,
+  AdminWorkflowRunsFilter,
+  AdminWorkflowRunState,
+  AdminWorkflowStep,
+  AdminWorkflowStepAttempt,
+  AdminWorkflowSyncResult,
+  AdminWorkflowTrigger,
+  AdminWorkflowUpgradeResult,
+  AdminWorkflowVersion
+} from "./workflows";
+
 export type {
   ProjectConfig
 } from "./project-configs";

package/src/lib/hexclave-app/workflows.test.ts

@@ -0,0 +1,28 @@
+
+//===========================================
+// THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY UNLESS YOU ALSO EDIT THE CORRESPONDING FILE IN packages/template
+//===========================================
+import type { WorkflowVersionJson } from "@hexclave/shared/dist/interface/workflows";
+import { describe, expect, it } from "vitest";
+import { adminWorkflowVersionFromCrud } from "./workflows";
+
+describe("adminWorkflowVersionFromCrud", () => {
+  it("preserves the deployment source hash", () => {
+    const version: WorkflowVersionJson = {
+      workflow_id: "daily-report",
+      version: 3,
+      source: "export default 1",
+      source_hash: "0123456789abcdef",
+      runtime_env_version: "v1",
+      is_latest: true,
+      in_flight_runs: 2,
+      created_at_millis: 1234,
+    };
+
+    expect(adminWorkflowVersionFromCrud(version)).toMatchObject({
+      workflowId: "daily-report",
+      version: 3,
+      sourceHash: "0123456789abcdef",
+    });
+  });
+});