@flowrunner/cli 0.1.13 → 0.1.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (80) hide show
  1. package/ai-docs/instructions/service-code-format/02-zod-types.md +3 -1
  2. package/ai-docs/instructions/service-code-format/04-http-requests.md +9 -0
  3. package/ai-docs/instructions/service-code-format/05-dictionaries.md +59 -1
  4. package/ai-docs/instructions/service-code-format/06-oauth2.md +68 -9
  5. package/ai-docs/instructions/service-code-format/07-actions.md +1 -1
  6. package/ai-docs/instructions/service-code-format/08-polling-triggers.md +13 -0
  7. package/ai-docs/instructions/service-code-format/09-realtime-triggers.md +110 -4
  8. package/ai-docs/instructions/service-code-format/11-output-model.md +6 -0
  9. package/ai-docs/instructions/service-code-format/16-gotchas.md +24 -0
  10. package/ai-docs/instructions/service-code-format/18-test-recipes.md +16 -0
  11. package/ai-docs/instructions/service-code-format/19-security.md +121 -0
  12. package/ai-docs/instructions/service-code-format/README.md +3 -2
  13. package/ai-docs/providers/claude/agents/flowrunner-service-code-engineer.md +1 -1
  14. package/dist/cli.js +10605 -73
  15. package/dist/cli.js.map +4 -4
  16. package/dist/index.js +10574 -66
  17. package/dist/index.js.map +4 -4
  18. package/dist/types/flow-extension-runner/src/v2/dictionaries/dictionary-method.d.ts +1 -0
  19. package/dist/types/flow-extension-runner/src/v2/model/field-mapper.d.ts +4 -2
  20. package/dist/types/flow-extension-runner/src/v2/model/params-model.d.ts +2 -2
  21. package/dist/types/flow-extension-runner/src/v2/oauth/types.d.ts +9 -7
  22. package/dist/types/flow-extension-runner/src/v2/params/index.d.ts +1 -0
  23. package/dist/types/flow-extension-runner/src/v2/params/json/encode.d.ts +7 -1
  24. package/dist/types/flow-extension-runner/src/v2/params/schema/dictionary-binding.d.ts +37 -0
  25. package/dist/types/flow-extension-runner/src/v2/params/zod.d.ts +7 -5
  26. package/dist/types/flow-extension-runner/src/v2/realtime-triggers/types.d.ts +2 -1
  27. package/dist/types/flow-extension-runner/src/v2/types.d.ts +1 -0
  28. package/dist/types/shared/src/constants/activity-log.d.ts +77 -0
  29. package/dist/types/shared/src/constants/app.d.ts +0 -1
  30. package/dist/types/shared/src/constants/error-codes.d.ts +3 -0
  31. package/dist/types/shared/src/constants/index.d.ts +1 -0
  32. package/dist/types/shared/src/constants/notification-types.d.ts +176 -6
  33. package/dist/types/shared/src/constants/oauth-connection-error.d.ts +3 -0
  34. package/dist/types/shared/src/errors/api.d.ts +11 -0
  35. package/dist/types/shared/src/errors/index.d.ts +1 -0
  36. package/dist/types/shared/src/errors/oauth-connection.d.ts +4 -0
  37. package/dist/types/shared/src/scheme/account/dto.d.ts +3 -0
  38. package/dist/types/shared/src/scheme/crm/dto.d.ts +6 -0
  39. package/dist/types/shared/src/scheme/flowrunner/java.dto.d.ts +26 -0
  40. package/dist/types/shared/src/scheme/index.d.ts +1 -0
  41. package/dist/types/shared/src/scheme/integration-connection/dto.d.ts +68 -14
  42. package/dist/types/shared/src/scheme/notifications/dto.d.ts +4 -0
  43. package/dist/types/shared/src/scheme/notifications/rest.d.ts +8 -0
  44. package/dist/types/shared/src/scheme/onboarding/dto.d.ts +29 -0
  45. package/dist/types/shared/src/scheme/onboarding/index.d.ts +1 -0
  46. package/dist/types/shared/src/scheme/shared-extensions/list.d.ts +52 -11
  47. package/dist/types/shared/src/scheme/shared-extensions/workspace-stack.d.ts +2 -2
  48. package/package.json +1 -4
  49. package/runtime/index.js +10563 -45
  50. package/runtime/index.js.map +4 -4
  51. package/runtime/types/flow-extension-runner/src/v2/dictionaries/dictionary-method.d.ts +1 -0
  52. package/runtime/types/flow-extension-runner/src/v2/model/field-mapper.d.ts +4 -2
  53. package/runtime/types/flow-extension-runner/src/v2/model/params-model.d.ts +2 -2
  54. package/runtime/types/flow-extension-runner/src/v2/oauth/types.d.ts +9 -7
  55. package/runtime/types/flow-extension-runner/src/v2/params/index.d.ts +1 -0
  56. package/runtime/types/flow-extension-runner/src/v2/params/json/encode.d.ts +7 -1
  57. package/runtime/types/flow-extension-runner/src/v2/params/schema/dictionary-binding.d.ts +37 -0
  58. package/runtime/types/flow-extension-runner/src/v2/params/zod.d.ts +7 -5
  59. package/runtime/types/flow-extension-runner/src/v2/realtime-triggers/types.d.ts +2 -1
  60. package/runtime/types/flow-extension-runner/src/v2/types.d.ts +1 -0
  61. package/runtime/types/shared/src/constants/activity-log.d.ts +77 -0
  62. package/runtime/types/shared/src/constants/app.d.ts +0 -1
  63. package/runtime/types/shared/src/constants/error-codes.d.ts +3 -0
  64. package/runtime/types/shared/src/constants/index.d.ts +1 -0
  65. package/runtime/types/shared/src/constants/notification-types.d.ts +176 -6
  66. package/runtime/types/shared/src/constants/oauth-connection-error.d.ts +3 -0
  67. package/runtime/types/shared/src/errors/api.d.ts +11 -0
  68. package/runtime/types/shared/src/errors/index.d.ts +1 -0
  69. package/runtime/types/shared/src/errors/oauth-connection.d.ts +4 -0
  70. package/runtime/types/shared/src/scheme/account/dto.d.ts +3 -0
  71. package/runtime/types/shared/src/scheme/crm/dto.d.ts +6 -0
  72. package/runtime/types/shared/src/scheme/flowrunner/java.dto.d.ts +26 -0
  73. package/runtime/types/shared/src/scheme/index.d.ts +1 -0
  74. package/runtime/types/shared/src/scheme/integration-connection/dto.d.ts +68 -14
  75. package/runtime/types/shared/src/scheme/notifications/dto.d.ts +4 -0
  76. package/runtime/types/shared/src/scheme/notifications/rest.d.ts +8 -0
  77. package/runtime/types/shared/src/scheme/onboarding/dto.d.ts +29 -0
  78. package/runtime/types/shared/src/scheme/onboarding/index.d.ts +1 -0
  79. package/runtime/types/shared/src/scheme/shared-extensions/list.d.ts +52 -11
  80. package/runtime/types/shared/src/scheme/shared-extensions/workspace-stack.d.ts +2 -2
