@yadsh/dsh-qa-integrations 0.10.0 → 0.10.2

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/lib/errors.js CHANGED
@@ -1,6 +1,11 @@
1
1
  /** Safe domain error: message and code never include upstream bodies or secrets. */
2
2
  export class IntegrationError extends Error {
3
3
  code;
4
+ /**
5
+ * Set by a transport on the failure it refused a call with; absent on every
6
+ * error that never reached one.
7
+ */
8
+ budget;
4
9
  constructor(code, message, options) {
5
10
  super(message, options);
6
11
  this.code = code;
package/lib/errors.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AA8CA,oFAAoF;AACpF,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAE9B,IAAI;IADf,YACW,IAA0B,EACnC,OAAe,EACf,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBAJf,IAAI;QAKb,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,MAAM,IAAI,GACR,KAAK,YAAY,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,qBAAqB,CAAC;IACzE,OAAO,IAAI,KAAK,CAAC,uCAAuC,IAAI,GAAG,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,CACL,KAAK,YAAY,gBAAgB;QACjC,CAAC,KAAK,CAAC,IAAI,KAAK,kBAAkB;YAChC,KAAK,CAAC,IAAI,KAAK,0BAA0B,CAAC,CAC7C,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,GAAG,KAAK,KAAK,OAAO,EAAE,CAAC,CAAC;AACxD,CAAC"}
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAkEA,oFAAoF;AACpF,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAQ9B,IAAI;IAPf;;;OAGG;IACH,MAAM,CAAmB;IAEzB,YACW,IAA0B,EACnC,OAAe,EACf,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBAJf,IAAI;QAKb,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,MAAM,IAAI,GACR,KAAK,YAAY,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,qBAAqB,CAAC;IACzE,OAAO,IAAI,KAAK,CAAC,uCAAuC,IAAI,GAAG,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,CACL,KAAK,YAAY,gBAAgB;QACjC,CAAC,KAAK,CAAC,IAAI,KAAK,kBAAkB;YAChC,KAAK,CAAC,IAAI,KAAK,0BAA0B,CAAC,CAC7C,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,GAAG,KAAK,KAAK,OAAO,EAAE,CAAC,CAAC;AACxD,CAAC"}
@@ -1,6 +1,6 @@
1
1
  import { IntegrationError } from "../../errors.js";
2
2
  import { hostMatchesSuffix } from "../shared/host.js";
3
- import { readBoundedJson } from "../kernel/read-policy.js";
3
+ import { readBoundedJson, withTransportBudget } from "../kernel/read-policy.js";
4
4
  export function credentialFromPlaintext(plaintext) {
5
5
  let parsed;
6
6
  try {
@@ -114,12 +114,22 @@ export class BitrixTransport {
114
114
  };
115
115
  }
116
116
  catch (error) {
117
+ // One attempt is this provider's whole budget, so the loop's arithmetic is
118
+ // named here rather than left out of it: a refusal the operator reads has
119
+ // to say what it cost whether the shared loop made the attempt or this one
120
+ // did.
121
+ const spent = {
122
+ timeoutMs: this.config.timeoutMs,
123
+ retries: 0,
124
+ attempts: 1,
125
+ };
117
126
  // A refusal the read already named — a denied operation, a body over the
118
127
  // cap, a body that stopped arriving — stays what it was named as.
119
- if (error instanceof IntegrationError)
120
- throw error;
128
+ if (error instanceof IntegrationError) {
129
+ throw withTransportBudget(error, spent);
130
+ }
121
131
  throw timedOut
122
- ? new IntegrationError("UpstreamTimeout", "Provider did not answer")
132
+ ? withTransportBudget(new IntegrationError("UpstreamTimeout", "Provider did not answer"), spent)
123
133
  : new IntegrationError("ProviderUnavailable", "Provider request failed");
124
134
  }
125
135
  finally {
@@ -1 +1 @@
1
- {"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../src/providers/bitrix24/transport.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../src/providers/bitrix24/transport.ts"],"names":[],"mappings":"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"}
@@ -181,6 +181,17 @@ export const DEADLINE_IS_THE_BUDGET = (error) => error.code !== "UpstreamTimeout
181
181
  * the read made of it is a verdict, not a fault that may be gone on a later try.
182
182
  */
183
183
  export const RESEND_AFTER_EVERY_FAULT = () => true;
184
+ /**
185
+ * Write the budget a call was refused under onto the error that carries it out.
186
+ * The party that reports the failure knows the provider and the operation and
187
+ * nothing about the attempts; the loop that spent them knows nothing else. This
188
+ * is the one place the two meet, and it is why a log line can say both what was
189
+ * asked for and what it cost.
190
+ */
191
+ export function withTransportBudget(error, budget) {
192
+ error.budget = budget;
193
+ return error;
194
+ }
184
195
  /**
185
196
  * The shared transport loop: one bounded GET per attempt, transient answers
186
197
  * retried with backoff, upstream failures folded into safe domain errors. The
@@ -190,11 +201,21 @@ export const RESEND_AFTER_EVERY_FAULT = () => true;
190
201
  * budget instead of leaving the call pending. A fetch that answered is never
191
202
  * retried by this loop unless its status says the upstream fault may be gone on
192
203
  * a later try, and what `read` refuses on its own (a body over the cap, a body
193
- * that is not JSON) stays the domain error it named.
204
+ * that is not JSON) stays the domain error it named. Whatever the loop hands
205
+ * back from a transport give-up carries the budget it spent, because the party
206
+ * reporting that failure to the operator knows the call and none of the
207
+ * arithmetic behind it.
194
208
  */
195
209
  export async function fetchWithRetries(fetcher, target, policy, read) {
196
210
  const retriable = policy.retriable ?? DEADLINE_IS_THE_BUDGET;
197
211
  for (let attempt = 0;; attempt += 1) {
212
+ // What this attempt has spent so far, in the shape a report reads: the
213
+ // deadline re-paid by every retry, and the attempts the call actually cost.
214
+ const spent = () => ({
215
+ timeoutMs: policy.timeoutMs,
216
+ retries: policy.retries,
217
+ attempts: attempt + 1,
218
+ });
198
219
  let timedOut = false;
199
220
  const controller = new AbortController();
200
221
  const timer = setTimeout(() => {
@@ -216,7 +237,7 @@ export async function fetchWithRetries(fetcher, target, policy, read) {
216
237
  catch (error) {
217
238
  const failure = policy.transportFailure(error, timedOut);
218
239
  if (attempt >= policy.retries || !retriable(failure)) {
219
- throw failure;
240
+ throw withTransportBudget(failure, spent());
220
241
  }
221
242
  await sleep(retryDelay(attempt));
222
243
  continue;
@@ -235,9 +256,14 @@ export async function fetchWithRetries(fetcher, target, policy, read) {
235
256
  return await read(response, controller.signal);
236
257
  }
237
258
  catch (error) {
238
- if (error instanceof IntegrationError)
239
- throw error;
240
- throw policy.transportFailure(error, timedOut);
259
+ // A read this deployment's own deadline ended leaves as the refusal the
260
+ // reader named — and carries the budget that named it, whatever that
261
+ // refusal was: the attempts and the deadline are true of the call either
262
+ // way, and only the reader knows which of them ended it.
263
+ if (error instanceof IntegrationError) {
264
+ throw withTransportBudget(error, spent());
265
+ }
266
+ throw withTransportBudget(policy.transportFailure(error, timedOut), spent());
241
267
  }
242
268
  }
243
269
  finally {
@@ -1 +1 @@
1
- {"version":3,"file":"read-policy.js","sourceRoot":"","sources":["../../../src/providers/kernel/read-policy.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"read-policy.js","sourceRoot":"","sources":["../../../src/providers/kernel/read-policy.ts"],"names":[],"mappings":"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"}
package/lib/tool-kit.js CHANGED
@@ -17,6 +17,21 @@ const OUTPUT = {
17
17
  },
18
18
  render: (_args, value) => [{ type: "text", text: JSON.stringify(value.data) }],
19
19
  };
20
+ /**
21
+ * The budget the harness arms on every integration tool. It promises nothing
22
+ * about our own reads — it is the outer bound that ends a chat turn a read which
23
+ * outlived them all would have held open — so it has to sit above the transport's
24
+ * own worst case and below the round the chat owns. The arithmetic, at the
25
+ * shipped defaults: one read costs `(retries + 1) × timeoutMs + retries ×
26
+ * RETRY_CAP_MS`, and the widest `timeoutMs` a read is held to is the streaming
27
+ * one a log or an attachment takes (30 000 against the general 15 000), so a
28
+ * fully retried read is 3 × 30 000 + 2 × 2 000 = 94 000 ms; a call chains up to
29
+ * three such reads (a boundary probe, the reading, one included collection) for
30
+ * 282 000 ms; 300 000 clears that and leaves the 600 000 ms `/ask` round to
31
+ * `@yadsh/dsh-qa-surface`, which owns it. `tests/tools/tool-timeout.test.ts`
32
+ * recomputes both bounds from the resolvers rather than from this number.
33
+ */
34
+ const TOOL_TIMEOUT_MS = 300_000;
20
35
  /**
21
36
  * Shared plumbing for provider tool modules. It owns the one security-relevant
22
37
  * step every tool repeats: resolve the QA principal from the DSH session, never
@@ -55,6 +70,10 @@ export function createToolKit(options) {
55
70
  : definition.description,
56
71
  parameters: definition.parameters,
57
72
  output: OUTPUT,
73
+ // Without this the harness arms no deadline at all: a tool that declares
74
+ // no budget is delegated unchanged, and a chat turn waits on the upstream
75
+ // for as long as the upstream likes.
76
+ timeoutMs: TOOL_TIMEOUT_MS,
58
77
  execute: (args, exec) => run(exec, definition.operation, definition.input(args)),
59
78
  });
60
79
  };
@@ -1 +1 @@
1
- {"version":3,"file":"tool-kit.js","sourceRoot":"","sources":["../src/tool-kit.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,GAIX,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EACL,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,wCAAwC,CAAC;AAMhD,MAAM,MAAM,GAAG;IACb,MAAM,EAAE;QACN,IAAI,EAAE,QAAiB;QACvB,oBAAoB,EAAE,KAAK;QAC3B,UAAU,EAAE;YACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,QAAQ,EAAE,IAAI,EAAE;YACrD,SAAS,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,QAAQ,EAAE,IAAI,EAAE;YACtD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAiB;gBACvB,QAAQ,EAAE,IAAI;gBACd,oBAAoB,EAAE,IAAI;aAC3B;SACF;KACF;IACD,MAAM,EAAE,CACN,KAAc,EACd,KAA4D,EAC5D,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;CAC1D,CAAC;AAoCX;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,OAAuB;IACnD,MAAM,GAAG,GAAG,KAAK,EACf,IAAmB,EACnB,SAAiB,EACjB,KAAwC,EACxC,EAAE;QACF,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;QAC3C,IAAI,EAAE,KAAK,SAAS,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACjD,MAAM,IAAI,gBAAgB,CACxB,sBAAsB,EACtB,0BAA0B,CAC3B,CAAC;QACJ,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7B,MAAM,SAAS,GAAG,OAAO,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;QACzD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,gBAAgB,CACxB,sBAAsB,EACtB,mCAAmC,CACpC,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE;YACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,SAAS;YACT,KAAK;YACL,eAAe,EAAE,SAAS;SAC3B,CAAC,CAAC;IACL,CAAC,CAAC;IAEF;;;OAGG;IACH,MAAM,IAAI,GAAG,CAAsC,UAMlD,EAAkB,EAAE;QACnB,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC;QACpE,MAAM,KAAK,GACT,OAAO,CAAC,gCAAgC;YACxC,4BAA4B,CAAC,QAAQ,CAAC,CAAC;QACzC,OAAO,UAAU,CAAC;YAChB,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,WAAW,EAAE,KAAK;gBAChB,CAAC,CAAC,GAAG,UAAU,CAAC,WAAW,IAAI,sBAAsB,EAAE;gBACvD,CAAC,CAAC,UAAU,CAAC,WAAW;YAC1B,UAAU,EAAE,UAAU,CAAC,UAAU;YACjC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CACtB,GAAG,CACD,IAAI,EACJ,UAAU,CAAC,SAAS,EACpB,UAAU,CAAC,KAAK,CAAC,IAA+B,CAAC,CAClD;SACJ,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AACvB,CAAC"}
1
+ {"version":3,"file":"tool-kit.js","sourceRoot":"","sources":["../src/tool-kit.ts"],"names":[],"mappings":"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"}
@@ -117,6 +117,21 @@ export declare class IntegrationBroker {
117
117
  readonly input: Readonly<Record<string, unknown>>;
118
118
  readonly sourceSessionId: string;
119
119
  }): Promise<IntegrationToolResult>;
120
+ /**
121
+ * Record a call this deployment's own deadline ended.
122
+ *
123
+ * Without it the failure is invisible where an operator looks for it: the
124
+ * audit row says `error`, the trail of the reason code is the chat, and the
125
+ * log — the one surface that outlives both — carried nothing about a provider
126
+ * that stopped answering. The provider and the operation are this call's; the
127
+ * deadline and the attempts come written on the error by the transport loop
128
+ * that spent them, which is the only party that ever knew them.
129
+ *
130
+ * Nothing upstream is named here: no address, no query, no body, no
131
+ * credential. Numbers, a provider id and an operation are enough to find the
132
+ * call again in the trail.
133
+ */
134
+ private logTransportTimeout;
120
135
  /**
121
136
  * Spend one unit of the service-mode ceiling before the call leaves for
122
137
  * upstream. Both sides of the limit are consulted together: one principal may
@@ -29,6 +29,18 @@ export interface ValueProps<T> {
29
29
  }
30
30
  /** The control's DOM id, derived from its settings path: one per field. */
31
31
  export declare function fieldId(path: readonly string[]): string;
32
+ /**
33
+ * One settings key spelled the way a test id has to be spelled: camelCase humps
34
+ * come apart (`allowedHosts` is `allowed-hosts`, and an acronym run belongs to
35
+ * the word after it, so `maxHTTPRetries` is `max-http-retries`) and every other
36
+ * run of non-alphanumerics collapses to one dash (`issues.read` is
37
+ * `issues-read`). Whatever the key looks like, the answer is ASCII kebab-case:
38
+ * an id carrying a dot or a stray capital is a selector the harness cannot quote.
39
+ *
40
+ * The provider card names its capability and boundary rows with this same rule,
41
+ * so one spelling of a vocabulary key cannot yield two different selectors.
42
+ */
43
+ export declare function kebabSegment(segment: string): string;
32
44
  /**
33
45
  * The test id of the control that writes `path`: the settings key is what the
34
46
  * Host stores the value under and what the card mutates by, so a reworded
@@ -25,9 +25,33 @@ export type IntegrationErrorCode = "IntegrationNotConnected" | "CredentialExpire
25
25
  * `publicIntegrationError` is what turns them into a client-visible reason.
26
26
  */
27
27
  | "ServiceCredentialUnavailable" | "ServiceCredentialDisabled" | "ServiceCredentialInvalid" | "ServiceCredentialUnsafeScope" | "ServiceResourceNotAllowed" | "OperationNotAllowedWithServiceCredential" | "SensitiveReadRequiresPersonalCredential" | "PersonalCredentialRequired";
28
+ /**
29
+ * What a transport spent on the failure it handed back: the deadline one attempt
30
+ * was held to, how many further attempts the deployment allows, and how many
31
+ * attempts the call actually cost.
32
+ *
33
+ * The loop that made the attempts is the only party that knows these three, and
34
+ * the party that reports the failure to the operator — the broker, which knows
35
+ * the provider and the operation — has no view of them. So the loop writes them
36
+ * on the error it gives up with and the report reads them off. Numbers only: a
37
+ * budget names no address, no query, no body and no credential.
38
+ */
39
+ export interface TransportBudget {
40
+ /** The per-attempt deadline, in milliseconds. */
41
+ readonly timeoutMs: number;
42
+ /** Attempts the deployment allows after the first one. */
43
+ readonly retries: number;
44
+ /** Attempts spent, the first included. */
45
+ readonly attempts: number;
46
+ }
28
47
  /** Safe domain error: message and code never include upstream bodies or secrets. */
29
48
  export declare class IntegrationError extends Error {
30
49
  readonly code: IntegrationErrorCode;
50
+ /**
51
+ * Set by a transport on the failure it refused a call with; absent on every
52
+ * error that never reached one.
53
+ */
54
+ budget?: TransportBudget;
31
55
  constructor(code: IntegrationErrorCode, message: string, options?: ErrorOptions);
32
56
  }
33
57
  export declare function publicIntegrationError(error: unknown): Error;
@@ -1,4 +1,4 @@
1
- import { IntegrationError } from "../../errors.js";
1
+ import { IntegrationError, type TransportBudget } from "../../errors.js";
2
2
  export declare const RETRY_CAP_MS = 2000;
3
3
  export declare const BACKOFF_BASE_MS = 250;
4
4
  /** Upstream codes that mean "the TLS handshake did not succeed". */
@@ -67,6 +67,14 @@ export declare const DEADLINE_IS_THE_BUDGET: TransportRetriable;
67
67
  * the read made of it is a verdict, not a fault that may be gone on a later try.
68
68
  */
69
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;
70
78
  /**
71
79
  * How a provider folds transport outcomes into its own safe domain errors:
72
80
  * each transport keeps the wording, the shared loop keeps the mechanics.
@@ -101,7 +109,10 @@ export type ResponseRead<T> = (response: Response, signal: AbortSignal) => Promi
101
109
  * budget instead of leaving the call pending. A fetch that answered is never
102
110
  * retried by this loop unless its status says the upstream fault may be gone on
103
111
  * a later try, and what `read` refuses on its own (a body over the cap, a body
104
- * that is not JSON) stays the domain error it named.
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.
105
116
  */
106
117
  export declare function fetchWithRetries<T>(fetcher: typeof fetch, target: string, policy: FetchRetryPolicy, read: ResponseRead<T>): Promise<T>;
107
118
  //# sourceMappingURL=read-policy.d.ts.map
package/locale/en.json ADDED
@@ -0,0 +1,6 @@
1
+ {
2
+ "meta": {
3
+ "title": "QA Integrations",
4
+ "description": "Principal-scoped, encrypted user integrations for DSH QA Surface"
5
+ }
6
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@yadsh/dsh-qa-integrations",
3
- "version": "0.10.0",
3
+ "version": "0.10.2",
4
4
  "description": "Principal-scoped, encrypted user integrations for DSH QA Surface",
5
5
  "repository": {
6
6
  "type": "git",
@@ -36,12 +36,14 @@
36
36
  "types": "./lib/types/types.d.ts",
37
37
  "default": "./lib/types.js"
38
38
  },
39
+ "./locale/en.json": "./locale/en.json",
39
40
  "./package.json": "./package.json"
40
41
  },
41
42
  "files": [
42
43
  "lib/**/*.js",
43
44
  "lib/**/*.js.map",
44
45
  "lib/**/*.d.ts",
46
+ "locale/*.json",
45
47
  "cordis.patch.yml",
46
48
  "compatibility.json",
47
49
  "README.md",
@@ -87,9 +89,9 @@
87
89
  },
88
90
  "dependencies": {
89
91
  "zod": "^4.4.3",
90
- "@yadsh/dsh-plugin-log": "^0.4.1",
91
92
  "@yadsh/dsh-plugin-kit": "^0.5.0",
92
- "@yadsh/dsh-qa-surface": "^0.14.0"
93
+ "@yadsh/dsh-qa-surface": "^0.15.2",
94
+ "@yadsh/dsh-plugin-log": "^0.4.1"
93
95
  },
94
96
  "peerDependencies": {
95
97
  "@deepseek-ai/cordis": "^4.0.4",