@tai42/api-client 16.0.0 → 17.0.0

package/dist/client/manifest-client.d.ts

@@ -0,0 +1,354 @@
+import type { Transport } from './transport';
+/**
+ * Names to add to / remove from the manifest `api_tools` include and exclude
+ * lists (`POST /api/api-tools`). Each field is a bare name list; the server
+ * refuses a body whose four lists are all empty.
+ */
+export interface ApiToolsListsBody {
+    readonly include_add?: string[];
+    readonly include_remove?: string[];
+    readonly exclude_add?: string[];
+    readonly exclude_remove?: string[];
+}
+/**
+ * Body for the combined env+manifest secret op (POST `/api/mcp-config/secret-env`).
+ * The server generates the env key from `value` (shaping the name from `key_hint`),
+ * then writes the env value and the literal `!ENV ${KEY}` manifest leaf at
+ * `manifest_pointer` atomically. `manifest_pointer`'s head segment MUST be `mcp`
+ * (the server refuses any other with a loud 400).
+ */
+export interface SetMcpSecretEnvBody {
+    readonly value: string;
+    readonly key_hint: string;
+    readonly manifest_pointer: string;
+}
+export declare function manifestClient(t: Transport): {
+    getManifest: (signal?: AbortSignal) => Promise<{
+        mcp: {
+            [x: string]: unknown;
+            managed?: {
+                connection_id: string;
+                provider_id: string;
+                sub_service: string;
+            } | null | undefined;
+        }[];
+        user_tools: string[];
+    }>;
+    setMcpConfig: (mcp: unknown[]) => Promise<{
+        status: string;
+        env_keys: number;
+        fanout: {
+            mode: "local-only";
+            note: string;
+        } | {
+            op: string;
+            reachable: boolean;
+            local_only: boolean;
+            results: {
+                name: string;
+                outcome: "failed" | "resyncing" | "recycling" | "stale" | "applied" | "missing" | "departed" | "timed_out";
+                payload: unknown;
+                error: string | null;
+                detail: string | null;
+            }[];
+            error: string | null;
+            mode: "fleet";
+        } | {
+            op: string;
+            reachable: boolean;
+            local_only: boolean;
+            results: {
+                name: string;
+                outcome: "failed" | "resyncing" | "recycling" | "stale" | "applied" | "missing" | "departed" | "timed_out";
+                payload: unknown;
+                error: string | null;
+                detail: string | null;
+            }[];
+            error: string | null;
+            mode: "unreachable";
+        };
+    }>;
+    getMcpStatus: (signal?: AbortSignal) => Promise<{
+        bound: Record<string, string[]>;
+        failed: {
+            title: string;
+            status: string;
+        }[];
+    }>;
+    reloadMcp: (title: string) => Promise<{
+        op: string;
+        reachable: boolean;
+        local_only: boolean;
+        results: {
+            name: string;
+            outcome: "failed" | "resyncing" | "recycling" | "stale" | "applied" | "missing" | "departed" | "timed_out";
+            payload: unknown;
+            error: string | null;
+            detail: string | null;
+        }[];
+        error: string | null;
+    }>;
+    addToolsEntries: (entries: readonly unknown[], replace?: boolean) => Promise<{
+        status: string;
+        env_keys: number;
+        fanout: {
+            mode: "local-only";
+            note: string;
+        } | {
+            op: string;
+            reachable: boolean;
+            local_only: boolean;
+            results: {
+                name: string;
+                outcome: "failed" | "resyncing" | "recycling" | "stale" | "applied" | "missing" | "departed" | "timed_out";
+                payload: unknown;
+                error: string | null;
+                detail: string | null;
+            }[];
+            error: string | null;
+            mode: "fleet";
+        } | {
+            op: string;
+            reachable: boolean;
+            local_only: boolean;
+            results: {
+                name: string;
+                outcome: "failed" | "resyncing" | "recycling" | "stale" | "applied" | "missing" | "departed" | "timed_out";
+                payload: unknown;
+                error: string | null;
+                detail: string | null;
+            }[];
+            error: string | null;
+            mode: "unreachable";
+        };
+    }>;
+    removeToolsEntry: (title: string) => Promise<{
+        status: string;
+        env_keys: number;
+        fanout: {
+            mode: "local-only";
+            note: string;
+        } | {
+            op: string;
+            reachable: boolean;
+            local_only: boolean;
+            results: {
+                name: string;
+                outcome: "failed" | "resyncing" | "recycling" | "stale" | "applied" | "missing" | "departed" | "timed_out";
+                payload: unknown;
+                error: string | null;
+                detail: string | null;
+            }[];
+            error: string | null;
+            mode: "fleet";
+        } | {
+            op: string;
+            reachable: boolean;
+            local_only: boolean;
+            results: {
+                name: string;
+                outcome: "failed" | "resyncing" | "recycling" | "stale" | "applied" | "missing" | "departed" | "timed_out";
+                payload: unknown;
+                error: string | null;
+                detail: string | null;
+            }[];
+            error: string | null;
+            mode: "unreachable";
+        };
+    }>;
+    addAgentsEntries: (entries: readonly unknown[], replace?: boolean) => Promise<{
+        status: string;
+        env_keys: number;
+        fanout: {
+            mode: "local-only";
+            note: string;
+        } | {
+            op: string;
+            reachable: boolean;
+            local_only: boolean;
+            results: {
+                name: string;
+                outcome: "failed" | "resyncing" | "recycling" | "stale" | "applied" | "missing" | "departed" | "timed_out";
+                payload: unknown;
+                error: string | null;
+                detail: string | null;
+            }[];
+            error: string | null;
+            mode: "fleet";
+        } | {
+            op: string;
+            reachable: boolean;
+            local_only: boolean;
+            results: {
+                name: string;
+                outcome: "failed" | "resyncing" | "recycling" | "stale" | "applied" | "missing" | "departed" | "timed_out";
+                payload: unknown;
+                error: string | null;
+                detail: string | null;
+            }[];
+            error: string | null;
+            mode: "unreachable";
+        };
+    }>;
+    removeAgentsEntry: (title: string) => Promise<{
+        status: string;
+        env_keys: number;
+        fanout: {
+            mode: "local-only";
+            note: string;
+        } | {
+            op: string;
+            reachable: boolean;
+            local_only: boolean;
+            results: {
+                name: string;
+                outcome: "failed" | "resyncing" | "recycling" | "stale" | "applied" | "missing" | "departed" | "timed_out";
+                payload: unknown;
+                error: string | null;
+                detail: string | null;
+            }[];
+            error: string | null;
+            mode: "fleet";
+        } | {
+            op: string;
+            reachable: boolean;
+            local_only: boolean;
+            results: {
+                name: string;
+                outcome: "failed" | "resyncing" | "recycling" | "stale" | "applied" | "missing" | "departed" | "timed_out";
+                payload: unknown;
+                error: string | null;
+                detail: string | null;
+            }[];
+            error: string | null;
+            mode: "unreachable";
+        };
+    }>;
+    updateApiTools: (body: ApiToolsListsBody) => Promise<{
+        status: string;
+        env_keys: number;
+        fanout: {
+            mode: "local-only";
+            note: string;
+        } | {
+            op: string;
+            reachable: boolean;
+            local_only: boolean;
+            results: {
+                name: string;
+                outcome: "failed" | "resyncing" | "recycling" | "stale" | "applied" | "missing" | "departed" | "timed_out";
+                payload: unknown;
+                error: string | null;
+                detail: string | null;
+            }[];
+            error: string | null;
+            mode: "fleet";
+        } | {
+            op: string;
+            reachable: boolean;
+            local_only: boolean;
+            results: {
+                name: string;
+                outcome: "failed" | "resyncing" | "recycling" | "stale" | "applied" | "missing" | "departed" | "timed_out";
+                payload: unknown;
+                error: string | null;
+                detail: string | null;
+            }[];
+            error: string | null;
+            mode: "unreachable";
+        };
+    }>;
+    listFailedMcps: (signal?: AbortSignal) => Promise<{
+        op: string;
+        reachable: boolean;
+        local_only: boolean;
+        results: {
+            name: string;
+            outcome: "failed" | "resyncing" | "recycling" | "stale" | "applied" | "missing" | "departed" | "timed_out";
+            payload: unknown;
+            error: string | null;
+            detail: string | null;
+        }[];
+        error: string | null;
+    }>;
+    reloadFailedMcps: () => Promise<{
+        op: string;
+        reachable: boolean;
+        local_only: boolean;
+        results: {
+            name: string;
+            outcome: "failed" | "resyncing" | "recycling" | "stale" | "applied" | "missing" | "departed" | "timed_out";
+            payload: unknown;
+            error: string | null;
+            detail: string | null;
+        }[];
+        error: string | null;
+    }>;
+    deregisterMcp: (title: string) => Promise<{
+        op: string;
+        reachable: boolean;
+        local_only: boolean;
+        results: {
+            name: string;
+            outcome: "failed" | "resyncing" | "recycling" | "stale" | "applied" | "missing" | "departed" | "timed_out";
+            payload: unknown;
+            error: string | null;
+            detail: string | null;
+        }[];
+        error: string | null;
+    }>;
+};
+export declare function manifestSecretEnvClient(t: Transport): {
+    setMcpSecretEnv: (body: SetMcpSecretEnvBody) => Promise<{
+        status: string;
+        env_keys: number;
+        fanout: {
+            mode: "local-only";
+            note: string;
+        } | {
+            op: string;
+            reachable: boolean;
+            local_only: boolean;
+            results: {
+                name: string;
+                outcome: "failed" | "resyncing" | "recycling" | "stale" | "applied" | "missing" | "departed" | "timed_out";
+                payload: unknown;
+                error: string | null;
+                detail: string | null;
+            }[];
+            error: string | null;
+            mode: "fleet";
+        } | {
+            op: string;
+            reachable: boolean;
+            local_only: boolean;
+            results: {
+                name: string;
+                outcome: "failed" | "resyncing" | "recycling" | "stale" | "applied" | "missing" | "departed" | "timed_out";
+                payload: unknown;
+                error: string | null;
+                detail: string | null;
+            }[];
+            error: string | null;
+            mode: "unreachable";
+        };
+    }>;
+    getManifestPreserved: (signal?: AbortSignal) => Promise<{
+        mcp: {
+            [x: string]: unknown;
+            managed?: {
+                connection_id: string;
+                provider_id: string;
+                sub_service: string;
+            } | null | undefined;
+        }[];
+        user_tools: string[];
+    }>;
+    getMcpEnvRefs: (signal?: AbortSignal) => Promise<{
+        var: string;
+        pointer: string;
+        has_default: boolean;
+        set: boolean;
+    }[]>;
+};
+//# sourceMappingURL=manifest-client.d.ts.map

