@newheap/platform-ai-chat 0.1.0

package/admin/index.d.ts

@@ -0,0 +1,294 @@
+import * as _angular_core from '@angular/core';
+import { NhAssistantStore, NhAssistantError, ApplicationContext, ApplicationContextVersion, AdminAgent, ToolCatalogEntry, McpServer, AssistantAutonomy, McpServerTestResult, McpAuthMode, McpToolEffect, McpTool } from '@newheap/platform-ai-chat';
+
+type NhAssistantAdminTab = 'context' | 'agents' | 'mcp-servers';
+/**
+ * The assistant administration page with the tabs Context, Agents and MCP servers. The host
+ * routes to it and guards the route with its admin permission; the component additionally
+ * shows a no-access state unless the server reports `canAdminister`.
+ */
+declare class NhAssistantAdminComponent {
+    private readonly host;
+    readonly store: NhAssistantStore;
+    /** Tab shown first. */
+    readonly initialTab: _angular_core.InputSignal<NhAssistantAdminTab>;
+    readonly id: string;
+    readonly tabs: readonly NhAssistantAdminTab[];
+    readonly activeTab: _angular_core.WritableSignal<NhAssistantAdminTab | null>;
+    readonly ready: _angular_core.WritableSignal<boolean>;
+    constructor();
+    selected(): NhAssistantAdminTab;
+    select(tab: NhAssistantAdminTab): void;
+    /** Arrow keys, Home and End move between tabs as the ARIA tabs pattern describes. */
+    onTabKeydown(event: KeyboardEvent): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NhAssistantAdminComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NhAssistantAdminComponent, "nh-assistant-admin", never, { "initialTab": { "alias": "initialTab"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/** Maximum length of the application context and of agent instructions. */
+declare const NH_ASSISTANT_MAX_INSTRUCTIONS = 20000;
+/**
+ * Editor of the application context: the current version with its hash, optimistic
+ * concurrency through `expectedVersion`, and the version history.
+ */
+declare class NhAssistantAdminContextComponent {
+    private readonly admin;
+    private subscription?;
+    readonly id: string;
+    readonly max = 20000;
+    readonly loading: _angular_core.WritableSignal<boolean>;
+    readonly loadFailed: _angular_core.WritableSignal<boolean>;
+    readonly saving: _angular_core.WritableSignal<boolean>;
+    readonly saved: _angular_core.WritableSignal<boolean>;
+    readonly conflict: _angular_core.WritableSignal<boolean>;
+    readonly error: _angular_core.WritableSignal<NhAssistantError | null>;
+    readonly context: _angular_core.WritableSignal<ApplicationContext | null>;
+    readonly versions: _angular_core.WritableSignal<ApplicationContextVersion[]>;
+    readonly text: _angular_core.WritableSignal<string>;
+    readonly tooLong: _angular_core.Signal<boolean>;
+    readonly dirty: _angular_core.Signal<boolean>;
+    readonly canSave: _angular_core.Signal<boolean>;
+    readonly errorKeys: _angular_core.Signal<string[]>;
+    readonly history: _angular_core.Signal<ApplicationContextVersion[]>;
+    constructor();
+    /** Loads the latest version; with `keepDraft` the user's unsaved text stays in the editor. */
+    load(keepDraft: boolean): void;
+    onInput(event: Event): void;
+    save(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NhAssistantAdminContextComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NhAssistantAdminContextComponent, "nh-assistant-admin-context", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Agent administration: code agents (override, disable, reset) and agents created here
+ * (edit, disable, delete). Editing opens `nh-assistant-admin-agent-editor`.
+ */
+declare class NhAssistantAdminAgentsComponent {
+    private readonly admin;
+    private readonly store;
+    private subscription?;
+    private actionSubscription?;
+    readonly id: string;
+    readonly loading: _angular_core.WritableSignal<boolean>;
+    readonly loadFailed: _angular_core.WritableSignal<boolean>;
+    readonly agents: _angular_core.WritableSignal<AdminAgent[]>;
+    readonly tools: _angular_core.WritableSignal<ToolCatalogEntry[]>;
+    readonly servers: _angular_core.WritableSignal<McpServer[]>;
+    /** `undefined`: list; `null`: new agent; an agent: editing that agent. */
+    readonly editing: _angular_core.WritableSignal<AdminAgent | null | undefined>;
+    readonly confirming: _angular_core.WritableSignal<{
+        agentId: string;
+        action: "delete" | "reset";
+    } | null>;
+    readonly busyAgentId: _angular_core.WritableSignal<string | null>;
+    readonly error: _angular_core.WritableSignal<NhAssistantError | null>;
+    readonly errorKeys: _angular_core.Signal<string[]>;
+    constructor();
+    load(): void;
+    create(): void;
+    edit(agent: AdminAgent): void;
+    onSaved(agent: AdminAgent): void;
+    setEnabled(agent: AdminAgent, isEnabled: boolean): void;
+    confirm(agentId: string, action: 'delete' | 'reset'): void;
+    isConfirming(agentId: string, action: 'delete' | 'reset'): boolean;
+    reset(agent: AdminAgent): void;
+    remove(agent: AdminAgent): void;
+    private run;
+    private replace;
+    /** Agent changes affect the agent picker of the panel. */
+    private refreshChat;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NhAssistantAdminAgentsComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NhAssistantAdminAgentsComponent, "nh-assistant-admin-agents", never, {}, {}, never, never, true, never>;
+}
+
+/** True when a tool id matches a selector glob (`*` matches any characters). */
+declare function nhAssistantSelectorMatches(toolId: string, selector: string): boolean;
+/**
+ * Creates or edits one agent: texts, autonomy, policy, tool selectors chosen from the tool
+ * catalog or typed as patterns, and assigned MCP servers.
+ */
+declare class NhAssistantAdminAgentEditorComponent {
+    private readonly admin;
+    private subscription?;
+    /** The agent to edit, or null for a new agent. */
+    readonly agent: _angular_core.InputSignal<AdminAgent | null>;
+    readonly tools: _angular_core.InputSignal<readonly ToolCatalogEntry[]>;
+    readonly servers: _angular_core.InputSignal<readonly McpServer[]>;
+    readonly saved: _angular_core.OutputEmitterRef<AdminAgent>;
+    readonly cancelled: _angular_core.OutputEmitterRef<void>;
+    readonly id: string;
+    readonly max = 20000;
+    readonly autonomyLevels: readonly AssistantAutonomy[];
+    readonly agentId: _angular_core.WritableSignal<string>;
+    readonly displayName: _angular_core.WritableSignal<string>;
+    readonly description: _angular_core.WritableSignal<string>;
+    readonly instructions: _angular_core.WritableSignal<string>;
+    readonly autonomy: _angular_core.WritableSignal<AssistantAutonomy>;
+    readonly requiredPolicy: _angular_core.WritableSignal<string>;
+    readonly isEnabled: _angular_core.WritableSignal<boolean>;
+    readonly toolSelectors: _angular_core.WritableSignal<string[]>;
+    readonly mcpServerIds: _angular_core.WritableSignal<string[]>;
+    readonly newSelector: _angular_core.WritableSignal<string>;
+    readonly catalogFilter: _angular_core.WritableSignal<string>;
+    readonly submitted: _angular_core.WritableSignal<boolean>;
+    readonly saving: _angular_core.WritableSignal<boolean>;
+    readonly error: _angular_core.WritableSignal<NhAssistantError | null>;
+    readonly isNew: _angular_core.Signal<boolean>;
+    readonly idInvalid: _angular_core.Signal<boolean>;
+    readonly nameMissing: _angular_core.Signal<boolean>;
+    readonly tooLong: _angular_core.Signal<boolean>;
+    readonly selectorInvalid: _angular_core.Signal<boolean>;
+    readonly valid: _angular_core.Signal<boolean>;
+    readonly errorKeys: _angular_core.Signal<string[]>;
+    readonly filteredTools: _angular_core.Signal<ToolCatalogEntry[]>;
+    readonly matchCount: _angular_core.Signal<number>;
+    constructor();
+    isSelected(toolId: string): boolean;
+    isCovered(toolId: string): boolean;
+    toggleTool(toolId: string, checked: boolean): void;
+    addSelector(): void;
+    onSelectorKeydown(event: KeyboardEvent): void;
+    removeSelector(selector: string): void;
+    toggleServer(serverId: string, checked: boolean): void;
+    value(event: Event): string;
+    checked(event: Event): boolean;
+    save(): void;
+    private reset;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NhAssistantAdminAgentEditorComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NhAssistantAdminAgentEditorComponent, "nh-assistant-admin-agent-editor", never, { "agent": { "alias": "agent"; "required": false; "isSignal": true; }; "tools": { "alias": "tools"; "required": false; "isSignal": true; }; "servers": { "alias": "servers"; "required": false; "isSignal": true; }; }, { "saved": "saved"; "cancelled": "cancelled"; }, never, never, true, never>;
+}
+
+/** Result of the latest connection test per server. */
+interface TestState {
+    running: boolean;
+    result: McpServerTestResult | null;
+}
+/**
+ * MCP server administration: list, connection test, tool sync, the server editor and the
+ * tool table of one server.
+ */
+declare class NhAssistantAdminMcpServersComponent {
+    private readonly admin;
+    private subscription?;
+    private readonly actions;
+    readonly id: string;
+    readonly loading: _angular_core.WritableSignal<boolean>;
+    readonly loadFailed: _angular_core.WritableSignal<boolean>;
+    readonly servers: _angular_core.WritableSignal<McpServer[]>;
+    /** `undefined`: list; `null`: new server; a server: editing that server. */
+    readonly editing: _angular_core.WritableSignal<McpServer | null | undefined>;
+    readonly toolsOf: _angular_core.WritableSignal<McpServer | null>;
+    readonly tests: _angular_core.WritableSignal<Record<string, TestState>>;
+    readonly confirmingDelete: _angular_core.WritableSignal<string | null>;
+    readonly error: _angular_core.WritableSignal<NhAssistantError | null>;
+    readonly errorKeys: _angular_core.Signal<string[]>;
+    constructor();
+    load(): void;
+    /** Reloads the list silently, for example after a sync changed the sync status. */
+    refresh(): void;
+    create(): void;
+    edit(server: McpServer): void;
+    onSaved(server: McpServer): void;
+    test(server: McpServer): void;
+    testState(serverId: string): TestState | null;
+    testErrorKeys(code: string | null): string[];
+    remove(server: McpServer): void;
+    private setTest;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NhAssistantAdminMcpServersComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NhAssistantAdminMcpServersComponent, "nh-assistant-admin-mcp-servers", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * What happens to the stored secret on save. `keep` omits `secret`, `replace` sends the
+ * new value and `clear` sends `""`. The stored value is never shown.
+ */
+type NhAssistantSecretAction = 'keep' | 'replace' | 'clear';
+/** Creates or edits one MCP server with a write-only secret. */
+declare class NhAssistantAdminMcpServerEditorComponent {
+    private readonly admin;
+    private subscription?;
+    /** The server to edit, or null for a new server. */
+    readonly server: _angular_core.InputSignal<McpServer | null>;
+    readonly saved: _angular_core.OutputEmitterRef<McpServer>;
+    readonly cancelled: _angular_core.OutputEmitterRef<void>;
+    readonly id: string;
+    readonly authModes: readonly McpAuthMode[];
+    readonly serverId: _angular_core.WritableSignal<string>;
+    readonly displayName: _angular_core.WritableSignal<string>;
+    readonly url: _angular_core.WritableSignal<string>;
+    readonly authMode: _angular_core.WritableSignal<McpAuthMode>;
+    readonly headerName: _angular_core.WritableSignal<string>;
+    readonly requiredPolicy: _angular_core.WritableSignal<string>;
+    readonly isEnabled: _angular_core.WritableSignal<boolean>;
+    readonly secretAction: _angular_core.WritableSignal<NhAssistantSecretAction>;
+    /** The new secret while typing. Never filled from the server. */
+    readonly secret: _angular_core.WritableSignal<string>;
+    readonly submitted: _angular_core.WritableSignal<boolean>;
+    readonly saving: _angular_core.WritableSignal<boolean>;
+    readonly error: _angular_core.WritableSignal<NhAssistantError | null>;
+    readonly isNew: _angular_core.Signal<boolean>;
+    readonly hasSecret: _angular_core.Signal<boolean>;
+    readonly usesSecret: _angular_core.Signal<boolean>;
+    readonly showSecretInput: _angular_core.Signal<boolean>;
+    readonly idInvalid: _angular_core.Signal<boolean>;
+    readonly nameMissing: _angular_core.Signal<boolean>;
+    readonly urlInvalid: _angular_core.Signal<boolean>;
+    readonly valid: _angular_core.Signal<boolean>;
+    readonly errorKeys: _angular_core.Signal<string[]>;
+    constructor();
+    value(event: Event): string;
+    checked(event: Event): boolean;
+    setSecretAction(action: NhAssistantSecretAction): void;
+    onSecretInput(event: Event): void;
+    save(): void;
+    private reset;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NhAssistantAdminMcpServerEditorComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NhAssistantAdminMcpServerEditorComponent, "nh-assistant-admin-mcp-server-editor", never, { "server": { "alias": "server"; "required": false; "isSignal": true; }; }, { "saved": "saved"; "cancelled": "cancelled"; }, never, never, true, never>;
+}
+
+/** Unsaved changes of one tool row. */
+interface ToolDraft {
+    isEnabled: boolean;
+    effect: McpToolEffect;
+    descriptionOverride: string;
+}
+/**
+ * The tools of one MCP server. Every tool starts disabled as a change that needs approval;
+ * the administrator enables it and chooses the effect. Remote annotations appear as hints
+ * only, and a changed remote input schema is shown as a warning.
+ */
+declare class NhAssistantAdminMcpToolsComponent {
+    private readonly admin;
+    private subscription?;
+    private rowSubscription?;
+    readonly server: _angular_core.InputSignal<McpServer>;
+    readonly closed: _angular_core.OutputEmitterRef<void>;
+    /** Emitted after a sync so the host can refresh the server's sync status. */
+    readonly synced: _angular_core.OutputEmitterRef<void>;
+    readonly id: string;
+    readonly effects: readonly McpToolEffect[];
+    readonly loading: _angular_core.WritableSignal<boolean>;
+    readonly loadFailed: _angular_core.WritableSignal<boolean>;
+    readonly syncing: _angular_core.WritableSignal<boolean>;
+    readonly savingTool: _angular_core.WritableSignal<string | null>;
+    readonly savedTool: _angular_core.WritableSignal<string | null>;
+    readonly tools: _angular_core.WritableSignal<McpTool[]>;
+    readonly drafts: _angular_core.WritableSignal<Record<string, ToolDraft>>;
+    readonly error: _angular_core.WritableSignal<NhAssistantError | null>;
+    readonly errorKeys: _angular_core.Signal<string[]>;
+    constructor();
+    load(serverId?: string): void;
+    sync(): void;
+    draft(tool: McpTool): ToolDraft;
+    isDirty(tool: McpTool): boolean;
+    change(tool: McpTool, patch: Partial<ToolDraft>): void;
+    value(event: Event): string;
+    checked(event: Event): boolean;
+    save(tool: McpTool): void;
+    private setTools;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NhAssistantAdminMcpToolsComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NhAssistantAdminMcpToolsComponent, "nh-assistant-admin-mcp-tools", never, { "server": { "alias": "server"; "required": true; "isSignal": true; }; }, { "closed": "closed"; "synced": "synced"; }, never, never, true, never>;
+}
+
+export { NH_ASSISTANT_MAX_INSTRUCTIONS, NhAssistantAdminAgentEditorComponent, NhAssistantAdminAgentsComponent, NhAssistantAdminComponent, NhAssistantAdminContextComponent, NhAssistantAdminMcpServerEditorComponent, NhAssistantAdminMcpServersComponent, NhAssistantAdminMcpToolsComponent, nhAssistantSelectorMatches };
+export type { NhAssistantAdminTab, NhAssistantSecretAction };