@hivemindai/sdk-ts 0.1.0
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/dist/__tests__/client.test.d.ts +2 -0
- package/dist/__tests__/client.test.d.ts.map +1 -0
- package/dist/__tests__/client.test.js +155 -0
- package/dist/__tests__/client.test.js.map +1 -0
- package/dist/client.d.ts +21 -0
- package/dist/client.d.ts.map +1 -0
- package/dist/client.js +84 -0
- package/dist/client.js.map +1 -0
- package/dist/errors.d.ts +16 -0
- package/dist/errors.d.ts.map +1 -0
- package/dist/errors.js +31 -0
- package/dist/errors.js.map +1 -0
- package/dist/index.d.ts +4 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +3 -0
- package/dist/index.js.map +1 -0
- package/dist/retry.d.ts +5 -0
- package/dist/retry.d.ts.map +1 -0
- package/dist/retry.js +29 -0
- package/dist/retry.js.map +1 -0
- package/dist/types.d.ts +96 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +2 -0
- package/dist/types.js.map +1 -0
- package/package.json +35 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/client.test.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
|
|
2
|
+
import { HivemindClient } from "../client.js";
|
|
3
|
+
import { AuthError, NotFoundError, RateLimitError, HivemindError } from "../errors.js";
|
|
4
|
+
const mockFetch = vi.fn();
|
|
5
|
+
beforeEach(() => {
|
|
6
|
+
vi.stubGlobal("fetch", mockFetch);
|
|
7
|
+
});
|
|
8
|
+
afterEach(() => {
|
|
9
|
+
vi.restoreAllMocks();
|
|
10
|
+
});
|
|
11
|
+
function jsonResponse(body, status = 200, headers) {
|
|
12
|
+
return new Response(JSON.stringify(body), {
|
|
13
|
+
status,
|
|
14
|
+
headers: { "Content-Type": "application/json", ...headers },
|
|
15
|
+
});
|
|
16
|
+
}
|
|
17
|
+
const client = new HivemindClient({
|
|
18
|
+
apiKey: "hm_live_12345678901234567890123456789012",
|
|
19
|
+
baseUrl: "http://localhost:3000",
|
|
20
|
+
maxRetries: 0,
|
|
21
|
+
});
|
|
22
|
+
describe("publish", () => {
|
|
23
|
+
it("sends POST /v1/events with correct body and auth header", async () => {
|
|
24
|
+
mockFetch.mockResolvedValueOnce(jsonResponse({ id: "evt_1", created_at: "2024-06-15T12:00:00Z" }, 201));
|
|
25
|
+
const result = await client.publish({
|
|
26
|
+
channel: "backend",
|
|
27
|
+
event_type: "task.completed",
|
|
28
|
+
source: { agent: "a", tool: "t" },
|
|
29
|
+
data: { description: "Done" },
|
|
30
|
+
});
|
|
31
|
+
expect(result.id).toBe("evt_1");
|
|
32
|
+
expect(mockFetch).toHaveBeenCalledWith("http://localhost:3000/v1/events", expect.objectContaining({
|
|
33
|
+
method: "POST",
|
|
34
|
+
headers: expect.objectContaining({
|
|
35
|
+
Authorization: "Bearer hm_live_12345678901234567890123456789012",
|
|
36
|
+
"Content-Type": "application/json",
|
|
37
|
+
}),
|
|
38
|
+
}));
|
|
39
|
+
});
|
|
40
|
+
});
|
|
41
|
+
describe("query", () => {
|
|
42
|
+
it("sends GET /v1/events with query params", async () => {
|
|
43
|
+
mockFetch.mockResolvedValueOnce(jsonResponse({ events: [], total: 0, has_more: false }));
|
|
44
|
+
await client.query({ channel: "backend", limit: 10 });
|
|
45
|
+
expect(mockFetch).toHaveBeenCalledWith(expect.stringContaining("/v1/events?"), expect.objectContaining({ method: "GET" }));
|
|
46
|
+
const url = mockFetch.mock.calls[0][0];
|
|
47
|
+
expect(url).toContain("channel=backend");
|
|
48
|
+
expect(url).toContain("limit=10");
|
|
49
|
+
});
|
|
50
|
+
it("sends GET /v1/events without params when none provided", async () => {
|
|
51
|
+
mockFetch.mockResolvedValueOnce(jsonResponse({ events: [], total: 0, has_more: false }));
|
|
52
|
+
await client.query();
|
|
53
|
+
expect(mockFetch).toHaveBeenCalledWith("http://localhost:3000/v1/events", expect.anything());
|
|
54
|
+
});
|
|
55
|
+
});
|
|
56
|
+
describe("getEvent", () => {
|
|
57
|
+
it("returns event from response", async () => {
|
|
58
|
+
const event = {
|
|
59
|
+
id: "evt_1",
|
|
60
|
+
project_id: "proj_1",
|
|
61
|
+
channel: "backend",
|
|
62
|
+
event_type: "task.completed",
|
|
63
|
+
source: { agent: "a", tool: "t" },
|
|
64
|
+
data: {},
|
|
65
|
+
confidence: null,
|
|
66
|
+
created_at: "2024-06-15T12:00:00Z",
|
|
67
|
+
};
|
|
68
|
+
mockFetch.mockResolvedValueOnce(jsonResponse({ event }));
|
|
69
|
+
const result = await client.getEvent("evt_1");
|
|
70
|
+
expect(result.id).toBe("evt_1");
|
|
71
|
+
});
|
|
72
|
+
it("throws NotFoundError on 404", async () => {
|
|
73
|
+
mockFetch.mockResolvedValueOnce(jsonResponse({ error: "Event not found" }, 404));
|
|
74
|
+
await expect(client.getEvent("nonexistent")).rejects.toThrow(NotFoundError);
|
|
75
|
+
});
|
|
76
|
+
});
|
|
77
|
+
describe("status", () => {
|
|
78
|
+
it("sends GET /v1/status", async () => {
|
|
79
|
+
mockFetch.mockResolvedValueOnce(jsonResponse({
|
|
80
|
+
active_tasks: [],
|
|
81
|
+
recent_completions: [],
|
|
82
|
+
blockers: [],
|
|
83
|
+
event_count_24h: 0,
|
|
84
|
+
last_event_at: null,
|
|
85
|
+
}));
|
|
86
|
+
await client.status();
|
|
87
|
+
expect(mockFetch).toHaveBeenCalledWith("http://localhost:3000/v1/status", expect.anything());
|
|
88
|
+
});
|
|
89
|
+
it("passes channel as query param", async () => {
|
|
90
|
+
mockFetch.mockResolvedValueOnce(jsonResponse({
|
|
91
|
+
active_tasks: [],
|
|
92
|
+
recent_completions: [],
|
|
93
|
+
blockers: [],
|
|
94
|
+
event_count_24h: 0,
|
|
95
|
+
last_event_at: null,
|
|
96
|
+
}));
|
|
97
|
+
await client.status("backend");
|
|
98
|
+
expect(mockFetch).toHaveBeenCalledWith("http://localhost:3000/v1/status?channel=backend", expect.anything());
|
|
99
|
+
});
|
|
100
|
+
});
|
|
101
|
+
describe("lock / unlock", () => {
|
|
102
|
+
it("sends POST /v1/locks/:resource", async () => {
|
|
103
|
+
mockFetch.mockResolvedValueOnce(jsonResponse({ locked: true, lock: {} }));
|
|
104
|
+
const result = await client.lock("src/db.ts", { agent: "a", tool: "t" });
|
|
105
|
+
expect(result.locked).toBe(true);
|
|
106
|
+
expect(mockFetch).toHaveBeenCalledWith("http://localhost:3000/v1/locks/src%2Fdb.ts", expect.objectContaining({ method: "POST" }));
|
|
107
|
+
});
|
|
108
|
+
it("sends DELETE /v1/locks/:resource", async () => {
|
|
109
|
+
mockFetch.mockResolvedValueOnce(jsonResponse({ released: true }));
|
|
110
|
+
const result = await client.unlock("src/db.ts");
|
|
111
|
+
expect(result.released).toBe(true);
|
|
112
|
+
});
|
|
113
|
+
});
|
|
114
|
+
describe("error handling", () => {
|
|
115
|
+
it("throws AuthError on 401", async () => {
|
|
116
|
+
mockFetch.mockResolvedValueOnce(jsonResponse({ error: "Invalid API key" }, 401));
|
|
117
|
+
await expect(client.query()).rejects.toThrow(AuthError);
|
|
118
|
+
});
|
|
119
|
+
it("throws RateLimitError on 429", async () => {
|
|
120
|
+
mockFetch.mockResolvedValueOnce(jsonResponse({ error: "Rate limit exceeded" }, 429, {
|
|
121
|
+
"X-RateLimit-Reset": String(Math.ceil(Date.now() / 1000) + 60),
|
|
122
|
+
}));
|
|
123
|
+
await expect(client.query()).rejects.toThrow(RateLimitError);
|
|
124
|
+
});
|
|
125
|
+
it("throws HivemindError on 500", async () => {
|
|
126
|
+
mockFetch.mockResolvedValueOnce(jsonResponse({ error: "Internal server error" }, 500));
|
|
127
|
+
await expect(client.query()).rejects.toThrow(HivemindError);
|
|
128
|
+
});
|
|
129
|
+
});
|
|
130
|
+
describe("retry", () => {
|
|
131
|
+
it("retries on 5xx responses", async () => {
|
|
132
|
+
const retryClient = new HivemindClient({
|
|
133
|
+
apiKey: "hm_live_12345678901234567890123456789012",
|
|
134
|
+
baseUrl: "http://localhost:3000",
|
|
135
|
+
maxRetries: 2,
|
|
136
|
+
});
|
|
137
|
+
mockFetch
|
|
138
|
+
.mockResolvedValueOnce(jsonResponse({ error: "Server error" }, 500))
|
|
139
|
+
.mockResolvedValueOnce(jsonResponse({ events: [], total: 0, has_more: false }));
|
|
140
|
+
const result = await retryClient.query();
|
|
141
|
+
expect(result.events).toEqual([]);
|
|
142
|
+
expect(mockFetch).toHaveBeenCalledTimes(2);
|
|
143
|
+
});
|
|
144
|
+
it("does not retry on 400", async () => {
|
|
145
|
+
const retryClient = new HivemindClient({
|
|
146
|
+
apiKey: "hm_live_12345678901234567890123456789012",
|
|
147
|
+
baseUrl: "http://localhost:3000",
|
|
148
|
+
maxRetries: 2,
|
|
149
|
+
});
|
|
150
|
+
mockFetch.mockResolvedValueOnce(jsonResponse({ error: "Validation error", details: [] }, 400));
|
|
151
|
+
await expect(retryClient.query()).rejects.toThrow(HivemindError);
|
|
152
|
+
expect(mockFetch).toHaveBeenCalledTimes(1);
|
|
153
|
+
});
|
|
154
|
+
});
|
|
155
|
+
//# sourceMappingURL=client.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client.test.js","sourceRoot":"","sources":["../../src/__tests__/client.test.ts"],"names":[],"mappings":"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"}
|
package/dist/client.d.ts
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import type { ClientOptions, PublishParams, QueryParams, QueryResult, SubscribeParams, SubscribeResult, StatusResponse, LockParams, LockResponse, Event } from "./types.js";
|
|
2
|
+
export declare class HivemindClient {
|
|
3
|
+
private readonly apiKey;
|
|
4
|
+
private readonly baseUrl;
|
|
5
|
+
private readonly maxRetries;
|
|
6
|
+
constructor(options: ClientOptions);
|
|
7
|
+
publish(params: PublishParams): Promise<{
|
|
8
|
+
id: string;
|
|
9
|
+
created_at: string;
|
|
10
|
+
}>;
|
|
11
|
+
query(params?: QueryParams): Promise<QueryResult>;
|
|
12
|
+
getEvent(id: string): Promise<Event>;
|
|
13
|
+
subscribe(params: SubscribeParams): Promise<SubscribeResult>;
|
|
14
|
+
status(channel?: string): Promise<StatusResponse>;
|
|
15
|
+
lock(resource: string, params: LockParams): Promise<LockResponse>;
|
|
16
|
+
unlock(resource: string): Promise<{
|
|
17
|
+
released: boolean;
|
|
18
|
+
}>;
|
|
19
|
+
private request;
|
|
20
|
+
}
|
|
21
|
+
//# sourceMappingURL=client.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,WAAW,EACX,WAAW,EACX,eAAe,EACf,eAAe,EACf,cAAc,EACd,UAAU,EACV,YAAY,EACZ,KAAK,EACN,MAAM,YAAY,CAAC;AAOpB,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,OAAO,EAAE,aAAa;IAM5B,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAI3E,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAcjD,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAKpC,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAI5D,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAKjD,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;IAIjE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;YAIhD,OAAO;CAmDtB"}
|
package/dist/client.js
ADDED
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
import { HivemindError, AuthError, RateLimitError, NotFoundError } from "./errors.js";
|
|
2
|
+
import { withRetry } from "./retry.js";
|
|
3
|
+
const DEFAULT_BASE_URL = "http://localhost:3000";
|
|
4
|
+
const DEFAULT_MAX_RETRIES = 2;
|
|
5
|
+
export class HivemindClient {
|
|
6
|
+
apiKey;
|
|
7
|
+
baseUrl;
|
|
8
|
+
maxRetries;
|
|
9
|
+
constructor(options) {
|
|
10
|
+
this.apiKey = options.apiKey;
|
|
11
|
+
this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
|
|
12
|
+
this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
|
|
13
|
+
}
|
|
14
|
+
async publish(params) {
|
|
15
|
+
return this.request("POST", "/v1/events", params, 201);
|
|
16
|
+
}
|
|
17
|
+
async query(params) {
|
|
18
|
+
const searchParams = new URLSearchParams();
|
|
19
|
+
if (params) {
|
|
20
|
+
for (const [key, value] of Object.entries(params)) {
|
|
21
|
+
if (value !== undefined && value !== null) {
|
|
22
|
+
searchParams.set(key, String(value));
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
const qs = searchParams.toString();
|
|
27
|
+
const path = qs ? `/v1/events?${qs}` : "/v1/events";
|
|
28
|
+
return this.request("GET", path);
|
|
29
|
+
}
|
|
30
|
+
async getEvent(id) {
|
|
31
|
+
const result = await this.request("GET", `/v1/events/${encodeURIComponent(id)}`);
|
|
32
|
+
return result.event;
|
|
33
|
+
}
|
|
34
|
+
async subscribe(params) {
|
|
35
|
+
return this.request("POST", "/v1/subscriptions", params, 201);
|
|
36
|
+
}
|
|
37
|
+
async status(channel) {
|
|
38
|
+
const path = channel ? `/v1/status?channel=${encodeURIComponent(channel)}` : "/v1/status";
|
|
39
|
+
return this.request("GET", path);
|
|
40
|
+
}
|
|
41
|
+
async lock(resource, params) {
|
|
42
|
+
return this.request("POST", `/v1/locks/${encodeURIComponent(resource)}`, params);
|
|
43
|
+
}
|
|
44
|
+
async unlock(resource) {
|
|
45
|
+
return this.request("DELETE", `/v1/locks/${encodeURIComponent(resource)}`);
|
|
46
|
+
}
|
|
47
|
+
async request(method, path, body, expectedStatus) {
|
|
48
|
+
const url = `${this.baseUrl}${path}`;
|
|
49
|
+
const headers = {
|
|
50
|
+
Authorization: `Bearer ${this.apiKey}`,
|
|
51
|
+
};
|
|
52
|
+
if (body) {
|
|
53
|
+
headers["Content-Type"] = "application/json";
|
|
54
|
+
}
|
|
55
|
+
return withRetry(() => fetch(url, {
|
|
56
|
+
method,
|
|
57
|
+
headers,
|
|
58
|
+
body: body ? JSON.stringify(body) : undefined,
|
|
59
|
+
}), async (res) => {
|
|
60
|
+
const json = await res.json().catch(() => ({}));
|
|
61
|
+
if (expectedStatus && res.status === expectedStatus) {
|
|
62
|
+
return json;
|
|
63
|
+
}
|
|
64
|
+
if (res.ok) {
|
|
65
|
+
return json;
|
|
66
|
+
}
|
|
67
|
+
if (res.status === 401) {
|
|
68
|
+
throw new AuthError(json.error ?? "Unauthorized", json);
|
|
69
|
+
}
|
|
70
|
+
if (res.status === 404) {
|
|
71
|
+
throw new NotFoundError(json.error ?? "Not found", json);
|
|
72
|
+
}
|
|
73
|
+
if (res.status === 429) {
|
|
74
|
+
const resetHeader = res.headers.get("X-RateLimit-Reset");
|
|
75
|
+
const retryAfterMs = resetHeader
|
|
76
|
+
? Math.max(0, Number(resetHeader) * 1000 - Date.now())
|
|
77
|
+
: 1000;
|
|
78
|
+
throw new RateLimitError(json.error ?? "Rate limit exceeded", retryAfterMs, json);
|
|
79
|
+
}
|
|
80
|
+
throw new HivemindError(json.error ?? `HTTP ${res.status}`, res.status, json);
|
|
81
|
+
}, { maxRetries: this.maxRetries });
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
//# sourceMappingURL=client.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
|
package/dist/errors.d.ts
ADDED
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
export declare class HivemindError extends Error {
|
|
2
|
+
readonly status: number;
|
|
3
|
+
readonly body: unknown;
|
|
4
|
+
constructor(message: string, status: number, body?: unknown);
|
|
5
|
+
}
|
|
6
|
+
export declare class AuthError extends HivemindError {
|
|
7
|
+
constructor(message: string, body?: unknown);
|
|
8
|
+
}
|
|
9
|
+
export declare class RateLimitError extends HivemindError {
|
|
10
|
+
readonly retryAfterMs: number;
|
|
11
|
+
constructor(message: string, retryAfterMs: number, body?: unknown);
|
|
12
|
+
}
|
|
13
|
+
export declare class NotFoundError extends HivemindError {
|
|
14
|
+
constructor(message: string, body?: unknown);
|
|
15
|
+
}
|
|
16
|
+
//# sourceMappingURL=errors.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,IAAI,EAAE,OAAO,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAM5D;AAED,qBAAa,SAAU,SAAQ,aAAa;gBAC9B,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAI5C;AAED,qBAAa,cAAe,SAAQ,aAAa;IAC/C,SAAgB,YAAY,EAAE,MAAM,CAAC;gBAEzB,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAKlE;AAED,qBAAa,aAAc,SAAQ,aAAa;gBAClC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAI5C"}
|
package/dist/errors.js
ADDED
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
export class HivemindError extends Error {
|
|
2
|
+
status;
|
|
3
|
+
body;
|
|
4
|
+
constructor(message, status, body) {
|
|
5
|
+
super(message);
|
|
6
|
+
this.name = "HivemindError";
|
|
7
|
+
this.status = status;
|
|
8
|
+
this.body = body;
|
|
9
|
+
}
|
|
10
|
+
}
|
|
11
|
+
export class AuthError extends HivemindError {
|
|
12
|
+
constructor(message, body) {
|
|
13
|
+
super(message, 401, body);
|
|
14
|
+
this.name = "AuthError";
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
export class RateLimitError extends HivemindError {
|
|
18
|
+
retryAfterMs;
|
|
19
|
+
constructor(message, retryAfterMs, body) {
|
|
20
|
+
super(message, 429, body);
|
|
21
|
+
this.name = "RateLimitError";
|
|
22
|
+
this.retryAfterMs = retryAfterMs;
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
export class NotFoundError extends HivemindError {
|
|
26
|
+
constructor(message, body) {
|
|
27
|
+
super(message, 404, body);
|
|
28
|
+
this.name = "NotFoundError";
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
//# sourceMappingURL=errors.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtB,MAAM,CAAS;IACf,IAAI,CAAU;IAE9B,YAAY,OAAe,EAAE,MAAc,EAAE,IAAc;QACzD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,OAAO,SAAU,SAAQ,aAAa;IAC1C,YAAY,OAAe,EAAE,IAAc;QACzC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,aAAa;IAC/B,YAAY,CAAS;IAErC,YAAY,OAAe,EAAE,YAAoB,EAAE,IAAc;QAC/D,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,aAAa;IAC9C,YAAY,OAAe,EAAE,IAAc;QACzC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
export { HivemindClient } from "./client.js";
|
|
2
|
+
export type { ClientOptions, Event, EventSource, PublishParams, QueryParams, QueryResult, SubscribeParams, SubscribeResult, StatusResponse, LockParams, LockResponse, } from "./types.js";
|
|
3
|
+
export { HivemindError, AuthError, RateLimitError, NotFoundError, } from "./errors.js";
|
|
4
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,YAAY,EACV,aAAa,EACb,KAAK,EACL,WAAW,EACX,aAAa,EACb,WAAW,EACX,WAAW,EACX,eAAe,EACf,eAAe,EACf,cAAc,EACd,UAAU,EACV,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,aAAa,EACb,SAAS,EACT,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAC"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAgB7C,OAAO,EACL,aAAa,EACb,SAAS,EACT,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAC"}
|
package/dist/retry.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,EAC3B,KAAK,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,EACpC,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,CAAC,CAAC,CA6BZ"}
|
package/dist/retry.js
ADDED
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
const DEFAULT_DELAYS = [100, 200, 400];
|
|
2
|
+
export async function withRetry(fn, parse, opts) {
|
|
3
|
+
let lastError;
|
|
4
|
+
for (let attempt = 0; attempt <= opts.maxRetries; attempt++) {
|
|
5
|
+
const res = await fn();
|
|
6
|
+
// Don't retry client errors (except 429)
|
|
7
|
+
if (res.status >= 400 && res.status < 500 && res.status !== 429) {
|
|
8
|
+
return parse(res);
|
|
9
|
+
}
|
|
10
|
+
// Success — parse and return
|
|
11
|
+
if (res.ok) {
|
|
12
|
+
return parse(res);
|
|
13
|
+
}
|
|
14
|
+
// Retryable: 429 or 5xx
|
|
15
|
+
if (attempt < opts.maxRetries) {
|
|
16
|
+
const delay = DEFAULT_DELAYS[attempt] ?? DEFAULT_DELAYS[DEFAULT_DELAYS.length - 1];
|
|
17
|
+
await sleep(delay);
|
|
18
|
+
lastError = new Error(`HTTP ${res.status}`);
|
|
19
|
+
continue;
|
|
20
|
+
}
|
|
21
|
+
// Final attempt — let parse handle error mapping
|
|
22
|
+
return parse(res);
|
|
23
|
+
}
|
|
24
|
+
throw lastError ?? new Error("Retry exhausted");
|
|
25
|
+
}
|
|
26
|
+
function sleep(ms) {
|
|
27
|
+
return new Promise((resolve) => setTimeout(resolve, ms));
|
|
28
|
+
}
|
|
29
|
+
//# sourceMappingURL=retry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAMvC,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAA2B,EAC3B,KAAoC,EACpC,IAAkB;IAElB,IAAI,SAA4B,CAAC;IAEjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QAC5D,MAAM,GAAG,GAAG,MAAM,EAAE,EAAE,CAAC;QAEvB,yCAAyC;QACzC,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAChE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QAED,6BAA6B;QAC7B,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;YACX,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QAED,wBAAwB;QACxB,IAAI,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,cAAc,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACnF,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;YACnB,SAAS,GAAG,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YAC5C,SAAS;QACX,CAAC;QAED,iDAAiD;QACjD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,SAAS,IAAI,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}
|
package/dist/types.d.ts
ADDED
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
export interface EventSource {
|
|
2
|
+
agent: string;
|
|
3
|
+
tool: string;
|
|
4
|
+
session?: string;
|
|
5
|
+
}
|
|
6
|
+
export interface Event {
|
|
7
|
+
id: string;
|
|
8
|
+
project_id: string;
|
|
9
|
+
channel: string;
|
|
10
|
+
event_type: string;
|
|
11
|
+
source: EventSource;
|
|
12
|
+
data: Record<string, unknown>;
|
|
13
|
+
confidence: number | null;
|
|
14
|
+
created_at: string;
|
|
15
|
+
}
|
|
16
|
+
export interface PublishParams {
|
|
17
|
+
channel: string;
|
|
18
|
+
event_type: string;
|
|
19
|
+
source: EventSource;
|
|
20
|
+
data: Record<string, unknown>;
|
|
21
|
+
confidence?: number | null;
|
|
22
|
+
idempotency_key?: string;
|
|
23
|
+
}
|
|
24
|
+
export interface QueryParams {
|
|
25
|
+
q?: string;
|
|
26
|
+
channel?: string;
|
|
27
|
+
event_type?: string;
|
|
28
|
+
since?: string;
|
|
29
|
+
until?: string;
|
|
30
|
+
source_tool?: string;
|
|
31
|
+
limit?: number;
|
|
32
|
+
offset?: number;
|
|
33
|
+
}
|
|
34
|
+
export interface QueryResult {
|
|
35
|
+
events: Event[];
|
|
36
|
+
total: number;
|
|
37
|
+
has_more: boolean;
|
|
38
|
+
}
|
|
39
|
+
export interface SubscribeParams {
|
|
40
|
+
channel?: string | null;
|
|
41
|
+
event_type?: string | null;
|
|
42
|
+
webhook_url: string;
|
|
43
|
+
}
|
|
44
|
+
export interface SubscribeResult {
|
|
45
|
+
id: string;
|
|
46
|
+
secret: string;
|
|
47
|
+
}
|
|
48
|
+
export interface StatusResponse {
|
|
49
|
+
active_tasks: Array<{
|
|
50
|
+
id: string;
|
|
51
|
+
channel: string;
|
|
52
|
+
data: Record<string, unknown>;
|
|
53
|
+
created_at: string;
|
|
54
|
+
}>;
|
|
55
|
+
recent_completions: Array<{
|
|
56
|
+
id: string;
|
|
57
|
+
channel: string;
|
|
58
|
+
data: Record<string, unknown>;
|
|
59
|
+
created_at: string;
|
|
60
|
+
}>;
|
|
61
|
+
blockers: Array<{
|
|
62
|
+
id: string;
|
|
63
|
+
channel: string;
|
|
64
|
+
data: Record<string, unknown>;
|
|
65
|
+
source: EventSource;
|
|
66
|
+
created_at: string;
|
|
67
|
+
}>;
|
|
68
|
+
event_count_24h: number;
|
|
69
|
+
last_event_at: string | null;
|
|
70
|
+
}
|
|
71
|
+
export interface LockParams {
|
|
72
|
+
agent: string;
|
|
73
|
+
tool?: string;
|
|
74
|
+
ttl_seconds?: number;
|
|
75
|
+
}
|
|
76
|
+
export interface LockResponse {
|
|
77
|
+
locked: boolean;
|
|
78
|
+
lock?: {
|
|
79
|
+
project_id: string;
|
|
80
|
+
resource: string;
|
|
81
|
+
agent: string;
|
|
82
|
+
tool: string | null;
|
|
83
|
+
acquired_at: string;
|
|
84
|
+
expires_at: string;
|
|
85
|
+
};
|
|
86
|
+
held_by?: {
|
|
87
|
+
agent: string;
|
|
88
|
+
tool: string | null;
|
|
89
|
+
};
|
|
90
|
+
}
|
|
91
|
+
export interface ClientOptions {
|
|
92
|
+
apiKey: string;
|
|
93
|
+
baseUrl?: string;
|
|
94
|
+
maxRetries?: number;
|
|
95
|
+
}
|
|
96
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
|
package/dist/types.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
|
package/package.json
ADDED
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@hivemindai/sdk-ts",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "TypeScript SDK for the Hivemind event coordination API",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"main": "dist/index.js",
|
|
7
|
+
"types": "dist/index.d.ts",
|
|
8
|
+
"files": [
|
|
9
|
+
"dist"
|
|
10
|
+
],
|
|
11
|
+
"keywords": [
|
|
12
|
+
"hivemind",
|
|
13
|
+
"ai-agents",
|
|
14
|
+
"event-log",
|
|
15
|
+
"coordination",
|
|
16
|
+
"sdk"
|
|
17
|
+
],
|
|
18
|
+
"license": "MIT",
|
|
19
|
+
"repository": {
|
|
20
|
+
"type": "git",
|
|
21
|
+
"url": "https://github.com/hivemind-dev/hivemind",
|
|
22
|
+
"directory": "packages/sdk-ts"
|
|
23
|
+
},
|
|
24
|
+
"publishConfig": {
|
|
25
|
+
"access": "public"
|
|
26
|
+
},
|
|
27
|
+
"devDependencies": {
|
|
28
|
+
"vitest": "^2.1.0"
|
|
29
|
+
},
|
|
30
|
+
"scripts": {
|
|
31
|
+
"build": "tsc",
|
|
32
|
+
"test": "vitest run",
|
|
33
|
+
"lint": "eslint src/"
|
|
34
|
+
}
|
|
35
|
+
}
|