What is this?

Author: blove

.github/workflows/ci.yml

@@ -0,0 +1,71 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  library:
+    name: Library — lint / test / build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+      - run: npm ci
+      - run: npx nx lint stream-resource
+      - run: npx nx test stream-resource --coverage
+      - run: npx nx build stream-resource --configuration=production
+
+  website:
+    name: Website — lint / build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+      - run: npm ci
+      - run: npx nx lint website
+      # nx build website triggers demo:build first (dependsOn in project.json)
+      - run: npx nx build website
+
+  mcp:
+    name: MCP — build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+      - run: npm ci
+      - run: npx nx build mcp
+
+  deploy:
+    name: Deploy → Vercel
+    needs: [library, website, mcp]
+    runs-on: ubuntu-latest
+    # Only deploy on pushes to main, not on pull requests
+    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+      # Vercel re-runs the full build on its servers using vercel.json buildCommand.
+      # Required GitHub secrets (Settings → Secrets and variables → Actions):
+      #   VERCEL_TOKEN      — vercel.com/account/tokens
+      #   VERCEL_ORG_ID     — from .vercel/project.json after `vercel link`
+      #   VERCEL_PROJECT_ID — from .vercel/project.json after `vercel link`
+      - name: Deploy to Vercel (production)
+        run: npx vercel deploy --prod --yes --token=${{ secrets.VERCEL_TOKEN }}
+        env:
+          VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
+          VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}

.github/workflows/e2e.yml

@@ -0,0 +1,52 @@
+name: E2E
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  e2e:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          python-version: "3.12"
+
+      - name: Install npm dependencies
+        run: npm ci
+
+      - name: Install Python dependencies
+        working-directory: examples/chat-agent
+        run: uv sync
+
+      - name: Start LangGraph dev server
+        working-directory: examples/chat-agent
+        run: uv run langgraph dev --no-browser &
+        env:
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          LANGSMITH_API_KEY: ${{ secrets.LANGSMITH_API_KEY }}
+          LANGSMITH_TRACING: "true"
+          LANGSMITH_PROJECT: stream-resource-e2e-ci
+
+      - name: Wait for server to be ready
+        run: |
+          echo "Waiting for LangGraph server..."
+          for i in {1..30}; do
+            curl -sf http://localhost:2024/ok && echo "Server ready" && break
+            echo "Attempt $i/30..."
+            sleep 2
+          done
+          curl -sf http://localhost:2024/ok || (echo "Server failed to start after 60s" && exit 1)
+
+      - name: Run e2e tests
+        run: npx nx e2e stream-resource-e2e
+        env:
+          LANGGRAPH_URL: http://localhost:2024

.github/workflows/publish.yml

@@ -0,0 +1,24 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+          registry-url: https://registry.npmjs.org
+      - run: npm ci
+      - run: npx nx test stream-resource
+      - run: npx nx build stream-resource --configuration=production
+      - name: Publish to npm
+        run: npx nx-release-publish stream-resource
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -0,0 +1,29 @@
+# Worktrees
+.worktrees/
+.superpowers/
+
+# Node
+node_modules/
+dist/
+.next/
+
+# Nx
+.nx/cache/
+.nx/workspace-data
+tmp/
+apps/website/test-results/
+apps/website/public/demo/
+
+# Env
+.env
+.env.local
+
+# OS
+.DS_Store
+
+.angular
+
+# Next.js
+.next
+out
+.vercel

.npmrc

@@ -0,0 +1 @@
+legacy-peer-deps=true

.prettierignore

@@ -0,0 +1,7 @@
+# Add files here to ignore them from prettier formatting
+/dist
+/coverage
+/.nx/cache
+/.nx/workspace-data
+
+.angular

.prettierrc

@@ -0,0 +1,3 @@
+{
+  "singleQuote": true
+}

.verdaccio/config.yml

@@ -0,0 +1,28 @@
+# path to a directory with all packages
+storage: ../tmp/local-registry/storage
+
+# a list of other known repositories we can talk to
+uplinks:
+  npmjs:
+    url: https://registry.npmjs.org/
+    maxage: 60m
+
+packages:
+  '**':
+    # give all users (including non-authenticated users) full access
+    # because it is a local registry
+    access: $all
+    publish: $all
+    unpublish: $all
+
+    # if package is not available locally, proxy requests to npm registry
+    proxy: npmjs
+
+# log settings
+log:
+  type: stdout
+  format: pretty
+  level: warn
+
+publish:
+  allow_offline: true # set offline to true to allow publish offline

