@celljs/ta-harness 4.5.1 → 4.6.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 (70) hide show
  1. package/README.md +6 -5
  2. package/esm/node/brand-extension.js +2 -2
  3. package/esm/node/bug-report.js +2 -2
  4. package/esm/node/extensions.js +1 -1
  5. package/esm/node/index.d.ts +2 -0
  6. package/esm/node/index.js +2 -0
  7. package/esm/node/index.js.map +1 -1
  8. package/esm/node/pi-types.d.ts +1 -0
  9. package/esm/node/serve-state.d.ts +18 -0
  10. package/esm/node/serve-state.js +44 -0
  11. package/esm/node/serve-state.js.map +1 -0
  12. package/esm/node/ta-brand.d.ts +2 -0
  13. package/esm/node/ta-brand.js +12 -0
  14. package/esm/node/ta-brand.js.map +1 -1
  15. package/esm/node/ta-cli.js +152 -6
  16. package/esm/node/ta-cli.js.map +1 -1
  17. package/esm/node/ta-header.js +3 -3
  18. package/esm/node/ta-packages.d.ts +67 -0
  19. package/esm/node/ta-packages.js +173 -0
  20. package/esm/node/ta-packages.js.map +1 -0
  21. package/lib/node/brand-extension.js +2 -2
  22. package/lib/node/brand-extension.spec.js +3 -3
  23. package/lib/node/bug-report.js +2 -2
  24. package/lib/node/extensions.js +1 -1
  25. package/lib/node/index.d.ts +2 -0
  26. package/lib/node/index.d.ts.map +1 -1
  27. package/lib/node/index.js +2 -0
  28. package/lib/node/index.js.map +1 -1
  29. package/lib/node/pi-types.d.ts +1 -0
  30. package/lib/node/pi-types.d.ts.map +1 -1
  31. package/lib/node/serve-state.d.ts +19 -0
  32. package/lib/node/serve-state.d.ts.map +1 -0
  33. package/lib/node/serve-state.js +47 -0
  34. package/lib/node/serve-state.js.map +1 -0
  35. package/lib/node/serve-state.spec.d.ts +2 -0
  36. package/lib/node/serve-state.spec.d.ts.map +1 -0
  37. package/lib/node/serve-state.spec.js +35 -0
  38. package/lib/node/serve-state.spec.js.map +1 -0
  39. package/lib/node/ta-brand.d.ts +2 -0
  40. package/lib/node/ta-brand.d.ts.map +1 -1
  41. package/lib/node/ta-brand.js +12 -0
  42. package/lib/node/ta-brand.js.map +1 -1
  43. package/lib/node/ta-cli.d.ts.map +1 -1
  44. package/lib/node/ta-cli.js +152 -6
  45. package/lib/node/ta-cli.js.map +1 -1
  46. package/lib/node/ta-header.js +3 -3
  47. package/lib/node/ta-header.spec.js +2 -2
  48. package/lib/node/ta-packages.d.ts +68 -0
  49. package/lib/node/ta-packages.d.ts.map +1 -0
  50. package/lib/node/ta-packages.js +172 -0
  51. package/lib/node/ta-packages.js.map +1 -0
  52. package/lib/node/ta-packages.spec.d.ts +2 -0
  53. package/lib/node/ta-packages.spec.d.ts.map +1 -0
  54. package/lib/node/ta-packages.spec.js +89 -0
  55. package/lib/node/ta-packages.spec.js.map +1 -0
  56. package/package.json +5 -4
  57. package/src/node/brand-extension.spec.ts +3 -3
  58. package/src/node/brand-extension.ts +2 -2
  59. package/src/node/bug-report.ts +2 -2
  60. package/src/node/extensions.ts +1 -1
  61. package/src/node/index.ts +2 -0
  62. package/src/node/pi-types.ts +1 -0
  63. package/src/node/serve-state.spec.ts +36 -0
  64. package/src/node/serve-state.ts +51 -0
  65. package/src/node/ta-brand.ts +10 -0
  66. package/src/node/ta-cli.ts +155 -6
  67. package/src/node/ta-header.spec.ts +2 -2
  68. package/src/node/ta-header.ts +3 -3
  69. package/src/node/ta-packages.spec.ts +95 -0
  70. package/src/node/ta-packages.ts +200 -0
package/README.md CHANGED
@@ -1,14 +1,15 @@
1
- # Cell - ta Harness
1
+ # Cell - Ta Harness
2
2
 
3
- ta 在 pi 之上的运行时部件,`ta` 命令和 ta serve 共用。这里的代码不依赖 Cell 容器,`ta` 命令因此不加载 Cell。
3
+ Ta 在 pi 之上的运行时部件,`ta` 命令和 ta serve 共用。这里的代码不依赖 Cell 容器,`ta` 命令因此不加载 Cell。
4
4
 
5
5
  | 导出 | 作用 |
6
6
  | --- | --- |
7
7
  | `TaCli.run(argv, options)` | `ta` 命令:`serve` 启动服务端,其余参数原样交给 pi 的 `main()` |
