@namzu/sdk 0.4.2 → 0.4.4

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

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 5):
+ *
+ *   - `WebhookConnector.connect` stores config + auth; merges default
+ *     headers; sets `Authorization: Bearer <token>` iff auth is
+ *     bearer with a token (other auth types are ignored here).
+ *   - `disconnect` clears state.
+ *   - `healthCheck` HEAD-fetches the configured url; true iff
+ *     `ok || status < 500`; false on thrown fetch or empty url.
+ *   - `execute("send", input)`:
+ *     - Validates input via zod.
+ *     - Posts JSON to `input.url ?? config.url`.
+ *     - Always sets `Content-Type: application/json`.
+ *     - When `config.secret` is set, computes HMAC-SHA256 over the
+ *       stringified payload and sets `X-Webhook-Signature: sha256=<hex>`.
+ *     - `success: true` iff `status in [200, 400)`.
+ *     - `metadata.deliveredAt` is a recent timestamp.
+ */
+export {};
+//# sourceMappingURL=webhook.test.d.ts.map

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

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

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

@@ -0,0 +1,113 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 5):
+ *
+ *   - `WebhookConnector.connect` stores config + auth; merges default
+ *     headers; sets `Authorization: Bearer <token>` iff auth is
+ *     bearer with a token (other auth types are ignored here).
+ *   - `disconnect` clears state.
+ *   - `healthCheck` HEAD-fetches the configured url; true iff
+ *     `ok || status < 500`; false on thrown fetch or empty url.
+ *   - `execute("send", input)`:
+ *     - Validates input via zod.
+ *     - Posts JSON to `input.url ?? config.url`.
+ *     - Always sets `Content-Type: application/json`.
+ *     - When `config.secret` is set, computes HMAC-SHA256 over the
+ *       stringified payload and sets `X-Webhook-Signature: sha256=<hex>`.
+ *     - `success: true` iff `status in [200, 400)`.
+ *     - `metadata.deliveredAt` is a recent timestamp.
+ */
+import { createHmac } from 'node:crypto';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { WebhookConnector } from './webhook.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: 'OK',
+        headers,
+        json: async () => init.body,
+        text: async () => String(init.body ?? ''),
+    };
+}
+describe('WebhookConnector', () => {
+    let fetchMock;
+    beforeEach(() => {
+        fetchMock = vi.fn();
+        global.fetch = fetchMock;
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('connect + disconnect round-trip state', async () => {
+        const c = new WebhookConnector();
+        await c.connect({ url: 'https://hook.example.com/x' });
+        fetchMock.mockResolvedValueOnce(makeResponse({ status: 200 }));
+        expect(await c.healthCheck()).toBe(true);
+        await c.disconnect();
+        expect(await c.healthCheck()).toBe(false);
+    });
+    it('bearer auth sets Authorization header on send', async () => {
+        const c = new WebhookConnector();
+        await c.connect({ url: 'https://hook.example.com' }, { type: 'bearer', credentials: { token: 'tkn' } });
+        fetchMock.mockResolvedValueOnce(makeResponse({ status: 200, body: 'ok' }));
+        await c.execute('send', { payload: {} });
+        const headers = fetchMock.mock.calls[0]?.[1].headers;
+        expect(headers.Authorization).toBe('Bearer tkn');
+    });
+    it('send posts JSON to the configured URL', async () => {
+        const c = new WebhookConnector();
+        await c.connect({ url: 'https://hook.example.com' });
+        fetchMock.mockResolvedValueOnce(makeResponse({ status: 200, body: 'ok' }));
+        await c.execute('send', { payload: { k: 'v' } });
+        expect(fetchMock).toHaveBeenCalledWith('https://hook.example.com', expect.objectContaining({
+            method: 'POST',
+            body: JSON.stringify({ k: 'v' }),
+        }));
+    });
+    it('input.url overrides the configured URL', async () => {
+        const c = new WebhookConnector();
+        await c.connect({ url: 'https://default.example.com' });
+        fetchMock.mockResolvedValueOnce(makeResponse({ status: 200, body: 'ok' }));
+        await c.execute('send', { payload: {}, url: 'https://override.example.com' });
+        expect(fetchMock).toHaveBeenCalledWith('https://override.example.com', expect.any(Object));
+    });
+    it('includes HMAC signature when secret is configured', async () => {
+        const secret = 's3cret';
+        const c = new WebhookConnector();
+        await c.connect({ url: 'https://hook.example.com', secret });
+        fetchMock.mockResolvedValueOnce(makeResponse({ status: 200, body: 'ok' }));
+        await c.execute('send', { payload: { k: 'v' } });
+        const headers = fetchMock.mock.calls[0]?.[1].headers;
+        const expected = `sha256=${createHmac('sha256', secret)
+            .update(JSON.stringify({ k: 'v' }))
+            .digest('hex')}`;
+        expect(headers['X-Webhook-Signature']).toBe(expected);
+    });
+    it('omits HMAC signature when no secret is configured', async () => {
+        const c = new WebhookConnector();
+        await c.connect({ url: 'https://hook.example.com' });
+        fetchMock.mockResolvedValueOnce(makeResponse({ status: 200, body: 'ok' }));
+        await c.execute('send', { payload: {} });
+        const headers = fetchMock.mock.calls[0]?.[1].headers;
+        expect(headers['X-Webhook-Signature']).toBeUndefined();
+    });
+    it('success: true for 2xx; false for 4xx/5xx', async () => {
+        const c = new WebhookConnector();
+        await c.connect({ url: 'https://hook.example.com' });
+        fetchMock.mockResolvedValueOnce(makeResponse({ status: 200, body: 'ok' }));
+        expect((await c.execute('send', { payload: {} })).success).toBe(true);
+        fetchMock.mockResolvedValueOnce(makeResponse({ status: 500, body: 'err' }));
+        expect((await c.execute('send', { payload: {} })).success).toBe(false);
+    });
+    it('metadata.deliveredAt is a recent timestamp', async () => {
+        const before = Date.now();
+        const c = new WebhookConnector();
+        await c.connect({ url: 'https://hook.example.com' });
+        fetchMock.mockResolvedValueOnce(makeResponse({ status: 200, body: 'ok' }));
+        const result = await c.execute('send', { payload: {} });
+        const delivered = result.metadata.deliveredAt;
+        expect(delivered).toBeGreaterThanOrEqual(before);
+    });
+});
+//# sourceMappingURL=webhook.test.js.map

package/dist/connector/builtins/webhook.test.js.map

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

package/dist/connector/execution/factory.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 5):
+ *
+ *   - `ExecutionContextFactory.create(config)` dispatches by
+ *     `config.environment`:
+ *     - 'local' → `LocalExecutionContext` with the forwarded fields.
+ *     - 'remote' → `RemoteExecutionContext` with target + capabilities.
+ *     - 'hybrid' → `HybridExecutionContext` with local + remotes +
+ *       routingStrategy.
+ *   - Unknown environment hits the exhaustive throw (unreachable via
+ *     types).
+ *   - The static `createLocal` / `createRemote` / `createHybrid`
+ *     helpers directly return the appropriate subclass.
+ */
+export {};
+//# sourceMappingURL=factory.test.d.ts.map

package/dist/connector/execution/factory.test.d.ts.map

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

package/dist/connector/execution/factory.test.js

@@ -0,0 +1,64 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 5):
+ *
+ *   - `ExecutionContextFactory.create(config)` dispatches by
+ *     `config.environment`:
+ *     - 'local' → `LocalExecutionContext` with the forwarded fields.
+ *     - 'remote' → `RemoteExecutionContext` with target + capabilities.
+ *     - 'hybrid' → `HybridExecutionContext` with local + remotes +
+ *       routingStrategy.
+ *   - Unknown environment hits the exhaustive throw (unreachable via
+ *     types).
+ *   - The static `createLocal` / `createRemote` / `createHybrid`
+ *     helpers directly return the appropriate subclass.
+ */
+import { describe, expect, it } from 'vitest';
+import { LocalExecutionContext } from '../../execution/local.js';
+import { ExecutionContextFactory } from './factory.js';
+import { HybridExecutionContext } from './hybrid.js';
+import { RemoteExecutionContext } from './remote.js';
+describe('ExecutionContextFactory', () => {
+    it('creates a LocalExecutionContext for environment: local', () => {
+        const ctx = ExecutionContextFactory.create({
+            id: 'c1',
+            environment: 'local',
+            cwd: '/tmp',
+            fsAccess: true,
+        });
+        expect(ctx).toBeInstanceOf(LocalExecutionContext);
+        expect(ctx.id).toBe('c1');
+        expect(ctx.environment).toBe('local');
+    });
+    it('creates a RemoteExecutionContext for environment: remote', () => {
+        const ctx = ExecutionContextFactory.create({
+            id: 'c2',
+            environment: 'remote',
+            target: { type: 'ssh', host: 'server.example.com' },
+        });
+        expect(ctx).toBeInstanceOf(RemoteExecutionContext);
+        expect(ctx.environment).toBe('remote');
+    });
+    it('creates a HybridExecutionContext for environment: hybrid', () => {
+        const ctx = ExecutionContextFactory.create({
+            id: 'c3',
+            environment: 'hybrid',
+            local: { cwd: '/tmp', fsAccess: true },
+            remotes: [{ type: 'ssh', host: 'r1.example.com' }],
+        });
+        expect(ctx).toBeInstanceOf(HybridExecutionContext);
+        expect(ctx.environment).toBe('hybrid');
+    });
+    it('createLocal / createRemote / createHybrid return the right subclass', () => {
+        expect(ExecutionContextFactory.createLocal({ id: 'x', cwd: '/tmp', fsAccess: true })).toBeInstanceOf(LocalExecutionContext);
+        expect(ExecutionContextFactory.createRemote({
+            id: 'y',
+            target: { type: 'ssh', host: 'h' },
+        })).toBeInstanceOf(RemoteExecutionContext);
+        expect(ExecutionContextFactory.createHybrid({
+            id: 'z',
+            local: { cwd: '/tmp', fsAccess: true },
+            remotes: [],
+        })).toBeInstanceOf(HybridExecutionContext);
+    });
+});
+//# sourceMappingURL=factory.test.js.map

