@byteplus-iga-pages/agent 0.0.0-stage → 1.0.3

package/LICENSE

@@ -0,0 +1,20 @@
+Copyright 2026 BytePlus Pte. Ltd. All Rights Reserved.
+
+@byteplus-iga-pages/agent is developed by BytePlus Pte. Ltd. (hereinafter "BytePlus").
+Any copyright or patent right is owned by BytePlus or its affiliates.
+
+@byteplus-iga-pages/agent is available under a commercial license. Customers can contact
+BytePlus through https://www.byteplus.com for commercial licensing options.
+
+Access to or use of this software is subject to the BytePlus Software License
+and Services Agreement, which you agree to and accept by downloading or
+installing this software, available at:
+https://docs.byteplus.com/en/legal/docs/byteplus-software-license-and-services-agreement
+
+Without BytePlus's prior written permission, any use of @byteplus-iga-pages/agent,
+in particular any use for commercial purposes, is prohibited. This includes,
+without limitation, incorporation in a commercial product, use in a commercial
+service, or production of other artefacts for commercial purposes.
+
+Without BytePlus's prior written permission, @byteplus-iga-pages/agent may not be
+reproduced, modified or made available in any form to any third party.

package/README.md

@@ -1,3 +1,85 @@
-# Temporary Holding Version
+# @byteplus-iga-pages/agent
 
-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.
+Server-side SDK for BytePlus IGA Pages agents: persist conversations, run Sandbox tools, and connect to agent frameworks.
+
+[Official BytePlus IGA Pages documentation](https://docs.byteplus.com/en/docs/iga)
+
+## Quick start
+
+Requires Node.js 20+ and an BytePlus IGA Pages server runtime.
+
+```bash
+npm install @byteplus-iga-pages/agent
+npm install -g @byteplus-iga-pages/cli
+bp-iga login
+bp-iga pages link
+bp-iga pages dev
+```
+
+Pages supplies the project identity locally and after deployment. No IGA endpoint or credential is needed in application code.
+
+## Store
+
+```ts
+import { store } from "@byteplus-iga-pages/agent/store";
+
+const { conversationId } = await store.createConversation({
+  metadata: { title: "New conversation" },
+});
+await store.appendMessage({
+  conversationId,
+  role: "user",
+  payload: { text: "Hello" },
+});
+const page = await store.listMessages({ conversationId, limit: 20 });
+```
+
+Store preserves your JSON payload. `page.nextCursor` continues pagination. Your application must authorize access to each conversation ID.
+
+## Tools and Sandbox
+
+```ts
+import { getConversationSandbox } from "@byteplus-iga-pages/agent/sandbox";
+import { getTools } from "@byteplus-iga-pages/agent/tools";
+
+const sandbox = getConversationSandbox(conversationId);
+const result = await getTools(sandbox).code_run.execute({
+  language: "python",
+  code: "print(1 + 1)",
+});
+if (result.status === "error") throw new Error(result.error.message);
+
+// Direct Sandbox API, when you need more control:
+await sandbox.code.executeCode({ language: "python", code: "print(1 + 1)" });
+```
+
+`getTools(sandbox)` provides nine tools: `files_read`, `files_write`, `files_list`, `files_search`, `files_find`, `shell_exec`, `code_run`, `browser_fetch`, and `browser_screenshot`. Calls return `{ status: "success", data }` or `{ status: "error", error }`.
+
+The direct `Sandbox` API exposes:
+
+| Module | Methods |
+| --- | --- |
+| `sandbox.code` | `executeCode` |
+| `sandbox.shell` | `execCommand`, `view`, `waitForProcess`, `killProcess` |
+| `sandbox.file` | `readFile`, `writeFile`, `replaceInFile`, `searchInFile`, `findFiles`, `grepFiles`, `listPath` |
+| `sandbox.browserPage` | Navigation, interaction, screenshots, and page content; see the exported `Sandbox` type for all methods |
+
+Use `getConversationSandbox(conversationId)` for a conversation-bound instance. For a standalone instance, use `const sandbox = await createSandbox()`, save `sandbox.sandboxId`, and reconnect with `connectSandbox(sandboxId)`. Instances also support `getInfo()`, `extendTimeout(minutes)`, and `destroy()`.
+
+## Imports
+
+There is no package-root import. Use these subpaths:
+
+| Path after `@byteplus-iga-pages/agent/` | API |
+| --- | --- |
+| `store` | `store`, `StoreError` |
+| `store/openai`, `store/langgraph`, `store/claude` | `createSession`, `createCheckpointer`, `createSessionStore` |
+| `tools` | Portable `getTools` |
+| `tools/openai`, `tools/openai-agents`, `tools/claude`, `tools/langchain` | Framework-specific `getTools` |
+| `sandbox` | `getConversationSandbox`, `createSandbox`, `connectSandbox` |
+
+Install the corresponding framework SDK when using an adapter. See [package.json](./package.json) for optional peer dependencies.
+
+## License
+
+See [LICENSE](./LICENSE) for terms of use.

package/dist/cjs/261.js

@@ -0,0 +1,77 @@
+"use strict";
+exports.ids = [
+    "261"
+];
+exports.modules = {
+    "../store/src/runtime-store.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        __webpack_require__.d(__webpack_exports__, {
+            M: ()=>store
+        });
+        var _errors_js__rspack_import_1 = __webpack_require__("../store/src/errors.ts");
+        var _runtime_data_plane_js__rspack_import_0 = __webpack_require__("../store/src/runtime-data-plane.ts");
+        const PUBLIC_STORE_METHODS = [
+            "createConversation",
+            "getConversation",
+            "listConversations",
+            "updateConversation",
+            "deleteConversation",
+            "appendMessage",
+            "appendMessages",
+            "getMessage",
+            "listMessages",
+            "updateMessage",
+            "deleteMessage",
+            "clearMessages"
+        ];
+        const store = createPublicStore();
+        function createPublicStore() {
+            const methods = new Set(PUBLIC_STORE_METHODS);
+            const bound = new Map();
+            const getMethod = (method)=>{
+                if (bound.has(method)) return bound.get(method);
+                const value = async (...args)=>{
+                    const instance = await (0, _runtime_data_plane_js__rspack_import_0.y)();
+                    const implementation = instance[method];
+                    if ("function" != typeof implementation) throw new _errors_js__rspack_import_1.A("UnknownError", "Store runtime is invalid");
+                    return Reflect.apply(implementation, instance, args);
+                };
+                bound.set(method, value);
+                return value;
+            };
+            return new Proxy(Object.create(null), {
+                get (_target, property) {
+                    return methods.has(property) ? getMethod(property) : void 0;
+                },
+                has (_target, property) {
+                    return methods.has(property);
+                },
+                ownKeys () {
+                    return [
+                        ...PUBLIC_STORE_METHODS
+                    ];
+                },
+                getOwnPropertyDescriptor (_target, property) {
+                    if (!methods.has(property)) return;
+                    return {
+                        configurable: true,
+                        enumerable: false,
+                        writable: false,
+                        value: getMethod(property)
+                    };
+                },
+                getPrototypeOf () {
+                    return null;
+                },
+                set () {
+                    return false;
+                },
+                defineProperty () {
+                    return false;
+                },
+                deleteProperty () {
+                    return false;
+                }
+            });
+        }
+    }
+};

