@yadsh/dsh-qa-integrations 0.9.0 → 0.10.1

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 (184) hide show
  1. package/README.md +32 -21
  2. package/compatibility.json +7 -3
  3. package/lib/broker.js +172 -17
  4. package/lib/broker.js.map +1 -1
  5. package/lib/client/bitrix24.js +8 -6
  6. package/lib/client/bitrix24.js.map +1 -1
  7. package/lib/client/card.js +14 -13
  8. package/lib/client/card.js.map +1 -1
  9. package/lib/client/confluence.js +11 -7
  10. package/lib/client/confluence.js.map +1 -1
  11. package/lib/client/credential-help-note.js +51 -0
  12. package/lib/client/credential-help-note.js.map +1 -0
  13. package/lib/client/gitlab.js +8 -6
  14. package/lib/client/gitlab.js.map +1 -1
  15. package/lib/client/index.js +38 -32
  16. package/lib/client/index.js.map +1 -1
  17. package/lib/client/integrations.js +31 -18
  18. package/lib/client/integrations.js.map +1 -1
  19. package/lib/client/jira.js +10 -8
  20. package/lib/client/jira.js.map +1 -1
  21. package/lib/client/operator-card.js +93 -534
  22. package/lib/client/operator-card.js.map +1 -1
  23. package/lib/client/operator-controls.js +72 -23
  24. package/lib/client/operator-controls.js.map +1 -1
  25. package/lib/client/operator-sections/bitrix24.js +22 -0
  26. package/lib/client/operator-sections/bitrix24.js.map +1 -0
  27. package/lib/client/operator-sections/confluence.js +27 -0
  28. package/lib/client/operator-sections/confluence.js.map +1 -0
  29. package/lib/client/operator-sections/credential-help.js +15 -0
  30. package/lib/client/operator-sections/credential-help.js.map +1 -0
  31. package/lib/client/operator-sections/general.js +8 -0
  32. package/lib/client/operator-sections/general.js.map +1 -0
  33. package/lib/client/operator-sections/gitlab.js +41 -0
  34. package/lib/client/operator-sections/gitlab.js.map +1 -0
  35. package/lib/client/operator-sections/jira.js +25 -0
  36. package/lib/client/operator-sections/jira.js.map +1 -0
  37. package/lib/client/operator-sections/provider-section.js +21 -0
  38. package/lib/client/operator-sections/provider-section.js.map +1 -0
  39. package/lib/client/operator-sections/service-profiles.js +178 -0
  40. package/lib/client/operator-sections/service-profiles.js.map +1 -0
  41. package/lib/client/operator-sections/shared.js +192 -0
  42. package/lib/client/operator-sections/shared.js.map +1 -0
  43. package/lib/client/operator-sections/teamcity.js +42 -0
  44. package/lib/client/operator-sections/teamcity.js.map +1 -0
  45. package/lib/client/operator-sections/testit.js +35 -0
  46. package/lib/client/operator-sections/testit.js.map +1 -0
  47. package/lib/client/operator-sections/weblate.js +32 -0
  48. package/lib/client/operator-sections/weblate.js.map +1 -0
  49. package/lib/client/operator-service-reach.js +98 -0
  50. package/lib/client/operator-service-reach.js.map +1 -0
  51. package/lib/client/provider-card.js +32 -19
  52. package/lib/client/provider-card.js.map +1 -1
  53. package/lib/client/styles.js +52 -15
  54. package/lib/client/styles.js.map +1 -1
  55. package/lib/client/teamcity.js +7 -5
  56. package/lib/client/teamcity.js.map +1 -1
  57. package/lib/client/testit.js +8 -6
  58. package/lib/client/testit.js.map +1 -1
  59. package/lib/client/weblate.js +8 -6
  60. package/lib/client/weblate.js.map +1 -1
  61. package/lib/client.js +2838 -1923
  62. package/lib/client.js.map +1 -1
  63. package/lib/config.js +64 -17
  64. package/lib/config.js.map +1 -1
  65. package/lib/errors.js +5 -0
  66. package/lib/errors.js.map +1 -1
  67. package/lib/index.js +176 -222
  68. package/lib/index.js.map +1 -1
  69. package/lib/providers/bitrix24/tools.js +7 -2
  70. package/lib/providers/bitrix24/tools.js.map +1 -1
  71. package/lib/providers/bitrix24/transport.js +28 -8
  72. package/lib/providers/bitrix24/transport.js.map +1 -1
  73. package/lib/providers/confluence/config.js +14 -55
  74. package/lib/providers/confluence/config.js.map +1 -1
  75. package/lib/providers/confluence/tools.js +7 -2
  76. package/lib/providers/confluence/tools.js.map +1 -1
  77. package/lib/providers/confluence/transport.js +42 -78
  78. package/lib/providers/confluence/transport.js.map +1 -1
  79. package/lib/providers/gitlab/config.js +11 -55
  80. package/lib/providers/gitlab/config.js.map +1 -1
  81. package/lib/providers/gitlab/operations.js +3 -3
  82. package/lib/providers/gitlab/operations.js.map +1 -1
  83. package/lib/providers/gitlab/tools.js +7 -2
  84. package/lib/providers/gitlab/tools.js.map +1 -1
  85. package/lib/providers/gitlab/transport.js +33 -65
  86. package/lib/providers/gitlab/transport.js.map +1 -1
  87. package/lib/providers/jira/config.js +18 -58
  88. package/lib/providers/jira/config.js.map +1 -1
  89. package/lib/providers/jira/jql.js +105 -1
  90. package/lib/providers/jira/jql.js.map +1 -1
  91. package/lib/providers/jira/tools.js +68 -2
  92. package/lib/providers/jira/tools.js.map +1 -1
  93. package/lib/providers/jira/transport.js +44 -110
  94. package/lib/providers/jira/transport.js.map +1 -1
  95. package/lib/providers/kernel/address.js +90 -0
  96. package/lib/providers/kernel/address.js.map +1 -0
  97. package/lib/providers/kernel/errors.js +42 -0
  98. package/lib/providers/kernel/errors.js.map +1 -0
  99. package/lib/providers/kernel/read-policy.js +276 -0
  100. package/lib/providers/kernel/read-policy.js.map +1 -0
  101. package/lib/providers/kernel/token.js +45 -0
  102. package/lib/providers/kernel/token.js.map +1 -0
  103. package/lib/providers/shared/service-boundary.js +31 -3
  104. package/lib/providers/shared/service-boundary.js.map +1 -1
  105. package/lib/providers/teamcity/tools.js +8 -3
  106. package/lib/providers/teamcity/tools.js.map +1 -1
  107. package/lib/providers/teamcity/transport.js +6 -8
  108. package/lib/providers/teamcity/transport.js.map +1 -1
  109. package/lib/providers/testit/config.js +12 -57
  110. package/lib/providers/testit/config.js.map +1 -1
  111. package/lib/providers/testit/tools.js +7 -2
  112. package/lib/providers/testit/tools.js.map +1 -1
  113. package/lib/providers/testit/transport.js +12 -12
  114. package/lib/providers/testit/transport.js.map +1 -1
  115. package/lib/providers/weblate/config.js +12 -55
  116. package/lib/providers/weblate/config.js.map +1 -1
  117. package/lib/providers/weblate/tools.js +7 -2
  118. package/lib/providers/weblate/tools.js.map +1 -1
  119. package/lib/providers/weblate/transport.js +21 -20
  120. package/lib/providers/weblate/transport.js.map +1 -1
  121. package/lib/public-api.js +79 -0
  122. package/lib/public-api.js.map +1 -0
  123. package/lib/repository.js +65 -16
  124. package/lib/repository.js.map +1 -1
  125. package/lib/service-credentials/policy.js +14 -1
  126. package/lib/service-credentials/policy.js.map +1 -1
  127. package/lib/tool-kit.js +34 -7
  128. package/lib/tool-kit.js.map +1 -1
  129. package/lib/tools.js +49 -24
  130. package/lib/tools.js.map +1 -1
  131. package/lib/typert.host.js +455 -351
  132. package/lib/typert.remote-client.js +450 -336
  133. package/lib/types/broker.d.ts +65 -1
  134. package/lib/types/client/card.d.ts +13 -4
  135. package/lib/types/client/credential-help-note.d.ts +26 -0
  136. package/lib/types/client/index.d.ts +15 -7
  137. package/lib/types/client/integrations.d.ts +5 -4
  138. package/lib/types/client/operator-card.d.ts +56 -4
  139. package/lib/types/client/operator-controls.d.ts +31 -0
  140. package/lib/types/client/operator-sections/bitrix24.d.ts +12 -0
  141. package/lib/types/client/operator-sections/confluence.d.ts +10 -0
  142. package/lib/types/client/operator-sections/credential-help.d.ts +17 -0
  143. package/lib/types/client/operator-sections/general.d.ts +11 -0
  144. package/lib/types/client/operator-sections/gitlab.d.ts +13 -0
  145. package/lib/types/client/operator-sections/jira.d.ts +11 -0
  146. package/lib/types/client/operator-sections/provider-section.d.ts +58 -0
  147. package/lib/types/client/operator-sections/service-profiles.d.ts +13 -0
  148. package/lib/types/client/operator-sections/shared.d.ts +123 -0
  149. package/lib/types/client/operator-sections/teamcity.d.ts +11 -0
  150. package/lib/types/client/operator-sections/testit.d.ts +10 -0
  151. package/lib/types/client/operator-sections/weblate.d.ts +10 -0
  152. package/lib/types/client/operator-service-reach.d.ts +76 -0
  153. package/lib/types/client/provider-card.d.ts +14 -3
  154. package/lib/types/client/styles.d.ts +28 -4
  155. package/lib/types/config.d.ts +49 -2
  156. package/lib/types/errors.d.ts +24 -0
  157. package/lib/types/index.d.ts +54 -117
  158. package/lib/types/providers/bitrix24/tools.d.ts +2 -5
  159. package/lib/types/providers/confluence/tools.d.ts +2 -6
  160. package/lib/types/providers/confluence/transport.d.ts +0 -6
  161. package/lib/types/providers/gitlab/config.d.ts +1 -1
  162. package/lib/types/providers/gitlab/tools.d.ts +2 -6
  163. package/lib/types/providers/gitlab/transport.d.ts +3 -5
  164. package/lib/types/providers/jira/tools.d.ts +2 -6
  165. package/lib/types/providers/jira/transport.d.ts +2 -11
  166. package/lib/types/providers/kernel/address.d.ts +57 -0
  167. package/lib/types/providers/kernel/errors.d.ts +34 -0
  168. package/lib/types/providers/kernel/read-policy.d.ts +118 -0
  169. package/lib/types/providers/kernel/token.d.ts +25 -0
  170. package/lib/types/providers/shared/service-boundary.d.ts +15 -0
  171. package/lib/types/providers/teamcity/tools.d.ts +2 -6
  172. package/lib/types/providers/teamcity/transport.d.ts +1 -1
  173. package/lib/types/providers/testit/tools.d.ts +2 -6
  174. package/lib/types/providers/testit/transport.d.ts +1 -1
  175. package/lib/types/providers/weblate/tools.d.ts +2 -6
  176. package/lib/types/public-api.d.ts +80 -0
  177. package/lib/types/repository.d.ts +62 -2
  178. package/lib/types/tool-kit.d.ts +27 -1
  179. package/lib/types/tools.d.ts +26 -9
  180. package/lib/types/types.d.ts +17 -3
  181. package/package.json +25 -23
  182. package/lib/providers/shared/http.js +0 -168
  183. package/lib/providers/shared/http.js.map +0 -1
  184. package/lib/types/providers/shared/http.d.ts +0 -60
