@framers/agentos-extensions 1.0.3 → 1.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +32 -23
  2. package/package.json +9 -8
  3. package/registry.json +738 -429
package/README.md CHANGED
@@ -8,11 +8,12 @@
8
8
 
9
9
  Extension source code for AgentOS — tools, channel adapters, integrations, and starter templates.
10
10
 
11
- [![CI Status](https://github.com/framersai/agentos-extensions/workflows/CI/badge.svg)](https://github.com/framersai/agentos-extensions/actions)
11
+ [![CI Status](https://github.com/framerslab/agentos-extensions/workflows/CI/badge.svg)](https://github.com/framerslab/agentos-extensions/actions)
12
12
  [![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
13
- [![API Docs](https://img.shields.io/badge/docs-TypeDoc-blue)](https://framersai.github.io/agentos-extensions/)
13
+ [![API Docs](https://img.shields.io/badge/docs-TypeDoc-blue)](https://framerslab.github.io/agentos-extensions/)
14
14
  [![npm: registry](https://img.shields.io/npm/v/@framers/agentos-extensions-registry?label=registry)](https://www.npmjs.com/package/@framers/agentos-extensions-registry)
15
15
  [![npm: catalog](https://img.shields.io/npm/v/@framers/agentos-extensions?label=catalog)](https://www.npmjs.com/package/@framers/agentos-extensions)
16
+ [![NVIDIA Inception](https://img.shields.io/badge/NVIDIA_Inception-Member-76B900?logo=nvidia&logoColor=white)](https://www.nvidia.com/en-us/startups/)
16
17
 
17
18
  ## What This Package Is
18
19
 
@@ -90,7 +91,7 @@ All extensions are published to npm under the `@framers` scope.
90
91
  | [`@framers/agentos-ext-channel-blog-publisher`](./registry/curated/channels/blog-publisher) | Blog publisher (Dev.to, Hashnode, Medium, WordPress) | [![npm](https://img.shields.io/npm/v/@framers/agentos-ext-channel-blog-publisher)](https://www.npmjs.com/package/@framers/agentos-ext-channel-blog-publisher) |
91
92
  | [`@framers/agentos-ext-channel-pinterest`](./registry/curated/channels/pinterest) | Pinterest social channel (API v5) | [![npm](https://img.shields.io/npm/v/@framers/agentos-ext-channel-pinterest)](https://www.npmjs.com/package/@framers/agentos-ext-channel-pinterest) |
92
93
  | [`@framers/agentos-ext-channel-tiktok`](./registry/curated/channels/tiktok) | TikTok social channel (API for Business) | [![npm](https://img.shields.io/npm/v/@framers/agentos-ext-channel-tiktok)](https://www.npmjs.com/package/@framers/agentos-ext-channel-tiktok) |
93
- | [`@framers/agentos-ext-channel-email`](./registry/curated/channels/email) | Email messaging channel (nodemailer/imapflow) | [![npm](https://img.shields.io/npm/v/@framers/agentos-ext-channel-email)](https://www.npmjs.com/package/@framers/agentos-ext-channel-email) |
94
+ | [`@framers/agentos-ext-channel-email`](./registry/curated/channels/email) | Email messaging channel (SMTP or Resend's HTTPS API, IMAP), with a suppression record and unsubscribe tokens on SQL | [![npm](https://img.shields.io/npm/v/@framers/agentos-ext-channel-email)](https://www.npmjs.com/package/@framers/agentos-ext-channel-email) |
94
95
 
95
96
  ## Two-Tier Extension Pattern
96
97
 
@@ -161,6 +162,7 @@ agentos-extensions/
161
162
  │ │ ├── communications/# Telegram bot, notifications
162
163
  │ │ ├── integrations/ # External services (Telegram API)
163
164
  │ │ ├── media/ # Giphy, image search, voice synthesis
165
+ │ │ ├── meetings/ # Browser-join meeting bot provider (Google Meet, Microsoft Teams)
164
166
  │ │ ├── provenance/ # On-chain anchoring (tip-ingestion package is published separately)
165
167
  │ │ ├── research/ # Web search, deep research, content extraction
166
168
  │ │ ├── safety/ # Stub READMEs -> core packages (see above)
@@ -352,6 +354,7 @@ For the dispatcher mechanics (Phase 1 sanitizers, Phase 2 parallel classifiers,
352
354
  | `email.smtpHost` | `SMTP_HOST` | channel-email |
353
355
  | `email.smtpUser` | `SMTP_USER` | channel-email |
354
356
  | `email.smtpPassword` | `SMTP_PASSWORD` | channel-email |
357
+ | `email.resendApiKey` | `RESEND_API_KEY` | channel-email |
355
358
 
356
359
  #### Selective loading examples
357
360
 
@@ -386,10 +389,7 @@ const manifest = await createCuratedManifest({
386
389
  ### Create a new extension
387
390
 
388
391
  ```bash
389
- # Use the scaffolding script
390
- pnpm run create-extension
391
-
392
- # Or copy a template
392
+ # Copy the template
393
393
  cp -r templates/basic-tool registry/curated/category/my-extension
394
394
  cd registry/curated/category/my-extension
395
395
  pnpm install
@@ -428,11 +428,13 @@ Each extension is versioned and published independently. A change to `web-search
428
428
 
429
429
  All extensions get free CI/CD via GitHub Actions:
430
430
 
431
- - **CI** (`ci.yml`): Lint, test, typecheck on every PR
432
- - **Release** (`release.yml`): Changesets auto-version PRs + npm publish on merge
433
- - **TypeDoc** (`pages-typedoc.yml`): API docs deployed to [framersai.github.io/agentos-extensions](https://framersai.github.io/agentos-extensions/)
434
- - **Extension validation** (`extension-validation.yml`): Manifest & structure checks
435
- - **Dependabot**: Automated dependency updates with auto-merge for patches
431
+ - **CI** (`ci.yml`): builds the AgentOS core and every pack, runs the release-script tests and each pack's tests, and runs the pack guard on every pull request
432
+ - **Release** (`release.yml`): runs CI, then opens the "chore: version packages" pull request or publishes to npm
433
+ - **TypeDoc** (`pages-typedoc.yml`): API docs deployed to [framerslab.github.io/agentos-extensions](https://framerslab.github.io/agentos-extensions/) on a push to `master`, one deploy at a time: a deploy that has started runs to the end, and a push that lands during it waits, the last push to come in replacing any earlier one still waiting
434
+ - **Lockfile** (`lockfile.yml`): resolves the workspace's dependency ranges and offers `pnpm-lock.yaml` as an artifact to commit, run by hand on a branch whose `package.json` files changed
435
+ - **Meeting bot image** (`meeting-bot-image.yml`): builds the browser meeting bot's container image and runs its lifecycle test on every pull request that touches `registry/curated/meetings/browser/`, and pushes the image to GHCR from `master`; the bot's nightly real-join check (`nightly-real-join.yml`) runs daily and by hand, and its capacity measurement on a worker (`measure-meeting-bots.yml`) by hand only, as [the pack's README](./registry/curated/meetings/browser/README.md) describes
436
+ - **Document parser image** (`document-parser-image.yml`): builds the document parser's container image and runs its lifecycle test on a pull request that touches `registry/curated/tools/document-parser/` or `pnpm-lock.yaml`, once it is ready for review, and on a push to `master` that touches the pack, which also pushes the tested image to GHCR as `ghcr.io/framerslab/agentos-document-parser:sha-<commit>`, and once as `:<version>` from the version pull request's merge, as [the release guide](./RELEASING.md) and [the pack's README](./registry/curated/tools/document-parser/README.md) describe. `document-parser.yml` runs the pack's tests on Node 24, beside CI's Node 22, when a pull request or a push to `master` touches the pack, `pnpm-lock.yaml` or `pnpm-workspace.yaml`
437
+ - **Dependabot**: weekly dependency updates. `dependabot-auto-merge.yml` labels an npm minor or patch update `landing`, and posts one comment for its head commit naming the guards that passed, when CI's `build` check and the `links` check have succeeded on that commit, no other workflow check there is pending or failed (skipped and neutral count as passed), every commit is Dependabot's, its review threads are settled and ten minutes have passed since its last push. It never merges: a labelled update lands once its review comments on GitHub are read, those that name a failing input fixed and the rest answered, and its threads resolved. It decides again when a CI or Links run of the update is requested, starts or finishes, when a review is submitted or a comment is made on its diff, and every hour; when a push moves the head or a guard fails, it takes off a label it added, and a label a maintainer added, took off or put back stays. A thread resolved or reopened sends no event a workflow can take, so the next of those runs decides it; a landing waits for every thread to be resolved whatever the label says. Major updates, GitHub Actions updates, and a pull request whose head commit message names a different version than its title (left from an older update after a rebase) wait for a maintainer. The decision is `scripts/dependabot-merge-lib.mjs`. Dependabot updates `pnpm-lock.yaml` with pnpm's `minimumReleaseAge` at three days; `pnpm-workspace.yaml` exempts `@framers/*`, the family whose pins the weekly bump (`bump-framers-deps.yml`) moves to the newest release, and the bump runs Dependabot's update before it opens its pull request
436
438
 
437
439
  ## Quality Standards
438
440
 
@@ -452,7 +454,7 @@ All extensions get free CI/CD via GitHub Actions:
452
454
 
453
455
  ## Documentation
454
456
 
455
- - [API Reference (TypeDoc)](https://framersai.github.io/agentos-extensions/)
457
+ - [API Reference (TypeDoc)](https://framerslab.github.io/agentos-extensions/)
456
458
  - [How Extensions Work](./HOW_EXTENSIONS_WORK.md)
457
459
  - [Extension Architecture](./EXTENSION_ARCHITECTURE.md)
458
460
  - [Auto-Loading Extensions](./AUTO_LOADING_EXTENSIONS.md)
@@ -462,22 +464,29 @@ All extensions get free CI/CD via GitHub Actions:
462
464
  - [Releasing & Publishing](./RELEASING.md)
463
465
  - [Contributing](./CONTRIBUTING.md)
464
466
 
465
- ## Contributing
467
+ ## Contributing and support
466
468
 
467
- See [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed guidelines.
469
+ | Guide | What |
470
+ |---|---|
471
+ | [Contributing](https://github.com/framerslab/agentos-extensions/blob/master/CONTRIBUTING.md) | Development setup, adding a pack, changesets, pull request rules, review threads, contribution licensing |
472
+ | [Release guide](https://github.com/framerslab/agentos-extensions/blob/master/RELEASING.md) | How changesets become npm releases |
473
+ | [Agent instructions](https://github.com/framerslab/agentos-extensions/blob/master/AGENTS.md) | Commands and conventions for coding agents |
474
+ | [Maintainers](https://github.com/framerslab/agentos-extensions/blob/master/MAINTAINERS.md) | Who reviews and merges changes |
475
+ | [Code of Conduct](https://github.com/framerslab/agentos-extensions/blob/master/.github/CODE_OF_CONDUCT.md) | Community standards |
476
+ | [Security Policy](https://github.com/framerslab/agentos-extensions/blob/master/.github/SECURITY.md) | Reporting vulnerabilities privately |
477
+ | [Support](https://github.com/framerslab/agentos-extensions/blob/master/SUPPORT.md) | Where to get help |
468
478
 
469
- - [Submit New Extension](https://github.com/framersai/agentos-extensions/issues/new?template=new-extension.yml)
470
- - [Report Bug](https://github.com/framersai/agentos-extensions/issues/new?template=bug-report.yml)
471
- - [Request Feature](https://github.com/framersai/agentos-extensions/discussions)
479
+ - [Propose a new extension](https://github.com/framerslab/agentos-extensions/issues/new?template=new-extension.yml)
480
+ - [Report a bug](https://github.com/framerslab/agentos-extensions/issues/new?template=bug_report.yml)
481
+ - [Request a feature](https://github.com/framerslab/agentos-extensions/issues/new?template=feature_request.yml)
472
482
 
473
483
  ## Links
474
484
 
475
485
  - **AgentOS**: [agentos.sh](https://agentos.sh)
476
- - **AgentOS GitHub**: [github.com/framersai/agentos](https://github.com/framersai/agentos)
477
- - **Extensions GitHub**: [github.com/framersai/agentos-extensions](https://github.com/framersai/agentos-extensions)
478
- - **Mars Genesis Demo**: [github.com/framersai/mars-genesis-simulation](https://github.com/framersai/mars-genesis-simulation)
486
+ - **AgentOS GitHub**: [github.com/framerslab/agentos](https://github.com/framerslab/agentos)
487
+ - **Extensions GitHub**: [github.com/framerslab/agentos-extensions](https://github.com/framerslab/agentos-extensions)
479
488
  - **npm**: [@framers](https://www.npmjs.com/org/framers)
480
- - **API Docs**: [framersai.github.io/agentos-extensions](https://framersai.github.io/agentos-extensions/)
489
+ - **API Docs**: [framerslab.github.io/agentos-extensions](https://framerslab.github.io/agentos-extensions/)
481
490
  - **Discord**: [wilds.ai/discord](https://wilds.ai/discord)
482
491
  - **Website**: [frame.dev](https://frame.dev)
483
492
  - **Contact**: [team@frame.dev](mailto:team@frame.dev)
@@ -495,6 +504,6 @@ All extensions in this repository are Apache 2.0 licensed.
495
504
  </p>
496
505
 
497
506
  <p align="center">
498
- Built by <a href="https://manic.agency">Manic Agency LLC</a> / <a href="https://frame.dev">Frame.dev</a><br>
507
+ Built by <a href="https://frame.dev">Frame</a><br>
499
508
  Contact: <a href="mailto:team@frame.dev">team@frame.dev</a>
500
509
  </p>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@framers/agentos-extensions",
3
- "version": "1.0.3",
3
+ "version": "1.0.4",
4
4
  "files": [
5
5
  "index.mjs",
6
6
  "registry.json",
@@ -10,7 +10,7 @@
10
10
  "description": "Extension source for AgentOS — implementations, templates, and manifests for tools, channel adapters, and integrations. Companion to the @framers/agentos TypeScript AI agent runtime.",
11
11
  "homepage": "https://agentos.sh",
12
12
  "bugs": {
13
- "url": "https://github.com/framersai/agentos-extensions/issues"
13
+ "url": "https://github.com/framerslab/agentos-extensions/issues"
14
14
  },
15
15
  "type": "module",
16
16
  "sideEffects": false,
@@ -24,7 +24,7 @@
24
24
  },
25
25
  "repository": {
26
26
  "type": "git",
27
- "url": "https://github.com/framersai/agentos-extensions.git"
27
+ "url": "https://github.com/framerslab/agentos-extensions.git"
28
28
  },
29
29
  "keywords": [
30
30
  "agentos",
@@ -72,18 +72,19 @@
72
72
  "devDependencies": {
73
73
  "@atproto/api": "^0.13.0",
74
74
  "@changesets/changelog-github": "^0.5.2",
75
- "@changesets/cli": "^2.29.8",
76
- "masto": "^6.8.0",
75
+ "@changesets/cli": "^3.0.3",
76
+ "masto": "^8.0.0",
77
77
  "typedoc": "^0.28.19",
78
78
  "typescript": "^5.4.5"
79
79
  },
80
80
  "scripts": {
81
81
  "build": "node scripts/build-extensions.js && node scripts/update-registry.js",
82
- "create-extension": "node scripts/create-extension.js",
83
82
  "update-registry": "node scripts/update-registry.js",
84
83
  "docs": "npx typedoc",
85
84
  "changeset": "changeset",
86
- "version-packages": "changeset version",
87
- "release": "changeset publish"
85
+ "version-packages": "changeset version && node scripts/sync-manifest-versions.mjs",
86
+ "release": "changeset publish",
87
+ "test": "node --test scripts/__tests__/*.test.mjs",
88
+ "pack-guard": "node scripts/pack-guard.mjs"
88
89
  }
89
90
  }