@tyvm/knowhow 0.0.156 → 0.0.157

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 (69) hide show
  1. package/package.json +1 -1
  2. package/src/agents/base/base.ts +15 -5
  3. package/src/chat/modules/AgentModule.ts +3 -3
  4. package/src/chat/modules/RemoteSyncModule.ts +45 -17
  5. package/src/clients/anthropic.ts +156 -79
  6. package/src/clients/attribution.ts +53 -0
  7. package/src/clients/http.ts +211 -84
  8. package/src/clients/index.ts +21 -9
  9. package/src/clients/openai.ts +441 -220
  10. package/src/clients/openrouter.ts +10 -3
  11. package/src/clients/pricing/openai.ts +15 -1
  12. package/src/clients/pricing/types.ts +15 -0
  13. package/src/clients/responseMetadata.ts +221 -0
  14. package/src/clients/types.ts +49 -4
  15. package/tests/unit/clients/anthropic.responseMetadata.test.ts +81 -0
  16. package/tests/unit/clients/attribution.test.ts +185 -0
  17. package/tests/unit/clients/http.responseMetadata.test.ts +86 -0
  18. package/tests/unit/clients/openai.responseMetadata.test.ts +90 -0
  19. package/tests/unit/clients/responseMetadata.test.ts +123 -0
  20. package/ts_build/package.json +1 -1
  21. package/ts_build/src/agents/base/base.js +14 -4
  22. package/ts_build/src/agents/base/base.js.map +1 -1
  23. package/ts_build/src/chat/modules/AgentModule.js +3 -3
  24. package/ts_build/src/chat/modules/AgentModule.js.map +1 -1
  25. package/ts_build/src/chat/modules/RemoteSyncModule.d.ts +1 -0
  26. package/ts_build/src/chat/modules/RemoteSyncModule.js +19 -7
  27. package/ts_build/src/chat/modules/RemoteSyncModule.js.map +1 -1
  28. package/ts_build/src/clients/anthropic.d.ts +1 -0
  29. package/ts_build/src/clients/anthropic.js +83 -38
  30. package/ts_build/src/clients/anthropic.js.map +1 -1
  31. package/ts_build/src/clients/attribution.d.ts +2 -0
  32. package/ts_build/src/clients/attribution.js +32 -0
  33. package/ts_build/src/clients/attribution.js.map +1 -0
  34. package/ts_build/src/clients/http.js +100 -20
  35. package/ts_build/src/clients/http.js.map +1 -1
  36. package/ts_build/src/clients/index.d.ts +2 -1
  37. package/ts_build/src/clients/index.js +6 -2
  38. package/ts_build/src/clients/index.js.map +1 -1
  39. package/ts_build/src/clients/openai.d.ts +2 -1
  40. package/ts_build/src/clients/openai.js +225 -99
  41. package/ts_build/src/clients/openai.js.map +1 -1
  42. package/ts_build/src/clients/openrouter.d.ts +2 -2
  43. package/ts_build/src/clients/openrouter.js +6 -2
  44. package/ts_build/src/clients/openrouter.js.map +1 -1
  45. package/ts_build/src/clients/pricing/openai.js +15 -1
  46. package/ts_build/src/clients/pricing/openai.js.map +1 -1
  47. package/ts_build/src/clients/pricing/types.d.ts +6 -0
  48. package/ts_build/src/clients/pricing/types.js.map +1 -1
  49. package/ts_build/src/clients/responseMetadata.d.ts +15 -0
  50. package/ts_build/src/clients/responseMetadata.js +141 -0
  51. package/ts_build/src/clients/responseMetadata.js.map +1 -0
  52. package/ts_build/src/clients/types.d.ts +18 -1
  53. package/ts_build/src/clients/types.js +2 -1
  54. package/ts_build/src/clients/types.js.map +1 -1
  55. package/ts_build/tests/unit/clients/anthropic.responseMetadata.test.d.ts +1 -0
  56. package/ts_build/tests/unit/clients/anthropic.responseMetadata.test.js +77 -0
  57. package/ts_build/tests/unit/clients/anthropic.responseMetadata.test.js.map +1 -0
  58. package/ts_build/tests/unit/clients/attribution.test.d.ts +1 -0
  59. package/ts_build/tests/unit/clients/attribution.test.js +153 -0
  60. package/ts_build/tests/unit/clients/attribution.test.js.map +1 -0
  61. package/ts_build/tests/unit/clients/http.responseMetadata.test.d.ts +1 -0
  62. package/ts_build/tests/unit/clients/http.responseMetadata.test.js +77 -0
  63. package/ts_build/tests/unit/clients/http.responseMetadata.test.js.map +1 -0
  64. package/ts_build/tests/unit/clients/openai.responseMetadata.test.d.ts +1 -0
  65. package/ts_build/tests/unit/clients/openai.responseMetadata.test.js +86 -0
  66. package/ts_build/tests/unit/clients/openai.responseMetadata.test.js.map +1 -0
  67. package/ts_build/tests/unit/clients/responseMetadata.test.d.ts +1 -0
  68. package/ts_build/tests/unit/clients/responseMetadata.test.js +96 -0
  69. package/ts_build/tests/unit/clients/responseMetadata.test.js.map +1 -0
