agentic-engage

agentic-engage

agentic-engage は、承認ステップ、ローカルレシート、汎用 HTTP アダプターを備えた、Node.js 開発者とエージェント向けのオープンソースのエンゲージメントキューです。

インストール

npm install agentic-engage

Node.js 18 以降が必要です。TypeScript の型宣言と、2 つのランタイム依存関係が含まれています。

最初のアクションをプレビューする

これを preview.mjs として保存し、node preview.mjs を実行します。認証情報は不要です。

import {
  createEngagementQueue, planEngagement, approveEngagement,
  executeEngagement, getCostReport,
} from "agentic-engage";

const queue = createEngagementQueue();
const [draft] = planEngagement(
  [{ id: "post-1", platform: "webhook", context: "your launch" }],
  "Helpful brand", queue,
);
approveEngagement(draft.id, queue);
const preview = await executeEngagement(draft.id, { queue });
console.log(preview.dryRun, preview.action.status); // true approved
console.log(getCostReport()); // entries: [], dispatches: 0, units: 0

成功すると true approved と表示され、ディスパッチ費用はゼロになります。プレビューでは配信リクエストは送信されません。

機能と対応状況

• 下書き： AI 支援に関する開示を含む固定テンプレートのテキストを生成します。
• レビュー： アクションを承認または拒否します。実行には承認済みのステータスが必要です。
• キュー： ターゲット ID の重複を排除し、インメモリ監査ログを保持します。
• HTTP アダプター： 指定したエンドポイントにターゲットとテキストを POST します。
• ガード： 任意で、ディスパッチ上限、UTC の静穏時間帯、テキストのブロックリストを設定できます。

ターゲットラベル	ネイティブ連携の状況
Reddit	スキャフォールド。汎用 HTTP またはローカルレシートのみ
X (Twitter)	スキャフォールド。汎用 HTTP またはローカルレシートのみ
LinkedIn	スキャフォールド。汎用 HTTP またはローカルレシートのみ
YouTube	スキャフォールド。汎用 HTTP またはローカルレシートのみ
Bluesky	スキャフォールド。汎用 HTTP またはローカルレシートのみ
Webhook	汎用 HTTP アダプターを実装済み。エンドポイントは呼び出し側が指定

6 つのターゲットラベルは、2 種類のエンゲージメントアダプタークラスを共有します。ネイティブのソーシャル API について、認証情報の検証は行われていません。 ライブラリの adapters マップで new HttpEngagementAdapter("webhook", { endpoint }) を使用します。 認証とプラットフォームへの配信は、エンドポイント側で処理します。ベンダー用の環境変数や .env ローダーはありません。

ランタイムのインターフェース

CLI コマンド：plan、queue、approve、deny、send、costs、mcp。また、--help と --version も使用できます。 Model Context Protocol (MCP) を利用するには、npx agentic-engage mcp または npx --package agentic-engage agentic-engage-mcp を実行します。 ツール：plan_engagement、get_engagement_queue、approve_engagement、deny_engagement、execute_engagement、get_cost_report。 ワーカーのソースは GET /health、POST /summarize、POST /plan を公開します。デプロイはご自身で行ってください。

制限事項と状況

キューと費用はプロセスの終了時にリセットされます。CLI を別々に実行してもアクションは共有されません。 CLI と MCP のライブ実行ではローカルレシートが使われ、HTTP アダプターは設定できません。 アダプターを指定しない場合、ライブラリの実行も live: true であってもデフォルトではローカルレシートを使用します。 そのため、sent ステータスはソーシャルメディアへの投稿が行われたことを証明するものではありません。HTTP レシートでは、ローカルで生成された ID が使われます。 HTTP リクエストのデフォルトのタイムアウトは 10 秒で、リトライはありません。費用は通貨ではなく文字数で計算されます。 下書きには固定のテキストテンプレートが使われ、言語モデルによる生成は行われません。アカウントの所有者確認は行われません。 バージョン 0.1.0 の API は変更される可能性があります。マネージド型のソーシャルメディア配信サービスは含まれていません。

リンクとライセンス

パッケージとリリース · MIT ライセンス