@owlmeans/viable-sdk 0.1.18-rc.1

package/README.md

@@ -0,0 +1,128 @@
+# @owlmeans/viable-sdk
+
+Drive the OwlMeans Viable platform from outside it.
+
+Viable turns a description into a running full-stack application. This package is what lets
+something that is not the Viable manager do that: a coding agent through
+[`@owlmeans/viable-mcp`](../viable-mcp), a CLI, a test. It owns the four things such a client
+needs and the platform cannot supply:
+
+- **a client context** that authenticates with one long-lived access token and nothing else;
+- **a connector API** — one interface, two implementations, so a tool written against it works
+  both over HTTP and in-process;
+- **a session runtime** that answers the operations the platform sends: file writes, shell
+  commands and git against a project on the user's own machine;
+- **the tool catalogue and the model-task protocol** a parent agent reads — including the
+  questions the platform puts to a person, and the tools for converting an application that
+  already exists.
+
+## The two axes
+
+A session has a **target** and an **llm**, and they are independent.
+
+|  | `cloud` | `local` |
+|---|---|---|
+| **target** | the project lives in a Viable preview slot | the project lives in a directory here, and this package executes every command against it |
+| **llm** | Viable performs the model calls | the parent agent performs them, one at a time, in a clean subagent |
+
+## Using it
+
+```ts
+import {
+  makeSdkContext, makeRemoteConnectorApi, openSession
+} from '@owlmeans/viable-sdk'
+import { makeLocalSlotExecutor } from '@owlmeans/viable-sdk/executor'
+import { ConnectHarness, ConnectLlm, ConnectTarget } from '@owlmeans/viable-common'
+
+const context = await makeSdkContext({ apiUrl, token })
+const api = makeRemoteConnectorApi(context)
+
+const session = await openSession({
+  api,
+  executor: makeLocalSlotExecutor(projectDir),
+  open: {
+    projectDir,
+    target: ConnectTarget.Local,
+    llm: ConnectLlm.Cloud,
+    harness: ConnectHarness.Other,
+    clientVersion: '1.0.0',
+    capabilities: { harness: ConnectHarness.Other, tiers: {}, subagents: false, effortControl: false, executors: [] },
+  },
+})
+
+const job = await api.project.create('a tool for tracking gym workouts', ConnectTarget.Local)
+```
+
+The session runs its own loop from that point: operations arrive, the executor answers them, model
+tasks queue for the parent agent.
+
+## Rules worth knowing before you change something
+
+**Every tool answers within 45 seconds.** The strictest MCP host in the field bounds a tool call at
+sixty. Anything that takes minutes is a JOB: it returns at once and is polled. A tool that blocked
+would be reported to the user as a hung server rather than as a slow platform.
+
+**A tool that cannot work in a mode is hidden, not failing.** `visibleTools(host)` is the whole
+catalogue a parent sees, and it is exactly the set of things that work for it. A tool offered and
+then refused is one an agent tries once and remembers as broken.
+
+**The session loop is serial.** The thing on the other end of a local operation is a filesystem the
+platform believes it is the only writer of. Two concurrent template writes into one tree is not a
+throughput problem, it is a corrupted tree.
+
+**Results are cached by operation id.** A connector that reconnects is handed everything still
+outstanding, including what it had already answered when the connection dropped. Re-running a build
+because an acknowledgement was lost is exactly the cost that cache avoids.
+
+**A question is the user's, and the connector answers none of it.** An inquiry arrives on the
+same operation loop as everything else and is executed by nobody: `next_question` hands it to the
+parent to put to a person, and `answer_question` sends the answer back. The two queues stay
+separate from the task queue, because draining one list would sooner or later hand a decision
+about somebody's project to a subagent. Declining is an answer — a parent whose user is away says
+so rather than waiting out the deadline or inventing one.
+
+**A model task is handed over once.** The platform redelivers every unanswered operation on each
+poll, which is free for a slot command the result cache answers and expensive for a task a
+subagent is already working on. The shared queue remembers every id it has handed over and ignores
+a second delivery of one, while still refreshing the operation the answer must route to.
+
+**A malformed model-task answer is refused locally.** `parseTaskResult` checks the answer against
+the task before the platform ever sees it — with the subagent's context still open, so the parent
+can retry immediately. A malformed answer that reached the platform would cost a whole new task, a
+new subagent and another wait.
+
+**A refusal is phrased from its marker.** The platform's refusal classes live in packages this one
+does not depend on, so an error crossing the wire arrives as a marshalled `type|||marker|||stack`
+wrapped in a local stack trace. `REFUSALS` maps the marker to one sentence a parent agent can act
+on; an unknown marker keeps the marker and names the tool to call next, and no stack ever reaches
+the model — including the one shape with no separator in it, where `ResilientError.ensure` swaps a
+plain-text response body into `type` and its stack into `message`.
+
+**A refusal reads the same wherever it is rendered.** The same marker arrives thrown from a call
+and stored as text — `job.error`, `slot.lastError`, a conversion's `lastError`, a pipeline row's
+`error` — so every one of those goes through `refusalPhrase` too. Anything that is not a refusal,
+a build warning above all, is rendered exactly as it stands.
+
+**The harness installer never writes the token.** Each configuration references the environment
+variable in its own syntax, so what it writes is safe to commit. `tests/harness.spec.ts` greps
+every written file for a token shape.
+
+## Tests
+
+`bun test ./tests` — all offline.
+
+<!-- owlmeans:agent-guidance:start -->
+## Agent guidance
+
+This package ships embedded agent skills under `agent-meta/`. After installing your
+`@owlmeans/*` packages, run the OwlMeans agent-skills installer to place them into
+your project's skill store (`.agents/skills/`):
+
+```sh
+npx @owlmeans/agent-skills@^0.1.18-rc.13
+```
+
+The embedded files are version-matched to this package release. Do not edit them
+directly — they are regenerated on each publish. To contribute guidance edits,
+open a PR against the source monorepo.
+<!-- owlmeans:agent-guidance:end -->