@@ -0,0 +1,77 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const post = jest.fn();
4
+ jest.mock("../../../src/utils/http", () => ({
5
+ __esModule: true,
6
+ default: { post },
7
+ HTTP_UNAUTHORIZED_HANDLER: Symbol("refresh"),
8
+ HttpError: class HttpError extends Error {
9
+ status;
10
+ response;
11
+ constructor(status, response, message) {
12
+ super(message);
13
+ this.status = status;
14
+ this.response = response;
15
+ }
16
+ },
17
+ }));
18
+ const http_1 = require("../../../src/clients/http");
19
+ describe("HttpClient response metadata", () => {
20
+ beforeEach(() => post.mockReset());
21
+ it("emits chat metadata and excludes transport-only options from its body", async () => {
22
+ post.mockResolvedValue({
23
+ status: 200,
24
+ headers: new Headers({
25
+ "x-request-id": "http-request",
26
+ "x-ratelimit-limit-requests": "20",
27
+ "x-ratelimit-remaining-requests": "19",
28
+ }),
29
+ data: {
30
+ choices: [{ message: { role: "assistant", content: "hi" } }],
31
+ model: "test",
32
+ },
33
+ });
34
+ const observer = jest.fn();
35
+ const client = new http_1.HttpClient("https://provider.example");
36
+ const controller = new AbortController();
37
+ await client.createChatCompletion({
38
+ model: "test",
39
+ messages: [{ role: "user", content: "hello" }],
40
+ signal: controller.signal,
41
+ timeout: 1,
42
+ maxRetries: 0,
43
+ backoffMs: 1,
44
+ onResponseMetadata: observer,
45
+ });
46
+ expect(post.mock.calls[0][1]).not.toHaveProperty("onResponseMetadata");
47
+ expect(post.mock.calls[0][1]).not.toHaveProperty("signal");
48
+ expect(post.mock.calls[0][1]).not.toHaveProperty("timeout");
49
+ expect(observer).toHaveBeenCalledWith({
50
+ statusCode: 200,
51
+ requestId: "http-request",
52
+ rateLimit: { limit: 20, remaining: 19 },
53
+ headers: {
54
+ "x-request-id": "http-request",
55
+ "x-ratelimit-limit-requests": "20",
56
+ "x-ratelimit-remaining-requests": "19",
57
+ },
58
+ });
59
+ });
60
+ it("emits embedding error metadata and preserves the original HttpError", async () => {
61
+ const { HttpError } = require("../../../src/utils/http");
62
+ const error = new HttpError(429, new Response(null, { headers: { "retry-after": "3" } }), "rate limited");
63
+ post.mockRejectedValue(error);
64
+ const observer = jest.fn();
65
+ await expect(new http_1.HttpClient("https://provider.example").createEmbedding({
66
+ model: "test",
67
+ input: "hello",
68
+ onResponseMetadata: observer,
69
+ })).rejects.toBe(error);
70
+ expect(observer).toHaveBeenCalledWith({
71
+ statusCode: 429,
72
+ rateLimit: { retryAfterSeconds: 3 },
73
+ headers: { "retry-after": "3" },
74
+ });
75
+ });
76
+ });
77
+ //# sourceMappingURL=http.responseMetadata.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http.responseMetadata.test.js","sourceRoot":"","sources":["../../../../tests/unit/clients/http.responseMetadata.test.ts"],"names":[],"mappings":";;AAAA,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;AAEvB,IAAI,CAAC,IAAI,CAAC,yBAAyB,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1C,UAAU,EAAE,IAAI;IAChB,OAAO,EAAE,EAAE,IAAI,EAAE;IACjB,yBAAyB,EAAE,MAAM,CAAC,SAAS,CAAC;IAC5C,SAAS,EAAE,MAAM,SAAU,SAAQ,KAAK;QAE7B;QACA;QAFT,YACS,MAAc,EACd,QAAkB,EACzB,OAAe;YAEf,KAAK,CAAC,OAAO,CAAC,CAAC;YAJR,WAAM,GAAN,MAAM,CAAQ;YACd,aAAQ,GAAR,QAAQ,CAAU;QAI3B,CAAC;KACF;CACF,CAAC,CAAC,CAAC;AAEJ,oDAAuD;AAEvD,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAEnC,EAAE,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;QACrF,IAAI,CAAC,iBAAiB,CAAC;YACrB,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,IAAI,OAAO,CAAC;gBACnB,cAAc,EAAE,cAAc;gBAC9B,4BAA4B,EAAE,IAAI;gBAClC,gCAAgC,EAAE,IAAI;aACvC,CAAC;YACF,IAAI,EAAE;gBACJ,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;gBAC5D,KAAK,EAAE,MAAM;aACd;SACF,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,IAAI,iBAAU,CAAC,0BAA0B,CAAC,CAAC;QAC1D,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,MAAM,CAAC,oBAAoB,CAAC;YAChC,KAAK,EAAE,MAAM;YACb,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;YAC9C,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,OAAO,EAAE,CAAC;YACV,UAAU,EAAE,CAAC;YACb,SAAS,EAAE,CAAC;YACZ,kBAAkB,EAAE,QAAQ;SAC7B,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC;QACvE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC3D,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAC5D,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC;YACpC,UAAU,EAAE,GAAG;YACf,SAAS,EAAE,cAAc;YACzB,SAAS,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;YACvC,OAAO,EAAE;gBACP,cAAc,EAAE,cAAc;gBAC9B,4BAA4B,EAAE,IAAI;gBAClC,gCAAgC,EAAE,IAAI;aACvC;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACnF,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,IAAI,SAAS,CACzB,GAAG,EACH,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE,EAAE,CAAC,EACvD,cAAc,CACf,CAAC;QACF,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,MAAM,CACV,IAAI,iBAAU,CAAC,0BAA0B,CAAC,CAAC,eAAe,CAAC;YACzD,KAAK,EAAE,MAAM;YACb,KAAK,EAAE,OAAO;YACd,kBAAkB,EAAE,QAAQ;SAC7B,CAAC,CACH,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC;YACpC,UAAU,EAAE,GAAG;YACf,SAAS,EAAE,EAAE,iBAAiB,EAAE,CAAC,EAAE;YACnC,OAAO,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE;SAChC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,86 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const openai_1 = require("../../../src/clients/openai");
4
+ const completionOptions = {
5
+ model: "gpt-4o-mini",
6
+ messages: [{ role: "user", content: "hello" }],
7
+ };
8
+ describe("OpenAI response metadata", () => {
9
+ it("emits native chat response metadata before mapping", async () => {
10
+ const client = new openai_1.GenericOpenAiClient("test-key");
11
+ const observer = jest.fn();
12
+ client.client = {
13
+ chat: {
14
+ completions: {
15
+ create: jest.fn(() => ({
16
+ withResponse: async () => ({
17
+ data: {
18
+ choices: [{ message: { role: "assistant", content: "hi" } }],
19
+ usage: undefined,
20
+ },
21
+ response: new Response(null, {
22
+ status: 200,
23
+ headers: {
24
+ "x-request-id": "chat-request",
25
+ "x-ratelimit-limit-requests": "100",
26
+ "x-ratelimit-remaining-requests": "99",
27
+ "x-ratelimit-limit-tokens": "1000",
28
+ },
29
+ }),
30
+ request_id: "chat-request",
31
+ }),
32
+ })),
33
+ },
34
+ },
35
+ };
36
+ const result = await client.createChatCompletion({
37
+ ...completionOptions,
38
+ onResponseMetadata: observer,
39
+ });
40
+ expect(result.choices[0].message.content).toBe("hi");
41
+ expect(observer).toHaveBeenCalledWith({
42
+ statusCode: 200,
43
+ requestId: "chat-request",
44
+ rateLimit: { limit: 100, remaining: 99, tokenLimit: 1000 },
45
+ headers: {
46
+ "x-request-id": "chat-request",
47
+ "x-ratelimit-limit-requests": "100",
48
+ "x-ratelimit-remaining-requests": "99",
49
+ "x-ratelimit-limit-tokens": "1000",
50
+ },
51
+ });
52
+ });
53
+ it("emits API error metadata and preserves the original error", async () => {
54
+ const client = new openai_1.GenericOpenAiClient("test-key");
55
+ const observer = jest.fn(() => {
56
+ throw new Error("observer");
57
+ });
58
+ const error = Object.assign(new Error("rate limited"), {
59
+ status: 429,
60
+ headers: { "retry-after": "2", authorization: "secret" },
61
+ request_id: "rate-request",
62
+ });
63
+ client.client = {
64
+ chat: {
65
+ completions: {
66
+ create: jest.fn(() => ({
67
+ withResponse: async () => {
68
+ throw error;
69
+ },
70
+ })),
71
+ },
72
+ },
73
+ };
74
+ await expect(client.createChatCompletion({
75
+ ...completionOptions,
76
+ onResponseMetadata: observer,
77
+ })).rejects.toBe(error);
78
+ expect(observer).toHaveBeenCalledWith({
79
+ statusCode: 429,
80
+ requestId: "rate-request",
81
+ rateLimit: { retryAfterSeconds: 2 },
82
+ headers: { "retry-after": "2" },
83
+ });
84
+ });
85
+ });
86
+ //# sourceMappingURL=openai.responseMetadata.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"openai.responseMetadata.test.js","sourceRoot":"","sources":["../../../../tests/unit/clients/openai.responseMetadata.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,96 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const responseMetadata_1 = require("../../../src/clients/responseMetadata");
4
+ describe("response metadata", () => {
5
+ it("normalizes and allowlists safe headers and derives a request id", () => {
6
+ const metadata = (0, responseMetadata_1.normalizeResponseMetadata)({
7
+ statusCode: 429,
8
+ headers: {
9
+ "X-RateLimit-Remaining": "0",
10
+ "X-Request-Id": "request-123",
11
+ Authorization: "Bearer secret",
12
+ Cookie: "session=secret",
13
+ "X-Private-Value": "never expose",
14
+ },
15
+ });
16
+ expect(metadata).toEqual({
17
+ statusCode: 429,
18
+ requestId: "request-123",
19
+ rateLimit: { remaining: 0 },
20
+ headers: {
21
+ "x-ratelimit-remaining": "0",
22
+ "x-request-id": "request-123",
23
+ },
24
+ });
25
+ });
26
+ it("uses an explicit request id and retains only the first duplicate header", () => {
27
+ const metadata = (0, responseMetadata_1.normalizeResponseMetadata)({
28
+ requestId: "explicit-id",
29
+ headers: [
30
+ ["Retry-After", "1"],
31
+ ["retry-after", "2"],
32
+ ["CF-Ray", "ray-id"],
33
+ ],
34
+ });
35
+ expect(metadata.requestId).toBe("explicit-id");
36
+ expect(metadata.headers).toEqual({
37
+ "retry-after": "1",
38
+ "cf-ray": "ray-id",
39
+ });
40
+ });
41
+ it("normalizes standard and OpenAI-compatible limits into JSON-safe values", () => {
42
+ const now = new Date("2026-08-23T00:00:00.000Z");
43
+ expect((0, responseMetadata_1.normalizeRateLimitMetadata)({
44
+ "ratelimit-limit": "100",
45
+ "ratelimit-remaining": "9",
46
+ "ratelimit-reset": "60",
47
+ "retry-after": "2",
48
+ "x-ratelimit-limit-tokens": "2000",
49
+ "x-ratelimit-remaining-tokens": "100",
50
+ "x-ratelimit-reset-tokens": "1m30s",
51
+ }, now)).toEqual({
52
+ limit: 100,
53
+ remaining: 9,
54
+ resetAt: "2026-08-23T00:01:00.000Z",
55
+ retryAfterSeconds: 2,
56
+ tokenLimit: 2000,
57
+ tokenRemaining: 100,
58
+ tokenResetAt: "2026-08-23T00:01:30.000Z",
59
+ });
60
+ });
61
+ it("normalizes Anthropic request and token windows", () => {
62
+ expect((0, responseMetadata_1.normalizeRateLimitMetadata)({
63
+ "anthropic-ratelimit-requests-limit": "50",
64
+ "anthropic-ratelimit-requests-remaining": "10",
65
+ "anthropic-ratelimit-requests-reset": "2026-08-23T00:01:00Z",
66
+ "anthropic-ratelimit-tokens-limit": "40000",
67
+ "anthropic-ratelimit-tokens-remaining": "5000",
68
+ "anthropic-ratelimit-tokens-reset": "2026-08-23T00:02:00Z",
69
+ }, new Date("2026-08-23T00:00:00Z"))).toEqual({
70
+ limit: 50,
71
+ remaining: 10,
72
+ resetAt: "2026-08-23T00:01:00.000Z",
73
+ tokenLimit: 40000,
74
+ tokenRemaining: 5000,
75
+ tokenResetAt: "2026-08-23T00:02:00.000Z",
76
+ });
77
+ });
78
+ it("bounds retained values and isolates observer failures", () => {
79
+ const value = "x".repeat(300);
80
+ const observer = jest.fn(() => {
81
+ throw new Error("telemetry failure");
82
+ });
83
+ expect(() => (0, responseMetadata_1.emitResponseMetadata)({ onResponseMetadata: observer }, { headers: { "x-ratelimit-reset": value } })).not.toThrow();
84
+ expect(observer).toHaveBeenCalledWith({
85
+ rateLimit: {},
86
+ headers: { "x-ratelimit-reset": "x".repeat(256) },
87
+ });
88
+ });
89
+ it("limits retained header count and aggregate data", () => {
90
+ const headers = {};
91
+ for (let index = 0; index < 30; index++)
92
+ headers[`x-ratelimit-test-${index}`] = String(index);
93
+ expect(Object.keys((0, responseMetadata_1.normalizeResponseMetadata)({ headers }).headers)).toHaveLength(24);
94
+ });
95
+ });
96
+ //# sourceMappingURL=responseMetadata.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"responseMetadata.test.js","sourceRoot":"","sources":["../../../../tests/unit/clients/responseMetadata.test.ts"],"names":[],"mappings":"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"}