8
- | `TaBrand` | 在加载 pi 之前把它改名为 ta(`PI_PACKAGE_DIR` 指向带 `piConfig` 的目录);`agentDir()` 不加载 pi 就能算出 `~/.ta/agent` |
8
+ | `TaBrand` | 在加载 pi 之前把它改名为 Ta(`PI_PACKAGE_DIR` 指向带 `piConfig` 的目录);`agentDir()` 不加载 pi 就能算出 `~/.ta/agent` |
9
9
  | `SessionLock` / `SessionLockExtension`(`ta:session-lock`) | 会话文件旁的锁文件(先写草稿再硬链接,原子创建);进程不在了锁即失效;`/resume` 到被占用的会话会被取消,启动时打开被占用的会话则提示后退出 |
10
- | `BrandExtension`(`ta:brand`) | 终端界面的启动头部 `TaHeader`(像素恐龙 `DinoLogo`、版本、按键;随宽度换行,窄终端和 Apple Terminal 不画恐龙),并把 system prompt 里 pi 自称的句子改成 ta 的 |
10
+ | `BrandExtension`(`ta:brand`) | 终端界面的启动头部 `TaHeader`(像素恐龙 `DinoLogo`、版本、按键;随宽度换行,窄终端和 Apple Terminal 不画恐龙),并把 system prompt 里 pi 自称的句子改成 Ta 的 |
11
11
  | `ExecExtension`(`ta:exec`) | 执行环境不在本机时,用同名工具替换 read / bash / edit / write / ls / find 并接管 `!` 命令;pi 的 grep 总在本机跑 ripgrep,所以停用它(模型会通过 bash 用 rg) |
12
12
  | `ExecOperations` | 把 `ExecEnvironment` 适配成 pi 工具的 `*Operations` |
13
13
  | `ExecMcpTransport` | 在执行环境里启动 stdio MCP 服务,交给 pi 的 `createMcpExtension({ createTransport })` |
14
- | `TaExtension` / `TaExtensionUtil` | ta 的内置扩展形状:普通对象;`bundle()` 把内置扩展合成一个,pi 的已加载扩展列表里显示为 `ta` |
14
+ | `TaPackages` | Ta 自带的 pi 包(`@celljs/ta-workspace`、`@celljs/ta-channels`、`@celljs/ta-extensions`):发布时在 `dist/pi/packages/<名字>`,仓库里从工作区解析;默认开启,关掉的记在 agent 目录的 `ta.json`。`ta` 命令用 `--extension` 加载开启着的包的 pi 扩展、技能和提示模板(包管理命令和 `--no-extensions` 除外),ta serve 用 pi ResourceLoader 的 `additionalExtensionPaths` + `extensionsOverride` / `skillsOverride` / `promptsOverride`,`reload` 时按当时的开关取舍 |
15
+ | `TaExtension` / `TaExtensionUtil` | Ta 的内置扩展形状:普通对象;`bundle()` 把内置扩展合成一个,pi 的已加载扩展列表里显示为 `ta` |
@@ -18,14 +18,14 @@ export class BrandExtension {
18
18
  }
19
19
  });
20
20
  pi.registerCommand('bug', {
21
- description: 'Open an issue for ta on GitHub',
21
+ description: 'Open an issue for Ta on GitHub',
22
22
  handler: async (args, ctx) => {
23
23
  const url = BugReport.issueUrl(args, BugReport.currentEnvironment(this.sdk.VERSION, ctx.model));
24
24
  // In the terminal UI the browser is on this machine; a client of ta serve shows the link itself.
25
25
  if (ctx.mode === 'tui') {
26
26
  BugReport.open(url);
27
27
  }
28
- ctx.ui.notify(`A new issue for ta, with its version, the model and the platform and nothing else, opens in the browser. If it did not:\n${url}`, 'info');
28
+ ctx.ui.notify(`A new issue for Ta, with its version, the model and the platform and nothing else, opens in the browser. If it did not:\n${url}`, 'info');
29
29
  },
30
30
  });
31
31
  }
