@harborclient/team-hub-api 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) HarborClient
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,39 @@
+# @harborclient/team-hub-api
+
+**Full documentation:** [https://harborclient.github.io/team-hub-api/](https://harborclient.github.io/team-hub-api/)
+
+**TypeScript client for the HarborClient Team Hub API**
+
+`@harborclient/team-hub-api` is a library for typed HTTP access to HarborClient Team Hub collections, environments, folders, and saved requests:
+
+- **Typed HTTP client:** Zod-validated request and response shapes for Team Hub endpoints.
+- **Full API coverage:** Collections, environments, folders, saved requests, admin, and session APIs.
+- **Capability-aware usage:** Session capabilities guide when to call management vs. user-scoped methods.
+
+## Documentation
+
+| Topic           | Link                                                                     |
+| --------------- | ------------------------------------------------------------------------ |
+| Getting started | [Introduction](https://harborclient.github.io/team-hub-api/)             |
+| Installation    | [Install](https://harborclient.github.io/team-hub-api/install)           |
+| Usage           | [Usage](https://harborclient.github.io/team-hub-api/usage)               |
+| API reference   | [API coverage](https://harborclient.github.io/team-hub-api/api-coverage) |
+
+Canonical docs live in [`docs/`](./docs/). Edit those pages directly, then run `pnpm docs:build:nav` to refresh the VitePress sidebar.
+
+## Development
+
+```bash
+pnpm install
+pnpm lint
+pnpm format:check
+pnpm typecheck
+pnpm test
+pnpm build
+pnpm docs:serve    # VitePress dev server with nav watcher
+pnpm docs:build    # production docs build
+```
+
+## License
+
+MIT

package/dist/ITeamHubClient.d.ts

@@ -0,0 +1,261 @@
+import type { AdminEntityConfig, AdminResourceOption, CollectionRecord, CreateCollectionInput, CreateEnvironmentInput, CreateFolderInput, CreateRequestInput, EnvironmentRecord, FolderRecord, HealthResponse, HubUserRecord, MoveRequestInput, PluginSourcesResponse, RenameFolderInput, ReorderFoldersInput, ReorderRequestsInput, SavedRequestRecord, SessionResponse, TeamHubAdminResourceOptions, UpdateCollectionInput, UpdateEnvironmentInput, UpdateHubUserInput, CreateHubUserInput, HubApiTokenRecord, CreatedHubUser, CreateHubTokenInput, CreatedHubToken, UpdateRequestInput, ReloadConfigResponse } from './types.js';
+import type { HubLlmModel } from './appTypes.js';
+/**
+ * Typed HTTP client for HarborClient Server entity and health routes.
+ */
+export interface ITeamHubClient {
+    /**
+     * Probes server availability via the public health endpoint.
+     */
+    checkHealth(): Promise<HealthResponse>;
+    /**
+     * Returns the authenticated user, token metadata, and derived API capabilities.
+     *
+     * Calls `GET /auth/session` with bearer auth. Use this to discover whether
+     * a token belongs to a `user` or `admin` account before gating management UI.
+     */
+    getSession(): Promise<SessionResponse>;
+    /**
+     * Lists all Team Hub user accounts visible to an admin-role token.
+     */
+    listAdminUsers(): Promise<HubUserRecord[]>;
+    /**
+     * Creates a Team Hub user account and an initial API bearer token.
+     *
+     * @param input - User fields for the new account.
+     */
+    createAdminUser(input: CreateHubUserInput): Promise<CreatedHubUser>;
+    /**
+     * Updates a Team Hub user account via the management API.
+     *
+     * @param id - User account identifier.
+     * @param input - Partial user fields to apply.
+     */
+    updateAdminUser(id: string, input: UpdateHubUserInput): Promise<HubUserRecord>;
+    /**
+     * Deletes a Team Hub user account and their API tokens via the management API.
+     *
+     * @param id - User account identifier.
+     */
+    deleteAdminUser(id: string): Promise<void>;
+    /**
+     * Lists all API bearer tokens visible to an admin-role token.
+     */
+    listAdminTokens(): Promise<HubApiTokenRecord[]>;
+    /**
+     * Creates an additional API bearer token for a user account.
+     *
+     * @param userId - Owning user account identifier.
+     * @param input - Human-readable label for the new token.
+     */
+    createAdminUserToken(userId: string, input: CreateHubTokenInput): Promise<CreatedHubToken>;
+    /**
+     * Permanently deletes an API bearer token via the management API.
+     *
+     * @param id - Token record identifier.
+     */
+    deleteAdminToken(id: string): Promise<void>;
+    /**
+     * Lists all collections as id/name metadata for admin user management.
+     */
+    listAdminCollections(): Promise<AdminResourceOption[]>;
+    /**
+     * Lists all environments as id/name metadata for admin user management.
+     */
+    listAdminEnvironments(): Promise<AdminResourceOption[]>;
+    /**
+     * Lists folders in a collection for operator inspection.
+     *
+     * @param collectionId - Parent collection UUID.
+     */
+    listAdminCollectionFolders(collectionId: string): Promise<FolderRecord[]>;
+    /**
+     * Lists saved requests in a collection for operator inspection.
+     *
+     * @param collectionId - Parent collection UUID.
+     */
+    listAdminCollectionRequests(collectionId: string): Promise<SavedRequestRecord[]>;
+    /**
+     * Deletes a collection via the admin management API.
+     *
+     * @param id - Collection UUID.
+     */
+    deleteAdminCollection(id: string): Promise<void>;
+    /**
+     * Deletes an environment via the admin management API.
+     *
+     * @param id - Environment UUID.
+     */
+    deleteAdminEnvironment(id: string): Promise<void>;
+    /**
+     * Deletes a saved request via the admin management API.
+     *
+     * @param id - Saved request UUID.
+     */
+    deleteAdminRequest(id: string): Promise<void>;
+    /**
+     * Updates whether non-admin users may delete a collection.
+     *
+     * @param id - Collection UUID.
+     * @param deletionLocked - When true, user-role tokens cannot delete the collection.
+     */
+    updateAdminCollectionDeletionLocked(id: string, deletionLocked: boolean): Promise<AdminEntityConfig>;
+    /**
+     * Updates whether non-admin users may delete an environment.
+     *
+     * @param id - Environment UUID.
+     * @param deletionLocked - When true, user-role tokens cannot delete the environment.
+     */
+    updateAdminEnvironmentDeletionLocked(id: string, deletionLocked: boolean): Promise<AdminEntityConfig>;
+    /**
+     * Lists all hub-offered LLM models for admin user management.
+     */
+    listAdminLlmModels(): Promise<HubLlmModel[]>;
+    /**
+     * Returns whether the Team Hub server has LLM support configured.
+     *
+     * @param managementApi - When true, probes `GET /admin/llm/models`.
+     */
+    probeLlmServiceEnabled(managementApi: boolean): Promise<boolean>;
+    /**
+     * Returns plugin catalog and trusted-publisher URLs configured on this Team Hub.
+     */
+    getPluginSources(): Promise<PluginSourcesResponse>;
+    /**
+     * Loads collection, environment, and LLM model options for admin user forms.
+     */
+    listAdminResourceOptions(): Promise<TeamHubAdminResourceOptions>;
+    /**
+     * Re-reads server.yaml on the Team Hub and applies reloadable config sections.
+     *
+     * Requires an admin-role bearer token. Returns a per-section report. A `400`
+     * response with `fatalError` is returned as a normal result, not thrown.
+     */
+    reloadConfig(): Promise<ReloadConfigResponse>;
+    /**
+     * Lists all collections visible to the authenticated token.
+     *
+     * Admin tokens receive the full catalog from `GET /collections`; create, update,
+     * and delete remain forbidden on the server.
+     */
+    listCollections(): Promise<CollectionRecord[]>;
+    /**
+     * Creates a new top-level collection.
+     *
+     * @param input - Display name for the collection.
+     */
+    createCollection(input: CreateCollectionInput): Promise<CollectionRecord>;
+    /**
+     * Updates an existing collection's settings.
+     *
+     * @param id - Collection UUID.
+     * @param input - Updated collection fields.
+     */
+    updateCollection(id: string, input: UpdateCollectionInput): Promise<CollectionRecord>;
+    /**
+     * Deletes a collection and all nested folders and requests.
+     *
+     * @param id - Collection UUID.
+     */
+    deleteCollection(id: string): Promise<void>;
+    /**
+     * Lists all environments visible to the authenticated token.
+     *
+     * Admin tokens receive the full catalog from `GET /environments`; create, update,
+     * and delete remain forbidden on the server.
+     */
+    listEnvironments(): Promise<EnvironmentRecord[]>;
+    /**
+     * Creates a new top-level environment.
+     *
+     * @param input - Display name for the environment.
+     */
+    createEnvironment(input: CreateEnvironmentInput): Promise<EnvironmentRecord>;
+    /**
+     * Updates an existing environment's name and variables.
+     *
+     * @param id - Environment UUID.
+     * @param input - Updated environment fields.
+     */
+    updateEnvironment(id: string, input: UpdateEnvironmentInput): Promise<EnvironmentRecord>;
+    /**
+     * Deletes an environment by id.
+     *
+     * @param id - Environment UUID.
+     */
+    deleteEnvironment(id: string): Promise<void>;
+    /**
+     * Lists folders in a collection ordered by sort order, then name.
+     *
+     * @param collectionId - Parent collection UUID.
+     */
+    listFolders(collectionId: string): Promise<FolderRecord[]>;
+    /**
+     * Creates a folder in the given collection.
+     *
+     * @param collectionId - Parent collection UUID.
+     * @param input - Display name for the folder.
+     */
+    createFolder(collectionId: string, input: CreateFolderInput): Promise<FolderRecord>;
+    /**
+     * Renames a folder by id.
+     *
+     * @param id - Folder UUID.
+     * @param input - Updated folder name.
+     */
+    renameFolder(id: string, input: RenameFolderInput): Promise<FolderRecord>;
+    /**
+     * Deletes a folder and all saved requests inside it.
+     *
+     * @param id - Folder UUID.
+     */
+    deleteFolder(id: string): Promise<void>;
+    /**
+     * Reorders folders within a collection.
+     *
+     * @param collectionId - Parent collection UUID.
+     * @param input - Folder ids in the desired order.
+     */
+    reorderFolders(collectionId: string, input: ReorderFoldersInput): Promise<void>;
+    /**
+     * Lists saved requests in a collection.
+     *
+     * @param collectionId - Parent collection UUID.
+     */
+    listRequests(collectionId: string): Promise<SavedRequestRecord[]>;
+    /**
+     * Creates a new saved request in a collection.
+     *
+     * @param collectionId - Parent collection UUID.
+     * @param input - Saved request fields.
+     */
+    createRequest(collectionId: string, input: CreateRequestInput): Promise<SavedRequestRecord>;
+    /**
+     * Updates an existing saved request by id.
+     *
+     * @param id - Saved request UUID.
+     * @param input - Updated request fields including collection id.
+     */
+    updateRequest(id: string, input: UpdateRequestInput): Promise<SavedRequestRecord>;
+    /**
+     * Deletes a saved request by id.
+     *
+     * @param id - Saved request UUID.
+     */
+    deleteRequest(id: string): Promise<void>;
+    /**
+     * Reorders saved requests within a folder or the collection root.
+     *
+     * @param collectionId - Parent collection UUID.
+     * @param input - Destination folder and ordered request ids.
+     */
+    reorderRequests(collectionId: string, input: ReorderRequestsInput): Promise<void>;
+    /**
+     * Moves a saved request to another folder or root index.
+     *
+     * @param id - Saved request UUID.
+     * @param input - Destination folder and target index.
+     */
+    moveRequest(id: string, input: MoveRequestInput): Promise<void>;
+}
+//# sourceMappingURL=ITeamHubClient.d.ts.map

package/dist/ITeamHubClient.d.ts.map

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

package/dist/ITeamHubClient.js

@@ -0,0 +1 @@
+export {};

package/dist/TeamHubClient.d.ts

@@ -0,0 +1,333 @@
+import type { ITeamHubClient } from './ITeamHubClient.js';
+import type { AdminResourceOption, AdminEntityConfig, CollectionRecord, CreateCollectionInput, CreateEnvironmentInput, CreateFolderInput, CreateHubTokenInput, CreateHubUserInput, CreateRequestInput, CreatedHubToken, CreatedHubUser, EnvironmentRecord, FolderRecord, HealthResponse, HubApiTokenRecord, HubUserRecord, MoveRequestInput, PluginSourcesResponse, RenameFolderInput, ReorderFoldersInput, ReorderRequestsInput, SavedRequestRecord, TeamHubClientConfig, SessionResponse, TeamHubAdminResourceOptions, UpdateCollectionInput, UpdateEnvironmentInput, UpdateHubUserInput, UpdateRequestInput, ReloadConfigResponse } from './types.js';
+import type { ChatStepMessage, ChatStepResult, HubLlmModel } from './appTypes.js';
+/**
+ * Default request timeout when {@link TeamHubClientConfig.requestTimeoutMs} is omitted.
+ */
+export declare const DEFAULT_TEAM_HUB_REQUEST_TIMEOUT_MS = 30000;
+/**
+ * Input for POST /llm/chat/step on Team Hub.
+ */
+export interface HubChatStepRequest {
+    /**
+     * Provider-specific model id.
+     */
+    model: string;
+    /**
+     * Conversation messages excluding the injected system prompt.
+     */
+    messages: ChatStepMessage[];
+    /**
+     * OpenAI-compatible tool definitions forwarded to the provider.
+     */
+    tools?: Record<string, unknown>[];
+    /**
+     * System prompt injected ahead of the conversation messages.
+     */
+    systemPrompt?: string;
+}
+/**
+ * Executes typed HTTP requests against HarborClient Server.
+ */
+export declare class TeamHubClient implements ITeamHubClient {
+    private readonly baseUrl;
+    private readonly token;
+    private readonly requestTimeoutMs;
+    /**
+     * Creates a client bound to a HarborClient Server instance and bearer token.
+     *
+     * @param config - Base URL, token, and optional request timeout.
+     */
+    constructor(config: TeamHubClientConfig);
+    /**
+     * Joins the configured base URL with a relative API path.
+     *
+     * @param path - Path beginning with `/`.
+     */
+    private buildUrl;
+    /**
+     * Parses a failed response body into a human-readable error message.
+     *
+     * @param response - Non-success fetch response.
+     * @param method - HTTP method used for the request.
+     * @param path - Request path relative to the base URL.
+     */
+    private parseErrorMessage;
+    /**
+     * Sends an HTTP request to HarborClient Server and validates the response.
+     *
+     * @param method - HTTP method.
+     * @param path - Path relative to the configured base URL.
+     * @param options - Optional body, response schema, and auth flag.
+     * @returns Parsed response body, or `undefined` for `204 No Content`.
+     * @throws {TeamHubClientError} When the request fails or the response is invalid.
+     */
+    private request;
+    /**
+     * Probes server availability via the public health endpoint.
+     */
+    checkHealth(): Promise<HealthResponse>;
+    /**
+     * Returns the authenticated user, token metadata, and derived API capabilities.
+     */
+    getSession(): Promise<SessionResponse>;
+    /**
+     * Lists all Team Hub user accounts visible to an admin-role token.
+     */
+    listAdminUsers(): Promise<HubUserRecord[]>;
+    /**
+     * Creates a Team Hub user account and an initial API bearer token.
+     *
+     * @param input - User fields for the new account.
+     */
+    createAdminUser(input: CreateHubUserInput): Promise<CreatedHubUser>;
+    /**
+     * Updates a Team Hub user account via the management API.
+     *
+     * @param id - User account identifier.
+     * @param input - Partial user fields to apply.
+     */
+    updateAdminUser(id: string, input: UpdateHubUserInput): Promise<HubUserRecord>;
+    /**
+     * Deletes a Team Hub user account and their API tokens via the management API.
+     *
+     * @param id - User account identifier.
+     */
+    deleteAdminUser(id: string): Promise<void>;
+    /**
+     * Lists all API bearer tokens visible to an admin-role token.
+     */
+    listAdminTokens(): Promise<HubApiTokenRecord[]>;
+    /**
+     * Creates an additional API bearer token for a user account.
+     *
+     * @param userId - Owning user account identifier.
+     * @param input - Human-readable label for the new token.
+     */
+    createAdminUserToken(userId: string, input: CreateHubTokenInput): Promise<CreatedHubToken>;
+    /**
+     * Permanently deletes an API bearer token via the management API.
+     *
+     * @param id - Token record identifier.
+     */
+    deleteAdminToken(id: string): Promise<void>;
+    /**
+     * Lists all collections as id/name metadata for admin user management.
+     */
+    listAdminCollections(): Promise<AdminResourceOption[]>;
+    /**
+     * Lists all environments as id/name metadata for admin user management.
+     */
+    listAdminEnvironments(): Promise<AdminResourceOption[]>;
+    /**
+     * Lists folders in a collection for operator inspection.
+     *
+     * @param collectionId - Parent collection UUID.
+     */
+    listAdminCollectionFolders(collectionId: string): Promise<FolderRecord[]>;
+    /**
+     * Lists saved requests in a collection for operator inspection.
+     *
+     * @param collectionId - Parent collection UUID.
+     */
+    listAdminCollectionRequests(collectionId: string): Promise<SavedRequestRecord[]>;
+    /**
+     * Deletes a collection via the admin management API.
+     *
+     * @param id - Collection UUID.
+     */
+    deleteAdminCollection(id: string): Promise<void>;
+    /**
+     * Deletes an environment via the admin management API.
+     *
+     * @param id - Environment UUID.
+     */
+    deleteAdminEnvironment(id: string): Promise<void>;
+    /**
+     * Deletes a saved request via the admin management API.
+     *
+     * @param id - Saved request UUID.
+     */
+    deleteAdminRequest(id: string): Promise<void>;
+    /**
+     * Updates whether non-admin users may delete a collection.
+     *
+     * @param id - Collection UUID.
+     * @param deletionLocked - When true, user-role tokens cannot delete the collection.
+     */
+    updateAdminCollectionDeletionLocked(id: string, deletionLocked: boolean): Promise<AdminEntityConfig>;
+    /**
+     * Updates whether non-admin users may delete an environment.
+     *
+     * @param id - Environment UUID.
+     * @param deletionLocked - When true, user-role tokens cannot delete the environment.
+     */
+    updateAdminEnvironmentDeletionLocked(id: string, deletionLocked: boolean): Promise<AdminEntityConfig>;
+    /**
+     * Lists all hub-offered LLM models for admin user management.
+     *
+     * Returns an empty list when LLM support is not configured on the hub.
+     */
+    listAdminLlmModels(): Promise<HubLlmModel[]>;
+    /**
+     * Returns whether the Team Hub server has LLM support configured.
+     *
+     * Uses the admin models route for management tokens and the user route otherwise.
+     * A 503 response means LLM is not configured; any other successful response means
+     * configured.
+     *
+     * @param managementApi - When true, probes `GET /admin/llm/models`.
+     */
+    probeLlmServiceEnabled(managementApi: boolean): Promise<boolean>;
+    /**
+     * Loads collection, environment, and LLM model options for admin user forms.
+     */
+    listAdminResourceOptions(): Promise<TeamHubAdminResourceOptions>;
+    /**
+     * Re-reads server.yaml on the Team Hub and applies reloadable config sections.
+     *
+     * Returns parsed bodies for both `200` and `400` responses. Only auth and
+     * transport failures throw {@link TeamHubClientError}.
+     */
+    reloadConfig(): Promise<ReloadConfigResponse>;
+    /**
+     * Lists all collections visible to the authenticated token.
+     *
+     * Admin tokens receive the full catalog from `GET /collections`; create, update,
+     * and delete remain forbidden on the server.
+     */
+    listCollections(): Promise<CollectionRecord[]>;
+    /**
+     * Creates a new top-level collection.
+     *
+     * @param input - Display name for the collection.
+     */
+    createCollection(input: CreateCollectionInput): Promise<CollectionRecord>;
+    /**
+     * Updates an existing collection's settings.
+     *
+     * @param id - Collection UUID.
+     * @param input - Updated collection fields.
+     */
+    updateCollection(id: string, input: UpdateCollectionInput): Promise<CollectionRecord>;
+    /**
+     * Deletes a collection and all nested folders and requests.
+     *
+     * @param id - Collection UUID.
+     */
+    deleteCollection(id: string): Promise<void>;
+    /**
+     * Lists all environments visible to the authenticated token.
+     *
+     * Admin tokens receive the full catalog from `GET /environments`; create, update,
+     * and delete remain forbidden on the server.
+     */
+    listEnvironments(): Promise<EnvironmentRecord[]>;
+    /**
+     * Creates a new top-level environment.
+     *
+     * @param input - Display name for the environment.
+     */
+    createEnvironment(input: CreateEnvironmentInput): Promise<EnvironmentRecord>;
+    /**
+     * Updates an existing environment's name and variables.
+     *
+     * @param id - Environment UUID.
+     * @param input - Updated environment fields.
+     */
+    updateEnvironment(id: string, input: UpdateEnvironmentInput): Promise<EnvironmentRecord>;
+    /**
+     * Deletes an environment by id.
+     *
+     * @param id - Environment UUID.
+     */
+    deleteEnvironment(id: string): Promise<void>;
+    /**
+     * Lists folders in a collection ordered by sort order, then name.
+     *
+     * @param collectionId - Parent collection UUID.
+     */
+    listFolders(collectionId: string): Promise<FolderRecord[]>;
+    /**
+     * Creates a folder in the given collection.
+     *
+     * @param collectionId - Parent collection UUID.
+     * @param input - Display name for the folder.
+     */
+    createFolder(collectionId: string, input: CreateFolderInput): Promise<FolderRecord>;
+    /**
+     * Renames a folder by id.
+     *
+     * @param id - Folder UUID.
+     * @param input - Updated folder name.
+     */
+    renameFolder(id: string, input: RenameFolderInput): Promise<FolderRecord>;
+    /**
+     * Deletes a folder and all saved requests inside it.
+     *
+     * @param id - Folder UUID.
+     */
+    deleteFolder(id: string): Promise<void>;
+    /**
+     * Reorders folders within a collection.
+     *
+     * @param collectionId - Parent collection UUID.
+     * @param input - Folder ids in the desired order.
+     */
+    reorderFolders(collectionId: string, input: ReorderFoldersInput): Promise<void>;
+    /**
+     * Lists saved requests in a collection.
+     *
+     * @param collectionId - Parent collection UUID.
+     */
+    listRequests(collectionId: string): Promise<SavedRequestRecord[]>;
+    /**
+     * Creates a new saved request in a collection.
+     *
+     * @param collectionId - Parent collection UUID.
+     * @param input - Saved request fields.
+     */
+    createRequest(collectionId: string, input: CreateRequestInput): Promise<SavedRequestRecord>;
+    /**
+     * Updates an existing saved request by id.
+     *
+     * @param id - Saved request UUID.
+     * @param input - Updated request fields including collection id.
+     */
+    updateRequest(id: string, input: UpdateRequestInput): Promise<SavedRequestRecord>;
+    /**
+     * Deletes a saved request by id.
+     *
+     * @param id - Saved request UUID.
+     */
+    deleteRequest(id: string): Promise<void>;
+    /**
+     * Reorders saved requests within a folder or the collection root.
+     *
+     * @param collectionId - Parent collection UUID.
+     * @param input - Destination folder and ordered request ids.
+     */
+    reorderRequests(collectionId: string, input: ReorderRequestsInput): Promise<void>;
+    /**
+     * Moves a saved request to another folder or root index.
+     *
+     * @param id - Saved request UUID.
+     * @param input - Destination folder and target index.
+     */
+    moveRequest(id: string, input: MoveRequestInput): Promise<void>;
+    /**
+     * Lists hub-offered LLM models visible to the authenticated token.
+     */
+    listLlmModels(): Promise<HubLlmModel[]>;
+    /**
+     * Returns plugin catalog and trusted-publisher URLs configured on this Team Hub.
+     */
+    getPluginSources(): Promise<PluginSourcesResponse>;
+    /**
+     * Runs one hub-proxied LLM completion step.
+     *
+     * @param input - Model, messages, tools, and system prompt for the step.
+     */
+    completeChatStep(input: HubChatStepRequest): Promise<ChatStepResult>;
+}
+//# sourceMappingURL=TeamHubClient.d.ts.map

package/dist/TeamHubClient.d.ts.map

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