package/build/api/index.d.ts

@@ -0,0 +1,2 @@
+export * from './remote.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/build/api/index.js

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

package/build/api/index.js.map

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

package/build/api/remote.d.ts

@@ -0,0 +1,14 @@
+import type { ClientConfig, ClientContext } from '@owlmeans/client-context';
+import type { ConnectorApi } from '../types.js';
+type Ctx = ClientContext<ClientConfig>;
+/**
+ * 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.
+ */
+export declare const makeRemoteConnectorApi: (context: Ctx) => ConnectorApi;
+export {};
+//# sourceMappingURL=remote.d.ts.map

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

@@ -0,0 +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;AAS3E,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,YAoIrD,CAAA"}

package/build/api/remote.js

@@ -0,0 +1,123 @@
+import { connectRef } from '@owlmeans/viable-common';
+import { TOOL_DEADLINE_MS } from '../consts.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.
+ */
+export const makeRemoteConnectorApi = (context) => {
+    return {
+        capabilities: async () => await context
+            .entrypoint(connectRef.capabilities).call({ timeout: TOOL_DEADLINE_MS }),
+        openSession: async (args) => {
+            const { llm, ...body } = args;
+            // Which route is called fixes the mode: the delegated one carries the entitlement gate.
+            return await context.entrypoint(llm === 'local'
+                ? connectRef.session.openDelegated : connectRef.session.open).call({ body, timeout: TOOL_DEADLINE_MS });
+        },
+        closeSession: async (sessionId) => {
+            await context.entrypoint(connectRef.session.close).call({
+                params: { sessionId }, timeout: TOOL_DEADLINE_MS,
+            });
+        },
+        heartbeat: async (sessionId) => await context.entrypoint(connectRef.session.heartbeat).call({
+            params: { sessionId }, timeout: TOOL_DEADLINE_MS,
+        }),
+        pullOps: async (sessionId, waitSec) => await context.entrypoint(connectRef.op.pull).call({
+            params: { sessionId },
+            query: { wait: waitSec },
+            // The long poll holds the response open on purpose; it must outlast its own wait.
+            timeout: (waitSec + 10) * 1000,
+        }),
+        submitOp: async (sessionId, result) => await context
+            .entrypoint(connectRef.op.submit).call({
+            params: { sessionId, opId: result.opId }, body: result,
+            timeout: TOOL_DEADLINE_MS,
+        }),
+        project: {
+            create: async (prompt, target) => await context.entrypoint(connectRef.project.create).call({
+                body: { prompt, ...(target != null ? { target } : {}) }, timeout: TOOL_DEADLINE_MS,
+            }),
+            confirm: async (id, edits) => await context.entrypoint(connectRef.project.confirm).call({
+                params: { id }, body: edits, timeout: TOOL_DEADLINE_MS,
+            }),
+            list: async () => await context.entrypoint(connectRef.project.list).call({ timeout: TOOL_DEADLINE_MS }),
+            status: async (id) => await context
+                .entrypoint(connectRef.project.status).call({ params: { id }, timeout: TOOL_DEADLINE_MS }),
+            attach: async (args) => await context.entrypoint(connectRef.project.attach).call({
+                body: args, timeout: TOOL_DEADLINE_MS,
+            }),
+            reinit: async (id) => await context
+                .entrypoint(connectRef.project.reinit).call({ params: { id }, timeout: TOOL_DEADLINE_MS }),
+            modify: async (id, prompt) => await context.entrypoint(connectRef.project.modify).call({
+                params: { id }, body: { prompt }, timeout: TOOL_DEADLINE_MS,
+            }),
+            job: async (id, jobId, waitSec) => await context
+                .entrypoint(connectRef.project.job).call({
+                params: { id, jobId },
+                query: waitSec == null ? {} : { wait: waitSec },
+                timeout: waitSec == null ? TOOL_DEADLINE_MS : (waitSec + 10) * 1000,
+            }),
+        },
+        story: {
+            list: async (id, query) => await context.entrypoint(connectRef.story.list).call({
+                params: { id }, query: query ?? {}, timeout: TOOL_DEADLINE_MS,
+            }),
+            get: async (id, storyId) => await context
+                .entrypoint(connectRef.story.get).call({ params: { id, storyId }, timeout: TOOL_DEADLINE_MS }),
+            create: async (id, story) => await context
+                .entrypoint(connectRef.story.create).call({ params: { id }, body: { story }, timeout: TOOL_DEADLINE_MS }),
+            update: async (id, storyId, story) => await context.entrypoint(connectRef.story.update).call({
+                params: { id, storyId }, body: { story }, timeout: TOOL_DEADLINE_MS,
+            }),
+            remove: async (id, storyId) => await context
+                .entrypoint(connectRef.story.delete).call({ params: { id, storyId }, timeout: TOOL_DEADLINE_MS }),
+            develop: async (id, storyId) => await context.entrypoint(connectRef.story.develop).call({
+                params: { id, storyId }, timeout: TOOL_DEADLINE_MS,
+            }),
+        },
+        files: {
+            list: async (id) => await context.entrypoint(connectRef.files.list).call({
+                params: { id }, timeout: TOOL_DEADLINE_MS,
+            }),
+        },
+        pipeline: {
+            state: async (id, runId) => await context
+                .entrypoint(connectRef.pipeline.state).call({ params: { id, runId }, timeout: TOOL_DEADLINE_MS }),
+            resume: async (id, runId, args) => await context.entrypoint(connectRef.pipeline.resume).call({
+                params: { id, runId }, body: args ?? {}, timeout: TOOL_DEADLINE_MS,
+            }),
+        },
+        convert: {
+            create: async (args) => await context.entrypoint(connectRef.convert.create).call({
+                body: args, timeout: TOOL_DEADLINE_MS,
+            }),
+            check: async (id) => await context
+                .entrypoint(connectRef.convert.check).call({ params: { id }, timeout: TOOL_DEADLINE_MS }),
+            start: async (id) => await context
+                .entrypoint(connectRef.convert.start).call({ params: { id }, timeout: TOOL_DEADLINE_MS }),
+            proceed: async (id, decision, note) => await context.entrypoint(connectRef.convert.proceed).call({
+                params: { id }, body: { decision, ...(note != null ? { note } : {}) },
+                timeout: TOOL_DEADLINE_MS,
+            }),
+            cancel: async (id) => await context
+                .entrypoint(connectRef.convert.cancel).call({ params: { id }, timeout: TOOL_DEADLINE_MS }),
+            status: async (id) => await context
+                .entrypoint(connectRef.convert.status).call({ params: { id }, timeout: TOOL_DEADLINE_MS }),
+            purge: async (id) => await context
+                .entrypoint(connectRef.convert.purge).call({ params: { id }, timeout: TOOL_DEADLINE_MS }),
+        },
+        inquiry: {
+            answer: async (id, inquiryId, answer) => 
+            // The id travels twice on purpose: in the path, which is what the route addresses, and in
+            // the body, which is what the platform validates the answer against.
+            await context.entrypoint(connectRef.inquiry.answer).call({
+                params: { id, inquiryId }, body: { ...answer, inquiryId }, timeout: TOOL_DEADLINE_MS,
+            }),
+        },
+    };
+};
+//# sourceMappingURL=remote.js.map

