agent-things 0.0.0-stage → 1.2.2
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.
- package/LICENSE +21 -0
- package/NOTICE +5 -0
- package/README.md +221 -2
- package/bin/agent-things.cjs +8 -0
- package/bin/antigravity-session-status.cjs +96 -0
- package/bin/claude-session-status.cjs +55 -0
- package/bin/codex-session-status.cjs +287 -0
- package/mods/agent-things-ui/.claude-plugin/plugin.json +12 -0
- package/mods/agent-things-ui/SKILL.md +10 -0
- package/mods/agent-things-ui/hooks/controls.js +112 -0
- package/mods/agent-things-ui/hooks/foundation.js +431 -0
- package/mods/agent-things-ui/hooks/hooks.json +1 -0
- package/mods/agent-things-ui/hooks/presentation.js +223 -0
- package/mods/agent-things-ui/hooks/progress.js +1 -0
- package/mods/agent-things-ui/hooks/register.js +382 -0
- package/native/bin/bridge +0 -0
- package/native/bin/bridge.json +20 -0
- package/native/session-status-bridge.swift +280 -0
- package/outputs/antigravity-session-status.js +2476 -0
- package/outputs/codex-session-status.js +1761 -0
- package/package.json +75 -4
- package/scripts/build-antigravity-bundle.cjs +35 -0
- package/scripts/build-codex-bundle.cjs +31 -0
- package/scripts/build-native-bridge.cjs +55 -0
- package/scripts/build-shared-ui.cjs +16 -0
- package/scripts/setup-antigravity-service.cjs +71 -0
- package/scripts/setup-claude-service.cjs +21 -0
- package/skills/agent-things/SKILL.en.md +95 -0
- package/skills/agent-things/SKILL.md +99 -0
- package/skills/codex/things/SKILL.en.md +10 -0
- package/skills/codex/things/SKILL.md +10 -0
- package/skills/things/SKILL.en.md +10 -0
- package/skills/things/SKILL.md +10 -0
- package/skills/things/checklist.en.md +91 -0
- package/skills/things/checklist.md +95 -0
- package/src/analysis-app-server.cjs +74 -0
- package/src/analysis-assets/output.en.schema.json +93 -0
- package/src/analysis-assets/output.schema.json +93 -0
- package/src/analysis-assets/prompt.en.txt +17 -0
- package/src/analysis-assets/prompt.zh-CN.txt +18 -0
- package/src/analysis-budget.cjs +105 -0
- package/src/analysis-git.cjs +38 -0
- package/src/analysis-history.cjs +150 -0
- package/src/analysis-ledger.cjs +82 -0
- package/src/analysis-log.cjs +62 -0
- package/src/analysis-runner.cjs +203 -0
- package/src/analysis-service.cjs +197 -0
- package/src/analysis-source.cjs +72 -0
- package/src/antigravity-card.cjs +2063 -0
- package/src/antigravity-hook.cjs +138 -0
- package/src/antigravity-mcp-config.cjs +36 -0
- package/src/app-server.cjs +96 -0
- package/src/cdp.cjs +115 -0
- package/src/claude-inline-install.cjs +38 -0
- package/src/claude-mcp-config.cjs +29 -0
- package/src/cli/arguments.cjs +30 -0
- package/src/cli/environment-probe.cjs +130 -0
- package/src/cli/integration-state.cjs +15 -0
- package/src/cli/interactive-cli.cjs +236 -0
- package/src/cli/prompt-tui.cjs +420 -0
- package/src/cli/setup-orchestrator.cjs +449 -0
- package/src/codex-mcp-config.cjs +67 -0
- package/src/harnesses/antigravity/analysis-profile.cjs +41 -0
- package/src/harnesses/antigravity/antigravity-git.cjs +89 -0
- package/src/harnesses/antigravity/antigravity-harness.js +1477 -0
- package/src/harnesses/antigravity/antigravity-injector.cjs +104 -0
- package/src/harnesses/antigravity/antigravity-migration.cjs +235 -0
- package/src/harnesses/antigravity/antigravity-service.cjs +357 -0
- package/src/harnesses/antigravity/antigravity-title.cjs +155 -0
- package/src/harnesses/antigravity/gemini-runner.cjs +304 -0
- package/src/harnesses/antigravity/transcript-cleaner.cjs +129 -0
- package/src/harnesses/antigravity/transcript-source.cjs +100 -0
- package/src/harnesses/claude/claude-harness.js +93 -0
- package/src/harnesses/claude/claude-host-helper.cjs +176 -0
- package/src/harnesses/claude/claude-injector.cjs +95 -0
- package/src/harnesses/claude/claude-local-source.cjs +106 -0
- package/src/harnesses/claude/claude-navigation.cjs +99 -0
- package/src/harnesses/claude/claude-runner.cjs +74 -0
- package/src/harnesses/claude/claude-service.cjs +313 -0
- package/src/harnesses/claude/claude-source.cjs +70 -0
- package/src/harnesses/codex/codex-analysis.cjs +10 -0
- package/src/harnesses/codex/codex-card-bridge.js +123 -0
- package/src/harnesses/codex/codex-card-events.cjs +76 -0
- package/src/harnesses/codex/codex-card.cjs +169 -0
- package/src/harnesses/codex/codex-git.cjs +24 -0
- package/src/harnesses/codex/codex-harness.js +229 -0
- package/src/harnesses/codex/codex-local-card.js +97 -0
- package/src/harnesses/codex/codex-progress-context.cjs +84 -0
- package/src/harnesses/codex/codex-service.cjs +502 -0
- package/src/i18n.cjs +174 -0
- package/src/launchd.cjs +105 -0
- package/src/lifecycle-lock.cjs +13 -0
- package/src/local-progress-http.cjs +267 -0
- package/src/manual-status-agent.cjs +12 -0
- package/src/manual-status-startup.cjs +66 -0
- package/src/manual-status-store.cjs +466 -0
- package/src/mcp-stdio.cjs +67 -0
- package/src/model-router.cjs +63 -0
- package/src/native-bridge.cjs +17 -0
- package/src/npm-updates.cjs +228 -0
- package/src/plugins/things/assets/logo.svg +13 -0
- package/src/plugins/things/plugin.json +6 -0
- package/src/plugins/things/sidecars/things_board/app.js +447 -0
- package/src/plugins/things/sidecars/things_board/index.html +2141 -0
- package/src/plugins/things/sidecars/things_board/main.mjs +652 -0
- package/src/plugins/things/sidecars/things_board/package.json +6 -0
- package/src/plugins/things/sidecars/things_board/sidecar.json +21 -0
- package/src/plugins/things/sidecars/things_board/styles.css +560 -0
- package/src/plugins/things/sidecars/things_board/ui-i18n.mjs +434 -0
- package/src/progress-error.cjs +54 -0
- package/src/progress-tools.cjs +145 -0
- package/src/project-path.cjs +15 -0
- package/src/renderer-resource.cjs +17 -0
- package/src/request-budget.cjs +24 -0
- package/src/resolve.cjs +51 -0
- package/src/runtime-install.cjs +635 -0
- package/src/session-status-filter.cjs +136 -0
- package/src/session-status.js +992 -0
- package/src/session-view.cjs +34 -0
- package/src/startup/controller.cjs +354 -0
- package/src/startup/watch.cjs +126 -0
- package/src/state-file-lock.cjs +31 -0
- package/src/task-provenance.cjs +42 -0
- package/src/ui-foundation.cjs +435 -0
package/package.json
CHANGED
|
@@ -1,6 +1,77 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agent-things",
|
|
3
|
-
"version": "
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "1.2.2",
|
|
4
|
+
"description": "Session task progress and checklists for ChatGPT, Antigravity and Claude Desktop on macOS.",
|
|
5
|
+
"license": "MIT",
|
|
6
|
+
"author": "snuffpic",
|
|
7
|
+
"repository": {
|
|
8
|
+
"type": "git",
|
|
9
|
+
"url": "git+https://github.com/snuffpic/agent-things.git"
|
|
10
|
+
},
|
|
11
|
+
"homepage": "https://github.com/snuffpic/agent-things#readme",
|
|
12
|
+
"bugs": {
|
|
13
|
+
"url": "https://github.com/snuffpic/agent-things/issues"
|
|
14
|
+
},
|
|
15
|
+
"type": "commonjs",
|
|
16
|
+
"bin": {
|
|
17
|
+
"agent-things": "bin/codex-session-status.cjs",
|
|
18
|
+
"codex-session-status": "bin/codex-session-status.cjs",
|
|
19
|
+
"antigravity-session-status": "bin/antigravity-session-status.cjs"
|
|
20
|
+
},
|
|
21
|
+
"engines": {
|
|
22
|
+
"node": ">=22"
|
|
23
|
+
},
|
|
24
|
+
"os": [
|
|
25
|
+
"darwin"
|
|
26
|
+
],
|
|
27
|
+
"scripts": {
|
|
28
|
+
"test": "SESSION_STATUS_PORT=0 SESSION_STATUS_CONFIG=/tmp/agent-things-test-isolated-config.json node --test --test-timeout=60000 test/*.test.cjs",
|
|
29
|
+
"build:bundles": "node scripts/build-shared-ui.cjs && node scripts/build-antigravity-bundle.cjs && node scripts/build-codex-bundle.cjs",
|
|
30
|
+
"build:bridge": "node scripts/build-native-bridge.cjs",
|
|
31
|
+
"prepack": "npm run build:bridge && npm run build:bundles",
|
|
32
|
+
"mcp": "node bin/codex-session-status.cjs mcp",
|
|
33
|
+
"mcp:antigravity": "node bin/antigravity-session-status.cjs",
|
|
34
|
+
"check:syntax": "node scripts/check.cjs",
|
|
35
|
+
"check:package": "node scripts/check-package.cjs",
|
|
36
|
+
"check:browser": "SESSION_STATUS_CONFIG=/tmp/agent-things-test-isolated-config.json AGENT_THINGS_CHECK_HOST=codex node scripts/check-session-status.cjs",
|
|
37
|
+
"verify": "npm run check:syntax && npm run build:bridge && npm run build:bundles && git diff --exit-code -- outputs/ mods/agent-things-ui/hooks/foundation.js && npm test && npm run check:browser && npm run check:package"
|
|
38
|
+
},
|
|
39
|
+
"keywords": [
|
|
40
|
+
"agent",
|
|
41
|
+
"antigravity",
|
|
42
|
+
"codex",
|
|
43
|
+
"mcp",
|
|
44
|
+
"task-manager",
|
|
45
|
+
"gtd",
|
|
46
|
+
"session-status",
|
|
47
|
+
"ai-agent"
|
|
48
|
+
],
|
|
49
|
+
"files": [
|
|
50
|
+
"bin/*.cjs",
|
|
51
|
+
"src/**/*.cjs",
|
|
52
|
+
"src/**/*.js",
|
|
53
|
+
"src/plugins/things/**",
|
|
54
|
+
"src/analysis-assets/*.txt",
|
|
55
|
+
"src/analysis-assets/*.json",
|
|
56
|
+
"outputs/*.js",
|
|
57
|
+
"LICENSE",
|
|
58
|
+
"NOTICE",
|
|
59
|
+
"native/*.swift",
|
|
60
|
+
"native/bin/bridge",
|
|
61
|
+
"native/bin/bridge.json",
|
|
62
|
+
"skills/**/*.md",
|
|
63
|
+
"mods/agent-things-ui/.claude-plugin/plugin.json",
|
|
64
|
+
"mods/agent-things-ui/SKILL.md",
|
|
65
|
+
"mods/agent-things-ui/hooks/*.js",
|
|
66
|
+
"mods/agent-things-ui/hooks/*.json",
|
|
67
|
+
"scripts/setup-antigravity-service.cjs",
|
|
68
|
+
"scripts/setup-claude-service.cjs",
|
|
69
|
+
"scripts/build-native-bridge.cjs",
|
|
70
|
+
"scripts/build-*-bundle.cjs",
|
|
71
|
+
"scripts/build-shared-ui.cjs"
|
|
72
|
+
],
|
|
73
|
+
"publishConfig": {
|
|
74
|
+
"access": "public",
|
|
75
|
+
"registry": "https://registry.npmjs.org"
|
|
76
|
+
}
|
|
77
|
+
}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
const fs = require('node:fs');
|
|
3
|
+
const path = require('node:path');
|
|
4
|
+
|
|
5
|
+
function buildBundle() {
|
|
6
|
+
const root = path.resolve(__dirname, '..');
|
|
7
|
+
const harnessPath = path.join(root, 'src/harnesses/antigravity/antigravity-harness.js');
|
|
8
|
+
const panelPath = path.join(root, 'src/session-status.js');
|
|
9
|
+
const outDir = path.join(root, 'outputs');
|
|
10
|
+
const outFile = path.join(outDir, 'antigravity-session-status.js');
|
|
11
|
+
|
|
12
|
+
const harnessCode = fs.readFileSync(harnessPath, 'utf8');
|
|
13
|
+
const panelCode = fs.readFileSync(panelPath, 'utf8');
|
|
14
|
+
|
|
15
|
+
const combined = `// Antigravity Session Status Bundle (Auto-generated)
|
|
16
|
+
// Zero-friction embedded panel for Antigravity
|
|
17
|
+
|
|
18
|
+
${harnessCode}
|
|
19
|
+
|
|
20
|
+
${panelCode}
|
|
21
|
+
|
|
22
|
+
`;
|
|
23
|
+
|
|
24
|
+
fs.mkdirSync(outDir, { recursive: true });
|
|
25
|
+
fs.writeFileSync(outFile, combined, 'utf8');
|
|
26
|
+
console.log(`✅ Built bundle: ${outFile} (${Buffer.byteLength(combined)} bytes)`);
|
|
27
|
+
|
|
28
|
+
return outFile;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
if (require.main === module) {
|
|
32
|
+
buildBundle();
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
module.exports = { buildBundle };
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
const fs = require('node:fs');
|
|
3
|
+
const path = require('node:path');
|
|
4
|
+
const { readRendererResource } = require('../src/renderer-resource.cjs');
|
|
5
|
+
|
|
6
|
+
function buildCodexBundle() {
|
|
7
|
+
const root = path.resolve(__dirname, '..');
|
|
8
|
+
const harnessPath = path.join(root, 'src/harnesses/codex/codex-harness.js');
|
|
9
|
+
const panelPath = path.join(root, 'src/session-status.js');
|
|
10
|
+
const outDir = path.join(root, 'outputs');
|
|
11
|
+
const outFile = path.join(outDir, 'codex-session-status.js');
|
|
12
|
+
|
|
13
|
+
const { source } = readRendererResource({ harnessFile: harnessPath, rendererFile: panelPath });
|
|
14
|
+
|
|
15
|
+
const combined = `// Agent Things Codex Bundle (Auto-generated)
|
|
16
|
+
// Things 3 task manager and session progress overlay for Codex
|
|
17
|
+
|
|
18
|
+
${source}
|
|
19
|
+
`;
|
|
20
|
+
|
|
21
|
+
fs.mkdirSync(outDir, { recursive: true });
|
|
22
|
+
fs.writeFileSync(outFile, combined, 'utf8');
|
|
23
|
+
console.log(`✅ Built Codex bundle: ${outFile} (${Buffer.byteLength(combined)} bytes)`);
|
|
24
|
+
return outFile;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
if (require.main === module) {
|
|
28
|
+
buildCodexBundle();
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
module.exports = { buildCodexBundle };
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
const fs = require('node:fs');
|
|
3
|
+
const path = require('node:path');
|
|
4
|
+
const os = require('node:os');
|
|
5
|
+
const crypto = require('node:crypto');
|
|
6
|
+
const { execFileSync } = require('node:child_process');
|
|
7
|
+
const { verifyBridgeBundle } = require('../src/native-bridge.cjs');
|
|
8
|
+
|
|
9
|
+
function buildNativeBridge() {
|
|
10
|
+
if (process.platform !== 'darwin') throw new Error('请在 macOS 上构建启动桥,需要 Xcode Command Line Tools');
|
|
11
|
+
const root = path.resolve(__dirname, '..');
|
|
12
|
+
const source = path.join(root, 'native/session-status-bridge.swift');
|
|
13
|
+
// Keep the exact signed executable when the source has not changed. Its code
|
|
14
|
+
// identity is also the user's macOS Accessibility permission identity.
|
|
15
|
+
try {
|
|
16
|
+
const existing = verifyBridgeBundle(root);
|
|
17
|
+
execFileSync('/usr/bin/xcrun', ['lipo', existing, '-verify_arch', 'arm64', 'x86_64'], { stdio: 'pipe', timeout: 5000 });
|
|
18
|
+
execFileSync('/usr/bin/codesign', ['--verify', '--strict', '--all-architectures', existing], { stdio: 'pipe', timeout: 5000 });
|
|
19
|
+
const version = JSON.parse(execFileSync(existing, ['version'], { encoding: 'utf8', timeout: 5000 }));
|
|
20
|
+
if (version.protocol === 1) {
|
|
21
|
+
console.log('Reusing verified universal startup bridge'); return;
|
|
22
|
+
}
|
|
23
|
+
} catch { /* Changed or absent artifacts need a new build. */ }
|
|
24
|
+
|
|
25
|
+
const directory = fs.mkdtempSync(path.join(os.tmpdir(), 'agent-things-bridge-'));
|
|
26
|
+
const architectures = ['arm64', 'x86_64'];
|
|
27
|
+
const options = { stdio: 'pipe', timeout: 180000 };
|
|
28
|
+
try {
|
|
29
|
+
for (const architecture of architectures) {
|
|
30
|
+
execFileSync('/usr/bin/xcrun', ['swiftc', '-O', '-swift-version', '5', '-target', `${architecture}-apple-macos11.0`, source,
|
|
31
|
+
'-o', path.join(directory, architecture)], options);
|
|
32
|
+
}
|
|
33
|
+
const binary = path.join(directory, 'bridge');
|
|
34
|
+
execFileSync('/usr/bin/xcrun', ['lipo', '-create', ...architectures.map(architecture => path.join(directory, architecture)), '-output', binary], options);
|
|
35
|
+
execFileSync('/usr/bin/codesign', ['--force', '--sign', '-', '--timestamp=none', '--identifier', 'com.agent-things.session-status-bridge', binary], options);
|
|
36
|
+
execFileSync('/usr/bin/xcrun', ['lipo', binary, '-verify_arch', ...architectures], options);
|
|
37
|
+
execFileSync('/usr/bin/codesign', ['--verify', '--strict', '--all-architectures', binary], options);
|
|
38
|
+
const version = JSON.parse(execFileSync(binary, ['version'], { ...options, encoding: 'utf8', timeout: 5000 }));
|
|
39
|
+
if (version.protocol !== 1) throw new Error('构建产物启动桥协议不匹配');
|
|
40
|
+
const hash = file => crypto.createHash('sha256').update(fs.readFileSync(file)).digest('hex');
|
|
41
|
+
const manifest = { protocol: 1, architectures, minimumMacOS: '11.0', sourceSha256: hash(source), sha256: hash(binary), capabilities: version.capabilities };
|
|
42
|
+
const output = path.join(root, 'native/bin');
|
|
43
|
+
fs.mkdirSync(output, { recursive: true });
|
|
44
|
+
fs.chmodSync(binary, 0o755);
|
|
45
|
+
fs.copyFileSync(binary, path.join(output, 'bridge'));
|
|
46
|
+
fs.writeFileSync(path.join(output, 'bridge.json'), JSON.stringify(manifest, null, 2) + '\n');
|
|
47
|
+
console.log(`Built universal startup bridge: ${architectures.join(' + ')}, ${fs.statSync(binary).size} bytes`);
|
|
48
|
+
} finally { fs.rmSync(directory, { recursive: true, force: true }); }
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
if (require.main === module) {
|
|
52
|
+
try { buildNativeBridge(); }
|
|
53
|
+
catch (error) { console.error(error.stderr?.toString() || error.message); process.exitCode = 1; }
|
|
54
|
+
}
|
|
55
|
+
module.exports = { buildNativeBridge };
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
const fs = require('node:fs');
|
|
3
|
+
const path = require('node:path');
|
|
4
|
+
const { createPresentation } = require('../src/ui-foundation.cjs');
|
|
5
|
+
|
|
6
|
+
function buildSharedUi() {
|
|
7
|
+
const target = path.join(__dirname, '../mods/agent-things-ui/hooks/foundation.js');
|
|
8
|
+
const source = `// Generated from src/ui-foundation.cjs. Edit the shared source.\nconst presentation = (${createPresentation.toString()})();\nexport const { lang, labels, colors, taskLabels, strings, locales, layout, accent, t, format, forLang, formatDate, progressValue, progressState, draftTransition, analysisDisabled } = presentation;\n`;
|
|
9
|
+
fs.writeFileSync(target, source);
|
|
10
|
+
|
|
11
|
+
const sidecarI18nTarget = path.join(__dirname, '../src/plugins/things/sidecars/things_board/ui-i18n.mjs');
|
|
12
|
+
const sidecarSource = `// Generated from src/ui-foundation.cjs. Edit the shared source.\nexport const createPresentation = ${createPresentation.toString()};\nexport function getUiForLang(lang) {\n const base = createPresentation(lang);\n return base.forLang ? { ...base, ...base.forLang(lang) } : base;\n}\n`;
|
|
13
|
+
fs.writeFileSync(sidecarI18nTarget, sidecarSource);
|
|
14
|
+
}
|
|
15
|
+
if (require.main === module) buildSharedUi();
|
|
16
|
+
module.exports = { buildSharedUi };
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
'use strict';
|
|
3
|
+
const fs = require('node:fs');
|
|
4
|
+
const path = require('node:path');
|
|
5
|
+
const os = require('node:os');
|
|
6
|
+
const { execSync } = require('node:child_process');
|
|
7
|
+
|
|
8
|
+
const PLIST_NAME = 'com.antigravity.session-status.plist';
|
|
9
|
+
const LAUNCH_AGENTS_DIR = path.join(os.homedir(), 'Library', 'LaunchAgents');
|
|
10
|
+
const PLIST_PATH = path.join(LAUNCH_AGENTS_DIR, PLIST_NAME);
|
|
11
|
+
const ROOT = path.resolve(__dirname, '..');
|
|
12
|
+
const SCRIPT_PATH = path.join(ROOT, 'bin', 'antigravity-session-status.cjs');
|
|
13
|
+
const LOG_DIR = path.join(os.homedir(), '.gemini', 'antigravity', 'session-status');
|
|
14
|
+
|
|
15
|
+
function getAvailableNode() {
|
|
16
|
+
const candidates = [
|
|
17
|
+
process.execPath,
|
|
18
|
+
'/opt/homebrew/bin/node',
|
|
19
|
+
'/usr/local/bin/node',
|
|
20
|
+
path.join(os.homedir(), '.bun/bin/bun'),
|
|
21
|
+
];
|
|
22
|
+
for (const c of candidates) {
|
|
23
|
+
if (fs.existsSync(c)) return c;
|
|
24
|
+
}
|
|
25
|
+
return 'node';
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
async function install({ root = ROOT } = {}) {
|
|
29
|
+
const launchd = require('../src/launchd.cjs');
|
|
30
|
+
fs.mkdirSync(LOG_DIR, { recursive: true, mode: 0o700 });
|
|
31
|
+
await launchd.bootout('com.antigravity.session-status');
|
|
32
|
+
launchd.writePlist({
|
|
33
|
+
Label: 'com.antigravity.session-status',
|
|
34
|
+
ProgramArguments: [getAvailableNode(), path.join(root, 'bin/antigravity-session-status.cjs'), '--daemon'],
|
|
35
|
+
RunAtLoad: true, KeepAlive: { SuccessfulExit: false }, ThrottleInterval: 10,
|
|
36
|
+
StandardOutPath: path.join(LOG_DIR, 'daemon.log'), StandardErrorPath: path.join(LOG_DIR, 'daemon.err.log'),
|
|
37
|
+
EnvironmentVariables: { PATH: process.env.PATH || '/usr/bin:/bin:/opt/homebrew/bin' },
|
|
38
|
+
}, PLIST_PATH);
|
|
39
|
+
launchd.bootstrap(PLIST_PATH);
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
async function uninstall() {
|
|
43
|
+
const launchd = require('../src/launchd.cjs');
|
|
44
|
+
await launchd.bootout('com.antigravity.session-status');
|
|
45
|
+
fs.rmSync(PLIST_PATH, { force: true });
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
function status() {
|
|
49
|
+
try {
|
|
50
|
+
const out = execSync(`launchctl list | grep com.antigravity.session-status || true`, { encoding: 'utf8' });
|
|
51
|
+
if (out.trim()) {
|
|
52
|
+
console.log(`🟢 Running:\n${out.trim()}`);
|
|
53
|
+
} else {
|
|
54
|
+
console.log(`⚪ Not running.`);
|
|
55
|
+
}
|
|
56
|
+
} catch (err) {
|
|
57
|
+
console.error(err.message);
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
if (require.main === module) {
|
|
62
|
+
const cmd = process.argv[2] || 'install';
|
|
63
|
+
if (cmd === 'install') install().catch(error => { console.error(error.message); process.exitCode = 1; });
|
|
64
|
+
else if (cmd === 'uninstall') uninstall().catch(error => { console.error(error.message); process.exitCode = 1; });
|
|
65
|
+
else if (cmd === 'status') status();
|
|
66
|
+
else {
|
|
67
|
+
console.log('Usage: setup-antigravity-service.cjs [install|uninstall|status]');
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
module.exports = { install, uninstall, status, PLIST_PATH };
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
const fs = require('node:fs');
|
|
3
|
+
const os = require('node:os');
|
|
4
|
+
const path = require('node:path');
|
|
5
|
+
const launchd = require('../src/launchd.cjs');
|
|
6
|
+
const { resolveNode } = require('../src/resolve.cjs');
|
|
7
|
+
const { DEFAULT_STATE_FILE } = require('../src/harnesses/claude/claude-service.cjs');
|
|
8
|
+
const LABEL = 'com.agentthings.claude';
|
|
9
|
+
const PLIST_PATH = path.join(os.homedir(), 'Library/LaunchAgents', `${LABEL}.plist`);
|
|
10
|
+
async function install({ root } = {}) {
|
|
11
|
+
const directory = path.dirname(DEFAULT_STATE_FILE);
|
|
12
|
+
fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
|
|
13
|
+
await launchd.bootout(LABEL);
|
|
14
|
+
launchd.writePlist({ Label: LABEL, ProgramArguments: [resolveNode(), path.join(root, 'bin/claude-session-status.cjs'), '--daemon'],
|
|
15
|
+
RunAtLoad: true, KeepAlive: { SuccessfulExit: false }, ThrottleInterval: 10,
|
|
16
|
+
EnvironmentVariables: { NODE_OPTIONS: '', NODE_PATH: '' },
|
|
17
|
+
StandardOutPath: path.join(directory, 'daemon.log'), StandardErrorPath: path.join(directory, 'daemon.err.log') }, PLIST_PATH);
|
|
18
|
+
launchd.bootstrap(PLIST_PATH);
|
|
19
|
+
}
|
|
20
|
+
async function uninstall() { await launchd.bootout(LABEL); fs.rmSync(PLIST_PATH, { force: true }); }
|
|
21
|
+
module.exports = { install, uninstall, LABEL, PLIST_PATH };
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: agent-things
|
|
3
|
+
description: Agent Things core skill for the session Progress Checklist. Use via the session_status MCP (session-status in Antigravity) when the user opens the /things card or asks to get progress, update progress, check remaining tasks, clear progress, or check if a session is ready to archive.
|
|
4
|
+
user-invocable: false
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Agent Things Progress Checklist
|
|
8
|
+
|
|
9
|
+
Reply in the user's current language ("Progress Checklist" in English, "进度清单" in Chinese). Refer to the conversation by its session title or "current session" when speaking to the user.
|
|
10
|
+
|
|
11
|
+
## Session Identity
|
|
12
|
+
|
|
13
|
+
- Codex: obtain the real session ID from `CODEX_THREAD_ID` or explicit session context.
|
|
14
|
+
- Antigravity: obtain the Conversation ID from session metadata.
|
|
15
|
+
- Claude: obtain the real CLI session ID from host-provided session metadata; the service maps it to the corresponding Desktop session record using local metadata. The `/things` command opens the current session card.
|
|
16
|
+
- If the user specifies another session, use the specified ID. When identity is missing, locate the host session first, or ask the user to confirm if still ambiguous.
|
|
17
|
+
- Use the workspace path corresponding to the current session for `project_path`.
|
|
18
|
+
|
|
19
|
+
## Getting & Updating Progress
|
|
20
|
+
|
|
21
|
+
When the user explicitly asks to "get task progress for this session" or similar, your authorization covers reading, initial extraction, saving, and read-back verification.
|
|
22
|
+
|
|
23
|
+
1. Call `get_session_progress` with the real `conversation_id`.
|
|
24
|
+
2. If a record exists, report the saved total tasks, completed count, percentage, remaining tasks, and updated time. If the user asks to update, apply incremental changes on top of the existing ledger and recent conversation turns.
|
|
25
|
+
3. If no record exists or `cleared: true` is returned, inspect accessible user requests and final assistant replies in the target session, organize completed and remaining milestones for the full goal, and create the checklist with `update_session_tasks`.
|
|
26
|
+
4. After writing, call `get_session_progress` again to confirm the tasks, percentage, and revision before reporting back to the user.
|
|
27
|
+
|
|
28
|
+
Reuse task details already visible in context first. When longer history is needed, paginate through the host's session-reading capability and keep real user requests, scope changes, cancellations, confirmations, and final replies while filtering raw tool noise, reasoning, and internal machine events.
|
|
29
|
+
|
|
30
|
+
Follow user and host delegation constraints if delegating analysis. When allowed, prefer a lightweight/economical model and pass the target session ID, existing ledger, and coverage boundary so the worker performs read, write, and read-back verification and returns a concise summary.
|
|
31
|
+
|
|
32
|
+
If accessible history is incomplete, state the coverage scope explicitly and cite evidence for historical completions. Keep confirmed scope and status in the summary; judge git commits, pushes, and live device verification from concrete evidence.
|
|
33
|
+
|
|
34
|
+
## MCP Tool Contract
|
|
35
|
+
|
|
36
|
+
| Tool | Purpose |
|
|
37
|
+
| --- | --- |
|
|
38
|
+
| `get_session_progress` | Read the exact current record and task ledger by `conversation_id` |
|
|
39
|
+
| `update_session_tasks` | Create or incrementally update the task list (percentage is computed by the service) |
|
|
40
|
+
| `update_session_progress` | Save an explicit manual percentage and note requested by the user |
|
|
41
|
+
| `clear_session_progress` | Clear progress, completed/remaining tasks, notes, and timeline for the session |
|
|
42
|
+
| `list_all_session_statuses` | Query sessions by resolved project identity, recent 25, or all projects |
|
|
43
|
+
|
|
44
|
+
Project queries rely on resolved project ownership stored in records. Always rely on `get_session_progress` to judge whether a specific session already has a record; never reuse records from other sessions in project listings.
|
|
45
|
+
|
|
46
|
+
Parameter rules for `update_session_tasks`:
|
|
47
|
+
|
|
48
|
+
- Initial creation: `expected_revision: 0`. If updating an existing record or after `cleared: true`, pass the latest `revision` just read.
|
|
49
|
+
- New tasks use `knownTaskId: null`; existing tasks reuse their `id` as `knownTaskId`.
|
|
50
|
+
- Store the complete task name in `title` (in natural English when configured for English).
|
|
51
|
+
- Set each task's `summary` to a concise action + object label of **at most 60 characters**. Detailed context belongs in `title`, `source`, and session text.
|
|
52
|
+
- Set the top-level `summary` in natural English describing the current goal and remaining work.
|
|
53
|
+
- Set `status` to one of: `todo`, `in_progress`, `blocked`, `needs_verification`, or `done`.
|
|
54
|
+
- Only submit new or changed tasks in `tasks`; the service preserves untouched tasks (including done items).
|
|
55
|
+
- List explicitly cancelled, replaced, or dropped task IDs in `removedTaskIds` (usually `[]` initially).
|
|
56
|
+
- Attach `source` when available (`locator`: a verbatim continuous 10–240 char snippet from a user prompt or final reply, optionally with `turnId` and `itemId`). The service verifies it so the UI shows "View source". Existing refs can reuse `evidenceRefs`.
|
|
57
|
+
- Pass `project_path` when the project path is known.
|
|
58
|
+
|
|
59
|
+
On `REVISION_CONFLICT`, re-read the ledger, reconcile changes, and retry. If a `summary` exceeds the limit, shorten that task's summary per the error message and retry. On read or service errors, report the exact failure while preserving the last successful result.
|
|
60
|
+
|
|
61
|
+
Example initial creation:
|
|
62
|
+
|
|
63
|
+
```json
|
|
64
|
+
{
|
|
65
|
+
"conversation_id": "<current session ID>",
|
|
66
|
+
"expected_revision": 0,
|
|
67
|
+
"summary": "Core features implemented; awaiting user UI verification",
|
|
68
|
+
"tasks": [
|
|
69
|
+
{"knownTaskId": null, "title": "Implement session task progress service", "summary": "Implement task progress service", "status": "done"},
|
|
70
|
+
{"knownTaskId": null, "title": "Complete user visual and interaction review", "summary": "Verify UI and interactions", "status": "todo"}
|
|
71
|
+
],
|
|
72
|
+
"removedTaskIds": []
|
|
73
|
+
}
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
## Clearing Progress & Tasks
|
|
77
|
+
|
|
78
|
+
Run the clear workflow when the user explicitly asks to "clear progress" or "clear session tasks" using the current or specified real `conversation_id`.
|
|
79
|
+
|
|
80
|
+
1. Call `get_session_progress` to fetch the record and latest `revision`; if none or `cleared: true`, inform the user there is no progress recorded.
|
|
81
|
+
2. Call `clear_session_progress` with `conversation_id` and the read `expected_revision`. This clears progress, completed and remaining tasks, notes, task sources, and timeline records.
|
|
82
|
+
3. Verify the response returns `cleared: true`, `tasks: []`, `progress: null`, read back via `get_session_progress`, and concisely confirm cleared. Any subsequent rebuild uses the `revision` returned by the clear call as `expected_revision`.
|
|
83
|
+
|
|
84
|
+
```json
|
|
85
|
+
{
|
|
86
|
+
"conversation_id": "<target session ID>",
|
|
87
|
+
"expected_revision": 158
|
|
88
|
+
}
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
On `REVISION_CONFLICT`, re-read the record and confirm the target before retrying. If tools are not yet visible, instruct the user to reconnect the Agent Things (`session_status`) MCP and retry. After clearing, keep the record empty; rebuild the checklist only when the user asks for it.
|
|
92
|
+
|
|
93
|
+
## Reporting Results
|
|
94
|
+
|
|
95
|
+
After writing and reading back successfully, report concisely: "Updated to X%, A/B completed, C remaining", listing key remaining tasks and any coverage/verification notes. Judge archiving readiness from remaining tasks, delivery state, and user instructions. When a major milestone is reached, submit the confirmed task changes to the existing checklist and tell the user the latest result.
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: agent-things
|
|
3
|
+
description: Agent Things 会话任务进度清单核心技能。当用户通过 /things 卡片、或直接要求获取任务进度、更新进度、查看上次进度、查询遗留任务、清除进度及检查会话是否可归档时,通过 session_status MCP(Antigravity 下为 session-status)完成读写操作。
|
|
4
|
+
user-invocable: false
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Agent Things 会话进度清单
|
|
8
|
+
|
|
9
|
+
使用用户当前的语言回复,中文称“进度清单”,英文称“Progress Checklist”。面向用户使用会话标题或“当前会话”。
|
|
10
|
+
|
|
11
|
+
## 当前会话身份
|
|
12
|
+
|
|
13
|
+
- Codex 从 `CODEX_THREAD_ID` 或明确的会话上下文获取真实会话 ID。
|
|
14
|
+
- Antigravity 从会话元数据获取 Conversation ID。
|
|
15
|
+
- Claude 从宿主提供的会话元数据获取真实 CLI 会话 ID,服务会依据本机元数据映射到对应的 Desktop 会话记录。界面的 `/things` 命令可打开当前会话卡片。
|
|
16
|
+
- 用户指定其他会话时使用指定 ID。身份缺失时先定位宿主会话,仍无法确定时向用户确认目标。
|
|
17
|
+
- 工程路径使用当前会话对应的工作区路径。
|
|
18
|
+
|
|
19
|
+
## 获取进度
|
|
20
|
+
|
|
21
|
+
用户说“获取该会话的任务进度”等明确请求时,授权范围包含查询、首次整理、保存和回读确认。
|
|
22
|
+
|
|
23
|
+
1. 调用 `get_session_progress`,传入真实 `conversation_id`。
|
|
24
|
+
2. 有记录时,报告已保存的任务数、完成数、比例、剩余任务及更新时间。用户要求更新时,结合原账本和后续对话提交变化。
|
|
25
|
+
3. 暂无记录或返回 `cleared: true` 时,读取目标会话中可访问的用户要求与模型最终答复,整理完整目标中的已完成及剩余里程碑,通过 `update_session_tasks` 首次创建。
|
|
26
|
+
4. 写入后再次调用 `get_session_progress`,确认任务、百分比和版本,再向用户报告结果。
|
|
27
|
+
|
|
28
|
+
已有上下文能提供的任务信息优先复用。需要读取较长历史时,使用宿主的会话读取能力按需分页,保留真实用户要求、变更、取消、确认以及最终答复。工具原始输出、思考过程和后台机器事件在本地清洗时过滤。
|
|
29
|
+
|
|
30
|
+
委派执行遵循用户和宿主的授权约束。允许委派时优先使用可用的经济型模型,传递目标会话 ID、已有账本与覆盖边界,由执行者完成读取、写入和回读,并返回简短结论。
|
|
31
|
+
|
|
32
|
+
可访问历史不足时明确说明覆盖范围;历史报告的完成项注明依据。任务摘要保存已确认的范围和状态。Git 提交、推送及当前实机验收分别依据对应证据判断。
|
|
33
|
+
|
|
34
|
+
## MCP 调用契约
|
|
35
|
+
|
|
36
|
+
| 工具 | 用途 |
|
|
37
|
+
| --- | --- |
|
|
38
|
+
| `get_session_progress` | 按会话 ID 精确读取当前记录和任务账本 |
|
|
39
|
+
| `update_session_tasks` | 首次创建任务清单或提交任务增量,由程序计算任务完成比例 |
|
|
40
|
+
| `update_session_progress` | 保存用户明确指定的人工百分比与备注 |
|
|
41
|
+
| `clear_session_progress` | 清除指定会话的进度、全部已完成及剩余任务、备注与进展记录 |
|
|
42
|
+
| `list_all_session_statuses` | 查询工程、最近25条或全局会话记录 |
|
|
43
|
+
|
|
44
|
+
工程查询依赖记录中的工程归属。判断某个会话是否已有记录时,以 `get_session_progress` 的精确查询结果为准。
|
|
45
|
+
|
|
46
|
+
精确查询返回暂无记录时,按首次整理流程创建当前会话的清单。工程列表中的其他会话保留各自身份,不能用作当前会话的任务记录。
|
|
47
|
+
|
|
48
|
+
`update_session_tasks` 的参数规则如下。
|
|
49
|
+
|
|
50
|
+
- 首次创建使用 `expected_revision: 0`。已有记录或返回 `cleared: true` 时使用刚刚读到的 `revision`。
|
|
51
|
+
- 新任务使用 `knownTaskId: null`;已有任务使用其 `id` 作为 `knownTaskId`。
|
|
52
|
+
- `title` 保存完整任务名称。
|
|
53
|
+
- 每项任务的 `summary` 概括动作和对象,最多20个字符,中文、英文、数字和标点均计数。详细证据使用完整标题、来源及会话内容承载。
|
|
54
|
+
- 顶层 `summary` 表达当前目标和剩余事项,与任务短总结分别填写。
|
|
55
|
+
- `status` 使用 `todo`、`in_progress`、`blocked`、`needs_verification` 或 `done`。
|
|
56
|
+
- `tasks` 提交新增和发生变化的任务,服务继承其余任务,包括已完成项。
|
|
57
|
+
- `removedTaskIds` 记录明确取消、替代或移出目标的任务,首次创建通常为 `[]`。
|
|
58
|
+
- 每项任务附 `source`,其中 `locator` 使用原始用户提问或最终答复中10至240个字符的连续原文;可附 `turnId` 和 `itemId` 消除重复引用。服务核对原文后关联消息位置,面板显示“查看来源”。已有短事件引用可通过 `evidenceRefs` 复用。
|
|
59
|
+
- 项目已知时传入 `project_path`。
|
|
60
|
+
|
|
61
|
+
版本冲突时重新读取最新账本,再核对变化。摘要超长时依据错误中的任务位置缩短该项,再重试。出现读取或服务错误时报告具体故障,保留上一次成功结果作为历史记录。
|
|
62
|
+
|
|
63
|
+
首次创建示例。
|
|
64
|
+
|
|
65
|
+
```json
|
|
66
|
+
{
|
|
67
|
+
"conversation_id": "<当前会话 ID>",
|
|
68
|
+
"expected_revision": 0,
|
|
69
|
+
"summary": "功能实现完成,剩余用户验收",
|
|
70
|
+
"tasks": [
|
|
71
|
+
{"knownTaskId": null, "title": "实现会话任务状态功能", "summary": "实现任务状态功能", "status": "done"},
|
|
72
|
+
{"knownTaskId": null, "title": "完成用户视觉与交互验收", "summary": "验收视觉与交互", "status": "todo"}
|
|
73
|
+
],
|
|
74
|
+
"removedTaskIds": []
|
|
75
|
+
}
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
## 清除进度与任务
|
|
79
|
+
|
|
80
|
+
用户明确要求“清除进度”“清空该会话任务记录”时执行清除流程。目标使用当前或用户指定的真实会话 ID。
|
|
81
|
+
|
|
82
|
+
1. 调用 `get_session_progress` 获取目标记录与最新 `revision`;暂无记录或返回 `cleared: true` 时直接说明当前没有进度记录。
|
|
83
|
+
2. 调用 `clear_session_progress`,参数为 `conversation_id` 和刚读取的 `expected_revision`。该操作立即清除进度、全部已完成和剩余任务、备注、任务来源及进展记录。
|
|
84
|
+
3. 检查返回 `cleared: true`、`tasks: []`、`progress: null`,再通过 `get_session_progress` 确认返回 `cleared: true` 且任务为空,简短报告已清除。后续重新建立记录使用清除返回的 `revision` 作为 `expected_revision`。
|
|
85
|
+
|
|
86
|
+
```json
|
|
87
|
+
{
|
|
88
|
+
"conversation_id": "<目标会话 ID>",
|
|
89
|
+
"expected_revision": 158
|
|
90
|
+
}
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
版本冲突时重新读取并核对目标后再提交。工具尚未出现在可用列表时,提示重新连接 Agent Things(`session_status`)MCP 后重试。清除流程完成后保持空记录,后续按用户请求重新整理任务。
|
|
94
|
+
|
|
95
|
+
## 结果播报
|
|
96
|
+
|
|
97
|
+
写入和回读成功后,简短报告“已更新为 X%,完成 A/B 项,剩余 C 项”,列出关键遗留任务。按需注明历史覆盖范围及核验依据。
|
|
98
|
+
|
|
99
|
+
归档判断同时考虑剩余任务、交付状态和用户要求。重大里程碑出现时,将已确认的任务变化提交到现有清单,并告知最新结果。
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: things
|
|
3
|
+
description: Open the Agent Things session progress card in Codex, or query, create, update, or clear the session Progress Checklist when the user selects $things or types /things.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Agent Things (`/things`)
|
|
7
|
+
|
|
8
|
+
When the user selects `$things`, types `/things`, or asks to open the card, call `open_session_card` on the Agent Things `session_status` MCP. Pass the real current session ID from host context (or read `CODEX_THREAD_ID` via shell if unavailable) as `conversation_id`, and include `title` when known. If the tool is not yet loaded, search for `Agent Things session progress card mcp__session_status__open_session_card` and invoke it. Once it succeeds, reply concisely: "Opened the session progress card." Opening the card only reads existing records; writes and analysis are triggered by the user inside the card.
|
|
9
|
+
|
|
10
|
+
When the user explicitly asks to query, create, update, or clear the Progress Checklist, or check whether the session is ready to archive, follow the [Agent Things Progress Checklist Guide](checklist.md) using the `session_status` MCP workflow.
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: things
|
|
3
|
+
description: 在 Codex 信息流唤起 Agent Things 会话任务进度卡片,也可查询、建立、更新或清除会话任务进度清单。当用户选择 $things 或输入 /things 时使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Agent Things (`/things`)
|
|
7
|
+
|
|
8
|
+
用户选择 `$things`、输入 `/things` 或要求打开卡片时,调用 Agent Things 的 `session_status` MCP 工具 `open_session_card`。使用宿主提供的当前真实会话 ID,缺失时通过终端读取 `CODEX_THREAD_ID`,作为 `conversation_id`。标题已知时传 `title`。工具尚未加载时,以 `Agent Things session progress card mcp__session_status__open_session_card` 搜索并调用。工具成功后简短回复「已打开会话进度卡片」。打开卡片只读取已有记录,写入和分析由用户在卡片中触发。
|
|
9
|
+
|
|
10
|
+
用户明确要求查询、建立、更新、清除进度清单或检查会话能否归档时,按 [Agent Things 进度清单操作说明](checklist.md) 执行对应的 `session_status` MCP 流程。
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: things
|
|
3
|
+
description: Open and embed the Agent Things session progress card, or get, create, update, or clear the session Progress Checklist when the user invokes /things or asks about task progress.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Agent Things (`/things`)
|
|
7
|
+
|
|
8
|
+
When the user runs `/things` or asks to view the current session card, immediately call the `render_things_card` tool on the Agent Things `session-status` MCP with `conversation_id` set to the current session ID. Once it succeeds, output the returned `user_markdown` verbatim to the user. Opening the card only reads existing records; an empty session displays "No progress recorded yet", and writes/analysis are triggered by the user inside the card. Never run extra shell scripts, file searches, or ad-hoc deductions when opening the card.
|
|
9
|
+
|
|
10
|
+
When the user explicitly asks to query, create, update, or clear the Progress Checklist, or check whether the session is ready to archive, follow the [Agent Things Progress Checklist Guide](checklist.md) using the `session-status` MCP workflow.
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: things
|
|
3
|
+
description: 唤起并内嵌渲染 Agent Things 会话任务进度卡片,也可查询、建立、更新或清除会话任务进度清单。当用户输入 /things 或要求展示任务卡片、获取/更新/清除进度时使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Agent Things (`/things`)
|
|
7
|
+
|
|
8
|
+
用户输入 `/things` 或要求查看当前会话卡片时,直接调用 Agent Things 的 `session-status` MCP 工具 `render_things_card`,参数为 `conversation_id`(当前会话 ID)。工具调用成功后,直接将返回的 `user_markdown` 原样输出给用户。打开卡片只读取已有记录,空会话直接显示「尚未记录进展」,写入和分析由用户在卡片中触发。严禁执行任何额外的终端脚本、文件搜索或推演操作。
|
|
9
|
+
|
|
10
|
+
用户明确要求查询、建立、更新、清除进度清单或检查会话能否归档时,按 [Agent Things 进度清单操作说明](checklist.md) 执行对应的 `session-status` MCP 流程。
|