@owlmeans/viable-sdk 0.1.18-rc.9 → 0.1.18

package/build/api/collect/types.d.ts

@@ -0,0 +1,30 @@
+import type { EntrypointTransport } from '@owlmeans/entrypoint';
+export interface CallCollectOptions {
+    /**
+     * Whether this context runs in the DELEGATED mode (`llm=local`). Only then is a write named with
+     * `x-viable-call` and an early `{ pending }` answer collected; otherwise every call passes through
+     * to the API client untouched.
+     */
+    delegated: boolean;
+}
+/**
+ * The SDK context's HTTP transport — ONE seam in front of the API client that every bound route
+ * goes through, the connector routes and the planning client alike.
+ *
+ * In the delegated mode a write may wait on a model call the connector's own parent performs, which
+ * outlasts what an edge holds a response open. So every non-GET request carries `x-viable-call:
+ * <uuid>` (kept when the request already names one, so a retry reuses it), and an answer `{ pending:
+ * <that id> }` is turned into `connect.call.collect` long polls until the call settles: its value
+ * resolves the original call exactly as a direct answer would have, its marshalled error is rethrown
+ * as its own class, and a lost call throws `ConnectCallLost`. Any other answer is returned as is.
+ */
+export interface CallCollectTransport extends EntrypointTransport {
+    /** Whether writes are named and collected — the delegated mode. */
+    readonly delegated: boolean;
+}
+/** A collected call's answer, as the original entrypoint would have resolved. */
+export interface CollectedCall {
+    value: unknown;
+    outcome: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/api/collect/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/api/collect/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAE/D,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D,mEAAmE;IACnE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED,iFAAiF;AACjF,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB"}

package/build/api/collect/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/api/collect/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/api/collect/types.ts"],"names":[],"mappings":""}

package/build/api/collect.d.ts

@@ -0,0 +1,14 @@
+import type { CallCollectOptions, CallCollectTransport } from './collect/types.js';
+import type { Ctx } from './types.local.js';
+/**
+ * The SDK context's HTTP transport: request now, collect later — see {@link CallCollectTransport}.
+ *
+ * Registered under `transportAlias('http')`, which every client entrypoint asks for before it
+ * reaches for the API client, so the connector routes and the planning client get it with no
+ * per-method code. It forwards to the context's API client (the service `cfg.webService` names),
+ * resolved per call.
+ */
+export declare const createCallCollectTransport: (opts: CallCollectOptions) => CallCollectTransport;
+/** Register the call-collect transport on an SDK context — before its `init()`. */
+export declare const appendCallCollectTransport: <T extends Ctx>(context: T, opts: CallCollectOptions) => T;
+//# sourceMappingURL=collect.d.ts.map

package/build/api/collect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../src/api/collect.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAiB,MAAM,oBAAoB,CAAA;AACjG,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAW3C;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,SAAU,kBAAkB,KAAG,oBAgHrE,CAAA;AAED,mFAAmF;AACnF,eAAO,MAAM,0BAA0B,GAAI,CAAC,SAAS,GAAG,WAAW,CAAC,QAAQ,kBAAkB,KAAG,CAIhG,CAAA"}

package/build/api/collect.js

@@ -0,0 +1,132 @@
+import { randomUUID } from 'node:crypto';
+import { DEFAULT_ALIAS } from '@owlmeans/api';
+import { DEFAULT_KEY } from '@owlmeans/client-config';
+import { assertContext, createService } from '@owlmeans/context';
+import { EntrypointOutcome, provideResponse, transportAlias, } from '@owlmeans/entrypoint';
+import { ResilientError } from '@owlmeans/error';
+import { RouteMethod, RouteProtocols } from '@owlmeans/route';
+import { CONNECT_CALL_COLLECT_WAIT_SEC, CONNECT_CALL_HEADER, ConnectCallLost, ConnectCallState, connectRef, } from '@owlmeans/viable-common';
+import { SdkUnsupported } from '../errors.js';
+import { AXIOS_TIMEOUT_CODE, COLLECT_DROPPED_HOPS, COLLECT_DROPPED_STATUSES, COLLECT_FAST_MS, COLLECT_HOP_TIMEOUT_MS, COLLECT_PAUSE_MS, } from './consts.local.js';
+import { transportHelper } from './transport.js';
+/** A pause that a caller's abort cuts short. */
+const pause = async (ms, signal) => await new Promise(resolve => {
+    const timer = setTimeout(resolve, ms);
+    signal?.addEventListener('abort', () => {
+        clearTimeout(timer);
+        resolve();
+    }, { once: true });
+});
+/**
+ * The SDK context's HTTP transport: request now, collect later — see {@link CallCollectTransport}.
+ *
+ * Registered under `transportAlias('http')`, which every client entrypoint asks for before it
+ * reaches for the API client, so the connector routes and the planning client get it with no
+ * per-method code. It forwards to the context's API client (the service `cfg.webService` names),
+ * resolved per call.
+ */
+export const createCallCollectTransport = (opts) => {
+    const location = 'viable-sdk:call-collect-transport';
+    const contextOf = () => assertContext(transport.ctx, location);
+    /** The API client this transport stands in front of — what an entrypoint would have called. */
+    const apiOf = (context) => {
+        const named = context.cfg.webService;
+        const alias = typeof named === 'string' ? named : named?.[DEFAULT_KEY] ?? DEFAULT_ALIAS;
+        return context.service(alias);
+    };
+    /** A write is anything but a GET: only a write can wait on a model call. */
+    const writes = (context, alias) => (context.entrypoint(alias).route.route.method ?? RouteMethod.GET) !== RouteMethod.GET;
+    /**
+     * The call's id, written onto the request itself: a request that already names one keeps it, so
+     * a retry of the same request is the same call to the platform.
+     */
+    const nameCall = (req) => {
+        const existing = Object.entries(req.headers ?? {})
+            .find(([key]) => key.toLowerCase() === CONNECT_CALL_HEADER)?.[1];
+        const named = Array.isArray(existing) ? existing[0] : existing;
+        const callId = typeof named === 'string' && named !== '' ? named : randomUUID();
+        req.headers = req.headers ?? {};
+        req.headers[CONNECT_CALL_HEADER] = callId;
+        return callId;
+    };
+    const pendingFor = (value, callId) => value != null && typeof value === 'object' && value.pending === callId;
+    /** A hop the line dropped rather than the platform refused — asked again, since a collect is a read. */
+    const dropped = (e) => transportHelper.isTransientTransportError(e)
+        || e?.code === AXIOS_TIMEOUT_CODE
+        || COLLECT_DROPPED_STATUSES.has(e?.responseStatus ?? 0);
+    const collect = async (context, callId, signal) => {
+        let drops = 0;
+        for (;;) {
+            const started = Date.now();
+            let result;
+            try {
+                result = await context.entrypoint(connectRef.call.collect).call({
+                    params: { callId },
+                    query: { wait: CONNECT_CALL_COLLECT_WAIT_SEC },
+                    timeout: COLLECT_HOP_TIMEOUT_MS,
+                    ...(signal != null ? { signal } : {}),
+                });
+                drops = 0;
+            }
+            catch (e) {
+                if (signal?.aborted === true || !dropped(e) || ++drops > COLLECT_DROPPED_HOPS)
+                    throw e;
+                continue;
+            }
+            switch (result.state) {
+                case ConnectCallState.Settled:
+                    if (result.error != null && result.error !== '') {
+                        // The class the call itself would have thrown — rebuilt from its marshalled form.
+                        throw ResilientError.ensure(result.error);
+                    }
+                    return { value: result.value ?? null, outcome: result.outcome ?? EntrypointOutcome.Ok };
+                case ConnectCallState.Lost:
+                    throw new ConnectCallLost(callId);
+                case ConnectCallState.Pending:
+                    if (Date.now() - started < COLLECT_FAST_MS)
+                        await pause(COLLECT_PAUSE_MS, signal);
+                    continue;
+                default:
+                    throw new SdkUnsupported(`call-state:${String(result.state)}`);
+            }
+        }
+    };
+    const handle = async (req, res) => {
+        const context = contextOf();
+        const api = apiOf(context);
+        if (!opts.delegated || !writes(context, req.alias)) {
+            await api.handler(req, res);
+            return;
+        }
+        const callId = nameCall(req);
+        const first = provideResponse();
+        await api.handler(req, first);
+        if (first.error != null) {
+            res.reject(first.error);
+            return;
+        }
+        if (!pendingFor(first.value, callId)) {
+            res.resolve(first.value, first.outcome);
+            return;
+        }
+        try {
+            const settled = await collect(context, callId, req.signal);
+            res.resolve(settled.value, settled.outcome);
+        }
+        catch (e) {
+            res.reject(e);
+        }
+    };
+    const transport = createService(transportAlias(RouteProtocols.WEB), {
+        protocol: RouteProtocols.WEB,
+        delegated: opts.delegated,
+        handle: handle,
+    });
+    return transport;
+};
+/** Register the call-collect transport on an SDK context — before its `init()`. */
+export const appendCallCollectTransport = (context, opts) => {
+    context.registerService(createCallCollectTransport(opts));
+    return context;
+};
+//# sourceMappingURL=collect.js.map

package/build/api/collect.js.map

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

package/build/api/consts.local.d.ts

@@ -0,0 +1,21 @@
+export declare const TRANSIENT_TRANSPORT_CODES: Set<string>;
+/**
+ * A collect hop's HTTP deadline: the hold the platform answers within, plus room for the round trip
+ * — a quiet hop must never read as a dropped line.
+ */
+export declare const COLLECT_HOP_TIMEOUT_MS: number;
+/**
+ * How many collect hops in a row may DROP (a reset, a timeout, an edge's 502/503/504) before the
+ * call's own promise gives up. A collect is a read, so a dropped hop is simply asked again; a
+ * platform that stays unreachable is a failure the parent should hear about.
+ */
+export declare const COLLECT_DROPPED_HOPS = 3;
+/** The statuses an edge answers when it, not the platform, dropped a held response. */
+export declare const COLLECT_DROPPED_STATUSES: Set<number>;
+/** The code axios rejects a request with when its own deadline fired. */
+export declare const AXIOS_TIMEOUT_CODE = "ECONNABORTED";
+/** A `pending` answered faster than this was not held, so the next hop waits {@link COLLECT_PAUSE_MS} first. */
+export declare const COLLECT_FAST_MS = 1000;
+/** The rest after an unheld `pending`, so a platform that answers at once is not asked in a hot loop. */
+export declare const COLLECT_PAUSE_MS = 1000;
+//# sourceMappingURL=consts.local.d.ts.map

package/build/api/consts.local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.local.d.ts","sourceRoot":"","sources":["../../src/api/consts.local.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,yBAAyB,aAGpC,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,QAA8C,CAAA;AAEjF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAErC,uFAAuF;AACvF,eAAO,MAAM,wBAAwB,aAA2B,CAAA;AAEhE,yEAAyE;AACzE,eAAO,MAAM,kBAAkB,iBAAiB,CAAA;AAEhD,gHAAgH;AAChH,eAAO,MAAM,eAAe,OAAQ,CAAA;AAEpC,yGAAyG;AACzG,eAAO,MAAM,gBAAgB,OAAQ,CAAA"}

package/build/api/consts.local.js

@@ -0,0 +1,25 @@
+import { CONNECT_CALL_COLLECT_WAIT_SEC } from '@owlmeans/viable-common';
+export const TRANSIENT_TRANSPORT_CODES = new Set([
+    'ECONNRESET', 'ECONNREFUSED', 'EPIPE', 'ETIMEDOUT', 'UND_ERR_CONNECT_TIMEOUT',
+    'UND_ERR_HEADERS_TIMEOUT', 'UND_ERR_SOCKET',
+]);
+/**
+ * A collect hop's HTTP deadline: the hold the platform answers within, plus room for the round trip
+ * — a quiet hop must never read as a dropped line.
+ */
+export const COLLECT_HOP_TIMEOUT_MS = (CONNECT_CALL_COLLECT_WAIT_SEC + 10) * 1000;
+/**
+ * How many collect hops in a row may DROP (a reset, a timeout, an edge's 502/503/504) before the
+ * call's own promise gives up. A collect is a read, so a dropped hop is simply asked again; a
+ * platform that stays unreachable is a failure the parent should hear about.
+ */
+export const COLLECT_DROPPED_HOPS = 3;
+/** The statuses an edge answers when it, not the platform, dropped a held response. */
+export const COLLECT_DROPPED_STATUSES = new Set([502, 503, 504]);
+/** The code axios rejects a request with when its own deadline fired. */
+export const AXIOS_TIMEOUT_CODE = 'ECONNABORTED';
+/** A `pending` answered faster than this was not held, so the next hop waits {@link COLLECT_PAUSE_MS} first. */
+export const COLLECT_FAST_MS = 1_000;
+/** The rest after an unheld `pending`, so a platform that answers at once is not asked in a hot loop. */
+export const COLLECT_PAUSE_MS = 1_000;
+//# sourceMappingURL=consts.local.js.map

package/build/api/consts.local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.local.js","sourceRoot":"","sources":["../../src/api/consts.local.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAA;AAEvE,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAC;IAC/C,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,EAAE,yBAAyB;IAC7E,yBAAyB,EAAE,gBAAgB;CAC5C,CAAC,CAAA;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,6BAA6B,GAAG,EAAE,CAAC,GAAG,IAAI,CAAA;AAEjF;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAA;AAErC,uFAAuF;AACvF,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;AAEhE,yEAAyE;AACzE,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAA;AAEhD,gHAAgH;AAChH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAA;AAEpC,yGAAyG;AACzG,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAA"}

package/build/api/index.d.ts

@@ -1,2 +1,7 @@
 export * from './remote.js';
+export type * from './types.js';
+export * from './transport.js';
+export * from './collect.js';
+export type * from './collect/types.js';
+export type * from './transport/types.js';
 //# sourceMappingURL=index.d.ts.map

package/build/api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,mBAAmB,YAAY,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,mBAAmB,oBAAoB,CAAA;AACvC,mBAAmB,sBAAsB,CAAA"}

package/build/api/index.js

@@ -1,2 +1,4 @@
 export * from './remote.js';
+export * from './transport.js';
+export * from './collect.js';
 //# sourceMappingURL=index.js.map

package/build/api/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAE3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA"}

package/build/api/remote.d.ts

@@ -1,14 +1,21 @@
-import type { ClientConfig, ClientContext } from '@owlmeans/client-context';
 import type { ConnectorApi } from '../types.js';
-type Ctx = ClientContext<ClientConfig>;
+import type { Ctx } from './types.local.js';
+import type { RemoteConnectorOptions } from './types.js';
 /**
  * The connector API over HTTP.
  *
  * Every call is bounded by the tool deadline rather than left to the transport's own default: a
  * tool that outlives its host's ceiling is reported to the user as a broken server, and the true
- * answer — the platform was slow — never reaches them. Anything that legitimately takes longer is
- * a job, and a job returns at once.
+ * answer — the platform was slow — never reaches them. Long work returns its current domain status.
+ * In the delegated mode a write may wait on a model call the connector's own parent performs; the
+ * context's transport names it and collects an early `{ pending }` answer, so the deadline bounds
+ * each request and collect hop, never the call (and its tool answers before the call ends: the
+ * handover).
+ *
+ * `planning` is the facade `makeSdkContext` registered with `appendPlanningClient`: its reads and
+ * its execute POST carry the same tool deadline, and a commit is awaited by long polls whose HTTP
+ * deadline outlasts their own hold by ten seconds. Its scope is empty on purpose — the platform
+ * reads the organization and the profile from the token.
  */
-export declare const makeRemoteConnectorApi: (context: Ctx) => ConnectorApi;
-export {};
+export declare const makeRemoteConnectorApi: (context: Ctx, opts?: RemoteConnectorOptions) => ConnectorApi;
 //# sourceMappingURL=remote.d.ts.map

package/build/api/remote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../src/api/remote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAQ3E,OAAO,KAAK,EAAE,YAAY,EAA6C,MAAM,aAAa,CAAA;AAE1F,KAAK,GAAG,GAAG,aAAa,CAAC,YAAY,CAAC,CAAA;AAEtC;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,YAAa,GAAG,KAAG,YA+FrD,CAAA"}
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../src/api/remote.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAiC,MAAM,aAAa,CAAA;AAC9E,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAGxD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,sBAAsB,YAAa,GAAG,SAAQ,sBAAsB,KAAQ,YAgXxF,CAAA"}