package/build/api/remote.js.map

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

package/build/consts.d.ts

@@ -0,0 +1,47 @@
+/** Where the connector reads its configuration from. Only the token is a secret. */
+export declare const ENV_TOKEN = "VIABLE_API_TOKEN";
+export declare const ENV_API_URL = "VIABLE_API_URL";
+export declare const ENV_TARGET = "VIABLE_TARGET";
+export declare const ENV_LLM = "VIABLE_LLM";
+export declare const ENV_HARNESS = "VIABLE_HARNESS";
+export declare const ENV_PROJECT_DIR = "VIABLE_PROJECT_DIR";
+/** The service alias the SDK's own client context registers under. */
+export declare const SDK_SERVICE = "viable-sdk";
+/**
+ * The longest any tool may take to answer.
+ *
+ * Every MCP host bounds a tool call, and the strictest default in the field is sixty seconds
+ * (Codex). Forty-five leaves room for the round trip and keeps the connector inside every host's
+ * ceiling without configuration — which is why long operations are JOBS that return at once and
+ * are polled, rather than calls that block.
+ */
+export declare const TOOL_DEADLINE_MS = 45000;
+/**
+ * The longest a job poll may hold its answer, in seconds.
+ *
+ * Strictly under {@link TOOL_DEADLINE_MS}, with room for the round trip. Set equal to it, a poll
+ * that used its whole window lost the race with its own deadline every time — and the tool's own
+ * "call this next" line suggested exactly that value, so an agent following the instructions it
+ * was given failed on every poll that ran the full window.
+ */
+export declare const JOB_POLL_MAX_SEC = 30;
+/** How long `next_task` waits before answering "nothing yet". Under every host's ceiling. */
+export declare const NEXT_TASK_WAIT_MS = 30000;
+/**
+ * How long `next_question` waits before answering "nothing yet".
+ *
+ * The same window as a model task's, and for the host's reasons rather than the person's: nobody
+ * is expected to answer inside it. What the wait buys is a parent that asked one call too early —
+ * the platform queues the question a moment after the job reported it — and what the ceiling buys
+ * is that the call returns before the host's own deadline turns it into a broken server.
+ */
+export declare const NEXT_QUESTION_WAIT_MS = 30000;
+/** How long a pull waits for an operation before answering empty. */
+export declare const PULL_WAIT_MS = 30000;
+/** How often a socket says it is still there. Presence outlives three missed pings. */
+export declare const PING_INTERVAL_MS = 30000;
+/** How long the socket handshake may take before the connector falls back to polling. */
+export declare const SOCKET_HANDSHAKE_MS = 10000;
+/** Reconnection backoff, in order. The last entry repeats. */
+export declare const RECONNECT_BACKOFF_MS: number[];
+//# sourceMappingURL=consts.d.ts.map

