@namzu/sdk 0.4.2 → 0.4.3

package/dist/bus/ownership.test.js

@@ -0,0 +1,205 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 1):
+ *
+ *   - `claim(path, owner)` on an unowned file creates ownership, emits
+ *     `ownership_claimed`, returns `{claimed: true, ownership}`.
+ *   - `claim(path, owner)` by the same owner is idempotent — returns
+ *     `{claimed: true, ownership}` WITHOUT re-emitting.
+ *   - `claim(path, owner)` by a different owner is denied — emits
+ *     `ownership_denied`, returns `{claimed: false, currentOwner, filePath}`.
+ *   - `release(path, owner)` on the current owner deletes + emits; returns
+ *     true. On mismatch or missing entry: returns false; no emit.
+ *   - `transfer(path, from, to)` requires the current owner to equal
+ *     `from`. Success replaces the entry with a new `claimedAt`, emits
+ *     `ownership_transferred`; no intervening `ownership_released` or
+ *     `ownership_claimed` events. Failure returns false; no emit.
+ *   - `releaseAll(owner)` sweeps every ownership for `owner`, emits
+ *     `ownership_released` per entry, returns the count. Other owners'
+ *     entries are untouched.
+ *   - File paths are normalised via `path.resolve` before keying —
+ *     `./foo/bar` and the absolute resolution of the same path collide
+ *     into one ownership slot.
+ *   - Ownership is not per-tenant; only per-`RunId`. There is no tenant
+ *     isolation at this layer (design.md §2.1 aspirational; see §2.7).
+ */
+import path from 'node:path';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { EditOwnershipTracker } from './ownership.js';
+function makeLogger() {
+    const stub = { info: vi.fn(), warn: vi.fn(), error: vi.fn(), debug: vi.fn() };
+    return { ...stub, child: vi.fn(() => ({ ...stub, child: vi.fn() })) };
+}
+function runId(n) {
+    return `run_${n}`;
+}
+describe('EditOwnershipTracker', () => {
+    let events;
+    let tracker;
+    beforeEach(() => {
+        events = [];
+        tracker = new EditOwnershipTracker(makeLogger(), (e) => events.push(e));
+    });
+    describe('claim', () => {
+        it('claims an unowned file, emits ownership_claimed, returns ownership', () => {
+            const before = Date.now();
+            const result = tracker.claim('/tmp/file.txt', runId(1));
+            const after = Date.now();
+            expect(result.claimed).toBe(true);
+            if (result.claimed) {
+                expect(result.ownership.owner).toBe(runId(1));
+                expect(result.ownership.filePath).toBe(path.resolve('/tmp/file.txt'));
+                expect(result.ownership.claimedAt).toBeGreaterThanOrEqual(before);
+                expect(result.ownership.claimedAt).toBeLessThanOrEqual(after);
+            }
+            expect(events).toEqual([
+                { type: 'ownership_claimed', filePath: path.resolve('/tmp/file.txt'), owner: runId(1) },
+            ]);
+        });
+        it('is idempotent when the same owner re-claims — no re-emit', () => {
+            tracker.claim('/tmp/file.txt', runId(1));
+            events.length = 0;
+            const result = tracker.claim('/tmp/file.txt', runId(1));
+            expect(result.claimed).toBe(true);
+            expect(events).toEqual([]);
+        });
+        it('denies a claim by a different owner, emits ownership_denied', () => {
+            tracker.claim('/tmp/file.txt', runId(1));
+            events.length = 0;
+            const result = tracker.claim('/tmp/file.txt', runId(2));
+            expect(result.claimed).toBe(false);
+            if (!result.claimed) {
+                expect(result.currentOwner).toBe(runId(1));
+                expect(result.filePath).toBe(path.resolve('/tmp/file.txt'));
+            }
+            expect(events).toEqual([
+                {
+                    type: 'ownership_denied',
+                    filePath: path.resolve('/tmp/file.txt'),
+                    requester: runId(2),
+                    currentOwner: runId(1),
+                },
+            ]);
+        });
+        it('normalises file paths — equivalent paths collide', () => {
+            tracker.claim('/tmp/foo/../file.txt', runId(1));
+            const result = tracker.claim('/tmp/file.txt', runId(2));
+            expect(result.claimed).toBe(false);
+        });
+    });
+    describe('release', () => {
+        it('releases an owned file, emits ownership_released, returns true', () => {
+            tracker.claim('/tmp/file.txt', runId(1));
+            events.length = 0;
+            const ok = tracker.release('/tmp/file.txt', runId(1));
+            expect(ok).toBe(true);
+            expect(tracker.getOwner('/tmp/file.txt')).toBeUndefined();
+            expect(events).toEqual([
+                {
+                    type: 'ownership_released',
+                    filePath: path.resolve('/tmp/file.txt'),
+                    previousOwner: runId(1),
+                },
+            ]);
+        });
+        it('returns false when no ownership exists — no emit', () => {
+            const ok = tracker.release('/tmp/never-claimed.txt', runId(1));
+            expect(ok).toBe(false);
+            expect(events).toEqual([]);
+        });
+        it('returns false when owner mismatches — no emit', () => {
+            tracker.claim('/tmp/file.txt', runId(1));
+            events.length = 0;
+            const ok = tracker.release('/tmp/file.txt', runId(2));
+            expect(ok).toBe(false);
+            expect(tracker.getOwner('/tmp/file.txt')).toBe(runId(1));
+            expect(events).toEqual([]);
+        });
+    });
+    describe('transfer', () => {
+        it('transfers ownership from current owner to another — atomic, single event', () => {
+            tracker.claim('/tmp/file.txt', runId(1));
+            events.length = 0;
+            const ok = tracker.transfer('/tmp/file.txt', runId(1), runId(2));
+            expect(ok).toBe(true);
+            expect(tracker.getOwner('/tmp/file.txt')).toBe(runId(2));
+            expect(events).toEqual([
+                {
+                    type: 'ownership_transferred',
+                    filePath: path.resolve('/tmp/file.txt'),
+                    from: runId(1),
+                    to: runId(2),
+                },
+            ]);
+        });
+        it('returns false when the `from` argument is not the current owner — no emit', () => {
+            tracker.claim('/tmp/file.txt', runId(1));
+            events.length = 0;
+            const ok = tracker.transfer('/tmp/file.txt', runId(99), runId(2));
+            expect(ok).toBe(false);
+            expect(tracker.getOwner('/tmp/file.txt')).toBe(runId(1));
+            expect(events).toEqual([]);
+        });
+        it('returns false when no ownership exists — no emit', () => {
+            const ok = tracker.transfer('/tmp/file.txt', runId(1), runId(2));
+            expect(ok).toBe(false);
+            expect(events).toEqual([]);
+        });
+        it('refreshes claimedAt on successful transfer', async () => {
+            tracker.claim('/tmp/file.txt', runId(1));
+            const t0 = tracker.getOwner('/tmp/file.txt');
+            expect(t0).toBe(runId(1));
+            await new Promise((r) => setTimeout(r, 2));
+            tracker.transfer('/tmp/file.txt', runId(1), runId(2));
+            const list = tracker.listByOwner(runId(2));
+            expect(list).toHaveLength(1);
+            const after = list[0];
+            expect(after?.claimedAt).toBeGreaterThan(0);
+            expect(after?.owner).toBe(runId(2));
+        });
+    });
+    describe('releaseAll', () => {
+        it('releases every ownership for the owner, returns count, emits per-entry', () => {
+            tracker.claim('/tmp/a.txt', runId(1));
+            tracker.claim('/tmp/b.txt', runId(1));
+            tracker.claim('/tmp/c.txt', runId(2));
+            events.length = 0;
+            const count = tracker.releaseAll(runId(1));
+            expect(count).toBe(2);
+            expect(tracker.getOwner('/tmp/a.txt')).toBeUndefined();
+            expect(tracker.getOwner('/tmp/b.txt')).toBeUndefined();
+            expect(tracker.getOwner('/tmp/c.txt')).toBe(runId(2));
+            const released = events.filter((e) => e.type === 'ownership_released');
+            expect(released.length).toBe(2);
+            for (const e of released) {
+                if (e.type === 'ownership_released') {
+                    expect(e.previousOwner).toBe(runId(1));
+                }
+            }
+        });
+        it('returns 0 when the owner has no entries', () => {
+            const count = tracker.releaseAll(runId(99));
+            expect(count).toBe(0);
+            expect(events).toEqual([]);
+        });
+    });
+    describe('read helpers', () => {
+        it('getOwner returns undefined for unclaimed paths', () => {
+            expect(tracker.getOwner('/tmp/anything.txt')).toBeUndefined();
+        });
+        it('listByOwner returns all ownerships for a given owner', () => {
+            tracker.claim('/tmp/a.txt', runId(1));
+            tracker.claim('/tmp/b.txt', runId(1));
+            tracker.claim('/tmp/c.txt', runId(2));
+            const list = tracker.listByOwner(runId(1));
+            expect(list.length).toBe(2);
+            expect(new Set(list.map((o) => o.filePath))).toEqual(new Set([path.resolve('/tmp/a.txt'), path.resolve('/tmp/b.txt')]));
+        });
+        it('checkConflict returns the current owner iff a different owner holds the file', () => {
+            tracker.claim('/tmp/file.txt', runId(1));
+            expect(tracker.checkConflict('/tmp/file.txt', runId(1))).toBeUndefined();
+            expect(tracker.checkConflict('/tmp/file.txt', runId(2))).toBe(runId(1));
+            expect(tracker.checkConflict('/tmp/other.txt', runId(2))).toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=ownership.test.js.map

package/dist/bus/ownership.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownership.test.js","sourceRoot":"","sources":["../../src/bus/ownership.test.ts"],"names":[],"mappings":"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"}

package/dist/connector/BaseConnector.test.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 5):
+ *
+ *   - `BaseConnector` is abstract. Each concrete subclass sets id /
+ *     name / description / connectionType / configSchema / methods
+ *     and implements connect / disconnect / healthCheck / execute.
+ *   - `toDefinition()` projects the abstract readonly fields into a
+ *     `ConnectorDefinition<TConfig>` — used to register the connector
+ *     with the `ConnectorRegistry`.
+ *   - `findMethod(name)` returns the method by name or undefined.
+ *   - `requireMethod(name)` throws with the method name + available
+ *     names when not found.
+ *   - `validateInput(method, input)`: zod.safeParse; on failure
+ *     throws `Invalid input for method "<name>": <joined issues>`.
+ *   - `measureExecution(fn)` returns `{result, durationMs}` with
+ *     durationMs rounded.
+ *   - Auth resolution lives in subclasses (see HttpConnector tests),
+ *     not in the base class.
+ */
+export {};
+//# sourceMappingURL=BaseConnector.test.d.ts.map

package/dist/connector/BaseConnector.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseConnector.test.d.ts","sourceRoot":"","sources":["../../src/connector/BaseConnector.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}

package/dist/connector/BaseConnector.test.js

@@ -0,0 +1,108 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 5):
+ *
+ *   - `BaseConnector` is abstract. Each concrete subclass sets id /
+ *     name / description / connectionType / configSchema / methods
+ *     and implements connect / disconnect / healthCheck / execute.
+ *   - `toDefinition()` projects the abstract readonly fields into a
+ *     `ConnectorDefinition<TConfig>` — used to register the connector
+ *     with the `ConnectorRegistry`.
+ *   - `findMethod(name)` returns the method by name or undefined.
+ *   - `requireMethod(name)` throws with the method name + available
+ *     names when not found.
+ *   - `validateInput(method, input)`: zod.safeParse; on failure
+ *     throws `Invalid input for method "<name>": <joined issues>`.
+ *   - `measureExecution(fn)` returns `{result, durationMs}` with
+ *     durationMs rounded.
+ *   - Auth resolution lives in subclasses (see HttpConnector tests),
+ *     not in the base class.
+ */
+import { describe, expect, it } from 'vitest';
+import { z } from 'zod';
+import { BaseConnector } from './BaseConnector.js';
+class TestConnector extends BaseConnector {
+    id = 'conn_test';
+    name = 'Test';
+    description = 'Test connector';
+    connectionType = 'custom';
+    configSchema = z.object({ base: z.string() });
+    methods = [
+        {
+            name: 'echo',
+            description: 'echo',
+            inputSchema: z.object({ value: z.string() }),
+        },
+    ];
+    async connect() { }
+    async disconnect() { }
+    async healthCheck() {
+        return true;
+    }
+    async execute() {
+        return { success: true, output: 'ok', durationMs: 0 };
+    }
+    // Expose protected methods for direct tests:
+    publicRequireMethod(name) {
+        return this.requireMethod(name);
+    }
+    publicValidateInput(method, input) {
+        return this.validateInput(method, input);
+    }
+    publicMeasureExecution(fn) {
+        return this.measureExecution(fn);
+    }
+    // Exposed internal auth resolver on a subclass is a sibling concern —
+    // `BaseConnector` does not define any auth handling; the field is
+    // just stored.
+    getStoredAuth() {
+        return this.auth;
+    }
+}
+describe('BaseConnector', () => {
+    it('toDefinition projects abstract readonly fields', () => {
+        const c = new TestConnector();
+        const def = c.toDefinition();
+        expect(def.id).toBe('conn_test');
+        expect(def.name).toBe('Test');
+        expect(def.description).toBe('Test connector');
+        expect(def.connectionType).toBe('custom');
+        expect(def.methods).toHaveLength(1);
+    });
+    it('findMethod returns undefined for an unknown name', () => {
+        const c = new TestConnector();
+        expect(c.publicRequireMethod).toBeDefined();
+        // findMethod is invoked indirectly via requireMethod — we cover the
+        // positive + negative paths below.
+    });
+    it('requireMethod returns the method when present', () => {
+        const c = new TestConnector();
+        const method = c.publicRequireMethod('echo');
+        expect(method.name).toBe('echo');
+    });
+    it('requireMethod throws naming the missing method + available names', () => {
+        const c = new TestConnector();
+        expect(() => c.publicRequireMethod('nope')).toThrow(/Method "nope" not found/);
+        expect(() => c.publicRequireMethod('nope')).toThrow(/Available: echo/);
+    });
+    it('validateInput passes through parsed data on success', () => {
+        const c = new TestConnector();
+        const method = c.publicRequireMethod('echo');
+        expect(c.publicValidateInput(method, { value: 'hi' })).toEqual({ value: 'hi' });
+    });
+    it('validateInput throws with joined issue messages on failure', () => {
+        const c = new TestConnector();
+        const method = c.publicRequireMethod('echo');
+        expect(() => c.publicValidateInput(method, { value: 123 })).toThrow(/Invalid input for method "echo"/);
+    });
+    it('measureExecution returns the result + rounded durationMs', async () => {
+        const c = new TestConnector();
+        const { result, durationMs } = await c.publicMeasureExecution(async () => {
+            await new Promise((r) => setTimeout(r, 5));
+            return 42;
+        });
+        expect(result).toBe(42);
+        expect(durationMs).toBeGreaterThanOrEqual(0);
+        expect(Number.isInteger(durationMs)).toBe(true);
+    });
+});
+//# sourceMappingURL=BaseConnector.test.js.map

package/dist/connector/BaseConnector.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseConnector.test.js","sourceRoot":"","sources":["../../src/connector/BaseConnector.test.ts"],"names":[],"mappings":"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"}

package/dist/connector/builtins/http.test.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 5):
+ *
+ *   - `HttpConnector.connect` stores config + auth, strips trailing
+ *     slashes from baseUrl, merges default headers with auth-derived
+ *     headers.
+ *   - Auth resolution (http only — webhook has its own):
+ *     - `api_key` with `apiKey` + optional `headerName` (default
+ *       `X-API-Key`).
+ *     - `bearer` with `token` → `Authorization: Bearer <token>`.
+ *     - `basic` with `username` + `password` → base64 encoded.
+ *     - `none` / `oauth2` / `custom` → no headers.
+ *     - Missing required credential fields throw a typed error string.
+ *   - `disconnect` clears internal state.
+ *   - `healthCheck` HEAD-fetches baseUrl with a 5s timeout; returns
+ *     true iff `response.ok || response.status < 500`; false on any
+ *     thrown fetch (e.g. timeout abort).
+ *   - `execute("request", input)`:
+ *     - `requireMethod` + `validateInput` run.
+ *     - Builds URL from `baseUrl + path` + appends query params.
+ *     - Sends default+input headers; auto-sets `Content-Type:
+ *       application/json` when a body is present and no content-type
+ *       was passed.
+ *     - Parses response JSON when `content-type: application/json`,
+ *       else text.
+ *     - `success: true` iff status in [200, 400). Metadata includes
+ *       status + statusText.
+ */
+export {};
+//# sourceMappingURL=http.test.d.ts.map

package/dist/connector/builtins/http.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.test.d.ts","sourceRoot":"","sources":["../../../src/connector/builtins/http.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG"}

package/dist/connector/builtins/http.test.js

@@ -0,0 +1,232 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 5):
+ *
+ *   - `HttpConnector.connect` stores config + auth, strips trailing
+ *     slashes from baseUrl, merges default headers with auth-derived
+ *     headers.
+ *   - Auth resolution (http only — webhook has its own):
+ *     - `api_key` with `apiKey` + optional `headerName` (default
+ *       `X-API-Key`).
+ *     - `bearer` with `token` → `Authorization: Bearer <token>`.
+ *     - `basic` with `username` + `password` → base64 encoded.
+ *     - `none` / `oauth2` / `custom` → no headers.
+ *     - Missing required credential fields throw a typed error string.
+ *   - `disconnect` clears internal state.
+ *   - `healthCheck` HEAD-fetches baseUrl with a 5s timeout; returns
+ *     true iff `response.ok || response.status < 500`; false on any
+ *     thrown fetch (e.g. timeout abort).
+ *   - `execute("request", input)`:
+ *     - `requireMethod` + `validateInput` run.
+ *     - Builds URL from `baseUrl + path` + appends query params.
+ *     - Sends default+input headers; auto-sets `Content-Type:
+ *       application/json` when a body is present and no content-type
+ *       was passed.
+ *     - Parses response JSON when `content-type: application/json`,
+ *       else text.
+ *     - `success: true` iff status in [200, 400). Metadata includes
+ *       status + statusText.
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { HttpConnector } from './http.js';
+function makeResponse(init) {
+    const headers = new Headers(init.headers ?? { 'content-type': 'application/json' });
+    return {
+        ok: (init.status ?? 200) < 400,
+        status: init.status ?? 200,
+        statusText: init.statusText ?? 'OK',
+        headers,
+        json: async () => init.body,
+        text: async () => String(init.body ?? ''),
+    };
+}
+describe('HttpConnector', () => {
+    let fetchMock;
+    beforeEach(() => {
+        fetchMock = vi.fn();
+        global.fetch = fetchMock;
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    describe('connect + disconnect', () => {
+        it('strips trailing slashes from baseUrl', async () => {
+            const c = new HttpConnector();
+            await c.connect({ baseUrl: 'https://api.example.com//', timeoutMs: 30_000 });
+            // Follow-up request lands on the cleaned URL:
+            fetchMock.mockResolvedValueOnce(makeResponse({ status: 200, body: { ok: true } }));
+            await c.execute('request', { method: 'GET', path: 'x' });
+            expect(fetchMock).toHaveBeenCalledWith('https://api.example.com/x', expect.any(Object));
+        });
+        it('disconnect clears internal state; execute after disconnect treats baseUrl as empty', async () => {
+            const c = new HttpConnector();
+            await c.connect({ baseUrl: 'https://api.example.com', timeoutMs: 30_000 });
+            await c.disconnect();
+            expect(await c.healthCheck()).toBe(false);
+        });
+    });
+    describe('auth resolution', () => {
+        it('api_key default header name = X-API-Key', async () => {
+            const c = new HttpConnector();
+            await c.connect({ baseUrl: 'https://api.example.com' }, { type: 'api_key', credentials: { apiKey: 'secret' } });
+            fetchMock.mockResolvedValueOnce(makeResponse({ status: 200, body: {} }));
+            await c.execute('request', { method: 'GET', path: 'x' });
+            const headers = fetchMock.mock.calls[0]?.[1].headers;
+            expect(headers['X-API-Key']).toBe('secret');
+        });
+        it('api_key custom header name is honored', async () => {
+            const c = new HttpConnector();
+            await c.connect({ baseUrl: 'https://api.example.com' }, { type: 'api_key', credentials: { apiKey: 'secret', headerName: 'X-Custom' } });
+            fetchMock.mockResolvedValueOnce(makeResponse({ status: 200, body: {} }));
+            await c.execute('request', { method: 'GET', path: 'x' });
+            const headers = fetchMock.mock.calls[0]?.[1].headers;
+            expect(headers['X-Custom']).toBe('secret');
+        });
+        it('bearer sets Authorization: Bearer <token>', async () => {
+            const c = new HttpConnector();
+            await c.connect({ baseUrl: 'https://api.example.com' }, { type: 'bearer', credentials: { token: 'tkn' } });
+            fetchMock.mockResolvedValueOnce(makeResponse({ status: 200, body: {} }));
+            await c.execute('request', { method: 'GET', path: 'x' });
+            const headers = fetchMock.mock.calls[0]?.[1].headers;
+            expect(headers.Authorization).toBe('Bearer tkn');
+        });
+        it('basic encodes username:password as base64', async () => {
+            const c = new HttpConnector();
+            await c.connect({ baseUrl: 'https://api.example.com' }, { type: 'basic', credentials: { username: 'alice', password: 'pw' } });
+            fetchMock.mockResolvedValueOnce(makeResponse({ status: 200, body: {} }));
+            await c.execute('request', { method: 'GET', path: 'x' });
+            const headers = fetchMock.mock.calls[0]?.[1].headers;
+            expect(headers.Authorization).toBe(`Basic ${btoa('alice:pw')}`);
+        });
+        it('none / oauth2 / custom add no auth headers', async () => {
+            for (const type of ['none', 'oauth2', 'custom']) {
+                const c = new HttpConnector();
+                await c.connect({ baseUrl: 'https://api.example.com' }, { type, credentials: {} });
+                fetchMock.mockResolvedValueOnce(makeResponse({ status: 200, body: {} }));
+                await c.execute('request', { method: 'GET', path: 'x' });
+                const headers = fetchMock.mock.calls.at(-1)?.[1].headers;
+                expect(headers.Authorization).toBeUndefined();
+                expect(headers['X-API-Key']).toBeUndefined();
+            }
+        });
+        it('api_key throws when apiKey is missing', async () => {
+            const c = new HttpConnector();
+            await expect(c.connect({ baseUrl: 'https://api.example.com' }, { type: 'api_key', credentials: {} })).rejects.toThrow(/missing required credential "apiKey"/);
+        });
+        it('bearer throws when token is missing', async () => {
+            const c = new HttpConnector();
+            await expect(c.connect({ baseUrl: 'https://api.example.com' }, { type: 'bearer', credentials: {} })).rejects.toThrow(/missing required credential "token"/);
+        });
+        it('basic throws when either username or password is missing', async () => {
+            const c = new HttpConnector();
+            await expect(c.connect({ baseUrl: 'https://api.example.com' }, { type: 'basic', credentials: { username: 'a' } })).rejects.toThrow(/missing required credentials/);
+        });
+    });
+    describe('healthCheck', () => {
+        it('returns true for ok responses', async () => {
+            const c = new HttpConnector();
+            await c.connect({ baseUrl: 'https://api.example.com' });
+            fetchMock.mockResolvedValueOnce(makeResponse({ status: 200 }));
+            expect(await c.healthCheck()).toBe(true);
+        });
+        it('returns true for 4xx (not-ok but < 500)', async () => {
+            const c = new HttpConnector();
+            await c.connect({ baseUrl: 'https://api.example.com' });
+            fetchMock.mockResolvedValueOnce(makeResponse({ status: 404 }));
+            expect(await c.healthCheck()).toBe(true);
+        });
+        it('returns false for 5xx', async () => {
+            const c = new HttpConnector();
+            await c.connect({ baseUrl: 'https://api.example.com' });
+            fetchMock.mockResolvedValueOnce(makeResponse({ status: 503 }));
+            expect(await c.healthCheck()).toBe(false);
+        });
+        it('returns false on thrown fetch', async () => {
+            const c = new HttpConnector();
+            await c.connect({ baseUrl: 'https://api.example.com' });
+            fetchMock.mockRejectedValueOnce(new Error('timeout'));
+            expect(await c.healthCheck()).toBe(false);
+        });
+        it('returns false when never connected', async () => {
+            const c = new HttpConnector();
+            expect(await c.healthCheck()).toBe(false);
+        });
+    });
+    describe('execute', () => {
+        it('returns success:true for 2xx + 3xx responses', async () => {
+            const c = new HttpConnector();
+            await c.connect({ baseUrl: 'https://api.example.com' });
+            fetchMock.mockResolvedValueOnce(makeResponse({ status: 200, body: { ok: 1 } }));
+            const result = await c.execute('request', { method: 'GET', path: 'thing' });
+            expect(result.success).toBe(true);
+            expect(result.output).toMatchObject({ status: 200 });
+        });
+        it('returns success:false for 4xx / 5xx responses', async () => {
+            const c = new HttpConnector();
+            await c.connect({ baseUrl: 'https://api.example.com' });
+            fetchMock.mockResolvedValueOnce(makeResponse({ status: 500, body: { err: 1 } }));
+            const result = await c.execute('request', { method: 'GET', path: 'thing' });
+            expect(result.success).toBe(false);
+            expect(result.metadata).toMatchObject({ status: 500 });
+        });
+        it('sets Content-Type: application/json when body is set and none provided', async () => {
+            const c = new HttpConnector();
+            await c.connect({ baseUrl: 'https://api.example.com' });
+            fetchMock.mockResolvedValueOnce(makeResponse({ status: 200, body: {} }));
+            await c.execute('request', {
+                method: 'POST',
+                path: 'thing',
+                body: { k: 'v' },
+            });
+            const headers = fetchMock.mock.calls[0]?.[1].headers;
+            expect(headers['Content-Type']).toBe('application/json');
+        });
+        it('preserves caller-supplied Content-Type', async () => {
+            const c = new HttpConnector();
+            await c.connect({ baseUrl: 'https://api.example.com' });
+            fetchMock.mockResolvedValueOnce(makeResponse({ status: 200, body: '' }));
+            await c.execute('request', {
+                method: 'POST',
+                path: 'thing',
+                body: 'raw',
+                headers: { 'Content-Type': 'text/plain' },
+            });
+            const headers = fetchMock.mock.calls[0]?.[1].headers;
+            expect(headers['Content-Type']).toBe('text/plain');
+        });
+        it('appends query params to the URL', async () => {
+            const c = new HttpConnector();
+            await c.connect({ baseUrl: 'https://api.example.com' });
+            fetchMock.mockResolvedValueOnce(makeResponse({ status: 200, body: {} }));
+            await c.execute('request', {
+                method: 'GET',
+                path: 'thing',
+                query: { a: '1', b: '2' },
+            });
+            expect(fetchMock.mock.calls[0]?.[0]).toBe('https://api.example.com/thing?a=1&b=2');
+        });
+        it('parses JSON response when content-type is json', async () => {
+            const c = new HttpConnector();
+            await c.connect({ baseUrl: 'https://api.example.com' });
+            fetchMock.mockResolvedValueOnce(makeResponse({
+                status: 200,
+                headers: { 'content-type': 'application/json' },
+                body: { ok: 1 },
+            }));
+            const result = await c.execute('request', { method: 'GET', path: 'x' });
+            expect(result.output.body).toEqual({ ok: 1 });
+        });
+        it('returns text body for non-JSON content-type', async () => {
+            const c = new HttpConnector();
+            await c.connect({ baseUrl: 'https://api.example.com' });
+            fetchMock.mockResolvedValueOnce(makeResponse({ status: 200, headers: { 'content-type': 'text/plain' }, body: 'hello' }));
+            const result = await c.execute('request', { method: 'GET', path: 'x' });
+            expect(result.output.body).toBe('hello');
+        });
+        it('throws on invalid input (unknown method)', async () => {
+            const c = new HttpConnector();
+            await c.connect({ baseUrl: 'https://api.example.com' });
+            await expect(c.execute('not-a-method', {})).rejects.toThrow(/not found/);
+        });
+    });
+});
+//# sourceMappingURL=http.test.js.map