@jackwener/opencli 1.6.9 → 1.7.0

package/dist/src/skill-generate.test.js

@@ -0,0 +1,173 @@
+import { describe, expect, it } from 'vitest';
+import { mapOutcomeToSkillOutput } from './skill-generate.js';
+import { Strategy } from './registry.js';
+describe('mapOutcomeToSkillOutput', () => {
+    const baseStats = {
+        endpoint_count: 1,
+        api_endpoint_count: 1,
+        candidate_count: 1,
+        verified: false,
+        repair_attempted: false,
+        explore_dir: '/tmp/test',
+    };
+    it('maps success outcome correctly', () => {
+        const outcome = {
+            status: 'success',
+            adapter: {
+                site: 'demo',
+                name: 'hot',
+                command: 'demo/hot',
+                strategy: Strategy.PUBLIC,
+                path: '/tmp/demo/hot.verified.ts',
+                metadata_path: '/tmp/demo/hot.meta.json',
+                reusability: 'verified-artifact',
+            },
+            reusability: 'verified-artifact',
+            stats: { ...baseStats, verified: true },
+        };
+        const result = mapOutcomeToSkillOutput(outcome);
+        expect(result.conclusion).toBe('success');
+        expect(result.reusability).toBe('verified-artifact');
+        expect(result.command).toBe('demo/hot');
+        expect(result.strategy).toBe('public');
+        expect(result.path).toBe('/tmp/demo/hot.verified.ts');
+        expect(result.message).toContain('demo/hot');
+        expect(result.reason).toBeUndefined();
+        expect(result.suggested_action).toBeUndefined();
+    });
+    it('maps blocked outcome with no-viable-api-surface', () => {
+        const outcome = {
+            status: 'blocked',
+            reason: 'no-viable-api-surface',
+            stage: 'explore',
+            confidence: 'high',
+            message: 'No API endpoints',
+            stats: { ...baseStats, api_endpoint_count: 0 },
+        };
+        const result = mapOutcomeToSkillOutput(outcome);
+        expect(result.conclusion).toBe('blocked');
+        expect(result.reason).toBe('no-viable-api-surface');
+        expect(result.message).toContain('JSON API');
+        expect(result.command).toBeUndefined();
+        expect(result.suggested_action).toBeUndefined();
+    });
+    it('maps blocked outcome with auth-too-complex', () => {
+        const outcome = {
+            status: 'blocked',
+            reason: 'auth-too-complex',
+            stage: 'cascade',
+            confidence: 'high',
+            stats: baseStats,
+        };
+        const result = mapOutcomeToSkillOutput(outcome);
+        expect(result.conclusion).toBe('blocked');
+        expect(result.reason).toBe('auth-too-complex');
+        expect(result.message).toContain('认证');
+    });
+    it('maps blocked outcome with execution-environment-unavailable', () => {
+        const outcome = {
+            status: 'blocked',
+            reason: 'execution-environment-unavailable',
+            stage: 'verify',
+            confidence: 'high',
+            stats: baseStats,
+        };
+        const result = mapOutcomeToSkillOutput(outcome);
+        expect(result.conclusion).toBe('blocked');
+        expect(result.reason).toBe('execution-environment-unavailable');
+        expect(result.message).toContain('doctor');
+    });
+    it('maps needs-human-check with unsupported-required-args', () => {
+        const outcome = {
+            status: 'needs-human-check',
+            escalation: {
+                stage: 'synthesize',
+                reason: 'unsupported-required-args',
+                confidence: 'high',
+                suggested_action: 'ask-for-sample-arg',
+                candidate: {
+                    name: 'detail',
+                    command: 'demo/detail',
+                    path: '/tmp/demo/detail.verified.ts',
+                    reusability: 'unverified-candidate',
+                },
+            },
+            reusability: 'unverified-candidate',
+            message: 'required args: id',
+            stats: baseStats,
+        };
+        const result = mapOutcomeToSkillOutput(outcome);
+        expect(result.conclusion).toBe('needs-human-check');
+        expect(result.reason).toBe('unsupported-required-args');
+        expect(result.suggested_action).toBe('ask-for-sample-arg');
+        expect(result.reusability).toBe('unverified-candidate');
+        expect(result.path).toBe('/tmp/demo/detail.verified.ts');
+        expect(result.message).toContain('required args: id');
+    });
+    it('maps needs-human-check with empty-result (inspect-with-browser)', () => {
+        const outcome = {
+            status: 'needs-human-check',
+            escalation: {
+                stage: 'fallback',
+                reason: 'empty-result',
+                confidence: 'low',
+                suggested_action: 'inspect-with-browser',
+                candidate: {
+                    name: 'hot',
+                    command: 'demo/hot',
+                    path: null,
+                    reusability: 'unverified-candidate',
+                },
+            },
+            reusability: 'unverified-candidate',
+            stats: { ...baseStats, repair_attempted: true },
+        };
+        const result = mapOutcomeToSkillOutput(outcome);
+        expect(result.conclusion).toBe('needs-human-check');
+        expect(result.reason).toBe('empty-result');
+        expect(result.suggested_action).toBe('inspect-with-browser');
+        expect(result.path).toBeUndefined();
+        expect(result.message).toContain('空结果');
+    });
+    it('maps needs-human-check with verify-inconclusive and path', () => {
+        const outcome = {
+            status: 'needs-human-check',
+            escalation: {
+                stage: 'verify',
+                reason: 'verify-inconclusive',
+                confidence: 'low',
+                suggested_action: 'manual-review',
+                candidate: {
+                    name: 'hot',
+                    command: 'demo/hot',
+                    path: '/tmp/demo/hot.verified.ts',
+                    reusability: 'unverified-candidate',
+                },
+            },
+            reusability: 'unverified-candidate',
+            stats: baseStats,
+        };
+        const result = mapOutcomeToSkillOutput(outcome);
+        expect(result.conclusion).toBe('needs-human-check');
+        expect(result.reason).toBe('verify-inconclusive');
+        expect(result.suggested_action).toBe('manual-review');
+        expect(result.path).toBe('/tmp/demo/hot.verified.ts');
+        expect(result.message).toContain('/tmp/demo/hot.verified.ts');
+    });
+    it('output satisfies SkillOutput contract shape', () => {
+        const outcome = {
+            status: 'blocked',
+            reason: 'no-viable-candidate',
+            stage: 'synthesize',
+            confidence: 'medium',
+            stats: baseStats,
+        };
+        const result = mapOutcomeToSkillOutput(outcome);
+        // Every SkillOutput must have conclusion + message
+        expect(result).toHaveProperty('conclusion');
+        expect(result).toHaveProperty('message');
+        expect(['success', 'blocked', 'needs-human-check']).toContain(result.conclusion);
+        expect(typeof result.message).toBe('string');
+        expect(result.message.length).toBeGreaterThan(0);
+    });
+});

