@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.
- package/README.md +32 -21
- package/compatibility.json +7 -3
- package/lib/broker.js +172 -17
- package/lib/broker.js.map +1 -1
- package/lib/client/bitrix24.js +8 -6
- package/lib/client/bitrix24.js.map +1 -1
- package/lib/client/card.js +14 -13
- package/lib/client/card.js.map +1 -1
- package/lib/client/confluence.js +11 -7
- package/lib/client/confluence.js.map +1 -1
- package/lib/client/credential-help-note.js +51 -0
- package/lib/client/credential-help-note.js.map +1 -0
- package/lib/client/gitlab.js +8 -6
- package/lib/client/gitlab.js.map +1 -1
- package/lib/client/index.js +38 -32
- package/lib/client/index.js.map +1 -1
- package/lib/client/integrations.js +31 -18
- package/lib/client/integrations.js.map +1 -1
- package/lib/client/jira.js +10 -8
- package/lib/client/jira.js.map +1 -1
- package/lib/client/operator-card.js +93 -534
- package/lib/client/operator-card.js.map +1 -1
- package/lib/client/operator-controls.js +72 -23
- package/lib/client/operator-controls.js.map +1 -1
- package/lib/client/operator-sections/bitrix24.js +22 -0
- package/lib/client/operator-sections/bitrix24.js.map +1 -0
- package/lib/client/operator-sections/confluence.js +27 -0
- package/lib/client/operator-sections/confluence.js.map +1 -0
- package/lib/client/operator-sections/credential-help.js +15 -0
- package/lib/client/operator-sections/credential-help.js.map +1 -0
- package/lib/client/operator-sections/general.js +8 -0
- package/lib/client/operator-sections/general.js.map +1 -0
- package/lib/client/operator-sections/gitlab.js +41 -0
- package/lib/client/operator-sections/gitlab.js.map +1 -0
- package/lib/client/operator-sections/jira.js +25 -0
- package/lib/client/operator-sections/jira.js.map +1 -0
- package/lib/client/operator-sections/provider-section.js +21 -0
- package/lib/client/operator-sections/provider-section.js.map +1 -0
- package/lib/client/operator-sections/service-profiles.js +178 -0
- package/lib/client/operator-sections/service-profiles.js.map +1 -0
- package/lib/client/operator-sections/shared.js +192 -0
- package/lib/client/operator-sections/shared.js.map +1 -0
- package/lib/client/operator-sections/teamcity.js +42 -0
- package/lib/client/operator-sections/teamcity.js.map +1 -0
- package/lib/client/operator-sections/testit.js +35 -0
- package/lib/client/operator-sections/testit.js.map +1 -0
- package/lib/client/operator-sections/weblate.js +32 -0
- package/lib/client/operator-sections/weblate.js.map +1 -0
- package/lib/client/operator-service-reach.js +98 -0
- package/lib/client/operator-service-reach.js.map +1 -0
- package/lib/client/provider-card.js +32 -19
- package/lib/client/provider-card.js.map +1 -1
- package/lib/client/styles.js +52 -15
- package/lib/client/styles.js.map +1 -1
- package/lib/client/teamcity.js +7 -5
- package/lib/client/teamcity.js.map +1 -1
- package/lib/client/testit.js +8 -6
- package/lib/client/testit.js.map +1 -1
- package/lib/client/weblate.js +8 -6
- package/lib/client/weblate.js.map +1 -1
- package/lib/client.js +2838 -1923
- package/lib/client.js.map +1 -1
- package/lib/config.js +64 -17
- package/lib/config.js.map +1 -1
- package/lib/errors.js +5 -0
- package/lib/errors.js.map +1 -1
- package/lib/index.js +176 -222
- package/lib/index.js.map +1 -1
- package/lib/providers/bitrix24/tools.js +7 -2
- package/lib/providers/bitrix24/tools.js.map +1 -1
- package/lib/providers/bitrix24/transport.js +28 -8
- package/lib/providers/bitrix24/transport.js.map +1 -1
- package/lib/providers/confluence/config.js +14 -55
- package/lib/providers/confluence/config.js.map +1 -1
- package/lib/providers/confluence/tools.js +7 -2
- package/lib/providers/confluence/tools.js.map +1 -1
- package/lib/providers/confluence/transport.js +42 -78
- package/lib/providers/confluence/transport.js.map +1 -1
- package/lib/providers/gitlab/config.js +11 -55
- package/lib/providers/gitlab/config.js.map +1 -1
- package/lib/providers/gitlab/operations.js +3 -3
- package/lib/providers/gitlab/operations.js.map +1 -1
- package/lib/providers/gitlab/tools.js +7 -2
- package/lib/providers/gitlab/tools.js.map +1 -1
- package/lib/providers/gitlab/transport.js +33 -65
- package/lib/providers/gitlab/transport.js.map +1 -1
- package/lib/providers/jira/config.js +18 -58
- package/lib/providers/jira/config.js.map +1 -1
- package/lib/providers/jira/jql.js +105 -1
- package/lib/providers/jira/jql.js.map +1 -1
- package/lib/providers/jira/tools.js +68 -2
- package/lib/providers/jira/tools.js.map +1 -1
- package/lib/providers/jira/transport.js +44 -110
- package/lib/providers/jira/transport.js.map +1 -1
- package/lib/providers/kernel/address.js +90 -0
- package/lib/providers/kernel/address.js.map +1 -0
- package/lib/providers/kernel/errors.js +42 -0
- package/lib/providers/kernel/errors.js.map +1 -0
- package/lib/providers/kernel/read-policy.js +276 -0
- package/lib/providers/kernel/read-policy.js.map +1 -0
- package/lib/providers/kernel/token.js +45 -0
- package/lib/providers/kernel/token.js.map +1 -0
- package/lib/providers/shared/service-boundary.js +31 -3
- package/lib/providers/shared/service-boundary.js.map +1 -1
- package/lib/providers/teamcity/tools.js +8 -3
- package/lib/providers/teamcity/tools.js.map +1 -1
- package/lib/providers/teamcity/transport.js +6 -8
- package/lib/providers/teamcity/transport.js.map +1 -1
- package/lib/providers/testit/config.js +12 -57
- package/lib/providers/testit/config.js.map +1 -1
- package/lib/providers/testit/tools.js +7 -2
- package/lib/providers/testit/tools.js.map +1 -1
- package/lib/providers/testit/transport.js +12 -12
- package/lib/providers/testit/transport.js.map +1 -1
- package/lib/providers/weblate/config.js +12 -55
- package/lib/providers/weblate/config.js.map +1 -1
- package/lib/providers/weblate/tools.js +7 -2
- package/lib/providers/weblate/tools.js.map +1 -1
- package/lib/providers/weblate/transport.js +21 -20
- package/lib/providers/weblate/transport.js.map +1 -1
- package/lib/public-api.js +79 -0
- package/lib/public-api.js.map +1 -0
- package/lib/repository.js +65 -16
- package/lib/repository.js.map +1 -1
- package/lib/service-credentials/policy.js +14 -1
- package/lib/service-credentials/policy.js.map +1 -1
- package/lib/tool-kit.js +34 -7
- package/lib/tool-kit.js.map +1 -1
- package/lib/tools.js +49 -24
- package/lib/tools.js.map +1 -1
- package/lib/typert.host.js +455 -351
- package/lib/typert.remote-client.js +450 -336
- package/lib/types/broker.d.ts +65 -1
- package/lib/types/client/card.d.ts +13 -4
- package/lib/types/client/credential-help-note.d.ts +26 -0
- package/lib/types/client/index.d.ts +15 -7
- package/lib/types/client/integrations.d.ts +5 -4
- package/lib/types/client/operator-card.d.ts +56 -4
- package/lib/types/client/operator-controls.d.ts +31 -0
- package/lib/types/client/operator-sections/bitrix24.d.ts +12 -0
- package/lib/types/client/operator-sections/confluence.d.ts +10 -0
- package/lib/types/client/operator-sections/credential-help.d.ts +17 -0
- package/lib/types/client/operator-sections/general.d.ts +11 -0
- package/lib/types/client/operator-sections/gitlab.d.ts +13 -0
- package/lib/types/client/operator-sections/jira.d.ts +11 -0
- package/lib/types/client/operator-sections/provider-section.d.ts +58 -0
- package/lib/types/client/operator-sections/service-profiles.d.ts +13 -0
- package/lib/types/client/operator-sections/shared.d.ts +123 -0
- package/lib/types/client/operator-sections/teamcity.d.ts +11 -0
- package/lib/types/client/operator-sections/testit.d.ts +10 -0
- package/lib/types/client/operator-sections/weblate.d.ts +10 -0
- package/lib/types/client/operator-service-reach.d.ts +76 -0
- package/lib/types/client/provider-card.d.ts +14 -3
- package/lib/types/client/styles.d.ts +28 -4
- package/lib/types/config.d.ts +49 -2
- package/lib/types/errors.d.ts +24 -0
- package/lib/types/index.d.ts +54 -117
- package/lib/types/providers/bitrix24/tools.d.ts +2 -5
- package/lib/types/providers/confluence/tools.d.ts +2 -6
- package/lib/types/providers/confluence/transport.d.ts +0 -6
- package/lib/types/providers/gitlab/config.d.ts +1 -1
- package/lib/types/providers/gitlab/tools.d.ts +2 -6
- package/lib/types/providers/gitlab/transport.d.ts +3 -5
- package/lib/types/providers/jira/tools.d.ts +2 -6
- package/lib/types/providers/jira/transport.d.ts +2 -11
- package/lib/types/providers/kernel/address.d.ts +57 -0
- package/lib/types/providers/kernel/errors.d.ts +34 -0
- package/lib/types/providers/kernel/read-policy.d.ts +118 -0
- package/lib/types/providers/kernel/token.d.ts +25 -0
- package/lib/types/providers/shared/service-boundary.d.ts +15 -0
- package/lib/types/providers/teamcity/tools.d.ts +2 -6
- package/lib/types/providers/teamcity/transport.d.ts +1 -1
- package/lib/types/providers/testit/tools.d.ts +2 -6
- package/lib/types/providers/testit/transport.d.ts +1 -1
- package/lib/types/providers/weblate/tools.d.ts +2 -6
- package/lib/types/public-api.d.ts +80 -0
- package/lib/types/repository.d.ts +62 -2
- package/lib/types/tool-kit.d.ts +27 -1
- package/lib/types/tools.d.ts +26 -9
- package/lib/types/types.d.ts +17 -3
- package/package.json +25 -23
- package/lib/providers/shared/http.js +0 -168
- package/lib/providers/shared/http.js.map +0 -1
- 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
|
|
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 "../
|
|
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
|
|
17
|
-
* instance the operator has since removed fails closed
|
|
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
|
|
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
|
|
27
|
-
* the operator has since removed fails closed
|
|
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
|
|
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 "../
|
|
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
|
|
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 "../
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
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. */
|