@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.
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=client.test.d.ts.map
@@ -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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"}
@@ -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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"}
@@ -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"}
@@ -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,3 @@
1
+ export { HivemindClient } from "./client.js";
2
+ export { HivemindError, AuthError, RateLimitError, NotFoundError, } from "./errors.js";
3
+ //# sourceMappingURL=index.js.map
@@ -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"}
@@ -0,0 +1,5 @@
1
+ export interface RetryOptions {
2
+ maxRetries: number;
3
+ }
4
+ export declare function withRetry<T>(fn: () => Promise<Response>, parse: (res: Response) => Promise<T>, opts: RetryOptions): Promise<T>;
5
+ //# sourceMappingURL=retry.d.ts.map
@@ -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"}
@@ -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,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -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
+ }