agent-space-manager 1.0.3 → 1.0.4

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/page/app.js CHANGED
@@ -18,7 +18,7 @@
18
18
  return plugin.files;
19
19
  }
20
20
  const files = [];
21
- files.push({ name: "plugin.json", relPath: "plugin.json", size: 520 });
21
+ files.push({ name: plugin.isApp ? "app.json" : "plugin.json", relPath: plugin.isApp ? "app.json" : "plugin.json", size: 520 });
22
22
 
23
23
  if (Array.isArray(plugin.skills) && plugin.skills.length > 0) {
24
24
  plugin.skills.forEach((s) => {
@@ -41,7 +41,7 @@
41
41
  files.push({ name: a, relPath: `agents/${a}`, size: 1280 });
42
42
  });
43
43
  }
44
- if (files.length === 1 && !plugin.hasMcp && !plugin.hasHooks && (!plugin.skills || plugin.skills.length === 0)) {
44
+ if (files.length === 1 && !plugin.isApp && !plugin.hasMcp && !plugin.hasHooks && (!plugin.skills || plugin.skills.length === 0)) {
45
45
  files.push({ name: "README.md", relPath: "README.md", size: 1024 });
46
46
  }
47
47
  plugin.files = files;
@@ -149,6 +149,23 @@
149
149
  }
150
150
  }
151
151
 
152
+ // 5b. Apps
153
+ if (plugin.isApp || plugin.hasApp || (Array.isArray(plugin.apps) && plugin.apps.length > 0)) {
154
+ const apps = (Array.isArray(plugin.apps) && plugin.apps.length > 0) ? plugin.apps : [plugin.appName || plugin.name || plugin.id];
155
+ for (const appName of apps) {
156
+ const match = files.find((f) => f.name === "app.json" || (f.relPath || "").includes(`apps/${appName}`));
157
+ if (match && match.name === "app.json") seenFiles.add(match.relPath || match.name);
158
+ items.push({
159
+ badge: "📦 App",
160
+ type: "app",
161
+ name: appName,
162
+ sub: "App Runtime / Binary",
163
+ relPath: plugin.isApp ? `app/${appName}/app.json` : (match ? (match.relPath || match.name) : `apps/${appName}`),
164
+ sizeStr: match ? formatSize(match.size) : "",
165
+ });
166
+ }
167
+ }
168
+
152
169
  // 6. Manifest & Documentation & Other Files
153
170
  for (const f of files) {
154
171
  const key = f.relPath || f.name;
@@ -162,6 +179,14 @@
162
179
  badge = "⚙️ Manifest";
163
180
  type = "manifest";
164
181
  sub = "Plugin Metadata";
182
+ } else if (f.name === "app.json") {
183
+ badge = "⚙️ Manifest";
184
+ type = "manifest";
185
+ sub = "App Metadata";
186
+ } else if (f.isDir || (f.name && f.name.endsWith("/"))) {
187
+ badge = "📁 Dir";
188
+ type = "dir";
189
+ sub = "Runtime Folder";
165
190
  } else if (f.name.toLowerCase().startsWith("readme")) {
166
191
  badge = "📝 Docs";
167
192
  type = "docs";
@@ -1399,6 +1424,7 @@
1399
1424
  if ($("cpRulesInput")) $("cpRulesInput").value = current.rules || defaults.rules || "";
1400
1425
  if ($("cpAgentsInput")) $("cpAgentsInput").value = current.agents || defaults.agents || "";
1401
1426
  if ($("cpHooksInput")) $("cpHooksInput").value = current.hooks || defaults.hooks || "";
1427
+ if ($("cpAppsInput")) $("cpAppsInput").value = current.apps || defaults.apps || "";
1402
1428
  }
1403
1429
 
1404
1430
  function collectComponentPathsFromInputs() {
@@ -1410,6 +1436,7 @@
1410
1436
  const r = $("cpRulesInput")?.value?.trim();
1411
1437
  const a = $("cpAgentsInput")?.value?.trim();
1412
1438
  const h = $("cpHooksInput")?.value?.trim();
1439
+ const ap = $("cpAppsInput")?.value?.trim();
1413
1440
  if (b) res.bundle = b;
1414
1441
  if (s) res.skills = s;
1415
1442
  if (c) res.commands = c;
@@ -1417,6 +1444,7 @@
1417
1444
  if (r) res.rules = r;
1418
1445
  if (a) res.agents = a;
1419
1446
  if (h) res.hooks = h;
1447
+ if (ap) res.apps = ap;
1420
1448
  return res;
1421
1449
  }
1422
1450
 
@@ -1431,6 +1459,7 @@
1431
1459
  { key: "rules", label: "Rules" },
1432
1460
  { key: "agents", label: "Subagents" },
1433
1461
  { key: "hooks", label: "Hooks" },
1462
+ { key: "apps", label: "Apps" },
1434
1463
  ];
