termdock 1.4.71 → 1.4.73

package/dist/server/cli.js

@@ -159,7 +159,17 @@ Options:
   --plugin-init      Print the Agent integration protocol reference
   --plugin-create <file>
                      Create a plugin from a manifest JSON file
+  --plugin-install <source>
+                     Install a complete plugin package from HTTPS Git or a local path
   --plugin-list      List installed agent plugins
+  --plugin-check <slug>
+                     Check the installed plugin source for updates
+  --plugin-update <slug>
+                     Update a plugin package from its recorded source
+  --plugin-doctor <slug>
+                     Probe one plugin's title/model integration
+  --plugin-hooks <slug> <install|uninstall>
+                     Manage the Agent-native hook entries for a plugin
   --plugin-remove <slug>
                      Remove an installed agent plugin
   -h, --help         Show this help message
@@ -173,7 +183,18 @@ Short commands:
   pi                 Same as agent-plugin
   plugin-create <file>
                      Same as --plugin-create <file>
-  plugin-list        Same as --plugin-list
+  plugin-install <source>
+                     Install a shareable plugin repository or local package
+  plugin-list [--json]
+                     List plugin packages and their recorded sources
+  plugin-check <slug>
+                     Check one plugin for updates
+  plugin-update <slug>
+                     Update one plugin from its recorded source
+  plugin-doctor <slug> [--json]
+                     Validate title capability and dynamically probe models
+  plugin-hooks <slug> <install|uninstall>
+                     Install or uninstall only that plugin's Agent hooks
   plugin-remove <slug>
                      Same as --plugin-remove <slug>
   s                  Same as --status
@@ -513,7 +534,13 @@ function parseArgs(argv) {
     let pluginInit = false;
     let pluginInitJson = false;
     let pluginCreate;
+    let pluginInstall;
     let pluginList = false;
+    let pluginListJson = false;
+    let pluginCheck;
+    let pluginUpdate;
+    let pluginDoctor;
+    let pluginHooks;
     let pluginRemove;
     let agentEvent;
     // Short command aliases for the common path. Keep these positional-only so
@@ -638,13 +665,41 @@ function parseArgs(argv) {
                 argv = argv.slice(2);
             }
             else {
-                pluginCreate = undefined;
+                pluginCreate = '';
                 argv = argv.slice(1);
             }
         }
