Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

10.0 KB
Raw Blame
// Copyright (c) 2026 Beijing Volcano Engine Technology Co., Ltd.
// SPDX-License-Identifier: AGPL-3.0

package openviking

import (
	"context"
	"net/http"
	"net/url"
)

// AdminCreateAccount creates an account with its first admin user.
func (c *Client) AdminCreateAccount(ctx context.Context, accountID, adminUserID string) (map[string]any, error) {
	return c.AdminCreateAccountWithOptions(ctx, accountID, adminUserID, nil)
}

// AdminCreateAccountWithOptions creates an account with its first admin user.
func (c *Client) AdminCreateAccountWithOptions(ctx context.Context, accountID, adminUserID string, opts *AdminCreateAccountOptions) (map[string]any, error) {
	payload := map[string]any{
		"account_id":    accountID,
		"admin_user_id": adminUserID,
	}
	if opts != nil && opts.UserConfig != nil {
		payload["user_config"] = opts.UserConfig
	}
	if opts != nil && opts.Seed != nil {
		payload["seed"] = *opts.Seed
	}
	var result map[string]any
	err := c.doJSON(ctx, http.MethodPost, "/api/v1/admin/accounts", nil, payload, &result)
	return result, err
}

// AdminListAccounts lists accounts.
func (c *Client) AdminListAccounts(ctx context.Context) ([]any, error) {
	return c.AdminListAccountsWithOptions(ctx, nil)
}

// AdminListAccountsWithOptions lists accounts (in creation order), optionally
// filtering by a wildcard name pattern and paging via Limit/Page.
func (c *Client) AdminListAccountsWithOptions(ctx context.Context, opts *AdminListAccountsOptions) ([]any, error) {
	query := url.Values{}
	if opts != nil {
		setQueryString(query, "name", opts.Name)
		if opts.Limit != nil {
			queryInt(query, "limit", *opts.Limit)
			page := 1
			if opts.Page != nil {
				page = *opts.Page
			}
			queryInt(query, "page", page)
		}
	}
	var result []any
	err := c.doJSON(ctx, http.MethodGet, "/api/v1/admin/accounts", query, nil, &result)
	return result, err
}

// AdminDeleteAccount deletes an account and all associated users.
func (c *Client) AdminDeleteAccount(ctx context.Context, accountID string) (map[string]any, error) {
	var result map[string]any
	err := c.doJSON(ctx, http.MethodDelete, "/api/v1/admin/accounts/"+url.PathEscape(accountID), nil, nil, &result)
	return result, err
}

// AdminGetAccount returns credential-free metadata for one account.
// It returns an *Error with code NOT_FOUND when the account does not exist.
func (c *Client) AdminGetAccount(ctx context.Context, accountID string) (map[string]any, error) {
	var result map[string]any
	err := c.doJSON(ctx, http.MethodGet, "/api/v1/admin/accounts/"+url.PathEscape(accountID), nil, nil, &result)
	return result, err
}

// AdminGetUser returns one user's credential-free membership info (user_id, role).
// It returns an *Error with code NOT_FOUND when the user does not exist and never
// exposes api_key or key_prefix.
func (c *Client) AdminGetUser(ctx context.Context, accountID, userID string) (map[string]any, error) {
	var result map[string]any
	path := "/api/v1/admin/accounts/" + url.PathEscape(accountID) +
		"/users/" + url.PathEscape(userID)
	err := c.doJSON(ctx, http.MethodGet, path, nil, nil, &result)
	return result, err
}

// AdminRegisterUser registers a user in an account.
func (c *Client) AdminRegisterUser(ctx context.Context, accountID, userID, role string) (map[string]any, error) {
	return c.AdminRegisterUserWithOptions(ctx, accountID, userID, role, nil)
}

// AdminRegisterUserWithOptions registers a user in an account.
func (c *Client) AdminRegisterUserWithOptions(ctx context.Context, accountID, userID, role string, opts *AdminRegisterUserOptions) (map[string]any, error) {
	if role == "" {
		role = "user"
	}
	payload := map[string]any{
		"user_id": userID,
		"role":    role,
	}
	if opts != nil && opts.UserConfig != nil {
		payload["user_config"] = opts.UserConfig
	}
	if opts != nil && opts.Seed != nil {
		payload["seed"] = *opts.Seed
	}
	var result map[string]any
	err := c.doJSON(ctx, http.MethodPost, "/api/v1/admin/accounts/"+url.PathEscape(accountID)+"/users", nil, payload, &result)
	return result, err
}

// AdminListUsers lists users in an account.
func (c *Client) AdminListUsers(ctx context.Context, accountID string) ([]any, error) {
	return c.AdminListUsersWithOptions(ctx, accountID, nil)
}

// AdminListUsersWithOptions lists users in an account (in creation order),
// optionally filtering by a wildcard name pattern, role, and paging via
// Limit/Page.
func (c *Client) AdminListUsersWithOptions(ctx context.Context, accountID string, opts *AdminListUsersOptions) ([]any, error) {
	query := url.Values{}
	if opts != nil {
		if opts.Limit != nil {
			queryInt(query, "limit", *opts.Limit)
			page := 1
			if opts.Page != nil {
				page = *opts.Page
			}
			queryInt(query, "page", page)
		}
		setQueryString(query, "name", opts.Name)
		setQueryString(query, "role", opts.Role)
	}
	var result []any
	err := c.doJSON(ctx, http.MethodGet, "/api/v1/admin/accounts/"+url.PathEscape(accountID)+"/users", query, nil, &result)
	return result, err
}

// AdminRemoveUser removes a user from an account.
func (c *Client) AdminRemoveUser(ctx context.Context, accountID, userID string) (map[string]any, error) {
	var result map[string]any
	err := c.doJSON(ctx, http.MethodDelete, "/api/v1/admin/accounts/"+url.PathEscape(accountID)+"/users/"+url.PathEscape(userID), nil, nil, &result)
	return result, err
}