1435
1464
  chipsEl.innerHTML = caps.map((c) => {
1436
1465
  const ok = prof.capabilities?.[c.key];
@@ -1600,11 +1629,11 @@
1600
1629
  async function reloadPluginsFromHub(forceReloadScript = false) {
1601
1630
  const effective = computeEffectiveHubPath();
1602
1631
  const targetPath = effective.path;
1603
- discoveredCategories = { plugins: [], mcps: [], hooks: [], skills: [], agents: [], rules: [] };
1632
+ discoveredCategories = { plugins: [], mcps: [], hooks: [], skills: [], agents: [], rules: [], apps: [] };
1604
1633
  const plugins = await apiClient.getPlugins(targetPath, forceReloadScript);
1605
1634
  discoveredPlugins = Array.isArray(plugins) ? plugins : [];
1606
1635
  if (discoveredPlugins.length === 0) {
1607
- discoveredCategories = { plugins: [], mcps: [], hooks: [], skills: [], agents: [], rules: [] };
1636
+ discoveredCategories = { plugins: [], mcps: [], hooks: [], skills: [], agents: [], rules: [], apps: [] };
1608
1637
  } else if (!discoveredCategories.plugins || discoveredCategories.plugins.length === 0) {
1609
1638
  discoveredCategories = buildClientCategoriesRegistry(discoveredPlugins);
1610
1639
  }
@@ -1633,6 +1662,7 @@
1633
1662
  let skills = 0;
1634
1663
  let agents = 0;
1635
1664
  let rules = 0;
1665
+ let apps = 0;
1636
1666
 
1637
1667
  discoveredPlugins.forEach((p) => {
1638
1668
  if (p.hasMcp) mcps += (p.mcps?.length || 1);
@@ -1640,9 +1670,11 @@
1640
1670
  skills += (p.skills || []).length;
1641
1671
  agents += (p.agents || []).length;
1642
1672
  rules += (p.rules || []).length;
1673
+ if (p.isApp) apps += 1;
1674
+ else if (Array.isArray(p.apps)) apps += p.apps.length;
1643
1675
  });
1644
1676
 
1645
- return { plugins, mcps, hooks, skills, agents, rules };
1677
+ return { plugins, mcps, hooks, skills, agents, rules, apps };
1646
1678
  }
1647
1679
 
1648
1680
  function buildClientCategoriesRegistry(plugins = []) {
@@ -1653,12 +1685,14 @@
1653
1685
  skills: [],
1654
1686
  agents: [],
1655
1687
  rules: [],
1688
+ apps: [],
1656
1689
  };
1657
1690
  const seenSkills = new Set();
1658
1691
  const seenMcps = new Set();
1659
1692
  const seenHooks = new Set();
1660
1693
  const seenAgents = new Set();
1661
1694
  const seenRules = new Set();
1695
+ const seenApps = new Set();
1662
1696
 
1663
1697
  for (const p of plugins) {
1664
1698
  ensurePluginFiles(p);
@@ -1668,6 +1702,9 @@
1668
1702
  version: p.version,
1669
1703
  path: p.path,
1670
1704
  description: p.description,
1705
+ isApp: Boolean(p.isApp),
1706
+ hasApp: Boolean(p.hasApp || p.isApp),
1707
+ appsCount: p.isApp ? 1 : (p.apps || []).length,
1671
1708
  skillsCount: (p.skills || []).length,
1672
1709
  filesCount: (p.files || []).length,
1673
1710
  files: p.files,
@@ -1675,6 +1712,36 @@
1675
1712
  hasHooks: p.hasHooks,
1676
1713
  });
1677
1714
 
1715
+ if (p.isApp) {
1716
+ const appKey = p.id || p.name;
1717
+ if (!seenApps.has(appKey)) {
1718
+ seenApps.add(appKey);
1719
+ categories.apps.push({
1720
+ id: p.id,
1721
+ name: p.name,
1722
+ version: p.version,
1723
+ pluginId: p.id,
1724
+ pluginName: p.name,
1725
+ description: p.description,
1726
+ sourcePath: p.path,
1727
+ });
1728
+ }
1729
+ } else {
1730
+ for (const ap of (p.apps || [])) {
1731
+ const appKey = `${p.id}/${ap}`;
1732
+ if (!seenApps.has(appKey)) {
1733
+ seenApps.add(appKey);
1734
+ categories.apps.push({
1735
+ id: appKey,
1736
+ name: ap,
1737
+ pluginId: p.id,
1738
+ pluginName: p.name,
1739
+ sourcePath: `${p.path}\\apps\\${ap}`,
1740
+ });
1741
+ }
1742
+ }
1743
+ }
1744
+
1678
1745
  for (const s of (p.skills || [])) {
1679
1746
  if (!seenSkills.has(s)) {
1680
1747
  seenSkills.add(s);
@@ -1751,7 +1818,8 @@
1751
1818
  const sLen = (cats.skills || []).length;
1752
1819
  const aLen = (cats.agents || []).length;
1753
1820
  const rLen = (cats.rules || []).length;
1754
- const totalCount = (pLen + mLen + hLen + sLen + aLen + rLen);
1821
+ const apLen = (cats.apps || []).length;
1822
+ const totalCount = (pLen + mLen + hLen + sLen + aLen + rLen + apLen);
1755
1823
 
1756
1824
  if ($("cat-cnt-total")) $("cat-cnt-total").textContent = totalCount;
1757
1825
  if ($("cat-cnt-all")) $("cat-cnt-all").textContent = totalCount;
@@ -1761,6 +1829,7 @@
1761
1829
  if ($("cat-cnt-skills")) $("cat-cnt-skills").textContent = sLen;
1762
1830
  if ($("cat-cnt-agents")) $("cat-cnt-agents").textContent = aLen;
1763
1831
  if ($("cat-cnt-rules")) $("cat-cnt-rules").textContent = rLen;
1832
+ if ($("cat-cnt-apps")) $("cat-cnt-apps").textContent = apLen;
1764
1833
 
1765
1834
  const container = $("categoryItemsContainer");
1766
1835
  if (!container) return;
@@ -1773,8 +1842,8 @@
1773
1842
  let items = [];
1774
1843
  if (activeCategoryTab === "all" || activeCategoryTab === "plugins") {
1775
1844
  items.push(...cats.plugins.map(p => ({
1776
- type: "plugin",
1777
- badge: "🧩 Plugin",
1845
+ type: p.isApp ? "app" : "plugin",
1846
+ badge: p.isApp ? "📦 App" : "🧩 Plugin",
1778
1847
  name: p.name,
1779
1848
  sub: p.version ? `v${p.version}` : "",
1780
1849
  path: p.path,
@@ -1831,6 +1900,16 @@
1831
1900
  desc: "System Instruction & Rule Spec",
1832
1901
  })));
1833
1902
  }
1903
+ if (activeCategoryTab === "all" || activeCategoryTab === "apps") {
1904
+ items.push(...(cats.apps || []).map(ap => ({
1905
+ type: "app",
1906
+ badge: "📦 App",
1907
+ name: ap.name,
1908
+ sub: ap.version ? `v${ap.version}` : (ap.pluginName && ap.pluginName !== ap.name ? `from ${ap.pluginName}` : ""),
1909
+ path: ap.sourcePath,
1910
+ desc: ap.description || "Standalone Application Runtime",
1911
+ })));
1912
+ }
1834
1913
 
1835
1914
  if (categorySearchFilter) {
1836
1915
  const q = categorySearchFilter.toLowerCase();
@@ -1923,6 +2002,7 @@
1923
2002
  if ($("cnt-skills")) $("cnt-skills").textContent = String(counts.skills);
1924
2003
  if ($("cnt-agents")) $("cnt-agents").textContent = String(counts.agents);
1925
2004
  if ($("cnt-rules")) $("cnt-rules").textContent = String(counts.rules);
2005
+ if ($("cnt-apps")) $("cnt-apps").textContent = String(counts.apps);
1926
2006
 
1927
2007
  if ($("ideCount")) $("ideCount").textContent = String(hubConfig.ides?.length || 0);
1928
2008
  if ($("projectCount")) $("projectCount").textContent = String(hubConfig.projects?.length || 0);
@@ -2280,14 +2360,17 @@
2280
2360
  const rawHooks = Array.isArray(plugin.hooks) ? plugin.hooks : [];
2281
2361
  const hasHooksInside = Boolean(plugin.hasHooks || rawHooks.length > 0);
2282
2362
 
2283
- const hasAnyFeature = hasSkillsInside || hasAgentsInside || hasMcpInside || hasRulesInside || hasHooksInside || (plugin.filesCount && plugin.filesCount > 0);
2363
+ const rawApps = Array.isArray(plugin.apps) ? plugin.apps : [];
2364
+ const hasAppInside = Boolean(plugin.isApp || plugin.hasApp || rawApps.length > 0);
2365
+
2366
+ const hasAnyFeature = hasSkillsInside || hasAgentsInside || hasMcpInside || hasRulesInside || hasHooksInside || hasAppInside || (plugin.filesCount && plugin.filesCount > 0);
2284
2367
  if (!hasAnyFeature && !plugin.path) {
2285
2368
  return { workable: false, color: "red", status: "failed", features: {}, summary: "Empty component", tooltip: `🔴 Connection failed: No workable components discovered in "${plugin.name || plugin.id}"` };
2286
2369
  }
2287
2370
 
2288
2371
  // Resolve agent profile capabilities
2289
2372
  const agentType = String(ide.agentType || ide.id || "").toLowerCase();
2290
- const profile = agentProfiles.find((p) => p.id === agentType) || { capabilities: { skills: true, mcp: true, rules: true, agents: true, hooks: true } };
2373
+ const profile = agentProfiles.find((p) => p.id === agentType) || { capabilities: { skills: true, mcp: true, rules: true, agents: true, hooks: true, apps: true } };
2291
2374
  const isBundle = profile?.mode === "bundle" || agentType === "antigravity";
2292
2375
  const customPaths = ide.componentPaths || {};
2293
2376
 
@@ -2297,6 +2380,7 @@
2297
2380
  rules: isBundle || customPaths.rules ? true : (profile?.capabilities?.rules ?? true),
2298
2381
  agents: isBundle || customPaths.agents ? true : (profile?.capabilities?.agents ?? true),
2299
2382
  hooks: isBundle || customPaths.hooks ? true : (profile?.capabilities?.hooks ?? true),
2383
+ apps: isBundle || customPaths.apps ? true : (profile?.capabilities?.apps ?? true),
2300
2384
  };
2301
2385
 
2302
2386
  const features = {};
@@ -2415,6 +2499,27 @@
2415
2499
  };
2416
2500
  }
2417
2501
 
2502
+ // 6. Apps Check (only if present inside component)
2503
+ if (hasAppInside) {
2504
+ presentTypeCount++;
2505
+ const appNames = rawApps.length > 0 ? rawApps : [plugin.appName || plugin.name || plugin.id];
2506
+ const isSupported = capabilities.apps === true;
2507
+ if (isSupported) {
2508
+ workableCount++;
2509
+ actionParts.push(`App: ${appNames.join(", ")}`);
2510
+ detailedTooltipLines.push(`✓ App (${appNames.length}): ${appNames.join(", ")} active`);
2511
+ } else {
2512
+ detailedTooltipLines.push(`✗ App (${appNames.length}): Skipped (unsupported by ${ide.name || ide.id})`);
2513
+ }
2514
+ features.apps = {
2515
+ present: true,
2516
+ count: appNames.length,
2517
+ workable: isSupported,
2518
+ items: appNames,
2519
+ reason: isSupported ? "Active" : `Unsupported by ${ide.name || ide.id}`,
2520
+ };
2521
+ }
2522
+
2418
2523
  // If component has types present but NONE of them are supported by this agent
2419
2524
  if (presentTypeCount > 0 && workableCount === 0) {
2420
2525
  return {
@@ -2422,7 +2527,7 @@
2422
2527
  color: "red",
2423
2528
  status: "unsupported",
2424
2529
  features,
2425
- quickActions: { slashCommands, mentions, hasSlash: false, hasMention: false, hasMcp: false, hasRules: false, hasHooks: false },
2530
+ quickActions: { slashCommands, mentions, hasSlash: false, hasMention: false, hasMcp: false, hasRules: false, hasHooks: false, hasApp: false },
2426
2531
  summary: `Incompatible with ${ide.name || ide.id}`,
2427
2532
  tooltip: `🔴 Incompatible with ${ide.name || ide.id}: All component types in "${plugin.name || plugin.id}" are unsupported.`,
2428
2533
  reason: `All component types in "${plugin.name || plugin.id}" are unsupported by ${ide.name || ide.id}`,
@@ -2434,6 +2539,7 @@
2434
2539
  const hasMcp = hasMcpInside && capabilities.mcp === true;
2435
2540
  const hasRules = hasRulesInside && capabilities.rules === true;
2436
2541
  const hasHooks = hasHooksInside && capabilities.hooks === true;
2542
+ const hasApp = hasAppInside && capabilities.apps === true;
2437
2543
 
2438
2544
  const summary = `Workable in ${ide.name || ide.id}${actionParts.length > 0 ? " · " + actionParts.join(" · ") : ""}`;
2439
2545
  const baseTooltip = `🟢 Workable in ${ide.name || ide.id}: Connected & ready.${actionParts.length > 0 ? " Can be used with " + actionParts.join(" | ") : ""}`;
@@ -2452,6 +2558,7 @@
2452
2558
  hasMcp,
2453
2559
  hasRules,
2454
2560
  hasHooks,
2561
+ hasApp,
2455
2562
  },
2456
2563
  summary,
2457
2564
  tooltip,
@@ -2484,7 +2591,10 @@
2484
2591
  const rawHooks = Array.isArray(plugin.hooks) ? plugin.hooks : [];
2485
2592
  const hasHooksInside = Boolean(plugin.hasHooks || rawHooks.length > 0);
2486
2593
 
2487
- const hasAnyFeature = hasSkillsInside || hasAgentsInside || hasMcpInside || hasRulesInside || hasHooksInside || (plugin.filesCount && plugin.filesCount > 0);
2594
+ const rawApps = Array.isArray(plugin.apps) ? plugin.apps : [];
2595
+ const hasAppInside = Boolean(plugin.isApp || plugin.hasApp || rawApps.length > 0);
2596
+
2597
+ const hasAnyFeature = hasSkillsInside || hasAgentsInside || hasMcpInside || hasRulesInside || hasHooksInside || hasAppInside || (plugin.filesCount && plugin.filesCount > 0);
2488
2598
  if (!hasAnyFeature && !plugin.path) {
2489
2599
  return { workable: false, color: "red", status: "failed", features: {}, summary: "Empty component", tooltip: `🔴 Connection failed: No workable components discovered in "${plugin.name || plugin.id}"` };
2490
2600
  }
@@ -2556,6 +2666,14 @@
2556
2666
  features.hooks = { present: true, count: hookCount, workable: isSupported, items: rawHooks, reason: isSupported ? "Active" : "Unsupported" };
2557
2667
  }
2558
2668
 
2669
+ // 6. Apps
2670
+ if (hasAppInside) {
2671
+ const appNames = rawApps.length > 0 ? rawApps : [plugin.appName || plugin.name || plugin.id];
2672
+ actionParts.push(`App: ${appNames.join(", ")}`);
2673
+ detailedTooltipLines.push(`✓ App (${appNames.length}): ${appNames.join(", ")} active`);
2674
+ features.apps = { present: true, count: appNames.length, workable: true, items: appNames, reason: "Active" };
2675
+ }
2676
+
2559
2677
  const summary = `Workable in ${project.name}${actionParts.length > 0 ? " · " + actionParts.join(" · ") : ""}`;
2560
2678
  const baseTooltip = `🟢 Workable in Project "${project.name}": Repository linked & protected (.git/info/exclude).${actionParts.length > 0 ? " Can be used with " + actionParts.join(" | ") : ""}`;
2561
2679
  const tooltip = detailedTooltipLines.length > 0 ? `${baseTooltip}\n${detailedTooltipLines.join("\n")}` : baseTooltip;
@@ -2638,6 +2756,9 @@
2638
2756
  const row = document.createElement("tr");
2639
2757
 
2640
2758
  let badges = "";
2759
+ if (plugin.isApp || plugin.hasApp || (plugin.apps && plugin.apps.length > 0)) {
2760
+ badges += `<span class="badge badge-app">App</span>`;
2761
+ }
2641
2762
  if (plugin.hasMcp) badges += `<span class="badge badge-mcp">MCP</span>`;
2642
2763
  if (plugin.skills?.length > 0) badges += `<span class="badge badge-skills">${plugin.skills.length} Skills</span>`;
2643
2764
  if (plugin.rules?.length > 0) badges += `<span class="badge badge-rules">Rules</span>`;
@@ -2667,6 +2788,9 @@
2667
2788
  } else if (it.type === "hook") {
2668
2789
  badgeBg = "rgba(234,88,12,0.15)";
2669
2790
  badgeColor = "#ea580c";
2791
+ } else if (it.type === "app") {
2792
+ badgeBg = "rgba(139,92,246,0.15)";
2793
+ badgeColor = "#7c3aed";
2670
2794
  } else if (it.type === "manifest") {
2671
2795
  badgeBg = "rgba(16,185,129,0.12)";
2672
2796
  badgeColor = "#059669";
@@ -2702,6 +2826,11 @@
2702
2826
  workabilityBadge = isW
2703
2827
  ? `<span style="font-size:9.5px; color:#10b981; font-weight:600;" title="Lifecycle hook active">✓ Workable</span>`
2704
2828
  : `<span style="font-size:9.5px; color:#f59e0b; font-weight:600;" title="Agent does not support lifecycle hooks">⚠️ Unsupported</span>`;
2829
+ } else if (it.type === "app") {
2830
+ const isW = workability.features?.apps?.workable ?? true;
2831
+ workabilityBadge = isW
2832
+ ? `<span style="font-size:9.5px; color:#10b981; font-weight:600;" title="App runtime linked and active">✓ Workable</span>`
2833
+ : `<span style="font-size:9.5px; color:#f59e0b; font-weight:600;" title="Agent does not support apps">⚠️ Unsupported</span>`;
2705
2834
  }