package/dist/connector/execution/factory.test.js.map

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

package/dist/connector/execution/remote.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 5):
+ *
+ *   - `RemoteExecutionContext` starts disconnected; `connect()` flips
+ *     `connected = true` and emits `remote_connected`.
+ *   - `disconnect()` is idempotent — the second call emits nothing
+ *     and returns quietly.
+ *   - `getTarget()` returns a COPY (mutating the returned object does
+ *     not mutate internal state).
+ *   - `initialize()` succeeds for supported target types; emits
+ *     `context_initialized` + `context_ready`.
+ *   - `isReady()` reflects post-initialize state.
+ *   - `environment` is 'remote'.
+ */
+export {};
+//# sourceMappingURL=remote.test.d.ts.map

package/dist/connector/execution/remote.test.d.ts.map

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

package/dist/connector/execution/remote.test.js

@@ -0,0 +1,53 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 5):
+ *
+ *   - `RemoteExecutionContext` starts disconnected; `connect()` flips
+ *     `connected = true` and emits `remote_connected`.
+ *   - `disconnect()` is idempotent — the second call emits nothing
+ *     and returns quietly.
+ *   - `getTarget()` returns a COPY (mutating the returned object does
+ *     not mutate internal state).
+ *   - `initialize()` succeeds for supported target types; emits
+ *     `context_initialized` + `context_ready`.
+ *   - `isReady()` reflects post-initialize state.
+ *   - `environment` is 'remote'.
+ */
+import { describe, expect, it } from 'vitest';
+import { RemoteExecutionContext } from './remote.js';
+const target = { type: 'ssh', host: 'server.example.com', port: 22 };
+describe('RemoteExecutionContext', () => {
+    it('environment is remote', () => {
+        const r = new RemoteExecutionContext({ id: 'r1', target });
+        expect(r.environment).toBe('remote');
+    });
+    it('starts disconnected; connect flips to connected', async () => {
+        const r = new RemoteExecutionContext({ id: 'r1', target });
+        expect(r.isConnected()).toBe(false);
+        await r.connect();
+        expect(r.isConnected()).toBe(true);
+    });
+    it('disconnect when not connected is a no-op', async () => {
+        const r = new RemoteExecutionContext({ id: 'r1', target });
+        await r.disconnect();
+        expect(r.isConnected()).toBe(false);
+    });
+    it('disconnect flips back to disconnected', async () => {
+        const r = new RemoteExecutionContext({ id: 'r1', target });
+        await r.connect();
+        await r.disconnect();
+        expect(r.isConnected()).toBe(false);
+    });
+    it('getTarget returns a copy (mutation does not leak)', () => {
+        const r = new RemoteExecutionContext({ id: 'r1', target });
+        const copy = r.getTarget();
+        copy.host = 'mutated.example.com';
+        expect(r.getTarget().host).toBe('server.example.com');
+    });
+    it('initialize flips isReady to true', async () => {
+        const r = new RemoteExecutionContext({ id: 'r1', target });
+        expect(r.isReady()).toBe(false);
+        await r.initialize();
+        expect(r.isReady()).toBe(true);
+    });
+});
+//# sourceMappingURL=remote.test.js.map

