@uppercut-labs/agent-native 0.0.0-stage → 1.1.0

package/dist/harness-mcp-bridge.js

@@ -0,0 +1,159 @@
+import { Buffer } from 'node:buffer';
+import { once } from 'node:events';
+import { createServer } from 'node:http';
+/** Transport only: the supplied handler retains authentication and capability authorization. */
+export async function startHarnessMcpBridge(options) {
+    const host = options.host ?? '127.0.0.1';
+    const port = options.port ?? 0;
+    const maxRequestBytes = options.maxRequestBytes ?? 32_768;
+    const deadlineMs = options.deadlineMs ?? 30_000;
+    if (host !== '127.0.0.1' ||
+        !Number.isInteger(port) ||
+        port < 0 ||
+        port > 65_535 ||
+        !Number.isInteger(maxRequestBytes) ||
+        maxRequestBytes < 1 ||
+        maxRequestBytes > 1_048_576 ||
+        !Number.isInteger(deadlineMs) ||
+        deadlineMs < 1 ||
+        deadlineMs > 300_000)
+        throw new TypeError('Invalid loopback MCP bridge configuration.');
+    let origin = '';
+    let active = new Set();
+    let server = createServer(async (incoming, outgoing) => {
+        if (incoming.headers.host !== origin.slice('http://'.length)) {
+            outgoing.writeHead(421).end();
+            return;
+        }
+        if (incoming.headers.origin !== undefined && incoming.headers.origin !== origin) {
+            outgoing.writeHead(403).end();
+            return;
+        }
+        let url;
+        try {
+            url = new URL(incoming.url ?? '/', origin);
+        }
+        catch {
+            outgoing.writeHead(400).end();
+            return;
+        }
+        if (url.origin !== origin) {
+            outgoing.writeHead(421).end();
+            return;
+        }
+        if (url.pathname !== '/mcp') {
+            outgoing.writeHead(404).end();
+            return;
+        }
+        let controller = new AbortController();
+        active.add(controller);
+        let reader;
+        const disconnected = () => controller.abort();
+        outgoing.on('close', disconnected);
+        incoming.on('aborted', disconnected);
+        const timer = setTimeout(() => {
+            controller.abort();
+            if (outgoing.headersSent)
+                outgoing.destroy();
+            else
+                outgoing.writeHead(504).end();
+        }, deadlineMs);
+        try {
+            let chunks = [];
+            let size = 0;
+            for await (const chunk of incoming) {
+                const bytes = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+                size += bytes.length;
+                if (size > maxRequestBytes) {
+                    outgoing.writeHead(413).end();
+                    return;
+                }
+                chunks.push(bytes);
+            }
+            if (controller.signal.aborted)
+                return;
+            let headers = new Headers();
+            for (let index = 0; index < incoming.rawHeaders.length; index += 2) {
+                const name = incoming.rawHeaders[index];
+                const value = incoming.rawHeaders[index + 1];
+                if (name !== undefined && value !== undefined)
+                    headers.append(name, value);
+            }
+            const method = incoming.method ?? 'GET';
+            const request = new Request(url, {
+                method,
+                headers,
+                signal: controller.signal,
+                ...(method === 'GET' || method === 'HEAD'
+                    ? {}
+                    : { body: new Uint8Array(Buffer.concat(chunks)) }),
+            });
+            const response = await options.handler(request);
+            if (controller.signal.aborted) {
+                await response.body?.cancel();
+                return;
+            }
+            outgoing.writeHead(response.status, Object.fromEntries(response.headers));
+            if (response.body !== null && method !== 'HEAD') {
+                reader = response.body.getReader();
+                // Cancellation also interrupts an idle SSE read during close or client disconnect.
+                controller.signal.addEventListener('abort', () => {
+                    void reader
+                        ?.cancel()
+                        .catch(() => console.error('MCP bridge response cancellation failed.'));
+                }, { once: true });
+                while (!controller.signal.aborted) {
+                    const { value, done } = await reader.read();
+                    if (done)
+                        break;
+                    if (!outgoing.write(value))
+                        await once(outgoing, 'drain', { signal: controller.signal });
+                }
+            }
+            else
+                await response.body?.cancel();
+            if (!outgoing.destroyed)
+                outgoing.end();
+        }
+        catch {
+            if (!controller.signal.aborted) {
+                console.error('MCP bridge request failed.');
+                if (outgoing.headersSent)
+                    outgoing.destroy();
+                else
+                    outgoing.writeHead(500).end();
+            }
+        }
+        finally {
+            clearTimeout(timer);
+            active.delete(controller);
+            outgoing.off('close', disconnected);
+            incoming.off('aborted', disconnected);
+            reader?.releaseLock();
+        }
+    });
+    server.requestTimeout = deadlineMs;
+    server.headersTimeout = deadlineMs;
+    server.listen(port, host);
+    await once(server, 'listening');
+    const address = server.address();
+    if (address === null || typeof address === 'string') {
+        server.close();
+        throw new Error('MCP bridge failed to bind.');
+    }
+    origin = `http://${host}:${address.port}`;
+    let closing;
+    return Object.freeze({
+        url: `${origin}/mcp`,
+        close() {
+            closing ??= new Promise((resolve, reject) => {
+                for (const controller of active)
+                    controller.abort();
+                server.close((error) => (error ? reject(error) : resolve()));
+                server.closeAllConnections();
+            });
+            return closing;
+        },
+    });
+}
+//# sourceMappingURL=harness-mcp-bridge.js.map