package/dist/src/synthesize.d.ts

@@ -1,6 +1,6 @@
 /**
  * Synthesize candidate CLIs from explore artifacts.
- * Generates evaluate-based YAML pipelines (matching hand-written adapter patterns).
+ * Generates evaluate-based pipelines (matching hand-written adapter patterns).
  */
 import type { ExploreAuthSummary, ExploreEndpointArtifact, ExploreManifest } from './explore.js';
 interface RecommendedArg {

package/dist/src/synthesize.js

@@ -1,10 +1,9 @@
 /**
  * Synthesize candidate CLIs from explore artifacts.
- * Generates evaluate-based YAML pipelines (matching hand-written adapter patterns).
+ * Generates evaluate-based pipelines (matching hand-written adapter patterns).
  */
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-import yaml from 'js-yaml';
 import { VOLATILE_PARAMS, SEARCH_PARAMS, LIMIT_PARAMS, PAGINATION_PARAMS } from './constants.js';
 export function synthesizeFromExplore(target, opts = {}) {
     const exploreDir = resolveExploreDir(target);
@@ -20,8 +19,8 @@ export function synthesizeFromExplore(target, opts = {}) {
         if (!endpoint)
             continue;
         const candidate = buildCandidateYaml(site, bundle.manifest, cap, endpoint);
-        const filePath = path.join(targetDir, `${candidate.name}.yaml`);
-        fs.writeFileSync(filePath, yaml.dump(candidate.yaml, { sortKeys: false, lineWidth: 120 }));
+        const filePath = path.join(targetDir, `${candidate.name}.json`);
+        fs.writeFileSync(filePath, JSON.stringify(candidate.yaml, null, 2));
         candidates.push({ name: candidate.name, path: filePath, strategy: cap.strategy });
     }
     const index = { site, target_url: bundle.manifest.target_url, generated_from: exploreDir, candidate_count: candidates.length, candidates };
@@ -94,7 +93,7 @@ function buildTemplatedUrl(rawUrl, cap, _endpoint) {
 }
 /**
  * Build inline evaluate script for browser-based fetch+parse.
- * Follows patterns from bilibili/hot.yaml and twitter/trending.yaml.
+ * Follows patterns from bilibili/hot.ts and twitter/trending.ts.
  */
 function buildEvaluateScript(url, itemPath, endpoint) {
     const pathChain = itemPath.split('.').map((p) => `?.${p}`).join('');
@@ -117,7 +116,7 @@ function buildEvaluateScript(url, itemPath, endpoint) {
         '})()\n',
     ].join('\n');
 }
-// ── YAML pipeline generation ───────────────────────────────────────────────
+// ── Pipeline generation ────────────────────────────────────────────────────
 function buildCandidateYaml(site, manifest, cap, endpoint) {
     const needsBrowser = cap.strategy !== 'public';
     const pipeline = [];
@@ -153,13 +152,13 @@ function buildCandidateYaml(site, manifest, cap, endpoint) {
         pipeline.push({ tap: tapStep });
     }
     else if (needsBrowser) {
-        // Browser-based: navigate + evaluate (like bilibili/hot.yaml, twitter/trending.yaml)
+        // Browser-based: navigate + evaluate (like bilibili/hot, twitter/trending)
         pipeline.push({ navigate: manifest.target_url });
         const itemPath = cap.itemPath ?? 'data.data.list';
         pipeline.push({ evaluate: buildEvaluateScript(templatedUrl, itemPath, endpoint) });
     }
     else {
-        // Public API: direct fetch (like hackernews/top.yaml)
+        // Public API: direct fetch (like hackernews/top)
         pipeline.push({ fetch: { url: templatedUrl } });
         if (cap.itemPath)
             pipeline.push({ select: cap.itemPath });

package/dist/src/types.d.ts

@@ -85,7 +85,9 @@ export interface IPage {
     closeWindow?(): Promise<void>;
     /** Returns the current page URL, or null if unavailable. */
     getCurrentUrl?(): Promise<string | null>;
-    /** Returns the active tab ID, or undefined if not yet resolved. */
+    /** Returns the active page identity (targetId), or undefined if not yet resolved. */
+    getActivePage?(): string | undefined;
+    /** @deprecated Use getActivePage() instead */
     getActiveTabId?(): number | undefined;
     /** Send a raw CDP command via chrome.debugger passthrough. */
     cdp?(method: string, params?: Record<string, unknown>): Promise<unknown>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jackwener/opencli",
-  "version": "1.6.9",
+  "version": "1.7.0",
   "publishConfig": {
     "access": "public"
   },
@@ -48,13 +48,14 @@
     "copy-yaml": "node scripts/copy-yaml.cjs",
     "start": "node dist/src/main.js",
     "start:bun": "bun dist/src/main.js",
+    "preuninstall": "node -e \"fetch('http://127.0.0.1:19825/shutdown',{method:'POST',headers:{'X-OpenCLI':'1'},signal:AbortSignal.timeout(3000)}).catch(()=>{})\" || true",
     "postinstall": "node scripts/postinstall.js || true; node scripts/fetch-adapters.js || true",
     "typecheck": "tsc --noEmit",
     "lint": "tsc --noEmit",
     "prepare": "[ -d src ] && npm run build || true",
     "prepublishOnly": "npm run build",
-    "test": "vitest run --project unit",
-    "test:bun": "bun vitest run --project unit",
+    "test": "vitest run --project unit --project extension",
+    "test:bun": "bun vitest run --project unit --project extension",
     "test:adapter": "vitest run --project adapter",
     "test:all": "vitest run",
     "test:e2e": "vitest run --project e2e",

package/dist/clis/bilibili/hot.yaml

@@ -1,38 +0,0 @@
-site: bilibili
-name: hot
-description: B站热门视频
-domain: www.bilibili.com
-
-args:
-  limit:
-    type: int
-    default: 20
-    description: Number of videos
-
-pipeline:
-  - navigate: https://www.bilibili.com
-
-  - evaluate: |
-      (async () => {
-        const res = await fetch('https://api.bilibili.com/x/web-interface/popular?ps=${{ args.limit }}&pn=1', {
-          credentials: 'include'
-        });
-        const data = await res.json();
-        return (data?.data?.list || []).map((item) => ({
-          title: item.title,
-          author: item.owner?.name,
-          play: item.stat?.view,
-          danmaku: item.stat?.danmaku,
-        }));
-      })()
-
-  - map:
-      rank: ${{ index + 1 }}
-      title: ${{ item.title }}
-      author: ${{ item.author }}
-      play: ${{ item.play }}
-      danmaku: ${{ item.danmaku }}
-
-  - limit: ${{ args.limit }}
-
-columns: [rank, title, author, play, danmaku]

package/dist/clis/bluesky/feeds.yaml

@@ -1,29 +0,0 @@
-site: bluesky
-name: feeds
-description: Popular Bluesky feed generators
-domain: public.api.bsky.app
-strategy: public
-browser: false
-
-args:
-  limit:
-    type: int
-    default: 20
-    description: Number of feeds
-
-pipeline:
-  - fetch:
-      url: https://public.api.bsky.app/xrpc/app.bsky.unspecced.getPopularFeedGenerators?limit=${{ args.limit }}
-
-  - select: feeds
-
-  - map:
-      rank: ${{ index + 1 }}
-      name: ${{ item.displayName }}
-      likes: ${{ item.likeCount }}
-      creator: ${{ item.creator.handle }}
-      description: ${{ item.description }}
-
-  - limit: ${{ args.limit }}
-
-columns: [rank, name, likes, creator, description]

package/dist/clis/bluesky/followers.yaml

@@ -1,33 +0,0 @@
-site: bluesky
-name: followers
-description: List followers of a Bluesky user
-domain: public.api.bsky.app
-strategy: public
-browser: false
-
-args:
-  handle:
-    type: str
-    required: true
-    positional: true
-    description: "Bluesky handle"
-  limit:
-    type: int
-    default: 20
-    description: Number of followers
-
-pipeline:
-  - fetch:
-      url: https://public.api.bsky.app/xrpc/app.bsky.graph.getFollowers?actor=${{ args.handle }}&limit=${{ args.limit }}
-
-  - select: followers
-
-  - map:
-      rank: ${{ index + 1 }}
-      handle: ${{ item.handle }}
-      name: ${{ item.displayName }}
-      description: ${{ item.description }}
-
-  - limit: ${{ args.limit }}
-
-columns: [rank, handle, name, description]

package/dist/clis/bluesky/following.yaml

@@ -1,33 +0,0 @@
-site: bluesky
-name: following
-description: List accounts a Bluesky user is following
-domain: public.api.bsky.app
-strategy: public
-browser: false
-
-args:
-  handle:
-    type: str
-    required: true
-    positional: true
-    description: "Bluesky handle"
-  limit:
-    type: int
-    default: 20
-    description: Number of accounts
-
-pipeline:
-  - fetch:
-      url: https://public.api.bsky.app/xrpc/app.bsky.graph.getFollows?actor=${{ args.handle }}&limit=${{ args.limit }}
-
-  - select: follows
-
-  - map:
-      rank: ${{ index + 1 }}
-      handle: ${{ item.handle }}
-      name: ${{ item.displayName }}
-      description: ${{ item.description }}
-
-  - limit: ${{ args.limit }}
-
-columns: [rank, handle, name, description]

package/dist/clis/bluesky/profile.yaml

@@ -1,27 +0,0 @@
-site: bluesky
-name: profile
-description: Get Bluesky user profile info
-domain: public.api.bsky.app
-strategy: public
-browser: false
-
-args:
-  handle:
-    type: str
-    required: true
-    positional: true
-    description: "Bluesky handle (e.g. bsky.app, jay.bsky.team)"
-
-pipeline:
-  - fetch:
-      url: https://public.api.bsky.app/xrpc/app.bsky.actor.getProfile?actor=${{ args.handle }}
-
-  - map:
-      handle: ${{ item.handle }}
-      name: ${{ item.displayName }}
-      followers: ${{ item.followersCount }}
-      following: ${{ item.followsCount }}
-      posts: ${{ item.postsCount }}
-      description: ${{ item.description }}
-
-columns: [handle, name, followers, following, posts, description]

package/dist/clis/bluesky/search.yaml

@@ -1,34 +0,0 @@
-site: bluesky
-name: search
-description: Search Bluesky users
-domain: public.api.bsky.app
-strategy: public
-browser: false
-
-args:
-  query:
-    type: str
-    required: true
-    positional: true
-    description: Search query
-  limit:
-    type: int
-    default: 10
-    description: Number of results
-
-pipeline:
-  - fetch:
-      url: https://public.api.bsky.app/xrpc/app.bsky.actor.searchActors?q=${{ args.query }}&limit=${{ args.limit }}
-
-  - select: actors
-
-  - map:
-      rank: ${{ index + 1 }}
-      handle: ${{ item.handle }}
-      name: ${{ item.displayName }}
-      followers: ${{ item.followersCount }}
-      description: ${{ item.description }}
-
-  - limit: ${{ args.limit }}
-
-columns: [rank, handle, name, followers, description]

package/dist/clis/bluesky/starter-packs.yaml

@@ -1,34 +0,0 @@
-site: bluesky
-name: starter-packs
-description: Get starter packs created by a Bluesky user
-domain: public.api.bsky.app
-strategy: public
-browser: false
-
-args:
-  handle:
-    type: str
-    required: true
-    positional: true
-    description: "Bluesky handle"
-  limit:
-    type: int
-    default: 10
-    description: Number of starter packs
-
-pipeline:
-  - fetch:
-      url: https://public.api.bsky.app/xrpc/app.bsky.graph.getActorStarterPacks?actor=${{ args.handle }}&limit=${{ args.limit }}
-
-  - select: starterPacks
-
-  - map:
-      rank: ${{ index + 1 }}
-      name: ${{ item.record.name }}
-      description: ${{ item.record.description }}
-      members: ${{ item.listItemCount }}
-      joins: ${{ item.joinedAllTimeCount }}
-
-  - limit: ${{ args.limit }}
-
-columns: [rank, name, description, members, joins]

package/dist/clis/bluesky/thread.yaml

@@ -1,32 +0,0 @@
-site: bluesky
-name: thread
-description: Get a Bluesky post thread with replies
-domain: public.api.bsky.app
-strategy: public
-browser: false
-
-args:
-  uri:
-    type: str
-    required: true
-    positional: true
-    description: "Post AT URI (at://did:.../app.bsky.feed.post/...) or bsky.app URL"
-  limit:
-    type: int
-    default: 20
-    description: Number of replies
-
-pipeline:
-  - fetch:
-      url: https://public.api.bsky.app/xrpc/app.bsky.feed.getPostThread?uri=${{ args.uri }}&depth=2
-
-  - select: thread
-
-  - map:
-      author: ${{ item.post.author.handle }}
-      text: ${{ item.post.record.text }}
-      likes: ${{ item.post.likeCount }}
-      reposts: ${{ item.post.repostCount }}
-      replies_count: ${{ item.post.replyCount }}
-
-columns: [author, text, likes, reposts, replies_count]

package/dist/clis/bluesky/trending.yaml

@@ -1,27 +0,0 @@
-site: bluesky
-name: trending
-description: Trending topics on Bluesky
-domain: public.api.bsky.app
-strategy: public
-browser: false
-
-args:
-  limit:
-    type: int
-    default: 20
-    description: Number of topics
-
-pipeline:
-  - fetch:
-      url: https://public.api.bsky.app/xrpc/app.bsky.unspecced.getTrendingTopics
-
-  - select: topics
-
-  - map:
-      rank: ${{ index + 1 }}
-      topic: ${{ item.topic }}
-      link: ${{ item.link }}
-
-  - limit: ${{ args.limit }}
-
-columns: [rank, topic, link]

package/dist/clis/bluesky/user.yaml

@@ -1,34 +0,0 @@
-site: bluesky
-name: user
-description: Get recent posts from a Bluesky user
-domain: public.api.bsky.app
-strategy: public
-browser: false
-
-args:
-  handle:
-    type: str
-    required: true
-    positional: true
-    description: "Bluesky handle (e.g. bsky.app)"
-  limit:
-    type: int
-    default: 20
-    description: Number of posts
-
-pipeline:
-  - fetch:
-      url: https://public.api.bsky.app/xrpc/app.bsky.feed.getAuthorFeed?actor=${{ args.handle }}&limit=${{ args.limit }}
-
-  - select: feed
-
-  - map:
-      rank: ${{ index + 1 }}
-      text: ${{ item.post.record.text }}
-      likes: ${{ item.post.likeCount }}
-      reposts: ${{ item.post.repostCount }}
-      replies: ${{ item.post.replyCount }}
-
-  - limit: ${{ args.limit }}
-
-columns: [rank, text, likes, reposts, replies]

package/dist/clis/devto/tag.yaml

@@ -1,34 +0,0 @@
-site: devto
-name: tag
-description: Latest DEV.to articles for a specific tag
-domain: dev.to
-strategy: public
-browser: false
-
-args:
-  tag:
-    type: str
-    required: true
-    positional: true
-    description: "Tag name (e.g. javascript, python, webdev)"
-  limit:
-    type: int
-    default: 20
-    description: Number of articles
-
-pipeline:
-  - fetch:
-      url: https://dev.to/api/articles?tag=${{ args.tag }}&per_page=${{ args.limit }}
-
-  - map:
-      rank: ${{ index + 1 }}
-      title: ${{ item.title }}
-      author: ${{ item.user.username }}
-      reactions: ${{ item.public_reactions_count }}
-      comments: ${{ item.comments_count }}
-      tags: ${{ item.tag_list | join(', ') }}
-      url: ${{ item.url }}
-
-  - limit: ${{ args.limit }}
-
-columns: [rank, title, author, reactions, comments, tags]

package/dist/clis/devto/top.yaml

@@ -1,29 +0,0 @@
-site: devto
-name: top
-description: Top DEV.to articles of the day
-domain: dev.to
-strategy: public
-browser: false
-
-args:
-  limit:
-    type: int
-    default: 20
-    description: Number of articles
-
-pipeline:
-  - fetch:
-      url: https://dev.to/api/articles?top=1&per_page=${{ args.limit }}
-
-  - map:
-      rank: ${{ index + 1 }}
-      title: ${{ item.title }}
-      author: ${{ item.user.username }}
-      reactions: ${{ item.public_reactions_count }}
-      comments: ${{ item.comments_count }}
-      tags: ${{ item.tag_list | join(', ') }}
-      url: ${{ item.url }}
-
-  - limit: ${{ args.limit }}
-
-columns: [rank, title, author, reactions, comments, tags]