@lessly/sdk-app 67.3.0 → 67.5.0

package/src/gen/types.gen.ts

@@ -111051,6 +111051,57 @@ has_more: boolean
 next_cursor: (string | null)
 }
 
+export interface WorkflowCapListInput {
+
+}
+
+export interface WorkflowCapListOutput {
+items: {
+/**
+ * Spent in the window running now. Null when the key is contested — the runs spent against several different windows and no one number is the truth.
+ */
+used: (number | null)
+/**
+ * Null when the declarations disagree.
+ */
+limit: (number | null)
+/**
+ * Null when the declarations disagree: no single window is true for the key.
+ */
+window: (string | null)
+cap_key: string
+/**
+ * `limit - used`, or null when either is unknown.
+ */
+remaining: (number | null)
+/**
+ * Who shares this budget. Empty for a key that has counters but no live declaration.
+ */
+workflows: {
+name: string
+/**
+ * What THIS workflow declared.
+ */
+limit: number
+/**
+ * What THIS workflow declared. Always true, even when the key is contested.
+ */
+window: string
+/**
+ * The cap node in that workflow’s live version, loop bodies included.
+ */
+node_id: string
+version: number
+workflow_id: string
+}[]
+/**
+ * Two live workflows declare different budgets under this one key.
+ */
+conflicting: boolean
+window_start: (string | null)
+}[]
+}
+
 export interface WorkflowCapabilityGetInput {
 /**
  * Tool name of an action (e.g. "mail_email_send") or event name of a trigger.
@@ -111064,7 +111115,7 @@ http?: ({
 path: string
 method: string
 } | null)
-kind: ("action" | "event" | "schedule" | "manual")
+kind: ("action" | "event" | "schedule" | "batch" | "manual")
 title: string
 schema?: {
 [k: string]: unknown
@@ -111118,7 +111169,7 @@ http?: ({
 path: string
 method: string
 } | null)
-kind: ("action" | "event" | "schedule" | "manual")
+kind: ("action" | "event" | "schedule" | "batch" | "manual")
 title: string
 schema?: {
 [k: string]: unknown
@@ -111524,6 +111575,37 @@ description: (string | null)
 live_version: (number | null)
 }
 
+export interface WorkflowDefinitionEstimateInput {
+/**
+ * A workflow definition: trigger, nodes, edges, grants, config_refs.
+ */
+definition?: {
+[k: string]: unknown
+}
+workflow_id?: string
+}
+
+/**
+ * There is deliberately no `count` on `unavailable`: "we could not ask" and "nobody is in the audience" are opposite facts. `grant_missing` is the ordinary answer for an unpublished draft — the source's grant arrives at publish.
+ */
+export type WorkflowDefinitionEstimateOutput = ({
+/**
+ * Runs one tick would start: the trigger filter is applied. A floor when `exact` is false.
+ */
+count: number
+/**
+ * False when the page budget ran out before the source did; `count` is then "at least this many".
+ */
+exact: boolean
+status: "counted"
+counted_pages: number
+page_limit_reached: boolean
+} | {
+reason: ("unknown_tool" | "not_a_batch_trigger" | "source_failed" | "grant_missing")
+status: "unavailable"
+counted_pages: number
+})
+
 export interface WorkflowDefinitionExportInput {
 /**
  * Defaults to the live version.
@@ -112422,6 +112504,10 @@ started_at: (string | null)
 held_reason?: {
 [k: string]: unknown
 }
+/**
+ * Who this run is about, rendered once from the definition’s `subject` at run start and frozen. Null when the workflow declares no subject.
+ */
+subject_key: (string | null)
 workflow_id: string
 trigger_event_id: string
 replay_generation: number
@@ -112449,6 +112535,10 @@ started_at: (string | null)
 held_reason?: {
 [k: string]: unknown
 }
+/**
+ * Who this run is about, rendered once from the definition’s `subject` at run start and frozen. Null when the workflow declares no subject.
+ */
+subject_key: (string | null)
 workflow_id: string
 trigger_event_id: string
 replay_generation: number
@@ -112496,6 +112586,10 @@ limit?: number
  */
 cursor?: string
 status?: ("created" | "queued" | "running" | "waiting" | "succeeded" | "failed" | "held" | "cancelled" | "paused_ceiling")
+/**
+ * Every run about one subject — the frozen key, not the template.
+ */
+subject_key?: string
 workflow_id?: string
 }
 