package/dist/cjs/341.js

@@ -0,0 +1,43 @@
+"use strict";
+exports.ids = [
+    "341"
+];
+exports.modules = {
+    "../sandbox/src/error.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        __webpack_require__.d(__webpack_exports__, {
+            ES: ()=>SandboxError,
+            YA: ()=>SandboxInstanceGoneError,
+            sX: ()=>SandboxAbortError,
+            zf: ()=>isAbortError
+        });
+        var node_http__rspack_import_0 = __webpack_require__("node:http");
+        class SandboxError extends Error {
+            toJSON() {
+                return {
+                    code: this.code,
+                    ...void 0 !== this.status ? {
+                        status: this.status
+                    } : {},
+                    message: this.message
+                };
+            }
+            constructor(message, options = {}){
+                super(message);
+                this.name = "SandboxError";
+                if (Number.isInteger(options.status) && options.status >= 100 && options.status <= 599) this.status = options.status;
+                const statusName = void 0 !== this.status && this.status >= 400 ? node_http__rspack_import_0.STATUS_CODES[this.status] : void 0;
+                this.code = statusName?.replace(/[^A-Za-z0-9]/g, "") || "SandboxError";
+            }
+        }
+        class SandboxAbortError extends SandboxError {
+        }
+        class SandboxInstanceGoneError extends SandboxError {
+        }
+        function isAbortError(error) {
+            if (error instanceof SandboxAbortError) return true;
+            if (error instanceof Error && "AbortError" === error.name) return true;
+            const value = error;
+            return value?.name === "AbortError" || value?.code === "ABORT_ERR";
+        }
+    }
+};