Skip to content

Open-source, local-first social media research agent for Instagram, TikTok, and LinkedIn. Jev routes read-only steps; socai CLI captures cited browser evidence.

feat: package Jev Social as a Codex plugin

Asklv7b2f2b8d68f8
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
new file mode 100644
index 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/.codexignore
new file mode 100644
index 0000000..7612044
--- /dev/null
+++ b/.codexignore
@@ -0,0 +1,8 @@
+.DS_Store
+.env
+.env.*
+node_modules/
+coverage/
+test/
+docs/
+*.log
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
new file mode 100644
index 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: 5
diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml
index 70d5e24..bbd7950 100644
--- a/.github/workflows/pages.yml
+++ b/.github/workflows/pages.yml
@@ -28,8 +28,8 @@ jobs:
name: github-pages
url: ${{ 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 site
run: |
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.1
with:
path: _site
- name: Deploy to GitHub Pages
id: deployment
- uses: actions/deploy-pages@v4
+ uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e # v4.0.5
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 0e3f51d..9176191 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -12,8 +12,8 @@ jobs:
test:
runs-on: ubuntu-latest
steps:
- - uses: actions/checkout@v4
- - uses: actions/setup-node@v4
+ - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+ - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
with:
node-version: 20
cache: npm
diff --git a/assets/icon.svg b/assets/icon.svg
new file mode 100644
index 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.js
index 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.js
index 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", asy
const 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.js
index 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 credential
PATH: "/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.js
index 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 });