@tai42/api-client 16.0.1 → 17.1.1

package/src/client/login-client.ts

@@ -1,6 +1,11 @@
 /** Public sign-in aggregator and session-logout sub-clients. */
+import {
+  ApiError,
+  ApiLoginFailedError,
+  ApiSetupFailedError,
+  ApiUnauthorizedError,
+} from '../errors';
 import * as s from '../schemas';
-import { ApiError, ApiLoginFailedError, ApiUnauthorizedError } from '../errors';
 import type { Transport } from './transport';
 
 /**
@@ -22,9 +27,9 @@ export function isSafeApiPath(path: string): boolean {
  *
  * A transport 401 arrives as `ApiUnauthorizedError` before any body is read, so
  * its message is generic by construction; the domain 4xx statuses carry the
- * server's informative envelope text (rate-limit, bootstrap-already-initialized,
- * password-policy, or the claim exchange's uniform "unknown or already used"
- * 404) straight through to the inline surface.
+ * server's informative envelope text (rate-limit, password-policy, or the claim
+ * exchange's uniform "unknown or already used" 404) straight through to the
+ * inline surface.
  */
 function asLoginError(error: unknown): never {
   if (error instanceof ApiUnauthorizedError) {
@@ -44,6 +49,29 @@ function asLoginError(error: unknown): never {
   throw error;
 }
 
+/**
+ * Map a transport error from the setup submission onto an `ApiSetupFailedError`
+ * (rendered inline on the setup entry, keyed on `status`) or rethrow it unchanged
+ * (schema drift, network, any other status — the generic failure branch surfaces
+ * it loudly). The mapped statuses are the setup door's own: 403/429 (a bad or
+ * throttled token — no oracle), 409 (already initialized), 501 (setup
+ * unsupported), and 400/422 (an invalid body).
+ */
+function asSetupError(error: unknown): never {
+  if (
+    error instanceof ApiError &&
+    (error.status === 400 ||
+      error.status === 403 ||
+      error.status === 409 ||
+      error.status === 422 ||
+      error.status === 429 ||
+      error.status === 501)
+  ) {
+    throw new ApiSetupFailedError(error.message, error.status);
+  }
+  throw error;
+}
+
 export function loginClient(t: Transport) {
   const { req } = t;
   return {
@@ -93,6 +121,19 @@ export function loginClient(t: Transport) {
         return asLoginError(error);
       }
     },
+    // Initialize the deployment: create the owner principal, mint the owner's
+    // first key (returned once), and optionally attach the owner's login. PUBLIC
+    // (anonymous — no credential exists yet). A refused/throttled token, an
+    // already-initialized deployment, an unsupported setup door, or an invalid
+    // body becomes an inline `ApiSetupFailedError`; any other failure rethrows
+    // loudly.
+    submitSetup: async (body: s.SetupBody) => {
+      try {
+        return await req('/api/setup', s.setupResult, { method: 'POST', body });
+      } catch (error) {
+        return asSetupError(error);
+      }
+    },
   };
 }
 

package/src/client/manifest-client.ts

@@ -1,6 +1,6 @@
 /** Manifest / MCP section, env-ref and config-reload sub-clients. */
-import * as s from '../schemas';
 import { encodeSegment } from '../http';
+import * as s from '../schemas';
 import type { Transport } from './transport';
 
 /**

package/src/client/marketplace-client.ts

@@ -1,6 +1,6 @@
 /** Marketplace search, install, update and advisory sub-client. */
-import * as s from '../schemas';
 import { encodeSegment } from '../http';
+import * as s from '../schemas';
 import type { Transport } from './transport';
 
 /**

package/src/client/observability-client.ts

@@ -1,6 +1,6 @@
 /** Run metrics, listing, trace and export sub-client. */
-import * as s from '../schemas';
 import { apiDownload, encodeSegment, type RequestOptions } from '../http';
+import * as s from '../schemas';
 import type { Transport } from './transport';
 
 /** The observability-metrics window + bucket size (GET query params). */

package/src/client/policy-client.ts

@@ -1,6 +1,6 @@
 /** Access-policy validation, versioning and rollback sub-client. */
-import * as s from '../schemas';
 import { encodeSegment } from '../http';
+import * as s from '../schemas';
 import type { Transport } from './transport';
 
 /**

package/src/client/presets-client.ts

@@ -1,6 +1,6 @@
 /** Preset CRUD, versioning and validation sub-client. */
-import * as s from '../schemas';
 import { encodeSegment } from '../http';
+import * as s from '../schemas';
 import type { Transport } from './transport';
 
 /**

package/src/client/profiles-client.ts

@@ -1,6 +1,6 @@
 /** Settings-profile CRUD, versioning and apply sub-client. */
-import * as s from '../schemas';
 import { encodeSegment } from '../http';
+import * as s from '../schemas';
 import type { Transport } from './transport';
 
 export function profilesClient(t: Transport) {

package/src/client/schedules-client.ts

@@ -1,6 +1,6 @@
 /** Schedule listing and mutation sub-client. */
-import * as s from '../schemas';
 import { encodeSegment } from '../http';
+import * as s from '../schemas';
 import type { Transport } from './transport';
 
 export function schedulesClient(t: Transport) {

package/src/client/states-client.ts

@@ -1,6 +1,6 @@
 /** State declaration, record, template and consumer sub-client. */
-import * as s from '../schemas';
 import { encodeSegment } from '../http';
+import * as s from '../schemas';
 import type { Transport } from './transport';
 
 /**

package/src/client/storage-client.ts

@@ -1,6 +1,6 @@
 /** Storage resource CRUD sub-client. */
-import * as s from '../schemas';
 import { apiDownload, isUnsafePathSegment } from '../http';
+import * as s from '../schemas';
 import type { Transport } from './transport';
 
 /**

package/src/client/sub-mcp-client.ts

@@ -1,6 +1,6 @@
 /** Sub-MCP mount registry sub-client. */
-import * as s from '../schemas';
 import { encodeSegment } from '../http';
+import * as s from '../schemas';
 import type { Transport } from './transport';
 
 export function subMcpClient(t: Transport) {

package/src/client/system-client.ts

@@ -1,6 +1,6 @@
 /** System health and pluggable-kind status sub-client. */
-import * as s from '../schemas';
 import { apiText } from '../http';
+import * as s from '../schemas';
 import type { Transport } from './transport';
 
 export function systemClient(t: Transport) {

package/src/client/tool-extensions-client.ts

@@ -1,6 +1,6 @@
 /** Tool extension listing and authoring sub-client. */
-import * as s from '../schemas';
 import { encodeSegment } from '../http';
+import * as s from '../schemas';
 import type { Transport } from './transport';
 
 export function toolExtensionsClient(t: Transport) {

package/src/client/tool-meta-client.ts

@@ -1,6 +1,6 @@
 /** Tool-organization overlay (folders and meta) sub-client. */
-import * as s from '../schemas';
 import { encodeSegment } from '../http';
+import * as s from '../schemas';
 import type { Transport } from './transport';
 
 /**

package/src/client/tools-client.ts

@@ -1,6 +1,6 @@
 /** Tool catalog, run, live-registry admin and tag sub-client. */
-import * as s from '../schemas';
 import { encodeSegment } from '../http';
+import * as s from '../schemas';
 import { getToolRun, listToolRuns, submitToolRun, type SubmitToolRunArgs } from '../tool-runs';
 import type { Transport } from './transport';
 

package/src/client/trigger-links-client.ts

@@ -1,6 +1,6 @@
 /** Trigger-link mint, listing and revoke sub-client. */
-import * as s from '../schemas';
 import { encodeSegment } from '../http';
+import * as s from '../schemas';
 import type { Transport } from './transport';
 
 /**

package/src/client/web-entry-gate-client.ts

@@ -1,6 +1,6 @@
 /** Web-channel entry-gate sub-client. */
-import * as s from '../schemas';
 import { encodeSegment } from '../http';
+import * as s from '../schemas';
 import type { Transport } from './transport';
 
 /**

package/src/errors.ts

@@ -71,6 +71,22 @@ export class ApiLoginFailedError extends Error {
   }
 }
 
+/**
+ * A setup attempt was REJECTED — a bad or throttled token (403/429), an
+ * already-initialized deployment (409), an unsupported setup door (501), or an
+ * invalid body (400/422). Like {@link ApiLoginFailedError} it is NOT an
+ * ApiUnauthorizedError: it renders inline on the setup entry, keyed on `status`
+ * so the page shows the right copy, never a global unauthorized redirect.
+ */
+export class ApiSetupFailedError extends Error {
+  readonly status: number;
+  constructor(message: string, status: number) {
+    super(message);
+    this.name = 'ApiSetupFailedError';
+    this.status = status;
+  }
+}
+
 /**
  * The response body did not match its declared zod schema. This is a contract
  * drift between the Studio and the skeleton — a loud, visible error, never a

package/src/generated/served-schemas.ts

@@ -18,6 +18,9 @@ export type MediaKind = z.infer<typeof mediaKind>;
 export const mediaItem = z.object({ "caption": z.union([z.string(), z.null()]).default(null), "filename": z.union([z.string(), z.null()]).default(null), "kind": mediaKind, "url": z.string() });
 export type MediaItem = z.infer<typeof mediaItem>;
 
+export const overlapPolicy = z.object({ "deliver": z.enum(["one","all"]).default("one"), "running": z.enum(["continue","cancel"]).default("continue"), "settle_seconds": z.number().int().gte(0).lte(30).default(0) });
+export type OverlapPolicy = z.infer<typeof overlapPolicy>;
+
 export const presetSeedToolMeta = z.object({ "display_name": z.union([z.string(), z.null()]).default(null), "folder_path": z.union([z.string(), z.null()]).default(null), "tags": z.union([z.array(z.string()), z.null()]).default(null) });
 export type PresetSeedToolMeta = z.infer<typeof presetSeedToolMeta>;
 
@@ -95,10 +98,10 @@ export const channelTemplate = z.object({ "body_parameters": z.array(z.string())
   })).default([]), "header_media": z.union([mediaItem, z.null()]).default(null), "language": z.string(), "name": z.string() });
 export type ChannelTemplate = z.infer<typeof channelTemplate>;
 
-export const conversationRoute = z.object({ "callback_secret": z.union([z.string(), z.null()]).default(null), "callback_url": z.union([z.string(), z.null()]).default(null), "channel": z.union([z.string(), z.null()]).default(null), "door": z.enum(["api","channel"]), "error_reply_text": z.union([z.string().min(1).max(2000), z.null()]).default(null), "execution_key": z.string().min(1), "execution_key_fingerprint": z.string().min(1), "initial_mode": z.enum(["agent","manual"]).default("agent"), "locale": z.union([z.string(), z.null()]).default(null), "our_identity": z.union([z.string(), z.null()]).default(null), "payload_expr": z.union([templatedText, z.null()]).default(null), "reply_expr": z.union([templatedText, z.null()]).default(null), "route_name": z.string(), "target_kind": z.enum(["agent","tool"]), "target_name": z.string().min(1), "turns_per_hour_override": z.union([z.number().int().gt(0), z.null()]).default(null) });
+export const conversationRoute = z.object({ "callback_secret": z.union([z.string(), z.null()]).default(null), "callback_url": z.union([z.string(), z.null()]).default(null), "channel": z.union([z.string(), z.null()]).default(null), "door": z.enum(["api","channel"]), "error_reply_text": z.union([z.string().min(1).max(2000), z.null()]).default(null), "execution_key": z.string().min(1), "execution_key_fingerprint": z.string().min(1), "initial_mode": z.enum(["agent","manual"]).default("agent"), "locale": z.union([z.string(), z.null()]).default(null), "our_identity": z.union([z.string(), z.null()]).default(null), "overlap": overlapPolicy.default({"deliver":"one","running":"continue","settle_seconds":0}), "payload_expr": z.union([templatedText, z.null()]).default(null), "reply_expr": z.union([templatedText, z.null()]).default(null), "route_name": z.string(), "target_kind": z.enum(["agent","tool"]), "target_name": z.string().min(1), "turns_per_hour_override": z.union([z.number().int().gt(0), z.null()]).default(null) });
 export type ConversationRoute = z.infer<typeof conversationRoute>;
 
-export const conversationRouteCreate = z.object({ "callback_url": z.union([z.string(), z.null()]).default(null), "channel": z.union([z.string(), z.null()]).default(null), "door": z.enum(["api","channel"]), "error_reply_text": z.union([z.string().min(1).max(2000), z.null()]).default(null), "execution_key": z.string().min(1), "initial_mode": z.enum(["agent","manual"]).default("agent"), "locale": z.union([z.string(), z.null()]).default(null), "our_identity": z.union([z.string(), z.null()]).default(null), "payload_expr": z.union([templatedText, z.null()]).default(null), "reply_expr": z.union([templatedText, z.null()]).default(null), "route_name": z.string(), "target_kind": z.enum(["agent","tool"]), "target_name": z.string().min(1), "turns_per_hour_override": z.union([z.number().int().gt(0), z.null()]).default(null) });
+export const conversationRouteCreate = z.object({ "callback_url": z.union([z.string(), z.null()]).default(null), "channel": z.union([z.string(), z.null()]).default(null), "door": z.enum(["api","channel"]), "error_reply_text": z.union([z.string().min(1).max(2000), z.null()]).default(null), "execution_key": z.string().min(1), "initial_mode": z.enum(["agent","manual"]).default("agent"), "locale": z.union([z.string(), z.null()]).default(null), "our_identity": z.union([z.string(), z.null()]).default(null), "overlap": overlapPolicy.default({"deliver":"one","running":"continue","settle_seconds":0}), "payload_expr": z.union([templatedText, z.null()]).default(null), "reply_expr": z.union([templatedText, z.null()]).default(null), "route_name": z.string(), "target_kind": z.enum(["agent","tool"]), "target_name": z.string().min(1), "turns_per_hour_override": z.union([z.number().int().gt(0), z.null()]).default(null) });
 export type ConversationRouteCreate = z.infer<typeof conversationRouteCreate>;
 
 export const hookParams = z.object({ "condition": z.union([templatedText, z.null()]).default(null), "execution_key": z.string().min(1), "execution_key_fingerprint": z.string().min(1), "expr": z.union([templatedText, z.null()]).default(null), "name": z.string().min(1), "state_binding": z.union([stateBinding, z.null()]).default(null), "subject": z.union([hookSubject, z.null()]).default(null), "tool": z.string().min(1), "tool_kwargs": z.record(z.string(), z.unknown()).default({}), "topic": z.string().min(1) });