2706
2835
  }
2707
2836
 
@@ -3249,7 +3378,7 @@
3249
3378
  }
3250
3379
 
3251
3380
  // Standardize Storage Structure Prompt Copy Button (with version display)
3252
- const STORAGE_PROMPT_VERSION = "V1.6";
3381
+ const STORAGE_PROMPT_VERSION = "V1.7";
3253
3382
  const btnCopyPrompt = $("btnCopyStoragePrompt");
3254
3383
  if (btnCopyPrompt) {
3255
3384
  const originalText = `Copy Prompt (${STORAGE_PROMPT_VERSION})`;
@@ -3261,10 +3390,10 @@
3261
3390
 
3262
3391
  const promptText = `[Components Storage Specification & Upstream Rules Prompt ${STORAGE_PROMPT_VERSION}]
3263
3392
 
3264
- Please organize and force our Components Storage file structure to strictly adhere to the standard plugin specification, record mandatory upstream source links, eliminate decentralized component updaters, ensure complete plugin uninstallation cleanup, enforce UTF-8 without BOM encoding, respect one-time rearrangement stability, define universal shared folder specifications, maintain dynamic Smart Middleware intent rules, and install a persistent agent rule:
3393
+ Please organize and force our Components Storage file structure to strictly adhere to the standard plugin and app specification, record mandatory upstream source links, eliminate decentralized component updaters, ensure complete plugin/app uninstallation cleanup, enforce UTF-8 without BOM encoding, respect one-time rearrangement stability, define universal shared and app folder specifications, maintain dynamic Smart Middleware intent rules, and install a persistent agent rule:
3265
3394
 
3266
3395
  ${targetPathHeader}1. Directory Structure Specification:
3267
- Components Storage root (e.g. \`<Components Storage Path>\`) contains plugins, optional standalone skills, hub configuration, and a shared cross-agent communication/data directory:
3396
+ Components Storage root (e.g. \`<Components Storage Path>\`) contains plugins, standalone apps, optional standalone skills, hub configuration, and a shared cross-agent communication/data directory:
3268
3397
 
3269
3398
  <Components Storage Path>/
3270
3399
  ├── plugins/ # Standard plugin directory
@@ -3279,51 +3408,78 @@ Components Storage root (e.g. \`<Components Storage Path>\`) contains plugins, o
3279
3408
  │ │ └── <upstream GitHub name/self (if self created)-agent-name>.md # Must include upstream in frontmatter
3280
3409
  │ └── rules/ # Optional rules directory
3281
3410
  │ └── <upstream GitHub name/self (if self created)-rule-name>.md # Must include upstream in frontmatter
3411
+ ├── app/ # Standalone application runtimes, browser binaries & desktop/CLI tools
3412
+ │ └── <app-name>/
3413
+ │ ├── app.json # Required app manifest ("id", "name", "version", "description", "upstream", optional "env"/"executable")
3414
+ │ └── <runtime-files>/ # Self-contained app binaries, browser builds (e.g. ms-playwright), or runtime assets
3282
3415
  ├── shared/ # Cross-agent IPC, discovery registry, handoff, and shared tools directory
3283
3416
  │ ├── agent-connectors.json # Cross-agent messaging and discovery registry (active IDE agents & capabilities)
3284
3417
  │ ├── handoff/ # Cross-agent delegation and task handoff inboxes
3285
3418
  │ │ └── <agent-id>/ # Target agent inbox queue
3286
3419
  │ ├── _upstream_backups/ # Pre-update backups and component snapshots
3287
3420
  │ ├── middleware-intents.json # Dynamic user & agent Smart Middleware intent keyword registry
3288
- │ └── <shared-tool-dirs>/ # Shared runtime states, engines, caches, or browser automation; subfolders are named after their joining skills (e.g. stagehand-fastcrw joining stagehand and fastcrw, omniroute)
3421
+ │ └── <shared-tool-dirs>/ # Shared runtime states, engines, caches; subfolders are named after their joining skills (e.g. stagehand-fastcrw joining stagehand and fastcrw, omniroute)
3289
3422
  ├── skills/ # Standalone or migrated skills
3290
3423
  ├── hub-config.json # Hub configuration
3291
3424
  ├── plugins.json # Discovered/registered plugins index
3425
+ ├── apps.json # Discovered/registered apps index
3292
3426
  └── skills.json # Discovered/registered skills index
3293
3427
 
3294
3428
  Duplicate Naming, Skill Collision Avoidance & No Duplicate Standalone Rule:
3295
3429
  - Skill Name Collisions Across Plugins: To avoid skill name collision across plugins, if a skill with the same name exists in two or more different plugins (e.g. a skill called "plan" in 2 different plugins called A and B), name the skill in each plugin by prefixing it with its plugin name (e.g. name the skill "plan" in A as "A-plan", and in B as "B-plan") so each skill has a distinct identifier without namespace collisions.
3296
- - Other Component Duplicate Collisions: If two or more other components (plugins, agents, rules, MCPs, or standalone skills) coincidentally have the same name, append \`-1\`, \`-2\`, etc. sequentially (e.g. \`<name>-1\`, \`<name>-2\`) so every component has a unique name without colliding or overwriting.
3430
+ - Other Component Duplicate Collisions: If two or more other components (plugins, apps, agents, rules, MCPs, or standalone skills) coincidentally have the same name, append \`-1\`, \`-2\`, etc. sequentially (e.g. \`<name>-1\`, \`<name>-2\`) so every component has a unique name without colliding or overwriting.
3297
3431
  - No Duplicate Standalone Copies: NEVER leave or create a standalone copy in \`<Components Storage Path>/skills/\`, \`rules/\`, \`agents/\`, or directly inside IDE native directories (e.g. \`~/.gemini/config/skills/\`, \`~/.gemini/config/rules/\`, \`~/.cursor/rules/\`, \`~/.claude/\`) when that component belongs to a plugin in \`plugins/<plugin-name>/\`. Whenever installing or migrating a plugin, check for existing standalone or unprefixed copies matching the same \`upstream\` URL or base name (e.g. \`trail-code-auto.md\` vs \`trailhq-trail-code-auto.md\`) and move or remove the standalone copy so only the plugin-scoped copy remains.
3298
3432
 
3299
- 2. Shared Folder Specification (<Components Storage Path>/shared):
3433
+ 2. Shared Folder & App Component Specifications (<Components Storage Path>/shared & <Components Storage Path>/app):
3434
+ A. Shared Folder (<Components Storage Path>/shared):
3300
3435
  The shared directory serves as the centralized cross-agent IPC, discovery, and shared coordination layer across all supported AI coding agents (Antigravity, Cursor, Windsurf, Claude Code, OpenCode, VS Code Copilot, etc.):
3301
3436
  - agent-connectors.json: Global discovery registry tracking connected agent profiles, capability flags, root config paths, and communication bridges.
3302
3437
  - handoff/: Inter-agent handoff queues. Enables asynchronous task delegation and context packet transfers between agents across different IDEs.
3303
3438
  - _upstream_backups/: Centralized safety backups created prior to weekly upstream component updates or synchronization runs.
3304
3439
  - middleware-intents.json: Dynamic intent keyword registry for Smart Middleware. Maps tool patterns (e.g. docker, database, git) to user intent keywords so Smart Middleware dynamically surfaces domain tools without exceeding LLM context limits.
3305
- - Shared Tooling & State Subfolder Naming: Shared runtime caches, browser automation tools, and routing engines accessible universally across all connected agents without redundant duplication. Any subfolder created in shared/ for collaborating skills MUST be named after the joining skills (e.g. \`stagehand-fastcrw\` representing the joint operation of \`stagehand\` and \`fastcrw\`).
3440
+ - Shared Tooling & State Subfolder Naming: Shared runtime caches and routing engines accessible universally across all connected agents without redundant duplication. Any subfolder created in shared/ for collaborating skills MUST be named after the joining skills (e.g. \`stagehand-fastcrw\` representing the joint operation of \`stagehand\` and \`fastcrw\`).
3306
3441
  - Invariant: Never treat the shared/ directory or its internal files as loose components, and never delete or clear user-managed handoffs or shared configs during plugin cleanup.
3307
3442
 
3443
+ B. App Component Folder (<Components Storage Path>/app):
3444
+ The app directory stores standalone, toggleable application runtimes, browser engines, and external binaries (e.g. \`ms-playwright\`):
3445
+ - Directory Layout: Each app resides in \`<Components Storage Path>/app/<app-name>/\` and MUST contain an \`app.json\` manifest at its root (strict UTF-8 No BOM), alongside its runtime/binary files (such as \`chromium-1243/\`, \`ffmpeg-1011/\`, etc.). Never place standalone binary runtimes like \`ms-playwright\` inside \`shared/\`.
3446
+ - Required \`app.json\` Content:
3447
+ \`\`\`json
3448
+ {
3449
+ "id": "<app-name>",
3450
+ "name": "<app-name>",
3451
+ "version": "1.0.0",
3452
+ "description": "Concise description of the standalone application runtime",
3453
+ "upstream": "https://github.com/<owner>/<repo>",
3454
+ "env": {
3455
+ "OPTIONAL_ENV_VAR": "."
3456
+ },
3457
+ "executable": "optional/relative/path/to/binary"
3458
+ }
3459
+ \`\`\`
3460
+ - IDE Bridging & Toggling: Agent Space Manager discovers each subfolder in \`app/\` as an \`App\` component (tagged \`App\` in Components & Plugins) that can be toggled ON/OFF per connected IDE or project, linking via directory junction into \`<agent-config>/apps/<app-name>\` (e.g. \`~/.gemini/config/apps/ms-playwright\`). For tools relying on environment variables (such as \`PLAYWRIGHT_BROWSERS_PATH\` for \`ms-playwright\`), ensure the user environment variable points to \`<Components Storage Path>/app/<app-name>\`.
3461
+
3308
3462
  3. Mandatory Upstream Links:
3309
- For EVERY component (plugin, skill, rule, agent, MCP) installed in Components Storage Path:
3463
+ For EVERY component (plugin, app, skill, rule, agent, MCP) installed in Components Storage Path:
3310
3464
  - Identify and record the upstream source link (GitHub repository URL, official documentation URL, or author registry link) where the component was saved or fetched from:
3311
3465
  * In plugin.json: Include "upstream": "https://github.com/<owner>/<repo>" (or source repository URL).
3466
+ * In app.json: Include "upstream": "https://github.com/<owner>/<repo>" (or source repository URL).
3312
3467
  * In SKILL.md: Include upstream: "https://github.com/<owner>/<repo>" in the YAML frontmatter.
3313
3468
  * In rules (*.md): Include upstream: "https://github.com/<owner>/<repo>" in the YAML frontmatter.
3314
3469
  * In agents (*.md): Include upstream: "https://github.com/<owner>/<repo>" in the YAML frontmatter.
3315
3470
 
3316
- 4. Complete Plugin Removal & Cleanup:
3317
- When the user asks to remove, delete, or uninstall a plugin:
3318
- - Remove the plugin directory itself (plugins/<plugin-name>/).
3319
- - Concurrently remove ALL components related to that plugin across Components Storage and connected agent configs:
3471
+ 4. Complete Plugin & App Removal & Cleanup:
3472
+ When the user asks to remove, delete, or uninstall a plugin or app:
3473
+ - Remove the plugin directory (\`plugins/<plugin-name>/\`) or app directory (\`app/<app-name>/\`).
3474
+ - Concurrently remove ALL components related to that plugin or app across Components Storage and connected agent configs:
3320
3475
  * Associated skills in the plugin's skills/ directory and any bridged skill links.
3321
3476
  * Associated subagents in agents/ and any bridged agent definitions.
3322
3477
  * Associated rules in rules/ and any bridged rule files or managed rule sections.
3323
3478
  * Associated MCP server definitions in mcp_config.json and their bridged entries.
3324
3479
  * Associated hooks in hooks.json and their bridged hook entries.
3480
+ * Associated bridged app junctions in \`<agent-config>/apps/<app-name>\`.
3325
3481
  * Associated Smart Middleware intent entries in <Components Storage Path>/shared/middleware-intents.json: trim and remove the plugin's registered intent keywords and tool patterns so no dead or stale intent entries remain for uninstalled tools.
3326
- - Ensure no orphaned components, dangling junctions/symlinks, ghost configuration entries, or leftover intent keywords associated with the removed plugin remain.
3482
+ - Ensure no orphaned components, dangling junctions/symlinks, ghost configuration entries, or leftover intent keywords associated with the removed plugin or app remain.
3327
3483
 
3328
3484
  5. Centralized Weekly Update Checking (No Decentralized Scripts):
3329
3485
  - Remove and DO NOT create individual, local, or decentralized update scripts (such as update_checker.mjs or update_check_state.json) inside component folders.
@@ -3331,8 +3487,8 @@ When the user asks to remove, delete, or uninstall a plugin:
3331
3487
  - Prune any obsolete local component update checking scripts or decentralized state files.
3332
3488
 
3333
3489
  6. Mandatory File Encoding (Strict UTF-8 Without BOM):
3334
- - ALL manifest and configuration files (plugin.json, mcp_config.json, hooks.json, SKILL.md, and *.md) MUST be written strictly in standard UTF-8 without Byte Order Mark (UTF-8 No BOM).
3335
- - NEVER output or save files with a UTF-8 BOM (\\uFEFF or byte sequence 0xEF, 0xBB, 0xBF). A BOM header corrupts JSON parsing across IDEs and tools, leading to "Invalid plugin.json" errors.
3490
+ - ALL manifest and configuration files (plugin.json, app.json, mcp_config.json, hooks.json, SKILL.md, and *.md) MUST be written strictly in standard UTF-8 without Byte Order Mark (UTF-8 No BOM).
3491
+ - NEVER output or save files with a UTF-8 BOM (\\uFEFF or byte sequence 0xEF, 0xBB, 0xBF). A BOM header corrupts JSON parsing across IDEs and tools, leading to "Invalid plugin.json" or "Invalid app.json" errors.
3336
3492
  - If executing file writes via Windows PowerShell (5.1), avoid standard Out-File or Set-Content defaults; always write without BOM using Node.js fs.writeFileSync(path, content, "utf8"), PowerShell 7 -Encoding utf8NoBOM, or [System.IO.File]::WriteAllText($path, $content, (New-Object System.Text.UTF8Encoding($false))).
3337
3493
 
3338
3494
  7. One-Time Rearrangement Stability:
@@ -3348,16 +3504,16 @@ When the user asks to remove, delete, or uninstall a plugin:
3348
3504
  9. Mandatory Persistent Agent Rule:
3349
3505
  Install and persist a dedicated rule in your agent's rule system (e.g. .agents/rules/components-storage-upstream-rule.md or .cursor/rules/components-storage-upstream-rule.mdc) that is ALWAYS TRIGGERED whenever an addendum, creation, modification, edit, or removal of any component in the Components Storage Path (${storagePath || "Components Storage Path"}):
3350
3506
  - Rule Trigger: Addendum, creation, edit, or removal of any component in Components Storage Path.
3351
- - Rule Invariant 1: Ensure strict compliance with the plugin directory and shared/ directory structures above; avoid skill name collisions across plugins by prefixing the skill with its plugin name (e.g. a skill called 'plan' in plugins A and B is named 'A-plan' and 'B-plan'), disambiguate any other coincidental duplicate component names by appending -1, -2, etc. sequentially, and never leave duplicate standalone copies in root skills/rules/agents or IDE native config directories when the component belongs to a plugin (remove or migrate any pre-existing standalone/unprefixed copy matching the same upstream URL or base name).
3352
- - Rule Invariant 2: Always add and preserve the upstream link in the component's manifest or frontmatter.
3353
- - Rule Invariant 3: Complete removal cleanup — when removing a plugin, all components related to that plugin (skills, agents, rules, MCP servers, hooks) AND its entries in shared/middleware-intents.json must be cleanly removed and trimmed with no orphaned leftovers.
3507
+ - Rule Invariant 1: Ensure strict compliance with the plugin, app/, and shared/ directory structures above; place standalone application runtimes and browser binaries (e.g. ms-playwright) in app/<app-name>/ with a valid app.json manifest (never in shared/); avoid skill name collisions across plugins by prefixing the skill with its plugin name (e.g. a skill called 'plan' in plugins A and B is named 'A-plan' and 'B-plan'), disambiguate any other coincidental duplicate component names by appending -1, -2, etc. sequentially, and never leave duplicate standalone copies in root skills/rules/agents or IDE native config directories when the component belongs to a plugin (remove or migrate any pre-existing standalone/unprefixed copy matching the same upstream URL or base name).
3508
+ - Rule Invariant 2: Always add and preserve the upstream link in the component's manifest (plugin.json, app.json) or frontmatter.
3509
+ - Rule Invariant 3: Complete removal cleanup — when removing a plugin or app, all components related to it (skills, agents, rules, MCP servers, hooks, bridged app junctions) AND its entries in shared/middleware-intents.json must be cleanly removed and trimmed with no orphaned leftovers.
3354
3510
  - Rule Invariant 4: Never introduce decentralized or component-level update scripts; all update checking is handled centrally by the Agent Space Manager plugin on Monday startup.
3355
- - Rule Invariant 5: Never write files with a UTF-8 BOM header; always enforce UTF-8 No BOM encoding.
3511
+ - Rule Invariant 5: Never write files with a UTF-8 BOM header; always enforce UTF-8 No BOM encoding across plugin.json, app.json, mcp_config.json, hooks.json, and markdown files.
3356
3512
  - Rule Invariant 6: One-Time Rearrangement Stability — if file rearrangement was already performed once, never rearrange or move existing structure again on subsequent prompt runs unless explicitly requested by the user.
3357
3513
  - Rule Invariant 7: Universal Shared Directory Preservation & Naming — preserve <Components Storage Path>/shared (agent-connectors.json, handoff/, _upstream_backups/, middleware-intents.json) as the designated cross-agent communication and data hub; never treat it as an orphaned or removable plugin; any subfolders in shared/ must be named after their joining skills (e.g. stagehand-fastcrw joining stagehand and fastcrw).
3358
3514
  - Rule Invariant 8: Dynamic Smart Middleware Intent Lifecycle & Seeding — (a) on initial run, seed shared/middleware-intents.json based on all currently existing plugins and tools in Components Storage; (b) when adding new components with tools, register their intent keywords and tool patterns in shared/middleware-intents.json; (c) when removing components, trim and prune their intent entries from shared/middleware-intents.json so the personal layer remains trimmed and accurate.
3359
3515
 
3360
- Please inspect ${storagePath || "Components Storage Path"}, clean up non-conforming or loose files, ensure all component manifests and frontmatters contain their upstream links, ensure all JSON files are valid UTF-8 without BOM, purge any decentralized update checking scripts, ensure removal rules cover all related components and trim middleware intents, resolve skill name collisions across plugins by prefixing plugin names (e.g. A-plan, B-plan), preserve the shared/ cross-agent folder, seed or update tool intent keywords in shared/middleware-intents.json based on existing installed components, respect one-time rearrangement stability if already arranged, and persist the rule into your agent's rules.`;
3516
+ Please inspect ${storagePath || "Components Storage Path"}, clean up non-conforming or loose files, ensure all component manifests (including plugin.json and app.json) and frontmatters contain their upstream links, ensure all JSON files are valid UTF-8 without BOM, purge any decentralized update checking scripts, ensure removal rules cover all related components and trim middleware intents, resolve skill name collisions across plugins by prefixing plugin names (e.g. A-plan, B-plan), keep standalone apps in app/<app-name>/ with app.json, preserve the shared/ cross-agent folder, seed or update tool intent keywords in shared/middleware-intents.json based on existing installed components, respect one-time rearrangement stability if already arranged, and persist the rule into your agent's rules.`;
3361
3517
 
3362
3518
  let copied = false;
3363
3519
  if (navigator.clipboard && navigator.clipboard.writeText) {
package/page/index.html CHANGED
@@ -17,7 +17,7 @@
17
17
  <div>
18
18
  <div class="title-row">
19
19
  <h1>Agent Space Manager</h1>
20
- <span class="plugin-version-badge" id="pluginVersionBadge">V1.0.3</span>
20
+ <span class="plugin-version-badge" id="pluginVersionBadge">V1.0.4</span>
21
21
  </div>
22
22
  <p class="subtitle" id="main-subtitle">Universal Multi-IDE & Project Skill Orchestrator</p>
23
23
  </div>
@@ -45,7 +45,7 @@
45
45
  <div class="hub-path-header">
46
46
  <span class="hub-path-title">Components Storage Path (Where all skills, MCPs, and plugins are saved)</span>
47
47
  <div style="display:flex; gap:8px; align-items:center;">
48
- <button type="button" class="btn-sm" id="btnToggleComponentsDetails" style="font-weight:600; font-size:11.5px; cursor:pointer;" title="Expand/Collapse categorized list of all Plugins, MCPs, Hooks, Skills, Agents, and Rules">
48
+ <button type="button" class="btn-sm" id="btnToggleComponentsDetails" style="font-weight:600; font-size:11.5px; cursor:pointer;" title="Expand/Collapse categorized list of all Plugins, MCPs, Hooks, Skills, Agents, Rules, and Apps">
49
49
  <span id="expandIcon">▼</span> <span id="expandLabel">Expand Components List</span>
50
50
  </button>
51
51
  <span class="hub-path-badge" id="hubPathBadge">Default Hub</span>
@@ -87,6 +87,7 @@
87
87
  <button type="button" class="cat-tab" data-cat="skills">Skills (<span id="cat-cnt-skills">0</span>)</button>
88
88
  <button type="button" class="cat-tab" data-cat="agents">Agents (<span id="cat-cnt-agents">0</span>)</button>
89
89
  <button type="button" class="cat-tab" data-cat="rules">Rules (<span id="cat-cnt-rules">0</span>)</button>
90
+ <button type="button" class="cat-tab" data-cat="apps">Apps (<span id="cat-cnt-apps">0</span>)</button>
90
91
  </div>
91
92
 
92
93
  <!-- Search bar inside category expander -->
@@ -113,6 +114,7 @@
113
114
  <div class="sub-line"><span>Skills:</span> <strong id="cnt-skills">0</strong></div>
114
115
  <div class="sub-line"><span>Agents:</span> <strong id="cnt-agents">0</strong></div>
115
116
  <div class="sub-line"><span>Rules:</span> <strong id="cnt-rules">0</strong></div>
117
+ <div class="sub-line"><span>Apps:</span> <strong id="cnt-apps">0</strong></div>
116
118
  </div>
117
119
  </div>
118
120
 
@@ -132,7 +134,7 @@
132
134
  <div class="prompt-desc">
133
135
  Ask your AI agent to enforce standard layouts, record upstream links, and install rules for component addendum/edits.
134
136
  </div>
135
- <button type="button" class="btn-copy-prompt" id="btnCopyStoragePrompt" title="Copy prompt for your AI agent to standardize Components Storage file structure, enforce upstream links, clean up plugins, enforce UTF-8 No BOM encoding, respect one-time rearrangement stability, preserve shared cross-agent communication folders, maintain dynamic Smart Middleware intent rules, and install rules">Copy Prompt (V1.6)</button>
137
+ <button type="button" class="btn-copy-prompt" id="btnCopyStoragePrompt" title="Copy prompt for your AI agent to standardize Components Storage file structure (plugins, app, shared, skills), enforce upstream links, clean up plugins/apps, enforce UTF-8 No BOM encoding, respect one-time rearrangement stability, preserve shared cross-agent communication folders, maintain dynamic Smart Middleware intent rules, and install rules">Copy Prompt (V1.7)</button>
136
138
  </div>
137
139
 
138
140
  <!-- Tile 4: Gateway Tool Optimization (Adjustable Cap with "Default" button) -->
@@ -320,6 +322,10 @@
320
322
  Hooks Configuration File:
321
323
  <input type="text" id="cpHooksInput" placeholder="e.g. ~/.claude/hooks.json" style="font-size:11px; padding:4px 6px;">
322
324
  </label>
325
+ <label style="font-size:11px; margin-bottom:0;">
326
+ Apps Directory (Runtimes &amp; Tools):
327
+ <input type="text" id="cpAppsInput" placeholder="e.g. ~/.gemini/config/apps" style="font-size:11px; padding:4px 6px;">
328
+ </label>
323
329
  </div>
324
330
  </div>
325
331
  </div>
package/page/style.css CHANGED
@@ -785,6 +785,7 @@ input:checked + .slider:before {
785
785
  .badge-mcp { background: rgba(37, 99, 235, 0.15); color: #3b82f6; }
786
786
  .badge-skills { background: rgba(34, 197, 94, 0.15); color: #16a34a; }
787
787
  .badge-rules { background: rgba(245, 158, 11, 0.15); color: #d97706; }
788
+ .badge-app { background: rgba(139, 92, 246, 0.15); color: #7c3aed; }
788
789
 
789
790
  /* Modals */
790
791
  .modal {