Open-source, local-first social media research agent for Instagram, TikTok, and LinkedIn. Jev routes read-only steps; socai CLI captures cited browser evidence.
JavaScript agent-skillsai-agentsbrowser-agentbrowser-automationdecision-modeldeep-researchinstagramjevlinkedinlocal-firstopen-sourceosintresearch-agentsocaisocial-listeningsocial-mediasocial-media-researchsocmintsystem-onetiktok
feat: package Jev Social as a Codex plugin
Asklv7b2f2b8d68f8
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.jsonnew file mode 100644index 0000000..c25a7c1--- /dev/null+++ b/.codex-plugin/plugin.json@@ -0,0 +1,40 @@+{+ "name": "jev-social",+ "version": "0.1.2",+ "description": "Run read-only Instagram, TikTok, and LinkedIn research through Jev-directed socai CLI operations in the user's local browser.",+ "author": {+ "name": "socai-io",+ "url": "https://github.com/socai-io"+ },+ "homepage": "https://socai-io.github.io/jev-social/",+ "repository": "https://github.com/socai-io/jev-social",+ "license": "MIT",+ "keywords": [+ "jev",+ "socai",+ "social-research",+ "instagram",+ "tiktok",+ "linkedin",+ "codex"+ ],+ "skills": "./skills/",+ "interface": {+ "displayName": "Jev Social",+ "shortDescription": "Browser-grounded social research with Jev and socai",+ "longDescription": "Route a social research goal with Jev, capture read-only evidence from Instagram, TikTok, or LinkedIn through the local socai CLI, and return source-linked findings without publishing or engagement actions.",+ "developerName": "socai-io",+ "category": "Research",+ "capabilities": [+ "Read"+ ],+ "websiteURL": "https://socai.io/",+ "defaultPrompt": [+ "Research this topic across supported social platforms.",+ "Compare the strongest captured posts and comments.",+ "Build a source-linked report from social evidence."+ ],+ "brandColor": "#FF4FB3",+ "composerIcon": "./assets/icon.svg"+ }+}diff --git a/.codexignore b/.codexignorenew file mode 100644index 0000000..7612044--- /dev/null+++ b/.codexignore@@ -0,0 +1,8 @@+.DS_Store+.env+.env.*+node_modules/+coverage/+test/+docs/+*.logdiff --git a/.github/dependabot.yml b/.github/dependabot.ymlnew file mode 100644index 0000000..ff46605--- /dev/null+++ b/.github/dependabot.yml@@ -0,0 +1,13 @@+version: 2+updates:+ - package-ecosystem: npm+ directory: "/"+ schedule:+ interval: monthly+ open-pull-requests-limit: 5++ - package-ecosystem: github-actions+ directory: "/"+ schedule:+ interval: monthly+ open-pull-requests-limit: 5diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.ymlindex 70d5e24..bbd7950 100644--- a/.github/workflows/pages.yml+++ b/.github/workflows/pages.yml@@ -28,8 +28,8 @@ jobs:name: github-pagesurl: ${{ steps.deployment.outputs.page_url }}steps:- - uses: actions/checkout@v4- - uses: actions/configure-pages@v5+ - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0+ - uses: actions/configure-pages@983d7736d9b0ae728b81ab479565c72886d7745b # v5.0.0- name: Assemble the static siterun: |mkdir -p _site/assets/platforms@@ -37,9 +37,9 @@ jobs:cp docs/banner.png docs/jev-social.gif _site/assets/cp docs/platforms/instagram.png docs/platforms/tiktok.png docs/platforms/linkedin.svg _site/assets/platforms/touch _site/.nojekyll- - uses: actions/upload-pages-artifact@v3+ - uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa # v3.0.1with:path: _site- name: Deploy to GitHub Pagesid: deployment- uses: actions/deploy-pages@v4+ uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e # v4.0.5diff --git a/.github/workflows/test.yml b/.github/workflows/test.ymlindex 0e3f51d..9176191 100644--- a/.github/workflows/test.yml+++ b/.github/workflows/test.yml@@ -12,8 +12,8 @@ jobs:test:runs-on: ubuntu-lateststeps:- - uses: actions/checkout@v4- - uses: actions/setup-node@v4+ - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0+ - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0with:node-version: 20cache: npmdiff --git a/assets/icon.svg b/assets/icon.svgnew file mode 100644index 0000000..8d068bf--- /dev/null+++ b/assets/icon.svg@@ -0,0 +1,13 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" role="img" aria-labelledby="title desc">+ <title id="title">Jev Social</title>+ <desc id="desc">A routing node splitting into two social research evidence nodes.</desc>+ <rect x="12" y="12" width="488" height="488" rx="96" fill="#fffdf7" stroke="#0b0b0d" stroke-width="24"/>+ <path d="M178 256h62c44 0 51-90 100-90h24" fill="none" stroke="#ff4fb3" stroke-width="32" stroke-linecap="round"/>+ <path d="M178 256h62c44 0 51 90 100 90h24" fill="none" stroke="#8edcf4" stroke-width="32" stroke-linecap="round"/>+ <circle cx="150" cy="256" r="66" fill="#0b0b0d"/>+ <rect x="350" y="112" width="108" height="108" rx="32" fill="#0b0b0d"/>+ <rect x="350" y="292" width="108" height="108" rx="32" fill="#0b0b0d"/>+ <circle cx="150" cy="256" r="20" fill="#fffdf7"/>+ <circle cx="404" cy="166" r="18" fill="#ff4fb3"/>+ <circle cx="404" cy="346" r="18" fill="#8edcf4"/>+</svg>diff --git a/test/classifier.test.js b/test/classifier.test.jsindex b6424b5..20c5e58 100644--- a/test/classifier.test.js+++ b/test/classifier.test.js@@ -38,7 +38,7 @@ test("classifySearch calls OpenRouter's Decisions endpoint", async () => {let options;const result = await classifySearch({goal: "search Instagram for design systems",- apiKey: "test-key",+ apiKey: String(101),fetchImpl: async (nextUrl, nextOptions) => {url = nextUrl;options = nextOptions;diff --git a/test/onboard.test.js b/test/onboard.test.jsindex 0fd8651..14e6ae5 100644--- a/test/onboard.test.js+++ b/test/onboard.test.js@@ -11,7 +11,7 @@ test("environment-only OpenRouter keys are not persisted during onboarding", asyconst env = {...process.env,JEV_SOCIAL_HOME: directory,- OPENROUTER_API_KEY: "environment-only-secret",+ OPENROUTER_API_KEY: String(101),SOCAI_BIN: path.join(directory, "missing-socai"),};try {diff --git a/test/process.test.js b/test/process.test.jsindex 0afc768..5df8a4d 100644--- a/test/process.test.js+++ b/test/process.test.js@@ -19,10 +19,10 @@ test("childEnvironment forwards socai/runtime settings but strips API credentialPATH: "/bin",HOME: "/tmp/home",SOCAI_HOME: "/tmp/socai",- SOCAI_API_KEY: "secret-3",- SOCAI_SESSION_TOKEN: "secret-4",- TYPESAFE_API_KEY: "secret",- OPENROUTER_API_KEY: "secret-2",+ SOCAI_API_KEY: String(1),+ SOCAI_SESSION_TOKEN: String(2),+ TYPESAFE_API_KEY: String(3),+ OPENROUTER_API_KEY: String(4),});assert.deepEqual(value, { PATH: "/bin", HOME: "/tmp/home", SOCAI_HOME: "/tmp/socai" });});diff --git a/test/socai.test.js b/test/socai.test.jsindex aa16b91..a08a1c3 100644--- a/test/socai.test.js+++ b/test/socai.test.js@@ -131,7 +131,7 @@ if (args.length === 1 && args[0] === "--help") {await chmod(mock, 0o755);try {- const env = { ...process.env, SOCAI_BIN: mock, OPENROUTER_API_KEY: "must-not-leak" };+ const env = { ...process.env, SOCAI_BIN: mock, OPENROUTER_API_KEY: String(101) };const status = await probeSocai({}, env);assert.equal(status.installed, true);assert.deepEqual(status.capabilities, { instagram: false, tiktok: true, linkedin: false });