package/build/consts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,eAAO,MAAM,SAAS,qBAAqB,CAAA;AAC3C,eAAO,MAAM,WAAW,mBAAmB,CAAA;AAC3C,eAAO,MAAM,UAAU,kBAAkB,CAAA;AACzC,eAAO,MAAM,OAAO,eAAe,CAAA;AACnC,eAAO,MAAM,WAAW,mBAAmB,CAAA;AAC3C,eAAO,MAAM,eAAe,uBAAuB,CAAA;AAEnD,sEAAsE;AACtE,eAAO,MAAM,WAAW,eAAe,CAAA;AAEvC;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,QAAS,CAAA;AAEtC;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAElC,6FAA6F;AAC7F,eAAO,MAAM,iBAAiB,QAAS,CAAA;AAEvC;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,QAAS,CAAA;AAE3C,qEAAqE;AACrE,eAAO,MAAM,YAAY,QAAS,CAAA;AAElC,uFAAuF;AACvF,eAAO,MAAM,gBAAgB,QAAS,CAAA;AAEtC,yFAAyF;AACzF,eAAO,MAAM,mBAAmB,QAAS,CAAA;AAEzC,8DAA8D;AAC9D,eAAO,MAAM,oBAAoB,UAAwC,CAAA"}

package/build/consts.js