// AdminSetRole changes a user's role.
func (c *Client) AdminSetRole(ctx context.Context, accountID, userID, role string) (map[string]any, error) {
	var result map[string]any
	err := c.doJSON(ctx, http.MethodPut, "/api/v1/admin/accounts/"+url.PathEscape(accountID)+"/users/"+url.PathEscape(userID)+"/role", nil, map[string]any{
		"role": role,
	}, &result)
	return result, err
}

// AdminRegenerateKey regenerates a user's API key.
func (c *Client) AdminRegenerateKey(ctx context.Context, accountID, userID string) (map[string]any, error) {
	return c.AdminRegenerateKeyWithOptions(ctx, accountID, userID, nil)
}

// AdminRegenerateKeyWithOptions regenerates a user's API key.
func (c *Client) AdminRegenerateKeyWithOptions(ctx context.Context, accountID, userID string, opts *AdminRegenerateKeyOptions) (map[string]any, error) {
	var payload map[string]any
	if opts != nil && opts.Seed != nil {
		payload = map[string]any{"seed": *opts.Seed}
	}
	var result map[string]any
	err := c.doJSON(ctx, http.MethodPost, "/api/v1/admin/accounts/"+url.PathEscape(accountID)+"/users/"+url.PathEscape(userID)+"/key", nil, payload, &result)
	return result, err
}

// AdminCreateGroup creates an empty account-scoped group.
func (c *Client) AdminCreateGroup(ctx context.Context, accountID, groupID string) (map[string]any, error) {
	var result map[string]any
	err := c.doJSON(ctx, http.MethodPost, "/api/v1/admin/accounts/"+url.PathEscape(accountID)+"/groups", nil, map[string]any{"group_id": groupID}, &result)
	return result, err
}

// AdminListGroups lists account-scoped groups.
func (c *Client) AdminListGroups(ctx context.Context, accountID string) ([]any, error) {
	var result []any
	err := c.doJSON(ctx, http.MethodGet, "/api/v1/admin/accounts/"+url.PathEscape(accountID)+"/groups", nil, nil, &result)
	return result, err
}

// AdminDeleteGroup deletes an empty group.
func (c *Client) AdminDeleteGroup(ctx context.Context, accountID, groupID string) (map[string]any, error) {
	var result map[string]any
	err := c.doJSON(ctx, http.MethodDelete, "/api/v1/admin/accounts/"+url.PathEscape(accountID)+"/groups/"+url.PathEscape(groupID), nil, nil, &result)
	return result, err
}

// AdminListGroupMembers lists a group's user IDs.
func (c *Client) AdminListGroupMembers(ctx context.Context, accountID, groupID string) (map[string]any, error) {
	var result map[string]any
	err := c.doJSON(ctx, http.MethodGet, "/api/v1/admin/accounts/"+url.PathEscape(accountID)+"/groups/"+url.PathEscape(groupID)+"/members", nil, nil, &result)
	return result, err
}

// AdminAddGroupMember adds an existing account user to a group.
func (c *Client) AdminAddGroupMember(ctx context.Context, accountID, groupID, userID string) (map[string]any, error) {
	var result map[string]any
	err := c.doJSON(ctx, http.MethodPut, "/api/v1/admin/accounts/"+url.PathEscape(accountID)+"/groups/"+url.PathEscape(groupID)+"/members/"+url.PathEscape(userID), nil, nil, &result)
	return result, err
}

// AdminRemoveGroupMember removes a user from a group.
func (c *Client) AdminRemoveGroupMember(ctx context.Context, accountID, groupID, userID string) (map[string]any, error) {
	var result map[string]any
	err := c.doJSON(ctx, http.MethodDelete, "/api/v1/admin/accounts/"+url.PathEscape(accountID)+"/groups/"+url.PathEscape(groupID)+"/members/"+url.PathEscape(userID), nil, nil, &result)
	return result, err
}

// AdminGetAgentEvolution returns the effective Agent Evolution switch for the
// caller's account.
func (c *Client) AdminGetAgentEvolution(ctx context.Context) (map[string]any, error) {
	var result map[string]any
	err := c.doJSON(ctx, http.MethodGet, "/api/v1/admin/agent-evolution", nil, nil, &result)
	return result, err
}

// AdminSetAgentEvolution persists and hot-reloads Agent Evolution for the
// caller's account.
func (c *Client) AdminSetAgentEvolution(ctx context.Context, enabled bool) (map[string]any, error) {
	var result map[string]any
	err := c.doJSON(ctx, http.MethodPut, "/api/v1/admin/agent-evolution", nil, map[string]any{"enabled": enabled}, &result)
	return result, err
}

// AdminGetAccountSettings returns the effective and explicitly overridden
// settings for one account.
func (c *Client) AdminGetAccountSettings(ctx context.Context, accountID string) (map[string]any, error) {
	var result map[string]any
	err := c.doJSON(ctx, http.MethodGet, "/api/v1/admin/accounts/"+url.PathEscape(accountID)+"/settings", nil, nil, &result)
	return result, err
}

// AdminSetAccountAgentEvolution updates the allowlisted, hot-reloadable Agent
// Evolution setting for one account via PATCH.
func (c *Client) AdminSetAccountAgentEvolution(ctx context.Context, accountID string, enabled bool) (map[string]any, error) {
	payload := map[string]any{
		"agent_evolution": map[string]any{"enabled": enabled},
	}
	var result map[string]any
	err := c.doJSON(ctx, http.MethodPatch, "/api/v1/admin/accounts/"+url.PathEscape(accountID)+"/settings", nil, payload, &result)
	return result, err
}