package/dist/client/manifest-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-client.d.ts","sourceRoot":"","sources":["../../src/client/manifest-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CACpC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS;2BAGhB,WAAW;;;;;;;;;;;wBACd,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAEL,WAAW;;;;;;;uBAChB,MAAM;;;;;;;;;;;;;+BAUE,SAAS,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAKnB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAIJ,SAAS,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BAKnB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAOV,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAgBd,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;2BAOd,MAAM;;;;;;;;;;;;;EAMhC;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,SAAS;4BAKxB,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCAKX,WAAW;;;;;;;;;;;6BAKlB,WAAW;;;;;;EAGvC"}

package/dist/client/manifest-client.js

@@ -0,0 +1,76 @@
+/** Manifest / MCP section, env-ref and config-reload sub-clients. */
+import { encodeSegment } from '../http';
+import * as s from '../schemas';
+export function manifestClient(t) {
+    const { req } = t;
+    return {
+        getManifest: (signal) => req('/api/manifest', s.manifestView, { signal }),
+        setMcpConfig: (mcp) => req('/api/mcp-config', s.reloadConfigResult, { method: 'POST', body: { mcp } }),
+        getMcpStatus: (signal) => req('/api/mcp-status', s.mcpStatus, { signal }),
+        reloadMcp: (title) => req(`/api/mcp-status/${encodeSegment(title)}/reload`, s.mcpReloadResult, {
+            method: 'POST',
+        }),
+        // Granular manifest-section entry edits — add/replace or remove ONE entry by
+        // title, leaving the rest of the section untouched (the surgical counterpart to
+        // the whole-section `setMcpConfig`). Each crosses the config pipeline and returns
+        // the shared apply-result (`status` + `env_keys` + fleet `fanout`). `replace` lets
+        // an entry whose title already exists swap in; without it a collision is refused.
+        addToolsEntries: (entries, replace = false) => req('/api/tools-config/entries', s.reloadConfigResult, {
+            method: 'POST',
+            body: { entries, replace },
+        }),
+        removeToolsEntry: (title) => req(`/api/tools-config/entries/${encodeSegment(title)}`, s.reloadConfigResult, {
+            method: 'DELETE',
+        }),
+        addAgentsEntries: (entries, replace = false) => req('/api/agents-config/entries', s.reloadConfigResult, {
+            method: 'POST',
+            body: { entries, replace },
+        }),
+        removeAgentsEntry: (title) => req(`/api/agents-config/entries/${encodeSegment(title)}`, s.reloadConfigResult, {
+            method: 'DELETE',
+        }),
+        // Edit the manifest `api_tools` include/exclude name lists by delta (add/remove
+        // names on either list). Absent fields default to empty; the server refuses a body
+        // whose four lists are all empty. Returns the shared apply-result.
+        updateApiTools: (body) => req('/api/api-tools', s.reloadConfigResult, {
+            method: 'POST',
+            body: {
+                include_add: body.include_add ?? [],
+                include_remove: body.include_remove ?? [],
+                exclude_add: body.exclude_add ?? [],
+                exclude_remove: body.exclude_remove ?? [],
+            },
+        }),
+        // The MCP servers skipped by the viability check, plus their remediation ops. The
+        // LIST rides the fleet fan-out primitive (each worker's failed roster arrives as
+        // its own report payload; `failedMcpsFromReport` unions them). Reload-all re-probes
+        // every failed server; deregister detaches one server's tools by title. Each op
+        // returns the bare per-worker `fleetResult`.
+        listFailedMcps: (signal) => req('/api/mcp-status/failed', s.fleetResult, { signal }),
+        reloadFailedMcps: () => req('/api/mcp-status/reload-failed', s.fleetResult, {
+            method: 'POST',
+            body: { targets: null },
+        }),
+        deregisterMcp: (title) => req(`/api/mcp-status/${encodeSegment(title)}/deregister`, s.fleetResult, {
+            method: 'POST',
+            body: { targets: null },
+        }),
+    };
+}
+export function manifestSecretEnvClient(t) {
+    const { req } = t;
+    return {
+        // The SecretRefField server half: one atomic env-value + `!ENV` manifest
+        // write, returning the shared apply-result shape (reload + fleet fanout).
+        setMcpSecretEnv: (body) => req('/api/mcp-config/secret-env', s.reloadConfigResult, { method: 'POST', body }),
+        // The PRESERVED manifest (`!ENV` markers intact, no resolved secrets) — the
+        // connectors page's McpServersSection reads this so round-trips never inline
+        // resolved values.
+        getManifestPreserved: (signal) => req('/api/manifest/preserved', s.manifestView, { signal }),
+        // The manifest MCP section's `!ENV ${VAR[:default]}` marker refs — NAMES and
+        // set/unset BOOLEANS only, never values. Drives the McpServersSection env-refs
+        // checklist on the connectors page.
+        getMcpEnvRefs: (signal) => req('/api/manifest/mcp-env-refs', s.mcpEnvRefs, { signal }),
+    };
+}
+//# sourceMappingURL=manifest-client.js.map

package/dist/client/manifest-client.js.map

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