Skip to content

Add LICENSE, AGENTS.md, and richer package metadata#1

Merged
shuakami merged 1 commit intomainfrom
chore/license-agents-meta
May 6, 2026
Merged

Add LICENSE, AGENTS.md, and richer package metadata#1
shuakami merged 1 commit intomainfrom
chore/license-agents-meta

Conversation

@shuakami
Copy link
Copy Markdown
Member

@shuakami shuakami commented May 6, 2026

Summary

Land explicit license terms, an agent-facing playbook, and discovery-friendly package metadata.

  • LICENSE (MIT)
  • AGENTS.md — install, typed client surface, auth, errors, rate limits, links to sibling repos
  • Package manifest — English description, MIT license, uapis.cn homepage, search-friendly keywords / classifiers / tags

No code changes; build/publish pipeline untouched.

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@shuakami shuakami merged commit 6d9dd67 into main May 6, 2026
1 check passed
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 8c2e4e5098

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread AGENTS.md
## Quick start

```cpp
#include <uapi/client.hpp>
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Use the shipped public header name

On case-sensitive platforms this quick start cannot compile because the repository ships include/uapi/Client.hpp and the existing README/tests include <uapi/Client.hpp>, not <uapi/client.hpp>. Since this AGENTS file is meant to guide generated integrations, agents following it will produce examples that fail before reaching the SDK code.

Useful? React with 👍 / 👎.

Comment thread AGENTS.md
Comment on lines +35 to +36
auto weather = client.misc().get_misc_weather({.city = "北京"});
std::cout << weather.dump() << std::endl;
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Replace the quick start with the real C++ API shape

This example describes a typed/snake_case API that is not present in the public wrapper: include/uapi/Client.hpp exposes getMiscWeather(const std::map<std::string, std::string>&) returning std::string, so get_misc_weather, the designated .city argument, and weather.dump() all fail for users or agents copying the snippet. The example should match the actual camelCase map-based calls used by the SDK.

Useful? React with 👍 / 👎.

Comment thread AGENTS.md
Comment on lines +54 to +55
Methods throw `uapi::ApiException` on non-2xx responses. The exception
carries `code`, `error`, and `request_id` fields. Surface `error`
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Document the actual exception type

The public header does not define or throw uapi::ApiException; non-2xx responses are mapped to UapiError subclasses such as UnauthorizedError, NotFoundError, and finally UapiError in include/uapi/Client.hpp. Code generated from this guidance will try to catch a nonexistent public type and miss the fields that actually exist (code, status, payload, meta).

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant