Refactor core internals

.changeset/clean-core-refactor.md

@@ -0,0 +1,5 @@
+---
+"@anvia/core": patch
+---
+
+Refactor core internals for improved maintainability while preserving public API and behavior.

.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.1/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": ["docs", "cookbook", "anvia-cli-agent"]
+}

.env.example

@@ -1,4 +1,5 @@
 OPENAI_API_KEY=
+OPENAI_BASEURL=
 
 ANTHROPIC_API_KEY=
 ANTHROPIC_MODEL=claude-sonnet-4-20250514

.github/workflows/ci.yml

@@ -0,0 +1,77 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  packages:
+    name: Packages
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 11.0.4
+          run_install: false
+
+      - name: Setup Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          cache: pnpm
+          cache-dependency-path: pnpm-lock.yaml
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build core package
+        run: pnpm --filter @anvia/core build
+
+      - name: Build remaining packages
+        run: pnpm --filter './packages/**' --filter '!@anvia/core' build
+
+      - name: Typecheck packages
+        run: pnpm --filter './packages/**' typecheck
+
+      - name: Test packages
+        run: pnpm --filter './packages/**' test
+
+  docs:
+    name: Docs
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 11.0.4
+          run_install: false
+
+      - name: Setup Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          cache: pnpm
+          cache-dependency-path: pnpm-lock.yaml
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Typecheck docs
+        run: pnpm --filter docs typecheck
+
+      - name: Build docs
+        run: pnpm --filter docs build

.github/workflows/docs-deploy.yml

@@ -0,0 +1,51 @@
+name: Deploy Docs
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+concurrency:
+  group: docs-production
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    name: Deploy docs
+    runs-on: ubuntu-latest
+    environment: production
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 11.0.4
+          run_install: false
+
+      - name: Setup Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          cache: pnpm
+          cache-dependency-path: pnpm-lock.yaml
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Typecheck docs
+        run: pnpm --filter docs typecheck
+
+      - name: Build docs
+        run: pnpm --filter docs build
+
+      - name: Deploy docs
+        run: pnpm --filter docs run deploy
+        env:
+          CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}

.github/workflows/release.yml

@@ -0,0 +1,104 @@
+name: Release Packages
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: package-release
+  cancel-in-progress: false
+
+jobs:
+  version:
+    name: Create release pull request
+    if: github.event_name == 'push'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 11.0.4
+          run_install: false
+
+      - name: Setup Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          cache: pnpm
+          cache-dependency-path: pnpm-lock.yaml
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Create release pull request
+        uses: changesets/action@v1
+        with:
+          version: pnpm version-packages
+          title: Version Packages
+          commit: Version Packages
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  publish:
+    name: Publish packages to npm
+    if: github.event_name == 'workflow_dispatch'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - name: Require main branch
+        run: |
+          if [ "${GITHUB_REF_NAME}" != "main" ]; then
+            echo "Manual package publishing must run from the main branch."
+            exit 1
+          fi
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 11.0.4
+          run_install: false
+
+      - name: Setup Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          cache: pnpm
+          cache-dependency-path: pnpm-lock.yaml
+          registry-url: https://registry.npmjs.org
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Publish packages
+        run: pnpm release
+        env:
+          NPM_CONFIG_PROVENANCE: true
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Push release tags
+        run: git push --follow-tags
+
+      - name: Create GitHub Releases
+        run: pnpm github-releases
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

CHANGESET_GUIDE.md

@@ -0,0 +1,116 @@
+# Changeset Guide
+
+Use Changesets whenever a change should publish one or more packages from `packages/` to npm.
+
+## When To Add A Changeset
+
+Add a changeset for any user-facing package change:
+
+- `patch`: bug fixes, small behavior fixes, documentation fixes that affect the published package, or internal changes that should ship.
+- `minor`: new backwards-compatible APIs, features, options, exports, or capabilities.
+- `major`: breaking API, behavior, package export, runtime, or type changes.
+
+Do not add a changeset for docs-only changes, CI changes, examples-only changes, or changes to private workspaces.
+
+## Create A Changeset
+
+From the repository root:
+
+```sh
+pnpm changeset
+```
+
+Then:
+
+1. Select every package that should be released.
+2. Choose the bump type for each selected package.
+3. Write a short release note that explains the user-visible change.
+4. Commit the generated file under `.changeset/` with your code changes.
+
+Example changeset text:
+
+```md
+---
+"@anvia/core": minor
+"@anvia/openai": patch
+---
+
+Add streaming metadata support to core runs and align the OpenAI adapter output.
+```
+
+## Before Opening A PR
+
+Run the relevant checks:
+
+```sh
+pnpm install --frozen-lockfile
+pnpm --filter './packages/**' typecheck
+pnpm --filter './packages/**' test
+pnpm --filter './packages/**' build
+```
+
+If docs changed, also run:
+
+```sh
+pnpm --filter docs typecheck
+pnpm --filter docs build
+```
+
+## Release Flow
+
+After a PR with one or more changesets is merged into `main`, the GitHub Actions release workflow runs Changesets.
+
+The workflow will:
+
+1. Open or update a `Version Packages` release PR.
+2. Apply version bumps to changed packages.
+3. Update package changelogs.
+4. Remove consumed `.changeset/*.md` files.
+
+Review the release PR before merging it. Make sure package versions and changelog entries are correct.
+
+## Publish To npm Manually
+
+Merging the `Version Packages` release PR into `main` does not publish to npm. Publishing is manual dispatch only.
+
+Publishing requires the repository secret:
+
+```txt
+NPM_TOKEN
+```
+
+To publish:
+
+1. Merge the `Version Packages` release PR into `main`.
+2. Open GitHub Actions.
+3. Select the `Release Packages` workflow.
+4. Click `Run workflow`.
+5. Run it from the `main` branch.
+
+The manual publish job builds packages before publishing:
+
+```sh
+pnpm release
+```
+
+That command runs:
+
+```sh
+pnpm --filter './packages/**' build && changeset publish
+```
+
+## Manual Version Check
+
+To preview what Changesets sees locally:
+
+```sh
+pnpm exec changeset status --since main
+```
+
+To apply version bumps locally for inspection only:
+
+```sh
+pnpm version-packages
+```
+
+Only commit local version bumps if you are intentionally preparing the release PR by hand. In normal development, let GitHub Actions create the release PR.