@@ -0,0 +1,47 @@
+/** Where the connector reads its configuration from. Only the token is a secret. */
+export const ENV_TOKEN = 'VIABLE_API_TOKEN';
+export const ENV_API_URL = 'VIABLE_API_URL';
+export const ENV_TARGET = 'VIABLE_TARGET';
+export const ENV_LLM = 'VIABLE_LLM';
+export const ENV_HARNESS = 'VIABLE_HARNESS';
+export const ENV_PROJECT_DIR = 'VIABLE_PROJECT_DIR';
+/** The service alias the SDK's own client context registers under. */
+export const SDK_SERVICE = 'viable-sdk';
+/**
+ * The longest any tool may take to answer.
+ *
+ * Every MCP host bounds a tool call, and the strictest default in the field is sixty seconds
+ * (Codex). Forty-five leaves room for the round trip and keeps the connector inside every host's
+ * ceiling without configuration — which is why long operations are JOBS that return at once and
+ * are polled, rather than calls that block.
+ */
+export const TOOL_DEADLINE_MS = 45_000;
+/**
+ * The longest a job poll may hold its answer, in seconds.
+ *
+ * Strictly under {@link TOOL_DEADLINE_MS}, with room for the round trip. Set equal to it, a poll
+ * that used its whole window lost the race with its own deadline every time — and the tool's own
+ * "call this next" line suggested exactly that value, so an agent following the instructions it
+ * was given failed on every poll that ran the full window.
+ */
+export const JOB_POLL_MAX_SEC = 30;
+/** How long `next_task` waits before answering "nothing yet". Under every host's ceiling. */
+export const NEXT_TASK_WAIT_MS = 30_000;
+/**
+ * How long `next_question` waits before answering "nothing yet".
+ *
+ * The same window as a model task's, and for the host's reasons rather than the person's: nobody
+ * is expected to answer inside it. What the wait buys is a parent that asked one call too early —
+ * the platform queues the question a moment after the job reported it — and what the ceiling buys
+ * is that the call returns before the host's own deadline turns it into a broken server.
+ */
+export const NEXT_QUESTION_WAIT_MS = 30_000;
+/** How long a pull waits for an operation before answering empty. */
+export const PULL_WAIT_MS = 30_000;
+/** How often a socket says it is still there. Presence outlives three missed pings. */
+export const PING_INTERVAL_MS = 30_000;
+/** How long the socket handshake may take before the connector falls back to polling. */
+export const SOCKET_HANDSHAKE_MS = 10_000;
+/** Reconnection backoff, in order. The last entry repeats. */
+export const RECONNECT_BACKOFF_MS = [1_000, 2_000, 5_000, 10_000, 30_000];
+//# sourceMappingURL=consts.js.map