COMMERCIAL.md

@@ -0,0 +1,29 @@
+# Commercial Licensing
+
+`@cacheplane/stream-resource` is source-available software dual-licensed under:
+
+- **PolyForm Noncommercial 1.0.0** — free for noncommercial use (see [`LICENSE`](./LICENSE))
+- **StreamResource Commercial License** — required for commercial use (see [`LICENSE-COMMERCIAL`](./LICENSE-COMMERCIAL))
+
+## What requires a commercial license?
+
+Any use in a for-profit product, service, or organization requires a paid commercial license. This includes:
+
+- Production applications at for-profit companies
+- SaaS products or internal tools at revenue-generating organizations
+- Consulting or client work where the software is deployed commercially
+
+## License tiers
+
+| Tier | Price | Scope |
+|---|---|---|
+| **Developer Seat** | $500 / seat / year | One developer, all environments, 12-month release lock |
+| **App Deployment** | $2,000 / app (one-time) | One named application, all developers, perpetual for version |
+| **Enterprise** | Custom | Volume licensing, priority support, custom contract |
+
+## Purchase or inquire
+
+- Website: https://stream-resource.dev/pricing
+- Email: hello@cacheplane.ai
+
+See [`LICENSE-COMMERCIAL`](./LICENSE-COMMERCIAL) for the full commercial license terms.

LICENSE

@@ -0,0 +1,144 @@
+PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+Copyright (c) 2026 Brian Love d/b/a cacheplane
+
+## Acceptance
+
+In order to get any license under these terms, you must agree
+to them as both strict obligations and conditions to all
+your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the
+software to do everything you might do with the software
+that would otherwise infringe the licensor's copyright
+in it for any permitted purpose. However, you may
+only distribute the software according to Distribution
+License and make changes or new works based on the
+software according to Changes and New Works License.
+
+## Distribution License
+
+The licensor grants you an additional copyright license
+to distribute copies of the software. Your license
+to distribute covers distributing the software with
+changes and new works permitted by Changes and New
+Works License.
+
+## Notices
+
+You must ensure that anyone who gets a copy of
+any part of the software from you also gets a
+copy of these terms or the URL for them above,
+as well as copies of any plain-text lines beginning
+with `Required Notice:` that the licensor provided
+with the software. For example:
+
+> Required Notice: Copyright (c) 2026 Brian Love d/b/a cacheplane
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license
+to make changes and new works based on the software
+for any permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the
+software that covers patent claims the licensor can
+license, or becomes able to license, that you would
+infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for
+the benefit of public knowledge, personal study, private
+entertainment, hobby projects, amateur pursuits, or religious
+observance, without any anticipated commercial application,
+is use for a noncommercial purpose.
+
+## Noncommercial Organizations
+
+Use in the scope of an organization with no substantial
+commercial activity is use for a noncommercial purpose.
+Substantial commercial activity does not include
+providing software to an organization with substantial
+commercial activity if the software is not itself
+a commercial product.
+
+## Fair Use
+
+You may have "fair use" rights for the software under
+the law. These terms do not limit them.
+
+## Free Trial
+
+Use to evaluate whether the software suits a particular
+application for less than 32 consecutive calendar days,
+on behalf of you or your organization, is use for a
+noncommercial purpose.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer
+any of your licenses to anyone else, or prevent the
+licensor from granting licenses to anyone else. These
+terms do not imply any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software
+infringes or contributes to infringement of any patent,
+your patent license for the software granted under
+these terms ends immediately. If your employer makes
+such a claim, your patent license ends immediately for
+work on behalf of your employer.
+
+## Violations
+
+The first time you are notified in writing that you
+have violated any of these terms, and you stop your
+violation within 30 days after your notification, your
+license continues forever. Otherwise, your license
+ends immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is,
+without any warranty or condition, and the licensor
+will not be liable to you for any damages arising out
+of these terms or the use or nature of the software,
+under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering
+these terms, and the **software** is the software the
+licensor makes available under these terms.
+
+**You** refers to the individual or entity agreeing
+to these terms.
+
+**Your organization** is any legal entity, sole
+proprietorship, or other kind of organization that
+you work for, plus all organizations that have control
+over, are under the control of, or are under common
+control with that organization. **Control** means
+ownership of substantially all the assets of an entity,
+or the power to direct its management and legal affairs.
+
+**Your licenses** are all the licenses granted to you
+for the software under these terms.
+
+**Use** means anything you do with the software
+requiring one of your licenses.
+
+**Trademark** means trademarks, service marks, and
+similar rights.