@@ -112517,6 +112611,10 @@ started_at: (string | null)
 held_reason?: {
 [k: string]: unknown
 }
+/**
+ * Who this run is about, rendered once from the definition’s `subject` at run start and frozen. Null when the workflow declares no subject.
+ */
+subject_key: (string | null)
 workflow_id: string
 trigger_event_id: string
 replay_generation: number
@@ -112549,6 +112647,10 @@ started_at: (string | null)
 held_reason?: {
 [k: string]: unknown
 }
+/**
+ * Who this run is about, rendered once from the definition’s `subject` at run start and frozen. Null when the workflow declares no subject.
+ */
+subject_key: (string | null)
 workflow_id: string
 trigger_event_id: string
 replay_generation: number
@@ -112685,11 +112787,213 @@ started_at: (string | null)
 held_reason?: {
 [k: string]: unknown
 }
+/**
+ * Who this run is about, rendered once from the definition’s `subject` at run start and frozen. Null when the workflow declares no subject.
+ */
+subject_key: (string | null)
 workflow_id: string
 trigger_event_id: string
 replay_generation: number
 }
 
+export interface WorkflowTemplateApplyInput {
+/**
+ * Defaults to the template's own name.
+ */
+name?: string
+template_id: string
+}
+
+export interface WorkflowTemplateApplyOutput {
+live: ({
+note: (string | null)
+version: number
+published_at: (string | null)
+} | null)
+draft: ({
+[k: string]: unknown
+} | null)
+/**
+ * The workflow principal's grants; null when Governance could not be reached.
+ */
+grants: ({
+/**
+ * What to do next, when something needs doing; null when nothing does.
+ */
+hint: (string | null)
+grants: {
+/**
+ * "approved" is the only status a call gets through on.
+ */
+status: ("pending" | "approved" | "revoked" | "needs_sponsor")
+tool_key: string
+approved_at: (string | null)
+/**
+ * The member who vouches for the grant.
+ */
+sponsor_member_id: (string | null)
+}[]
+/**
+ * Tool keys asked for and waiting on a human.
+ */
+pending: string[]
+/**
+ * Tool keys a human withdrew. Approving one again is not enough: Governance does not resurrect a revoked grant, so it has to be asked for first.
+ */
+revoked: string[]
+/**
+ * Tool keys the workflow may call right now.
+ */
+effective: string[]
+/**
+ * Tool keys that were approved and lost their sponsor.
+ */
+needs_sponsor: string[]
+} | null)
+/**
+ * What the dependency check found; null when nothing is unknown.
+ */
+health: ({
+unknown: {
+kind: ("trigger" | "action")
+name: string
+reason: ("missing" | "schema_changed")
+node_id?: string
+toolkit: string
+}[]
+/**
+ * What a recovery restores.
+ */
+previous_status?: ("draft" | "enabled" | "disabled")
+} | null)
+/**
+ * Validation of the draft as it stands right now.
+ */
+issues: {
+/**
+ * A documented issue code; repair by reacting to this, not to prose.
+ */
+code: string
+hint?: string
+/**
+ * JSON Pointer into the definition.
+ */
+path: string
+actual?: string
+node_id?: string
+expected?: string
+severity: ("error" | "warning")
+}[]
+/**
+ * The last 20 health entries, newest first; `workflow_health_list` pages the rest.
+ */
+timeline: {
+at: string
+fix?: unknown
+/**
+ * `broken`, `recovered`, `grants_pending`, `grant_revoked`, `sponsor_gone`, `grants_ok` and whatever the dispatcher and the executor record beside them.
+ */
+kind: string
+detail?: unknown
+}[]
+workflow: {
+id: string
+name: string
+/**
+ * `broken` is the dependency check's, not an operator's: a capability is gone.
+ */
+status: ("draft" | "enabled" | "disabled" | "broken")
+/**
+ * What starts this workflow and how big it is, without fetching the definition. Taken from the live version when one is live, from the draft otherwise.
+ */
+summary: {
+/**
+ * What starts the workflow; null when the definition declares no trigger.
+ */
+trigger: ({
+/**
+ * Set for `schedule` and `batch`; null otherwise.
+ */
+cron: (string | null)
+kind: ("event" | "schedule" | "batch" | "manual")
+/**
+ * The event name for `event`, the source tool for `batch`; null otherwise.
+ */
+name: (string | null)
+} | null)
+/**
+ * Steps in the graph; a loop counts as one.
+ */
+node_count: number
+}
+/**
+ * What is stopping an otherwise published workflow; null when nothing is.
+ */
+attention: ({
+code: ("grants_pending" | "sponsor_gone" | "grant_revoked" | "rate_limited" | "auto_disable_warning")
+detail: {
+/**
+ * Set instead when Governance could not be asked.
+ */
+error?: string
+/**
+ * The tools still waiting on a sponsor.
+ */
+tools?: string[]
+}
+} | null)
+created_at: string
+updated_at: string
+description: (string | null)
+live_version: (number | null)
+}
+/**
+ * What the live version was validated against, with the hashes it saw.
+ */
+dependencies: {
+kind: ("trigger" | "action")
+/**
+ * The event name of the trigger, or the tool name of the action.
+ */
+name: string
+toolkit: string
+/**
+ * The hash the capability had at publish; a drift means broken.
+ */
+schema_hash: string
+}[]
+}
+
+export interface WorkflowTemplateListInput {
+
+}
+
+export interface WorkflowTemplateListOutput {
+items: {
+id: string
+name: string
+/**
+ * Empty when applicable. An inapplicable template is shown with this, never hidden.
+ */
+missing: {
+/**
+ * The tool name or event name the template needs.
+ */
+key: string
+kind: ("tool" | "event")
+/**
+ * Why this template cannot work without it, as a sentence to show a person.
+ */
+reason: string
+}[]
+/**
+ * False when something in `missing` is not registered on this Product.
+ */
+applicable: boolean
+description: string
+}[]
+}
+
 export interface WorkflowVersionGetInput {
 /**
  * 0 is the draft.

package/src/gen/workflow/index.ts

@@ -1,3 +1,3 @@
 // AUTOGENERATED by scripts/generate.ts — do not edit.
 export * from './queryOptions.gen';
-export type { WorkflowCapabilityGetInput, WorkflowCapabilityGetOutput, WorkflowCapabilityListInput, WorkflowCapabilityListOutput, WorkflowConfigDeleteInput, WorkflowConfigDeleteOutput, WorkflowConfigListInput, WorkflowConfigListOutput, WorkflowConfigSetInput, WorkflowConfigSetOutput, WorkflowDefinitionCreateInput, WorkflowDefinitionCreateOutput, WorkflowDefinitionDisableInput, WorkflowDefinitionDisableOutput, WorkflowDefinitionDryrunInput, WorkflowDefinitionDryrunOutput, WorkflowDefinitionEnableInput, WorkflowDefinitionEnableOutput, WorkflowDefinitionExportInput, WorkflowDefinitionExportOutput, WorkflowDefinitionGetInput, WorkflowDefinitionGetOutput, WorkflowDefinitionImportInput, WorkflowDefinitionImportOutput, WorkflowDefinitionListInput, WorkflowDefinitionListOutput, WorkflowDefinitionPublishInput, WorkflowDefinitionPublishOutput, WorkflowDefinitionUpdateInput, WorkflowDefinitionUpdateOutput, WorkflowDefinitionValidateInput, WorkflowDefinitionValidateOutput, WorkflowDependencyListInput, WorkflowDependencyListOutput, WorkflowGrantListInput, WorkflowGrantListOutput, WorkflowGrantRequestInput, WorkflowGrantRequestOutput, WorkflowHealthListInput, WorkflowHealthListOutput, WorkflowHealthPingInput, WorkflowHealthPingOutput, WorkflowKillswitchGetInput, WorkflowKillswitchGetOutput, WorkflowKillswitchSetInput, WorkflowKillswitchSetOutput, WorkflowRunCancelInput, WorkflowRunCancelOutput, WorkflowRunGetInput, WorkflowRunGetOutput, WorkflowRunListInput, WorkflowRunListOutput, WorkflowRunReplayAllInput, WorkflowRunReplayAllOutput, WorkflowRunReplayInput, WorkflowRunReplayOutput, WorkflowRunStartInput, WorkflowRunStartOutput, WorkflowRunStatsInput, WorkflowRunStatsOutput, WorkflowRunTestInput, WorkflowRunTestOutput, WorkflowVersionGetInput, WorkflowVersionGetOutput, WorkflowVersionListInput, WorkflowVersionListOutput, WorkflowWaitGetInput, WorkflowWaitGetOutput, WorkflowWaitListAllInput, WorkflowWaitListAllOutput, WorkflowWaitListInput, WorkflowWaitListOutput, WorkflowWaitResolveInput, WorkflowWaitResolveOutput } from '../types.gen';
+export type { WorkflowCapListInput, WorkflowCapListOutput, WorkflowCapabilityGetInput, WorkflowCapabilityGetOutput, WorkflowCapabilityListInput, WorkflowCapabilityListOutput, WorkflowConfigDeleteInput, WorkflowConfigDeleteOutput, WorkflowConfigListInput, WorkflowConfigListOutput, WorkflowConfigSetInput, WorkflowConfigSetOutput, WorkflowDefinitionCreateInput, WorkflowDefinitionCreateOutput, WorkflowDefinitionDisableInput, WorkflowDefinitionDisableOutput, WorkflowDefinitionDryrunInput, WorkflowDefinitionDryrunOutput, WorkflowDefinitionEnableInput, WorkflowDefinitionEnableOutput, WorkflowDefinitionEstimateInput, WorkflowDefinitionEstimateOutput, WorkflowDefinitionExportInput, WorkflowDefinitionExportOutput, WorkflowDefinitionGetInput, WorkflowDefinitionGetOutput, WorkflowDefinitionImportInput, WorkflowDefinitionImportOutput, WorkflowDefinitionListInput, WorkflowDefinitionListOutput, WorkflowDefinitionPublishInput, WorkflowDefinitionPublishOutput, WorkflowDefinitionUpdateInput, WorkflowDefinitionUpdateOutput, WorkflowDefinitionValidateInput, WorkflowDefinitionValidateOutput, WorkflowDependencyListInput, WorkflowDependencyListOutput, WorkflowGrantListInput, WorkflowGrantListOutput, WorkflowGrantRequestInput, WorkflowGrantRequestOutput, WorkflowHealthListInput, WorkflowHealthListOutput, WorkflowHealthPingInput, WorkflowHealthPingOutput, WorkflowKillswitchGetInput, WorkflowKillswitchGetOutput, WorkflowKillswitchSetInput, WorkflowKillswitchSetOutput, WorkflowRunCancelInput, WorkflowRunCancelOutput, WorkflowRunGetInput, WorkflowRunGetOutput, WorkflowRunListInput, WorkflowRunListOutput, WorkflowRunReplayAllInput, WorkflowRunReplayAllOutput, WorkflowRunReplayInput, WorkflowRunReplayOutput, WorkflowRunStartInput, WorkflowRunStartOutput, WorkflowRunStatsInput, WorkflowRunStatsOutput, WorkflowRunTestInput, WorkflowRunTestOutput, WorkflowTemplateApplyInput, WorkflowTemplateApplyOutput, WorkflowTemplateListInput, WorkflowTemplateListOutput, WorkflowVersionGetInput, WorkflowVersionGetOutput, WorkflowVersionListInput, WorkflowVersionListOutput, WorkflowWaitGetInput, WorkflowWaitGetOutput, WorkflowWaitListAllInput, WorkflowWaitListAllOutput, WorkflowWaitListInput, WorkflowWaitListOutput, WorkflowWaitResolveInput, WorkflowWaitResolveOutput } from '../types.gen';

package/src/gen/workflow/queryOptions.gen.ts

@@ -1,6 +1,8 @@
 // AUTOGENERATED by scripts/generate.ts — do not edit.
 import type { GeneratedClient } from '../client.gen';
 import type {
+  WorkflowCapListInput,
+  WorkflowCapListOutput,
   WorkflowCapabilityGetInput,
   WorkflowCapabilityGetOutput,
   WorkflowCapabilityListInput,
@@ -14,6 +16,8 @@ import type {
   WorkflowDefinitionDryrunInput,
   WorkflowDefinitionDryrunOutput,
   WorkflowDefinitionEnableInput,
+  WorkflowDefinitionEstimateInput,
+  WorkflowDefinitionEstimateOutput,
   WorkflowDefinitionExportInput,
   WorkflowDefinitionExportOutput,
   WorkflowDefinitionGetInput,
@@ -48,6 +52,9 @@ import type {
   WorkflowRunStatsInput,
   WorkflowRunStatsOutput,
   WorkflowRunTestInput,
+  WorkflowTemplateApplyInput,
+  WorkflowTemplateListInput,
+  WorkflowTemplateListOutput,
   WorkflowVersionGetInput,
   WorkflowVersionGetOutput,
   WorkflowVersionListInput,
@@ -61,6 +68,11 @@ import type {
   WorkflowWaitResolveInput,
 } from '../types.gen';
 
+export const workflowCapListQueryOptions = (sdk: GeneratedClient, input: WorkflowCapListInput) => ({
+  queryKey: ['workflow', 'cap', 'list', input] as const,
+  queryFn: () => sdk['workflow']['cap']['list'](input),
+});
+
 export const workflowCapabilityGetQueryOptions = (sdk: GeneratedClient, input: WorkflowCapabilityGetInput) => ({
   queryKey: ['workflow', 'capability', 'get', input] as const,
   queryFn: () => sdk['workflow']['capability']['get'](input),
@@ -106,6 +118,11 @@ export const workflowDefinitionEnableMutationOptions = (sdk: GeneratedClient) =>
   mutationFn: (input: WorkflowDefinitionEnableInput) => sdk['workflow']['definition']['enable'](input),
 });
 
+export const workflowDefinitionEstimateQueryOptions = (sdk: GeneratedClient, input: WorkflowDefinitionEstimateInput) => ({
+  queryKey: ['workflow', 'definition', 'estimate', input] as const,
+  queryFn: () => sdk['workflow']['definition']['estimate'](input),
+});
+
 export const workflowDefinitionExportQueryOptions = (sdk: GeneratedClient, input: WorkflowDefinitionExportInput) => ({
   queryKey: ['workflow', 'definition', 'export', input] as const,
   queryFn: () => sdk['workflow']['definition']['export'](input),
@@ -216,6 +233,16 @@ export const workflowRunTestMutationOptions = (sdk: GeneratedClient) => ({
   mutationFn: (input: WorkflowRunTestInput) => sdk['workflow']['run']['test'](input),
 });
 
+export const workflowTemplateApplyMutationOptions = (sdk: GeneratedClient) => ({
+  mutationKey: ['workflow', 'template', 'apply'],
+  mutationFn: (input: WorkflowTemplateApplyInput) => sdk['workflow']['template']['apply'](input),
+});
+
+export const workflowTemplateListQueryOptions = (sdk: GeneratedClient, input: WorkflowTemplateListInput) => ({
+  queryKey: ['workflow', 'template', 'list', input] as const,
+  queryFn: () => sdk['workflow']['template']['list'](input),
+});
+
 export const workflowVersionGetQueryOptions = (sdk: GeneratedClient, input: WorkflowVersionGetInput) => ({
   queryKey: ['workflow', 'version', 'get', input] as const,
   queryFn: () => sdk['workflow']['version']['get'](input),