@@ -1,6 +1,5 @@
1
1
  import type { ToolDefinition } from "@deepseek-ai/dsh-tools";
2
- import type { IntegrationBroker } from "../../broker.js";
3
- import type { IntegrationPrincipal } from "../../types.js";
2
+ import { type ProviderToolFactoryOptions } from "../../tool-kit.js";
4
3
  export declare const GITLAB_TOOL_NAMES: readonly ["gitlab_connection_get", "gitlab_projects_list", "gitlab_project_get", "gitlab_repository_tree", "gitlab_repository_file_get", "gitlab_commits_list", "gitlab_commit_get", "gitlab_compare", "gitlab_search", "gitlab_issues_list", "gitlab_issue_get", "gitlab_issue_notes_list", "gitlab_merge_requests_list", "gitlab_merge_request_get", "gitlab_merge_request_changes_get", "gitlab_merge_request_discussions_list", "gitlab_merge_request_approvals_get", "gitlab_merge_request_pipelines_list", "gitlab_pipelines_list", "gitlab_pipeline_get", "gitlab_pipeline_jobs_list", "gitlab_job_get", "gitlab_job_log_get"];
5
4
  /**
6
5
  * Every tool reports what the *connected* GitLab account may read, never a
@@ -8,8 +7,5 @@ export declare const GITLAB_TOOL_NAMES: readonly ["gitlab_connection_get", "gitl
8
7
  * the QA user who owns the DSH session, and the tool schemas carry no user,
9
8
  * credential or instance selector.
10
9
  */
11
- export declare function createGitlabTools(options: {
12
- readonly broker: IntegrationBroker;
13
- readonly principalForSession: (sessionId: string) => IntegrationPrincipal | undefined;
14
- }): readonly ToolDefinition[];
10
+ export declare function createGitlabTools(options: ProviderToolFactoryOptions): readonly ToolDefinition[];
15
11
  //# sourceMappingURL=tools.d.ts.map
@@ -1,5 +1,5 @@
1
1
  import type { ResolvedQaIntegrationsConfig } from "../../config.js";
2
- import { type BoundedText } from "../shared/http.js";
2
+ import { type BoundedText } from "../kernel/read-policy.js";
3
3
  import { type GitlabFlags, type GitlabInstance } from "./config.js";
4
4
  /**
5
5
  * Encrypted credential payload of one GitLab connection: which configured
@@ -13,9 +13,8 @@ export interface GitlabCredential {
13
13
  }
14
14
  export declare function credentialFromPlaintext(plaintext: string): GitlabCredential;
15
15
  /**
16
- * The configured instance a credential belongs to. A credential minted for an
17
- * instance the operator has since removed fails closed: it never falls back to
18
- * another instance, however permissive that one is.
16
+ * The configured instance a credential belongs to: a credential minted for an
17
+ * instance the operator has since removed fails closed.
19
18
  */
20
19
  export declare function credentialInstance(flags: GitlabFlags, credential: GitlabCredential): GitlabInstance;