package/build/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,CAAC,MAAM,SAAS,GAAG,kBAAkB,CAAA;AAC3C,MAAM,CAAC,MAAM,WAAW,GAAG,gBAAgB,CAAA;AAC3C,MAAM,CAAC,MAAM,UAAU,GAAG,eAAe,CAAA;AACzC,MAAM,CAAC,MAAM,OAAO,GAAG,YAAY,CAAA;AACnC,MAAM,CAAC,MAAM,WAAW,GAAG,gBAAgB,CAAA;AAC3C,MAAM,CAAC,MAAM,eAAe,GAAG,oBAAoB,CAAA;AAEnD,sEAAsE;AACtE,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAA;AAEvC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAA;AAEtC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAA;AAElC,6FAA6F;AAC7F,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAA;AAEvC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAA;AAE3C,qEAAqE;AACrE,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAA;AAElC,uFAAuF;AACvF,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAA;AAEtC,yFAAyF;AACzF,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAA;AAEzC,8DAA8D;AAC9D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA"}

package/build/context/index.d.ts

@@ -0,0 +1,22 @@
+import type { ClientConfig, ClientContext } from '@owlmeans/client-context';
+import { connect } from '@owlmeans/viable-common';
+export interface SdkContextOptions {
+    apiUrl: string;
+    token: string;
+    /** The service alias the API is registered under. One deployment, one alias. */
+    service?: string;
+}
+/**
+ * A client context that speaks to a viable deployment with one access token.
+ *
+ * The same machinery a browser uses — the API client, the entrypoint registry, the auth
+ * middleware — with one difference: the guard holds a long-lived credential the user was handed
+ * instead of a session it negotiated. Registering it under the alias the routes already name is
+ * what makes every unchanged route declaration work from a process that has no browser.
+ *
+ * There is deliberately no second credential path. A connector that could fall back to some other
+ * form of authentication would be a connector whose access nobody can revoke by revoking a token.
+ */
+export declare const makeSdkContext: (opts: SdkContextOptions) => Promise<ClientContext<ClientConfig>>;
+export { connect };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAM3E,OAAO,EAAE,OAAO,EAA4C,MAAM,yBAAyB,CAAA;AAY3F,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,SAAgB,iBAAiB,KAAG,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAsEjG,CAAA;AAED,OAAO,EAAE,OAAO,EAAE,CAAA"}

package/build/context/index.js