package/dist/connector/execution/remote.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.test.js","sourceRoot":"","sources":["../../../src/connector/execution/remote.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAI7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAEpD,MAAM,MAAM,GAAiB,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,EAAE,EAAE,CAAA;AAElF,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAChC,MAAM,CAAC,GAAG,IAAI,sBAAsB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;QAC1D,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,CAAC,GAAG,IAAI,sBAAsB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;QAC1D,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACnC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAA;QACjB,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACnC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,CAAC,GAAG,IAAI,sBAAsB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;QAC1D,MAAM,CAAC,CAAC,UAAU,EAAE,CAAA;QACpB,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,CAAC,GAAG,IAAI,sBAAsB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;QAC1D,MAAM,CAAC,CAAC,OAAO,EAAE,CAAA;QACjB,MAAM,CAAC,CAAC,UAAU,EAAE,CAAA;QACpB,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,GAAG,IAAI,sBAAsB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;QAC1D,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,CAAA;QAC1B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;QACjC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;IACtD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,CAAC,GAAG,IAAI,sBAAsB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;QAC1D,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC/B,MAAM,CAAC,CAAC,UAAU,EAAE,CAAA;QACpB,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC/B,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/connector/mcp/adapter.test.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 5):
+ *
+ *   - `mcpJsonSchemaToZod(schema)`:
+ *     - Empty / no-properties object → passthrough `z.object({})`.
+ *     - Maps primitive types (string, number, integer, boolean, array,
+ *       object) to zod equivalents.
+ *     - Unknown / null property types → `z.unknown()`.
+ *     - Fields not in `required[]` are `.optional()`.
+ *   - `zodToMCPJsonSchema(zodSchema)` wraps `zodToJsonSchema` with
+ *     `type: 'object'` prefixed.
+ *   - `mcpToolToToolDefinition(tool, client, serverName)` produces a
+ *     ToolDefinition:
+ *     - name = `mcp_<server>_<tool.name>`
+ *     - description prefixed `[MCP:<server>] <tool.description or name>`
+ *     - category = 'network', permissions = ['network_access']
+ *     - readOnly + destructive reflect MCP annotations; concurrency
+ *       safe defaults to true.
+ *     - `execute(input, ctx)` calls `client.callTool(tool.name, input)`
+ *       and adapts the MCPToolResult.
+ *   - `toolDefinitionToMCPTool(tool)` projects name/description +
+ *     converts inputSchema + copies annotations.
+ *   - `mcpToolResultToToolResult`:
+ *     - success = !isError.
+ *     - output = text content joined with '\n' (non-text blocks
+ *       kept in `data` only).
+ *     - error = same joined text when isError, else undefined.
+ *   - `toolResultToMCPToolResult`:
+ *     - success + output → single text block.
+ *     - failure + error → single text block + isError.
+ *     - Empty output on success → single empty-text block.
+ */
+export {};
+//# sourceMappingURL=adapter.test.d.ts.map

package/dist/connector/mcp/adapter.test.d.ts.map

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