@@ -11,6 +11,7 @@ export declare class DictionaryMethod extends ExtensionMethod {
11
11
  private readonly props;
12
12
  readonly criteria: MethodParams;
13
13
  readonly result: ResultSpec;
14
+ readonly criteriaAliases?: Record<string, string[]>;
14
15
  constructor(extension: Extension, props: DictionaryProps);
15
16
  get id(): string;
16
17
  get name(): string;
@@ -1,10 +1,12 @@
1
1
  import type { ConfigItem } from '../../common/types';
2
+ import { DictionaryScope } from '../params/schema/dictionary-binding';
2
3
  import { type AnyZod } from '../params/schema/introspect';
3
4
  import type { SharedExtensionMetaInfoArg, SharedExtensionParam } from './model-types';
4
5
  export interface FieldToParamOptions {
5
6
  nested?: boolean;
7
+ scope?: DictionaryScope;
6
8
  }
7
9
  export declare function fieldToParam(name: string, schema: AnyZod, options?: FieldToParamOptions): SharedExtensionParam;
8
- export declare function propertiesOf(objectCore: AnyZod | undefined): SharedExtensionParam[];
9
- export declare function fieldToArg(name: string, schema: AnyZod): SharedExtensionMetaInfoArg;
10
+ export declare function propertiesOf(objectCore: AnyZod | undefined, scope?: DictionaryScope): SharedExtensionParam[];
11
+ export declare function fieldToArg(name: string, schema: AnyZod, scope?: DictionaryScope): SharedExtensionMetaInfoArg;
10
12
  export declare function fieldToConfigItem(name: string, schema: AnyZod): ConfigItem;
@@ -1,5 +1,5 @@
1
1
  import type { ConfigItem } from '../../common/types';
2
- import type { ConfigParams, MethodParams, Params } from '../params';
2
+ import { type ConfigParams, DictionaryScope, type MethodParams, type Params } from '../params';
3
3
  import type { SharedExtensionMetaInfoArg, SharedExtensionParam } from './model-types';
4
4
  export declare function toBodyParams(params: MethodParams): SharedExtensionParam[];
5
5
  export declare function toArgs(params: MethodParams): Record<string, SharedExtensionMetaInfoArg>;
@@ -12,5 +12,5 @@ export declare function toArgs(params: MethodParams): Record<string, SharedExten
12
12
  * must stay compatible with declares them exactly this way.
13
13
  */
14
14
  export declare function toOpaqueBodyParams(params: MethodParams): SharedExtensionParam[];
15
- export declare function toProperties(params: Params): SharedExtensionParam[];
15
+ export declare function toProperties(params: Params, scope?: DictionaryScope): SharedExtensionParam[];
16
16
  export declare function toConfigItems(config: ConfigParams): ConfigItem[];
@@ -18,11 +18,17 @@ export interface OAuthRefreshResult {
18
18
  expirationInSeconds?: number;
19
19
  refreshToken?: string;
20
20
  }
21
+ export interface OAuthStoredToken<TUserData = unknown> {
22
+ accessToken: string;
23
+ refreshToken?: string;
24
+ userData?: TUserData;
25
+ }
21
26
  export interface OAuthBag<TToken = unknown> {
22
27
  accessToken?: string;
23
28
  token?: TToken;
29
+ userData?: unknown;
24
30
  }
25
- export interface OAuth2Props<TShape extends ExtensionShape = AnyShape, TToken = unknown> {
31
+ export interface OAuth2Props<TShape extends ExtensionShape = AnyShape, TToken = OAuthStoredToken> {
26
32
  scopes?: string[];
27
33
  authorizeUrl?: string;
28
34
  tokenUrl?: string;
@@ -36,12 +42,8 @@ export interface OAuth2Props<TShape extends ExtensionShape = AnyShape, TToken =
36
42
  imageUrl?: string | null;
37
43
  userData?: unknown;
38
44
  };
39
- serializeToken?: (data: {
40
- accessToken: string;
41
- refreshToken?: string;
42
- userData?: unknown;
43
- }) => string;
44
- deserializeToken?: (accessToken: string) => TToken;
45
+ serializeToken?: (stored: OAuthStoredToken) => string;
46
+ deserializeToken?: (token: string) => TToken;
45
47
  getConnectionURL?: (bag: HandlerBag<TShape> & {
46
48
  scopes: string[];
47
49
  }) => string | Promise<string>;
@@ -4,6 +4,7 @@ export { Params } from './params';
4
4
  export type { NormalizedInput, SchemaSource, ZodIssue, ZodSchema } from './types';
5
5
  export * from './widget-types';
6
6
  export { describeField, FORMAT_DESCRIPTIONS, TYPE_DESCRIPTIONS, WIDGET_DESCRIPTIONS, } from './schema/defaults';
7
+ export { type DictionaryBinding, DictionaryScope, publishedBinding, type ResolvedDependsOn, resolveDependsOn, } from './schema/dictionary-binding';
7
8
  export type { AnyZod, Inspected, WidgetInfo } from './schema/introspect';
8
9
  export { deriveWidget, fieldLabels, inspect, shapeEntries } from './schema/introspect';
9
10
  export { humanizeKey, labelOf } from './schema/labels';
@@ -1,3 +1,4 @@
1
+ import { DictionaryScope } from '../schema/dictionary-binding';
1
2
  import { type AnyZod } from '../schema/introspect';
2
3
  import { type FieldJSON, type ParamsSchemaJSON } from './types';
3
4
  /**
@@ -7,6 +8,11 @@ import { type FieldJSON, type ParamsSchemaJSON } from './types';
7
8
  */
8
9
  export interface EncodeParamsOptions {
9
10
  loaderIdOf?: (fieldName: string) => string;
11
+ /**
12
+ * What the level ABOVE these fields sees, for their `.dictionary()` bindings — the owner's params, when the
13
+ * fields are a loader's. Omitted, the fields are a method's top level.
14
+ */
15
+ scope?: DictionaryScope;
10
16
  }
11
17
  /**
12
18
  * One declared field → its wire form.
@@ -16,7 +22,7 @@ export interface EncodeParamsOptions {
16
22
  * added before descending and removed after, which makes the check below a cycle test rather than a
17
23
  * deduplication.
18
24
  */
19
- export declare function encodeField(name: string, schema: AnyZod, seen?: Set<unknown>, loaderId?: string): FieldJSON;
25
+ export declare function encodeField(name: string, schema: AnyZod, seen?: Set<unknown>, loaderId?: string, scope?: DictionaryScope): FieldJSON;
20
26
  /**
21
27
  * A whole declared slot → its wire form. `null` for an undeclared slot, which is legal everywhere: a method
22
28
  * with no params publishes no schema rather than an empty one.
@@ -0,0 +1,37 @@
1
+ export interface DictionaryBinding {
2
+ id: string;
3
+ dependsOn: string[];
4
+ criteriaAliases?: Record<string, string[]>;
5
+ }
6
+ /**
7
+ * The param names visible at one level of a declared schema.
8
+ *
9
+ * Entered once per level of fields: the first level is the method's top level, and every level below it sees
10
+ * its own fields plus the top level — not the levels in between, which the console does not send.
11
+ */
12
+ export declare class DictionaryScope {
13
+ private readonly top;
14
+ readonly visible: ReadonlySet<string>;
15
+ static readonly ROOT: DictionaryScope;
16
+ private constructor();
17
+ enter(names: string[]): DictionaryScope;
18
+ }
19
+ export interface ResolvedDependsOn {
20
+ dependsOn: string[];
21
+ clash?: {
22
+ key: string;
23
+ names: string[];
24
+ };
25
+ }
26
+ /**
27
+ * Each criteria key → the one of `[key, ...aliases]` visible in `scope`, or the key itself when none is.
28
+ *
29
+ * Without aliases this is the identity, so a service that declares none publishes exactly what it always did.
30
+ * On a clash the canonical key (or the first visible alias) is published and the clash is reported; the
31
+ * registration guard turns it into an error (./assert-supported-schema.ts).
32
+ */
33
+ export declare function resolveDependsOn(binding: DictionaryBinding, scope: DictionaryScope): ResolvedDependsOn;
34
+ export declare function publishedBinding(binding: DictionaryBinding, scope: DictionaryScope): {
35
+ id: string;
36
+ dependsOn: string[];
37
+ };
@@ -1,9 +1,11 @@
1
1
  import { z as baseZod } from 'zod';
2
2
  import { filesDeleteOptions, filesGetOptions, filesListOptions, filesUploadOptions } from './files-options';
3
+ import type { DictionaryBinding } from './schema/dictionary-binding';
3
4
  import { type FrWidgetToken } from './widget-types';
4
5
  export interface DictionaryRef {
5
6
  id: string;
6
7
  dependsOn?: string[];
8
+ criteriaAliases?: Record<string, string[]>;
7
9
  }
8
10
  /**
9
11
  * What `.dynamicProps()` takes: the sibling params whose values the loader receives as `criteria`, and the
@@ -26,10 +28,7 @@ export interface FrMeta {
26
28
  description?: string;
27
29
  examples?: unknown[];
28
30
  frShared?: boolean;
29
- frDictionary?: {
30
- id: string;
31
- dependsOn: string[];
32
- };
31
+ frDictionary?: DictionaryBinding;
33
32
  frLabels?: Record<string, string>;
34
33
  /** A widget token the declaration carries explicitly — see `FrWidgetToken` in ./widget-types.ts. */
35
34
  frWidget?: FrWidgetToken;
@@ -61,7 +60,10 @@ declare module 'zod' {
61
60
  * its input would suggest a protection that is not there.
62
61
  */
63
62
  secret(): this;
64
- /** Bind a param to a dictionary for dynamic options; auto-derives `dependsOn` from the dictionary criteria. */
63
+ /**
64
+ * Bind a param to a dictionary for dynamic options; auto-derives `dependsOn` from the dictionary criteria —
65
+ * through its `criteriaAliases`, as the names this param's method declares.
66
+ */
65
67
  dictionary(ref: DictionaryRef): this;
66
68
  /**
67
69
  * Show a human label per declared VALUE: `.labels({ asc: 'Ascending' })`.
@@ -38,7 +38,7 @@ export interface RealtimeVerify<TShape extends ExtensionShape = AnyShape> {
38
38
  encoding: 'hex' | 'base64';
39
39
  secret: (config: TShape['config'], bag: {
40
40
  webhookData: ProviderPayload;
41
- }) => string;
41
+ }) => string | null | undefined;
42
42
  freshness?: number;
43
43
  timestampHeader?: string;
44
44
  }
@@ -66,6 +66,7 @@ export interface RealtimeSetupProps<TShape extends ExtensionShape = AnyShape> {
66
66
  verify?: RealtimeVerify<TShape>;
67
67
  handshake?: (bag: InboundBag<TShape> & {
68
68
  requestBody: ProviderPayload;
69
+ query: Record<string, unknown>;
69
70
  }) => HandshakeResult | boolean | void | Promise<HandshakeResult | boolean | void>;
70
71
  subscribe: (bag: HandlerBag<TShape> & {
71
72
  callbackUrl: string;
@@ -86,6 +86,7 @@ export interface DictionaryProps<TShape extends ExtensionShape = AnyShape, TCrit
86
86
  label?: string;
87
87
  description?: string;
88
88
  criteria?: TCriteria;
89
+ criteriaAliases?: Record<string, string[]>;
89
90
  result?: unknown;
90
91
  oauth2Scopes?: string[];
91
92
  execute: (bag: HandlerBag<TShape> & {
@@ -95,6 +95,9 @@ export declare enum ActivityLogOperation {
95
95
  WS_PANIC_MODE_DISABLED = "WS_PANIC_MODE_DISABLED",
96
96
  WS_HIPAA_COMPLIANCE_ENABLED = "WS_HIPAA_COMPLIANCE_ENABLED",
97
97
  WS_HIPAA_COMPLIANCE_DISABLED = "WS_HIPAA_COMPLIANCE_DISABLED",
98
+ WS_SSO_CONFIG_SAVED = "WS_SSO_CONFIG_SAVED",
99
+ WS_SSO_CONFIG_DELETED = "WS_SSO_CONFIG_DELETED",
100
+ WS_SSO_RELINK_PERMITTED = "WS_SSO_RELINK_PERMITTED",
98
101
  WS_ACCESS_KEY_ROTATED = "WS_ACCESS_KEY_ROTATED",
99
102
  WS_ACCOUNT_PERMISSIONS_CHANGED = "WS_ACCOUNT_PERMISSIONS_CHANGED",
100
103
  WS_OWNERSHIP_TRANSFER_STARTED = "WS_OWNERSHIP_TRANSFER_STARTED",
@@ -134,6 +137,9 @@ export declare enum ActivityLogOperation {
134
137
  ACC_FLOW_INSTANCES_EXPORT_COMPLETED = "ACC_FLOW_INSTANCES_EXPORT_COMPLETED",
135
138
  ACC_FLOW_INSTANCES_EXPORT_FAILED = "ACC_FLOW_INSTANCES_EXPORT_FAILED",
136
139
  ACC_PASSWORD_RESTORE_REQUESTED = "ACC_PASSWORD_RESTORE_REQUESTED",
140
+ ACC_ACTIVATED_BY_SSO = "ACC_ACTIVATED_BY_SSO",
141
+ ACC_SSO_RELINK_PERMITTED = "ACC_SSO_RELINK_PERMITTED",
142
+ ACC_SSO_SIGN_IN_LINKS_REQUESTED = "ACC_SSO_SIGN_IN_LINKS_REQUESTED",
137
143
  ACC_LOGIN_OTP_ISSUED = "ACC_LOGIN_OTP_ISSUED",
138
144
  ACC_EMAIL_CONFIRMATION_REQUESTED = "ACC_EMAIL_CONFIRMATION_REQUESTED",
139
145
  ACC_PAYMENT_CONFIRMATION_REQUIRED = "ACC_PAYMENT_CONFIRMATION_REQUIRED",
@@ -794,6 +800,32 @@ export declare const ActivityLogOperationsConfigs: {
794
800
  summary: string;
795
801
  detailsSchema: z.ZodObject<{}, z.core.$strict>;
796
802
  };
803
+ WS_SSO_CONFIG_SAVED: {
804
+ scope: ActivityLogScope.WORKSPACE;
805
+ severity: "warning";
806
+ category: ActivityLogCategory.WORKSPACE_MANAGE;
807
+ title: string;
808
+ summary: string;
809
+ detailsSchema: z.ZodObject<{}, z.core.$strict>;
810
+ };
811
+ WS_SSO_CONFIG_DELETED: {
812
+ scope: ActivityLogScope.WORKSPACE;
813
+ severity: "warning";
814
+ category: ActivityLogCategory.WORKSPACE_MANAGE;
815
+ title: string;
816
+ summary: string;
817
+ detailsSchema: z.ZodObject<{}, z.core.$strict>;
818
+ };
819
+ WS_SSO_RELINK_PERMITTED: {
820
+ scope: ActivityLogScope.WORKSPACE;
821
+ severity: "warning";
822
+ category: ActivityLogCategory.WORKSPACE_MANAGE;
823
+ title: ({ accountName }: Record<string, unknown>) => string;
824
+ summary: string;
825
+ detailsSchema: z.ZodObject<{
826
+ accountId: z.ZodOptional<z.ZodString>;
827
+ }, z.core.$strip>;
828
+ };
797
829
  WS_ACCESS_KEY_ROTATED: {
798
830
  scope: ActivityLogScope.WORKSPACE;
799
831
  severity: "critical";
@@ -1079,6 +1111,8 @@ export declare const ActivityLogOperationsConfigs: {
1079
1111
  version: z.ZodOptional<z.ZodNumber>;
1080
1112
  executionId: z.ZodOptional<z.ZodString>;
1081
1113
  reason: z.ZodOptional<z.ZodString>;
1114
+ terminationKind: z.ZodOptional<z.ZodEnum<typeof import("./notification-types").FlowTerminationKind>>;
1115
+ parentExecutionId: z.ZodOptional<z.ZodString>;
1082
1116
  }, z.core.$strip>;
1083
1117
  notify: {
1084
1118
  type: "FLOW_INSTANCE_TERMINATED";
@@ -1327,11 +1361,54 @@ export declare const ActivityLogOperationsConfigs: {
1327
1361
  summary: string;
1328
1362
  detailsSchema: z.ZodObject<{
1329
1363
  restorePwdId: z.ZodString;
1364
+ ssoWorkspaceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
1330
1365
  }, z.core.$strip>;
1331
1366
  notify: {
1332
1367
  type: "PASSWORD_RESTORE_REQUESTED";
1333
1368
  };
1334
1369
  };
1370
+ ACC_ACTIVATED_BY_SSO: {
1371
+ scope: ActivityLogScope.ACCOUNT;
1372
+ severity: "warning";
1373
+ category: ActivityLogCategory.ACCOUNT;
1374
+ title: ({ workspaceName }: Record<string, unknown>) => string;
1375
+ summary: string;
1376
+ detailsSchema: z.ZodObject<{
1377
+ workspaceId: z.ZodString;
1378
+ }, z.core.$strip>;
1379
+ notify: {
1380
+ type: "ACTIVATED_BY_SSO";
1381
+ };
1382
+ };
1383
+ ACC_SSO_RELINK_PERMITTED: {
1384
+ scope: ActivityLogScope.ACCOUNT;
1385
+ severity: "warning";
1386
+ category: ActivityLogCategory.WORKSPACE_MANAGE;
1387
+ title: ({ workspaceName }: Record<string, unknown>) => string;
1388
+ summary: string;
1389
+ detailsSchema: z.ZodObject<{
1390
+ workspaceId: z.ZodString;
1391
+ }, z.core.$strip>;
1392
+ notify: {
1393
+ type: "SSO_RELINK_PERMITTED";
1394
+ };
1395
+ };
1396
+ ACC_SSO_SIGN_IN_LINKS_REQUESTED: {
1397
+ scope: ActivityLogScope.ACCOUNT;
1398
+ severity: "info";
1399
+ category: ActivityLogCategory.ACCOUNT;
1400
+ title: string;
1401
+ summary: string;
1402
+ detailsSchema: z.ZodObject<{
1403
+ links: z.ZodArray<z.ZodObject<{
1404
+ workspaceId: z.ZodString;
1405
+ signInUrl: z.ZodString;
1406
+ }, z.core.$strip>>;
1407
+ }, z.core.$strip>;
1408
+ notify: {
1409
+ type: "SSO_SIGN_IN_LINKS_REQUESTED";
1410
+ };
1411
+ };
1335
1412
  ACC_LOGIN_OTP_ISSUED: {
1336
1413
  scope: ActivityLogScope.ACCOUNT;
1337
1414
  severity: "info";
@@ -53,6 +53,5 @@ export declare const PRESERVED_SCREENS: {
53
53
  general: number;
54
54
  team: number;
55
55
  billing: number;
56
- 'log-management': number;
57
56
  };
58
57
  export type PreservedScreenType = keyof typeof PRESERVED_SCREENS;
@@ -15,3 +15,6 @@ export declare enum CommonErrorTypes {
15
15
  CLOUD_CODE_RESPONSE_TOO_LARGE = "CLOUD_CODE_RESPONSE_TOO_LARGE",
16
16
  VECTOR_SEARCH_ERROR = "VECTOR_SEARCH_ERROR"
17
17
  }
18
+ export declare enum OAuthConnectionErrorTypes {
19
+ OAUTH_CONNECTION_RECONNECT_REQUIRED = "OAUTH_CONNECTION_RECONNECT_REQUIRED"
20
+ }
@@ -10,6 +10,7 @@ export * from './error-codes';
10
10
  export * from './knowledge-base';
11
11
  export * from './notification-types';
12
12
  export * from './notifications';
13
+ export * from './oauth-connection-error';
13
14
  export * from './patterns';
14
15
  export * from './retry-policy';
15
16
  export * from './severity';
@@ -37,6 +37,7 @@ export declare const FlowInstancesExportFailedDataSchema: z.ZodObject<{
37
37
  export declare const PasswordRestoreRequestedDataSchema: z.ZodObject<{
38
38
  devName: z.ZodString;
39
39
  restorePwdId: z.ZodString;
40
+ ssoWorkspaceNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
40
41
  }, z.core.$strip>;
41
42
  export declare const WorkspaceDevInvitationDataSchema: z.ZodObject<{
42
43
  inviterName: z.ZodString;
@@ -64,6 +65,20 @@ export declare const PaymentConfirmationRequiredDataSchema: z.ZodObject<{
64
65
  currency: z.ZodOptional<z.ZodString>;
65
66
  expiresInSeconds: z.ZodOptional<z.ZodNumber>;
66
67
  }, z.core.$strip>;
68
+ export declare const AccountActivatedBySsoDataSchema: z.ZodObject<{
69
+ workspaceName: z.ZodOptional<z.ZodString>;
70
+ }, z.core.$strip>;
71
+ export declare const SsoRelinkPermittedDataSchema: z.ZodObject<{
72
+ workspaceName: z.ZodOptional<z.ZodString>;
73
+ adminName: z.ZodOptional<z.ZodString>;
74
+ }, z.core.$strip>;
75
+ export declare const SsoSignInLinksRequestedDataSchema: z.ZodObject<{
76
+ links: z.ZodArray<z.ZodObject<{
77
+ workspaceId: z.ZodString;
78
+ workspaceName: z.ZodOptional<z.ZodString>;
79
+ signInUrl: z.ZodString;
80
+ }, z.core.$strip>>;
81
+ }, z.core.$strip>;
67
82
  export declare const AccountNotificationTypes: {
68
83
  readonly OWNERSHIP_TRANSFER_REQUEST: {
69
84
  readonly severity: "warning";
@@ -123,6 +138,45 @@ export declare const AccountNotificationTypes: {
123
138
  readonly dataSchema: z.ZodObject<{
124
139
  devName: z.ZodString;
125
140
  restorePwdId: z.ZodString;
141
+ ssoWorkspaceNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
142
+ }, z.core.$strip>;
143
+ };
144
+ readonly ACTIVATED_BY_SSO: {
145
+ readonly severity: "warning";
146
+ readonly title: "Your account was activated through single sign-on";
147
+ readonly message: (data: Record<string, unknown>) => string;
148
+ readonly emailTemplate: "account-activated-by-sso";
149
+ readonly tags: ["account", "security"];
150
+ readonly requireAccountId: true;
151
+ readonly dataSchema: z.ZodObject<{
152
+ workspaceName: z.ZodOptional<z.ZodString>;
153
+ }, z.core.$strip>;
154
+ };
155
+ readonly SSO_RELINK_PERMITTED: {
156
+ readonly severity: "warning";
157
+ readonly title: "Your single sign-on connection was reset";
158
+ readonly message: (data: Record<string, unknown>) => string;
159
+ readonly emailTemplate: "sso-connection-reset";
160
+ readonly tags: ["account", "security"];
161
+ readonly requireAccountId: true;
162
+ readonly dataSchema: z.ZodObject<{
163
+ workspaceName: z.ZodOptional<z.ZodString>;
164
+ adminName: z.ZodOptional<z.ZodString>;
165
+ }, z.core.$strip>;
166
+ };
167
+ readonly SSO_SIGN_IN_LINKS_REQUESTED: {
168
+ readonly severity: "info";
169
+ readonly title: "Your single sign-on links";
170
+ readonly message: "The workspaces you sign in to through single sign-on have been emailed to you.";
171
+ readonly emailTemplate: "sso-sign-in-links";
172
+ readonly tags: ["account"];
173
+ readonly requireAccountId: true;
174
+ readonly dataSchema: z.ZodObject<{
175
+ links: z.ZodArray<z.ZodObject<{
176
+ workspaceId: z.ZodString;
177
+ workspaceName: z.ZodOptional<z.ZodString>;
178
+ signInUrl: z.ZodString;
179
+ }, z.core.$strip>>;
126
180
  }, z.core.$strip>;
127
181
  };
128
182
  readonly WORKSPACE_DEV_INVITATION: {
@@ -207,13 +261,27 @@ export declare const AccountNotificationTypes: {
207
261
  readonly requireAccountId: true;
208
262
  };
209
263
  };
264
+ export declare enum FlowTerminationKind {
265
+ FAILURE = "FAILURE",
266
+ TIMEOUT = "TIMEOUT",
267
+ WORKSPACE_SUSPENSION = "WORKSPACE_SUSPENSION",
268
+ SYSTEM_LIFECYCLE = "SYSTEM_LIFECYCLE",
269
+ USER_INSTANCE_STOPPED = "USER_INSTANCE_STOPPED",
270
+ USER_FLOW_VERSION_STOPPED = "USER_FLOW_VERSION_STOPPED"
271
+ }
210
272
  export declare const FlowInstanceTerminatedDataSchema: z.ZodObject<{
211
273
  flowId: z.ZodOptional<z.ZodString>;
212
274
  flowName: z.ZodString;
213
275
  version: z.ZodOptional<z.ZodNumber>;
214
276
  executionId: z.ZodOptional<z.ZodString>;
215
277
  reason: z.ZodOptional<z.ZodString>;
278
+ terminationKind: z.ZodOptional<z.ZodEnum<typeof FlowTerminationKind>>;
279
+ parentExecutionId: z.ZodOptional<z.ZodString>;
216
280
  }, z.core.$strip>;
281
+ export declare function flowTerminationPhrasing(kind: unknown): {
282
+ verb: string;
283
+ clause: string;
284
+ };
217
285
  export declare const FlowExtensionPollingTriggerFailedDataSchema: z.ZodObject<{
218
286
  flowId: z.ZodOptional<z.ZodString>;
219
287
  flowName: z.ZodOptional<z.ZodString>;
@@ -230,6 +298,18 @@ export declare const FlowExtensionPollingTriggerFailedDataSchema: z.ZodObject<{
230
298
  reason: z.ZodOptional<z.ZodString>;
231
299
  error: z.ZodOptional<z.ZodString>;
232
300
  }, z.core.$strip>;
301
+ export declare const OAuthConnectionRefreshTokenFailedDataSchema: z.ZodObject<{
302
+ hostType: z.ZodEnum<{
303
+ APP: "APP";
304
+ SHARED: "SHARED";
305
+ }>;
306
+ packageId: z.ZodString;
307
+ serviceId: z.ZodString;
308
+ serviceName: z.ZodString;
309
+ connectionId: z.ZodString;
310
+ connectionName: z.ZodString;
311
+ code: z.ZodString;
312
+ }, z.core.$strip>;
233
313
  export declare const FlowExtensionRealtimeTriggerFailedDataSchema: z.ZodObject<{
234
314
  developerFullName: z.ZodOptional<z.ZodString>;
235
315
  serviceName: z.ZodOptional<z.ZodString>;
@@ -363,7 +443,7 @@ export declare const WorkspaceNotificationTypes: {
363
443
  readonly FLOW_INSTANCE_TERMINATED: {
364
444
  readonly severity: "warning";
365
445
  readonly title: (data: Record<string, unknown>) => string;
366
- readonly message: "A flow instance was terminated.";
446
+ readonly message: (data: Record<string, unknown>) => string;
367
447
  readonly emailTemplate: "flow-instance-terminated";
368
448
  readonly tags: ["flow-execution"];
369
449
  readonly dataSchema: z.ZodObject<{
@@ -372,12 +452,14 @@ export declare const WorkspaceNotificationTypes: {
372
452
  version: z.ZodOptional<z.ZodNumber>;
373
453
  executionId: z.ZodOptional<z.ZodString>;
374
454
  reason: z.ZodOptional<z.ZodString>;
455
+ terminationKind: z.ZodOptional<z.ZodEnum<typeof FlowTerminationKind>>;
456
+ parentExecutionId: z.ZodOptional<z.ZodString>;
375
457
  }, z.core.$strip>;
376
458
  readonly grouping: {
377
- readonly keyFields: ["flowId"];
459
+ readonly keyFields: ["flowId", "terminationKind"];
378
460
  readonly windowMs: number;
379
461
  readonly title: (data: Record<string, unknown>) => string;
380
- readonly message: () => string;
462
+ readonly message: (data: Record<string, unknown>) => string;
381
463
  };
382
464
  };
383
465
  readonly FLOW_EXTENSION_POLLING_TRIGGER_FAILED: {
@@ -403,6 +485,29 @@ export declare const WorkspaceNotificationTypes: {
403
485
  error: z.ZodOptional<z.ZodString>;
404
486
  }, z.core.$strip>;
405
487
  };
488
+ readonly OAUTH_CONNECTION_REFRESH_TOKEN_FAILED: {
489
+ readonly severity: "warning";
490
+ readonly title: (data: Record<string, unknown>) => string;
491
+ readonly message: (data: Record<string, unknown>) => string;
492
+ readonly emailTemplate: "oauth-connection-refresh-token-failed";
493
+ readonly tags: ["flow-execution"];
494
+ readonly dataSchema: z.ZodObject<{
495
+ hostType: z.ZodEnum<{
496
+ APP: "APP";
497
+ SHARED: "SHARED";
498
+ }>;
499
+ packageId: z.ZodString;
500
+ serviceId: z.ZodString;
501
+ serviceName: z.ZodString;
502
+ connectionId: z.ZodString;
503
+ connectionName: z.ZodString;
504
+ code: z.ZodString;
505
+ }, z.core.$strip>;
506
+ readonly grouping: {
507
+ readonly keyFields: ["connectionId"];
508
+ readonly windowMs: number;
509
+ };
510
+ };
406
511
  readonly FLOW_EXTENSION_REALTIME_TRIGGER_FAILED: {
407
512
  readonly severity: "critical";
408
513
  readonly title: (data: Record<string, unknown>) => string;
@@ -593,6 +698,7 @@ export type AccountNotificationType = keyof typeof AccountNotificationTypes;
593
698
  export type WorkspaceNotificationType = keyof typeof WorkspaceNotificationTypes;
594
699
  export type AllNotificationType = AccountNotificationType | WorkspaceNotificationType;
595
700
  export type FlowExtensionPollingTriggerFailedDetails = z.infer<typeof FlowExtensionPollingTriggerFailedDataSchema>;
701
+ export type OAuthConnectionRefreshTokenFailedDetails = z.infer<typeof OAuthConnectionRefreshTokenFailedDataSchema>;
596
702
  export type FlowInstanceTerminatedDetails = z.infer<typeof FlowInstanceTerminatedDataSchema>;
597
703
  export declare const AccountNotificationTypeKeys: KeysTuple<typeof AccountNotificationTypes>;
598
704
  export declare const WorkspaceNotificationTypeKeys: KeysTuple<typeof WorkspaceNotificationTypes>;
@@ -694,7 +800,7 @@ export declare const AllNotificationTypes: {
694
800
  readonly FLOW_INSTANCE_TERMINATED: {
695
801
  readonly severity: "warning";
696
802
  readonly title: (data: Record<string, unknown>) => string;
697
- readonly message: "A flow instance was terminated.";
803
+ readonly message: (data: Record<string, unknown>) => string;
698
804
  readonly emailTemplate: "flow-instance-terminated";
699
805
  readonly tags: ["flow-execution"];
700
806
  readonly dataSchema: z.ZodObject<{
@@ -703,12 +809,14 @@ export declare const AllNotificationTypes: {
703
809
  version: z.ZodOptional<z.ZodNumber>;
704
810
  executionId: z.ZodOptional<z.ZodString>;
705
811
  reason: z.ZodOptional<z.ZodString>;
812
+ terminationKind: z.ZodOptional<z.ZodEnum<typeof FlowTerminationKind>>;
813
+ parentExecutionId: z.ZodOptional<z.ZodString>;
706
814
  }, z.core.$strip>;
707
815
  readonly grouping: {
708
- readonly keyFields: ["flowId"];
816
+ readonly keyFields: ["flowId", "terminationKind"];
709
817
  readonly windowMs: number;
710
818
  readonly title: (data: Record<string, unknown>) => string;
711
- readonly message: () => string;
819
+ readonly message: (data: Record<string, unknown>) => string;
712
820
  };
713
821
  };
714
822
  readonly FLOW_EXTENSION_POLLING_TRIGGER_FAILED: {
@@ -734,6 +842,29 @@ export declare const AllNotificationTypes: {
734
842
  error: z.ZodOptional<z.ZodString>;
735
843
  }, z.core.$strip>;
736
844
  };
845
+ readonly OAUTH_CONNECTION_REFRESH_TOKEN_FAILED: {
846
+ readonly severity: "warning";
847
+ readonly title: (data: Record<string, unknown>) => string;
848
+ readonly message: (data: Record<string, unknown>) => string;
849
+ readonly emailTemplate: "oauth-connection-refresh-token-failed";
850
+ readonly tags: ["flow-execution"];
851
+ readonly dataSchema: z.ZodObject<{
852
+ hostType: z.ZodEnum<{
853
+ APP: "APP";
854
+ SHARED: "SHARED";
855
+ }>;
856
+ packageId: z.ZodString;
857
+ serviceId: z.ZodString;
858
+ serviceName: z.ZodString;
859
+ connectionId: z.ZodString;
860
+ connectionName: z.ZodString;
861
+ code: z.ZodString;
862
+ }, z.core.$strip>;
863
+ readonly grouping: {
864
+ readonly keyFields: ["connectionId"];
865
+ readonly windowMs: number;
866
+ };
867
+ };
737
868
  readonly FLOW_EXTENSION_REALTIME_TRIGGER_FAILED: {
738
869
  readonly severity: "critical";
739
870
  readonly title: (data: Record<string, unknown>) => string;
@@ -977,6 +1108,45 @@ export declare const AllNotificationTypes: {
977
1108
  readonly dataSchema: z.ZodObject<{
978
1109
  devName: z.ZodString;
979
1110
  restorePwdId: z.ZodString;
1111
+ ssoWorkspaceNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
1112
+ }, z.core.$strip>;
1113
+ };
1114
+ readonly ACTIVATED_BY_SSO: {
1115
+ readonly severity: "warning";
1116
+ readonly title: "Your account was activated through single sign-on";
1117
+ readonly message: (data: Record<string, unknown>) => string;
1118
+ readonly emailTemplate: "account-activated-by-sso";
1119
+ readonly tags: ["account", "security"];
1120
+ readonly requireAccountId: true;
1121
+ readonly dataSchema: z.ZodObject<{
1122
+ workspaceName: z.ZodOptional<z.ZodString>;
1123
+ }, z.core.$strip>;
1124
+ };
1125
+ readonly SSO_RELINK_PERMITTED: {
1126
+ readonly severity: "warning";
1127
+ readonly title: "Your single sign-on connection was reset";
1128
+ readonly message: (data: Record<string, unknown>) => string;
1129
+ readonly emailTemplate: "sso-connection-reset";
1130
+ readonly tags: ["account", "security"];
1131
+ readonly requireAccountId: true;
1132
+ readonly dataSchema: z.ZodObject<{
1133
+ workspaceName: z.ZodOptional<z.ZodString>;
1134
+ adminName: z.ZodOptional<z.ZodString>;
1135
+ }, z.core.$strip>;
1136
+ };
1137
+ readonly SSO_SIGN_IN_LINKS_REQUESTED: {
1138
+ readonly severity: "info";
1139
+ readonly title: "Your single sign-on links";
1140
+ readonly message: "The workspaces you sign in to through single sign-on have been emailed to you.";
1141
+ readonly emailTemplate: "sso-sign-in-links";
1142
+ readonly tags: ["account"];
1143
+ readonly requireAccountId: true;
1144
+ readonly dataSchema: z.ZodObject<{
1145
+ links: z.ZodArray<z.ZodObject<{
1146
+ workspaceId: z.ZodString;
1147
+ workspaceName: z.ZodOptional<z.ZodString>;
1148
+ signInUrl: z.ZodString;
1149
+ }, z.core.$strip>>;
980
1150
  }, z.core.$strip>;
981
1151
  };
982
1152
  readonly WORKSPACE_DEV_INVITATION: {
@@ -0,0 +1,3 @@
1
+ export declare const ConnectionErrorTypes: {
2
+ readonly TOKEN_REFRESH: "token_refresh";
3
+ };
@@ -1,4 +1,15 @@
1
1
  import { ApiError } from './base';
2
+ import { NotAuthorizedError } from './common';
2
3
  export declare class ClITokenExpiredError extends ApiError {
3
4
  constructor(message?: string);
4
5
  }
6
+ /**
7
+ * The caller's own developer auth key is missing or was rejected — an expired session, a signed-out tab, a
8
+ * key from another cluster. Expected traffic, not a server fault (logged at debug, see `handlers.ts`).
9
+ *
10
+ * Throw it only for the USER's key. A 401 to a call made with the console's own credentials is a
11
+ * misconfiguration and must stay an error.
12
+ */
13
+ export declare class InvalidAuthKeyError extends NotAuthorizedError {
14
+ constructor(message?: string);
15
+ }
@@ -8,6 +8,7 @@ export * from './api';
8
8
  export * from './base';
9
9
  export * from './common';
10
10
  export * from './k8s';
11
+ export * from './oauth-connection';
11
12
  export * from './open-search';
12
13
  export * from './s3';
13
14
  export * from '../constants/error-codes';