@@ -0,0 +1,92 @@
+import { AppType } from '@owlmeans/context';
+import { makeClientContext } from '@owlmeans/client-context';
+import { elevate } from '@owlmeans/client-entrypoint';
+import { entrypoint } from '@owlmeans/entrypoint';
+import { route } from '@owlmeans/route';
+import { authMiddleware, DEFAULT_GUARD } from '@owlmeans/auth-common';
+import { makeTokenCarrierGuard } from '@owlmeans/auth-token';
+import { connect, connectEntrypoints, CONNECT_TOKEN_PREFIX } from '@owlmeans/viable-common';
+import { SDK_SERVICE } from '../consts.js';
+import { SdkAuthError, SdkMisconfigured } from '../errors.js';
+/**
+ * The platform's websocket namespace, which the connector's socket route is declared under.
+ *
+ * A literal because it belongs to manager-api: the contract package takes it as a parameter for
+ * exactly this reason, so that neither end has to import the other's constants.
+ */
+const UPDATE_BASE = 'viable:manager-api:update:base';
+/**
+ * A client context that speaks to a viable deployment with one access token.
+ *
+ * The same machinery a browser uses — the API client, the entrypoint registry, the auth
+ * middleware — with one difference: the guard holds a long-lived credential the user was handed
+ * instead of a session it negotiated. Registering it under the alias the routes already name is
+ * what makes every unchanged route declaration work from a process that has no browser.
+ *
+ * There is deliberately no second credential path. A connector that could fall back to some other
+ * form of authentication would be a connector whose access nobody can revoke by revoking a token.
+ */
+export const makeSdkContext = async (opts) => {
+    if (opts.token === '') {
+        throw new SdkMisconfigured('token');
+    }
+    if (!opts.token.startsWith(CONNECT_TOKEN_PREFIX)) {
+        // Refused here rather than at the first call: a value that is not one of this platform's
+        // tokens produces a 401 with nothing in it about which of the several plausible mistakes was
+        // made, and the answer is always the same one — that is not the token you were given.
+        throw new SdkAuthError(`prefix:${CONNECT_TOKEN_PREFIX}`);
+    }
+    const service = opts.service ?? 'viable-manager-api';
+    const url = new URL(opts.apiUrl);
+    // NOT `addWebService`: that names the backend service as `cfg.webService`, which is the alias of
+    // the API CLIENT rather than of the backend — the entrypoint handler resolves
+    // `context.service(cfg.webService)` and would look for a service registered under the backend's
+    // name, failing every call with `Service <name> not found`. Left unset, `appendApiClient` inside
+    // `makeClientContext` claims it for the client it registers, and the backend descriptor below is
+    // reached through the route's own address because it is this context's default backend.
+    const cfg = {
+        ready: false,
+        service: SDK_SERVICE,
+        type: AppType.Frontend,
+        layer: undefined,
+        services: {
+            [service]: {
+                service,
+                type: AppType.Backend,
+                host: url.hostname,
+                ...(url.port !== '' ? { port: Number(url.port) } : {}),
+                base: url.pathname === '/' ? undefined : url.pathname.replace(/^\/|\/$/g, ''),
+                secure: url.protocol === 'https:',
+                default: true,
+            },
+        },
+    };
+    const context = makeClientContext(cfg);
+    context.registerService(makeTokenCarrierGuard(DEFAULT_GUARD, {
+        token: opts.token,
+        // The scheme the platform's own guard claims first; `Bearer` is accepted too, and is what a
+        // host configured with a bare URL will send.
+        scheme: 'auth-token',
+    }));
+    context.registerMiddleware(authMiddleware);
+    const surface = connectEntrypoints({
+        guard: DEFAULT_GUARD,
+        updateBase: UPDATE_BASE,
+    });
+    // The socket route hangs under the platform's own websocket base, so that base has to exist
+    // here too — a parent a registry cannot resolve fails the whole context at init, not the one
+    // call that would have used it. Declared with the path the platform declares, never elevated:
+    // it is a namespace, and nothing calls it.
+    const parent = entrypoint(route(UPDATE_BASE, '/update'));
+    const entrypoints = [parent, ...surface];
+    // Client elevation is what makes an alias callable from this side — the same list the server
+    // mounts, so a path or a schema cannot be right on one end and wrong on the other.
+    for (const declared of surface) {
+        elevate(entrypoints, declared.route.route.alias);
+    }
+    context.registerEntrypoints(entrypoints);
+    await context.configure().init();
+    return context;
+};
+export { connect };
+//# sourceMappingURL=index.js.map

package/build/context/index.js.map

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

package/build/errors.d.ts