package/dist/harness-mcp-bridge.js.map

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

package/dist/harness.d.ts

@@ -0,0 +1,72 @@
+export type HarnessTarget = 'local' | 'cloud';
+export type HarnessFeature = 'resume' | 'cancel' | 'usage' | 'mcp';
+export type HarnessDescriptor = {
+    readonly provider: string;
+    readonly targets: readonly HarnessTarget[];
+    readonly features: readonly HarnessFeature[];
+};
+export type HarnessSessionRef = {
+    readonly provider: string;
+    readonly sessionId: string;
+    readonly target: HarnessTarget;
+};
+export type OpenHarnessSessionRequest = {
+    readonly target: 'local';
+    readonly workspace: string;
+} | {
+    readonly target: 'cloud';
+};
+export type ResumeHarnessSessionRequest = OpenHarnessSessionRequest & {
+    readonly session: HarnessSessionRef;
+};
+export type RunHarnessTurnRequest = {
+    readonly session: HarnessSessionRef;
+    readonly prompt: string;
+};
+export type CancelHarnessTurnRequest = {
+    readonly session: HarnessSessionRef;
+    readonly turnId: string;
+};
+export type CloseHarnessSessionRequest = {
+    readonly session: HarnessSessionRef;
+};
+export type HarnessFailureReason = 'unsupported-target' | 'unsupported-feature' | 'invalid-request' | 'authentication-required' | 'provider-unavailable' | 'session-not-found' | 'session-closed' | 'turn-not-found' | 'turn-active' | 'timeout' | 'provider-failed';
+export declare class HarnessError extends Error {
+    readonly reason: HarnessFailureReason;
+    constructor(reason: HarnessFailureReason);
+}
+type HarnessTurnEventRef = {
+    readonly session: HarnessSessionRef;
+    readonly turnId: string;
+};
+export type HarnessStatusEvent = HarnessTurnEventRef & {
+    readonly type: 'progress' | 'tool';
+    readonly message: string;
+};
+export type HarnessEvent = {
+    readonly type: 'session-started';
+    readonly session: HarnessSessionRef;
+} | (HarnessTurnEventRef & {
+    readonly type: 'turn-started' | 'completed' | 'cancelled';
+}) | HarnessStatusEvent | (HarnessTurnEventRef & {
+    readonly type: 'usage';
+    readonly unit: 'tokens' | 'requests';
+    readonly quantity: number;
+}) | (HarnessTurnEventRef & {
+    readonly type: 'failed';
+    readonly reason: HarnessFailureReason;
+});
+export interface ProgrammaticHarnessAdapter {
+    describe(): Promise<HarnessDescriptor>;
+    openSession(request: OpenHarnessSessionRequest): Promise<HarnessSessionRef>;
+    resumeSession(request: ResumeHarnessSessionRequest): Promise<HarnessSessionRef>;
+    runTurn(request: RunHarnessTurnRequest): AsyncIterable<HarnessEvent>;
+    cancelTurn(request: CancelHarnessTurnRequest): Promise<void>;
+    closeSession(request: CloseHarnessSessionRequest): Promise<void>;
+}
+export declare function assertHarnessSupport(descriptor: HarnessDescriptor, target: HarnessTarget, feature?: HarnessFeature): void;
+export declare const HARNESS_STATUS_MESSAGE_LIMIT: 240;
+export declare function createHarnessStatusEvent(event: HarnessStatusEvent): HarnessStatusEvent;
+export declare function createHarnessEvent(event: HarnessEvent): HarnessEvent;
+export {};
+//# sourceMappingURL=harness.d.ts.map

package/dist/harness.d.ts.map

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

package/dist/harness.js

