@bili-agent-kit/core 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 ALTERSSSS
+Copyright (c) 2026 Cansiny0320 (bili-agent-kit modifications)
+
+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/NOTICE.md

@@ -0,0 +1,7 @@
+# Third-party notices
+
+See LICENSE for copyright notices and MIT license terms.
+
+This is an independent, unofficial tool. Bilibili does not endorse or maintain it. Bilibili web interfaces may change without notice.
+
+ffmpeg is optional, separately installed, and not bundled. Its own LGPL/GPL terms depend on the chosen build: https://ffmpeg.org/legal.html. Node.js, Zod, MCP SDK, TypeScript, pnpm and Vite+ retain their respective licenses. The sponsorship image in the repository is reused from Cansiny0320/Nexlet at the owner's request; it is not included in the npm packages.

package/README.md

@@ -1,3 +1,24 @@
-# Temporary Holding Version
+# @bili-agent-kit/core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+TypeScript SDK for Bilibili discovery, content and creator reads, media processing, QR login/Cookie refresh, approved interactions and submissions, and persistent event polling. ESM; requires Node.js 22.18+, 24.11+ or 26+ (Node 23/25 unsupported).
+
+```sh
+npm install @bili-agent-kit/core
+```
+
+```ts
+import { BiliKit, FileStore, loadAuth } from "@bili-agent-kit/core";
+
+const kit = new BiliKit({ store: new FileStore("./.bili-agent-kit") });
+const video = await kit.reads.video({ bvid: "BV1xx411c7mD" });
+
+// Trusted host: the config explicitly selects credentialsFile and stateDir.
+const auth = await loadAuth("./config.local.json");
+const status = await auth.status();
+```
+
+Use `loadKit(configPath)` to share the configured credentials with CLI/MCP. `QrLogin` supports custom login UIs; its success result contains credentials and must remain inside the trusted host. `FileAuth` returns only sanitized account information and supports explicit `refreshCheck()` / `refresh()`. Expanded APIs include `kit.reads.popular`, `kit.reads.transcript`, `kit.media.call`, `kit.events.peek/ack` and `kit.open.call`. Open-platform access requires separate application credentials and scopes.
+
+Writes are disabled by default and require allowlists, durable state and administrator approval. This library is not a shell sandbox. See [configuration and API usage](https://github.com/Cansiny0320/bili-agent-kit/blob/main/docs/usage.md) and [security/recovery](https://github.com/Cansiny0320/bili-agent-kit/blob/main/SECURITY.md).
+
+MIT; see LICENSE and NOTICE.md. Not affiliated with Bilibili.