+        else if (command === 'pinstall' || command === 'plugin-install') {
+            pluginInstall = next && !next.startsWith('-') ? next : '';
+            argv = argv.slice(pluginInstall ? 2 : 1);
+        }
         else if (command === 'pinfo' || command === 'plugin-list') {
             pluginList = true;
-            argv = argv.slice(1);
+            pluginListJson = next === '--json';
+            argv = argv.slice(pluginListJson ? 2 : 1);
+        }
+        else if (command === 'pcheck' || command === 'plugin-check') {
+            pluginCheck = next && !next.startsWith('-') ? next : '';
+            argv = argv.slice(pluginCheck ? 2 : 1);
+        }
+        else if (command === 'pupdate' || command === 'plugin-update') {
+            pluginUpdate = next && !next.startsWith('-') ? next : '';
+            argv = argv.slice(pluginUpdate ? 2 : 1);
+        }
+        else if (command === 'pdoctor' || command === 'plugin-doctor') {
+            pluginDoctor = { slug: next && !next.startsWith('-') ? next : '', json: argv[2] === '--json' };
+            argv = argv.slice(pluginDoctor.slug ? (pluginDoctor.json ? 3 : 2) : 1);
+        }
+        else if (command === 'phooks' || command === 'plugin-hooks') {
+            const action = argv[2];
+            if (next && (action === 'install' || action === 'uninstall')) {
+                pluginHooks = { slug: next, action };
+                argv = argv.slice(3);
+            }
+            else {
+                console.error(`${ICON.err} ${c.red('Usage: td plugin-hooks <slug> <install|uninstall>')}`);
+                process.exit(1);
+            }
         }
         else if (command === 'premove' || command === 'plugin-remove') {
             if (next && !next.startsWith('-')) {
@@ -652,7 +707,7 @@ function parseArgs(argv) {
                 argv = argv.slice(2);
             }
             else {
-                pluginRemove = undefined;
+                pluginRemove = '';
                 argv = argv.slice(1);
             }
         }
@@ -737,6 +792,8 @@ function parseArgs(argv) {
         if (arg === '--json') {
             if (pluginInit)
                 pluginInitJson = true;
+            else if (pluginList)
+                pluginListJson = true;
             else
                 tlsJson = true;
             continue;
@@ -850,7 +907,7 @@ function parseArgs(argv) {
                 index += 1;
             }
             else {
-                pluginCreate = undefined;
+                pluginCreate = '';
             }
             continue;
         }
@@ -858,6 +915,46 @@ function parseArgs(argv) {
             pluginList = true;
             continue;
         }
+        if (arg === '--plugin-install' || arg === '--plugin-check' || arg === '--plugin-update' || arg === '--plugin-doctor') {
+            const next = argv[index + 1];
+            if (next && !next.startsWith('-')) {
+                if (arg === '--plugin-install')
+                    pluginInstall = next;
+                else if (arg === '--plugin-check')
+                    pluginCheck = next;
+                else if (arg === '--plugin-update')
+                    pluginUpdate = next;
+                else
+                    pluginDoctor = { slug: next, json: argv[index + 2] === '--json' };
+                index += pluginDoctor?.json && arg === '--plugin-doctor' ? 2 : 1;
+            }
+            else if (arg === '--plugin-install') {
+                pluginInstall = '';
+            }
+            else if (arg === '--plugin-check') {
+                pluginCheck = '';
+            }
+            else if (arg === '--plugin-update') {
+                pluginUpdate = '';
+            }
+            else {
+                pluginDoctor = { slug: '', json: false };
+            }
+            continue;
+        }
+        if (arg === '--plugin-hooks') {
+            const slug = argv[index + 1];
+            const action = argv[index + 2];
+            if (slug && (action === 'install' || action === 'uninstall')) {
+                pluginHooks = { slug, action };
+                index += 2;
+            }
+            else {
+                console.error(`${ICON.err} ${c.red('Usage: td --plugin-hooks <slug> <install|uninstall>')}`);
+                process.exit(1);
+            }
+            continue;
+        }
         if (arg === '--plugin-remove') {
             const next = argv[index + 1];
             if (next && !next.startsWith('-')) {
@@ -865,7 +962,7 @@ function parseArgs(argv) {
                 index += 1;
             }
             else {
-                pluginRemove = undefined;
+                pluginRemove = '';
             }
             continue;
         }
@@ -914,7 +1011,13 @@ function parseArgs(argv) {
         pluginInit,
         pluginInitJson,
         pluginCreate,
+        pluginInstall,
         pluginList,
+        pluginListJson,
+        pluginCheck,
+        pluginUpdate,
+        pluginDoctor,
+        pluginHooks,
         pluginRemove,
         agentEvent,
     };
@@ -1727,7 +1830,8 @@ const AGENT_PLUGIN_EXAMPLE = {
     },
     titleNamer: {
         command: 'my-agent',
-        args: ['title', '--json', '--prompt', '{prompt}', '--model={model}'],
+        modelArgs: ['--model', '{model}'],
+        args: ['title', '--json', '--prompt', '{prompt}'],
         models: {
             command: 'my-agent',
             args: ['models', '--json'],
@@ -1742,8 +1846,13 @@ function runPluginInitJson() {
         commands: {
             guide: 'td agent-plugin --json',
             register: 'td plugin-create ./manifest.json',
+            installPackage: 'td plugin-install https://github.com/owner/repository',
+            checkUpdate: 'td plugin-check <slug>',
+            updatePackage: 'td plugin-update <slug>',
+            doctor: 'td plugin-doctor <slug> --json',
             emit: 'td agent-event <slug> <event> [status]',
-            inspect: 'td plugin-list',
+            inspect: 'td plugin-list --json',
+            hooks: 'td plugin-hooks <slug> <install|uninstall>',
             remove: 'td plugin-remove <slug>',
         },
         ui: {
@@ -1763,6 +1872,21 @@ function runPluginInitJson() {
             indicator: 'Theme-safe visual indicator.',
             tone: 'Theme token; arbitrary status colors are not accepted.',
         },
+        security: {
+            source: 'Only public HTTPS repository roots on approved Git hosts or explicit local paths are accepted; URL credentials are rejected.',
+            package: 'Symlinks, active/external SVG content, oversized files, submodules, and excessive unpacked size are rejected.',
+            hooks: 'hooks.target must be a non-symlinked ~/ JSON path. Termdock generates the hook command; manifests cannot inject shell.',
+            titleCommands: 'Installing or inspecting a plugin never executes its title/model commands. They run only after the user enables automatic titles for that plugin.',
+            updates: 'Changes to hook or title command declarations revoke the corresponding prior opt-in.',
+        },
+        titleModelContract: {
+            noCatalog: 'If titleNamer.models is absent or yields no recommendation, Termdock omits modelArgs and uses the Agent CLI default model.',
+            optionalArguments: 'Put every model-only flag/value in titleNamer.modelArgs. The complete group is prepended only when a model is selected.',
+            acceptedOutput: 'A JSON array or {models, recommendedModel}. Entries may use id, name, or model; optional fields: displayName/display_name, description, isDefault/is_default, isEconomical/is_economical.',
+            automaticSelection: 'Top-level recommendedModel, then the first isEconomical model, then the first isDefault model; otherwise omit modelArgs and use the CLI default. Termdock never guesses price from names or descriptions.',
+            adapters: 'Use command: node plus {pluginDir}/scripts/list-models.mjs when the native CLI output needs normalization. Never hardcode a model catalog.',
+            verify: 'Run td plugin-doctor <slug> --json. This explicit command probes models but never spends a title-generation request.',
+        },
         migrationV1: {
             errorCode: 'AGENT_PLUGIN_MANIFEST_V1_UNSUPPORTED',
             guideCommand: 'td agent-plugin --json',
@@ -1774,12 +1898,16 @@ function runPluginInitJson() {
             example: 'printf \'%s\' \'{"session_id":"abc","message":"Indexing"}\' | td agent-event my-agent prompt-submit thinking',
         },
         integrationSteps: [
-            'Generate a version 2 manifest using this schema and save it as JSON.',
-            'Run td plugin-create <manifest-file>; the Agent appears in Termdock immediately.',
+            'Create a repository with manifest.json at its root; icon.svg and helper files are optional.',
+            'Publish the repository, then install it with td plugin-install <https-git-url>. Local directories are also supported.',
+            'For manifest-only development, td plugin-create <manifest-file> remains available.',
             'Ask the user to open Settings > Detection Rules and click Install for this Agent. They can uninstall it there later.',
             'If the Agent hook format is not a Claude-style hooks map, configure native hooks to call td agent-event directly.',
             'Map the completed-turn hook to event "stop"; this is also the automatic-title trigger when the user enables titles for the Agent.',
             'Optionally declare titleNamer so this Agent can generate titles and dynamically publish its own model catalog.',
+            'Put optional model flags in titleNamer.modelArgs; keep the always-present prompt invocation in titleNamer.args.',
+            'Run td plugin-doctor <slug> --json and fix every warning before sharing the repository.',
+            'Tell the user that enabling a plugin title provider executes that plugin\'s declared CLI; installation alone never does.',
             'Run td plugin-list to verify registration.',
         ],
         manifest: AGENT_PLUGIN_EXAMPLE,
@@ -1862,7 +1990,7 @@ ${c.dim('───────────────────')}
 
   ${c.dim('// ── optional: hook installation (bring your own hooks.json surface) ──')}
   "hooks": {
-    ${c.dim("// Path to the agent's hooks config file (~-abbreviated).")}
+    ${c.dim("// JSON path under ~/ only; symlink traversal is rejected.")}
     ${c.dim('// termdock inserts marker-carrying entries; leaves user entries untouched.')}
     "target": "~/.trae/settings.json",
 
@@ -1888,10 +2016,13 @@ ${c.dim('───────────────────')}
 
   ${c.dim('// ── optional: injectable automatic-title provider ──')}
   "titleNamer": {
-    ${c.dim('// No shell expansion. {prompt} is required; a bare {model} arg is omitted when automatic.')}
+    ${c.dim('// No shell expansion. Commands run only after the user enables this title provider.')}
+    ${c.dim('// modelArgs is an all-or-nothing group and is omitted for CLI-default mode.')}
     "command": "trae",
-    "args": ["title", "--prompt", "{prompt}", "--model={model}"],
-    ${c.dim('// Must print JSON: strings or {id, displayName, description, isDefault} objects.')}
+    "modelArgs": ["--model", "{model}"],
+    "args": ["title", "--prompt", "{prompt}"],
+    ${c.dim('// JSON array or {models,recommendedModel}; id/name/model are accepted.')}
+    ${c.dim('// Use node + {pluginDir}/scripts/... when native fields need conversion.')}
     "models": { "command": "trae", "args": ["models", "--json"] }
   }
 }
@@ -1915,11 +2046,20 @@ ${c.dim('──────────────────')}
   ${c.dim('# Inject the Agent definition; it appears in the UI immediately')}
   td plugin-create ./trae-manifest.json
 
+  ${c.dim('# Or install a complete, updateable package from a public HTTPS Git repository')}
+  td plugin-install https://github.com/owner/trae-termdock-plugin
+
   ${c.dim('# The user then opens Settings > Detection Rules and clicks Install.')}
   ${c.dim('# The same UI button can uninstall the hooks later.')}
 
   ${c.dim('# Verify registration')}
-  td plugin-list
+  td plugin-list --json
+
+  ${c.dim('# Manage the package and its hooks independently')}
+  td plugin-check trae
+  td plugin-update trae
+  td plugin-doctor trae --json
+  td plugin-hooks trae install
 
   ${c.dim('# Remove')}
   td plugin-remove trae
@@ -1993,7 +2133,21 @@ async function runPluginCreate(manifestPath) {
     console.log(`  ${c.dim('Visible immediately in Settings > Detection Rules; no restart required.')}`);
     console.log(`  ${c.dim('The user can click Install or Uninstall there.')}`);
 }
-async function runPluginList() {
+async function runPluginInstall(source) {
+    const { baseUrl, token } = requireRunningServer();
+    const normalizedSource = /^https:\/\//i.test(source) ? source : path.resolve(source);
+    const response = await postLocalJson(baseUrl, token, '/api/terminal/agent-plugins/install', { source: normalizedSource });
+    const body = JSON.parse(response.body || '{}');
+    if (response.statusCode < 200 || response.statusCode >= 300) {
+        console.error(`${ICON.err} ${c.red(body.code ? `${body.code}: ${body.error ?? 'Plugin installation failed'}` : body.error ?? 'Plugin installation failed')}`);
+        process.exit(1);
+    }
+    console.log(`${ICON.ok} ${c.green(`Plugin "${body.slug}" installed.`)}`);
+    if (body.dir)
+        console.log(`  ${c.dim('Directory:')} ${c.cyan(body.dir)}`);
+    console.log(`  ${c.dim('Next:')} ${c.cyan(`td plugin-hooks ${body.slug} install`)} ${c.dim('or use Settings > Detection Rules')}`);
+}
+async function runPluginList(json = false) {
     const { baseUrl, token } = requireRunningServer();
     const response = await getLocalJson(baseUrl, token, '/api/terminal/agent-plugins');
     const body = JSON.parse(response.body || '{}');
@@ -2001,6 +2155,10 @@ async function runPluginList() {
         console.error(`${ICON.err} ${c.red('Failed to list plugins')}`);
         process.exit(1);
     }
+    if (json) {
+        console.log(JSON.stringify(body, null, 2));
+        return;
+    }
     const plugins = body.plugins ?? [];
     if (plugins.length === 0) {
         console.log(`${c.dim('No plugins installed.')}`);
@@ -2019,7 +2177,11 @@ async function runPluginList() {
                 flags.push('resume');
             if (p.iconMode !== 'mask')
                 flags.push(p.iconMode);
+            if (p.updateAvailable)
+                flags.push('update');
             console.log(`  ${c.cyan(p.slug)}  ${c.dim(p.displayName)}  ${c.gray(p.accentColor)}  ${c.dim(flags.length > 0 ? `[${flags.join(', ')}]` : '')}`);
+            if (p.source)
+                console.log(`    ${c.dim(`${p.sourceType ?? 'source'}: ${p.source}${p.revision ? ` @ ${p.revision.slice(0, 8)}` : ''}`)}`);
         }
     }
     const errors = body.errors ?? [];
@@ -2037,6 +2199,68 @@ async function runPluginList() {
         }
     }
 }
+async function runPluginSourceAction(slug, action) {
+    const { baseUrl, token } = requireRunningServer();
+    const response = await postLocalJson(baseUrl, token, `/api/terminal/agent-plugins/${encodeURIComponent(slug)}/${action}`, {});
+    const body = JSON.parse(response.body || '{}');
+    if (response.statusCode < 200 || response.statusCode >= 300) {
+        console.error(`${ICON.err} ${c.red(body.error ?? `Plugin ${action} failed`)}`);
+        process.exit(1);
+    }
+    if (action === 'check-update') {
+        console.log(body.updateAvailable
+            ? `${ICON.warn} ${c.yellow(`Update available for ${slug}`)} ${c.dim(`${body.revision?.slice(0, 8) ?? '?'} → ${body.latestRevision?.slice(0, 8) ?? '?'}`)}`
+            : `${ICON.ok} ${c.green(`${slug} is up to date.`)}`);
+    }
+    else {
+        console.log(`${ICON.ok} ${c.green(`Plugin "${slug}" updated.`)}`);
+        if (body.hookWarning)
+            console.log(`${ICON.warn} ${c.yellow(`Hooks need attention: ${body.hookWarning}`)}`);
+        if (body.titleWarning)
+            console.log(`${ICON.warn} ${c.yellow(`Title commands need attention: ${body.titleWarning}`)}`);
+    }
+}
+async function runPluginDoctor(slug, json = false) {
+    const { baseUrl, token } = requireRunningServer();
+    const response = await postLocalJson(baseUrl, token, `/api/terminal/agent-plugins/${encodeURIComponent(slug)}/doctor`, {});
+    const body = JSON.parse(response.body || '{}');
+    if (response.statusCode < 200 || response.statusCode >= 300) {
+        console.error(`${ICON.err} ${c.red(body.error ?? 'Plugin diagnosis failed')}`);
+        process.exit(1);
+    }
+    if (json) {
+        console.log(JSON.stringify(body, null, 2));
+    }
+    else {
+        const ok = body.status === 'ok' || body.status === 'cli-default';
+        console.log(`${ok ? ICON.ok : ICON.warn} ${ok ? c.green(body.displayName ?? slug) : c.yellow(body.displayName ?? slug)} ${c.dim(`(${body.status ?? 'unknown'})`)}`);
+        console.log(`  ${c.dim('Title provider:')} ${body.hasTitleNamer ? 'yes' : 'no'}`);
+        console.log(`  ${c.dim('Model probe:')} ${body.hasModelCommand ? `${body.models?.length ?? 0} usable model(s)` : 'not declared; CLI default'}`);
+        if (body.recommendedModel)
+            console.log(`  ${c.dim('Automatic model:')} ${c.cyan(body.recommendedModel)}`);
+        if (body.selectionBehavior)
+            console.log(`  ${c.dim('Behavior:')} ${body.selectionBehavior}`);
+        if (body.error)
+            console.log(`  ${c.red('Error:')} ${body.error}`);
+        for (const warning of body.warnings ?? [])
+            console.log(`  ${ICON.warn} ${c.yellow(warning)}`);
+        for (const step of body.nextSteps ?? [])
+            console.log(`  ${c.dim('Next:')} ${step}`);
+    }
+    if (body.status === 'missing-title-namer' || body.status === 'probe-failed' || body.status === 'no-models') {
+        process.exitCode = 1;
+    }
+}
+async function runPluginHooks(slug, action) {
+    const { baseUrl, token } = requireRunningServer();
+    const response = await postLocalJson(baseUrl, token, `/api/terminal/agent-hooks/${encodeURIComponent(slug)}/${action}`, {});
+    const body = JSON.parse(response.body || '{}');
+    if (response.statusCode < 200 || response.statusCode >= 300) {
+        console.error(`${ICON.err} ${c.red(body.error ?? `Plugin hook ${action} failed`)}`);
+        process.exit(1);
+    }
+    console.log(`${ICON.ok} ${c.green(body.summary ?? `Hooks ${action === 'install' ? 'installed' : 'removed'}.`)}`);
+}
 async function runPluginRemove(slug) {
     const { baseUrl, token } = requireRunningServer();
     const response = await new Promise((resolve, reject) => {
@@ -3029,8 +3253,44 @@ async function main() {
         await runPluginCreate(options.pluginCreate);
         process.exit(0);
     }
+    if (options.pluginInstall !== undefined) {
+        if (!options.pluginInstall) {
+            console.error(`${ICON.err} ${c.red('plugin-install requires an HTTPS Git URL or local package path')}`);
+            process.exit(1);
+        }
+        await runPluginInstall(options.pluginInstall);
+        process.exit(0);
+    }
     if (options.pluginList) {
-        await runPluginList();
+        await runPluginList(options.pluginListJson);
+        process.exit(0);
+    }
+    if (options.pluginCheck !== undefined) {
+        if (!options.pluginCheck) {
+            console.error(`${ICON.err} ${c.red('plugin-check requires a plugin slug')}`);
+            process.exit(1);
+        }
+        await runPluginSourceAction(options.pluginCheck, 'check-update');
+        process.exit(0);
+    }
+    if (options.pluginUpdate !== undefined) {
+        if (!options.pluginUpdate) {
+            console.error(`${ICON.err} ${c.red('plugin-update requires a plugin slug')}`);
+            process.exit(1);
+        }
+        await runPluginSourceAction(options.pluginUpdate, 'update');
+        process.exit(0);
+    }
+    if (options.pluginDoctor) {
+        if (!options.pluginDoctor.slug) {
+            console.error(`${ICON.err} ${c.red('plugin-doctor requires a plugin slug')}`);
+            process.exit(1);
+        }
+        await runPluginDoctor(options.pluginDoctor.slug, options.pluginDoctor.json);
+        process.exit(process.exitCode ?? 0);
+    }
+    if (options.pluginHooks) {
+        await runPluginHooks(options.pluginHooks.slug, options.pluginHooks.action);
         process.exit(0);
     }
     if (options.pluginRemove !== undefined) {

package/dist/server/entry.js

@@ -411,13 +411,22 @@ export function createApp(options = {}) {
     app.get('/api/home', requireAuth(), (_req, res) => {
         res.json({ home: homedir() });
     });
+    // A locally installed Agent/plugin CLI uses the mode-0600 local API token.
+    // Keep this bypass loopback-only: possession of the token must not turn the
+    // LAN-facing terminal API into a bearer-token endpoint.
+    const isTrustedLocalCliRequest = (req) => {
+        if (!options.localApiToken || req.header('X-Termdock-Local-Token') !== options.localApiToken)
+            return false;
+        const address = req.socket.remoteAddress ?? '';
+        return address === '127.0.0.1' || address === '::1' || address === '::ffff:127.0.0.1';
+    };
     // 应用鉴权 + CSRF保护（在终端路由之前）
     // The HTML preview route authenticates itself: document requests use the
     // session cookie, then get redirected to a short-lived URL token so the
     // sandboxed iframe's subresource requests (which browsers refuse to send
     // cookies for) can still load images/css/js.
-    app.use('/api/terminal', requireAuth({ bypass: (req) => req.path.startsWith('/fs/preview') }));
-    app.use('/api/terminal', csrfProtection.verifyMiddleware());
+    app.use('/api/terminal', requireAuth({ bypass: (req) => req.path.startsWith('/fs/preview') || isTrustedLocalCliRequest(req) }));
+    app.use('/api/terminal', csrfProtection.verifyMiddleware({ bypass: isTrustedLocalCliRequest }));
     // 终端路由
     app.use('/api/terminal', terminalRoutes);
     // 文件系统路由（继承 /api/terminal 上的 auth + CSRF 保护）