@@ -6,7 +6,7 @@ export var BugReport;
6
6
  function issueUrl(description, environment) {
7
7
  var _a;
8
8
  const url = new URL(BugReport.ISSUES_URL);
9
- url.searchParams.set('title', `[ta] ${description.trim() || 'Describe the bug'}`);
9
+ url.searchParams.set('title', `[Ta] ${description.trim() || 'Describe the bug'}`);
10
10
  url.searchParams.set('labels', 'ta');
11
11
  url.searchParams.set('body', [
12
12
  '## What happened',
@@ -15,7 +15,7 @@ export var BugReport;
15
15
  '',
16
16
  '## Environment',
17
17
  '',
18
- `- ta ${environment.version}`,
18
+ `- Ta ${environment.version}`,
19
19
  `- model: ${(_a = environment.model) !== null && _a !== void 0 ? _a : 'none'}`,
20
20
  `- ${environment.platform}, Node.js ${environment.node}`,
21
21
  ].join('\n'));
@@ -48,7 +48,7 @@ export class SessionLockExtension {
48
48
  * can only end the process. `ctx.shutdown` restores the terminal; print modes do not act on it.
49
49
  */
50
50
  refuse(file, ctx) {
51
- const message = `This session is open in another ta process. If that process is gone, delete ${this.lock.path(file)}.`;
51
+ const message = `This session is open in another Ta process. If that process is gone, delete ${this.lock.path(file)}.`;
52
52
  if (ctx.mode === 'tui') {
53
53
  ctx.ui.notify(message, 'error');
54
54
  ctx.shutdown();
@@ -7,7 +7,9 @@ export * from './exec-operations.js';
7
7
  export * from './extensions.js';
8
8
  export * from './glob-util.js';
9
9
  export * from './pi-types.js';
10
+ export * from './serve-state.js';
10
11
  export * from './session-lock.js';
11
12
  export * from './ta-brand.js';
12
13
  export * from './ta-cli.js';
13
14
  export * from './ta-header.js';
15
+ export * from './ta-packages.js';
package/esm/node/index.js CHANGED
@@ -7,8 +7,10 @@ export * from './exec-operations.js';
7
7
  export * from './extensions.js';
8
8
  export * from './glob-util.js';
9
9
  export * from './pi-types.js';
10
+ export * from './serve-state.js';
10
11
  export * from './session-lock.js';
11
12
  export * from './ta-brand.js';
12
13
  export * from './ta-cli.js';
13
14
  export * from './ta-header.js';
15
+ export * from './ta-packages.js';
14
16
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}
@@ -1,6 +1,7 @@
1
1
  export type { PiSdk } from '@celljs/ai-coding-agent/lib/node/pi/pi-sdk-util';
2
2
  export type ExtensionAPI = import('@earendil-works/pi-coding-agent', { with: { 'resolution-mode': 'import' } }).ExtensionAPI;
3
3
  export type ExtensionContext = import('@earendil-works/pi-coding-agent', { with: { 'resolution-mode': 'import' } }).ExtensionContext;
4
+ export type LoadExtensionsResult = import('@earendil-works/pi-coding-agent', { with: { 'resolution-mode': 'import' } }).LoadExtensionsResult;
4
5
  export type InlineExtension = import('@earendil-works/pi-coding-agent', { with: { 'resolution-mode': 'import' } }).InlineExtension;
5
6
  export type BashOperations = import('@earendil-works/pi-coding-agent', { with: { 'resolution-mode': 'import' } }).BashOperations;
6
7
  export type ReadOperations = import('@earendil-works/pi-coding-agent', { with: { 'resolution-mode': 'import' } }).ReadOperations;
@@ -0,0 +1,18 @@
1
+ /**
2
+ * What `ta serve` keeps across restarts: its port and its token. A web app installed from it (a PWA)
3
+ * belongs to one address, and remembers the token it signed in with; both must stay the same.
4
+ */
5
+ export interface TaServeState {
6
+ port?: number;
7
+ token?: string;
8
+ }
9
+ export declare namespace TaServeStateUtil {
10
+ /** In the agent directory, readable only by this user, like serve.json. Removing it gives a new token. */
11
+ const FILE = "serve-state.json";
12
+ function file(agentDir?: string): string;
13
+ /** Nothing when the file is missing or is not what {@link write} wrote. */
14
+ function read(path?: string): TaServeState;
15
+ function write(state: TaServeState, path?: string): void;
16
+ /** Whether a server could listen on `port` of `host` now. */
17
+ function isFree(port: number, host: string): Promise<boolean>;
18
+ }
@@ -0,0 +1,44 @@
1
+ import { chmodSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
2
+ import { createServer } from 'node:net';
3
+ import { dirname, join } from 'node:path';
4
+ import { TaBrand } from './ta-brand.js';
5
+ export var TaServeStateUtil;
6
+ (function (TaServeStateUtil) {
7
+ /** In the agent directory, readable only by this user, like serve.json. Removing it gives a new token. */
8
+ TaServeStateUtil.FILE = 'serve-state.json';
9
+ function file(agentDir = TaBrand.agentDir()) {
10
+ return join(agentDir, TaServeStateUtil.FILE);
11
+ }
12
+ TaServeStateUtil.file = file;
13
+ /** Nothing when the file is missing or is not what {@link write} wrote. */
14
+ function read(path = file()) {
15
+ try {
16
+ const { port, token } = JSON.parse(readFileSync(path, 'utf8'));
17
+ return {
18
+ port: typeof port === 'number' && Number.isInteger(port) && port > 0 && port < 65536 ? port : undefined,
19
+ token: typeof token === 'string' && token.length > 0 ? token : undefined,
20
+ };
21
+ }
22
+ catch (_a) {
23
+ return {};
24
+ }
25
+ }
26
+ TaServeStateUtil.read = read;
27
+ function write(state, path = file()) {
28
+ mkdirSync(dirname(path), { recursive: true });
29
+ writeFileSync(path, JSON.stringify(state), { mode: 0o600 });
30
+ // The mode above only applies to a new file.
31
+ chmodSync(path, 0o600);
32
+ }
33
+ TaServeStateUtil.write = write;
34
+ /** Whether a server could listen on `port` of `host` now. */
35
+ function isFree(port, host) {
36
+ return new Promise(resolve => {
37
+ const server = createServer();
38
+ server.once('error', () => resolve(false));
39
+ server.listen(port, host, () => server.close(() => resolve(true)));
40
+ });
41
+ }
42
+ TaServeStateUtil.isFree = isFree;
43
+ })(TaServeStateUtil || (TaServeStateUtil = {}));
44
+ //# sourceMappingURL=serve-state.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"serve-state.js","sourceRoot":"","sources":["../../src/node/serve-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAWrC,MAAM,KAAW,gBAAgB,CAoChC;AApCD,WAAiB,gBAAgB;IAC7B,0GAA0G;IAC7F,qBAAI,GAAG,kBAAkB,CAAC;IAEvC,SAAgB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE;QAC9C,OAAO,IAAI,CAAC,QAAQ,EAAE,qBAAI,CAAC,CAAC;IAChC,CAAC;IAFe,iBAAA,IAAI,OAEnB,CAAA;IAED,2EAA2E;IAC3E,SAAgB,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE;QAC9B,IAAI,CAAC;YACD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAiB,CAAC;YAC/E,OAAO;gBACH,IAAI,EAAE,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;gBACvG,KAAK,EAAE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;aAC3E,CAAC;QACN,CAAC;mBAAO,CAAC;YACL,OAAO,EAAE,CAAC;QACd,CAAC;IACL,CAAC;IAVe,iBAAA,IAAI,OAUnB,CAAA;IAED,SAAgB,KAAK,CAAC,KAAmB,EAAE,IAAI,GAAG,IAAI,EAAE;QACpD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,6CAA6C;QAC7C,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC3B,CAAC;IALe,iBAAA,KAAK,QAKpB,CAAA;IAED,6DAA6D;IAC7D,SAAgB,MAAM,CAAC,IAAY,EAAE,IAAY;QAC7C,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;YACzB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YAC3C,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;IACP,CAAC;IANe,iBAAA,MAAM,SAMrB,CAAA;AACL,CAAC,EApCgB,gBAAgB,KAAhB,gBAAgB,QAoChC"}
@@ -4,6 +4,8 @@ export declare namespace TaBrand {
4
4
  const ENV_ALIASES: Record<string, string>;
5
5
  /** Where pi keeps ta's files, without loading pi: an idle `ta serve` must not pay for it. */
6
6
  function agentDir(): string;
7
+ /** The version of ta, from the package.json that {@link activate} named. */
8
+ function version(): string;
7
9
  /**
8
10
  * Makes pi `ta`: its name, `~/.ta/agent`, project `.ta/` and `TA_CODING_AGENT_DIR` come from the
9
11
  * `piConfig` of the package.json in `brandDir`, next to pi's assets and ta's patched build of pi
@@ -1,3 +1,4 @@
1
+ import { readFileSync } from 'node:fs';
1
2
  import { homedir } from 'node:os';
2
3
  import { join } from 'node:path';
3
4
  export var TaBrand;
@@ -16,6 +17,17 @@ export var TaBrand;
16
17
  return (_a = process.env.TA_CODING_AGENT_DIR) !== null && _a !== void 0 ? _a : join(homedir(), '.ta', 'agent');
17
18
  }
18
19
  TaBrand.agentDir = agentDir;
20
+ /** The version of ta, from the package.json that {@link activate} named. */
21
+ function version() {
22
+ var _a, _b;
23
+ try {
24
+ return (_b = JSON.parse(readFileSync(join((_a = process.env.PI_PACKAGE_DIR) !== null && _a !== void 0 ? _a : '', 'package.json'), 'utf8')).version) !== null && _b !== void 0 ? _b : 'unknown';
25
+ }
26
+ catch (_c) {
27
+ return 'unknown';
28
+ }
29
+ }
30
+ TaBrand.version = version;
19
31
  /**
20
32
  * Makes pi `ta`: its name, `~/.ta/agent`, project `.ta/` and `TA_CODING_AGENT_DIR` come from the
21
33
  * `piConfig` of the package.json in `brandDir`, next to pi's assets and ta's patched build of pi
@@ -1 +1 @@
1
- {"version":3,"file":"ta-brand.js","sourceRoot":"","sources":["../../src/node/ta-brand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,KAAW,OAAO,CAqCvB;AArCD,WAAiB,OAAO;IACP,YAAI,GAAG,IAAI,CAAC;IAEzB,yFAAyF;IAC5E,mBAAW,GAA2B;QAC/C,UAAU,EAAE,YAAY;QACxB,sBAAsB,EAAE,wBAAwB;QAChD,YAAY,EAAE,cAAc;QAC5B,qBAAqB,EAAE,uBAAuB;KACjD,CAAC;IAEF,6FAA6F;IAC7F,SAAgB,QAAQ;;QACpB,aAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,mCAAI,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;IAFe,QAAA,QAAQ,WAEvB,CAAA;IAED;;;;;OAKG;IACH,SAAgB,QAAQ,CAAC,QAAgB;;;QACrC,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,QAAQ,CAAC;QACtC,KAAK,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,mBAAW,CAAC,EAAE,CAAC;YACjD,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,SAAS,EAAE,CAAC;gBAChC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACtC,CAAC;QACL,CAAC;QACD,4GAA4G;QAC5G,YAAA,OAAO,CAAC,GAAG,EAAC,qBAAqB,uCAArB,qBAAqB,GAAK,GAAG,EAAC;QAC1C,YAAA,OAAO,CAAC,GAAG,EAAC,YAAY,uCAAZ,YAAY,GAAK,GAAG,EAAC;QACjC,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,MAAM,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,YAAI,CAAC;QAC5B,OAAO,CAAC,KAAK,GAAG,YAAI,CAAC;QACrB,OAAO,CAAC,WAAW,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC;IAC1C,CAAC;IAde,QAAA,QAAQ,WAcvB,CAAA;AACL,CAAC,EArCgB,OAAO,KAAP,OAAO,QAqCvB"}
1
+ {"version":3,"file":"ta-brand.js","sourceRoot":"","sources":["../../src/node/ta-brand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,KAAW,OAAO,CA8CvB;AA9CD,WAAiB,OAAO;IACP,YAAI,GAAG,IAAI,CAAC;IAEzB,yFAAyF;IAC5E,mBAAW,GAA2B;QAC/C,UAAU,EAAE,YAAY;QACxB,sBAAsB,EAAE,wBAAwB;QAChD,YAAY,EAAE,cAAc;QAC5B,qBAAqB,EAAE,uBAAuB;KACjD,CAAC;IAEF,6FAA6F;IAC7F,SAAgB,QAAQ;;QACpB,aAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,mCAAI,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;IAFe,QAAA,QAAQ,WAEvB,CAAA;IAED,4EAA4E;IAC5E,SAAgB,OAAO;;QACnB,IAAI,CAAC;YACD,aAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,OAAC,OAAO,CAAC,GAAG,CAAC,cAAc,mCAAI,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,mCAAI,SAAS,CAAC;QACzH,CAAC;mBAAO,CAAC;YACL,OAAO,SAAS,CAAC;QACrB,CAAC;IACL,CAAC;IANe,QAAA,OAAO,UAMtB,CAAA;IAED;;;;;OAKG;IACH,SAAgB,QAAQ,CAAC,QAAgB;;;QACrC,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,QAAQ,CAAC;QACtC,KAAK,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,mBAAW,CAAC,EAAE,CAAC;YACjD,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,SAAS,EAAE,CAAC;gBAChC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACtC,CAAC;QACL,CAAC;QACD,4GAA4G;QAC5G,YAAA,OAAO,CAAC,GAAG,EAAC,qBAAqB,uCAArB,qBAAqB,GAAK,GAAG,EAAC;QAC1C,YAAA,OAAO,CAAC,GAAG,EAAC,YAAY,uCAAZ,YAAY,GAAK,GAAG,EAAC;QACjC,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,MAAM,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,YAAI,CAAC;QAC5B,OAAO,CAAC,KAAK,GAAG,YAAI,CAAC;QACrB,OAAO,CAAC,WAAW,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC;IAC1C,CAAC;IAde,QAAA,QAAQ,WAcvB,CAAA;AACL,CAAC,EA9CgB,OAAO,KAAP,OAAO,QA8CvB"}
@@ -1,19 +1,53 @@
1
+ import { randomBytes } from 'node:crypto';
1
2
  import { parseArgs } from 'node:util';
2
3
  import { PiBundleUtil } from '@celljs/ai-coding-agent/lib/node/pi/pi-bundle-util';
3
4
  import { BrandExtension } from './brand-extension.js';
4
5
  import { SessionLockExtension, TaExtensionUtil } from './extensions.js';
6
+ import { TaServeStateUtil } from './serve-state.js';
5
7
  import { SessionLock } from './session-lock.js';
6
8
  import { TaBrand } from './ta-brand.js';
7
- const SERVE_HELP = `Usage: ta serve [--host <host>] [--port <port>]
9
+ import { TaPackages } from './ta-packages.js';
10
+ const SERVE_HELP = `Usage: ta serve [--host <host>] [--port <port>] [--web] [--exec <url>]
8
11
 
9
- Serves pi sessions over WebSocket to any number of clients. Stops on SIGINT or SIGTERM.
12
+ Serves ta sessions over WebSocket to any number of clients, and the web client. Stops on SIGINT or SIGTERM.
10
13
 
11
14
  --host Address to listen on. Default: 127.0.0.1
12
- --port Port to listen on. Default: a free port
15
+ --port Port to listen on. Default: the port of the last start if it is free, so that a web app
16
+ installed from it finds it again; otherwise a free port
17
+ --web Open the web client in the browser
18
+ --exec Run the sessions' commands and file operations on a ta exec-server; TA_EXEC_TOKEN is its token
13
19
 
14
- The URL and the access token are written to serve.json in the agent directory.
20
+ The URL and the access token are written to serve.json in the agent directory. The token stays the
21
+ same across restarts (serve-state.json there; remove it for a new token and port).
15
22
  Set TA_SERVE_TOKEN to choose the token.
16
23
  `;
24
+ const EXEC_SERVER_HELP = `Usage: ta exec-server [--host <host>] [--port <port>] [--cwd <dir>]
25
+
26
+ Runs the commands and file operations of the sessions of a ta serve on this machine, for example a
27
+ container or a sandbox, while the agent runs elsewhere: ta serve --exec <url>. Stops on SIGINT or SIGTERM.
28
+
29
+ --host Address to listen on. Default: 127.0.0.1
30
+ --port Port to listen on. Default: a free port
31
+ --cwd Where sessions run when the host names no directory. Default: the current directory
32
+
33
+ Set TA_EXEC_TOKEN to choose the token hosts must present; otherwise a random one is printed.
34
+ `;
35
+ const RELAY_HELP = `Usage: ta relay [--host <host>] [--port <port>]
36
+
37
+ Runs a relay, through which paired devices reach a ta serve from anywhere (ta pair). It only forwards:
38
+ what goes through is encrypted end to end. Put it behind HTTPS. Stops on SIGINT or SIGTERM.
39
+
40
+ --host Address to listen on. Default: 127.0.0.1
41
+ --port Port to listen on. Default: 8080
42
+ `;
43
+ const PAIR_HELP = `Usage: ta pair [<relay url>] [--name <device>]
44
+ ta pair --list
45
+ ta pair --remove <device id>
46
+
47
+ Pairs a device, such as a phone, with the ta serve of this user: prints a link to paste in the Ta app on
48
+ it. The relay is https://relay.cellbang.com unless named. With a device paired, ta serve connects to the relay; what goes through it is encrypted end to end,
49
+ with a key only the device and ta serve have. The devices are in relay.json in the agent directory.
50
+ `;
17
51
  export var TaCli;
18
52
  (function (TaCli) {
19
53
  /**
@@ -26,17 +60,41 @@ export var TaCli;
26
60
  await serve(argv.slice(1), options.serveEntry);
27
61
  return;
28
62
  }
63
+ if (argv[0] === 'relay') {
64
+ await relay(argv.slice(1));
65
+ return;
66
+ }
67
+ if (argv[0] === 'pair') {
68
+ await pair(argv.slice(1));
69
+ return;
70
+ }
71
+ if (argv[0] === 'exec-server') {
72
+ await execServer(argv.slice(1));
73
+ return;
74
+ }
29
75
  const sdk = await import(/* @vite-ignore */ PiBundleUtil.specifier());
30
76
  const builtIn = TaExtensionUtil.bundle([new SessionLockExtension(new SessionLock()), new BrandExtension(sdk)]);
31
- await sdk.main(argv, { extensionFactories: [builtIn] });
77
+ await sdk.main(TaPackages.withExtensions(argv, TaBrand.agentDir()), { extensionFactories: [builtIn] });
32
78
  }
33
79
  TaCli.run = run;
34
80
  async function serve(argv, entry) {
35
- const { values } = parseArgs({ args: argv, options: { host: { type: 'string' }, port: { type: 'string' }, help: { type: 'boolean', short: 'h' } } });
81
+ var _a;
82
+ const { values } = parseArgs({
83
+ args: argv,
84
+ options: {
85
+ host: { type: 'string' },
86
+ port: { type: 'string' },
87
+ web: { type: 'boolean' },
88
+ exec: { type: 'string' },
89
+ help: { type: 'boolean', short: 'h' },
90
+ },
91
+ });
36
92
  if (values.help) {
37
93
  process.stdout.write(SERVE_HELP);
38
94
  return;
39
95
  }
96
+ // This process is already Node.js; in the commands of the agent, an Electron app would start as Node.js too.
97
+ delete process.env.ELECTRON_RUN_AS_NODE;
40
98
  // Read by the server like any other key of its configuration.
41
99
  if (values.host) {
42
100
  process.env.CELL_SERVER__HOST = values.host;
@@ -44,7 +102,95 @@ export var TaCli;
44
102
  if (values.port) {
45
103
  process.env.CELL_SERVER__PORT = values.port;
46
104
  }
105
+ else if (!process.env.CELL_SERVER__PORT) {
106
+ const { port } = TaServeStateUtil.read();
107
+ if (port && (await TaServeStateUtil.isFree(port, (_a = process.env.CELL_SERVER__HOST) !== null && _a !== void 0 ? _a : '127.0.0.1'))) {
108
+ process.env.CELL_SERVER__PORT = String(port);
109
+ }
110
+ }
111
+ if (values.web) {
112
+ process.env.TA_SERVE_OPEN_WEB = '1';
113
+ }
114
+ if (values.exec) {
115
+ process.env.CELL_TA__EXEC__URL = values.exec;
116
+ }
117
+ if (process.env.TA_EXEC_TOKEN) {
118
+ process.env.CELL_TA__EXEC__TOKEN = process.env.TA_EXEC_TOKEN;
119
+ }
47
120
  await import(/* @vite-ignore */ entry);
48
121
  }
122
+ /** Without Cell, as the exec server. */
123
+ async function relay(argv) {
124
+ const { values } = parseArgs({ args: argv, options: { host: { type: 'string' }, port: { type: 'string' }, help: { type: 'boolean', short: 'h' } } });
125
+ if (values.help) {
126
+ process.stdout.write(RELAY_HELP);
127
+ return;
128
+ }
129
+ const { RelayServer } = await import('@celljs/ta-relay/lib/node/relay-server');
130
+ const server = new RelayServer({ host: values.host, port: values.port ? Number(values.port) : 8080 });
131
+ console.log(`ta relay: ${await server.listen()}`);
132
+ const stop = () => void server.close().then(() => process.exit(0));
133
+ process.once('SIGINT', stop);
134
+ process.once('SIGTERM', stop);
135
+ }
136
+ async function pair(argv) {
137
+ var _a;
138
+ const { values, positionals } = parseArgs({
139
+ args: argv,
140
+ allowPositionals: true,
141
+ options: { name: { type: 'string' }, list: { type: 'boolean' }, remove: { type: 'string' }, help: { type: 'boolean', short: 'h' } },
142
+ });
143
+ const { RelayStore } = await import('@celljs/ta-relay/lib/node/relay-store');
144
+ const { RelayPairingUtil } = await import('@celljs/ta-relay/lib/common/relay-pairing');
145
+ const store = new RelayStore(TaBrand.agentDir());
146
+ if (values.list) {
147
+ const { url, devices } = store.read();
148
+ console.log(devices.length === 0 ? 'No devices are paired.' : `Relay: ${url}`);
149
+ for (const device of devices) {
150
+ console.log(`${device.id} ${device.name} ${new Date(device.createdAt).toISOString()}`);
151
+ }
152
+ return;
153
+ }
154
+ if (values.remove) {
155
+ if (!store.remove(values.remove)) {
156
+ console.error(`ta pair: no device ${values.remove}`);
157
+ process.exitCode = 1;
158
+ }
159
+ return;
160
+ }
161
+ const { RELAY_DEFAULT_URL } = await import('@celljs/ta-relay/lib/common/relay-protocol');
162
+ const [relayUrl = RELAY_DEFAULT_URL] = positionals;
163
+ if (values.help || !/^https?:\/\//.test(relayUrl)) {
164
+ process.stdout.write(PAIR_HELP);
165
+ process.exitCode = values.help ? 0 : 1;
166
+ return;
167
+ }
168
+ const pairing = store.pair(relayUrl, (_a = values.name) !== null && _a !== void 0 ? _a : 'device');
169
+ console.log('Paste this link in the Ta app on the device. Anyone with it can reach your Ta: keep it to yourself.\n');
170
+ console.log(RelayPairingUtil.link(pairing));
171
+ console.log(`\nDevice id: ${pairing.device} (ta pair --remove ${pairing.device} to unpair it)`);
172
+ }
173
+ /** Without Cell: the exec server is a plain HTTP server, as small as it can be. */
174
+ async function execServer(argv) {
175
+ const { values } = parseArgs({
176
+ args: argv,
177
+ options: { host: { type: 'string' }, port: { type: 'string' }, cwd: { type: 'string' }, help: { type: 'boolean', short: 'h' } },
178
+ });
179
+ if (values.help) {
180
+ process.stdout.write(EXEC_SERVER_HELP);
181
+ return;
182
+ }
183
+ const { ExecServer } = await import('@celljs/ta-exec/lib/node/exec-server');
184
+ const token = process.env.TA_EXEC_TOKEN || randomBytes(32).toString('base64url');
185
+ const server = new ExecServer({ host: values.host, port: values.port ? Number(values.port) : undefined, cwd: values.cwd, token });
186
+ const url = await server.listen();
187
+ console.log(`ta exec-server: ${url}`);
188
+ if (!process.env.TA_EXEC_TOKEN) {
189
+ console.log(`token: ${token}`);
190
+ }
191
+ const stop = () => void server.close().then(() => process.exit(0));
192
+ process.once('SIGINT', stop);
193
+ process.once('SIGTERM', stop);
194
+ }
49
195
  })(TaCli || (TaCli = {}));
50
196
  //# sourceMappingURL=ta-cli.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"ta-cli.js","sourceRoot":"","sources":["../../src/node/ta-cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,oDAAoD,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAErE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC,MAAM,UAAU,GAAG;;;;;;;;;CASlB,CAAC;AASF,MAAM,KAAW,KAAK,CA+BrB;AA/BD,WAAiB,KAAK;IAClB;;;OAGG;IACI,KAAK,UAAU,GAAG,CAAC,IAAc,EAAE,OAAqB;QAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;YACtB,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;YAC/C,OAAO;QACX,CAAC;QACD,MAAM,GAAG,GAAU,MAAM,MAAM,CAAC,kBAAkB,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC;QAC7E,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,IAAI,oBAAoB,CAAC,IAAI,WAAW,EAAE,CAAC,EAAE,IAAI,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC/G,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,kBAAkB,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;IATqB,MAAA,GAAG,MASxB,CAAA;IAED,KAAK,UAAU,KAAK,CAAC,IAAc,EAAE,KAAa;QAC9C,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;QACrJ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACjC,OAAO;QACX,CAAC;QACD,8DAA8D;QAC9D,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,MAAM,CAAC,IAAI,CAAC;QAChD,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,MAAM,CAAC,IAAI,CAAC;QAChD,CAAC;QACD,MAAM,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;AACL,CAAC,EA/BgB,KAAK,KAAL,KAAK,QA+BrB"}
1
+ {"version":3,"file":"ta-cli.js","sourceRoot":"","sources":["../../src/node/ta-cli.ts"],"names":[],"mappings":"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"}
@@ -78,15 +78,15 @@ export class TaHeader {
78
78
  }
79
79
  intro(width) {
80
80
  const { theme } = this;
81
- const title = `ta v${this.options.version}`;
81
+ const title = `Ta v${this.options.version}`;
82
82
  const green = (text) => DinoLogo.paint(theme.getColorMode(), text);
83
83
  return [
84
- this.span(title, width, text => (text === title ? `${theme.bold(green('ta'))} ${theme.fg('dim', title.slice(4))}` : green(text))),
84
+ this.span(title, width, text => (text === title ? `${theme.bold(green('Ta'))} ${theme.fg('dim', title.slice(4))}` : green(text))),
85
85
  this.span('a coding agent on Cell and pi', width, text => theme.fg('muted', text)),
86
86
  { text: '', width: 0 },
87
87
  ...COMPACT_HINTS.flatMap(group => this.flow(this.hints(group), width)),
88
88
  { text: '', width: 0 },
89
- this.span('Ask ta how to use or extend it.', width, text => theme.fg('dim', text)),
89
+ this.span('Ask Ta how to use or extend it.', width, text => theme.fg('dim', text)),
90
90
  ];
91
91
  }
92
92
  /** Hints in as few lines as the width allows, a hint never split. */
@@ -0,0 +1,67 @@
1
+ import type { LoadExtensionsResult } from './pi-types.js';
2
+ /** The options of pi's resource loader that load the built-in packages. */
3
+ export interface TaPackageLoaderOptions {
4
+ additionalExtensionPaths: string[];
5
+ extensionsOverride(result: LoadExtensionsResult): LoadExtensionsResult;
6
+ skillsOverride<T extends {
7
+ filePath: string;
8
+ }, D extends {
9
+ path?: string;
10
+ }>(result: {
11
+ skills: T[];
12
+ diagnostics: D[];
13
+ }): {
14
+ skills: T[];
15
+ diagnostics: D[];
16
+ };
17
+ promptsOverride<T extends {
18
+ filePath: string;
19
+ }, D extends {
20
+ path?: string;
21
+ }>(result: {
22
+ prompts: T[];
23
+ diagnostics: D[];
24
+ }): {
25
+ prompts: T[];
26
+ diagnostics: D[];
27
+ };
28
+ }
29
+ /** A pi package that comes with ta. */
30
+ export interface TaBuiltinPackage {
31
+ /** The `name` of its package.json. */
32
+ name: string;
33
+ root: string;
34
+ /** It has what pi loads: `pi.extensions`, `pi.skills` or `pi.prompts` of its package.json. */
35
+ resources: boolean;
36
+ }
37
+ /**
38
+ * The pi packages that come with ta. They are on unless the user turned them off; they cannot be
39
+ * removed. The build of apps/ta copies each to `packages/<name without scope>` of pi's package
40
+ * directory (PI_PACKAGE_DIR); in the repository they are the workspace packages of {@link BUILTIN}.
41
+ */
42
+ export declare namespace TaPackages {
43
+ const BUILTIN: readonly string[];
44
+ /** In the agent directory. */
45
+ const SETTINGS_FILE = "ta.json";
46
+ function builtins(packageDir?: string | undefined): TaBuiltinPackage[];
47
+ /** Not built: those of {@link BUILTIN} that are installed next to this file, in the repository. */
48
+ function workspace(): TaBuiltinPackage[];
49
+ /** The directory of a package in pi's package directory. */
50
+ function directoryName(name: string): string;
51
+ function disabled(agentDir: string): Set<string>;
52
+ function setEnabled(agentDir: string, name: string, enabled: boolean): void;
53
+ /** The directories of the packages with only a web extension that the user turned off. */
54
+ function disabledWeb(agentDir: string): Set<string>;
55
+ function setWebEnabled(agentDir: string, root: string, enabled: boolean): void;
56
+ function enabled(agentDir: string, packageDir?: string): TaBuiltinPackage[];
57
+ /** The directories to load pi extensions, skills and prompts from, as `--extension` and pi's `additionalExtensionPaths` take them. */
58
+ function extensionPaths(agentDir: string, packageDir?: string): string[];
59
+ /**
60
+ * For pi's resource loader of a session: it loads every built-in package, its pi extensions, skills
61
+ * and prompt templates, and keeps those of the packages that are on, read again on each reload, so
62
+ * that a reload follows the setting.
63
+ */
64
+ function loaderOptions(agentDir: string, packageDir?: string): TaPackageLoaderOptions;
65
+ /** pi's command line with the built-in packages that are on, unless it manages packages or loads no extensions. */
66
+ function withExtensions(argv: string[], agentDir: string, packageDir?: string): string[];
67
+ }