@@ -0,0 +1,101 @@
+const FAILURE_MESSAGES = Object.freeze({
+    'unsupported-target': 'The harness does not support this target.',
+    'unsupported-feature': 'The harness does not support this feature.',
+    'invalid-request': 'The harness request is invalid.',
+    'authentication-required': 'The harness requires authentication.',
+    'provider-unavailable': 'The harness provider is unavailable.',
+    'session-not-found': 'The harness session was not found.',
+    'session-closed': 'The harness session is closed.',
+    'turn-not-found': 'The harness turn was not found.',
+    'turn-active': 'The harness session already has an active turn.',
+    timeout: 'The harness operation timed out.',
+    'provider-failed': 'The harness provider failed.',
+});
+export class HarnessError extends Error {
+    reason;
+    constructor(reason) {
+        super(FAILURE_MESSAGES[reason]);
+        this.name = 'HarnessError';
+        this.reason = reason;
+    }
+}
+export function assertHarnessSupport(descriptor, target, feature) {
+    if (!descriptor.targets.includes(target))
+        throw new HarnessError('unsupported-target');
+    if (feature !== undefined && !descriptor.features.includes(feature)) {
+        throw new HarnessError('unsupported-feature');
+    }
+}
+export const HARNESS_STATUS_MESSAGE_LIMIT = 240;
+function checkedSession(session) {
+    if (!isBoundedText(session.provider, 64) ||
+        !isBoundedText(session.sessionId, 1024) ||
+        !['local', 'cloud'].includes(session.target)) {
+        throw new HarnessError('invalid-request');
+    }
+    return Object.freeze({
+        provider: session.provider,
+        sessionId: session.sessionId,
+        target: session.target,
+    });
+}
+function isBoundedText(value, limit) {
+    return (typeof value === 'string' &&
+        value.length > 0 &&
+        value.length <= limit &&
+        [...value].every((character) => character.charCodeAt(0) > 31 && character.charCodeAt(0) !== 127));
+}
+// The adapter supplies a reviewed safe summary, never provider output or exception text.
+export function createHarnessStatusEvent(event) {
+    if (!['progress', 'tool'].includes(event.type) ||
+        !isBoundedText(event.message, HARNESS_STATUS_MESSAGE_LIMIT) ||
+        !isBoundedText(event.turnId, 128)) {
+        throw new HarnessError('invalid-request');
+    }
+    return Object.freeze({
+        type: event.type,
+        session: checkedSession(event.session),
+        turnId: event.turnId,
+        message: event.message,
+    });
+}
+// Runtime validator default for untrusted input; also proves compile-time exhaustiveness.
+function invalidHarnessEvent(_event) {
+    throw new HarnessError('invalid-request');
+}
+export function createHarnessEvent(event) {
+    const session = checkedSession(event.session);
+    if (event.type === 'session-started')
+        return Object.freeze({ type: event.type, session });
+    if (!isBoundedText(event.turnId, 128))
+        throw new HarnessError('invalid-request');
+    const ref = { session, turnId: event.turnId };
+    switch (event.type) {
+        case 'progress':
+        case 'tool':
+            return createHarnessStatusEvent(event);
+        case 'turn-started':
+        case 'completed':
+        case 'cancelled':
+            return Object.freeze({ type: event.type, ...ref });
+        case 'failed':
+            if (!Object.hasOwn(FAILURE_MESSAGES, event.reason))
+                throw new HarnessError('invalid-request');
+            return Object.freeze({ type: event.type, ...ref, reason: event.reason });
+        case 'usage':
+            if (!['tokens', 'requests'].includes(event.unit) ||
+                !Number.isSafeInteger(event.quantity) ||
+                event.quantity < 0) {
+                throw new HarnessError('invalid-request');
+            }
+            return Object.freeze({
+                type: event.type,
+                ...ref,
+                unit: event.unit,
+                quantity: event.quantity,
+            });
+        default:
+            return invalidHarnessEvent(event);
+    }
+}
+//# sourceMappingURL=harness.js.map

package/dist/harness.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,20 @@
+import { type CapabilityDefinition } from './core/contracts.js';
+import type { AuthorizationPort, ExecutionCaller } from './core/executor.js';
+import type { CapabilityRegistry } from './core/registry.js';
+export type HttpExecutionContext = {
+    readonly caller: ExecutionCaller;
+    readonly authorization: AuthorizationPort;
+};
+export type HttpAdapterOptions = {
+    readonly basePath?: string;
+    readonly maxRequestBytes?: number;
+    readonly deadlineMs?: number;
+    readonly resolveExecutionContext?: (request: Request) => HttpExecutionContext | Promise<HttpExecutionContext>;
+};
+export declare function httpInvocationPath(identityOrDefinition: CapabilityDefinition<unknown, unknown>['identity'] | CapabilityDefinition<unknown, unknown>, root?: string): string;
+export declare function httpQueryParameters(definition: CapabilityDefinition<unknown, unknown>, input: unknown): URLSearchParams;
+export declare function createOpenApiDocument(registry: CapabilityRegistry, options?: {
+    readonly basePath?: string;
+}): Readonly<Record<string, unknown>>;
+export declare function createHttpHandler(registry: CapabilityRegistry, options?: HttpAdapterOptions): (request: Request) => Promise<Response>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,oBAAoB,EAAyB,MAAM,qBAAqB,CAAC;AAGvF,OAAO,KAAK,EACV,iBAAiB,EAEjB,eAAe,EAEhB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAqB,kBAAkB,EAAmB,MAAM,oBAAoB,CAAC;AAyBjG,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CACjC,OAAO,EAAE,OAAO,KACb,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC3D,CAAC;AA0DF,wBAAgB,kBAAkB,CAChC,oBAAoB,EAChB,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC,GAClD,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,EAC1C,IAAI,GAAE,MAA0B,GAC/B,MAAM,CAQR;AAyJD,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,EAClD,KAAK,EAAE,OAAO,GACb,eAAe,CAwBjB;AAuDD,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,GAAE;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAC3C,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAqFnC;AA6GD,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,GAAE,kBAAuB,GAC/B,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CA+IzC"}