21
20
  export interface GitlabQuery {
@@ -47,6 +46,5 @@ export declare class GitlabTransport {
47
46
  getText(instance: GitlabInstance, token: string, path: string, query?: GitlabQuery, maxBytes?: number): Promise<GitlabTextResponse>;
48
47
  private url;
49
48
  private request;
50
- private failure;
51
49
  }
52
50
  //# sourceMappingURL=transport.d.ts.map
@@ -1,6 +1,5 @@
1
1
  import type { ToolDefinition } from "@deepseek-ai/dsh-tools";
2
- import type { IntegrationBroker } from "../../broker.js";
3
- import type { IntegrationPrincipal } from "../../types.js";
2
+ import { type ProviderToolFactoryOptions } from "../../tool-kit.js";
4
3
  export declare const JIRA_TOOL_NAMES: readonly ["jira_get_current_user", "jira_search_issues", "jira_get_issue", "jira_get_issue_comments", "jira_get_issue_attachments", "jira_get_available_transitions", "jira_get_project", "jira_get_fields"];
5
4
  /**
6
5
  * Every tool reports what the *connected* Jira account may read, never a
@@ -8,10 +7,7 @@ export declare const JIRA_TOOL_NAMES: readonly ["jira_get_current_user", "jira_s
8
7
  * integration of the QA user who owns the DSH session, and the tool schemas
9
8
  * carry no user, credential or site selector.
10
9
  */
11
- export declare function createJiraTools(options: {
12
- readonly broker: IntegrationBroker;
13
- readonly principalForSession: (sessionId: string) => IntegrationPrincipal | undefined;
14
- }): readonly ToolDefinition[];
10
+ export declare function createJiraTools(options: ProviderToolFactoryOptions): readonly ToolDefinition[];
15
11
  /** Field names a search answer carries, for documentation and tests. */
16
12
  export declare const JIRA_SEARCH_FIELDS: readonly string[];
17
13
  //# sourceMappingURL=tools.d.ts.map
@@ -23,9 +23,8 @@ export interface JiraCredential {
23
23
  }
24
24
  export declare function credentialFromPlaintext(plaintext: string): JiraCredential;
25
25
  /**
26
- * The configured site a credential belongs to. A credential minted for a site
27
- * the operator has since removed fails closed: it never falls back to another
28
- * site, however permissive that one is.
26
+ * The configured site a credential belongs to: a credential minted for a site
27
+ * the operator has since removed fails closed.
29
28
  */
30
29
  export declare function credentialSite(flags: JiraFlags, credential: JiraCredential): JiraSite;
31
30
  export type JiraQuery = Readonly<Record<string, string | number | boolean | undefined>>;
@@ -46,13 +45,5 @@ export declare class JiraTransport {
46
45
  getJson<T>(site: JiraSite, credential: JiraCredential, path: string, query?: JiraQuery): Promise<T>;
47
46
  private url;
48
47
  private request;
49
- /**
50
- * The provider error model. Jira answers a refused permission with 403 — a
51
- * permission scheme the connected user is not in, an issue security level, or
52
- * a project they cannot browse — and an unknown or invisible resource with
53
- * 404; both stay distinct so the model can tell "you may not" from "it is not
54
- * there". Neither answer ever carries the upstream body.
55
- */
56
- private failure;
57
48
  }
58
49
  //# sourceMappingURL=transport.d.ts.map
@@ -0,0 +1,57 @@
1
+ /**
2
+ * The address policy shared by every provider: the operator declares the
3
+ * endpoints a deployment may be dialled at, a stored credential only names one
4
+ * of them, and a user never types a host — the connect form picks from the
5
+ * list, so the broker cannot be pointed at an arbitrary origin (the
6
+ * specification's SSRF rule) and a credential minted for a site cannot be spent
7
+ * against another.
8
+ *
9
+ * Canonicalization is the same question for every upstream — which id forms
10
+ * are legal, whether an address may be plain HTTP, which parts pasted onto a
11
+ * URL make it not an endpoint, how `<origin><path>` is folded — so one
12
+ * implementation answers it and a provider supplies only the words its config
13
+ * error carries and, when it differs from the shared shape, the extra row
14
+ * members it resolves itself.
15
+ */
16
+ /** The id shape every provider list shares. */
17
+ export declare const ENDPOINT_ID: RegExp;
18
+ /** How many endpoints one deployment may declare. */
19
+ export declare const MAX_ENDPOINTS = 16;
20
+ /** One allowed endpoint, canonicalized: `<origin><path>`, no trailing slash. */
21
+ export interface EndpointAddress {
22
+ readonly id: string;
23
+ readonly label: string;
24
+ readonly baseUrl: string;
25
+ }
26
+ export interface EndpointListPolicy<T extends object = Record<never, never>> {
27
+ /** The failure factory of the provider's config module. */
28
+ readonly error: (message: string) => Error;
29
+ /** The config field carrying the list, as a load failure names it. */
30
+ readonly field: string;
31
+ /** The noun a development exception is explained in. */
32
+ readonly noun: string;
33
+ /**
34
+ * The phrase the HTTPS rule names what is being developed against, when a
35
+ * provider's own words differ from `a development <noun>`. An installation
36
+ * that legitimately has no certificate is often called internal rather than
37
+ * development, and the operator reading the refusal looks for the word their
38
+ * own product uses.
39
+ */
40
+ readonly insecureTarget?: string;
41
+ /** How many endpoints one deployment may declare. */
42
+ readonly max?: number;
43
+ /**
44
+ * Provider-specific members of one row, resolved after the shared ones —
45
+ * e.g. which product answers at the address.
46
+ */
47
+ readonly extra?: (record: Record<string, unknown>, index: number) => T;
48
+ }
49
+ /**
50
+ * Validate and canonicalize the operator's endpoint list. Everything here is
51
+ * operator input, so a typo must fail loudly at load: a silently dropped entry
52
+ * would leave users with a provider they cannot connect to and no explanation.
53
+ */
54
+ export declare function resolveEndpointList<T extends object = Record<never, never>>(input: unknown, allowInsecureHttp: boolean, policy: EndpointListPolicy<T>): readonly (EndpointAddress & T)[];
55
+ /** The configured endpoint an id names, or undefined. */
56
+ export declare function findEndpoint<T extends EndpointAddress>(endpoints: readonly T[], id: string): T | undefined;
57
+ //# sourceMappingURL=address.d.ts.map
@@ -0,0 +1,34 @@
1
+ import { IntegrationError, type IntegrationErrorCode } from "../../errors.js";
2
+ /**
3
+ * The error policy shared by every provider: upstream failures fold into the
4
+ * same safe domain errors — a refused permission stays distinct from a
5
+ * missing resource, neither answer ever carries the upstream body, and the
6
+ * status mapping is alike wherever two upstreams answer alike. A provider
7
+ * supplies only the word it calls itself in a message and, where it answers
8
+ * differently from the common rule, the statuses it reads differently.
9
+ */
10
+ export interface StatusErrorPolicy {
11
+ /** How the provider names itself in a folded message. */
12
+ readonly label: string;
13
+ /** The 401 wording; defaults to the stored token being rejected. */
14
+ readonly rejectedCredential?: string;
15
+ /** Statuses meaning "the call itself is wrong"; defaults to 400 and 422. */
16
+ readonly invalidRequestStatuses?: readonly number[];
17
+ /** A status the default mapping does not describe: its code and wording. */
18
+ readonly overrides?: Readonly<Record<number, readonly [IntegrationErrorCode, string]>>;
19
+ }
20
+ /** The provider's status folding, in the shape `FetchRetryPolicy` takes. */
21
+ export declare function statusErrorOf(policy: StatusErrorPolicy): (response: Response) => IntegrationError;
22
+ export interface TransportFailurePolicy {
23
+ /** How the provider names itself in a folded message. */
24
+ readonly label: string;
25
+ /** The wording of a connection failure that is neither timeout nor TLS. */
26
+ readonly unreachable?: string;
27
+ }
28
+ /**
29
+ * The provider's transport folding: this deployment's own deadline, a TLS
30
+ * handshake the user cannot fix from the connect form, and everything else
31
+ * that means the upstream is not answering.
32
+ */
33
+ export declare function transportFailureOf(policy: TransportFailurePolicy): (error: unknown, timedOut: boolean) => IntegrationError;
34
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1,118 @@
1
+ import { IntegrationError, type TransportBudget } from "../../errors.js";
2
+ export declare const RETRY_CAP_MS = 2000;
3
+ export declare const BACKOFF_BASE_MS = 250;
4
+ /** Upstream codes that mean "the TLS handshake did not succeed". */
5
+ export declare const TLS_FAILURE: RegExp;
6
+ /** Content types that must never be handed to the model as text. */
7
+ export declare const BINARY_TYPE: RegExp;
8
+ /** A body read up to a cap; the text is empty for a payload that looks binary. */
9
+ export interface BoundedText {
10
+ /** Body prefix; empty for a payload that looks binary. */
11
+ readonly text: string;
12
+ readonly bytes: number;
13
+ readonly truncated: boolean;
14
+ readonly binary: boolean;
15
+ }
16
+ export declare function numberFrom(value: string | null): number | undefined;
17
+ export declare function looksBinary(contentType: string | null, bytes: Uint8Array): boolean;
18
+ export declare function sleep(ms: number): Promise<void>;
19
+ /** The first upstream error code in a fetch failure chain, if any. */
20
+ export declare function causeCode(error: unknown): string;
21
+ export declare function backoff(response: Response, attempt: number): number;
22
+ export declare function retryDelay(attempt: number): number;
23
+ /**
24
+ * A requested ceiling folded into the deployment's own, never past it: a
25
+ * request naming no ceiling gets the default, one naming more than the cap
26
+ * gets the cap rather than an error — an operator asking for more only wants
27
+ * the maximum.
28
+ */
29
+ export declare function withinCap(requested: number | undefined, fallback: number, cap: number): number;
30
+ /**
31
+ * Read a body without letting upstream decide how much memory the broker
32
+ * spends, or for how long it spends the request's time. A body over the cap is
33
+ * reported as truncated instead of surfacing a raw `content-length` nobody can
34
+ * verify, and a body that stops arriving is refused by `signal` — the same
35
+ * deadline the headers had to meet.
36
+ */
37
+ export declare function readBoundedText(response: Response, maxBytes: number, label: string, signal: AbortSignal): Promise<BoundedText>;
38
+ /**
39
+ * Read one JSON body under the deployment cap and inside the request deadline,
40
+ * folding what a capped, stalled or unreadable body means into a domain error.
41
+ * The cap, the prefix-keeping truncation, the deadline and the binary
42
+ * classification are the shared policy; a transport only supplies the label it
43
+ * answers with, so the same limit cannot mean "narrow the request" in one
44
+ * provider and "try again later" in another, and no transport can quietly skip
45
+ * either of them.
46
+ */
47
+ export declare function readBoundedJson<T>(response: Response, maxBytes: number, label: string, signal: AbortSignal): Promise<T>;
48
+ /**
49
+ * Whether a folded transport failure earns another attempt. Re-spending a
50
+ * deadline is a latency decision, not a detail of the API behind it, so the
51
+ * kernel holds the two rules a deployment chooses between and a provider names
52
+ * its choice — an upstream that answers in five different ways here cannot say
53
+ * what one `timeoutMs` promised the operator.
54
+ */
55
+ export type TransportRetriable = (error: IntegrationError) => boolean;
56
+ /**
57
+ * The default, and the rule a provider gets when it names no other: one
58
+ * deadline is the whole budget. A call this deployment already gave up on is
59
+ * not re-sent, so one read costs `timeoutMs` rather than `retries × timeoutMs`.
60
+ */
61
+ export declare const DEADLINE_IS_THE_BUDGET: TransportRetriable;
62
+ /**
63
+ * The rule for an upstream more often busy than gone: every fault that left no
64
+ * answer earns another attempt, and the worst case of one read is `retries ×
65
+ * timeoutMs` — a longer wait, paid for by the answers it still gets. A body this
66
+ * deployment stopped reading is not among them: that request answered, and what
67
+ * the read made of it is a verdict, not a fault that may be gone on a later try.
68
+ */
69
+ export declare const RESEND_AFTER_EVERY_FAULT: TransportRetriable;
70
+ /**
71
+ * Write the budget a call was refused under onto the error that carries it out.
72
+ * The party that reports the failure knows the provider and the operation and
73
+ * nothing about the attempts; the loop that spent them knows nothing else. This
74
+ * is the one place the two meet, and it is why a log line can say both what was
75
+ * asked for and what it cost.
76
+ */
77
+ export declare function withTransportBudget(error: IntegrationError, budget: TransportBudget): IntegrationError;
78
+ /**
79
+ * How a provider folds transport outcomes into its own safe domain errors:
80
+ * each transport keeps the wording, the shared loop keeps the mechanics.
81
+ */
82
+ export interface FetchRetryPolicy {
83
+ readonly timeoutMs: number;
84
+ readonly retries: number;
85
+ readonly headers: Record<string, string>;
86
+ /** Fold a thrown fetch or a broken body read into a safe error. */
87
+ readonly transportFailure: (error: unknown, timedOut: boolean) => IntegrationError;
88
+ /**
89
+ * Whether a folded transport failure earns another attempt; {@link
90
+ * DEADLINE_IS_THE_BUDGET} unless the provider names its choice.
91
+ */
92
+ readonly retriable?: TransportRetriable;
93
+ /** Fold a non-2xx answer into the provider's safe domain error. */
94
+ readonly statusFailure: (response: Response) => IntegrationError;
95
+ }
96
+ /**
97
+ * What the transport does with an answer that arrived: read the body it came
98
+ * for, under `signal` — the deadline of the attempt that produced the response.
99
+ * The read is the transport's because only it knows which of its shapes the
100
+ * body carries; the deadline is the loop's because the loop set it.
101
+ */
102
+ export type ResponseRead<T> = (response: Response, signal: AbortSignal) => Promise<T>;
103
+ /**
104
+ * The shared transport loop: one bounded GET per attempt, transient answers
105
+ * retried with backoff, upstream failures folded into safe domain errors. The
106
+ * deadline is per attempt and covers the whole exchange — the loop hands the
107
+ * answer to `read` while its own timer is still armed, so an upstream that
108
+ * replies with the headers and then stops sending chunks is refused by the
109
+ * budget instead of leaving the call pending. A fetch that answered is never
110
+ * retried by this loop unless its status says the upstream fault may be gone on
111
+ * a later try, and what `read` refuses on its own (a body over the cap, a body
112
+ * that is not JSON) stays the domain error it named. Whatever the loop hands
113
+ * back from a transport give-up carries the budget it spent, because the party
114
+ * reporting that failure to the operator knows the call and none of the
115
+ * arithmetic behind it.
116
+ */
117
+ export declare function fetchWithRetries<T>(fetcher: typeof fetch, target: string, policy: FetchRetryPolicy, read: ResponseRead<T>): Promise<T>;
118
+ //# sourceMappingURL=read-policy.d.ts.map
@@ -0,0 +1,25 @@
1
+ /**
2
+ * The token policy shared by every provider: an encrypted payload names the
3
+ * configured endpoint the secret belongs to and carries the secret itself. The
4
+ * address is never stored — it is re-resolved from operator config on every
5
+ * call, so removing or repointing an endpoint takes effect at once instead of
6
+ * at the next connect. A credential minted for an endpoint the operator has
7
+ * since removed fails closed: it never falls back to another endpoint, however
8
+ * permissive that one is.
9
+ */
10
+ /** The refusal every provider answers for a payload it cannot read. */
11
+ export declare function invalidStoredCredential(): never;
12
+ /**
13
+ * `"text"` must be a string and may be empty (a deployment type that
14
+ * authenticates on the token alone carries no account e-mail); `"nonempty"`
15
+ * additionally refuses the empty value, which is how a secret that was never
16
+ * entered reads.
17
+ */
18
+ export type CredentialFieldRule = "text" | "nonempty";
19
+ /** Decode one credential payload field by field, refusing a half-shaped blob. */
20
+ export declare function decodeCredentialFields<S extends Readonly<Record<string, CredentialFieldRule>>>(plaintext: string, schema: S): {
21
+ readonly [K in keyof S]: string;
22
+ };
23
+ /** The configured endpoint a credential names, or a fail-closed refusal. */
24
+ export declare function requireConfiguredEndpoint<T>(found: T | undefined, message: string): T;
25
+ //# sourceMappingURL=token.d.ts.map
@@ -13,6 +13,21 @@ import type { ProviderContext } from "../contract.js";
13
13
  export declare function serviceBoundaryOf(context: ProviderContext): ServiceResourceBoundary | undefined;
14
14
  /** One refusal shape, so every service-mode denial reads the same. */
15
15
  export declare function serviceResourceDenied(): IntegrationError;
16
+ /**
17
+ * What the managed credential never answers, in the words a tool says before it
18
+ * is called. The model reads this instead of discovering it in a refusal, so it
19
+ * neither promises a user a log it cannot fetch nor goes looking for a fault in
20
+ * the stand's own integration.
21
+ */
22
+ export declare const SERVICE_CEILING_NOTICE = "Needs a personal connection: under the deployment's managed service token the service ceiling refuses this reading, and the user switches this integration to their own account to get it.";
23
+ /**
24
+ * Whether the ceiling refuses one operation *as a reading* — the case worth
25
+ * warning about, because the deployment's capability switch stays on while the
26
+ * answer stays personal. A write needs no warning: it is outside a read-only
27
+ * credential whatever it returns. An operation the provider never classified is
28
+ * refused too, and says so, because that is what the lock below will answer.
29
+ */
30
+ export declare function serviceCeilingRefusedReading(security: OperationSecurityMetadata | undefined): boolean;
16
31
  /**
17
32
  * Refuse an operation the provider's own catalog does not mark as service-safe.
18
33
  * The broker decides this first and with the administrator's narrowing on top;
@@ -1,6 +1,5 @@
1
1
  import type { ToolDefinition } from "@deepseek-ai/dsh-tools";
2
- import type { IntegrationBroker } from "../../broker.js";
3
- import type { IntegrationPrincipal } from "../../types.js";
2
+ import { type ProviderToolFactoryOptions } from "../../tool-kit.js";
4
3
  export declare const TEAMCITY_TOOL_NAMES: readonly ["teamcity_connection_get", "teamcity_projects", "teamcity_build_configs", "teamcity_builds", "teamcity_build", "teamcity_build_changes", "teamcity_build_failures", "teamcity_build_log", "teamcity_queue", "teamcity_investigations", "teamcity_agents", "teamcity_artifacts", "teamcity_artifact_text"];
5
4
  /**
6
5
  * Every tool reads what the *connected* TeamCity account may read, never a
@@ -8,8 +7,5 @@ export declare const TEAMCITY_TOOL_NAMES: readonly ["teamcity_connection_get", "
8
7
  * QA user who owns the DSH session, and no tool schema carries a user,
9
8
  * credential or server selector.
10
9
  */
11
- export declare function createTeamcityTools(options: {
12
- readonly broker: IntegrationBroker;
13
- readonly principalForSession: (sessionId: string) => IntegrationPrincipal | undefined;
14
- }): readonly ToolDefinition[];
10
+ export declare function createTeamcityTools(options: ProviderToolFactoryOptions): readonly ToolDefinition[];
15
11
  //# sourceMappingURL=tools.d.ts.map
@@ -1,5 +1,5 @@
1
1
  import type { ResolvedQaIntegrationsConfig } from "../../config.js";
2
- import { type BoundedText } from "../shared/http.js";
2
+ import { type BoundedText } from "../kernel/read-policy.js";
3
3
  import type { TeamCityFlags } from "./config.js";
4
4
  /**
5
5
  * Encrypted payload of one TeamCity connection: the personal access token the
@@ -1,6 +1,5 @@
1
1
  import type { ToolDefinition } from "@deepseek-ai/dsh-tools";
2
- import type { IntegrationBroker } from "../../broker.js";
3
- import type { IntegrationPrincipal } from "../../types.js";
2
+ import { type ProviderToolFactoryOptions } from "../../tool-kit.js";
4
3
  export declare const TESTIT_TOOL_NAMES: readonly ["testit_connection_get", "testit_projects", "testit_project_get", "testit_sections", "testit_work_items", "testit_work_item_get", "testit_work_item_history", "testit_work_item_comments", "testit_work_item_test_results", "testit_test_plans", "testit_test_plan_get", "testit_test_plan_summary", "testit_test_runs", "testit_test_run_get", "testit_test_run_results", "testit_test_result_get", "testit_test_result_attachments", "testit_attachment_metadata", "testit_attachment_text", "testit_auto_tests", "testit_auto_test_get", "testit_configurations"];
5
4
  /**
6
5
  * Every tool reads what the *connected* Test IT token may read, never a
@@ -8,8 +7,5 @@ export declare const TESTIT_TOOL_NAMES: readonly ["testit_connection_get", "test
8
7
  * the QA user who owns the DSH session, and no tool schema carries a user,
9
8
  * credential, token or installation selector.
10
9
  */
11
- export declare function createTestitTools(options: {
12
- readonly broker: IntegrationBroker;
13
- readonly principalForSession: (sessionId: string) => IntegrationPrincipal | undefined;
14
- }): readonly ToolDefinition[];
10
+ export declare function createTestitTools(options: ProviderToolFactoryOptions): readonly ToolDefinition[];
15
11
  //# sourceMappingURL=tools.d.ts.map
@@ -1,5 +1,5 @@
1
1
  import type { ResolvedQaIntegrationsConfig } from "../../config.js";
2
- import { type BoundedText } from "../shared/http.js";
2
+ import { type BoundedText } from "../kernel/read-policy.js";
3
3
  import { type TestitFlags, type TestitInstance } from "./config.js";
4
4
  /**
5
5
  * Encrypted credential payload of one Test IT connection: which configured
@@ -1,6 +1,5 @@
1
1
  import type { ToolDefinition } from "@deepseek-ai/dsh-tools";
2
- import type { IntegrationBroker } from "../../broker.js";
3
- import type { IntegrationPrincipal } from "../../types.js";
2
+ import { type ProviderToolFactoryOptions } from "../../tool-kit.js";
4
3
  export declare const WEBLATE_TOOL_NAMES: readonly ["weblate_connection_get", "weblate_projects_list", "weblate_project_get", "weblate_project_statistics_get", "weblate_components_list", "weblate_component_get", "weblate_component_statistics_get", "weblate_translations_list", "weblate_translation_get", "weblate_translation_statistics_get", "weblate_units_search", "weblate_units_find", "weblate_unit_get", "weblate_unit_comments_list", "weblate_unit_suggestions_list", "weblate_failing_units_list", "weblate_changes_list", "weblate_screenshots_list", "weblate_screenshot_get"];
5
4
  /**
6
5
  * Every tool reports what the *connected* Weblate account may read, never a
@@ -8,8 +7,5 @@ export declare const WEBLATE_TOOL_NAMES: readonly ["weblate_connection_get", "we
8
7
  * QA user who owns the DSH session, and the tool schemas carry no user,
9
8
  * credential or instance selector.
10
9
  */
11
- export declare function createWeblateTools(options: {
12
- readonly broker: IntegrationBroker;
13
- readonly principalForSession: (sessionId: string) => IntegrationPrincipal | undefined;
14
- }): readonly ToolDefinition[];
10
+ export declare function createWeblateTools(options: ProviderToolFactoryOptions): readonly ToolDefinition[];
15
11
  //# sourceMappingURL=tools.d.ts.map
@@ -0,0 +1,80 @@
1
+ /**
2
+ * The published surface of this package, in one list.
3
+ *
4
+ * The plugin's composition root and this list answer different questions — which
5
+ * providers a deployment mounts, and which names another plugin may import from
6
+ * @yadsh/dsh-qa-integrations — so they live apart: adding a provider adds its own
7
+ * row to the list and its own module, and changes nothing about how the plugin is
8
+ * composed. The entry module re-exports this file, so a consumer of the package
9
+ * cannot tell the two apart, which is the point.
10
+ */
11
+ export { IntegrationBroker } from "./broker.js";
12
+ export { ConfigSchema, resolveConfig, snapshotConfig, type LiveQaIntegrationsConfig, type QaIntegrationsConfig, type QaIntegrationsSnapshot, type ResolvedQaIntegrationsConfig, } from "./config.js";
13
+ export { MANAGED_SERVICE_CREDENTIALS_DEFAULTS, managedServiceCredentialsSchema, resolveManagedServiceCredentials, type ManagedServiceCredentialProfileConfig, type ManagedServiceCredentialProfileInput, type ManagedServiceCredentialsConfig, type ManagedServiceCredentialsInput, } from "./service-credentials/config.js";
14
+ export { evaluateServiceOperation, narrowBoundary, SERVICE_CEILING, type ServiceOperationQuery, type ServicePolicyDecision, } from "./service-credentials/policy.js";
15
+ export { ServiceCredentialRegistry } from "./service-credentials/registry.js";
16
+ export { operationCapabilityServiceState } from "./service-credentials/state.js";
17
+ export { profilePolicyRevision } from "./service-credentials/config.js";
18
+ export { CREDENTIAL_SOURCES, isCredentialSource, UNCLASSIFIED_OPERATION, type CredentialSource as ManagedCredentialSource, type DataSensitivity, type OperationEffect, type OperationSecurityMetadata, type OperationServiceDecision, type ResolvedCredentialContext, type ResolvedServiceCredential, type SafeExternalIdentity, type ServiceCredentialHealth, type ServiceCredentialProfile, type ServiceCredentialStatus, type ServiceResourceBoundary, } from "./service-credentials/types.js";
19
+ export { IntegrationError } from "./errors.js";
20
+ export { BITRIX_CAPABILITIES, BITRIX_OPERATIONS, BITRIX24_CAPABILITY_INFO, bitrix24OperationCapability, enabledCapabilities, type Bitrix24Capability, type Bitrix24CapabilityDefinition, type BitrixOperationDefinition, } from "./providers/bitrix24/catalog.js";
21
+ export { BITRIX24_DEFAULTS, bitrix24ConfigSchema, resolveBitrix24Config, type Bitrix24Flags, } from "./providers/bitrix24/config.js";
22
+ export { Bitrix24Provider, parseBitrixWebhook, } from "./providers/bitrix24/index.js";
23
+ export { BITRIX_HANDLERS, BITRIX_PROJECTIONS, } from "./providers/bitrix24/operations.js";
24
+ export { createBitrix24Tools, BITRIX24_TOOL_NAMES, } from "./providers/bitrix24/tools.js";
25
+ export { GitlabProvider, groupAllowed as gitlabGroupAllowed, projectAllowed as gitlabProjectAllowed, } from "./providers/gitlab/index.js";
26
+ export { GITLAB_CAPABILITIES, GITLAB_CAPABILITY_INFO, GITLAB_CI_SPLIT_CAPABILITIES, GITLAB_LEGACY_CI_CAPABILITY, GITLAB_OPERATIONS, GITLAB_RESOURCE_KIND, capabilitiesForScopes, gitlabOperationCapability, gitlabOperationMetadata, type GitlabCapability, type GitlabCapabilityDefinition, type GitlabOperationDefinition, } from "./providers/gitlab/catalog.js";
27
+ export { GITLAB_DEFAULTS, gitlabConfigSchema, resolveGitlabConfig, type GitlabConfigInput, type GitlabFlags, type GitlabInstance, } from "./providers/gitlab/config.js";
28
+ export { createGitlabTools, GITLAB_TOOL_NAMES, } from "./providers/gitlab/tools.js";
29
+ export { GitlabTransport, credentialFromPlaintext as gitlabCredentialFromPlaintext, credentialInstance, type GitlabCredential, } from "./providers/gitlab/transport.js";
30
+ export { GITLAB_HANDLERS, GITLAB_PROJECTIONS, } from "./providers/gitlab/operations.js";
31
+ export { ConfluenceProvider } from "./providers/confluence/index.js";
32
+ export { adfToText as confluenceAdfToText, textBudget, } from "./providers/confluence/adf.js";
33
+ export { CONFLUENCE_CAPABILITIES, CONFLUENCE_CAPABILITY_INFO, CONFLUENCE_OPERATIONS, confluenceOperationCapability, type ConfluenceCapability, type ConfluenceCapabilityDefinition, type ConfluenceOperationDefinition, } from "./providers/confluence/catalog.js";
34
+ export { CONFLUENCE_DEFAULTS, confluenceConfigSchema, resolveConfluenceConfig, spaceAllowed, type ConfluenceFlags, type ConfluenceInstance, } from "./providers/confluence/config.js";
35
+ export { buildCql, cqlLiteral, CONTENT_TYPES, ORDER_BY, type ConfluenceOrder, type ConfluenceSearchFilter, } from "./providers/confluence/cql.js";
36
+ export { COMMENT_KINDS, CONFLUENCE_HANDLERS, CONFLUENCE_PROJECTIONS, DEFAULT_LIMIT, bodyLimit, commentChildrenPath, commentCollections, commentKind, commentPath, commentReplies, isNumericSpace, modifiedAfterDate, numericId, offsetCursor, pageLimit, plainExcerpt, spaceRef, upstreamCursor, type ConfluenceCommentKind, type ConfluenceProjection, type ConfluenceProjectionContext, type ConfluenceRequest, } from "./providers/confluence/operations.js";
37
+ export { createConfluenceTools, CONFLUENCE_TOOL_NAMES, } from "./providers/confluence/tools.js";
38
+ export { ConfluenceTransport, credentialFromPlaintext as confluenceCredentialFromPlaintext, credentialInstance as confluenceCredentialInstance, type ConfluenceCredential, } from "./providers/confluence/transport.js";
39
+ export { TeamcityProvider, buildTypeAllowed as teamcityBuildTypeAllowed, projectAllowed as teamcityProjectAllowed, } from "./providers/teamcity/index.js";
40
+ export { TEAMCITY_CAPABILITIES, TEAMCITY_CAPABILITY_INFO, TEAMCITY_INSTANCE_ID, TEAMCITY_OPERATIONS, TEAMCITY_RESOURCE_KIND, TEAMCITY_STREAM_OPERATIONS, enabledCapabilities as enabledTeamcityCapabilities, teamcityOperationCapability, teamcityOperationMetadata, type TeamCityCapability, type TeamCityCapabilityDefinition, type TeamCityOperationDefinition, } from "./providers/teamcity/catalog.js";
41
+ export { TEAMCITY_DEFAULTS, DEFAULT_LOG_LINES, resolveTeamCityConfig, teamcityConfigSchema, type TeamCityConfigInput, type TeamCityFlags, } from "./providers/teamcity/config.js";
42
+ export { artifactBinaryProblem, artifactByteLimit, artifactPath, textArtifact, type ArtifactPath, } from "./providers/teamcity/artifacts.js";
43
+ export { LOG_MODES, logLines, logMode, sanitizeLog, selectLogWindow, trimToBytes, type LogMode, type LogWindow, } from "./providers/teamcity/logs.js";
44
+ export { PRIVATE_CIDRS, canonicalServerUrl, cidrProblem, hostPatternProblem, isIpLiteral, serverUrlProblem, type TeamCityNetworkMode, type TeamCityNetworkPolicy, } from "./providers/teamcity/network.js";
45
+ export { buildBuildLocator, dimension, joinDimensions, locatorValue, nested, teamCityDate, type BuildLocatorInput, } from "./providers/teamcity/locators.js";
46
+ export { TEAMCITY_HANDLERS, TEAMCITY_LIMITS, TEAMCITY_PROJECTIONS, isoDate, listLimit, type TeamCityProjection, type TeamCityRequest, } from "./providers/teamcity/operations.js";
47
+ export { TeamCityTransport, configuredServer as teamcityConfiguredServer, credentialFromPlaintext as teamcityCredentialFromPlaintext, type TeamCityCredential, } from "./providers/teamcity/transport.js";
48
+ export { createTeamcityTools, TEAMCITY_TOOL_NAMES, } from "./providers/teamcity/tools.js";
49
+ export { JiraProvider } from "./providers/jira/index.js";
50
+ export { JIRA_CAPABILITIES, JIRA_CAPABILITY_INFO, JIRA_COMPANION_PATHS, JIRA_OPERATIONS, JIRA_READ_PATHS, enabledCapabilities as enabledJiraCapabilities, jiraOperationCapability, type JiraCapability, type JiraCapabilityDefinition, type JiraOperationDefinition, } from "./providers/jira/catalog.js";
51
+ export { JIRA_DEFAULTS, SEARCH_PAGE_CAP, jiraConfigSchema, jiraSite, resolveJiraConfig, type JiraFlags, type JiraSite, } from "./providers/jira/config.js";
52
+ export { adfToText as jiraAdfToText, bodyText, isAdf, type AdfText, } from "./providers/jira/adf.js";
53
+ export { buildJql, commentLimit, commentStart, issueKey as jiraIssueKey, jqlDateValue, jqlLiteral, needsUserLookup, pageToken, projectKey as jiraProjectKey, searchLimit, textClauses, textMatch, type CustomFieldClause, } from "./providers/jira/jql.js";
54
+ export { ISSUE_INCLUDES, JIRA_HANDLERS, JIRA_PROJECTIONS, SEARCH_FIELDS as JIRA_SEARCH_FIELDS, customFieldValue, issueFields, issueUrl, requestedIncludes, wantsFieldNames, type JiraProjection, } from "./providers/jira/operations.js";
55
+ export { JiraTransport, basicAuthorization, credentialFromPlaintext as jiraCredentialFromPlaintext, credentialSite, type JiraCredential, } from "./providers/jira/transport.js";
56
+ export { createJiraTools, JIRA_TOOL_NAMES } from "./providers/jira/tools.js";
57
+ export { TestitProvider } from "./providers/testit/index.js";
58
+ export { TESTIT_CAPABILITIES, TESTIT_CAPABILITY_INFO, TESTIT_OPERATIONS, enabledCapabilities as enabledTestitCapabilities, testitOperationCapability, type TestitCapability, type TestitCapabilityDefinition, type TestitListKind, type TestitOperationDefinition, } from "./providers/testit/catalog.js";
59
+ export { TESTIT_DEFAULTS, resolveTestitConfig, testitConfigSchema, testitInstance, type TestitFlags, type TestitInstance, } from "./providers/testit/config.js";
60
+ export { assertReadableSize, attachmentBinaryProblem, attachmentByteLimit, attachmentExtension, attachmentName, } from "./providers/testit/attachments.js";
61
+ export { RESULT_OUTCOMES, TESTIT_HANDLERS, TESTIT_LIMITS, TESTIT_PROJECTIONS, TEST_RUN_STATES, WORK_ITEM_ENTITY_TYPES, WORK_ITEM_PRIORITIES, WORK_ITEM_STATES, bounded as testitBounded, capped, contentBlock as testitContentBlock, listLimit as testitListLimit, listOffset as testitListOffset, paged, type TestitProjection, type TestitProjectionContext, type TestitRequest, } from "./providers/testit/operations.js";
62
+ export { TestitTransport, credentialFromPlaintext as testitCredentialFromPlaintext, credentialInstance as testitCredentialInstance, type TestitCredential, type TestitPage, } from "./providers/testit/transport.js";
63
+ export { createTestitTools, TESTIT_TOOL_NAMES, } from "./providers/testit/tools.js";
64
+ export { WeblateProvider } from "./providers/weblate/index.js";
65
+ export { WEBLATE_CAPABILITIES, WEBLATE_CAPABILITY_INFO, WEBLATE_OPERATIONS, enabledCapabilities as weblateEnabledCapabilities, weblateOperationCapability, type WeblateCapability, type WeblateCapabilityDefinition, type WeblateOperationDefinition, } from "./providers/weblate/catalog.js";
66
+ export { WEBLATE_DEFAULTS, resolveWeblateConfig, weblateConfigSchema, weblateInstance, type WeblateFlags, type WeblateInstance, } from "./providers/weblate/config.js";
67
+ export { WEBLATE_HANDLERS, WEBLATE_PROJECTIONS, WEBLATE_UNTRUSTED_OPERATIONS, accountFromUsers, componentRef, projectRef as weblateProjectRef, sameOriginUrl, translationRef as weblateTranslationRef, unitState as weblateUnitState, type WeblateProjection, type WeblateProjectionContext, } from "./providers/weblate/operations.js";
68
+ export { FAILING_CHECK_CLAUSE, UNIT_STATE_FILTERS, UNIT_TEXT_FIELDS, buildUnitQuery, exactClause as weblateExactClause, quoteQueryValue, stateClause as weblateStateClause, textClause as weblateTextClause, type UnitStateFilter, type UnitTextField, } from "./providers/weblate/query.js";
69
+ export { WeblateTransport, credentialFromPlaintext as weblateCredentialFromPlaintext, credentialInstance as weblateCredentialInstance, resultsOf, type WeblateCredential, } from "./providers/weblate/transport.js";
70
+ export { createWeblateTools, WEBLATE_TOOL_NAMES, } from "./providers/weblate/tools.js";
71
+ export { IntegrationProviderRegistry } from "./providers/registry.js";
72
+ export { serviceBoundaryOf, serviceResourceDenied, } from "./providers/shared/service-boundary.js";
73
+ export { IntegrationRepository } from "./repository.js";
74
+ export { DockerSecretKeyProvider, MemoryKeyProvider, type KeyProvider, } from "./secrets/key-provider.js";
75
+ export { SecretStore } from "./secrets/secret-store.js";
76
+ export { createToolKit, type ToolKitOptions } from "./tool-kit.js";
77
+ export { createIntegrationTools, INTEGRATION_TOOL_NAMES, integrationToolNames, } from "./tools.js";
78
+ export type * from "./types.js";
79
+ export { BitrixTransport, credentialFromPlaintext, type BitrixCredential, } from "./providers/bitrix24/transport.js";
80
+ //# sourceMappingURL=public-api.d.ts.map
@@ -1,4 +1,33 @@
1
1
  import type { CredentialSource, EncryptedSecretRecord, IntegrationAuditEntry, IntegrationCapability, IntegrationFile, IntegrationPolicyMode, IntegrationPrincipal, IntegrationProviderId, IntegrationServiceBoundary, StoredIntegration } from "./types.js";
2
+ /**
3
+ * The identity a binding had when a probe started against it. A verdict is only
4
+ * worth storing while the row still carries all four: any reconnect bumps the
5
+ * revision and may swap the secret, a mode switch names another profile, and
6
+ * either makes the older answer about a credential that is no longer in use.
7
+ *
8
+ * The row id is part of that identity because the revision alone does not
9
+ * separate a replaced connection from a new one: `disconnect` deletes the row
10
+ * and the next `connect` mints a fresh id with the revision restarted at its
11
+ * column default. A service binding that holds no personal credential then
12
+ * matches on every other field — no secret, the same profile, revision 1 — so a
13
+ * verdict written before the disconnect would land on the healthy connection
14
+ * that took its place.
15
+ */
16
+ export interface IntegrationBindingGeneration {
17
+ readonly bindingId: string;
18
+ readonly bindingRevision: number;
19
+ readonly secretRef: string | null;
20
+ readonly serviceProfileId: string | null;
21
+ }
22
+ /**
23
+ * How a write guarded by a binding generation turned out. `stale` and `missing`
24
+ * both mean nothing was written, and both are the caller's refusal to make, but
25
+ * they are two different stories for whoever reads the log afterwards: the
26
+ * first is a probe that lost the connection to a newer generation of it, the
27
+ * second is a connection that was disconnected and never made again. Filing
28
+ * them under one key leaves the reader to work out which race happened.
29
+ */
30
+ export type IntegrationWriteFate = "applied" | "stale" | "missing";
2
31
  /**
3
32
  * Durable plugin-owned store, as tables. Every lookup starts from principal +
4
33
  * provider, which is the pair the unique index covers, so a lookup reads the
@@ -22,6 +51,18 @@ export declare class IntegrationRepository {
22
51
  /** Whether this account explicitly disconnected this provider. */
23
52
  serviceOptedOut(principal: IntegrationPrincipal, provider: IntegrationProviderId): boolean;
24
53
  secretFor(principal: IntegrationPrincipal, provider: IntegrationProviderId): EncryptedSecretRecord | undefined;
54
+ /**
55
+ * The secret one binding's reference names, for the account that asked for it.
56
+ * Like every other lookup in this store it starts from principal + provider —
57
+ * a bare reference would be a way to unlock any account's credential from
58
+ * anywhere the id is readable — and the reference then picks which generation
59
+ * of that connection is being unlocked: it is honored only while the live row
60
+ * still carries it. A probe asked for the credential of the binding it started
61
+ * from, so looked up by principal and provider alone it would spend whatever
62
+ * took that binding's place and file a verdict about a connection the
63
+ * generation guard has no reason to accept.
64
+ */
65
+ secretByRef(principal: IntegrationPrincipal, provider: IntegrationProviderId, secretRef: string | null): EncryptedSecretRecord | undefined;
25
66
  policy(integration: StoredIntegration, operation: IntegrationCapability): IntegrationPolicyMode;
26
67
  connect(options: {
27
68
  principal: IntegrationPrincipal;
@@ -40,12 +81,30 @@ export declare class IntegrationRepository {
40
81
  credentialSource?: CredentialSource;
41
82
  serviceProfileId?: string | null;
42
83
  }): StoredIntegration;
43
- updateValidation(principal: IntegrationPrincipal, provider: IntegrationProviderId, success: boolean, errorCode: string | null, capabilities?: readonly IntegrationCapability[]): void;
84
+ /**
85
+ * Record one validation verdict, optionally with the capabilities the probe
86
+ * found. `expected` is the binding the probe was started against: a verdict
87
+ * that lands after a reconnect or a mode switch describes the credential that
88
+ * used to be there, so the write is compare-and-swapped against that row — its
89
+ * id, revision, secret reference and profile, read from the same principal and
90
+ * provider the lookup always starts from — and the answer says whether it
91
+ * arrived, and if not whether the row had moved on or had gone away.
92
+ */
93
+ updateValidation(principal: IntegrationPrincipal, provider: IntegrationProviderId, success: boolean, errorCode: string | null, capabilities: readonly IntegrationCapability[] | undefined, expected: IntegrationBindingGeneration): IntegrationWriteFate;
44
94
  /**
45
95
  * Move a binding between credential sources without touching upstream. The
46
96
  * binding revision is bumped, so everything derived from the previous identity
47
97
  * — caches, cursors, prepared actions — is stale from this moment on; the
48
98
  * personal credential, if there is one, stays stored but unused.
99
+ *
100
+ * `expected` is the generation the caller read before it reached upstream for
101
+ * the switch, and the write only lands while that row is still the live one
102
+ * under the same revision and credential: a reconnect that happened inside the
103
+ * probe's await would otherwise file the replaced token's identity and grant
104
+ * onto the connection that took its place. The profile is deliberately not part
105
+ * of the comparison — naming another one is what this call is for. The answer
106
+ * is the fate of the write: whoever asked reports a switch that did not happen
107
+ * either way, and only the log tells a moved binding from a deleted one.
49
108
  */
50
109
  setCredentialSource(options: {
51
110
  principal: IntegrationPrincipal;
@@ -56,7 +115,8 @@ export declare class IntegrationRepository {
56
115
  tenantId: string;
57
116
  externalUserId: string;
58
117
  displayName: string;
59
- }): StoredIntegration | undefined;
118
+ expected: IntegrationBindingGeneration;
119
+ }): IntegrationWriteFate;
60
120
  /** Store what this binding narrows the profile's allowlist to. */
61
121
  setServiceSelection(principal: IntegrationPrincipal, provider: IntegrationProviderId, selection: IntegrationServiceBoundary | null): void;
62
122
  /** Record which profile revision the binding was last resolved against. */