@@ -0,0 +1,21 @@
+import { ResilientError } from '@owlmeans/error';
+export declare class SdkError extends ResilientError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/** The token is absent, malformed, or was refused. */
+export declare class SdkAuthError extends SdkError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/** The connector was started without something it cannot work out for itself. */
+export declare class SdkMisconfigured extends SdkError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/** A tool was called in a mode where it cannot work — a local operation on a cloud target. */
+export declare class SdkUnsupported extends SdkError {
+    static typeName: string;
+    constructor(message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/build/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,qBAAa,QAAS,SAAQ,cAAc;IAC1C,OAAuB,QAAQ,SAAwC;IAEvE,YAAY,OAAO,GAAE,MAAgB,EAEpC;CACF;AAED,sDAAsD;AACtD,qBAAa,YAAa,SAAQ,QAAQ;IACxC,OAAuB,QAAQ,SAA6B;IAE5D,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF;AAED,iFAAiF;AACjF,qBAAa,gBAAiB,SAAQ,QAAQ;IAC5C,OAAuB,QAAQ,SAAsC;IAErE,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF;AAED,8FAA8F;AAC9F,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,OAAuB,QAAQ,SAAoC;IAEnE,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF"}

package/build/errors.js

@@ -0,0 +1,36 @@
+import { ResilientError } from '@owlmeans/error';
+export class SdkError extends ResilientError {
+    static typeName = `ViableSdk${ResilientError.typeName}`;
+    constructor(message = 'error') {
+        super(SdkError.typeName, `viable-sdk:${message}`);
+    }
+}
+/** The token is absent, malformed, or was refused. */
+export class SdkAuthError extends SdkError {
+    static typeName = `Auth${SdkError.typeName}`;
+    constructor(message = 'error') {
+        super(`auth:${message}`);
+        this.type = SdkAuthError.typeName;
+    }
+}
+/** The connector was started without something it cannot work out for itself. */
+export class SdkMisconfigured extends SdkError {
+    static typeName = `Misconfigured${SdkError.typeName}`;
+    constructor(message = 'error') {
+        super(`misconfigured:${message}`);
+        this.type = SdkMisconfigured.typeName;
+    }
+}
+/** A tool was called in a mode where it cannot work — a local operation on a cloud target. */
+export class SdkUnsupported extends SdkError {
+    static typeName = `Unsupported${SdkError.typeName}`;
+    constructor(message = 'error') {
+        super(`unsupported:${message}`);
+        this.type = SdkUnsupported.typeName;
+    }
+}
+ResilientError.registerErrorClass(SdkError);
+ResilientError.registerErrorClass(SdkAuthError);
+ResilientError.registerErrorClass(SdkMisconfigured);
+ResilientError.registerErrorClass(SdkUnsupported);
+//# sourceMappingURL=errors.js.map

package/build/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,MAAM,OAAO,QAAS,SAAQ,cAAc;IACnC,MAAM,CAAU,QAAQ,GAAG,YAAY,cAAc,CAAC,QAAQ,EAAE,CAAA;IAEvE,YAAY,OAAO,GAAW,OAAO;QACnC,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,cAAc,OAAO,EAAE,CAAC,CAAA;IACnD,CAAC;CACF;AAED,sDAAsD;AACtD,MAAM,OAAO,YAAa,SAAQ,QAAQ;IACjC,MAAM,CAAU,QAAQ,GAAG,OAAO,QAAQ,CAAC,QAAQ,EAAE,CAAA;IAE5D,YAAY,OAAO,GAAW,OAAO;QACnC,KAAK,CAAC,QAAQ,OAAO,EAAE,CAAC,CAAA;QACxB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAA;IACnC,CAAC;CACF;AAED,iFAAiF;AACjF,MAAM,OAAO,gBAAiB,SAAQ,QAAQ;IACrC,MAAM,CAAU,QAAQ,GAAG,gBAAgB,QAAQ,CAAC,QAAQ,EAAE,CAAA;IAErE,YAAY,OAAO,GAAW,OAAO;QACnC,KAAK,CAAC,iBAAiB,OAAO,EAAE,CAAC,CAAA;QACjC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC,QAAQ,CAAA;IACvC,CAAC;CACF;AAED,8FAA8F;AAC9F,MAAM,OAAO,cAAe,SAAQ,QAAQ;IACnC,MAAM,CAAU,QAAQ,GAAG,cAAc,QAAQ,CAAC,QAAQ,EAAE,CAAA;IAEnE,YAAY,OAAO,GAAW,OAAO;QACnC,KAAK,CAAC,eAAe,OAAO,EAAE,CAAC,CAAA;QAC/B,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAA;IACrC,CAAC;CACF;AAED,cAAc,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAA;AAC3C,cAAc,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAA;AAC/C,cAAc,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAA;AACnD,cAAc,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAA"}