@liyang8246/takeit 0.0.0-stage → 0.4.0

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 +22 -2
  2. package/dist/cli.mjs +30 -0
  3. package/package.json +41 -3
package/README.md CHANGED
@@ -1,3 +1,23 @@
1
- # Temporary Holding Version
1
+ # takeit
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ 把一个浏览器标签页交给 agent。
4
+
5
+ 装扩展。点接管。复制 prompt。
6
+
7
+ ```sh
8
+ npx -y @liyang8246/takeit <token> help
9
+ ```
10
+
11
+ 单 tab。单次进程。无常驻桥。
12
+
13
+ ## 开发
14
+
15
+ ```sh
16
+ pnpm install
17
+ pnpm build
18
+ pnpm run ci
19
+ ```
20
+
21
+ 在 Chrome 加载 [extension](<extension/>)。开发使用 Node.js 24.15+;CLI 仍支持 22.18+。
22
+
23
+ Token 即授权。切换即撤权。超时不回滚。
package/dist/cli.mjs ADDED
@@ -0,0 +1,30 @@
1
+ #!/usr/bin/env node
2
+ import{Buffer as B}from"node:buffer";import{writeFile as j}from"node:fs/promises";import{resolve as Z}from"node:path";import f from"node:process";import{parseArgs as G}from"node:util";function E(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}function R(t){return typeof t=="string"&&/^[a-f0-9]{32}$/.test(t)}var M=t=>typeof t=="number"&&Number.isFinite(t);function C(t){return typeof t=="string"&&/^[1-9]\d*$/.test(t)&&Number.isSafeInteger(Number(t))}var b=t=>t===void 0||typeof t=="boolean";function F(t){if(!E(t))return!1;switch(t.op){case"click":return C(t.ref);case"type":return C(t.ref)&&typeof t.text=="string"&&b(t.submit);case"key":return typeof t.key=="string"&&["Enter","Tab","Escape","Backspace","Delete","ArrowUp","ArrowDown","ArrowLeft","ArrowRight"].includes(t.key);case"scroll":return M(t.dy);case"navigate":{if(typeof t.url!="string")return!1;try{return["http:","https:"].includes(new URL(t.url).protocol)}catch{return!1}}case"wait":return M(t.ms)&&t.ms>=0&&t.ms<=1e4;default:return!1}}function T(t){if(!E(t))return!1;switch(t.kind){case"state":return E(t.view)&&b(t.view.id)&&b(t.view.class)&&b(t.view.hidden);case"act":return F(t.act);case"script":return typeof t.code=="string"&&t.code.trim().length>0;case"screenshot":return typeof t.full=="boolean";default:return!1}}function _(t){return E(t)&&typeof t.id=="string"&&(t.ok===!0&&typeof t.data=="string"||t.ok===!1&&typeof t.error=="string")}function V(t,a){let e={state:0,click:1,type:2,key:1,scroll:1,navigate:1,wait:1,script:1,screenshot:1};if(t===void 0||e[t]===void 0)throw new Error(`\u672A\u77E5\u547D\u4EE4\uFF1A${t??""}\uFF1B\u8FD0\u884C takeit help \u67E5\u770B\u7528\u6CD5`);let s=[],n=!1;for(let o=0;o<e[t];o+=1){let i=a.shift();if(!n&&i==="--"&&(n=!0,i=a.shift()),i===void 0||!n&&i.startsWith("--"))throw new Error(`${t} \u7F3A\u5C11\u53C2\u6570\uFF1B\u4EE5 -- \u5F00\u5934\u7684\u6587\u672C\u987B\u653E\u5728\u72EC\u7ACB\u7684 -- \u4E4B\u540E`);s.push(i)}if(n&&a.length)throw new Error("-- \u540E\u53EA\u80FD\u653E\u547D\u4EE4\u6240\u9700\u7684\u6587\u672C\uFF0C\u4E0D\u80FD\u518D\u52A0\u9009\u9879");let r={timeout:{type:"string"},...t==="state"?{"with-id":{type:"boolean"},"with-class":{type:"boolean"},"with-hidden":{type:"boolean"}}:{},...t==="type"?{submit:{type:"boolean"}}:{},...t==="screenshot"?{full:{type:"boolean"}}:{}},{values:c}=G({args:a,options:r,strict:!0,allowPositionals:!1});return{positional:s,values:c}}function U(t){if(t.length===0||["help","--help","-h"].includes(t[0]??""))return null;let[a,e,...s]=t;if(!R(a))throw new Error("token \u5FC5\u987B\u662F\u6269\u5C55\u590D\u5236\u7684 32 \u4F4D\u5B57\u7B26\u4E32\uFF1B\u8BF7\u91CD\u65B0\u590D\u5236 prompt");if(["help","--help","-h"].includes(e??""))return null;let{positional:n,values:r}=V(e,s),c=r.timeout===void 0?3e4/1e3:Number(r.timeout);if(!Number.isFinite(c)||c<=0||c>300)throw new Error("--timeout \u987B\u4E3A\u5927\u4E8E 0 \u4E14\u4E0D\u8D85\u8FC7 300 \u7684\u79D2\u6570");let o=n[0]??"",i;switch(e){case"state":i={kind:"state",view:{id:r["with-id"]===!0,class:r["with-class"]===!0,hidden:r["with-hidden"]===!0}};break;case"click":i={kind:"act",act:{op:e,ref:o}};break;case"type":i={kind:"act",act:{op:e,ref:o,text:n[1]??"",submit:r.submit===!0}};break;case"key":i={kind:"act",act:{op:e,key:o}};break;case"scroll":i={kind:"act",act:{op:e,dy:o.trim()?Number(o):NaN}};break;case"navigate":i={kind:"act",act:{op:e,url:o}};break;case"wait":i={kind:"act",act:{op:e,ms:o.trim()?Number(o):NaN}};break;case"script":i={kind:"script",code:o};break;case"screenshot":if(!o||o.startsWith("--"))throw new Error("screenshot \u9700\u8981\u4E00\u4E2A\u672A\u5B58\u5728\u7684 PNG \u8F93\u51FA\u8DEF\u5F84");i={kind:"screenshot",full:r.full===!0};break;default:throw new Error(`\u672A\u77E5\u547D\u4EE4\uFF1A${e}`)}if(!T(i))throw new Error(`${e} \u53C2\u6570\u65E0\u6548\uFF1Auid \u987B\u4E3A\u6B63\u6574\u6570\uFF0CURL \u987B\u4E3A http/https\uFF0Cwait \u8303\u56F4\u4E3A 0\u201310000ms`);return{token:a,command:i,timeoutMs:c*1e3,...e==="screenshot"?{output:o}:{}}}var $=`takeit \xB7 \u53EA\u64CD\u4F5C\u6269\u5C55\u660E\u786E\u6388\u6743\u7684\u90A3\u4E2A\u6807\u7B7E\u9875
3
+
4
+ \u7528\u6CD5\uFF1Anpx -y @liyang8246/takeit <token> <command> [\u53C2\u6570] [\u9009\u9879]
5
+
6
+ state [--with-id] [--with-class] [--with-hidden] \u8BFB\u53D6 DOM \u5FEB\u7167
7
+ click <uid> \u70B9\u51FB\u5143\u7D20
8
+ type <uid> <text> [--submit] \u66FF\u6362\u8F93\u5165\u5185\u5BB9\uFF0C\u53EF\u6309 Enter \u63D0\u4EA4
9
+ key <key> Enter/Tab/Escape/Backspace/Delete/Arrow\u65B9\u5411\u952E
10
+ scroll <dy> \u5782\u76F4\u6EDA\u52A8\u50CF\u7D20\uFF0C\u53EF\u4E3A\u8D1F\u6570
11
+ navigate <http/https URL> \u5728\u540C\u4E00\u6807\u7B7E\u9875\u5BFC\u822A
12
+ wait <ms> \u7B49\u5F85 0\u201310000 \u6BEB\u79D2
13
+ script <JavaScript> \u5728\u9875\u9762\u4E3B\u4E16\u754C\u6267\u884C\uFF0C\u63D0\u4F9B jQuery
14
+ screenshot <new.png> [--full] \u4FDD\u5B58\u89C6\u53E3/\u6574\u9875 PNG\uFF0C\u4E0D\u8986\u76D6\u5DF2\u6709\u6587\u4EF6
15
+ help \u672C\u5730\u663E\u793A\u8BF4\u660E\uFF0C\u4E0D\u8FDE\u63A5\u6269\u5C55
16
+
17
+ \u6240\u6709\u9875\u9762\u547D\u4EE4\u652F\u6301 --timeout <\u79D2>\uFF08\u9ED8\u8BA4 30\uFF0C\u6700\u5927 300\uFF0C\u5305\u542B\u7B49\u5F85\u7AEF\u53E3\u65F6\u95F4\uFF09\u3002
18
+ \u6587\u672C/\u4EE3\u7801\u4EE5 -- \u5F00\u5934\u65F6\uFF0C\u5728\u5176\u524D\u52A0\u72EC\u7ACB\u7684 --\uFF0C\u5E76\u4E14\u540E\u9762\u4E0D\u518D\u6DFB\u52A0\u9009\u9879\u3002
19
+ \u5FEB\u7167 uid \u7528\u4E8E click/type\uFF1B\u9875\u9762\u5BFC\u822A\u6216\u8282\u70B9\u66FF\u6362\u540E\u5E94\u91CD\u65B0\u8BFB\u53D6 state\u3002
20
+ \u8F93\u51FA\u53EF\u80FD\u5F88\u957F\uFF0C\u5EFA\u8BAE\u91CD\u5B9A\u5411\u6587\u4EF6\u540E\u6309\u9700\u8BFB\u53D6\uFF1B\u64CD\u4F5C\u4EC5\u8FD4\u56DE ok\uFF0C\u9700\u8981\u65F6\u81EA\u5DF1\u8BFB\u53D6 state\u3002
21
+ \u6BCF\u6761\u547D\u4EE4\u4E34\u65F6\u7ED1\u5B9A 127.0.0.1:8737\uFF0C\u5B8C\u6210\u5373\u9000\u51FA\uFF0C\u6CA1\u6709\u540E\u53F0\u670D\u52A1\u3002
22
+ \u7AEF\u53E3\u5FD9\u65F6\u9650\u65F6\u7B49\u5F85\uFF1B\u53EA\u4FDD\u8BC1\u9010\u6761\u4E92\u65A5\uFF0C\u4E0D\u4FDD\u8BC1 FIFO \u6216\u591A agent \u6574\u4E2A\u4EFB\u52A1\u72EC\u5360\u3002
23
+ \u5207\u6362/\u505C\u6B62\u63A5\u7BA1\u540E\uFF0C\u65E7 token \u7ACB\u5373\u5931\u6548\uFF1B\u672C\u673A\u5176\u4ED6\u7A0B\u5E8F\u5360\u7AEF\u53E3\u65F6\u4E5F\u4F1A\u7B49\u5F85\u3002
24
+ \u547D\u4EE4\u5DF2\u9001\u8FBE\u540E\u53D1\u751F\u8D85\u65F6/\u4E2D\u65AD\uFF0C\u6267\u884C\u7ED3\u679C\u672A\u77E5\uFF1B\u5148\u68C0\u67E5\u9875\u9762\uFF0C\u4E0D\u8981\u81EA\u52A8\u91CD\u8BD5\u526F\u4F5C\u7528\u3002
25
+ \u4E0B\u5355\u3001\u53D1\u6D88\u606F\u3001\u5220\u9664\u7B49\u4E0D\u53EF\u9006\u64CD\u4F5C\uFF0C\u5148\u5F81\u6C42\u7528\u6237\u786E\u8BA4\u3002
26
+ `;import{Buffer as J}from"node:buffer";import{randomUUID as H}from"node:crypto";import{createServer as W}from"node:http";import{setTimeout as z}from"node:timers/promises";var Y=32*1024*1024;function K(t,a){return new Promise((e,s)=>{function n(){t.off("error",r),t.off("listening",c)}function r(o){n(),s(o)}function c(){n(),e()}t.once("error",r),t.once("listening",c),t.listen({host:"127.0.0.1",port:a,exclusive:!0})})}async function Q(t){if(!t.listening)return;let a=new Promise(e=>t.close(()=>e()));t.closeAllConnections(),await a}function X(t){return new Promise((a,e)=>{let s=[],n=0,r=!1;t.on("data",c=>{r||(n+=c.length,n>Y?(r=!0,s.length=0,e(new Error("\u56DE\u6267\u8D85\u8FC7 32 MiB"))):s.push(c))}),t.on("end",()=>{r||a(J.concat(s).toString("utf8"))}),t.on("error",e),t.on("aborted",()=>e(new Error("\u56DE\u6267\u8FDE\u63A5\u4E2D\u65AD")))})}async function D(t,a,e={}){if(!R(t)||!T(a))throw new Error("\u65E0\u6548\u7684 token \u6216\u547D\u4EE4");let s=e.timeoutMs??3e4,n=e.port??8737;if(!Number.isFinite(s)||s<=0||s>3e5)throw new Error("\u8D85\u65F6\u987B\u5728 0\u2013300 \u79D2\u4E4B\u95F4");if(!Number.isInteger(n)||n<1||n>65535)throw new Error("\u65E0\u6548\u7AEF\u53E3");let r=new AbortController,c=setTimeout(()=>r.abort(),s),o=e.signal?AbortSignal.any([e.signal,r.signal]):r.signal,i={version:1,id:H(),token:t,deadline:Date.now()+s,command:a},w=()=>o.aborted||Date.now()>=i.deadline,g=!1,P=!1,I,S,y=()=>new Error(g?"\u547D\u4EE4\u5DF2\u9001\u8FBE\uFF0C\u4F46\u7B49\u5F85\u7ED3\u679C\u8D85\u65F6\u6216\u4E2D\u65AD\uFF1A\u6267\u884C\u7ED3\u679C\u672A\u77E5\uFF0C\u8BF7\u5148\u68C0\u67E5\u9875\u9762\uFF0C\u52FF\u81EA\u52A8\u91CD\u8BD5\u6709\u526F\u4F5C\u7528\u7684\u64CD\u4F5C":P?"\u7B49\u5F85\u6269\u5C55\u8D85\u65F6\u6216\u4E2D\u65AD\uFF1A\u8BF7\u786E\u8BA4\u6B64 token \u5BF9\u5E94\u7684\u6807\u7B7E\u9875\u4ECD\u5728\u63A5\u7BA1":`\u7B49\u5F85\u7AEF\u53E3 ${n} \u8D85\u65F6\u6216\u4E2D\u65AD\uFF1A\u5176\u4ED6\u547D\u4EE4\u6216\u7A0B\u5E8F\u4ECD\u5728\u5360\u7528\u7AEF\u53E3`),A=()=>S?.(y()),h=W((u,m)=>{let d=(l,p,k)=>{m.destroyed||(m.writeHead(l,{"content-type":"application/json; charset=utf-8","cache-control":"no-store",connection:"close"}),m.end(l===204?void 0:JSON.stringify(p),k))};(async()=>{let l=u.headers.origin;if(u.headers.host!==`127.0.0.1:${n}`||l!==void 0&&!/^chrome-extension:\/\/[a-p]{32}$/.test(l)||u.headers.authorization!==`Bearer ${t}`){d(403,{error:"forbidden"});return}if(w()){d(410,{error:"\u547D\u4EE4\u5DF2\u8FC7\u671F"});return}if(u.method==="POST"&&u.url==="/command"){if(g){d(204,null);return}g=!0,d(200,i);return}if(u.method!=="POST"||u.url!=="/reply"){d(404,{error:"not found"});return}let p;try{p=JSON.parse(await X(u))}catch(k){d(k instanceof Error&&k.message.includes("32 MiB")?413:400,{error:"\u65E0\u6548\u56DE\u6267"});return}if(w()){d(410,{error:"\u547D\u4EE4\u5DF2\u8FC7\u671F"});return}if(!g||!_(p)||p.id!==i.id){d(409,{error:"\u56DE\u6267\u4E0D\u5C5E\u4E8E\u5F53\u524D\u547D\u4EE4"});return}d(200,{ok:!0},()=>I?.(p))})().catch(l=>{d(500,{error:"\u8FDE\u63A5\u5904\u7406\u5931\u8D25"}),S?.(l instanceof Error?l:new Error(String(l)))})});h.headersTimeout=Math.min(s,5e3),h.requestTimeout=s,h.keepAliveTimeout=1;try{for(;;){if(w())throw y();try{await K(h,n),P=!0;break}catch(u){if(u.code!=="EADDRINUSE")throw u;try{await z(100,void 0,{signal:o})}catch{throw y()}}}return await new Promise((u,m)=>{S=m,I=d=>{w()?m(y()):d.ok?u(d.data):m(new Error(d.error))},o.addEventListener("abort",A,{once:!0}),w()&&A()})}finally{clearTimeout(c),o.removeEventListener("abort",A),await Q(h)}}var x=new AbortController,O=x.abort.bind(x);f.once("SIGINT",O);f.once("SIGTERM",O);try{let t=U(f.argv.slice(2));if(!t)f.stdout.write($);else{let{token:a,command:e,timeoutMs:s,output:n}=t,r=await D(a,e,{timeoutMs:s,signal:x.signal});if(n!==void 0){let c=B.from(r,"base64");if(!c.subarray(0,8).equals(B.from([137,80,78,71,13,10,26,10])))throw new Error("\u6269\u5C55\u672A\u8FD4\u56DE\u6709\u6548 PNG");await j(n,c,{flag:"wx"}),f.stdout.write(`${Z(n)}
27
+ `)}else f.stdout.write(r.endsWith(`
28
+ `)?r:`${r}
29
+ `)}}catch(t){f.stderr.write(`takeit: ${t instanceof Error?t.message:String(t)}
30
+ `),f.exitCode=x.signal.aborted?130:1}finally{f.off("SIGINT",O),f.off("SIGTERM",O)}
package/package.json CHANGED
@@ -1,6 +1,44 @@
1
1
  {
2
2
  "name": "@liyang8246/takeit",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "type": "module",
4
+ "version": "0.4.0",
5
+ "description": "Control one explicitly authorized browser tab with a one-shot CLI",
6
+ "repository": {
7
+ "type": "git",
8
+ "url": "git+https://github.com/liyang8246/takeit.git"
9
+ },
10
+ "bin": {
11
+ "takeit": "dist/cli.mjs"
12
+ },
13
+ "files": [
14
+ "dist/cli.mjs"
15
+ ],
16
+ "engines": {
17
+ "node": ">=22.18.0"
18
+ },
19
+ "publishConfig": {
20
+ "access": "public"
21
+ },
22
+ "devDependencies": {
23
+ "@antfu/eslint-config": "^10.0.0",
24
+ "@resvg/resvg-js": "^2.6.2",
25
+ "@types/chrome": "^0.3.7",
26
+ "@types/node": "^26.6.6",
27
+ "esbuild": "^0.28.2",
28
+ "eslint": "^10.15.0",
29
+ "eslint-plugin-format": "^2.0.1",
30
+ "eslint-plugin-slop": "^0.1.3",
31
+ "eslint-plugin-sonarjs": "^4.2.2",
32
+ "jquery": "^4.0.0",
33
+ "typescript": "~6.0.3"
34
+ },
35
+ "scripts": {
36
+ "build": "node build.mjs",
37
+ "ci": "pnpm run lint && pnpm run typecheck && pnpm test",
38
+ "dev": "node src/cli/main.ts",
39
+ "lint": "eslint .",
40
+ "typecheck": "tsc --noEmit",
41
+ "selftest": "pnpm run build && node dev/protocol.test.ts && node dev/cli.test.ts && node dev/selftest.ts && node dev/snapshot.test.ts && node dev/cdp.test.ts && node dev/extension.test.ts",
42
+ "test": "pnpm run selftest"
43
+ }
6
44
  }