91 lines
3.2 KiB
TypeScript
91 lines
3.2 KiB
TypeScript
/**
|
|
* @fileoverview Frontend API client for external adapter management.
|
|
*/
|
|
|
|
import { api } from "./client";
|
|
|
|
/**
|
|
* The safe scalar login fields the server projects for an adapter that declares
|
|
* an interactive login capability. The projection carries no function member and
|
|
* no secret. The form reads it to pick the login flow and the login panel.
|
|
*/
|
|
export interface AdapterLoginProjection {
|
|
panelMode: "displayed_code" | "submitted_browser_code";
|
|
timeoutPolicy: "caller_bounded" | "fixed";
|
|
}
|
|
|
|
export interface AdapterCapabilities {
|
|
supportsInstructionsBundle: boolean;
|
|
supportsSkills: boolean;
|
|
supportsLocalAgentJwt: boolean;
|
|
requiresMaterializedRuntimeSkills: boolean;
|
|
supportsAcp: boolean;
|
|
/** Present only when the adapter declares an interactive login capability. */
|
|
login?: AdapterLoginProjection;
|
|
}
|
|
|
|
export interface AcpTargetDescriptor {
|
|
agentId: string;
|
|
skillsMode: "ephemeral" | "unsupported";
|
|
prerequisites: {
|
|
nodeRange?: string;
|
|
packages?: string[];
|
|
};
|
|
}
|
|
|
|
export interface AdapterInfo {
|
|
type: string;
|
|
label: string;
|
|
source: "builtin" | "external";
|
|
modelsCount: number;
|
|
loaded: boolean;
|
|
disabled: boolean;
|
|
capabilities: AdapterCapabilities;
|
|
acp?: AcpTargetDescriptor;
|
|
/** Installed version (for external npm adapters) */
|
|
version?: string;
|
|
/** Package name (for external adapters) */
|
|
packageName?: string;
|
|
/** Whether the adapter was installed from a local path (vs npm). */
|
|
isLocalPath?: boolean;
|
|
/** True when an external plugin has replaced a built-in adapter of the same type. */
|
|
overriddenBuiltin?: boolean;
|
|
/** True when the external override for a builtin type is currently paused. */
|
|
overridePaused?: boolean;
|
|
}
|
|
|
|
export interface AdapterInstallResult {
|
|
type: string;
|
|
packageName: string;
|
|
version?: string;
|
|
installedAt: string;
|
|
}
|
|
|
|
export const adaptersApi = {
|
|
/** List all registered adapters (built-in + external). */
|
|
list: () => api.get<AdapterInfo[]>("/adapters"),
|
|
|
|
/** Install an external adapter from npm or a local path. */
|
|
install: (params: { packageName: string; version?: string; isLocalPath?: boolean }) =>
|
|
api.post<AdapterInstallResult>("/adapters/install", params),
|
|
|
|
/** Remove an external adapter by type. */
|
|
remove: (type: string) => api.delete<{ type: string; removed: boolean }>(`/adapters/${type}`),
|
|
|
|
/** Enable or disable an adapter (disabled adapters hidden from agent menus). */
|
|
setDisabled: (type: string, disabled: boolean) =>
|
|
api.patch<{ type: string; disabled: boolean; changed: boolean }>(`/adapters/${type}`, { disabled }),
|
|
|
|
/** Pause or resume an external override of a builtin type. */
|
|
setOverridePaused: (type: string, paused: boolean) =>
|
|
api.patch<{ type: string; paused: boolean; changed: boolean }>(`/adapters/${type}/override`, { paused }),
|
|
|
|
/** Reload an external adapter (bust server + client caches). */
|
|
reload: (type: string) =>
|
|
api.post<{ type: string; version?: string; reloaded: boolean }>(`/adapters/${type}/reload`, {}),
|
|
|
|
/** Reinstall an npm-sourced adapter (pulls latest from registry, then reloads). */
|
|
reinstall: (type: string) =>
|
|
api.post<{ type: string; version?: string; reinstalled: boolean }>(`/adapters/${type}/reinstall`, {}),
|
|
};
|